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

package/dist/commands/context/print.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/commands/context/print.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAwB,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAoB,MAAM,6BAA6B,CAAC;AAE/D,MAAM,UAAU,SAAS,CAAC,IAAiB;IACzC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnG,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,KAAK,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7G,2EAA2E;IAC3E,4EAA4E;IAC5E,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,WAAW,CAAC,WAAW,wCAAwC,CAAC,CAAC;IACpG,CAAC;IACD,0EAA0E;IAC1E,qEAAqE;IACrE,kEAAkE;IAClE,wEAAwE;IACxE,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CACT,yBAAyB,IAAI,CAAC,QAAQ,CAAC,WAAW,wDAAwD,CAC3G,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,yGAAyG,CAAC,CAAC;IACzH,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,2DAA2D,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;QAC/F,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,4DAA4D,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAC;QAC9G,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,uEAAuE;IACvE,cAAc;IACd,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,0IAA0I,CAAC,CAAC;QACxJ,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,CAAC,sBAAsB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,6HAA6H,CAAC,CAAC;QAC3I,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,4HAA4H,CAAC,CAAC;IACrJ,CAAC;IACD,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACtD,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,6IAA6I,CAAC,CAAC;QAC3J,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QACrF,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,iBAAiB,CAAC,mBAAmB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE9D,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACnH,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACjC,CAAC,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChE,CAAC,CAAC,iCAAiC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClH,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,kDAAkD,CAAC,CAAC;YACzE,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG;YACZ,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACvD,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACjF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAE/C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;IAC3H,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,kBAAkB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3F,2EAA2E;QAC3E,wEAAwE;QACxE,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC;IACtH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;SAC5E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;SACtE,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,2DAA2D,CAAC,CAAC;QACtH,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnG,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3G,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,OAAgB,EAAU,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACjG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,yEAAyE;IACzE,wEAAwE;IACxE,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,6BAA6B,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;IACvG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;QAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa,EAAE,IAAuB,EAAE,KAAK,GAAG,IAAI;IAC7E,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,kBAAkB,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,wEAAwE;YACxE,uBAAuB;YACvB,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,CAAc,EAAE,OAAe;IACnD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,MAAM,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,CAAC;IACxI,CAAC;IACD,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,2EAA2E;IAC3E,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,iBAAiB,CAAC,mBAAmB,EAAE,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC7F,IAAI,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,iBAAiB,CAAC,wBAAwB,EAAE,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAE1G,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACzB,2EAA2E;QAC3E,yEAAyE;QACzE,iCAAiC;QACjC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;SAAM,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvH,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;SAAM,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,wEAAwE;IACxE,kEAAkE;IAClE,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,OAAO,cAAc,OAAO,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,QAAQ,CAAC,EAAiB,EAAE,KAAoB;IACvD,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,KAAK,EAAE,EAAE,CAAC;IAClC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,+FAA+F;AAC/F,SAAS,cAAc,CAAC,EAAU;IAChC,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC","sourcesContent":["/**\n * The context pack as a Markdown document on stdout — for pasting into an\n * agent's context, or reading in a terminal that renders neither.\n *\n * Rendering only. Everything printed here comes from `core/pack/`, which is\n * also what `--json` emits, so a printed section can never disagree with the\n * payload beside it. Requirement bodies and Given/When/Then lines go out\n * VERBATIM — they are the acceptance criteria, and paraphrasing them here\n * would put a second wording of the contract in front of whoever implements\n * it. The living sections use the canonical `### Requirement:` /\n * `#### Scenario:` heading levels; the in-flight blocks print the same lines\n * one level deeper, because each sits under its feature's own `###` heading.\n */\nimport { type ContextPack } from \"../../core/pack/pack.js\";\nimport { type PackRequirement } from \"../../core/pack/living.js\";\nimport { type PackFeature } from \"../../core/pack/features.js\";\n\nexport function printPack(pack: ContextPack): void {\n  console.log(`# ${pack.service} — context pack\\n`);\n  const badge = [pack.frontmatter.status, pack.frontmatter.owner].filter((s) => s !== null);\n  console.log(`${pack.path} · ${pack.maturity}${badge.length > 0 ? ` · ${badge.join(\" · \")}` : \"\"}`);\n  if (pack.missing.length > 0) console.log(`missing: ${pack.missing.join(\", \")}`);\n  if (pack.frontmatter.last_verified !== null) console.log(`last_verified: ${pack.frontmatter.last_verified}`);\n  // Under the date it qualifies: that vouch read the sections this names and\n  // no others, so `verified` above covers less of the document than it looks.\n  if (pack.frontmatter.vouch_scope !== null) {\n    console.log(`vouch_scope: ${pack.frontmatter.vouch_scope} — the rest was not read at that vouch`);\n  }\n  // Per axis and named, `show`'s discipline: the sample is per FILE, so one\n  // run can read a short spec.md in full and stamp a long arch.spec.md\n  // sampled. Printing only the first line said `verified` over arch\n  // requirements this pack then reproduced verbatim, half of them unread.\n  if (pack.archSpec.vouch_scope !== null) {\n    console.log(\n      `archSpec.vouch_scope: ${pack.archSpec.vouch_scope} — the rest of arch.spec.md was not read at that vouch`,\n    );\n  }\n  for (const s of pack.frontmatter.sources) console.log(`sources: ${s}`);\n  console.log();\n\n  // Unreadable documents are said FIRST and without hedging (explore's print\n  // discipline): every empty section below could otherwise be read as \"nothing\n  // here\", which is the one conclusion an unreadable document never supports.\n  if (pack.landscape.present && !pack.landscape.parses) {\n    console.log(\"! architecture/landscape.likec4 does not parse — no edge below is derived, and none is missing either\\n\");\n  }\n  if (pack.openapi.unreadable) {\n    console.log(`! openapi.yaml does not parse — nothing here lists what ${pack.service} exposes`);\n    if (pack.openapi.error !== undefined) console.log(`  ${pack.openapi.error}`);\n    console.log();\n  }\n  if (pack.asyncapi.unreadable) {\n    console.log(`! asyncapi.yaml does not parse — nothing here lists what ${pack.service} publishes or consumes`);\n    if (pack.asyncapi.error !== undefined) console.log(`  ${pack.asyncapi.error}`);\n    console.log();\n  }\n  // The vocabulary failures lead with the contract failures: each empties a\n  // section below into something that reads as an answer (\"declared: false\"\n  // on every permission, \"(none realized here)\"), and a warning printed down\n  // beside the section is a warning a reader pasting the top of the pack\n  // never sees.\n  if (pack.permissionsVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/permissions.yaml does not read as a vocabulary — every permission below reports declared: false because nobody could look\");\n    console.log(`  ${pack.permissionsVocabulary.invalid}`);\n    console.log();\n  }\n  if (pack.capabilitiesVocabulary.invalid !== undefined) {\n    console.log(\"! architecture/capabilities.yaml does not read as a vocabulary — no capability below is derived, and none is missing either\");\n    console.log(`  ${pack.capabilitiesVocabulary.invalid}`);\n    console.log();\n  }\n  for (const path of pack.capabilitiesUnread) {\n    console.log(`! ${path} could not be read while joining capabilities — that service's realizations are missing from the rollup this pack filtered`);\n  }\n  if (pack.capabilitiesUnread.length > 0) console.log();\n  if (pack.useCaseScan.unreadable) {\n    console.log(\"! architecture/ does not parse as one LikeC4 project — every use case below is missing because nobody could look, not because none is drawn\");\n    if (pack.useCaseScan.error !== undefined) console.log(`  ${pack.useCaseScan.error}`);\n    console.log();\n  }\n\n  printRequirements(\"Requirements\", pack.requirements);\n  printRequirements(\"Arch requirements\", pack.archRequirements);\n\n  console.log(\"## Operations\\n\");\n  if (pack.operations.length === 0) console.log(pack.openapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const op of pack.operations) {\n    const by = op.governedBy.length > 0\n      ? `governed by ${op.governedBy.map((n) => `\"${n}\"`).join(\", \")}`\n      : \"not governed by any requirement\";\n    console.log(`- ${op.method} ${op.path}  ${op.id} — ${by}`);\n  }\n  if (pack.operations.length > 0) console.log();\n\n  console.log(\"## Messages\\n\");\n  if (pack.messages.length === 0) console.log(pack.asyncapi.unreadable ? \"(unreadable — see above)\\n\" : \"(none)\\n\");\n  for (const m of pack.messages) {\n    const direction = m.direction === null ? \"declared, not wired\" : m.direction.toUpperCase();\n    console.log(`- ${direction}  ${m.name}  (${m.slot})`);\n  }\n  if (pack.messages.length > 0) console.log();\n\n  console.log(\"## Permissions\\n\");\n  if (pack.permissions.length === 0) console.log(\"(none required)\\n\");\n  for (const p of pack.permissions) {\n    if (!p.declared) {\n      console.log(`- ${p.id} — not declared in architecture/permissions.yaml`);\n      continue;\n    }\n    const notes = [\n      ...(p.description === undefined ? [] : [p.description]),\n      ...(p.ownedBy === undefined ? [] : [`owned by ${p.ownedBy}`]),\n      ...(p.enforcedBy.length === 0 ? [] : [`enforced by ${p.enforcedBy.join(\", \")}`]),\n    ];\n    console.log(`- ${p.id}${notes.length > 0 ? ` — ${notes.join(\"; \")}` : \"\"}`);\n  }\n  if (pack.permissions.length > 0) console.log();\n\n  console.log(\"## Capabilities\\n\");\n  if (pack.capabilities.length === 0) {\n    console.log(pack.capabilitiesVocabulary.invalid !== undefined ? \"(unreadable — see above)\\n\" : \"(none realized here)\\n\");\n  }\n  for (const c of pack.capabilities) {\n    const label = c.description === undefined ? c.id : `${c.id} — ${c.description}`;\n    console.log(`- ${label} (realized by: ${c.requirements.map((n) => `\"${n}\"`).join(\", \")})`);\n    // The flows that claim the capability, fleet-wide — the answer to \"what is\n    // this requirement FOR\", which the requirement's own text rarely gives.\n    for (const flow of c.useCases) console.log(`  - flow: ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n  }\n  if (pack.capabilities.length > 0) console.log();\n\n  console.log(\"## Use cases\\n\");\n  if (pack.useCaseSteps.length === 0) {\n    console.log(pack.useCaseScan.unreadable ? \"(unreadable — see above)\\n\" : \"(no declared flow draws this service)\\n\");\n  }\n  for (const flow of pack.useCaseSteps) {\n    console.log(`- ${flow.title ?? flow.id} [${flow.id}]  ${flow.file}`);\n    for (const step of flow.steps) {\n      const label = step.title === undefined ? \"\" : ` '${step.title}'`;\n      console.log(`  - step ${step.ordinal}${label}: ${step.source} -> ${step.target}`);\n    }\n  }\n  if (pack.useCaseSteps.length > 0) console.log();\n\n  console.log(\"## Landscape\\n\");\n  if (!pack.landscape.present) console.log(\"(no architecture/landscape.likec4)\\n\");\n  else if (!pack.landscape.parses) console.log(\"(unreadable — see above)\\n\");\n  else {\n    if (!pack.landscape.modelled) console.log(`${pack.service} is not in the fleet map — no edge into it can be checked`);\n    for (const e of pack.landscape.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of pack.landscape.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    if (pack.landscape.modelled && pack.landscape.inbound.length === 0 && pack.landscape.outbound.length === 0) {\n      console.log(\"(modelled, no edges touch it)\");\n    }\n    console.log();\n  }\n\n  console.log(\"## Pointers\\n\");\n  const mark = (present: boolean): string => (present ? \"present\" : \"absent\");\n  console.log(`- runbook: ${mark(pack.pointers.runbook.present)} (${pack.pointers.runbook.path})`);\n  console.log(`- health: ${mark(pack.pointers.health.present)} (${pack.pointers.health.path})`);\n  console.log(`- adrs: ${pack.pointers.adrs.count} (${pack.pointers.adrs.path})`);\n  console.log();\n\n  // The narrowing is said in the heading: a narrowed pack differs from the\n  // default only by what it leaves OUT, and a reader (or a diff) must not\n  // mistake one for a fleet gone quiet.\n  console.log(pack.feature === null ? \"## In flight\\n\" : `## In flight (narrowed to ${pack.feature})\\n`);\n  if (pack.features.length === 0) console.log(\"(no active feature touches this service)\");\n  for (const f of pack.features) printFeature(f, pack.service);\n}\n\nfunction printRequirements(label: string, reqs: PackRequirement[], level = \"##\"): void {\n  console.log(`${level} ${label}\\n`);\n  if (reqs.length === 0) console.log(\"(none)\\n\");\n  for (const r of reqs) {\n    const tag = r.kind === \"BASE\" ? \"\" : `[${r.kind}] `;\n    console.log(`${level}# Requirement: ${tag}${r.name}`);\n    if (r.text.length > 0) console.log(r.text);\n    for (const s of r.scenarios) {\n      console.log(`\\n${level}## Scenario: ${s.name}`);\n      // Verbatim, bullets and markdown emphasis included: these lines are the\n      // acceptance criteria.\n      for (const line of s.lines) console.log(line);\n    }\n    console.log();\n  }\n}\n\nfunction printFeature(f: PackFeature, service: string): void {\n  console.log(`### ${f.feature} (${f.path})\\n`);\n  if (!f.services.includes(service)) {\n    console.log(`(no delta for ${service} — ${f.feature} touches: ${f.services.length > 0 ? f.services.join(\", \") : \"(no services)\"})\\n`);\n  }\n  // Intent prose arrives with its own headings — usually an H1 title — and\n  // pasted raw under this feature's `###` those restructure the whole pack: a\n  // second H1 splits the document, and an intent section named \"Operations\"\n  // collides with the pack's own. Demoted three levels (below the feature\n  // heading), capped at H6 because a seventh `#` renders as literal text.\n  // Body lines are untouched — the demotion is structural, not a paraphrase.\n  if (f.intent !== null && f.intent.length > 0) console.log(`${demoteHeadings(f.intent)}\\n`);\n  if (f.requirements.length > 0) printRequirements(\"Requirement delta\", f.requirements, \"###\");\n  if (f.archRequirements.length > 0) printRequirements(\"Arch requirement delta\", f.archRequirements, \"###\");\n\n  if (f.openapi.unreadable) {\n    // Worded like the delta brief's answer for the same failure, and without a\n    // \"run `loam validate`\" hint: the parser's own message is quoted and the\n    // exit code carries the failure.\n    console.log(\"API: openapi.yaml does not parse\");\n    if (f.openapi.error !== undefined) console.log(`  ${f.openapi.error}`);\n    console.log();\n  } else if (f.api.length > 0) {\n    console.log(\"API changes:\");\n    for (const op of f.api) {\n      const marker = op.remove ? \"REMOVE \" : \"\";\n      console.log(`- ${marker}${op.method} ${op.path}  ${op.operationId}${op.summary === null ? \"\" : ` — ${op.summary}`}`);\n    }\n    console.log();\n  }\n\n  if (f.events.unreadable) {\n    console.log(\"Events: asyncapi.yaml does not parse\");\n    if (f.events.error !== undefined) console.log(`  ${f.events.error}`);\n    console.log();\n  } else if (f.events.changes.length > 0) {\n    console.log(\"Event changes:\");\n    for (const m of f.events.changes) {\n      const marker = m.remove ? \"REMOVE \" : \"\";\n      const direction = m.direction === null ? \"\" : `${m.direction.toUpperCase()} `;\n      console.log(`- ${marker}${direction}${m.message}  (${m.slot})`);\n    }\n    console.log();\n  }\n\n  const arch = f.architecture;\n  if (arch.errors.length > 0) {\n    console.log(\"Architecture: delta.likec4 has errors\");\n    for (const e of arch.errors) console.log(`  ${e}`);\n    console.log();\n  } else if (arch.isNew || arch.inbound.length > 0 || arch.outbound.length > 0) {\n    console.log(\"Architecture:\");\n    if (arch.isNew) console.log(`- NEW service — create ${service}`);\n    for (const e of arch.outbound) console.log(`- → ${e.service}${edgeNote(e.op, e.title)}`);\n    for (const e of arch.inbound) console.log(`- ← ${e.service}${edgeNote(e.op, e.title)}`);\n    console.log();\n  }\n\n  // Both interpolants passed their grammars at the boundary — the service\n  // through assertServiceId, the feature id as the CANONICAL id the\n  // enumeration derived — so the printed command parses. That property is the\n  // exact lesson explore's `--as` records: this line is assembled from data,\n  // which is the one shape test/agent-commands-runnable.test.ts cannot see.\n  console.log(`next: loam delta ${f.feature} --service ${service}\\n`);\n}\n\nfunction edgeNote(op: string | null, title: string | null): string {\n  if (op !== null) return `  ${op}`;\n  return title !== null && title.length > 0 ? `  \"${title}\"` : \"\";\n}\n\n/** Every ATX heading pushed three levels down, capped at H6 — see the intent comment above. */\nfunction demoteHeadings(md: string): string {\n  return md.replace(/^(#{1,6})(?= )/gm, (h) => \"#\".repeat(Math.min(6, h.length + 3)));\n}\n"]}

