@intentius/chant 0.124.46 → 0.124.49

package/dist/workspace/release-candidates.d.ts.map

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

package/dist/workspace/release-candidates.js

@@ -38,7 +38,7 @@ import { latestPerComponent, readReleaseLedger } from "../lifecycle/release-ledg
 import { readAllReleases, readCuts } from "../lifecycle/release-store.js";
 import { resolveMemberLedger } from "../lifecycle/member-ledger.js";
 import { readBlobFromPath } from "../lifecycle/git.js";
-import { readerVersion } from "./declaration.js";
+import { greenBranches, readerVersion } from "./declaration.js";
 export const RELEASE_CANDIDATES_CONTRACT_VERSION = 1;
 export const RELEASE_CANDIDATES_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/release-candidates/v1/release-candidates.schema.json";
 /** Why the read stopped. Closed; each code is in `reason-codes.ts`. */
@@ -113,7 +113,10 @@ export async function releaseCandidatesDocument(query) {
         const { commitDetails } = await import("./intent.js");
         const source = scopeSource(cwd);
         const green = source.declaration?.ci?.green ?? null;
-        const trunk = resolveTrunk(top, green?.branch ?? null);
+        if (query.branch !== undefined && !(green && greenBranches(green).includes(query.branch))) {
+            throw new Error(`--branch ${query.branch} is not a branch ci.green judges${green ? ` (${greenBranches(green).join(", ")})` : ", and the declaration has no ci.green"}`);
+        }
+        const trunk = resolveTrunk(top, query.branch ?? green?.branch ?? null);
         const tip = tryGit(top, ["rev-parse", "--verify", "--quiet", `refs/remotes/${trunk.remote}/${trunk.branch}^{commit}`]) ??
             tryGit(top, ["rev-parse", "--verify", "--quiet", `refs/heads/${trunk.branch}^{commit}`]);
         const ledger = await resolveMemberLedger(cwd);

package/dist/workspace/release-train.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Release trains (#2554, #2524 D19, ws-043): one record that pins a release
+ * of every `chant` member, so several members move together.
+ *
+ * Releases stay per member (ws-043): each is a digest over its artifacts and
+ * a git commit, written to the member's own ledger by `chant release cut`. A
+ * train names one of them per member: by default the newest cut release, or
+ * the one `--pin <member>=<label|digest>` picks. It refuses unless every
+ * `chant` member of the declaration has a release, so a train never leaves a
+ * member out. It is written to `_members/_workspace/<env>/trains.jsonl`.
+ */
+import type { CommandContext } from "../cli/registry.js";
+export interface TrainMember {
+    member: string;
+    releaseDigest: string;
+    /** The release's git commit. */
+    commit: string;
+    /** The label its newest cut gave it, or null. */
+    label: string | null;
+}
+export interface ReleaseTrainRecord {
+    version: 1;
+    id: string;
+    env: string;
+    timestamp: string;
+    actor: string;
+    /** Every `chant` member, by name. */
+    members: TrainMember[];
+}
+/** What one member offers a train: its releases, newest cut first. */
+export interface MemberReleases {
+    member: string;
+    releases: TrainMember[];
+}
+/**
+ * Pick each member's release, pure. `pins` maps a member to a label or a
+ * digest; a member with no pin takes its newest. Returns the members, or
+ * the problems that stop the train.
+ */
+export declare function pickTrain(members: readonly MemberReleases[], pins?: ReadonlyMap<string, string>): {
+    members: TrainMember[];
+} | {
+    problems: string[];
+};
+/** Every `chant` member's releases, newest cut first, read from its ledger. */
+export declare function readMemberReleases(cwd: string): Promise<MemberReleases[]>;
+export declare function readReleaseTrains(cwd: string, env: string): Promise<{
+    records: ReleaseTrainRecord[];
+    malformed: number;
+}>;
+export declare function appendReleaseTrain(cwd: string, record: ReleaseTrainRecord): Promise<string>;
+export declare function runWorkspaceTrain(ctx: CommandContext): Promise<number>;
+//# sourceMappingURL=release-train.d.ts.map

package/dist/workspace/release-train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-train.d.ts","sourceRoot":"","sources":["../../src/workspace/release-train.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAID,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,IAAI,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBhK;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB/E;AAOD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAE/H;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjG;AAID,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAiD5E"}

package/dist/workspace/release-train.js

@@ -0,0 +1,134 @@
+/**
+ * Release trains (#2554, #2524 D19, ws-043): one record that pins a release
+ * of every `chant` member, so several members move together.
+ *
+ * Releases stay per member (ws-043): each is a digest over its artifacts and
+ * a git commit, written to the member's own ledger by `chant release cut`. A
+ * train names one of them per member: by default the newest cut release, or
+ * the one `--pin <member>=<label|digest>` picks. It refuses unless every
+ * `chant` member of the declaration has a release, so a train never leaves a
+ * member out. It is written to `_members/_workspace/<env>/trains.jsonl`.
+ */
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { formatError } from "../cli/format.js";
+import { readAllReleases, readCuts } from "../lifecycle/release-store.js";
+import { readDeclaration, WorkspaceReadError } from "./declaration.js";
+import { locateWorkspace } from "./which-chant.js";
+import { appendWorkspaceLine, readWorkspaceLines } from "./workspace-ledger.js";
+const TRAINS_FILE = "trains.jsonl";
+/**
+ * Pick each member's release, pure. `pins` maps a member to a label or a
+ * digest; a member with no pin takes its newest. Returns the members, or
+ * the problems that stop the train.
+ */
+export function pickTrain(members, pins = new Map()) {
+    const problems = [];
+    const picked = [];
+    for (const name of pins.keys()) {
+        if (!members.some((m) => m.member === name))
+            problems.push(`--pin ${name}: not a chant member of the workspace`);
+    }
+    for (const m of members) {
+        const pin = pins.get(m.member);
+        const r = pin === undefined ? m.releases[0] : m.releases.find((x) => x.releaseDigest === pin || x.label === pin);
+        if (!r) {
+            problems.push(pin === undefined ? `member ${m.member} has no release; cut one with chant release cut in its directory` : `member ${m.member} has no release ${pin}`);
+            continue;
+        }
+        picked.push(r);
+    }
+    return problems.length > 0 ? { problems } : { members: picked };
+}
+/** Every `chant` member's releases, newest cut first, read from its ledger. */
+export async function readMemberReleases(cwd) {
+    const located = locateWorkspace(cwd);
+    const declaration = readDeclaration(located.tree, "", { rootChant: true });
+    const out = [];
+    for (const m of declaration.members) {
+        if (m.kind !== "chant")
+            continue;
+        const loc = { cwd: located.rootOnDisk, member: m.dir === "." ? "." : m.name };
+        const { releases } = await readAllReleases(loc);
+        const { cuts } = await readCuts(loc);
+        const newest = (digest) => cuts.filter((c) => c.releaseDigest === digest).map((c) => c.timestamp).sort().at(-1) ?? "";
+        const label = (digest) => cuts.filter((c) => c.releaseDigest === digest && c.label !== null).sort((a, b) => (a.timestamp < b.timestamp ? -1 : 1)).at(-1)?.label ?? null;
+        const list = releases
+            .filter((r) => newest(r.releaseDigest) !== "")
+            .sort((a, b) => (newest(b.releaseDigest) < newest(a.releaseDigest) ? -1 : newest(b.releaseDigest) > newest(a.releaseDigest) ? 1 : 0))
+            .map((r) => ({ member: m.name, releaseDigest: r.releaseDigest, commit: r.commit, label: label(r.releaseDigest) }));
+        out.push({ member: m.name, releases: list });
+    }
+    return out;
+}
+function isTrain(v) {
+    const t = v;
+    return typeof t === "object" && t !== null && t.version === 1 && typeof t.id === "string" && typeof t.env === "string" && Array.isArray(t.members);
+}
+export async function readReleaseTrains(cwd, env) {
+    return readWorkspaceLines(cwd, env, TRAINS_FILE, isTrain);
+}
+export async function appendReleaseTrain(cwd, record) {
+    return appendWorkspaceLine(cwd, record.env, TRAINS_FILE, record, `Release train: ${record.env} ${record.id}`);
+}
+const USAGE = "chant workspace train <env> [--pin <member>=<label|digest>]... [--dry-run] [--json] | chant workspace train list <env> [--json]";
+export async function runWorkspaceTrain(ctx) {
+    const words = ctx.args.positionals ?? [];
+    const rest = words[0] === "train" ? words.slice(1) : words;
+    const listing = rest[0] === "list";
+    const env = listing ? rest[1] : rest[0];
+    if (!env) {
+        console.error(formatError({ message: "chant workspace train needs an environment", hint: USAGE }));
+        return 1;
+    }
+    const cwd = resolve(".");
+    try {
+        if (listing) {
+            const root = locateWorkspace(cwd).rootOnDisk;
+            const { records } = await readReleaseTrains(root, env);
+            if (ctx.args.json)
+                console.log(JSON.stringify({ env, trains: records }, null, 2));
+            else if (records.length === 0)
+                console.log(`No release train recorded for ${env}.`);
+            else
+                for (const t of records)
+                    console.log(`${t.timestamp}  ${t.id}  ${t.members.map((m) => `${m.member}@${m.label ?? m.releaseDigest.slice(0, 19)}`).join(" ")}`);
+            return 0;
+        }
+        const pins = new Map();
+        for (const p of ctx.args.pins ?? []) {
+            const at = p.indexOf("=");
+            if (at <= 0) {
+                console.error(formatError({ message: `--pin ${p}: expected <member>=<label|digest>`, hint: USAGE }));
+                return 1;
+            }
+            pins.set(p.slice(0, at), p.slice(at + 1));
+        }
+        const root = locateWorkspace(cwd).rootOnDisk;
+        const picked = pickTrain(await readMemberReleases(root), pins);
+        if ("problems" in picked) {
+            console.error(formatError({ message: `no release train for ${env}: every chant member needs a release`, hint: USAGE }));
+            for (const p of picked.problems)
+                console.error(`  ${p}`);
+            return 1;
+        }
+        const actor = ctx.args.actor ?? process.env.GITHUB_ACTOR ?? process.env.GITLAB_USER_LOGIN ?? process.env.USER ?? "unknown";
+        const record = { version: 1, id: `train-${randomUUID()}`, env, timestamp: new Date().toISOString(), actor, members: picked.members };
+        if (!ctx.args.dryRun)
+            await appendReleaseTrain(root, record);
+        if (ctx.args.json)
+            console.log(JSON.stringify({ ...record, written: !ctx.args.dryRun }, null, 2));
+        else {
+            console.log(`${ctx.args.dryRun ? "Would record" : "Recorded"} release train ${record.id} for ${env}:`);
+            for (const m of record.members)
+                console.log(`  ${m.member.padEnd(24)} ${m.label ?? "(no label)"}  ${m.releaseDigest}  ${m.commit.slice(0, 12)}`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (!(err instanceof WorkspaceReadError))
+            throw err;
+        console.error(formatError({ message: `${err.code}: ${err.describe()}`, hint: USAGE }));
+        return 1;
+    }
+}

package/dist/workspace/release-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/release-workflow.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,uBAAuB,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAKvE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,MAAM,EAAE,CAEzE;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAwDzE;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,iBAAiB,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CvG"}
+{"version":3,"file":"release-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/release-workflow.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,uBAAuB,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAKvE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,MAAM,EAAE,CAEzE;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAwDzE;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,iBAAiB,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CvG"}

package/dist/workspace/release-workflow.js

@@ -16,6 +16,7 @@
  * there: it costs nothing, and with it what the job uploads carries
  * provenance whether or not the group requires it.
  */
+import { ACTION_PINS, tagComments, usesRef } from "../action-pins.js";
 import { GENERATED_MARKER } from "../discovery/files.js";
 export const RELEASE_WORKFLOW_FORGES = ["github", "forgejo", "gitlab"];
 /** Where each forge's publish workflow is written, relative to the repository root. */
@@ -71,10 +72,10 @@ export function renderReleaseWorkflow(input) {
         "    runs-on: ubuntu-latest",
         ...(root ? ["    defaults:", "      run:", `        working-directory: ${root}`] : []),
         "    steps:",
-        "      - uses: actions/checkout@v4",
+        `      - uses: ${usesRef(ACTION_PINS.checkout4)}`,
         "        with:",
         "          fetch-depth: 0",
-        "      - uses: actions/setup-node@v4",
+        `      - uses: ${usesRef(ACTION_PINS.setupNode4)}`,
         "        with:",
         "          node-version: 24",
         "          registry-url: https://registry.npmjs.org",
@@ -85,7 +86,7 @@ export function renderReleaseWorkflow(input) {
         ...(verify ? [`      - run: ${chant} release verify ${label}`] : []),
         `      - run: ${chant} release publish ${label} ${flags}`,
     ];
-    return `${lines.join("\n")}\n`;
+    return tagComments(`${lines.join("\n")}\n`);
 }
 /** The header that marks the file generated, naming the command that regenerates it. */
 export function releaseWorkflowHeader(command) {

package/dist/workspace/repo-ref.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Another repository's workspace, named by URL and pinned revision (#3168).
+ *
+ * A member of kind `repo` is read the way a nested `workspace` member is
+ * (./nested-graph.ts): through that repository's own `chant workspace graph`,
+ * at the pinned revision, and nothing is ever written there. To have a tree
+ * to run that read in, chant fetches the revision into the user's cache
+ * directory, never under the workspace: one clone per URL, and one detached
+ * worktree per revision, which is immutable once made, so two reads of one
+ * revision share it and a read never moves another's checkout.
+ *
+ * This is the only place `chant workspace graph` reaches a remote, and only
+ * for repo members. `chant workspace check` never fetches.
+ *
+ * The read contract's identity names the repository a document came from
+ * (`workspace.repo`): the URL of the `origin` remote, credentials removed.
+ */
+import type { RepoRef } from "./declaration.js";
+/** A URL with any user name and password removed; scp-style and local paths are returned as they are. */
+export declare function redactUrl(url: string): string;
+/**
+ * The repository a workspace on disk came from (#3168): its git repository's
+ * `origin` URL, redacted, or null without git or an origin. Reads local git
+ * config only; never reaches the remote.
+ */
+export declare function repoIdentity(dir: string): string | null;
+/** Where fetched repositories live: `<cache>/repos`, with the cache dir as the graph cache finds it. */
+export declare function repoCacheDir(env?: NodeJS.ProcessEnv): string;
+/** The URL git is handed: a relative local path is resolved from the workspace root, since git runs in the cache. */
+export declare function fetchUrl(url: string, workspaceRoot: string): string;
+export type RepoFetch = {
+    ok: true;
+    dir: string;
+    worktree: string;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Make `ref`'s revision available in the cache, fetching it when the cache
+ * doesn't hold it, and return the directory of its workspace root there.
+ * Never throws; a failure says why.
+ */
+export declare function fetchRepoAt(ref: RepoRef, workspaceRoot: string, env?: NodeJS.ProcessEnv): RepoFetch;
+//# sourceMappingURL=repo-ref.d.ts.map

package/dist/workspace/repo-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-ref.d.ts","sourceRoot":"","sources":["../../src/workspace/repo-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,yGAAyG;AACzG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW7C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvD;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAGzE;AAED,qHAAqH;AACrH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAcrG;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAyBhH"}

package/dist/workspace/repo-ref.js

@@ -0,0 +1,114 @@
+/**
+ * Another repository's workspace, named by URL and pinned revision (#3168).
+ *
+ * A member of kind `repo` is read the way a nested `workspace` member is
+ * (./nested-graph.ts): through that repository's own `chant workspace graph`,
+ * at the pinned revision, and nothing is ever written there. To have a tree
+ * to run that read in, chant fetches the revision into the user's cache
+ * directory, never under the workspace: one clone per URL, and one detached
+ * worktree per revision, which is immutable once made, so two reads of one
+ * revision share it and a read never moves another's checkout.
+ *
+ * This is the only place `chant workspace graph` reaches a remote, and only
+ * for repo members. `chant workspace check` never fetches.
+ *
+ * The read contract's identity names the repository a document came from
+ * (`workspace.repo`): the URL of the `origin` remote, credentials removed.
+ */
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
+import { CACHE_DIR_ENV } from "./graph-cache.js";
+import { urlCredential } from "./checks/org.js";
+/** A URL with any user name and password removed; scp-style and local paths are returned as they are. */
+export function redactUrl(url) {
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(url))
+        return url;
+    try {
+        const u = new URL(url);
+        if (u.username === "" && u.password === "")
+            return url;
+        u.username = "";
+        u.password = "";
+        return u.toString();
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * The repository a workspace on disk came from (#3168): its git repository's
+ * `origin` URL, redacted, or null without git or an origin. Reads local git
+ * config only; never reaches the remote.
+ */
+export function repoIdentity(dir) {
+    try {
+        const url = execFileSync("git", ["-C", dir, "config", "--get", "remote.origin.url"], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        return url ? redactUrl(url) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Where fetched repositories live: `<cache>/repos`, with the cache dir as the graph cache finds it. */
+export function repoCacheDir(env = process.env) {
+    const base = env[CACHE_DIR_ENV] || join(env.XDG_CACHE_HOME || join(homedir(), ".cache"), "chant");
+    return join(base, "repos");
+}
+/** The URL git is handed: a relative local path is resolved from the workspace root, since git runs in the cache. */
+export function fetchUrl(url, workspaceRoot) {
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url))
+        return url;
+    if (/^(?:[^@/\s]+@)?[^:/\s]+:(?!\/\/)/.test(url) && !isAbsolute(url) && !/^[a-z]:[\\/]/i.test(url))
+        return url;
+    return resolve(workspaceRoot, url);
+}
+const GIT_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
+function git(args, cwd) {
+    try {
+        const out = execFileSync("git", args, { cwd, encoding: "utf-8", env: GIT_ENV, stdio: ["ignore", "pipe", "pipe"], timeout: 120000 });
+        return { ok: true, out };
+    }
+    catch (err) {
+        const e = err;
+        return { ok: false, out: String(e.stderr ?? e.message).trim().split("\n").slice(-3).join("; ") };
+    }
+}
+/**
+ * Make `ref`'s revision available in the cache, fetching it when the cache
+ * doesn't hold it, and return the directory of its workspace root there.
+ * Never throws; a failure says why.
+ */
+export function fetchRepoAt(ref, workspaceRoot, env = process.env) {
+    if (urlCredential(ref.url))
+        return { ok: false, message: `the repo url carries a credential, which chant refuses to use (WSP016)` };
+    const url = fetchUrl(ref.url, workspaceRoot);
+    const clone = join(repoCacheDir(env), createHash("sha256").update(url).digest("hex").slice(0, 24));
+    const worktree = join(clone, "at", ref.rev);
+    const dir = ref.workspace === "." ? worktree : join(worktree, ...ref.workspace.split("/"));
+    if (existsSync(join(worktree, ".git")))
+        return { ok: true, dir, worktree };
+    if (!existsSync(join(clone, ".git"))) {
+        mkdirSync(clone, { recursive: true });
+        const init = git(["init", "-q", clone]);
+        if (!init.ok)
+            return { ok: false, message: `could not make the cache clone in ${clone}: ${init.out}` };
+        git(["-C", clone, "remote", "add", "origin", url]);
+    }
+    const has = () => git(["-C", clone, "cat-file", "-e", `${ref.rev}^{commit}`]).ok;
+    if (!has()) {
+        // A pinned commit by id first; a server that refuses unadvertised ids gets a full fetch.
+        const byId = git(["-C", clone, "fetch", "-q", "origin", ref.rev]);
+        if (!has()) {
+            const all = git(["-C", clone, "fetch", "-q", "origin", "+refs/heads/*:refs/remotes/origin/*", "+refs/tags/*:refs/tags/*"]);
+            if (!has())
+                return { ok: false, message: `could not fetch ${ref.rev} from ${redactUrl(ref.url)}: ${all.ok ? (byId.ok ? "the repository has no such commit" : byId.out) : all.out}` };
+        }
+    }
+    const add = git(["-C", clone, "worktree", "add", "-q", "--detach", worktree, ref.rev]);
+    if (!add.ok && !existsSync(join(worktree, ".git")))
+        return { ok: false, message: `could not check out ${ref.rev} in the cache: ${add.out}` };
+    return { ok: true, dir, worktree };
+}

package/dist/workspace/run-event.schema.json

@@ -296,8 +296,8 @@
             "resolvedBy": { "type": "string", "description": "Who approved it." },
             "resolvedAt": { "type": "string", "description": "When the approval was recorded, ISO-8601." },
             "via": {
-              "enum": ["quorum", "policy", "point", "alias", "empty", null],
-              "description": "How the approval passed when it was more than one person's approval of this gate: a quorum, a policy permit, a decision point's answer, or an approval recorded under one of the gate's aliases. empty (added within contract 1 by #4045, chant 0.124.28 and newer): a release gate passed over an empty change set with no approval, on the resolution the promote wrote, whose resolvedBy is the actor running it."
+              "enum": ["quorum", "policy", "point", "alias", "empty", "workspace", null],
+              "description": "How the approval passed when it was more than one person's approval of this gate: a quorum, a policy permit, a decision point's answer, or an approval recorded under one of the gate's aliases. empty (added within contract 1 by #4045, chant 0.124.28 and newer): a release gate passed over an empty change set with no approval, on the resolution the promote wrote, whose resolvedBy is the actor running it. workspace (added within contract 1 by #2554, chant 0.124.47 and newer): a workspace gate's approval stood in for this member gate, because the member opts in at base and the approval covers this plan."
             },
             "url": { "type": "string", "description": "Where the approval was made, when known." }
           }

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

@@ -23,6 +23,7 @@
  */
 import type { CommandContext } from "../cli/registry.js";
 import { type RunLedgerWrite, type RunView } from "./runs.js";
+import { type FilterFields } from "../read-filter.js";
 import { type DsseEnvelope } from "./trust/dsse.js";
 import { type BaseSource } from "./trust/provenance.js";
 import type { TrustPolicy } from "./trust/policy.js";
@@ -84,6 +85,13 @@ export interface RunsQuery {
     base?: string;
     /** Follow squash merges on HEAD to their pull requests' original commits, fetching missing pull request refs (#3035). */
     followSquash?: boolean;
+    /** Typed filters (#4363), each `<field><op><value>` over {@link RUN_FILTER_FIELDS}; every one has to hold. Applied before the totals. */
+    where?: readonly string[];
+}
+/** The fields `runs --where` filters on (#4363). */
+export declare const RUN_FILTER_FIELDS: FilterFields;
+/** Thrown for a `--where` that can't be applied: a usage error, before the ledger is read. */
+export declare class RunsFilterError extends Error {
 }
 export interface RunsReason {
     code: RunsReasonCode;
@@ -129,6 +137,7 @@ export type RunsDocument = {
         by: string | null;
         since: string | null;
         followSquash?: boolean;
+        where?: string[];
     };
     /** The trust policy the run statements are judged by (#3192). */
     trust: RunsTrust;

package/dist/workspace/runs-cli.d.ts.map

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

package/dist/workspace/runs-cli.js

@@ -30,6 +30,7 @@ import { loadRecordKind, RecordReadError } from "./records.js";
 import { queryRecords } from "./records-cli.js";
 import { appendRunStatement, commitsByRunTrailer, endRun, foldRun, joinPatchIdCommits, joinSquashCommits, joinTrailerCommits, LEDGER_BRANCH, readRuns, recordRun, RunWriteError, startRun, } from "./runs.js";
 import { RUN_TRAILER } from "./trailers.js";
+import { FilterError, matchesWhere, parseWhere } from "../read-filter.js";
 import { locateWorkspace } from "./which-chant.js";
 import { idList } from "./work.js";
 import { AGENT_ENV } from "./write-scope.js";
@@ -46,7 +47,7 @@ export const RUNS_WRITE_SCHEMA_ID = "https://intentius.io/chant/schemas/workspac
 /** `$id` of the JSON Schema for what `runs statement` and `runs verify` print (#3192). */
 export const RUN_STATEMENT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/run-statement/v1/run-statement.schema.json";
 const USAGE = [
-    "chant workspace runs [--unit <id>] [--decision <id>] [--by <principal>] [--since <rev>] [--follow-squash] [--json]",
+    "chant workspace runs [--unit <id>] [--decision <id>] [--by <principal>] [--since <rev>] [--where <field><op><value>]... [--follow-squash] [--json]",
     "chant workspace runs start --from <file|->",
     "chant workspace runs end <run id> [--from <file|->]",
     "chant workspace runs record --from <file|->",
@@ -116,6 +117,31 @@ function groupBy(runs, keys) {
             (out.get(k) ?? out.set(k, []).get(k)).push(r);
     return out;
 }
+/** The fields `runs --where` filters on (#4363). */
+export const RUN_FILTER_FIELDS = {
+    id: "text",
+    state: "text",
+    startedAt: "time",
+    endedAt: "time",
+    outcome: "text",
+    by: "text",
+    agent: "text",
+    model: "text",
+    provider: "text",
+    lease: "text",
+    "harness.name": "text",
+    "harness.version": "text",
+    "unit.id": "text",
+    "unit.kind": "text",
+    "cost.amount": "number",
+    "cost.currency": "text",
+    "usage.inputTokens": "number",
+    "usage.outputTokens": "number",
+    ledger: "text",
+};
+/** Thrown for a `--where` that can't be applied: a usage error, before the ledger is read. */
+export class RunsFilterError extends Error {
+}
 /** The policy at base for run statements, and its summary. */
 export function runsTrust(top, base) {
     const resolved = resolveBase(top, base);
@@ -185,6 +211,15 @@ function tryGit(top, args) {
 /** Read the run ledger and build the document. Never throws a {@link WorkspaceReadError}. */
 export async function workspaceRuns(query) {
     const head = { $schema: RUNS_OUTPUT_SCHEMA_ID, contract: RUNS_CONTRACT_VERSION, chant: readerVersion() };
+    let clauses;
+    try {
+        clauses = parseWhere(query.where ?? [], RUN_FILTER_FIELDS);
+    }
+    catch (err) {
+        if (err instanceof FilterError)
+            throw new RunsFilterError(err.message);
+        throw err;
+    }
     try {
         const located = locateWorkspace(query.cwd);
         const declaration = readDeclaration(located.tree, "", { rootChant: true });
@@ -226,6 +261,7 @@ export async function workspaceRuns(query) {
             .filter((r) => wantDecision === undefined || r.decisions.some((d) => d === wantDecision || d.slice(d.indexOf("/") + 1) === wantDecision))
             .filter((r) => query.by === undefined || r.by === query.by)
             .filter((r) => !since || r.commits.some((c) => since.commits.has(c.sha)) || Date.parse(r.startedAt) > since.date)
+            .filter((r) => matchesWhere(r, clauses))
             .sort((a, b) => (a.startedAt < b.startedAt ? 1 : a.startedAt > b.startedAt ? -1 : a.id < b.id ? 1 : -1));
         const byUnit = [...groupBy(selected, (r) => [r.unit?.id ?? null])].map(([unit, rs]) => ({ unit, ...totalRuns(rs) }));
         const byDecision = [...groupBy(selected, (r) => r.decisions)].map(([decision, rs]) => ({ decision: decision, ...totalRuns(rs) }));
@@ -234,7 +270,7 @@ export async function workspaceRuns(query) {
             ...head,
             workspace: { name: declaration.name, root: located.root },
             ledger: { branch: LEDGER_BRANCH, dir, commit: tip },
-            filter: { unit: query.unit ?? null, decision: query.decision ?? null, by: query.by ?? null, since: query.since ?? null, followSquash: query.followSquash === true },
+            filter: { unit: query.unit ?? null, decision: query.decision ?? null, by: query.by ?? null, since: query.since ?? null, followSquash: query.followSquash === true, ...(query.where && query.where.length > 0 ? { where: [...query.where] } : {}) },
             trust,
             runs: selected,
             totals: { all: totalRuns(selected), byUnit, byDecision, byPrincipal },
@@ -512,7 +548,16 @@ export async function runWorkspaceRuns(ctx) {
         console.error(formatError({ message: "runs is a read and takes no --from; write with runs start, end or record", hint: USAGE }));
         return 1;
     }
-    const doc = await workspaceRuns({ cwd, unit: args.unit, decision: args.decision, by: args.by, since: args.since, base: args.base, followSquash: args.followSquash });
+    let doc;
+    try {
+        doc = await workspaceRuns({ cwd, unit: args.unit, decision: args.decision, by: args.by, since: args.since, base: args.base, followSquash: args.followSquash, where: args.where });
+    }
+    catch (err) {
+        if (!(err instanceof RunsFilterError))
+            throw err;
+        console.error(formatError({ message: err.message, hint: USAGE }));
+        return 1;
+    }
     if (args.json)
         console.log(JSON.stringify(doc, null, 2));
     else if ("error" in doc)

package/dist/workspace/runs.schema.json

@@ -111,6 +111,13 @@
             "followSquash": {
               "type": "boolean",
               "description": "Whether --follow-squash was given (#3035). Added within version 1."
+            },
+            "where": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Each --where clause, <field><op><value>, as given (#4363); every one held for each run listed, and the totals count only those runs. Absent without --where. Added within version 1."
             }
           }
         },