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

package/dist/core/status/feature/next.js

@@ -0,0 +1,163 @@
+import { recoverStep } from "../interrupted.js";
+import { testStep, verifyStep } from "../verification.js";
+import {} from "./state.js";
+import { archivedVerification } from "./words.js";
+/**
+ * Would either gate refuse this? Severity answers `validate`'s question and
+ * `gates` answers archive's; a finding that fails EITHER is one an author has
+ * work to do about, and collapsing them to `severity === "error"` is how
+ * `status` came to print "ship it" beside a warning archive exits 1 on.
+ */
+export function unshippable(f) {
+    return f.severity === "error" || f.gates === true;
+}
+/** Codes whose one fix is `loam rebase`: a pin nobody ever wrote, on any of the three axes. */
+const UNPINNED = new Set(["delta.baseline-missing", "openapi.baseline-missing", "asyncapi.baseline-missing"]);
+export function featureNext(state, boundService) {
+    const { feature, services, artifacts, findings, blockedBy, verification, scans, interrupted } = state;
+    const id = feature.id;
+    // Before the archived shortcut: the interrupted commit may be this feature's
+    // own, and "it shipped" is not a thing to tell somebody whose living docs are
+    // half-written.
+    const first = interrupted === null ? [] : [recoverStep(interrupted)];
+    if (feature.archived) {
+        return [
+            ...first,
+            {
+                code: "next.archived",
+                // Not "it shipped": archive folds documents and checks no code and no
+                // evidence, so the sentence says what archiving did and then, in the
+                // done-check's own words, whether anybody verified it.
+                statement: `${id} is archived — its deltas are folded into the living docs. Archiving checks documents, not code: ` +
+                    `${id} is ${archivedVerification(verification)}.`,
+                command: `loam show ${id} --json`,
+            },
+        ];
+    }
+    const steps = [...first];
+    const owed = (kind, service) => artifacts.find((a) => a.id === kind && a.status === "missing" && (service === undefined || a.service === service));
+    const intent = owed("intent");
+    if (intent !== undefined) {
+        steps.push({
+            code: "next.author-intent",
+            statement: `Write ${intent.path} — what ${id} is for, in prose, before anything is derived from it.`,
+            command: `loam validate ${id} --json`,
+            artifact: "intent",
+            path: intent.path,
+        });
+    }
+    if (services.length === 0) {
+        steps.push({
+            code: "next.touch-service",
+            statement: `${id} carries no per-service delta — add specs/<service>/spec.md for every service it changes.`,
+            command: "loam list services --json",
+        });
+    }
+    for (const svc of services) {
+        const spec = owed("spec", svc);
+        if (spec !== undefined) {
+            steps.push({
+                code: "next.author-spec",
+                statement: `Write ${spec.path} — the ADDED/MODIFIED/REMOVED requirements ${id} makes to ${svc}, each with a scenario.`,
+                command: `loam delta ${id} --service ${svc} --json`,
+                artifact: "spec",
+                service: svc,
+                path: spec.path,
+            });
+        }
+        const api = owed("openapi", svc);
+        if (api !== undefined) {
+            steps.push({
+                code: "next.author-openapi",
+                // Not "the service is not in the living docs": a service adopted
+                // without a contract is the commoner case, and that wording sent a
+                // reader looking for a directory that was right there. And not "the
+                // operations it governs" either — what owes the file may be an edge
+                // the delta draws INTO the service rather than any `Operations:` line
+                // (owesContract), so naming governed operations promised the author a
+                // list they would go looking for and not find.
+                statement: `Write ${api.path} — nothing gives ${svc} a living openapi.yaml, so this feature is the only thing that can write down its API surface.`,
+                command: `loam delta ${id} --service ${svc} --json`,
+                artifact: "openapi",
+                service: svc,
+                path: api.path,
+            });
+        }
+    }
+    // A requirement with no scenario yields no generated .feature and no
+    // scenario.tested claim: a promise that reaches neither the suite nor the
+    // done-check, and that nothing downstream will ever mention again. One entry
+    // per service rather than per requirement — a delta with forty bare
+    // requirements would otherwise BE the payload (validate caps its details for
+    // the same reason).
+    for (const gap of scans) {
+        if (gap.bare.length === 0 || !services.includes(gap.service))
+            continue;
+        steps.push({
+            code: "next.author-scenarios",
+            statement: `${gap.bare.length} requirement(s) in ${gap.service}'s delta have no '#### Scenario:' ` +
+                `(starting with '${gap.bare[0].name}') — they generate no test and no verify claim.`,
+            command: `loam delta ${id} --service ${gap.service} --json`,
+            artifact: "spec",
+            service: gap.service,
+            path: gap.path,
+        });
+    }
+    if (findings.some((f) => UNPINNED.has(f.code))) {
+        steps.push({
+            code: "next.rebase",
+            statement: `${id} carries requirements or operations with no baseline pin — until they have one the merge cannot tell what it EDITS from what it merely quotes.`,
+            command: `loam rebase ${id}`,
+        });
+    }
+    if (blockedBy.length > 0) {
+        steps.push({
+            code: "next.archive-first",
+            statement: `${id} builds on ${blockedBy.join(", ")}, which ${blockedBy.length === 1 ? "has" : "have"} to archive first.`,
+            command: `loam dependencies ${id} --json`,
+        });
+    }
+    // Everything either gate refuses on, not just the errors: a warning marked
+    // `gates: true` stops archive exactly as hard, and leaving it out of the
+    // steps was the other half of leaving it out of the stage.
+    const blocking = findings.filter(unshippable);
+    if (blocking.length > 0) {
+        const gating = blocking.filter((f) => f.gates === true && f.severity !== "error").length;
+        steps.push({
+            code: "next.fix-coherence",
+            statement: `${id} has ${blocking.length} finding(s) that stop it, starting with ${blocking[0].code}` +
+                (gating > 0
+                    ? ` — ${gating} of them ${gating === 1 ? "is a warning that GATES" : "are warnings that GATE"} archive, ` +
+                        "which `validate` grades valid, so its exit code alone will not show you why archive refuses."
+                    : " — the axes disagree, and archive refuses."),
+            command: `loam validate ${id} --json`,
+        });
+    }
+    // The implementation half of the forward flow, which next[] never named at
+    // all: an agent read "author the spec" and then "record the verification",
+    // with nothing in between saying where a test comes from — so the only way
+    // left to answer a scenario claim was its own word, through `--record`.
+    steps.push(...testStep(id, verification, { services, scans, boundService }));
+    steps.push(...verifyStep(id, verification, { artifacts, services, boundService }));
+    // Always last, and always present: a feature whose every artifact holds and
+    // whose record is complete still has one thing left to do, and an empty
+    // `next[]` would leave a caller unable to tell "finished" from "this command
+    // had nothing to say".
+    //
+    // The sentence used to say the feature "ships once everything above is
+    // done", which promised a check archive never makes: it refuses on the
+    // documents (coherence, the gating warnings) and looks at neither the code
+    // nor the verification record. So it says what archive does, and what it
+    // does not, in the order a reader decides in.
+    steps.push({
+        code: "next.archive",
+        statement: steps.length === 0
+            ? `${id} is authored, coherent and verified — archive it to fold its deltas into the living docs.`
+            : `Archive ${id} once the steps above are done. Archive merges its deltas into the living docs and checks only ` +
+                "the documents — not the code, not the verification record — so it will not stop you archiving work nobody " +
+                "built. The dry run writes nothing and lists every file the merge would touch.",
+        command: `loam archive ${id} --dry-run --json`,
+    });
+    return steps;
+}
+//# sourceMappingURL=next.js.map

