@sdd-method/maintain-cli 0.8.0 → 0.10.0

package/dist/lib/catalogue/builders/screens.js

@@ -1,4 +1,4 @@
-// Screens builder — emits the UI screens catalogue family (per ADR 0166):
+// Screens builder — emits the UI screens catalogue family (per M-ADR 0166):
 //   screens, ui_components, screen_component, screen_feature,
 //   persona_screen, screen_action.
 //
@@ -7,7 +7,7 @@
 //   ---
 //   screen: <slug>            # optional; defaults to filename stem
 //   route: /path              # optional
-//   status: working           # optional (ADR 0165 maturity vocabulary)
+//   status: working           # optional (M-ADR 0165 maturity vocabulary)
 //   persona_access: [<persona-slug>, ...]   # -> persona_screen
 //   realises: [<feature-slug>, ...]         # -> screen_feature
 //   ---
@@ -25,7 +25,7 @@
 // toolkit projects an app's router + component tree into the same shape (the
 // upstream step that produces these artefacts).
 //
-// Per ADR 0135 the rows are identical regardless of authoring direction; only
+// Per M-ADR 0135 the rows are identical regardless of authoring direction; only
 // the `source` discriminator differs (screen-spec vs screen-extraction).
 //
 // Application-product profile. Like personas, the walker reads `screens/` at
@@ -36,9 +36,9 @@ import { basename, join } from "node:path";
 import { parse as parseYaml } from "yaml";
 import { analyzeComposition, maskStringLiterals, stripBlockComments } from "./screen-tree.js";
 import { isContainerArchetype } from "../archetype/resolver.js";
-/** Method default for the flat-composition threshold (ADR 0168 §4.2). */
+/** Method default for the flat-composition threshold (M-ADR 0168 §4.2). */
 const DEFAULT_FLAT_THRESHOLD = 6;
-/** The only maturity value that asserts a faithful, complete composition (ADR 0168 §4.3). */
+/** The only maturity value that asserts a faithful, complete composition (M-ADR 0168 §4.3). */
 const COMPLETENESS_STATUS = "working";
 const SCREENS_DIR_REL = "screens";
 /** Subdir of screens/ holding rendered wireframe artifacts — never screen specs. */
@@ -72,7 +72,7 @@ async function collectScreenSpecFiles(dir) {
     await walk("");
     return out.sort();
 }
-// Recognised standard maturity vocabulary (ADR 0165); other values pass through.
+// Recognised standard maturity vocabulary (M-ADR 0165); other values pass through.
 const STANDARD_MATURITY = new Set(["working", "provisional", "unknown", "absent"]);
 export async function buildScreens(inputs) {
     const screens = [];
@@ -105,7 +105,7 @@ export async function buildScreens(inputs) {
         }
         const name = extractH1(text) || (typeof fm.name === "string" ? fm.name : stem);
         const status = typeof fm.status === "string" && fm.status !== "" ? maturity(fm.status, inputs.findings, screenId) : "";
-        // Direction discriminator (ADR 0135): forward authoring is `screen-spec`,
+        // Direction discriminator (M-ADR 0135): forward authoring is `screen-spec`,
         // reverse extraction `screen-extraction`. Read from frontmatter, default
         // forward; only these two are recognised (others pass through, flagged).
         const source = screenSource(fm.source, inputs.findings, screenId);
@@ -130,7 +130,7 @@ export async function buildScreens(inputs) {
             evidence_class: evidenceClass(fm),
             source_sdd_id: "",
         });
