@ybotok/loam 0.2.0-alpha.1 → 0.2.0-alpha.13

package/dist/commands/context/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/commands/context/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { loadConfig } from \"../../core/envelope/config.js\";\nimport { emitJson, fail, reportNoConfig } from \"../../core/envelope/json.js\";\nimport { parseServiceId } from \"../../core/kernel/ids/service.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { assemblePack, packHoles } from \"../../core/pack/pack.js\";\nimport { nearestIds, type FeatureEntry } from \"../../core/repo/entries.js\";\nimport { missingFeatureMessage, resolveFeature } from \"../../core/repo/repo.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { docsRepoReady, reportDocsRepoError, reportRepositoryUnavailable } from \"../policy/gate.js\";\nimport { printPack } from \"./print.js\";\n\ninterface ContextOptions {\n  feature?: string;\n  json?: boolean;\n}\n\nexport function registerContext(program: Command): void {\n  program\n    .command(\"context\")\n    .argument(\"<service>\", \"service id, e.g. payment-service\")\n    .description(\n      \"Assemble one service's docs slice — spec, contracts, edges, permissions, capabilities, and the deltas in flight over it — as one deterministic briefing; writes nothing\",\n    )\n    .option(\"--feature <FEAT>\", \"narrow the in-flight section to this one feature\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (serviceArg: string, opts: ContextOptions) => {\n      const json = opts.json === true;\n\n      const loaded = await loadConfig();\n      if (loaded.kind !== \"loaded\") {\n        reportNoConfig(json, loaded);\n        return;\n      }\n      const { docsDir } = loaded.config;\n      // `services`, not `docs`: the pack is a statement about one service in\n      // the fleet, and an empty pack read out of a directory that is not a\n      // docs repo would say \"nothing is documented here\" about a repo nobody\n      // looked in.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      const context = new FleetContext();\n      try {\n        // The feature is resolved BEFORE the service is looked up (delta's\n        // ordering): its refusal is about the flag, and it must not depend on\n        // whether the service half of the invocation was right.\n        let feature: FeatureEntry | null = null;\n        if (opts.feature !== undefined) {\n          feature = await resolveFeature(docsDir, opts.feature, \"exclude\", context);\n          if (!feature) {\n            fail(json, \"unknown-target\", await missingFeatureMessage(docsDir, opts.feature, context));\n            return;\n          }\n        }\n\n        // The enumeration answers first and the grammar second —\n        // core/repo/service-target.ts's settled order, and the pack is exactly\n        // the case its banner argues from: `services/payment service/` is a\n        // directory `validate --all` grades and `service.id-invalid` tells the\n        // team to rename, so refusing it on the grammar would make the one\n        // service loam complains about the one service nobody can be briefed\n        // on. The enumerated id is safe to use onward — a readdir produced it,\n        // which is `RawServiceId`'s whole provenance. A name that is neither\n        // enumerated nor legal is refused before any path is built; a legal\n        // name with no directory is `unknown-service`, because a typo must\n        // never be indistinguishable from an undocumented service — an EMPTY\n        // pack reads as \"nothing to know here\".\n        const entries = await context.listServices(docsDir);\n        const entry = entries.find((e) => e.id === serviceArg);\n        if (entry === undefined) {\n          const parsed = parseServiceId(serviceArg, \"service\");\n          if (!parsed.ok) {\n            fail(json, \"invalid-option\", parsed.problem);\n            return;\n          }\n          const near = nearestIds(serviceArg, entries.map((e) => e.id));\n          fail(\n            json,\n            \"unknown-service\",\n            `No service '${serviceArg}' under ${docsDir}/services/.` +\n              (near.length === 0 ? \"\" : ` Did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`),\n          );\n          return;\n        }\n\n        const pack = await assemblePack({ docsDir, entry, feature, context });\n        // A document behind the pack that exists but does not parse empties\n        // its section, and an agent loading the pack as a briefing would read\n        // that as \"nothing here\" — the vacuously-green pattern. The output\n        // stays as informative as ever (and `ok` stays true under --json: the\n        // command ran); the exit code is what stops a pipeline from building\n        // on it, so it is set BEFORE the format fork — the guard is about the\n        // pack, not about how it is rendered.\n        if (packHoles(pack)) process.exitCode = 1;\n\n        if (json) {\n          emitJson({ command: \"context\", docsDir, ...pack });\n          return;\n        }\n        printPack(pack);\n      } catch (err) {\n        if (err instanceof DocsRepoUnavailableError) {\n          reportDocsRepoError(json, err);\n          return;\n        }\n        // The assembly is all-or-nothing, like explore's scan: it reads every\n        // document the pack quotes, so the honest answer to an unreadable FILE\n        // (a directory where a document belongs, bytes that are not UTF-8) is\n        // a refusal naming the path, not a briefing with a silent hole in it.\n        reportRepositoryUnavailable(json, err, \"the pack would be missing a document\", docsDir);\n      }\n    });\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/commands/context/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { configOrRefuse, emitJson, fail } from \"../../core/envelope/json.js\";\nimport { parseServiceId, type RawServiceId } from \"../../core/kernel/ids/service.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport {\n  assembleIntroducedPack,\n  assemblePack,\n  packHoles,\n  type ContextPack,\n  type IntroducedPack,\n} from \"../../core/pack/pack.js\";\nimport { introducingFeatures } from \"../../core/projection/introduced.js\";\nimport { nearestIds, type FeatureEntry } from \"../../core/repo/entries.js\";\nimport { missingFeatureMessage, resolveFeature } from \"../../core/repo/repo.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { docsRepoReady, reportDocsRepoError, reportRepositoryUnavailable } from \"../policy/gate.js\";\nimport { printPack } from \"./print.js\";\n\ninterface ContextOptions {\n  feature?: string;\n  json?: boolean;\n}\n\nexport function registerContext(program: Command): void {\n  program\n    .command(\"context\")\n    .argument(\"<service>\", \"service id, e.g. payment-service\")\n    .description(\n      \"Assemble one service's docs slice — spec, contracts, edges, permissions, capabilities, and the deltas in flight over it — as one deterministic briefing; writes nothing\",\n    )\n    .option(\"--feature <FEAT>\", \"narrow the in-flight section to this one feature\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (serviceArg: string, opts: ContextOptions) => {\n      const json = opts.json === true;\n\n      const config = await configOrRefuse(json);\n      if (config === null) return;\n      const { docsDir } = config;\n      // `services`, not `docs`: the pack is a statement about one service in\n      // the fleet, and an empty pack read out of a directory that is not a\n      // docs repo would say \"nothing is documented here\" about a repo nobody\n      // looked in.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      const context = new FleetContext();\n      try {\n        // The feature is resolved BEFORE the service is looked up (delta's\n        // ordering): its refusal is about the flag, and it must not depend on\n        // whether the service half of the invocation was right.\n        let feature: FeatureEntry | null = null;\n        if (opts.feature !== undefined) {\n          feature = await resolveFeature(docsDir, opts.feature, \"exclude\", context);\n          if (!feature) {\n            fail(json, \"unknown-target\", await missingFeatureMessage(docsDir, opts.feature, context));\n            return;\n          }\n        }\n\n        // The enumeration answers first and the grammar second —\n        // core/repo/service-target.ts's settled order, and the pack is exactly\n        // the case its banner argues from: `services/payment service/` is a\n        // directory `validate --all` grades and `service.id-invalid` tells the\n        // team to rename, so refusing it on the grammar would make the one\n        // service loam complains about the one service nobody can be briefed\n        // on. The enumerated id is safe to use onward — a readdir produced it,\n        // which is `RawServiceId`'s whole provenance. A name that is neither\n        // enumerated nor legal is refused before any path is built; a legal\n        // name with no directory is `unknown-service`, because a typo must\n        // never be indistinguishable from an undocumented service — an EMPTY\n        // pack reads as \"nothing to know here\".\n        const entries = await context.listServices(docsDir);\n        const entry = entries.find((e) => e.id === serviceArg);\n        const assembled: Assembled =\n          entry !== undefined\n            ? { ok: true, pack: await assemblePack({ docsDir, entry, feature, context }) }\n            : await notLivingPack({ docsDir, name: serviceArg, feature, context });\n        if (!assembled.ok) {\n          fail(json, assembled.code, assembled.message);\n          return;\n        }\n        const { pack } = assembled;\n        // A document behind the pack that exists but does not parse empties\n        // its section, and an agent loading the pack as a briefing would read\n        // that as \"nothing here\" — the vacuously-green pattern. The output\n        // stays as informative as ever (and `ok` stays true under --json: the\n        // command ran); the exit code is what stops a pipeline from building\n        // on it, so it is set BEFORE the format fork — the guard is about the\n        // pack, not about how it is rendered.\n        if (packHoles(pack)) process.exitCode = 1;\n\n        if (json) {\n          emitJson({ command: \"context\", docsDir, ...pack });\n          return;\n        }\n        printPack(pack);\n      } catch (err) {\n        if (err instanceof DocsRepoUnavailableError) {\n          reportDocsRepoError(json, err);\n          return;\n        }\n        // The assembly is all-or-nothing, like explore's scan: it reads every\n        // document the pack quotes, so the honest answer to an unreadable FILE\n        // (a directory where a document belongs, bytes that are not UTF-8) is\n        // a refusal naming the path, not a briefing with a silent hole in it.\n        reportRepositoryUnavailable(json, err, \"the pack would be missing a document\", docsDir);\n      }\n    });\n}\n\n/** A pack to print, or the refusal that stands in for one. */\ntype Assembled =\n  | { ok: true; pack: ContextPack | IntroducedPack }\n  | { ok: false; code: \"invalid-option\" | \"unknown-service\"; message: string };\n\ninterface NotLivingRequest {\n  docsDir: DocsDir;\n  /** The argument exactly as typed — the living enumeration did not answer to it. */\n  name: string;\n  /** What `--feature` resolved to, or null when the flag was not given. */\n  feature: FeatureEntry | null;\n  context: FleetContext;\n}\n\n/**\n * The answer for a name `services/` does not hold: the pack of the service an\n * active feature INTRODUCES, or the refusal.\n *\n * The introducing features are the second enumeration, asked before the\n * grammar for the first one's reason — the name came off a readdir, of the\n * feature's own `specs/`. Refusing it as unknown told the implementer of a NEW\n * service, at step 1 of the implement protocol (`loam context <svc> --feature\n * <FEAT>`), that the service the feature they were handed creates does not\n * exist, while `loam tasks` listed their work for it on the same tree.\n *\n * The briefing is ONE feature's delta, because a service nobody has merged yet\n * is whatever its introducing delta says it is. One introducer is used without\n * a flag; several, with none named, is refused rather than picked — two deltas\n * each describing the same new service differently is a conflict a person\n * resolves, and silently briefing from the first would hide the other.\n */\nasync function notLivingPack(req: NotLivingRequest): Promise<Assembled> {\n  const { docsDir, name, feature, context } = req;\n  const introducing = await introducingFeatures(docsDir, name, context);\n  const [first] = introducing;\n  if (first === undefined) return unknownService(req);\n  const ids = introducing.map((f) => f.id).join(\", \");\n  if (feature !== null && !introducing.some((f) => f.dir === feature.dir)) {\n    // A feature that does not introduce the service has nothing to say about\n    // it — its projection would be an EMPTY pack, which reads as \"nothing to\n    // know here\" about a service another feature is busy creating.\n    return {\n      ok: false,\n      code: \"unknown-service\",\n      message:\n        `No service '${name}' under ${docsDir}/services/, and ${feature.id} does not introduce it — ` +\n        `${ids} ${introducing.length === 1 ? \"does\" : \"do\"}. Name ${introducing.length === 1 ? \"it\" : \"one\"} with --feature ${first.id}.`,\n    };\n  }\n  if (feature === null && introducing.length > 1) {\n    return {\n      ok: false,\n      code: \"invalid-option\",\n      message:\n        `'${name}' is not in the living docs yet, and ${ids} each introduce it — ` +\n        `name the delta to brief from with --feature <FEAT>.`,\n    };\n  }\n  const chosen = feature ?? first;\n  // The chosen feature's own readdir spelling of the name: equal as a string,\n  // and the one value here that carries the fact that a directory produced it.\n  const service: RawServiceId | undefined = chosen.services.find((s) => s === name);\n  if (service === undefined) return unknownService(req);\n  const pack = await assembleIntroducedPack({ docsDir, service, feature: chosen, introducedBy: introducing, context });\n  return { ok: true, pack };\n}\n\n/**\n * The refusal for a name nothing holds — the grammar's, then `unknown-service`\n * with the near misses. The candidates are every service a reader could have\n * meant: the living ones and the ones a feature in flight introduces, since a\n * typo of the second is now a name this command would have briefed.\n */\nasync function unknownService(req: NotLivingRequest): Promise<Assembled> {\n  const { docsDir, name, context } = req;\n  const parsed = parseServiceId(name, \"service\");\n  if (!parsed.ok) return { ok: false, code: \"invalid-option\", message: parsed.problem };\n  const [living, active] = await Promise.all([context.listServices(docsDir), context.listFeatures(docsDir)]);\n  const known = new Set<string>([...living.map((e) => e.id), ...active.flatMap((f) => f.services)]);\n  const near = nearestIds(name, [...known]);\n  return {\n    ok: false,\n    code: \"unknown-service\",\n    message:\n      `No service '${name}' under ${docsDir}/services/.` +\n      (near.length === 0 ? \"\" : ` Did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`),\n  };\n}\n"]}

