@sdd-method/maintain-cli 0.8.0 → 0.10.0

package/dist/lib/catalogue/builders/glossary-xref.js

@@ -1,7 +1,7 @@
 // glossary_xref + entity_glossary edge builders — emit cross-domain glossary
 // relationships from `docs/platform/reference/glossary-alignment-manifest.yaml`.
 //
-// Per ADR 0158 (Glossary Cross-Reference Multi-Source Ingestion, schema 2.12.0),
+// Per M-ADR 0158 (Glossary Cross-Reference Multi-Source Ingestion, schema 2.12.0),
 // the builder ingests from FIVE walkers:
 //
 //   1. Forward declared pair-form (existing).
@@ -42,7 +42,7 @@ import { join } from "node:path";
 import { parse as parseYaml } from "yaml";
 const MANIFEST_REL_PATH = join("docs", "platform", "reference", "glossary-alignment-manifest.yaml");
 export async function buildGlossaryXref(inputs) {
-    // Profile gate per ADR 0158 §amendment: the manifest is platform-owned;
+    // Profile gate per M-ADR 0158 §amendment: the manifest is platform-owned;
     // sibling SDDs that syndicate it for documentation accessibility should
     // not re-emit rows. Mirrors the entities-manifest profile gate.
     if (inputs.profile !== "platform-profile") {
@@ -292,7 +292,7 @@ export async function buildGlossaryXref(inputs) {
                                 status: winner,
                             });
                         }
-                        inputs.findings.add("divergence", `${MANIFEST_REL_PATH}: entity ${name} in domain ${domain} has conflicting statuses across models (${existingStatus} vs ${status}) — keeping ${winner} (per ADR 0158)`);
+                        inputs.findings.add("divergence", `${MANIFEST_REL_PATH}: entity ${name} in domain ${domain} has conflicting statuses across models (${existingStatus} vs ${status}) — keeping ${winner} (per M-ADR 0158)`);
                         continue;
                     }
                     const row = {
@@ -321,7 +321,7 @@ export async function buildGlossaryXref(inputs) {
             || "cross_domain_terms" in obj
             || "models" in obj;
         if (!hasAnyKnownKey) {
-            inputs.findings.add("convention", `${MANIFEST_REL_PATH}: present but no recognised top-level keys (aliases/conflicts/cross_domain_terms/models) — emitting 0 xref rows (per ADR 0158)`);
+            inputs.findings.add("convention", `${MANIFEST_REL_PATH}: present but no recognised top-level keys (aliases/conflicts/cross_domain_terms/models) — emitting 0 xref rows (per M-ADR 0158)`);
         }
     }
     return { glossaryXref: xrefRows, entityGlossary: entityRows };

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

@@ -1,10 +1,10 @@
 // Integrations discoverer — emits `integrations.csv` rows from an
 // integration-product SDD's `integration-manifest.yaml`.
 //
-// Per ADR 0134 federation: each integration-provider SDD owns one row
+// Per M-ADR 0134 federation: each integration-provider SDD owns one row
 // in the granular integrations.csv. The aggregator merges siblings.
 //
-// Per ADR 0144 (schema 2.6.0): if the manifest declares an optional
+// Per M-ADR 0144 (schema 2.6.0): if the manifest declares an optional
 // `sub_integrations:` array (multi-provider monolith pattern), emit
 // one additional row per entry with parent_product_id set to the
 // SDD's integrationId. The umbrella SDD row stays unchanged.
@@ -29,7 +29,7 @@
 //   doc_path = SDD's doc_path
 //   repo_count = 0 (repo ownership stays with the umbrella)
 //
-// domain_id is always empty per ADR 0136.
+// domain_id is always empty per M-ADR 0136.
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { parse as parseYaml } from "yaml";
@@ -111,7 +111,7 @@ export async function buildIntegrations(inputs) {
             source_sdd_id: "",
         },
     ];
-    // Per ADR 0144 (schema 2.6.0): emit one row per sub_integration with
+    // Per M-ADR 0144 (schema 2.6.0): emit one row per sub_integration with
     // parent_product_id = the umbrella SDD's id.
     const subs = parsed.data.sub_integrations ?? [];
     const seenSubIds = new Set([id]); // umbrella id is reserved

package/dist/lib/catalogue/builders/persona-c4system.js

@@ -1,5 +1,5 @@
 // persona_c4system edge builder — emits one row per `Person(...)` actor on
-// the L1 context diagram that maps to a known persona (per ADR 0155). This
+// the L1 context diagram that maps to a known persona (per M-ADR 0155). This
 // captures the C4 "Person uses System" relationship; the C4 Person
 // abstraction reuses the existing Persona entity rather than a parallel one.
 //

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