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

package/dist/core/openspec/decide/verdict.js

@@ -0,0 +1,84 @@
+/**
+ * Is this migration ready, and what does the answer look like?
+ *
+ * Readiness is one judgement over everything the scan and the decisions found,
+ * and it lives in one function so the six conditions can be read together. Five
+ * of them are human decisions and the sixth is the corpus itself; a migration
+ * that satisfied five of six used to read as "nearly ready", which is not a
+ * state `--apply` may act on.
+ *
+ * The per-axis `readiness` block exists so an agent can say WHICH of the six is
+ * open without re-deriving it from the issue list — the same information, but
+ * the derivation is here rather than in every reader.
+ */
+import { compareIds } from "../../repo/entries.js";
+import {} from "../model/mapping.js";
+import { OPENSPEC_BASELINES, } from "../model/model.js";
+import { sortIssues } from "../scan/changes.js";
+export function inventoryVerdict(found) {
+    const { located, inventoryDigest, config, storeMetadataPath, livingCounts, capabilities, active, archived, renamed, blockers, archiveDiagnostics, artifacts, mappingDecisions, changeDecisions, mappingIssues, artifactDecisions, } = found;
+    const { inputRoot, root } = located;
+    mappingIssues.sort((a, b) => compareIds(a.key, b.key) || compareIds(a.code, b.code));
+    renamed.sort((a, b) => compareIds(a.path, b.path) || a.line - b.line || compareIds(a.key, b.key));
+    sortIssues(blockers);
+    sortIssues(archiveDiagnostics);
+    const livingIssueCount = blockers.filter((item) => item.scope === "workspace" || item.scope === "living").length;
+    const activeIssueCount = blockers.filter((item) => item.scope === "active").length;
+    const needsMapping = mappingDecisions.filter((decision) => decision.status === "needsMapping");
+    const needsChangeMapping = changeDecisions.filter((decision) => decision.status === "needsFeature");
+    const needsDisposition = artifactDecisions.filter((decision) => decision.status === "needsDisposition");
+    const unresolvedActiveRenames = renamed.filter((rename) => rename.scope === "active" && rename.status === "needsIdentity");
+    const mechanicallyCompatible = livingIssueCount === 0 && activeIssueCount === 0;
+    const ready = mechanicallyCompatible
+        && needsMapping.length === 0
+        && needsChangeMapping.length === 0
+        && unresolvedActiveRenames.length === 0
+        && needsDisposition.length === 0
+        && mappingIssues.length === 0;
+    return {
+        baselines: OPENSPEC_BASELINES,
+        inputRoot,
+        root,
+        inventoryDigest,
+        workspace: {
+            kind: located.kind,
+            config,
+            storeMetadataPath,
+        },
+        ready,
+        mechanicallyCompatible,
+        readiness: {
+            living: { compatible: livingIssueCount === 0, issueCount: livingIssueCount },
+            active: { compatible: activeIssueCount === 0, issueCount: activeIssueCount },
+            sourceCurrent: !mappingIssues.some((item) => item.code.startsWith("mapping.source-")),
+            mappingsResolved: needsMapping.length === 0 && !mappingIssues.some((item) => item.code === "mapping.unknown-capability"
+                || item.code === "mapping.unknown-requirement"
+                || item.code.startsWith("mapping.requirement-")
+                || item.code === "mapping.service-allocation-empty"),
+            changesResolved: needsChangeMapping.length === 0 && !mappingIssues.some((item) => item.code === "mapping.unknown-change"
+                || item.code === "mapping.change-title-missing"
+                || item.code.startsWith("mapping.feature-id-")),
+            renamesResolved: unresolvedActiveRenames.length === 0 && !mappingIssues.some((item) => item.code.includes("rename") || item.code.includes("requirement-id")),
+            dispositionsResolved: needsDisposition.length === 0 && !mappingIssues.some((item) => item.code.includes("artifact")),
+            migrationReady: ready,
+        },
+        living: { ...livingCounts, capabilities },
+        changes: {
+            active,
+            archived,
+            counts: { active: active.length, archived: archived.length },
+        },
+        renamed,
+        unsupported: blockers,
+        archiveDiagnostics,
+        mappingDecisions,
+        needsMapping,
+        changeDecisions,
+        needsChangeMapping,
+        mappingIssues,
+        artifacts,
+        artifactDecisions,
+        needsDisposition,
+    };
+}
+//# sourceMappingURL=verdict.js.map

