@ybotok/loam 0.1.0-beta.3 → 0.2.0-alpha.13

package/dist/commands/migrate-openspec/openspec/decisions.js

@@ -0,0 +1,86 @@
+/**
+ * The mapping document on the way out: the blank skeleton `audit-openspec`
+ * offers, the normalized record `migrate-openspec --apply` writes beside the
+ * staged docs, and the one query that reads a decision back.
+ *
+ * `selectedServices` belongs here rather than beside either materializer
+ * because it is the single spelling of the routing rule. It was written out
+ * twice once — once on the living side and once on the delta side — and the two
+ * copies drifted, so a split capability routed a living requirement and its own
+ * delta to different services. Both materializers now call this one.
+ */
+import { existsSync } from "node:fs";
+import { mkdir, realpath, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { isPathInside } from "../../../core/kernel/path-safety.js";
+import { dictionary, ownValue } from "../../../core/kernel/records.js";
+import { activeRenameEntries } from "../../../core/openspec/model/mapping.js";
+import {} from "../../../core/openspec/model/model.js";
+import { OpenSpecCommandError } from "./error.js";
+import { canonicalForCreate } from "./paths.js";
+export async function writeMappingSkeleton(inventory, outputArg, skeleton) {
+    const output = resolve(outputArg);
+    const canonicalOutput = await canonicalForCreate(output);
+    const canonicalSource = await realpath(inventory.inputRoot);
+    if (isPathInside(canonicalSource, canonicalOutput)) {
+        throw new OpenSpecCommandError("invalid-option", `Refusing to write the mapping inside the OpenSpec source workspace: ${output}`);
+    }
+    await mkdir(dirname(output), { recursive: true });
+    try {
+        // `wx` is the existence check: an output already there (a file, a
+        // directory, or a symlink, dangling or not) fails the exclusive create, so
+        // no separate pre-check is needed — one used to sit above, saying the same
+        // `already-exists` this catch says.
+        await writeFile(output, stringifyYaml(skeleton, { lineWidth: 0 }), { encoding: "utf8", flag: "wx" });
+    }
+    catch (error) {
+        if (existsSync(output)) {
+            throw new OpenSpecCommandError("already-exists", `Mapping output already exists; refusing to overwrite it: ${output}`);
+        }
+        throw error;
+    }
+    return output;
+}
+export function normalizedMapping(inventory, mapping) {
+    return {
+        version: 1,
+        source: { root: inventory.root, inventoryDigest: inventory.inventoryDigest },
+        capabilities: Object.fromEntries(inventory.mappingDecisions.map((decision) => [
+            decision.capability,
+            {
+                services: ownValue(mapping.capabilities, decision.capability)?.services ?? [],
+                requirementServices: ownValue(mapping.capabilities, decision.capability)?.requirementServices ?? dictionary(),
+            },
+        ])),
+        changes: Object.fromEntries(inventory.changeDecisions.map((decision) => [
+            decision.change,
+            {
+                feature: ownValue(mapping.changes, decision.change)?.feature ?? null,
+                // The decision's title, which is the mapping's own title trimmed.
+                // `readMapping` (`./mapping.ts`) trims `feature` but not `title`, and
+                // materialization writes the trimmed one into the frontmatter, the H1
+                // and the directory slug — so recording the raw one made the plan
+                // disagree with the files beside it about what the feature is called.
+                title: decision.title,
+            },
+        ])),
+        renames: activeRenameEntries(inventory),
+        artifacts: Object.fromEntries(inventory.artifactDecisions.map((decision) => [
+            decision.path,
+            {
+                kind: decision.kind,
+                disposition: ownValue(mapping.artifacts, decision.path) ?? null,
+            },
+        ])),
+    };
+}
+export function selectedServices(mapping, capability, requirement) {
+    const selected = ownValue(mapping.capabilities, capability);
+    if (selected === undefined)
+        return [];
+    return selected.services.length === 1
+        ? selected.services
+        : ownValue(selected.requirementServices, requirement) ?? [];
+}
+//# sourceMappingURL=decisions.js.map

package/dist/commands/migrate-openspec/openspec/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/openspec/decisions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The mapping document on the way out: the blank skeleton `audit-openspec`\n * offers, the normalized record `migrate-openspec --apply` writes beside the\n * staged docs, and the one query that reads a decision back.\n *\n * `selectedServices` belongs here rather than beside either materializer\n * because it is the single spelling of the routing rule. It was written out\n * twice once — once on the living side and once on the delta side — and the two\n * copies drifted, so a split capability routed a living requirement and its own\n * delta to different services. Both materializers now call this one.\n */\nimport { existsSync } from \"node:fs\";\nimport { mkdir, realpath, writeFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { isPathInside } from \"../../../core/kernel/path-safety.js\";\nimport { dictionary, ownValue } from \"../../../core/kernel/records.js\";\nimport { activeRenameEntries, type OpenSpecMapping, type OpenSpecMappingSkeleton } from \"../../../core/openspec/model/mapping.js\";\nimport { type OpenSpecInventory } from \"../../../core/openspec/model/model.js\";\nimport { OpenSpecCommandError } from \"./error.js\";\nimport { canonicalForCreate } from \"./paths.js\";\n\nexport async function writeMappingSkeleton(\n  inventory: OpenSpecInventory,\n  outputArg: string,\n  skeleton: OpenSpecMappingSkeleton,\n): Promise<string> {\n  const output = resolve(outputArg);\n  const canonicalOutput = await canonicalForCreate(output);\n  const canonicalSource = await realpath(inventory.inputRoot);\n  if (isPathInside(canonicalSource, canonicalOutput)) {\n    throw new OpenSpecCommandError(\n      \"invalid-option\",\n      `Refusing to write the mapping inside the OpenSpec source workspace: ${output}`,\n    );\n  }\n  await mkdir(dirname(output), { recursive: true });\n  try {\n    // `wx` is the existence check: an output already there (a file, a\n    // directory, or a symlink, dangling or not) fails the exclusive create, so\n    // no separate pre-check is needed — one used to sit above, saying the same\n    // `already-exists` this catch says.\n    await writeFile(output, stringifyYaml(skeleton, { lineWidth: 0 }), { encoding: \"utf8\", flag: \"wx\" });\n  } catch (error) {\n    if (existsSync(output)) {\n      throw new OpenSpecCommandError(\"already-exists\", `Mapping output already exists; refusing to overwrite it: ${output}`);\n    }\n    throw error;\n  }\n  return output;\n}\n\nexport function normalizedMapping(inventory: OpenSpecInventory, mapping: OpenSpecMapping): Record<string, unknown> {\n  return {\n    version: 1,\n    source: { root: inventory.root, inventoryDigest: inventory.inventoryDigest },\n    capabilities: Object.fromEntries(inventory.mappingDecisions.map((decision) => [\n      decision.capability,\n      {\n        services: ownValue(mapping.capabilities, decision.capability)?.services ?? [],\n        requirementServices: ownValue(mapping.capabilities, decision.capability)?.requirementServices ?? dictionary(),\n      },\n    ])),\n    changes: Object.fromEntries(inventory.changeDecisions.map((decision) => [\n      decision.change,\n      {\n        feature: ownValue(mapping.changes, decision.change)?.feature ?? null,\n        // The decision's title, which is the mapping's own title trimmed.\n        // `readMapping` (`./mapping.ts`) trims `feature` but not `title`, and\n        // materialization writes the trimmed one into the frontmatter, the H1\n        // and the directory slug — so recording the raw one made the plan\n        // disagree with the files beside it about what the feature is called.\n        title: decision.title,\n      },\n    ])),\n    renames: activeRenameEntries(inventory),\n    artifacts: Object.fromEntries(inventory.artifactDecisions.map((decision) => [\n      decision.path,\n      {\n        kind: decision.kind,\n          disposition: ownValue(mapping.artifacts, decision.path) ?? null,\n      },\n    ])),\n  };\n}\n\nexport function selectedServices(\n  mapping: OpenSpecMapping,\n  capability: string,\n  requirement: string,\n): string[] {\n  const selected = ownValue(mapping.capabilities, capability);\n  if (selected === undefined) return [];\n  return selected.services.length === 1\n    ? selected.services\n    : ownValue(selected.requirementServices, requirement) ?? [];\n}\n"]}

