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

package/dist/commands/seed/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/commands/seed/plan.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What a seed run will write, decided in full before a byte lands. Split from\n * `./commit.ts` on the phase seam: that module owns the WINDOW — the lock, the\n * interrupted-commit recovery, the two refusals and the transaction — while\n * this one answers the single question \"given the tree as it is and the fleet\n * file as it reads, which files change and how\". Nothing here acquires\n * anything, and nothing here writes: it is called under the lock and hands\n * back a plan the transaction executes or rolls back whole.\n */\nimport { existsSync } from \"node:fs\";\nimport { readdir, readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { Elem } from \"../../core/c4/likec4.js\";\nimport type { FleetSeed } from \"../../core/c4/seed/fleet-file.js\";\nimport { serviceDirOf, type DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport {\n  landscapePath,\n  servicePathsUnder,\n  servicesDir,\n  subsystemPathUnder,\n  subsystemViewsPath,\n  unfiledServicePaths,\n} from \"../../core/repo/paths.js\";\nimport { SUBSYSTEM_MARKER } from \"../../core/repo/tree/marker.js\";\nimport { renderSubsystemViews, viewsAgree } from \"../../core/repo/tree/views.js\";\nimport type { FleetTree, SubsystemEntry, WalkedService } from \"../../core/repo/tree/walk.js\";\nimport { TEMP_FILE_RE } from \"../../core/staging/commit.js\";\nimport { planWrite, type PlannedWrite } from \"../../core/staging/writes.js\";\n\n/** Everything the plan reads. The commit request extends this and adds only `rerun`. */\nexport interface SeedPlanInput {\n  docsDir: DocsDir;\n  seed: FleetSeed;\n  /** The sealed landscape text (stamp on line 1), already proven to parse. */\n  landscape: string;\n  /**\n   * That same text's parsed elements — the loadSource self-check's output,\n   * reused for the views join so the generated views file agrees byte for byte\n   * with what `validate --all` will recompute from the committed landscape.\n   */\n  elements: Elem[];\n}\n\nexport interface SeedPlan {\n  writes: PlannedWrite[];\n  /** Service ids split by whether this run creates the directory. */\n  services: { created: string[]; existing: string[] };\n}\n\n/**\n * Does this existing service directory hold nothing git would keep? An empty\n * directory is a service to the walk but nothing at all to git, so a landscape\n * declaring it clones into a repo where `validate --all` fails on a service\n * that exists only on the author's disk. Seed's own crash window produces\n * exactly this tree — `stageWrites` creates directories before the journal is\n * written, so a kill in between leaves directories no recovery knows about —\n * and so does a plain `mkdir`. Staging temps do not count as content: they are\n * that same crash's litter, not somebody's file.\n */\nasync function keepsNothing(dir: string): Promise<boolean> {\n  try {\n    return (await readdir(dir)).every((entry) => TEMP_FILE_RE.test(entry));\n  } catch {\n    // Unreadable is not empty: the walk found this directory a moment ago, and\n    // inventing a write into a directory we cannot list is the wrong guess.\n    return false;\n  }\n}\n\n/**\n * The complete plan, in memory, before a byte lands: the sealed landscape, one\n * marker per NEW subsystem, one `.gitkeep` per service directory this commit\n * creates — and per existing one holding nothing git would keep (see\n * `keepsNothing`) — and the generated views file rendered from the tree AS\n * THIS COMMIT LEAVES IT, never from a re-walk between two states\n * (commands/subsystem/txn/views.ts's `movedTree` doctrine). That last one is\n * the only write that can be a DELETE: a tree with no subsystems owes no views\n * file, and a leftover is a finding.\n *\n * Existing directories are never moved: fleet.yaml's placement is ignored for\n * a service that already exists — moving is `loam subsystem move <id> --into\n * <name>`'s job, under its own guards — and nothing anywhere is deleted except\n * that one generated file.\n */\nexport async function planSeedWrites(req: SeedPlanInput, tree: FleetTree): Promise<SeedPlan> {\n  const { docsDir, seed } = req;\n  const writes: PlannedWrite[] = [planWrite(landscapePath(docsDir), req.landscape)];\n\n  const existingSubs = new Map(tree.subsystems.map((s) => [s.name, s]));\n  const newSubs: SubsystemEntry[] = [];\n  for (const sub of seed.subsystems) {\n    if (existingSubs.has(sub as string)) continue;\n    const dir = subsystemPathUnder(servicesDir(docsDir), sub);\n    // A comment line parses to null — a valid empty marker (tree/marker.ts).\n    writes.push(planWrite(join(dir, SUBSYSTEM_MARKER), \"# subsystem marker\\n\"));\n    newSubs.push({ name: sub as string, path: [sub as string], dir, meta: {} });\n  }\n\n  const treeDirs = new Map(tree.services.map((s) => [s.id as string, s.dir]));\n  // Every existing directory inspected at once — independent reads, so the\n  // loop below stays synchronous.\n  const invisible = new Map(\n    await Promise.all([...treeDirs].map(async ([id, dir]) => [id, await keepsNothing(dir)] as const)),\n  );\n  const created: string[] = [];\n  const existing: string[] = [];\n  const newWalked: WalkedService[] = [];\n  for (const s of seed.services) {\n    const already = treeDirs.get(s.id as string);\n    if (already !== undefined) {\n      existing.push(s.id);\n      // Existing, but git-invisible: give it the `.gitkeep` a created service\n      // gets, or the landscape about to be written declares a directory the\n      // next clone will not have. `planWrite` makes this a no-op when the file\n      // is already there, so a real service is never touched.\n      if (invisible.get(s.id as string) === true) writes.push(planWrite(join(already, \".gitkeep\"), \"\"));\n      continue;\n    }\n    created.push(s.id);\n    const parent = s.subsystem === null ? null : existingSubs.get(s.subsystem as string) ?? null;\n    const dir =\n      s.subsystem === null\n        ? unfiledServicePaths(docsDir, s.id).dir\n        : parent !== null\n          ? servicePathsUnder(parent.dir, s.id).dir\n          : // A subsystem this same commit creates: the creation spelling,\n            // through the same branded joins the subsystem verbs use.\n            serviceDirOf(join(subsystemPathUnder(servicesDir(docsDir), s.subsystem), s.id));\n    writes.push(planWrite(join(dir, \".gitkeep\"), \"\"));\n    newWalked.push({\n      // A ServiceId IS a RawServiceId (the checked subtype), so no re-cast.\n      id: s.id,\n      dir,\n      subsystem: s.subsystem === null ? [] : parent !== null ? parent.path : [s.subsystem as string],\n    });\n  }\n\n  const plannedTree: FleetTree = {\n    findings: [],\n    services: [...tree.services, ...newWalked],\n    subsystems: [...tree.subsystems, ...newSubs],\n  };\n  // The generated views file, including its ABSENCE. `renderSubsystemViews`\n  // returning null means the tree has no subsystems, and its contract is that\n  // the file must then not exist — `validate` grades a leftover as\n  // `subsystem.views-stale`, so a seed that ignored the file would exit 0 and\n  // send the caller, via its own `next` list, into a failing gate over a file\n  // it had in hand. `content: null` is the delete the transaction understands\n  // (commands/subsystem/txn/txn.ts's `\"removed\"`), and a file that already\n  // SAYS this is left out of the journal entirely rather than written back\n  // over itself.\n  //\n  // \"Already says this\" is content, not bytes: `viewsAgree` performs the\n  // comparison and records the Windows reason for it, beside the generator\n  // that mints the bytes. What gets WRITTEN is unchanged — the LF render, as a\n  // Buffer — so this decode is a comparison only, never the string round trip\n  // to disk that writes.ts forbids; a views file whose bytes are not UTF-8\n  // therefore fails the compare and is regenerated, which is the right answer\n  // for it anyway.\n  const viewsPath = subsystemViewsPath(docsDir);\n  const views = renderSubsystemViews(plannedTree, req.elements);\n  const wanted = views === null ? null : Buffer.from(views, \"utf8\");\n  const onDisk = existsSync(viewsPath) ? await readFile(viewsPath, \"utf8\") : null;\n  if (!viewsAgree(onDisk, views)) writes.push({ path: viewsPath, content: wanted });\n\n  return { writes, services: { created: created.sort(), existing: existing.sort() } };\n}\n"]}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/commands/seed/plan.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What a seed run will write, decided in full before a byte lands. Split from\n * `./commit.ts` on the phase seam: that module owns the WINDOW — the lock, the\n * interrupted-commit recovery, the refusals and the transaction — while\n * this one answers the single question \"given the tree as it is and the fleet\n * file as it reads, which files change and how\". Nothing here acquires\n * anything, and nothing here writes: it is called under the lock and hands\n * back a plan the transaction executes or rolls back whole.\n */\nimport { copyFile, mkdir, mkdtemp, readdir, rm, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join, relative, resolve } from \"node:path\";\nimport { architectureDir, architectureProjectDocuments } from \"../../core/c4/project/architecture.js\";\nimport { loadProject } from \"../../core/c4/project/load.js\";\nimport type { FleetSeed } from \"../../core/c4/seed/fleet-file.js\";\nimport { repoPath } from \"../../core/envelope/json.js\";\nimport { serviceDirOf, type DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport {\n  landscapePath,\n  servicePathsUnder,\n  servicesDir,\n  serviceViewsPath,\n  subsystemPathUnder,\n  subsystemViewsPath,\n  unfiledServicePaths,\n} from \"../../core/repo/paths.js\";\nimport { SUBSYSTEM_MARKER } from \"../../core/repo/tree/marker.js\";\nimport { readGeneratedFile } from \"../../core/repo/tree/render/service/header.js\";\nimport {\n  type MapFacts,\n  renderServiceOverviews,\n  renderSubsystemViews,\n  viewsAgree,\n} from \"../../core/repo/tree/render/views.js\";\nimport type { FleetTree, SubsystemEntry, WalkedService } from \"../../core/repo/tree/walk.js\";\nimport { TEMP_FILE_RE } from \"../../core/staging/commit.js\";\nimport { planWrite, type PlannedWrite } from \"../../core/staging/writes.js\";\n\n/** Everything the plan reads. The commit request extends this and adds only `rerun`. */\nexport interface SeedPlanInput {\n  docsDir: DocsDir;\n  seed: FleetSeed;\n  /** The sealed landscape text (stamp on line 1), already proven to parse. */\n  landscape: string;\n  /**\n   * That same text's parsed facts — the loadSource self-check's output. They\n   * were first reused for the views join on their own, on the reasoning that\n   * the seed template declares no `global` block (`core/c4/seed/template.ts`)\n   * and so the render's style question had the answer \"none\"; true of the\n   * template and beside the point, because `validate --all` recomputes the\n   * expected bytes from the whole `architecture/` PROJECT, and a palette in a\n   * sibling document is in that census (`projectFacts` below carries the\n   * defect). They are now the render's input only when the landscape IS the\n   * whole project — no sibling document exists — and the fallback when the\n   * project does not parse.\n   */\n  map: MapFacts;\n}\n\n/**\n * The facts the generated views are rendered from: the `architecture/` PROJECT\n * as this commit leaves it — the sealed landscape standing in for the file it is\n * about to become, beside every other `.likec4` the directory already holds —\n * and never the sealed landscape alone.\n *\n * WHY THE PROJECT. `subsystem.views-stale` (`validate --all`) and `loam\n * subsystem sync` both recompute the expected bytes from `loadArchitecture` —\n * the landscape merged with every other `architecture/**` document, the\n * generated file excluded — and the render asks that document set which global\n * style ids it declares. A repository's `global { styleGroup subsystems { … } }`\n * naturally lives in a sibling such as `architecture/usecases/palette.likec4`,\n * since seed regenerates the landscape wholesale, so it was in the grader's\n * census and not in seed's: a seed into such a repo wrote a views file the very\n * next `validate --all` — seed's own first `next` command — graded stale, and\n * re-seeding wrote the same bytes again, the one loop no `next` could leave.\n * Reading the same documents the grader reads is what makes the shared render\n * shared in fact rather than in name (commands/subsystem/txn/views.ts's banner).\n *\n * NO SIBLING, NO WORKSPACE: the landscape's own facts, already in hand from the\n * self-check, ARE the project's, and the common case pays one readdir.\n *\n * STAGED, for `core/c4/project/staged.ts`'s reason: `loadProject` copies\n * documents from disk keyed on their path relative to a base, and the landscape\n * here exists only in memory. That module's staging is bound to a feature's\n * merge preview, so the same handful of copies is made here once more — the\n * temp tree is gone before this returns, and nothing under the docs repo is\n * touched.\n *\n * FAIL CLOSED to the landscape's own facts. A project that does not parse (a\n * sibling carrying an error of its own, or a copy the temp directory refused)\n * declares nothing loam can rely on, so the render carries exactly what it\n * carried before the project was asked, and the seed still lands: that sibling\n * is `landscape.invalid`'s to name on the next `validate --all`, and a seed\n * refusing over it would make seed the first command to grade a file it does\n * not own. Nothing is hidden by the fallback: the grader compares the views\n * file only once the project has parsed (`validate/fleet/landscape.ts`), so\n * the repo sees the one finding that names the sibling, never a stale-views\n * finding over a file no command could have rendered differently.\n */\nasync function projectFacts(req: SeedPlanInput): Promise<MapFacts> {\n  const arch = architectureDir(req.docsDir);\n  const landscape = resolve(landscapePath(req.docsDir));\n  // The PROJECT's documents, root `exclude` applied — `loadArchitecture`'s own\n  // list minus the landscape, which is staged from memory just below. Walking\n  // `architecture/` directly skipped that filter, and here that is a WRONG\n  // answer rather than an over-scan: a `palette.likec4` under an excluded path\n  // is a document the renderer never loads, so its `global styleGroup` id put\n  // `global style subsystems` into the generated views file — a name the fleet\n  // project cannot resolve — and the very next `validate --all` (seed's own\n  // `next` command) graded that file against the same set THIS one now reads.\n  // The W5b defect, one command over.\n  const siblings = (await architectureProjectDocuments(req.docsDir)).filter((p) => resolve(p) !== landscape);\n  if (siblings.length === 0) return req.map;\n  // The temp directory is made INSIDE the try, not one line above it: a full\n  // disk, a read-only temp root, or a TMPDIR naming a directory that no longer\n  // exists rejects `mkdtemp`, and outside the try that rejection left `seed` as\n  // the generic `internal` refusal on a repository where nothing is wrong — the\n  // defect docs/CODE-STYLE.md's \"read inside the try that handles the read\" rule\n  // was written from.\n  let root: string | null = null;\n  try {\n    root = await mkdtemp(join(tmpdir(), \"loam-seed-\"));\n    const staged: string[] = [];\n    for (const path of [landscape, ...siblings]) {\n      const dest = join(root, relative(arch, path));\n      await mkdir(dirname(dest), { recursive: true });\n      // The landscape is staged from the bytes this commit writes, never from\n      // the file on disk — which may be the scaffold's stub, a stamped\n      // predecessor, or absent — so the project parsed is the one the grader\n      // will read after the commit.\n      if (path === landscape) await writeFile(dest, req.landscape, \"utf8\");\n      else await copyFile(path, dest);\n      staged.push(dest);\n    }\n    const project = await loadProject(root, staged);\n    // RELATIONSHIPS travel with the elements, and dropping them is silent: they\n    // are what each per-service overview computes its peer set from, so a facts\n    // record without them renders every service view peerless — the service and\n    // its own interior, and nothing it touches — with no error anywhere\n    // (`core/repo/tree/render/views.ts` states the consequence beside the\n    // optional field). The fallback `req.map` is the whole self-check document\n    // and already carries them.\n    return project.clean\n      ? { elements: project.elements, globalStyles: project.globalStyles, relationships: project.relationships }\n      : req.map;\n  } catch {\n    // `loadProject` throws on an error it cannot attribute to a document, and\n    // a full disk fails the staging above; both are the fail-closed arm.\n    return req.map;\n  } finally {\n    if (root !== null) await rm(root, { recursive: true, force: true });\n  }\n}\n\nexport interface SeedPlan {\n  writes: PlannedWrite[];\n  /** Service ids split by whether this run creates the directory. */\n  services: { created: string[]; existing: string[] };\n  /**\n   * Repo-relative paths of the generated views files that hold a document loam\n   * did NOT write — the plan's own refusal, handed to `./commit.ts` rather than\n   * spelled here, because this module decides and never announces.\n   *\n   * Empty on every ordinary run. Non-empty means the whole seed must be refused\n   * before a byte lands: see `stageGenerated`.\n   */\n  authored: string[];\n}\n\n/**\n * Does this existing service directory hold nothing git would keep? An empty\n * directory is a service to the walk but nothing at all to git, so a landscape\n * declaring it clones into a repo where `validate --all` fails on a service\n * that exists only on the author's disk. Seed's own crash window produces\n * exactly this tree — `stageWrites` creates directories before the journal is\n * written, so a kill in between leaves directories no recovery knows about —\n * and so does a plain `mkdir`. Staging temps do not count as content: they are\n * that same crash's litter, not somebody's file.\n */\nasync function keepsNothing(dir: string): Promise<boolean> {\n  try {\n    return (await readdir(dir)).every((entry) => TEMP_FILE_RE.test(entry));\n  } catch {\n    // Unreadable is not empty: the walk found this directory a moment ago, and\n    // inventing a write into a directory we cannot list is the wrong guess.\n    return false;\n  }\n}\n\n/**\n * The complete plan, in memory, before a byte lands: the sealed landscape, one\n * marker per NEW subsystem, one `.gitkeep` per service directory this commit\n * creates — and per existing one holding nothing git would keep (see\n * `keepsNothing`) — and the generated views file rendered from the tree AS\n * THIS COMMIT LEAVES IT, never from a re-walk between two states\n * (commands/subsystem/txn/views.ts's `movedTree` doctrine). That last one is\n * the only write that can be a DELETE: a tree with no subsystems owes no views\n * file, and a leftover is a finding.\n *\n * Existing directories are never moved: fleet.yaml's placement is ignored for\n * a service that already exists — moving is `loam subsystem move <id> --into\n * <name>`'s job, under its own guards — and nothing anywhere is deleted except\n * that one generated file.\n */\nexport async function planSeedWrites(req: SeedPlanInput, tree: FleetTree): Promise<SeedPlan> {\n  const { docsDir, seed } = req;\n  const writes: PlannedWrite[] = [planWrite(landscapePath(docsDir), req.landscape)];\n\n  const existingSubs = new Map(tree.subsystems.map((s) => [s.name, s]));\n  const newSubs: SubsystemEntry[] = [];\n  for (const sub of seed.subsystems) {\n    if (existingSubs.has(sub as string)) continue;\n    const dir = subsystemPathUnder(servicesDir(docsDir), sub);\n    // A comment line parses to null — a valid empty marker (tree/marker.ts).\n    writes.push(planWrite(join(dir, SUBSYSTEM_MARKER), \"# subsystem marker\\n\"));\n    newSubs.push({ name: sub as string, path: [sub as string], dir, meta: {} });\n  }\n\n  const treeDirs = new Map(tree.services.map((s) => [s.id as string, s.dir]));\n  // Every existing directory inspected at once — independent reads, so the\n  // loop below stays synchronous.\n  const invisible = new Map(\n    await Promise.all([...treeDirs].map(async ([id, dir]) => [id, await keepsNothing(dir)] as const)),\n  );\n  const created: string[] = [];\n  const existing: string[] = [];\n  const newWalked: WalkedService[] = [];\n  for (const s of seed.services) {\n    const already = treeDirs.get(s.id as string);\n    if (already !== undefined) {\n      existing.push(s.id);\n      // Existing, but git-invisible: give it the `.gitkeep` a created service\n      // gets, or the landscape about to be written declares a directory the\n      // next clone will not have. `planWrite` makes this a no-op when the file\n      // is already there, so a real service is never touched.\n      if (invisible.get(s.id as string) === true) writes.push(planWrite(join(already, \".gitkeep\"), \"\"));\n      continue;\n    }\n    created.push(s.id);\n    const parent = s.subsystem === null ? null : existingSubs.get(s.subsystem as string) ?? null;\n    const dir =\n      s.subsystem === null\n        ? unfiledServicePaths(docsDir, s.id).dir\n        : parent !== null\n          ? servicePathsUnder(parent.dir, s.id).dir\n          : // A subsystem this same commit creates: the creation spelling,\n            // through the same branded joins the subsystem verbs use.\n            serviceDirOf(join(subsystemPathUnder(servicesDir(docsDir), s.subsystem), s.id));\n    writes.push(planWrite(join(dir, \".gitkeep\"), \"\"));\n    newWalked.push({\n      // A ServiceId IS a RawServiceId (the checked subtype), so no re-cast.\n      id: s.id,\n      dir,\n      subsystem: s.subsystem === null ? [] : parent !== null ? parent.path : [s.subsystem as string],\n    });\n  }\n\n  const plannedTree: FleetTree = {\n    findings: [],\n    services: [...tree.services, ...newWalked],\n    subsystems: [...tree.subsystems, ...newSubs],\n  };\n  // The generated views file, including its ABSENCE. `renderSubsystemViews`\n  // returning null means the tree has no subsystems, and its contract is that\n  // the file must then not exist — `validate` grades a leftover as\n  // `subsystem.views-stale`, so a seed that ignored the file would exit 0 and\n  // send the caller, via its own `next` list, into a failing gate over a file\n  // it had in hand. `content: null` is the delete the transaction understands\n  // (commands/subsystem/txn/txn.ts's `\"removed\"`), and a file that already\n  // SAYS this is left out of the journal entirely rather than written back\n  // over itself.\n  //\n  // \"Already says this\" is content, not bytes: `viewsAgree` performs the\n  // comparison and records the Windows reason for it, beside the generator\n  // that mints the bytes. What gets WRITTEN is unchanged — the LF render, as a\n  // Buffer — so this decode is a comparison only, never the string round trip\n  // to disk that writes.ts forbids; a views file whose bytes are not UTF-8\n  // therefore fails the compare and is regenerated, which is the right answer\n  // for it anyway.\n  //\n  // BOTH generated files, from ONE read of the project: `architecture/services.likec4`\n  // is the same contract one file over — one overview view per service the map\n  // draws, absent when it draws none — and a seed that landed only the subsystem\n  // views would send its caller, through its own `next` list, into a\n  // `subsystem.views-stale` no `seed` could clear. This is where the seeded\n  // services first exist AND the sealed landscape first says what they are, so\n  // it is the only moment the pair can be rendered together.\n  const facts = await projectFacts(req);\n  const authored = [\n    await stageGenerated(writes, subsystemViewsPath(docsDir), renderSubsystemViews(plannedTree, facts)),\n    await stageGenerated(writes, serviceViewsPath(docsDir), renderServiceOverviews(plannedTree, facts)),\n  ].filter((path): path is string => path !== null);\n\n  return {\n    writes,\n    services: { created: created.sort(), existing: existing.sort() },\n    authored: authored.map((path) => repoPath(docsDir, path)),\n  };\n}\n\n/**\n * Append the write for ONE generated file, or nothing when the file already\n * says it — the comparison the block above argues for, spelled once so the two\n * generated files cannot drift into two rules. Answers the path when the file\n * standing there is SOMEBODY ELSE'S, and stages nothing for it.\n *\n * OWNERSHIP FIRST, before the compare, exactly as `commands/subsystem/sync.ts`\n * asks it — through the same reader, from beneath every writer\n * (`core/repo/tree/render/service/header.ts`). Both of these are filenames loam\n * RESERVES inside `architecture/`, a directory the team owns, and seed rewrites\n * them whole; until this line existed a `loam seed` into a repository that kept\n * a hand-authored diagram at one of those paths destroyed it without a word.\n * That is the same promise `seed-landscape-edited` makes one file over — seed\n * never overwrites human work — and it was missing for the two files seed\n * reserves rather than shares.\n *\n * It is checked before the compare and not after, so that \"the file already says\n * this\" can never vouch for a file loam did not write. An authored file cannot\n * in fact agree with a render that opens with loam's mark, but a reader must not\n * have to prove that to know the guard holds.\n */\nasync function stageGenerated(writes: PlannedWrite[], path: string, content: string | null): Promise<string | null> {\n  const { text: onDisk, authored } = await readGeneratedFile(path);\n  if (authored) return path;\n  if (viewsAgree(onDisk, content)) return null;\n  writes.push({ path, content: content === null ? null : Buffer.from(content, \"utf8\") });\n  return null;\n}\n"]}