package/dist/core/openspec/decide/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../../../src/core/openspec/decide/verdict.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Is this migration ready, and what does the answer look like?\n *\n * Readiness is one judgement over everything the scan and the decisions found,\n * and it lives in one function so the six conditions can be read together. Five\n * of them are human decisions and the sixth is the corpus itself; a migration\n * that satisfied five of six used to read as \"nearly ready\", which is not a\n * state `--apply` may act on.\n *\n * The per-axis `readiness` block exists so an agent can say WHICH of the six is\n * open without re-deriving it from the issue list — the same information, but\n * the derivation is here rather than in every reader.\n */\nimport { compareIds } from \"../../repo/entries.js\";\nimport {\n  type OpenSpecMapping,\n  type CapabilityMappingDecision,\n  type OpenSpecChangeDecision,\n  type OpenSpecMappingIssue,\n} from \"../model/mapping.js\";\nimport {\n  OPENSPEC_BASELINES,\n  type OpenSpecArtifact,\n  type OpenSpecArtifactDecision,\n  type OpenSpecCapability,\n  type OpenSpecChange,\n  type OpenSpecCounts,\n  type OpenSpecInventory,\n  type OpenSpecRenamedUsage,\n  type OpenSpecUnsupportedShape,\n} from \"../model/model.js\";\nimport { sortIssues } from \"../scan/changes.js\";\n\n/** Everything a finished read produced, before it is graded into a verdict. */\nexport interface Findings {\n  located: { inputRoot: string; root: string; kind: OpenSpecInventory[\"workspace\"][\"kind\"] };\n  mapping: OpenSpecMapping;\n  inventoryDigest: string;\n  config: OpenSpecInventory[\"workspace\"][\"config\"];\n  storeMetadataPath: string | null;\n  livingCounts: OpenSpecCounts;\n  capabilities: OpenSpecCapability[];\n  active: OpenSpecChange[];\n  archived: OpenSpecChange[];\n  renamed: OpenSpecRenamedUsage[];\n  blockers: OpenSpecUnsupportedShape[];\n  archiveDiagnostics: OpenSpecUnsupportedShape[];\n  artifacts: OpenSpecArtifact[];\n  mappingDecisions: CapabilityMappingDecision[];\n  changeDecisions: OpenSpecChangeDecision[];\n  mappingIssues: OpenSpecMappingIssue[];\n  artifactDecisions: OpenSpecArtifactDecision[];\n}\n\nexport function inventoryVerdict(found: Findings): OpenSpecInventory {\n  const {\n    located, inventoryDigest, config, storeMetadataPath, livingCounts, capabilities,\n    active, archived, renamed, blockers, archiveDiagnostics, artifacts,\n    mappingDecisions, changeDecisions, mappingIssues, artifactDecisions,\n  } = found;\n  const { inputRoot, root } = located;\n  mappingIssues.sort((a, b) => compareIds(a.key, b.key) || compareIds(a.code, b.code));\n\n  renamed.sort((a, b) => compareIds(a.path, b.path) || a.line - b.line || compareIds(a.key, b.key));\n  sortIssues(blockers);\n  sortIssues(archiveDiagnostics);\n  const livingIssueCount = blockers.filter((item) => item.scope === \"workspace\" || item.scope === \"living\").length;\n  const activeIssueCount = blockers.filter((item) => item.scope === \"active\").length;\n  const needsMapping = mappingDecisions.filter((decision) => decision.status === \"needsMapping\");\n  const needsChangeMapping = changeDecisions.filter((decision) => decision.status === \"needsFeature\");\n  const needsDisposition = artifactDecisions.filter((decision) => decision.status === \"needsDisposition\");\n  const unresolvedActiveRenames = renamed.filter(\n    (rename) => rename.scope === \"active\" && rename.status === \"needsIdentity\",\n  );\n  const mechanicallyCompatible = livingIssueCount === 0 && activeIssueCount === 0;\n  const ready = mechanicallyCompatible\n    && needsMapping.length === 0\n    && needsChangeMapping.length === 0\n    && unresolvedActiveRenames.length === 0\n    && needsDisposition.length === 0\n    && mappingIssues.length === 0;\n\n  return {\n    baselines: OPENSPEC_BASELINES,\n    inputRoot,\n    root,\n    inventoryDigest,\n    workspace: {\n      kind: located.kind,\n      config,\n      storeMetadataPath,\n    },\n    ready,\n    mechanicallyCompatible,\n    readiness: {\n      living: { compatible: livingIssueCount === 0, issueCount: livingIssueCount },\n      active: { compatible: activeIssueCount === 0, issueCount: activeIssueCount },\n      sourceCurrent: !mappingIssues.some((item) => item.code.startsWith(\"mapping.source-\")),\n      mappingsResolved: needsMapping.length === 0 && !mappingIssues.some((item) =>\n        item.code === \"mapping.unknown-capability\"\n        || item.code === \"mapping.unknown-requirement\"\n        || item.code.startsWith(\"mapping.requirement-\")\n        || item.code === \"mapping.service-allocation-empty\"),\n      changesResolved: needsChangeMapping.length === 0 && !mappingIssues.some((item) =>\n        item.code === \"mapping.unknown-change\"\n        || item.code === \"mapping.change-title-missing\"\n        || item.code.startsWith(\"mapping.feature-id-\")),\n      renamesResolved: unresolvedActiveRenames.length === 0 && !mappingIssues.some((item) => item.code.includes(\"rename\") || item.code.includes(\"requirement-id\")),\n      dispositionsResolved: needsDisposition.length === 0 && !mappingIssues.some((item) => item.code.includes(\"artifact\")),\n      migrationReady: ready,\n    },\n    living: { ...livingCounts, capabilities },\n    changes: {\n      active,\n      archived,\n      counts: { active: active.length, archived: archived.length },\n    },\n    renamed,\n    unsupported: blockers,\n    archiveDiagnostics,\n    mappingDecisions,\n    needsMapping,\n    changeDecisions,\n    needsChangeMapping,\n    mappingIssues,\n    artifacts,\n    artifactDecisions,\n    needsDisposition,\n  };\n}\n"]}

package/dist/core/openspec/inventory.js

