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

package/dist/commands/mcp/mcp.js

@@ -0,0 +1,75 @@
+import { toolRunner } from "./dispatch.js";
+import { serve } from "./serve.js";
+import { MCP_TOOLS } from "../../core/mcp/tools.js";
+import { MCP_AUTHOR_TOOLS } from "../../core/mcp/author-tools.js";
+export function registerMcp(program) {
+    program
+        .command("mcp")
+        .description("Serve loam commands as MCP tools over stdio (JSON-RPC 2.0)")
+        .option("--author", "opt in to safe authoring tools; vouch and committing archive stay excluded")
+        // Declared for the uniform surface every command owes (`--json` is
+        // mandatory, test/agents.test.ts), and it is not inert: it governs the one
+        // pre-loop surface this command has — a usage error like `loam mcp --bogus`
+        // aborts before the action runs, and cli.ts's catch reads raw argv to
+        // decide whether that refusal is an envelope. Once the loop runs, stdout
+        // is JSON-RPC frames either way; there is no human rendering to switch off.
+        .option("--json", "emit the machine contract instead of the human view")
+        .action(async (opts) => {
+        await startMcp(mcpToolTable(opts.author === true), {
+            input: process.stdin,
+            output: process.stdout,
+            log: process.stderr,
+        });
+    });
+}
+/**
+ * The table `loam mcp` serves: the read surface, and the bounded writers after
+ * it only when the server was launched with `--author`.
+ *
+ * A function of its own, exported, because nothing pinned it inline. The
+ * in-process tests hand `startMcp` a table directly and the stdio smoke
+ * spawned `loam mcp` only without the flag, so this choice written as
+ * `MCP_TOOLS` alone left every test green — while every config `loam init
+ * --mcp-author` writes launches `loam mcp --author`, and those hosts would
+ * have lost the authoring tools without a word. test/mcp-serve.test.ts holds
+ * both values here; test/mcp-stdio.test.ts spawns `loam mcp --author` and holds
+ * the flag to it.
+ */
+export function mcpToolTable(author) {
+    return author ? [...MCP_TOOLS, ...MCP_AUTHOR_TOOLS] : MCP_TOOLS;
+}
+/**
+ * The action's body: serve `tools` on `io` until its input ends — or refuse
+ * before the first byte when the table itself is defective.
+ *
+ * Exported, with the stdio triple injected, so the startup refusal is pinned
+ * WHERE it happens. A test of `toolRunner` alone could not see the wiring
+ * here: rewritten as `(argv) => toolRunner(tools)(argv)`, every call would
+ * build its own runner, the refusal would move back to every `tools/call`, and
+ * a test that only called `toolRunner` would still pass.
+ */
+export function startMcp(tools, io) {
+    // No docs-repo gate at startup, deliberately (the add-command preamble
+    // decision): a launch-time refusal would print a non-JSON-RPC line into
+    // the client's protocol stream and kill the handshake with nothing a
+    // client can parse. Every tool call flows through the same command path
+    // the CLI uses, so a missing or broken loam.json arrives as the ordinary
+    // `no-config`/`config-invalid` envelope in a tool result — readable, and
+    // actionable, by the agent on the other end. The server serves the
+    // repository it was started in (each call resolves loam.json through
+    // process.cwd()) and never changes directory.
+    // One table decides both what `tools/list` advertises and which commands
+    // a `tools/call` can reach (`./dispatch.ts`'s `toolRunner`).
+    //
+    // `toolRunner` is the ONE launch-time refusal, and it is not the gate the
+    // paragraph above declines: it throws only when the table itself names a
+    // command with no registrar — a defect in the shipped binary that no
+    // repository state causes and no client can repair. Refusing here, before
+    // the first frame, costs the handshake; answering it per call instead
+    // turned every `tools/call` into an `internal` envelope, the correctly
+    // wired tools included. Without `--json` (how a client launches it) the
+    // message goes to stderr through cli.ts's catch, and stdout stays empty.
+    const run = toolRunner(tools);
+    return serve(io, run, tools);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/commands/mcp/mcp.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAgB,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAgB,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,UAAU,EAAE,4EAA4E,CAAC;QACjG,mEAAmE;QACnE,2EAA2E;QAC3E,4EAA4E;QAC5E,sEAAsE;QACtE,yEAAyE;QACzE,4EAA4E;SAC3E,MAAM,CAAC,QAAQ,EAAE,qDAAqD,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;QACjC,MAAM,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAyB,EAAE,EAAW;IAC7D,uEAAuE;IACvE,wEAAwE;IACxE,qEAAqE;IACrE,wEAAwE;IACxE,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,qEAAqE;IACrE,8CAA8C;IAC9C,yEAAyE;IACzE,6DAA6D;IAC7D,EAAE;IACF,0EAA0E;IAC1E,yEAAyE;IACzE,qEAAqE;IACrE,0EAA0E;IAC1E,sEAAsE;IACtE,uEAAuE;IACvE,wEAAwE;IACxE,yEAAyE;IACzE,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["/**\n * `loam mcp` — serve the read surface, plus bounded writers under `--author`.\n *\n * The action asks `mcpToolTable` which table its flag selects and hands it,\n * with the real stdio triple, to `startMcp`, which resolves the table once and\n * serves it until stdin EOF; everything else with a decision in it lives in\n * `./serve.ts`, `./dispatch.ts` and `src/core/mcp/`. This module carries the\n * one command registration of the package (test/agents.test.ts counts\n * registrations by their literal spelling, so the sibling modules must never\n * spell one).\n */\nimport type { Command } from \"commander\";\nimport { toolRunner } from \"./dispatch.js\";\nimport { serve, type ServeIo } from \"./serve.js\";\nimport { MCP_TOOLS, type McpTool } from \"../../core/mcp/tools.js\";\nimport { MCP_AUTHOR_TOOLS } from \"../../core/mcp/author-tools.js\";\n\ninterface McpOptions {\n  author?: boolean;\n}\n\nexport function registerMcp(program: Command): void {\n  program\n    .command(\"mcp\")\n    .description(\"Serve loam commands as MCP tools over stdio (JSON-RPC 2.0)\")\n    .option(\"--author\", \"opt in to safe authoring tools; vouch and committing archive stay excluded\")\n    // Declared for the uniform surface every command owes (`--json` is\n    // mandatory, test/agents.test.ts), and it is not inert: it governs the one\n    // pre-loop surface this command has — a usage error like `loam mcp --bogus`\n    // aborts before the action runs, and cli.ts's catch reads raw argv to\n    // decide whether that refusal is an envelope. Once the loop runs, stdout\n    // is JSON-RPC frames either way; there is no human rendering to switch off.\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (opts: McpOptions) => {\n      await startMcp(mcpToolTable(opts.author === true), {\n        input: process.stdin,\n        output: process.stdout,\n        log: process.stderr,\n      });\n    });\n}\n\n/**\n * The table `loam mcp` serves: the read surface, and the bounded writers after\n * it only when the server was launched with `--author`.\n *\n * A function of its own, exported, because nothing pinned it inline. The\n * in-process tests hand `startMcp` a table directly and the stdio smoke\n * spawned `loam mcp` only without the flag, so this choice written as\n * `MCP_TOOLS` alone left every test green — while every config `loam init\n * --mcp-author` writes launches `loam mcp --author`, and those hosts would\n * have lost the authoring tools without a word. test/mcp-serve.test.ts holds\n * both values here; test/mcp-stdio.test.ts spawns `loam mcp --author` and holds\n * the flag to it.\n */\nexport function mcpToolTable(author: boolean): readonly McpTool[] {\n  return author ? [...MCP_TOOLS, ...MCP_AUTHOR_TOOLS] : MCP_TOOLS;\n}\n\n/**\n * The action's body: serve `tools` on `io` until its input ends — or refuse\n * before the first byte when the table itself is defective.\n *\n * Exported, with the stdio triple injected, so the startup refusal is pinned\n * WHERE it happens. A test of `toolRunner` alone could not see the wiring\n * here: rewritten as `(argv) => toolRunner(tools)(argv)`, every call would\n * build its own runner, the refusal would move back to every `tools/call`, and\n * a test that only called `toolRunner` would still pass.\n */\nexport function startMcp(tools: readonly McpTool[], io: ServeIo): Promise<void> {\n  // No docs-repo gate at startup, deliberately (the add-command preamble\n  // decision): a launch-time refusal would print a non-JSON-RPC line into\n  // the client's protocol stream and kill the handshake with nothing a\n  // client can parse. Every tool call flows through the same command path\n  // the CLI uses, so a missing or broken loam.json arrives as the ordinary\n  // `no-config`/`config-invalid` envelope in a tool result — readable, and\n  // actionable, by the agent on the other end. The server serves the\n  // repository it was started in (each call resolves loam.json through\n  // process.cwd()) and never changes directory.\n  // One table decides both what `tools/list` advertises and which commands\n  // a `tools/call` can reach (`./dispatch.ts`'s `toolRunner`).\n  //\n  // `toolRunner` is the ONE launch-time refusal, and it is not the gate the\n  // paragraph above declines: it throws only when the table itself names a\n  // command with no registrar — a defect in the shipped binary that no\n  // repository state causes and no client can repair. Refusing here, before\n  // the first frame, costs the handshake; answering it per call instead\n  // turned every `tools/call` into an `internal` envelope, the correctly\n  // wired tools included. Without `--json` (how a client launches it) the\n  // message goes to stderr through cli.ts's catch, and stdout stays empty.\n  const run = toolRunner(tools);\n  return serve(io, run, tools);\n}\n"]}

