@ybotok/loam 0.2.0-alpha.6 → 0.2.0-alpha.9

package/dist/commands/new/new.js

@@ -1,20 +1,24 @@
+import { existsSync } from "node:fs";
 import {} from "../../core/staging/writes.js";
 import { commitScaffold } from "./commit.js";
 import { join } from "node:path";
-import { loadConfig } from "../../core/envelope/config.js";
 import { parseFeatureId } from "../../core/kernel/ids/feature.js";
 import { parseServiceIds } from "../../core/kernel/ids/service.js";
-import { emitJson, fail, repoPath, reportNoConfig } from "../../core/envelope/json.js";
+import { configOrRefuse, emitJson, fail, repoPath } from "../../core/envelope/json.js";
 import { UnsafePathError, resolveInside } from "../../core/kernel/path-safety.js";
 import { featureIdFromDirName, nearestIds } from "../../core/repo/entries.js";
-import { featuresDir } from "../../core/repo/paths.js";
+import { featuresDir, landscapePath } from "../../core/repo/paths.js";
+import { loadArchitecture } from "../../core/c4/project/architecture.js";
+import { drawnServiceElements } from "../../core/c4/resolve/service.js";
 import { DocsRepoUnavailableError } from "../../core/repo/state.js";
 import { listServices } from "../../core/repo/repo.js";
 import { docsRepoReady, reportDocsRepoError } from "../policy/gate.js";
 import { sayRecovered } from "../policy/format.js";
 import { capabilityIdProblem } from "../../core/kernel/ids/capability.js";
 import { capabilityNotes } from "../../core/capabilities/authoring/notes.js";
