@metaobjectsdev/metadata 0.22.1 → 0.23.1-rc.1

package/dist/core/documentation/documentation-definition.embedded.js

@@ -12,7 +12,7 @@ export const DOCUMENTATION_DEFINITION = {
                     "name": "description",
                     "min": 0,
                     "max": 1,
-                    "description": "Free-form user-facing prose. Markdown allowed, multi-line via YAML '|' block scalar. Flows into doc-gen surfaces (JSDoc / XML-doc / Postgres COMMENT / Mermaid prose)."
+                    "description": "What this element IS and COVERS, written for someone using it. Markdown allowed, multi-line via YAML '|' block scalar. Flows into doc-gen surfaces (JSDoc / XML-doc / Postgres COMMENT / Mermaid prose). State scope and boundary — what it covers, what it deliberately does NOT, and which sibling owns the rest — all of which is derivable from the model itself. Anything you had to read the implementation to learn belongs in @notes, not here."
                 },
                 {
                     "type": "attr",
@@ -20,7 +20,7 @@ export const DOCUMENTATION_DEFINITION = {
                     "name": "summary",
                     "min": 0,
                     "max": 1,
-                    "description": "Short single-line tagline (OpenAPI `summary` pattern) — used in index tables, sidebar previews, and AI prompts where the full @description is too long. Optional supplement to @description; when @summary is unset, doc surfaces typically fall back to the first sentence of @description."
+                    "description": "Short single-line SENTENCE (OpenAPI `summary` pattern) — used in index tables, sidebar previews, and AI prompts where the full @description is too long. Distinct from @title, which is a noun label rather than a sentence. When @summary is unset, doc surfaces typically fall back to the first sentence of @description."
                 },
                 {
                     "type": "attr",
@@ -28,7 +28,7 @@ export const DOCUMENTATION_DEFINITION = {
                     "name": "title",
                     "min": 0,
                     "max": 1,
-                    "description": "Short single-line human label (e.g. 'Email' for a `field.string email`). Optional supplement to description."
+                    "description": "Short single-line human label — a NOUN PHRASE naming the element (e.g. 'Email' for a `field.string email`), never a sentence. What a tab, an index row or a sidebar shows when the name is an identifier rather than a label. See @summary for the one-line sentence form."
                 },
                 {
                     "type": "attr",
@@ -36,7 +36,7 @@ export const DOCUMENTATION_DEFINITION = {
                     "name": "notes",
                     "min": 0,
                     "max": 1,
-                    "description": "Internal-only rationale. Stays in metadata; never emitted to user-facing docs."
+                    "description": "Internal-only rationale, never emitted to user-facing docs — the slot for what you had to look OUTSIDE the model to learn: evidence, measurements, citations, the control that proved an absence was real, and what breaks if this changes. It is NOT a longer @description, and restating the description here is the failure mode this slot invites. Mechanical test: a sentence belongs in @notes exactly when it would have to change because the IMPLEMENTATION changed while the model did not."
                 },
                 {
                     "type": "attr",

package/dist/core/documentation/documentation-definition.embedded.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentation-definition.embedded.js","sourceRoot":"","sources":["../../../src/core/documentation/documentation-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,wBAAwB,GAAuB;IAC1D,UAAU,EAAE,2BAA2B;IACvC,OAAO,EAAE;QACP;YACE,MAAM,EAAE,GAAG;YACX,SAAS,EAAE,GAAG;YACd,aAAa,EAAE,+KAA+K;YAC9L,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,wKAAwK;iBACxL;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8RAA8R;iBAC9S;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8GAA8G;iBAC9H;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,gFAAgF;iBAChG;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8GAA8G;iBAC9H;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,2IAA2I;iBAC3J;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uEAAuE;iBACvF;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,wFAAwF;iBACxG;aACF;SACF;KACF;CACF,CAAC"}
+{"version":3,"file":"documentation-definition.embedded.js","sourceRoot":"","sources":["../../../src/core/documentation/documentation-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,wBAAwB,GAAuB;IAC1D,UAAU,EAAE,2BAA2B;IACvC,OAAO,EAAE;QACP;YACE,MAAM,EAAE,GAAG;YACX,SAAS,EAAE,GAAG;YACd,aAAa,EAAE,+KAA+K;YAC9L,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,ybAAyb;iBACzc;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8TAA8T;iBAC9U;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,4QAA4Q;iBAC5R;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,ueAAue;iBACvf;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8GAA8G;iBAC9H;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,2IAA2I;iBAC3J;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uEAAuE;iBACvF;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,wFAAwF;iBACxG;aACF;SACF;KACF;CACF,CAAC"}

package/dist/core/requirement/meta-requirement.d.ts

@@ -1,20 +1,37 @@
 import { MetaData } from "../../shared/meta-data.js";
-import { type RequirementStatus } from "./requirement-constants.js";
+import { type RequirementDisposition, type RequirementStatus } from "./requirement-constants.js";
 export declare class MetaRequirement extends MetaData {
     /** What the product does for a user — checked by EXISTENCE. */
     isFunctional(): boolean;
     /** How the system is built — checked by UNIVERSALITY (the opposite polarity). */
     isArchitectural(): boolean;
-    /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Architectural
-     *  requirements carry none — they are object-independent by definition. */
+    /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Required on a
+     *  functional requirement. OPTIONAL on an architectural one, where absent
+     *  means the original flat, object-independent form and present means it
+     *  sits in a levelled tree (a quality taxonomy over non-functional claims). */
     level(): number | undefined;
     status(): RequirementStatus | undefined;
+    /** What was DECIDED about the outstanding work. Undefined means UNDECIDED —
+     *  a real state, and the one worth finding in a review. */
+    disposition(): RequirementDisposition | undefined;
+    /** Issue/ticket references. Free-form; never resolved (verify has no network). */
+    trackedBy(): string[];
+    /** Intended but not built. Its nodes may legitimately not exist yet, and it
+     *  must NOT count toward object coverage — planning a capability cannot be
+     *  allowed to silence the warning that nothing implements it. */
+    isPlanned(): boolean;
+    /** True when there is outstanding work, so a `@disposition` says something. */
+    hasOutstandingWork(): boolean;
     implementedBy(): string[];
     verifiedBy(): string[];
     /** True when this requirement is permitted to reference the model at all.
-     *  Architectural requirements always may (their claim set is the point);
-     *  functional ones only at or below the link floor, so the organisational
-     *  tiers stay organisational. */
+     *
+     *  An UNLEVELLED architectural requirement always may — its claim set is the
+     *  whole point, and that is the original flat form. Once a level is present,
+     *  the node has opted into a tree and the link floor applies to it exactly as
+     *  it does to a functional one, so an "ISO 25010 Security" grouping node
+     *  cannot quietly start naming entities. Levelling is the opt-in; enforcing
+     *  the floor unconditionally would have broken every existing flat policy. */
     mayReferenceModel(): boolean;
     /** True when a dangling `@implementedBy` is an ERROR rather than expected.
      *  An abandoned or superseded requirement's nodes are supposed to be gone. */

package/dist/core/requirement/meta-requirement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-requirement.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/meta-requirement.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,+DAA+D;IAC/D,YAAY,IAAI,OAAO;IAIvB,iFAAiF;IACjF,eAAe,IAAI,OAAO;IAI1B;+EAC2E;IAC3E,KAAK,IAAI,MAAM,GAAG,SAAS;IAK3B,MAAM,IAAI,iBAAiB,GAAG,SAAS;IAKvC,aAAa,IAAI,MAAM,EAAE;IAKzB,UAAU,IAAI,MAAM,EAAE;IAKtB;;;qCAGiC;IACjC,iBAAiB,IAAI,OAAO;IAM5B;kFAC8E;IAC9E,iBAAiB,IAAI,OAAO;CAI7B"}
+{"version":3,"file":"meta-requirement.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/meta-requirement.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAaL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,+DAA+D;IAC/D,YAAY,IAAI,OAAO;IAIvB,iFAAiF;IACjF,eAAe,IAAI,OAAO;IAI1B;;;mFAG+E;IAC/E,KAAK,IAAI,MAAM,GAAG,SAAS;IAK3B,MAAM,IAAI,iBAAiB,GAAG,SAAS;IAKvC;+DAC2D;IAC3D,WAAW,IAAI,sBAAsB,GAAG,SAAS;IAKjD,kFAAkF;IAClF,SAAS,IAAI,MAAM,EAAE;IAKrB;;qEAEiE;IACjE,SAAS,IAAI,OAAO;IAIpB,+EAA+E;IAC/E,kBAAkB,IAAI,OAAO;IAK7B,aAAa,IAAI,MAAM,EAAE;IAKzB,UAAU,IAAI,MAAM,EAAE;IAKtB;;;;;;;kFAO8E;IAC9E,iBAAiB,IAAI,OAAO;IAM5B;kFAC8E;IAC9E,iBAAiB,IAAI,OAAO;CAI7B"}

package/dist/core/requirement/meta-requirement.js

@@ -4,7 +4,7 @@
 // Accessors are RESOLVING (ADR-0039) so a requirement that `extends` an
 // abstract parent inherits its properties.
 import { MetaData } from "../../shared/meta-data.js";
-import { REQUIREMENT_SUBTYPE_FUNCTIONAL, REQUIREMENT_SUBTYPE_ARCHITECTURAL, REQUIREMENT_ATTR_LEVEL, REQUIREMENT_ATTR_STATUS, REQUIREMENT_ATTR_IMPLEMENTED_BY, REQUIREMENT_ATTR_VERIFIED_BY, REQUIREMENT_LINK_FLOOR_LEVEL, REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES, } from "./requirement-constants.js";
+import { REQUIREMENT_SUBTYPE_FUNCTIONAL, REQUIREMENT_SUBTYPE_ARCHITECTURAL, REQUIREMENT_ATTR_LEVEL, REQUIREMENT_ATTR_STATUS, REQUIREMENT_ATTR_DISPOSITION, REQUIREMENT_ATTR_TRACKED_BY, REQUIREMENT_ATTR_IMPLEMENTED_BY, REQUIREMENT_ATTR_VERIFIED_BY, REQUIREMENT_LINK_FLOOR_LEVEL, REQUIREMENT_STATUS_PLANNED, REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES, REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK, } from "./requirement-constants.js";
 export class MetaRequirement extends MetaData {
     /** What the product does for a user — checked by EXISTENCE. */
     isFunctional() {
@@ -14,8 +14,10 @@ export class MetaRequirement extends MetaData {
     isArchitectural() {
         return this.subType === REQUIREMENT_SUBTYPE_ARCHITECTURAL;
     }
-    /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Architectural
-     *  requirements carry none — they are object-independent by definition. */
+    /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Required on a
+     *  functional requirement. OPTIONAL on an architectural one, where absent
+     *  means the original flat, object-independent form and present means it
+     *  sits in a levelled tree (a quality taxonomy over non-functional claims). */
     level() {
         const v = this.attr(REQUIREMENT_ATTR_LEVEL);
         return typeof v === "number" ? v : undefined;
@@ -24,6 +26,28 @@ export class MetaRequirement extends MetaData {
         const v = this.attr(REQUIREMENT_ATTR_STATUS);
         return typeof v === "string" ? v : undefined;
     }
+    /** What was DECIDED about the outstanding work. Undefined means UNDECIDED —
+     *  a real state, and the one worth finding in a review. */
+    disposition() {
+        const v = this.attr(REQUIREMENT_ATTR_DISPOSITION);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Issue/ticket references. Free-form; never resolved (verify has no network). */
+    trackedBy() {
+        const v = this.attr(REQUIREMENT_ATTR_TRACKED_BY);
+        return Array.isArray(v) ? v : [];
+    }
+    /** Intended but not built. Its nodes may legitimately not exist yet, and it
+     *  must NOT count toward object coverage — planning a capability cannot be
+     *  allowed to silence the warning that nothing implements it. */
+    isPlanned() {
+        return this.status() === REQUIREMENT_STATUS_PLANNED;
+    }
+    /** True when there is outstanding work, so a `@disposition` says something. */
+    hasOutstandingWork() {
+        const s = this.status();
+        return s !== undefined && REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK.includes(s);
+    }
     implementedBy() {
         const v = this.attr(REQUIREMENT_ATTR_IMPLEMENTED_BY);
         return Array.isArray(v) ? v : [];
@@ -33,14 +57,18 @@ export class MetaRequirement extends MetaData {
         return Array.isArray(v) ? v : [];
     }
     /** True when this requirement is permitted to reference the model at all.
-     *  Architectural requirements always may (their claim set is the point);
-     *  functional ones only at or below the link floor, so the organisational
-     *  tiers stay organisational. */
+     *
+     *  An UNLEVELLED architectural requirement always may — its claim set is the
+     *  whole point, and that is the original flat form. Once a level is present,
+     *  the node has opted into a tree and the link floor applies to it exactly as
+     *  it does to a functional one, so an "ISO 25010 Security" grouping node
+     *  cannot quietly start naming entities. Levelling is the opt-in; enforcing
+     *  the floor unconditionally would have broken every existing flat policy. */
     mayReferenceModel() {
-        if (this.isArchitectural())
-            return true;
         const lvl = this.level();
-        return lvl !== undefined && lvl >= REQUIREMENT_LINK_FLOOR_LEVEL;
+        if (lvl === undefined)
+            return this.isArchitectural();
+        return lvl >= REQUIREMENT_LINK_FLOOR_LEVEL;
     }
     /** True when a dangling `@implementedBy` is an ERROR rather than expected.
      *  An abandoned or superseded requirement's nodes are supposed to be gone. */

package/dist/core/requirement/meta-requirement.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-requirement.js","sourceRoot":"","sources":["../../../src/core/requirement/meta-requirement.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,2CAA2C;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,4BAA4B,EAC5B,4BAA4B,EAC5B,yCAAyC,GAE1C,MAAM,4BAA4B,CAAC;AAEpC,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,+DAA+D;IAC/D,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,KAAK,8BAA8B,CAAC;IACzD,CAAC;IAED,iFAAiF;IACjF,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,KAAK,iCAAiC,CAAC;IAC5D,CAAC;IAED;+EAC2E;IAC3E,KAAK;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,MAAM;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IAED,aAAa;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,UAAU;QACR,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IAED;;;qCAGiC;IACjC,iBAAiB;QACf,IAAI,IAAI,CAAC,eAAe,EAAE;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,IAAI,4BAA4B,CAAC;IAClE,CAAC;IAED;kFAC8E;IAC9E,iBAAiB;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,SAAS,IAAI,yCAAyC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"meta-requirement.js","sourceRoot":"","sources":["../../../src/core/requirement/meta-requirement.ts"],"names":[],"mappings":"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"}

package/dist/core/requirement/requirement-constants.d.ts

@@ -3,25 +3,37 @@ export declare const REQUIREMENT_SUBTYPE_FUNCTIONAL = "functional";
 export declare const REQUIREMENT_SUBTYPE_ARCHITECTURAL = "architectural";
 export declare const REQUIREMENT_SUBTYPES: readonly ["functional", "architectural"];
 export type RequirementSubType = (typeof REQUIREMENT_SUBTYPES)[number];
-/** 1 solution · 2 segment (app/library) · 3 service · 4 object · 5 member. */
+/** 1 solution · 2 segment · 3 service · 4 object · 5 member — levels of
+ *  ABSTRACTION AND OWNERSHIP in the problem domain, never of code structure. */
 export declare const REQUIREMENT_ATTR_LEVEL = "level";
 export declare const REQUIREMENT_ATTR_STATUS = "status";
+export declare const REQUIREMENT_ATTR_DISPOSITION = "disposition";
+export declare const REQUIREMENT_ATTR_TRACKED_BY = "trackedBy";
 export declare const REQUIREMENT_ATTR_STATEMENT = "statement";
 export declare const REQUIREMENT_ATTR_VIOLATION = "violation";
 export declare const REQUIREMENT_ATTR_IMPLEMENTED_BY = "implementedBy";
 export declare const REQUIREMENT_ATTR_VERIFIED_BY = "verifiedBy";
 export declare const REQUIREMENT_ATTR_SUPERSEDED_BY = "supersededBy";
+export declare const REQUIREMENT_STATUS_PLANNED = "planned";
 export declare const REQUIREMENT_STATUS_LIVE = "live";
 export declare const REQUIREMENT_STATUS_PARTIAL = "partial";
 export declare const REQUIREMENT_STATUS_ABANDONED = "abandoned";
 export declare const REQUIREMENT_STATUS_SUPERSEDED = "superseded";
-export declare const REQUIREMENT_STATUSES: readonly ["live", "partial", "abandoned", "superseded"];
+export declare const REQUIREMENT_STATUSES: readonly ["planned", "live", "partial", "abandoned", "superseded"];
 export type RequirementStatus = (typeof REQUIREMENT_STATUSES)[number];
 /** Statuses whose implementing nodes are supposed to still exist. A dangling
  *  `@implementedBy` on one of these means the model moved and the requirement is
- *  stale; on the other two the nodes are supposed to be GONE, which is the whole
- *  point of the entry. The asymmetry inverts as a pair. */
+ *  stale. On `planned` the nodes do not exist YET; on `abandoned`/`superseded`
+ *  they are supposed to be GONE — which is the whole point of those entries. */
 export declare const REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES: readonly RequirementStatus[];
+/** Statuses with outstanding work, so a `@disposition` is meaningful on them.
+ *  On any other status the decision IS the status, and recording a second one
+ *  can only agree with it or contradict it. */
+export declare const REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK: readonly RequirementStatus[];
+export declare const REQUIREMENT_DISPOSITION_ACCEPTED = "accepted";
+export declare const REQUIREMENT_DISPOSITION_DEFERRED = "deferred";
+export declare const REQUIREMENT_DISPOSITIONS: readonly ["accepted", "deferred"];
+export type RequirementDisposition = (typeof REQUIREMENT_DISPOSITIONS)[number];
 export declare const REQUIREMENT_LEVEL_SOLUTION = 1;
 export declare const REQUIREMENT_LEVEL_SEGMENT = 2;
 export declare const REQUIREMENT_LEVEL_SERVICE = 3;

package/dist/core/requirement/requirement-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-constants.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/requirement-constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AASzC,eAAO,MAAM,8BAA8B,eAAe,CAAC;AAC3D,eAAO,MAAM,iCAAiC,kBAAkB,CAAC;AAEjE,eAAO,MAAM,oBAAoB,0CAGvB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMvE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAC9C,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAChD,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,eAAe,CAAC;AACzD,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAS7D,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAC9C,eAAO,MAAM,0BAA0B,YAAY,CAAC;AACpD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAE1D,eAAO,MAAM,oBAAoB,yDAKvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;2DAG2D;AAC3D,eAAO,MAAM,yCAAyC,EAAE,SAAS,iBAAiB,EAGjF,CAAC;AAMF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;mDACmD;AACnD,eAAO,MAAM,4BAA4B,IAA2B,CAAC;AACrE,eAAO,MAAM,qBAAqB,IAA6B,CAAC;AAChE,eAAO,MAAM,qBAAqB,IAA2B,CAAC"}
+{"version":3,"file":"requirement-constants.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/requirement-constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AASzC,eAAO,MAAM,8BAA8B,eAAe,CAAC;AAC3D,eAAO,MAAM,iCAAiC,kBAAkB,CAAC;AAEjE,eAAO,MAAM,oBAAoB,0CAGvB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMvE;gFACgF;AAChF,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAC9C,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAChD,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,eAAe,CAAC;AACzD,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAS7D,eAAO,MAAM,0BAA0B,YAAY,CAAC;AACpD,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAC9C,eAAO,MAAM,0BAA0B,YAAY,CAAC;AACpD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAE1D,eAAO,MAAM,oBAAoB,oEAMvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;gFAGgF;AAChF,eAAO,MAAM,yCAAyC,EAAE,SAAS,iBAAiB,EAGjF,CAAC;AAEF;;+CAE+C;AAC/C,eAAO,MAAM,0CAA0C,EAAE,SAAS,iBAAiB,EAGlF,CAAC;AASF,eAAO,MAAM,gCAAgC,aAAa,CAAC;AAC3D,eAAO,MAAM,gCAAgC,aAAa,CAAC;AAE3D,eAAO,MAAM,wBAAwB,mCAG3B,CAAC;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM/E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;mDACmD;AACnD,eAAO,MAAM,4BAA4B,IAA2B,CAAC;AACrE,eAAO,MAAM,qBAAqB,IAA6B,CAAC;AAChE,eAAO,MAAM,qBAAqB,IAA2B,CAAC"}

package/dist/core/requirement/requirement-constants.js

@@ -20,9 +20,12 @@ export const REQUIREMENT_SUBTYPES = [
 // ---------------------------------------------------------------------------
 // Attrs
 // ---------------------------------------------------------------------------
-/** 1 solution · 2 segment (app/library) · 3 service · 4 object · 5 member. */
+/** 1 solution · 2 segment · 3 service · 4 object · 5 member — levels of
+ *  ABSTRACTION AND OWNERSHIP in the problem domain, never of code structure. */
 export const REQUIREMENT_ATTR_LEVEL = "level";
 export const REQUIREMENT_ATTR_STATUS = "status";
+export const REQUIREMENT_ATTR_DISPOSITION = "disposition";
+export const REQUIREMENT_ATTR_TRACKED_BY = "trackedBy";
 export const REQUIREMENT_ATTR_STATEMENT = "statement";
 export const REQUIREMENT_ATTR_VIOLATION = "violation";
 export const REQUIREMENT_ATTR_IMPLEMENTED_BY = "implementedBy";
@@ -34,11 +37,13 @@ export const REQUIREMENT_ATTR_SUPERSEDED_BY = "supersededBy";
 // a deliberately-retired capability 0 times out of 24, so a typo that silently
 // disabled it would disable the whole mechanism.
 // ---------------------------------------------------------------------------
+export const REQUIREMENT_STATUS_PLANNED = "planned";
 export const REQUIREMENT_STATUS_LIVE = "live";
 export const REQUIREMENT_STATUS_PARTIAL = "partial";
 export const REQUIREMENT_STATUS_ABANDONED = "abandoned";
 export const REQUIREMENT_STATUS_SUPERSEDED = "superseded";
 export const REQUIREMENT_STATUSES = [
+    REQUIREMENT_STATUS_PLANNED,
     REQUIREMENT_STATUS_LIVE,
     REQUIREMENT_STATUS_PARTIAL,
     REQUIREMENT_STATUS_ABANDONED,
@@ -46,12 +51,31 @@ export const REQUIREMENT_STATUSES = [
 ];
 /** Statuses whose implementing nodes are supposed to still exist. A dangling
  *  `@implementedBy` on one of these means the model moved and the requirement is
- *  stale; on the other two the nodes are supposed to be GONE, which is the whole
- *  point of the entry. The asymmetry inverts as a pair. */
+ *  stale. On `planned` the nodes do not exist YET; on `abandoned`/`superseded`
+ *  they are supposed to be GONE — which is the whole point of those entries. */
 export const REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES = [
     REQUIREMENT_STATUS_LIVE,
     REQUIREMENT_STATUS_PARTIAL,
 ];
+/** Statuses with outstanding work, so a `@disposition` is meaningful on them.
+ *  On any other status the decision IS the status, and recording a second one
+ *  can only agree with it or contradict it. */
+export const REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK = [
+    REQUIREMENT_STATUS_PLANNED,
+    REQUIREMENT_STATUS_PARTIAL,
+];
+// ---------------------------------------------------------------------------
+// Disposition — what was DECIDED about the outstanding work. Orthogonal to
+// status, which says whether the work is done. Absent means UNDECIDED, and that
+// is the state a review exists to find; collapsing it into the status enum
+// would make "there is a gap" and "we chose to live with it" the same fact.
+// ---------------------------------------------------------------------------
+export const REQUIREMENT_DISPOSITION_ACCEPTED = "accepted";
+export const REQUIREMENT_DISPOSITION_DEFERRED = "deferred";
+export const REQUIREMENT_DISPOSITIONS = [
+    REQUIREMENT_DISPOSITION_ACCEPTED,
+    REQUIREMENT_DISPOSITION_DEFERRED,
+];
 // ---------------------------------------------------------------------------
 // Levels — organisational above the link floor, model-referencing at or below.
 // ---------------------------------------------------------------------------

package/dist/core/requirement/requirement-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-constants.js","sourceRoot":"","sources":["../../../src/core/requirement/requirement-constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,0EAA0E;AAC1E,wDAAwD;AACxD,oEAAoE;AACpE,oEAAoE;AACpE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,iCAAiC,GAAG,eAAe,CAAC;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,8BAA8B;IAC9B,iCAAiC;CACzB,CAAC;AAGX,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAG,WAAW,CAAC;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,WAAW,CAAC;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,eAAe,CAAC;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,YAAY,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,cAAc,CAAC;AAE7D,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,iDAAiD;AACjD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,uBAAuB;IACvB,0BAA0B;IAC1B,4BAA4B;IAC5B,6BAA6B;CACrB,CAAC;AAGX;;;2DAG2D;AAC3D,MAAM,CAAC,MAAM,yCAAyC,GAAiC;IACrF,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC;AAEF,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;mDACmD;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"requirement-constants.js","sourceRoot":"","sources":["../../../src/core/requirement/requirement-constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,0EAA0E;AAC1E,wDAAwD;AACxD,oEAAoE;AACpE,oEAAoE;AACpE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,iCAAiC,GAAG,eAAe,CAAC;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,8BAA8B;IAC9B,iCAAiC;CACzB,CAAC;AAGX,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;gFACgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,aAAa,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,WAAW,CAAC;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,WAAW,CAAC;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,WAAW,CAAC;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,eAAe,CAAC;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,YAAY,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,cAAc,CAAC;AAE7D,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,iDAAiD;AACjD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,uBAAuB;IACvB,0BAA0B;IAC1B,4BAA4B;IAC5B,6BAA6B;CACrB,CAAC;AAGX;;;gFAGgF;AAChF,MAAM,CAAC,MAAM,yCAAyC,GAAiC;IACrF,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC;AAEF;;+CAE+C;AAC/C,MAAM,CAAC,MAAM,0CAA0C,GAAiC;IACtF,0BAA0B;IAC1B,0BAA0B;CAC3B,CAAC;AAEF,8EAA8E;AAC9E,2EAA2E;AAC3E,gFAAgF;AAChF,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gCAAgC,GAAG,UAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,gCAAgC,GAAG,UAAU,CAAC;AAE3D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gCAAgC;IAChC,gCAAgC;CACxB,CAAC;AAGX,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;mDACmD;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC"}

package/dist/core/requirement/requirement-definition.embedded.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/requirement-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,sBAAsB,EAAE,kBA2IpC,CAAC"}
+{"version":3,"file":"requirement-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/core/requirement/requirement-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,sBAAsB,EAAE,kBAgNpC,CAAC"}

package/dist/core/requirement/requirement-definition.embedded.js

@@ -5,7 +5,7 @@ export const REQUIREMENT_DEFINITION = {
             "type": "requirement",
             "subType": "functional",
             "description": "What the product does for a user, stated as one violable claim. Its check is EXISTENCE: it fails when nothing implements it. Hierarchy is nesting — an L1 solution contains its L2 segments, which contain L3 services, and so on down to the levels that reference the model.",
-            "whenToUse": "Something exists because someone asked for it. Levels: 1 solution, 2 segment (an application or library), 3 service, 4 object, 5 member. Only L4 and L5 carry @implementedBy — L1-L3 are organisational and never reference the model.",
+            "whenToUse": "Something exists because someone asked for it. L1-L3 are levels of ABSTRACTION AND OWNERSHIP in the problem domain — whose need is this, and at what altitude — and are never a directory, package, deployable or module. Binding to technical constructs happens only at L4 (an object) and L5 (a member), which is the allocation step. Test every node: if a refactor that changes no behaviour would force it to move, its level is wrong.",
             "children": [
                 {
                     "type": "attr",
@@ -13,7 +13,7 @@ export const REQUIREMENT_DEFINITION = {
                     "name": "level",
                     "min": 1,
                     "max": 1,
-                    "description": "1 solution, 2 segment (application/library), 3 service, 4 object, 5 member. Nesting depth must agree with it."
+                    "description": "1 solution, 2 segment, 3 service, 4 object, 5 member. L1-L3 are levels of abstraction and ownership in the problem domain, NOT of code structure. Nesting depth must agree with it; skipping a level is legal, going back up is not."
                 },
                 {
                     "type": "attr",
@@ -22,12 +22,34 @@ export const REQUIREMENT_DEFINITION = {
                     "min": 1,
                     "max": 1,
                     "allowedValues": [
+                        "planned",
                         "live",
                         "partial",
                         "abandoned",
                         "superseded"
                     ],
-                    "description": "live implemented and in use; partial implemented with known gaps; abandoned built then deliberately retired; superseded replaced by a different mechanism. A dangling @implementedBy is an ERROR on live/partial (the model moved, the requirement is stale) and ALLOWED on abandoned/superseded (those nodes are meant to be gone — that is the entry doing its job)."
+                    "description": "planned intended but not built yet; live implemented and in use; partial implemented with known gaps; abandoned built then deliberately retired; superseded replaced by a different mechanism. A dangling @implementedBy is an ERROR on live/partial (the model moved, the requirement is stale) and ALLOWED on planned/abandoned/superseded — on planned the nodes do not exist YET, on the other two they are meant to be gone, and that is the entry doing its job. A planned requirement also never contributes to object coverage: planning a capability must not silence the warning that nothing implements it."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "disposition",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "accepted",
+                        "deferred"
+                    ],
+                    "description": "What has been DECIDED about outstanding work — a different question from whether the work is done, which is what @status answers. accepted: the gap is understood and deliberately not being closed. deferred: it will be closed, but not now. ABSENT MEANS UNDECIDED, which is a real and useful state — it is what an unreviewed gap looks like, and it is the one a review should be able to find. Meaningful on planned and partial only; on a status with no outstanding work it is a WARNING. Deliberately NOT a workflow vocabulary: which sprint, who owns it and whether it is in progress belong in the tracker named by @trackedBy, because two systems holding that answer will drift and only one of them is refreshed daily."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "trackedBy",
+                    "isArray": true,
+                    "min": 0,
+                    "max": 1,
+                    "description": "Issue or ticket references for outstanding work — a URL, an owner/repo#123 shorthand, or a tracker key. Free-form and NOT resolved by verify, which does not reach the network; unlike @verifiedBy, nothing here is checked to exist. Its job is to stop a deferred gap becoming invisible, so verify warns when a deferred requirement names no ticket. Also the right place to link the ticket that a planned requirement will be built under."
                 },
                 {
                     "type": "attr",
@@ -61,7 +83,7 @@ export const REQUIREMENT_DEFINITION = {
                     "isArray": true,
                     "min": 0,
                     "max": 1,
-                    "description": "Names of the tests proving the behaviour. verify checks each exists and is not skipped; it never runs them."
+                    "description": "OPTIONAL — omit unless you have opened the test and read what it asserts. Names of tests that assert the behaviour. verify checks each name EXISTS and is not skipped; it never runs them, and it cannot tell whether the named test verifies this requirement — any occurrence in the test corpus satisfies it."
                 },
                 {
                     "type": "attr",
@@ -84,9 +106,17 @@ export const REQUIREMENT_DEFINITION = {
         {
             "type": "requirement",
             "subType": "architectural",
-            "description": "How the system is built, applied uniformly across the model. Its check is UNIVERSALITY: it fails when something VIOLATES it, which is the opposite polarity to a functional requirement. Carries no level and no parent — levels come from object-in-focus decomposition and an architectural requirement is object-independent by definition.",
-            "whenToUse": "Something exists because every entity here looks like this — a uuid primary key, an @autoSet createdAt, a change-attribution column, tenant scoping. The discriminator is mechanical: did this exist because someone asked for something, or because it is the architecture?",
+            "description": "How the system is built, applied uniformly across the model. Its check is UNIVERSALITY: it fails when something VIOLATES it, which is the opposite polarity to a functional requirement. Flat by default and object-independent; it may optionally sit in a levelled tree when a quality taxonomy is being used to organise non-functional requirements.",
+            "whenToUse": "Something exists because every entity here looks like this — a uuid primary key, an @autoSet createdAt, a change-attribution column, tenant scoping. The discriminator is mechanical: did this exist because someone asked for something, or because it is the architecture? For a non-functional tree, an established quality taxonomy makes a good fixed upper structure (e.g. an ISO/IEC 25010 characteristic at L1, its sub-characteristic or a control-catalogue category at L2), with the model-binding claims at L4 and L5 as usual.",
             "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "level",
+                    "min": 0,
+                    "max": 1,
+                    "description": "OPTIONAL here, unlike on a functional requirement where it is required. ABSENT means a flat, object-independent policy that may reference the model directly — the original and still the default form. PRESENT means this node sits in a levelled tree, and then the same rules as functional apply: nesting must agree with the level, and only L4/L5 may carry @implementedBy. Levelling is opt-in so that adding a taxonomy on top of existing flat policies does not invalidate them."
+                },
                 {
                     "type": "attr",
                     "subType": "string",
@@ -94,12 +124,34 @@ export const REQUIREMENT_DEFINITION = {
                     "min": 1,
                     "max": 1,
                     "allowedValues": [
+                        "planned",
                         "live",
                         "partial",
                         "abandoned",
                         "superseded"
                     ],
-                    "description": "As on requirement.functional. A live or partial architectural requirement claimed by NOTHING is an error: a policy declared and applied to nothing."
+                    "description": "As on requirement.functional. A live or partial architectural requirement claimed by NOTHING is an error: a policy declared and applied to nothing. A planned one is exempt from that check — it is not applied yet by definition."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "disposition",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "accepted",
+                        "deferred"
+                    ],
+                    "description": "As on requirement.functional. On an architectural requirement, accepted is the common and important case: a policy that is genuinely not universal, where the exceptions are known and tolerated, is more honest as partial+accepted than as a live claim nobody audits."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "trackedBy",
+                    "isArray": true,
+                    "min": 0,
+                    "max": 1,
+                    "description": "As on requirement.functional. Issue or ticket references for outstanding work; free-form, not resolved."
                 },
                 {
                     "type": "attr",
@@ -126,6 +178,15 @@ export const REQUIREMENT_DEFINITION = {
                     "max": 1,
                     "description": "FQN references to the nodes applying this policy. High fan-out is normal and expected: one uuid-primary-key requirement is claimed by every entity."
                 },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "verifiedBy",
+                    "isArray": true,
+                    "min": 0,
+                    "max": 1,
+                    "description": "OPTIONAL — omit unless you have opened the test and read what it asserts. Names of tests that assert the policy holds. verify checks each name EXISTS and is not skipped; it never runs them, and it cannot tell whether the named test verifies this requirement — any occurrence in the test corpus satisfies it."
+                },
                 {
                     "type": "attr",
                     "subType": "string",
@@ -133,6 +194,14 @@ export const REQUIREMENT_DEFINITION = {
                     "min": 0,
                     "max": 1,
                     "description": "The requirement that replaced this one. Expected on status=superseded."
+                },
+                {
+                    "type": "requirement",
+                    "subType": "*",
+                    "name": "*",
+                    "min": 0,
+                    "max": null,
+                    "description": "Nested child requirements. Present so a non-functional tree can be organised by a quality taxonomy the same way a functional tree is organised by capability — the absence of this rule, while requirement.functional had it, is what previously made an architectural node nestable UNDER a functional one but never under another architectural one."
                 }
             ]
         }

package/dist/core/requirement/requirement-definition.embedded.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-definition.embedded.js","sourceRoot":"","sources":["../../../src/core/requirement/requirement-definition.embedded.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"requirement-definition.embedded.js","sourceRoot":"","sources":["../../../src/core/requirement/requirement-definition.embedded.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/metadata",
-  "version": "0.22.1",
+  "version": "0.23.1-rc.1",
   "description": "Metamodel loader, types, and constants for the MetaObjects standard.",
   "type": "module",
   "main": "./dist/index.js",

package/src/core/documentation/documentation-definition.embedded.ts

@@ -20,7 +20,7 @@ export const DOCUMENTATION_DEFINITION: ProviderDefinition = {
           "name": "description",
           "min": 0,
           "max": 1,
-          "description": "Free-form user-facing prose. Markdown allowed, multi-line via YAML '|' block scalar. Flows into doc-gen surfaces (JSDoc / XML-doc / Postgres COMMENT / Mermaid prose)."
+          "description": "What this element IS and COVERS, written for someone using it. Markdown allowed, multi-line via YAML '|' block scalar. Flows into doc-gen surfaces (JSDoc / XML-doc / Postgres COMMENT / Mermaid prose). State scope and boundary — what it covers, what it deliberately does NOT, and which sibling owns the rest — all of which is derivable from the model itself. Anything you had to read the implementation to learn belongs in @notes, not here."
         },
         {
           "type": "attr",
@@ -28,7 +28,7 @@ export const DOCUMENTATION_DEFINITION: ProviderDefinition = {
           "name": "summary",
           "min": 0,
           "max": 1,
-          "description": "Short single-line tagline (OpenAPI `summary` pattern) — used in index tables, sidebar previews, and AI prompts where the full @description is too long. Optional supplement to @description; when @summary is unset, doc surfaces typically fall back to the first sentence of @description."
+          "description": "Short single-line SENTENCE (OpenAPI `summary` pattern) — used in index tables, sidebar previews, and AI prompts where the full @description is too long. Distinct from @title, which is a noun label rather than a sentence. When @summary is unset, doc surfaces typically fall back to the first sentence of @description."
         },
         {
           "type": "attr",
@@ -36,7 +36,7 @@ export const DOCUMENTATION_DEFINITION: ProviderDefinition = {
           "name": "title",
           "min": 0,
           "max": 1,
-          "description": "Short single-line human label (e.g. 'Email' for a `field.string email`). Optional supplement to description."
+          "description": "Short single-line human label — a NOUN PHRASE naming the element (e.g. 'Email' for a `field.string email`), never a sentence. What a tab, an index row or a sidebar shows when the name is an identifier rather than a label. See @summary for the one-line sentence form."
         },
         {
           "type": "attr",
@@ -44,7 +44,7 @@ export const DOCUMENTATION_DEFINITION: ProviderDefinition = {
           "name": "notes",
           "min": 0,
           "max": 1,
-          "description": "Internal-only rationale. Stays in metadata; never emitted to user-facing docs."
+          "description": "Internal-only rationale, never emitted to user-facing docs — the slot for what you had to look OUTSIDE the model to learn: evidence, measurements, citations, the control that proved an absence was real, and what breaks if this changes. It is NOT a longer @description, and restating the description here is the failure mode this slot invites. Mechanical test: a sentence belongs in @notes exactly when it would have to change because the IMPLEMENTATION changed while the model did not."
         },
         {
           "type": "attr",

package/src/core/requirement/meta-requirement.ts

@@ -10,10 +10,15 @@ import {
   REQUIREMENT_SUBTYPE_ARCHITECTURAL,
   REQUIREMENT_ATTR_LEVEL,
   REQUIREMENT_ATTR_STATUS,
+  REQUIREMENT_ATTR_DISPOSITION,
+  REQUIREMENT_ATTR_TRACKED_BY,
   REQUIREMENT_ATTR_IMPLEMENTED_BY,
   REQUIREMENT_ATTR_VERIFIED_BY,
   REQUIREMENT_LINK_FLOOR_LEVEL,
+  REQUIREMENT_STATUS_PLANNED,
   REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES,
+  REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK,
+  type RequirementDisposition,
   type RequirementStatus,
 } from "./requirement-constants.js";
 
@@ -28,8 +33,10 @@ export class MetaRequirement extends MetaData {
     return this.subType === REQUIREMENT_SUBTYPE_ARCHITECTURAL;
   }
 
-  /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Architectural
-   *  requirements carry none — they are object-independent by definition. */
+  /** 1 solution · 2 segment · 3 service · 4 object · 5 member. Required on a
+   *  functional requirement. OPTIONAL on an architectural one, where absent
+   *  means the original flat, object-independent form and present means it
+   *  sits in a levelled tree (a quality taxonomy over non-functional claims). */
   level(): number | undefined {
     const v = this.attr(REQUIREMENT_ATTR_LEVEL);
     return typeof v === "number" ? v : undefined;
@@ -40,6 +47,32 @@ export class MetaRequirement extends MetaData {
     return typeof v === "string" ? (v as RequirementStatus) : undefined;
   }
 
+  /** What was DECIDED about the outstanding work. Undefined means UNDECIDED —
+   *  a real state, and the one worth finding in a review. */
+  disposition(): RequirementDisposition | undefined {
+    const v = this.attr(REQUIREMENT_ATTR_DISPOSITION);
+    return typeof v === "string" ? (v as RequirementDisposition) : undefined;
+  }
+
+  /** Issue/ticket references. Free-form; never resolved (verify has no network). */
+  trackedBy(): string[] {
+    const v = this.attr(REQUIREMENT_ATTR_TRACKED_BY);
+    return Array.isArray(v) ? (v as string[]) : [];
+  }
+
+  /** Intended but not built. Its nodes may legitimately not exist yet, and it
+   *  must NOT count toward object coverage — planning a capability cannot be
+   *  allowed to silence the warning that nothing implements it. */
+  isPlanned(): boolean {
+    return this.status() === REQUIREMENT_STATUS_PLANNED;
+  }
+
+  /** True when there is outstanding work, so a `@disposition` says something. */
+  hasOutstandingWork(): boolean {
+    const s = this.status();
+    return s !== undefined && REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK.includes(s);
+  }
+
   implementedBy(): string[] {
     const v = this.attr(REQUIREMENT_ATTR_IMPLEMENTED_BY);
     return Array.isArray(v) ? (v as string[]) : [];
@@ -51,13 +84,17 @@ export class MetaRequirement extends MetaData {
   }
 
   /** True when this requirement is permitted to reference the model at all.
-   *  Architectural requirements always may (their claim set is the point);
-   *  functional ones only at or below the link floor, so the organisational
-   *  tiers stay organisational. */
+   *
+   *  An UNLEVELLED architectural requirement always may — its claim set is the
+   *  whole point, and that is the original flat form. Once a level is present,
+   *  the node has opted into a tree and the link floor applies to it exactly as
+   *  it does to a functional one, so an "ISO 25010 Security" grouping node
+   *  cannot quietly start naming entities. Levelling is the opt-in; enforcing
+   *  the floor unconditionally would have broken every existing flat policy. */
   mayReferenceModel(): boolean {
-    if (this.isArchitectural()) return true;
     const lvl = this.level();
-    return lvl !== undefined && lvl >= REQUIREMENT_LINK_FLOOR_LEVEL;
+    if (lvl === undefined) return this.isArchitectural();
+    return lvl >= REQUIREMENT_LINK_FLOOR_LEVEL;
   }
 
   /** True when a dangling `@implementedBy` is an ERROR rather than expected.

package/src/core/requirement/requirement-constants.ts

@@ -27,9 +27,12 @@ export type RequirementSubType = (typeof REQUIREMENT_SUBTYPES)[number];
 // Attrs
 // ---------------------------------------------------------------------------
 
-/** 1 solution · 2 segment (app/library) · 3 service · 4 object · 5 member. */
+/** 1 solution · 2 segment · 3 service · 4 object · 5 member — levels of
+ *  ABSTRACTION AND OWNERSHIP in the problem domain, never of code structure. */
 export const REQUIREMENT_ATTR_LEVEL = "level";
 export const REQUIREMENT_ATTR_STATUS = "status";
+export const REQUIREMENT_ATTR_DISPOSITION = "disposition";
+export const REQUIREMENT_ATTR_TRACKED_BY = "trackedBy";
 export const REQUIREMENT_ATTR_STATEMENT = "statement";
 export const REQUIREMENT_ATTR_VIOLATION = "violation";
 export const REQUIREMENT_ATTR_IMPLEMENTED_BY = "implementedBy";
@@ -43,12 +46,14 @@ export const REQUIREMENT_ATTR_SUPERSEDED_BY = "supersededBy";
 // disabled it would disable the whole mechanism.
 // ---------------------------------------------------------------------------
 
+export const REQUIREMENT_STATUS_PLANNED = "planned";
 export const REQUIREMENT_STATUS_LIVE = "live";
 export const REQUIREMENT_STATUS_PARTIAL = "partial";
 export const REQUIREMENT_STATUS_ABANDONED = "abandoned";
 export const REQUIREMENT_STATUS_SUPERSEDED = "superseded";
 
 export const REQUIREMENT_STATUSES = [
+  REQUIREMENT_STATUS_PLANNED,
   REQUIREMENT_STATUS_LIVE,
   REQUIREMENT_STATUS_PARTIAL,
   REQUIREMENT_STATUS_ABANDONED,
@@ -58,13 +63,37 @@ export type RequirementStatus = (typeof REQUIREMENT_STATUSES)[number];
 
 /** Statuses whose implementing nodes are supposed to still exist. A dangling
  *  `@implementedBy` on one of these means the model moved and the requirement is
- *  stale; on the other two the nodes are supposed to be GONE, which is the whole
- *  point of the entry. The asymmetry inverts as a pair. */
+ *  stale. On `planned` the nodes do not exist YET; on `abandoned`/`superseded`
+ *  they are supposed to be GONE — which is the whole point of those entries. */
 export const REQUIREMENT_STATUSES_REQUIRING_LIVE_NODES: readonly RequirementStatus[] = [
   REQUIREMENT_STATUS_LIVE,
   REQUIREMENT_STATUS_PARTIAL,
 ];
 
+/** Statuses with outstanding work, so a `@disposition` is meaningful on them.
+ *  On any other status the decision IS the status, and recording a second one
+ *  can only agree with it or contradict it. */
+export const REQUIREMENT_STATUSES_WITH_OUTSTANDING_WORK: readonly RequirementStatus[] = [
+  REQUIREMENT_STATUS_PLANNED,
+  REQUIREMENT_STATUS_PARTIAL,
+];
+
+// ---------------------------------------------------------------------------
+// Disposition — what was DECIDED about the outstanding work. Orthogonal to
+// status, which says whether the work is done. Absent means UNDECIDED, and that
+// is the state a review exists to find; collapsing it into the status enum
+// would make "there is a gap" and "we chose to live with it" the same fact.
+// ---------------------------------------------------------------------------
+
+export const REQUIREMENT_DISPOSITION_ACCEPTED = "accepted";
+export const REQUIREMENT_DISPOSITION_DEFERRED = "deferred";
+
+export const REQUIREMENT_DISPOSITIONS = [
+  REQUIREMENT_DISPOSITION_ACCEPTED,
+  REQUIREMENT_DISPOSITION_DEFERRED,
+] as const;
+export type RequirementDisposition = (typeof REQUIREMENT_DISPOSITIONS)[number];
+
 // ---------------------------------------------------------------------------
 // Levels — organisational above the link floor, model-referencing at or below.
 // ---------------------------------------------------------------------------

package/src/core/requirement/requirement-definition.embedded.ts

@@ -13,7 +13,7 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
       "type": "requirement",
       "subType": "functional",
       "description": "What the product does for a user, stated as one violable claim. Its check is EXISTENCE: it fails when nothing implements it. Hierarchy is nesting — an L1 solution contains its L2 segments, which contain L3 services, and so on down to the levels that reference the model.",
-      "whenToUse": "Something exists because someone asked for it. Levels: 1 solution, 2 segment (an application or library), 3 service, 4 object, 5 member. Only L4 and L5 carry @implementedBy — L1-L3 are organisational and never reference the model.",
+      "whenToUse": "Something exists because someone asked for it. L1-L3 are levels of ABSTRACTION AND OWNERSHIP in the problem domain — whose need is this, and at what altitude — and are never a directory, package, deployable or module. Binding to technical constructs happens only at L4 (an object) and L5 (a member), which is the allocation step. Test every node: if a refactor that changes no behaviour would force it to move, its level is wrong.",
       "children": [
         {
           "type": "attr",
@@ -21,7 +21,7 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "name": "level",
           "min": 1,
           "max": 1,
-          "description": "1 solution, 2 segment (application/library), 3 service, 4 object, 5 member. Nesting depth must agree with it."
+          "description": "1 solution, 2 segment, 3 service, 4 object, 5 member. L1-L3 are levels of abstraction and ownership in the problem domain, NOT of code structure. Nesting depth must agree with it; skipping a level is legal, going back up is not."
         },
         {
           "type": "attr",
@@ -30,12 +30,34 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "min": 1,
           "max": 1,
           "allowedValues": [
+            "planned",
             "live",
             "partial",
             "abandoned",
             "superseded"
           ],
-          "description": "live implemented and in use; partial implemented with known gaps; abandoned built then deliberately retired; superseded replaced by a different mechanism. A dangling @implementedBy is an ERROR on live/partial (the model moved, the requirement is stale) and ALLOWED on abandoned/superseded (those nodes are meant to be gone — that is the entry doing its job)."
+          "description": "planned intended but not built yet; live implemented and in use; partial implemented with known gaps; abandoned built then deliberately retired; superseded replaced by a different mechanism. A dangling @implementedBy is an ERROR on live/partial (the model moved, the requirement is stale) and ALLOWED on planned/abandoned/superseded — on planned the nodes do not exist YET, on the other two they are meant to be gone, and that is the entry doing its job. A planned requirement also never contributes to object coverage: planning a capability must not silence the warning that nothing implements it."
+        },
+        {
+          "type": "attr",
+          "subType": "string",
+          "name": "disposition",
+          "min": 0,
+          "max": 1,
+          "allowedValues": [
+            "accepted",
+            "deferred"
+          ],
+          "description": "What has been DECIDED about outstanding work — a different question from whether the work is done, which is what @status answers. accepted: the gap is understood and deliberately not being closed. deferred: it will be closed, but not now. ABSENT MEANS UNDECIDED, which is a real and useful state — it is what an unreviewed gap looks like, and it is the one a review should be able to find. Meaningful on planned and partial only; on a status with no outstanding work it is a WARNING. Deliberately NOT a workflow vocabulary: which sprint, who owns it and whether it is in progress belong in the tracker named by @trackedBy, because two systems holding that answer will drift and only one of them is refreshed daily."
+        },
+        {
+          "type": "attr",
+          "subType": "string",
+          "name": "trackedBy",
+          "isArray": true,
+          "min": 0,
+          "max": 1,
+          "description": "Issue or ticket references for outstanding work — a URL, an owner/repo#123 shorthand, or a tracker key. Free-form and NOT resolved by verify, which does not reach the network; unlike @verifiedBy, nothing here is checked to exist. Its job is to stop a deferred gap becoming invisible, so verify warns when a deferred requirement names no ticket. Also the right place to link the ticket that a planned requirement will be built under."
         },
         {
           "type": "attr",
@@ -69,7 +91,7 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "isArray": true,
           "min": 0,
           "max": 1,
-          "description": "Names of the tests proving the behaviour. verify checks each exists and is not skipped; it never runs them."
+          "description": "OPTIONAL — omit unless you have opened the test and read what it asserts. Names of tests that assert the behaviour. verify checks each name EXISTS and is not skipped; it never runs them, and it cannot tell whether the named test verifies this requirement — any occurrence in the test corpus satisfies it."
         },
         {
           "type": "attr",
@@ -92,9 +114,17 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
     {
       "type": "requirement",
       "subType": "architectural",
-      "description": "How the system is built, applied uniformly across the model. Its check is UNIVERSALITY: it fails when something VIOLATES it, which is the opposite polarity to a functional requirement. Carries no level and no parent — levels come from object-in-focus decomposition and an architectural requirement is object-independent by definition.",
-      "whenToUse": "Something exists because every entity here looks like this — a uuid primary key, an @autoSet createdAt, a change-attribution column, tenant scoping. The discriminator is mechanical: did this exist because someone asked for something, or because it is the architecture?",
+      "description": "How the system is built, applied uniformly across the model. Its check is UNIVERSALITY: it fails when something VIOLATES it, which is the opposite polarity to a functional requirement. Flat by default and object-independent; it may optionally sit in a levelled tree when a quality taxonomy is being used to organise non-functional requirements.",
+      "whenToUse": "Something exists because every entity here looks like this — a uuid primary key, an @autoSet createdAt, a change-attribution column, tenant scoping. The discriminator is mechanical: did this exist because someone asked for something, or because it is the architecture? For a non-functional tree, an established quality taxonomy makes a good fixed upper structure (e.g. an ISO/IEC 25010 characteristic at L1, its sub-characteristic or a control-catalogue category at L2), with the model-binding claims at L4 and L5 as usual.",
       "children": [
+        {
+          "type": "attr",
+          "subType": "int",
+          "name": "level",
+          "min": 0,
+          "max": 1,
+          "description": "OPTIONAL here, unlike on a functional requirement where it is required. ABSENT means a flat, object-independent policy that may reference the model directly — the original and still the default form. PRESENT means this node sits in a levelled tree, and then the same rules as functional apply: nesting must agree with the level, and only L4/L5 may carry @implementedBy. Levelling is opt-in so that adding a taxonomy on top of existing flat policies does not invalidate them."
+        },
         {
           "type": "attr",
           "subType": "string",
@@ -102,12 +132,34 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "min": 1,
           "max": 1,
           "allowedValues": [
+            "planned",
             "live",
             "partial",
             "abandoned",
             "superseded"
           ],
-          "description": "As on requirement.functional. A live or partial architectural requirement claimed by NOTHING is an error: a policy declared and applied to nothing."
+          "description": "As on requirement.functional. A live or partial architectural requirement claimed by NOTHING is an error: a policy declared and applied to nothing. A planned one is exempt from that check — it is not applied yet by definition."
+        },
+        {
+          "type": "attr",
+          "subType": "string",
+          "name": "disposition",
+          "min": 0,
+          "max": 1,
+          "allowedValues": [
+            "accepted",
+            "deferred"
+          ],
+          "description": "As on requirement.functional. On an architectural requirement, accepted is the common and important case: a policy that is genuinely not universal, where the exceptions are known and tolerated, is more honest as partial+accepted than as a live claim nobody audits."
+        },
+        {
+          "type": "attr",
+          "subType": "string",
+          "name": "trackedBy",
+          "isArray": true,
+          "min": 0,
+          "max": 1,
+          "description": "As on requirement.functional. Issue or ticket references for outstanding work; free-form, not resolved."
         },
         {
           "type": "attr",
@@ -134,6 +186,15 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "max": 1,
           "description": "FQN references to the nodes applying this policy. High fan-out is normal and expected: one uuid-primary-key requirement is claimed by every entity."
         },
+        {
+          "type": "attr",
+          "subType": "string",
+          "name": "verifiedBy",
+          "isArray": true,
+          "min": 0,
+          "max": 1,
+          "description": "OPTIONAL — omit unless you have opened the test and read what it asserts. Names of tests that assert the policy holds. verify checks each name EXISTS and is not skipped; it never runs them, and it cannot tell whether the named test verifies this requirement — any occurrence in the test corpus satisfies it."
+        },
         {
           "type": "attr",
           "subType": "string",
@@ -141,6 +202,14 @@ export const REQUIREMENT_DEFINITION: ProviderDefinition = {
           "min": 0,
           "max": 1,
           "description": "The requirement that replaced this one. Expected on status=superseded."
+        },
+        {
+          "type": "requirement",
+          "subType": "*",
+          "name": "*",
+          "min": 0,
+          "max": null,
+          "description": "Nested child requirements. Present so a non-functional tree can be organised by a quality taxonomy the same way a functional tree is organised by capability — the absence of this rule, while requirement.functional had it, is what previously made an architectural node nestable UNDER a functional one but never under another architectural one."
         }
       ]
     }