package/dist/commands/delta/delta.js

@@ -0,0 +1,279 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { loadConfig } from "../../core/envelope/config.js";
+import { InvalidIdError, assertServiceId } from "../../core/kernel/ids/service.js";
+import { emitJson, emitJsonError, fail, repoPath, reportNoConfig, sayExplain } from "../../core/envelope/json.js";
+import { loadFile } from "../../core/c4/likec4.js";
+import { compareIds, nearestIds } from "../../core/repo/entries.js";
+import { featurePaths, featureSpecPaths } from "../../core/repo/paths.js";
+import { missingFeatureMessage, resolveFeature } from "../../core/repo/repo.js";
+import { parseRequirements } from "../../core/document/parse.js";
+import {} from "../../core/document/spec.js";
+import { stripFrontmatter } from "../../core/document/frontmatter.js";
+import { apiChanges } from "../../core/projection/api.js";
+import { eventChanges } from "../../core/projection/events.js";
+import { archSlice, introducedServices, livingServices } from "../../core/projection/arch-slice.js";
+import { useCaseBlastRadius } from "../../core/usecases/touch.js";
+import { featureCapabilityDeltas } from "../../core/capabilities/delta/tree.js";
+import { capabilityDeltaSummaries } from "../../core/capabilities/delta/summary.js";
+import { printApi, printArchSlice, printCapabilities, printEvents, printRequirements, printUseCases } from "./print.js";
+import { indent } from "./print.js";
+export function registerDelta(program) {
+    program
+        .command("delta")
+        .argument("<featureId>", "feature id, e.g. FEAT-101")
+        .description("Project a feature onto a service: why + requirement delta + C4 changes")
+        .option("--service <id>", "service to project onto (defaults to the configured service)")
+        .option("--json", "emit the machine contract instead of the human view")
+        .action(async (featureId, opts) => {
+        const json = opts.json === true;
+        const loaded = await loadConfig();
+        if (loaded.kind !== "loaded") {
+            reportNoConfig(json, loaded);
+            return;
+        }
+        const config = loaded.config;
+        // The id grammar first, and on the RAW argument: `--service ../../etc`
+        // reaches `featureSpecPaths` and reads from outside the feature directory.
+        // One grammar for the whole tool (core/kernel/ids/service.ts).
+        if (opts.service !== undefined) {
+            try {
+                assertServiceId(opts.service, "--service");
+            }
+            catch (err) {
+                if (!(err instanceof InvalidIdError))
+                    throw err;
+                fail(json, "invalid-option", err.message);
+                return;
+            }
+        }
+        // The feature is resolved BEFORE the service is chosen, because every
+        // sentence about the service ("which ones does this feature touch?") is
+        // only answerable once the feature is known.
+        const feature = await resolveFeature(config.docsDir, featureId, "exclude");
+        if (!feature) {
+            fail(json, "unknown-target", await missingFeatureMessage(config.docsDir, featureId));
+            return;
+        }
+        // Canonical id from here on — the delta's tags carry `#FEAT-5`, so a raw
+        // `FEAT-5-slug` argument used to empty the architecture slice silently.
+        const { id } = feature;
+        const paths = featurePaths(feature.dir);
+        const deltaDoc = existsSync(paths.delta) ? await loadFile(paths.delta) : null;
+        // Services the feature speaks about at all: one with a requirement delta,
+        // or one its C4 delta introduces. This is the list a refusal quotes.
+        const featureServices = [
+            ...new Set([...feature.services, ...introducedServices(deltaDoc, id)]),
+        ].sort(compareIds);
+        const service = opts.service ?? config.service;
+        if (!service) {
+            // The refusal NAMES the choices. "No service. Pass --service <id>" told
+            // the reader the shape of the flag and nothing about the answer, so the
+            // next step was always to go list the feature's specs/ by hand — and an
+            // agent had no way to recover at all. The list rides the JSON envelope
+            // for the same reason.
+            const message = `No service to project ${id} onto. Pass --service <id> or set 'service' in loam.json.` +
+                (featureServices.length === 0
+                    ? ` ${id} carries no per-service delta yet.`
+                    : ` ${id} touches: ${featureServices.join(", ")}.`);
+            if (json)
+                emitJsonError("invalid-option", message, { feature: id, services: featureServices });
+            else {
+                console.error(message);
+                // This arm refuses by hand because the envelope carries `services` as
+                // data, which `fail()` has no room for — so the code and its lookup
+                // are asked for explicitly, with the same code the branch above
+                // emits. Without it this was one of the two refusals that most needed
+                // `loam explain` and had no way to name it.
+                sayExplain("invalid-option");
+                process.exitCode = 1;
+            }
+            return;
+        }
+        // A service nobody has heard of produces a perfectly plausible EMPTY
+        // report — no requirements, no edges, "no architecture change" — which an
+        // agent consuming this as a task brief reads as "nothing to do here".
+        // A typo must never be indistinguishable from a finished service.
+        const living = await livingServices(config.docsDir);
+        if (!featureServices.includes(service) && !living.includes(service)) {
+            const near = nearestIds(service, [...new Set([...featureServices, ...living])]);
+            fail(json, "unknown-target", `No service '${service}': it is neither a services/${service}/ in the docs repo nor a service ${id} touches` +
+                (featureServices.length === 0 ? "" : ` (${featureServices.join(", ")})`) +
+                (near.length === 0 ? "." : ` — did you mean ${near.map((n) => `'${n}'`).join(" or ")}?`));
+            return;
+        }
+        // Why — business intent
+        const intent = existsSync(paths.intent)
+            ? stripFrontmatter(await readFile(paths.intent, "utf8")).trim()
+            : null;
+        // Requirement delta for this service (OpenSpec style), business and arch:
+        // the same projection covers both axes, in the same shape, so the payload
+        // stays one task — the arch requirements are the integration/ops half the
+        // business ones never mention.
+        const specPaths = featureSpecPaths(feature.dir, service);
+        const reqs = existsSync(specPaths.spec)
+            ? parseRequirements(await readFile(specPaths.spec, "utf8"))
+            : [];
+        const archReqs = existsSync(specPaths.archSpec)
+            ? parseRequirements(await readFile(specPaths.archSpec, "utf8"))
+            : [];
+        // The contract axis. Until now no command surfaced it at all: the feature's
+        // openapi.yaml was read by validate and by archive, and the one command
+        // whose output IS the implementation task never mentioned it — so "add the
+        // endpoint" was the half of the work the brief left out.
+        const api = await apiChanges(specPaths.openapi);
+        // The event axis, same reasoning: a feature's asyncapi.yaml is merged by
+        // archive and graded by validate, so the brief must name what it changes
+        // — a message the implementer was never told to publish is the same
+        // dropped work as an endpoint the brief left out.
+        const events = await eventChanges(specPaths.asyncapi);
+        // C4 architecture slice. The fleet union mirrors coherence's: services/
+        // plus the feature's own specs/ names, so the slice and the validator
+        // resolve a container-targeted edge to the same owner.
+        const fleet = new Set([...living, ...featureServices]);
+        const arch = archSlice(deltaDoc, service, id, fleet);
+        // The use-case axis, and the one section here that is a fact about the
+        // FLEET rather than about the feature's own files: which declared business
+        // flows already run through this service, and at which hop. An implementer
+        // handed "add the endpoint" and not told that step 4 of Checkout is the
+        // caller has to go find that out, and on a fleet of a hundred nobody does.
+        //
+        // The fleet set is `living ∪ featureServices`, the same union `archSlice`
+        // resolves with, so a service this feature INTRODUCES resolves to itself
+        // rather than to a container's title. And `useCaseBlastRadius` gates its
+        // own load: a docs repo whose architecture/ never mentions the reserved
+        // tag prefix costs a readdir and a few file reads here, not a LikeC4
+        // workspace — which is what keeps this command usable inside
+        // /loam-implement's inner loop.
+        const useCases = await useCaseBlastRadius({
+            docsDir: config.docsDir,
+            known: fleet,
+            services: new Set([service]),
+        });
+        // The business axis. Like the use-case section above it is a fact about
+        // the FEATURE rather than about this service's own files, and it is here
+        // for the sharper version of that section's reason: a capability delta
+        // NAMES NO SERVICE, so projecting the feature onto a service would drop
+        // it entirely — and the implementer handed "add the endpoint" would never
+        // learn which business promise the requirement they are about to write is
+        // supposed to keep. `Realizes: <capability>#<id>` is the line that says
+        // so, it is written on the SERVICE requirement, and the id in it is the
+        // one thing here that cannot be guessed.
+        //
+        // Not narrowed by `--service`, deliberately: the promise is what the
+        // whole feature is for, and narrowing it would report a capability-only
+        // feature as having nothing to say about every service in turn. One
+        // `existsSync` for a fleet that has not adopted the axis.
+        const capabilities = await capabilityDeltaSummaries((await featureCapabilityDeltas(feature.dir)).docs, async (path) => parseRequirements(await readFile(path, "utf8")));
+        // An unparseable delta.likec4 empties the C4 slice, and a consumer
+        // reading this projection as a task brief — the JSON payload and the
+        // printed view alike — would take that as "no architecture change": the
+        // vacuously-green pattern. The output stays as informative as ever (and
+        // `ok` stays true under --json: the command ran); the exit code is what
+        // stops a pipeline from building on it, so it is set BEFORE the format
+        // fork — the guard is about the delta, not about how it is rendered.
+        //
+        // The two contract axes fail the same way and earn the same guard: an
+        // openapi.yaml or asyncapi.yaml that does not parse projects as an empty
+        // change list. `validate --feature` does catch both these days
+        // (`openapi.invalid` / `asyncapi.invalid` on the feature's own files),
+        // but the guard stays this command's own: the brief is consumed by
+        // agents that never ran validate, so the exit code must carry the
+        // failure itself.
+        if (arch.errors.length > 0 || api.unreadable || events.unreadable)
+            process.exitCode = 1;
+        if (json) {
+            const reqJson = (r) => ({
+                kind: r.kind,
+                id: r.id,
+                name: r.name,
+                text: r.text.join("\n").trim(),
+                operations: r.operations,
+                covers: r.covers,
+                // Scenarios go out verbatim: they are the acceptance criteria and the
+                // source for the tests whoever picks this up is expected to write.
+                scenarios: r.scenarios.map((s) => ({ name: s.name, lines: s.lines })),
+            });
+            emitJson({
+                command: "delta",
+                feature: id,
+                service,
+                services: featureServices,
+                path: repoPath(config.docsDir, feature.dir),
+                intent,
+                requirements: reqs.map(reqJson),
+                // Same shape, separate section: an arch requirement's scenarios are
+                // integration/ops tests, and a consumer must not have to parse prose
+                // to tell the two apart.
+                archRequirements: archReqs.map(reqJson),
+                api: api.changes,
+                // `api` stays exactly the operations array it has always been — a
+                // consumer indexing it must not have to learn a new shape — so the
+                // readability of the document rides alongside as its own key,
+                // spelled the way `loam show` already spells it for a living
+                // contract. Additive, which the envelope permits (core/envelope/json.ts).
+                openapi: {
+                    unreadable: api.unreadable,
+                    ...(api.error === undefined ? {} : { error: api.error }),
+                },
+                // The event axis arrives after the api/openapi pair settled its
+                // split shape, so it is one additive key carrying both halves:
+                // the declarations and the document's readability.
+                events: {
+                    changes: events.changes,
+                    unreadable: events.unreadable,
+                    ...(events.error === undefined ? {} : { error: events.error }),
+                },
+                architecture: arch,
+                // Additive, which the envelope permits (core/envelope/json.ts), and
+                // deliberately NOT wired into the exit-code guard above. The three
+                // conditions there are about the FEATURE's own documents; an
+                // `architecture/` that does not parse is a pre-existing fleet defect
+                // `validate` already reports as `landscape.invalid`, and making every
+                // `loam delta` in such a repo exit 1 would be a new gate wearing the
+                // clothes of a new field. `unreadable` is how this payload says it
+                // could not look.
+                useCases: {
+                    unreadable: useCases.unreadable,
+                    ...(useCases.error === undefined ? {} : { error: useCases.error }),
+                    flows: useCases.flows,
+                },
+                // Additive, and an empty array rather than an absent key for the same
+                // reason `loam show`'s is: a consumer must not have to tell "this
+                // feature changes no capability" from "this loam does not report
+                // them". The shape is `show`'s, verbatim — the two commands are read
+                // side by side, and a second shape for one idea is a second thing to
+                // learn.
+                capabilities: capabilities.map((c) => ({
+                    id: c.id,
+                    path: repoPath(config.docsDir, c.spec),
+                    added: c.added,
+                    modified: c.modified,
+                    removed: c.removed,
+                    promises: c.promises,
+                })),
+            });
+            return;
+        }
+        console.log(`${id} · ${service}\n`);
+        if (intent) {
+            console.log(indent(intent, "  "));
+            console.log();
+        }
+        if (existsSync(specPaths.spec))
+            printRequirements(reqs, "Requirements");
+        else
+            console.log("Requirements: (none for this service)\n");
+        if (existsSync(specPaths.archSpec))
+            printRequirements(archReqs, "Arch requirements");
+        if (existsSync(specPaths.openapi))
+            printApi(api);
+        if (existsSync(specPaths.asyncapi))
+            printEvents(events);
+        if (existsSync(paths.delta))
+            printArchSlice(arch, service);
+        printCapabilities(capabilities);
+        printUseCases(useCases, service);
+    });
+}
+//# sourceMappingURL=delta.js.map