@@ -0,0 +1,221 @@
+/**
+ * One whole OpenSpec workspace, read and graded in one pass.
+ *
+ * The order below is the contract: everything is SCANNED before anything is
+ * DECIDED, because a decision graded against a half-read corpus is worse than
+ * no decision — it reads as reviewed. So this module locates the root, walks
+ * it, reads every document through `./scan/`, and only then hands the result to
+ * `./decide/`, which is the half a human's mapping can change.
+ *
+ * The digest is taken over the non-archive artifacts only. It binds a mapping
+ * to the truth it was reviewed against, and frozen archive history is neither
+ * migrated nor allowed to block readiness — covering it meant a colleague's typo
+ * fix under `changes/archive/` killed a completed mapping, with no `--force` and
+ * no indication of which file had moved.
+ */
+import { isUtf8 } from "node:buffer";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { compareIds } from "../repo/entries.js";
+import { parseRequirements } from "../document/parse.js";
+import { emptyMapping } from "./model/mapping.js";
+import {} from "./model/model.js";
+import { locateOpenSpecRoot } from "./scan/workspace.js";
+import { digestInventory, hiddenSubdirs, isSymbolicLink, portable, sourceInventoryPath, subdirs, walkFiles, walkSymlinks, } from "./scan/walk.js";
+import { inspectSpecFile, issue } from "./scan/shape.js";
+import { inspectConfig } from "./scan/config.js";
+import { artifactFor, artifactScope, inventoryChanges } from "./scan/changes.js";
+import { capabilityDecisions } from "./decide/capabilities.js";
+import { resolveRenames } from "./decide/renames.js";
+import { artifactDispositions } from "./decide/dispositions.js";
+import { inventoryVerdict } from "./decide/verdict.js";
+import { isDirectory } from "./scan/walk.js";
+import { addCounts } from "./scan/shape.js";
+import {} from "./model/model.js";
+export async function inventoryOpenSpec(input, options = {}) {
+    const located = await locateOpenSpecRoot(input);
+    const { inputRoot, root } = located;
+    const mapping = emptyMapping(options.mapping);
+    const renamed = [];
+    const blockers = [];
+    // The read in progress. Every reader below appends to these two lists rather
+    // than returning findings, because the ORDER they land in is what the `--json`
+    // contract pins — five arrays merged afterwards would be a different report.
+    const ingest = { root, mapping, renamed, unsupported: blockers };
+    const archiveDiagnostics = [];
+    for (const absolute of await walkSymlinks(root)) {
+        const path = portable(root, absolute);
+        const scope = artifactScope(path);
+        issue(scope === "archive" ? archiveDiagnostics : blockers, scope, {
+            code: "openspec.symlink-unsupported",
+            path: path,
+            message: "Symbolic links are not followed by migration inventory; replace this link with an in-tree regular file or directory.",
+        });
+    }
+    const config = await inspectConfig(root, blockers);
+    const specsRoot = join(root, "specs");
+    const changesRoot = join(root, "changes");
+    const inputStoreMetadata = join(inputRoot, ".openspec-store", "store.yaml");
+    const parentStoreMetadata = basename(root) === "openspec"
+        ? join(dirname(root), ".openspec-store", "store.yaml")
+        : inputStoreMetadata;
+    const storeMetadata = existsSync(inputStoreMetadata) ? inputStoreMetadata : parentStoreMetadata;
+    const storeMetadataExists = existsSync(storeMetadata);
+    const storeMetadataSymlink = storeMetadataExists && await isSymbolicLink(storeMetadata);
+    if (storeMetadataSymlink) {
+        issue(blockers, "workspace", {
+            code: "openspec.symlink-unsupported",
+            path: sourceInventoryPath(root, storeMetadata),
+            message: "Symbolic Store metadata is not followed; replace it with an in-tree regular file.",
+        });
+    }
+    const hasModernEmptyShape = config !== null || (storeMetadataExists && !storeMetadataSymlink);
+    if (!await isDirectory(specsRoot) && !hasModernEmptyShape) {
+        issue(blockers, "living", {
+            code: "openspec.specs-missing",
+            path: "specs",
+            message: "Living specs/ directory is missing.",
+        });
+    }
+    if (config !== null && config.store !== null && !await isDirectory(specsRoot) && !await isDirectory(changesRoot)) {
+        issue(blockers, "workspace", {
+            code: "openspec.external-store-pointer",
+            path: "config.yaml",
+            message: `Planning is externalized to Store '${config.store}'; audit that registered Store checkout directly.`,
+        });
+    }
+    const capabilities = [];
+    const livingRequirements = new Map();
+    const livingCounts = { specFiles: 0, requirements: 0, scenarios: 0 };
+    const livingTree = await walkFiles(specsRoot);
+    const livingFiles = livingTree.filter((path) => basename(path) === "spec.md");
+    // The living twin of openspec.nonstandard-change-spec. Selecting living specs
+    // by exact basename is right, but without the mirror a mis-cased or renamed
+    // file simply disappears: specs/payments/Spec.md audited as a clean, empty
+    // corpus while the identical shape under a change was reported.
+    for (const file of livingTree.filter((path) => /\.md$/i.test(path) && basename(path) !== "spec.md" && basename(path) !== "design.md")) {
+        blockers.push({
+            code: "openspec.nonstandard-living-spec",
+            path: portable(root, file),
+            message: "Markdown under specs/ is named neither spec.md nor design.md, so no capability reads it.",
+            scope: "living",
+        });
+    }
+    for (const specFile of livingFiles) {
+        const id = portable(specsRoot, dirname(specFile));
+        const inspected = await inspectSpecFile(ingest, specFile, "living", null);
+        livingRequirements.set(id, inspected.requirements);
+        const capability = { id, files: [inspected.path], ...inspected.counts };
+        capabilities.push(capability);
+        addCounts(livingCounts, inspected.counts);
+    }
+    capabilities.sort((a, b) => compareIds(a.id, b.id));
+    const activeIds = (await subdirs(changesRoot)).filter((id) => id !== "archive");
+    const archiveRoot = join(changesRoot, "archive");
+    const archivedIds = await subdirs(archiveRoot);
+    for (const id of await hiddenSubdirs(changesRoot)) {
+        blockers.push({
+            code: "openspec.hidden-change-directory",
+            path: portable(root, join(changesRoot, id)),
+            message: "A dot-prefixed change directory is not enumerated as a change, so nothing under it is migrated; rename it or move it out of changes/.",
+            scope: "active",
+        });
+    }
+    for (const id of await hiddenSubdirs(archiveRoot)) {
+        archiveDiagnostics.push({
+            code: "openspec.hidden-change-directory",
+            path: portable(root, join(archiveRoot, id)),
+            message: "A dot-prefixed archive directory is not enumerated as a change; frozen history is retained read-only where it is.",
+            scope: "archive",
+        });
+    }
+    const fallbackSchema = config?.schema ?? "spec-driven";
+    const active = await inventoryChanges(ingest, {
+        base: changesRoot,
+        ids: activeIds,
+        scope: "active",
+        fallbackSchema,
+        findings: blockers,
+    });
+    const archived = await inventoryChanges(ingest, {
+        base: archiveRoot,
+        ids: archivedIds,
+        scope: "archive",
+        fallbackSchema,
+        findings: archiveDiagnostics,
+    });
+    // Last-resort backstop under the whole "audited past the corpus" family, and
+    // the one check that does not depend on root selection being right: an
+    // inventory that read no living spec AND no active change describes nothing,
+    // so no verdict over it can be `ready`. That is exactly the shape the Store
+    // misdetection produced — ready, mechanically compatible, zero capabilities,
+    // zero unsupported shapes — where the failure verdict was more confident than
+    // any success verdict. A greenfield workspace whose only requirements live
+    // under changes/ has an active change and is not caught here.
+    if (livingCounts.specFiles === 0 && active.length === 0) {
+        blockers.push({
+            code: "openspec.workspace-empty",
+            path: ".",
+            message: `Planning root ${root} holds no living spec and no active change; there is nothing to migrate, so confirm this is the directory that really holds the corpus.`,
+            scope: "workspace",
+        });
+    }
+    const artifactFiles = await walkFiles(root);
+    if (storeMetadataExists && !storeMetadataSymlink && !artifactFiles.includes(storeMetadata)) {
+        artifactFiles.push(storeMetadata);
+    }
+    for (const absolute of artifactFiles) {
+        const bytes = await readFile(absolute);
+        if (isUtf8(bytes))
+            continue;
+        const rootPath = portable(root, absolute);
+        const artifactPath = sourceInventoryPath(root, absolute);
+        const scope = absolute === storeMetadata ? "workspace" : artifactScope(rootPath);
+        issue(scope === "archive" ? archiveDiagnostics : blockers, scope, {
+            code: "openspec.non-utf8-artifact",
+            path: artifactPath,
+            message: "Migration can preserve only valid UTF-8 authored artifacts; convert this file to UTF-8 before apply.",
+        });
+    }
+    // The digest binds a mapping to the truth it was reviewed against, and frozen
+    // archive history is neither migrated nor allowed to block readiness. Covering
+    // it meant a colleague's typo fix under changes/archive/ killed a completed
+    // mapping, with no --force and no indication of which file moved.
+    const inventoryDigest = await digestInventory(root, artifactFiles.filter((absolute) => artifactScope(portable(root, absolute)) !== "archive"));
+    const artifacts = artifactFiles
+        .map((path) => artifactFor(root, path))
+        .sort((a, b) => compareIds(a.path, b.path));
+    const { mappingIssues, mappingDecisions, changeDecisions, routing } = capabilityDecisions({
+        root,
+        mapping,
+        // An audit grades no source binding: there is no mapping to bind yet.
+        bound: options.mapping !== undefined,
+        inventoryDigest,
+        livingRequirements,
+        active,
+        renamed,
+    });
+    resolveRenames({ root, mapping, bound: options.mapping !== undefined, inventoryDigest, livingRequirements, active, renamed }, routing, mappingIssues);
+    const artifactDecisions = artifactDispositions(artifacts, mapping, new Set(active.map((change) => change.id)), mappingIssues);
+    return inventoryVerdict({
+        located,
+        mapping,
+        inventoryDigest,
+        config,
+        storeMetadataPath: storeMetadataExists ? sourceInventoryPath(root, storeMetadata) : null,
+        livingCounts,
+        capabilities,
+        active,
+        archived,
+        renamed,
+        blockers,
+        archiveDiagnostics,
+        artifacts,
+        mappingDecisions,
+        changeDecisions,
+        mappingIssues,
+        artifactDecisions,
+    });
+}
+//# sourceMappingURL=inventory.js.map

