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

package/dist/commands/validate/fleet/landscape.js

@@ -0,0 +1,371 @@
+/**
+ * The fleet target: `services/` and architecture/landscape.likec4 graded
+ * against each other, plus the two exemptions that decide which drawn element
+ * answers for a service directory at all.
+ *
+ * The landscape is the one artifact no service owns — parsed once for the whole
+ * run and graded on a target of its own, outside the dispatcher's `guarded`.
+ * That is why its IO containment lives in this package instead: see
+ * `unreadableLandscape` in `./load.ts`.
+ */
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import {} from "../../../core/c4/likec4.js";
+import { serviceResolver } from "../../../core/c4/resolve/service.js";
+import { landscapePath as landscapeFile, servicePathsAt } from "../../../core/repo/paths.js";
+import { serviceIdFindings } from "../../../core/repo/entries.js";
+import { listFleetTree, listServices } from "../../../core/repo/repo.js";
+import {} from "../../../core/vocabulary/report.js";
+import { landscapeConflictFinding } from "../../../core/conflict-markers.js";
+import { FleetContext } from "../../../core/fleet-context.js";
+import { capabilityFleetFindings, fleetShapeFindings, permissionFindings } from "../checks/fleet-shape.js";
+import { fleetLinkFindings } from "../links/corpus.js";
+import { glossaryFindings } from "../links/glossary.js";
+import { obligationFindings, obligationVocabularyFindings } from "./obligations.js";
+import { readObligations } from "../../../core/obligations/obligations.js";
+import { obligationsPath } from "../../../core/repo/paths.js";
+import { EXTERNAL_TAG } from "../../../core/vocabulary/maturity.js";
+import { brokenDocumentPaths, errorText } from "../../../core/c4/likec4.js";
+import { serviceTreePath } from "../../../core/kernel/ids/dirs.js";
+import { drawnSystems, serviceLevelElements, standsForService } from "./census.js";
+import { unreadableLandscape } from "./load.js";
+import { kindTagFindings } from "./kind-tags.js";
+import { mapAttestation } from "./map/attest.js";
+import { bindingFindings } from "./map/bindings.js";
+import { consumerCensus, datastoreFindings } from "./map/consumers.js";
+import { isolationFindings } from "./map/isolation.js";
+import { fleetUseCaseFindings } from "./map/usecases.js";
+import { viewIdFindings } from "./views/ids.js";
+import { viewsStaleFindings } from "./views/stale.js";
+import { projectFindings } from "./views/projects.js";
+import { fleetProjectFindings } from "./views/fleet-project.js";
+import { isUseCase } from "../../../core/usecases/fleet.js";
+/**
+ * The fleet's flows as a grade may read them, or `null` when loam cannot see
+ * them at all — the same `null`-suspends idiom `gradableCapabilityIds` uses,
+ * and here it guards one specific wrong answer.
+ *
+ * `capability.requirement-unrealized` says a business promise is kept by
+ * nobody. A use case is one of the two things that can keep it, so a run that
+ * could not read the flows must not make that claim: no map at all (`null`)
+ * and a project that did not parse are both "loam did not look", never
+ * "there is nothing there". A preload that DID parse and declares no views is a
+ * real, empty answer and grades normally.
+ *
+ * Filtered through `isUseCase` — the same opt-in `readUseCases` applies before
+ * `loam list capabilities` asks this question — because the two surfaces must
+ * never disagree about `keptBy`. Handing the unfiltered preload over was
+ * harmless only by luck: an untagged view yields no claims, so the answers
+ * matched for want of an input that could tell them apart. A `#req-`-only view
+ * is exactly that input.
+ */
+function gradableFlows(preloaded) {
+    if (preloaded === null || preloaded.errors.length > 0)
+        return null;
+    return (preloaded.views ?? []).filter(isUseCase);
+}
+/**
+ * The fleet cross-check: `services/` and the landscape both claim to name the
+ * fleet, and nothing used to compare them. A directory nobody drew and an element
+ * with nothing behind it were equally invisible.
+ *
+ * The two directions are graded differently because the evidence differs. A
+ * directory that exists is a fact, so a landscape missing it is an error — every
+ * view derived from that landscape is then incomplete. An element with no
+ * directory may legitimately be someone else's system, so it warns, and
+ * `#external` says "deliberately not ours" and silences it. An explicit
+ * `metadata { service '<id>' }` naming nothing is an error either way: a binding
+ * is a claim about this repo, not a guess at one.
+ *
+ * An ABSENT landscape is a finding, not a skipped check. It used to return null
+ * — no target, no findings, and a fleet gate that went green over a docs repo
+ * with no fleet map at all, which is the single artifact every derived view and
+ * every spine check is computed from. It is graded by what its absence proves:
+ * with services in `services/` it is an ERROR (a fleet that exists is undrawn),
+ * with none it is a WARNING (a docs repo before its first adopt legitimately
+ * has nothing to draw, but the file still belongs there — `loam init` scaffolds
+ * it, and a repo missing it will silently accept never getting one).
+ *
+ * `preloaded` is the already-parsed landscape under --all — the same doc every
+ * service check gets.
+ */
+export async function validateLandscape(docsDir, preloaded, fleet) {
+    const path = landscapeFile(docsDir);
+    const findings = [];
+    const report = {
+        kind: "landscape",
+        id: "landscape",
+        path: "architecture/landscape.likec4",
+        findings,
+    };
+    // The SET of service directories is this target's other subject, so it is
+    // graded before the map is even opened: `service.id-invalid` is a fact about
+    // `services/` that holds whether or not a landscape exists or parses, and
+    // both of those return early below. Emitted here and nowhere else — the
+    // enumeration is what makes the id a question, and one finding per fleet is
+    // what the rename fixes.
+    const entries = await listServices(docsDir, fleet);
+    findings.push(...serviceIdFindings(entries));
+    // The tree walk's own findings ride the same fleet target, before the map's
+    // early returns for the same reason `service.id-invalid` does: a stranded,
+    // colliding or mismarked directory is a fact about `services/` that holds
+    // whether or not a landscape exists or parses — and a broken tree must make
+    // the fleet gate refuse while still naming every service it found.
+    const tree = await listFleetTree(docsDir, fleet);
+    findings.push(...tree.findings);
+    // Which SHAPE each model has, read once for the whole target: it decides four
+    // of the grades below (`views/projects.ts`) and which documents the merged
+    // project holds (`views/fleet-project.ts`). Over the full enumeration, which
+    // is what `entries` is here even under `--base` — `validate --all` narrows the
+    // TARGETS it grades and never the fleet the renderer would load.
+    const models = entries.map((entry) => servicePathsAt(entry.dir).model);
+    const shapes = await fleet.modelShapes(models);
+    // A model and the renderer's project files disagreeing is a fact about
+    // `services/` too, graded here for `service.id-invalid`'s reason: it holds
+    // whether or not the map parses. One warning per service per disagreement;
+    // views/projects.ts says why a warning, why this run and not `doctor`, why
+    // the root-file gate, and why the grade is KEPT rather than spread and
+    // dropped — one of the five gates the merged-project load below, and
+    // re-deriving that fact there would let a cause and its 161-warning cascade
+    // disagree about which state the run is in.
+    const projects = await projectFindings(docsDir, entries, shapes);
+    findings.push(...projects.findings);
+    // Before the landscape's own early returns: the authorization and capability
+    // vocabularies are fleet facts that do not depend on the map existing or parsing.
+    findings.push(...(await permissionFindings(docsDir, entries, fleet)));
+    findings.push(...(await capabilityFleetFindings(docsDir, entries, fleet, gradableFlows(preloaded))));
+    // The documents that belong to no service and no feature — the fleet's ADRs
+    // and the living capability tree — are graded for their links here, once,
+    // for the same reason the two vocabularies above are: a fleet fact repeated
+    // on every service target is the report.
+    findings.push(...(await fleetLinkFindings({ docsDir, fleet })));
+    // The glossary is graded on who cites it, which is a question only the whole
+    // repository answers — so it belongs here, beside the two vocabularies, and
+    // nowhere else.
+    findings.push(...(await glossaryFindings(docsDir, fleet)));
+    // The architectural obligation vocabulary, read ONCE here and handed to the
+    // map half below: its own two verdicts hold whether or not the landscape
+    // exists or parses, and a run where somebody is fixing the map must still be
+    // told that this file does not read.
+    const obligations = await readObligations(obligationsPath(docsDir));
+    findings.push(...obligationVocabularyFindings(docsDir, obligations));
+    if (!existsSync(path)) {
+        const count = entries.length;
+        findings.push({
+            severity: count > 0 ? "error" : "warn",
+            code: "landscape.missing",
+            message: `landscape: architecture/landscape.likec4 does not exist — ` +
+                (count > 0
+                    ? `${count} service(s) are adopted and nothing draws the fleet. `
+                    : "nothing draws the fleet. ") +
+                "It is the one map every derived view and the C4↔API spine are computed from: " +
+                "write a `specification { element softwareSystem }` + `model { … }` document there " +
+                "with one element per services/<id>/, bound with `metadata { service '<id>' }`.",
+        });
+        return report;
+    }
+    // Conflict markers before the parse — `loam doctor`'s order, and for its
+    // reason: the markers are the cause and the parse errors are the cascade.
+    // Nothing may be concluded from a file that is two halves of two different
+    // maps, least of all that a service nobody drew is unmodelled, so this
+    // returns the way `landscape.invalid` does. An error, gating by the default
+    // rule and deliberately not carrying `gates` — that field is coherence's,
+    // and the archive gate has to ask this question itself (it does not yet).
+    // Read plainly rather than through FleetContext: this target runs outside
+    // `guarded`, and a document refused for its encoding would surface here as
+    // the whole run's `repository-unavailable` instead of one finding.
+    //
+    // Both reads are contained for that same reason — see `unreadableLandscape`.
+    // The conflict-marker read is the FIRST touch of the file, so it is the one
+    // that fails when the file cannot be opened at all, and it runs before
+    // `preloaded ??` can spare it.
+    let land;
+    try {
+        const conflict = landscapeConflictFinding("architecture/landscape.likec4", await readFile(path, "utf8"));
+        if (conflict !== null) {
+            findings.push(conflict);
+            return report;
+        }
+        land = preloaded ?? (await fleet.loadLikeC4(path));
+    }
+    catch (err) {
+        land = unreadableLandscape(err);
+    }
+    if (land.errors.length > 0) {
+        // Nothing may be concluded from a document that did not parse — in particular
+        // not that every service is unmodelled.
+        //
+        // The fleet map is a PROJECT now, not a file: `architecture/landscape.likec4`
+        // plus every `architecture/usecases/*.likec4`, merged the way the renderer
+        // merges them. So the message names the FILES that broke rather than the
+        // landscape by default — a use case with a typo'd element used to be
+        // reported as the landscape having errors, which sent the author to the
+        // wrong file with a line number that pointed at somebody else's text.
+        const broken = brokenDocumentPaths(docsDir, land.errors);
+        const named = broken.length === 0 ? "architecture/landscape.likec4" : broken.join(", ");
+        // The verb agrees with the LIST, not with the count after it: `named` is a
+        // comma-joined series once two documents broke, and "a, b has 6 error(s)"
+        // is a sentence a reader trips over. The service arm (`service/spine.ts`)
+        // picks the verb the same way off the same list, and these two messages are
+        // read side by side in one report — a run where the fleet line says "has"
+        // and the service line says "have" about the same two files reads as two
+        // different findings.
+        const verb = broken.length > 1 ? "have" : "has";
+        findings.push({
+            severity: "error",
+            code: "landscape.invalid",
+            // The tail is general on purpose. It used to speak about use-case flows
+            // alone, so an author whose MODEL EDGE named a container was told to move
+            // a flow that does not exist (#01). Both shapes are the same defect: loam
+            // grades the `architecture/` project, the renderer loads that project plus
+            // every extending model, and a reference to a container only the model
+            // declares therefore resolves there and not here.
+            message: `landscape: ${named} ${verb} ${land.errors.length} error(s) — cross-check with services/ impossible. ` +
+                "An unresolved name that a service's extending model declares — a use-case hop or an edge " +
+                "naming `<service-fqn>.<container>` — renders for the renderer and resolves for nobody here: " +
+                "name the SERVICE on the map, and the container in that service's own model (a container-level " +
+                "flow lives beside the model that declares it)",
+            // Every line carries its own file, because one project's errors can come
+            // from more than one document and a bare `L8:` is unactionable then. The
+            // prefix is `brokenDocumentPaths`'s spelling of that one error's document,
+            // so the message's file list and each line's prefix are one rule.
+            details: land.errors.map((e) => {
+                const [file] = broken.length < 2 ? [] : brokenDocumentPaths(docsDir, [e]);
+                return file === undefined ? errorText(e) : `${file} ${errorText(e)}`;
+            }),
+        });
+        return report;
+    }
+    // The generated views files, graded only now that the landscape has parsed:
+    // the expected bytes are a function of (tree, landscape elements, the global
+    // style ids the map declares) — the whole doc goes across so the grader and
+    // `sync` read one record. There are TWO generated files now
+    // (`subsystems.likec4` and `services.likec4`) and this pushes ONE error PER
+    // STALE FILE, each naming its own file; `views/stale.ts` says why a content
+    // compare, and why two files share one code but never one finding.
+    findings.push(...(await viewsStaleFindings(docsDir, tree, land)));
+    // The renderer's own reading of the tree: the map, every extending model and
+    // every `.likec4` beside one, merged into ONE project. It answers two
+    // questions at once and only one of them can be true at a time — either that
+    // project does not parse (`c4.fleet-project-invalid`), or it parsed and its
+    // view-id census is the real one.
+    const merged = await fleetProjectFindings({
+        docsDir, entries, shapes, fleet, tree,
+        architecture: land,
+        mapExcluded: projects.mapExcluded,
+        known: new Set(entries.map((s) => s.id)),
+    });
+    if (merged.kind === "invalid")
+        findings.push(...merged.findings);
+    // Beside staleness, and for the same file: an authored view id that collides
+    // with one loam mints into it takes the whole root project down in the
+    // renderer while every check here stays green — see views/ids.ts. The census
+    // is the merged project's when there is one; otherwise the `architecture/`
+    // project's alone, whose claims are spelled relative to that directory and are
+    // made docs-relative here.
+    // `land` goes across for the SERVICE half of the reservation: an id is minted
+    // per service the map DRAWS, so the census needs the render's own element join.
+    const claims = merged.kind === "clean"
+        ? merged.viewIds
+        : land.viewIds?.map((claim) => ({ ...claim, sourcePath: `architecture/${claim.sourcePath}` }));
+    findings.push(...viewIdFindings(claims, tree, land));
+    // The three obligation questions that need the map — where each declared rule
+    // is applied, which tags resolve to nothing, and which applications no living
+    // arch requirement covers. Here rather than beside the vocabulary above
+    // because all three are about the parsed landscape, and `land` is only
+    // trustworthy past this point.
+    findings.push(...(await obligationFindings({ docsDir, vocabulary: obligations, land, services: entries, fleet })));
+    const services = new Set(entries.map((s) => s.id));
+    // Where each service actually sits, for every finding below that names a
+    // directory a reader is meant to open. `services/<id>/` is right only for an
+    // unfiled fleet; a filed service lives at `services/<subsystem>/…/<id>/`, and
+    // a finding pointing at the root form sends the fix to a path that does not
+    // exist. Built once here because three checks below need the same answer.
+    const pathOf = (id) => {
+        const entry = entries.find((s) => s.id === id);
+        return entry === undefined ? `services/${id}` : serviceTreePath(entry);
+    };
+    // Ahead of every exemption below, because it is the one defect that can make
+    // all of them lie at once: a tag loam grades on, declared on a KIND, landing
+    // on an element that stands for one of our own directories — see kind-tags.ts.
+    findings.push(...kindTagFindings({ specification: land.specification, elements: land.elements, services }));
+    const drawn = serviceLevelElements(land.elements, services);
+    // Which services the landscape models, answered by the same resolver every
+    // edge join uses — so "modelled" here and "inbound edge" in the spine check
+    // can never disagree about what an element stands for.
+    const landSvcOf = serviceResolver(land.elements, services);
+    const modelled = new Set(land.elements.map((e) => landSvcOf(e.id)));
+    // The same set with `#external` removed — the isolation check's input, and
+    // NOT `service-unmodelled`'s: a foreign box bound to one of our directories
+    // still means the directory is drawn, but "deliberately not ours" must not
+    // make it a subject of an advisory about our own map (R4/W12). The two
+    // binding passes have always skipped the tag; this is the third.
+    const external = new Set(land.elements.filter((e) => e.tags.includes(EXTERNAL_TAG)).map((e) => e.id));
+    const ours = new Set(land.elements.filter((e) => !external.has(e.id)).map((e) => landSvcOf(e.id)));
+    // The element↔directory passes: two boxes for one directory, a directory
+    // nobody drew, a binding naming nothing, and an element nobody owns.
+    const systems = drawnSystems(land.elements, services);
+    findings.push(...bindingFindings({ elements: land.elements, drawn, systems, services, modelled, pathOf }));
+    // What the fleet's own models say, read once for the two checks below that
+    // need it: a map edge is not the only evidence that a service consumes
+    // something, nor the only evidence that it calls out (map/attest.ts).
+    const drawnIds = new Set(drawn.map((e) => e.id));
+    // `census.ts`'s predicate, handed down rather than respelled: a `fleet/map/`
+    // module may not import `fleet/`, and the store grades were skipping a
+    // datastore that IS a service in one of their two halves only.
+    const isService = (e) => standsForService(e, services);
+    const attestation = await mapAttestation({
+        docsDir,
+        entries,
+        services,
+        resolve: landSvcOf,
+        standsForService: isService,
+        drawnIds,
+        fleet,
+    });
+    const attested = attestation.models;
+    const mapFacts = { relationships: land.relationships, elements: land.elements, services, resolve: landSvcOf };
+    const consumers = consumerCensus({ ...mapFacts, standsForService: isService, attested });
+    // The shape advisories run LAST, over the same drawn set and resolver the
+    // structural checks used. Any one of them suppresses `landscape.matched`
+    // below on purpose: a map with a shape warning did not fully "agree".
+    findings.push(...fleetShapeFindings({ drawn, services, consumers }));
+    const { nestedStores } = attestation;
+    findings.push(...datastoreFindings({
+        drawn,
+        elements: land.elements,
+        nestedStores,
+        services,
+        resolve: landSvcOf,
+        standsForService: isService,
+        consumers,
+    }));
+    // A drawn service nothing reaches, graded only where its own model attests
+    // a call across its boundary — map/isolation.ts says why the evidence gate.
+    findings.push(...isolationFindings({ land, modelled: ours, external, attested, resolve: landSvcOf, pathOf }));
+    // The use cases the SAME `architecture/` project declares — every
+    // `dynamic view` in the landscape and in every `architecture/usecases/*.likec4`
+    // — graded against the model above (`map/usecases.ts` holds the call and the
+    // two vocabulary reads it needs; `core/usecases/grade/usecases.ts` owns the opt-in and
+    // the grades). They ride this target for `viewsStaleFindings`' reason: a view
+    // belongs to no service, and only the fleet run has both the whole model and
+    // the enumerated `services/` in view at once.
+    findings.push(...(await fleetUseCaseFindings({
+        docsDir,
+        views: preloaded?.views ?? [],
+        elements: land.elements,
+        relationships: land.relationships,
+        services,
+        resolve: landSvcOf,
+        fleet,
+    })));
+    if (findings.length === 0) {
+        findings.push({
+            severity: "ok",
+            code: "landscape.matched",
+            message: `landscape: ${services.size} service(s) modelled — architecture/landscape.likec4 and services/ agree`,
+        });
+    }
+    return report;
+}
+//# sourceMappingURL=landscape.js.map