package/dist/commands/migrate-openspec/openspec/error.js

@@ -0,0 +1,18 @@
+import { CodedFailure } from "../../../core/envelope/json.js";
+/**
+ * The one refusal shape both verbs raise, in a module of its own.
+ *
+ * It cannot live beside the commander wiring that catches it: every phase of a
+ * migration throws it, and a phase that imported the wiring to reach it would
+ * put the command's registration on the evaluation path of the modules being
+ * registered. So the error is the package's lowest leaf, and the wiring — which
+ * maps it onto an exit code in `reportCommandError` — sits above everything.
+ *
+ * The shape is the shared `CodedFailure`; the class stays so the migration's
+ * own refusals keep their name and can still be told from anything else thrown
+ * through a phase.
+ */
+export class OpenSpecCommandError extends CodedFailure {
+    name = "OpenSpecCommandError";
+}
+//# sourceMappingURL=error.js.map

package/dist/commands/migrate-openspec/openspec/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/openspec/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAClC,IAAI,GAAG,sBAAsB,CAAC;CACjD","sourcesContent":["import { CodedFailure } from \"../../../core/envelope/json.js\";\n\n/**\n * The one refusal shape both verbs raise, in a module of its own.\n *\n * It cannot live beside the commander wiring that catches it: every phase of a\n * migration throws it, and a phase that imported the wiring to reach it would\n * put the command's registration on the evaluation path of the modules being\n * registered. So the error is the package's lowest leaf, and the wiring — which\n * maps it onto an exit code in `reportCommandError` — sits above everything.\n *\n * The shape is the shared `CodedFailure`; the class stays so the migration's\n * own refusals keep their name and can still be told from anything else thrown\n * through a phase.\n */\nexport class OpenSpecCommandError extends CodedFailure {\n  override readonly name = \"OpenSpecCommandError\";\n}\n"]}

package/dist/commands/migrate-openspec/openspec/mapping.js

