@sdd-method/author-cli 0.7.0 → 0.9.0

package/dist/lib/catalogue/builders/product-edges.js

@@ -7,7 +7,7 @@
 // referenced columns are external FKs (capability_id and service_id
 // are owned by the platform-root SDD, not by the consuming app SDD).
 // The per-SDD builder logs `[finding] external` for each unresolved
-// reference; the aggregator validates after merge per ADR 0134 §4.3.
+// reference; the aggregator validates after merge per M-ADR 0134 §4.3.
 //
 // Profile gating: only application-product SDDs read this file. Other
 // profiles emit zero rows (no convention defined).

package/dist/lib/catalogue/builders/product-platform-dependencies.js

@@ -1,7 +1,7 @@
 // product_platform_dependencies builder — emits per-SDD rows recording a
 // product's consumption of a platform-side (capability, service) pair.
 //
-// Multi-source ingestion (ADR 0157 parity principle; same shape as ADR 0156
+// Multi-source ingestion (M-ADR 0157 parity principle; same shape as M-ADR 0156
 // events ingestion). Two equal-status authoring sources, merged by PK:
 //
 //   1. FORWARD — `app-platform-dependencies.yaml` at the SDD root, the same
@@ -31,7 +31,7 @@
 // service (M-ADR 0192), `(product_id, target_capability_id, contract_path)`.
 // The aggregator subsequently joins synchronous rows against platform-side
 // `capability_service` to derive `cross_sdd_platform_capability` edges (per
-// ADR 0134, federation); async rows resolve via the capability leg (no
+// M-ADR 0134, federation); async rows resolve via the capability leg (no
 // realiser service to join on) and skip the realiser-join.
 //
 // Cross-SDD references (target_capability_id, target_service_id) are

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