package/dist/commands/validate/fleet/landscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscape.js","sourceRoot":"","sources":["../../../../src/commands/validate/fleet/landscape.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The fleet target: `services/` and architecture/landscape.likec4 graded\n * against each other, plus the two exemptions that decide which drawn element\n * answers for a service directory at all.\n *\n * The landscape is the one artifact no service owns — parsed once for the whole\n * run and graded on a target of its own, outside the dispatcher's `guarded`.\n * That is why its IO containment lives in this package instead: see\n * `unreadableLandscape` in `./load.ts`.\n */\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { type Elem, type LoadedDoc } from \"../../../core/c4/likec4.js\";\nimport { serviceResolver } from \"../../../core/c4/resolve/service.js\";\nimport { landscapePath as landscapeFile, servicePathsAt } from \"../../../core/repo/paths.js\";\nimport { serviceIdFindings } from \"../../../core/repo/entries.js\";\nimport { listFleetTree, listServices } from \"../../../core/repo/repo.js\";\nimport { type Finding, type TargetReport } from \"../../../core/vocabulary/report.js\";\nimport { landscapeConflictFinding } from \"../../../core/conflict-markers.js\";\nimport { FleetContext } from \"../../../core/fleet-context.js\";\nimport { capabilityFleetFindings, fleetShapeFindings, permissionFindings } from \"../checks/fleet-shape.js\";\nimport { fleetLinkFindings } from \"../links/corpus.js\";\nimport { glossaryFindings } from \"../links/glossary.js\";\nimport { obligationFindings, obligationVocabularyFindings } from \"./obligations.js\";\nimport { readObligations } from \"../../../core/obligations/obligations.js\";\nimport { obligationsPath } from \"../../../core/repo/paths.js\";\nimport { EXTERNAL_TAG } from \"../../../core/vocabulary/maturity.js\";\nimport { brokenDocumentPaths, errorText } from \"../../../core/c4/likec4.js\";\nimport { serviceTreePath, type DocsDir } from \"../../../core/kernel/ids/dirs.js\";\nimport { drawnSystems, serviceLevelElements, standsForService } from \"./census.js\";\nimport { unreadableLandscape } from \"./load.js\";\nimport { kindTagFindings } from \"./kind-tags.js\";\nimport { mapAttestation } from \"./map/attest.js\";\nimport { bindingFindings } from \"./map/bindings.js\";\nimport { consumerCensus, datastoreFindings } from \"./map/consumers.js\";\nimport { isolationFindings } from \"./map/isolation.js\";\nimport { fleetUseCaseFindings } from \"./map/usecases.js\";\nimport { viewIdFindings } from \"./views/ids.js\";\nimport { viewsStaleFindings } from \"./views/stale.js\";\nimport { projectFindings } from \"./views/projects.js\";\nimport { fleetProjectFindings } from \"./views/fleet-project.js\";\nimport type { ParsedView } from \"../../../core/c4/parsed/dynamic-views.js\";\nimport { isUseCase } from \"../../../core/usecases/fleet.js\";\n\n/**\n * The fleet's flows as a grade may read them, or `null` when loam cannot see\n * them at all — the same `null`-suspends idiom `gradableCapabilityIds` uses,\n * and here it guards one specific wrong answer.\n *\n * `capability.requirement-unrealized` says a business promise is kept by\n * nobody. A use case is one of the two things that can keep it, so a run that\n * could not read the flows must not make that claim: no map at all (`null`)\n * and a project that did not parse are both \"loam did not look\", never\n * \"there is nothing there\". A preload that DID parse and declares no views is a\n * real, empty answer and grades normally.\n *\n * Filtered through `isUseCase` — the same opt-in `readUseCases` applies before\n * `loam list capabilities` asks this question — because the two surfaces must\n * never disagree about `keptBy`. Handing the unfiltered preload over was\n * harmless only by luck: an untagged view yields no claims, so the answers\n * matched for want of an input that could tell them apart. A `#req-`-only view\n * is exactly that input.\n */\nfunction gradableFlows(preloaded: LoadedDoc | null): readonly ParsedView[] | null {\n  if (preloaded === null || preloaded.errors.length > 0) return null;\n  return (preloaded.views ?? []).filter(isUseCase);\n}\n\n/**\n * The fleet cross-check: `services/` and the landscape both claim to name the\n * fleet, and nothing used to compare them. A directory nobody drew and an element\n * with nothing behind it were equally invisible.\n *\n * The two directions are graded differently because the evidence differs. A\n * directory that exists is a fact, so a landscape missing it is an error — every\n * view derived from that landscape is then incomplete. An element with no\n * directory may legitimately be someone else's system, so it warns, and\n * `#external` says \"deliberately not ours\" and silences it. An explicit\n * `metadata { service '<id>' }` naming nothing is an error either way: a binding\n * is a claim about this repo, not a guess at one.\n *\n * An ABSENT landscape is a finding, not a skipped check. It used to return null\n * — no target, no findings, and a fleet gate that went green over a docs repo\n * with no fleet map at all, which is the single artifact every derived view and\n * every spine check is computed from. It is graded by what its absence proves:\n * with services in `services/` it is an ERROR (a fleet that exists is undrawn),\n * with none it is a WARNING (a docs repo before its first adopt legitimately\n * has nothing to draw, but the file still belongs there — `loam init` scaffolds\n * it, and a repo missing it will silently accept never getting one).\n *\n * `preloaded` is the already-parsed landscape under --all — the same doc every\n * service check gets.\n */\nexport async function validateLandscape(\n  docsDir: DocsDir,\n  preloaded: LoadedDoc | null,\n  fleet: FleetContext,\n): Promise<TargetReport> {\n  const path = landscapeFile(docsDir);\n  const findings: Finding[] = [];\n  const report: TargetReport = {\n    kind: \"landscape\",\n    id: \"landscape\",\n    path: \"architecture/landscape.likec4\",\n    findings,\n  };\n\n  // The SET of service directories is this target's other subject, so it is\n  // graded before the map is even opened: `service.id-invalid` is a fact about\n  // `services/` that holds whether or not a landscape exists or parses, and\n  // both of those return early below. Emitted here and nowhere else — the\n  // enumeration is what makes the id a question, and one finding per fleet is\n  // what the rename fixes.\n  const entries = await listServices(docsDir, fleet);\n  findings.push(...serviceIdFindings(entries));\n  // The tree walk's own findings ride the same fleet target, before the map's\n  // early returns for the same reason `service.id-invalid` does: a stranded,\n  // colliding or mismarked directory is a fact about `services/` that holds\n  // whether or not a landscape exists or parses — and a broken tree must make\n  // the fleet gate refuse while still naming every service it found.\n  const tree = await listFleetTree(docsDir, fleet);\n  findings.push(...tree.findings);\n  // Which SHAPE each model has, read once for the whole target: it decides four\n  // of the grades below (`views/projects.ts`) and which documents the merged\n  // project holds (`views/fleet-project.ts`). Over the full enumeration, which\n  // is what `entries` is here even under `--base` — `validate --all` narrows the\n  // TARGETS it grades and never the fleet the renderer would load.\n  const models = entries.map((entry) => servicePathsAt(entry.dir).model);\n  const shapes = await fleet.modelShapes(models);\n  // A model and the renderer's project files disagreeing is a fact about\n  // `services/` too, graded here for `service.id-invalid`'s reason: it holds\n  // whether or not the map parses. One warning per service per disagreement;\n  // views/projects.ts says why a warning, why this run and not `doctor`, why\n  // the root-file gate, and why the grade is KEPT rather than spread and\n  // dropped — one of the five gates the merged-project load below, and\n  // re-deriving that fact there would let a cause and its 161-warning cascade\n  // disagree about which state the run is in.\n  const projects = await projectFindings(docsDir, entries, shapes);\n  findings.push(...projects.findings);\n  // Before the landscape's own early returns: the authorization and capability\n  // vocabularies are fleet facts that do not depend on the map existing or parsing.\n  findings.push(...(await permissionFindings(docsDir, entries, fleet)));\n  findings.push(...(await capabilityFleetFindings(docsDir, entries, fleet, gradableFlows(preloaded))));\n  // The documents that belong to no service and no feature — the fleet's ADRs\n  // and the living capability tree — are graded for their links here, once,\n  // for the same reason the two vocabularies above are: a fleet fact repeated\n  // on every service target is the report.\n  findings.push(...(await fleetLinkFindings({ docsDir, fleet })));\n  // The glossary is graded on who cites it, which is a question only the whole\n  // repository answers — so it belongs here, beside the two vocabularies, and\n  // nowhere else.\n  findings.push(...(await glossaryFindings(docsDir, fleet)));\n  // The architectural obligation vocabulary, read ONCE here and handed to the\n  // map half below: its own two verdicts hold whether or not the landscape\n  // exists or parses, and a run where somebody is fixing the map must still be\n  // told that this file does not read.\n  const obligations = await readObligations(obligationsPath(docsDir));\n  findings.push(...obligationVocabularyFindings(docsDir, obligations));\n\n  if (!existsSync(path)) {\n    const count = entries.length;\n    findings.push({\n      severity: count > 0 ? \"error\" : \"warn\",\n      code: \"landscape.missing\",\n      message:\n        `landscape: architecture/landscape.likec4 does not exist — ` +\n        (count > 0\n          ? `${count} service(s) are adopted and nothing draws the fleet. `\n          : \"nothing draws the fleet. \") +\n        \"It is the one map every derived view and the C4↔API spine are computed from: \" +\n        \"write a `specification { element softwareSystem }` + `model { … }` document there \" +\n        \"with one element per services/<id>/, bound with `metadata { service '<id>' }`.\",\n    });\n    return report;\n  }\n\n  // Conflict markers before the parse — `loam doctor`'s order, and for its\n  // reason: the markers are the cause and the parse errors are the cascade.\n  // Nothing may be concluded from a file that is two halves of two different\n  // maps, least of all that a service nobody drew is unmodelled, so this\n  // returns the way `landscape.invalid` does. An error, gating by the default\n  // rule and deliberately not carrying `gates` — that field is coherence's,\n  // and the archive gate has to ask this question itself (it does not yet).\n  // Read plainly rather than through FleetContext: this target runs outside\n  // `guarded`, and a document refused for its encoding would surface here as\n  // the whole run's `repository-unavailable` instead of one finding.\n  //\n  // Both reads are contained for that same reason — see `unreadableLandscape`.\n  // The conflict-marker read is the FIRST touch of the file, so it is the one\n  // that fails when the file cannot be opened at all, and it runs before\n  // `preloaded ??` can spare it.\n  let land: LoadedDoc;\n  try {\n    const conflict = landscapeConflictFinding(\n      \"architecture/landscape.likec4\",\n      await readFile(path, \"utf8\"),\n    );\n    if (conflict !== null) {\n      findings.push(conflict);\n      return report;\n    }\n    land = preloaded ?? (await fleet.loadLikeC4(path));\n  } catch (err) {\n    land = unreadableLandscape(err);\n  }\n  if (land.errors.length > 0) {\n    // Nothing may be concluded from a document that did not parse — in particular\n    // not that every service is unmodelled.\n    //\n    // The fleet map is a PROJECT now, not a file: `architecture/landscape.likec4`\n    // plus every `architecture/usecases/*.likec4`, merged the way the renderer\n    // merges them. So the message names the FILES that broke rather than the\n    // landscape by default — a use case with a typo'd element used to be\n    // reported as the landscape having errors, which sent the author to the\n    // wrong file with a line number that pointed at somebody else's text.\n    const broken = brokenDocumentPaths(docsDir, land.errors);\n    const named = broken.length === 0 ? \"architecture/landscape.likec4\" : broken.join(\", \");\n    // The verb agrees with the LIST, not with the count after it: `named` is a\n    // comma-joined series once two documents broke, and \"a, b has 6 error(s)\"\n    // is a sentence a reader trips over. The service arm (`service/spine.ts`)\n    // picks the verb the same way off the same list, and these two messages are\n    // read side by side in one report — a run where the fleet line says \"has\"\n    // and the service line says \"have\" about the same two files reads as two\n    // different findings.\n    const verb = broken.length > 1 ? \"have\" : \"has\";\n    findings.push({\n      severity: \"error\",\n      code: \"landscape.invalid\",\n      // The tail is general on purpose. It used to speak about use-case flows\n      // alone, so an author whose MODEL EDGE named a container was told to move\n      // a flow that does not exist (#01). Both shapes are the same defect: loam\n      // grades the `architecture/` project, the renderer loads that project plus\n      // every extending model, and a reference to a container only the model\n      // declares therefore resolves there and not here.\n      message:\n        `landscape: ${named} ${verb} ${land.errors.length} error(s) — cross-check with services/ impossible. ` +\n        \"An unresolved name that a service's extending model declares — a use-case hop or an edge \" +\n        \"naming `<service-fqn>.<container>` — renders for the renderer and resolves for nobody here: \" +\n        \"name the SERVICE on the map, and the container in that service's own model (a container-level \" +\n        \"flow lives beside the model that declares it)\",\n      // Every line carries its own file, because one project's errors can come\n      // from more than one document and a bare `L8:` is unactionable then. The\n      // prefix is `brokenDocumentPaths`'s spelling of that one error's document,\n      // so the message's file list and each line's prefix are one rule.\n      details: land.errors.map((e) => {\n        const [file] = broken.length < 2 ? [] : brokenDocumentPaths(docsDir, [e]);\n        return file === undefined ? errorText(e) : `${file} ${errorText(e)}`;\n      }),\n    });\n    return report;\n  }\n\n  // The generated views files, graded only now that the landscape has parsed:\n  // the expected bytes are a function of (tree, landscape elements, the global\n  // style ids the map declares) — the whole doc goes across so the grader and\n  // `sync` read one record. There are TWO generated files now\n  // (`subsystems.likec4` and `services.likec4`) and this pushes ONE error PER\n  // STALE FILE, each naming its own file; `views/stale.ts` says why a content\n  // compare, and why two files share one code but never one finding.\n  findings.push(...(await viewsStaleFindings(docsDir, tree, land)));\n  // The renderer's own reading of the tree: the map, every extending model and\n  // every `.likec4` beside one, merged into ONE project. It answers two\n  // questions at once and only one of them can be true at a time — either that\n  // project does not parse (`c4.fleet-project-invalid`), or it parsed and its\n  // view-id census is the real one.\n  const merged = await fleetProjectFindings({\n    docsDir, entries, shapes, fleet, tree,\n    architecture: land,\n    mapExcluded: projects.mapExcluded,\n    known: new Set(entries.map((s) => s.id)),\n  });\n  if (merged.kind === \"invalid\") findings.push(...merged.findings);\n  // Beside staleness, and for the same file: an authored view id that collides\n  // with one loam mints into it takes the whole root project down in the\n  // renderer while every check here stays green — see views/ids.ts. The census\n  // is the merged project's when there is one; otherwise the `architecture/`\n  // project's alone, whose claims are spelled relative to that directory and are\n  // made docs-relative here.\n  // `land` goes across for the SERVICE half of the reservation: an id is minted\n  // per service the map DRAWS, so the census needs the render's own element join.\n  const claims =\n    merged.kind === \"clean\"\n      ? merged.viewIds\n      : land.viewIds?.map((claim) => ({ ...claim, sourcePath: `architecture/${claim.sourcePath}` }));\n  findings.push(...viewIdFindings(claims, tree, land));\n  // The three obligation questions that need the map — where each declared rule\n  // is applied, which tags resolve to nothing, and which applications no living\n  // arch requirement covers. Here rather than beside the vocabulary above\n  // because all three are about the parsed landscape, and `land` is only\n  // trustworthy past this point.\n  findings.push(...(await obligationFindings({ docsDir, vocabulary: obligations, land, services: entries, fleet })));\n\n  const services: ReadonlySet<string> = new Set(entries.map((s) => s.id));\n  // Where each service actually sits, for every finding below that names a\n  // directory a reader is meant to open. `services/<id>/` is right only for an\n  // unfiled fleet; a filed service lives at `services/<subsystem>/…/<id>/`, and\n  // a finding pointing at the root form sends the fix to a path that does not\n  // exist. Built once here because three checks below need the same answer.\n  const pathOf = (id: string): string => {\n    const entry = entries.find((s) => s.id === id);\n    return entry === undefined ? `services/${id}` : serviceTreePath(entry);\n  };\n  // Ahead of every exemption below, because it is the one defect that can make\n  // all of them lie at once: a tag loam grades on, declared on a KIND, landing\n  // on an element that stands for one of our own directories — see kind-tags.ts.\n  findings.push(...kindTagFindings({ specification: land.specification, elements: land.elements, services }));\n  const drawn = serviceLevelElements(land.elements, services);\n  // Which services the landscape models, answered by the same resolver every\n  // edge join uses — so \"modelled\" here and \"inbound edge\" in the spine check\n  // can never disagree about what an element stands for.\n  const landSvcOf = serviceResolver(land.elements, services);\n  const modelled: ReadonlySet<string> = new Set(land.elements.map((e) => landSvcOf(e.id)));\n  // The same set with `#external` removed — the isolation check's input, and\n  // NOT `service-unmodelled`'s: a foreign box bound to one of our directories\n  // still means the directory is drawn, but \"deliberately not ours\" must not\n  // make it a subject of an advisory about our own map (R4/W12). The two\n  // binding passes have always skipped the tag; this is the third.\n  const external: ReadonlySet<string> = new Set(\n    land.elements.filter((e) => e.tags.includes(EXTERNAL_TAG)).map((e) => e.id),\n  );\n  const ours: ReadonlySet<string> = new Set(\n    land.elements.filter((e) => !external.has(e.id)).map((e) => landSvcOf(e.id)),\n  );\n\n  // The element↔directory passes: two boxes for one directory, a directory\n  // nobody drew, a binding naming nothing, and an element nobody owns.\n  const systems = drawnSystems(land.elements, services);\n  findings.push(...bindingFindings({ elements: land.elements, drawn, systems, services, modelled, pathOf }));\n\n  // What the fleet's own models say, read once for the two checks below that\n  // need it: a map edge is not the only evidence that a service consumes\n  // something, nor the only evidence that it calls out (map/attest.ts).\n  const drawnIds: ReadonlySet<string> = new Set(drawn.map((e) => e.id));\n  // `census.ts`'s predicate, handed down rather than respelled: a `fleet/map/`\n  // module may not import `fleet/`, and the store grades were skipping a\n  // datastore that IS a service in one of their two halves only.\n  const isService = (e: Elem): boolean => standsForService(e, services);\n  const attestation = await mapAttestation({\n    docsDir,\n    entries,\n    services,\n    resolve: landSvcOf,\n    standsForService: isService,\n    drawnIds,\n    fleet,\n  });\n  const attested = attestation.models;\n  const mapFacts = { relationships: land.relationships, elements: land.elements, services, resolve: landSvcOf };\n  const consumers = consumerCensus({ ...mapFacts, standsForService: isService, attested });\n  // The shape advisories run LAST, over the same drawn set and resolver the\n  // structural checks used. Any one of them suppresses `landscape.matched`\n  // below on purpose: a map with a shape warning did not fully \"agree\".\n  findings.push(...fleetShapeFindings({ drawn, services, consumers }));\n  const { nestedStores } = attestation;\n  findings.push(\n    ...datastoreFindings({\n      drawn,\n      elements: land.elements,\n      nestedStores,\n      services,\n      resolve: landSvcOf,\n      standsForService: isService,\n      consumers,\n    }),\n  );\n  // A drawn service nothing reaches, graded only where its own model attests\n  // a call across its boundary — map/isolation.ts says why the evidence gate.\n  findings.push(...isolationFindings({ land, modelled: ours, external, attested, resolve: landSvcOf, pathOf }));\n\n  // The use cases the SAME `architecture/` project declares — every\n  // `dynamic view` in the landscape and in every `architecture/usecases/*.likec4`\n  // — graded against the model above (`map/usecases.ts` holds the call and the\n  // two vocabulary reads it needs; `core/usecases/grade/usecases.ts` owns the opt-in and\n  // the grades). They ride this target for `viewsStaleFindings`' reason: a view\n  // belongs to no service, and only the fleet run has both the whole model and\n  // the enumerated `services/` in view at once.\n  findings.push(\n    ...(await fleetUseCaseFindings({\n      docsDir,\n      views: preloaded?.views ?? [],\n      elements: land.elements,\n      relationships: land.relationships,\n      services,\n      resolve: landSvcOf,\n      fleet,\n    })),\n  );\n\n  if (findings.length === 0) {\n    findings.push({\n      severity: \"ok\",\n      code: \"landscape.matched\",\n      message: `landscape: ${services.size} service(s) modelled — architecture/landscape.likec4 and services/ agree`,\n    });\n  }\n  return report;\n}\n"]}

