@intentius/chant 0.124.21 → 0.124.23

package/dist/workspace/graph.schema.json

@@ -181,6 +181,13 @@
               },
               "member": {
                 "type": "string"
+              },
+              "previously": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Names this output had before, from a rename hint a lexicon read in the member's source (a sql `-- previously:` comment). A link to one of them is told the new name."
               }
             }
           }
@@ -636,8 +643,23 @@
             "origin": {
               "enum": [
                 "declared",
+                "kind-reader",
                 "inferred:joinKey"
-              ]
+              ],
+              "description": "How the row was found: declared in chant.workspace.json, read from the member's own files by its kind's link reader (#3932), or inferred by joinKey()."
+            },
+            "reader": {
+              "type": "string",
+              "description": "A kind-reader row (#3932): the link reader that found it, such as dbt-project."
+            },
+            "file": {
+              "type": "string",
+              "description": "A kind-reader row (#3932): the file that states the link, from the workspace root."
+            },
+            "line": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "A kind-reader row (#3932): the line of file that states the link."
             },
             "resolves": {
               "const": "source"
@@ -728,8 +750,23 @@
             "origin": {
               "enum": [
                 "declared",
+                "kind-reader",
                 "inferred:joinKey"
-              ]
+              ],
+              "description": "How the row was found: declared in chant.workspace.json, read from the member's own files by its kind's link reader (#3932), or inferred by joinKey()."
+            },
+            "reader": {
+              "type": "string",
+              "description": "A kind-reader row (#3932): the link reader that found it, such as dbt-project."
+            },
+            "file": {
+              "type": "string",
+              "description": "A kind-reader row (#3932): the file that states the link, from the workspace root."
+            },
+            "line": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "A kind-reader row (#3932): the line of file that states the link."
             },
             "resolves": {
               "const": "source"
@@ -746,7 +783,8 @@
               "description": "The consumer's parameter node, when known."
             },
             "input": {
-              "type": "string"
+              "type": "string",
+              "description": "The consumer's parameter the join would feed; for a kind-reader row (#3932), the output its file reads, which no single member was found to produce."
             },
             "status": {
               "const": "ambiguous"

package/dist/workspace/intent.js

@@ -75,7 +75,7 @@ import { followSquashes, squashLineOrigins } from "./squash.js";
 import { memberDirOnDisk, memberSymbolResolvers } from "./lexicon-symbols.js";
 import { resolveSymbol, symbolResolverFor } from "./symbols.js";
 import { readTrailerJoins } from "./trailer-joins.js";
-import { joinPath, skippedDir } from "./tree.js";
+import { joinPath, skippedDir, workingTree } from "./tree.js";
 import { activeAttestors } from "./trust/attestor.js";
 import { commitProvenance, policyAtBase, resolveBase } from "./trust/provenance.js";
 import { locateWorkspace } from "./which-chant.js";
@@ -1295,7 +1295,12 @@ async function walk(query, head) {
         try {
             const groups = resolveGroups(declaration, located.tree);
             const kindsRegistry = loadKindRegistry(declaration.pins, located.rootOnDisk).registry;
-            rows = resolveLinks(declaration, sourceMemberHandles(declaration, located.tree, groups, kindsRegistry)).filter((r) => r.origin === "declared");
+            const { gatherLexiconOutputs } = await import("./lexicon-outputs.js");
+            const lexiconOutputs = await gatherLexiconOutputs(located.rootOnDisk, declaration, located.at ? workingTree(located.rootOnDisk) : located.tree, groups, kindsRegistry, {
+                atRevision: located.at !== null,
+                ...(query.loadLexicon ? { load: query.loadLexicon } : {}),
+            });
+            rows = resolveLinks(declaration, sourceMemberHandles(declaration, located.tree, groups, kindsRegistry, lexiconOutputs)).filter((r) => r.origin === "declared");
         }
         catch (err) {
             if (!(err instanceof WorkspaceReadError))

package/dist/workspace/kind-link-readers.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Links a kind reads from its member's own files (#3932).
+ *
+ * A member's links usually come from its entry in `chant.workspace.json`, or
+ * are inferred from a chant member's parameters by `joinKey()`. Some members
+ * already say what they read in files of their own: a dbt project names the
+ * tables it reads in its `sources:` YAML. A kind can name a link reader in its
+ * kinds file (`reader`), and chant runs that reader over the member's
+ * directory to derive the member's links.
+ *
+ * The readers are chant's code, listed in {@link KIND_LINK_READERS}: a kinds
+ * file stays data, and chant never imports the package that supplies it. A
+ * reader runs offline and parses files as data. It never invokes the tool
+ * whose files it reads, so `chant workspace check` keeps its promise of no
+ * network and no member code.
+ *
+ * A reader returns links with the file and line that state them, and gaps:
+ * the places it could not read without guessing, such as a templated value.
+ * `resolveLinks` (`./links.ts`) resolves the links beside the declared ones,
+ * with origin `kind-reader`; WSP093 and WSP094 name the reader's file and line,
+ * and WSP099 reports the gaps.
+ */
+import type { Declaration, Member } from "./declaration.js";
+import { type FieldValue, type KindLinkReaderName, type KindRegistry } from "./kinds.js";
+import type { WorkspaceTree } from "./tree.js";
+/** One link a reader found in the member's files. */
+export interface KindReadLink {
+    /**
+     * The producer the link names, or null when the member's files don't say
+     * which member produces it. A null producer is found among the members
+     * whose outputs include {@link anchor}; see `resolveLinks`.
+     */
+    member: string | null;
+    /** The producer's output the link reads. */
+    output: string;
+    /**
+     * The output that picks the producer when `member` is null; unset, the
+     * output itself. A dbt source column is anchored on its table, so a dropped
+     * column is missing from the member that still has the table.
+     */
+    anchor?: string;
+    /** The file that states the link, relative to the workspace root. */
+    file: string;
+    /** Its line, from 1. */
+    line: number;
+}
+/** A place the reader could not read without guessing. The links it would have stated are left out. */
+export interface KindReadGap {
+    /** Relative to the workspace root. */
+    file: string;
+    line: number;
+    message: string;
+}
+export interface KindLinkRead {
+    /** The reader that ran. */
+    reader: KindLinkReaderName;
+    links: KindReadLink[];
+    gaps: KindReadGap[];
+    /**
+     * The member field that names the producer, for messages that ask the
+     * author to set it when the files don't say (`sqlMember` for dbt).
+     */
+    producerField?: string;
+}
+/** What a reader gets: the member, its directory and resolved fields, and the tree read. */
+export interface KindReaderInput {
+    member: Member;
+    /** The member's directory, tree-relative; "" for the workspace root. */
+    dir: string;
+    /** The member's fields, defaults filled in (#3151); null when its kind declares none. */
+    fields: Record<string, FieldValue | null | Record<string, FieldValue | null>> | null;
+    tree: WorkspaceTree;
+}
+export type KindLinkReader = (input: KindReaderInput) => KindLinkRead;
+/** Every reader chant ships, by the name a kinds file uses. */
+export declare const LINK_READERS: Record<KindLinkReaderName, KindLinkReader>;
+/**
+ * Run the link reader of every member whose kind has one. A member whose
+ * directory is missing is left out. A reader that throws is reported as a
+ * gap on the member's directory, so one unreadable project never stops
+ * the check.
+ */
+export declare function readKindLinks(declaration: Declaration, tree: WorkspaceTree, kinds: KindRegistry): Map<string, KindLinkRead>;
+//# sourceMappingURL=kind-link-readers.d.ts.map

package/dist/workspace/kind-link-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-link-readers.d.ts","sourceRoot":"","sources":["../../src/workspace/kind-link-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAG5C,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACrF,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,YAAY,CAAC;AAEtE,+DAA+D;AAC/D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAEnE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAe3H"}

package/dist/workspace/kind-link-readers.js

@@ -0,0 +1,53 @@
+/**
+ * Links a kind reads from its member's own files (#3932).
+ *
+ * A member's links usually come from its entry in `chant.workspace.json`, or
+ * are inferred from a chant member's parameters by `joinKey()`. Some members
+ * already say what they read in files of their own: a dbt project names the
+ * tables it reads in its `sources:` YAML. A kind can name a link reader in its
+ * kinds file (`reader`), and chant runs that reader over the member's
+ * directory to derive the member's links.
+ *
+ * The readers are chant's code, listed in {@link KIND_LINK_READERS}: a kinds
+ * file stays data, and chant never imports the package that supplies it. A
+ * reader runs offline and parses files as data. It never invokes the tool
+ * whose files it reads, so `chant workspace check` keeps its promise of no
+ * network and no member code.
+ *
+ * A reader returns links with the file and line that state them, and gaps:
+ * the places it could not read without guessing, such as a templated value.
+ * `resolveLinks` (`./links.ts`) resolves the links beside the declared ones,
+ * with origin `kind-reader`; WSP093 and WSP094 name the reader's file and line,
+ * and WSP099 reports the gaps.
+ */
+import { resolveMemberFields } from "./kinds.js";
+import { readDbtProject } from "./dbt-project-reader.js";
+/** Every reader chant ships, by the name a kinds file uses. */
+export const LINK_READERS = {
+    "dbt-project": readDbtProject,
+};
+/**
+ * Run the link reader of every member whose kind has one. A member whose
+ * directory is missing is left out. A reader that throws is reported as a
+ * gap on the member's directory, so one unreadable project never stops
+ * the check.
+ */
+export function readKindLinks(declaration, tree, kinds) {
+    const out = new Map();
+    for (const m of declaration.members) {
+        const kind = kinds.get(m.kind);
+        if (!kind?.reader)
+            continue;
+        const dir = m.dir === "." ? "" : m.dir;
+        if (tree.stat(dir) !== "dir")
+            continue;
+        const { fields } = resolveMemberFields(kind, m.fields);
+        try {
+            out.set(m.name, LINK_READERS[kind.reader]({ member: m, dir, fields, tree }));
+        }
+        catch (err) {
+            out.set(m.name, { reader: kind.reader, links: [], gaps: [{ file: dir || ".", line: 1, message: `the ${kind.reader} reader failed: ${err.message}` }] });
+        }
+    }
+    return out;
+}

package/dist/workspace/kinds.d.ts

@@ -128,7 +128,22 @@ export interface MemberKind {
     graph?: KindGraph;
     /** The fields a member entry of this kind may set, with their defaults (#3151); unset, the kind declares none. */
     fields?: Record<string, KindField>;
+    /**
+     * The link reader chant runs over a member's own files (#3932), by name, from
+     * {@link KIND_LINK_READERS}. It derives the member's links offline, from
+     * files it parses as data; unset, the member's links are only those its
+     * entry states.
+     */
+    reader?: KindLinkReaderName;
 }
+/**
+ * The link readers chant ships (#3932). A kind names one in its kinds file as
+ * `reader`. The readers are chant's own code, not the package's: a kinds file
+ * stays data, and chant never imports the package that supplies it. Closed:
+ * a kind naming another reader is kept without one, and the load reports it.
+ */
+export declare const KIND_LINK_READERS: readonly ["dbt-project"];
+export type KindLinkReaderName = (typeof KIND_LINK_READERS)[number];
 export interface KindRegistry {
     get(name: string): MemberKind | undefined;
     /** Every member kind's name, sorted, for "unknown kind" messages. */

package/dist/workspace/kinds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/workspace/kinds.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/workspace/kinds.ts"],"names":[],"mappings":"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"}

package/dist/workspace/kinds.js

@@ -26,6 +26,13 @@ import { loadAjv2020 } from "./ajv2020.js";
 export const KINDS_SCHEMA_ID = schema.$id;
 /** The subpath a package publishes its kinds at. */
 export const KINDS_SUBPATH = "./workspace-kinds";
+/**
+ * The link readers chant ships (#3932). A kind names one in its kinds file as
+ * `reader`. The readers are chant's own code, not the package's: a kinds file
+ * stays data, and chant never imports the package that supplies it. Closed:
+ * a kind naming another reader is kept without one, and the load reports it.
+ */
+export const KIND_LINK_READERS = ["dbt-project"];
 /** The group kind (ws-051). An entry of this kind is a group, not a member. */
 export const EXAMPLES_KIND = "examples";
 /** The data member kind that holds design artifacts (#2549, ws-062). */
@@ -274,7 +281,11 @@ export function parseKindData(text, source) {
             source,
             ...(k.graph ? { graph: { lexicon: k.graph.lexicon, config: structuredClone(k.graph.config) } } : {}),
             ...(k.fields ? { fields: structuredClone(k.fields) } : {}),
+            ...(k.reader && KIND_LINK_READERS.includes(k.reader) ? { reader: k.reader } : {}),
         });
+        if (k.reader && !KIND_LINK_READERS.includes(k.reader)) {
+            problems.push(`${source}: kind ${k.name} names link reader ${k.reader}, which this chant does not have (it has ${KIND_LINK_READERS.join(", ")}); the kind is kept, and its members' links are only those their entries state`);
+        }
         for (const problem of fieldDefaultProblems(k.fields ?? {}))
             problems.push(`${source}: kind ${k.name} ${problem}`);
     }

package/dist/workspace/lexicon-outputs.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The outputs a member's lexicons report about their own declarations
+ * (#3931), read offline for `chant workspace check`.
+ *
+ * A sql member exposes each table and each column as a workspace output
+ * (`public.orders`, `public.orders.customer_id`) without anyone writing
+ * `output(...)`. The names are the lexicon's to give, so the lexicon answers
+ * through its `workspaceOutputs` hook, the way a CI lexicon answers
+ * `graphEdges` (#3910).
+ *
+ * The check never runs member code. The member's source files are folded
+ * with `foldProject` under `sandbox`, which evaluates the fold subset and
+ * imports nothing from the project: a sql `table` template becomes the real
+ * entity because the tag is the lexicon's own function, called with the
+ * folded parts. A file that does not fold is not run either. It is handed to
+ * the hook as unread, and when it is one of that lexicon's files (it uses the
+ * lexicon's tags), the hook records a gap: the member's outputs are then
+ * incomplete, and a link to a name not in them is unresolved rather than
+ * missing.
+ *
+ * Folding is asynchronous and the checks are not, so the outputs are
+ * gathered before the checks run, only for the members some declared link
+ * targets, and only for the kinds whose outputs are read from source.
+ *
+ * Under `--at` the revision's files are not on disk to fold, so a member
+ * whose lexicons report outputs gets a gap instead.
+ */
+import { type Declarable } from "../declarable.js";
+import type { LexiconUnreadSource, LexiconWorkspaceOutput } from "../graph-ir.js";
+import type { BuildRootContext, BuildRootContribution, IntrinsicDef } from "../lexicon.js";
+import type { Declaration, ResolvedGroup } from "./declaration.js";
+import type { KindRegistry } from "./kinds.js";
+import type { WorkspaceTree } from "./tree.js";
+/** What one member's lexicons report: its outputs, and why the list may be incomplete. */
+export interface MemberLexiconOutputs {
+    outputs: Pick<LexiconWorkspaceOutput, "name" | "previously">[];
+    gaps: string[];
+}
+/** The part of a lexicon plugin this reader uses. */
+export interface OutputsPlugin {
+    name?: string;
+    intrinsics?: () => IntrinsicDef[];
+    buildRoots?: (ctx: BuildRootContext) => Promise<BuildRootContribution>;
+    workspaceOutputs?: (entities: ReadonlyMap<string, Declarable>, unread?: readonly LexiconUnreadSource[]) => {
+        outputs: LexiconWorkspaceOutput[];
+        gaps?: string[];
+    } | undefined;
+}
+/** Loads a lexicon plugin by name; `loadPlugin` from the CLI unless a test swaps it. */
+export type OutputsPluginLoader = (name: string) => Promise<OutputsPlugin>;
+export interface GatherLexiconOutputsOptions {
+    /** Read under `--at`: the member's files are a revision's, not on disk, so nothing is folded. */
+    atRevision?: boolean;
+    load?: OutputsPluginLoader;
+}
+/**
+ * The lexicon outputs of every member a declared link, or a link a kind's
+ * reader found (#3932), targets, keyed by
+ * member name. A member whose lexicons report nothing is left out.
+ * `tree` is the working tree under `root`.
+ */
+export declare function gatherLexiconOutputs(root: string, declaration: Declaration, tree: WorkspaceTree, groups: readonly ResolvedGroup[], kinds: KindRegistry, options?: GatherLexiconOutputsOptions): Promise<Map<string, MemberLexiconOutputs>>;
+//# sourceMappingURL=lexicon-outputs.d.ts.map

package/dist/workspace/lexicon-outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexicon-outputs.d.ts","sourceRoot":"","sources":["../../src/workspace/lexicon-outputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC;IAC/D,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,KAAK;QAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/K;AAED,wFAAwF;AACxF,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAwDD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAmB5C"}

package/dist/workspace/lexicon-outputs.js

@@ -0,0 +1,241 @@
+/**
+ * The outputs a member's lexicons report about their own declarations
+ * (#3931), read offline for `chant workspace check`.
+ *
+ * A sql member exposes each table and each column as a workspace output
+ * (`public.orders`, `public.orders.customer_id`) without anyone writing
+ * `output(...)`. The names are the lexicon's to give, so the lexicon answers
+ * through its `workspaceOutputs` hook, the way a CI lexicon answers
+ * `graphEdges` (#3910).
+ *
+ * The check never runs member code. The member's source files are folded
+ * with `foldProject` under `sandbox`, which evaluates the fold subset and
+ * imports nothing from the project: a sql `table` template becomes the real
+ * entity because the tag is the lexicon's own function, called with the
+ * folded parts. A file that does not fold is not run either. It is handed to
+ * the hook as unread, and when it is one of that lexicon's files (it uses the
+ * lexicon's tags), the hook records a gap: the member's outputs are then
+ * incomplete, and a link to a name not in them is unresolved rather than
+ * missing.
+ *
+ * Folding is asynchronous and the checks are not, so the outputs are
+ * gathered before the checks run, only for the members some declared link
+ * targets, and only for the kinds whose outputs are read from source.
+ *
+ * Under `--at` the revision's files are not on disk to fold, so a member
+ * whose lexicons report outputs gets a gap instead.
+ */
+import { join, posix } from "node:path";
+import { isDeclarable } from "../declarable.js";
+import { kindHandles } from "./links.js";
+import { readKindLinks } from "./kind-link-readers.js";
+import { memberExcludes, sourceFiles } from "./member-handles.js";
+import { memberDirOnDisk } from "./lexicon-symbols.js";
+const firstLine = (err) => (err instanceof Error ? err.message : String(err)).split("\n")[0];
+const memberDir = (dir) => (dir === "." ? "" : dir);
+/** The `sourceDir` a member's config sets, read without running it. */
+function staticSourceDir(read) {
+    const value = read.status === "read" ? read.fields.sourceDir : undefined;
+    if (typeof value !== "string")
+        return undefined;
+    const dir = posix.normalize(value.replace(/\\/g, "/")).replace(/\/+$/, "");
+    return dir === "." || dir === "" ? undefined : dir;
+}
+/**
+ * Only the files under the member's `sourceDir`, when its config sets one, as
+ * a build reads them (#3941). Without one, every source file of the member.
+ */
+function withinSourceDir(files, member, sourceDir) {
+    if (!sourceDir)
+        return files;
+    const prefix = `${member ? `${member}/` : ""}${sourceDir}/`;
+    return files.filter((f) => f.startsWith(prefix));
+}
+/**
+ * A folded file's exports, less the entities of lexicons the member doesn't
+ * declare (#3941). An Op is a `chant` entity, and several files exporting
+ * `op` would otherwise collide and leave the whole member unread, though no
+ * hook reads Ops. Values that are not entities (a composite) are kept.
+ */
+function ownExports(exports, lexicons) {
+    const own = new Set(lexicons);
+    const out = {};
+    for (const [name, value] of exports) {
+        if (isDeclarable(value) && !own.has(value.lexicon))
+            continue;
+        out[name] = value;
+    }
+    return out;
+}
+/**
+ * The lexicon names a member's config declares, read without running it.
+ * Unlike the intent walk, a config that can't be read statically is not
+ * loaded: the check runs no member code, so it is a gap.
+ */
+async function staticMemberLexicons(dir) {
+    const { readLexiconDeclarationsStatically } = await import("../config-static.js");
+    const read = readLexiconDeclarationsStatically(dir);
+    if (read.status === "no-config")
+        return [];
+    if (read.status !== "read")
+        throw new Error(read.reason);
+    const { lexiconNames, registerLexiconDeclarations } = await import("../lexicon-module.js");
+    const { dirname } = await import("node:path");
+    registerLexiconDeclarations(read.entries, dirname(read.configPath));
+    return lexiconNames(read.entries);
+}
+/**
+ * The lexicon outputs of every member a declared link, or a link a kind's
+ * reader found (#3932), targets, keyed by
+ * member name. A member whose lexicons report nothing is left out.
+ * `tree` is the working tree under `root`.
+ */
+export async function gatherLexiconOutputs(root, declaration, tree, groups, kinds, options = {}) {
+    const out = new Map();
+    const targets = new Set(declaration.members.flatMap((m) => m.links.filter((l) => l.member !== m.name).map((l) => l.member)));
+    // Links a kind's reader finds in a member's files target members too (#3932). One that names no
+    // producer may be any other member's, so every other member is read.
+    for (const [consumer, read] of readKindLinks(declaration, tree, kinds)) {
+        for (const link of read.links) {
+            if (link.member !== null)
+                targets.add(link.member);
+            else
+                for (const m of declaration.members)
+                    if (m.name !== consumer)
+                        targets.add(m.name);
+        }
+    }
+    for (const m of declaration.members) {
+        if (!targets.has(m.name))
+            continue;
+        const kind = kinds.get(m.kind);
+        if (!kind || kindHandles(m, kind) || tree.stat(memberDir(m.dir)) !== "dir")
+            continue;
+        const read = await readMemberLexiconOutputs(root, declaration, tree, groups, m, options);
+        if (read)
+            out.set(m.name, read);
+    }
+    return out;
+}
+/** The lexicons the files import, by the package name chant gives a lexicon. */
+function importedLexicons(tree, files) {
+    const names = new Set();
+    for (const file of files) {
+        let text;
+        try {
+            text = tree.read(file);
+        }
+        catch {
+            continue;
+        }
+        for (const m of text.matchAll(/from\s+["']@intentius\/chant-lexicon-([a-z0-9-]+)(?:\/[^"']*)?["']/g))
+            names.add(m[1]);
+    }
+    return [...names].sort();
+}
+async function readMemberLexiconOutputs(root, declaration, tree, groups, m, options) {
+    const dir = memberDirOnDisk(root, m.dir);
+    const { readConfigFieldsStatically } = await import("../config-static.js");
+    const files = withinSourceDir(sourceFiles(tree, memberDir(m.dir), memberExcludes(declaration, groups, m)), memberDir(m.dir), staticSourceDir(readConfigFieldsStatically(dir, ["sourceDir"])));
+    let names;
+    try {
+        names = await staticMemberLexicons(dir);
+    }
+    catch {
+        // A config that can't be read statically is not run. The lexicons the
+        // source imports stand in for the ones it names.
+        names = importedLexicons(tree, files);
+    }
+    if (names.length === 0)
+        return undefined;
+    const load = options.load ?? (await import("../cli/plugins.js")).loadPlugin;
+    const plugins = [];
+    const gaps = [];
+    for (const name of names) {
+        try {
+            plugins.push({ name, plugin: await load(name) });
+        }
+        catch (err) {
+            gaps.push(`lexicon "${name}" could not be loaded, so the outputs it reads were not (${firstLine(err)})`);
+        }
+    }
+    const reporting = plugins.filter((p) => typeof p.plugin.workspaceOutputs === "function");
+    if (reporting.length === 0)
+        return gaps.length ? { outputs: [], gaps } : undefined;
+    if (options.atRevision) {
+        return { outputs: [], gaps: [`the outputs of lexicon ${reporting.map((p) => p.name).join(", ")} are read from the working tree's files, not a revision's`] };
+    }
+    // Fold the member's source, never run it.
+    const abs = (file) => join(root, ...file.split("/"));
+    const intrinsics = plugins.flatMap((p) => {
+        try {
+            return p.plugin.intrinsics?.() ?? [];
+        }
+        catch {
+            return [];
+        }
+    });
+    let entities = new Map();
+    const unread = [];
+    try {
+        const { foldProject } = await import("../discovery/fold-import.js");
+        const { collectEntities } = await import("../discovery/collect.js");
+        const verdicts = await foldProject(files.map(abs), intrinsics, { lexicons: names, sandbox: true });
+        const folded = [];
+        for (const file of files) {
+            const v = verdicts.get(abs(file));
+            if (v?.verdict === "fold" && v.exports) {
+                folded.push({ file: abs(file), exports: ownExports(v.exports, names) });
+                continue;
+            }
+            let text = "";
+            try {
+                text = tree.read(file);
+            }
+            catch {
+                // An unreadable file is still unread; the hook decides whether it matters.
+            }
+            const reason = v?.reason ?? (v?.taintedBy ? `it imports ${v.taintedBy.from}, which does not fold` : "it does not fold");
+            unread.push({ file, text, reason });
+        }
+        entities = collectEntities(folded, dir);
+    }
+    catch (err) {
+        return { outputs: [], gaps: [...gaps, `${m.dir}: its source could not be folded, so its lexicons' outputs were not read (${firstLine(err)})`] };
+    }
+    // A reporting lexicon's own build roots (the sql lexicon's `.sql` files) join
+    // the folded entities, as they join a build's. Only these lexicons' hooks
+    // run: they read files, and start nothing.
+    for (const { name, plugin } of reporting) {
+        if (typeof plugin.buildRoots !== "function")
+            continue;
+        const read = readConfigFieldsStatically(dir, [name, "sourceDir"]);
+        const config = read.status === "read" ? read.fields : {};
+        const sourceDir = typeof config.sourceDir === "string" ? join(dir, config.sourceDir) : undefined;
+        try {
+            const contributed = await plugin.buildRoots({ projectRoot: dir, config, entities, ...(sourceDir ? { sourceDir } : {}) });
+            for (const [key, entity] of contributed.entities)
+                if (!entities.has(key))
+                    entities.set(key, entity);
+        }
+        catch (err) {
+            gaps.push(`lexicon "${name}" could not read the member's other source files, so their declarations were not read (${firstLine(err)})`);
+        }
+    }
+    const outputs = [];
+    for (const { name, plugin } of reporting) {
+        try {
+            const report = plugin.workspaceOutputs(entities, unread);
+            if (!report)
+                continue;
+            for (const o of report.outputs)
+                outputs.push({ name: o.name, ...(o.previously?.length ? { previously: o.previously } : {}) });
+            for (const g of report.gaps ?? [])
+                gaps.push(g);
+        }
+        catch (err) {
+            gaps.push(`lexicon "${name}" workspaceOutputs threw, so its outputs were not read (${firstLine(err)})`);
+        }
+    }
+    return { outputs, gaps };
+}