@intentius/chant 0.84.0 → 0.86.0

package/dist/workspace/composites.d.ts

@@ -0,0 +1,152 @@
+/**
+ * `chant workspace graph --composites` (#2662): each composite instance the
+ * workspace's members declare, joined to the components that can deploy it.
+ *
+ * The composed graph already knows which composite instances each member
+ * declares (a node's `compositeInstance` and `compositeParent`), and a
+ * member's `chant graph --components --format ir` knows its components and
+ * the composite kinds each names in its contract's `composites`. This module
+ * joins the two and prints the rows. chant supplies the data and never the
+ * choice (ws-052): the document says how each component matched, and a
+ * reader decides what to offer.
+ *
+ * A component matches an instance in one of two ways:
+ *
+ * - `composites`: the component's contract lists one of the instance's
+ *   composite kinds, compared exactly.
+ * - `name`: the component declares no `composites`, and its `name` joins the
+ *   instance's kind or the instance's own name with the core `joinKey()`
+ *   (`LoomBackend` and `loom-backend` join, labelled `folded`). This is the
+ *   naming convention the component contract documents for a component that
+ *   says nothing (#1492).
+ *
+ * Every match says how it crosses members (`via`): `member` when the
+ * component and the instance are in the same member, `link` when the
+ * component's member reads the instance's member through a resolved member
+ * link (#2539), and `unlinked` otherwise. An instance with no component is
+ * listed with an empty `components`, so the gap is visible.
+ *
+ * Each member runs under its own toolchain, as for `workspace graph`, and at
+ * the same revision with `--at`. Nothing is written and no listener starts.
+ *
+ * Each component also lists the runtimes it can deploy on (#2674,
+ * `runtimes.ts`): `local`, and each lexicon its member configures that hosts
+ * `chant run --components`, with the command line for each.
+ */
+import type { CommandContext } from "../cli/registry.js";
+import { type JoinLabel } from "../join-key.js";
+import type { MemberReason, WorkspaceGraph } from "./compose-graph.js";
+import { type GraphQuery } from "./graph-cli.js";
+import { type ErrorLocation, type WorkspaceErrorCode } from "./declaration.js";
+import { type ComponentRuntime, type PluginLoader, type RuntimeReason } from "./runtimes.js";
+/** `$id` of the JSON Schema for the document, shipped beside this file. */
+export declare const COMPOSITES_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/composites/v1/composites.schema.json";
+/** The read-contract version the document follows. */
+export declare const COMPOSITES_CONTRACT_VERSION = 1;
+/** Why the composites couldn't be read at all: the graph's codes. */
+export declare const COMPOSITES_ERROR_CODES: readonly ["declaration-missing", "declaration-ambiguous", "declaration-unparseable", "declaration-invalid", "placement-invalid", "reader-too-old", "root-chant-required", "not-a-git-repository", "revision-unknown"];
+/** Why the list is empty, or why no instance has a component. Closed: part of the read contract. */
+export declare const COMPOSITES_REASON_CODES: readonly ["composites-no-chant-member", "composites-none-declared", "composites-no-component"];
+export type CompositesReasonCode = (typeof COMPOSITES_REASON_CODES)[number];
+/** Why a member's runtimes are only `local`, or leave out a lexicon its config lists (#2674). Closed. */
+export declare const COMPOSITES_RUNTIME_REASON_CODES: readonly ["runtimes-config-unreadable", "runtimes-lexicon-unreadable"];
+export interface CompositesMember {
+    name: string;
+    dir: string;
+    kind: string;
+    /** `read` when both its graph and its component graph were read. */
+    status: "read" | "skipped" | "failed";
+    reason: MemberReason | null;
+    chant: string | null;
+    /** Why its components' runtimes leave something out: its config, or a lexicon, couldn't be read. Empty for a member not of kind chant. */
+    runtimeReasons: RuntimeReason[];
+}
+export interface ComponentEntry {
+    /** `<member>/<name>`. */
+    id: string;
+    name: string;
+    member: string;
+    /** Declared or inferred; null when the member's chant does not print it. */
+    archetype: string | null;
+    /** The contract's `composites`, or null when it declares none. */
+    composites: string[] | null;
+    /** The component's file from the workspace root, when the member's chant names it. */
+    file: string | null;
+    /** The runtimes it can deploy on: `local` first, then each hosting lexicon its member configures. */
+    runtimes: ComponentRuntime[];
+}
+export interface ComponentMatch {
+    /** The {@link ComponentEntry} id. */
+    component: string;
+    by: "composites" | "name";
+    /** What was matched: one of the instance's kinds, or the instance's own name. */
+    against: "kind" | "instance";
+    value: string;
+    label: JoinLabel;
+    via: "member" | "link" | "unlinked";
+}
+export interface CompositeInstanceRow {
+    /** `<member>/<instance>`, the composed graph's `compositeInstance`. */
+    id: string;
+    member: string;
+    /** The instance's name in its member: the export name. */
+    instance: string;
+    /** The composite kinds its nodes came from; more than one when composites nest. */
+    kinds: string[];
+    lexicons: string[];
+    /** The composed ids of its nodes. */
+    nodes: string[];
+    components: ComponentMatch[];
+}
+interface Head {
+    $schema: string;
+    contract: number;
+    chant: string;
+}
+export type CompositesDocument = (Head & {
+    at: string | null;
+    workspace: {
+        name: string;
+        root: string;
+    };
+    members: CompositesMember[];
+    composites: CompositeInstanceRow[];
+    components: ComponentEntry[];
+    reasons: {
+        code: CompositesReasonCode;
+        message: string;
+    }[];
+    summary: {
+        composites: number;
+        withComponent: number;
+        withoutComponent: number;
+        components: number;
+    };
+}) | (Head & {
+    error: {
+        code: WorkspaceErrorCode;
+        message: string;
+        location: ErrorLocation | null;
+    };
+});
+export interface CompositesResult {
+    doc: CompositesDocument;
+    failed: boolean;
+}
+/** The composite instances in a composed graph, without their components. */
+export declare function compositeInstances(graph: Pick<WorkspaceGraph, "nodes">): CompositeInstanceRow[];
+/**
+ * Join instances to components. `links` are the composed graph's member link
+ * rows: a component crosses to another member's instance `via: "link"` when
+ * its member is the consumer of a resolved link whose producer is the
+ * instance's member.
+ */
+export declare function joinComponents(instances: CompositeInstanceRow[], components: ComponentEntry[], links: WorkspaceGraph["links"]): CompositeInstanceRow[];
+/** Read the workspace's composites and components, and build the document. Never throws a `WorkspaceReadError`. */
+export declare function workspaceComposites(query: Omit<GraphQuery, "kind" | "components" | "inTree"> & {
+    loadPlugin?: PluginLoader;
+}): Promise<CompositesResult>;
+/** `chant workspace graph --composites`: print the document as JSON, always, like the composed graph. */
+export declare function runWorkspaceComposites(ctx: CommandContext, cwd: string): Promise<number>;
+export {};
+//# sourceMappingURL=composites.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composites.d.ts","sourceRoot":"","sources":["../../src/workspace/composites.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAkB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAGjF,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAA2D,KAAK,gBAAgB,EAAuB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAExK,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,sFAAsF,CAAC;AAE/H,sDAAsD;AACtD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,uNAAoB,CAAC;AAExD,oGAAoG;AACpG,eAAO,MAAM,uBAAuB,gGAOM,CAAC;AAC3C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,yGAAyG;AACzG,eAAO,MAAM,+BAA+B,wEAAuB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0IAA0I;IAC1I,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qGAAqG;IACrG,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,YAAY,GAAG,MAAM,CAAC;IAC1B,iFAAiF;IACjF,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,UAAU,IAAI;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,kBAAkB,GAC1B,CAAC,IAAI,GAAG;IACN,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACtG,CAAC,GACF,CAAC,IAAI,GAAG;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC;AAEtG,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,kBAAkB,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6BD,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,oBAAoB,EAAE,CAqB/F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,oBAAoB,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,oBAAoB,EAAE,CA8BtJ;AAQD,mHAAmH;AACnH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuD9J;AAED,yGAAyG;AACzG,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F"}