package/dist/core/openspec/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../../src/core/openspec/inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAoF,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,kBAAkB,EAAe,MAAM,qBAAqB,CAAC;AACtE,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAgD,MAAM,kBAAkB,CAAC;AAEhF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,OAAO,GAAkC,EAAE;IAE3C,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,6EAA6E;IAC7E,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,MAAM,GAAW,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACzE,MAAM,kBAAkB,GAA+B,EAAE,CAAC;IAC1D,KAAK,MAAM,QAAQ,IAAI,MAAM,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE;YAChE,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,sHAAsH;SAChI,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,UAAU;QACvD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC;QACtD,CAAC,CAAC,kBAAkB,CAAC;IACvB,MAAM,aAAa,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAChG,MAAM,mBAAmB,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,oBAAoB,GAAG,mBAAmB,IAAI,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;IACxF,IAAI,oBAAoB,EAAE,CAAC;QACzB,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE;YAC3B,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC;YAC9C,OAAO,EAAE,mFAAmF;SAC7F,CAAC,CAAC;IACL,CAAC;IACD,MAAM,mBAAmB,GAAG,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC9F,IAAI,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1D,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,qCAAqC;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QACjH,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE;YAC3B,IAAI,EAAE,iCAAiC;YACvC,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,sCAAsC,MAAM,CAAC,KAAK,mDAAmD;SAC/G,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAyB,EAAE,CAAC;IAC9C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAgD,CAAC;IACnF,MAAM,YAAY,GAAmB,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrF,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAC9E,8EAA8E;IAC9E,4EAA4E;IAC5E,2EAA2E;IAC3E,gEAAgE;IAChE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,EAAE,CAAC;QACzF,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;YAC1B,OAAO,EAAE,0FAA0F;YACnG,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1E,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QACxE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAChF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,KAAK,MAAM,EAAE,IAAI,MAAM,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,uIAAuI;YAChJ,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,MAAM,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,kBAAkB,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,mHAAmH;YAC5H,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,EAAE,MAAM,IAAI,aAAa,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE;QAC5C,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,QAAQ;QACf,cAAc;QACd,QAAQ,EAAE,QAAQ;KACnB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE;QAC9C,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,SAAS;QAChB,cAAc;QACd,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAC;IAEH,6EAA6E;IAC7E,uEAAuE;IACvE,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,2EAA2E;IAC3E,8DAA8D;IAC9D,IAAI,YAAY,CAAC,SAAS,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,iBAAiB,IAAI,yIAAyI;YACvK,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,mBAAmB,IAAI,CAAC,oBAAoB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3F,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,KAAK,CAAC;YAAE,SAAS;QAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjF,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE;YAChE,IAAI,EAAE,4BAA4B;YAClC,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,sGAAsG;SAChH,CAAC,CAAC;IACL,CAAC;IACD,8EAA8E;IAC9E,+EAA+E;IAC/E,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,eAAe,GAAG,MAAM,eAAe,CAC3C,IAAI,EACJ,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,SAAS,CAAC,CAC1F,CAAC;IACF,MAAM,SAAS,GAAG,aAAa;SAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9C,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC;QACxF,IAAI;QACJ,OAAO;QACP,sEAAsE;QACtE,KAAK,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS;QACpC,eAAe;QACf,kBAAkB;QAClB,MAAM;QACN,OAAO;KACR,CAAC,CAAC;IACH,cAAc,CACZ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,EAC7G,OAAO,EACP,aAAa,CACd,CAAC;IACF,MAAM,iBAAiB,GAAG,oBAAoB,CAC5C,SAAS,EACT,OAAO,EACP,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAC1C,aAAa,CACd,CAAC;IAEF,OAAO,gBAAgB,CAAC;QACtB,OAAO;QACP,OAAO;QACP,eAAe;QACf,MAAM;QACN,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QACxF,YAAY;QACZ,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,kBAAkB;QAClB,SAAS;QACT,gBAAgB;QAChB,eAAe;QACf,aAAa;QACb,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * One whole OpenSpec workspace, read and graded in one pass.\n *\n * The order below is the contract: everything is SCANNED before anything is\n * DECIDED, because a decision graded against a half-read corpus is worse than\n * no decision — it reads as reviewed. So this module locates the root, walks\n * it, reads every document through `./scan/`, and only then hands the result to\n * `./decide/`, which is the half a human's mapping can change.\n *\n * The digest is taken over the non-archive artifacts only. It binds a mapping\n * to the truth it was reviewed against, and frozen archive history is neither\n * migrated nor allowed to block readiness — covering it meant a colleague's typo\n * fix under `changes/archive/` killed a completed mapping, with no `--force` and\n * no indication of which file had moved.\n */\nimport { isUtf8 } from \"node:buffer\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { basename, dirname, join } from \"node:path\";\nimport { compareIds } from \"../repo/entries.js\";\nimport { parseRequirements } from \"../document/parse.js\";\nimport { emptyMapping, type OpenSpecMapping } from \"./model/mapping.js\";\nimport { type OpenSpecInventory, type OpenSpecRenamedUsage, type OpenSpecUnsupportedShape } from \"./model/model.js\";\nimport { locateOpenSpecRoot, type Ingest } from \"./scan/workspace.js\";\nimport {\n  digestInventory,\n  hiddenSubdirs,\n  isSymbolicLink,\n  portable,\n  sourceInventoryPath,\n  subdirs,\n  walkFiles,\n  walkSymlinks,\n} from \"./scan/walk.js\";\nimport { inspectSpecFile, issue } from \"./scan/shape.js\";\nimport { inspectConfig } from \"./scan/config.js\";\nimport { artifactFor, artifactScope, inventoryChanges } from \"./scan/changes.js\";\nimport { capabilityDecisions } from \"./decide/capabilities.js\";\nimport { resolveRenames } from \"./decide/renames.js\";\nimport { artifactDispositions } from \"./decide/dispositions.js\";\nimport { inventoryVerdict } from \"./decide/verdict.js\";\nimport { isDirectory } from \"./scan/walk.js\";\nimport { addCounts } from \"./scan/shape.js\";\nimport { type OpenSpecCapability, type OpenSpecCounts } from \"./model/model.js\";\n\nexport async function inventoryOpenSpec(\n  input: string,\n  options: { mapping?: OpenSpecMapping } = {},\n): Promise<OpenSpecInventory> {\n  const located = await locateOpenSpecRoot(input);\n  const { inputRoot, root } = located;\n  const mapping = emptyMapping(options.mapping);\n  const renamed: OpenSpecRenamedUsage[] = [];\n  const blockers: OpenSpecUnsupportedShape[] = [];\n  // The read in progress. Every reader below appends to these two lists rather\n  // than returning findings, because the ORDER they land in is what the `--json`\n  // contract pins — five arrays merged afterwards would be a different report.\n  const ingest: Ingest = { root, mapping, renamed, unsupported: blockers };\n  const archiveDiagnostics: OpenSpecUnsupportedShape[] = [];\n  for (const absolute of await walkSymlinks(root)) {\n    const path = portable(root, absolute);\n    const scope = artifactScope(path);\n    issue(scope === \"archive\" ? archiveDiagnostics : blockers, scope, {\n      code: \"openspec.symlink-unsupported\",\n      path: path,\n      message: \"Symbolic links are not followed by migration inventory; replace this link with an in-tree regular file or directory.\",\n    });\n  }\n  const config = await inspectConfig(root, blockers);\n  const specsRoot = join(root, \"specs\");\n  const changesRoot = join(root, \"changes\");\n  const inputStoreMetadata = join(inputRoot, \".openspec-store\", \"store.yaml\");\n  const parentStoreMetadata = basename(root) === \"openspec\"\n    ? join(dirname(root), \".openspec-store\", \"store.yaml\")\n    : inputStoreMetadata;\n  const storeMetadata = existsSync(inputStoreMetadata) ? inputStoreMetadata : parentStoreMetadata;\n  const storeMetadataExists = existsSync(storeMetadata);\n  const storeMetadataSymlink = storeMetadataExists && await isSymbolicLink(storeMetadata);\n  if (storeMetadataSymlink) {\n    issue(blockers, \"workspace\", {\n      code: \"openspec.symlink-unsupported\",\n      path: sourceInventoryPath(root, storeMetadata),\n      message: \"Symbolic Store metadata is not followed; replace it with an in-tree regular file.\",\n    });\n  }\n  const hasModernEmptyShape = config !== null || (storeMetadataExists && !storeMetadataSymlink);\n  if (!await isDirectory(specsRoot) && !hasModernEmptyShape) {\n    issue(blockers, \"living\", {\n      code: \"openspec.specs-missing\",\n      path: \"specs\",\n      message: \"Living specs/ directory is missing.\",\n    });\n  }\n  if (config !== null && config.store !== null && !await isDirectory(specsRoot) && !await isDirectory(changesRoot)) {\n    issue(blockers, \"workspace\", {\n      code: \"openspec.external-store-pointer\",\n      path: \"config.yaml\",\n      message: `Planning is externalized to Store '${config.store}'; audit that registered Store checkout directly.`,\n    });\n  }\n\n  const capabilities: OpenSpecCapability[] = [];\n  const livingRequirements = new Map<string, ReturnType<typeof parseRequirements>>();\n  const livingCounts: OpenSpecCounts = { specFiles: 0, requirements: 0, scenarios: 0 };\n  const livingTree = await walkFiles(specsRoot);\n  const livingFiles = livingTree.filter((path) => basename(path) === \"spec.md\");\n  // The living twin of openspec.nonstandard-change-spec. Selecting living specs\n  // by exact basename is right, but without the mirror a mis-cased or renamed\n  // file simply disappears: specs/payments/Spec.md audited as a clean, empty\n  // corpus while the identical shape under a change was reported.\n  for (const file of livingTree.filter((path) =>\n    /\\.md$/i.test(path) && basename(path) !== \"spec.md\" && basename(path) !== \"design.md\")) {\n    blockers.push({\n      code: \"openspec.nonstandard-living-spec\",\n      path: portable(root, file),\n      message: \"Markdown under specs/ is named neither spec.md nor design.md, so no capability reads it.\",\n      scope: \"living\",\n    });\n  }\n  for (const specFile of livingFiles) {\n    const id = portable(specsRoot, dirname(specFile));\n    const inspected = await inspectSpecFile(ingest, specFile, \"living\", null);\n    livingRequirements.set(id, inspected.requirements);\n    const capability = { id, files: [inspected.path], ...inspected.counts };\n    capabilities.push(capability);\n    addCounts(livingCounts, inspected.counts);\n  }\n  capabilities.sort((a, b) => compareIds(a.id, b.id));\n\n  const activeIds = (await subdirs(changesRoot)).filter((id) => id !== \"archive\");\n  const archiveRoot = join(changesRoot, \"archive\");\n  const archivedIds = await subdirs(archiveRoot);\n  for (const id of await hiddenSubdirs(changesRoot)) {\n    blockers.push({\n      code: \"openspec.hidden-change-directory\",\n      path: portable(root, join(changesRoot, id)),\n      message: \"A dot-prefixed change directory is not enumerated as a change, so nothing under it is migrated; rename it or move it out of changes/.\",\n      scope: \"active\",\n    });\n  }\n  for (const id of await hiddenSubdirs(archiveRoot)) {\n    archiveDiagnostics.push({\n      code: \"openspec.hidden-change-directory\",\n      path: portable(root, join(archiveRoot, id)),\n      message: \"A dot-prefixed archive directory is not enumerated as a change; frozen history is retained read-only where it is.\",\n      scope: \"archive\",\n    });\n  }\n  const fallbackSchema = config?.schema ?? \"spec-driven\";\n  const active = await inventoryChanges(ingest, {\n    base: changesRoot,\n    ids: activeIds,\n    scope: \"active\",\n    fallbackSchema,\n    findings: blockers,\n  });\n  const archived = await inventoryChanges(ingest, {\n    base: archiveRoot,\n    ids: archivedIds,\n    scope: \"archive\",\n    fallbackSchema,\n    findings: archiveDiagnostics,\n  });\n\n  // Last-resort backstop under the whole \"audited past the corpus\" family, and\n  // the one check that does not depend on root selection being right: an\n  // inventory that read no living spec AND no active change describes nothing,\n  // so no verdict over it can be `ready`. That is exactly the shape the Store\n  // misdetection produced — ready, mechanically compatible, zero capabilities,\n  // zero unsupported shapes — where the failure verdict was more confident than\n  // any success verdict. A greenfield workspace whose only requirements live\n  // under changes/ has an active change and is not caught here.\n  if (livingCounts.specFiles === 0 && active.length === 0) {\n    blockers.push({\n      code: \"openspec.workspace-empty\",\n      path: \".\",\n      message: `Planning root ${root} holds no living spec and no active change; there is nothing to migrate, so confirm this is the directory that really holds the corpus.`,\n      scope: \"workspace\",\n    });\n  }\n\n  const artifactFiles = await walkFiles(root);\n  if (storeMetadataExists && !storeMetadataSymlink && !artifactFiles.includes(storeMetadata)) {\n    artifactFiles.push(storeMetadata);\n  }\n  for (const absolute of artifactFiles) {\n    const bytes = await readFile(absolute);\n    if (isUtf8(bytes)) continue;\n    const rootPath = portable(root, absolute);\n    const artifactPath = sourceInventoryPath(root, absolute);\n    const scope = absolute === storeMetadata ? \"workspace\" : artifactScope(rootPath);\n    issue(scope === \"archive\" ? archiveDiagnostics : blockers, scope, {\n      code: \"openspec.non-utf8-artifact\",\n      path: artifactPath,\n      message: \"Migration can preserve only valid UTF-8 authored artifacts; convert this file to UTF-8 before apply.\",\n    });\n  }\n  // The digest binds a mapping to the truth it was reviewed against, and frozen\n  // archive history is neither migrated nor allowed to block readiness. Covering\n  // it meant a colleague's typo fix under changes/archive/ killed a completed\n  // mapping, with no --force and no indication of which file moved.\n  const inventoryDigest = await digestInventory(\n    root,\n    artifactFiles.filter((absolute) => artifactScope(portable(root, absolute)) !== \"archive\"),\n  );\n  const artifacts = artifactFiles\n    .map((path) => artifactFor(root, path))\n    .sort((a, b) => compareIds(a.path, b.path));\n\n  const { mappingIssues, mappingDecisions, changeDecisions, routing } = capabilityDecisions({\n    root,\n    mapping,\n    // An audit grades no source binding: there is no mapping to bind yet.\n    bound: options.mapping !== undefined,\n    inventoryDigest,\n    livingRequirements,\n    active,\n    renamed,\n  });\n  resolveRenames(\n    { root, mapping, bound: options.mapping !== undefined, inventoryDigest, livingRequirements, active, renamed },\n    routing,\n    mappingIssues,\n  );\n  const artifactDecisions = artifactDispositions(\n    artifacts,\n    mapping,\n    new Set(active.map((change) => change.id)),\n    mappingIssues,\n  );\n\n  return inventoryVerdict({\n    located,\n    mapping,\n    inventoryDigest,\n    config,\n    storeMetadataPath: storeMetadataExists ? sourceInventoryPath(root, storeMetadata) : null,\n    livingCounts,\n    capabilities,\n    active,\n    archived,\n    renamed,\n    blockers,\n    archiveDiagnostics,\n    artifacts,\n    mappingDecisions,\n    changeDecisions,\n    mappingIssues,\n    artifactDecisions,\n  });\n}\n"]}