@@ -0,0 +1,162 @@
+/**
+ * The mapping document on the way in: YAML a human edited, graded into an
+ * `OpenSpecMapping` or refused with the line to fix.
+ *
+ * Split from `./decisions.ts`, which is the same document on the way out — the
+ * blank skeleton, the normalized record written beside a migration, and the
+ * routing query. Reading is where every refusal lives and writing is where none
+ * do, so the two halves have almost no vocabulary in common beyond the type.
+ */
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { serviceIdProblem } from "../../../core/kernel/ids/service.js";
+import { asRecord, dictionary, isStringArray } from "../../../core/kernel/records.js";
+import {} from "../../../core/openspec/model/mapping.js";
+import { message } from "../../../core/staging/commit.js";
+import { OpenSpecCommandError } from "./error.js";
+import { decodeSource } from "./read.js";
+function stringList(value, label) {
+    if (typeof value === "string")
+        return value.trim() === "" ? [] : [value.trim()];
+    if (!isStringArray(value)) {
+        throw new OpenSpecCommandError("invalid-option", `${label} must be a string or an array of service ids.`);
+    }
+    return [...new Set(value.map((item) => item.trim()).filter(Boolean))];
+}
+/**
+ * The service ids a mapping may name, checked against the ONE grammar.
+ *
+ * This used to carry its own copy of the rule — the same alphabet regex, the
+ * `.`/`..` tests, the trailing dot and the Windows device names — which is how
+ * the two spellings drifted apart to begin with: for a while migrate was the
+ * STRICTER of the two, so the primary authoring path accepted ids a migration
+ * refused. ids.ts owns the grammar now, so a mapping can only ever name a
+ * `services/<id>/` the authoring commands can still address.
+ *
+ * The refusal keeps migrate's own shape — `OpenSpecCommandError` with
+ * `invalid-option`, not an `Issue` — and `serviceIdProblem`'s label carries the
+ * mapping key, so the message still points at the line of the YAML to edit.
+ */
+function serviceList(value, label) {
+    const services = stringList(value, label);
+    for (const service of services) {
+        const problem = serviceIdProblem(service, label);
+        if (problem !== null)
+            throw new OpenSpecCommandError("invalid-option", problem);
+    }
+    return services;
+}
+export async function readMapping(path) {
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch (error) {
+        throw new OpenSpecCommandError("unknown-target", `Cannot read OpenSpec mapping ${path}: ${message(error)}`);
+    }
+    // Decoded rather than assumed: a mapping saved as UTF-16 parses as YAML with
+    // no capabilities block, and the refusal would name a missing decision
+    // instead of the encoding that hid it.
+    const raw = decodeSource(bytes, path, "OpenSpec mapping");
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (error) {
+        throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} is invalid YAML: ${message(error)}`);
+    }
+    const document = asRecord(parsed);
+    if (document === null || document.version !== 1) {
+        throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} must be a YAML mapping with version: 1.`);
+    }
+    const sourceNode = asRecord(document.source);
+    const source = sourceNode !== null
+        && typeof sourceNode.root === "string"
+        && typeof sourceNode.inventoryDigest === "string"
+        ? { root: sourceNode.root, inventoryDigest: sourceNode.inventoryDigest }
+        : null;
+    const capabilitiesNode = asRecord(document.capabilities);
+    if (capabilitiesNode === null) {
+        throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} must contain a capabilities mapping.`);
+    }
+    const capabilities = dictionary();
+    for (const [capability, value] of Object.entries(capabilitiesNode)) {
+        const record = asRecord(value);
+        const services = serviceList(record?.services ?? value, `capabilities.${capability}.services`);
+        const requirementServices = dictionary();
+        if (record?.requirementServices !== undefined) {
+            const allocations = asRecord(record.requirementServices);
+            if (allocations === null) {
+                throw new OpenSpecCommandError("invalid-option", `capabilities.${capability}.requirementServices must be a mapping.`);
+            }
+            for (const [requirement, selected] of Object.entries(allocations)) {
+                requirementServices[requirement] = serviceList(selected, `capabilities.${capability}.requirementServices.${requirement}`);
+            }
+        }
+        capabilities[capability] = { services, requirementServices };
+    }
+    const changesNode = asRecord(document.changes);
+    if (changesNode === null) {
+        throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} must contain a changes mapping.`);
+    }
+    const changes = dictionary();
+    for (const [change, value] of Object.entries(changesNode)) {
+        const record = asRecord(value);
+        if (record === null) {
+            throw new OpenSpecCommandError("invalid-option", `changes.${change} must be a mapping with explicit feature and title fields.`);
+        }
+        const featureValue = record.feature;
+        if (featureValue !== null && typeof featureValue !== "string") {
+            throw new OpenSpecCommandError("invalid-option", `changes.${change}.feature must be a string or null.`);
+        }
+        if (typeof record.title !== "string") {
+            throw new OpenSpecCommandError("invalid-option", `changes.${change}.title must be a string.`);
+        }
+        changes[change] = {
+            feature: typeof featureValue === "string" && featureValue.trim() !== "" ? featureValue.trim() : null,
+            title: record.title,
+        };
+    }
+    const renames = dictionary();
+    if (document.renames !== undefined) {
+        const renamesNode = asRecord(document.renames);
+        if (renamesNode === null) {
+            throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} renames must be a mapping.`);
+        }
+        for (const [key, value] of Object.entries(renamesNode)) {
+            const record = asRecord(value);
+            const requirementId = record !== null && "requirementId" in record ? record.requirementId : value;
+            // A freshly generated skeleton deliberately uses null: it remains a
+            // needsIdentity decision rather than becoming a malformed mapping.
+            if (requirementId === null || requirementId === "")
+                continue;
+            if (typeof requirementId !== "string") {
+                throw new OpenSpecCommandError("invalid-option", `renames.${key}.requirementId must be a string or null.`);
+            }
+            renames[key] = requirementId.trim();
+        }
+    }
+    // Recorded as written. Naming the disposition union here only meant asserting
+    // an unreviewed string into it: `mapping.invalid-artifact-disposition` is what
+    // actually grades this value, and it has to see what the human typed to be
+    // able to name it back to them.
+    const artifacts = dictionary();
+    if (document.artifacts !== undefined) {
+        const artifactsNode = asRecord(document.artifacts);
+        if (artifactsNode === null) {
+            throw new OpenSpecCommandError("invalid-option", `OpenSpec mapping ${path} artifacts must be a mapping.`);
+        }
+        for (const [artifactPath, value] of Object.entries(artifactsNode)) {
+            const record = asRecord(value);
+            const disposition = record !== null && "disposition" in record ? record.disposition : value;
+            if (disposition === null || disposition === "")
+                continue;
+            if (typeof disposition !== "string") {
+                throw new OpenSpecCommandError("invalid-option", `artifacts.${artifactPath}.disposition must be a string or null.`);
+            }
+            artifacts[artifactPath] = disposition;
+        }
+    }
+    return { source, capabilities, changes, renames, artifacts };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/commands/migrate-openspec/openspec/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/openspec/mapping.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The mapping document on the way in: YAML a human edited, graded into an\n * `OpenSpecMapping` or refused with the line to fix.\n *\n * Split from `./decisions.ts`, which is the same document on the way out — the\n * blank skeleton, the normalized record written beside a migration, and the\n * routing query. Reading is where every refusal lives and writing is where none\n * do, so the two halves have almost no vocabulary in common beyond the type.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { parse as parseYaml } from \"yaml\";\nimport { serviceIdProblem } from \"../../../core/kernel/ids/service.js\";\nimport { asRecord, dictionary, isStringArray } from \"../../../core/kernel/records.js\";\nimport { type OpenSpecMapping } from \"../../../core/openspec/model/mapping.js\";\nimport { message } from \"../../../core/staging/commit.js\";\nimport { OpenSpecCommandError } from \"./error.js\";\nimport { decodeSource } from \"./read.js\";\n\nfunction stringList(value: unknown, label: string): string[] {\n  if (typeof value === \"string\") return value.trim() === \"\" ? [] : [value.trim()];\n  if (!isStringArray(value)) {\n    throw new OpenSpecCommandError(\"invalid-option\", `${label} must be a string or an array of service ids.`);\n  }\n  return [...new Set(value.map((item) => item.trim()).filter(Boolean))];\n}\n\n/**\n * The service ids a mapping may name, checked against the ONE grammar.\n *\n * This used to carry its own copy of the rule — the same alphabet regex, the\n * `.`/`..` tests, the trailing dot and the Windows device names — which is how\n * the two spellings drifted apart to begin with: for a while migrate was the\n * STRICTER of the two, so the primary authoring path accepted ids a migration\n * refused. ids.ts owns the grammar now, so a mapping can only ever name a\n * `services/<id>/` the authoring commands can still address.\n *\n * The refusal keeps migrate's own shape — `OpenSpecCommandError` with\n * `invalid-option`, not an `Issue` — and `serviceIdProblem`'s label carries the\n * mapping key, so the message still points at the line of the YAML to edit.\n */\nfunction serviceList(value: unknown, label: string): string[] {\n  const services = stringList(value, label);\n  for (const service of services) {\n    const problem = serviceIdProblem(service, label);\n    if (problem !== null) throw new OpenSpecCommandError(\"invalid-option\", problem);\n  }\n  return services;\n}\n\nexport async function readMapping(path: string): Promise<OpenSpecMapping> {\n  let bytes: Buffer;\n  try {\n    bytes = await readFile(path);\n  } catch (error) {\n    throw new OpenSpecCommandError(\"unknown-target\", `Cannot read OpenSpec mapping ${path}: ${message(error)}`);\n  }\n  // Decoded rather than assumed: a mapping saved as UTF-16 parses as YAML with\n  // no capabilities block, and the refusal would name a missing decision\n  // instead of the encoding that hid it.\n  const raw = decodeSource(bytes, path, \"OpenSpec mapping\");\n  let parsed: unknown;\n  try {\n    parsed = parseYaml(raw);\n  } catch (error) {\n    throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} is invalid YAML: ${message(error)}`);\n  }\n  const document = asRecord(parsed);\n  if (document === null || document.version !== 1) {\n    throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} must be a YAML mapping with version: 1.`);\n  }\n  const sourceNode = asRecord(document.source);\n  const source = sourceNode !== null\n    && typeof sourceNode.root === \"string\"\n    && typeof sourceNode.inventoryDigest === \"string\"\n    ? { root: sourceNode.root, inventoryDigest: sourceNode.inventoryDigest }\n    : null;\n  const capabilitiesNode = asRecord(document.capabilities);\n  if (capabilitiesNode === null) {\n    throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} must contain a capabilities mapping.`);\n  }\n  const capabilities = dictionary<OpenSpecMapping[\"capabilities\"][string]>();\n  for (const [capability, value] of Object.entries(capabilitiesNode)) {\n    const record = asRecord(value);\n    const services = serviceList(record?.services ?? value, `capabilities.${capability}.services`);\n    const requirementServices = dictionary<string[]>();\n    if (record?.requirementServices !== undefined) {\n      const allocations = asRecord(record.requirementServices);\n      if (allocations === null) {\n        throw new OpenSpecCommandError(\n          \"invalid-option\",\n          `capabilities.${capability}.requirementServices must be a mapping.`,\n        );\n      }\n      for (const [requirement, selected] of Object.entries(allocations)) {\n        requirementServices[requirement] = serviceList(\n          selected,\n          `capabilities.${capability}.requirementServices.${requirement}`,\n        );\n      }\n    }\n    capabilities[capability] = { services, requirementServices };\n  }\n\n  const changesNode = asRecord(document.changes);\n  if (changesNode === null) {\n    throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} must contain a changes mapping.`);\n  }\n  const changes = dictionary<OpenSpecMapping[\"changes\"][string]>();\n  for (const [change, value] of Object.entries(changesNode)) {\n    const record = asRecord(value);\n    if (record === null) {\n      throw new OpenSpecCommandError(\n        \"invalid-option\",\n        `changes.${change} must be a mapping with explicit feature and title fields.`,\n      );\n    }\n    const featureValue = record.feature;\n    if (featureValue !== null && typeof featureValue !== \"string\") {\n      throw new OpenSpecCommandError(\"invalid-option\", `changes.${change}.feature must be a string or null.`);\n    }\n    if (typeof record.title !== \"string\") {\n      throw new OpenSpecCommandError(\"invalid-option\", `changes.${change}.title must be a string.`);\n    }\n    changes[change] = {\n      feature: typeof featureValue === \"string\" && featureValue.trim() !== \"\" ? featureValue.trim() : null,\n      title: record.title,\n    };\n  }\n\n  const renames = dictionary<string>();\n  if (document.renames !== undefined) {\n    const renamesNode = asRecord(document.renames);\n    if (renamesNode === null) {\n      throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} renames must be a mapping.`);\n    }\n    for (const [key, value] of Object.entries(renamesNode)) {\n      const record = asRecord(value);\n      const requirementId = record !== null && \"requirementId\" in record ? record.requirementId : value;\n      // A freshly generated skeleton deliberately uses null: it remains a\n      // needsIdentity decision rather than becoming a malformed mapping.\n      if (requirementId === null || requirementId === \"\") continue;\n      if (typeof requirementId !== \"string\") {\n        throw new OpenSpecCommandError(\"invalid-option\", `renames.${key}.requirementId must be a string or null.`);\n      }\n      renames[key] = requirementId.trim();\n    }\n  }\n  // Recorded as written. Naming the disposition union here only meant asserting\n  // an unreviewed string into it: `mapping.invalid-artifact-disposition` is what\n  // actually grades this value, and it has to see what the human typed to be\n  // able to name it back to them.\n  const artifacts = dictionary<string>();\n  if (document.artifacts !== undefined) {\n    const artifactsNode = asRecord(document.artifacts);\n    if (artifactsNode === null) {\n      throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec mapping ${path} artifacts must be a mapping.`);\n    }\n    for (const [artifactPath, value] of Object.entries(artifactsNode)) {\n      const record = asRecord(value);\n      const disposition = record !== null && \"disposition\" in record ? record.disposition : value;\n      if (disposition === null || disposition === \"\") continue;\n      if (typeof disposition !== \"string\") {\n        throw new OpenSpecCommandError(\"invalid-option\", `artifacts.${artifactPath}.disposition must be a string or null.`);\n      }\n      artifacts[artifactPath] = disposition;\n    }\n  }\n  return { source, capabilities, changes, renames, artifacts };\n}\n"]}