package/dist/workspace/conformance/index.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Workspace reader conformance (#2657, ws-052; published by #2679).
+ *
+ * A reader of a workspace, such as hud or behold, reads only through the
+ * read contract (#2524 D15, ws-017) and writes nothing. This module holds a
+ * reader to that, for each read-contract command it lists:
+ *
+ *   1. The reader's `read(command, args)` returns a document that validates
+ *      against that command's output schema, with the contract version this
+ *      chant writes.
+ *   2. Each read makes exactly one chant call, and that call is the contract
+ *      command with the suite's arguments and the command's JSON flag, and
+ *      nothing else.
+ *   3. What the reader returns is the document chant printed, unchanged.
+ *   4. The workspace's files are byte for byte the same after every read.
+ *
+ * How "touched nothing else" is checked: the reader is built by calling
+ * `reader(chant)`, where `chant` is a recording transport. The reader is
+ * never given the workspace's path, so the transport is its only way to the
+ * workspace, and every call through it is recorded and compared with the
+ * contract command (points 2 and 3). Every file under the workspace is
+ * hashed before the first read and after the last one (point 4), which
+ * catches a write by any route, the transport included.
+ *
+ * This module ships in `@intentius/chant` as the subpath
+ * `@intentius/chant/workspace/conformance` and imports no test runner.
+ * {@link runWorkspaceReaderConformance} returns the problems for `node:test`
+ * or any runner, {@link checkReaderRead} checks one read, and
+ * `@intentius/chant/workspace/conformance/vitest` wraps the same checks in
+ * `describe` and `it`.
+ *
+ * The workspace: inside the chant repository it is `reference-workspace/`.
+ * Anywhere else the suite generates one in a temporary directory from the
+ * `__fixture__/` this package ships beside this module (a decision kind and record, an
+ * app, and a chant member with one composite and one component), declared
+ * by `chant workspace init --yes`, so {@link REFERENCE_READS} resolve in
+ * both. `workspaceDir` names another workspace with the same files.
+ */
+/** The read-contract commands, as a reader names them. */
+export declare const READ_CONTRACT_COMMANDS: readonly ["ls", "graph", "check", "status", "records", "graph --intent", "graph --composites"];
+export type ReadContractCommand = (typeof READ_CONTRACT_COMMANDS)[number];
+/**
+ * Each command's output schema, beside this module's parent in `src/workspace/`.
+ * The write commands' schemas (`records-new`, `records-amend`,
+ * `records-review`, #2675) are not here: a reader never runs them.
+ */
+export declare const READ_CONTRACT_SCHEMAS: Record<ReadContractCommand, string>;
+/** The flags that ask each command for its JSON document. A reader adds one of these and nothing else. */
+export declare const READ_CONTRACT_JSON_FLAGS: Record<ReadContractCommand, readonly (readonly string[])[]>;
+/** The arguments the suite passes each read, on the reference workspace or the generated one. */
+export declare const REFERENCE_READS: Record<ReadContractCommand, string[]>;
+/** One chant run: the arguments after `chant`, and what it printed. */
+export interface ChantRun {
+    argv: string[];
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+/** How a reader runs chant. It runs in the workspace; the reader never sees the path. */
+export interface ChantTransport {
+    run(argv: string[]): Promise<ChantRun>;
+}
+export interface WorkspaceReader {
+    /** Run one read-contract command with `args`, and return the parsed JSON document. */
+    read(command: ReadContractCommand, args: string[]): Promise<unknown> | unknown;
+}
+/** Build the reader over the transport the suite gives it. */
+export type WorkspaceReaderFactory = (chant: ChantTransport) => WorkspaceReader;
+export interface WorkspaceReaderConformanceOptions {
+    /**
+     * The commands the reader reads. Only these are exercised; any other is
+     * not applicable and is reported as skipped. Defaults to every command in
+     * {@link READ_CONTRACT_COMMANDS}.
+     */
+    commands?: readonly ReadContractCommand[];
+    /**
+     * The workspace to read. Defaults to the chant repository's
+     * reference-workspace inside that repository, and to a workspace generated
+     * from this package's conformance fixture anywhere else.
+     */
+    workspaceDir?: string;
+    /**
+     * The chant to run, as a command and its leading arguments. Defaults to the
+     * checkout's CLI through tsx inside the chant repository, and anywhere else
+     * to the first `node_modules/.bin/chant` above the current directory, then
+     * this package's own `bin/chant`, then `chant` on PATH.
+     */
+    chantCommand?: string[];
+    /** How long one chant run may take, in milliseconds. Default 120000. */
+    timeoutMs?: number;
+}
+export interface WorkspaceReaderConformanceConfig extends WorkspaceReaderConformanceOptions {
+    /** Short label, used in the suite name. */
+    name: string;
+    reader: WorkspaceReaderFactory;
+}
+/** What one read found. */
+export interface ReaderReadResult {
+    command: ReadContractCommand;
+    args: string[];
+    problems: string[];
+}
+/** What {@link runWorkspaceReaderConformance} found. The reader conforms when `problems` is empty. */
+export interface WorkspaceReaderConformanceReport {
+    /** Every problem, each starting with the command it concerns, or `workspace:` for a changed file. */
+    problems: string[];
+    /** The commands read, in contract order. */
+    checked: ReadContractCommand[];
+    /** The commands not in `commands`, so not applicable to this reader. */
+    skipped: ReadContractCommand[];
+    results: ReaderReadResult[];
+    /** The workspace that was read. A generated one is removed before the report is returned. */
+    workspaceDir: string;
+}
+/**
+ * The fixture the generated workspace is copied from, shipped under `src/`.
+ * Its `__fixture__` name keeps `chant workspace init` on the chant repository
+ * from proposing its projects as members.
+ */
+export declare const CONFORMANCE_FIXTURE_DIR: string;
+/** The chant the suite runs when `chantCommand` is not given. */
+export declare function defaultChantCommand(cwd?: string): string[];
+/** The reference workspace in the chant repository, or undefined in an installed copy. */
+export declare function referenceWorkspaceDir(): string | undefined;
+type Validate = ((d: unknown) => boolean) & {
+    errors?: unknown;
+};
+/** A command's output schema and a draft 2020-12 validator for it, from this package's own ajv 8. */
+export declare function readContractSchema(command: ReadContractCommand): {
+    schema: {
+        $id: string;
+    };
+    validate: Validate;
+};
+/** A digest of every file under `dir`, skipping node_modules. */
+export declare function treeDigest(dir: string): Record<string, string>;
+/** The files that differ between two {@link treeDigest}s: added, removed or changed. */
+export declare function treeChanges(before: Record<string, string>, after: Record<string, string>): string[];
+/**
+ * What is wrong with the chant calls one read made: anything but exactly one
+ * call, of `workspace <command>` with `args` in order and the command's JSON
+ * flag, and nothing else. Empty when the calls conform.
+ */
+export declare function readerCallProblems(command: ReadContractCommand, args: string[], calls: string[][]): string[];
+/**
+ * Everything wrong with one read: the chant calls it made (`calls`, and
+ * `printed`, what each printed), and the document the reader returned
+ * (`doc`). Checks points 1 to 3 of the suite; empty when the read conforms.
+ */
+export declare function checkReaderRead(command: ReadContractCommand, args: string[], calls: string[][], printed: ChantRun[], doc: unknown): string[];
+/** The commands to exercise and the ones skipped, from `commands`. Throws on a name that is not a contract command. */
+export declare function selectCommands(commands?: readonly ReadContractCommand[]): {
+    checked: ReadContractCommand[];
+    skipped: ReadContractCommand[];
+};
+/** A workspace generated for a conformance run, and how to remove it. */
+export interface ConformanceWorkspace {
+    dir: string;
+    dispose(): void;
+}
+/**
+ * Generate the conformance workspace in a temporary directory: copy
+ * `__fixture__/`, link this package in as `node_modules/@intentius/chant`
+ * so the chant member resolves it, declare the workspace with
+ * `chant workspace init --yes --name conformance` and commit it all to a new
+ * git repository on `main`.
+ */
+export declare function createConformanceWorkspace(options?: {
+    chantCommand?: string[];
+    timeoutMs?: number;
+}): ConformanceWorkspace;
+/** The workspace and chant a run uses, from its options. `dispose` removes a generated workspace. */
+export declare function conformanceTarget(options?: WorkspaceReaderConformanceOptions): {
+    workspaceDir: string;
+    chantCommand: string[];
+    dispose(): void;
+};
+/**
+ * A transport that runs chant in the workspace `target()` names and records
+ * every call and what it printed. `reset()` clears the record before a read.
+ */
+export declare function recordingTransport(target: () => {
+    workspaceDir: string;
+    chantCommand: string[];
+}, timeoutMs?: number): {
+    transport: ChantTransport;
+    calls: string[][];
+    printed: ChantRun[];
+    reset(): void;
+};
+/** Make one read through a recording transport and check it. A reader that throws is a problem, not an error. */
+export declare function readAndCheck(reader: WorkspaceReader, recorder: ReturnType<typeof recordingTransport>, command: ReadContractCommand): Promise<ReaderReadResult>;
+/**
+ * Hold a reader to the read contract, with no test runner: read each listed
+ * command once through a recording transport, check the four points, and
+ * return what is wrong. The reader conforms when `problems` is empty.
+ *
+ * ```js
+ * import { test } from "node:test";
+ * import assert from "node:assert/strict";
+ * import { runWorkspaceReaderConformance } from "@intentius/chant/workspace/conformance";
+ *
+ * test("my reader reads only through the contract", { timeout: 600_000 }, async () => {
+ *   const report = await runWorkspaceReaderConformance(myReader, { commands: ["ls", "status"] });
+ *   assert.deepEqual(report.problems, []);
+ * });
+ * ```
+ */
+export declare function runWorkspaceReaderConformance(reader: WorkspaceReaderFactory, options?: WorkspaceReaderConformanceOptions): Promise<WorkspaceReaderConformanceReport>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/workspace/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workspace/conformance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAYH,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,gGAAiG,CAAC;AACrI,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAQrE,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,mBAAmB,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAQhG,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAQjE,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChF;AAED,8DAA8D;AAC9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,CAAC;AAEhF,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gCAAiC,SAAQ,iCAAiC;IACzF,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sGAAsG;AACtG,MAAM,WAAW,gCAAgC;IAC/C,qGAAqG;IACrG,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,wEAAwE;IACxE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAA4B,CAAC;AAYjE,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAazE;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAG1D;AAED,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAGjE,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAAE,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAUhH;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY9D;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAMnG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAc5G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAkB5I;AAED,uHAAuH;AACvH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG;IAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAM5I;AAYD,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,oBAAoB,CA0B9H;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iCAAsC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAMpJ;AAsBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,SAAS,SAAU;;;;;EAqBrH;AAED,iHAAiH;AACjH,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAWpK;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAgB9K"}

package/dist/workspace/conformance/vitest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The workspace reader conformance suite for vitest (#2657, #2679):
+ * {@link describeWorkspaceReaderConformance} wraps the runner-neutral checks
+ * of `./index` in `describe` and `it`, one test per listed command and one
+ * for the workspace's files. This is the only module of the suite that
+ * imports vitest; `@intentius/chant/workspace/conformance` imports no runner.
+ */
+import { type WorkspaceReaderConformanceConfig } from "./index.js";
+export declare function describeWorkspaceReaderConformance(config: WorkspaceReaderConformanceConfig): void;
+export * from "./index.js";
+//# sourceMappingURL=vitest.d.ts.map

package/dist/workspace/conformance/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../../src/workspace/conformance/vitest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EASL,KAAK,gCAAgC,EACtC,MAAM,SAAS,CAAC;AAEjB,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,gCAAgC,GAAG,IAAI,CAsCjG;AAED,cAAc,SAAS,CAAC"}

package/dist/workspace/declaration.d.ts

@@ -80,6 +80,22 @@ export interface LinkDeclaration {
     /** The link's JSON Pointer in the file, for messages. */
     pointer: string;
 }
+/**
+ * A record kind the declaration names (#2680): the workspace's own, in the
+ * top-level `records`, or a member's, in that member's `records`.
+ */
+export interface RecordKindDeclaration {
+    /** The kind file as the entry writes it: relative to the member's directory, or to the workspace root for the workspace's own. */
+    kind: string;
+    /** The kind file from the workspace root, with / separators. */
+    path: string;
+    /** The name the entry gives the kind, or null when readers use the kind file's own `recordKind.name`. */
+    name: string | null;
+    /** The member that declares it, or null for the workspace's own. */
+    member: string | null;
+    /** The entry's JSON Pointer in the file, for messages. */
+    pointer: string;
+}
 export interface Member {
     type: "member";
     name: string;
@@ -93,6 +109,8 @@ export interface Member {
     outputs: string[] | null;
     /** The links this member states as a consumer, in file order (#2539). */
     links: LinkDeclaration[];
+    /** The record kinds this member declares, in file order (#2680). */
+    records: RecordKindDeclaration[];
     upstream: string | null;
     because: string | null;
     suppress: Suppression[];
@@ -127,6 +145,10 @@ export interface Declaration {
     pins: Pin[];
     /** Severities set for declaration checks, keyed by `WSP` id (#2535). */
     checks: Record<string, CheckSeverity>;
+    /** How many verdicts besides the decider's a record needs, or null when the declaration names none (#2671). */
+    quorum: number | null;
+    /** The workspace's own record kinds, from the top-level `records`, in file order (#2680). A member's are on the member. */
+    records: RecordKindDeclaration[];
     /** The file, relative to the workspace root's tree (`chant.workspace.json` or `.jsonc`). */
     file: string;
 }
@@ -165,6 +187,12 @@ export declare function pinnedChant(obj: Record<string, unknown>): {
  * trailing commas.
  */
 export declare function parseDeclaration(text: string, file: string, reader?: string, options?: ReadOptions): Declaration;
+/**
+ * Every record kind the declaration names (#2680), in the order readers use
+ * them: the workspace's own first, then each member's, members in file order
+ * and each list in its own order.
+ */
+export declare function declaredRecordKinds(declaration: Declaration): RecordKindDeclaration[];
 /** Whether `path` is `dir` or sits under it. Both are tree-relative; `"."` is the root. */
 export declare function isInside(path: string, dir: string): boolean;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/workspace/declaration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/workspace/declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAC3D,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEtD,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAChD,eAAO,MAAM,iBAAiB,4DAA6D,CAAC;AAC5F,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,gFAAgF;AAChF,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAClE,eAAO,MAAM,YAAY,QAA8B,CAAC;AAIxD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,uNAmBQ,CAAC;AAC3C,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,kBAAkB;IAEjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa;gBAFxB,IAAI,EAAE,kBAAkB,EACjC,OAAO,EAAE,MAAM,EACN,QAAQ,CAAC,EAAE,aAAa,YAAA;IAMnC,yDAAyD;IACzD,QAAQ,IAAI,MAAM;CAInB;AAID,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kIAAkI;IAClI,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yGAAyG;IACzG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iHAAiH;IACjH,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,yEAAyE;IACzE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,oEAAoE;IACpE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnC,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,+GAA+G;IAC/G,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2HAA2H;IAC3H,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wEAAwE;AACxE,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAIhD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAID,qHAAqH;AACrH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAkED,MAAM,WAAW,WAAW;IAC1B;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+GAA+G;AAC/G,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAMxG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAwB,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW,CAiMrI;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,qBAAqB,EAAE,CAErF;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3D;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,SAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW,CAarG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKzF;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa,EAAE,CA8B5F;AAID;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,aAAa,EAAE,EACvB,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAWlH"}

package/dist/workspace/declaration.schema.json

@@ -44,6 +44,18 @@
                 "$ref": "#/$defs/pin"
             }
         },
+        "quorum": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "How many agree verdicts besides the decider's a record needs, for every record kind with a reviews list (#2671). chant workspace records reports each record's quorum against it. Two when absent. Added in schema 1 by chant 0.86.0, so a declaration that sets it sets minReader to 0.86.0 or newer. A per-kind quorum comes later (#2650 C14)."
+        },
+        "records": {
+            "type": "array",
+            "description": "The workspace's own record kinds, each a kind file relative to the workspace root (#2680): the kinds whose records belong to no one member, such as a decisions directory at the root. A member names its own in its records. chant workspace ls lists them, and chant workspace records and graph --intent read every declared kind when --kind is not given. Added in schema 1 by chant 0.86.0, so a declaration that uses it sets minReader to 0.86.0 or newer.",
+            "items": {
+                "$ref": "#/$defs/recordKind"
+            }
+        },
         "checks": {
             "type": "object",
             "description": "Severity for the declaration checks that allow it, keyed by WSP id (#2535, ws-028): error, warning, info or off. chant workspace check refuses an id it does not know, and one whose severity is fixed.",
@@ -250,6 +262,13 @@
                         "$ref": "#/$defs/link"
                     }
                 },
+                "records": {
+                    "type": "array",
+                    "description": "The record kinds this member holds, each a kind file relative to the member's directory (#2680). chant workspace ls lists them, and chant workspace records and graph --intent read every declared kind when --kind is not given. Added in schema 1 by chant 0.86.0, so a declaration that uses it sets minReader to 0.86.0 or newer.",
+                    "items": {
+                        "$ref": "#/$defs/recordKind"
+                    }
+                },
                 "upstream": {
                     "type": "string",
                     "minLength": 1,
@@ -335,6 +354,27 @@
             "description": "A file or directory path with / separators: no leading /, no . or .. segments and no trailing /.",
             "pattern": "^(?!\\.\\.?(/|$))[^/\\\\]+(/(?!\\.\\.?(/|$))[^/\\\\]+)*$"
         },
+        "recordKind": {
+            "type": "object",
+            "description": "A record kind the workspace declares (#2680): a kind file that exports recordKind. chant workspace check fails (WSP115) when the file is missing or does not load as a record kind.",
+            "required": [
+                "kind"
+            ],
+            "properties": {
+                "kind": {
+                    "$ref": "#/$defs/path",
+                    "description": "The kind file, relative to the member's directory, or to the workspace root for the workspace's own records. A path is listed once across the declaration."
+                },
+                "name": {
+                    "$ref": "#/$defs/kindName",
+                    "description": "The name readers show for the kind. Without it, the kind file's own recordKind.name. Unique across the declaration."
+                }
+            },
+            "patternProperties": {
+                "^x-": true
+            },
+            "additionalProperties": false
+        },
         "generatedFile": {
             "type": "object",
             "description": "One generated file of a member (#2524 D14, #2541).",

package/dist/workspace/declared-kinds.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The record kinds a declaration names, loaded (#2680).
+ *
+ * `chant.workspace.json` may name the workspace's record kinds, in the
+ * top-level `records` and in each member's `records`, so a reader never has to
+ * guess which kind files exist. `chant workspace ls` lists them, `check` fails
+ * on one that doesn't load (WSP115), and `records` and `graph --intent` read
+ * every one of them when `--kind` is not given.
+ *
+ * A kind file is looked for in the tree read, which is the revision under
+ * `--at`, and loaded from the working tree, as `records --kind` loads one.
+ * Loading imports the file, so it runs only where a command already runs a
+ * kind file.
+ */
+import { type Declaration, type RecordKindDeclaration } from "./declaration.js";
+import type { WorkspaceTree } from "./tree.js";
+/** Why a declared kind can't be loaded: the codes `loadRecordKind` fails with. Closed, like every list of codes. */
+export declare const DECLARED_KIND_REASON_CODES: readonly ["kind-unreadable", "kind-invalid", "schema-unreadable", "schema-id-mismatch"];
+export type DeclaredKindReasonCode = (typeof DECLARED_KIND_REASON_CODES)[number];
+export interface DeclaredKind {
+    declared: RecordKindDeclaration;
+    /** The kind file on disk, absolute. */
+    file: string;
+    /** The kind file's `recordKind.name`, or null when it wasn't loaded. */
+    kind: string | null;
+    /** Why it can't be loaded, or null. */
+    reason: {
+        code: DeclaredKindReasonCode;
+        message: string;
+    } | null;
+}
+/** The kind file of `declared` on disk, under the workspace root `rootOnDisk`. */
+export declare function declaredKindFile(declared: RecordKindDeclaration, rootOnDisk: string): string;
+/**
+ * Every kind the declaration names, in {@link declaredRecordKinds} order, each
+ * with its name or the reason it can't be loaded. A kind file missing from
+ * `tree` is `kind-unreadable` without a load. With `load: false`, nothing is
+ * imported and only that is checked.
+ */
+export declare function loadDeclaredKinds(declaration: Declaration, tree: WorkspaceTree, rootOnDisk: string, options?: {
+    load?: boolean;
+}): Promise<DeclaredKind[]>;
+//# sourceMappingURL=declared-kinds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declared-kinds.d.ts","sourceRoot":"","sources":["../../src/workspace/declared-kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAuB,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,oHAAoH;AACpH,eAAO,MAAM,0BAA0B,yFAA0H,CAAC;AAClK,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE;QAAE,IAAI,EAAE,sBAAsB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClE;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,YAAY,EAAE,CAAC,CAyBzB"}

package/dist/workspace/graph-cli.d.ts

@@ -7,7 +7,8 @@
  *
  * With `--intent <path[:start-end]>` it prints the intent graph over one
  * region instead (#2651, `intent.ts`), a document of its own in the read
- * contract.
+ * contract. With `--composites` it prints each composite instance with the
+ * components that can deploy it (#2662, `composites.ts`), another.
  *
  * The document is part of the read contract, described by `graph.schema.json`
  * beside this file. It is printed for a failure too, with the error's reason
@@ -25,7 +26,7 @@
 import type { CommandContext, ParsedArgs } from "../cli/registry.js";
 import { type WorkspaceGraph } from "./compose-graph.js";
 import { type ErrorLocation, type WorkspaceErrorCode } from "./declaration.js";
-import { type MemberPlan, type Toolchain } from "./member-commands.js";
+import { type MemberPlan, type Toolchain, type UnitResult } from "./member-commands.js";
 import { type LocatedWorkspace } from "./which-chant.js";
 /** The version of the `graph` document this chant writes. */
 export declare const GRAPH_CONTRACT_VERSION = 1;
@@ -65,12 +66,33 @@ export interface GraphQuery {
      * rows of `links`.
      */
     kind?: string;
+    /**
+     * Also run each member's `chant graph --components --format ir` (#2662),
+     * under the same toolchain and at the same revision, and return the answers
+     * in {@link GraphResult.components}. The document is unchanged.
+     */
+    components?: boolean;
+    /**
+     * Called once the members have run, with the directory they were read from
+     * (the exported tree for `--at`, before it is removed) and the declared
+     * members the read covers. `--composites` reads each member's runtimes
+     * here (#2674).
+     */
+    inTree?: (root: string, members: readonly {
+        name: string;
+        dir: string;
+        kind: string;
+    }[]) => Promise<void>;
 }
 export interface GraphResult {
     doc: GraphDocument;
     /** A member failed or couldn't be read, or the declaration couldn't be read. */
     failed: boolean;
+    /** With {@link GraphQuery.components}: each member's component graph run, in plan order. */
+    components?: UnitResult[];
 }
+/** The command line a member runs for its component graph (#2662). */
+export declare function componentGraphArgv(args: Partial<ParsedArgs>): string[];
 /**
  * Export the workspace root's tree at `at` into a temporary directory and link
  * the working tree's `node_modules` into it, so members' configs resolve the