package/dist/commands/context/print.js

@@ -16,10 +16,22 @@ import {} from "../../core/pack/living.js";
 import {} from "../../core/pack/features.js";
 export function printPack(pack) {
     console.log(`# ${pack.service} — context pack\n`);
-    const badge = [pack.frontmatter.status, pack.frontmatter.owner].filter((s) => s !== null);
-    console.log(`${pack.path} · ${pack.maturity}${badge.length > 0 ? ` · ${badge.join(" · ")}` : ""}`);
-    if (pack.missing.length > 0)
-        console.log(`missing: ${pack.missing.join(", ")}`);
+    if ("introducedBy" in pack) {
+        // Said FIRST, in place of the maturity line, because every living section
+        // below is about to print "(none)" — and a reader who has not been told why
+        // takes that for a documented service with nothing in it. `missing` is not
+        // printed: it names the living artifacts (`spec.md`, `model.likec4`) that
+        // the feature's archive writes, and an agent told they are missing writes
+        // them under services/ by hand, which forks the service before it exists.
+        console.log(`${pack.path} · introduced by ${pack.introducedBy.join(", ")} (in flight) — not in the living docs until it archives`);
+        console.log(`the living sections below are empty because nothing about ${pack.service} has merged yet; its documents are ${pack.feature ?? "the feature"}'s delta, under In flight`);
+    }
+    else {
+        const badge = [pack.frontmatter.status, pack.frontmatter.owner].filter((s) => s !== null);
+        console.log(`${pack.path} · ${pack.maturity}${badge.length > 0 ? ` · ${badge.join(" · ")}` : ""}`);
+        if (pack.missing.length > 0)
+            console.log(`missing: ${pack.missing.join(", ")}`);
+    }
     if (pack.frontmatter.last_verified !== null)
         console.log(`last_verified: ${pack.frontmatter.last_verified}`);
     // Under the date it qualifies: that vouch read the sections this names and
@@ -41,7 +53,17 @@ export function printPack(pack) {
     // discipline): every empty section below could otherwise be read as "nothing
     // here", which is the one conclusion an unreadable document never supports.
     if (pack.landscape.present && !pack.landscape.parses) {
-        console.log("! architecture/landscape.likec4 does not parse — no edge below is derived, and none is missing either\n");
+        // The `architecture/` PROJECT is what `parses` answers for, so the document
+        // at fault is very often a SIBLING beside a landscape that reads perfectly
+        // — and naming the landscape sent a reader to bytes loam read fine
+        // (verification 2026-09-04). `adopt` and `validate --all` name the file; so
+        // does this. The project keeps the fallback: a failure LikeC4 reports with
+        // no source document behind it is still a project that does not parse.
+        const broken = pack.landscape.broken;
+        const named = broken.length === 0 ? "the fleet map (architecture/)" : broken.join(", ");
+        // `> 1`, not `=== 1`: the empty arm's subject is the singular "fleet map".
+        const verb = broken.length > 1 ? "do" : "does";
+        console.log(`! ${named} ${verb} not parse — no edge below is derived, and none is missing either\n`);
     }
     if (pack.openapi.unreadable) {
         console.log(`! openapi.yaml does not parse — nothing here lists what ${pack.service} exposes`);
@@ -50,7 +72,7 @@ export function printPack(pack) {
         console.log();
     }
     if (pack.asyncapi.unreadable) {
-        console.log(`! asyncapi.yaml does not parse — nothing here lists what ${pack.service} publishes or consumes`);
+        console.log(`! asyncapi.yaml does not read as AsyncAPI 3.0 — nothing here lists what ${pack.service} publishes or consumes`);
         if (pack.asyncapi.error !== undefined)
             console.log(`  ${pack.asyncapi.error}`);
         console.log();
@@ -233,7 +255,7 @@ function printFeature(f, service) {
         console.log();
     }
     if (f.events.unreadable) {
-        console.log("Events: asyncapi.yaml does not parse");
+        console.log("Events: asyncapi.yaml does not read as AsyncAPI 3.0");
         if (f.events.error !== undefined)
             console.log(`  ${f.events.error}`);
         console.log();

package/dist/commands/context/print.js.map

@@ -1 +1 @@
-{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/commands/context/print.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The context pack as a Markdown document on stdout — for pasting into an\n * agent's context, or reading in a terminal that renders neither.\n *\n * Rendering only. Everything printed here comes from `core/pack/`, which is\n * also what `--json` emits, so a printed section can never disagree with the\n * payload beside it. Requirement bodies and Given/When/Then lines go out\n * VERBATIM — they are the acceptance criteria, and paraphrasing them here\n * would put a second wording of the contract in front of whoever implements\n * it. The living sections use the canonical `### Requirement:` /\n * `#### Scenario:` heading levels; the in-flight blocks print the same lines\n * one level deeper, because each sits under its feature's own `###` heading.\n */\nimport { type ContextPack } from \"../../core/pack/pack.js\";\nimport { type PackRequirement } from \"../../core/pack/living.js\";\nimport { type PackFeature } from \"../../core/pack/features.js\";\n\nexport function printPack(pack: ContextPack): void {\n  console.log(`# ${pack.service} — context pack\\n`);\n  const badge = [pack.frontmatter.status, pack.frontmatter.owner].filter((s) => s !== null);\n  console.log(`${pack.path} · ${pack.maturity}${badge.length > 0 ? ` · ${badge.join(\" · \")}` : \"\"}`);\n  if (pack.missing.length > 0) console.log(`missing: ${pack.missing.join(\", \")}`);\n  if (pack.frontmatter.last_verified !== null) console.log(`last_verified: ${pack.frontmatter.last_verified}`);\n  // Under the date it qualifies: that vouch read the sections this names and\n  // no others, so `verified` above covers less of the document than it looks.\n  if (pack.frontmatter.vouch_scope !== null) {\n    console.log(`vouch_scope: ${pack.frontmatter.vouch_scope} — the rest was not read at that vouch`);\n  }\n  // Per axis and named, `show`'s discipline: the sample is per FILE, so one\n  // run can read a short spec.md in full and stamp a long arch.spec.md\n  // sampled. Printing only the first line said `verified` over arch\n  // requirements this pack then reproduced verbatim, half of them unread.\n  if (pack.archSpec.vouch_scope !== null) {\n    console.log(\n      `archSpec.vouch_scope: ${pack.archSpec.vouch_scope} — the rest of arch.spec.md was not read at that vouch`,\n    );\n  }\n  for (const s of pack.frontmatter.sources) console.log(`sources: ${s}`);\n  console.log();\n\n  // Unreadable documents are said FIRST and without hedging (explore's print\n  // discipline): every empty section below could otherwise be read as \"nothing\n  // here\", which is the one conclusion an unreadable document never supports.\n  if (pack.landscape.present && !pack.landscape.parses) {\n    console.log(\"! architecture/landscape.likec4 does not parse — no edge below is derived, and none is missing either\\n\");\n  }\n  if (pack.openapi.unreadable) {\n    console.log(`! openapi.yaml does not parse — nothing here lists what ${pack.service} exposes`);\n    if (pack.openapi.error !== undefined) console.log(`  ${pack.openapi.error}`);\n    console.log();\n  }\n  if (pack.asyncapi.unreadable) {\n    console.log(`! asyncapi.yaml does not parse — nothing here lists what ${pack.service} publishes or consumes`);\n    if (pack.asyncapi.error !== undefined) console.log(`  ${pack.asyncapi.error}`);\n    console.log();\n  }\n  // The vocabulary failures lead with the contract failures: each empties a\n  // section below into something that reads as an answer (\"declared: false\"\n  // on every permission, \"(none realized here)\"), and a warning printed down\n  // beside the section is a warning a reader pasting the top of the pack\n  // never sees.\n  if (pack.permissionsVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/permissions.yaml does not read as a vocabulary — every permission below reports declared: false because nobody could look\");\n    console.log(`  ${pack.permissionsVocabulary.invalid}`);\n    console.log();\n  }\n  if (pack.capabilitiesVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/capabilities.yaml does not read as a vocabulary — no capability below is derived, and none is missing either\");\n    console.log(`  ${pack.capabilitiesVocabulary.invalid}`);\n    console.log();\n  }\n  for (const path of pack.capabilitiesUnread) {\n    console.log(`! ${path} could not be read while joining capabilities — that service's realizations are missing from the rollup this pack filtered`);\n  }\n  if (pack.capabilitiesUnread.length > 0) console.log();\n  if (pack.useCaseScan.unreadable) {\n    console.log(\"! architecture/ does not parse as one LikeC4 project — every use case below is missing because nobody could look, not because none is drawn\");\n    if (pack.useCaseScan.error !== undefined) console.log(`  ${pack.useCaseScan.error}`);\n    console.log();\n  }\n\n  printRequirements(\"Requirements\", pack.requirements);\n  printRequirements(\"Arch requirements\", pack.archRequirements);\n\n  console.log(\"## Operations\\n\");\n  if (pack.operations.length === 0) console.log(pack.openapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const op of pack.operations) {\n    const by = op.governedBy.length > 0\n      ? `governed by ${op.governedBy.map((n) => `\"${n}\"`).join(\", \")}`\n      : \"not governed by any requirement\";\n    console.log(`- ${op.method} ${op.path}  ${op.id} — ${by}`);\n  }\n  if (pack.operations.length > 0) console.log();\n\n  console.log(\"## Messages\\n\");\n  if (pack.messages.length === 0) console.log(pack.asyncapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const m of pack.messages) {\n    const direction = m.direction === null ? \"declared, not wired\" : m.direction.toUpperCase();\n    console.log(`- ${direction}  ${m.name}  (${m.slot})`);\n  }\n  if (pack.messages.length > 0) console.log();\n\n  console.log(\"## Permissions\\n\");\n  if (pack.permissions.length === 0) console.log(\"(none required)\\n\");\n  for (const p of pack.permissions) {\n    if (!p.declared) {\n      console.log(`- ${p.id} — not declared in architecture/permissions.yaml`);\n      continue;\n    }\n    const notes = [\n      ...(p.description === undefined ? [] : [p.description]),\n      ...(p.ownedBy === undefined ? [] : [`owned by ${p.ownedBy}`]),\n      ...(p.enforcedBy.length === 0 ? [] : [`enforced by ${p.enforcedBy.join(\", \")}`]),\n    ];\n    console.log(`- ${p.id}${notes.length > 0 ? ` — ${notes.join(\"; \")}` : \"\"}`);\n  }\n  if (pack.permissions.length > 0) console.log();\n\n  console.log(\"## Capabilities\\n\");\n  if (pack.capabilities.length === 0) {\n    console.log(pack.capabilitiesVocabulary.invalid !== undefined ? \"(unreadable — see above)\\n\" : \"(none realized here)\\n\");\n  }\n  for (const c of pack.capabilities) {\n    const label = c.description === undefined ? c.id : `${c.id} — ${c.description}`;\n    console.log(`- ${label} (realized by: ${c.requirements.map((n) => `\"${n}\"`).join(\", \")})`);\n    // The flows that claim the capability, fleet-wide — the answer to \"what is\n    // this requirement FOR\", which the requirement's own text rarely gives.\n    for (const flow of c.useCases) console.log(`  - flow: ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n  }\n  if (pack.capabilities.length > 0) console.log();\n\n  console.log(\"## Use cases\\n\");\n  if (pack.useCaseSteps.length === 0) {\n    console.log(pack.useCaseScan.unreadable ? \"(unreadable — see above)\\n\" : \"(no declared flow draws this service)\\n\");\n  }\n  for (const flow of pack.useCaseSteps) {\n    console.log(`- ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n    for (const step of flow.steps) {\n      const label = step.title === undefined ? \"\" : ` '${step.title}'`;\n      console.log(`  - step ${step.ordinal}${label}: ${step.source} -> ${step.target}`);\n    }\n  }\n  if (pack.useCaseSteps.length > 0) console.log();\n\n  console.log(\"## Landscape\\n\");\n  if (!pack.landscape.present) console.log(\"(no architecture/landscape.likec4)\\n\");\n  else if (!pack.landscape.parses) console.log(\"(unreadable — see above)\\n\");\n  else {\n    if (!pack.landscape.modelled) console.log(`${pack.service} is not in the fleet map — no edge into it can be checked`);\n    for (const e of pack.landscape.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of pack.landscape.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    if (pack.landscape.modelled && pack.landscape.inbound.length === 0 && pack.landscape.outbound.length === 0) {\n      console.log(\"(modelled, no edges touch it)\");\n    }\n    console.log();\n  }\n\n  console.log(\"## Pointers\\n\");\n  const mark = (present: boolean): string => (present ? \"present\" : \"absent\");\n  console.log(`- runbook: ${mark(pack.pointers.runbook.present)} (${pack.pointers.runbook.path})`);\n  console.log(`- health: ${mark(pack.pointers.health.present)} (${pack.pointers.health.path})`);\n  console.log(`- adrs: ${pack.pointers.adrs.count} (${pack.pointers.adrs.path})`);\n  console.log();\n\n  // The narrowing is said in the heading: a narrowed pack differs from the\n  // default only by what it leaves OUT, and a reader (or a diff) must not\n  // mistake one for a fleet gone quiet.\n  console.log(pack.feature === null ? \"## In flight\\n\" : `## In flight (narrowed to ${pack.feature})\\n`);\n  if (pack.features.length === 0) console.log(\"(no active feature touches this service)\");\n  for (const f of pack.features) printFeature(f, pack.service);\n}\n\nfunction printRequirements(label: string, reqs: PackRequirement[], level = \"##\"): void {\n  console.log(`${level} ${label}\\n`);\n  if (reqs.length === 0) console.log(\"(none)\\n\");\n  for (const r of reqs) {\n    const tag = r.kind === \"BASE\" ? \"\" : `[${r.kind}] `;\n    console.log(`${level}# Requirement: ${tag}${r.name}`);\n    if (r.text.length > 0) console.log(r.text);\n    for (const s of r.scenarios) {\n      console.log(`\\n${level}## Scenario: ${s.name}`);\n      // Verbatim, bullets and markdown emphasis included: these lines are the\n      // acceptance criteria.\n      for (const line of s.lines) console.log(line);\n    }\n    console.log();\n  }\n}\n\nfunction printFeature(f: PackFeature, service: string): void {\n  console.log(`### ${f.feature} (${f.path})\\n`);\n  if (!f.services.includes(service)) {\n    console.log(`(no delta for ${service} — ${f.feature} touches: ${f.services.length > 0 ? f.services.join(\", \") : \"(no services)\"})\\n`);\n  }\n  // Intent prose arrives with its own headings — usually an H1 title — and\n  // pasted raw under this feature's `###` those restructure the whole pack: a\n  // second H1 splits the document, and an intent section named \"Operations\"\n  // collides with the pack's own. Demoted three levels (below the feature\n  // heading), capped at H6 because a seventh `#` renders as literal text.\n  // Body lines are untouched — the demotion is structural, not a paraphrase.\n  if (f.intent !== null && f.intent.length > 0) console.log(`${demoteHeadings(f.intent)}\\n`);\n  if (f.requirements.length > 0) printRequirements(\"Requirement delta\", f.requirements, \"###\");\n  if (f.archRequirements.length > 0) printRequirements(\"Arch requirement delta\", f.archRequirements, \"###\");\n\n  if (f.openapi.unreadable) {\n    // Worded like the delta brief's answer for the same failure, and without a\n    // \"run `loam validate`\" hint: the parser's own message is quoted and the\n    // exit code carries the failure.\n    console.log(\"API: openapi.yaml does not parse\");\n    if (f.openapi.error !== undefined) console.log(`  ${f.openapi.error}`);\n    console.log();\n  } else if (f.api.length > 0) {\n    console.log(\"API changes:\");\n    for (const op of f.api) {\n      const marker = op.remove ? \"REMOVE \" : \"\";\n      console.log(`- ${marker}${op.method} ${op.path}  ${op.operationId}${op.summary === null ? \"\" : ` — ${op.summary}`}`);\n    }\n    console.log();\n  }\n\n  if (f.events.unreadable) {\n    console.log(\"Events: asyncapi.yaml does not parse\");\n    if (f.events.error !== undefined) console.log(`  ${f.events.error}`);\n    console.log();\n  } else if (f.events.changes.length > 0) {\n    console.log(\"Event changes:\");\n    for (const m of f.events.changes) {\n      const marker = m.remove ? \"REMOVE \" : \"\";\n      const direction = m.direction === null ? \"\" : `${m.direction.toUpperCase()} `;\n      console.log(`- ${marker}${direction}${m.message}  (${m.slot})`);\n    }\n    console.log();\n  }\n\n  const arch = f.architecture;\n  if (arch.errors.length > 0) {\n    console.log(\"Architecture: delta.likec4 has errors\");\n    for (const e of arch.errors) console.log(`  ${e}`);\n    console.log();\n  } else if (arch.isNew || arch.inbound.length > 0 || arch.outbound.length > 0) {\n    console.log(\"Architecture:\");\n    if (arch.isNew) console.log(`- NEW service — create ${service}`);\n    for (const e of arch.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of arch.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    console.log();\n  }\n\n  // Both interpolants passed their grammars at the boundary — the service\n  // through assertServiceId, the feature id as the CANONICAL id the\n  // enumeration derived — so the printed command parses. That property is the\n  // exact lesson explore's `--as` records: this line is assembled from data,\n  // which is the one shape test/agent-commands-runnable.test.ts cannot see.\n  console.log(`next: loam delta ${f.feature} --service ${service}\\n`);\n}\n\nfunction edgeNote(op: string | null, title: string | null): string {\n  if (op !== null) return `  ${op}`;\n  return title !== null && title.length > 0 ? `  \"${title}\"` : \"\";\n}\n\n/** Every ATX heading pushed three levels down, capped at H6 — see the intent comment above. */\nfunction demoteHeadings(md: string): string {\n  return md.replace(/^(#{1,6})(?= )/gm, (h) => \"#\".repeat(Math.min(6, h.length + 3)));\n}\n"]}
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/commands/context/print.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The context pack as a Markdown document on stdout — for pasting into an\n * agent's context, or reading in a terminal that renders neither.\n *\n * Rendering only. Everything printed here comes from `core/pack/`, which is\n * also what `--json` emits, so a printed section can never disagree with the\n * payload beside it. Requirement bodies and Given/When/Then lines go out\n * VERBATIM — they are the acceptance criteria, and paraphrasing them here\n * would put a second wording of the contract in front of whoever implements\n * it. The living sections use the canonical `### Requirement:` /\n * `#### Scenario:` heading levels; the in-flight blocks print the same lines\n * one level deeper, because each sits under its feature's own `###` heading.\n */\nimport { type ContextPack, type IntroducedPack } from \"../../core/pack/pack.js\";\nimport { type PackRequirement } from \"../../core/pack/living.js\";\nimport { type PackFeature } from \"../../core/pack/features.js\";\n\nexport function printPack(pack: ContextPack | IntroducedPack): void {\n  console.log(`# ${pack.service} — context pack\\n`);\n  if (\"introducedBy\" in pack) {\n    // Said FIRST, in place of the maturity line, because every living section\n    // below is about to print \"(none)\" — and a reader who has not been told why\n    // takes that for a documented service with nothing in it. `missing` is not\n    // printed: it names the living artifacts (`spec.md`, `model.likec4`) that\n    // the feature's archive writes, and an agent told they are missing writes\n    // them under services/ by hand, which forks the service before it exists.\n    console.log(\n      `${pack.path} · introduced by ${pack.introducedBy.join(\", \")} (in flight) — not in the living docs until it archives`,\n    );\n    console.log(\n      `the living sections below are empty because nothing about ${pack.service} has merged yet; its documents are ${pack.feature ?? \"the feature\"}'s delta, under In flight`,\n    );\n  } else {\n    const badge = [pack.frontmatter.status, pack.frontmatter.owner].filter((s) => s !== null);\n    console.log(`${pack.path} · ${pack.maturity}${badge.length > 0 ? ` · ${badge.join(\" · \")}` : \"\"}`);\n    if (pack.missing.length > 0) console.log(`missing: ${pack.missing.join(\", \")}`);\n  }\n  if (pack.frontmatter.last_verified !== null) console.log(`last_verified: ${pack.frontmatter.last_verified}`);\n  // Under the date it qualifies: that vouch read the sections this names and\n  // no others, so `verified` above covers less of the document than it looks.\n  if (pack.frontmatter.vouch_scope !== null) {\n    console.log(`vouch_scope: ${pack.frontmatter.vouch_scope} — the rest was not read at that vouch`);\n  }\n  // Per axis and named, `show`'s discipline: the sample is per FILE, so one\n  // run can read a short spec.md in full and stamp a long arch.spec.md\n  // sampled. Printing only the first line said `verified` over arch\n  // requirements this pack then reproduced verbatim, half of them unread.\n  if (pack.archSpec.vouch_scope !== null) {\n    console.log(\n      `archSpec.vouch_scope: ${pack.archSpec.vouch_scope} — the rest of arch.spec.md was not read at that vouch`,\n    );\n  }\n  for (const s of pack.frontmatter.sources) console.log(`sources: ${s}`);\n  console.log();\n\n  // Unreadable documents are said FIRST and without hedging (explore's print\n  // discipline): every empty section below could otherwise be read as \"nothing\n  // here\", which is the one conclusion an unreadable document never supports.\n  if (pack.landscape.present && !pack.landscape.parses) {\n    // The `architecture/` PROJECT is what `parses` answers for, so the document\n    // at fault is very often a SIBLING beside a landscape that reads perfectly\n    // — and naming the landscape sent a reader to bytes loam read fine\n    // (verification 2026-09-04). `adopt` and `validate --all` name the file; so\n    // does this. The project keeps the fallback: a failure LikeC4 reports with\n    // no source document behind it is still a project that does not parse.\n    const broken = pack.landscape.broken;\n    const named = broken.length === 0 ? \"the fleet map (architecture/)\" : broken.join(\", \");\n    // `> 1`, not `=== 1`: the empty arm's subject is the singular \"fleet map\".\n    const verb = broken.length > 1 ? \"do\" : \"does\";\n    console.log(`! ${named} ${verb} not parse — no edge below is derived, and none is missing either\\n`);\n  }\n  if (pack.openapi.unreadable) {\n    console.log(`! openapi.yaml does not parse — nothing here lists what ${pack.service} exposes`);\n    if (pack.openapi.error !== undefined) console.log(`  ${pack.openapi.error}`);\n    console.log();\n  }\n  if (pack.asyncapi.unreadable) {\n    console.log(`! asyncapi.yaml does not read as AsyncAPI 3.0 — nothing here lists what ${pack.service} publishes or consumes`);\n    if (pack.asyncapi.error !== undefined) console.log(`  ${pack.asyncapi.error}`);\n    console.log();\n  }\n  // The vocabulary failures lead with the contract failures: each empties a\n  // section below into something that reads as an answer (\"declared: false\"\n  // on every permission, \"(none realized here)\"), and a warning printed down\n  // beside the section is a warning a reader pasting the top of the pack\n  // never sees.\n  if (pack.permissionsVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/permissions.yaml does not read as a vocabulary — every permission below reports declared: false because nobody could look\");\n    console.log(`  ${pack.permissionsVocabulary.invalid}`);\n    console.log();\n  }\n  if (pack.capabilitiesVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/capabilities.yaml does not read as a vocabulary — no capability below is derived, and none is missing either\");\n    console.log(`  ${pack.capabilitiesVocabulary.invalid}`);\n    console.log();\n  }\n  for (const path of pack.capabilitiesUnread) {\n    console.log(`! ${path} could not be read while joining capabilities — that service's realizations are missing from the rollup this pack filtered`);\n  }\n  if (pack.capabilitiesUnread.length > 0) console.log();\n  if (pack.useCaseScan.unreadable) {\n    console.log(\"! architecture/ does not parse as one LikeC4 project — every use case below is missing because nobody could look, not because none is drawn\");\n    if (pack.useCaseScan.error !== undefined) console.log(`  ${pack.useCaseScan.error}`);\n    console.log();\n  }\n\n  printRequirements(\"Requirements\", pack.requirements);\n  printRequirements(\"Arch requirements\", pack.archRequirements);\n\n  console.log(\"## Operations\\n\");\n  if (pack.operations.length === 0) console.log(pack.openapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const op of pack.operations) {\n    const by = op.governedBy.length > 0\n      ? `governed by ${op.governedBy.map((n) => `\"${n}\"`).join(\", \")}`\n      : \"not governed by any requirement\";\n    console.log(`- ${op.method} ${op.path}  ${op.id} — ${by}`);\n  }\n  if (pack.operations.length > 0) console.log();\n\n  console.log(\"## Messages\\n\");\n  if (pack.messages.length === 0) console.log(pack.asyncapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const m of pack.messages) {\n    const direction = m.direction === null ? \"declared, not wired\" : m.direction.toUpperCase();\n    console.log(`- ${direction}  ${m.name}  (${m.slot})`);\n  }\n  if (pack.messages.length > 0) console.log();\n\n  console.log(\"## Permissions\\n\");\n  if (pack.permissions.length === 0) console.log(\"(none required)\\n\");\n  for (const p of pack.permissions) {\n    if (!p.declared) {\n      console.log(`- ${p.id} — not declared in architecture/permissions.yaml`);\n      continue;\n    }\n    const notes = [\n      ...(p.description === undefined ? [] : [p.description]),\n      ...(p.ownedBy === undefined ? [] : [`owned by ${p.ownedBy}`]),\n      ...(p.enforcedBy.length === 0 ? [] : [`enforced by ${p.enforcedBy.join(\", \")}`]),\n    ];\n    console.log(`- ${p.id}${notes.length > 0 ? ` — ${notes.join(\"; \")}` : \"\"}`);\n  }\n  if (pack.permissions.length > 0) console.log();\n\n  console.log(\"## Capabilities\\n\");\n  if (pack.capabilities.length === 0) {\n    console.log(pack.capabilitiesVocabulary.invalid !== undefined ? \"(unreadable — see above)\\n\" : \"(none realized here)\\n\");\n  }\n  for (const c of pack.capabilities) {\n    const label = c.description === undefined ? c.id : `${c.id} — ${c.description}`;\n    console.log(`- ${label} (realized by: ${c.requirements.map((n) => `\"${n}\"`).join(\", \")})`);\n    // The flows that claim the capability, fleet-wide — the answer to \"what is\n    // this requirement FOR\", which the requirement's own text rarely gives.\n    for (const flow of c.useCases) console.log(`  - flow: ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n  }\n  if (pack.capabilities.length > 0) console.log();\n\n  console.log(\"## Use cases\\n\");\n  if (pack.useCaseSteps.length === 0) {\n    console.log(pack.useCaseScan.unreadable ? \"(unreadable — see above)\\n\" : \"(no declared flow draws this service)\\n\");\n  }\n  for (const flow of pack.useCaseSteps) {\n    console.log(`- ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n    for (const step of flow.steps) {\n      const label = step.title === undefined ? \"\" : ` '${step.title}'`;\n      console.log(`  - step ${step.ordinal}${label}: ${step.source} -> ${step.target}`);\n    }\n  }\n  if (pack.useCaseSteps.length > 0) console.log();\n\n  console.log(\"## Landscape\\n\");\n  if (!pack.landscape.present) console.log(\"(no architecture/landscape.likec4)\\n\");\n  else if (!pack.landscape.parses) console.log(\"(unreadable — see above)\\n\");\n  else {\n    if (!pack.landscape.modelled) console.log(`${pack.service} is not in the fleet map — no edge into it can be checked`);\n    for (const e of pack.landscape.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of pack.landscape.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    if (pack.landscape.modelled && pack.landscape.inbound.length === 0 && pack.landscape.outbound.length === 0) {\n      console.log(\"(modelled, no edges touch it)\");\n    }\n    console.log();\n  }\n\n  console.log(\"## Pointers\\n\");\n  const mark = (present: boolean): string => (present ? \"present\" : \"absent\");\n  console.log(`- runbook: ${mark(pack.pointers.runbook.present)} (${pack.pointers.runbook.path})`);\n  console.log(`- health: ${mark(pack.pointers.health.present)} (${pack.pointers.health.path})`);\n  console.log(`- adrs: ${pack.pointers.adrs.count} (${pack.pointers.adrs.path})`);\n  console.log();\n\n  // The narrowing is said in the heading: a narrowed pack differs from the\n  // default only by what it leaves OUT, and a reader (or a diff) must not\n  // mistake one for a fleet gone quiet.\n  console.log(pack.feature === null ? \"## In flight\\n\" : `## In flight (narrowed to ${pack.feature})\\n`);\n  if (pack.features.length === 0) console.log(\"(no active feature touches this service)\");\n  for (const f of pack.features) printFeature(f, pack.service);\n}\n\nfunction printRequirements(label: string, reqs: PackRequirement[], level = \"##\"): void {\n  console.log(`${level} ${label}\\n`);\n  if (reqs.length === 0) console.log(\"(none)\\n\");\n  for (const r of reqs) {\n    const tag = r.kind === \"BASE\" ? \"\" : `[${r.kind}] `;\n    console.log(`${level}# Requirement: ${tag}${r.name}`);\n    if (r.text.length > 0) console.log(r.text);\n    for (const s of r.scenarios) {\n      console.log(`\\n${level}## Scenario: ${s.name}`);\n      // Verbatim, bullets and markdown emphasis included: these lines are the\n      // acceptance criteria.\n      for (const line of s.lines) console.log(line);\n    }\n    console.log();\n  }\n}\n\nfunction printFeature(f: PackFeature, service: string): void {\n  console.log(`### ${f.feature} (${f.path})\\n`);\n  if (!f.services.includes(service)) {\n    console.log(`(no delta for ${service} — ${f.feature} touches: ${f.services.length > 0 ? f.services.join(\", \") : \"(no services)\"})\\n`);\n  }\n  // Intent prose arrives with its own headings — usually an H1 title — and\n  // pasted raw under this feature's `###` those restructure the whole pack: a\n  // second H1 splits the document, and an intent section named \"Operations\"\n  // collides with the pack's own. Demoted three levels (below the feature\n  // heading), capped at H6 because a seventh `#` renders as literal text.\n  // Body lines are untouched — the demotion is structural, not a paraphrase.\n  if (f.intent !== null && f.intent.length > 0) console.log(`${demoteHeadings(f.intent)}\\n`);\n  if (f.requirements.length > 0) printRequirements(\"Requirement delta\", f.requirements, \"###\");\n  if (f.archRequirements.length > 0) printRequirements(\"Arch requirement delta\", f.archRequirements, \"###\");\n\n  if (f.openapi.unreadable) {\n    // Worded like the delta brief's answer for the same failure, and without a\n    // \"run `loam validate`\" hint: the parser's own message is quoted and the\n    // exit code carries the failure.\n    console.log(\"API: openapi.yaml does not parse\");\n    if (f.openapi.error !== undefined) console.log(`  ${f.openapi.error}`);\n    console.log();\n  } else if (f.api.length > 0) {\n    console.log(\"API changes:\");\n    for (const op of f.api) {\n      const marker = op.remove ? \"REMOVE \" : \"\";\n      console.log(`- ${marker}${op.method} ${op.path}  ${op.operationId}${op.summary === null ? \"\" : ` — ${op.summary}`}`);\n    }\n    console.log();\n  }\n\n  if (f.events.unreadable) {\n    console.log(\"Events: asyncapi.yaml does not read as AsyncAPI 3.0\");\n    if (f.events.error !== undefined) console.log(`  ${f.events.error}`);\n    console.log();\n  } else if (f.events.changes.length > 0) {\n    console.log(\"Event changes:\");\n    for (const m of f.events.changes) {\n      const marker = m.remove ? \"REMOVE \" : \"\";\n      const direction = m.direction === null ? \"\" : `${m.direction.toUpperCase()} `;\n      console.log(`- ${marker}${direction}${m.message}  (${m.slot})`);\n    }\n    console.log();\n  }\n\n  const arch = f.architecture;\n  if (arch.errors.length > 0) {\n    console.log(\"Architecture: delta.likec4 has errors\");\n    for (const e of arch.errors) console.log(`  ${e}`);\n    console.log();\n  } else if (arch.isNew || arch.inbound.length > 0 || arch.outbound.length > 0) {\n    console.log(\"Architecture:\");\n    if (arch.isNew) console.log(`- NEW service — create ${service}`);\n    for (const e of arch.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of arch.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    console.log();\n  }\n\n  // Both interpolants passed their grammars at the boundary — the service\n  // through assertServiceId, the feature id as the CANONICAL id the\n  // enumeration derived — so the printed command parses. That property is the\n  // exact lesson explore's `--as` records: this line is assembled from data,\n  // which is the one shape test/agent-commands-runnable.test.ts cannot see.\n  console.log(`next: loam delta ${f.feature} --service ${service}\\n`);\n}\n\nfunction edgeNote(op: string | null, title: string | null): string {\n  if (op !== null) return `  ${op}`;\n  return title !== null && title.length > 0 ? `  \"${title}\"` : \"\";\n}\n\n/** Every ATX heading pushed three levels down, capped at H6 — see the intent comment above. */\nfunction demoteHeadings(md: string): string {\n  return md.replace(/^(#{1,6})(?= )/gm, (h) => \"#\".repeat(Math.min(6, h.length + 3)));\n}\n"]}

package/dist/commands/delta/delta.js

@@ -1,14 +1,15 @@
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import { loadConfig } from "../../core/envelope/config.js";
 import { InvalidIdError, assertServiceId } from "../../core/kernel/ids/service.js";
-import { emitJson, emitJsonError, fail, repoPath, reportNoConfig, sayExplain } from "../../core/envelope/json.js";
+import { configOrRefuse, emitJson, emitJsonError, fail, repoPath, sayExplain } from "../../core/envelope/json.js";
 import { loadFile } from "../../core/c4/likec4.js";
 import { compareIds, nearestIds } from "../../core/repo/entries.js";
 import { featurePaths, featureSpecPaths } from "../../core/repo/paths.js";
 import { missingFeatureMessage, resolveFeature } from "../../core/repo/repo.js";
 import { parseRequirements } from "../../core/document/parse.js";
 import {} from "../../core/document/spec.js";
+import {} from "../../core/gherkin/digest.js";
+import { scenarioDigest } from "../../core/gherkin/stamp.js";
 import { stripFrontmatter } from "../../core/document/frontmatter.js";
 import { apiChanges } from "../../core/projection/api.js";
 import { eventChanges } from "../../core/projection/events.js";
@@ -16,7 +17,10 @@ import { archSlice, introducedServices, livingServices } from "../../core/projec
 import { useCaseBlastRadius } from "../../core/usecases/touch.js";
 import { featureCapabilityDeltas } from "../../core/capabilities/delta/tree.js";
 import { capabilityDeltaSummaries } from "../../core/capabilities/delta/summary.js";
-import { printApi, printArchSlice, printCapabilities, printEvents, printRequirements, printUseCases } from "./print.js";
+import { printApi, printArchSlice, printCapabilities, printDropped, printEvents, printRequirements, printUseCases } from "./print.js";
+import { droppedBy } from "../../core/document/apply.js";
+import { locateServicePaths } from "../../core/repo/service-target.js";
+import { livingCapabilityPaths } from "../../core/repo/authored/paths.js";
 import { indent } from "./print.js";
 export function registerDelta(program) {
     program
@@ -27,12 +31,9 @@ export function registerDelta(program) {
         .option("--json", "emit the machine contract instead of the human view")
         .action(async (featureId, opts) => {
         const json = opts.json === true;
-        const loaded = await loadConfig();
-        if (loaded.kind !== "loaded") {
-            reportNoConfig(json, loaded);
+        const config = await configOrRefuse(json);
+        if (config === null)
             return;
-        }
-        const config = loaded.config;
         // The id grammar first, and on the RAW argument: `--service ../../etc`
         // reaches `featureSpecPaths` and reads from outside the feature directory.
         // One grammar for the whole tool (core/kernel/ids/service.ts).
@@ -164,7 +165,8 @@ export function registerDelta(program) {
         // whole feature is for, and narrowing it would report a capability-only
         // feature as having nothing to say about every service in turn. One
         // `existsSync` for a fleet that has not adopted the axis.
-        const capabilities = await capabilityDeltaSummaries((await featureCapabilityDeltas(feature.dir)).docs, async (path) => parseRequirements(await readFile(path, "utf8")));
+        const capabilityDocs = (await featureCapabilityDeltas(feature.dir)).docs;
+        const capabilities = await capabilityDeltaSummaries(capabilityDocs, async (path) => parseRequirements(await readFile(path, "utf8")));
         // An unparseable delta.likec4 empties the C4 slice, and a consumer
         // reading this projection as a task brief — the JSON payload and the
         // printed view alike — would take that as "no architecture change": the
@@ -182,17 +184,61 @@ export function registerDelta(program) {
         // failure itself.
         if (arch.errors.length > 0 || api.unreadable || events.unreadable)
             process.exitCode = 1;
+        // What the merge would take out of the living documents this projection
+        // touches — the archive plan's `dropped` rows, read the same way, so the
+        // brief says before the archive what the plan says during it.
+        const livingPaths = await locateServicePaths(config.docsDir, service);
+        const dropped = await droppedRows(config.docsDir, {
+            axes: [
+                { delta: reqs, living: livingPaths.spec },
+                { delta: archReqs, living: livingPaths.archSpec },
+            ],
+            capabilities: capabilityDocs,
+        });
         if (json) {
-            const reqJson = (r) => ({
+            // `axis` is a parameter and `service` stays in the closure, because the
+            // scenario digest is salted by BOTH and only one of them varies per
+            // call — the same Given/When/Then under `spec.md` and under
+            // `arch.spec.md` are two different claims, and one hash for both would
+            // let a green business run answer an integration test nobody wrote
+            // (core/gherkin/digest.ts owns that reasoning and the recipe).
+            const reqJson = (r, axis) => ({
                 kind: r.kind,
                 id: r.id,
+                // Where the requirement sits in the document it was parsed from, so a
+                // consumer can send an author to the line rather than to the file.
+                line: r.line,
+                basedOn: r.basedOn,
                 name: r.name,
                 text: r.text.join("\n").trim(),
                 operations: r.operations,
                 covers: r.covers,
+                // The five joins this projection used to drop on the floor. Every one
+                // of them is already written on the requirement and every one names
+                // work: which permission gates it, which capability it belongs to,
+                // which named promise it realizes, and which messages it produces and
+                // consumes. An implementer handed "add the endpoint" and none of this
+                // has to go read the markdown the payload claims to have projected.
+                requires: r.requires,
+                capabilities: r.capabilities,
+                realizes: r.realizes,
+                publishes: r.publishes,
+                consumes: r.consumes,
                 // Scenarios go out verbatim: they are the acceptance criteria and the
                 // source for the tests whoever picks this up is expected to write.
-                scenarios: r.scenarios.map((s) => ({ name: s.name, lines: s.lines })),
+                //
+                // `digest` is the EXACT join key the rest of the toolchain uses —
+                // `loam gherkin` stamps it on the generated scenario as
+                // `@loam-digest-<16hex>` (core/gherkin/stamp.ts) and `loam verify`
+                // matches a cucumber report's scenarios on it. Without it a consumer
+                // of this brief could name the acceptance criteria but not the test
+                // that answers them, and had to regenerate the suite to find out.
+                scenarios: r.scenarios.map((s) => ({
+                    name: s.name,
+                    lines: s.lines,
+                    line: s.line,
+                    digest: scenarioDigest(service, s.lines, axis),
+                })),
             });
             emitJson({
                 command: "delta",
@@ -201,11 +247,12 @@ export function registerDelta(program) {
                 services: featureServices,
                 path: repoPath(config.docsDir, feature.dir),
                 intent,
-                requirements: reqs.map(reqJson),
+                requirements: reqs.map((r) => reqJson(r, "business")),
                 // Same shape, separate section: an arch requirement's scenarios are
                 // integration/ops tests, and a consumer must not have to parse prose
-                // to tell the two apart.
-                archRequirements: archReqs.map(reqJson),
+                // to tell the two apart. The axis is passed rather than inferred
+                // because it is a digest SALT, not a label — see `reqJson` above.
+                archRequirements: archReqs.map((r) => reqJson(r, "arch")),
                 api: api.changes,
                 // `api` stays exactly the operations array it has always been — a
                 // consumer indexing it must not have to learn a new shape — so the
@@ -252,6 +299,11 @@ export function registerDelta(program) {
                     removed: c.removed,
                     promises: c.promises,
                 })),
+                // Additive: every scenario and join-line entry the merge would take out
+                // of a living document, one row per replaced or removed requirement, in
+                // the shape `loam archive --json` carries as `dropped`. An empty array
+                // is the answer for a feature that only adds.
+                dropped,
             });
             return;
         }
@@ -273,7 +325,43 @@ export function registerDelta(program) {
         if (existsSync(paths.delta))
             printArchSlice(arch, service);
         printCapabilities(capabilities);
+        printDropped(dropped);
         printUseCases(useCases, service);
     });
 }
+/**
+ * Each living document's dropped rows (core/document/apply.ts), docs-relative.
+ *
+ * A pair the merge itself would refuse — malformed or repeated
+ * `Requirement-ID`s, an id and a heading selecting different requirements —
+ * is skipped rather than reported: `validate --feature` grades each under its
+ * own code, the archive refuses it, and a brief that died on it would hide
+ * every other section from the implementer. The catch is around the pure
+ * algebra alone, whose only throws are those refusals; the reads stay outside.
+ */
+async function droppedRows(docsDir, req) {
+    const pairs = [
+        ...req.axes,
+        ...(await Promise.all(req.capabilities.map(async (doc) => ({
+            delta: parseRequirements(await readFile(doc.spec, "utf8")),
+            living: livingCapabilityPaths(docsDir, doc.id).spec,
+        })))),
+    ];
+    const out = [];
+    for (const { delta, living } of pairs) {
+        if (delta.length === 0 || !existsSync(living))
+            continue;
+        const livingReqs = parseRequirements(await readFile(living, "utf8"));
+        let rows;
+        try {
+            rows = droppedBy(livingReqs, delta);
+        }
+        catch {
+            continue;
+        }
+        for (const row of rows)
+            out.push({ path: repoPath(docsDir, living), ...row });
+    }
+    return out;
+}
 //# sourceMappingURL=delta.js.map

package/dist/commands/delta/delta.js.map

@@ -1 +1 @@
-{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../../src/commands/delta/delta.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { loadConfig } from \"../../core/envelope/config.js\";\nimport { InvalidIdError, assertServiceId } from \"../../core/kernel/ids/service.js\";\nimport { emitJson, emitJsonError, fail, repoPath, reportNoConfig, sayExplain } from \"../../core/envelope/json.js\";\nimport { loadFile } from \"../../core/c4/likec4.js\";\nimport { compareIds, nearestIds } from \"../../core/repo/entries.js\";\nimport { featurePaths, featureSpecPaths } from \"../../core/repo/paths.js\";\nimport { missingFeatureMessage, resolveFeature } from \"../../core/repo/repo.js\";\nimport { parseRequirements } from \"../../core/document/parse.js\";\nimport { type Requirement } from \"../../core/document/spec.js\";\nimport { stripFrontmatter } from \"../../core/document/frontmatter.js\";\nimport { apiChanges } from \"../../core/projection/api.js\";\nimport { eventChanges } from \"../../core/projection/events.js\";\nimport { archSlice, introducedServices, livingServices } from \"../../core/projection/arch-slice.js\";\nimport { useCaseBlastRadius } from \"../../core/usecases/touch.js\";\nimport { featureCapabilityDeltas } from \"../../core/capabilities/delta/tree.js\";\nimport { capabilityDeltaSummaries } from \"../../core/capabilities/delta/summary.js\";\nimport { printApi, printArchSlice, printCapabilities, printEvents, printRequirements, printUseCases } from \"./print.js\";\nimport { indent } from \"./print.js\";\n\ninterface DeltaOptions {\n  service?: string;\n  json?: boolean;\n}\n\nexport function registerDelta(program: Command): void {\n  program\n    .command(\"delta\")\n    .argument(\"<featureId>\", \"feature id, e.g. FEAT-101\")\n    .description(\"Project a feature onto a service: why + requirement delta + C4 changes\")\n    .option(\"--service <id>\", \"service to project onto (defaults to the configured service)\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (featureId: string, opts: DeltaOptions) => {\n      const json = opts.json === true;\n      const loaded = await loadConfig();\n      if (loaded.kind !== \"loaded\") {\n        reportNoConfig(json, loaded);\n        return;\n      }\n      const config = loaded.config;\n\n      // The id grammar first, and on the RAW argument: `--service ../../etc`\n      // reaches `featureSpecPaths` and reads from outside the feature directory.\n      // One grammar for the whole tool (core/kernel/ids/service.ts).\n      if (opts.service !== undefined) {\n        try {\n          assertServiceId(opts.service, \"--service\");\n        } catch (err) {\n          if (!(err instanceof InvalidIdError)) throw err;\n          fail(json, \"invalid-option\", err.message);\n          return;\n        }\n      }\n\n      // The feature is resolved BEFORE the service is chosen, because every\n      // sentence about the service (\"which ones does this feature touch?\") is\n      // only answerable once the feature is known.\n      const feature = await resolveFeature(config.docsDir, featureId, \"exclude\");\n      if (!feature) {\n        fail(json, \"unknown-target\", await missingFeatureMessage(config.docsDir, featureId));\n        return;\n      }\n      // Canonical id from here on — the delta's tags carry `#FEAT-5`, so a raw\n      // `FEAT-5-slug` argument used to empty the architecture slice silently.\n      const { id } = feature;\n      const paths = featurePaths(feature.dir);\n\n      const deltaDoc = existsSync(paths.delta) ? await loadFile(paths.delta) : null;\n      // Services the feature speaks about at all: one with a requirement delta,\n      // or one its C4 delta introduces. This is the list a refusal quotes.\n      const featureServices = [\n        ...new Set([...feature.services, ...introducedServices(deltaDoc, id)]),\n      ].sort(compareIds);\n\n      const service = opts.service ?? config.service;\n      if (!service) {\n        // The refusal NAMES the choices. \"No service. Pass --service <id>\" told\n        // the reader the shape of the flag and nothing about the answer, so the\n        // next step was always to go list the feature's specs/ by hand — and an\n        // agent had no way to recover at all. The list rides the JSON envelope\n        // for the same reason.\n        const message =\n          `No service to project ${id} onto. Pass --service <id> or set 'service' in loam.json.` +\n          (featureServices.length === 0\n            ? ` ${id} carries no per-service delta yet.`\n            : ` ${id} touches: ${featureServices.join(\", \")}.`);\n        if (json) emitJsonError(\"invalid-option\", message, { feature: id, services: featureServices });\n        else {\n          console.error(message);\n          // This arm refuses by hand because the envelope carries `services` as\n          // data, which `fail()` has no room for — so the code and its lookup\n          // are asked for explicitly, with the same code the branch above\n          // emits. Without it this was one of the two refusals that most needed\n          // `loam explain` and had no way to name it.\n          sayExplain(\"invalid-option\");\n          process.exitCode = 1;\n        }\n        return;\n      }\n\n      // A service nobody has heard of produces a perfectly plausible EMPTY\n      // report — no requirements, no edges, \"no architecture change\" — which an\n      // agent consuming this as a task brief reads as \"nothing to do here\".\n      // A typo must never be indistinguishable from a finished service.\n      const living = await livingServices(config.docsDir);\n      if (!featureServices.includes(service) && !living.includes(service)) {\n        const near = nearestIds(service, [...new Set([...featureServices, ...living])]);\n        fail(\n          json,\n          \"unknown-target\",\n          `No service '${service}': it is neither a services/${service}/ in the docs repo nor a service ${id} touches` +\n            (featureServices.length === 0 ? \"\" : ` (${featureServices.join(\", \")})`) +\n            (near.length === 0 ? \".\" : ` — did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`),\n        );\n        return;\n      }\n\n      // Why — business intent\n      const intent = existsSync(paths.intent)\n        ? stripFrontmatter(await readFile(paths.intent, \"utf8\")).trim()\n        : null;\n\n      // Requirement delta for this service (OpenSpec style), business and arch:\n      // the same projection covers both axes, in the same shape, so the payload\n      // stays one task — the arch requirements are the integration/ops half the\n      // business ones never mention.\n      const specPaths = featureSpecPaths(feature.dir, service);\n      const reqs = existsSync(specPaths.spec)\n        ? parseRequirements(await readFile(specPaths.spec, \"utf8\"))\n        : [];\n      const archReqs = existsSync(specPaths.archSpec)\n        ? parseRequirements(await readFile(specPaths.archSpec, \"utf8\"))\n        : [];\n\n      // The contract axis. Until now no command surfaced it at all: the feature's\n      // openapi.yaml was read by validate and by archive, and the one command\n      // whose output IS the implementation task never mentioned it — so \"add the\n      // endpoint\" was the half of the work the brief left out.\n      const api = await apiChanges(specPaths.openapi);\n\n      // The event axis, same reasoning: a feature's asyncapi.yaml is merged by\n      // archive and graded by validate, so the brief must name what it changes\n      // — a message the implementer was never told to publish is the same\n      // dropped work as an endpoint the brief left out.\n      const events = await eventChanges(specPaths.asyncapi);\n\n      // C4 architecture slice. The fleet union mirrors coherence's: services/\n      // plus the feature's own specs/ names, so the slice and the validator\n      // resolve a container-targeted edge to the same owner.\n      const fleet = new Set([...living, ...featureServices]);\n      const arch = archSlice(deltaDoc, service, id, fleet);\n\n      // The use-case axis, and the one section here that is a fact about the\n      // FLEET rather than about the feature's own files: which declared business\n      // flows already run through this service, and at which hop. An implementer\n      // handed \"add the endpoint\" and not told that step 4 of Checkout is the\n      // caller has to go find that out, and on a fleet of a hundred nobody does.\n      //\n      // The fleet set is `living ∪ featureServices`, the same union `archSlice`\n      // resolves with, so a service this feature INTRODUCES resolves to itself\n      // rather than to a container's title. And `useCaseBlastRadius` gates its\n      // own load: a docs repo whose architecture/ never mentions the reserved\n      // tag prefix costs a readdir and a few file reads here, not a LikeC4\n      // workspace — which is what keeps this command usable inside\n      // /loam-implement's inner loop.\n      const useCases = await useCaseBlastRadius({\n        docsDir: config.docsDir,\n        known: fleet,\n        services: new Set([service]),\n      });\n\n      // The business axis. Like the use-case section above it is a fact about\n      // the FEATURE rather than about this service's own files, and it is here\n      // for the sharper version of that section's reason: a capability delta\n      // NAMES NO SERVICE, so projecting the feature onto a service would drop\n      // it entirely — and the implementer handed \"add the endpoint\" would never\n      // learn which business promise the requirement they are about to write is\n      // supposed to keep. `Realizes: <capability>#<id>` is the line that says\n      // so, it is written on the SERVICE requirement, and the id in it is the\n      // one thing here that cannot be guessed.\n      //\n      // Not narrowed by `--service`, deliberately: the promise is what the\n      // whole feature is for, and narrowing it would report a capability-only\n      // feature as having nothing to say about every service in turn. One\n      // `existsSync` for a fleet that has not adopted the axis.\n      const capabilities = await capabilityDeltaSummaries(\n        (await featureCapabilityDeltas(feature.dir)).docs,\n        async (path) => parseRequirements(await readFile(path, \"utf8\")),\n      );\n\n      // An unparseable delta.likec4 empties the C4 slice, and a consumer\n      // reading this projection as a task brief — the JSON payload and the\n      // printed view alike — would take that as \"no architecture change\": the\n      // vacuously-green pattern. The output stays as informative as ever (and\n      // `ok` stays true under --json: the command ran); the exit code is what\n      // stops a pipeline from building on it, so it is set BEFORE the format\n      // fork — the guard is about the delta, not about how it is rendered.\n      //\n      // The two contract axes fail the same way and earn the same guard: an\n      // openapi.yaml or asyncapi.yaml that does not parse projects as an empty\n      // change list. `validate --feature` does catch both these days\n      // (`openapi.invalid` / `asyncapi.invalid` on the feature's own files),\n      // but the guard stays this command's own: the brief is consumed by\n      // agents that never ran validate, so the exit code must carry the\n      // failure itself.\n      if (arch.errors.length > 0 || api.unreadable || events.unreadable) process.exitCode = 1;\n\n      if (json) {\n        const reqJson = (r: Requirement): Record<string, unknown> => ({\n          kind: r.kind,\n          id: r.id,\n          name: r.name,\n          text: r.text.join(\"\\n\").trim(),\n          operations: r.operations,\n          covers: r.covers,\n          // Scenarios go out verbatim: they are the acceptance criteria and the\n          // source for the tests whoever picks this up is expected to write.\n          scenarios: r.scenarios.map((s) => ({ name: s.name, lines: s.lines })),\n        });\n        emitJson({\n          command: \"delta\",\n          feature: id,\n          service,\n          services: featureServices,\n          path: repoPath(config.docsDir, feature.dir),\n          intent,\n          requirements: reqs.map(reqJson),\n          // Same shape, separate section: an arch requirement's scenarios are\n          // integration/ops tests, and a consumer must not have to parse prose\n          // to tell the two apart.\n          archRequirements: archReqs.map(reqJson),\n          api: api.changes,\n          // `api` stays exactly the operations array it has always been — a\n          // consumer indexing it must not have to learn a new shape — so the\n          // readability of the document rides alongside as its own key,\n          // spelled the way `loam show` already spells it for a living\n          // contract. Additive, which the envelope permits (core/envelope/json.ts).\n          openapi: {\n            unreadable: api.unreadable,\n            ...(api.error === undefined ? {} : { error: api.error }),\n          },\n          // The event axis arrives after the api/openapi pair settled its\n          // split shape, so it is one additive key carrying both halves:\n          // the declarations and the document's readability.\n          events: {\n            changes: events.changes,\n            unreadable: events.unreadable,\n            ...(events.error === undefined ? {} : { error: events.error }),\n          },\n          architecture: arch,\n          // Additive, which the envelope permits (core/envelope/json.ts), and\n          // deliberately NOT wired into the exit-code guard above. The three\n          // conditions there are about the FEATURE's own documents; an\n          // `architecture/` that does not parse is a pre-existing fleet defect\n          // `validate` already reports as `landscape.invalid`, and making every\n          // `loam delta` in such a repo exit 1 would be a new gate wearing the\n          // clothes of a new field. `unreadable` is how this payload says it\n          // could not look.\n          useCases: {\n            unreadable: useCases.unreadable,\n            ...(useCases.error === undefined ? {} : { error: useCases.error }),\n            flows: useCases.flows,\n          },\n          // Additive, and an empty array rather than an absent key for the same\n          // reason `loam show`'s is: a consumer must not have to tell \"this\n          // feature changes no capability\" from \"this loam does not report\n          // them\". The shape is `show`'s, verbatim — the two commands are read\n          // side by side, and a second shape for one idea is a second thing to\n          // learn.\n          capabilities: capabilities.map((c) => ({\n            id: c.id,\n            path: repoPath(config.docsDir, c.spec),\n            added: c.added,\n            modified: c.modified,\n            removed: c.removed,\n            promises: c.promises,\n          })),\n        });\n        return;\n      }\n\n      console.log(`${id} · ${service}\\n`);\n      if (intent) {\n        console.log(indent(intent, \"  \"));\n        console.log();\n      }\n      if (existsSync(specPaths.spec)) printRequirements(reqs, \"Requirements\");\n      else console.log(\"Requirements: (none for this service)\\n\");\n      if (existsSync(specPaths.archSpec)) printRequirements(archReqs, \"Arch requirements\");\n      if (existsSync(specPaths.openapi)) printApi(api);\n      if (existsSync(specPaths.asyncapi)) printEvents(events);\n      if (existsSync(paths.delta)) printArchSlice(arch, service);\n      printCapabilities(capabilities);\n      printUseCases(useCases, service);\n    });\n}\n"]}
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../../src/commands/delta/delta.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { InvalidIdError, assertServiceId } from \"../../core/kernel/ids/service.js\";\nimport { configOrRefuse, emitJson, emitJsonError, fail, repoPath, sayExplain } from \"../../core/envelope/json.js\";\nimport { loadFile } from \"../../core/c4/likec4.js\";\nimport { compareIds, nearestIds } from \"../../core/repo/entries.js\";\nimport { featurePaths, featureSpecPaths } from \"../../core/repo/paths.js\";\nimport { missingFeatureMessage, resolveFeature } from \"../../core/repo/repo.js\";\nimport { parseRequirements } from \"../../core/document/parse.js\";\nimport { type Requirement } from \"../../core/document/spec.js\";\nimport { type ScenarioAxis } from \"../../core/gherkin/digest.js\";\nimport { scenarioDigest } from \"../../core/gherkin/stamp.js\";\nimport { stripFrontmatter } from \"../../core/document/frontmatter.js\";\nimport { apiChanges } from \"../../core/projection/api.js\";\nimport { eventChanges } from \"../../core/projection/events.js\";\nimport { archSlice, introducedServices, livingServices } from \"../../core/projection/arch-slice.js\";\nimport { useCaseBlastRadius } from \"../../core/usecases/touch.js\";\nimport { featureCapabilityDeltas } from \"../../core/capabilities/delta/tree.js\";\nimport { capabilityDeltaSummaries } from \"../../core/capabilities/delta/summary.js\";\nimport { printApi, printArchSlice, printCapabilities, printDropped, printEvents, printRequirements, printUseCases } from \"./print.js\";\nimport { droppedBy, type DroppedRow } from \"../../core/document/apply.js\";\nimport { locateServicePaths } from \"../../core/repo/service-target.js\";\nimport { livingCapabilityPaths } from \"../../core/repo/authored/paths.js\";\nimport type { CapabilityDoc } from \"../../core/capabilities/tree.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { indent } from \"./print.js\";\n\ninterface DeltaOptions {\n  service?: string;\n  json?: boolean;\n}\n\nexport function registerDelta(program: Command): void {\n  program\n    .command(\"delta\")\n    .argument(\"<featureId>\", \"feature id, e.g. FEAT-101\")\n    .description(\"Project a feature onto a service: why + requirement delta + C4 changes\")\n    .option(\"--service <id>\", \"service to project onto (defaults to the configured service)\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (featureId: string, opts: DeltaOptions) => {\n      const json = opts.json === true;\n      const config = await configOrRefuse(json);\n      if (config === null) return;\n\n      // The id grammar first, and on the RAW argument: `--service ../../etc`\n      // reaches `featureSpecPaths` and reads from outside the feature directory.\n      // One grammar for the whole tool (core/kernel/ids/service.ts).\n      if (opts.service !== undefined) {\n        try {\n          assertServiceId(opts.service, \"--service\");\n        } catch (err) {\n          if (!(err instanceof InvalidIdError)) throw err;\n          fail(json, \"invalid-option\", err.message);\n          return;\n        }\n      }\n\n      // The feature is resolved BEFORE the service is chosen, because every\n      // sentence about the service (\"which ones does this feature touch?\") is\n      // only answerable once the feature is known.\n      const feature = await resolveFeature(config.docsDir, featureId, \"exclude\");\n      if (!feature) {\n        fail(json, \"unknown-target\", await missingFeatureMessage(config.docsDir, featureId));\n        return;\n      }\n      // Canonical id from here on — the delta's tags carry `#FEAT-5`, so a raw\n      // `FEAT-5-slug` argument used to empty the architecture slice silently.\n      const { id } = feature;\n      const paths = featurePaths(feature.dir);\n\n      const deltaDoc = existsSync(paths.delta) ? await loadFile(paths.delta) : null;\n      // Services the feature speaks about at all: one with a requirement delta,\n      // or one its C4 delta introduces. This is the list a refusal quotes.\n      const featureServices = [\n        ...new Set([...feature.services, ...introducedServices(deltaDoc, id)]),\n      ].sort(compareIds);\n\n      const service = opts.service ?? config.service;\n      if (!service) {\n        // The refusal NAMES the choices. \"No service. Pass --service <id>\" told\n        // the reader the shape of the flag and nothing about the answer, so the\n        // next step was always to go list the feature's specs/ by hand — and an\n        // agent had no way to recover at all. The list rides the JSON envelope\n        // for the same reason.\n        const message =\n          `No service to project ${id} onto. Pass --service <id> or set 'service' in loam.json.` +\n          (featureServices.length === 0\n            ? ` ${id} carries no per-service delta yet.`\n            : ` ${id} touches: ${featureServices.join(\", \")}.`);\n        if (json) emitJsonError(\"invalid-option\", message, { feature: id, services: featureServices });\n        else {\n          console.error(message);\n          // This arm refuses by hand because the envelope carries `services` as\n          // data, which `fail()` has no room for — so the code and its lookup\n          // are asked for explicitly, with the same code the branch above\n          // emits. Without it this was one of the two refusals that most needed\n          // `loam explain` and had no way to name it.\n          sayExplain(\"invalid-option\");\n          process.exitCode = 1;\n        }\n        return;\n      }\n\n      // A service nobody has heard of produces a perfectly plausible EMPTY\n      // report — no requirements, no edges, \"no architecture change\" — which an\n      // agent consuming this as a task brief reads as \"nothing to do here\".\n      // A typo must never be indistinguishable from a finished service.\n      const living = await livingServices(config.docsDir);\n      if (!featureServices.includes(service) && !living.includes(service)) {\n        const near = nearestIds(service, [...new Set([...featureServices, ...living])]);\n        fail(\n          json,\n          \"unknown-target\",\n          `No service '${service}': it is neither a services/${service}/ in the docs repo nor a service ${id} touches` +\n            (featureServices.length === 0 ? \"\" : ` (${featureServices.join(\", \")})`) +\n            (near.length === 0 ? \".\" : ` — did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`),\n        );\n        return;\n      }\n\n      // Why — business intent\n      const intent = existsSync(paths.intent)\n        ? stripFrontmatter(await readFile(paths.intent, \"utf8\")).trim()\n        : null;\n\n      // Requirement delta for this service (OpenSpec style), business and arch:\n      // the same projection covers both axes, in the same shape, so the payload\n      // stays one task — the arch requirements are the integration/ops half the\n      // business ones never mention.\n      const specPaths = featureSpecPaths(feature.dir, service);\n      const reqs = existsSync(specPaths.spec)\n        ? parseRequirements(await readFile(specPaths.spec, \"utf8\"))\n        : [];\n      const archReqs = existsSync(specPaths.archSpec)\n        ? parseRequirements(await readFile(specPaths.archSpec, \"utf8\"))\n        : [];\n\n      // The contract axis. Until now no command surfaced it at all: the feature's\n      // openapi.yaml was read by validate and by archive, and the one command\n      // whose output IS the implementation task never mentioned it — so \"add the\n      // endpoint\" was the half of the work the brief left out.\n      const api = await apiChanges(specPaths.openapi);\n\n      // The event axis, same reasoning: a feature's asyncapi.yaml is merged by\n      // archive and graded by validate, so the brief must name what it changes\n      // — a message the implementer was never told to publish is the same\n      // dropped work as an endpoint the brief left out.\n      const events = await eventChanges(specPaths.asyncapi);\n\n      // C4 architecture slice. The fleet union mirrors coherence's: services/\n      // plus the feature's own specs/ names, so the slice and the validator\n      // resolve a container-targeted edge to the same owner.\n      const fleet = new Set([...living, ...featureServices]);\n      const arch = archSlice(deltaDoc, service, id, fleet);\n\n      // The use-case axis, and the one section here that is a fact about the\n      // FLEET rather than about the feature's own files: which declared business\n      // flows already run through this service, and at which hop. An implementer\n      // handed \"add the endpoint\" and not told that step 4 of Checkout is the\n      // caller has to go find that out, and on a fleet of a hundred nobody does.\n      //\n      // The fleet set is `living ∪ featureServices`, the same union `archSlice`\n      // resolves with, so a service this feature INTRODUCES resolves to itself\n      // rather than to a container's title. And `useCaseBlastRadius` gates its\n      // own load: a docs repo whose architecture/ never mentions the reserved\n      // tag prefix costs a readdir and a few file reads here, not a LikeC4\n      // workspace — which is what keeps this command usable inside\n      // /loam-implement's inner loop.\n      const useCases = await useCaseBlastRadius({\n        docsDir: config.docsDir,\n        known: fleet,\n        services: new Set([service]),\n      });\n\n      // The business axis. Like the use-case section above it is a fact about\n      // the FEATURE rather than about this service's own files, and it is here\n      // for the sharper version of that section's reason: a capability delta\n      // NAMES NO SERVICE, so projecting the feature onto a service would drop\n      // it entirely — and the implementer handed \"add the endpoint\" would never\n      // learn which business promise the requirement they are about to write is\n      // supposed to keep. `Realizes: <capability>#<id>` is the line that says\n      // so, it is written on the SERVICE requirement, and the id in it is the\n      // one thing here that cannot be guessed.\n      //\n      // Not narrowed by `--service`, deliberately: the promise is what the\n      // whole feature is for, and narrowing it would report a capability-only\n      // feature as having nothing to say about every service in turn. One\n      // `existsSync` for a fleet that has not adopted the axis.\n      const capabilityDocs = (await featureCapabilityDeltas(feature.dir)).docs;\n      const capabilities = await capabilityDeltaSummaries(\n        capabilityDocs,\n        async (path) => parseRequirements(await readFile(path, \"utf8\")),\n      );\n\n      // An unparseable delta.likec4 empties the C4 slice, and a consumer\n      // reading this projection as a task brief — the JSON payload and the\n      // printed view alike — would take that as \"no architecture change\": the\n      // vacuously-green pattern. The output stays as informative as ever (and\n      // `ok` stays true under --json: the command ran); the exit code is what\n      // stops a pipeline from building on it, so it is set BEFORE the format\n      // fork — the guard is about the delta, not about how it is rendered.\n      //\n      // The two contract axes fail the same way and earn the same guard: an\n      // openapi.yaml or asyncapi.yaml that does not parse projects as an empty\n      // change list. `validate --feature` does catch both these days\n      // (`openapi.invalid` / `asyncapi.invalid` on the feature's own files),\n      // but the guard stays this command's own: the brief is consumed by\n      // agents that never ran validate, so the exit code must carry the\n      // failure itself.\n      if (arch.errors.length > 0 || api.unreadable || events.unreadable) process.exitCode = 1;\n\n      // What the merge would take out of the living documents this projection\n      // touches — the archive plan's `dropped` rows, read the same way, so the\n      // brief says before the archive what the plan says during it.\n      const livingPaths = await locateServicePaths(config.docsDir, service);\n      const dropped = await droppedRows(config.docsDir, {\n        axes: [\n          { delta: reqs, living: livingPaths.spec },\n          { delta: archReqs, living: livingPaths.archSpec },\n        ],\n        capabilities: capabilityDocs,\n      });\n\n      if (json) {\n        // `axis` is a parameter and `service` stays in the closure, because the\n        // scenario digest is salted by BOTH and only one of them varies per\n        // call — the same Given/When/Then under `spec.md` and under\n        // `arch.spec.md` are two different claims, and one hash for both would\n        // let a green business run answer an integration test nobody wrote\n        // (core/gherkin/digest.ts owns that reasoning and the recipe).\n        const reqJson = (r: Requirement, axis: ScenarioAxis): Record<string, unknown> => ({\n          kind: r.kind,\n          id: r.id,\n          // Where the requirement sits in the document it was parsed from, so a\n          // consumer can send an author to the line rather than to the file.\n          line: r.line,\n          basedOn: r.basedOn,\n          name: r.name,\n          text: r.text.join(\"\\n\").trim(),\n          operations: r.operations,\n          covers: r.covers,\n          // The five joins this projection used to drop on the floor. Every one\n          // of them is already written on the requirement and every one names\n          // work: which permission gates it, which capability it belongs to,\n          // which named promise it realizes, and which messages it produces and\n          // consumes. An implementer handed \"add the endpoint\" and none of this\n          // has to go read the markdown the payload claims to have projected.\n          requires: r.requires,\n          capabilities: r.capabilities,\n          realizes: r.realizes,\n          publishes: r.publishes,\n          consumes: r.consumes,\n          // Scenarios go out verbatim: they are the acceptance criteria and the\n          // source for the tests whoever picks this up is expected to write.\n          //\n          // `digest` is the EXACT join key the rest of the toolchain uses —\n          // `loam gherkin` stamps it on the generated scenario as\n          // `@loam-digest-<16hex>` (core/gherkin/stamp.ts) and `loam verify`\n          // matches a cucumber report's scenarios on it. Without it a consumer\n          // of this brief could name the acceptance criteria but not the test\n          // that answers them, and had to regenerate the suite to find out.\n          scenarios: r.scenarios.map((s) => ({\n            name: s.name,\n            lines: s.lines,\n            line: s.line,\n            digest: scenarioDigest(service, s.lines, axis),\n          })),\n        });\n        emitJson({\n          command: \"delta\",\n          feature: id,\n          service,\n          services: featureServices,\n          path: repoPath(config.docsDir, feature.dir),\n          intent,\n          requirements: reqs.map((r) => reqJson(r, \"business\")),\n          // Same shape, separate section: an arch requirement's scenarios are\n          // integration/ops tests, and a consumer must not have to parse prose\n          // to tell the two apart. The axis is passed rather than inferred\n          // because it is a digest SALT, not a label — see `reqJson` above.\n          archRequirements: archReqs.map((r) => reqJson(r, \"arch\")),\n          api: api.changes,\n          // `api` stays exactly the operations array it has always been — a\n          // consumer indexing it must not have to learn a new shape — so the\n          // readability of the document rides alongside as its own key,\n          // spelled the way `loam show` already spells it for a living\n          // contract. Additive, which the envelope permits (core/envelope/json.ts).\n          openapi: {\n            unreadable: api.unreadable,\n            ...(api.error === undefined ? {} : { error: api.error }),\n          },\n          // The event axis arrives after the api/openapi pair settled its\n          // split shape, so it is one additive key carrying both halves:\n          // the declarations and the document's readability.\n          events: {\n            changes: events.changes,\n            unreadable: events.unreadable,\n            ...(events.error === undefined ? {} : { error: events.error }),\n          },\n          architecture: arch,\n          // Additive, which the envelope permits (core/envelope/json.ts), and\n          // deliberately NOT wired into the exit-code guard above. The three\n          // conditions there are about the FEATURE's own documents; an\n          // `architecture/` that does not parse is a pre-existing fleet defect\n          // `validate` already reports as `landscape.invalid`, and making every\n          // `loam delta` in such a repo exit 1 would be a new gate wearing the\n          // clothes of a new field. `unreadable` is how this payload says it\n          // could not look.\n          useCases: {\n            unreadable: useCases.unreadable,\n            ...(useCases.error === undefined ? {} : { error: useCases.error }),\n            flows: useCases.flows,\n          },\n          // Additive, and an empty array rather than an absent key for the same\n          // reason `loam show`'s is: a consumer must not have to tell \"this\n          // feature changes no capability\" from \"this loam does not report\n          // them\". The shape is `show`'s, verbatim — the two commands are read\n          // side by side, and a second shape for one idea is a second thing to\n          // learn.\n          capabilities: capabilities.map((c) => ({\n            id: c.id,\n            path: repoPath(config.docsDir, c.spec),\n            added: c.added,\n            modified: c.modified,\n            removed: c.removed,\n            promises: c.promises,\n          })),\n          // Additive: every scenario and join-line entry the merge would take out\n          // of a living document, one row per replaced or removed requirement, in\n          // the shape `loam archive --json` carries as `dropped`. An empty array\n          // is the answer for a feature that only adds.\n          dropped,\n        });\n        return;\n      }\n\n      console.log(`${id} · ${service}\\n`);\n      if (intent) {\n        console.log(indent(intent, \"  \"));\n        console.log();\n      }\n      if (existsSync(specPaths.spec)) printRequirements(reqs, \"Requirements\");\n      else console.log(\"Requirements: (none for this service)\\n\");\n      if (existsSync(specPaths.archSpec)) printRequirements(archReqs, \"Arch requirements\");\n      if (existsSync(specPaths.openapi)) printApi(api);\n      if (existsSync(specPaths.asyncapi)) printEvents(events);\n      if (existsSync(paths.delta)) printArchSlice(arch, service);\n      printCapabilities(capabilities);\n      printDropped(dropped);\n      printUseCases(useCases, service);\n    });\n}\n\n/** The documents one projection's dropped rows are read over. */\ninterface DroppedRequest {\n  /** The service's two spec axes: the feature's parsed delta and the living document's path. */\n  axes: Array<{ delta: Requirement[]; living: string }>;\n  /** The feature's capability deltas — not narrowed by `--service`, for the capabilities section's reason. */\n  capabilities: readonly CapabilityDoc[];\n}\n\n/**\n * Each living document's dropped rows (core/document/apply.ts), docs-relative.\n *\n * A pair the merge itself would refuse — malformed or repeated\n * `Requirement-ID`s, an id and a heading selecting different requirements —\n * is skipped rather than reported: `validate --feature` grades each under its\n * own code, the archive refuses it, and a brief that died on it would hide\n * every other section from the implementer. The catch is around the pure\n * algebra alone, whose only throws are those refusals; the reads stay outside.\n */\nasync function droppedRows(docsDir: DocsDir, req: DroppedRequest): Promise<Array<DroppedRow & { path: string }>> {\n  const pairs = [\n    ...req.axes,\n    ...(await Promise.all(\n      req.capabilities.map(async (doc) => ({\n        delta: parseRequirements(await readFile(doc.spec, \"utf8\")),\n        living: livingCapabilityPaths(docsDir, doc.id).spec,\n      })),\n    )),\n  ];\n  const out: Array<DroppedRow & { path: string }> = [];\n  for (const { delta, living } of pairs) {\n    if (delta.length === 0 || !existsSync(living)) continue;\n    const livingReqs = parseRequirements(await readFile(living, \"utf8\"));\n    let rows: DroppedRow[];\n    try {\n      rows = droppedBy(livingReqs, delta);\n    } catch {\n      continue;\n    }\n    for (const row of rows) out.push({ path: repoPath(docsDir, living), ...row });\n  }\n  return out;\n}\n"]}