package/dist/commands/migrate-openspec/openspec/paths.js

@@ -0,0 +1,40 @@
+/**
+ * The path arithmetic every write decision in this command rests on.
+ *
+ * Three rules, kept together because they answer one question in two
+ * directions: is a path inside a tree it must stay out of (kernel's
+ * `isPathInside`, which this module used to restate as `contains`), what
+ * tree is it really in once symlinks are resolved (`canonicalForCreate`), and
+ * does a path claimed by the OpenSpec source stay inside the directory it was
+ * listed under (`safeArtifactRelative`). `materialize/stage.ts` builds the
+ * staging refusals out of the first two; `openspec/decisions.ts` uses them to
+ * keep a mapping skeleton out of the workspace it describes.
+ */
+import { existsSync } from "node:fs";
+import { realpath } from "node:fs/promises";
+import { basename, dirname, resolve } from "node:path";
+import { OpenSpecCommandError } from "./error.js";
+/** Resolve symlinks in the nearest existing ancestor of a not-yet-created path. */
+export async function canonicalForCreate(path) {
+    let cursor = path;
+    const suffix = [];
+    while (!existsSync(cursor)) {
+        const parent = dirname(cursor);
+        if (parent === cursor)
+            break;
+        suffix.unshift(basename(cursor));
+        cursor = parent;
+    }
+    return resolve(await realpath(cursor), ...suffix);
+}
+export function safeArtifactRelative(artifactPath, prefix, owner) {
+    if (!artifactPath.startsWith(prefix)) {
+        throw new OpenSpecCommandError("invalid-option", `${owner} contains an artifact outside its own directory: ${artifactPath}.`);
+    }
+    const segments = artifactPath.slice(prefix.length).split("/");
+    if (segments.length === 0 || segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new OpenSpecCommandError("invalid-option", `OpenSpec artifact has an unsafe relative path: ${artifactPath}.`);
+    }
+    return segments;
+}
+//# sourceMappingURL=paths.js.map

