capability (entity)

Generated from solutions/ontological/lib/model/entities/capability/schema.ts.

Schema version: 2.

Description

A Capability is a unit of functionality the system provides — an observable ability, described independently of the code that realizes it. Capabilities self-nest via parent_key to form the capability tree: a root capability (e.g. Executable Task) decomposes into the sub-capabilities that support it. parent_key is the only stored direction; children are derived by inverting it (T-SJH1).

A Capability is not:

• A Task (a Task delivers or changes a capability; the Capability describes the standing ability).
• A Specification. Behavioral elaboration is currently collapsed into the Capability body; it resurrects as its own type only if a Capability needs multiple independent specs (D-ORMG-data-model).

Properties

Field	Type	Required	Description
type	string	yes	Dispatch tag for the validator framework.
schema_version	string		Numeric string version of the per-type schema this instance conforms to. Compare numerically when ordering versions. Independent of any product version. The value 0 is a documented sentinel meaning ‘pre-SDLC-managed’ — audit treats it as intentional, not stale. Optional in frontmatter: never in any per-type required set (audit flags a MISSING stamp as drift, not the validator).
id	string	yes	Immutable identifier in canonical C-NNNN shape per D-0002-entity-identifier-shape: ‘C-’ + 4 zero-padded chars [0-9A-Z] (Capabilities use incrementing numbering). Never renamed once assigned.
status	string		Lifecycle stage. open/* states are active; closed/* are terminal. open/planned: described but not yet built; open/building: implementation in flight; open/verified: implemented and observed working as described; closed/retired: no longer provided.
title	string	yes	Human-readable name of the capability. Frontmatter is canonical; the body opens with # <title> for readability.
created	string	yes	ISO date the capability was first authored.
last_reviewed	string		ISO date the capability was last reviewed.
related	array		Cross-references to other entities as wikilinks (any AA-NNNN id per D-0002-entity-identifier-shape). Slug is optional.
tags	array		Free-form labels. Required at the common level, defaulting to []. Per-type schemas may add a contains constraint (e.g. Principle requires exactly one principle/<category> tag).
need_human_review	boolean		Review-tracking flag.
kind	string		Structural grain of the capability — what kind of structure it names (system, subsystem, service, workflow, component, datastore, external, module, adapter, generated, page). Absent = ungraded. Orthogonal to audience; see capability/definition.md for the grain rubric.
audience	string		Which index section the capability belongs to: user (the capability’s direct consumer is an end user — the old kind: feature) or system (consumed by the system itself — the old kind: technical).
parent_key	—		Wikilink to the parent Capability, or null for a tree root. Slug is optional per D-0002-entity-identifier-shape.
locations	array		Code anchors realizing the capability, in the five-form Location grammar shared with task touchpoints: path/to/file.ts, path/to/file.ts#symbol, path/to/file.ts:42, path/to/dir/, or a glob. Every form degrades to a path/glob. entities audit warns (anchor rot) when a stored location no longer resolves in the tree.

Enums

status

• open/planned
• open/building
• open/verified
• closed/retired

kind

• system
• subsystem
• service
• workflow
• component
• datastore
• external
• module
• adapter
• generated
• page

audience

• user
• system