package/dist/commands/mcp/serve.js

@@ -0,0 +1,55 @@
+import { frame, splitFrames } from "../../core/mcp/framing.js";
+import { INTERNAL_ERROR, errorResponse, resultResponse, routeLine, toolReply, } from "../../core/mcp/protocol.js";
+import { MCP_TOOLS } from "../../core/mcp/tools.js";
+export async function serve(io, runTool, tools = MCP_TOOLS) {
+    // One startup line, to stderr only — a client is entitled to a stdout that
+    // has never carried anything but frames, from the very first byte.
+    io.log.write(`loam mcp: serving ${process.cwd()} over stdio\n`);
+    // Decode at the stream, not per chunk: a UTF-8 code point split across two
+    // chunks would corrupt if each chunk were stringified on its own.
+    io.input.setEncoding("utf8");
+    let rest = "";
+    for await (const chunk of io.input) {
+        const split = splitFrames(rest + String(chunk));
+        rest = split.rest;
+        for (const line of split.lines)
+            await handleLine(line, io, runTool, tools);
+    }
+    // A final frame the client sent without a trailing newline is still a frame:
+    // EOF terminates it exactly as the delimiter would have.
+    if (rest.trim() !== "")
+        await handleLine(rest, io, runTool, tools);
+}
+async function handleLine(line, io, runTool, tools) {
+    const outcome = routeLine(line, tools);
+    if (outcome.kind === "ignore")
+        return;
+    if (outcome.kind === "reply") {
+        io.output.write(frame(outcome.response));
+        return;
+    }
+    await handleCall(outcome, io, runTool);
+}
+/** One tools/call, contained: whatever this call does, the loop survives it. */
+async function handleCall(call, io, runTool) {
+    try {
+        const run = await runTool(call.argv);
+        if (run.stderr.trim() !== "") {
+            // A command's diagnostics are server-side logging, never protocol bytes.
+            io.log.write(`loam mcp: ${call.toolName} stderr: ${run.stderr.trim()}\n`);
+        }
+        const reply = toolReply(run);
+        io.output.write(frame(reply.kind === "result"
+            ? resultResponse(call.id, reply.result)
+            : errorResponse(call.id, reply.code, reply.message)));
+    }
+    catch (err) {
+        // The dispatcher already converts everything it can into an envelope, so
+        // reaching here means the failure was outside it (or in the wrapping
+        // itself). It becomes a JSON-RPC error for THIS id — the caller learns
+        // which call died, with the reason — and the loop reads the next frame.
+        const detail = err instanceof Error ? err.message : String(err);
+        io.output.write(frame(errorResponse(call.id, INTERNAL_ERROR, `${call.toolName} failed: ${detail}`)));
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/mcp/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/mcp/serve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The MCP stdio loop: read newline-delimited JSON-RPC frames from `input`,\n * answer on `output`, log on `log`. Streams are injected so the tests drive\n * a whole session in-process with PassThrough pairs; `loam mcp` passes the\n * real stdio triple.\n *\n * Two invariants everything else leans on:\n *\n * - `output` carries protocol frames and NOTHING else — every byte goes\n *   through `frame()`. Command output cannot leak here: the dispatcher hooks\n *   console and commander's own writers, and no command in src/ writes to\n *   process.stdout directly (verified at implementation time; the dispatcher\n *   comment records the guarantee it needs). Logging — the startup line, a\n *   tool's captured stderr — goes to `log`, which MCP permits.\n *\n * - Frames are handled STRICTLY SEQUENTIALLY: each one is awaited before the\n *   next is looked at. This is not an optimization opportunity — the\n *   dispatcher's console capture is process-global, so two overlapping calls\n *   would interleave their captured output into each other's envelopes.\n *\n * The loop ends when `input` ends: per the MCP stdio lifecycle the client\n * closes stdin to shut the server down, so EOF resolves this promise, the\n * action resolves, and cli.ts — the only process-exit decider — lets the\n * process drain to exit 0. No signal handling, no exit call here.\n */\nimport type { Readable, Writable } from \"node:stream\";\nimport { frame, splitFrames } from \"../../core/mcp/framing.js\";\nimport {\n  INTERNAL_ERROR,\n  errorResponse,\n  resultResponse,\n  routeLine,\n  toolReply,\n} from \"../../core/mcp/protocol.js\";\nimport type { RouteOutcome, ToolRunOutcome } from \"../../core/mcp/protocol.js\";\nimport { MCP_TOOLS, type McpTool } from \"../../core/mcp/tools.js\";\n\nexport interface ServeIo {\n  readonly input: Readable;\n  readonly output: Writable;\n  readonly log: Writable;\n}\n\n/** The dispatcher, as a parameter: serve() stays testable with a stub and owns no registration. */\nexport type ToolRunner = (argv: readonly string[]) => Promise<ToolRunOutcome>;\n\nexport async function serve(\n  io: ServeIo,\n  runTool: ToolRunner,\n  tools: readonly McpTool[] = MCP_TOOLS,\n): Promise<void> {\n  // One startup line, to stderr only — a client is entitled to a stdout that\n  // has never carried anything but frames, from the very first byte.\n  io.log.write(`loam mcp: serving ${process.cwd()} over stdio\\n`);\n  // Decode at the stream, not per chunk: a UTF-8 code point split across two\n  // chunks would corrupt if each chunk were stringified on its own.\n  io.input.setEncoding(\"utf8\");\n  let rest = \"\";\n  for await (const chunk of io.input) {\n    const split = splitFrames(rest + String(chunk));\n    rest = split.rest;\n    for (const line of split.lines) await handleLine(line, io, runTool, tools);\n  }\n  // A final frame the client sent without a trailing newline is still a frame:\n  // EOF terminates it exactly as the delimiter would have.\n  if (rest.trim() !== \"\") await handleLine(rest, io, runTool, tools);\n}\n\nasync function handleLine(\n  line: string,\n  io: ServeIo,\n  runTool: ToolRunner,\n  tools: readonly McpTool[],\n): Promise<void> {\n  const outcome: RouteOutcome = routeLine(line, tools);\n  if (outcome.kind === \"ignore\") return;\n  if (outcome.kind === \"reply\") {\n    io.output.write(frame(outcome.response));\n    return;\n  }\n  await handleCall(outcome, io, runTool);\n}\n\n/** One tools/call, contained: whatever this call does, the loop survives it. */\nasync function handleCall(\n  call: Extract<RouteOutcome, { kind: \"call\" }>,\n  io: ServeIo,\n  runTool: ToolRunner,\n): Promise<void> {\n  try {\n    const run = await runTool(call.argv);\n    if (run.stderr.trim() !== \"\") {\n      // A command's diagnostics are server-side logging, never protocol bytes.\n      io.log.write(`loam mcp: ${call.toolName} stderr: ${run.stderr.trim()}\\n`);\n    }\n    const reply = toolReply(run);\n    io.output.write(frame(\n      reply.kind === \"result\"\n        ? resultResponse(call.id, reply.result)\n        : errorResponse(call.id, reply.code, reply.message),\n    ));\n  } catch (err) {\n    // The dispatcher already converts everything it can into an envelope, so\n    // reaching here means the failure was outside it (or in the wrapping\n    // itself). It becomes a JSON-RPC error for THIS id — the caller learns\n    // which call died, with the reason — and the loop reads the next frame.\n    const detail = err instanceof Error ? err.message : String(err);\n    io.output.write(frame(errorResponse(call.id, INTERNAL_ERROR, `${call.toolName} failed: ${detail}`)));\n  }\n}\n"]}

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

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

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 { openspecRequirements } from \"../../../core/openspec/scan/shape.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, type OpenSpecRenamedUsage } 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\n/** A RENAMED pair whose two headings and settled identity are all known — the only kind that materializes. */\ntype SettledRename = OpenSpecRenamedUsage & { from: string; to: string; requirementId: string };\n\nfunction isSettled(rename: OpenSpecRenamedUsage): rename is SettledRename {\n  return rename.from !== null && rename.to !== null && rename.requirementId !== null;\n}\n\n/**\n * A settled rename staged as the MODIFIED requirement it becomes: the new\n * heading under the settled id, annotated once with the living requirement it\n * renames. One construction for both places a rename materializes — over the\n * delta's own MODIFIED body (already that kind, so the `kind` here changes\n * nothing), and over the living requirement when the delta restates none.\n */\nfunction renamedAsModified(base: Requirement, rename: SettledRename): Requirement {\n  const annotation = `OpenSpec-Living-Source: ${rename.capability} :: ${rename.from}`;\n  return {\n    ...base,\n    kind: \"MODIFIED\",\n    id: rename.requirementId,\n    name: rename.to,\n    text: base.text.includes(annotation) ? base.text : [...base.text, \"\", annotation],\n    section: \"## MODIFIED Requirements\",\n  };\n}\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 = openspecRequirements(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 && isSettled(rename)) {\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          requirement = renamedAsModified(parsed, rename);\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 (!isSettled(rename)) 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 modified = renamedAsModified(source, rename);\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":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,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,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAwB,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAA0B,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAqB,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAA4B,EAC5B,OAAwB,EACxB,MAAc,EACd,kBAAsD;IAEtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,SAAS,CAAC,OAAO;SACd,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC;SACtG,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,aAAc,CAAU,CAAC,CAC7F,CAAC;IACF,KAAK,MAAM,UAAU,IAAI,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS,CAAC,qCAAqC;QAC3E,KAAK,MAAM,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACjE,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,WAAW,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;YACpF,mEAAmE;YACnE,0EAA0E;YAC1E,yEAAyE;YACzE,sEAAsE;YACtE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,mBAAmB,WAAW,CAAC,EAAE,GAAG,CAAC;gBACvH,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI;uBAC3B,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,WAAW,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC5F,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,2CAA2C,OAAO,QAAQ,QAAQ,gEAAgE,CACnI,CAAC;gBACJ,CAAC;gBACD,sEAAsE;gBACtE,2EAA2E;gBAC3E,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1F,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;SAC5B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE;QAC/B,gCAAgC,CAAC,0BAA0B,OAAO,GAAG,EAAE,YAAY,CAAC,CAAC;QACrF,OAAO,SAAS,CACd,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,EAC5C,QAAQ,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,OAAO,4OAA4O,qBAAqB,CAAC,YAAY,CAAC,EAAE,CACtX,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC","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"]}