package/dist/commands/seed/seed.js

@@ -1,10 +1,9 @@
 import { resolve } from "node:path";
-import { loadSource } from "../../core/c4/likec4.js";
+import { errorText, loadSource } from "../../core/c4/likec4.js";
 import { readFleetFile } from "../../core/c4/seed/fleet-file.js";
 import { sealLandscape } from "../../core/c4/seed/stamp.js";
 import { renderLandscape } from "../../core/c4/seed/template.js";
-import { loadConfig } from "../../core/envelope/config.js";
-import { emitJson, emitJsonError, fail, repoPath, reportNoConfig } from "../../core/envelope/json.js";
+import { configOrRefuse, emitJson, emitJsonError, fail, repoPath } from "../../core/envelope/json.js";
 import { NotUtf8Error, readUtf8 } from "../../core/staging/writes.js";
 import { sayRecovered } from "../policy/format.js";
 import { docsRepoReady, reportDocsRepoError } from "../policy/gate.js";
@@ -19,12 +18,10 @@ export function registerSeed(program) {
         .action(async (opts) => {
         const json = opts.json === true;
         const fromArg = opts.from ?? "fleet.yaml";
-        const loaded = await loadConfig();
-        if (loaded.kind !== "loaded") {
-            reportNoConfig(json, loaded);
+        const config = await configOrRefuse(json);
+        if (config === null)
             return;
-        }
-        const { docsDir } = loaded.config;
+        const { docsDir } = config;
         // `services`, not `docs`: every id in fleet.yaml becomes a
         // services/<id>/ directory, and the under-lock preflight enumerates the
         // tree — a run without the directory that IS the fleet is guessing.
@@ -59,19 +56,24 @@ export function registerSeed(program) {
         const seed = read.seed;
         // The self-check: the emitted DSL is parsed in memory BEFORE anything
         // is written, so a templater bug can never land as a broken landscape.
-        // Its parsed elements are reused for the generated views join.
+        // Its parsed document travels to the plan as the landscape's OWN facts —
+        // the render's input when no other `architecture/` document exists, and
+        // the fallback otherwise. It is not the render's whole input: the global
+        // style ids the render asks for are the PROJECT's (the template declares
+        // no `global`, but a sibling document may), which `plan.ts`'s
+        // `projectFacts` reads the way `validate --all` will.
         const sealed = sealLandscape(renderLandscape(seed));
         const doc = await loadSource(sealed);
         const firstError = doc.errors[0];
         if (firstError !== undefined) {
             return fail(json, "internal", `loam's own templater produced a landscape that does not parse — a bug in loam, not ` +
-                `in ${fromArg}; nothing was written. First error: ${firstError.message}`);
+                `in ${fromArg}; nothing was written. First error: ${errorText(firstError)}`);
         }
         const committed = await commitSeed({
             docsDir,
             seed,
             landscape: sealed,
-            elements: doc.elements,
+            map: doc,
             rerun: `loam seed --from ${fromArg}`,
         });
         if (!committed.ok)

package/dist/commands/seed/seed.js.map

@@ -1 +1 @@
-{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../src/commands/seed/seed.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,UAAU,EAA8C,MAAM,aAAa,CAAC;AAOrF,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,sFAAsF,CACvF;SACA,MAAM,CAAC,eAAe,EAAE,uEAAuE,CAAC;SAChG,MAAM,CAAC,QAAQ,EAAE,qDAAqD,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;QAE1C,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;QAClC,2DAA2D;QAC3D,wEAAwE;QACxE,oEAAoE;QACpE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC;YAAE,OAAO;QAEtD,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,YAAY;gBAAE,OAAO,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACrF,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,IAAI,CACT,IAAI,EACJ,mBAAmB,EACnB,GAAG,OAAO,wEAAwE;oBAChF,+EAA+E;oBAC/E,sDAAsD,CACzD,CAAC;YACJ,CAAC;YACD,sEAAsE;YACtE,iEAAiE;YACjE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACxD,OAAO,IAAI,CACT,IAAI,EACJ,mBAAmB,EACnB,GAAG,OAAO,0CAA0C,CAAC,CAAC,OAAO,wBAAwB,CACtF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvB,sEAAsE;QACtE,uEAAuE;QACvE,+DAA+D;QAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CACT,IAAI,EACJ,UAAU,EACV,qFAAqF;gBACnF,MAAM,OAAO,uCAAuC,UAAU,CAAC,OAAO,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC;YACjC,OAAO;YACP,IAAI;YACJ,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,oBAAoB,OAAO,EAAE;SACrC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,EAAE;YAAE,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG;YACX,qBAAqB;YACrB,wBAAwB;YACxB,kEAAkE;YAClE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC;SAChF,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,CAAC;gBACP,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,OAAO;gBAClB,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,OAAO,EAAE,OAAO;gBAChB,OAAO;gBACP,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;gBACvC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;gBACrC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;gBACxB,IAAI;gBACJ,GAAG,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;aAC5E,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YACjF,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,CAAC,GAAG,CACT,iCAAiC,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK;YAC3E,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,gBAAgB,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAkB,OAAO,EAAE,CACtF,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjD,uEAAuE;QACvE,yEAAyE;QACzE,4DAA4D;QAC5D,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;QAC9F,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC7C,0EAA0E;YAC1E,uEAAuE;YACvE,wEAAwE;YACxE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CACT,OAAO,EAAE,4DAA4D;gBACnE,uEAAuE,EAAE,GAAG;gBAC5E,mCAAmC,CACtC,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,kBAAkB,GAAyC;IAC/D,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,kDAAkD;IACnE,WAAW,EAAE,qDAAqD;CACnE,CAAC;AAEF,sFAAsF;AACtF,SAAS,eAAe,CAAC,IAAa,EAAE,OAAwB;IAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,KAAK,mBAAmB;YACtB,OAAO,IAAI,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,KAAK,kBAAkB;YACrB,qEAAqE;YACrE,kEAAkE;YAClE,OAAO,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,iCAAiC;IACjC,MAAM,WAAW,GAAU,OAAO,CAAC;IACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,YAAY,CAAC,IAAa,EAAE,SAA4C;IAC/E,IAAI,UAAU,IAAI,SAAS;QAAE,OAAO,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClF,IAAI,SAAS,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC3C,wEAAwE;QACxE,gDAAgD;QAChD,IAAI,IAAI,EAAE,CAAC;YACT,aAAa,CAAC,mBAAmB,EAAE,SAAS,CAAC,OAAO,EAAE;gBACpD,eAAe,EAAE,SAAS,CAAC,eAAe;aAC3C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC","sourcesContent":["/**\n * `loam seed` — the fleet map's first hour, mechanically: a tiny\n * human-authored fleet.yaml (service ids, optional subsystems, externals and\n * `a -> b` calls) templated into architecture/landscape.likec4 plus one\n * services/<id>/ directory per service, in one journaled transaction.\n *\n * NOT an extractor, deliberately: a human stated every fact in the file —\n * which services exist and who calls whom is the one thing no generator can\n * read off a repository (core/docs.ts's landscape doctrine) — and loam does\n * mechanical templating over those statements, the same category as\n * `loam new`. Seed never overwrites human work: it writes the landscape only\n * when the file is absent, is the scaffold's untouched stub, or carries its\n * own verified line-1 stamp (`core/c4/seed/stamp.ts`); everything else\n * refuses `seed-landscape-edited`.\n */\nimport type { Command } from \"commander\";\nimport { resolve } from \"node:path\";\nimport { loadSource } from \"../../core/c4/likec4.js\";\nimport { readFleetFile, type SeedFileProblem } from \"../../core/c4/seed/fleet-file.js\";\nimport { sealLandscape } from \"../../core/c4/seed/stamp.js\";\nimport { renderLandscape } from \"../../core/c4/seed/template.js\";\nimport { loadConfig } from \"../../core/envelope/config.js\";\nimport { emitJson, emitJsonError, fail, repoPath, reportNoConfig } from \"../../core/envelope/json.js\";\nimport { NotUtf8Error, readUtf8 } from \"../../core/staging/writes.js\";\nimport { sayRecovered } from \"../policy/format.js\";\nimport { docsRepoReady, reportDocsRepoError } from \"../policy/gate.js\";\nimport { serviceTreePathOf } from \"../../core/repo/service-target.js\";\nimport { commitSeed, type LandscapeDisposition, type SeedCommit } from \"./commit.js\";\n\ninterface SeedOptions {\n  from?: string;\n  json?: boolean;\n}\n\nexport function registerSeed(program: Command): void {\n  program\n    .command(\"seed\")\n    .description(\n      \"Template the fleet map and service directories from a tiny human-authored fleet.yaml\",\n    )\n    .option(\"--from <file>\", \"the fleet file to read (default: fleet.yaml in the current directory)\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (opts: SeedOptions) => {\n      const json = opts.json === true;\n      const fromArg = opts.from ?? \"fleet.yaml\";\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`: every id in fleet.yaml becomes a\n      // services/<id>/ directory, and the under-lock preflight enumerates the\n      // tree — a run without the directory that IS the fleet is guessing.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      // The fleet file is INPUT only — read once, from wherever the caller\n      // keeps it (it may legitimately live outside both repos), never stored\n      // and never written back. Refusals name the spelling the caller typed.\n      let text: string;\n      try {\n        text = await readUtf8(resolve(fromArg));\n      } catch (err) {\n        if (err instanceof NotUtf8Error) return fail(json, \"seed-file-invalid\", err.message);\n        const e = err as NodeJS.ErrnoException;\n        if (e.code === \"ENOENT\") {\n          return fail(\n            json,\n            \"seed-file-invalid\",\n            `${fromArg} does not exist — write the fleet file (a services: list of ids, plus ` +\n              `optional subsystems:, externals: and calls: like 'checkout -> payments'), or ` +\n              `point --from at where it lives. Nothing was written.`,\n          );\n        }\n        // An errno is a filesystem answer (EISDIR, EACCES, …) about the named\n        // file; anything without one is a real bug and stays `internal`.\n        if (e.path !== undefined || typeof e.errno === \"number\") {\n          return fail(\n            json,\n            \"seed-file-invalid\",\n            `${fromArg} could not be read as the fleet file — ${e.message}. Nothing was written.`,\n          );\n        }\n        throw err;\n      }\n\n      const read = readFleetFile(text, fromArg);\n      if (!read.ok) return refuseFleetFile(json, read.problem);\n      const seed = read.seed;\n\n      // The self-check: the emitted DSL is parsed in memory BEFORE anything\n      // is written, so a templater bug can never land as a broken landscape.\n      // Its parsed elements are reused for the generated views join.\n      const sealed = sealLandscape(renderLandscape(seed));\n      const doc = await loadSource(sealed);\n      const firstError = doc.errors[0];\n      if (firstError !== undefined) {\n        return fail(\n          json,\n          \"internal\",\n          `loam's own templater produced a landscape that does not parse — a bug in loam, not ` +\n            `in ${fromArg}; nothing was written. First error: ${firstError.message}`,\n        );\n      }\n\n      const committed = await commitSeed({\n        docsDir,\n        seed,\n        landscape: sealed,\n        elements: doc.elements,\n        rerun: `loam seed --from ${fromArg}`,\n      });\n      if (!committed.ok) return refuseCommit(json, committed);\n\n      const written = committed.written.map((w) => repoPath(docsDir, w));\n      const removed = committed.removed.map((w) => repoPath(docsDir, w));\n      const firstCreated = committed.services.created[0];\n      const next = [\n        \"loam validate --all\",\n        \"loam list --needs-work\",\n        // Interpolation is agent-safe: the id already passed the grammar.\n        ...(firstCreated === undefined ? [] : [`loam adopt --service ${firstCreated}`]),\n      ];\n\n      if (json) {\n        emitJson({\n          command: \"seed\",\n          fleetFile: fromArg,\n          landscape: committed.landscape,\n          created: written,\n          removed,\n          services: committed.services,\n          subsystems: [...seed.subsystems].sort(),\n          externals: [...seed.externals].sort(),\n          calls: seed.calls.length,\n          next,\n          ...(committed.recovered === null ? {} : { recovered: committed.recovered }),\n        });\n        return;\n      }\n      if (committed.recovered !== null && committed.recovered.outcome !== \"consistent\") {\n        console.log(`note: ${sayRecovered(committed.recovered)}`);\n      }\n      console.log(\n        `architecture/landscape.likec4 ${LANDSCAPE_SENTENCE[committed.landscape]} — ` +\n          `${seed.services.length} service(s), ${seed.calls.length} call(s), from ${fromArg}`,\n      );\n      for (const w of written) console.log(`  + ${w}`);\n      // Only ever the generated views file, and only when the resulting tree\n      // has no subsystems left to view — but a removal printed as `+` would be\n      // a lie, and an unmentioned one a surprise in `git status`.\n      for (const w of removed) console.log(`  - ${w} (generated, and this tree has no subsystems)`);\n      for (const id of committed.services.existing) {\n        // Spelled from the enumeration, and this line is the one place it matters\n        // most: the sentence is ABOUT placement, so naming the root form would\n        // say \"left exactly where it is\" while pointing at somewhere it is not.\n        const at = await serviceTreePathOf(docsDir, id);\n        console.log(\n          `  = ${at}/ already exists — left exactly where it is (fleet.yaml's ` +\n            `placement is ignored for an existing service; \\`loam subsystem move ${id} ` +\n            `--into <name>\\` is how one moves)`,\n        );\n      }\n      console.log(\"\\nNext:\");\n      for (const n of next) console.log(`  ${n}`);\n    });\n}\n\nconst LANDSCAPE_SENTENCE: Record<LandscapeDisposition, string> = {\n  created: \"created\",\n  \"replaced-stub\": \"written (replaced the scaffold's untouched stub)\",\n  regenerated: \"regenerated (the line-1 stamp proved no hand edits)\",\n};\n\n/** One stable code per problem kind — the mapping the fleet-file union exists for. */\nfunction refuseFleetFile(json: boolean, problem: SeedFileProblem): void {\n  switch (problem.kind) {\n    case \"invalid\":\n      return fail(json, \"seed-file-invalid\", problem.message);\n    case \"duplicate\":\n      return fail(json, \"seed-duplicate-service\", problem.message);\n    case \"unknown-subsystem\":\n      return fail(json, \"seed-unknown-subsystem\", problem.message);\n    case \"unknown-endpoint\":\n      // The existing code, not a fifth new one: the caller's action is the\n      // same as for every other unknown service — fix the name, re-run.\n      return fail(json, \"unknown-service\", problem.message);\n  }\n  // Exhaustiveness checked, not assumed, and the branch is genuinely dead:\n  // without it a fifth `kind` falls out of the switch printing nothing and\n  // leaving `process.exitCode` unset — a refused fleet file exiting 0, which\n  // is the worst answer available.\n  const unreachable: never = problem;\n  throw new Error(`refuseFleetFile: no code for fleet-file problem '${JSON.stringify(unreachable)}'`);\n}\n\nfunction refuseCommit(json: boolean, committed: Exclude<SeedCommit, { ok: true }>): void {\n  if (\"repoGone\" in committed) return reportDocsRepoError(json, committed.repoGone);\n  if (committed.code === \"seed-file-invalid\") {\n    // The exact ids to paste ride as data beside the prose, so an agent can\n    // repair fleet.yaml without parsing a sentence.\n    if (json) {\n      emitJsonError(\"seed-file-invalid\", committed.message, {\n        missingServices: committed.missingServices,\n      });\n      return;\n    }\n    return fail(json, \"seed-file-invalid\", committed.message);\n  }\n  return fail(json, committed.code, committed.message);\n}\n"]}
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../src/commands/seed/seed.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `loam seed` — the fleet map's first hour, mechanically: a tiny\n * human-authored fleet.yaml (service ids, optional subsystems, externals and\n * `a -> b` calls) templated into architecture/landscape.likec4 plus one\n * services/<id>/ directory per service, in one journaled transaction.\n *\n * NOT an extractor, deliberately: a human stated every fact in the file —\n * which services exist and who calls whom is the one thing no generator can\n * read off a repository (core/docs.ts's landscape doctrine) — and loam does\n * mechanical templating over those statements, the same category as\n * `loam new`. Seed never overwrites human work: it writes the landscape only\n * when the file is absent, is the scaffold's untouched stub, or carries its\n * own verified line-1 stamp (`core/c4/seed/stamp.ts`); everything else\n * refuses `seed-landscape-edited`.\n */\nimport type { Command } from \"commander\";\nimport { resolve } from \"node:path\";\nimport { errorText, loadSource } from \"../../core/c4/likec4.js\";\nimport { readFleetFile, type SeedFileProblem } from \"../../core/c4/seed/fleet-file.js\";\nimport { sealLandscape } from \"../../core/c4/seed/stamp.js\";\nimport { renderLandscape } from \"../../core/c4/seed/template.js\";\nimport { configOrRefuse, emitJson, emitJsonError, fail, repoPath } from \"../../core/envelope/json.js\";\nimport { NotUtf8Error, readUtf8 } from \"../../core/staging/writes.js\";\nimport { sayRecovered } from \"../policy/format.js\";\nimport { docsRepoReady, reportDocsRepoError } from \"../policy/gate.js\";\nimport { serviceTreePathOf } from \"../../core/repo/service-target.js\";\nimport { commitSeed, type LandscapeDisposition, type SeedCommit } from \"./commit.js\";\n\ninterface SeedOptions {\n  from?: string;\n  json?: boolean;\n}\n\nexport function registerSeed(program: Command): void {\n  program\n    .command(\"seed\")\n    .description(\n      \"Template the fleet map and service directories from a tiny human-authored fleet.yaml\",\n    )\n    .option(\"--from <file>\", \"the fleet file to read (default: fleet.yaml in the current directory)\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (opts: SeedOptions) => {\n      const json = opts.json === true;\n      const fromArg = opts.from ?? \"fleet.yaml\";\n\n      const config = await configOrRefuse(json);\n      if (config === null) return;\n      const { docsDir } = config;\n      // `services`, not `docs`: every id in fleet.yaml becomes a\n      // services/<id>/ directory, and the under-lock preflight enumerates the\n      // tree — a run without the directory that IS the fleet is guessing.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      // The fleet file is INPUT only — read once, from wherever the caller\n      // keeps it (it may legitimately live outside both repos), never stored\n      // and never written back. Refusals name the spelling the caller typed.\n      let text: string;\n      try {\n        text = await readUtf8(resolve(fromArg));\n      } catch (err) {\n        if (err instanceof NotUtf8Error) return fail(json, \"seed-file-invalid\", err.message);\n        const e = err as NodeJS.ErrnoException;\n        if (e.code === \"ENOENT\") {\n          return fail(\n            json,\n            \"seed-file-invalid\",\n            `${fromArg} does not exist — write the fleet file (a services: list of ids, plus ` +\n              `optional subsystems:, externals: and calls: like 'checkout -> payments'), or ` +\n              `point --from at where it lives. Nothing was written.`,\n          );\n        }\n        // An errno is a filesystem answer (EISDIR, EACCES, …) about the named\n        // file; anything without one is a real bug and stays `internal`.\n        if (e.path !== undefined || typeof e.errno === \"number\") {\n          return fail(\n            json,\n            \"seed-file-invalid\",\n            `${fromArg} could not be read as the fleet file — ${e.message}. Nothing was written.`,\n          );\n        }\n        throw err;\n      }\n\n      const read = readFleetFile(text, fromArg);\n      if (!read.ok) return refuseFleetFile(json, read.problem);\n      const seed = read.seed;\n\n      // The self-check: the emitted DSL is parsed in memory BEFORE anything\n      // is written, so a templater bug can never land as a broken landscape.\n      // Its parsed document travels to the plan as the landscape's OWN facts —\n      // the render's input when no other `architecture/` document exists, and\n      // the fallback otherwise. It is not the render's whole input: the global\n      // style ids the render asks for are the PROJECT's (the template declares\n      // no `global`, but a sibling document may), which `plan.ts`'s\n      // `projectFacts` reads the way `validate --all` will.\n      const sealed = sealLandscape(renderLandscape(seed));\n      const doc = await loadSource(sealed);\n      const firstError = doc.errors[0];\n      if (firstError !== undefined) {\n        return fail(\n          json,\n          \"internal\",\n          `loam's own templater produced a landscape that does not parse — a bug in loam, not ` +\n            `in ${fromArg}; nothing was written. First error: ${errorText(firstError)}`,\n        );\n      }\n\n      const committed = await commitSeed({\n        docsDir,\n        seed,\n        landscape: sealed,\n        map: doc,\n        rerun: `loam seed --from ${fromArg}`,\n      });\n      if (!committed.ok) return refuseCommit(json, committed);\n\n      const written = committed.written.map((w) => repoPath(docsDir, w));\n      const removed = committed.removed.map((w) => repoPath(docsDir, w));\n      const firstCreated = committed.services.created[0];\n      const next = [\n        \"loam validate --all\",\n        \"loam list --needs-work\",\n        // Interpolation is agent-safe: the id already passed the grammar.\n        ...(firstCreated === undefined ? [] : [`loam adopt --service ${firstCreated}`]),\n      ];\n\n      if (json) {\n        emitJson({\n          command: \"seed\",\n          fleetFile: fromArg,\n          landscape: committed.landscape,\n          created: written,\n          removed,\n          services: committed.services,\n          subsystems: [...seed.subsystems].sort(),\n          externals: [...seed.externals].sort(),\n          calls: seed.calls.length,\n          next,\n          ...(committed.recovered === null ? {} : { recovered: committed.recovered }),\n        });\n        return;\n      }\n      if (committed.recovered !== null && committed.recovered.outcome !== \"consistent\") {\n        console.log(`note: ${sayRecovered(committed.recovered)}`);\n      }\n      console.log(\n        `architecture/landscape.likec4 ${LANDSCAPE_SENTENCE[committed.landscape]} — ` +\n          `${seed.services.length} service(s), ${seed.calls.length} call(s), from ${fromArg}`,\n      );\n      for (const w of written) console.log(`  + ${w}`);\n      // Only ever the generated views file, and only when the resulting tree\n      // has no subsystems left to view — but a removal printed as `+` would be\n      // a lie, and an unmentioned one a surprise in `git status`.\n      for (const w of removed) console.log(`  - ${w} (generated, and this tree has no subsystems)`);\n      for (const id of committed.services.existing) {\n        // Spelled from the enumeration, and this line is the one place it matters\n        // most: the sentence is ABOUT placement, so naming the root form would\n        // say \"left exactly where it is\" while pointing at somewhere it is not.\n        const at = await serviceTreePathOf(docsDir, id);\n        console.log(\n          `  = ${at}/ already exists — left exactly where it is (fleet.yaml's ` +\n            `placement is ignored for an existing service; \\`loam subsystem move ${id} ` +\n            `--into <name>\\` is how one moves)`,\n        );\n      }\n      console.log(\"\\nNext:\");\n      for (const n of next) console.log(`  ${n}`);\n    });\n}\n\nconst LANDSCAPE_SENTENCE: Record<LandscapeDisposition, string> = {\n  created: \"created\",\n  \"replaced-stub\": \"written (replaced the scaffold's untouched stub)\",\n  regenerated: \"regenerated (the line-1 stamp proved no hand edits)\",\n};\n\n/** One stable code per problem kind — the mapping the fleet-file union exists for. */\nfunction refuseFleetFile(json: boolean, problem: SeedFileProblem): void {\n  switch (problem.kind) {\n    case \"invalid\":\n      return fail(json, \"seed-file-invalid\", problem.message);\n    case \"duplicate\":\n      return fail(json, \"seed-duplicate-service\", problem.message);\n    case \"unknown-subsystem\":\n      return fail(json, \"seed-unknown-subsystem\", problem.message);\n    case \"unknown-endpoint\":\n      // The existing code, not a fifth new one: the caller's action is the\n      // same as for every other unknown service — fix the name, re-run.\n      return fail(json, \"unknown-service\", problem.message);\n  }\n  // Exhaustiveness checked, not assumed, and the branch is genuinely dead:\n  // without it a fifth `kind` falls out of the switch printing nothing and\n  // leaving `process.exitCode` unset — a refused fleet file exiting 0, which\n  // is the worst answer available.\n  const unreachable: never = problem;\n  throw new Error(`refuseFleetFile: no code for fleet-file problem '${JSON.stringify(unreachable)}'`);\n}\n\nfunction refuseCommit(json: boolean, committed: Exclude<SeedCommit, { ok: true }>): void {\n  if (\"repoGone\" in committed) return reportDocsRepoError(json, committed.repoGone);\n  if (committed.code === \"seed-file-invalid\") {\n    // The exact ids to paste ride as data beside the prose, so an agent can\n    // repair fleet.yaml without parsing a sentence.\n    if (json) {\n      emitJsonError(\"seed-file-invalid\", committed.message, {\n        missingServices: committed.missingServices,\n      });\n      return;\n    }\n    return fail(json, \"seed-file-invalid\", committed.message);\n  }\n  return fail(json, committed.code, committed.message);\n}\n"]}

package/dist/commands/show/feature.js

@@ -22,6 +22,7 @@ import {} from "../../core/c4/likec4.js";
 import { FleetContext } from "../../core/fleet-context.js";
 import {} from "../../core/repo/entries.js";
 import { featurePaths, featureSpecPaths } from "../../core/repo/paths.js";
+import { featureTitle } from "../../core/repo/repo.js";
 import { parseRequirements } from "../../core/document/parse.js";
 import { featureCapabilityDeltas } from "../../core/capabilities/delta/tree.js";
 import { capabilityDeltaSummaries } from "../../core/capabilities/delta/summary.js";
@@ -31,7 +32,8 @@ import { featureStatus } from "../../core/status/feature/feature.js";
 import { executableNext } from "../../core/status/actions/execution.js";
 import { findingJson } from "../../core/vocabulary/report.js";
 import { plural } from "../policy/format.js";
-import { errorText, mark } from "./marks.js";
+import { kindCounts, mark } from "./marks.js";
+import { errorText } from "../../core/c4/likec4.js";
 const REVIEW_INTENT_LIMIT = 1_200;
 function intentSummary(text) {
     const withoutFrontmatter = text.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, "");
@@ -59,9 +61,7 @@ export async function showFeature(docsDir, feature, json, context = new FleetCon
         const reqs = existsSync(specPath) ? parseRequirements(await readFile(specPath, "utf8")) : [];
         services.push({
             id: svc,
-            added: reqs.filter((r) => r.kind === "ADDED").length,
-            modified: reqs.filter((r) => r.kind === "MODIFIED").length,
-            removed: reqs.filter((r) => r.kind === "REMOVED").length,
+            ...kindCounts(reqs),
             operations: [...new Set(reqs.flatMap((r) => r.operations))],
             api: await apiChanges(servicePaths.openapi),
             events: await eventChanges(servicePaths.asyncapi),
@@ -71,6 +71,8 @@ export async function showFeature(docsDir, feature, json, context = new FleetCon
     // feature in a fleet that has not adopted the business axis — the walk's own
     // short-circuit, and the whole cost such a fleet pays for this section.
     const capabilities = await capabilityDeltaSummaries((await featureCapabilityDeltas(feature.dir)).docs, async (path) => parseRequirements(await readFile(path, "utf8")));
+    // intent.md's title, so the header names the change and not only its key.
+    const title = await featureTitle(feature);
     if (json) {
         const status = await featureStatus(docsDir, feature, { context });
         const issues = status.checks.issues.map((finding) => findingJson(finding, { path: status.feature.path, role: "scope" }));
@@ -80,6 +82,8 @@ export async function showFeature(docsDir, feature, json, context = new FleetCon
             command: "show",
             type: "feature",
             id: feature.id,
+            // Additive (core/envelope/json.ts).
+            title,
             dirName: feature.dirName,
             path: repoPath(docsDir, feature.dir),
             archived: feature.archived,
@@ -136,7 +140,7 @@ export async function showFeature(docsDir, feature, json, context = new FleetCon
         return;
     }
     const state = feature.archived ? "archived" : "active";
-    console.log(`${feature.id}   ${repoPath(docsDir, feature.dir)}   ${state}\n`);
+    console.log(`${feature.id}${title === null ? "" : ` · ${title}`}   ${repoPath(docsDir, feature.dir)}   ${state}\n`);
     console.log("  artifacts");
     console.log(`    ${mark(feature.has.intent)} intent.md`);
     const deltaNote = delta.errors.length > 0

package/dist/commands/show/feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../src/commands/show/feature.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One feature as `loam show` presents it: its intent, its delta, the\n * per-service specs under it, and the business promises it changes.\n *\n * Split from `./service.ts` because a service and a feature answer different\n * questions — what a repository holds now, against what a change proposes —\n * and only the service view has to reach the landscape for its edges. The\n * one-line shapes both write in are in `./marks.ts`.\n *\n * THE CAPABILITY SECTION IS NOT DECORATION. Without it a feature carrying only\n * a `features/<FEAT>/capabilities/<id>/spec.md` — a business change with no\n * service touched yet, which is the first thing an analyst writes and what\n * `loam new --capability` scaffolds — displayed as a feature that carries\n * nothing at all, from the command a person runs to find out what a feature\n * carries. The archive would then refuse it (`capability.uncovered`,\n * `scaffold.placeholder`) over documents this view said were not there.\n */\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { emitJson, repoPath } from \"../../core/envelope/json.js\";\nimport { type Elem } from \"../../core/c4/likec4.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { type FeatureEntry } from \"../../core/repo/entries.js\";\nimport { featurePaths, featureSpecPaths } from \"../../core/repo/paths.js\";\nimport { parseRequirements } from \"../../core/document/parse.js\";\nimport { featureCapabilityDeltas } from \"../../core/capabilities/delta/tree.js\";\nimport { capabilityDeltaSummaries } from \"../../core/capabilities/delta/summary.js\";\nimport { apiChanges } from \"../../core/projection/api.js\";\nimport { eventChanges } from \"../../core/projection/events.js\";\nimport { featureStatus } from \"../../core/status/feature/feature.js\";\nimport { executableNext } from \"../../core/status/actions/execution.js\";\nimport { findingJson } from \"../../core/vocabulary/report.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { plural } from \"../policy/format.js\";\nimport { errorText, mark } from \"./marks.js\";\n\nconst REVIEW_INTENT_LIMIT = 1_200;\n\nfunction intentSummary(text: string): string {\n  const withoutFrontmatter = text.replace(/^---\\r?\\n[\\s\\S]*?\\r?\\n---\\r?\\n/, \"\");\n  const prose = withoutFrontmatter\n    .replace(/<!--[\\s\\S]*?-->/g, \"\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"))\n    .join(\" \");\n  return prose.length <= REVIEW_INTENT_LIMIT\n    ? prose\n    : `${prose.slice(0, REVIEW_INTENT_LIMIT - 1).trimEnd()}…`;\n}\n\nexport async function showFeature(\n  docsDir: DocsDir,\n  feature: FeatureEntry,\n  json: boolean,\n  context = new FleetContext(),\n): Promise<void> {\n  const paths = featurePaths(feature.dir);\n  const delta = feature.has.delta\n    ? await context.loadLikeC4(paths.delta)\n    : { errors: [], elements: [] as Elem[], relationships: [] };\n  const taggedEls = delta.elements.filter((e) => e.tags.includes(feature.id));\n  const taggedRels = delta.relationships.filter((r) => r.tags.includes(feature.id));\n\n  const services = [];\n  for (const svc of feature.services) {\n    const servicePaths = featureSpecPaths(feature.dir, svc);\n    const specPath = servicePaths.spec;\n    const reqs = existsSync(specPath) ? parseRequirements(await readFile(specPath, \"utf8\")) : [];\n    services.push({\n      id: svc,\n      added: reqs.filter((r) => r.kind === \"ADDED\").length,\n      modified: reqs.filter((r) => r.kind === \"MODIFIED\").length,\n      removed: reqs.filter((r) => r.kind === \"REMOVED\").length,\n      operations: [...new Set(reqs.flatMap((r) => r.operations))],\n      api: await apiChanges(servicePaths.openapi),\n      events: await eventChanges(servicePaths.asyncapi),\n    });\n  }\n\n  // One `existsSync` for a feature with no capability delta, which is every\n  // feature in a fleet that has not adopted the business axis — the walk's own\n  // short-circuit, and the whole cost such a fleet pays for this section.\n  const capabilities = await capabilityDeltaSummaries(\n    (await featureCapabilityDeltas(feature.dir)).docs,\n    async (path) => parseRequirements(await readFile(path, \"utf8\")),\n  );\n\n  if (json) {\n    const status = await featureStatus(docsDir, feature, { context });\n    const issues = status.checks.issues.map((finding) =>\n      findingJson(finding, { path: status.feature.path, role: \"scope\" }),\n    );\n    const blockers = issues.filter(\n      (finding) => finding[\"severity\"] === \"error\" || finding[\"gates\"] === true,\n    );\n    const intent = existsSync(paths.intent) ? intentSummary(await readFile(paths.intent, \"utf8\")) : \"\";\n    emitJson({\n      command: \"show\",\n      type: \"feature\",\n      id: feature.id,\n      dirName: feature.dirName,\n      path: repoPath(docsDir, feature.dir),\n      archived: feature.archived,\n      has: feature.has,\n      delta: {\n        elements: taggedEls.length,\n        relationships: taggedRels.length,\n        errors: delta.errors.map(errorText),\n      },\n      services,\n      // Additive, which the envelope permits (core/envelope/json.ts), and an\n      // EMPTY ARRAY rather than an omitted key for a feature that carries none:\n      // a consumer indexing it must not have to tell \"no capability delta\" from\n      // \"this loam does not report them\", and the two would be the same absence.\n      capabilities: capabilities.map((c) => ({\n        id: c.id,\n        path: repoPath(docsDir, c.spec),\n        added: c.added,\n        modified: c.modified,\n        removed: c.removed,\n        promises: c.promises,\n      })),\n      review: {\n        readyToArchive: !feature.archived && status.feature.stage === \"done\" && blockers.length === 0,\n        intent: {\n          path: repoPath(docsDir, paths.intent),\n          summary: intent,\n        },\n        architecture: {\n          path: repoPath(docsDir, paths.delta),\n          elements: taggedEls.map((element) => ({\n            id: element.id,\n            kind: element.kind,\n            title: element.title,\n          })),\n          relationships: taggedRels.map((relationship) => ({\n            source: relationship.source,\n            target: relationship.target,\n            title: relationship.title ?? null,\n            operation: relationship.op ?? null,\n          })),\n          errors: delta.errors.map(errorText),\n        },\n        services,\n        dependencies: { blockedBy: status.feature.blockedBy },\n        artifacts: status.artifacts,\n        verification: status.verification,\n        blockers,\n        advisories: issues.filter(\n          (finding) => finding[\"severity\"] === \"warn\" && finding[\"gates\"] !== true,\n        ),\n        useCases: status.useCases,\n        next: status.next.map(executableNext),\n      },\n    });\n    return;\n  }\n\n  const state = feature.archived ? \"archived\" : \"active\";\n  console.log(`${feature.id}   ${repoPath(docsDir, feature.dir)}   ${state}\\n`);\n\n  console.log(\"  artifacts\");\n  console.log(`    ${mark(feature.has.intent)} intent.md`);\n  const deltaNote =\n    delta.errors.length > 0\n      ? `${delta.errors.length} error(s)`\n      : `${plural(taggedEls.length, \"element\")} · ${plural(taggedRels.length, \"relationship\")} tagged ${feature.id}`;\n  console.log(`    ${mark(feature.has.delta)} delta.likec4  ${feature.has.delta ? deltaNote : \"\"}`.trimEnd());\n\n  if (services.length > 0) {\n    console.log(\"\\n  services\");\n    const width = Math.max(...services.map((s) => s.id.length));\n    for (const s of services) {\n      const ops = s.operations.length > 0 ? ` · ${s.operations.join(\", \")}` : \"\";\n      console.log(\n        `    ${s.id.padEnd(width)}  +${s.added} ~${s.modified} -${s.removed} requirements${ops}`,\n      );\n    }\n  }\n\n  // Printed only when the feature carries one: a fleet that has not adopted the\n  // business axis must see nothing, and an empty \"capabilities\" heading over\n  // every feature in every such fleet is exactly the noise that teaches people\n  // to stop reading the output.\n  if (capabilities.length > 0) {\n    console.log(\"\\n  capabilities\");\n    const width = Math.max(...capabilities.map((c) => c.id.length));\n    for (const c of capabilities) {\n      // The promise ids, not just the counts: `Realizes: <capability>#<id>` is\n      // the line somebody has to write next, and the id is the half of it a\n      // reader cannot guess.\n      const ids = c.promises.flatMap((p) => (p.id === null ? [] : [p.id]));\n      console.log(\n        `    ${c.id.padEnd(width)}  +${c.added} ~${c.modified} -${c.removed} promises` +\n          (ids.length === 0 ? \"\" : ` · ${ids.join(\", \")}`),\n      );\n    }\n  }\n\n  if (delta.errors.length > 0) {\n    console.log(\"\\n  delta errors\");\n    for (const e of delta.errors) console.log(`    ✗ ${errorText(e)}`);\n  }\n}\n\n/* ------------------------------------------------------------------ */\n\n/** \"-\" for absent, matching `list`: ✗ is the error glyph here, and a missing runbook is not an error. */\n"]}
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../src/commands/show/feature.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One feature as `loam show` presents it: its intent, its delta, the\n * per-service specs under it, and the business promises it changes.\n *\n * Split from `./service.ts` because a service and a feature answer different\n * questions — what a repository holds now, against what a change proposes —\n * and only the service view has to reach the landscape for its edges. The\n * one-line shapes both write in are in `./marks.ts`.\n *\n * THE CAPABILITY SECTION IS NOT DECORATION. Without it a feature carrying only\n * a `features/<FEAT>/capabilities/<id>/spec.md` — a business change with no\n * service touched yet, which is the first thing an analyst writes and what\n * `loam new --capability` scaffolds — displayed as a feature that carries\n * nothing at all, from the command a person runs to find out what a feature\n * carries. The archive would then refuse it (`capability.uncovered`,\n * `scaffold.placeholder`) over documents this view said were not there.\n */\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { emitJson, repoPath } from \"../../core/envelope/json.js\";\nimport { type Elem } from \"../../core/c4/likec4.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { type FeatureEntry } from \"../../core/repo/entries.js\";\nimport { featurePaths, featureSpecPaths } from \"../../core/repo/paths.js\";\nimport { featureTitle } from \"../../core/repo/repo.js\";\nimport { parseRequirements } from \"../../core/document/parse.js\";\nimport { featureCapabilityDeltas } from \"../../core/capabilities/delta/tree.js\";\nimport { capabilityDeltaSummaries } from \"../../core/capabilities/delta/summary.js\";\nimport { apiChanges } from \"../../core/projection/api.js\";\nimport { eventChanges } from \"../../core/projection/events.js\";\nimport { featureStatus } from \"../../core/status/feature/feature.js\";\nimport { executableNext } from \"../../core/status/actions/execution.js\";\nimport { findingJson } from \"../../core/vocabulary/report.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { plural } from \"../policy/format.js\";\nimport { kindCounts, mark } from \"./marks.js\";\nimport { errorText } from \"../../core/c4/likec4.js\";\n\nconst REVIEW_INTENT_LIMIT = 1_200;\n\nfunction intentSummary(text: string): string {\n  const withoutFrontmatter = text.replace(/^---\\r?\\n[\\s\\S]*?\\r?\\n---\\r?\\n/, \"\");\n  const prose = withoutFrontmatter\n    .replace(/<!--[\\s\\S]*?-->/g, \"\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"))\n    .join(\" \");\n  return prose.length <= REVIEW_INTENT_LIMIT\n    ? prose\n    : `${prose.slice(0, REVIEW_INTENT_LIMIT - 1).trimEnd()}…`;\n}\n\nexport async function showFeature(\n  docsDir: DocsDir,\n  feature: FeatureEntry,\n  json: boolean,\n  context = new FleetContext(),\n): Promise<void> {\n  const paths = featurePaths(feature.dir);\n  const delta = feature.has.delta\n    ? await context.loadLikeC4(paths.delta)\n    : { errors: [], elements: [] as Elem[], relationships: [] };\n  const taggedEls = delta.elements.filter((e) => e.tags.includes(feature.id));\n  const taggedRels = delta.relationships.filter((r) => r.tags.includes(feature.id));\n\n  const services = [];\n  for (const svc of feature.services) {\n    const servicePaths = featureSpecPaths(feature.dir, svc);\n    const specPath = servicePaths.spec;\n    const reqs = existsSync(specPath) ? parseRequirements(await readFile(specPath, \"utf8\")) : [];\n    services.push({\n      id: svc,\n      ...kindCounts(reqs),\n      operations: [...new Set(reqs.flatMap((r) => r.operations))],\n      api: await apiChanges(servicePaths.openapi),\n      events: await eventChanges(servicePaths.asyncapi),\n    });\n  }\n\n  // One `existsSync` for a feature with no capability delta, which is every\n  // feature in a fleet that has not adopted the business axis — the walk's own\n  // short-circuit, and the whole cost such a fleet pays for this section.\n  const capabilities = await capabilityDeltaSummaries(\n    (await featureCapabilityDeltas(feature.dir)).docs,\n    async (path) => parseRequirements(await readFile(path, \"utf8\")),\n  );\n\n  // intent.md's title, so the header names the change and not only its key.\n  const title = await featureTitle(feature);\n\n  if (json) {\n    const status = await featureStatus(docsDir, feature, { context });\n    const issues = status.checks.issues.map((finding) =>\n      findingJson(finding, { path: status.feature.path, role: \"scope\" }),\n    );\n    const blockers = issues.filter(\n      (finding) => finding[\"severity\"] === \"error\" || finding[\"gates\"] === true,\n    );\n    const intent = existsSync(paths.intent) ? intentSummary(await readFile(paths.intent, \"utf8\")) : \"\";\n    emitJson({\n      command: \"show\",\n      type: \"feature\",\n      id: feature.id,\n      // Additive (core/envelope/json.ts).\n      title,\n      dirName: feature.dirName,\n      path: repoPath(docsDir, feature.dir),\n      archived: feature.archived,\n      has: feature.has,\n      delta: {\n        elements: taggedEls.length,\n        relationships: taggedRels.length,\n        errors: delta.errors.map(errorText),\n      },\n      services,\n      // Additive, which the envelope permits (core/envelope/json.ts), and an\n      // EMPTY ARRAY rather than an omitted key for a feature that carries none:\n      // a consumer indexing it must not have to tell \"no capability delta\" from\n      // \"this loam does not report them\", and the two would be the same absence.\n      capabilities: capabilities.map((c) => ({\n        id: c.id,\n        path: repoPath(docsDir, c.spec),\n        added: c.added,\n        modified: c.modified,\n        removed: c.removed,\n        promises: c.promises,\n      })),\n      review: {\n        readyToArchive: !feature.archived && status.feature.stage === \"done\" && blockers.length === 0,\n        intent: {\n          path: repoPath(docsDir, paths.intent),\n          summary: intent,\n        },\n        architecture: {\n          path: repoPath(docsDir, paths.delta),\n          elements: taggedEls.map((element) => ({\n            id: element.id,\n            kind: element.kind,\n            title: element.title,\n          })),\n          relationships: taggedRels.map((relationship) => ({\n            source: relationship.source,\n            target: relationship.target,\n            title: relationship.title ?? null,\n            operation: relationship.op ?? null,\n          })),\n          errors: delta.errors.map(errorText),\n        },\n        services,\n        dependencies: { blockedBy: status.feature.blockedBy },\n        artifacts: status.artifacts,\n        verification: status.verification,\n        blockers,\n        advisories: issues.filter(\n          (finding) => finding[\"severity\"] === \"warn\" && finding[\"gates\"] !== true,\n        ),\n        useCases: status.useCases,\n        next: status.next.map(executableNext),\n      },\n    });\n    return;\n  }\n\n  const state = feature.archived ? \"archived\" : \"active\";\n  console.log(`${feature.id}${title === null ? \"\" : ` · ${title}`}   ${repoPath(docsDir, feature.dir)}   ${state}\\n`);\n\n  console.log(\"  artifacts\");\n  console.log(`    ${mark(feature.has.intent)} intent.md`);\n  const deltaNote =\n    delta.errors.length > 0\n      ? `${delta.errors.length} error(s)`\n      : `${plural(taggedEls.length, \"element\")} · ${plural(taggedRels.length, \"relationship\")} tagged ${feature.id}`;\n  console.log(`    ${mark(feature.has.delta)} delta.likec4  ${feature.has.delta ? deltaNote : \"\"}`.trimEnd());\n\n  if (services.length > 0) {\n    console.log(\"\\n  services\");\n    const width = Math.max(...services.map((s) => s.id.length));\n    for (const s of services) {\n      const ops = s.operations.length > 0 ? ` · ${s.operations.join(\", \")}` : \"\";\n      console.log(\n        `    ${s.id.padEnd(width)}  +${s.added} ~${s.modified} -${s.removed} requirements${ops}`,\n      );\n    }\n  }\n\n  // Printed only when the feature carries one: a fleet that has not adopted the\n  // business axis must see nothing, and an empty \"capabilities\" heading over\n  // every feature in every such fleet is exactly the noise that teaches people\n  // to stop reading the output.\n  if (capabilities.length > 0) {\n    console.log(\"\\n  capabilities\");\n    const width = Math.max(...capabilities.map((c) => c.id.length));\n    for (const c of capabilities) {\n      // The promise ids, not just the counts: `Realizes: <capability>#<id>` is\n      // the line somebody has to write next, and the id is the half of it a\n      // reader cannot guess.\n      const ids = c.promises.flatMap((p) => (p.id === null ? [] : [p.id]));\n      console.log(\n        `    ${c.id.padEnd(width)}  +${c.added} ~${c.modified} -${c.removed} promises` +\n          (ids.length === 0 ? \"\" : ` · ${ids.join(\", \")}`),\n      );\n    }\n  }\n\n  if (delta.errors.length > 0) {\n    console.log(\"\\n  delta errors\");\n    for (const e of delta.errors) console.log(`    ✗ ${errorText(e)}`);\n  }\n}\n\n/* ------------------------------------------------------------------ */\n\n/** \"-\" for absent, matching `list`: ✗ is the error glyph here, and a missing runbook is not an error. */\n"]}

package/dist/commands/show/introduced.js

@@ -0,0 +1,157 @@
+/**
+ * A service an active feature INTRODUCES, as `loam show` presents it: which
+ * feature carries it, the delta documents under that feature's
+ * `specs/<service>/`, what they add, and where a reader goes next.
+ *
+ * Its own view rather than a branch of `./service.ts`, because every line that
+ * view prints is a statement about the LIVING documents — artifact ticks under
+ * `services/<id>/`, a vouch, the fleet map's edges — and for this service each
+ * one would be a false "absent": the directory does not exist yet, by design,
+ * until the feature archives. Until this view existed `loam show` refused the
+ * name outright ("No service or feature"), on the same tree where `loam tasks`
+ * listed work for it, so the newest service in the fleet was the one a reader
+ * could not look up.
+ *
+ * The per-feature counts are `loam show <FEAT>`'s per-service row, read through
+ * the same core projections (`featureSpecPaths`, `apiChanges`, `eventChanges`),
+ * so the two views of one delta cannot disagree about what it adds.
+ */
+import { existsSync } from "node:fs";
+import { emitJson, repoPath } from "../../core/envelope/json.js";
+import { FleetContext } from "../../core/fleet-context.js";
+import {} from "../../core/repo/entries.js";
+import { featureSpecPaths } from "../../core/repo/paths.js";
+import { apiChanges } from "../../core/projection/api.js";
+import { eventChanges } from "../../core/projection/events.js";
+import {} from "../../core/document/spec.js";
+import { plural } from "../policy/format.js";
+import { kindCounts, mark, requirementJson, requirementLine, scenarioCount } from "./marks.js";
+export async function showIntroduced(docsDir, introduced, json, context) {
+    const { id } = introduced;
+    const rows = await Promise.all(introduced.features.map((f) => readIntroduction(f, id, context)));
+    const by = introduced.features.map((f) => f.id).join(", ");
+    if (json) {
+        emitJson({
+            command: "show",
+            type: "service",
+            id,
+            // The marker a consumer branches on, beside the id. It is absent from a
+            // living service's payload rather than `true` there, because that
+            // payload is published and stays byte-identical.
+            living: false,
+            introducedBy: introduced.features.map((f) => f.id),
+            introductions: rows.map((row) => ({
+                feature: row.feature.id,
+                path: repoPath(docsDir, row.paths.dir),
+                has: row.has,
+                // `show <FEAT> --json`'s per-service row, key for key, so a consumer
+                // that reads one reads the other.
+                ...kindCounts(row.reqs),
+                operations: [...new Set(row.reqs.flatMap((r) => r.operations))],
+                api: row.api,
+                events: row.events,
+                // And the living payload's requirement entries, so the delta is
+                // listed exactly as the service will list it once it merges.
+                requirements: row.reqs.map(requirementJson),
+                archSpec: {
+                    requirements: row.archReqs.length,
+                    scenarios: scenarioCount(row.archReqs),
+                    entries: row.archReqs.map(requirementJson),
+                },
+                next: nextCommands(row.feature, id),
+            })),
+        });
+        return;
+    }
+    console.log(`${id}   introduced by ${by} (in flight) — not in the living docs until it archives\n`);
+    rows.forEach((row, i) => {
+        if (i > 0)
+            console.log("");
+        printIntroduction(docsDir, row, id);
+    });
+}
+async function readIntroduction(feature, id, context) {
+    const paths = featureSpecPaths(feature.dir, id);
+    const has = {
+        spec: existsSync(paths.spec),
+        archSpec: existsSync(paths.archSpec),
+        openapi: existsSync(paths.openapi),
+        asyncapi: existsSync(paths.asyncapi),
+    };
+    // The contract projections carry their own readability, so a delta document
+    // that does not parse is said below rather than shown as "no operations".
+    const [reqs, archReqs, api, events] = await Promise.all([
+        has.spec ? context.readRequirements(paths.spec) : [],
+        has.archSpec ? context.readRequirements(paths.archSpec) : [],
+        apiChanges(paths.openapi),
+        eventChanges(paths.asyncapi),
+    ]);
+    return { feature, paths, has, reqs, archReqs, api, events };
+}
+/**
+ * Where a reader goes next: the feature that carries the service, its delta
+ * over it, and the open work on it. Both interpolants are enumeration
+ * spellings — the canonical feature id and the feature's own directory name for
+ * the service — so the printed commands parse.
+ */
+function nextCommands(feature, id) {
+    return [
+        `loam show ${feature.id}`,
+        `loam delta ${feature.id} --service ${id}`,
+        `loam tasks ${feature.id} --service ${id}`,
+    ];
+}
+function printIntroduction(docsDir, row, id) {
+    console.log(`  ${row.feature.id}   ${repoPath(docsDir, row.paths.dir)}`);
+    const specNote = (rs) => {
+        const k = kindCounts(rs);
+        return `+${k.added} ~${k.modified} -${k.removed} requirements · ${plural(scenarioCount(rs), "scenario")}`;
+    };
+    console.log(`    ${mark(row.has.spec)} spec.md         ${row.has.spec ? specNote(row.reqs) : ""}`.trimEnd());
+    console.log(`    ${mark(row.has.archSpec)} arch.spec.md    ${row.has.archSpec ? specNote(row.archReqs) : ""}`.trimEnd());
+    const apiNote = row.api.unreadable ? "does not parse" : plural(row.api.changes.length, "operation");
+    console.log(`    ${mark(row.has.openapi)} openapi.yaml    ${row.has.openapi ? apiNote : ""}`.trimEnd());
+    const eventNote = row.events.unreadable ? "does not read as AsyncAPI 3.0" : plural(row.events.changes.length, "message");
+    console.log(`    ${mark(row.has.asyncapi)} asyncapi.yaml   ${row.has.asyncapi ? eventNote : ""}`.trimEnd());
+    // The kind leads each line: in a delta it is the fact a reviewer reads first,
+    // and a requirement listed here without it would read as one already living.
+    if (row.reqs.length > 0) {
+        console.log("\n    requirements");
+        for (const r of row.reqs)
+            console.log(`      [${r.kind}] ${requirementLine(r)}`);
+    }
+    if (row.archReqs.length > 0) {
+        console.log("\n    arch requirements");
+        for (const r of row.archReqs)
+            console.log(`      [${r.kind}] ${requirementLine(r)}`);
+    }
+    if (row.api.unreadable) {
+        console.log("\n    operations");
+        console.log(`      ✗ openapi.yaml does not parse — nothing here lists what ${row.feature.id} adds to ${id}`);
+        if (row.api.error !== undefined)
+            console.log(`        ${row.api.error}`);
+    }
+    else if (row.api.changes.length > 0) {
+        console.log("\n    operations");
+        for (const op of row.api.changes) {
+            console.log(`      ${op.remove ? "REMOVE " : ""}${op.method} ${op.path}  ${op.operationId}`);
+        }
+    }
+    if (row.events.unreadable) {
+        console.log("\n    events");
+        console.log(`      ✗ asyncapi.yaml does not read as AsyncAPI 3.0 — nothing here lists what ${row.feature.id} adds to ${id}`);
+        if (row.events.error !== undefined)
+            console.log(`        ${row.events.error}`);
+    }
+    else if (row.events.changes.length > 0) {
+        console.log("\n    events");
+        for (const m of row.events.changes) {
+            const direction = m.direction === null ? "" : `${m.direction.toUpperCase()} `;
+            console.log(`      ${m.remove ? "REMOVE " : ""}${direction}${m.message}  (${m.slot})`);
+        }
+    }
+    console.log("\n    next");
+    for (const command of nextCommands(row.feature, id))
+        console.log(`      ${command}`);
+}
+//# sourceMappingURL=introduced.js.map

package/dist/commands/show/introduced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introduced.js","sourceRoot":"","sources":["../../../src/commands/show/introduced.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A service an active feature INTRODUCES, as `loam show` presents it: which\n * feature carries it, the delta documents under that feature's\n * `specs/<service>/`, what they add, and where a reader goes next.\n *\n * Its own view rather than a branch of `./service.ts`, because every line that\n * view prints is a statement about the LIVING documents — artifact ticks under\n * `services/<id>/`, a vouch, the fleet map's edges — and for this service each\n * one would be a false \"absent\": the directory does not exist yet, by design,\n * until the feature archives. Until this view existed `loam show` refused the\n * name outright (\"No service or feature\"), on the same tree where `loam tasks`\n * listed work for it, so the newest service in the fleet was the one a reader\n * could not look up.\n *\n * The per-feature counts are `loam show <FEAT>`'s per-service row, read through\n * the same core projections (`featureSpecPaths`, `apiChanges`, `eventChanges`),\n * so the two views of one delta cannot disagree about what it adds.\n */\nimport { existsSync } from \"node:fs\";\nimport { emitJson, repoPath } from \"../../core/envelope/json.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { type FeatureEntry } from \"../../core/repo/entries.js\";\nimport { featureSpecPaths, type FeatureSpecPaths } from \"../../core/repo/paths.js\";\nimport { apiChanges, type ApiSlice } from \"../../core/projection/api.js\";\nimport { eventChanges, type EventSlice } from \"../../core/projection/events.js\";\nimport { type Requirement } from \"../../core/document/spec.js\";\nimport type { RawServiceId } from \"../../core/kernel/ids/service.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { plural } from \"../policy/format.js\";\nimport { kindCounts, mark, requirementJson, requirementLine, scenarioCount } from \"./marks.js\";\n\nexport interface Introduced {\n  /** The service, as the introducing feature's own `specs/` readdir spelled it. */\n  id: RawServiceId;\n  /** `introducingFeatures`' answer — never empty when this view is reached. */\n  features: FeatureEntry[];\n}\n\n/** One introducing feature's delta over the service, read once for both renderings. */\ninterface Introduction {\n  feature: FeatureEntry;\n  paths: FeatureSpecPaths;\n  has: { spec: boolean; archSpec: boolean; openapi: boolean; asyncapi: boolean };\n  reqs: Requirement[];\n  archReqs: Requirement[];\n  api: ApiSlice;\n  events: EventSlice;\n}\n\nexport async function showIntroduced(\n  docsDir: DocsDir,\n  introduced: Introduced,\n  json: boolean,\n  context: FleetContext,\n): Promise<void> {\n  const { id } = introduced;\n  const rows = await Promise.all(introduced.features.map((f) => readIntroduction(f, id, context)));\n  const by = introduced.features.map((f) => f.id).join(\", \");\n\n  if (json) {\n    emitJson({\n      command: \"show\",\n      type: \"service\",\n      id,\n      // The marker a consumer branches on, beside the id. It is absent from a\n      // living service's payload rather than `true` there, because that\n      // payload is published and stays byte-identical.\n      living: false,\n      introducedBy: introduced.features.map((f) => f.id),\n      introductions: rows.map((row) => ({\n        feature: row.feature.id,\n        path: repoPath(docsDir, row.paths.dir),\n        has: row.has,\n        // `show <FEAT> --json`'s per-service row, key for key, so a consumer\n        // that reads one reads the other.\n        ...kindCounts(row.reqs),\n        operations: [...new Set(row.reqs.flatMap((r) => r.operations))],\n        api: row.api,\n        events: row.events,\n        // And the living payload's requirement entries, so the delta is\n        // listed exactly as the service will list it once it merges.\n        requirements: row.reqs.map(requirementJson),\n        archSpec: {\n          requirements: row.archReqs.length,\n          scenarios: scenarioCount(row.archReqs),\n          entries: row.archReqs.map(requirementJson),\n        },\n        next: nextCommands(row.feature, id),\n      })),\n    });\n    return;\n  }\n\n  console.log(`${id}   introduced by ${by} (in flight) — not in the living docs until it archives\\n`);\n  rows.forEach((row, i) => {\n    if (i > 0) console.log(\"\");\n    printIntroduction(docsDir, row, id);\n  });\n}\n\nasync function readIntroduction(feature: FeatureEntry, id: RawServiceId, context: FleetContext): Promise<Introduction> {\n  const paths = featureSpecPaths(feature.dir, id);\n  const has = {\n    spec: existsSync(paths.spec),\n    archSpec: existsSync(paths.archSpec),\n    openapi: existsSync(paths.openapi),\n    asyncapi: existsSync(paths.asyncapi),\n  };\n  // The contract projections carry their own readability, so a delta document\n  // that does not parse is said below rather than shown as \"no operations\".\n  const [reqs, archReqs, api, events] = await Promise.all([\n    has.spec ? context.readRequirements(paths.spec) : [],\n    has.archSpec ? context.readRequirements(paths.archSpec) : [],\n    apiChanges(paths.openapi),\n    eventChanges(paths.asyncapi),\n  ]);\n  return { feature, paths, has, reqs, archReqs, api, events };\n}\n\n/**\n * Where a reader goes next: the feature that carries the service, its delta\n * over it, and the open work on it. Both interpolants are enumeration\n * spellings — the canonical feature id and the feature's own directory name for\n * the service — so the printed commands parse.\n */\nfunction nextCommands(feature: FeatureEntry, id: RawServiceId): string[] {\n  return [\n    `loam show ${feature.id}`,\n    `loam delta ${feature.id} --service ${id}`,\n    `loam tasks ${feature.id} --service ${id}`,\n  ];\n}\n\nfunction printIntroduction(docsDir: DocsDir, row: Introduction, id: RawServiceId): void {\n  console.log(`  ${row.feature.id}   ${repoPath(docsDir, row.paths.dir)}`);\n  const specNote = (rs: Requirement[]): string => {\n    const k = kindCounts(rs);\n    return `+${k.added} ~${k.modified} -${k.removed} requirements · ${plural(scenarioCount(rs), \"scenario\")}`;\n  };\n  console.log(`    ${mark(row.has.spec)} spec.md         ${row.has.spec ? specNote(row.reqs) : \"\"}`.trimEnd());\n  console.log(`    ${mark(row.has.archSpec)} arch.spec.md    ${row.has.archSpec ? specNote(row.archReqs) : \"\"}`.trimEnd());\n  const apiNote = row.api.unreadable ? \"does not parse\" : plural(row.api.changes.length, \"operation\");\n  console.log(`    ${mark(row.has.openapi)} openapi.yaml    ${row.has.openapi ? apiNote : \"\"}`.trimEnd());\n  const eventNote = row.events.unreadable ? \"does not read as AsyncAPI 3.0\" : plural(row.events.changes.length, \"message\");\n  console.log(`    ${mark(row.has.asyncapi)} asyncapi.yaml   ${row.has.asyncapi ? eventNote : \"\"}`.trimEnd());\n\n  // The kind leads each line: in a delta it is the fact a reviewer reads first,\n  // and a requirement listed here without it would read as one already living.\n  if (row.reqs.length > 0) {\n    console.log(\"\\n    requirements\");\n    for (const r of row.reqs) console.log(`      [${r.kind}] ${requirementLine(r)}`);\n  }\n  if (row.archReqs.length > 0) {\n    console.log(\"\\n    arch requirements\");\n    for (const r of row.archReqs) console.log(`      [${r.kind}] ${requirementLine(r)}`);\n  }\n\n  if (row.api.unreadable) {\n    console.log(\"\\n    operations\");\n    console.log(`      ✗ openapi.yaml does not parse — nothing here lists what ${row.feature.id} adds to ${id}`);\n    if (row.api.error !== undefined) console.log(`        ${row.api.error}`);\n  } else if (row.api.changes.length > 0) {\n    console.log(\"\\n    operations\");\n    for (const op of row.api.changes) {\n      console.log(`      ${op.remove ? \"REMOVE \" : \"\"}${op.method} ${op.path}  ${op.operationId}`);\n    }\n  }\n\n  if (row.events.unreadable) {\n    console.log(\"\\n    events\");\n    console.log(`      ✗ asyncapi.yaml does not read as AsyncAPI 3.0 — nothing here lists what ${row.feature.id} adds to ${id}`);\n    if (row.events.error !== undefined) console.log(`        ${row.events.error}`);\n  } else if (row.events.changes.length > 0) {\n    console.log(\"\\n    events\");\n    for (const m of row.events.changes) {\n      const direction = m.direction === null ? \"\" : `${m.direction.toUpperCase()} `;\n      console.log(`      ${m.remove ? \"REMOVE \" : \"\"}${direction}${m.message}  (${m.slot})`);\n    }\n  }\n\n  console.log(\"\\n    next\");\n  for (const command of nextCommands(row.feature, id)) console.log(`      ${command}`);\n}\n"]}