package/dist/commands/validate/fleet/load.js

@@ -0,0 +1,118 @@
+/**
+ * The landscape's contained load path — the one phase of the fleet target that
+ * touches the filesystem before anything can be graded. Split from
+ * `./landscape.ts` when the fleet target grew past the line limit; the
+ * containment DOCTRINE below travelled with the functions it explains.
+ *
+ * The load ITSELF is no longer here. `loadArchitecture` moved to
+ * `core/c4/project/architecture.ts` when the use-case axis grew a second reader
+ * of it, and that module's banner records why; what stayed is the containment,
+ * which is command-layer business because it is about which validate TARGET a
+ * failed read is filed against.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { FleetContext } from "../../../core/fleet-context.js";
+import { featurePaths, landscapePath, servicePathsAt } from "../../../core/repo/paths.js";
+/**
+ * A landscape that could not be READ, shaped as one that did not PARSE.
+ *
+ * The landscape is the one artifact no target owns: it is read once for the
+ * whole run and it is graded on a target of its own, which runs OUTSIDE
+ * `guarded`. So a landscape.likec4 that is a directory, or that carries a
+ * permission bit this process cannot open, escaped every per-target catch and
+ * became the whole run's `repository-unavailable` — one file, and a fleet gate
+ * that said nothing about the ninety-nine services that are fine. A DANGLING
+ * symlink is not one of those shapes and never was: every read of the file is
+ * gated on an `existsSync` that follows the link, so a broken one resolves as
+ * `landscape.missing` long before anything opens it.
+ *
+ * What this contains is the FLEET-level reads, and only those: the `--all`
+ * preload, and both reads inside `validateLandscape` — the conflict-marker
+ * `readFile` and the parse. `loam validate --service <id>` and
+ * `loam validate --feature <id>` hand in no preloaded doc, so `validateService`
+ * and `validateFeature` open the same file again on demand, unwrapped and
+ * INSIDE `guarded`: an EISDIR there is still reported as `service.unreadable`
+ * or `feature.unreadable`, which files the fleet map's failure against the one
+ * target the caller happened to name. That is the wrong subject on a finding
+ * that does at least carry the offending path, and it costs those runs nothing
+ * further — they grade a single target either way, so there is no report left
+ * unwritten — which is why the remainder was left for the change that gives the
+ * landscape one load path instead of three.
+ *
+ * `guarded` is deliberately NOT widened to cover the landscape target instead.
+ * Its code ternary knows only services and features, so it would file the fleet
+ * map's failure as `feature.unreadable`; and a guarded failure yields no
+ * document, so all N services would go on to re-open the same broken file
+ * inside their own guards and emit N copies of it. Containing the IO here needs
+ * no new code and no new sentence: "could not be read" and "did not parse" have
+ * the same consequence — nothing may be concluded from this file — and
+ * `landscape.invalid` is already how that is said.
+ */
+export function unreadableLandscape(err) {
+    return {
+        errors: [{ message: err instanceof Error ? err.message : String(err) }],
+        elements: [],
+        relationships: [],
+    };
+}
+/** One landscape load, answering with `unreadableLandscape` rather than throwing. */
+export async function readLandscape(load) {
+    try {
+        return await load();
+    }
+    catch (err) {
+        return unreadableLandscape(err);
+    }
+}
+/**
+ * ONE workspace per document KIND for the whole `--all` run.
+ *
+ * The per-path load pays a fresh Langium workspace per document (~100 ms each
+ * even warm), which made the fleet's main CI command O(documents) workspace
+ * spins — 13.7 s median over the 120-service benchmark (docs/BENCHMARKS.md). So
+ * `--all` enumerates its documents up front and batch-parses them into the
+ * fleet context's memo; every load below, the landscape read included, is then a
+ * seeded hit. The enumerations are the same memoised promises the target loops
+ * reuse.
+ *
+ * TWO WORKSPACES, because the fleet's models no longer parse the same way as
+ * each other: a model that EXTENDS the map is a PROJECT (the map plus that
+ * file) and a model that stands alone is a document. So the shapes are read
+ * first, the DOCUMENT batch is asked for everything that is one — the landscape,
+ * every feature delta, every standalone model — and `prefetchServiceModels`
+ * then batches the extending half as projects, finding its own standalone list
+ * already memoised and asking for nothing.
+ *
+ * The order is load-bearing rather than tidy. `prefetchLikeC4` returns without a
+ * workspace when fewer than two documents are missing (one document gains
+ * nothing from batch isolation it already has), so splitting the documents
+ * across two calls is how a fleet of one service and one feature ends up
+ * batching the feature and parsing the model in a workspace of its own — the
+ * exact per-document spin this function exists to remove, and what
+ * `test/validate-batch-fallback.test.ts` counts.
+ *
+ * If a batch CANNOT run — a sandbox denying tmpdir writes — the prefetch seeds
+ * nothing and every load falls back to today's per-path parse: identical
+ * findings, the old speed. Single-service `validate` and `list` keep their
+ * untouched code paths on purpose, so the ≤10% regression bound in
+ * docs/BENCHMARKS.md holds by construction.
+ *
+ * It lives HERE rather than in `../validate.ts` because it is fleet-loading
+ * business and that module is the argument grammar and the target dispatch; the
+ * block also took that file to its line limit, which is the ceiling asking the
+ * question it exists to ask.
+ */
+export async function prefetchFleetDocuments(input) {
+    const { docsDir, fleet } = input;
+    const paths = input.services.filter((svc) => svc.has.model).map((svc) => servicePathsAt(svc.dir));
+    const shapes = await fleet.modelShapes(paths.map((p) => p.model));
+    const landscape = landscapePath(docsDir);
+    await fleet.prefetchLikeC4([
+        ...(existsSync(landscape) ? [landscape] : []),
+        ...input.features.filter((feat) => feat.has.delta).map((feat) => featurePaths(feat.dir).delta),
+        ...paths.filter((p) => shapes.get(resolve(p.model)) !== "extending").map((p) => p.model),
+    ]);
+    await fleet.prefetchServiceModels(docsDir, paths);
+}
+//# sourceMappingURL=load.js.map