package/dist/core/openspec/model/mapping.js

@@ -0,0 +1,76 @@
+/**
+ * The human decisions an audit asks for, and the blank form it hands over.
+ *
+ * Separate from `./model.ts` because these are the only shapes a PERSON edits.
+ * The skeleton is generated from a finished inventory rather than from the
+ * workspace, so every slot in it is a decision the audit actually reached — a
+ * form with a field nothing grades is a form somebody fills in for nothing.
+ */
+import { dictionary } from "../../kernel/records.js";
+import {} from "./model.js";
+import {} from "./model.js";
+export function emptyMapping(mapping) {
+    if (mapping === undefined) {
+        return {
+            source: null,
+            capabilities: dictionary(),
+            changes: dictionary(),
+            renames: dictionary(),
+            artifacts: dictionary(),
+        };
+    }
+    // Keep the core inventory tolerant of programmatic v0 callers while the CLI
+    // parser enforces the complete v1 document, including explicit `changes`.
+    return {
+        source: mapping.source ?? null,
+        capabilities: mapping.capabilities ?? dictionary(),
+        changes: mapping.changes ?? dictionary(),
+        renames: mapping.renames ?? dictionary(),
+        artifacts: mapping.artifacts ?? dictionary(),
+    };
+}
+export function createOpenSpecMappingSkeleton(inventory) {
+    return {
+        version: 1,
+        source: { root: inventory.root, inventoryDigest: inventory.inventoryDigest },
+        capabilities: Object.fromEntries(inventory.mappingDecisions.map((decision) => [
+            decision.capability,
+            {
+                services: decision.services,
+                suggestedServices: [decision.suggestedService],
+                requirementServices: decision.requirementServices,
+            },
+        ])),
+        changes: Object.fromEntries(inventory.changeDecisions.map((decision) => [
+            decision.change,
+            {
+                feature: null,
+                suggestedFeature: decision.suggestedFeature,
+                title: decision.title,
+            },
+        ])),
+        renames: Object.fromEntries(inventory.renamed
+            .filter((rename) => rename.scope === "active")
+            .map((rename) => [rename.key, {
+                from: rename.from,
+                to: rename.to,
+                existingRequirementId: rename.existingRequirementId,
+                // The identity the inventory settled on, which is the field the
+                // skeleton is asking a human to fill in. `existingRequirementId` is
+                // the living source's own id and happens to equal it on the only path
+                // that reaches here today — but a caller that audits WITH a mapping
+                // would have a settled id and no existing one, and the skeleton would
+                // hand that decision back as unmade.
+                requirementId: rename.requirementId,
+            }])),
+        artifacts: Object.fromEntries(inventory.artifactDecisions.map((decision) => [
+            decision.path,
+            {
+                kind: decision.kind,
+                disposition: null,
+                suggestedDisposition: decision.suggestedDisposition,
+            },
+        ])),
+    };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/core/openspec/model/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../../../src/core/openspec/model/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAA0B,MAAM,YAAY,CAAC;AACpD,OAAO,EAAoC,MAAM,YAAY,CAAC;AA4G9D,MAAM,UAAU,YAAY,CAAC,OAAyB;IACpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,UAAU,EAAE;YAC1B,OAAO,EAAE,UAAU,EAAE;YACrB,OAAO,EAAE,UAAU,EAAE;YACrB,SAAS,EAAE,UAAU,EAAE;SACxB,CAAC;IACJ,CAAC;IACD,4EAA4E;IAC5E,0EAA0E;IAC1E,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,UAAU,EAAE;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU,EAAE;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU,EAAE;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,SAA4B;IACxE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,eAAe,EAAE;QAC5E,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC5E,QAAQ,CAAC,UAAU;YACnB;gBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,iBAAiB,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAC9C,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;aAClD;SACF,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtE,QAAQ,CAAC,MAAM;YACf;gBACE,OAAO,EAAE,IAAI;gBACb,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB;SACF,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,SAAS,CAAC,OAAO;aACd,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC;aAC7C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;gBACnD,gEAAgE;gBAChE,oEAAoE;gBACpE,sEAAsE;gBACtE,oEAAoE;gBACpE,sEAAsE;gBACtE,qCAAqC;gBACrC,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,CAAC,CAAC,CACN;QACD,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC1E,QAAQ,CAAC,IAAI;YACb;gBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,IAAI;gBACjB,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;aACpD;SACF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The human decisions an audit asks for, and the blank form it hands over.\n *\n * Separate from `./model.ts` because these are the only shapes a PERSON edits.\n * The skeleton is generated from a finished inventory rather than from the\n * workspace, so every slot in it is a decision the audit actually reached — a\n * form with a field nothing grades is a form somebody fills in for nothing.\n */\nimport { dictionary } from \"../../kernel/records.js\";\nimport { type OpenSpecInventory } from \"./model.js\";\nimport { type OpenSpecArtifactDisposition } from \"./model.js\";\n\nexport interface CapabilityMappingDecision {\n  capability: string;\n  /** Backward-compatible convenience for consumers that only understand one owner. */\n  service: string | null;\n  /** One capability may need to be split across multiple loam services. */\n  services: string[];\n  /** Required only when a capability is split across more than one service. */\n  requirementServices: Record<string, string[]>;\n  suggestedService: string;\n  hasLivingSpec: boolean;\n  activeChanges: string[];\n  status: \"needsMapping\" | \"mapped\";\n}\n\nexport interface OpenSpecCapabilityMapping {\n  services: string[];\n  requirementServices: Record<string, string[]>;\n}\n\nexport interface OpenSpecChangeMapping {\n  feature: string | null;\n  title: string;\n}\n\nexport interface OpenSpecChangeDecision {\n  change: string;\n  feature: string | null;\n  title: string;\n  suggestedFeature: string;\n  suggestedTitle: string;\n  status: \"needsFeature\" | \"mapped\";\n}\n\nexport interface OpenSpecMapping {\n  source: { root: string; inventoryDigest: string } | null;\n  capabilities: Record<string, OpenSpecCapabilityMapping>;\n  changes: Record<string, OpenSpecChangeMapping>;\n  renames: Record<string, string>;\n  /**\n   * Whatever a human wrote, not what the type wishes they had written. Declaring\n   * this as the disposition union meant the parser had to assert its way into\n   * it, so an unrecognised disposition arrived typed as a valid one and only\n   * `mapping.invalid-artifact-disposition` — a check downstream of the parse —\n   * stood between it and code comparing it against a literal. The union is\n   * recovered where it is needed, through `isOpenSpecArtifactDisposition`.\n   */\n  artifacts: Record<string, string>;\n}\n\nexport interface OpenSpecMappingIssue {\n  code:\n    | \"mapping.source-missing\"\n    | \"mapping.source-root-mismatch\"\n    | \"mapping.source-digest-mismatch\"\n    | \"mapping.unknown-capability\"\n    | \"mapping.unknown-requirement\"\n    | \"mapping.requirement-allocation-missing\"\n    | \"mapping.requirement-service-unknown\"\n    | \"mapping.service-allocation-empty\"\n    | \"mapping.unknown-change\"\n    | \"mapping.change-title-missing\"\n    | \"mapping.feature-id-invalid\"\n    | \"mapping.feature-id-duplicate\"\n    | \"mapping.unknown-rename\"\n    | \"mapping.invalid-requirement-id\"\n    | \"mapping.rename-source-missing\"\n    | \"mapping.rename-source-ambiguous\"\n    | \"mapping.rename-source-id-invalid\"\n    | \"mapping.rename-target-conflict\"\n    | \"mapping.rename-existing-id-conflict\"\n    | \"mapping.rename-id-conflict\"\n    | \"mapping.rename-double-source\"\n    | \"mapping.rename-double-target\"\n    | \"mapping.rename-chain\"\n    | \"mapping.unknown-artifact\"\n    | \"mapping.invalid-artifact-disposition\";\n  key: string;\n  message: string;\n}\n\nexport interface OpenSpecMappingSkeleton {\n  version: 1;\n  source: { root: string; inventoryDigest: string };\n  capabilities: Record<string, {\n    services: string[];\n    suggestedServices: string[];\n    requirementServices: Record<string, string[]>;\n  }>;\n  changes: Record<string, {\n    feature: null;\n    suggestedFeature: string;\n    title: string;\n  }>;\n  renames: Record<string, {\n    from: string | null;\n    to: string | null;\n    existingRequirementId: string | null;\n    requirementId: string | null;\n  }>;\n  artifacts: Record<string, {\n    kind: \"proposal\" | \"tasks\" | \"change-design\";\n    disposition: null;\n    suggestedDisposition: OpenSpecArtifactDisposition;\n  }>;\n}\n\nexport function emptyMapping(mapping?: OpenSpecMapping): OpenSpecMapping {\n  if (mapping === undefined) {\n    return {\n      source: null,\n      capabilities: dictionary(),\n      changes: dictionary(),\n      renames: dictionary(),\n      artifacts: dictionary(),\n    };\n  }\n  // Keep the core inventory tolerant of programmatic v0 callers while the CLI\n  // parser enforces the complete v1 document, including explicit `changes`.\n  return {\n    source: mapping.source ?? null,\n    capabilities: mapping.capabilities ?? dictionary(),\n    changes: mapping.changes ?? dictionary(),\n    renames: mapping.renames ?? dictionary(),\n    artifacts: mapping.artifacts ?? dictionary(),\n  };\n}\n\nexport function createOpenSpecMappingSkeleton(inventory: OpenSpecInventory): OpenSpecMappingSkeleton {\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: decision.services,\n        suggestedServices: [decision.suggestedService],\n        requirementServices: decision.requirementServices,\n      },\n    ])),\n    changes: Object.fromEntries(inventory.changeDecisions.map((decision) => [\n      decision.change,\n      {\n        feature: null,\n        suggestedFeature: decision.suggestedFeature,\n        title: decision.title,\n      },\n    ])),\n    renames: Object.fromEntries(\n      inventory.renamed\n        .filter((rename) => rename.scope === \"active\")\n        .map((rename) => [rename.key, {\n          from: rename.from,\n          to: rename.to,\n          existingRequirementId: rename.existingRequirementId,\n          // The identity the inventory settled on, which is the field the\n          // skeleton is asking a human to fill in. `existingRequirementId` is\n          // the living source's own id and happens to equal it on the only path\n          // that reaches here today — but a caller that audits WITH a mapping\n          // would have a settled id and no existing one, and the skeleton would\n          // hand that decision back as unmade.\n          requirementId: rename.requirementId,\n        }]),\n    ),\n    artifacts: Object.fromEntries(inventory.artifactDecisions.map((decision) => [\n      decision.path,\n      {\n        kind: decision.kind,\n        disposition: null,\n        suggestedDisposition: decision.suggestedDisposition,\n      },\n    ])),\n  };\n}\n"]}