-import { archSpecTemplate, capabilityDeltaTemplate, deltaTemplate, intentTemplate, openapiTemplate, specTemplate, } from "./templates.js";
+import { modifiedFiles, planModifies } from "./modifies.js";
+import { archSpecTemplate, deltaTemplate, intentTemplate, openapiTemplate, specTemplate } from "./templates.js";
+import { capabilityDeltaTemplate } from "./capability-template.js";
 export function registerNew(program) {
     program
         .command("new")
@@ -42,6 +46,9 @@ export function registerNew(program) {
         // promises is as real as a feature touching two services, and the flag that
         // is not repeatable is the one that sends an author to mkdir by hand.
         .option("--capability <id>", "a business capability this feature changes (repeatable)", collect, [])
+        // The small-change lane (./modifies.ts): the living requirement copied
+        // into an uncommented MODIFIED block, pinned at scaffold time.
+        .option("--modifies <Req-ID>", "a living requirement of a --touches service this feature rewrites (repeatable): scaffolds its MODIFIED block, already pinned", collect, [])
         .option("--json", "emit the machine contract instead of the human view")
         .action(async (featureId, opts) => {
         const json = opts.json === true;
@@ -92,12 +99,9 @@ export function registerNew(program) {
             if (problem !== null)
                 return fail(json, "invalid-option", problem);
         }
-        const loaded = await loadConfig();
-        if (loaded.kind !== "loaded") {
-            reportNoConfig(json, loaded);
+        const config = await configOrRefuse(json);
+        if (config === null)
             return;
-        }
-        const config = loaded.config;
         const { docsDir } = config;
         // Before a single file is scaffolded: a docsDir that is not a docs repo is
         // refused, never written into. `features/<id>/**` lands happily in any
@@ -122,13 +126,26 @@ export function registerNew(program) {
         const created = new Set(newServices.ids);
         const touched = touches.ids.filter((s) => !created.has(s));
         const dir = join(featuresDir(docsDir), dirName);
-        const files = {
-            "intent.md": intentTemplate(featureId, opts.title),
-            "delta.likec4": deltaTemplate(featureId, touched, [...created]),
-        };
+        // Resolved before anything is written: an id naming no living
+        // requirement refuses the whole scaffold, as a bad --touches id does.
+        const modifies = await planModifies(docsDir, touched, opts.modifies);
+        if (!modifies.ok)
+            return fail(json, modifies.code, modifies.message);
+        // `--modifies` and nothing else — every touched service has a requirement
+        // rewritten, none is introduced, no promise opened — is a feature that
+        // changes no architecture, and the scaffold's own advice for that case is
+        // "delete delta.likec4". So it is not written; validate and archive read
+        // a requirements-only feature as complete without it.
+        const requirementsOnly = modifies.targets.length > 0 && created.size === 0 && capabilities.length === 0 &&
+            touched.every((svc) => modifies.targets.some((t) => t.service === svc));
+        const files = { "intent.md": intentTemplate(featureId, opts.title) };
+        if (!requirementsOnly) {
+            files["delta.likec4"] = deltaTemplate(featureId, touched, [...created], await drawnIds(docsDir, touched));
+        }
         for (const svc of [...touched, ...created]) {
             files[join("specs", svc, "spec.md")] = specTemplate(featureId, svc);
         }
+        Object.assign(files, modifiedFiles(featureId, modifies.targets, files));
         // The business axis, and the ONE file `--capability` adds. No service
         // spec rides with it, and that is the inversion rather than an omission:
         // the whole point of opening the document that changes first is that the
@@ -218,8 +235,17 @@ export function registerNew(program) {
         console.log(`${featureId} scaffolded at ${repoPath(docsDir, dir)}`);
         for (const w of written)
             console.log(`  + ${w}`);
+        for (const t of modifies.targets)
+            console.log(`  ~ MODIFIED ${t.id}: copied from ${t.living}, Based-On already pinned`);
         for (const note of notes)
             console.log(`\n  note: ${note}`);
+        if (requirementsOnly) {
+            console.log(`\nNext: edit each MODIFIED requirement in place, write intent.md's Why, then\n` +
+                `\`loam validate --feature ${featureId}\` and \`loam archive ${featureId}\`. No delta.likec4 was written:\n` +
+                "rewriting requirements changes no architecture. If this change also moves an element or\n" +
+                "an edge, add one — `loam instructions loam-feature` shows its shape.");
+            return;
+        }
         console.log(`\nNext: fill in the delta, then \`loam validate --feature ${featureId}\`.`);
         console.log("If this feature changes no architecture, delete delta.likec4 — a requirements-only\n" +
             "feature is complete without it, and an empty `model {}` validates clean too.");
@@ -266,6 +292,26 @@ async function unknownServiceNotes(docsDir, touched) {
     }
     return notes;
 }
+/**
+ * The element ids the fleet map already draws the touched services as, so the
+ * delta's context lines reuse them instead of guessing — the delta's own
+ * comment tells the author to reuse the map's identifiers, and it used to
+ * hand them a camel-cased guess that never matched a seeded map's `svc_<id>`.
+ *
+ * Best effort by design: `new` is a scaffolder, not a validator. No map, or
+ * one that does not parse, leaves every id to the seed convention, and
+ * `loam validate` reports the map on its own. The project loader and the
+ * resolver are the ones `loam adopt` reads, so the two commands cannot name
+ * one box two ways.
+ */
+async function drawnIds(docsDir, touched) {
+    if (touched.length === 0 || !existsSync(landscapePath(docsDir)))
+        return new Map();
+    const land = await loadArchitecture(docsDir);
+    if (land.errors.length > 0)
+        return new Map();
+    return drawnServiceElements(land.elements, new Set((await listServices(docsDir)).map((s) => s.id)));
+}
 /* ------------------------------------------------------------------ */
 /* Naming                                                              */
 /* ------------------------------------------------------------------ */
@@ -279,5 +325,4 @@ function slugify(text) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }
-/** A LikeC4 identifier for a service name: `payment-split-service` -> `paymentSplitService`. */
 //# sourceMappingURL=new.js.map

package/dist/commands/new/new.js.map

@@ -1 +1 @@
-{"version":3,"file":"new.js","sourceRoot":"","sources":["../../../src/commands/new/new.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { type PlannedWrite } from \"../../core/staging/writes.js\";\nimport { commitScaffold } from \"./commit.js\";\nimport { join } from \"node:path\";\nimport { loadConfig } from \"../../core/envelope/config.js\";\nimport { type FeatureId, parseFeatureId } from \"../../core/kernel/ids/feature.js\";\nimport { parseServiceIds } from \"../../core/kernel/ids/service.js\";\nimport { emitJson, fail, repoPath, reportNoConfig } from \"../../core/envelope/json.js\";\nimport { UnsafePathError, resolveInside } from \"../../core/kernel/path-safety.js\";\nimport { featureIdFromDirName, nearestIds } from \"../../core/repo/entries.js\";\nimport { featuresDir } from \"../../core/repo/paths.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { listServices } from \"../../core/repo/repo.js\";\nimport { docsRepoReady, reportDocsRepoError } from \"../policy/gate.js\";\nimport { sayRecovered } from \"../policy/format.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { capabilityIdProblem } from \"../../core/kernel/ids/capability.js\";\nimport { capabilityNotes } from \"../../core/capabilities/authoring/notes.js\";\nimport {\n  archSpecTemplate,\n  capabilityDeltaTemplate,\n  deltaTemplate,\n  intentTemplate,\n  openapiTemplate,\n  specTemplate,\n} from \"./templates.js\";\n\ninterface NewOptions {\n  title?: string;\n  touches: string[];\n  newService: string[];\n  capability: string[];\n  json?: boolean;\n}\n\nexport function registerNew(program: Command): void {\n  program\n    .command(\"new\")\n    .argument(\"<featureId>\", \"feature id, e.g. FEAT-101\")\n    .description(\"Scaffold a feature: intent, C4 delta, a requirement delta per service, a capability delta per promise\")\n    .option(\"--title <text>\", \"human title; also becomes the directory slug\")\n    // `--touches`, not `--service`: everywhere else `--service` selects the ONE\n    // operating target (defaulting to config.service), while this is a repeatable\n    // list of services the feature touches — a different arity and a different\n    // meaning deserve a different name.\n    .option(\"--touches <id>\", \"a service this feature touches (repeatable)\", collect, [])\n    .option(\"--new-service <id>\", \"a service this feature introduces (repeatable)\", collect, [])\n    // The INVERSION of the two flags above, and it composes with them rather\n    // than excluding them. `--touches` asks which services change before the\n    // business change has been written; `--capability` opens the document that\n    // changes and lets the service work be derived from it. A feature that\n    // does both — the analyst writes the promise, and one team already knows it\n    // owns part of the mechanism — is an ordinary shape, and refusing the\n    // combination would fight this axis's own archive gate: `capability.uncovered`\n    // refuses a promise nothing in the same feature keeps, so the fix it names\n    // is precisely a `--touches` service's `Realizes:` line living beside the\n    // capability delta.\n    //\n    // Repeatable, like both flags above: a business change that moves two\n    // promises is as real as a feature touching two services, and the flag that\n    // is not repeatable is the one that sends an author to mkdir by hand.\n    .option(\"--capability <id>\", \"a business capability this feature changes (repeatable)\", collect, [])\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (featureId: string, opts: NewOptions) => {\n      const json = opts.json === true;\n\n      // The grammar's verdict arrives as the brand: `featureDirName` demands\n      // a FeatureId, so an argv string cannot reach the directory derivation\n      // without passing through this parse — the producer the brand was\n      // missing while `isFeatureId` narrowed to plain string.\n      const parsedId = parseFeatureId(featureId, \"feature id\");\n      if (!parsedId.ok) {\n        return fail(json, \"invalid-option\", parsedId.problem);\n      }\n      const dirName = featureDirName(parsedId.id, opts.title);\n      // The round-trip is checked beside the grammar, not inside it: the\n      // grammar is a fact about the id, while `featureIdFromDirName` depends on\n      // the TITLE this command is about to slug into the directory name. Only\n      // `new` creates that directory, so only `new` owes that second half.\n      if (featureIdFromDirName(dirName) !== featureId) {\n        return fail(\n          json,\n          \"invalid-option\",\n          `'${featureId}' does not survive the directory round-trip with this title.`,\n        );\n      }\n\n      // Service ids are validated BEFORE the config is even loaded, and long\n      // before anything is written: every one of them is interpolated into\n      // `specs/<id>/` under the new feature directory, so `--touches ../../x`\n      // was a writer pointed outside the docs repo. One grammar (core/kernel/ids/service.ts),\n      // the same one adopt/init/vouch refuse on, so a service that is legal to\n      // create is legal to name here and nowhere the two disagree.\n      // The LIST, not each item: a loop narrows the element and leaves the\n      // array unbranded, so what reached the writer below was `string[]` no\n      // matter how thoroughly each id had been checked. --touches first, so the\n      // id reported first is the one it was before.\n      const touches = parseServiceIds(opts.touches, \"--touches\");\n      if (!touches.ok) return fail(json, \"invalid-option\", touches.problem);\n      const newServices = parseServiceIds(opts.newService, \"--new-service\");\n      if (!newServices.ok) return fail(json, \"invalid-option\", newServices.problem);\n\n      // Same reasoning as the two lists above, one tree over. A capability id\n      // becomes `features/<dirName>/capabilities/<id>/` — a chain of\n      // directories, one per `/`-separated segment — so `--capability\n      // ../../evil` resolves to `features/evil/spec.md`, a directory\n      // `listFeatures` then enumerates as a feature, and one `..` further\n      // reaches the docs-repo root. `resolveInside` below cannot refuse either:\n      // both are still inside the repo. Checked here for that reason, and\n      // against the same directory-name grammar a service id passes\n      // (core/kernel/ids/capability.ts).\n      const capabilities = opts.capability;\n      for (const id of capabilities) {\n        const problem = capabilityIdProblem(id);\n        if (problem !== null) return fail(json, \"invalid-option\", problem);\n      }\n\n      const loaded = await loadConfig();\n      if (loaded.kind !== \"loaded\") {\n        reportNoConfig(json, loaded);\n        return;\n      }\n      const config = loaded.config;\n      const { docsDir } = config;\n      // Before a single file is scaffolded: a docsDir that is not a docs repo is\n      // refused, never written into. `features/<id>/**` lands happily in any\n      // directory, so without this gate `new` reported `ok: true` over a\n      // scaffold that no enumeration downstream will ever see — and a docsDir\n      // that is simply absent escaped as `internal` (the enumeration below\n      // throws) carrying the very sentence `list` and `show` report as\n      // `docs-missing`. See docs-repo-gate.ts's docsRepoReady. `services`, not\n      // `docs`: every id named by --touches/--new-service is a claim about\n      // `services/<id>/`, and the near-miss note below is computed against that\n      // directory, so a run without it is guessing.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      // No unlocked existence fast-path, deliberately: staging creates the\n      // feature directory at plan time, so a HALF-scaffold from a killed run\n      // resolves like a finished feature — and an unlocked refusal here made\n      // \\`loam new <id>\\` answer already-exists over its own wreckage without\n      // ever reaching the recovery that would complete it, while doctor's fix\n      // printed exactly that re-run. Existence is asked once, under the lock,\n      // after recovery has run.\n\n      // A service named both ways is new — that is the more specific claim.\n      const created = new Set(newServices.ids);\n      const touched = touches.ids.filter((s) => !created.has(s));\n      const dir = join(featuresDir(docsDir), dirName);\n\n      const files: Record<string, string> = {\n        \"intent.md\": intentTemplate(featureId, opts.title),\n        \"delta.likec4\": deltaTemplate(featureId, touched, [...created]),\n      };\n      for (const svc of [...touched, ...created]) {\n        files[join(\"specs\", svc, \"spec.md\")] = specTemplate(featureId, svc);\n      }\n      // The business axis, and the ONE file `--capability` adds. No service\n      // spec rides with it, and that is the inversion rather than an omission:\n      // the whole point of opening the document that changes first is that the\n      // services realizing it are not known until the promise is written.\n      // `--touches` is still how a service the author already knows about gets\n      // its delta, which is why the two compose.\n      //\n      // Spelled relative, mirroring `featureCapabilityDeltasDir` +\n      // `capabilityDocPathsAt` in core/repo/authored/paths.ts — the path builders take a\n      // FeatureDir, whose provenance is an enumeration that read the directory,\n      // and this directory is about to be created rather than read. One\n      // directory per segment, exactly as the living tree spells nesting.\n      for (const cap of capabilities) {\n        files[join(\"capabilities\", ...cap.split(\"/\"), \"spec.md\")] = capabilityDeltaTemplate(featureId, cap);\n      }\n      for (const svc of created) {\n        files[join(\"specs\", svc, \"openapi.yaml\")] = openapiTemplate(svc);\n        // The architecture axis is scaffolded only for a service this feature\n        // INTRODUCES, because that is the case where `c4.uncovered` will fire\n        // the moment the delta is written: a brand-new tagged element nothing\n        // covers. Handing an author a blank page for the outbox/retries/alerts\n        // requirement is how that axis stays empty across a whole fleet.\n        files[join(\"specs\", svc, \"arch.spec.md\")] = archSpecTemplate(featureId, svc);\n      }\n\n      // The COMPLETE plan in memory before a byte lands on disk: every path\n      // resolved (belt and braces over the id grammar — resolveInside proves\n      // containment at the moment of the write, symlink cases included), and\n      // every write an exclusive create, because the feature must not exist.\n      // The sequential writeFile loop this replaces could die mid-scaffold and\n      // leave a partial feature the next run refused as already-exists.\n      const writes: PlannedWrite[] = [];\n      for (const [rel, content] of Object.entries(files)) {\n        let path: string;\n        try {\n          path = resolveInside(docsDir, join(\"features\", dirName, rel), \"feature file\");\n        } catch (err) {\n          if (!(err instanceof UnsafePathError)) throw err;\n          return fail(json, \"invalid-option\", err.message);\n        }\n        writes.push({ path, content, exclusive: true });\n      }\n\n      const committed = await commitScaffold(docsDir, featureId, writes);\n      if (!committed.ok) {\n        if (\"repoGone\" in committed) {\n          reportDocsRepoError(json, committed.repoGone);\n          return;\n        }\n        if (committed.code === \"already-exists\") {\n          // After a recovery the refusal must SAY the repair happened: doctor\n          // told the operator to re-run this exact command, and \"already\n          // exists\" alone reads as the fix having failed.\n          return fail(\n            json,\n            \"already-exists\",\n            `Feature '${featureId}' already exists at ${repoPath(docsDir, committed.existing?.dir ?? dir)}.` +\n              (committed.recovered === null ? \"\" : ` (${sayRecovered(committed.recovered)} The scaffold is complete.)`),\n          );\n        }\n        return fail(json, committed.code, committed.message);\n      }\n      const recovered = committed.recovered;\n      const written = writes.map((w) => repoPath(docsDir, w.path));\n\n      // Both note families in ONE list, and the services first so an existing\n      // `--touches` consumer reads the same first element it always did. They\n      // are the same kind of statement — \"the thing you named is not there yet,\n      // and here is what that means\" — so splitting them into two payload keys\n      // would ask a consumer to learn a second shape for one idea.\n      const notes = [\n        ...(await unknownServiceNotes(docsDir, touched)),\n        ...(await capabilityNotes(docsDir, { dirName, ids: capabilities })),\n      ];\n\n      if (json) {\n        emitJson({\n          command: \"new\",\n          feature: featureId,\n          path: repoPath(docsDir, dir),\n          created: written,\n          ...(recovered === null ? {} : { recovered }),\n          // Not an error and not a finding: `--touches` on a service that does\n          // not exist yet is legal (adopt it later, or say `--new-service`),\n          // and `--capability` on a promise nobody has named is the ordinary\n          // way a new business area starts. Both are reported because the\n          // silent alternative is a delta that will never merge into anything,\n          // or a near-miss spelling filed as a second capability.\n          notes,\n        });\n        return;\n      }\n      console.log(`${featureId} scaffolded at ${repoPath(docsDir, dir)}`);\n      for (const w of written) console.log(`  + ${w}`);\n      for (const note of notes) console.log(`\\n  note: ${note}`);\n      console.log(`\\nNext: fill in the delta, then \\`loam validate --feature ${featureId}\\`.`);\n      console.log(\n        \"If this feature changes no architecture, delete delta.likec4 — a requirements-only\\n\" +\n          \"feature is complete without it, and an empty `model {}` validates clean too.\",\n      );\n    });\n}\n\nfunction collect(value: string, previous: string[]): string[] {\n  return [...previous, value];\n}\n\n/* ------------------------------------------------------------------ */\n/* Hints                                                               */\n/* ------------------------------------------------------------------ */\n\n/**\n * `--touches <id>` naming neither a living `services/<id>/` nor a `--new-service`\n * is almost always a typo, and it is silent by construction: the scaffold writes\n * `specs/<id>/spec.md` happily, `loam validate` grades a delta against a living\n * spec that is not there, and the mistake surfaces at archive time as a service\n * appearing from nowhere. A note, not a refusal — naming a service that will be\n * adopted next week is legitimate — but the near-miss is spelled out, because\n * `order-api` vs `orders-api` is exactly the pair a person cannot see.\n */\nasync function unknownServiceNotes(docsDir: DocsDir, touched: string[]): Promise<string[]> {\n  if (touched.length === 0) return [];\n  let known: string[];\n  try {\n    known = (await listServices(docsDir)).map((s) => s.id);\n  } catch (err) {\n    // No docs repo to compare against is a different diagnosis entirely, and\n    // `loam doctor` owns it. Saying nothing here beats inventing a typo hint\n    // out of an enumeration that never ran.\n    if (!(err instanceof DocsRepoUnavailableError)) throw err;\n    return [];\n  }\n  const notes: string[] = [];\n  for (const id of touched) {\n    if (known.includes(id)) continue;\n    const near = nearestIds(id, known);\n    notes.push(\n      `--touches '${id}' matches no services/${id}/ in the docs repo` +\n        (near.length === 0 ? \"\" : ` — did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`) +\n        ` If ${id} is introduced by this feature, pass --new-service ${id} instead.`,\n    );\n  }\n  return notes;\n}\n\n/* ------------------------------------------------------------------ */\n/* Naming                                                              */\n/* ------------------------------------------------------------------ */\n\nfunction featureDirName(featureId: FeatureId, title: string | undefined): string {\n  const slug = slugify(title ?? \"\");\n  return slug ? `${featureId}-${slug}` : featureId;\n}\n\nfunction slugify(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\n/** A LikeC4 identifier for a service name: `payment-split-service` -> `paymentSplitService`. */\n"]}
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../../src/commands/new/new.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { existsSync } from \"node:fs\";\nimport { type PlannedWrite } from \"../../core/staging/writes.js\";\nimport { commitScaffold } from \"./commit.js\";\nimport { join } from \"node:path\";\nimport { type FeatureId, parseFeatureId } from \"../../core/kernel/ids/feature.js\";\nimport { parseServiceIds } from \"../../core/kernel/ids/service.js\";\nimport { configOrRefuse, emitJson, fail, repoPath } from \"../../core/envelope/json.js\";\nimport { UnsafePathError, resolveInside } from \"../../core/kernel/path-safety.js\";\nimport { featureIdFromDirName, nearestIds } from \"../../core/repo/entries.js\";\nimport { featuresDir, landscapePath } from \"../../core/repo/paths.js\";\nimport { loadArchitecture } from \"../../core/c4/project/architecture.js\";\nimport { drawnServiceElements } from \"../../core/c4/resolve/service.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { listServices } from \"../../core/repo/repo.js\";\nimport { docsRepoReady, reportDocsRepoError } from \"../policy/gate.js\";\nimport { sayRecovered } from \"../policy/format.js\";\nimport type { DocsDir } from \"../../core/kernel/ids/dirs.js\";\nimport { capabilityIdProblem } from \"../../core/kernel/ids/capability.js\";\nimport { capabilityNotes } from \"../../core/capabilities/authoring/notes.js\";\nimport { modifiedFiles, planModifies } from \"./modifies.js\";\nimport { archSpecTemplate, deltaTemplate, intentTemplate, openapiTemplate, specTemplate } from \"./templates.js\";\nimport { capabilityDeltaTemplate } from \"./capability-template.js\";\n\ninterface NewOptions {\n  title?: string;\n  touches: string[];\n  newService: string[];\n  capability: string[];\n  modifies: string[];\n  json?: boolean;\n}\n\nexport function registerNew(program: Command): void {\n  program\n    .command(\"new\")\n    .argument(\"<featureId>\", \"feature id, e.g. FEAT-101\")\n    .description(\"Scaffold a feature: intent, C4 delta, a requirement delta per service, a capability delta per promise\")\n    .option(\"--title <text>\", \"human title; also becomes the directory slug\")\n    // `--touches`, not `--service`: everywhere else `--service` selects the ONE\n    // operating target (defaulting to config.service), while this is a repeatable\n    // list of services the feature touches — a different arity and a different\n    // meaning deserve a different name.\n    .option(\"--touches <id>\", \"a service this feature touches (repeatable)\", collect, [])\n    .option(\"--new-service <id>\", \"a service this feature introduces (repeatable)\", collect, [])\n    // The INVERSION of the two flags above, and it composes with them rather\n    // than excluding them. `--touches` asks which services change before the\n    // business change has been written; `--capability` opens the document that\n    // changes and lets the service work be derived from it. A feature that\n    // does both — the analyst writes the promise, and one team already knows it\n    // owns part of the mechanism — is an ordinary shape, and refusing the\n    // combination would fight this axis's own archive gate: `capability.uncovered`\n    // refuses a promise nothing in the same feature keeps, so the fix it names\n    // is precisely a `--touches` service's `Realizes:` line living beside the\n    // capability delta.\n    //\n    // Repeatable, like both flags above: a business change that moves two\n    // promises is as real as a feature touching two services, and the flag that\n    // is not repeatable is the one that sends an author to mkdir by hand.\n    .option(\"--capability <id>\", \"a business capability this feature changes (repeatable)\", collect, [])\n    // The small-change lane (./modifies.ts): the living requirement copied\n    // into an uncommented MODIFIED block, pinned at scaffold time.\n    .option(\n      \"--modifies <Req-ID>\",\n      \"a living requirement of a --touches service this feature rewrites (repeatable): scaffolds its MODIFIED block, already pinned\",\n      collect,\n      [],\n    )\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .action(async (featureId: string, opts: NewOptions) => {\n      const json = opts.json === true;\n\n      // The grammar's verdict arrives as the brand: `featureDirName` demands\n      // a FeatureId, so an argv string cannot reach the directory derivation\n      // without passing through this parse — the producer the brand was\n      // missing while `isFeatureId` narrowed to plain string.\n      const parsedId = parseFeatureId(featureId, \"feature id\");\n      if (!parsedId.ok) {\n        return fail(json, \"invalid-option\", parsedId.problem);\n      }\n      const dirName = featureDirName(parsedId.id, opts.title);\n      // The round-trip is checked beside the grammar, not inside it: the\n      // grammar is a fact about the id, while `featureIdFromDirName` depends on\n      // the TITLE this command is about to slug into the directory name. Only\n      // `new` creates that directory, so only `new` owes that second half.\n      if (featureIdFromDirName(dirName) !== featureId) {\n        return fail(\n          json,\n          \"invalid-option\",\n          `'${featureId}' does not survive the directory round-trip with this title.`,\n        );\n      }\n\n      // Service ids are validated BEFORE the config is even loaded, and long\n      // before anything is written: every one of them is interpolated into\n      // `specs/<id>/` under the new feature directory, so `--touches ../../x`\n      // was a writer pointed outside the docs repo. One grammar (core/kernel/ids/service.ts),\n      // the same one adopt/init/vouch refuse on, so a service that is legal to\n      // create is legal to name here and nowhere the two disagree.\n      // The LIST, not each item: a loop narrows the element and leaves the\n      // array unbranded, so what reached the writer below was `string[]` no\n      // matter how thoroughly each id had been checked. --touches first, so the\n      // id reported first is the one it was before.\n      const touches = parseServiceIds(opts.touches, \"--touches\");\n      if (!touches.ok) return fail(json, \"invalid-option\", touches.problem);\n      const newServices = parseServiceIds(opts.newService, \"--new-service\");\n      if (!newServices.ok) return fail(json, \"invalid-option\", newServices.problem);\n\n      // Same reasoning as the two lists above, one tree over. A capability id\n      // becomes `features/<dirName>/capabilities/<id>/` — a chain of\n      // directories, one per `/`-separated segment — so `--capability\n      // ../../evil` resolves to `features/evil/spec.md`, a directory\n      // `listFeatures` then enumerates as a feature, and one `..` further\n      // reaches the docs-repo root. `resolveInside` below cannot refuse either:\n      // both are still inside the repo. Checked here for that reason, and\n      // against the same directory-name grammar a service id passes\n      // (core/kernel/ids/capability.ts).\n      const capabilities = opts.capability;\n      for (const id of capabilities) {\n        const problem = capabilityIdProblem(id);\n        if (problem !== null) return fail(json, \"invalid-option\", problem);\n      }\n\n      const config = await configOrRefuse(json);\n      if (config === null) return;\n      const { docsDir } = config;\n      // Before a single file is scaffolded: a docsDir that is not a docs repo is\n      // refused, never written into. `features/<id>/**` lands happily in any\n      // directory, so without this gate `new` reported `ok: true` over a\n      // scaffold that no enumeration downstream will ever see — and a docsDir\n      // that is simply absent escaped as `internal` (the enumeration below\n      // throws) carrying the very sentence `list` and `show` report as\n      // `docs-missing`. See docs-repo-gate.ts's docsRepoReady. `services`, not\n      // `docs`: every id named by --touches/--new-service is a claim about\n      // `services/<id>/`, and the near-miss note below is computed against that\n      // directory, so a run without it is guessing.\n      if (!docsRepoReady(json, docsDir, \"services\")) return;\n\n      // No unlocked existence fast-path, deliberately: staging creates the\n      // feature directory at plan time, so a HALF-scaffold from a killed run\n      // resolves like a finished feature — and an unlocked refusal here made\n      // \\`loam new <id>\\` answer already-exists over its own wreckage without\n      // ever reaching the recovery that would complete it, while doctor's fix\n      // printed exactly that re-run. Existence is asked once, under the lock,\n      // after recovery has run.\n\n      // A service named both ways is new — that is the more specific claim.\n      const created = new Set(newServices.ids);\n      const touched = touches.ids.filter((s) => !created.has(s));\n      const dir = join(featuresDir(docsDir), dirName);\n\n      // Resolved before anything is written: an id naming no living\n      // requirement refuses the whole scaffold, as a bad --touches id does.\n      const modifies = await planModifies(docsDir, touched, opts.modifies);\n      if (!modifies.ok) return fail(json, modifies.code, modifies.message);\n      // `--modifies` and nothing else — every touched service has a requirement\n      // rewritten, none is introduced, no promise opened — is a feature that\n      // changes no architecture, and the scaffold's own advice for that case is\n      // \"delete delta.likec4\". So it is not written; validate and archive read\n      // a requirements-only feature as complete without it.\n      const requirementsOnly =\n        modifies.targets.length > 0 && created.size === 0 && capabilities.length === 0 &&\n        touched.every((svc) => modifies.targets.some((t) => t.service === svc));\n\n      const files: Record<string, string> = { \"intent.md\": intentTemplate(featureId, opts.title) };\n      if (!requirementsOnly) {\n        files[\"delta.likec4\"] = deltaTemplate(featureId, touched, [...created], await drawnIds(docsDir, touched));\n      }\n      for (const svc of [...touched, ...created]) {\n        files[join(\"specs\", svc, \"spec.md\")] = specTemplate(featureId, svc);\n      }\n      Object.assign(files, modifiedFiles(featureId, modifies.targets, files));\n      // The business axis, and the ONE file `--capability` adds. No service\n      // spec rides with it, and that is the inversion rather than an omission:\n      // the whole point of opening the document that changes first is that the\n      // services realizing it are not known until the promise is written.\n      // `--touches` is still how a service the author already knows about gets\n      // its delta, which is why the two compose.\n      //\n      // Spelled relative, mirroring `featureCapabilityDeltasDir` +\n      // `capabilityDocPathsAt` in core/repo/authored/paths.ts — the path builders take a\n      // FeatureDir, whose provenance is an enumeration that read the directory,\n      // and this directory is about to be created rather than read. One\n      // directory per segment, exactly as the living tree spells nesting.\n      for (const cap of capabilities) {\n        files[join(\"capabilities\", ...cap.split(\"/\"), \"spec.md\")] = capabilityDeltaTemplate(featureId, cap);\n      }\n      for (const svc of created) {\n        files[join(\"specs\", svc, \"openapi.yaml\")] = openapiTemplate(svc);\n        // The architecture axis is scaffolded only for a service this feature\n        // INTRODUCES, because that is the case where `c4.uncovered` will fire\n        // the moment the delta is written: a brand-new tagged element nothing\n        // covers. Handing an author a blank page for the outbox/retries/alerts\n        // requirement is how that axis stays empty across a whole fleet.\n        files[join(\"specs\", svc, \"arch.spec.md\")] = archSpecTemplate(featureId, svc);\n      }\n\n      // The COMPLETE plan in memory before a byte lands on disk: every path\n      // resolved (belt and braces over the id grammar — resolveInside proves\n      // containment at the moment of the write, symlink cases included), and\n      // every write an exclusive create, because the feature must not exist.\n      // The sequential writeFile loop this replaces could die mid-scaffold and\n      // leave a partial feature the next run refused as already-exists.\n      const writes: PlannedWrite[] = [];\n      for (const [rel, content] of Object.entries(files)) {\n        let path: string;\n        try {\n          path = resolveInside(docsDir, join(\"features\", dirName, rel), \"feature file\");\n        } catch (err) {\n          if (!(err instanceof UnsafePathError)) throw err;\n          return fail(json, \"invalid-option\", err.message);\n        }\n        writes.push({ path, content, exclusive: true });\n      }\n\n      const committed = await commitScaffold(docsDir, featureId, writes);\n      if (!committed.ok) {\n        if (\"repoGone\" in committed) {\n          reportDocsRepoError(json, committed.repoGone);\n          return;\n        }\n        if (committed.code === \"already-exists\") {\n          // After a recovery the refusal must SAY the repair happened: doctor\n          // told the operator to re-run this exact command, and \"already\n          // exists\" alone reads as the fix having failed.\n          return fail(\n            json,\n            \"already-exists\",\n            `Feature '${featureId}' already exists at ${repoPath(docsDir, committed.existing?.dir ?? dir)}.` +\n              (committed.recovered === null ? \"\" : ` (${sayRecovered(committed.recovered)} The scaffold is complete.)`),\n          );\n        }\n        return fail(json, committed.code, committed.message);\n      }\n      const recovered = committed.recovered;\n      const written = writes.map((w) => repoPath(docsDir, w.path));\n\n      // Both note families in ONE list, and the services first so an existing\n      // `--touches` consumer reads the same first element it always did. They\n      // are the same kind of statement — \"the thing you named is not there yet,\n      // and here is what that means\" — so splitting them into two payload keys\n      // would ask a consumer to learn a second shape for one idea.\n      const notes = [\n        ...(await unknownServiceNotes(docsDir, touched)),\n        ...(await capabilityNotes(docsDir, { dirName, ids: capabilities })),\n      ];\n\n      if (json) {\n        emitJson({\n          command: \"new\",\n          feature: featureId,\n          path: repoPath(docsDir, dir),\n          created: written,\n          ...(recovered === null ? {} : { recovered }),\n          // Not an error and not a finding: `--touches` on a service that does\n          // not exist yet is legal (adopt it later, or say `--new-service`),\n          // and `--capability` on a promise nobody has named is the ordinary\n          // way a new business area starts. Both are reported because the\n          // silent alternative is a delta that will never merge into anything,\n          // or a near-miss spelling filed as a second capability.\n          notes,\n        });\n        return;\n      }\n      console.log(`${featureId} scaffolded at ${repoPath(docsDir, dir)}`);\n      for (const w of written) console.log(`  + ${w}`);\n      for (const t of modifies.targets) console.log(`  ~ MODIFIED ${t.id}: copied from ${t.living}, Based-On already pinned`);\n      for (const note of notes) console.log(`\\n  note: ${note}`);\n      if (requirementsOnly) {\n        console.log(\n          `\\nNext: edit each MODIFIED requirement in place, write intent.md's Why, then\\n` +\n            `\\`loam validate --feature ${featureId}\\` and \\`loam archive ${featureId}\\`. No delta.likec4 was written:\\n` +\n            \"rewriting requirements changes no architecture. If this change also moves an element or\\n\" +\n            \"an edge, add one — `loam instructions loam-feature` shows its shape.\",\n        );\n        return;\n      }\n      console.log(`\\nNext: fill in the delta, then \\`loam validate --feature ${featureId}\\`.`);\n      console.log(\n        \"If this feature changes no architecture, delete delta.likec4 — a requirements-only\\n\" +\n          \"feature is complete without it, and an empty `model {}` validates clean too.\",\n      );\n    });\n}\n\nfunction collect(value: string, previous: string[]): string[] {\n  return [...previous, value];\n}\n\n/* ------------------------------------------------------------------ */\n/* Hints                                                               */\n/* ------------------------------------------------------------------ */\n\n/**\n * `--touches <id>` naming neither a living `services/<id>/` nor a `--new-service`\n * is almost always a typo, and it is silent by construction: the scaffold writes\n * `specs/<id>/spec.md` happily, `loam validate` grades a delta against a living\n * spec that is not there, and the mistake surfaces at archive time as a service\n * appearing from nowhere. A note, not a refusal — naming a service that will be\n * adopted next week is legitimate — but the near-miss is spelled out, because\n * `order-api` vs `orders-api` is exactly the pair a person cannot see.\n */\nasync function unknownServiceNotes(docsDir: DocsDir, touched: string[]): Promise<string[]> {\n  if (touched.length === 0) return [];\n  let known: string[];\n  try {\n    known = (await listServices(docsDir)).map((s) => s.id);\n  } catch (err) {\n    // No docs repo to compare against is a different diagnosis entirely, and\n    // `loam doctor` owns it. Saying nothing here beats inventing a typo hint\n    // out of an enumeration that never ran.\n    if (!(err instanceof DocsRepoUnavailableError)) throw err;\n    return [];\n  }\n  const notes: string[] = [];\n  for (const id of touched) {\n    if (known.includes(id)) continue;\n    const near = nearestIds(id, known);\n    notes.push(\n      `--touches '${id}' matches no services/${id}/ in the docs repo` +\n        (near.length === 0 ? \"\" : ` — did you mean ${near.map((n) => `'${n}'`).join(\" or \")}?`) +\n        ` If ${id} is introduced by this feature, pass --new-service ${id} instead.`,\n    );\n  }\n  return notes;\n}\n\n/**\n * The element ids the fleet map already draws the touched services as, so the\n * delta's context lines reuse them instead of guessing — the delta's own\n * comment tells the author to reuse the map's identifiers, and it used to\n * hand them a camel-cased guess that never matched a seeded map's `svc_<id>`.\n *\n * Best effort by design: `new` is a scaffolder, not a validator. No map, or\n * one that does not parse, leaves every id to the seed convention, and\n * `loam validate` reports the map on its own. The project loader and the\n * resolver are the ones `loam adopt` reads, so the two commands cannot name\n * one box two ways.\n */\nasync function drawnIds(docsDir: DocsDir, touched: string[]): Promise<ReadonlyMap<string, string>> {\n  if (touched.length === 0 || !existsSync(landscapePath(docsDir))) return new Map();\n  const land = await loadArchitecture(docsDir);\n  if (land.errors.length > 0) return new Map();\n  return drawnServiceElements(land.elements, new Set((await listServices(docsDir)).map((s) => s.id)));\n}\n\n/* ------------------------------------------------------------------ */\n/* Naming                                                              */\n/* ------------------------------------------------------------------ */\n\nfunction featureDirName(featureId: FeatureId, title: string | undefined): string {\n  const slug = slugify(title ?? \"\");\n  return slug ? `${featureId}-${slug}` : featureId;\n}\n\nfunction slugify(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n"]}

package/dist/commands/new/templates.js

@@ -1,5 +1,6 @@
 /**
- * The six files `loam new` scaffolds, and what each one says.
+ * Five of the six files `loam new` scaffolds, and what each one says. The
+ * sixth, the `--capability` delta, is in `./capability-template.ts`.
  *
  * They are here rather than inline because every one of them is a document a
  * person edits next, and the wording IS the instruction: the delta's comments
@@ -9,20 +10,32 @@
  * file stops parsing.
  */
 import { stringify as stringifyYaml } from "yaml";
-import { REQUIREMENT_ID_RE } from "../../core/document/spec.js";
-import { ARCH_REQUIREMENT_SENTINEL, ARCH_SHALL_SENTINEL, CAPABILITY_REQUIREMENT_SENTINEL, CAPABILITY_SHALL_SENTINEL, REQUIREMENT_SENTINEL, SCENARIO_SENTINEL, SERVICE_DESCRIPTION_SENTINEL, GIVEN_SENTINEL, SHALL_SENTINEL, THEN_SENTINEL, WHEN_SENTINEL, } from "../../core/coherence/authoring/sentinels.js";
-function identifier(name, taken) {
-    const parts = name.split(/[^A-Za-z0-9]+/).filter((p) => p.length > 0);
-    const head = (parts[0] ?? "svc").replace(/^\d+/, "") || "svc";
-    const base = head[0].toLowerCase() +
-        head.slice(1) +
-        parts.slice(1).map((p) => p[0].toUpperCase() + p.slice(1)).join("");
+import { serviceElementId } from "../../core/c4/seed/template.js";
+import { ARCH_REQUIREMENT_SENTINEL, ARCH_SHALL_SENTINEL, REQUIREMENT_SENTINEL, SCENARIO_SENTINEL, SERVICE_DESCRIPTION_SENTINEL, GIVEN_SENTINEL, SHALL_SENTINEL, THEN_SENTINEL, WHEN_SENTINEL, } from "../../core/coherence/authoring/sentinels.js";
+/**
+ * The LikeC4 identifier the delta declares a service under: the id the fleet
+ * map already draws it as (`drawn`), since a context id the map lacks lines up
+ * with nothing at archive, else `serviceElementId` — seed's `svc_<id>`, where
+ * this used to camel-case the name into a third spelling beside the seed's and
+ * the map's. A collision inside one delta takes the seed's `_<n>` suffix.
+ */
+function identifier(name, taken, drawn) {
+    if (drawn !== undefined)
+        return drawn;
+    const base = serviceElementId(name);
     let id = base;
     for (let n = 2; taken.has(id); n += 1)
-        id = `${base}${n}`;
+        id = `${base}_${n}`;
     taken.add(id);
     return id;
 }
+/** One context line. A nested id (`a.b`) is no top-level declaration, so it names its parent instead. */
+function contextLine(id, name) {
+    const dot = id.lastIndexOf(".");
+    if (dot < 0)
+        return `  // ${id} = softwareSystem '${name}'`;
+    return `  // ${id.slice(dot + 1)} = softwareSystem '${name}'  // inside ${id.slice(0, dot)} { }, as the map draws it; edges name it ${id}`;
+}
 /** `FEAT-101` -> `feat_101`: LikeC4 view names take no dashes. */
 function viewName(featureId) {
     return featureId.toLowerCase().replace(/[^a-z0-9]+/g, "_");
@@ -44,6 +57,11 @@ export function intentTemplate(featureId, title) {
     // explicit null, which is a claim ("this feature has no owner") rather than
     // the truth ("nobody has said yet") — and every reader then has to tell an
     // absent key from a null one. The prompt survives as a comment.
+    //
+    // `## Open questions` is where loam-feature's analyze step writes, so it is
+    // scaffolded as a heading over a comment and nothing else. `intent.empty`
+    // (coherence/authoring/scaffold.ts) reads past the whole section, so neither
+    // the untouched comment nor a page of questions counts as the Why.
     const frontmatter = stringifyYaml({ feature: featureId, ...(title === undefined ? {} : { title }), status: "proposed" }, { lineWidth: 0 }).trimEnd();
     return `---
 ${frontmatter}
@@ -60,11 +78,18 @@ ${frontmatter}
 ## Scope
 
 <!-- Which services this touches — and, more usefully, which it deliberately does not. -->
+
+## Open questions
+
+<!-- Optional, never graded. What the documents leave open: an ambiguous SHALL, a value or
+     window two services state differently, an edge with no stated timeout, retry or
+     compensation. A person answers each by editing this section. -->
 `;
 }
-export function deltaTemplate(featureId, touched, created) {
-    const taken = new Set();
-    const touchedIds = touched.map((s) => [identifier(s, taken), s]);
+export function deltaTemplate(featureId, touched, created, drawn = new Map()) {
+    // The map's ids are claimed first: a new service's id never collides with a box quoted as context.
+    const taken = new Set(drawn.values());
+    const touchedIds = touched.map((s) => [identifier(s, taken, drawn.get(s)), s]);
     const createdIds = created.map((s) => [identifier(s, taken), s]);
     const lines = [];
     if (touchedIds.length > 0) {
@@ -75,11 +100,12 @@ export function deltaTemplate(featureId, touched, created) {
         // which teaches people that the validator is noise. Uncomment a line when an
         // edge below actually needs the identifier.
         lines.push("  // Services this feature touches, as context for the diagram. Uncomment the");
-        lines.push("  // ones an edge below names, and reuse the identifiers from");
-        lines.push("  // architecture/landscape.likec4 so the merge lines up. They stay UNTAGGED:");
+        lines.push("  // ones an edge below names. A service the fleet map already draws keeps the");
+        lines.push("  // identifier architecture/ gives it, so the merge lines up; one it does not");
+        lines.push("  // draw yet gets svc_<id>, the convention `loam seed` writes. They stay UNTAGGED:");
         lines.push(`  // only #${featureId} is the change, and everything else here is context.`);
         for (const [id, name] of touchedIds)
-            lines.push(`  // ${id} = softwareSystem '${name}'`);
+            lines.push(contextLine(id, name));
         lines.push("");
     }
     if (createdIds.length > 0) {
@@ -162,10 +188,12 @@ export function specTemplate(featureId, service) {
      A \`Publishes:\` / \`Consumes:\` body line does the same for event messages:
      it names what the requirement puts on or takes off the bus, checked
      against the service's AsyncAPI contract. If ${featureId} changes that
-     contract, hand-create specs/${service}/asyncapi.yaml — a complete
-     AsyncAPI 3.0 document, messages declared under \`components.messages\`
-     (loam scaffolds none: an event contract is genuinely optional) — and run
-     \`loam rebase ${featureId}\` so every restated slot pins as a quote.
+     contract, hand-create specs/${service}/asyncapi.yaml — an AsyncAPI 3.0
+     document holding only the slots this feature adds, changes or removes,
+     messages under \`components.messages\` (loam scaffolds none: an event
+     contract is genuinely optional) — and run \`loam rebase ${featureId}\`
+     when it edits a slot the living contract already has, so that slot pins.
+     The same holds for an openapi.yaml beside this file: only what changes.
 
      Copy the block below out of this comment, unindent it, and replace the
      TODOs and every <angle-bracket> fill-in — \`loam archive\` refuses the
@@ -230,110 +258,6 @@ export function archSpecTemplate(featureId, service) {
 -->
 `;
 }
-/**
- * The BUSINESS axis, scaffolded by `--capability`: a delta against the living
- * `capabilities/<id>/spec.md`.
- *
- * Same idiom as the two spec templates above and for the same reason — the
- * example lives INSIDE an HTML comment, indented past the line-anchored
- * `## ADDED Requirements` / `### Requirement:` patterns core/document/parse.ts
- * matches on — so the scaffold declares nothing until a person copies the block
- * out. That is what lets a freshly scaffolded feature validate clean while
- * still being refused by `loam archive` the moment the block is copied out and
- * left unedited (`scaffold.placeholder`, which reads
- * `features/<FEAT>/capabilities/` as well as `features/<FEAT>/specs/`).
- *
- * WHAT THE COMMENT TEACHES IS THE ALTITUDE, because that is the mistake this
- * document invites. A capability requirement is a promise a customer could
- * check; the four service-scoped lines (`Operations:`, `Covers:`, `Publishes:`,
- * `Consumes:`) and the axis's own two (`Capability:`, `Realizes:`) are all
- * ERRORS here — `capability.requirement-service-scoped` and
- * `capability.requirement-inert-join` — and every one of them parses, so an
- * author who is not told writes one and finds out at archive. `Requirement-ID:`
- * is spelled as mandatory for the same reason: a capability document outlives
- * every service that realizes it, so identity by heading is refused
- * (`capability.requirement-unidentified`).
- *
- * No nested HTML comments, exactly as `specTemplate` states: an inner `-->`
- * would end the outer comment early and re-expose the example to the parser.
- */
-export function capabilityDeltaTemplate(featureId, capability) {
-    return `# ${capability} — capability delta for ${featureId}
-
-<!-- The business axis. This is a DELTA against the living
-     capabilities/${capability}/spec.md, not the document itself: sections are
-     ADDED / MODIFIED / REMOVED, delete the ones you do not need, and a MODIFIED
-     requirement carries its full new text rather than a diff. If the fleet has
-     no capabilities/${capability}/spec.md yet, this feature's archive creates it.
-
-     WHAT BELONGS HERE is a promise somebody outside the fleet could check —
-     'a refund reaches the customer's card within five days'. What does NOT is
-     the mechanism: \`Operations:\`, \`Covers:\`, \`Publishes:\` and \`Consumes:\`
-     all resolve against ONE service's own contract or model, so a requirement
-     carrying one is a service requirement filed at the wrong altitude and
-     \`loam validate\` says so. \`Capability:\` and \`Realizes:\` are refused here
-     too — they are the joins written on the SERVICE requirement that keeps this
-     promise, one directory over in specs/<svc>/spec.md, as
-     \`Realizes: ${capability}#<Requirement-ID>\`.
-
-     \`Requirement-ID:\` is mandatory on every requirement below. A capability
-     document outlives the services that realize it, so its requirements are
-     addressed by a stable id rather than by their heading — rewording a heading
-     would otherwise be a removal and an addition, and every \`Realizes:\` line
-     pointed at it would break in silence.
-
-     A MODIFIED or REMOVED requirement also needs a \`Based-On:\` pin quoting the
-     living text it rewrites, so two features touching one capability collide
-     loudly instead of overwriting each other. Run \`loam rebase ${featureId}\`
-     and the pins are written for you.
-
-     Copy the block below out of this comment, unindent it, and replace the TODO
-     and every <angle-bracket> fill-in — \`loam archive\` refuses the scaffold's
-     own wording (\`scaffold.placeholder\`):
-
-    ## ADDED Requirements
-
-    ### Requirement: ${CAPABILITY_REQUIREMENT_SENTINEL}
-    Requirement-ID: ${idHint(capability)}
-
-    The fleet SHALL ${CAPABILITY_SHALL_SENTINEL}.
-
-    #### Scenario: ${SCENARIO_SENTINEL}
-    - **Given** ${GIVEN_SENTINEL}
-    - **When** ${WHEN_SENTINEL}
-    - **Then** ${THEN_SENTINEL}
--->
-`;
-}
-/**
- * A plausible `Requirement-ID:` for a capability, offered as a shape rather than
- * a name: `payments/refunds` -> `PAYMENTS-REFUNDS-1`.
- *
- * Deliberately NOT the feature id. A service requirement's scaffolded id is
- * `<FEAT>.<svc>.requirement` because that requirement is created by, and lives
- * and dies with, one feature; a capability requirement outlives every feature
- * that touches it, so an id carrying the id of the feature that happened to
- * introduce it is exactly the identity-by-accident this axis refuses. The
- * suffix is `-1` and not a count of anything: it is a placeholder digit inside
- * a placeholder id, and the author is being asked to name the promise.
- *
- * CHECKED AGAINST THE REAL GRAMMAR, never assumed to satisfy it. A capability id
- * may begin with a digit (`3ds`, `2fa`, `1099-filing` — `dirNameHazard` allows an
- * alphanumeric head) while `REQUIREMENT_ID_RE` demands a LETTER, so the obvious
- * slug hands the author `3DS-1` and `loam validate` then refuses it with
- * `delta.requirement-id-invalid` — the author refused for using the shape the
- * scaffold offered. Length is the same class of failure at 128 characters. The
- * fallback prefixes rather than truncates, because a truncated id is a plausible
- * name that means something else.
- */
-function idHint(capability) {
-    const slug = capability.toUpperCase().replace(/[^A-Z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-    const candidate = `${slug}-1`;
-    if (REQUIREMENT_ID_RE.test(candidate))
-        return candidate;
-    const prefixed = `CAP-${candidate}`;
-    return REQUIREMENT_ID_RE.test(prefixed) ? prefixed : "CAP-1";
-}
 export function openapiTemplate(service) {
     return `openapi: 3.1.0
 info:

package/dist/commands/new/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/new/templates.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The six files `loam new` scaffolds, and what each one says.\n *\n * They are here rather than inline because every one of them is a document a\n * person edits next, and the wording IS the instruction: the delta's comments\n * teach the grammar `core/document/parse.ts` matches on, and the intent's\n * frontmatter is serialized rather than interpolated because a title is free\n * text somebody types — `Checkout: split payments` reopens the mapping and the\n * file stops parsing.\n */\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { REQUIREMENT_ID_RE } from \"../../core/document/spec.js\";\nimport {\n  ARCH_REQUIREMENT_SENTINEL,\n  ARCH_SHALL_SENTINEL,\n  CAPABILITY_REQUIREMENT_SENTINEL,\n  CAPABILITY_SHALL_SENTINEL,\n  REQUIREMENT_SENTINEL,\n  SCENARIO_SENTINEL,\n  SERVICE_DESCRIPTION_SENTINEL,\n  GIVEN_SENTINEL,\n  SHALL_SENTINEL,\n  THEN_SENTINEL,\n  WHEN_SENTINEL,\n} from \"../../core/coherence/authoring/sentinels.js\";\n\nfunction identifier(name: string, taken: Set<string>): string {\n  const parts = name.split(/[^A-Za-z0-9]+/).filter((p) => p.length > 0);\n  const head = (parts[0] ?? \"svc\").replace(/^\\d+/, \"\") || \"svc\";\n  const base =\n    head[0]!.toLowerCase() +\n    head.slice(1) +\n    parts.slice(1).map((p) => p[0]!.toUpperCase() + p.slice(1)).join(\"\");\n  let id = base;\n  for (let n = 2; taken.has(id); n += 1) id = `${base}${n}`;\n  taken.add(id);\n  return id;\n}\n\n/** `FEAT-101` -> `feat_101`: LikeC4 view names take no dashes. */\nfunction viewName(featureId: string): string {\n  return featureId.toLowerCase().replace(/[^a-z0-9]+/g, \"_\");\n}\n\n/* ------------------------------------------------------------------ */\n/* Templates                                                           */\n/* ------------------------------------------------------------------ */\n\nexport function intentTemplate(featureId: string, title: string | undefined): string {\n  const heading = title ?? featureId;\n  // The frontmatter is SERIALIZED, never interpolated. A title is free text a\n  // person types — `Checkout: split payments` used to be pasted straight after\n  // `title: `, where the colon reopens the mapping and the file stops parsing;\n  // `Orders #42 rework` lost everything from the `#` as a YAML comment, so the\n  // feature quietly answered to a title nobody wrote. The yaml serializer is the\n  // only thing that knows every case, and it is already how migrate-openspec\n  // writes the same three keys.\n  //\n  // `owner` is deliberately NOT a key here. Scaffolding `owner:` writes an\n  // explicit null, which is a claim (\"this feature has no owner\") rather than\n  // the truth (\"nobody has said yet\") — and every reader then has to tell an\n  // absent key from a null one. The prompt survives as a comment.\n  const frontmatter = stringifyYaml(\n    { feature: featureId, ...(title === undefined ? {} : { title }), status: \"proposed\" },\n    { lineWidth: 0 },\n  ).trimEnd();\n  return `---\n${frontmatter}\n# owner: <the team or person who answers for this>\n---\n\n# ${heading}\n\n## Why\n\n<!-- The problem in business terms. This is what a reviewer reads first, and what\n     the requirement deltas below have to be justified by. -->\n\n## Scope\n\n<!-- Which services this touches — and, more usefully, which it deliberately does not. -->\n`;\n}\n\nexport function deltaTemplate(featureId: string, touched: string[], created: string[]): string {\n  const taken = new Set<string>();\n  const touchedIds = touched.map((s) => [identifier(s, taken), s] as const);\n  const createdIds = created.map((s) => [identifier(s, taken), s] as const);\n\n  const lines: string[] = [];\n  if (touchedIds.length > 0) {\n    // Context elements ship COMMENTED OUT, exactly like the example edge below.\n    // Declared-and-untagged is the one shape `delta.nothing-tagged` exists to\n    // refuse (an author who forgot the tags), so writing these live made every\n    // `loam new --touches X` fail its own validator on the very first run —\n    // which teaches people that the validator is noise. Uncomment a line when an\n    // edge below actually needs the identifier.\n    lines.push(\"  // Services this feature touches, as context for the diagram. Uncomment the\");\n    lines.push(\"  // ones an edge below names, and reuse the identifiers from\");\n    lines.push(\"  // architecture/landscape.likec4 so the merge lines up. They stay UNTAGGED:\");\n    lines.push(`  // only #${featureId} is the change, and everything else here is context.`);\n    for (const [id, name] of touchedIds) lines.push(`  // ${id} = softwareSystem '${name}'`);\n    lines.push(\"\");\n  }\n  if (createdIds.length > 0) {\n    lines.push(\"  // Services this feature introduces. The tag is what `loam archive` folds\");\n    lines.push(\"  // into the living landscape.\");\n    for (const [id, name] of createdIds) {\n      lines.push(`  ${id} = softwareSystem '${name}' {`);\n      lines.push(`    #${featureId}`);\n      // Interpolated from sentinels.ts, never spelled here: the placeholder\n      // gate refuses this exact string at archive, and a second spelling is\n      // how a template rewording silently retires the check that guards it.\n      lines.push(`    description '${SERVICE_DESCRIPTION_SENTINEL}'`);\n      lines.push(\"  }\");\n    }\n    lines.push(\"\");\n  }\n\n  // The example edge uses identifiers already declared above when there are two\n  // to join; otherwise placeholders, so it never invents a service.\n  const from = touchedIds[0]?.[0] ?? createdIds[0]?.[0] ?? \"consumer\";\n  const to = createdIds[0]?.[0] ?? touchedIds[1]?.[0] ?? \"provider\";\n  lines.push(\"  // New calls. `metadata { op }` is the spine: it names the OpenAPI operationId\");\n  lines.push(\"  // the call uses, and `loam validate` checks it against the target's contract.\");\n  lines.push(\"  // Uncomment and adjust (both endpoints have to be declared above):\");\n  lines.push(\"  //\");\n  lines.push(`  // ${from} -> ${to} 'Calls createSplit' {`);\n  lines.push(`  //   #${featureId}`);\n  lines.push(\"  //   metadata { op 'createSplit' }\");\n  lines.push(\"  // }\");\n\n  return `// ${featureId} — architecture delta.\n//\n// Everything tagged #${featureId} is exactly what \\`loam archive\\` folds into\n// architecture/landscape.likec4. Everything else here is context for the diagram.\n//\n// If ${featureId} changes no architecture, DELETE this file: a requirements-only\n// feature is complete without it, and an empty \\`model {}\\` is just as legal.\n\nspecification {\n  element softwareSystem\n  tag ${featureId}\n}\n\nmodel {\n${lines.join(\"\\n\")}\n}\n\nviews {\n  view ${viewName(featureId)} {\n    include *\n  }\n}\n`;\n}\n\n/**\n * The business axis, scaffolded with its example INSIDE the comment — the same\n * mechanism as `archSpecTemplate` below, for the same reason: this template\n * used to ship a live `### Requirement: TODO — name the behaviour` that\n * parsed as a real requirement, validated clean, and archived a literal TODO\n * into the living spec at exit 0. The indented headings sit past the\n * line-anchored patterns core/document/parse.ts matches on, so the scaffold\n * declares nothing until a person copies the block out and writes over the\n * fill-ins — and `scaffold.placeholder` gates the archive if the fill-ins\n * survive the copy.\n *\n * No nested HTML comments: the `Operations:` guidance that used to be its own\n * comment lives in this one's prose, because an inner `-->` would end the\n * outer comment early and re-expose the example to the parser.\n */\nexport function specTemplate(featureId: string, service: string): string {\n  return `# ${service} — requirement delta for ${featureId}\n\n<!-- Sections: ADDED / MODIFIED / REMOVED. Delete the ones you do not need.\n     A MODIFIED requirement carries its full new text, not a diff.\n     Every requirement needs at least one scenario — \\`loam validate\\` gates on it.\n\n     An \\`Operations:\\` body line names the operationIds the requirement\n     governs. \\`loam validate\\` checks each one against the service's OpenAPI,\n     and \\`loam archive\\` refuses to merge a requirement that governs an\n     operation nobody defines — add the line once the contract exists.\n\n     A \\`Publishes:\\` / \\`Consumes:\\` body line does the same for event messages:\n     it names what the requirement puts on or takes off the bus, checked\n     against the service's AsyncAPI contract. If ${featureId} changes that\n     contract, hand-create specs/${service}/asyncapi.yaml — a complete\n     AsyncAPI 3.0 document, messages declared under \\`components.messages\\`\n     (loam scaffolds none: an event contract is genuinely optional) — and run\n     \\`loam rebase ${featureId}\\` so every restated slot pins as a quote.\n\n     Copy the block below out of this comment, unindent it, and replace the\n     TODOs and every <angle-bracket> fill-in — \\`loam archive\\` refuses the\n     scaffold's own wording (\\`scaffold.placeholder\\`):\n\n    ## ADDED Requirements\n\n    ### Requirement: ${REQUIREMENT_SENTINEL}\n    Requirement-ID: ${featureId}.${service}.requirement\n\n    The service SHALL ${SHALL_SENTINEL}.\n\n    #### Scenario: ${SCENARIO_SENTINEL}\n    - **Given** ${GIVEN_SENTINEL}\n    - **When** ${WHEN_SENTINEL}\n    - **Then** ${THEN_SENTINEL}\n-->\n`;\n}\n\n/**\n * The architecture axis, scaffolded EMPTY on purpose.\n *\n * Same grammar as spec.md, so the template body has to be unparseable as\n * requirements or the scaffold would ship a requirement nobody wrote — the\n * headings are therefore indented inside an HTML comment, which puts them past\n * the line-anchored `## ADDED Requirements` / `### Requirement:` patterns\n * core/document/parse.ts matches on. Copy the block out of the comment and unindent it.\n */\nexport function archSpecTemplate(featureId: string, service: string): string {\n  return `# ${service} — architecture requirement delta for ${featureId}\n\n<!-- The architecture axis: the obligations no business scenario was ever going\n     to mention — the outbox, the retries, the timeouts, the alerts.\n\n     \\`Covers:\\` is to an arch requirement what \\`Operations:\\` is to a business\n     one — it names the MODEL OBJECTS the scenarios below exercise, so coverage\n     is derived instead of trusted. Three forms, comma-separated:\n\n       Covers: ${service}                 a C4 element — its id, or the service a\n                                          bound/titled element stands for\n       Covers: consumer -> ${service}     an edge, each side resolved the same way\n       Covers: alert:<id>, sli:<id>       a signal declared in health.yaml\n\n     Every tagged element and edge in delta.likec4 wants one (\\`c4.uncovered\\`).\n     Delete this file if ${featureId} adds no architectural obligation.\n\n     Copy the block below out of this comment and unindent it:\n\n    ## ADDED Requirements\n\n    ### Requirement: ${ARCH_REQUIREMENT_SENTINEL}\n    Requirement-ID: ${featureId}.${service}.arch\n\n    The service SHALL ${ARCH_SHALL_SENTINEL}.\n\n    Covers: ${service}\n\n    #### Scenario: ${SCENARIO_SENTINEL}\n    - **Given** ${GIVEN_SENTINEL}\n    - **When** ${WHEN_SENTINEL}\n    - **Then** ${THEN_SENTINEL}\n-->\n`;\n}\n\n/**\n * The BUSINESS axis, scaffolded by `--capability`: a delta against the living\n * `capabilities/<id>/spec.md`.\n *\n * Same idiom as the two spec templates above and for the same reason — the\n * example lives INSIDE an HTML comment, indented past the line-anchored\n * `## ADDED Requirements` / `### Requirement:` patterns core/document/parse.ts\n * matches on — so the scaffold declares nothing until a person copies the block\n * out. That is what lets a freshly scaffolded feature validate clean while\n * still being refused by `loam archive` the moment the block is copied out and\n * left unedited (`scaffold.placeholder`, which reads\n * `features/<FEAT>/capabilities/` as well as `features/<FEAT>/specs/`).\n *\n * WHAT THE COMMENT TEACHES IS THE ALTITUDE, because that is the mistake this\n * document invites. A capability requirement is a promise a customer could\n * check; the four service-scoped lines (`Operations:`, `Covers:`, `Publishes:`,\n * `Consumes:`) and the axis's own two (`Capability:`, `Realizes:`) are all\n * ERRORS here — `capability.requirement-service-scoped` and\n * `capability.requirement-inert-join` — and every one of them parses, so an\n * author who is not told writes one and finds out at archive. `Requirement-ID:`\n * is spelled as mandatory for the same reason: a capability document outlives\n * every service that realizes it, so identity by heading is refused\n * (`capability.requirement-unidentified`).\n *\n * No nested HTML comments, exactly as `specTemplate` states: an inner `-->`\n * would end the outer comment early and re-expose the example to the parser.\n */\nexport function capabilityDeltaTemplate(featureId: string, capability: string): string {\n  return `# ${capability} — capability delta for ${featureId}\n\n<!-- The business axis. This is a DELTA against the living\n     capabilities/${capability}/spec.md, not the document itself: sections are\n     ADDED / MODIFIED / REMOVED, delete the ones you do not need, and a MODIFIED\n     requirement carries its full new text rather than a diff. If the fleet has\n     no capabilities/${capability}/spec.md yet, this feature's archive creates it.\n\n     WHAT BELONGS HERE is a promise somebody outside the fleet could check —\n     'a refund reaches the customer's card within five days'. What does NOT is\n     the mechanism: \\`Operations:\\`, \\`Covers:\\`, \\`Publishes:\\` and \\`Consumes:\\`\n     all resolve against ONE service's own contract or model, so a requirement\n     carrying one is a service requirement filed at the wrong altitude and\n     \\`loam validate\\` says so. \\`Capability:\\` and \\`Realizes:\\` are refused here\n     too — they are the joins written on the SERVICE requirement that keeps this\n     promise, one directory over in specs/<svc>/spec.md, as\n     \\`Realizes: ${capability}#<Requirement-ID>\\`.\n\n     \\`Requirement-ID:\\` is mandatory on every requirement below. A capability\n     document outlives the services that realize it, so its requirements are\n     addressed by a stable id rather than by their heading — rewording a heading\n     would otherwise be a removal and an addition, and every \\`Realizes:\\` line\n     pointed at it would break in silence.\n\n     A MODIFIED or REMOVED requirement also needs a \\`Based-On:\\` pin quoting the\n     living text it rewrites, so two features touching one capability collide\n     loudly instead of overwriting each other. Run \\`loam rebase ${featureId}\\`\n     and the pins are written for you.\n\n     Copy the block below out of this comment, unindent it, and replace the TODO\n     and every <angle-bracket> fill-in — \\`loam archive\\` refuses the scaffold's\n     own wording (\\`scaffold.placeholder\\`):\n\n    ## ADDED Requirements\n\n    ### Requirement: ${CAPABILITY_REQUIREMENT_SENTINEL}\n    Requirement-ID: ${idHint(capability)}\n\n    The fleet SHALL ${CAPABILITY_SHALL_SENTINEL}.\n\n    #### Scenario: ${SCENARIO_SENTINEL}\n    - **Given** ${GIVEN_SENTINEL}\n    - **When** ${WHEN_SENTINEL}\n    - **Then** ${THEN_SENTINEL}\n-->\n`;\n}\n\n/**\n * A plausible `Requirement-ID:` for a capability, offered as a shape rather than\n * a name: `payments/refunds` -> `PAYMENTS-REFUNDS-1`.\n *\n * Deliberately NOT the feature id. A service requirement's scaffolded id is\n * `<FEAT>.<svc>.requirement` because that requirement is created by, and lives\n * and dies with, one feature; a capability requirement outlives every feature\n * that touches it, so an id carrying the id of the feature that happened to\n * introduce it is exactly the identity-by-accident this axis refuses. The\n * suffix is `-1` and not a count of anything: it is a placeholder digit inside\n * a placeholder id, and the author is being asked to name the promise.\n *\n * CHECKED AGAINST THE REAL GRAMMAR, never assumed to satisfy it. A capability id\n * may begin with a digit (`3ds`, `2fa`, `1099-filing` — `dirNameHazard` allows an\n * alphanumeric head) while `REQUIREMENT_ID_RE` demands a LETTER, so the obvious\n * slug hands the author `3DS-1` and `loam validate` then refuses it with\n * `delta.requirement-id-invalid` — the author refused for using the shape the\n * scaffold offered. Length is the same class of failure at 128 characters. The\n * fallback prefixes rather than truncates, because a truncated id is a plausible\n * name that means something else.\n */\nfunction idHint(capability: string): string {\n  const slug = capability.toUpperCase().replace(/[^A-Z0-9]+/g, \"-\").replace(/^-+|-+$/g, \"\");\n  const candidate = `${slug}-1`;\n  if (REQUIREMENT_ID_RE.test(candidate)) return candidate;\n  const prefixed = `CAP-${candidate}`;\n  return REQUIREMENT_ID_RE.test(prefixed) ? prefixed : \"CAP-1\";\n}\n\nexport function openapiTemplate(service: string): string {\n  return `openapi: 3.1.0\ninfo:\n  title: ${service}\n  version: \"0.1\"\n\n# The operations this feature adds. \\`operationId\\` is the token the C4 edge\n# (metadata { op }) and the requirement (Operations:) both point at — keep the\n# three spellings identical or \\`loam validate\\` will say so.\npaths: {}\n#  /splits:\n#    post:\n#      operationId: createSplit\n#      responses:\n#        \"201\":\n#          description: Created\n`;\n}\n"]}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/new/templates.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Five of the six files `loam new` scaffolds, and what each one says. The\n * sixth, the `--capability` delta, is in `./capability-template.ts`.\n *\n * They are here rather than inline because every one of them is a document a\n * person edits next, and the wording IS the instruction: the delta's comments\n * teach the grammar `core/document/parse.ts` matches on, and the intent's\n * frontmatter is serialized rather than interpolated because a title is free\n * text somebody types — `Checkout: split payments` reopens the mapping and the\n * file stops parsing.\n */\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { serviceElementId } from \"../../core/c4/seed/template.js\";\nimport {\n  ARCH_REQUIREMENT_SENTINEL,\n  ARCH_SHALL_SENTINEL,\n  REQUIREMENT_SENTINEL,\n  SCENARIO_SENTINEL,\n  SERVICE_DESCRIPTION_SENTINEL,\n  GIVEN_SENTINEL,\n  SHALL_SENTINEL,\n  THEN_SENTINEL,\n  WHEN_SENTINEL,\n} from \"../../core/coherence/authoring/sentinels.js\";\n\n/**\n * The LikeC4 identifier the delta declares a service under: the id the fleet\n * map already draws it as (`drawn`), since a context id the map lacks lines up\n * with nothing at archive, else `serviceElementId` — seed's `svc_<id>`, where\n * this used to camel-case the name into a third spelling beside the seed's and\n * the map's. A collision inside one delta takes the seed's `_<n>` suffix.\n */\nfunction identifier(name: string, taken: Set<string>, drawn?: string): string {\n  if (drawn !== undefined) return drawn;\n  const base = serviceElementId(name);\n  let id = base;\n  for (let n = 2; taken.has(id); n += 1) id = `${base}_${n}`;\n  taken.add(id);\n  return id;\n}\n\n/** One context line. A nested id (`a.b`) is no top-level declaration, so it names its parent instead. */\nfunction contextLine(id: string, name: string): string {\n  const dot = id.lastIndexOf(\".\");\n  if (dot < 0) return `  // ${id} = softwareSystem '${name}'`;\n  return `  // ${id.slice(dot + 1)} = softwareSystem '${name}'  // inside ${id.slice(0, dot)} { }, as the map draws it; edges name it ${id}`;\n}\n\n/** `FEAT-101` -> `feat_101`: LikeC4 view names take no dashes. */\nfunction viewName(featureId: string): string {\n  return featureId.toLowerCase().replace(/[^a-z0-9]+/g, \"_\");\n}\n\n/* ------------------------------------------------------------------ */\n/* Templates                                                           */\n/* ------------------------------------------------------------------ */\n\nexport function intentTemplate(featureId: string, title: string | undefined): string {\n  const heading = title ?? featureId;\n  // The frontmatter is SERIALIZED, never interpolated. A title is free text a\n  // person types — `Checkout: split payments` used to be pasted straight after\n  // `title: `, where the colon reopens the mapping and the file stops parsing;\n  // `Orders #42 rework` lost everything from the `#` as a YAML comment, so the\n  // feature quietly answered to a title nobody wrote. The yaml serializer is the\n  // only thing that knows every case, and it is already how migrate-openspec\n  // writes the same three keys.\n  //\n  // `owner` is deliberately NOT a key here. Scaffolding `owner:` writes an\n  // explicit null, which is a claim (\"this feature has no owner\") rather than\n  // the truth (\"nobody has said yet\") — and every reader then has to tell an\n  // absent key from a null one. The prompt survives as a comment.\n  //\n  // `## Open questions` is where loam-feature's analyze step writes, so it is\n  // scaffolded as a heading over a comment and nothing else. `intent.empty`\n  // (coherence/authoring/scaffold.ts) reads past the whole section, so neither\n  // the untouched comment nor a page of questions counts as the Why.\n  const frontmatter = stringifyYaml(\n    { feature: featureId, ...(title === undefined ? {} : { title }), status: \"proposed\" },\n    { lineWidth: 0 },\n  ).trimEnd();\n  return `---\n${frontmatter}\n# owner: <the team or person who answers for this>\n---\n\n# ${heading}\n\n## Why\n\n<!-- The problem in business terms. This is what a reviewer reads first, and what\n     the requirement deltas below have to be justified by. -->\n\n## Scope\n\n<!-- Which services this touches — and, more usefully, which it deliberately does not. -->\n\n## Open questions\n\n<!-- Optional, never graded. What the documents leave open: an ambiguous SHALL, a value or\n     window two services state differently, an edge with no stated timeout, retry or\n     compensation. A person answers each by editing this section. -->\n`;\n}\n\nexport function deltaTemplate(featureId: string, touched: string[], created: string[], drawn: ReadonlyMap<string, string> = new Map()): string {\n  // The map's ids are claimed first: a new service's id never collides with a box quoted as context.\n  const taken = new Set<string>(drawn.values());\n  const touchedIds = touched.map((s) => [identifier(s, taken, drawn.get(s)), s] as const);\n  const createdIds = created.map((s) => [identifier(s, taken), s] as const);\n\n  const lines: string[] = [];\n  if (touchedIds.length > 0) {\n    // Context elements ship COMMENTED OUT, exactly like the example edge below.\n    // Declared-and-untagged is the one shape `delta.nothing-tagged` exists to\n    // refuse (an author who forgot the tags), so writing these live made every\n    // `loam new --touches X` fail its own validator on the very first run —\n    // which teaches people that the validator is noise. Uncomment a line when an\n    // edge below actually needs the identifier.\n    lines.push(\"  // Services this feature touches, as context for the diagram. Uncomment the\");\n    lines.push(\"  // ones an edge below names. A service the fleet map already draws keeps the\");\n    lines.push(\"  // identifier architecture/ gives it, so the merge lines up; one it does not\");\n    lines.push(\"  // draw yet gets svc_<id>, the convention `loam seed` writes. They stay UNTAGGED:\");\n    lines.push(`  // only #${featureId} is the change, and everything else here is context.`);\n    for (const [id, name] of touchedIds) lines.push(contextLine(id, name));\n    lines.push(\"\");\n  }\n  if (createdIds.length > 0) {\n    lines.push(\"  // Services this feature introduces. The tag is what `loam archive` folds\");\n    lines.push(\"  // into the living landscape.\");\n    for (const [id, name] of createdIds) {\n      lines.push(`  ${id} = softwareSystem '${name}' {`);\n      lines.push(`    #${featureId}`);\n      // Interpolated from sentinels.ts, never spelled here: the placeholder\n      // gate refuses this exact string at archive, and a second spelling is\n      // how a template rewording silently retires the check that guards it.\n      lines.push(`    description '${SERVICE_DESCRIPTION_SENTINEL}'`);\n      lines.push(\"  }\");\n    }\n    lines.push(\"\");\n  }\n\n  // The example edge uses identifiers already declared above when there are two\n  // to join; otherwise placeholders, so it never invents a service.\n  const from = touchedIds[0]?.[0] ?? createdIds[0]?.[0] ?? \"consumer\";\n  const to = createdIds[0]?.[0] ?? touchedIds[1]?.[0] ?? \"provider\";\n  lines.push(\"  // New calls. `metadata { op }` is the spine: it names the OpenAPI operationId\");\n  lines.push(\"  // the call uses, and `loam validate` checks it against the target's contract.\");\n  lines.push(\"  // Uncomment and adjust (both endpoints have to be declared above):\");\n  lines.push(\"  //\");\n  lines.push(`  // ${from} -> ${to} 'Calls createSplit' {`);\n  lines.push(`  //   #${featureId}`);\n  lines.push(\"  //   metadata { op 'createSplit' }\");\n  lines.push(\"  // }\");\n\n  return `// ${featureId} — architecture delta.\n//\n// Everything tagged #${featureId} is exactly what \\`loam archive\\` folds into\n// architecture/landscape.likec4. Everything else here is context for the diagram.\n//\n// If ${featureId} changes no architecture, DELETE this file: a requirements-only\n// feature is complete without it, and an empty \\`model {}\\` is just as legal.\n\nspecification {\n  element softwareSystem\n  tag ${featureId}\n}\n\nmodel {\n${lines.join(\"\\n\")}\n}\n\nviews {\n  view ${viewName(featureId)} {\n    include *\n  }\n}\n`;\n}\n\n/**\n * The business axis, scaffolded with its example INSIDE the comment — the same\n * mechanism as `archSpecTemplate` below, for the same reason: this template\n * used to ship a live `### Requirement: TODO — name the behaviour` that\n * parsed as a real requirement, validated clean, and archived a literal TODO\n * into the living spec at exit 0. The indented headings sit past the\n * line-anchored patterns core/document/parse.ts matches on, so the scaffold\n * declares nothing until a person copies the block out and writes over the\n * fill-ins — and `scaffold.placeholder` gates the archive if the fill-ins\n * survive the copy.\n *\n * No nested HTML comments: the `Operations:` guidance that used to be its own\n * comment lives in this one's prose, because an inner `-->` would end the\n * outer comment early and re-expose the example to the parser.\n */\nexport function specTemplate(featureId: string, service: string): string {\n  return `# ${service} — requirement delta for ${featureId}\n\n<!-- Sections: ADDED / MODIFIED / REMOVED. Delete the ones you do not need.\n     A MODIFIED requirement carries its full new text, not a diff.\n     Every requirement needs at least one scenario — \\`loam validate\\` gates on it.\n\n     An \\`Operations:\\` body line names the operationIds the requirement\n     governs. \\`loam validate\\` checks each one against the service's OpenAPI,\n     and \\`loam archive\\` refuses to merge a requirement that governs an\n     operation nobody defines — add the line once the contract exists.\n\n     A \\`Publishes:\\` / \\`Consumes:\\` body line does the same for event messages:\n     it names what the requirement puts on or takes off the bus, checked\n     against the service's AsyncAPI contract. If ${featureId} changes that\n     contract, hand-create specs/${service}/asyncapi.yaml — an AsyncAPI 3.0\n     document holding only the slots this feature adds, changes or removes,\n     messages under \\`components.messages\\` (loam scaffolds none: an event\n     contract is genuinely optional) — and run \\`loam rebase ${featureId}\\`\n     when it edits a slot the living contract already has, so that slot pins.\n     The same holds for an openapi.yaml beside this file: only what changes.\n\n     Copy the block below out of this comment, unindent it, and replace the\n     TODOs and every <angle-bracket> fill-in — \\`loam archive\\` refuses the\n     scaffold's own wording (\\`scaffold.placeholder\\`):\n\n    ## ADDED Requirements\n\n    ### Requirement: ${REQUIREMENT_SENTINEL}\n    Requirement-ID: ${featureId}.${service}.requirement\n\n    The service SHALL ${SHALL_SENTINEL}.\n\n    #### Scenario: ${SCENARIO_SENTINEL}\n    - **Given** ${GIVEN_SENTINEL}\n    - **When** ${WHEN_SENTINEL}\n    - **Then** ${THEN_SENTINEL}\n-->\n`;\n}\n\n/**\n * The architecture axis, scaffolded EMPTY on purpose.\n *\n * Same grammar as spec.md, so the template body has to be unparseable as\n * requirements or the scaffold would ship a requirement nobody wrote — the\n * headings are therefore indented inside an HTML comment, which puts them past\n * the line-anchored `## ADDED Requirements` / `### Requirement:` patterns\n * core/document/parse.ts matches on. Copy the block out of the comment and unindent it.\n */\nexport function archSpecTemplate(featureId: string, service: string): string {\n  return `# ${service} — architecture requirement delta for ${featureId}\n\n<!-- The architecture axis: the obligations no business scenario was ever going\n     to mention — the outbox, the retries, the timeouts, the alerts.\n\n     \\`Covers:\\` is to an arch requirement what \\`Operations:\\` is to a business\n     one — it names the MODEL OBJECTS the scenarios below exercise, so coverage\n     is derived instead of trusted. Three forms, comma-separated:\n\n       Covers: ${service}                 a C4 element — its id, or the service a\n                                          bound/titled element stands for\n       Covers: consumer -> ${service}     an edge, each side resolved the same way\n       Covers: alert:<id>, sli:<id>       a signal declared in health.yaml\n\n     Every tagged element and edge in delta.likec4 wants one (\\`c4.uncovered\\`).\n     Delete this file if ${featureId} adds no architectural obligation.\n\n     Copy the block below out of this comment and unindent it:\n\n    ## ADDED Requirements\n\n    ### Requirement: ${ARCH_REQUIREMENT_SENTINEL}\n    Requirement-ID: ${featureId}.${service}.arch\n\n    The service SHALL ${ARCH_SHALL_SENTINEL}.\n\n    Covers: ${service}\n\n    #### Scenario: ${SCENARIO_SENTINEL}\n    - **Given** ${GIVEN_SENTINEL}\n    - **When** ${WHEN_SENTINEL}\n    - **Then** ${THEN_SENTINEL}\n-->\n`;\n}\n\nexport function openapiTemplate(service: string): string {\n  return `openapi: 3.1.0\ninfo:\n  title: ${service}\n  version: \"0.1\"\n\n# The operations this feature adds. \\`operationId\\` is the token the C4 edge\n# (metadata { op }) and the requirement (Operations:) both point at — keep the\n# three spellings identical or \\`loam validate\\` will say so.\npaths: {}\n#  /splits:\n#    post:\n#      operationId: createSplit\n#      responses:\n#        \"201\":\n#          description: Created\n`;\n}\n"]}