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

package/dist/commands/list/list.js

@@ -0,0 +1,343 @@
+import { loadConfig } from "../../core/envelope/config.js";
+import { emitJson, fail, repoPath, reportNoConfig } from "../../core/envelope/json.js";
+import { maturityRollup } from "../../core/vocabulary/maturity.js";
+import { FleetContext } from "../../core/fleet-context.js";
+import { DocsRepoUnavailableError } from "../../core/repo/state.js";
+import { capabilityRollup } from "../../core/capabilities/rollup.js";
+import { invalidVocabularyFinding } from "../../core/capabilities/findings.js";
+import { promisesKeptByFlows } from "../../core/usecases/capability.js";
+import { fleetAdrCount, listFeatures, listFleetTree, listServices } from "../../core/repo/repo.js";
+import { readGlossary } from "../../core/glossary/tree.js";
+import { backlinkIndex } from "../../core/links/backlinks.js";
+import { glossaryDir } from "../../core/repo/authored/paths.js";
+import { docsRepoReady, reportDocsRepoError, reportRepositoryUnavailable } from "../policy/gate.js";
+import { featureVerification, serviceViews } from "./views.js";
+import { capabilityJson, featureJson, glossaryJson, ownersJson, serviceRows, subsystemsJson } from "./json.js";
+import { printCapabilities, printFeatures, printGlossary, printOwners, printServices, printWorklist, } from "./print.js";
+import { fanInByService, reviewLandscape, reviewOrder } from "./review.js";
+import { resolveSubsystemSlice } from "./campaign/campaign.js";
+import { ownersJoin } from "./campaign/owners.js";
+const SECTIONS = ["services", "features", "capabilities", "glossary"];
+/**
+ * What a bare `loam list` shows. `capabilities` is explicit-only, NEVER part
+ * of this default: the no-argument output and its `--json` payload are a
+ * frozen contract, byte-identical whether or not a fleet declares capabilities.
+ */
+const DEFAULT_SECTIONS = ["services", "features"];
+export function registerList(program) {
+    program
+        .command("list")
+        .argument("[section]", "services | features | capabilities | glossary (default: services + features)")
+        .description("List the services and features in the docs repo")
+        .option("--json", "emit the machine contract instead of the human view")
+        .option("--archived", "include archived features")
+        .option("--needs-work", "services only: the adoption worklist — every service below `vouched`, with what it is missing")
+        .option("--review-order", "with --needs-work: order the worklist by blast radius — services the most other services depend on first")
+        .option("--subsystem <name>", "services only: limit the listing to services filed under this subsystem, at any depth ('unfiled' selects the ones filed under none, while nothing in the tree claims that name)")
+        .option("--owners <path>", "services only: group the listing by owning team from this CODEOWNERS file, resolved from the current directory (directory-pattern rules only; unsupported rules are listed as skipped, never guessed)")
+        .action(async (section, opts) => {
+        const json = opts.json === true;
+        // The campaign flags grade services, so — exactly like --needs-work —
+        // they narrow a bare `loam list` to the services section instead of
+        // printing a features table the filter silently does not apply to.
+        const campaign = opts.subsystem !== undefined || opts.owners !== undefined;
+        const wanted = opts.needsWork || campaign
+            ? DEFAULT_SECTIONS.filter((s) => s === "services")
+            : section
+                ? SECTIONS.filter((s) => s === section)
+                : DEFAULT_SECTIONS;
+        if (section && !SECTIONS.includes(section)) {
+            // `invalid-option`, same as show's bad --type: one mistake class, one code.
+            fail(json, "invalid-option", `Unknown section '${section}'. Expected: ${SECTIONS.join(" | ")}.`);
+            return;
+        }
+        if (opts.needsWork && section === "features") {
+            fail(json, "invalid-option", "--needs-work is the service adoption worklist; drop the 'features' section.");
+            return;
+        }
+        if (campaign && section !== undefined && section !== "services") {
+            fail(json, "invalid-option", `--subsystem and --owners grade the services section; drop the '${section}' section.`);
+            return;
+        }
+        // The flag ORDERS the worklist, so it requires the worklist explicitly:
+        // silently implying --needs-work would make one flag change which rows
+        // exist, not only their order.
+        if (opts.reviewOrder && !opts.needsWork) {
+            fail(json, "invalid-option", "--review-order sorts the adoption worklist; add --needs-work.");
+            return;
+        }
+        const loaded = await loadConfig();
+        if (loaded.kind !== "loaded") {
+            reportNoConfig(json, loaded);
+            return;
+        }
+        const config = loaded.config;
+        const { docsDir } = config;
+        // A docsDir that is not a docs repo is refused, never rendered as an empty
+        // fleet — the whole point of the gate (see docs-repo-gate.ts).
+        // `list features` alone does not need services/, so it asks for less;
+        // the capability rollup walks every service's spec files, so it asks for them.
+        const needsServices = wanted.includes("services") || wanted.includes("capabilities") || wanted.includes("glossary");
+        if (!docsRepoReady(json, docsDir, needsServices ? "services" : "docs"))
+            return;
+        try {
+            // One context, one walk: the tree memo answers both the service
+            // entries and the subsystem/unfiled counts beside them.
+            const fleet = new FleetContext();
+            const tree = wanted.includes("services") ? await listFleetTree(docsDir, fleet) : undefined;
+            const services = wanted.includes("services") ? await listServices(docsDir, fleet) : undefined;
+            // --review-order parses the landscape ONCE for both of its consumers —
+            // serviceViews' `called` set (handed in as `preloaded`) and the fan-in
+            // joins below. Without the flag, `undefined` keeps serviceViews' own
+            // load-if-exists behaviour and the run byte-identical to today's.
+            const land = opts.reviewOrder === true && services !== undefined
+                ? await reviewLandscape(docsDir, fleet)
+                : undefined;
+            const views = services ? await serviceViews(docsDir, services, config.service, land) : undefined;
+            // The slice is resolved AFTER the full-fleet views, and rows are
+            // filtered rather than re-derived: fan-in, apiExpected and the missing
+            // lists are fleet facts, and a slice-first derivation would recompute
+            // them against a fleet with the callers outside the slice erased. The
+            // composition is pinned as filter-first-then-rank — ranks stay
+            // contiguous within the filtered set (test/list-campaign.test.ts).
+            // `tree !== undefined` is a type NARROWING, not a branch: a campaign
+            // flag forces the services section, so the tree always exists here.
+            const slice = opts.subsystem !== undefined && tree !== undefined
+                ? resolveSubsystemSlice(tree, opts.subsystem, json)
+                : undefined;
+            if (slice === null)
+                return;
+            // Membership is by DIRECTORY: leaf ids can collide across a broken
+            // tree (`subsystem.name-collision`), and the directory is the row's
+            // actual identity — campaign.ts's SubsystemSlice says why.
+            const shown = slice === undefined ? views : views?.filter((v) => slice.members.has(v.entry.dir));
+            // The fleet's own decision records. Read unconditionally — it is one
+            // existsSync over `architecture/adrs/` and it belongs to the docs repo
+            // rather than to any section, so `loam list features --json` reports it
+            // as truthfully as `loam list services --json` does. Nothing grades it:
+            // an absent directory is 0 and 0 is a fine, permanent answer.
+            const fleetAdrs = await fleetAdrCount(docsDir);
+            const features = wanted.includes("features")
+                ? await listFeatures(docsDir, { includeArchived: opts.archived }, fleet)
+                : undefined;
+            const verification = features
+                ? await Promise.all(features.map((f) => featureVerification(docsDir, f)))
+                : undefined;
+            // The capability section: the vocabulary's own verdict decides the shape.
+            // An INVALID file refuses with `repository-unavailable` — an
+            // empty-looking success over a broken file is the silent hole this
+            // command already refuses elsewhere — while an ABSENT one is an honest
+            // empty answer, because the file is the axis's opt-in. The message is
+            // `capability.invalid`'s own sentence, not the fs-error helper's: the
+            // file WAS read, it just is not a vocabulary, and one diagnosis should
+            // have one spelling wherever it surfaces.
+            const capabilityVocab = wanted.includes("capabilities")
+                ? await fleet.capabilities(docsDir)
+                : undefined;
+            const brokenVocab = capabilityVocab === undefined ? null : invalidVocabularyFinding(capabilityVocab);
+            if (brokenVocab !== null) {
+                fail(json, "repository-unavailable", brokenVocab.message);
+                return;
+            }
+            // The SECOND corpus behind a capability's promises: the `#cap-`/`#req-`
+            // tagged flows. Read only under `loam list capabilities`, and
+            // `promisesKeptByFlows` carries `readUseCases`' byte gate, so a fleet
+            // whose architecture/ never mentions the reserved tag prefix pays a
+            // readdir here rather than a LikeC4 workspace.
+            //
+            // AN UNREADABLE architecture/ DEGRADES, it does not refuse — the
+            // opposite of the invalid vocabulary above, and the difference is which
+            // corpus broke. `architecture/capabilities.yaml` is what the ROWS are
+            // built from: unreadable, there is no listing to print, so refusing is
+            // the only honest answer. The flows are a second corpus over rows that
+            // are already true, and refusing the whole listing because a use-case
+            // document has a syntax error would take `loam list capabilities` away
+            // during exactly the minutes somebody is fixing that document, while
+            // `validate` already reports it as `landscape.invalid`. So the join is
+            // withheld instead — every `keptBy` absent rather than `[]` — and the
+            // reason is stated, which is `core/pack/joins.ts`' holes idiom: carry
+            // what is true, name what could not be looked at, never let the two read
+            // the same.
+            const entries = capabilityVocab === undefined ? undefined : await listServices(docsDir, fleet);
+            const promises = capabilityVocab === undefined || entries === undefined
+                ? undefined
+                : await promisesKeptByFlows({
+                    docsDir,
+                    vocab: capabilityVocab,
+                    known: new Set(entries.map((e) => e.id)),
+                    read: (p) => fleet.readRequirements(p),
+                });
+            const capabilities = capabilityVocab === undefined || entries === undefined
+                ? undefined
+                : await capabilityRollup({
+                    services: entries,
+                    vocab: capabilityVocab,
+                    read: (p) => fleet.readRequirements(p),
+                    ...(promises?.kind === "read" ? { keptByFlows: promises.kept } : {}),
+                });
+            // The glossary section: the tree, and who cites each term. The
+            // citation index is the expensive half — it reads every authored
+            // document in the repository — so it is built only when the section is
+            // asked for, and not at all when `glossary/` does not exist. The
+            // directory's existence is the axis's opt-in, exactly as it is for
+            // `capabilities/`, so a fleet without one prints an empty section
+            // rather than paying for a fleet-wide walk to say so.
+            const glossary = wanted.includes("glossary") ? await readGlossary(glossaryDir(docsDir)) : undefined;
+            const citations = glossary !== undefined && glossary.terms.length > 0 ? await backlinkIndex(docsDir, fleet) : undefined;
+            const terms = glossary?.terms.map((term) => ({
+                term,
+                linkedBy: citations === undefined ? [] : citations.linkersOf(term.path),
+            }));
+            const worklist = (shown ?? []).filter((v) => v.maturity !== "vouched");
+            // The ranked review queue, derived never stored: fan-in is computed
+            // FLEET-WIDE (the joins need every service's slice anyway — and a
+            // --subsystem filter must never change a service's count, only which
+            // rows appear) while ranks are assigned over the WORKLIST only — a
+            // vouched service needs no review, and ranking it would put gaps in
+            // the queue. The worklist is already sliced, so under --subsystem the
+            // ranks are contiguous within the filtered set.
+            let ranked;
+            if (opts.reviewOrder === true && services !== undefined) {
+                const fanIn = await fanInByService(services, fleet, land ?? null);
+                ranked = { queue: reviewOrder(worklist, fanIn), fanIn };
+            }
+            // THE row set of this listing, spelled once: the owners join, the
+            // `services[]` payload and the text view must all be about the same
+            // rows — `owners.teams[]` is only "that team's campaign worklist"
+            // while it was computed over the rows `services[]` lists — and three
+            // copies of this expression is how they would drift apart.
+            const rows = shown === undefined ? undefined : (ranked?.queue ?? (opts.needsWork ? worklist : shown));
+            let owned;
+            if (opts.owners !== undefined && rows !== undefined) {
+                const join = await ownersJoin({
+                    path: opts.owners,
+                    rows: rows.map((v) => ({ id: v.entry.id, repoDir: repoPath(docsDir, v.entry.dir) })),
+                    json,
+                });
+                if (join === null)
+                    return;
+                owned = join;
+            }
+            if (json) {
+                emitJson({
+                    command: "list",
+                    docsDir,
+                    // Additive, unconditional and flat, mirroring the per-service
+                    // `adrs` key one row down rather than inventing a second shape for
+                    // the same number. Not nested under the services section: the fleet
+                    // has decision records whether or not this run listed services.
+                    fleetAdrs,
+                    ...(rows && shown
+                        ? {
+                            services: serviceRows(docsDir, ranked ?? rows),
+                            // Under --subsystem the dial is the SLICE's — the filter's
+                            // whole answer — while unfiltered runs keep the full fleet's
+                            // rollup, byte-identical to before the flag existed.
+                            maturity: maturityRollup(shown),
+                            // The tree beside the table — additive keys, wave 3 of the
+                            // subsystem item: the groups, and how many services sit
+                            // unfiled (a permanent, normal state, so a count, never a
+                            // finding). Under --subsystem the rows narrow to the named
+                            // group and its descendants; memberCount stays transitive
+                            // because the full tree's services back the modified copy.
+                            subsystems: subsystemsJson(docsDir, slice === undefined ? tree : { ...tree, subsystems: slice.subsystems }),
+                            // `unfiledServices` is a fleet-root fact: under a filter it
+                            // is omitted rather than reported as 0, which would lie.
+                            ...(slice === undefined
+                                ? { unfiledServices: tree.services.filter((s) => s.subsystem.length === 0).length }
+                                : {}),
+                        }
+                        : {}),
+                    ...(owned !== undefined ? { owners: ownersJson(owned) } : {}),
+                    ...(features
+                        ? { features: features.map((f, i) => featureJson(docsDir, f, verification[i] ?? null)) }
+                        : {}),
+                    ...(capabilities ? { capabilities: capabilities.map(capabilityJson) } : {}),
+                    ...(terms ? { glossary: terms.map((t) => glossaryJson(t.term, t.linkedBy, docsDir)) } : {}),
+                    // What the citation walk could not read, beside the rows it
+                    // decorates — `useCases` below is the same shape for the same
+                    // reason. An empty `linkedBy` means loam read every authored
+                    // document and none cites the term; this key is how a reader tells
+                    // that from "one of them would not decode".
+                    ...(citations ? { links: { unreadable: citations.unreadable } } : {}),
+                    // The use-case corpus's own health, beside the rows it decorates —
+                    // `status --json` and `delta --json` already spell this key this
+                    // way. It is what makes an absent `keptBy` legible: `unreadable:
+                    // false` with no `keptBy` on a row means the document declares that
+                    // promise and no flow keeps it, while `unreadable: true` means
+                    // nobody could look. Emitted only with the capabilities section, so
+                    // bare `loam list --json` is untouched.
+                    ...(promises === undefined
+                        ? {}
+                        : {
+                            useCases: {
+                                unreadable: promises.kind === "unreadable",
+                                ...(promises.kind === "unreadable" && promises.errors[0] !== undefined
+                                    ? { error: promises.errors[0] }
+                                    : {}),
+                            },
+                        }),
+                });
+                return;
+            }
+            if (slice !== undefined && shown !== undefined) {
+                console.log(`filtered to ${slice.label}: ${shown.length} of ${views.length} service(s)`);
+            }
+            if (owned !== undefined && rows !== undefined && shown !== undefined) {
+                if (opts.needsWork && rows.length === 0) {
+                    // printWorklist's own affordance, kept under the grouping flag:
+                    // empty owner groups would answer "who owns the work" without
+                    // saying there is none.
+                    console.log(`nothing to do — all ${shown.length} service(s) are vouched`);
+                    return;
+                }
+                const kind = opts.needsWork
+                    ? `${rows.length} of ${shown.length} service(s) need work`
+                    : `services (${rows.length})`;
+                const ordered = ranked === undefined ? "" : " — review order (fan-in: services depending on each)";
+                console.log(`${kind} — by owner (${owned.path})${ordered}`);
+                printOwners(owned, new Map(rows.map((v) => [repoPath(docsDir, v.entry.dir), v])), ranked?.fanIn);
+                return;
+            }
+            if (opts.needsWork) {
+                printWorklist(ranked === undefined ? worklist : ranked.queue, shown.length, ranked?.fanIn);
+                return;
+            }
+            // Under --subsystem the tree dial (subsystem and unfiled counts) is a
+            // fleet-root fact the filtered table must not claim, so no tree. The
+            // fleet's ADR count is not derived from the rows at all and stays.
+            if (shown)
+                printServices(shown, { tree: slice === undefined ? tree : undefined, adrs: fleetAdrs });
+            if (views && features)
+                console.log("");
+            if (features)
+                printFeatures(features, verification);
+            if (capabilities) {
+                if (capabilityVocab.present)
+                    printCapabilities(capabilities, promises);
+                else
+                    console.log("no architecture/capabilities.yaml — the fleet declares no capabilities");
+            }
+            if (terms && glossary) {
+                if (glossary.present) {
+                    printGlossary(terms.map((t) => ({ id: t.term.id, linkedBy: t.linkedBy })), citations?.unreadable ?? []);
+                }
+                else {
+                    console.log("no glossary/ — the fleet defines no domain terms");
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof DocsRepoUnavailableError) {
+                reportDocsRepoError(json, err);
+                return;
+            }
+            // One unreadable file used to escape as a stack trace (`internal` in
+            // --json), naming nothing. The enumeration is all-or-nothing — it reads
+            // every service's frontmatter to build one table — so the honest answer
+            // is a refusal that says WHICH path could not be read.
+            reportRepositoryUnavailable(json, err, "the listing would be missing a service", docsDir);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list/list.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\nimport { loadConfig } from \"../../core/envelope/config.js\";\nimport { emitJson, fail, repoPath, reportNoConfig } from \"../../core/envelope/json.js\";\nimport { maturityRollup } from \"../../core/vocabulary/maturity.js\";\nimport { FleetContext } from \"../../core/fleet-context.js\";\nimport { DocsRepoUnavailableError } from \"../../core/repo/state.js\";\nimport { capabilityRollup, type CapabilityRow } from \"../../core/capabilities/rollup.js\";\nimport { invalidVocabularyFinding } from \"../../core/capabilities/findings.js\";\nimport { promisesKeptByFlows } from \"../../core/usecases/capability.js\";\nimport { fleetAdrCount, listFeatures, listFleetTree, listServices } from \"../../core/repo/repo.js\";\nimport { readGlossary } from \"../../core/glossary/tree.js\";\nimport { backlinkIndex } from \"../../core/links/backlinks.js\";\nimport { glossaryDir } from \"../../core/repo/authored/paths.js\";\nimport { docsRepoReady, reportDocsRepoError, reportRepositoryUnavailable } from \"../policy/gate.js\";\nimport { featureVerification, serviceViews, type ServiceView } from \"./views.js\";\nimport { capabilityJson, featureJson, glossaryJson, ownersJson, serviceRows, subsystemsJson } from \"./json.js\";\nimport {\n  printCapabilities,\n  printFeatures,\n  printGlossary,\n  printOwners,\n  printServices,\n  printWorklist,\n} from \"./print.js\";\nimport { fanInByService, reviewLandscape, reviewOrder } from \"./review.js\";\nimport { resolveSubsystemSlice } from \"./campaign/campaign.js\";\nimport { ownersJoin, type OwnersJoin } from \"./campaign/owners.js\";\n\ntype Section = \"services\" | \"features\" | \"capabilities\" | \"glossary\";\nconst SECTIONS: Section[] = [\"services\", \"features\", \"capabilities\", \"glossary\"];\n/**\n * What a bare `loam list` shows. `capabilities` is explicit-only, NEVER part\n * of this default: the no-argument output and its `--json` payload are a\n * frozen contract, byte-identical whether or not a fleet declares capabilities.\n */\nconst DEFAULT_SECTIONS: Section[] = [\"services\", \"features\"];\n\ninterface ListOptions {\n  json?: boolean;\n  archived?: boolean;\n  needsWork?: boolean;\n  reviewOrder?: boolean;\n  subsystem?: string;\n  owners?: string;\n}\n\nexport function registerList(program: Command): void {\n  program\n    .command(\"list\")\n    .argument(\"[section]\", \"services | features | capabilities | glossary (default: services + features)\")\n    .description(\"List the services and features in the docs repo\")\n    .option(\"--json\", \"emit the machine contract instead of the human view\")\n    .option(\"--archived\", \"include archived features\")\n    .option(\n      \"--needs-work\",\n      \"services only: the adoption worklist — every service below `vouched`, with what it is missing\",\n    )\n    .option(\n      \"--review-order\",\n      \"with --needs-work: order the worklist by blast radius — services the most other services depend on first\",\n    )\n    .option(\n      \"--subsystem <name>\",\n      \"services only: limit the listing to services filed under this subsystem, at any depth ('unfiled' selects the ones filed under none, while nothing in the tree claims that name)\",\n    )\n    .option(\n      \"--owners <path>\",\n      \"services only: group the listing by owning team from this CODEOWNERS file, resolved from the current directory (directory-pattern rules only; unsupported rules are listed as skipped, never guessed)\",\n    )\n    .action(async (section: string | undefined, opts: ListOptions) => {\n      const json = opts.json === true;\n      // The campaign flags grade services, so — exactly like --needs-work —\n      // they narrow a bare `loam list` to the services section instead of\n      // printing a features table the filter silently does not apply to.\n      const campaign = opts.subsystem !== undefined || opts.owners !== undefined;\n      const wanted =\n        opts.needsWork || campaign\n          ? DEFAULT_SECTIONS.filter((s) => s === \"services\")\n          : section\n            ? SECTIONS.filter((s) => s === section)\n            : DEFAULT_SECTIONS;\n      if (section && !SECTIONS.includes(section as Section)) {\n        // `invalid-option`, same as show's bad --type: one mistake class, one code.\n        fail(json, \"invalid-option\", `Unknown section '${section}'. Expected: ${SECTIONS.join(\" | \")}.`);\n        return;\n      }\n      if (opts.needsWork && section === \"features\") {\n        fail(json, \"invalid-option\", \"--needs-work is the service adoption worklist; drop the 'features' section.\");\n        return;\n      }\n      if (campaign && section !== undefined && section !== \"services\") {\n        fail(json, \"invalid-option\", `--subsystem and --owners grade the services section; drop the '${section}' section.`);\n        return;\n      }\n      // The flag ORDERS the worklist, so it requires the worklist explicitly:\n      // silently implying --needs-work would make one flag change which rows\n      // exist, not only their order.\n      if (opts.reviewOrder && !opts.needsWork) {\n        fail(json, \"invalid-option\", \"--review-order sorts the adoption worklist; add --needs-work.\");\n        return;\n      }\n\n      const loaded = await loadConfig();\n      if (loaded.kind !== \"loaded\") {\n        reportNoConfig(json, loaded);\n        return;\n      }\n      const config = loaded.config;\n      const { docsDir } = config;\n      // A docsDir that is not a docs repo is refused, never rendered as an empty\n      // fleet — the whole point of the gate (see docs-repo-gate.ts).\n      // `list features` alone does not need services/, so it asks for less;\n      // the capability rollup walks every service's spec files, so it asks for them.\n      const needsServices =\n        wanted.includes(\"services\") || wanted.includes(\"capabilities\") || wanted.includes(\"glossary\");\n      if (!docsRepoReady(json, docsDir, needsServices ? \"services\" : \"docs\")) return;\n\n      try {\n        // One context, one walk: the tree memo answers both the service\n        // entries and the subsystem/unfiled counts beside them.\n        const fleet = new FleetContext();\n        const tree = wanted.includes(\"services\") ? await listFleetTree(docsDir, fleet) : undefined;\n        const services = wanted.includes(\"services\") ? await listServices(docsDir, fleet) : undefined;\n        // --review-order parses the landscape ONCE for both of its consumers —\n        // serviceViews' `called` set (handed in as `preloaded`) and the fan-in\n        // joins below. Without the flag, `undefined` keeps serviceViews' own\n        // load-if-exists behaviour and the run byte-identical to today's.\n        const land =\n          opts.reviewOrder === true && services !== undefined\n            ? await reviewLandscape(docsDir, fleet)\n            : undefined;\n        const views = services ? await serviceViews(docsDir, services, config.service, land) : undefined;\n        // The slice is resolved AFTER the full-fleet views, and rows are\n        // filtered rather than re-derived: fan-in, apiExpected and the missing\n        // lists are fleet facts, and a slice-first derivation would recompute\n        // them against a fleet with the callers outside the slice erased. The\n        // composition is pinned as filter-first-then-rank — ranks stay\n        // contiguous within the filtered set (test/list-campaign.test.ts).\n        // `tree !== undefined` is a type NARROWING, not a branch: a campaign\n        // flag forces the services section, so the tree always exists here.\n        const slice =\n          opts.subsystem !== undefined && tree !== undefined\n            ? resolveSubsystemSlice(tree, opts.subsystem, json)\n            : undefined;\n        if (slice === null) return;\n        // Membership is by DIRECTORY: leaf ids can collide across a broken\n        // tree (`subsystem.name-collision`), and the directory is the row's\n        // actual identity — campaign.ts's SubsystemSlice says why.\n        const shown = slice === undefined ? views : views?.filter((v) => slice.members.has(v.entry.dir));\n        // The fleet's own decision records. Read unconditionally — it is one\n        // existsSync over `architecture/adrs/` and it belongs to the docs repo\n        // rather than to any section, so `loam list features --json` reports it\n        // as truthfully as `loam list services --json` does. Nothing grades it:\n        // an absent directory is 0 and 0 is a fine, permanent answer.\n        const fleetAdrs = await fleetAdrCount(docsDir);\n        const features = wanted.includes(\"features\")\n          ? await listFeatures(docsDir, { includeArchived: opts.archived }, fleet)\n          : undefined;\n        const verification = features\n          ? await Promise.all(features.map((f) => featureVerification(docsDir, f)))\n          : undefined;\n\n        // The capability section: the vocabulary's own verdict decides the shape.\n        // An INVALID file refuses with `repository-unavailable` — an\n        // empty-looking success over a broken file is the silent hole this\n        // command already refuses elsewhere — while an ABSENT one is an honest\n        // empty answer, because the file is the axis's opt-in. The message is\n        // `capability.invalid`'s own sentence, not the fs-error helper's: the\n        // file WAS read, it just is not a vocabulary, and one diagnosis should\n        // have one spelling wherever it surfaces.\n        const capabilityVocab = wanted.includes(\"capabilities\")\n          ? await fleet.capabilities(docsDir)\n          : undefined;\n        const brokenVocab = capabilityVocab === undefined ? null : invalidVocabularyFinding(capabilityVocab);\n        if (brokenVocab !== null) {\n          fail(json, \"repository-unavailable\", brokenVocab.message);\n          return;\n        }\n        // The SECOND corpus behind a capability's promises: the `#cap-`/`#req-`\n        // tagged flows. Read only under `loam list capabilities`, and\n        // `promisesKeptByFlows` carries `readUseCases`' byte gate, so a fleet\n        // whose architecture/ never mentions the reserved tag prefix pays a\n        // readdir here rather than a LikeC4 workspace.\n        //\n        // AN UNREADABLE architecture/ DEGRADES, it does not refuse — the\n        // opposite of the invalid vocabulary above, and the difference is which\n        // corpus broke. `architecture/capabilities.yaml` is what the ROWS are\n        // built from: unreadable, there is no listing to print, so refusing is\n        // the only honest answer. The flows are a second corpus over rows that\n        // are already true, and refusing the whole listing because a use-case\n        // document has a syntax error would take `loam list capabilities` away\n        // during exactly the minutes somebody is fixing that document, while\n        // `validate` already reports it as `landscape.invalid`. So the join is\n        // withheld instead — every `keptBy` absent rather than `[]` — and the\n        // reason is stated, which is `core/pack/joins.ts`' holes idiom: carry\n        // what is true, name what could not be looked at, never let the two read\n        // the same.\n        const entries = capabilityVocab === undefined ? undefined : await listServices(docsDir, fleet);\n        const promises =\n          capabilityVocab === undefined || entries === undefined\n            ? undefined\n            : await promisesKeptByFlows({\n                docsDir,\n                vocab: capabilityVocab,\n                known: new Set(entries.map((e) => e.id)),\n                read: (p) => fleet.readRequirements(p),\n              });\n        const capabilities: CapabilityRow[] | undefined =\n          capabilityVocab === undefined || entries === undefined\n            ? undefined\n            : await capabilityRollup({\n                services: entries,\n                vocab: capabilityVocab,\n                read: (p) => fleet.readRequirements(p),\n                ...(promises?.kind === \"read\" ? { keptByFlows: promises.kept } : {}),\n              });\n\n        // The glossary section: the tree, and who cites each term. The\n        // citation index is the expensive half — it reads every authored\n        // document in the repository — so it is built only when the section is\n        // asked for, and not at all when `glossary/` does not exist. The\n        // directory's existence is the axis's opt-in, exactly as it is for\n        // `capabilities/`, so a fleet without one prints an empty section\n        // rather than paying for a fleet-wide walk to say so.\n        const glossary = wanted.includes(\"glossary\") ? await readGlossary(glossaryDir(docsDir)) : undefined;\n        const citations =\n          glossary !== undefined && glossary.terms.length > 0 ? await backlinkIndex(docsDir, fleet) : undefined;\n        const terms = glossary?.terms.map((term) => ({\n          term,\n          linkedBy: citations === undefined ? [] : citations.linkersOf(term.path),\n        }));\n\n        const worklist = (shown ?? []).filter((v) => v.maturity !== \"vouched\");\n        // The ranked review queue, derived never stored: fan-in is computed\n        // FLEET-WIDE (the joins need every service's slice anyway — and a\n        // --subsystem filter must never change a service's count, only which\n        // rows appear) while ranks are assigned over the WORKLIST only — a\n        // vouched service needs no review, and ranking it would put gaps in\n        // the queue. The worklist is already sliced, so under --subsystem the\n        // ranks are contiguous within the filtered set.\n        let ranked: { queue: ServiceView[]; fanIn: ReadonlyMap<string, number> } | undefined;\n        if (opts.reviewOrder === true && services !== undefined) {\n          const fanIn = await fanInByService(services, fleet, land ?? null);\n          ranked = { queue: reviewOrder(worklist, fanIn), fanIn };\n        }\n\n        // THE row set of this listing, spelled once: the owners join, the\n        // `services[]` payload and the text view must all be about the same\n        // rows — `owners.teams[]` is only \"that team's campaign worklist\"\n        // while it was computed over the rows `services[]` lists — and three\n        // copies of this expression is how they would drift apart.\n        const rows = shown === undefined ? undefined : (ranked?.queue ?? (opts.needsWork ? worklist : shown));\n\n        let owned: OwnersJoin | undefined;\n        if (opts.owners !== undefined && rows !== undefined) {\n          const join = await ownersJoin({\n            path: opts.owners,\n            rows: rows.map((v) => ({ id: v.entry.id, repoDir: repoPath(docsDir, v.entry.dir) })),\n            json,\n          });\n          if (join === null) return;\n          owned = join;\n        }\n\n        if (json) {\n          emitJson({\n            command: \"list\",\n            docsDir,\n            // Additive, unconditional and flat, mirroring the per-service\n            // `adrs` key one row down rather than inventing a second shape for\n            // the same number. Not nested under the services section: the fleet\n            // has decision records whether or not this run listed services.\n            fleetAdrs,\n            ...(rows && shown\n              ? {\n                  services: serviceRows(docsDir, ranked ?? rows),\n                  // Under --subsystem the dial is the SLICE's — the filter's\n                  // whole answer — while unfiltered runs keep the full fleet's\n                  // rollup, byte-identical to before the flag existed.\n                  maturity: maturityRollup(shown),\n                  // The tree beside the table — additive keys, wave 3 of the\n                  // subsystem item: the groups, and how many services sit\n                  // unfiled (a permanent, normal state, so a count, never a\n                  // finding). Under --subsystem the rows narrow to the named\n                  // group and its descendants; memberCount stays transitive\n                  // because the full tree's services back the modified copy.\n                  subsystems: subsystemsJson(\n                    docsDir,\n                    slice === undefined ? tree! : { ...tree!, subsystems: slice.subsystems },\n                  ),\n                  // `unfiledServices` is a fleet-root fact: under a filter it\n                  // is omitted rather than reported as 0, which would lie.\n                  ...(slice === undefined\n                    ? { unfiledServices: tree!.services.filter((s) => s.subsystem.length === 0).length }\n                    : {}),\n                }\n              : {}),\n            ...(owned !== undefined ? { owners: ownersJson(owned) } : {}),\n            ...(features\n              ? { features: features.map((f, i) => featureJson(docsDir, f, verification![i] ?? null)) }\n              : {}),\n            ...(capabilities ? { capabilities: capabilities.map(capabilityJson) } : {}),\n            ...(terms ? { glossary: terms.map((t) => glossaryJson(t.term, t.linkedBy, docsDir)) } : {}),\n            // What the citation walk could not read, beside the rows it\n            // decorates — `useCases` below is the same shape for the same\n            // reason. An empty `linkedBy` means loam read every authored\n            // document and none cites the term; this key is how a reader tells\n            // that from \"one of them would not decode\".\n            ...(citations ? { links: { unreadable: citations.unreadable } } : {}),\n            // The use-case corpus's own health, beside the rows it decorates —\n            // `status --json` and `delta --json` already spell this key this\n            // way. It is what makes an absent `keptBy` legible: `unreadable:\n            // false` with no `keptBy` on a row means the document declares that\n            // promise and no flow keeps it, while `unreadable: true` means\n            // nobody could look. Emitted only with the capabilities section, so\n            // bare `loam list --json` is untouched.\n            ...(promises === undefined\n              ? {}\n              : {\n                  useCases: {\n                    unreadable: promises.kind === \"unreadable\",\n                    ...(promises.kind === \"unreadable\" && promises.errors[0] !== undefined\n                      ? { error: promises.errors[0] }\n                      : {}),\n                  },\n                }),\n          });\n          return;\n        }\n\n        if (slice !== undefined && shown !== undefined) {\n          console.log(`filtered to ${slice.label}: ${shown.length} of ${views!.length} service(s)`);\n        }\n        if (owned !== undefined && rows !== undefined && shown !== undefined) {\n          if (opts.needsWork && rows.length === 0) {\n            // printWorklist's own affordance, kept under the grouping flag:\n            // empty owner groups would answer \"who owns the work\" without\n            // saying there is none.\n            console.log(`nothing to do — all ${shown.length} service(s) are vouched`);\n            return;\n          }\n          const kind = opts.needsWork\n            ? `${rows.length} of ${shown.length} service(s) need work`\n            : `services (${rows.length})`;\n          const ordered =\n            ranked === undefined ? \"\" : \" — review order (fan-in: services depending on each)\";\n          console.log(`${kind} — by owner (${owned.path})${ordered}`);\n          printOwners(owned, new Map(rows.map((v) => [repoPath(docsDir, v.entry.dir), v])), ranked?.fanIn);\n          return;\n        }\n        if (opts.needsWork) {\n          printWorklist(ranked === undefined ? worklist : ranked.queue, shown!.length, ranked?.fanIn);\n          return;\n        }\n        // Under --subsystem the tree dial (subsystem and unfiled counts) is a\n        // fleet-root fact the filtered table must not claim, so no tree. The\n        // fleet's ADR count is not derived from the rows at all and stays.\n        if (shown) printServices(shown, { tree: slice === undefined ? tree : undefined, adrs: fleetAdrs });\n        if (views && features) console.log(\"\");\n        if (features) printFeatures(features, verification!);\n        if (capabilities) {\n          if (capabilityVocab!.present) printCapabilities(capabilities, promises!);\n          else console.log(\"no architecture/capabilities.yaml — the fleet declares no capabilities\");\n        }\n        if (terms && glossary) {\n          if (glossary.present) {\n            printGlossary(\n              terms.map((t) => ({ id: t.term.id, linkedBy: t.linkedBy })),\n              citations?.unreadable ?? [],\n            );\n          } else {\n            console.log(\"no glossary/ — the fleet defines no domain terms\");\n          }\n        }\n      } catch (err) {\n        if (err instanceof DocsRepoUnavailableError) {\n          reportDocsRepoError(json, err);\n          return;\n        }\n        // One unreadable file used to escape as a stack trace (`internal` in\n        // --json), naming nothing. The enumeration is all-or-nothing — it reads\n        // every service's frontmatter to build one table — so the honest answer\n        // is a refusal that says WHICH path could not be read.\n        reportRepositoryUnavailable(json, err, \"the listing would be missing a service\", docsDir);\n      }\n    });\n}\n\n"]}