package/dist/core/openspec/model/model.js

@@ -0,0 +1,65 @@
+/**
+ * What an OpenSpec workspace IS, as loam models it.
+ *
+ * `core/openspec-inventory.ts` was the one foreign model in this codebase and
+ * this package is still it: OpenSpec's vocabulary — capabilities, changes,
+ * RENAMED pairs, `.openspec.yaml` — is named here and nowhere else, and nothing
+ * outside `commands/migrate-openspec/` may import an `OpenSpec*` type. That
+ * quarantine is the point of the package, not a side effect of its size.
+ *
+ * Types only, plus the one error the root search throws. Every module below
+ * fills these in; none of them redefines one.
+ */
+import {} from "./mapping.js";
+/**
+ * The upstream commits this binary's OpenSpec compatibility is measured against:
+ * `release` is the certified current release, swept file by file by the corpus
+ * gate (`scripts/check-openspec-corpus.ts`) and vendored as the seven verbatim
+ * fixtures. `mainCanary` is the older post-v1.7 canary, kept as a regression pin
+ * rather than as a claim about where `main` points today — at the time of the
+ * v1.9.0 pin, `main` and the release tag were the same commit.
+ */
+export const OPENSPEC_BASELINES = Object.freeze({
+    release: Object.freeze({
+        version: "1.9.0",
+        ref: "v1.9.0",
+        commit: "2826b8889e5223a9a8095d4428b60b56597e1020",
+    }),
+    mainCanary: Object.freeze({
+        ref: "main",
+        commit: "45cca5db6137ed209117cc70510eb3e057fb981b",
+    }),
+});
+/**
+ * The dispositions as values, not only as a type, because a mapping file names
+ * one as a plain string and the parse boundary has to be able to ask whether
+ * that string is one of these. A hand-written second spelling of the same list
+ * is how a disposition added here would go on being unrecognised where it is
+ * read from somebody else's YAML.
+ */
+export const OPENSPEC_ARTIFACT_DISPOSITIONS = [
+    "translate-project-context",
+    "record-external-planning-root",
+    "remove-after-cutover",
+    "map-requirements",
+    "review-as-service-adr",
+    "translate-change-metadata",
+    "convert-to-intent",
+    "preserve-as-legacy-checklist",
+    "review-as-feature-adr",
+    "map-delta",
+    "review-custom-workflow",
+    "retain-read-only",
+    "manual-review",
+];
+/** Whether an authored string names a disposition this codebase actually defines. */
+export function isOpenSpecArtifactDisposition(value) {
+    return OPENSPEC_ARTIFACT_DISPOSITIONS.includes(value);
+}
+export class OpenSpecRootError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OpenSpecRootError";
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/core/openspec/model/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/core/openspec/model/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAIN,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,OAAO;QAChB,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,0CAA0C;KACnD,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,GAAG,EAAE,MAAM;QACX,MAAM,EAAE,0CAA0C;KACnD,CAAC;CACH,CAAC,CAAC;AA4EH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,2BAA2B;IAC3B,+BAA+B;IAC/B,sBAAsB;IACtB,kBAAkB;IAClB,uBAAuB;IACvB,2BAA2B;IAC3B,mBAAmB;IACnB,8BAA8B;IAC9B,uBAAuB;IACvB,WAAW;IACX,wBAAwB;IACxB,kBAAkB;IAClB,eAAe;CACP,CAAC;AAGX,qFAAqF;AACrF,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAQ,8BAAoD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AA8ED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF","sourcesContent":["/**\n * What an OpenSpec workspace IS, as loam models it.\n *\n * `core/openspec-inventory.ts` was the one foreign model in this codebase and\n * this package is still it: OpenSpec's vocabulary — capabilities, changes,\n * RENAMED pairs, `.openspec.yaml` — is named here and nowhere else, and nothing\n * outside `commands/migrate-openspec/` may import an `OpenSpec*` type. That\n * quarantine is the point of the package, not a side effect of its size.\n *\n * Types only, plus the one error the root search throws. Every module below\n * fills these in; none of them redefines one.\n */\nimport {\n  type CapabilityMappingDecision,\n  type OpenSpecChangeDecision,\n  type OpenSpecMappingIssue,\n} from \"./mapping.js\";\n\n/**\n * The upstream commits this binary's OpenSpec compatibility is measured against:\n * `release` is the certified current release, swept file by file by the corpus\n * gate (`scripts/check-openspec-corpus.ts`) and vendored as the seven verbatim\n * fixtures. `mainCanary` is the older post-v1.7 canary, kept as a regression pin\n * rather than as a claim about where `main` points today — at the time of the\n * v1.9.0 pin, `main` and the release tag were the same commit.\n */\nexport const OPENSPEC_BASELINES = Object.freeze({\n  release: Object.freeze({\n    version: \"1.9.0\",\n    ref: \"v1.9.0\",\n    commit: \"2826b8889e5223a9a8095d4428b60b56597e1020\",\n  }),\n  mainCanary: Object.freeze({\n    ref: \"main\",\n    commit: \"45cca5db6137ed209117cc70510eb3e057fb981b\",\n  }),\n});\n\nexport interface OpenSpecCounts {\n  specFiles: number;\n  requirements: number;\n  scenarios: number;\n}\n\nexport interface OpenSpecCapability extends OpenSpecCounts {\n  /** Nested capability ids retain their complete relative directory, e.g. payments/refunds. */\n  id: string;\n  files: string[];\n}\n\nexport interface OpenSpecChangeMetadata {\n  path: string | null;\n  schema: string | null;\n  skipSpecs: boolean;\n  created: string | null;\n  fields: string[];\n}\n\nexport interface OpenSpecChangeSpec extends OpenSpecCounts {\n  capability: string;\n  path: string;\n  requirementNames: string[];\n}\n\nexport interface OpenSpecChange extends OpenSpecCounts {\n  id: string;\n  files: string[];\n  specs: OpenSpecChangeSpec[];\n  artifacts: string[];\n  metadata: OpenSpecChangeMetadata;\n}\n\nexport type OpenSpecIssueScope = \"workspace\" | \"living\" | \"active\" | \"archive\";\n\nexport interface OpenSpecRenamedUsage {\n  /** Stable key used by the mapping file. */\n  key: string;\n  path: string;\n  line: number;\n  scope: \"active\" | \"archive\";\n  changeId: string;\n  capability: string;\n  from: string | null;\n  to: string | null;\n  existingRequirementId: string | null;\n  requirementId: string | null;\n  status: \"needsIdentity\" | \"mapped\";\n}\n\nexport interface OpenSpecUnsupportedShape {\n  code: string;\n  path: string;\n  message: string;\n  scope: OpenSpecIssueScope;\n}\n\nexport type OpenSpecArtifactScope = \"workspace\" | \"living\" | \"active\" | \"archive\";\nexport type OpenSpecArtifactKind =\n  | \"config\"\n  | \"store-metadata\"\n  | \"project-context\"\n  | \"agent-instructions\"\n  | \"living-spec\"\n  | \"living-design\"\n  | \"change-metadata\"\n  | \"proposal\"\n  | \"tasks\"\n  | \"change-design\"\n  | \"delta-spec\"\n  | \"custom-schema\"\n  | \"schema-template\"\n  | \"other\";\n/**\n * The dispositions as values, not only as a type, because a mapping file names\n * one as a plain string and the parse boundary has to be able to ask whether\n * that string is one of these. A hand-written second spelling of the same list\n * is how a disposition added here would go on being unrecognised where it is\n * read from somebody else's YAML.\n */\nexport const OPENSPEC_ARTIFACT_DISPOSITIONS = [\n  \"translate-project-context\",\n  \"record-external-planning-root\",\n  \"remove-after-cutover\",\n  \"map-requirements\",\n  \"review-as-service-adr\",\n  \"translate-change-metadata\",\n  \"convert-to-intent\",\n  \"preserve-as-legacy-checklist\",\n  \"review-as-feature-adr\",\n  \"map-delta\",\n  \"review-custom-workflow\",\n  \"retain-read-only\",\n  \"manual-review\",\n] as const;\nexport type OpenSpecArtifactDisposition = (typeof OPENSPEC_ARTIFACT_DISPOSITIONS)[number];\n\n/** Whether an authored string names a disposition this codebase actually defines. */\nexport function isOpenSpecArtifactDisposition(value: string): value is OpenSpecArtifactDisposition {\n  return (OPENSPEC_ARTIFACT_DISPOSITIONS as readonly string[]).includes(value);\n}\n\nexport interface OpenSpecArtifact {\n  /** Workspace-relative, so store metadata outside openspec/ remains representable. */\n  path: string;\n  scope: OpenSpecArtifactScope;\n  kind: OpenSpecArtifactKind;\n  disposition: OpenSpecArtifactDisposition;\n  changeId?: string;\n  capability?: string;\n}\n\nexport interface OpenSpecArtifactDecision {\n  path: string;\n  kind: \"proposal\" | \"tasks\" | \"change-design\";\n  suggestedDisposition: OpenSpecArtifactDisposition;\n  /**\n   * What the mapping selected, verbatim. This is the field the invalid-value\n   * report is written from, so it has to be able to hold the invalid value —\n   * narrowing it to the union would only mean asserting one back into it.\n   */\n  disposition: string | null;\n  status: \"needsDisposition\" | \"mapped\";\n}\n\nexport interface OpenSpecConfigSummary {\n  path: string;\n  schema: string | null;\n  store: string | null;\n  hasContext: boolean;\n  ruleArtifacts: string[];\n  references: string[];\n}\n\nexport interface OpenSpecInventory {\n  baselines: typeof OPENSPEC_BASELINES;\n  inputRoot: string;\n  root: string;\n  /** SHA-256 over every inventoried OpenSpec source path and byte sequence. */\n  inventoryDigest: string;\n  workspace: {\n    kind: \"project\" | \"store\" | \"openspec-root\";\n    config: OpenSpecConfigSummary | null;\n    storeMetadataPath: string | null;\n  };\n  ready: boolean;\n  mechanicallyCompatible: boolean;\n  readiness: {\n    living: { compatible: boolean; issueCount: number };\n    active: { compatible: boolean; issueCount: number };\n    sourceCurrent: boolean;\n    mappingsResolved: boolean;\n    changesResolved: boolean;\n    renamesResolved: boolean;\n    dispositionsResolved: boolean;\n    migrationReady: boolean;\n  };\n  living: OpenSpecCounts & { capabilities: OpenSpecCapability[] };\n  changes: {\n    active: OpenSpecChange[];\n    archived: OpenSpecChange[];\n    counts: { active: number; archived: number };\n  };\n  renamed: OpenSpecRenamedUsage[];\n  /** Living/active blockers only. Frozen archive history never blocks migration readiness. */\n  unsupported: OpenSpecUnsupportedShape[];\n  /** Historical anomalies are retained for review, but are not migration blockers. */\n  archiveDiagnostics: OpenSpecUnsupportedShape[];\n  mappingDecisions: CapabilityMappingDecision[];\n  needsMapping: CapabilityMappingDecision[];\n  changeDecisions: OpenSpecChangeDecision[];\n  needsChangeMapping: OpenSpecChangeDecision[];\n  mappingIssues: OpenSpecMappingIssue[];\n  artifacts: OpenSpecArtifact[];\n  artifactDecisions: OpenSpecArtifactDecision[];\n  needsDisposition: OpenSpecArtifactDecision[];\n}\n\nexport class OpenSpecRootError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OpenSpecRootError\";\n  }\n}\n"]}