@intentius/chant 0.79.0 → 0.81.0

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

@@ -0,0 +1,115 @@
+/**
+ * The composed workspace IR that `chant workspace graph` prints (#2537, #2524
+ * D8, ws-009, ws-018, ws-022).
+ *
+ * Each member is read through its own `chant graph --format ir`, under its
+ * own toolchain. This module takes those documents and composes them:
+ *
+ * - Every node id becomes `<member>/<id>`. Member names can't hold `/`, and
+ *   `::` keeps its meaning for stacks inside a member (`app/web::Bucket`).
+ *   Edge ends, `$ref` values in attributes, `compositeInstance`,
+ *   `runtimeOwner` and export and import nodes are rewritten the same way.
+ * - `groups.byMember` maps each member to its node ids. `byLexicon` and
+ *   `byComposite` keep their keys (a lexicon or composite type is the same
+ *   thing in every member) and merge the ids. `byStack`, `byContainer` and
+ *   `byWave` name things inside one member, so their keys are prefixed too.
+ * - `links` holds the member links (#2524 D6, #2539): the declared links and
+ *   the joins inferred from members' `imports` and `exports` with the core
+ *   `joinKey()`, labelled `exact` or `folded` (`./links.ts`). A declared link
+ *   suppresses the inferred edge it covers. `records` is the section record
+ *   kinds fill (#2524 D4), empty so far.
+ *
+ * A member's IR with no `version` field comes from a chant older than #2529.
+ * It is version 1, and it is upgraded in place by stamping that version. An IR
+ * newer than {@link GRAPH_IR_VERSION} can't be read safely, so that member is
+ * listed with a reason code and left out, like any other member that can't be
+ * read (#2524 D15).
+ *
+ * `chant graph` itself is untouched: this is the only place members compose.
+ */
+import type { Declaration } from "./declaration.js";
+import type { KindRegistry } from "./kinds.js";
+import { type LinkTableRow } from "./links.js";
+import { type GraphIR, type IRExport, type IRGroups, type IRImport, type IREdge, type IRNode } from "../graph-ir.js";
+/** The version of the composed document `chant workspace graph` writes. */
+export declare const WORKSPACE_GRAPH_VERSION = 1;
+/**
+ * Why a member is missing from the composed graph, or from any per-member
+ * run. Closed, like the `ls` reason codes: a new code is a contract change.
+ */
+export declare const MEMBER_RUN_REASON_CODES: readonly ["kind-not-run", "dir-missing", "unknown-kind", "kind-probe-failed", "command-failed", "output-unreadable", "ir-version-unsupported"];
+export type MemberRunReasonCode = (typeof MEMBER_RUN_REASON_CODES)[number];
+export interface MemberReason {
+    code: MemberRunReasonCode;
+    message: string;
+}
+export interface ComposedMember {
+    name: string;
+    dir: string;
+    kind: string;
+    status: "composed" | "skipped" | "failed";
+    reason: MemberReason | null;
+    /** The chant version that read the member, when its toolchain said. */
+    chant: string | null;
+    /** The IR version the member printed; `null` when it printed none and was upgraded as version 1. */
+    irVersion: number | null;
+    /** Whole-read facts the member's IR carried (`meta`, `pipeline`), kept apart from the composed sections. */
+    meta?: Record<string, unknown>;
+    pipeline?: unknown;
+}
+export type ComposedNode = IRNode & {
+    member: string;
+};
+export type ComposedEdge = IREdge & {
+    member: string;
+};
+export interface WorkspaceGraph {
+    version: number;
+    workspace: {
+        name: string;
+        root: string;
+    };
+    members: ComposedMember[];
+    nodes: ComposedNode[];
+    edges: ComposedEdge[];
+    groups: IRGroups & {
+        byMember: Record<string, string[]>;
+    };
+    exports: (IRExport & {
+        member: string;
+    })[];
+    imports: (IRImport & {
+        member: string;
+    })[];
+    derivedAttrs?: Record<string, string[]>;
+    /** Member links (#2524 D6, #2539), declared and inferred. Empty when no declaration is given. */
+    links: LinkTableRow[];
+    /** Record sections (#2524 D4). Empty until record kinds join the graph. */
+    records: unknown[];
+}
+/** Read one member's `chant graph --format ir` output, upgrading an unversioned (v1) IR in place. */
+export declare function readMemberIr(text: string): {
+    ir: GraphIR;
+    irVersion: number | null;
+} | {
+    reason: MemberReason;
+};
+export interface ComposeInput {
+    member: ComposedMember;
+    /** Present for a member whose IR was read. */
+    ir?: GraphIR;
+}
+/**
+ * Compose the members' IRs into the workspace document. Members keep the
+ * order they are given in. With `links`, the `links` section is filled from
+ * the declaration; `kinds` lets a member that isn't composed but whose kind
+ * lists its outputs (`other`, kinds from a package) be a link target.
+ */
+export declare function composeWorkspaceGraph(workspace: {
+    name: string;
+    root: string;
+}, inputs: ComposeInput[], links?: {
+    declaration: Declaration;
+    kinds?: KindRegistry;
+}): WorkspaceGraph;
+//# sourceMappingURL=compose-graph.d.ts.map