@@ -1,12 +1,12 @@
 /**
  * Products discoverer — emits the SDD-as-Product row from the manifest.
  *
- * Per ADR 0134 + catalogue-metamodel.md: every SDD is one Product. The
+ * Per M-ADR 0134 + catalogue-metamodel.md: every SDD is one Product. The
  * canonical builder emits ONE products.csv row per SDD — the SDD itself.
  * Sibling SDDs (apps, integrations) get their own products.csv rows in
  * their own builds; the aggregator merges by primary key.
  *
- * domain_id selection (per ADR 0136):
+ * domain_id selection (per M-ADR 0136):
  *   - For platform-profile SDDs: manifest.domainId when declared, else
  *     a sensible default for platform-profile categories (where a real
  *     `platform` domain exists locally).
@@ -27,7 +27,7 @@
 import { PACKAGING_DEFAULT } from "../manifest-loader.js";
 /**
  * Default domain_id per category when the manifest doesn't declare one.
- * Per ADR 0136 only platform-profile categories carry a default — app
+ * Per M-ADR 0136 only platform-profile categories carry a default — app
  * and integration products legitimately have an empty domain_id.
  */
 const DEFAULT_DOMAIN_BY_CATEGORY = {
@@ -49,7 +49,7 @@ export function buildProducts(inputs) {
         }
     }
     else {
-        // Per ADR 0136: app/integration/support products do not have a
+        // Per M-ADR 0136: app/integration/support products do not have a
         // primary domain. Even if the manifest declares one (typically the
         // umbrella name like "applications" or "integrations"), clear it
         // here so the products.domain_id FK reference does not dangle
@@ -58,7 +58,7 @@ export function buildProducts(inputs) {
         // so the override is traceable.
         domainId = "";
         if (m.domainId !== undefined && m.domainId.length > 0) {
-            inputs.findings.add("inferred", `products: domain_id cleared (manifest declared "${m.domainId}") for profile=${m.profile} per ADR 0136 — app/integration/support products do not have a primary domain`);
+            inputs.findings.add("inferred", `products: domain_id cleared (manifest declared "${m.domainId}") for profile=${m.profile} per M-ADR 0136 — app/integration/support products do not have a primary domain`);
         }
     }
     // Lifecycle (schema 2.22.0): owner-declared in the manifest, default

package/dist/lib/catalogue/builders/repo-edges.js

@@ -1,6 +1,6 @@
 // Repo-edge builders — repo_capability, repo_contract, feature_repo.
 //
-// Per ADR 0157 (Forward-Declared / Reverse-Derived Parity for Edge Catalogues):
+// Per M-ADR 0157 (Forward-Declared / Reverse-Derived Parity for Edge Catalogues):
 // both edges ingest from forward-method declared sources AND reverse-method
 // derived sources, merged by primary-key deduplication. The two paths are
 // equal-status per the parity principle; neither displaces the other.
@@ -32,20 +32,20 @@
 //     services.primary_repo_id`. A service exposing a contract is implemented
 //     by a repo (its primary_repo_id) — the repo "owns" the contract by
 //     transitive inference. Works universally because primary_repo_id and
-//     service_contract are core-schema populated. Added per ADR 0157 §4.2
+//     service_contract are core-schema populated. Added per M-ADR 0157 §4.2
 //     amendment after an early-adopter 0/30 source_repo_id outcome.
 //   repo_contract Path Y — `contracts.source_repo_id` denormalisation
-//     (from OpenAPI `x-source-repo` hints per ADR 0110, or whatever
+//     (from OpenAPI `x-source-repo` hints per M-ADR 0110, or whatever
 //     populates the column). Augments Path X when adopters carry the hint.
 //   repo_capability Path X (universal) — `capability_service ⋈
 //     services.primary_repo_id`. Works in both forward and reverse method
 //     shapes because primary_repo_id is core-schema and capability_service
 //     is heavily authored.
-//   repo_capability Path Y (augments via ADR 0143 feature-grounding) —
+//   repo_capability Path Y (augments via M-ADR 0143 feature-grounding) —
 //     `capability_feature ⋈ feature_repo`. Adopters who have adopted the
 //     feature-grounding extractor get many additional rows.
 //
-// feature_repo: ADR 0143's feature-grounding extractor populates this in
+// feature_repo: M-ADR 0143's feature-grounding extractor populates this in
 // build.ts (10a). The forward declared `contributes_to.artifact_type:
 // feature-set` path is documented in the metamodel but unused by any
 // observed adopter — left empty here pending first-adopter authoring.
@@ -68,7 +68,7 @@ import { normaliseAdditionalContextEntry, REPO_CONFIG_CONTRACT_KINDS, } from "./
  * identity-DEPENDENT, and so is this. A first review of D8 flagged the opposite
  * and was wrong.
  *
- * Caller supplies `existingIds` so this only ever ADDS: the ADR 0143
+ * Caller supplies `existingIds` so this only ever ADDS: the M-ADR 0143
  * feature-grounding extractor and the capability-spec walker own their rows and
  * are authoritative where they overlap.
  */
@@ -109,7 +109,7 @@ export function deriveFeatureRepoFromServices(inputs) {
 export function buildRepoEdges(inputs) {
     const repoCapability = collectRepoCapability(inputs);
     const repoContract = collectRepoContract(inputs);
-    // feature_repo is populated later in build.ts by the ADR 0143
+    // feature_repo is populated later in build.ts by the M-ADR 0143
     // feature-grounding extractor; this builder doesn't contribute.
     const featureRepo = [];
     return { repoCapability, repoContract, featureRepo };
@@ -222,9 +222,9 @@ function collectRepoCapability(inputs) {
             missingPrimaryRepoSvcs++;
     }
     if (missingPrimaryRepoSvcs > 0) {
-        inputs.findings.add("orphan", `repo_capability: ${missingPrimaryRepoSvcs} capability_service rows reference services with empty primary_repo_id — reverse-method Path X (capability_service ⋈ services.primary_repo_id) skipped those edges (per ADR 0157 §4.3)`);
+        inputs.findings.add("orphan", `repo_capability: ${missingPrimaryRepoSvcs} capability_service rows reference services with empty primary_repo_id — reverse-method Path X (capability_service ⋈ services.primary_repo_id) skipped those edges (per M-ADR 0157 §4.3)`);
     }
-    // Reverse path Y — capability_feature ⋈ feature_repo (transitive via ADR 0143).
+    // Reverse path Y — capability_feature ⋈ feature_repo (transitive via M-ADR 0143).
     const featuresToRepos = new Map();
     for (const fr of featureRepoRows) {
         const fid = String(fr["feature_id"] ?? "");
@@ -299,7 +299,7 @@ function collectRepoContract(inputs) {
     }
     // Reverse path X (universal) — service_contract ⋈ services.primary_repo_id.
     // A service exposing a contract is implemented by a repo; the repo "owns"
-    // the contract by transitive inference. Added per ADR 0157 §4.2 amendment
+    // the contract by transitive inference. Added per M-ADR 0157 §4.2 amendment
     // (an early adopter's source_repo_id was 0/30 populated, so
     // a derivation that depends only on it leaves them empty).
     const repoBySvcId = new Map();
@@ -323,10 +323,10 @@ function collectRepoContract(inputs) {
         emit(repoId, ctrId);
     }
     if (missingPrimaryRepoSvcs > 0) {
-        inputs.findings.add("orphan", `repo_contract: ${missingPrimaryRepoSvcs} service_contract rows reference services with empty primary_repo_id — reverse-method Path X (service_contract ⋈ services.primary_repo_id) skipped those edges (per ADR 0157 §4.2)`);
+        inputs.findings.add("orphan", `repo_contract: ${missingPrimaryRepoSvcs} service_contract rows reference services with empty primary_repo_id — reverse-method Path X (service_contract ⋈ services.primary_repo_id) skipped those edges (per M-ADR 0157 §4.2)`);
     }
     // Reverse path Y — contracts.source_repo_id denormalisation.
-    // Adopters who carry OpenAPI x-source-repo hints (per ADR 0110) or whose
+    // Adopters who carry OpenAPI x-source-repo hints (per M-ADR 0110) or whose
     // contracts builder otherwise populates source_repo_id get one row per
     // (source_repo_id, contract.id) for free.
     for (const c of contractRows) {

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

@@ -1,7 +1,7 @@
 // Repositories discoverer — emits `repositories.csv` rows from
 // `orchestration/repo-config/<domain>/<repo>.yaml` (recursive).
 //
-// Per ADR 0134 + Q7.1 resolution: `service_type` is constrained to the
+// Per M-ADR 0134 + Q7.1 resolution: `service_type` is constrained to the
 // canonical `enums.service_type` set (api_service, worker, gateway,
 // frontend, mobile, library, infrastructure, documentation). Unknown
 // values log a `[finding] convention` and are kept verbatim — the FK
@@ -173,13 +173,13 @@ export async function buildRepositories(inputs) {
             inputs.findings.add("convention", `${cfg.relPath}: missing required \`domain\` field`);
         }
         else if (!inputs.knownDomainIds.has(domain)) {
-            // Per ADR 0136: leave domain_id empty when the declared domain
+            // Per M-ADR 0136: leave domain_id empty when the declared domain
             // doesn't resolve locally (typical for app/integration SDDs whose
             // repo-config declares "applications"/"integrations").
             //
             // NOT `orphan`, and the argument is about TIER rather than a relabelling
             // of the same claim. A locally-unresolvable domain is two different
-            // things and THIS TIER CANNOT TELL THEM APART: ADR 0136 externality (the
+            // things and THIS TIER CANNOT TELL THEM APART: M-ADR 0136 externality (the
             // domain is owned by a sibling SDD — correct, expected, nothing to fix)
             // or a genuinely dangling domain name (a typo). The discriminator lives
             // at estate scope, not here. Measured across two estates: 137
@@ -191,7 +191,7 @@ export async function buildRepositories(inputs) {
             // §4.2 names. `inferred` records the builder's documented resolution
             // (empty the column, keep the repository) without claiming a defect this
             // build cannot see.
-            inputs.findings.add("inferred", `${cfg.relPath}: domain "${domain}" has no docs/domains/${domain}/ directory — domain_id left empty per ADR 0136. Whether that is external ownership or a dangling name is decidable only at estate scope`);
+            inputs.findings.add("inferred", `${cfg.relPath}: domain "${domain}" has no docs/domains/${domain}/ directory — domain_id left empty per M-ADR 0136. Whether that is external ownership or a dangling name is decidable only at estate scope`);
             resolvedDomain = "";
         }
         const loc = locByRepo.get(repoId);
@@ -252,19 +252,23 @@ async function loadRepoConfigs(sddPath, findings) {
             raw = parseYaml(text);
         }
         catch (err) {
-            findings.add("convention", `failed to parse YAML at ${relative(sddPath, path)}: ${err.message}`);
+            findings.add("convention", `failed to parse YAML at ${relative(sddPath, path)}: ${err.message} — repository dropped`, "error", relative(sddPath, path));
             continue;
         }
         if (!raw || typeof raw !== "object") {
-            findings.add("convention", `${relative(sddPath, path)}: not an object — skipped`);
+            findings.add("convention", `${relative(sddPath, path)}: not an object — repository dropped`, "error", relative(sddPath, path));
             continue;
         }
+        // A repo-config that cannot be read takes its repository, services and
+        // capability edges out of the catalogue with it. That is an error, not
+        // advice: as a warning it passed validation while the rows vanished, and
+        // only a downstream aggregate's FK check noticed.
         const parsed = RepoConfigSchema.safeParse(raw);
         if (!parsed.success) {
             const issues = parsed.error.issues
                 .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
                 .join("; ");
-            findings.add("convention", `${relative(sddPath, path)}: schema violation — ${issues}`);
+            findings.add("convention", `${relative(sddPath, path)}: schema violation — ${issues} — repository dropped`, "error", relative(sddPath, path));
             continue;
         }
         const repoFull = parsed.data.repo;

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

@@ -8,7 +8,13 @@
 //                       directory name, which is the catalogue feature id; plus one per requirement an open,
 //                       agreed change ADDS (stage agreed).
 //   requirement_lineage each archived change, in archive order, whose delta ADDED, MODIFIED or RENAMED a
-//                       requirement that is current now. A change carrying baseline-evidence.md is a baseline.
+//                       requirement that is current now, under any name a later RENAMED gave it. A change carrying
+//                       baseline-evidence.md is a baseline. Statuses follow renames the same way.
+//   changes             each change in the store, open or archived (M-ADR 0223 §4.2): its directory name, its
+//                       undated name, kind, status (archived, or its agreement record's) and verdict.
+//   change_work_order   per (change, repository): the record's work order, agreed or completed.
+//   change_work_item    per (change, work item): the ids its proposal's `## Work Items` section lists, keyed by
+//                       the undated name so the row survives archive.
 //   requirement_status  per (requirement, repository): observed from a baseline's `**Observed in:**` line;
 //                       declared-shipped from an archived change whose agreement record's verdict is PASS, through
 //                       its work orders' `implements` lists; agreed from an open change whose record is agreed.
@@ -20,7 +26,7 @@
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { parse as parseYaml } from "yaml";
-import { observedIn, orderArchives, parseRequirements } from "../../behaviour-store/archive.js";
+import { observedIn, orderArchives, parseRequirements, renamePairs } from "../../behaviour-store/archive.js";
 export { observedIn, parseRequirements };
 const STORE = "openspec";
 const AGREEMENTS = join("docs", "agreements");
@@ -62,6 +68,17 @@ async function deltaOf(changeDir) {
     }
     return out;
 }
+async function renamesOf(changeDir) {
+    const out = [];
+    for (const feature of await dirs(join(changeDir, "specs"))) {
+        const text = await readText(join(changeDir, "specs", feature, "spec.md"));
+        if (text === null)
+            continue;
+        for (const r of renamePairs(text))
+            out.push({ feature, ...r });
+    }
+    return out;
+}
 async function agreementRecord(sddPath, change) {
     const text = await readText(join(sddPath, AGREEMENTS, `${change}.yaml`));
     if (text === null)
@@ -82,10 +99,33 @@ export async function archiveOrder(sddPath, names, findings) {
     }
     return order;
 }
+const CHANGE_STATUSES = new Set(["proposed", "agreed", "superseded", "withdrawn"]);
+/**
+ * The work-item ids a proposal's `## Work Items` section lists (M-ADR 0223 §4.2): one per bullet, the backticked
+ * id if there is one, else the bullet's first word. HTML comments (the template's guidance) are ignored.
+ */
+export function parseWorkItems(proposal) {
+    const text = proposal.replace(/<!--[\s\S]*?-->/g, "");
+    const m = /^##\s+Work Items\s*$/im.exec(text);
+    if (!m)
+        return [];
+    const rest = text.slice(m.index + m[0].length);
+    const end = /^##\s/m.exec(rest);
+    const ids = [];
+    for (const line of (end ? rest.slice(0, end.index) : rest).split("\n")) {
+        const b = /^\s*[-*]\s+(.*)$/.exec(line);
+        if (!b)
+            continue;
+        const id = (/`([^`]+)`/.exec(b[1])?.[1] ?? b[1].split(/\s+/)[0] ?? "").replace(/[:,;]+$/, "").trim();
+        if (id && !ids.includes(id))
+            ids.push(id);
+    }
+    return ids;
+}
 const rel = (sddPath, p) => p.slice(sddPath.length + 1).split("\\").join("/");
 export async function buildRequirements(inputs) {
     const { sddPath, findings } = inputs;
-    const empty = { requirements: [], lineage: [], status: [] };
+    const empty = { requirements: [], lineage: [], status: [], changes: [], workOrders: [], workItems: [] };
     const store = join(sddPath, STORE);
     if (!(await isDir(store)))
         return empty;
@@ -115,6 +155,28 @@ export async function buildRequirements(inputs) {
     const events = [];
     const lineage = [];
     const unknownRepos = new Set();
+    const changes = [];
+    const workOrders = [];
+    const workItems = [];
+    // The change itself, its work orders and its work items (M-ADR 0223 §4.2).
+    const recordChange = async (id, name, kind, status, archivedOn, changeDir, record) => {
+        const verdict = record?.verdict?.result === "PASS" || record?.verdict?.result === "FAIL" ? record.verdict.result : "";
+        changes.push({ id, name, change_kind: kind, status, archived_on: archivedOn, verdict, source_sdd_id: "", platform_sdd_id: "" });
+        for (const wo of record?.work_orders ?? []) {
+            if (!wo.repo)
+                continue;
+            if (!inputs.knownRepoIds.has(wo.repo)) {
+                unknownRepos.add(wo.repo);
+                continue;
+            }
+            const woStatus = wo.status === "agreed" || wo.status === "completed" ? wo.status : verdict === "PASS" && status === "archived" ? "completed" : "agreed";
+            workOrders.push({ id: `${id}__${wo.repo}`, change_id: id, repo_id: wo.repo, status: woStatus, source_sdd_id: "", platform_sdd_id: "" });
+        }
+        const proposal = await readText(join(changeDir, "proposal.md"));
+        for (const item of proposal === null ? [] : parseWorkItems(proposal)) {
+            workItems.push({ id: `${name}__${item}`, change_id: id, change_name: name, work_item_id: item, source_sdd_id: "", platform_sdd_id: "" });
+        }
+    };
     const pushEvent = (e) => {
         if (!inputs.knownRepoIds.has(e.repo)) {
             unknownRepos.add(e.repo);
@@ -123,21 +185,25 @@ export async function buildRequirements(inputs) {
         if (requirements.has(e.requirementId))
             events.push(e);
     };
-    // 2. Archived changes, in archive order.
-    for (const dir of await archiveOrder(sddPath, await dirs(join(store, "changes", "archive")), findings)) {
+    // 2. Archived changes, in archive order. A requirement is named as it was when each change archived, so its
+    // rows are carried forward through every later RENAMED (and one in the same change) to the name it has now;
+    // otherwise a rename would read as a requirement born at the rename, with no baseline.
+    const archived = [];
+    const renames = [];
+    const archives = await archiveOrder(sddPath, await dirs(join(store, "changes", "archive")), findings);
+    for (const [index, dir] of archives.entries()) {
         const changeDir = join(store, "changes", "archive", dir);
+        renames.push(await renamesOf(changeDir));
         const change = dir.replace(/^\d{4}-\d{2}-\d{2}-/, "");
         const archivedOn = /^(\d{4}-\d{2}-\d{2})-/.exec(dir)?.[1] ?? "";
         const evidence = await readText(join(changeDir, "baseline-evidence.md"));
         const kind = evidence !== null ? "baseline" : "change";
+        await recordChange(dir, change, kind, "archived", archivedOn, changeDir, await agreementRecord(sddPath, change));
         const delta = await deltaOf(changeDir);
         for (const d of delta) {
             if (d.operation === "REMOVED")
                 continue;
-            const requirementId = `${d.feature}::${d.name}`;
-            if (!requirements.has(requirementId))
-                continue;
-            lineage.push({ id: `${requirementId}__${dir}`, requirement_id: requirementId, change_id: dir, change_kind: kind, operation: d.operation, archived_on: archivedOn, source_sdd_id: "", platform_sdd_id: "" });
+            archived.push({ index, feature: d.feature, name: d.name, lineage: { change_id: dir, change_kind: kind, operation: d.operation, archived_on: archivedOn, source_sdd_id: "", platform_sdd_id: "" } });
         }
         if (evidence !== null) {
             const repos = observedIn(evidence);
@@ -147,7 +213,7 @@ export async function buildRequirements(inputs) {
             for (const repo of repos)
                 for (const d of delta)
                     if (d.operation !== "REMOVED")
-                        pushEvent({ requirementId: `${d.feature}::${d.name}`, repo, status: "observed", basis: dir });
+                        archived.push({ index, feature: d.feature, name: d.name, event: { repo, status: "observed", basis: dir } });
             continue;
         }
         const record = await agreementRecord(sddPath, change);
@@ -162,13 +228,43 @@ export async function buildRequirements(inputs) {
                     findings.add("convention", `${AGREEMENTS}/${change}.yaml: work order for ${wo.repo} implements "${name}", which the change's delta does not name`);
                 }
                 for (const d of match)
-                    pushEvent({ requirementId: `${d.feature}::${d.name}`, repo: wo.repo, status: "declared-shipped", basis: dir });
+                    archived.push({ index, feature: d.feature, name: d.name, event: { repo: wo.repo, status: "declared-shipped", basis: dir } });
             }
         }
     }
+    const current = (feature, name, from) => {
+        let n = name;
+        for (let j = from; j < renames.length; j++)
+            for (const r of renames[j])
+                if (r.feature === feature && r.from === n)
+                    n = r.to;
+        return `${feature}::${n}`;
+    };
+    // One lineage row per (requirement, change): a change that renames and modifies a requirement records MODIFIED,
+    // the behaviour change, and its delta still shows the rename.
+    const lineageById = new Map();
+    for (const a of archived) {
+        const requirementId = current(a.feature, a.name, a.index);
+        if (a.event)
+            pushEvent({ requirementId, ...a.event });
+        else if (a.lineage && requirements.has(requirementId)) {
+            const id = `${requirementId}__${a.lineage["change_id"]}`;
+            if (lineageById.get(id)?.["operation"] === "MODIFIED")
+                continue;
+            lineageById.set(id, { id, requirement_id: requirementId, ...a.lineage });
+        }
+    }
+    lineage.push(...lineageById.values());
     // 3. Open changes whose agreement record is agreed.
     for (const dir of (await dirs(join(store, "changes"))).filter((d) => d !== "archive")) {
         const record = await agreementRecord(sddPath, dir);
+        const openKind = (await readText(join(store, "changes", dir, "baseline-evidence.md"))) !== null ? "baseline" : "change";
+        let openStatus = record?.status ?? "proposed";
+        if (!CHANGE_STATUSES.has(openStatus)) {
+            findings.add("convention", `${AGREEMENTS}/${dir}.yaml: status "${openStatus}" is not a change status; catalogued as proposed`);
+            openStatus = "proposed";
+        }
+        await recordChange(dir, dir, openKind, openStatus, "", join(store, "changes", dir), record);
         if (record?.status !== "agreed")
             continue;
         const delta = await deltaOf(join(store, "changes", dir));
@@ -203,6 +299,9 @@ export async function buildRequirements(inputs) {
         requirements: [...requirements.values()].sort(byId),
         lineage,
         status: [...status.values()].sort(byId),
+        changes: changes.sort(byId),
+        workOrders: workOrders.sort(byId),
+        workItems: workItems.sort(byId),
     };
 }
 //# sourceMappingURL=requirements.js.map

package/dist/lib/catalogue/builders/screen-tree.js

@@ -1,15 +1,15 @@
-// Screen composition-tree analysis for openui-lang blocks (per ADR 0168).
+// Screen composition-tree analysis for openui-lang blocks (per M-ADR 0168).
 //
 // The screens builder (screens.ts) lowers a ```openui-lang block into catalogue
-// rows by flat token-scanning. ADR 0168 adds a *fidelity floor*: the block must
+// rows by flat token-scanning. M-ADR 0168 adds a *fidelity floor*: the block must
 // be a faithful tree, not a flat / empty / mis-rooted "widget bag". That needs
 // the structural shape the flat scan throws away — so this module parses the
 // block into a tree and computes the metrics the depth findings reason about.
 //
 // Pure functions, no I/O. The metrics reason about TREE SHAPE only — never about
-// any component vocabulary (adopter-agnostic by construction, ADR 0168 §4.5).
+// any component vocabulary (adopter-agnostic by construction, M-ADR 0168 §4.5).
 //
-// Grammar recap (ADR 0166 / openui-lang-grammar-reference.md): one
+// Grammar recap (M-ADR 0166 / openui-lang-grammar-reference.md): one
 // `identifier = Expression` statement per line; the first statement is `root`;
 // composition is by identifier reference inside list literals. A component is a
 // Capitalised call head (`Name(`); local references are lowercase ids that are
@@ -73,7 +73,7 @@ function parseArgsActions(rhs) {
 }
 /**
  * Strip openui-lang inline comments: from the first *unquoted* `#` to
- * end-of-line, per line (ADR 0168 §4.4, defect g). A `Capitalised(` token inside
+ * end-of-line, per line (M-ADR 0168 §4.4, defect g). A `Capitalised(` token inside
  * a comment must not be lexed as a component. `#` inside a string literal is
  * preserved.
  */
@@ -113,7 +113,7 @@ function parseStatements(cleanBlock) {
         const rhs = m[2];
         // A component statement's RHS is a call (`Text("Q4")`) or a reference — never a
         // bare string literal. A line like `action="basket-updated"` (the block-level
-        // screen_action messaging contract, ADR 0166) matches the statement shape with
+        // screen_action messaging contract, M-ADR 0166) matches the statement shape with
         // id=`action`; skip it so it isn't lexed as a phantom component (and so a node
         // carrying an `action=` attr doesn't pick it up as a spurious child).
         if (/^["']/.test(rhs))

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).