package/dist/core/status/feature/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../../../src/core/status/feature/next.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `next[]` — one feature.\n *\n * The payload's reason to exist. Each entry carries a stable `code` to branch\n * on, one sentence a person can read, and the literal command to run — ordered,\n * first entry first. `command` is the loam invocation that carries the step\n * forward: the one that does the work where loam does it (`rebase`, `archive`),\n * and the one that states or grades the work where the author does it (`delta`,\n * `validate`, `verify`). It is never a command that would write the artifact\n * behind the author's back — loam does not author.\n *\n * `next` is never empty. A feature with nothing outstanding still has a next\n * step (archive it), and a repository with nothing outstanding still has one (keep\n * the fleet green) — an empty array would be indistinguishable from a bug in\n * the caller's own parsing.\n */\nimport type { Finding } from \"../../vocabulary/report.js\";\nimport { recoverStep } from \"../interrupted.js\";\nimport type { ArtifactId, ArtifactState, NextStep } from \"../report.js\";\nimport { testStep, verifyStep } from \"../verification.js\";\nimport { type FeatureState } from \"./state.js\";\nimport { archivedVerification } from \"./words.js\";\n\n/**\n * Would either gate refuse this? Severity answers `validate`'s question and\n * `gates` answers archive's; a finding that fails EITHER is one an author has\n * work to do about, and collapsing them to `severity === \"error\"` is how\n * `status` came to print \"ship it\" beside a warning archive exits 1 on.\n */\nexport function unshippable(f: Finding): boolean {\n  return f.severity === \"error\" || f.gates === true;\n}\n\n/** Codes whose one fix is `loam rebase`: a pin nobody ever wrote, on any of the three axes. */\nconst UNPINNED = new Set([\"delta.baseline-missing\", \"openapi.baseline-missing\", \"asyncapi.baseline-missing\"]);\n\nexport function featureNext(state: FeatureState, boundService: string | undefined): NextStep[] {\n  const { feature, services, artifacts, findings, blockedBy, verification, scans, interrupted } = state;\n  const id = feature.id;\n  // Before the archived shortcut: the interrupted commit may be this feature's\n  // own, and \"it shipped\" is not a thing to tell somebody whose living docs are\n  // half-written.\n  const first = interrupted === null ? [] : [recoverStep(interrupted)];\n  if (feature.archived) {\n    return [\n      ...first,\n      {\n        code: \"next.archived\",\n        // Not \"it shipped\": archive folds documents and checks no code and no\n        // evidence, so the sentence says what archiving did and then, in the\n        // done-check's own words, whether anybody verified it.\n        statement:\n          `${id} is archived — its deltas are folded into the living docs. Archiving checks documents, not code: ` +\n          `${id} is ${archivedVerification(verification)}.`,\n        command: `loam show ${id} --json`,\n      },\n    ];\n  }\n\n  const steps: NextStep[] = [...first];\n  const owed = (kind: ArtifactId, service?: string): ArtifactState | undefined =>\n    artifacts.find(\n      (a) => a.id === kind && a.status === \"missing\" && (service === undefined || a.service === service),\n    );\n\n  const intent = owed(\"intent\");\n  if (intent !== undefined) {\n    steps.push({\n      code: \"next.author-intent\",\n      statement: `Write ${intent.path} — what ${id} is for, in prose, before anything is derived from it.`,\n      command: `loam validate ${id} --json`,\n      artifact: \"intent\",\n      path: intent.path,\n    });\n  }\n\n  if (services.length === 0) {\n    steps.push({\n      code: \"next.touch-service\",\n      statement: `${id} carries no per-service delta — add specs/<service>/spec.md for every service it changes.`,\n      command: \"loam list services --json\",\n    });\n  }\n\n  for (const svc of services) {\n    const spec = owed(\"spec\", svc);\n    if (spec !== undefined) {\n      steps.push({\n        code: \"next.author-spec\",\n        statement: `Write ${spec.path} — the ADDED/MODIFIED/REMOVED requirements ${id} makes to ${svc}, each with a scenario.`,\n        command: `loam delta ${id} --service ${svc} --json`,\n        artifact: \"spec\",\n        service: svc,\n        path: spec.path,\n      });\n    }\n    const api = owed(\"openapi\", svc);\n    if (api !== undefined) {\n      steps.push({\n        code: \"next.author-openapi\",\n        // Not \"the service is not in the living docs\": a service adopted\n        // without a contract is the commoner case, and that wording sent a\n        // reader looking for a directory that was right there. And not \"the\n        // operations it governs\" either — what owes the file may be an edge\n        // the delta draws INTO the service rather than any `Operations:` line\n        // (owesContract), so naming governed operations promised the author a\n        // list they would go looking for and not find.\n        statement: `Write ${api.path} — nothing gives ${svc} a living openapi.yaml, so this feature is the only thing that can write down its API surface.`,\n        command: `loam delta ${id} --service ${svc} --json`,\n        artifact: \"openapi\",\n        service: svc,\n        path: api.path,\n      });\n    }\n  }\n\n  // A requirement with no scenario yields no generated .feature and no\n  // scenario.tested claim: a promise that reaches neither the suite nor the\n  // done-check, and that nothing downstream will ever mention again. One entry\n  // per service rather than per requirement — a delta with forty bare\n  // requirements would otherwise BE the payload (validate caps its details for\n  // the same reason).\n  for (const gap of scans) {\n    if (gap.bare.length === 0 || !services.includes(gap.service)) continue;\n    steps.push({\n      code: \"next.author-scenarios\",\n      statement:\n        `${gap.bare.length} requirement(s) in ${gap.service}'s delta have no '#### Scenario:' ` +\n        `(starting with '${gap.bare[0]!.name}') — they generate no test and no verify claim.`,\n      command: `loam delta ${id} --service ${gap.service} --json`,\n      artifact: \"spec\",\n      service: gap.service,\n      path: gap.path,\n    });\n  }\n\n  if (findings.some((f) => UNPINNED.has(f.code))) {\n    steps.push({\n      code: \"next.rebase\",\n      statement: `${id} carries requirements or operations with no baseline pin — until they have one the merge cannot tell what it EDITS from what it merely quotes.`,\n      command: `loam rebase ${id}`,\n    });\n  }\n\n  if (blockedBy.length > 0) {\n    steps.push({\n      code: \"next.archive-first\",\n      statement: `${id} builds on ${blockedBy.join(\", \")}, which ${blockedBy.length === 1 ? \"has\" : \"have\"} to archive first.`,\n      command: `loam dependencies ${id} --json`,\n    });\n  }\n\n  // Everything either gate refuses on, not just the errors: a warning marked\n  // `gates: true` stops archive exactly as hard, and leaving it out of the\n  // steps was the other half of leaving it out of the stage.\n  const blocking = findings.filter(unshippable);\n  if (blocking.length > 0) {\n    const gating = blocking.filter((f) => f.gates === true && f.severity !== \"error\").length;\n    steps.push({\n      code: \"next.fix-coherence\",\n      statement:\n        `${id} has ${blocking.length} finding(s) that stop it, starting with ${blocking[0]!.code}` +\n        (gating > 0\n          ? ` — ${gating} of them ${gating === 1 ? \"is a warning that GATES\" : \"are warnings that GATE\"} archive, ` +\n            \"which `validate` grades valid, so its exit code alone will not show you why archive refuses.\"\n          : \" — the axes disagree, and archive refuses.\"),\n      command: `loam validate ${id} --json`,\n    });\n  }\n\n  // The implementation half of the forward flow, which next[] never named at\n  // all: an agent read \"author the spec\" and then \"record the verification\",\n  // with nothing in between saying where a test comes from — so the only way\n  // left to answer a scenario claim was its own word, through `--record`.\n  steps.push(...testStep(id, verification, { services, scans, boundService }));\n  steps.push(...verifyStep(id, verification, { artifacts, services, boundService }));\n\n  // Always last, and always present: a feature whose every artifact holds and\n  // whose record is complete still has one thing left to do, and an empty\n  // `next[]` would leave a caller unable to tell \"finished\" from \"this command\n  // had nothing to say\".\n  //\n  // The sentence used to say the feature \"ships once everything above is\n  // done\", which promised a check archive never makes: it refuses on the\n  // documents (coherence, the gating warnings) and looks at neither the code\n  // nor the verification record. So it says what archive does, and what it\n  // does not, in the order a reader decides in.\n  steps.push({\n    code: \"next.archive\",\n    statement:\n      steps.length === 0\n        ? `${id} is authored, coherent and verified — archive it to fold its deltas into the living docs.`\n        : `Archive ${id} once the steps above are done. Archive merges its deltas into the living docs and checks only ` +\n          \"the documents — not the code, not the verification record — so it will not stop you archiving work nobody \" +\n          \"built. The dry run writes nothing and lists every file the merge would touch.\",\n    command: `loam archive ${id} --dry-run --json`,\n  });\n  return steps;\n}\n"]}