package/dist/workspace/compose-graph.d.ts.map

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

package/dist/workspace/compose-reports.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Merging per-member lint and audit output (#2537, #2524 D16, ws-025, ws-026).
+ *
+ * `chant workspace lint --format sarif` prints one SARIF log with one run per
+ * member, each run being what that member's own `chant lint --format sarif`
+ * printed. `chant workspace audit --format json` prints one document whose
+ * findings each carry a `member` field. Both keep what the member's chant
+ * said and only add where it came from.
+ */
+/** One member's output, as the merge sees it. */
+export interface MemberOutput {
+    /** The member's name, or `<group>:<dir>` for an example-group match. */
+    id: string;
+    /** The member or group name. */
+    member: string;
+    /** Relative to the workspace root, `"."` for the root member. */
+    dir: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    /**
+     * Directories (relative to the member) that belong to other members. Set
+     * for member `.`: its audit walks the whole root, and findings in these
+     * directories are reported by the members they belong to.
+     */
+    exclude?: string[];
+}
+type Json = Record<string, unknown>;
+/**
+ * One SARIF log with one run per member. A member's own log normally holds
+ * one run; if it holds more, their results are folded into the first so the
+ * member still has exactly one. Artifact URIs become relative to the
+ * workspace root, and each run's `automationDetails.id` is `<member>/`, the
+ * SARIF way to tell runs of one tool apart.
+ */
+export declare function mergeSarif(units: MemberOutput[], root: string): Json;
+export interface MemberAuditStatus {
+    member: string;
+    dir: string;
+    exitCode: number;
+    status: "ok" | "no-lexicons" | "failed";
+    summary: Json | null;
+    error: string | null;
+    /** What the member's audit printed instead of a report when it had nothing to audit. */
+    note?: string;
+    /** Findings dropped from member `.` because they sit in another member's directory. */
+    leftToMembers?: number;
+}
+export interface WorkspaceAuditDocument {
+    /** The audit report schema version the members wrote, when they all agree. */
+    schemaVersion: string | null;
+    workspace: {
+        name: string;
+        root: string;
+    };
+    members: MemberAuditStatus[];
+    findings: Json[];
+}
+/**
+ * Merge each member's `chant audit --format json` report. Every finding keeps
+ * its fields, with `file` still relative to its member, and gains `member`.
+ */
+export declare function mergeAudit(units: MemberOutput[], workspace: {
+    name: string;
+    root: string;
+}): WorkspaceAuditDocument;
+export {};
+//# sourceMappingURL=compose-reports.d.ts.map

package/dist/workspace/compose-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-reports.d.ts","sourceRoot":"","sources":["../../src/workspace/compose-reports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoDpC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgCpE;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC;IACxC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,CAiCnH"}

package/dist/workspace/declaration.d.ts

@@ -0,0 +1,220 @@
+/**
+ * The workspace declaration, `chant.workspace.json` or `.jsonc` (#2524 D1, D2;
+ * ws-051 for example groups).
+ *
+ * Every read goes through {@link parseDeclaration}: the text is parsed with
+ * positions, the declared `minReader` is checked, the result is validated
+ * against the JSON Schema shipped beside this file, and then the rules JSON
+ * Schema can't say are checked in code: unique names, and the placement rules.
+ * Any failure is a {@link WorkspaceReadError} naming the file, line and
+ * column. A declaration never reads as empty.
+ *
+ * Group matches depend on the tree, so their placement is checked when they
+ * are expanded ({@link resolveGroups}).
+ *
+ * Everything under `workspace/` loads only when a `chant workspace` command
+ * runs. The level-0 goldens (#2526) fail if a level-0 command loads it.
+ */
+import { EXAMPLES_KIND } from "./kinds.js";
+import { type TextLocation } from "./jsonc.js";
+import { type WorkspaceTree } from "./tree.js";
+export declare const DECLARATION_SCHEMA_ID: string;
+export declare const DECLARATION_FILES: readonly ["chant.workspace.json", "chant.workspace.jsonc"];
+export declare const DECLARATION_SCHEMA_VERSION = 1;
+/** Names no member or group may take: ledger paths use them (#2524 D7, D17). */
+export declare const RESERVED_NAMES: readonly ["_workspace", "_members"];
+export declare const NAME_PATTERN: RegExp;
+/**
+ * Why a workspace could not be read. The list is closed: a reader may switch
+ * on it, and a new code is a contract change (#2524 D15).
+ */
+export declare const WORKSPACE_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"];
+export type WorkspaceErrorCode = (typeof WORKSPACE_ERROR_CODES)[number];
+export interface ErrorLocation extends TextLocation {
+    /** The declaration file, relative to the workspace root's tree. */
+    file: string;
+}
+export declare class WorkspaceReadError extends Error {
+    readonly code: WorkspaceErrorCode;
+    readonly location?: ErrorLocation | undefined;
+    constructor(code: WorkspaceErrorCode, message: string, location?: ErrorLocation | undefined);
+    /** `file:line:column: message`, or the message alone. */
+    describe(): string;
+}
+/** A declaration check suppressed for one entry (#2535). */
+export interface Suppression {
+    /** A `WSP` id. */
+    check: string;
+    because: string;
+}
+/** What `checks` may set a declaration check's severity to. */
+export type CheckSeverity = "error" | "warning" | "info" | "off";
+export interface MemberRole {
+    name: string;
+    /** Relative to the member's directory, or null for the whole member. */
+    path: string | null;
+}
+/** A file a member lists as written by a command (#2524 D14, #2541). */
+export interface GeneratedFile {
+    /** Relative to the member's directory. */
+    path: string;
+    /** The command line that writes the file, run in the member's directory. */
+    generator: string;
+    /** What the generator reads, relative to the workspace root. */
+    sources: string[];
+    /** Set when the file is kept by hand instead of regenerated. */
+    handWritten: {
+        because: string;
+    } | null;
+    /** The entry's JSON Pointer in the file, for messages. */
+    pointer: string;
+}
+/** A member link as the consumer states it (#2524 D6, #2539). */
+export interface LinkDeclaration {
+    /** The producer member. */
+    member: string;
+    /** The producer's output, compared exactly. */
+    output: string;
+    /** The link kind as written, or null for the default (`output`). */
+    kind: string | null;
+    /** The link's JSON Pointer in the file, for messages. */
+    pointer: string;
+}
+export interface Member {
+    type: "member";
+    name: string;
+    /** Relative to the workspace root; `"."` is the root member. */
+    dir: string;
+    kind: string;
+    roles: MemberRole[];
+    /** Declared generated files, in file order. The implicit ones are not listed here (see `generated-files.ts`). */
+    generated: GeneratedFile[];
+    /** Outputs the entry lists as link targets, or null when it lists none (#2539). */
+    outputs: string[] | null;
+    /** The links this member states as a consumer, in file order (#2539). */
+    links: LinkDeclaration[];
+    upstream: string | null;
+    because: string | null;
+    suppress: Suppression[];
+    /** The entry's JSON Pointer in the file, for messages. */
+    pointer: string;
+}
+export interface Group {
+    type: "group";
+    name: string;
+    kind: typeof EXAMPLES_KIND;
+    globs: string[];
+    suppress: Suppression[];
+    pointer: string;
+    /** Where the entry's `glob` sits in the file, for placement errors. */
+    globLocation: TextLocation;
+}
+export type Entry = Member | Group;
+export interface Pin {
+    package: string | null;
+    version: string | null;
+    path: string | null;
+    integrity: string | null;
+}
+export interface Declaration {
+    name: string;
+    schema: number;
+    minReader: string | null;
+    /** Members and groups, in file order. */
+    entries: Entry[];
+    members: Member[];
+    groups: Group[];
+    pins: Pin[];
+    /** Severities set for declaration checks, keyed by `WSP` id (#2535). */
+    checks: Record<string, CheckSeverity>;
+    /** The file, relative to the workspace root's tree (`chant.workspace.json` or `.jsonc`). */
+    file: string;
+}
+/** The package whose pin names the root's chant (#2524 D15, ws-021). */
+export declare const CHANT_PACKAGE = "@intentius/chant";
+/**
+ * The version of the chant doing the reading. Read as a file, not through
+ * `require`: discovery reads the declaration on every walk under a workspace
+ * root (#2527), and a CJS require of `package.json` took about a minute per
+ * call in a vitest worker once a build had run in it, where a file read takes
+ * well under a millisecond.
+ */
+export declare function readerVersion(): string;
+/** Negative when `a` is older than `b`. Build metadata is not allowed, and prereleases sort before their release. */
+export declare function compareVersions(a: string, b: string): number;
+export interface ReadOptions {
+    /**
+     * Apply "which chant reads it" (#2524 D15, ws-021): when the declaration
+     * pins `@intentius/chant` at a version other than `reader`, that pinned
+     * chant, the root's, reads it, and this one refuses with
+     * `root-chant-required`. The read-contract commands (`ls`, `graph`,
+     * `check`, `status`) set it, and hand the command to the root's chant
+     * first when it is installed (`which-chant.ts`). Other commands leave it
+     * off: a member's own toolchain writes its ledger whatever the root pins.
+     */
+    rootChant?: boolean;
+}
+/** The version the declaration's `@intentius/chant` pin names, and where the pin is. Undefined without one. */
+export declare function pinnedChant(obj: Record<string, unknown>): {
+    version: string;
+    index: number;
+} | undefined;
+/**
+ * Parse and check a declaration's text. `file` is the name used in messages
+ * and decides the dialect: a name ending in `.jsonc` allows comments and
+ * trailing commas.
+ */
+export declare function parseDeclaration(text: string, file: string, reader?: string, options?: ReadOptions): Declaration;
+/** Whether `path` is `dir` or sits under it. Both are tree-relative; `"."` is the root. */
+export declare function isInside(path: string, dir: string): boolean;
+/**
+ * Read the declaration in directory `dir` of `tree`. Throws
+ * `declaration-missing` when neither name is there and
+ * `declaration-ambiguous` when both are.
+ */
+export declare function readDeclaration(tree: WorkspaceTree, dir?: string, options?: ReadOptions): Declaration;
+/**
+ * Walk up from `start` (tree-relative) to the nearest directory holding a
+ * declaration, within `tree`. The tree's root is the git root, so this is
+ * `findWorkspaceRoot` for a revision. Returns the directory, or undefined.
+ */
+export declare function findDeclarationDir(tree: WorkspaceTree, start: string): string | undefined;
+export interface ResolvedGroup {
+    group: Group;
+    /** Directories the globs match that hold a chant project, sorted. */
+    matches: string[];
+    /** Directories the globs match that hold none; they are left alone. */
+    skipped: string[];
+}
+/**
+ * Expand every group's globs in `tree` (rooted at the workspace root) and
+ * check where the matches sit (ws-051): a match is never a member's directory
+ * and never contains one, it doesn't sit inside a nested workspace, and no
+ * two groups claim the same directory. A match may sit inside any other
+ * member's directory; that member leaves it to the group.
+ */
+export declare function resolveGroups(declaration: Declaration, tree: WorkspaceTree): ResolvedGroup[];
+/**
+ * Which entry owns `path` (relative to the workspace root): the group whose
+ * match holds it, else the member with the deepest directory holding it, else
+ * none. A group match wins over the member whose directory it sits in
+ * (ws-051). Ledgers (#2538), telemetry attribution (#2558) and the root
+ * project's discovery (#2537) all ask this question.
+ */
+export declare function ownerOf(declaration: Declaration, groups: ResolvedGroup[], path: string): {
+    member: Member;
+} | {
+    group: Group;
+    match: string;
+} | undefined;
+/**
+ * The directories that leave the root project once the declaration exists
+ * (#2524 D0, D2): every member's directory but the root's, and every group
+ * match. The root project's build, lint, Op and audit discovery skip them
+ * (#2537); `chant workspace init` prints them before it writes.
+ */
+export declare function rootExclusions(declaration: Declaration, groups: ResolvedGroup[]): {
+    dir: string;
+    owner: string;
+}[];
+//# sourceMappingURL=declaration.d.ts.map

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

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