package/dist/commands/migrate-openspec/openspec/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/openspec/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM;QAC7B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,YAAoB,EAAE,MAAc,EAAE,KAAa;IACtF,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,GAAG,KAAK,oDAAoD,YAAY,GAAG,CAC5E,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,kDAAkD,YAAY,GAAG,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * The path arithmetic every write decision in this command rests on.\n *\n * Three rules, kept together because they answer one question in two\n * directions: is a path inside a tree it must stay out of (kernel's\n * `isPathInside`, which this module used to restate as `contains`), what\n * tree is it really in once symlinks are resolved (`canonicalForCreate`), and\n * does a path claimed by the OpenSpec source stay inside the directory it was\n * listed under (`safeArtifactRelative`). `materialize/stage.ts` builds the\n * staging refusals out of the first two; `openspec/decisions.ts` uses them to\n * keep a mapping skeleton out of the workspace it describes.\n */\nimport { existsSync } from \"node:fs\";\nimport { realpath } from \"node:fs/promises\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { OpenSpecCommandError } from \"./error.js\";\n\n/** Resolve symlinks in the nearest existing ancestor of a not-yet-created path. */\nexport async function canonicalForCreate(path: string): Promise<string> {\n  let cursor = path;\n  const suffix: string[] = [];\n  while (!existsSync(cursor)) {\n    const parent = dirname(cursor);\n    if (parent === cursor) break;\n    suffix.unshift(basename(cursor));\n    cursor = parent;\n  }\n  return resolve(await realpath(cursor), ...suffix);\n}\n\nexport function safeArtifactRelative(artifactPath: string, prefix: string, owner: string): string[] {\n  if (!artifactPath.startsWith(prefix)) {\n    throw new OpenSpecCommandError(\n      \"invalid-option\",\n      `${owner} contains an artifact outside its own directory: ${artifactPath}.`,\n    );\n  }\n  const segments = artifactPath.slice(prefix.length).split(\"/\");\n  if (segments.length === 0 || segments.some((segment) => segment === \"\" || segment === \".\" || segment === \"..\")) {\n    throw new OpenSpecCommandError(\"invalid-option\", `OpenSpec artifact has an unsafe relative path: ${artifactPath}.`);\n  }\n  return segments;\n}\n"]}

package/dist/commands/migrate-openspec/openspec/read.js

@@ -0,0 +1,49 @@
+/**
+ * Bytes out of somebody else's repository, decoded or refused by name.
+ *
+ * Every other phase reads its input through here rather than calling `readFile`
+ * itself, which is the point: the encoding rule below is one line of code, and
+ * the defect it prevents is a migration that reports success over requirements
+ * it silently dropped. A read added later to a materializer has to come through
+ * this module to reach the source at all.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { decodeDocument, NotUtf8DocumentError } from "../../../core/kernel/document-bytes.js";
+import { OpenSpecCommandError } from "./error.js";
+/**
+ * A document this command is about to migrate, decoded or refused BY NAME.
+ *
+ * Every other read on this path used `readFile(…, "utf8")`, which never fails:
+ * bytes that are not UTF-8 become U+FFFD and a UTF-16 spec.md becomes text with
+ * no headings in it. Downstream that is not a wrong answer but a silent one —
+ * `parseRequirements` returns [], the capability materializes as a `spec.md`
+ * with an empty `## Requirements`, and the migration reports success over a file
+ * whose every requirement was dropped. Migration is the one command whose input
+ * is somebody else's repository, written by tooling loam does not control, so
+ * this is where lossy decoding is both most likely and least acceptable.
+ *
+ * The ingest scan already refuses non-UTF-8 artifacts up front
+ * (`openspec.non-utf8-artifact`); holding the same rule at the point of use
+ * means a read added later cannot quietly skip it, and it is what catches the
+ * encoding the scan's `isUtf8` cannot see — UTF-16 written without a BOM, whose
+ * bytes are valid UTF-8 with a NUL between every character.
+ */
+export function decodeSource(bytes, path, label) {
+    try {
+        return decodeDocument(bytes, path);
+    }
+    catch (error) {
+        if (!(error instanceof NotUtf8DocumentError))
+            throw error;
+        // `error.message` already opens with the path; the label says which of the
+        // two inputs it is — the corpus being migrated, or the mapping about it.
+        throw new OpenSpecCommandError("invalid-option", `${label}: ${error.message}`);
+    }
+}
+/** A path under the audited OpenSpec root, decoded the same way. */
+export async function readSourceArtifact(root, artifactPath) {
+    const absolute = join(root, artifactPath);
+    return decodeSource(await readFile(absolute), absolute, "OpenSpec source artifact");
+}
+//# sourceMappingURL=read.js.map

package/dist/commands/migrate-openspec/openspec/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/openspec/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY,EAAE,KAAa;IACrE,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,oBAAoB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC1D,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,GAAG,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,YAAoB;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC1C,OAAO,YAAY,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,0BAA0B,CAAC,CAAC;AACtF,CAAC","sourcesContent":["/**\n * Bytes out of somebody else's repository, decoded or refused by name.\n *\n * Every other phase reads its input through here rather than calling `readFile`\n * itself, which is the point: the encoding rule below is one line of code, and\n * the defect it prevents is a migration that reports success over requirements\n * it silently dropped. A read added later to a materializer has to come through\n * this module to reach the source at all.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { decodeDocument, NotUtf8DocumentError } from \"../../../core/kernel/document-bytes.js\";\nimport { OpenSpecCommandError } from \"./error.js\";\n\n/**\n * A document this command is about to migrate, decoded or refused BY NAME.\n *\n * Every other read on this path used `readFile(…, \"utf8\")`, which never fails:\n * bytes that are not UTF-8 become U+FFFD and a UTF-16 spec.md becomes text with\n * no headings in it. Downstream that is not a wrong answer but a silent one —\n * `parseRequirements` returns [], the capability materializes as a `spec.md`\n * with an empty `## Requirements`, and the migration reports success over a file\n * whose every requirement was dropped. Migration is the one command whose input\n * is somebody else's repository, written by tooling loam does not control, so\n * this is where lossy decoding is both most likely and least acceptable.\n *\n * The ingest scan already refuses non-UTF-8 artifacts up front\n * (`openspec.non-utf8-artifact`); holding the same rule at the point of use\n * means a read added later cannot quietly skip it, and it is what catches the\n * encoding the scan's `isUtf8` cannot see — UTF-16 written without a BOM, whose\n * bytes are valid UTF-8 with a NUL between every character.\n */\nexport function decodeSource(bytes: Buffer, path: string, label: string): string {\n  try {\n    return decodeDocument(bytes, path);\n  } catch (error) {\n    if (!(error instanceof NotUtf8DocumentError)) throw error;\n    // `error.message` already opens with the path; the label says which of the\n    // two inputs it is — the corpus being migrated, or the mapping about it.\n    throw new OpenSpecCommandError(\"invalid-option\", `${label}: ${error.message}`);\n  }\n}\n\n/** A path under the audited OpenSpec root, decoded the same way. */\nexport async function readSourceArtifact(root: string, artifactPath: string): Promise<string> {\n  const absolute = join(root, artifactPath);\n  return decodeSource(await readFile(absolute), absolute, \"OpenSpec source artifact\");\n}\n"]}

package/dist/commands/migrate-openspec/print.js

@@ -0,0 +1,89 @@
+/**
+ * The human view of an inventory, shared by both verbs.
+ *
+ * `audit-openspec` and `migrate-openspec` print the same block and differ only
+ * in the word above it, so the renderer takes the mode rather than existing
+ * twice — the audit's readiness line and the migration's are the same claim and
+ * have to stay the same claim.
+ *
+ * The local `plural` is not a duplicate of `../format.ts`'s. That one spells
+ * the regular English plural only, and says so: an irregular noun belongs at
+ * the call site. "capability"/"capabilities" is exactly that noun, so this
+ * renderer carries the two-form variant instead of misspelling a count.
+ */
+import {} from "../../core/openspec/model/model.js";
+function plural(count, one, many = `${one}s`) {
+    return `${count} ${count === 1 ? one : many}`;
+}
+export function printInventory(inventory, mode) {
+    const status = inventory.ready
+        ? "ready"
+        : inventory.mechanicallyCompatible
+            ? "compatible; explicit mapping/identity decisions remain"
+            : "living or active blockers found";
+    console.log(`OpenSpec ${mode} inventory — ${status}`);
+    console.log(`  root          ${inventory.root}`);
+    console.log(`  baseline      release ${inventory.baselines.release.version}@${inventory.baselines.release.commit} · main canary ${inventory.baselines.mainCanary.commit.slice(0, 7)}`);
+    console.log(`  living       ${plural(inventory.living.capabilities.length, "capability", "capabilities")} · ${plural(inventory.living.specFiles, "spec file")} · ${plural(inventory.living.requirements, "requirement")} · ${plural(inventory.living.scenarios, "scenario")}`);
+    console.log(`  changes      ${inventory.changes.counts.active} active · ${inventory.changes.counts.archived} archived`);
+    console.log(`  readiness    living ${inventory.readiness.living.compatible ? "ok" : "blocked"} · active ${inventory.readiness.active.compatible ? "ok" : "blocked"} · source ${inventory.readiness.sourceCurrent ? "current" : "stale"} · capabilities ${inventory.readiness.mappingsResolved ? "resolved" : "open"} · changes ${inventory.readiness.changesResolved ? "resolved" : "open"} · dispositions ${inventory.readiness.dispositionsResolved ? "resolved" : "open"} · archive ${inventory.archiveDiagnostics.length} diagnostic(s)`);
+    if (inventory.needsMapping.length > 0) {
+        console.log("\n  capability → service decisions");
+        for (const decision of inventory.needsMapping) {
+            console.log(`    ? ${decision.capability} → ${decision.suggestedService}  [${decision.status}]`);
+        }
+    }
+    if (inventory.needsChangeMapping.length > 0) {
+        console.log("\n  change → feature decisions");
+        for (const decision of inventory.needsChangeMapping) {
+            console.log(`    ? ${decision.change} → ${decision.suggestedFeature}  [${decision.status}]`);
+        }
+    }
+    const activeRenames = inventory.renamed.filter((rename) => rename.scope === "active");
+    if (activeRenames.length > 0) {
+        console.log("\n  RENAMED identity decisions");
+        for (const rename of activeRenames) {
+            console.log(`    ${rename.status === "mapped" ? "✓" : "?"} ${rename.key}  ${rename.from ?? "<missing FROM>"} → ${rename.to ?? "<missing TO>"}${rename.requirementId ? `  [${rename.requirementId}]` : ""}`);
+        }
+    }
+    if (inventory.needsDisposition.length > 0) {
+        console.log(`\n  authored artifact decisions (${inventory.needsDisposition.length})`);
+        for (const decision of inventory.needsDisposition.slice(0, 12)) {
+            console.log(`    ? ${decision.path} → ${decision.suggestedDisposition}  [${decision.status}]`);
+        }
+        if (inventory.needsDisposition.length > 12) {
+            console.log(`    … ${inventory.needsDisposition.length - 12} more in --json/mapping output`);
+        }
+    }
+    if (inventory.mappingIssues.length > 0) {
+        console.log("\n  mapping issues");
+        for (const item of inventory.mappingIssues)
+            console.log(`    ✗ ${item.code}  ${item.message}`);
+    }
+    if (inventory.unsupported.length > 0) {
+        console.log("\n  living/active blockers");
+        for (const item of inventory.unsupported) {
+            console.log(`    ✗ ${item.code}  ${item.path} — ${item.message}`);
+        }
+    }
+    if (inventory.archiveDiagnostics.length > 0) {
+        console.log(`\n  archive diagnostics (non-blocking, ${inventory.archiveDiagnostics.length})`);
+        for (const item of inventory.archiveDiagnostics.slice(0, 12)) {
+            console.log(`    · ${item.code}  ${item.path} — ${item.message}`);
+        }
+        if (inventory.archiveDiagnostics.length > 12) {
+            console.log(`    … ${inventory.archiveDiagnostics.length - 12} more in --json output`);
+        }
+    }
+    const dispositions = new Map();
+    for (const artifact of inventory.artifacts) {
+        dispositions.set(artifact.disposition, (dispositions.get(artifact.disposition) ?? 0) + 1);
+    }
+    if (dispositions.size > 0) {
+        console.log("\n  artifact disposition");
+        for (const [disposition, count] of [...dispositions].sort(([a], [b]) => a.localeCompare(b))) {
+            console.log(`    · ${disposition}  ${count}`);
+        }
+    }
+}
+//# sourceMappingURL=print.js.map

package/dist/commands/migrate-openspec/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/commands/migrate-openspec/print.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The human view of an inventory, shared by both verbs.\n *\n * `audit-openspec` and `migrate-openspec` print the same block and differ only\n * in the word above it, so the renderer takes the mode rather than existing\n * twice — the audit's readiness line and the migration's are the same claim and\n * have to stay the same claim.\n *\n * The local `plural` is not a duplicate of `../format.ts`'s. That one spells\n * the regular English plural only, and says so: an irregular noun belongs at\n * the call site. \"capability\"/\"capabilities\" is exactly that noun, so this\n * renderer carries the two-form variant instead of misspelling a count.\n */\nimport { type OpenSpecInventory } from \"../../core/openspec/model/model.js\";\n\nfunction plural(count: number, one: string, many = `${one}s`): string {\n  return `${count} ${count === 1 ? one : many}`;\n}\n\nexport function printInventory(inventory: OpenSpecInventory, mode: \"audit\" | \"migration\"): void {\n  const status = inventory.ready\n    ? \"ready\"\n    : inventory.mechanicallyCompatible\n      ? \"compatible; explicit mapping/identity decisions remain\"\n      : \"living or active blockers found\";\n  console.log(`OpenSpec ${mode} inventory — ${status}`);\n  console.log(`  root          ${inventory.root}`);\n  console.log(\n    `  baseline      release ${inventory.baselines.release.version}@${inventory.baselines.release.commit} · main canary ${inventory.baselines.mainCanary.commit.slice(0, 7)}`,\n  );\n  console.log(\n    `  living       ${plural(inventory.living.capabilities.length, \"capability\", \"capabilities\")} · ${plural(inventory.living.specFiles, \"spec file\")} · ${plural(inventory.living.requirements, \"requirement\")} · ${plural(inventory.living.scenarios, \"scenario\")}`,\n  );\n  console.log(\n    `  changes      ${inventory.changes.counts.active} active · ${inventory.changes.counts.archived} archived`,\n  );\n  console.log(\n    `  readiness    living ${inventory.readiness.living.compatible ? \"ok\" : \"blocked\"} · active ${inventory.readiness.active.compatible ? \"ok\" : \"blocked\"} · source ${inventory.readiness.sourceCurrent ? \"current\" : \"stale\"} · capabilities ${inventory.readiness.mappingsResolved ? \"resolved\" : \"open\"} · changes ${inventory.readiness.changesResolved ? \"resolved\" : \"open\"} · dispositions ${inventory.readiness.dispositionsResolved ? \"resolved\" : \"open\"} · archive ${inventory.archiveDiagnostics.length} diagnostic(s)`,\n  );\n\n  if (inventory.needsMapping.length > 0) {\n    console.log(\"\\n  capability → service decisions\");\n    for (const decision of inventory.needsMapping) {\n      console.log(`    ? ${decision.capability} → ${decision.suggestedService}  [${decision.status}]`);\n    }\n  }\n  if (inventory.needsChangeMapping.length > 0) {\n    console.log(\"\\n  change → feature decisions\");\n    for (const decision of inventory.needsChangeMapping) {\n      console.log(`    ? ${decision.change} → ${decision.suggestedFeature}  [${decision.status}]`);\n    }\n  }\n  const activeRenames = inventory.renamed.filter((rename) => rename.scope === \"active\");\n  if (activeRenames.length > 0) {\n    console.log(\"\\n  RENAMED identity decisions\");\n    for (const rename of activeRenames) {\n      console.log(\n        `    ${rename.status === \"mapped\" ? \"✓\" : \"?\"} ${rename.key}  ${rename.from ?? \"<missing FROM>\"} → ${rename.to ?? \"<missing TO>\"}${rename.requirementId ? `  [${rename.requirementId}]` : \"\"}`,\n      );\n    }\n  }\n  if (inventory.needsDisposition.length > 0) {\n    console.log(`\\n  authored artifact decisions (${inventory.needsDisposition.length})`);\n    for (const decision of inventory.needsDisposition.slice(0, 12)) {\n      console.log(`    ? ${decision.path} → ${decision.suggestedDisposition}  [${decision.status}]`);\n    }\n    if (inventory.needsDisposition.length > 12) {\n      console.log(`    … ${inventory.needsDisposition.length - 12} more in --json/mapping output`);\n    }\n  }\n  if (inventory.mappingIssues.length > 0) {\n    console.log(\"\\n  mapping issues\");\n    for (const item of inventory.mappingIssues) console.log(`    ✗ ${item.code}  ${item.message}`);\n  }\n  if (inventory.unsupported.length > 0) {\n    console.log(\"\\n  living/active blockers\");\n    for (const item of inventory.unsupported) {\n      console.log(`    ✗ ${item.code}  ${item.path} — ${item.message}`);\n    }\n  }\n  if (inventory.archiveDiagnostics.length > 0) {\n    console.log(`\\n  archive diagnostics (non-blocking, ${inventory.archiveDiagnostics.length})`);\n    for (const item of inventory.archiveDiagnostics.slice(0, 12)) {\n      console.log(`    · ${item.code}  ${item.path} — ${item.message}`);\n    }\n    if (inventory.archiveDiagnostics.length > 12) {\n      console.log(`    … ${inventory.archiveDiagnostics.length - 12} more in --json output`);\n    }\n  }\n  const dispositions = new Map<string, number>();\n  for (const artifact of inventory.artifacts) {\n    dispositions.set(artifact.disposition, (dispositions.get(artifact.disposition) ?? 0) + 1);\n  }\n  if (dispositions.size > 0) {\n    console.log(\"\\n  artifact disposition\");\n    for (const [disposition, count] of [...dispositions].sort(([a], [b]) => a.localeCompare(b))) {\n      console.log(`    · ${disposition}  ${count}`);\n    }\n  }\n}\n"]}