package/dist/core/status/feature/state.js

@@ -0,0 +1,21 @@
+/**
+ * One feature, fully graded — the record every question in this package asks
+ * about.
+ *
+ * It exists because eight functions took the same seven or nine values in
+ * hand-kept order: a feature, its services, its artifacts, its findings, its
+ * verification, its scans, what it is blocked by, and whether a commit was
+ * interrupted. Positional, `services` and `blockedBy` are both `string[]` and
+ * transposing them compiles.
+ *
+ * Note what is NOT in here: the `--service` lens. The whole feature is graded
+ * and the view is narrowed afterwards, never the other way round — a rollup
+ * that moved with the lens would report a feature `ready` because the one
+ * service you asked about happens to be written, while three others have
+ * nothing.
+ */
+import {} from "../../repo/entries.js";
+import {} from "../../vocabulary/report.js";
+import {} from "../scan.js";
+import {} from "../report.js";
+//# sourceMappingURL=state.js.map

package/dist/core/status/feature/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../src/core/status/feature/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAqB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAgB,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAkB,MAAM,YAAY,CAAC;AAC5C,OAAO,EAIN,MAAM,cAAc,CAAC","sourcesContent":["/**\n * One feature, fully graded — the record every question in this package asks\n * about.\n *\n * It exists because eight functions took the same seven or nine values in\n * hand-kept order: a feature, its services, its artifacts, its findings, its\n * verification, its scans, what it is blocked by, and whether a commit was\n * interrupted. Positional, `services` and `blockedBy` are both `string[]` and\n * transposing them compiles.\n *\n * Note what is NOT in here: the `--service` lens. The whole feature is graded\n * and the view is narrowed afterwards, never the other way round — a rollup\n * that moved with the lens would report a feature `ready` because the one\n * service you asked about happens to be written, while three others have\n * nothing.\n */\nimport { type FeatureEntry } from \"../../repo/entries.js\";\nimport { type Finding } from \"../../vocabulary/report.js\";\nimport { type DeltaScan } from \"../scan.js\";\nimport {\n  type ArtifactState,\n  type InterruptedCommit,\n  type VerificationState,\n} from \"../report.js\";\n\nexport interface FeatureState {\n  feature: FeatureEntry;\n  /** Every service the feature touches — not the narrowed view. */\n  services: string[];\n  artifacts: ArtifactState[];\n  findings: Finding[];\n  /** Features that have to archive before this one can. */\n  blockedBy: string[];\n  verification: VerificationState;\n  scans: DeltaScan[];\n  interrupted: InterruptedCommit | null;\n}\n"]}

package/dist/core/status/feature/words.js

