@sdd-method/author-cli 0.7.0 → 0.9.0

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:

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

@@ -8,7 +8,7 @@
 // `docs/domains/{domain}/product/{capability}.traceability.yaml`.
 //
 // Schema reference: docs/method/methods/capability-traceability-manifest-template.yaml
-// in sdd-method (per ADR 0047 / capability-spec-template.md).
+// in sdd-method (per M-ADR 0047 / capability-spec-template.md).
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join, relative, sep } from "node:path";
 import { parse as parseYaml } from "yaml";
@@ -84,6 +84,8 @@ export async function loadTraceabilityManifests(opts) {
         }
         throw err;
     }
+    // A manifest dropped whole takes its capability's traceability with it, so
+    // each drop below is an error that fails the build (as for repo-configs).
     const manifests = [];
     for (const path of yamlPaths.sort()) {
         const text = await readFile(path, "utf-8");
@@ -92,18 +94,18 @@ export async function loadTraceabilityManifests(opts) {
             raw = parseYaml(text);
         }
         catch (err) {
-            opts.findings.add("convention", `failed to parse YAML at ${relative(opts.sddPath, path)}: ${err.message}`);
+            opts.findings.add("convention", `failed to parse YAML at ${relative(opts.sddPath, path)}: ${err.message} — manifest dropped`, "error", relative(opts.sddPath, path));
             continue;
         }
         if (!raw || typeof raw !== "object") {
-            opts.findings.add("convention", `${relative(opts.sddPath, path)}: not an object — skipped`);
+            opts.findings.add("convention", `${relative(opts.sddPath, path)}: not an object — manifest dropped`, "error", relative(opts.sddPath, path));
             continue;
         }
         const obj = raw;
         const cap = obj["capability"] ?? {};
         const capId = String(cap["id"] ?? "").trim();
         if (capId === "") {
-            opts.findings.add("convention", `${relative(opts.sddPath, path)}: missing capability.id`);
+            opts.findings.add("convention", `${relative(opts.sddPath, path)}: missing capability.id — manifest dropped`, "error", relative(opts.sddPath, path));
             continue;
         }
         const relPath = relative(opts.sddPath, path);

package/dist/lib/conformance/finding.js

@@ -53,7 +53,7 @@ export function findingRows(results, runDate) {
             observed_not_declared: r.observedNotDeclared.length,
             needs_triage: r.needsTriage,
             run_date: runDate,
-            source_sdd_id: "", // populated by the aggregator per ADR 0134
+            source_sdd_id: "", // populated by the aggregator per M-ADR 0134
             platform_sdd_id: "", // stamped at organisation tier per M-ADR 0208
         };
         lines.push(FINDING_COLUMNS.map((c) => csvCell(row[c])).join(","));

package/dist/lib/conformance/index.js

@@ -17,7 +17,7 @@ function resolveSource(targetRepo, source, codeRoot) {
 }
 const markdownProviderSignals = async (path, spec) => {
     const out = new Set();
-    // `section` (ADR 0180 delta-pilot extension) scopes the scan to one heading block and accepts a plain
+    // `section` (M-ADR 0180 delta-pilot extension) scopes the scan to one heading block and accepts a plain
     // "Field" header, so a check can read ONE entity table inside a multi-table data-model doc (e.g.
     // data-model.mermaid.md "### Collection: orders") without duplicating the field list into a bespoke
     // surface file. With no `section` the behaviour is byte-for-byte the legacy one (whole file, strict
@@ -499,7 +499,7 @@ function printReconcile(chk, r, schemaDir, out) {
     if (!chk.reconcile || r.target !== "binding-vs-reality")
         return;
     const rc = chk.reconcile;
-    out(`\n--- reconcile ${r.id} -> regenerate \`${rc.block}\` in ${rc.binding} (ADR 0181 §2.3) ---\n`);
+    out(`\n--- reconcile ${r.id} -> regenerate \`${rc.block}\` in ${rc.binding} (M-ADR 0181 §2.3) ---\n`);
     out(`# generated from the observed-set (${r.observed} schemas); the binding cannot drift if generated.\n`);
     if (rc.note)
         out(`# NOTE: ${rc.note}\n`);
@@ -513,7 +513,7 @@ function printReconcile(chk, r, schemaDir, out) {
     }
 }
 async function planChecks(opts, stdout) {
-    // Resolution order: explicit --config wins; else the ADR 0181 binding (checks derived from it);
+    // Resolution order: explicit --config wins; else the M-ADR 0181 binding (checks derived from it);
     // else the conventional .sdd/conformance-checks.yaml; else nothing to do.
     if (!opts.config && hasBinding(opts.targetRepo)) {
         const derived = await deriveChecksFromBinding(opts.targetRepo);
@@ -523,7 +523,7 @@ async function planChecks(opts, stdout) {
         ? resolveSource(opts.targetRepo, opts.config, opts.codeRoot)
         : resolve(opts.targetRepo, ".sdd/conformance-checks.yaml");
     if (!existsSync(configPath)) {
-        stdout(`[skip] no spec↔implementation binding (.sdd/implementation-binding.yaml or .sdd/implementation-bindings/, ADR 0181) and no ` +
+        stdout(`[skip] no spec↔implementation binding (.sdd/implementation-binding.yaml or .sdd/implementation-bindings/, M-ADR 0181) and no ` +
             `checks file at ${configPath}\n`);
         return null;
     }
@@ -562,7 +562,7 @@ export async function runConformance(opts, stdout = (line) => process.stdout.wri
         stdout(JSON.stringify({ checks: results, skipped }, null, 2) + "\n");
     }
     else {
-        stdout("Conformance-reverse (advisory; disposition is triage — ADR 0180 §2.3).\n");
+        stdout("Conformance-reverse (advisory; disposition is triage — M-ADR 0180 §2.3).\n");
         for (const r of results) {
             printHuman(r, stdout);
             if (opts.reconcile) {

package/dist/lib/generate-briefing/index.js

@@ -6,7 +6,7 @@
  * source of truth).
  *
  * Replaces the v0.3.0 `generate-claude-md` verb whose rich-content
- * output diverges from the ADR 0148 thin-pointer shape.
+ * output diverges from the M-ADR 0148 thin-pointer shape.
  */
 import { access } from "node:fs/promises";
 import { join } from "node:path";
@@ -36,7 +36,7 @@ export async function runGenerateBriefing(opts, stdout = (line) => process.stdou
     // graceful skip downstream.
     const templatesPresent = await fileExists(join(opts.targetDir, BRIEFING_TEMPLATE_ROOT, "agent-instructions.md.hbs"));
     if (!templatesPresent) {
-        stdout(fail(`Briefing templates not found under ${BRIEFING_TEMPLATE_ROOT}/ — sync against a baseline that ships ADR 0148 templates first.`));
+        stdout(fail(`Briefing templates not found under ${BRIEFING_TEMPLATE_ROOT}/ — sync against a baseline that ships M-ADR 0148 templates first.`));
         return { exitCode: 1 };
     }
     const result = await syncBriefingFiles({