package/dist/commands/validate/fleet/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/commands/validate/fleet/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO;QACL,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,QAAQ,EAAE,EAAE;QACZ,aAAa,EAAE,EAAE;KAClB,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA8B;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAoB;IAC/D,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,cAAc,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QAC9F,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;KACzF,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * The landscape's contained load path — the one phase of the fleet target that\n * touches the filesystem before anything can be graded. Split from\n * `./landscape.ts` when the fleet target grew past the line limit; the\n * containment DOCTRINE below travelled with the functions it explains.\n *\n * The load ITSELF is no longer here. `loadArchitecture` moved to\n * `core/c4/project/architecture.ts` when the use-case axis grew a second reader\n * of it, and that module's banner records why; what stayed is the containment,\n * which is command-layer business because it is about which validate TARGET a\n * failed read is filed against.\n */\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport type { LoadedDoc } from \"../../../core/c4/likec4.js\";\nimport { FleetContext } from \"../../../core/fleet-context.js\";\nimport type { DocsDir } from \"../../../core/kernel/ids/dirs.js\";\nimport type { FeatureEntry, ServiceEntry } from \"../../../core/repo/entries.js\";\nimport { featurePaths, landscapePath, servicePathsAt } from \"../../../core/repo/paths.js\";\n\n/**\n * A landscape that could not be READ, shaped as one that did not PARSE.\n *\n * The landscape is the one artifact no target owns: it is read once for the\n * whole run and it is graded on a target of its own, which runs OUTSIDE\n * `guarded`. So a landscape.likec4 that is a directory, or that carries a\n * permission bit this process cannot open, escaped every per-target catch and\n * became the whole run's `repository-unavailable` — one file, and a fleet gate\n * that said nothing about the ninety-nine services that are fine. A DANGLING\n * symlink is not one of those shapes and never was: every read of the file is\n * gated on an `existsSync` that follows the link, so a broken one resolves as\n * `landscape.missing` long before anything opens it.\n *\n * What this contains is the FLEET-level reads, and only those: the `--all`\n * preload, and both reads inside `validateLandscape` — the conflict-marker\n * `readFile` and the parse. `loam validate --service <id>` and\n * `loam validate --feature <id>` hand in no preloaded doc, so `validateService`\n * and `validateFeature` open the same file again on demand, unwrapped and\n * INSIDE `guarded`: an EISDIR there is still reported as `service.unreadable`\n * or `feature.unreadable`, which files the fleet map's failure against the one\n * target the caller happened to name. That is the wrong subject on a finding\n * that does at least carry the offending path, and it costs those runs nothing\n * further — they grade a single target either way, so there is no report left\n * unwritten — which is why the remainder was left for the change that gives the\n * landscape one load path instead of three.\n *\n * `guarded` is deliberately NOT widened to cover the landscape target instead.\n * Its code ternary knows only services and features, so it would file the fleet\n * map's failure as `feature.unreadable`; and a guarded failure yields no\n * document, so all N services would go on to re-open the same broken file\n * inside their own guards and emit N copies of it. Containing the IO here needs\n * no new code and no new sentence: \"could not be read\" and \"did not parse\" have\n * the same consequence — nothing may be concluded from this file — and\n * `landscape.invalid` is already how that is said.\n */\nexport function unreadableLandscape(err: unknown): LoadedDoc {\n  return {\n    errors: [{ message: err instanceof Error ? err.message : String(err) }],\n    elements: [],\n    relationships: [],\n  };\n}\n\n/** One landscape load, answering with `unreadableLandscape` rather than throwing. */\nexport async function readLandscape(load: () => Promise<LoadedDoc>): Promise<LoadedDoc> {\n  try {\n    return await load();\n  } catch (err) {\n    return unreadableLandscape(err);\n  }\n}\n\n/** Everything a `--all` run parses up front, and the enumerations it was narrowed to. */\nexport interface FleetPrefetch {\n  docsDir: DocsDir;\n  fleet: FleetContext;\n  /** The services this run grades — the `--base` narrowing when there is one. */\n  services: readonly ServiceEntry[];\n  /** The active features this run grades, likewise. */\n  features: readonly FeatureEntry[];\n}\n\n/**\n * ONE workspace per document KIND for the whole `--all` run.\n *\n * The per-path load pays a fresh Langium workspace per document (~100 ms each\n * even warm), which made the fleet's main CI command O(documents) workspace\n * spins — 13.7 s median over the 120-service benchmark (docs/BENCHMARKS.md). So\n * `--all` enumerates its documents up front and batch-parses them into the\n * fleet context's memo; every load below, the landscape read included, is then a\n * seeded hit. The enumerations are the same memoised promises the target loops\n * reuse.\n *\n * TWO WORKSPACES, because the fleet's models no longer parse the same way as\n * each other: a model that EXTENDS the map is a PROJECT (the map plus that\n * file) and a model that stands alone is a document. So the shapes are read\n * first, the DOCUMENT batch is asked for everything that is one — the landscape,\n * every feature delta, every standalone model — and `prefetchServiceModels`\n * then batches the extending half as projects, finding its own standalone list\n * already memoised and asking for nothing.\n *\n * The order is load-bearing rather than tidy. `prefetchLikeC4` returns without a\n * workspace when fewer than two documents are missing (one document gains\n * nothing from batch isolation it already has), so splitting the documents\n * across two calls is how a fleet of one service and one feature ends up\n * batching the feature and parsing the model in a workspace of its own — the\n * exact per-document spin this function exists to remove, and what\n * `test/validate-batch-fallback.test.ts` counts.\n *\n * If a batch CANNOT run — a sandbox denying tmpdir writes — the prefetch seeds\n * nothing and every load falls back to today's per-path parse: identical\n * findings, the old speed. Single-service `validate` and `list` keep their\n * untouched code paths on purpose, so the ≤10% regression bound in\n * docs/BENCHMARKS.md holds by construction.\n *\n * It lives HERE rather than in `../validate.ts` because it is fleet-loading\n * business and that module is the argument grammar and the target dispatch; the\n * block also took that file to its line limit, which is the ceiling asking the\n * question it exists to ask.\n */\nexport async function prefetchFleetDocuments(input: FleetPrefetch): Promise<void> {\n  const { docsDir, fleet } = input;\n  const paths = input.services.filter((svc) => svc.has.model).map((svc) => servicePathsAt(svc.dir));\n  const shapes = await fleet.modelShapes(paths.map((p) => p.model));\n  const landscape = landscapePath(docsDir);\n  await fleet.prefetchLikeC4([\n    ...(existsSync(landscape) ? [landscape] : []),\n    ...input.features.filter((feat) => feat.has.delta).map((feat) => featurePaths(feat.dir).delta),\n    ...paths.filter((p) => shapes.get(resolve(p.model)) !== \"extending\").map((p) => p.model),\n  ]);\n  await fleet.prefetchServiceModels(docsDir, paths);\n}\n"]}