@@ -0,0 +1,96 @@
+/** `docs ready — nothing verified yet (0 of 19 claims answered)` and its siblings. */
+export function stageWords(f) {
+    // Ahead of `archived`, and ahead of `blockedBy`: an interrupted commit blocks
+    // even a feature that archived (the files that say so may be half-written),
+    // and a feature also waiting on another one cannot move until the repair
+    // either — that one cannot archive past the journal any more than this can.
+    if (f.stage === "blocked" && f.interrupted) {
+        return "blocked — an interrupted archive or unarchive has to be recovered first";
+    }
+    if (f.archived)
+        return `archived — ${archivedVerification(f.verification)}`;
+    switch (f.stage) {
+        case "blocked":
+            return `blocked — waiting on ${f.blockedBy.join(", ")} to archive first`;
+        case "missing":
+            return `being written — ${missingWords(f)}`;
+        case "draft":
+            return `the docs need fixing — ${f.blocking ?? "some"} finding(s) stop it`;
+        case "ready":
+            return `docs ready — ${openVerification(f.verification, f.asked)}`;
+        case "done":
+            // The fleet form grades nothing, so it cannot say archive will take it —
+            // only that the record is verified. The feature's own status can.
+            return f.blocking === null
+                ? "verified — every claim confirmed by evidence; its own status says whether archive will take it"
+                : "verified — every claim confirmed by evidence; ready to archive";
+    }
+}
+/** `FEAT-101 (Payment splitting)` — the id a machine keys on, and the words a person recognises. */
+export function featureLabel(f) {
+    return f.title === null ? f.id : `${f.id} (${f.title})`;
+}
+/** The fleet form's facts: presence and an existing record only, graded nothing. */
+export function fleetStageWords(f, interrupted) {
+    return stageWords({
+        stage: f.stage,
+        archived: false,
+        verification: f.verification,
+        asked: null,
+        missing: f.missing,
+        narrowed: false,
+        services: f.services.length,
+        blockedBy: f.blockedBy,
+        interrupted,
+        blocking: null,
+    });
+}
+/** What is not written yet — the whole feature's list, or as much of it as a `--service` view can see. */
+function missingWords(f) {
+    const owed = f.missing.length > 0 ? `not written yet: ${f.missing.join(", ")}` : "";
+    if (f.services === 0)
+        return owed === "" ? "no service delta yet" : `no service delta yet; ${owed}`;
+    // Only a narrowed view can reach a `missing` stage with nothing missing in it:
+    // the stage is the whole feature's, the rows are the lens's.
+    if (owed === "")
+        return "another service's artifacts are not written yet (drop --service to see which)";
+    return f.narrowed ? `${owed} (in this --service view; drop --service for the whole feature)` : owed;
+}
+/** Where an in-flight feature's verification stands, counted. */
+function openVerification(v, asked) {
+    if (v.state === "absent") {
+        return asked === null
+            ? "nothing verified yet (no verification record)"
+            : `nothing verified yet (0 of ${asked} claim(s) answered)`;
+    }
+    if (v.state === "unreadable")
+        return "its verification record does not read";
+    if (v.state === "stale")
+        return "its verification record is stale — it answers an older checklist than the one asked now";
+    const open = v.unconfirmed + v.unanswered;
+    if (v.verdict === "attested") {
+        return `every claim answered, but ${v.attested} scenario(s) rest on an agent's word, not a test run (attested)`;
+    }
+    if (v.claims === 0)
+        return "its verification record answers no claims";
+    return `${v.confirmed} of ${v.claims} claim(s) confirmed${open > 0 ? `, ${open} open` : ""}`;
+}
+/**
+ * An archived feature's verification, said plainly. Archive merges documents
+ * and checks no code and no evidence, so this sentence — not the word
+ * `archived`, and not the stage `done` — is what says whether anybody verified
+ * the thing that shipped.
+ */
+export function archivedVerification(v) {
+    if (v.state === "absent")
+        return "never verified (no verification record)";
+    if (v.state === "unreadable")
+        return "its verification record does not read";
+    if (v.verdict === "verified")
+        return `verified (${v.confirmed} of ${v.claims} claim(s) confirmed)`;
+    if (v.verdict === "attested") {
+        return `attested, not verified: ${v.attested} scenario(s) rest on an agent's word (${v.confirmed} of ${v.claims} claim(s) confirmed)`;
+    }
+    return `not fully verified (${v.confirmed} of ${v.claims} claim(s) confirmed)`;
+}
+//# sourceMappingURL=words.js.map

package/dist/core/status/feature/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../../../src/core/status/feature/words.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The stage, said in words a person can act on.\n *\n * `stage` is a closed vocabulary an agent branches on (../report.ts), and it is\n * frozen: renaming `ready` would break every script that reads it. What was\n * wrong was printing it BARE. `ready` means the documents are written and pass\n * the shared checks — nothing about code — and `loam status FEAT-1 — ready`\n * over a feature nobody had built or verified read as \"ready to ship\". `done\n * (archived)` over a feature that was never verified read as \"shipped and\n * checked\", when archive checks documents and nothing else.\n *\n * So the machine value stays exactly what it was, and every human surface\n * (the status header and rows, the `next[]` statements that quote a stage)\n * says it through this one module, with the counts that make it true: how\n * many claims were answered of how many asked. One module, because a second\n * spelling of \"what does ready mean\" is the drift that made the first one\n * misleading.\n */\nimport type { ArtifactStatus, FleetFeatureState, VerificationState } from \"../report.js\";\n\n/**\n * What a stage sentence needs to be honest — every field a fact somebody\n * measured, never one inferred from another field being empty. The sentence\n * used to guess \"interrupted commit\" from an empty `blockedBy` and \"no service\n * delta\" from an empty `missing`, and both guesses were wrong in a state the\n * report could reach.\n */\nexport interface StageFacts {\n  stage: ArtifactStatus;\n  archived: boolean;\n  verification: VerificationState;\n  /** Claims the checklist asks now — the single-feature form derives it; null where nothing was derived. */\n  asked: number | null;\n  /** The owed artifacts not written yet (labels), for `missing`. */\n  missing: string[];\n  /** True when `missing` was read off a `--service` view rather than the whole feature. */\n  narrowed: boolean;\n  /** How many services the feature carries a delta for. */\n  services: number;\n  /** Features that must archive first, for `blocked`. */\n  blockedBy: string[];\n  /** A `.loam-commit` journal is present: some writer was killed mid-commit. */\n  interrupted: boolean;\n  /** Findings that stop the feature; null where nothing was graded (the fleet form). */\n  blocking: number | null;\n}\n\n/** `docs ready — nothing verified yet (0 of 19 claims answered)` and its siblings. */\nexport function stageWords(f: StageFacts): string {\n  // Ahead of `archived`, and ahead of `blockedBy`: an interrupted commit blocks\n  // even a feature that archived (the files that say so may be half-written),\n  // and a feature also waiting on another one cannot move until the repair\n  // either — that one cannot archive past the journal any more than this can.\n  if (f.stage === \"blocked\" && f.interrupted) {\n    return \"blocked — an interrupted archive or unarchive has to be recovered first\";\n  }\n  if (f.archived) return `archived — ${archivedVerification(f.verification)}`;\n  switch (f.stage) {\n    case \"blocked\":\n      return `blocked — waiting on ${f.blockedBy.join(\", \")} to archive first`;\n    case \"missing\":\n      return `being written — ${missingWords(f)}`;\n    case \"draft\":\n      return `the docs need fixing — ${f.blocking ?? \"some\"} finding(s) stop it`;\n    case \"ready\":\n      return `docs ready — ${openVerification(f.verification, f.asked)}`;\n    case \"done\":\n      // The fleet form grades nothing, so it cannot say archive will take it —\n      // only that the record is verified. The feature's own status can.\n      return f.blocking === null\n        ? \"verified — every claim confirmed by evidence; its own status says whether archive will take it\"\n        : \"verified — every claim confirmed by evidence; ready to archive\";\n  }\n}\n\n/** `FEAT-101 (Payment splitting)` — the id a machine keys on, and the words a person recognises. */\nexport function featureLabel(f: { id: string; title: string | null }): string {\n  return f.title === null ? f.id : `${f.id} (${f.title})`;\n}\n\n/** The fleet form's facts: presence and an existing record only, graded nothing. */\nexport function fleetStageWords(f: FleetFeatureState, interrupted: boolean): string {\n  return stageWords({\n    stage: f.stage,\n    archived: false,\n    verification: f.verification,\n    asked: null,\n    missing: f.missing,\n    narrowed: false,\n    services: f.services.length,\n    blockedBy: f.blockedBy,\n    interrupted,\n    blocking: null,\n  });\n}\n\n/** What is not written yet — the whole feature's list, or as much of it as a `--service` view can see. */\nfunction missingWords(f: StageFacts): string {\n  const owed = f.missing.length > 0 ? `not written yet: ${f.missing.join(\", \")}` : \"\";\n  if (f.services === 0) return owed === \"\" ? \"no service delta yet\" : `no service delta yet; ${owed}`;\n  // Only a narrowed view can reach a `missing` stage with nothing missing in it:\n  // the stage is the whole feature's, the rows are the lens's.\n  if (owed === \"\") return \"another service's artifacts are not written yet (drop --service to see which)\";\n  return f.narrowed ? `${owed} (in this --service view; drop --service for the whole feature)` : owed;\n}\n\n/** Where an in-flight feature's verification stands, counted. */\nfunction openVerification(v: VerificationState, asked: number | null): string {\n  if (v.state === \"absent\") {\n    return asked === null\n      ? \"nothing verified yet (no verification record)\"\n      : `nothing verified yet (0 of ${asked} claim(s) answered)`;\n  }\n  if (v.state === \"unreadable\") return \"its verification record does not read\";\n  if (v.state === \"stale\") return \"its verification record is stale — it answers an older checklist than the one asked now\";\n  const open = v.unconfirmed + v.unanswered;\n  if (v.verdict === \"attested\") {\n    return `every claim answered, but ${v.attested} scenario(s) rest on an agent's word, not a test run (attested)`;\n  }\n  if (v.claims === 0) return \"its verification record answers no claims\";\n  return `${v.confirmed} of ${v.claims} claim(s) confirmed${open > 0 ? `, ${open} open` : \"\"}`;\n}\n\n/**\n * An archived feature's verification, said plainly. Archive merges documents\n * and checks no code and no evidence, so this sentence — not the word\n * `archived`, and not the stage `done` — is what says whether anybody verified\n * the thing that shipped.\n */\nexport function archivedVerification(v: VerificationState): string {\n  if (v.state === \"absent\") return \"never verified (no verification record)\";\n  if (v.state === \"unreadable\") return \"its verification record does not read\";\n  if (v.verdict === \"verified\") return `verified (${v.confirmed} of ${v.claims} claim(s) confirmed)`;\n  if (v.verdict === \"attested\") {\n    return `attested, not verified: ${v.attested} scenario(s) rest on an agent's word (${v.confirmed} of ${v.claims} claim(s) confirmed)`;\n  }\n  return `not fully verified (${v.confirmed} of ${v.claims} claim(s) confirmed)`;\n}\n"]}

package/dist/core/status/fleet/fleet.js

@@ -0,0 +1,216 @@
+/**
+ * The whole repository — why the fleet form is cheaper than the feature form.
+ *
+ * `loam status` with no feature runs over every active feature, and deriving a
+ * coherence report or a verification checklist per feature means spinning a
+ * fresh LikeC4 workspace per feature. On a fleet-sized repository that is the
+ * cost that gets a command switched off — `list` made the same call about its
+ * verification column. So the fleet form grades nothing: it reports artifact
+ * PRESENCE, the dependency order, and a verification record only where one
+ * already exists, and its `next[]` hands off to `loam status <FEAT>`, which is
+ * where the checks actually run.
+ */
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { analyzeDependencies } from "../../dependencies/dependencies.js";
+import {} from "../../dependencies/facts.js";
+import { isLandscapeStub } from "../../scaffold/landscape.js";
+import { repoPath } from "../../envelope/json.js";
+import { FleetContext } from "../../fleet-context.js";
+import { compareIds } from "../../repo/entries.js";
+import { featurePaths, featureSpecPaths, landscapePath } from "../../repo/paths.js";
+import { featureTitle, listFeatures, listServices } from "../../repo/repo.js";
+import { introducingFeatures } from "../../projection/introduced.js";
+import { contractEvidence, contractOwners, contractsHeldElsewhere, owesContract } from "../contracts.js";
+import { readInterruptedCommit } from "../interrupted.js";
+import { undocumented, vouched, } from "../report.js";
+import { scanDeltas } from "../scan.js";
+import { fullyVerified, verificationState } from "../verification.js";
+import { fleetNext, groupServiceSteps, perServiceSteps } from "./next.js";
+/**
+ * The fleet view: how much of `services/` anyone has written down, every
+ * feature in flight with the stage it has reached, and the order they have to
+ * land in. Nothing here is graded — the module header says why — so the stages
+ * are drawn from artifact presence and from a record that already exists, and
+ * `next[]` hands off to `loam status <FEAT>` for everything else.
+ */
+export async function fleetStatus(docsDir, opts) {
+    const { context } = opts;
+    const interrupted = await readInterruptedCommit(docsDir);
+    const narrowed = opts.service;
+    const all = await listServices(docsDir, context);
+    const services = narrowed === undefined ? all : all.filter((s) => s.id === narrowed);
+    // The service this repository says it IS, and whether the fleet has heard of
+    // it. Asked against the UNNARROWED list, because "is it adopted" is a question
+    // about the fleet and not about the view.
+    //
+    // Both facts travel, where only the unadopted case used to. This value was a
+    // `string | null` that went null exactly when the service directory EXISTED,
+    // so the walk could see the repository it stands in only while that
+    // repository was undocumented — and a developer in an adopted service repo
+    // got the whole fleet's worklist with their own boundary buried in it.
+    //
+    // And the third fact: which feature in flight introduces it, when the fleet
+    // has no directory for it. Through the shared resolver, so `status` and
+    // `show`/`context`/`steps` agree on what "introduced" means.
+    const binding = opts.bound === undefined
+        ? null
+        : {
+            id: opts.bound,
+            adopted: all.some((s) => s.id === opts.bound),
+            introducedBy: (await introducingFeatures(docsDir, opts.bound, context)).map((f) => f.id),
+        };
+    const graph = await analyzeDependencies(docsDir, undefined, context);
+    const entries = await listFeatures(docsDir, {}, context);
+    const inScope = narrowed === undefined ? entries : entries.filter((f) => f.services.some((s) => s === narrowed));
+    // Once for the fleet, not once per feature: which features hold a contract
+    // for which service is one fact about the repository, and every feature below
+    // reads its own row out of it. Built over the UNNARROWED list on purpose — a
+    // `--service` view still has to know that a feature outside it discharges the
+    // contract, or the narrowing would invent an obligation.
+    const owners = await contractOwners(docsDir, context);
+    const features = await Promise.all(inScope.map((f) => fleetFeature(docsDir, f, {
+        graph,
+        contracted: contractsHeldElsewhere(owners, f.id),
+        living: new Map(all.map((s) => [s.id, s])),
+        context,
+        interrupted,
+    })));
+    features.sort((a, b) => compareIds(a.id, b.id));
+    // The first-hour ladder's fact, computed exactly when the ladder can apply
+    // — an unnarrowed run over a fleet with zero services and zero features —
+    // so the read disappears from every repository that has anything in it.
+    // Withheld on narrowed runs for the same reason the binding is withheld
+    // below: `--service X` is an explicit question about X, and the
+    // repository's onboarding ladder would be a different question's answer.
+    const teaching = narrowed === undefined && services.length === 0 && features.length === 0
+        ? { landscape: await landscapeTeaching(docsDir) }
+        : null;
+    return {
+        interrupted,
+        services: {
+            total: services.length,
+            undocumented: services.filter(undocumented).length,
+            draft: services.filter((s) => !undocumented(s) && !vouched(s)).length,
+            vouched: services.filter(vouched).length,
+            // A subset of `vouched`, never a fourth bucket: those services ARE
+            // vouched, and the three counts still sum to `total`. It rides beside
+            // the count it qualifies because this line is the fleet's trust
+            // headline, and "118 vouched" over a fleet where 90 of them were read
+            // from a sample is the misreading the scope exists to prevent.
+            sampledVouched: services.filter((s) => vouched(s) && s.vouchScope === "sampled").length,
+            // The other subset, for the same reason: "118 vouched" over a fleet where
+            // twenty documents were edited after the person read them is the
+            // trust headline lying by omission.
+            contentStale: services.filter((s) => vouched(s) && s.contentStale.length > 0).length,
+        },
+        features,
+        order: graph.order.filter((id) => features.some((f) => f.id === id)),
+        service: narrowed ?? null,
+        // The binding is passed only when this run was NOT narrowed, and that guard
+        // is unchanged now that the binding also decides ORDER. `--service X` is an
+        // explicit question about X, and answering it with a step about whichever
+        // service loam.json happens to name would be a different question's answer
+        // at the top of the list — which is as true of a rung promoted to the front
+        // as it was of `next.adopt-bound` emitted out of nowhere. A narrowed run
+        // sees at most the one service it asked about anyway, so withholding the
+        // binding here costs the reader nothing and keeps `--service X` answering
+        // only about X.
+        next: fleetNext({ services, features, graph, interrupted, teaching }, narrowed === undefined ? binding : null),
+        // The same rungs `next[]` carries, from the same function, before the cap.
+        serviceSteps: groupServiceSteps(perServiceSteps(services, narrowed === undefined && binding?.adopted === true ? binding.id : null)),
+    };
+}
+/**
+ * Which first-hour state the fleet map is in: absent, still the scaffold's own
+ * untouched bytes, or authored. One file read and a byte comparison — the
+ * module header's cost rule stands, no LikeC4 workspace is spun here.
+ */
+async function landscapeTeaching(docsDir) {
+    const lp = landscapePath(docsDir);
+    if (!existsSync(lp))
+        return "missing";
+    try {
+        return isLandscapeStub(await readFile(lp, "utf8")) ? "stub" : "authored";
+    }
+    catch {
+        // Unreadable is not untouched. A map that cannot be read — a directory in
+        // the file's place, a permission — must not be called the scaffold's stub
+        // ("missing" and "stub" would each put a false statement in next[]), so it
+        // reads as "authored", which only drops the one teaching step: the gate
+        // entry still names `loam validate --all`, where an unreadable landscape
+        // is actually graded, and letting this read throw would hand the whole
+        // orientation surface — a command that reports and never gates — to the
+        // repository-unavailable refusal over a file status does not even parse.
+        return "authored";
+    }
+}
+async function fleetFeature(docsDir, feature, view) {
+    const { graph, contracted, living, context, interrupted } = view;
+    const paths = featurePaths(feature.dir);
+    const missing = [];
+    if (!existsSync(paths.intent))
+        missing.push("intent");
+    if (feature.services.length === 0)
+        missing.push("spec");
+    // Requirement text and the delta's op-linked edges, not a coherence run: the
+    // `Operations:` lines are read off the same cached parse `list` already pays
+    // for, and the delta off the parse the dependency graph above already made
+    // through this context — so the contract question (owesContract) spins no
+    // LikeC4 workspace of its own, which is the cost this form refuses.
+    const evidence = await contractEvidence(docsDir, feature, await scanDeltas(docsDir, feature, feature.services, context), context);
+    for (const svc of feature.services) {
+        const p = featureSpecPaths(feature.dir, svc);
+        // EITHER corpus satisfies it. What a service delta owes is a requirement
+        // delta, and `arch.spec.md` is the other one — same grammar, same delta
+        // algebra, read by `featureChecklist` — so an architecture-only feature is
+        // complete and every gate already says so. This form asked for `spec.md`
+        // specifically, which broke the rule the comment two lines down states
+        // about the contract question: the two forms disagreed, `loam status`
+        // reporting `missing <svc>/spec` over a feature `loam status <FEAT>` and
+        // `loam validate --feature` both called complete. The name stays
+        // `<svc>/spec` when NEITHER exists, because the business delta is the one
+        // an author writes by default.
+        if (!existsSync(p.spec) && !existsSync(p.archSpec))
+            missing.push(`${svc}/spec`);
+        // The same question featureArtifacts asks, through the same function: the
+        // two forms must never disagree about whether a feature owes a contract.
+        if (owesContract(living.get(svc), contracted.has(svc), evidence(svc)) && !existsSync(p.openapi)) {
+            missing.push(`${svc}/openapi`);
+        }
+    }
+    const verification = (await verificationState(docsDir, feature)).state;
+    const blockedBy = graph.nodes.find((n) => n.id === feature.id)?.dependsOn ?? [];
+    // No `draft` here, ever: that verdict needs the coherence run this form
+    // refuses to pay for, and inferring it from presence alone would be a second
+    // opinion about validity — the one thing status must never invent.
+    //
+    // The interrupted commit leads, exactly as it does in the feature form: every
+    // presence test below is a question about files a killed `archive` may have
+    // half-written, so answering `done` from them is a claim about bytes nobody
+    // has established. Without this the two forms contradicted each other over
+    // one repository — `loam status --json` said `done` and offered "ship it"
+    // while `loam status <FEAT>` said `blocked` — and the rule in report.ts's
+    // header is that this projection is never greener than the gates.
+    const stage = interrupted !== null
+        ? "blocked"
+        : missing.length > 0
+            ? "missing"
+            : blockedBy.length > 0
+                ? "blocked"
+                : fullyVerified(verification)
+                    ? "done"
+                    : "ready";
+    return {
+        id: feature.id,
+        title: await featureTitle(feature),
+        dirName: feature.dirName,
+        path: repoPath(docsDir, feature.dir),
+        stage,
+        services: feature.services,
+        blockedBy,
+        missing,
+        verification,
+    };
+}
+//# sourceMappingURL=fleet.js.map