-        // Evidence integrity (ADR 0168 §4.2, defect f): a reverse-extracted screen
+        // Evidence integrity (M-ADR 0168 §4.2, defect f): a reverse-extracted screen
         // must cite its route + component evidence with a `[^…]` footnote. Forward-
         // authored screens make no such claim, so the check is reverse-scoped.
         if (source === "screen-extraction" && !/\[\^[^\]]+\]/.test(text)) {
@@ -142,7 +142,7 @@ export async function buildScreens(inputs) {
         }
         else {
             // Strip inline `#` comments before any scan so a `Capitalised(` token in a
-            // comment can't emit a phantom component (ADR 0168 §4.4, defect g).
+            // comment can't emit a phantom component (M-ADR 0168 §4.4, defect g).
             const clean = stripBlockComments(block);
             // Component invocations: Capitalised call heads (e.g. Stack(, StatCard().
             // Local id references (lowercase, no parens) and list literals are skipped.
@@ -168,12 +168,12 @@ export async function buildScreens(inputs) {
                 const aKey = `${screenId}__${screenSlug(action)}`;
                 if (!screenAction.has(aKey)) {
                     // event_id left empty: external-capable, resolved against the event
-                    // catalogue when an explicit mapping exists (best-effort per ADR 0166).
+                    // catalogue when an explicit mapping exists (best-effort per M-ADR 0166).
                     screenAction.set(aKey, { id: aKey, screen_id: screenId, action, event_id: "", source_sdd_id: "" });
                 }
             }
-            // Composition-depth validation (ADR 0168): structural fidelity floor +
-            // status gate + the archetype-aware root check (ADR 0169). The vocabulary-
+            // Composition-depth validation (M-ADR 0168): structural fidelity floor +
+            // status gate + the archetype-aware root check (M-ADR 0169). The vocabulary-
             // free checks reason about tree shape + status only; root-is-leaf consults
             // the archetype map when the screen declares a `platform:`.
             const platform = typeof fm.platform === "string" ? fm.platform : undefined;
@@ -192,7 +192,7 @@ export async function buildScreens(inputs) {
             if (!fid) {
                 // App/integration screens can realise a platform-resident feature
                 // (MFE-over-platform: the platform owns the capability tree and its
-                // features — ADR 0177 single-slug). Emit a deferred cross-SDD edge
+                // features — M-ADR 0177 single-slug). Emit a deferred cross-SDD edge
                 // carrying the bare realises slug; the aggregator resolves it to the
                 // platform feature id, and the FK validator logs it `[finding] external`
                 // for this build (screen_feature.feature_id is external_for_profiles).
@@ -261,24 +261,24 @@ function emitDepthFindings(findings, screenId, status, m, ctx) {
         findings.add("coverage", `screen ${screenId}: composition is flat — root has ${m.rootChildCount} children at depth ${m.maxDepth} (screen-flat-composition)`);
     }
     // Status gate (keystone): `working` is the only maturity that asserts a
-    // faithful, complete composition (ADR 0168 §4.3). provisional/unknown/absent
+    // faithful, complete composition (M-ADR 0168 §4.3). provisional/unknown/absent
     // make no completeness claim and are not gated.
     if (status === COMPLETENESS_STATUS && (empty || flat)) {
         findings.add("convention", `screen ${screenId}: status "${COMPLETENESS_STATUS}" exceeds composition depth — block is ${empty ? "empty" : "flat"} (screen-status-exceeds-depth)`, "error");
     }
-    // Mis-rooted (ADR 0168 §4.2 screen-root-is-leaf, archetype-aware per ADR 0169):
+    // Mis-rooted (M-ADR 0168 §4.2 screen-root-is-leaf, archetype-aware per M-ADR 0169):
     // root is a leaf/control rather than a screen container. isContainer combines
     // the appears-with-children heuristic (containers) with the archetype map.
     // Only fires when the screen declares a known `platform:` — without a map the
     // heuristic alone can't distinguish an empty container root (Stack([])) from a
-    // genuine leaf root (Button([])), so the check no-ops (ADR 0168 §4.5).
+    // genuine leaf root (Button([])), so the check no-ops (M-ADR 0168 §4.5).
     if (m.rootComponent !== "" && m.rootChildCount === 0) {
         const byMap = isContainerArchetype(m.rootComponent, platform, overlay);
         if (byMap === false && !m.containers.has(m.rootComponent)) {
             findings.add("convention", `screen ${screenId}: root component "${m.rootComponent}" is a leaf, not a container (screen-root-is-leaf)`, "error");
         }
     }
-    // Styling-primitive leakage (ADR 0168 §4.2 screen-styling-primitive-as-structure):
+    // Styling-primitive leakage (M-ADR 0168 §4.2 screen-styling-primitive-as-structure):
     // an adopter-flagged decorative primitive composed as a structural component.
     // No-ops when the adopter declares no decorative set.
     if (decorativePrimitives !== undefined && decorativePrimitives.size > 0) {
@@ -317,7 +317,7 @@ function screenSlug(s) {
 function normalise(s) {
     return s.trim().toLowerCase().replace(/\s+/g, " ");
 }
-// Recognised direction discriminators (ADR 0135). Others pass through flagged.
+// Recognised direction discriminators (M-ADR 0135). Others pass through flagged.
 const SCREEN_SOURCES = new Set(["screen-spec", "screen-extraction"]);
 function screenSource(value, findings, screenId) {
     if (typeof value !== "string" || value.trim() === "")

package/dist/lib/catalogue/builders/service-contract-consumes.js

@@ -22,7 +22,7 @@
 //      the platform-root SDD validates internally first per the fk-validator
 //      optimistic-resolve rule.
 //
-// Pattern documented in sdd-method ADR 0147.
+// Pattern documented in sdd-method M-ADR 0147.
 import { readFile, readdir } from "node:fs/promises";
 import { join } from "node:path";
 const REPOS_DIR_REL = "repos";

package/dist/lib/catalogue/builders/service-entity-tables.js

@@ -1,8 +1,8 @@
 // Primary reverse-method walker for the service_entity edge catalogue per
-// ADR 0159 §4.5. Reads per-domain `## Data Store Mapping` markdown tables in
+// M-ADR 0159 §4.5. Reads per-domain `## Data Store Mapping` markdown tables in
 // `docs/domains/{domain}/architecture/data-model.mermaid.md` files.
 //
-// Prototype findings (per ADR 0159 — data-store-mapping table variations):
+// Prototype findings (per M-ADR 0159 — data-store-mapping table variations):
 // - Two heading variants: `## Data Store Mapping` and `## Data Store Inventory`
 //   (the latter is store-centric — different schema, no Entity column — and
 //   gets skipped with a convention finding).
@@ -14,7 +14,7 @@
 // - Cross-domain entity references in tables resolve against entities.csv
 //   from any domain (not just the table's own domain) — same-domain first.
 //
-// Service-name resolution rules (ADR 0159 §4.7):
+// Service-name resolution rules (M-ADR 0159 §4.7):
 // 1. Try alias-map exact match (case-insensitive on display name).
 // 2. Try entitySlug(display_name) ⋈ entitySlug(services.name).
 // 3. Try entitySlug(display_name) ⋈ last_segment(services.id).

package/dist/lib/catalogue/builders/services.js

@@ -10,7 +10,7 @@
 // 0197 §4.1 — a dangling reference to it resolves to an orphan finding
 // elsewhere, not a crash here).
 //
-// Per ADR 0134 + Q7.1 resolution, runtime kinds are
+// Per M-ADR 0134 + Q7.1 resolution, runtime kinds are
 // {api_service, worker, gateway, frontend, mobile} — read from the
 // canonical schema's enums.service_type block where
 // `emits_service_row: true`. The runtime-kind gate applies only to the
@@ -29,13 +29,13 @@
 // service-architecture-parser module.
 //
 // The `description` column has two authoring sources, honoured per the
-// forward/reverse parity principle (ADR 0157, extended to node columns by
-// ADR 0163):
+// forward/reverse parity principle (M-ADR 0157, extended to node columns by
+// M-ADR 0163):
 //   - forward: `orchestration/repo-config/<repo>.yaml` `description:` —
 //     the deliberate spec, authored by forward-method adopters.
 //   - reverse: the arch doc's `## Purpose` lead paragraph.
 // When both are present for the same service the forward repo-config
-// description wins (matching the ADR 0156 / 0162 merge convention) and a
+// description wins (matching the M-ADR 0156 / 0162 merge convention) and a
 // `divergence` finding records the conflict. In practice an adopter has
 // only one of the two, so this is usually a plain coalesce.
 //
@@ -111,7 +111,7 @@ export async function buildServices(inputs) {
     // repos/<group>/<repo>/docs/..., so a recursive walk is required.
     // Services whose architecture doc lives in a federated member SDD (rather
     // than this SDD's own repos/) resolve to no entry here — their metadata is
-    // an aggregation-time concern (ADR 0163 P2), not a local build gap.
+    // an aggregation-time concern (M-ADR 0163 P2), not a local build gap.
     const archIndex = await indexServiceArchitectures(inputs.sddPath);
     const repoDescriptions = inputs.repoDescriptions ?? new Map();
     const declaredByRepo = inputs.declaredServicesByRepo ?? new Map();

package/dist/lib/catalogue/builders/system-external-dependency.js

@@ -1,12 +1,12 @@
 // system_external_dependency edge builder — emits one row per
 // `Rel(...)` line on an L1/L2 diagram that connects the SDD's own system
-// (or one of its containers) to an external system (per ADR 0155).
+// (or one of its containers) to an external system (per M-ADR 0155).
 //
 // Resolution: the c4-external-systems builder supplies `externalIdByEntryId`
 // (diagram entry-id → ext-... row id). For each `Rel(a, b, "label")` where
 // exactly one endpoint is a known external entry-id, we emit an edge from
 // the SDD's c4_systems row to that external system. Container-level external
-// dependencies are intentionally collapsed to the system level — ADR 0155
+// dependencies are intentionally collapsed to the system level — M-ADR 0155
 // §4.2 keeps the edge system-scoped.
 import { readFile } from "node:fs/promises";
 import { collectC4DiagramFiles } from "./c4-external-systems.js";

package/dist/lib/catalogue/canonical-schema.yaml

@@ -7,7 +7,7 @@
 # Emitted by sdd-cli's YAML emitter with no line folding; the three header scalars are quoted for the
 # textual readers downstream. The one deliberate difference from the authored form is schema_status:
 # the authored form says canonical; a projection never does.
-schema_version: "4.1.0"
+schema_version: "4.2.0"
 schema_owner: "sdd-method"
 schema_status: "generated"
 enums:
@@ -643,6 +643,31 @@ enums:
     - value: observed
       description: Independent evidence from this repository's code matches (a baseline's characterization tests or a reverse snapshot).
     description: A requirement's status in one implementing repository (M-ADR 0221 §4.5).
+  change_status:
+    values:
+    - value: proposed
+      description: Open, with a proposed agreement record or none yet.
+    - value: agreed
+      description: "Open, with an agreed record: being built."
+    - value: superseded
+      description: Open, its record superseded by another change.
+    - value: withdrawn
+      description: Open, its record withdrawn.
+    - value: archived
+      description: Archived into the living specs.
+    description: Where a change stands (M-ADR 0222 §4.6, M-ADR 0223 §4.6).
+  judge_verdict:
+    values:
+    - value: PASS
+    - value: FAIL
+    description: The judge's verdict on a change (M-ADR 0223 §4.5).
+  work_order_status:
+    values:
+    - value: agreed
+      description: Agreed; the repository's work is not yet judged.
+    - value: completed
+      description: Marked completed by a passing judge.
+    description: A work order's status in its change's agreement record (M-ADR 0223 §4.2, §4.6).
 catalogues:
   domains:
     primary_key: id
@@ -4200,7 +4225,7 @@ catalogues:
     - name: change_id
       type: string
       nullable: false
-      description: The archived change's directory name (its archive date prefix included).
+      description: The archived change's directory name (its archive date prefix included); a changes.id.
     - name: change_kind
       type: string
       nullable: false
@@ -4226,6 +4251,9 @@ catalogues:
     - column: requirement_id
       references: requirements.id
       nullable: false
+    - column: change_id
+      references: changes.id
+      nullable: false
     column_enums:
       change_kind: enums.requirement_change_kind
       operation: enums.requirement_operation
@@ -4269,3 +4297,111 @@ catalogues:
       nullable: false
     column_enums:
       status: enums.requirement_status_value
+  changes:
+    primary_key: id
+    columns:
+    - name: id
+      type: string
+      nullable: false
+      description: "The change's directory name: the open change's name, or the archived change's directory (its archive date prefix included). requirement_lineage.change_id references it."
+    - name: name
+      type: string
+      nullable: false
+      description: "The change's name without the archive date prefix: the same before and after archive, so a work item that cites the change keeps its link."
+    - name: change_kind
+      type: string
+      nullable: false
+      description: "Bound to requirement_change_kind: baseline (it carries baseline-evidence.md) or change."
+    - name: status
+      type: string
+      nullable: false
+      description: "Bound to change_status: archived for an archived change; otherwise the agreement record's status, or proposed when there is no record yet."
+    - name: archived_on
+      type: string
+      nullable: true
+      description: The archive date (YYYY-MM-DD) from the archived change's directory name; empty for an open change.
+    - name: verdict
+      type: string
+      nullable: true
+      description: "Bound to judge_verdict: the agreement record's verdict result (M-ADR 0223 §4.6). Empty for a baseline, and for a change not yet judged."
+    - name: source_sdd_id
+      type: string
+      nullable: true
+      description: Originating SDD (stamped at aggregation; empty in a per-SDD build).
+    - name: platform_sdd_id
+      type: string
+      nullable: true
+      description: The platform SDD the row belongs to (stamped at aggregation).
+    description: "A change in the SDD's behaviour store (M-ADR 0223 §4.2), open or archived, including baseline changes. Derived, never authored: from the store's change directories and their agreement records (M-ADR 0222 §4.6)."
+    column_enums:
+      change_kind: enums.requirement_change_kind
+      status: enums.change_status
+      verdict: enums.judge_verdict
+  change_work_order:
+    primary_key: id
+    columns:
+    - name: id
+      type: string
+      nullable: false
+      description: <change_id>__<repo_id>.
+    - name: change_id
+      type: string
+      nullable: false
+    - name: repo_id
+      type: string
+      nullable: false
+      description: The repository the work order is for.
+    - name: status
+      type: string
+      nullable: false
+      description: "Bound to work_order_status: the record's status for the work order; a judge PASS marks it completed (M-ADR 0223 §4.6)."
+    - name: source_sdd_id
+      type: string
+      nullable: true
+      description: Originating SDD (stamped at aggregation; empty in a per-SDD build).
+    - name: platform_sdd_id
+      type: string
+      nullable: true
+      description: The platform SDD the row belongs to (stamped at aggregation).
+    description: "Edge: a change's work order for one implementing repository (M-ADR 0223 §4.2), from the change's agreement record. Derived, never authored."
+    foreign_keys:
+    - column: change_id
+      references: changes.id
+      nullable: false
+    - column: repo_id
+      references: repositories.id
+      nullable: false
+    column_enums:
+      status: enums.work_order_status
+  change_work_item:
+    primary_key: id
+    columns:
+    - name: id
+      type: string
+      nullable: false
+      description: "<change_name>__<work_item_id>: keyed by the change's undated name, so the row is the same before and after archive."
+    - name: change_id
+      type: string
+      nullable: false
+      description: "The change as it stands now: its open name, or its archive directory."
+    - name: change_name
+      type: string
+      nullable: false
+      description: The change's undated name.
+    - name: work_item_id
+      type: string
+      nullable: false
+      description: The work item's id in the adopter's work-item tool, as the proposal's Work Items section gives it.
+    - name: source_sdd_id
+      type: string
+      nullable: true
+      description: Originating SDD (stamped at aggregation; empty in a per-SDD build).
+    - name: platform_sdd_id
+      type: string
+      nullable: true
+      description: The platform SDD the row belongs to (stamped at aggregation).
+    description: "Annotation: a work item a change's proposal says it delivers (M-ADR 0223 §4.2), giving the roll-up from work item to changes to requirements. The work item's id is the adopter's work-item tool's (M-ADR 0035), so it has no foreign key."
+    foreign_keys:
+    - column: change_id
+      references: changes.id
+      nullable: false

package/dist/lib/catalogue/coverage-render.js

@@ -281,47 +281,47 @@ export function renderContractCoverage(res, tier) {
 }
 // ─── the nine Phase-0 gate checks ────────────────────────────────────────
 export function renderEventCatalogueCheck(gaps) {
-    return gaps.map((g) => `[finding] coverage: domain ${g.domain} event-catalog.yaml declares ${g.declared} events but events.csv contains ${g.emitted} rows for that domain (per ADR 0156 Phase 0)`);
+    return gaps.map((g) => `[finding] coverage: domain ${g.domain} event-catalog.yaml declares ${g.declared} events but events.csv contains ${g.emitted} rows for that domain (per M-ADR 0156 Phase 0)`);
 }
 export function renderRepoEdgesCheck(res) {
     const lines = [];
     if (res.repoCapabilityGap) {
         const g = res.repoCapabilityGap;
-        lines.push(`[finding] coverage: repo_capability.csv is empty but ${g.capabilityService} capability_service rows + ${g.servicesWithRepo} services with primary_repo_id present — reverse-method derivation likely missing (per ADR 0157 §4.3, Phase 0)`);
+        lines.push(`[finding] coverage: repo_capability.csv is empty but ${g.capabilityService} capability_service rows + ${g.servicesWithRepo} services with primary_repo_id present — reverse-method derivation likely missing (per M-ADR 0157 §4.3, Phase 0)`);
     }
     if (res.repoContractForwardGap) {
         const g = res.repoContractForwardGap;
-        lines.push(`[finding] coverage: repo_contract.csv is empty but ${g.contracts} contracts and ${g.repoConfigsWithContracts} repo-configs with contracts: blocks present — forward-method derivation likely missing (per ADR 0157 §4.2, Phase 0)`);
+        lines.push(`[finding] coverage: repo_contract.csv is empty but ${g.contracts} contracts and ${g.repoConfigsWithContracts} repo-configs with contracts: blocks present — forward-method derivation likely missing (per M-ADR 0157 §4.2, Phase 0)`);
     }
     if (res.repoContractPathXGap) {
         const g = res.repoContractPathXGap;
-        lines.push(`[finding] coverage: repo_contract.csv is empty but ${g.serviceContracts} service_contract rows + ${g.servicesWithRepo} services with primary_repo_id present — reverse-method Path X (service_contract ⋈ services.primary_repo_id) derivation likely missing (per ADR 0157 §4.2, Phase 0)`);
+        lines.push(`[finding] coverage: repo_contract.csv is empty but ${g.serviceContracts} service_contract rows + ${g.servicesWithRepo} services with primary_repo_id present — reverse-method Path X (service_contract ⋈ services.primary_repo_id) derivation likely missing (per M-ADR 0157 §4.2, Phase 0)`);
     }
     if (res.repoContractReverseGap) {
         const g = res.repoContractReverseGap;
-        lines.push(`[finding] coverage: repo_contract.csv is empty with ${g.contracts} contracts present and no repo-config.contracts: blocks or service_contract rows — reverse-method derivation via contracts.source_repo_id likely missing (per ADR 0157 §4.2, Phase 0)`);
+        lines.push(`[finding] coverage: repo_contract.csv is empty with ${g.contracts} contracts present and no repo-config.contracts: blocks or service_contract rows — reverse-method derivation via contracts.source_repo_id likely missing (per M-ADR 0157 §4.2, Phase 0)`);
     }
     return lines;
 }
 export function renderGlossaryXrefCheck(finding) {
     return finding
         ? [
-            `[finding] coverage: docs/platform/reference/glossary-alignment-manifest.yaml exists but glossary_xref.csv emits 0 rows — multi-source derivation likely missing (per ADR 0158 §4.5, Phase 0)`,
+            `[finding] coverage: docs/platform/reference/glossary-alignment-manifest.yaml exists but glossary_xref.csv emits 0 rows — multi-source derivation likely missing (per M-ADR 0158 §4.5, Phase 0)`,
         ]
         : [];
 }
 export function renderDataModelEntitiesCheck(res) {
     const lines = [];
     if (res.entitiesGap) {
-        lines.push(`[finding] coverage: ${res.entitiesGap.domainModels} domain-model files catalogued but entities.csv emits 0 rows — reverse-method entity extraction missing (per ADR 0159 Phase 0)`);
+        lines.push(`[finding] coverage: ${res.entitiesGap.domainModels} domain-model files catalogued but entities.csv emits 0 rows — reverse-method entity extraction missing (per M-ADR 0159 Phase 0)`);
     }
     if (res.serviceEntityGap) {
         const g = res.serviceEntityGap;
-        lines.push(`[finding] coverage: ${g.entities} entities + ${g.services} services catalogued but service_entity.csv emits 0 rows — Data Store Mapping ingestion missing (per ADR 0159 Phase 0)`);
+        lines.push(`[finding] coverage: ${g.entities} entities + ${g.services} services catalogued but service_entity.csv emits 0 rows — Data Store Mapping ingestion missing (per M-ADR 0159 Phase 0)`);
     }
     if (res.containerEntityGap) {
         const g = res.containerEntityGap;
-        lines.push(`[finding] coverage: ${g.containersWithService} containers map to services + ${g.serviceEntity} service_entity edges present but c4_container_entity.csv emits 0 rows — Phase 3 derivation missing (per ADR 0159 Phase 0)`);
+        lines.push(`[finding] coverage: ${g.containersWithService} containers map to services + ${g.serviceEntity} service_entity edges present but c4_container_entity.csv emits 0 rows — Phase 3 derivation missing (per M-ADR 0159 Phase 0)`);
     }
     return lines;
 }
@@ -329,24 +329,24 @@ export function renderCapabilityEventCheck(res) {
     const lines = [];
     if (res.derivableGap) {
         const g = res.derivableGap;
-        lines.push(`[finding] coverage: service_event (${g.serviceEvent}) + capability_service (${g.capabilityService}) populated but capability_event emits 0 rows — reverse-derivable edge missing (per ADR 0160 Phase 0)`);
+        lines.push(`[finding] coverage: service_event (${g.serviceEvent}) + capability_service (${g.capabilityService}) populated but capability_event emits 0 rows — reverse-derivable edge missing (per M-ADR 0160 Phase 0)`);
     }
     if (res.authoredGap) {
-        lines.push(`[finding] coverage: capability_event has ${res.authoredGap.derived} derived rows but 0 authored rows — no traceability.events[] or traceability.contracts.{published,consumed}_events declarations are landing in the catalogue. Governance queries filtering to source=authored will return empty (per ADR 0160 Phase 0)`);
+        lines.push(`[finding] coverage: capability_event has ${res.authoredGap.derived} derived rows but 0 authored rows — no traceability.events[] or traceability.contracts.{published,consumed}_events declarations are landing in the catalogue. Governance queries filtering to source=authored will return empty (per M-ADR 0160 Phase 0)`);
     }
     return lines;
 }
 export function renderFeatureEventCheck(res) {
     return res.gap
         ? [
-            `[finding] coverage: service_event (${res.gap.serviceEvent}) + feature_service (${res.gap.featureService}) populated but feature_event emits 0 rows — reverse-derivable edge missing (per ADR 0161 Phase 0)`,
+            `[finding] coverage: service_event (${res.gap.serviceEvent}) + feature_service (${res.gap.featureService}) populated but feature_event emits 0 rows — reverse-derivable edge missing (per M-ADR 0161 Phase 0)`,
         ]
         : [];
 }
 export function renderPlatformDependenciesCheck(finding) {
     return finding
         ? [
-            `[finding] coverage: app-platform-dependencies.yaml declares a platform_dependencies block but product_platform_dependencies.csv emits 0 rows — forward-method ingestion missing (per ADR 0162 Phase 0). Resolves once the builder reads the forward source.`,
+            `[finding] coverage: app-platform-dependencies.yaml declares a platform_dependencies block but product_platform_dependencies.csv emits 0 rows — forward-method ingestion missing (per M-ADR 0162 Phase 0). Resolves once the builder reads the forward source.`,
         ]
         : [];
 }
@@ -358,7 +358,7 @@ export function renderFeatureSpecPromotionCheck(res) {
         `[finding] coverage: ${f.intermediate} of ${f.total} features are reverse-intermediate ` +
             `(capability-spec/feature-grounding) not yet promoted to feature-spec — ` +
             `unresolvable as realises:/FK targets (${f.pctResolvable}% resolvable, ${f.note}; ` +
-            `per ADR 0177 §4.2)`,
+            `per M-ADR 0177 §4.2)`,
     ];
 }
 export function renderFeatureSurfaceDuplicationCheck(res) {
@@ -370,7 +370,7 @@ export function renderFeatureSurfaceDuplicationCheck(res) {
         `[finding] coverage: ${f.pairs} near-duplicate feature surface(s) across ` +
             `${f.capabilities} ${capWord} — a capability-spec (rollup) and feature-grounding ` +
             `(detailed) slug naming the same surface; reconcile to one slug per surface, ` +
-            `detailed slug canonical (per ADR 0177 §4.3)`,
+            `detailed slug canonical (per M-ADR 0177 §4.3)`,
     ];
 }
 // ─── Scores coverage (M-ADR 0205 §4.5, B2 — the fourteenth check) ─────────

package/dist/lib/catalogue/csv-writer.js

@@ -1,7 +1,7 @@
 /**
  * Deterministic CSV writer for catalogues.
  *
- * Emits headers + sorted rows per ADR 0134 builder contract:
+ * Emits headers + sorted rows per M-ADR 0134 builder contract:
  *   - column order matches the canonical schema exactly,
  *   - rows sorted by primary-key value,
  *   - cells with embedded comma/quote/newline are RFC-4180 quoted,

package/dist/lib/catalogue/feature-grounding-aliases-loader.js

@@ -1,6 +1,6 @@
 /**
  * Loader for the optional `.sdd/feature-grounding-aliases.yaml` config
- * per ADR 0143 (schema 2.5.0).
+ * per M-ADR 0143 (schema 2.5.0).
  *
  * Adopters use this map to translate display names in
  * `feature-grounding.md` tables (class names, file basenames, route

package/dist/lib/catalogue/findings.js

@@ -1,5 +1,5 @@
 /**
- * Findings collector for the canonical builder per ADR 0134 / builder-spec
+ * Findings collector for the canonical builder per M-ADR 0134 / builder-spec
  * §"Emit findings as it parses".
  *
  * Findings are human-readable AND machine-parseable. Format per finding:

package/dist/lib/catalogue/fk-validator.js

@@ -1,5 +1,5 @@
 /**
- * FK validator per ADR 0134 builder-spec §"Run internal FK validation
+ * FK validator per M-ADR 0134 builder-spec §"Run internal FK validation
  * before exiting" + §"External FK handling".
  *
  * For each catalogue's foreign keys:
@@ -9,7 +9,7 @@
  *   - External FKs (external=true, or external for the build's profile via
  *     `externalForProfiles` — schema 2.23.0): every non-empty value is logged
  *     as a `[finding] external` line and skipped from validation. The
- *     aggregator resolves these post-merge per ADR 0134 §4.5. A required
+ *     aggregator resolves these post-merge per M-ADR 0134 §4.5. A required
  *     (non-nullable) external FK still fails when EMPTY — the value must be
  *     named even if it resolves cross-SDD.
  *

package/dist/lib/catalogue/manifest-loader.js

@@ -223,8 +223,8 @@ const ManifestSchema = z.object({
     // shape here. Whether the value resolves against the active vocabulary
     // (method ∪ RA-bundle ∪ adopter) is checked in the build step, which has
     // the bundle cache. Absent reads as "unclassified" (with a finding). Named
-    // application_archetype to stay distinct from the ADR 0173 domain archetype
-    // and the ADR 0169 openui archetype.
+    // application_archetype to stay distinct from the M-ADR 0173 domain archetype
+    // and the M-ADR 0169 openui archetype.
     application_archetype: z
         .string()
         .regex(/^[a-z][a-z0-9-]*$/, {
@@ -298,7 +298,7 @@ export async function loadSddManifest(sddPath, options) {
         const code = err.code;
         if (code === "ENOENT") {
             throw new Error(`SDD manifest not found at ${sourcePath}\n\n` +
-                `Every SDD repo MUST declare an .sdd/sdd-manifest.yaml per ADR 0134 §4.6.\n` +
+                `Every SDD repo MUST declare an .sdd/sdd-manifest.yaml per M-ADR 0134 §4.6.\n` +
                 `Schema: docs/method/methods/sdd-manifest-schema.yaml in sdd-method.\n` +
                 `Bootstrap: \`sdd-cli init\` (when migrated to support manifest authoring).`);
         }

package/dist/lib/catalogue/rubric-coverage-map.yaml

@@ -905,3 +905,31 @@ coverage:
     kind: enum
     scoring: not-applicable
     reason: closed vocabulary, not an artefact
+  changes:
+    kind: entity
+    scoring: not-applicable
+    reason: projected from the behaviour store, whose change gate and judge hold its quality (M-ADR 0222, M-ADR 0223)
+  change_work_order:
+    kind: edge
+    scoring: derived-edge
+    class: realisation
+    impact_flow: both
+    reason: derived from agreement records and verdicts
+  change_work_item:
+    kind: annotation
+    scoring: derived-edge
+    class: traceability
+    impact_flow: none
+    reason: derived from each change's proposal
+  change_status:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  judge_verdict:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  work_order_status:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact

package/dist/lib/catalogue/schema-compat.js

@@ -23,8 +23,8 @@
  *     release; migration tooling (`sdd-cli migrate <schema> --to <v>`,
  *     planned) covers downgrade paths.
  *
- * See ADR 0132 (catalogue-integrity gate's schema-drift digest hook) +
- * ADR 0134 §4.6 (canonical builder + aggregator).
+ * See M-ADR 0132 (catalogue-integrity gate's schema-drift digest hook) +
+ * M-ADR 0134 §4.6 (canonical builder + aggregator).
  */
 export const SCHEMA_COMPAT = {
     catalogue_schema: "^4.0.0",

package/dist/lib/catalogue/schema-loader.js

@@ -1,7 +1,7 @@
 /**
  * Loader for the canonical catalogue-schema.yaml vendored from sdd-method.
  *
- * Per ADR 0134 §4.6 the canonical builder reads the schema rather than
+ * Per M-ADR 0134 §4.6 the canonical builder reads the schema rather than
  * hardcoding column shapes or FK rules. This loader is the only place in
  * the CLI that knows the schema file's location.
  */

package/dist/lib/catalogue/screen-validation-loader.js

@@ -1,7 +1,7 @@
 /**
  * Loader for the optional `.sdd/screen-validation.yaml` config — the
  * adopter-tunable parameters for screen-spec composition-depth validation
- * (ADR 0168 §4.5) and the archetype overlay (ADR 0169 §4.3).
+ * (M-ADR 0168 §4.5) and the archetype overlay (M-ADR 0169 §4.3).
  *
  * Every field is optional and carries a method default; an absent file means
  * "method defaults only" (the vocabulary-free checks all still run). Follows
@@ -13,7 +13,7 @@
  *     decorative_primitives:            # unlocks screen-styling-primitive-as-structure
  *       - Spacer
  *       - Divider
- *     archetype_overlays:               # per-platform overlay (ADR 0169 §4.3)
+ *     archetype_overlays:               # per-platform overlay (M-ADR 0169 §4.3)
  *       web-generic:
  *         strip_prefixes: [Nwc, Nwe]    # render-only: stripped when humanising labels
  *         overrides:

package/dist/lib/catalogue/service-architecture-parser.js

@@ -3,7 +3,7 @@
 // Extracted from builders/services.ts so two callers can share it:
 //   - the per-SDD services builder (buildServices), and
 //   - the aggregator's federated reverse-metadata enrichment pass
-//     (ADR 0163 P2), which reaches member SDDs' arch docs that the
+//     (M-ADR 0163 P2), which reaches member SDDs' arch docs that the
 //     platform-root's own build never sees.
 //
 // The metadata is read faithfully — not inferred — from three blocks: