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

package/dist/commands/migrate-openspec/materialize/active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/materialize/active.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Each active OpenSpec change as a staged loam feature: its intent, the\n * authored artifacts a disposition kept, a verbatim copy of the source change\n * tree, and one delta `spec.md` per service its requirements routed to.\n *\n * This is the phase that resolves RENAMED pairs, and the reason it is the\n * longest: a rename is the only place where the living corpus, the delta and\n * the human's identity decision all have to agree, and every disagreement\n * between them is a refusal rather than a guess. `./feature.js` holds the file\n * shapes this emits; `./living.js` is the same corpus read for the other half.\n */\nimport { join } from \"node:path\";\nimport { parseRequirements } from \"../../../core/document/parse.js\";\nimport { type Requirement } from \"../../../core/document/spec.js\";\nimport { ownValue } from \"../../../core/kernel/records.js\";\nimport { type OpenSpecMapping } from \"../../../core/openspec/model/mapping.js\";\nimport { isOpenSpecArtifactDisposition, type OpenSpecInventory } from \"../../../core/openspec/model/model.js\";\nimport { planWrite, type PlannedWrite } from \"../../../core/staging/writes.js\";\nimport { selectedServices } from \"../openspec/decisions.js\";\nimport { OpenSpecCommandError } from \"../openspec/error.js\";\nimport { safeArtifactRelative } from \"../openspec/paths.js\";\nimport { readSourceArtifact } from \"../openspec/read.js\";\nimport {\n  featureSlug,\n  migrationFrontmatter,\n  renderAuthoredBundle,\n  serializeDeltaRequirements,\n  type AuthoredArtifactCopy,\n} from \"./feature.js\";\nimport { assertMaterializedRequirementIds, requirementWithCapability } from \"./stage.js\";\n\nexport async function materializeActiveChanges(\n  inventory: OpenSpecInventory,\n  mapping: OpenSpecMapping,\n  target: string,\n  livingByCapability: ReadonlyMap<string, Requirement[]>,\n): Promise<PlannedWrite[]> {\n  const writes: PlannedWrite[] = [];\n  const inventoryArtifactsByPath = new Map(inventory.artifacts.map((artifact) => [artifact.path, artifact]));\n\n  for (const change of inventory.changes.active) {\n    const decision = inventory.changeDecisions.find((item) => item.change === change.id);\n    const feature = ownValue(mapping.changes, change.id)?.feature ?? null;\n    if (decision === undefined || feature === null) continue; // readiness prevents this on --apply\n    const featureDir = join(target, \"features\", `${feature}-${featureSlug(decision.title, change.id)}`);\n\n    // Preserve the complete authored source change tree, including metadata,\n    // rename syntax, custom artifacts, and original delta section ordering.\n    for (const artifactPath of change.artifacts) {\n      const segments = safeArtifactRelative(artifactPath, `changes/${change.id}/`, `OpenSpec change '${change.id}'`);\n      writes.push(planWrite(\n        join(featureDir, \"legacy\", \"openspec\", ...segments),\n        await readSourceArtifact(inventory.root, artifactPath),\n      ));\n    }\n\n    const authored: Array<AuthoredArtifactCopy & { kind: \"proposal\" | \"tasks\" | \"change-design\" }> = [];\n    for (const artifactDecision of inventory.artifactDecisions) {\n      const artifact = inventoryArtifactsByPath.get(artifactDecision.path);\n      if (artifact?.changeId !== change.id) continue;\n      const disposition = ownValue(mapping.artifacts, artifactDecision.path);\n      if (disposition === undefined) continue; // readiness prevents this on --apply\n      // The mapping holds the authored string; everything below compares it\n      // against disposition literals, so this is where the value has to become\n      // one of them or stop being routed. `mapping.invalid-artifact-disposition`\n      // already refuses an unknown one, so readiness prevents this too — but a\n      // silent skip is the right failure for a value nothing here can act on.\n      if (!isOpenSpecArtifactDisposition(disposition)) continue;\n      authored.push({\n        path: artifactDecision.path,\n        kind: artifactDecision.kind,\n        disposition,\n        raw: await readSourceArtifact(inventory.root, artifactDecision.path),\n      });\n    }\n\n    const convertedProposals = authored.filter(\n      (artifact) => artifact.kind === \"proposal\" && artifact.disposition === \"convert-to-intent\",\n    );\n    const retainedProposals = authored.filter(\n      (artifact) => artifact.kind === \"proposal\" && artifact.disposition !== \"convert-to-intent\",\n    );\n    const intentBody = convertedProposals.length > 0\n      ? renderAuthoredBundle(\"## Migrated OpenSpec proposal\", convertedProposals)\n      : \"No proposal was converted into this intent. Review the retained OpenSpec artifacts and migration-plan.json before promotion.\\n\";\n    writes.push(planWrite(\n      join(featureDir, \"intent.md\"),\n      `${migrationFrontmatter(feature, decision.title)}\\n\\n# ${decision.title}\\n\\n<!-- Staged from OpenSpec change '${change.id}'. This feature is deliberately not validation-green yet. -->\\n\\n${intentBody}`,\n    ));\n    if (retainedProposals.length > 0) {\n      writes.push(planWrite(\n        join(featureDir, \"legacy\", \"proposal.md\"),\n        renderAuthoredBundle(\"# Retained OpenSpec proposal\", retainedProposals),\n      ));\n    }\n\n    const tasks = authored.filter((artifact) => artifact.kind === \"tasks\");\n    if (tasks.length > 0) {\n      writes.push(planWrite(\n        join(featureDir, \"legacy\", \"tasks.md\"),\n        renderAuthoredBundle(\"# OpenSpec task checklist\", tasks),\n      ));\n    }\n    const reviewedDesigns = authored.filter(\n      (artifact) => artifact.kind === \"change-design\" && artifact.disposition === \"review-as-feature-adr\",\n    );\n    if (reviewedDesigns.length > 0) {\n      writes.push(planWrite(\n        join(featureDir, \"adrs\", \"openspec-design.md\"),\n        renderAuthoredBundle(\"# OpenSpec design (review required)\", reviewedDesigns),\n      ));\n    }\n    const retainedDesigns = authored.filter(\n      (artifact) => artifact.kind === \"change-design\" && artifact.disposition !== \"review-as-feature-adr\",\n    );\n    if (retainedDesigns.length > 0) {\n      writes.push(planWrite(\n        join(featureDir, \"legacy\", \"design.md\"),\n        renderAuthoredBundle(\"# Retained OpenSpec design\", retainedDesigns),\n      ));\n    }\n\n    if (change.metadata.skipSpecs) continue;\n    const deltaByService = new Map<string, Requirement[]>();\n    const changeRenames = inventory.renamed.filter(\n      (item) => item.scope === \"active\" && item.changeId === change.id,\n    );\n    const materializedRenameKeys = new Set<string>();\n    const addDelta = (service: string, requirement: Requirement, origin: string): void => {\n      const existing = deltaByService.get(service) ?? [];\n      const collision = existing.find((item) =>\n        item.name === requirement.name\n        || (item.id !== undefined && requirement.id !== undefined && item.id === requirement.id));\n      if (collision !== undefined) {\n        const identity = requirement.id === undefined ? requirement.name : requirement.id;\n        throw new OpenSpecCommandError(\n          \"invalid-option\",\n          `Active change '${change.id}' produces colliding requirement '${identity}' in service '${service}' while materializing ${origin}.`,\n        );\n      }\n      existing.push(requirement);\n      deltaByService.set(service, existing);\n    };\n\n    for (const spec of change.specs) {\n      const requirements = parseRequirements(await readSourceArtifact(inventory.root, spec.path))\n        .filter((requirement) => requirement.kind !== \"BASE\");\n      for (const parsed of requirements) {\n        const matchingRenames = changeRenames.filter((rename) =>\n          rename.capability === spec.capability\n          && rename.from !== null\n          && rename.to !== null\n          && (parsed.name === rename.from || parsed.name === rename.to));\n        if (matchingRenames.length > 1) {\n          throw new OpenSpecCommandError(\n            \"invalid-option\",\n            `Active change '${change.id}' requirement '${parsed.name}' matches multiple RENAMED pairs.`,\n          );\n        }\n        const rename = matchingRenames[0];\n        let requirement = parsed;\n        let routingName = parsed.name;\n        if (rename !== undefined && rename.from !== null && rename.to !== null && rename.requirementId !== null) {\n          if (parsed.kind !== \"MODIFIED\") {\n            throw new OpenSpecCommandError(\n              \"invalid-option\",\n              `Active change '${change.id}' combines RENAMED '${rename.from}' → '${rename.to}' with ${parsed.kind} '${parsed.name}'; review the conflicting delta before --apply.`,\n            );\n          }\n          if (parsed.id !== undefined && parsed.id !== rename.requirementId) {\n            throw new OpenSpecCommandError(\n              \"invalid-option\",\n              `Active change '${change.id}' MODIFIED requirement '${parsed.name}' has Requirement-ID '${parsed.id}', but its RENAMED source resolves to '${rename.requirementId}'.`,\n            );\n          }\n          const annotation = `OpenSpec-Living-Source: ${rename.capability} :: ${rename.from}`;\n          requirement = {\n            ...parsed,\n            id: rename.requirementId,\n            name: rename.to,\n            text: parsed.text.includes(annotation) ? parsed.text : [...parsed.text, \"\", annotation],\n            section: \"## MODIFIED Requirements\",\n          };\n          routingName = rename.from;\n          materializedRenameKeys.add(rename.key);\n        }\n        // Every delta kind uniformly: REMOVED is harmless (every check exempts\n        // it), and a MODIFIED body MUST carry the line or its wholesale\n        // replace would strip the one the living side was staged with.\n        const withCapability = requirementWithCapability(requirement, spec.capability);\n        for (const service of selectedServices(mapping, spec.capability, routingName)) {\n          addDelta(service, withCapability, spec.path);\n        }\n      }\n    }\n    for (const rename of changeRenames) {\n      if (materializedRenameKeys.has(rename.key)) continue;\n      if (rename.from === null || rename.to === null || rename.requirementId === null) continue;\n      const source = (livingByCapability.get(rename.capability) ?? [])\n        .filter((requirement) => requirement.name === rename.from)[0];\n      if (source === undefined) continue; // readiness prevents this on --apply\n      const annotation = `OpenSpec-Living-Source: ${rename.capability} :: ${rename.from}`;\n      const text = source.text.includes(annotation) ? source.text : [...source.text, \"\", annotation];\n      const modified: Requirement = {\n        ...source,\n        kind: \"MODIFIED\",\n        id: rename.requirementId,\n        name: rename.to,\n        text,\n        section: \"## MODIFIED Requirements\",\n      };\n      for (const service of selectedServices(mapping, rename.capability, rename.from)) {\n        addDelta(service, requirementWithCapability(modified, rename.capability), rename.path);\n      }\n    }\n    for (const [service, requirements] of [...deltaByService].sort(([a], [b]) => a.localeCompare(b))) {\n      assertMaterializedRequirementIds(\n        `Active change '${change.id}' mapped to service '${service}'`,\n        requirements,\n      );\n      writes.push(planWrite(\n        join(featureDir, \"specs\", service, \"spec.md\"),\n        serializeDeltaRequirements(requirements),\n      ));\n    }\n  }\n  return writes;\n}\n"]}

package/dist/commands/migrate-openspec/materialize/feature.js

@@ -0,0 +1,41 @@
+/**
+ * The shapes a staged feature is written in: its directory slug, its
+ * frontmatter, the delta spec body, and the bundle an authored OpenSpec
+ * artifact is copied into.
+ *
+ * All four are used by `./active.js` alone, and they are here rather than
+ * inside it because they are the part a reviewer compares against the migrated
+ * repository by eye. What routes a requirement to a service is a decision;
+ * these are the file formats that decision comes out as, and the two answer to
+ * different questions when a migration reads wrong.
+ */
+import { stringify as stringifyYaml } from "yaml";
+import { serializeRequirements } from "../../../core/document/spec.js";
+import {} from "../../../core/document/spec.js";
+import {} from "../../../core/openspec/model/model.js";
+export function featureSlug(title, changeId) {
+    const slug = (text) => text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug(title) || slug(changeId) || "openspec-change";
+}
+export function serializeDeltaRequirements(requirements) {
+    const sections = [];
+    for (const kind of ["ADDED", "MODIFIED", "REMOVED"]) {
+        const group = requirements.filter((requirement) => requirement.kind === kind);
+        if (group.length > 0)
+            sections.push(`## ${kind} Requirements\n\n${serializeRequirements(group).trimEnd()}`);
+    }
+    return `${sections.join("\n\n")}\n`;
+}
+export function migrationFrontmatter(feature, title) {
+    return `---\n${stringifyYaml({ feature, title, status: "proposed" }, { lineWidth: 0 }).trimEnd()}\n---`;
+}
+export function renderAuthoredBundle(heading, artifacts) {
+    return `${heading}\n\n${artifacts.map((artifact) => [
+        `<!-- OpenSpec source: ${artifact.path}; disposition: ${artifact.disposition}. -->`,
+        artifact.raw.trimEnd(),
+    ].join("\n\n")).join("\n\n---\n\n")}\n`;
+}
+//# sourceMappingURL=feature.js.map

package/dist/commands/migrate-openspec/materialize/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/materialize/feature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAoB,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAoC,MAAM,uCAAuC,CAAC;AAEzF,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB;IACzD,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI;SACxC,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,YAA2B;IACpE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,oBAAoB,qBAAqB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,KAAa;IACjE,OAAO,QAAQ,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC;AAC1G,CAAC;AAQD,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiC;IACrF,OAAO,GAAG,OAAO,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClD,yBAAyB,QAAQ,CAAC,IAAI,kBAAkB,QAAQ,CAAC,WAAW,OAAO;QACnF,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE;KACvB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * The shapes a staged feature is written in: its directory slug, its\n * frontmatter, the delta spec body, and the bundle an authored OpenSpec\n * artifact is copied into.\n *\n * All four are used by `./active.js` alone, and they are here rather than\n * inside it because they are the part a reviewer compares against the migrated\n * repository by eye. What routes a requirement to a service is a decision;\n * these are the file formats that decision comes out as, and the two answer to\n * different questions when a migration reads wrong.\n */\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { serializeRequirements } from \"../../../core/document/spec.js\";\nimport { type Requirement } from \"../../../core/document/spec.js\";\nimport { type OpenSpecArtifactDisposition } from \"../../../core/openspec/model/model.js\";\n\nexport function featureSlug(title: string, changeId: string): string {\n  const slug = (text: string): string => text\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return slug(title) || slug(changeId) || \"openspec-change\";\n}\n\nexport function serializeDeltaRequirements(requirements: Requirement[]): string {\n  const sections: string[] = [];\n  for (const kind of [\"ADDED\", \"MODIFIED\", \"REMOVED\"] as const) {\n    const group = requirements.filter((requirement) => requirement.kind === kind);\n    if (group.length > 0) sections.push(`## ${kind} Requirements\\n\\n${serializeRequirements(group).trimEnd()}`);\n  }\n  return `${sections.join(\"\\n\\n\")}\\n`;\n}\n\nexport function migrationFrontmatter(feature: string, title: string): string {\n  return `---\\n${stringifyYaml({ feature, title, status: \"proposed\" }, { lineWidth: 0 }).trimEnd()}\\n---`;\n}\n\nexport interface AuthoredArtifactCopy {\n  path: string;\n  disposition: OpenSpecArtifactDisposition;\n  raw: string;\n}\n\nexport function renderAuthoredBundle(heading: string, artifacts: AuthoredArtifactCopy[]): string {\n  return `${heading}\\n\\n${artifacts.map((artifact) => [\n    `<!-- OpenSpec source: ${artifact.path}; disposition: ${artifact.disposition}. -->`,\n    artifact.raw.trimEnd(),\n  ].join(\"\\n\\n\")).join(\"\\n\\n---\\n\\n\")}\\n`;\n}\n"]}

package/dist/commands/migrate-openspec/materialize/living.js

@@ -0,0 +1,62 @@
+/**
+ * The living OpenSpec corpus as draft loam service specs — one `spec.md` per
+ * service a capability was routed to.
+ *
+ * Separate from `./active.js` because the two materialize different documents
+ * from the same corpus: this one emits BASE requirements a service owns, that
+ * one emits the ADDED/MODIFIED/REMOVED deltas a feature proposes. They share
+ * the routing rule (`../openspec/decisions.js`) and the spec guard
+ * (`./stage.js`) and nothing else, and keeping them apart is what stopped a
+ * rename resolved on one side from being written beside a spec built on the
+ * other.
+ */
+import { join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { serializeRequirements } from "../../../core/document/spec.js";
+import {} from "../../../core/document/spec.js";
+import { ownValue } from "../../../core/kernel/records.js";
+import {} from "../../../core/openspec/model/mapping.js";
+import {} from "../../../core/openspec/model/model.js";
+import { planWrite } from "../../../core/staging/writes.js";
+import { selectedServices } from "../openspec/decisions.js";
+import { OpenSpecCommandError } from "../openspec/error.js";
+import { assertMaterializedRequirementIds, requirementWithCapability } from "./stage.js";
+export async function materializeLivingSpecs(inventory, mapping, target, livingByCapability) {
+    const byService = new Map();
+    const renameIds = new Map(inventory.renamed
+        .filter((rename) => rename.scope === "active" && rename.from !== null && rename.requirementId !== null)
+        .map((rename) => [`${rename.capability}\0${rename.from}`, rename.requirementId]));
+    for (const capability of inventory.living.capabilities) {
+        const selected = ownValue(mapping.capabilities, capability.id);
+        if (selected === undefined)
+            continue; // readiness prevents this on --apply
+        for (const parsed of livingByCapability.get(capability.id) ?? []) {
+            const renamedId = renameIds.get(`${capability.id}\0${parsed.name}`);
+            const requirement = renamedId === undefined ? parsed : { ...parsed, id: renamedId };
+            // The one spelling of the routing rule, and the reason it lives in
+            // `../openspec/decisions.js` rather than here. Written out again here, it
+            // drifted from the copy the delta side uses, so a split capability could
+            // route a living requirement and its own delta to different services.
+            const services = selectedServices(mapping, capability.id, requirement.name);
+            for (const service of services) {
+                const existing = byService.get(service) ?? [];
+                const identity = requirement.id === undefined ? `heading '${requirement.name}'` : `Requirement-ID '${requirement.id}'`;
+                if (existing.some((item) => item.name === requirement.name
+                    || (item.id !== undefined && requirement.id !== undefined && item.id === requirement.id))) {
+                    throw new OpenSpecCommandError("invalid-option", `Mapped living specs collide in service '${service}' on ${identity}; refine the capability/requirement allocation before --apply.`);
+                }
+                // The capability id rides every routed requirement as a `Capability:`
+                // line, declared in the staged architecture/capabilities.yaml (target.ts).
+                existing.push(requirementWithCapability({ ...requirement, kind: "BASE" }, capability.id));
+                byService.set(service, existing);
+            }
+        }
+    }
+    return [...byService.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([service, requirements]) => {
+        assertMaterializedRequirementIds(`Mapped living service '${service}'`, requirements);
+        return planWrite(join(target, "services", service, "spec.md"), `---\n${stringifyYaml({ service, status: "draft" }, { lineWidth: 0 }).trimEnd()}\n---\n\n# ${service}\n\n<!-- Staged from OpenSpec. Purpose/section prose and capability design.md are preserved verbatim under legacy/openspec/specs/. Add truthful sources and complete C4/OpenAPI links before validation/vouch. -->\n\n## Requirements\n\n${serializeRequirements(requirements)}`);
+    });
+}
+//# sourceMappingURL=living.js.map

package/dist/commands/migrate-openspec/materialize/living.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"living.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/materialize/living.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The living OpenSpec corpus as draft loam service specs — one `spec.md` per\n * service a capability was routed to.\n *\n * Separate from `./active.js` because the two materialize different documents\n * from the same corpus: this one emits BASE requirements a service owns, that\n * one emits the ADDED/MODIFIED/REMOVED deltas a feature proposes. They share\n * the routing rule (`../openspec/decisions.js`) and the spec guard\n * (`./stage.js`) and nothing else, and keeping them apart is what stopped a\n * rename resolved on one side from being written beside a spec built on the\n * other.\n */\nimport { join } from \"node:path\";\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { serializeRequirements } from \"../../../core/document/spec.js\";\nimport { type Requirement } from \"../../../core/document/spec.js\";\nimport { ownValue } from \"../../../core/kernel/records.js\";\nimport { type OpenSpecMapping } from \"../../../core/openspec/model/mapping.js\";\nimport { type OpenSpecInventory } from \"../../../core/openspec/model/model.js\";\nimport { planWrite, type PlannedWrite } from \"../../../core/staging/writes.js\";\nimport { selectedServices } from \"../openspec/decisions.js\";\nimport { OpenSpecCommandError } from \"../openspec/error.js\";\nimport { assertMaterializedRequirementIds, requirementWithCapability } from \"./stage.js\";\n\nexport async function materializeLivingSpecs(\n  inventory: OpenSpecInventory,\n  mapping: OpenSpecMapping,\n  target: string,\n  livingByCapability: ReadonlyMap<string, Requirement[]>,\n): Promise<PlannedWrite[]> {\n  const byService = new Map<string, Requirement[]>();\n  const renameIds = new Map(\n    inventory.renamed\n      .filter((rename) => rename.scope === \"active\" && rename.from !== null && rename.requirementId !== null)\n      .map((rename) => [`${rename.capability}\\0${rename.from}`, rename.requirementId!] as const),\n  );\n  for (const capability of inventory.living.capabilities) {\n    const selected = ownValue(mapping.capabilities, capability.id);\n    if (selected === undefined) continue; // readiness prevents this on --apply\n    for (const parsed of livingByCapability.get(capability.id) ?? []) {\n      const renamedId = renameIds.get(`${capability.id}\\0${parsed.name}`);\n      const requirement = renamedId === undefined ? parsed : { ...parsed, id: renamedId };\n      // The one spelling of the routing rule, and the reason it lives in\n      // `../openspec/decisions.js` rather than here. Written out again here, it\n      // drifted from the copy the delta side uses, so a split capability could\n      // route a living requirement and its own delta to different services.\n      const services = selectedServices(mapping, capability.id, requirement.name);\n      for (const service of services) {\n        const existing = byService.get(service) ?? [];\n        const identity = requirement.id === undefined ? `heading '${requirement.name}'` : `Requirement-ID '${requirement.id}'`;\n        if (existing.some((item) =>\n          item.name === requirement.name\n          || (item.id !== undefined && requirement.id !== undefined && item.id === requirement.id))) {\n          throw new OpenSpecCommandError(\n            \"invalid-option\",\n            `Mapped living specs collide in service '${service}' on ${identity}; refine the capability/requirement allocation before --apply.`,\n          );\n        }\n        // The capability id rides every routed requirement as a `Capability:`\n        // line, declared in the staged architecture/capabilities.yaml (target.ts).\n        existing.push(requirementWithCapability({ ...requirement, kind: \"BASE\" }, capability.id));\n        byService.set(service, existing);\n      }\n    }\n  }\n  return [...byService.entries()]\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([service, requirements]) => {\n      assertMaterializedRequirementIds(`Mapped living service '${service}'`, requirements);\n      return planWrite(\n        join(target, \"services\", service, \"spec.md\"),\n        `---\\n${stringifyYaml({ service, status: \"draft\" }, { lineWidth: 0 }).trimEnd()}\\n---\\n\\n# ${service}\\n\\n<!-- Staged from OpenSpec. Purpose/section prose and capability design.md are preserved verbatim under legacy/openspec/specs/. Add truthful sources and complete C4/OpenAPI links before validation/vouch. -->\\n\\n## Requirements\\n\\n${serializeRequirements(requirements)}`,\n      );\n    });\n}\n"]}

package/dist/commands/migrate-openspec/materialize/stage.js

@@ -0,0 +1,142 @@
+/**
+ * Every refusal that stands between a finished migration plan and the disk.
+ *
+ * Three questions, one module because all three are answered at the same
+ * moment and none of them may be skipped: may the target hold these bytes at
+ * all (it must be empty, not a symlink, outside the OpenSpec source and outside
+ * any live loam fleet), do two planned writes claim one path once portable
+ * case/Unicode folding is applied, and would the requirements about to be
+ * serialized still parse as a loam spec.
+ *
+ * They sit beside the writers rather than under `../openspec/` because they
+ * grade the *output*: `../openspec/paths.ts` holds the path arithmetic they are
+ * built from, and knows nothing about a plan.
+ */
+import { existsSync } from "node:fs";
+import { lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { findConfigPath, parseConfig } from "../../../core/envelope/config.js";
+import { docsDirOf } from "../../../core/kernel/ids/dirs.js";
+import { CAPABILITY_LINE_RE, requirementIdProblems } from "../../../core/document/spec.js";
+import { decodeDocument } from "../../../core/kernel/document-bytes.js";
+import {} from "../../../core/openspec/model/model.js";
+import {} from "../../../core/staging/writes.js";
+import { OpenSpecCommandError } from "../openspec/error.js";
+import { canonicalForCreate, contains } from "../openspec/paths.js";
+/**
+ * The other half of "never writes into … live loam docs". Overlap with the
+ * OpenSpec source was the only thing checked, so `--target <docs>/features` on a
+ * fresh fleet passed and put phantom features into every `loam list`.
+ *
+ * The line is the docs tree, not the repository: every enumerating command reads
+ * `<docsDir>/services` and `<docsDir>/features`, so a target under docsDir joins
+ * the live fleet, while a sibling of it is merely a directory. A config that
+ * governs the target but cannot be parsed is refused too — an unreadable
+ * docsDir cannot be shown to be somewhere else.
+ */
+async function assertOutsideLoamDocs(stage) {
+    const canonicalStage = await canonicalForCreate(stage);
+    const governing = findConfigPath(canonicalStage);
+    if (governing !== null) {
+        const docsDir = await governingDocsDir(governing);
+        if (docsDir === null || contains(docsDir, canonicalStage)) {
+            throw new OpenSpecCommandError("invalid-option", `Refusing to stage a migration inside the live loam docs ${docsDir ?? `governed by ${governing}`}: ${stage}. Migrate into a standalone directory and cut over after review.`);
+        }
+    }
+    // A docs repo checked out without its loam.json — the landscape is the file
+    // no docs repo is without, and `loam init` scaffolds it before anything else.
+    for (let dir = canonicalStage;; dir = dirname(dir)) {
+        if (existsSync(join(dir, "architecture", "landscape.likec4"))) {
+            throw new OpenSpecCommandError("invalid-option", `Refusing to stage a migration inside a loam docs repository: ${join(dir, "architecture", "landscape.likec4")} is above ${stage}. Migrate into a standalone directory and cut over after review.`);
+        }
+        if (dirname(dir) === dir)
+            return;
+    }
+}
+/**
+ * Canonical docsDir of the config at `path`, or null when it cannot be read —
+ * including "read as UTF-8 it would have said something else", which is why the
+ * bytes go through `decodeDocument`. Null is the conservative answer here: the
+ * caller refuses to stage rather than accept a docsDir it cannot establish.
+ */
+async function governingDocsDir(path) {
+    try {
+        // Re-branded after canonicalization: the path came out of `parseConfig`
+        // already resolved (a `DocsDir`), and `canonicalForCreate` only follows
+        // symlinks — same root, same provenance, canonical spelling.
+        return docsDirOf(await canonicalForCreate(parseConfig(decodeDocument(await readFile(path), path), dirname(path)).docsDir));
+    }
+    catch {
+        return null;
+    }
+}
+export async function assertEmptyNonOverlappingStage(inventory, stage) {
+    const canonicalStage = await canonicalForCreate(stage);
+    const canonicalSource = await realpath(inventory.inputRoot);
+    if (contains(canonicalSource, canonicalStage) || contains(canonicalStage, canonicalSource)) {
+        throw new OpenSpecCommandError("invalid-option", `Staging directory must not overlap the OpenSpec source workspace: ${stage}`);
+    }
+    await assertOutsideLoamDocs(stage);
+    try {
+        if ((await lstat(stage)).isSymbolicLink()) {
+            throw new OpenSpecCommandError("invalid-option", `Staging target must not be a symbolic link: ${stage}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof OpenSpecCommandError)
+            throw error;
+        const code = typeof error === "object" && error !== null && "code" in error ? error.code : null;
+        if (code !== "ENOENT")
+            throw error;
+    }
+    if (!existsSync(stage))
+        return;
+    const info = await stat(stage);
+    if (!info.isDirectory() || (await readdir(stage)).length > 0) {
+        throw new OpenSpecCommandError("already-exists", `Staging target must be absent or an empty directory: ${stage}`);
+    }
+}
+export function assertDistinctPlannedPaths(writes) {
+    const writePaths = new Map();
+    for (const write of writes) {
+        const collisionKey = resolve(write.path).normalize("NFC").toLowerCase();
+        const existing = writePaths.get(collisionKey);
+        if (existing !== undefined) {
+            throw new OpenSpecCommandError("invalid-option", `Migration paths '${existing}' and '${write.path}' collide after portable case/Unicode normalization; refine mappings before apply.`);
+        }
+        writePaths.set(collisionKey, write.path);
+    }
+}
+/**
+ * The requirement with a `Capability: <id>` body line — the join that keeps
+ * the source capability's identity on every requirement it routed, instead of
+ * dissolving it into service files and leaving the id only in legacy/. The
+ * serializeRequirements Requirement-ID pattern: never a second line when the
+ * author already wrote one (a rare but legal delta authored against a loam
+ * target), and appended after the body the way active.ts appends its
+ * OpenSpec-Living-Source annotation, so a MODIFIED requirement's wholesale
+ * replace carries the line into the living document rather than stripping it.
+ */
+export function requirementWithCapability(requirement, capabilityId) {
+    if (requirement.text.some((line) => CAPABILITY_LINE_RE.test(line)))
+        return requirement;
+    const line = `Capability: ${capabilityId}`;
+    return {
+        ...requirement,
+        capabilities: [capabilityId],
+        text: requirement.text.length === 0 ? [line] : [...requirement.text, "", line],
+    };
+}
+export function assertMaterializedRequirementIds(where, requirements) {
+    const problems = requirementIdProblems(requirements);
+    if (problems.length === 0)
+        return;
+    const first = problems[0];
+    const detail = first.kind === "invalid"
+        ? `requirement '${first.requirement}' has invalid Requirement-ID '${first.value}'`
+        : first.kind === "repeated"
+            ? `requirement '${first.requirement}' declares Requirement-ID ${first.values.length} times`
+            : `Requirement-ID '${first.id}' is shared by ${first.requirements.map((name) => `'${name}'`).join(", ")}`;
+    throw new OpenSpecCommandError("invalid-option", `${where} would materialize an invalid loam spec: ${detail}. Repair the source or refine routing before apply.`);
+}
+//# sourceMappingURL=stage.js.map

package/dist/commands/migrate-openspec/materialize/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../../../src/commands/migrate-openspec/materialize/stage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Every refusal that stands between a finished migration plan and the disk.\n *\n * Three questions, one module because all three are answered at the same\n * moment and none of them may be skipped: may the target hold these bytes at\n * all (it must be empty, not a symlink, outside the OpenSpec source and outside\n * any live loam fleet), do two planned writes claim one path once portable\n * case/Unicode folding is applied, and would the requirements about to be\n * serialized still parse as a loam spec.\n *\n * They sit beside the writers rather than under `../openspec/` because they\n * grade the *output*: `../openspec/paths.ts` holds the path arithmetic they are\n * built from, and knows nothing about a plan.\n */\nimport { existsSync } from \"node:fs\";\nimport { lstat, readFile, readdir, realpath, stat } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { findConfigPath, parseConfig } from \"../../../core/envelope/config.js\";\nimport { docsDirOf, type DocsDir } from \"../../../core/kernel/ids/dirs.js\";\nimport { CAPABILITY_LINE_RE, requirementIdProblems, type Requirement } from \"../../../core/document/spec.js\";\nimport { decodeDocument } from \"../../../core/kernel/document-bytes.js\";\nimport { type OpenSpecInventory } from \"../../../core/openspec/model/model.js\";\nimport { type PlannedWrite } from \"../../../core/staging/writes.js\";\nimport { OpenSpecCommandError } from \"../openspec/error.js\";\nimport { canonicalForCreate, contains } from \"../openspec/paths.js\";\n\n/**\n * The other half of \"never writes into … live loam docs\". Overlap with the\n * OpenSpec source was the only thing checked, so `--target <docs>/features` on a\n * fresh fleet passed and put phantom features into every `loam list`.\n *\n * The line is the docs tree, not the repository: every enumerating command reads\n * `<docsDir>/services` and `<docsDir>/features`, so a target under docsDir joins\n * the live fleet, while a sibling of it is merely a directory. A config that\n * governs the target but cannot be parsed is refused too — an unreadable\n * docsDir cannot be shown to be somewhere else.\n */\nasync function assertOutsideLoamDocs(stage: string): Promise<void> {\n  const canonicalStage = await canonicalForCreate(stage);\n  const governing = findConfigPath(canonicalStage);\n  if (governing !== null) {\n    const docsDir = await governingDocsDir(governing);\n    if (docsDir === null || contains(docsDir, canonicalStage)) {\n      throw new OpenSpecCommandError(\n        \"invalid-option\",\n        `Refusing to stage a migration inside the live loam docs ${docsDir ?? `governed by ${governing}`}: ${stage}. Migrate into a standalone directory and cut over after review.`,\n      );\n    }\n  }\n  // A docs repo checked out without its loam.json — the landscape is the file\n  // no docs repo is without, and `loam init` scaffolds it before anything else.\n  for (let dir = canonicalStage; ; dir = dirname(dir)) {\n    if (existsSync(join(dir, \"architecture\", \"landscape.likec4\"))) {\n      throw new OpenSpecCommandError(\n        \"invalid-option\",\n        `Refusing to stage a migration inside a loam docs repository: ${join(dir, \"architecture\", \"landscape.likec4\")} is above ${stage}. Migrate into a standalone directory and cut over after review.`,\n      );\n    }\n    if (dirname(dir) === dir) return;\n  }\n}\n\n/**\n * Canonical docsDir of the config at `path`, or null when it cannot be read —\n * including \"read as UTF-8 it would have said something else\", which is why the\n * bytes go through `decodeDocument`. Null is the conservative answer here: the\n * caller refuses to stage rather than accept a docsDir it cannot establish.\n */\nasync function governingDocsDir(path: string): Promise<DocsDir | null> {\n  try {\n    // Re-branded after canonicalization: the path came out of `parseConfig`\n    // already resolved (a `DocsDir`), and `canonicalForCreate` only follows\n    // symlinks — same root, same provenance, canonical spelling.\n    return docsDirOf(await canonicalForCreate(\n      parseConfig(decodeDocument(await readFile(path), path), dirname(path)).docsDir,\n    ));\n  } catch {\n    return null;\n  }\n}\n\nexport async function assertEmptyNonOverlappingStage(inventory: OpenSpecInventory, stage: string): Promise<void> {\n  const canonicalStage = await canonicalForCreate(stage);\n  const canonicalSource = await realpath(inventory.inputRoot);\n  if (contains(canonicalSource, canonicalStage) || contains(canonicalStage, canonicalSource)) {\n    throw new OpenSpecCommandError(\n      \"invalid-option\",\n      `Staging directory must not overlap the OpenSpec source workspace: ${stage}`,\n    );\n  }\n  await assertOutsideLoamDocs(stage);\n  try {\n    if ((await lstat(stage)).isSymbolicLink()) {\n      throw new OpenSpecCommandError(\n        \"invalid-option\",\n        `Staging target must not be a symbolic link: ${stage}`,\n      );\n    }\n  } catch (error) {\n    if (error instanceof OpenSpecCommandError) throw error;\n    const code = typeof error === \"object\" && error !== null && \"code\" in error ? error.code : null;\n    if (code !== \"ENOENT\") throw error;\n  }\n  if (!existsSync(stage)) return;\n  const info = await stat(stage);\n  if (!info.isDirectory() || (await readdir(stage)).length > 0) {\n    throw new OpenSpecCommandError(\"already-exists\", `Staging target must be absent or an empty directory: ${stage}`);\n  }\n}\n\nexport function assertDistinctPlannedPaths(writes: PlannedWrite[]): void {\n  const writePaths = new Map<string, string>();\n  for (const write of writes) {\n    const collisionKey = resolve(write.path).normalize(\"NFC\").toLowerCase();\n    const existing = writePaths.get(collisionKey);\n    if (existing !== undefined) {\n      throw new OpenSpecCommandError(\n        \"invalid-option\",\n        `Migration paths '${existing}' and '${write.path}' collide after portable case/Unicode normalization; refine mappings before apply.`,\n      );\n    }\n    writePaths.set(collisionKey, write.path);\n  }\n}\n\n/**\n * The requirement with a `Capability: <id>` body line — the join that keeps\n * the source capability's identity on every requirement it routed, instead of\n * dissolving it into service files and leaving the id only in legacy/. The\n * serializeRequirements Requirement-ID pattern: never a second line when the\n * author already wrote one (a rare but legal delta authored against a loam\n * target), and appended after the body the way active.ts appends its\n * OpenSpec-Living-Source annotation, so a MODIFIED requirement's wholesale\n * replace carries the line into the living document rather than stripping it.\n */\nexport function requirementWithCapability(requirement: Requirement, capabilityId: string): Requirement {\n  if (requirement.text.some((line) => CAPABILITY_LINE_RE.test(line))) return requirement;\n  const line = `Capability: ${capabilityId}`;\n  return {\n    ...requirement,\n    capabilities: [capabilityId],\n    text: requirement.text.length === 0 ? [line] : [...requirement.text, \"\", line],\n  };\n}\n\nexport function assertMaterializedRequirementIds(where: string, requirements: Requirement[]): void {\n  const problems = requirementIdProblems(requirements);\n  if (problems.length === 0) return;\n  const first = problems[0]!;\n  const detail = first.kind === \"invalid\"\n    ? `requirement '${first.requirement}' has invalid Requirement-ID '${first.value}'`\n    : first.kind === \"repeated\"\n      ? `requirement '${first.requirement}' declares Requirement-ID ${first.values.length} times`\n      : `Requirement-ID '${first.id}' is shared by ${first.requirements.map((name) => `'${name}'`).join(\", \")}`;\n  throw new OpenSpecCommandError(\n    \"invalid-option\",\n    `${where} would materialize an invalid loam spec: ${detail}. Repair the source or refine routing before apply.`,\n  );\n}\n"]}

package/dist/commands/migrate-openspec/materialize/target.js

@@ -0,0 +1,219 @@
+/**
+ * The staged target: plan every byte first, then land them all or none.
+ *
+ * The two halves are one module because they are one transaction. Planning
+ * reads the whole source corpus, so `writeMigrationTarget` re-hashes it
+ * afterwards and refuses a snapshot that moved mid-flight; the plan then
+ * becomes an exclusive staged write set that rolls back as a unit. Splitting
+ * the planner from the writer would put that re-hash on one side of a module
+ * boundary and the reads it guards on the other.
+ */
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { parseRequirements } from "../../../core/document/parse.js";
+import {} from "../../../core/document/spec.js";
+import { DOCS_SUBDIRS, docsRepoFiles } from "../../../core/docs.js";
+import { compareIds } from "../../../core/repo/entries.js";
+import { ownValue } from "../../../core/kernel/records.js";
+import { inventoryOpenSpec } from "../../../core/openspec/inventory.js";
+import {} from "../../../core/openspec/model/mapping.js";
+import {} from "../../../core/openspec/model/model.js";
+import { rollbackError, rollbackStaged, stageWrites, swapStaged } from "../../../core/staging/commit.js";
+import { planWrite } from "../../../core/staging/writes.js";
+import { normalizedMapping } from "../openspec/decisions.js";
+import { OpenSpecCommandError } from "../openspec/error.js";
+import { safeArtifactRelative } from "../openspec/paths.js";
+import { readSourceArtifact } from "../openspec/read.js";
+import { materializeActiveChanges } from "./active.js";
+import { materializeLivingSpecs } from "./living.js";
+import { assertDistinctPlannedPaths, assertEmptyNonOverlappingStage } from "./stage.js";
+export async function planMigrationWrites(inventory, mapping, target) {
+    // One reading of the living corpus for both materializers. They each read and
+    // parsed the whole of it independently, which is twice the work and, worse,
+    // two readings: a rename resolved against one of them was written beside a
+    // living spec built from the other.
+    const livingByCapability = new Map();
+    for (const capability of inventory.living.capabilities) {
+        livingByCapability.set(capability.id, parseRequirements(await readSourceArtifact(inventory.root, capability.files[0])));
+    }
+    const livingWrites = await materializeLivingSpecs(inventory, mapping, target, livingByCapability);
+    const vocabulary = capabilitiesVocabularyWrite(inventory, target);
+    if (vocabulary !== null)
+        livingWrites.push(vocabulary);
+    const activeWrites = await materializeActiveChanges(inventory, mapping, target, livingByCapability);
+    const legacyWrites = await copyLivingTree(inventory, target);
+    assertDistinctPlannedPaths([...livingWrites, ...activeWrites, ...legacyWrites]);
+    return { livingWrites, activeWrites, legacyWrites };
+}
+/**
+ * The staged fleet's capability vocabulary: the union of living and
+ * active-horizon capability ids, each declared with an EMPTY body — no
+ * description is invented, because the authored `## Purpose` prose stays
+ * verbatim under legacy/ (the no-prose-moves rule), and an empty mapping is a
+ * legal declaration. Keys sorted with compareIds over an insertion-ordered
+ * object, so the bytes are machine-independent; nested ids stay one flat key
+ * (`payments/refunds`), never collapsed. Null when the corpus names no
+ * capability at all — an empty vocabulary FILE would opt the staged fleet into
+ * an axis it has nothing to say on. assertDistinctPlannedPaths guards the path
+ * against every other planned write; the docs scaffold does not write it.
+ */
+function capabilitiesVocabularyWrite(inventory, target) {
+    const ids = new Set(inventory.living.capabilities.map((capability) => capability.id));
+    for (const change of inventory.changes.active) {
+        for (const spec of change.specs)
+            ids.add(spec.capability);
+    }
+    if (ids.size === 0)
+        return null;
+    const capabilities = Object.fromEntries([...ids].sort(compareIds).map((id) => [id, {}]));
+    return planWrite(join(target, "architecture", "capabilities.yaml"), "# Declared by `loam migrate-openspec`: every living and active-horizon OpenSpec\n" +
+        "# capability id, so capability identity survives migration as a checkable name\n" +
+        "# (each routed requirement carries a matching `Capability:` line). Descriptions\n" +
+        "# are deliberately absent — the authored Purpose prose is verbatim under\n" +
+        "# legacy/openspec/specs/, and no prose moves.\n" +
+        stringifyYaml({ capabilities }, { lineWidth: 0 }));
+}
+/**
+ * The living tree, byte for byte, the way each change tree already gets
+ * `legacy/openspec/`.
+ *
+ * `materializeLivingSpecs` emits frontmatter plus serialized requirements, so
+ * everything a living spec holds AROUND its requirements has nowhere to land:
+ * `## Purpose`, prose between `## Requirements` and the first requirement, and
+ * the whole of `specs/<capability>/design.md` — which the summary counts under
+ * `review-as-service-adr` while FOLLOW-UP.md tells the migrator to review prose
+ * that had been written nowhere. (Prose inside a requirement body survives
+ * serialization and is not the subject here.)
+ */
+async function copyLivingTree(inventory, target) {
+    const writes = [];
+    for (const artifact of inventory.artifacts) {
+        if (artifact.scope !== "living")
+            continue;
+        const segments = safeArtifactRelative(artifact.path, "specs/", "The OpenSpec living tree");
+        writes.push(planWrite(join(target, "legacy", "openspec", "specs", ...segments), await readSourceArtifact(inventory.root, artifact.path)));
+    }
+    return writes;
+}
+export async function writeMigrationTarget(inventory, mapping, target, planned) {
+    await assertEmptyNonOverlappingStage(inventory, target);
+    // All migration content was read while planning. Re-hash after those reads so
+    // a source edit between audit and materialization cannot produce a mixed snapshot.
+    const refreshed = await inventoryOpenSpec(inventory.inputRoot, { mapping });
+    if (!refreshed.ready || refreshed.inventoryDigest !== inventory.inventoryDigest) {
+        throw new OpenSpecCommandError("invalid-option", "OpenSpec source changed while the migration plan was being materialized; re-audit and review a new mapping.");
+    }
+    const followUpBlockers = [
+        "Model every staged service in architecture/landscape.likec4 and bind it with metadata { service '<id>' }; the scaffolded landscape is deliberately empty.",
+        "Add each service model.likec4 and OpenAPI contract; migrated requirements have no Operations/Covers links yet unless authored upstream.",
+        "Set truthful sources from each service repository, validate, and have a human run loam vouch; staged specs remain status: draft.",
+        ...(inventory.changes.active.length === 0
+            ? []
+            : [
+                `Review ${inventory.changes.active.length} staged feature(s), add their LikeC4/OpenAPI deltas, and resolve any retained or manual-review OpenSpec artifacts recorded in migration-plan.json.`,
+                // OpenSpec has no equivalent of `Based-On:`, so every migrated
+                // MODIFIED/REMOVED requirement arrives unpinned (`delta.baseline-missing`,
+                // a warning that GATES archive — unpinned is the shape that reverts
+                // someone else's landed change). The corpus is not stranded: one
+                // rebase per staged feature pins everything, which is exactly the
+                // step this line asks for.
+                "Run `loam rebase <FEAT>` per staged feature: OpenSpec deltas carry no Based-On, so no MODIFIED/REMOVED requirement is pinned to the living text it was written against.",
+            ]),
+        "Review config context/rules, Stores/references, custom schemas, and every artifact disposition in migration-plan.json.",
+        "Review the verbatim OpenSpec living tree under legacy/openspec/specs/: Purpose prose, section prose, and capability design.md have no loam equivalent and were copied, not converted.",
+        // The cutover was undocumented, which is how a staged target that cannot
+        // answer `loam validate` reads as finished work. Naming the two halves —
+        // what is fleet content and what is review residue — is the whole procedure.
+        "Cut over only once `loam validate --all` here is green: services/ and features/ are the fleet content, while legacy/, mapping.yaml, migration-plan.json, FOLLOW-UP.md, and this repository's own loam.json/AGENTS.md are review residue that does not move.",
+    ];
+    const plan = {
+        version: 1,
+        generatedBy: "loam migrate-openspec",
+        source: { inputRoot: inventory.inputRoot, root: inventory.root },
+        baselines: inventory.baselines,
+        readiness: inventory.readiness,
+        mapping: normalizedMapping(inventory, mapping),
+        living: inventory.living,
+        activeChanges: inventory.changes.active,
+        archiveDiagnostics: inventory.archiveDiagnostics,
+        artifactDisposition: inventory.artifacts.map((artifact) => ({
+            ...artifact,
+            disposition: ownValue(mapping.artifacts, artifact.path) ?? artifact.disposition,
+            selectedDisposition: ownValue(mapping.artifacts, artifact.path) ?? null,
+        })),
+        followUpBlockers,
+        note: "Staged migration docs only. Living specs and mapped active changes were materialized without changing the OpenSpec source or live loam docs. The result is intentionally not expected to validate green until the listed architecture, API, provenance, and review work is completed.",
+    };
+    const writes = [
+        planWrite(join(target, "migration-plan.json"), `${JSON.stringify(plan, null, 2)}\n`),
+        planWrite(join(target, "mapping.yaml"), stringifyYaml(normalizedMapping(inventory, mapping), { lineWidth: 0 })),
+        planWrite(join(target, "FOLLOW-UP.md"), renderFollowUp(followUpBlockers)),
+        ...docsRepoScaffold(target),
+        ...planned.livingWrites,
+        ...planned.activeWrites,
+        ...planned.legacyWrites,
+    ];
+    assertDistinctPlannedPaths(writes);
+    for (const write of writes)
+        write.exclusive = true;
+    const staged = await stageWrites(writes);
+    if (staged.some((item) => item.before !== null)) {
+        await rollbackStaged(staged);
+        throw new OpenSpecCommandError("already-exists", "Staging target changed after its emptiness check; refusing to overwrite a concurrently created file.");
+    }
+    try {
+        await swapStaged(staged);
+    }
+    catch (error) {
+        const failures = await rollbackStaged(staged);
+        const code = typeof error === "object" && error !== null && "code" in error ? error.code : null;
+        if (code === "EEXIST" && failures.length === 0) {
+            throw new OpenSpecCommandError("already-exists", "Staging target changed during apply; the migration was rolled back without overwriting the concurrent file.");
+        }
+        throw rollbackError(error, failures);
+    }
+    // The skeleton `loam init` lays down, after the content that fills it. A docs
+    // repo is recognised by `services/` plus AGENTS.md, and until now `services/`
+    // existed only if some capability happened to route there: migrate a corpus
+    // whose requirements all live under `changes/` — legitimate, and the shape a
+    // greenfield OpenSpec workspace has — and the target came out with no
+    // `services/` at all, so `loam init --docs <target> --service <id>` answered
+    // "not a docs repo" and every read command refused it as `services-missing`.
+    // Empty directories, created after the swap so a rolled-back apply leaves the
+    // target as empty as it found it.
+    for (const dir of DOCS_SUBDIRS)
+        await mkdir(join(target, dir), { recursive: true });
+    return { directory: target, files: writes.map((write) => write.path), followUpBlockers };
+}
+/**
+ * The staged target is a real docs repo, not a folder of markdown.
+ *
+ * FOLLOW-UP.md tells the migrator to validate, rebase and vouch against this
+ * directory, and every one of those commands resolves its fleet from loam.json:
+ * without these three files none of the instructions it gives can be executed,
+ * and the reviewer has no way to see what is still missing. The landscape is
+ * laid down EMPTY for the same reason `loam init` lays it down empty — an absent
+ * landscape silences every cross-service check, and a generated one would be a
+ * guess presented as the map. Each staged service then shows up as exactly one
+ * `landscape.service-unmodelled` error, which is the first follow-up item.
+ *
+ * The bytes come from `docs.ts`, so this IS the repo `loam init` makes rather
+ * than a lookalike. Only the landscape's opening comment differs, and it differs
+ * through a parameter: the migrator needs to be told why their map is empty,
+ * and everything after that sentence is advice that does not depend on how the
+ * repo was created.
+ */
+function docsRepoScaffold(target) {
+    return docsRepoFiles({
+        landscapePreamble: "// Fleet map for a staged OpenSpec migration. It arrives EMPTY because\n"
+            + "// OpenSpec has no topology: loam has nothing to read here and will not\n"
+            + "// guess \"who calls whom\" into the source of truth. Every services/<id>/\n"
+            + "// staged beside this file needs an element and a binding below — until\n"
+            + "// then each one is a `landscape.service-unmodelled` error.",
+    }).map(([rel, content]) => planWrite(join(target, rel), content));
+}
+function renderFollowUp(blockers) {
+    return `# Staged OpenSpec migration: required follow-up\n\nThis target contains migrated living requirements, mapped active feature deltas, preserved source artifacts, and a review plan. It is deliberately not presented as a fully valid loam fleet. Complete every item before moving it into live docs.\n\n${blockers.map((item) => `- [ ] ${item}`).join("\n")}\n`;
+}
+//# sourceMappingURL=target.js.map