package/dist/core/status/fleet/fleet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.js","sourceRoot":"","sources":["../../../../src/core/status/fleet/fleet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The whole repository — why the fleet form is cheaper than the feature form.\n *\n * `loam status` with no feature runs over every active feature, and deriving a\n * coherence report or a verification checklist per feature means spinning a\n * fresh LikeC4 workspace per feature. On a fleet-sized repository that is the\n * cost that gets a command switched off — `list` made the same call about its\n * verification column. So the fleet form grades nothing: it reports artifact\n * PRESENCE, the dependency order, and a verification record only where one\n * already exists, and its `next[]` hands off to `loam status <FEAT>`, which is\n * where the checks actually run.\n */\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { analyzeDependencies } from \"../../dependencies/dependencies.js\";\nimport { type DependencyGraph } from \"../../dependencies/facts.js\";\nimport { isLandscapeStub } from \"../../scaffold/landscape.js\";\nimport { repoPath } from \"../../envelope/json.js\";\nimport { FleetContext } from \"../../fleet-context.js\";\nimport { compareIds, type FeatureEntry, type ServiceEntry } from \"../../repo/entries.js\";\nimport { featurePaths, featureSpecPaths, landscapePath } from \"../../repo/paths.js\";\nimport { featureTitle, listFeatures, listServices } from \"../../repo/repo.js\";\nimport { introducingFeatures } from \"../../projection/introduced.js\";\nimport { contractEvidence, contractOwners, contractsHeldElsewhere, owesContract } from \"../contracts.js\";\nimport { readInterruptedCommit } from \"../interrupted.js\";\nimport {\n  undocumented,\n  vouched,\n  type ArtifactStatus,\n  type FleetFeatureState,\n  type FleetStatusReport,\n  type InterruptedCommit,\n} from \"../report.js\";\nimport { scanDeltas } from \"../scan.js\";\nimport { fullyVerified, verificationState } from \"../verification.js\";\nimport { fleetNext, groupServiceSteps, perServiceSteps, type Binding } from \"./next.js\";\nimport type { DocsDir } from \"../../kernel/ids/dirs.js\";\n\n/**\n * The fleet view: how much of `services/` anyone has written down, every\n * feature in flight with the stage it has reached, and the order they have to\n * land in. Nothing here is graded — the module header says why — so the stages\n * are drawn from artifact presence and from a record that already exists, and\n * `next[]` hands off to `loam status <FEAT>` for everything else.\n */\nexport async function fleetStatus(\n  docsDir: DocsDir,\n  opts: { service?: string; bound?: string; context: FleetContext },\n): Promise<FleetStatusReport> {\n  const { context } = opts;\n  const interrupted = await readInterruptedCommit(docsDir);\n  const narrowed = opts.service;\n  const all = await listServices(docsDir, context);\n  const services = narrowed === undefined ? all : all.filter((s) => s.id === narrowed);\n  // The service this repository says it IS, and whether the fleet has heard of\n  // it. Asked against the UNNARROWED list, because \"is it adopted\" is a question\n  // about the fleet and not about the view.\n  //\n  // Both facts travel, where only the unadopted case used to. This value was a\n  // `string | null` that went null exactly when the service directory EXISTED,\n  // so the walk could see the repository it stands in only while that\n  // repository was undocumented — and a developer in an adopted service repo\n  // got the whole fleet's worklist with their own boundary buried in it.\n  //\n  // And the third fact: which feature in flight introduces it, when the fleet\n  // has no directory for it. Through the shared resolver, so `status` and\n  // `show`/`context`/`steps` agree on what \"introduced\" means.\n  const binding: Binding | null =\n    opts.bound === undefined\n      ? null\n      : {\n          id: opts.bound,\n          adopted: all.some((s) => s.id === opts.bound),\n          introducedBy: (await introducingFeatures(docsDir, opts.bound, context)).map((f) => f.id),\n        };\n  const graph = await analyzeDependencies(docsDir, undefined, context);\n  const entries = await listFeatures(docsDir, {}, context);\n  const inScope = narrowed === undefined ? entries : entries.filter((f) => f.services.some((s) => s === narrowed));\n  // Once for the fleet, not once per feature: which features hold a contract\n  // for which service is one fact about the repository, and every feature below\n  // reads its own row out of it. Built over the UNNARROWED list on purpose — a\n  // `--service` view still has to know that a feature outside it discharges the\n  // contract, or the narrowing would invent an obligation.\n  const owners = await contractOwners(docsDir, context);\n\n  const features = await Promise.all(\n    inScope.map((f) =>\n      fleetFeature(docsDir, f, {\n        graph,\n        contracted: contractsHeldElsewhere(owners, f.id),\n        living: new Map(all.map((s) => [s.id, s])),\n        context,\n        interrupted,\n      }),\n    ),\n  );\n  features.sort((a, b) => compareIds(a.id, b.id));\n\n  // The first-hour ladder's fact, computed exactly when the ladder can apply\n  // — an unnarrowed run over a fleet with zero services and zero features —\n  // so the read disappears from every repository that has anything in it.\n  // Withheld on narrowed runs for the same reason the binding is withheld\n  // below: `--service X` is an explicit question about X, and the\n  // repository's onboarding ladder would be a different question's answer.\n  const teaching =\n    narrowed === undefined && services.length === 0 && features.length === 0\n      ? { landscape: await landscapeTeaching(docsDir) }\n      : null;\n\n  return {\n    interrupted,\n    services: {\n      total: services.length,\n      undocumented: services.filter(undocumented).length,\n      draft: services.filter((s) => !undocumented(s) && !vouched(s)).length,\n      vouched: services.filter(vouched).length,\n      // A subset of `vouched`, never a fourth bucket: those services ARE\n      // vouched, and the three counts still sum to `total`. It rides beside\n      // the count it qualifies because this line is the fleet's trust\n      // headline, and \"118 vouched\" over a fleet where 90 of them were read\n      // from a sample is the misreading the scope exists to prevent.\n      sampledVouched: services.filter((s) => vouched(s) && s.vouchScope === \"sampled\").length,\n      // The other subset, for the same reason: \"118 vouched\" over a fleet where\n      // twenty documents were edited after the person read them is the\n      // trust headline lying by omission.\n      contentStale: services.filter((s) => vouched(s) && s.contentStale.length > 0).length,\n    },\n    features,\n    order: graph.order.filter((id) => features.some((f) => f.id === id)),\n    service: narrowed ?? null,\n    // The binding is passed only when this run was NOT narrowed, and that guard\n    // is unchanged now that the binding also decides ORDER. `--service X` is an\n    // explicit question about X, and answering it with a step about whichever\n    // service loam.json happens to name would be a different question's answer\n    // at the top of the list — which is as true of a rung promoted to the front\n    // as it was of `next.adopt-bound` emitted out of nowhere. A narrowed run\n    // sees at most the one service it asked about anyway, so withholding the\n    // binding here costs the reader nothing and keeps `--service X` answering\n    // only about X.\n    next: fleetNext(\n      { services, features, graph, interrupted, teaching },\n      narrowed === undefined ? binding : null,\n    ),\n    // The same rungs `next[]` carries, from the same function, before the cap.\n    serviceSteps: groupServiceSteps(\n      perServiceSteps(services, narrowed === undefined && binding?.adopted === true ? binding.id : null),\n    ),\n  };\n}\n\n/**\n * Which first-hour state the fleet map is in: absent, still the scaffold's own\n * untouched bytes, or authored. One file read and a byte comparison — the\n * module header's cost rule stands, no LikeC4 workspace is spun here.\n */\nasync function landscapeTeaching(docsDir: DocsDir): Promise<\"missing\" | \"stub\" | \"authored\"> {\n  const lp = landscapePath(docsDir);\n  if (!existsSync(lp)) return \"missing\";\n  try {\n    return isLandscapeStub(await readFile(lp, \"utf8\")) ? \"stub\" : \"authored\";\n  } catch {\n    // Unreadable is not untouched. A map that cannot be read — a directory in\n    // the file's place, a permission — must not be called the scaffold's stub\n    // (\"missing\" and \"stub\" would each put a false statement in next[]), so it\n    // reads as \"authored\", which only drops the one teaching step: the gate\n    // entry still names `loam validate --all`, where an unreadable landscape\n    // is actually graded, and letting this read throw would hand the whole\n    // orientation surface — a command that reports and never gates — to the\n    // repository-unavailable refusal over a file status does not even parse.\n    return \"authored\";\n  }\n}\n\n/** What a feature's fleet row needs about the fleet AROUND it. */\ninterface FleetView {\n  graph: DependencyGraph;\n  /** Operations some other feature's contract already holds. */\n  contracted: ReadonlySet<string>;\n  /** The enumeration's entries by id — where each living service is and what it has (owesContract reads both). */\n  living: ReadonlyMap<string, ServiceEntry>;\n  context: FleetContext;\n  interrupted: InterruptedCommit | null;\n}\n\nasync function fleetFeature(\n  docsDir: DocsDir,\n  feature: FeatureEntry,\n  view: FleetView,\n): Promise<FleetFeatureState> {\n  const { graph, contracted, living, context, interrupted } = view;\n  const paths = featurePaths(feature.dir);\n  const missing: string[] = [];\n  if (!existsSync(paths.intent)) missing.push(\"intent\");\n  if (feature.services.length === 0) missing.push(\"spec\");\n  // Requirement text and the delta's op-linked edges, not a coherence run: the\n  // `Operations:` lines are read off the same cached parse `list` already pays\n  // for, and the delta off the parse the dependency graph above already made\n  // through this context — so the contract question (owesContract) spins no\n  // LikeC4 workspace of its own, which is the cost this form refuses.\n  const evidence = await contractEvidence(docsDir, feature, await scanDeltas(docsDir, feature, feature.services, context), context);\n  for (const svc of feature.services) {\n    const p = featureSpecPaths(feature.dir, svc);\n    // EITHER corpus satisfies it. What a service delta owes is a requirement\n    // delta, and `arch.spec.md` is the other one — same grammar, same delta\n    // algebra, read by `featureChecklist` — so an architecture-only feature is\n    // complete and every gate already says so. This form asked for `spec.md`\n    // specifically, which broke the rule the comment two lines down states\n    // about the contract question: the two forms disagreed, `loam status`\n    // reporting `missing <svc>/spec` over a feature `loam status <FEAT>` and\n    // `loam validate --feature` both called complete. The name stays\n    // `<svc>/spec` when NEITHER exists, because the business delta is the one\n    // an author writes by default.\n    if (!existsSync(p.spec) && !existsSync(p.archSpec)) missing.push(`${svc}/spec`);\n    // The same question featureArtifacts asks, through the same function: the\n    // two forms must never disagree about whether a feature owes a contract.\n    if (owesContract(living.get(svc), contracted.has(svc), evidence(svc)) && !existsSync(p.openapi)) {\n      missing.push(`${svc}/openapi`);\n    }\n  }\n  const verification = (await verificationState(docsDir, feature)).state;\n  const blockedBy = graph.nodes.find((n) => n.id === feature.id)?.dependsOn ?? [];\n\n  // No `draft` here, ever: that verdict needs the coherence run this form\n  // refuses to pay for, and inferring it from presence alone would be a second\n  // opinion about validity — the one thing status must never invent.\n  //\n  // The interrupted commit leads, exactly as it does in the feature form: every\n  // presence test below is a question about files a killed `archive` may have\n  // half-written, so answering `done` from them is a claim about bytes nobody\n  // has established. Without this the two forms contradicted each other over\n  // one repository — `loam status --json` said `done` and offered \"ship it\"\n  // while `loam status <FEAT>` said `blocked` — and the rule in report.ts's\n  // header is that this projection is never greener than the gates.\n  const stage: ArtifactStatus =\n    interrupted !== null\n      ? \"blocked\"\n      : missing.length > 0\n        ? \"missing\"\n        : blockedBy.length > 0\n          ? \"blocked\"\n          : fullyVerified(verification)\n            ? \"done\"\n            : \"ready\";\n\n  return {\n    id: feature.id,\n    title: await featureTitle(feature),\n    dirName: feature.dirName,\n    path: repoPath(docsDir, feature.dir),\n    stage,\n    services: feature.services,\n    blockedBy,\n    missing,\n    verification,\n  };\n}\n"]}