@intentius/chant 0.101.0 → 0.102.0

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

@@ -0,0 +1,164 @@
+/**
+ * `chant workspace runs` (#3033, ws-076): read and write the agent run
+ * record.
+ *
+ * - `runs [--unit <id>] [--decision <id>] [--by <principal>] [--since <rev>]
+ *   --json` reads every run in the ledger with the commits it made, and
+ *   totals tokens and cost per work item, per decision and per principal,
+ *   naming the runs that report no cost instead of counting them as zero
+ *   (`runs.schema.json`, a read-contract output).
+ * - `runs start --from <file|->`, `runs end <id> --from <file|->` and `runs
+ *   record --from <file|->` append a run's start, its end, or both, to
+ *   `_agent-runs/<id>.jsonl` on `chant/lifecycle` (`runs-write.schema.json`).
+ *
+ * chant records runs and never starts one: whatever ran the agent writes the
+ * record. Reads never fetch.
+ */
+import type { CommandContext } from "../cli/registry.js";
+import { type RunLedgerWrite, type RunView } from "./runs.js";
+/** The version of the `runs` documents this chant writes: read contract 1. */
+export declare const RUNS_CONTRACT_VERSION = 1;
+/** `$id` of the JSON Schema for `runs --json`, shipped beside this file. */
+export declare const RUNS_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/runs/v1/runs.schema.json";
+/** `$id` of the JSON Schema for what `runs start|end|record` print. */
+export declare const RUNS_WRITE_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/runs-write/v1/runs-write.schema.json";
+/** Why `runs` read nothing. Closed. */
+export declare const RUNS_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 RunsErrorCode = (typeof RUNS_ERROR_CODES)[number];
+/** Why part of the read is missing. The read still succeeds. Closed. */
+export declare const RUNS_REASON_CODES: readonly ["runs-no-ledger", "runs-ledger-malformed", "kind-unreadable"];
+export type RunsReasonCode = (typeof RUNS_REASON_CODES)[number];
+/** Why a run write was refused or could not run. Closed. */
+export declare const RUNS_WRITE_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", "write-usage-invalid", "write-input-invalid", "run-exists", "run-unknown", "run-ended"];
+export type RunsWriteErrorCode = (typeof RUNS_WRITE_ERROR_CODES)[number];
+/** Tokens and cost summed over some runs. */
+export interface RunTotals {
+    runs: number;
+    /** Runs with no end recorded yet. */
+    running: number;
+    /** Summed over the runs that report usage; a count a run leaves out adds nothing. */
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    /** One sum per currency, since amounts in two currencies don't add. */
+    cost: {
+        currency: string;
+        amount: number;
+    }[];
+    /** The runs that report no cost, running ones included: left out of `cost`, never counted as zero. */
+    unpriced: string[];
+    /** The runs that report no usage: left out of `tokens`. */
+    unreported: string[];
+}
+export declare function totalRuns(runs: RunView[]): RunTotals;
+export interface RunsQuery {
+    cwd: string;
+    /** Only the runs on this work item. */
+    unit?: string;
+    /** Only the runs that carried out this decision: its id, or `<kind>/<id>`. */
+    decision?: string;
+    /** Only the runs made for this principal. */
+    by?: string;
+    /** Only the runs that made a commit after `since` on HEAD, or started after its commit date. */
+    since?: string;
+}
+export interface RunsReason {
+    code: RunsReasonCode;
+    message: string;
+}
+/** What `runs --json` prints. */
+export type RunsDocument = {
+    $schema: string;
+    contract: number;
+    chant: string;
+    workspace: {
+        name: string;
+        root: string;
+    };
+    ledger: {
+        branch: string;
+        dir: string;
+        commit: string | null;
+    };
+    filter: {
+        unit: string | null;
+        decision: string | null;
+        by: string | null;
+        since: string | null;
+    };
+    /** Newest first, by when each started. */
+    runs: RunView[];
+    totals: {
+        all: RunTotals;
+        byUnit: (RunTotals & {
+            unit: string | null;
+        })[];
+        byDecision: (RunTotals & {
+            decision: string;
+        })[];
+        byPrincipal: (RunTotals & {
+            principal: string | null;
+        })[];
+    };
+    malformed: number;
+    reasons: RunsReason[];
+} | {
+    $schema: string;
+    contract: number;
+    chant: string;
+    error: {
+        code: RunsErrorCode;
+        message: string;
+    };
+};
+/**
+ * The decisions each run carried out, as `<kind>/<id>`: the ones its work
+ * item implements, read through the declared work kinds, and the records it
+ * names of a kind a work kind calls its decision kind. Fills `decisions` in
+ * place.
+ */
+export declare function resolveRunDecisions(runs: RunView[], rootOnDisk: string, declared: string[], reasons: RunsReason[]): Promise<void>;
+/** Read the run ledger and build the document. Never throws a {@link WorkspaceReadError}. */
+export declare function workspaceRuns(query: RunsQuery): Promise<RunsDocument>;
+export type RunsVerb = "start" | "end" | "record";
+/** What `runs start|end|record` print. */
+export type RunsWriteDocument = {
+    $schema: string;
+    contract: number;
+    verb: RunsVerb;
+    /** The run as the ledger now holds it. */
+    run: RunView;
+    /** The line a commit the run makes carries, `Chant-Run: <id>` (#3149). */
+    trailer: string;
+    ledger: RunLedgerWrite;
+} | {
+    $schema: string;
+    contract: number;
+    verb: RunsVerb | null;
+    error: {
+        code: RunsWriteErrorCode;
+        message: string;
+    };
+};
+export interface RunsWriteRequest {
+    verb: RunsVerb;
+    /** The run id, for `end`. */
+    id?: string;
+    /** The JSON fields, as text. */
+    fields: string;
+    cwd: string;
+    /** The agent session in `CHANT_AGENT`, the default for `agent`. */
+    agent?: string;
+    now?: () => Date;
+}
+/** Run one write and build the document it prints. */
+export declare function runsWrite(req: RunsWriteRequest): Promise<RunsWriteDocument>;
+/** The read as lines for a person. */
+export declare function formatRuns(doc: Extract<RunsDocument, {
+    runs: unknown;
+}>): string;
+export declare function runWorkspaceRuns(ctx: CommandContext): Promise<number>;
+//# sourceMappingURL=runs-cli.d.ts.map

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

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

package/dist/workspace/runs.d.ts

@@ -0,0 +1,423 @@
+/**
+ * The agent run record (#3033, ws-076): what each agent run cost and which
+ * changes it made.
+ *
+ * chant records runs and never starts one (ws-052). Whatever ran the agent,
+ * a steward step, a factory, hud's chat or a lobby that proxies model calls,
+ * reports the run through `chant workspace runs start|end|record`, and
+ * chant appends it to the run ledger on `chant/lifecycle`, beside the work
+ * lease histories (ws-068: a ledger entry is a fact about a run, never
+ * revised). Nothing is written to the working tree, and no transcript is
+ * copied: the record pins one by sha256.
+ *
+ * ## Storage
+ *
+ * `_agent-runs/<run id>.jsonl` in the ledger of the workspace root (flat at
+ * the root, under `_members/<member>/` for a nested workspace). One file per
+ * run, so concurrent runs never contend for one file, with two kinds of line:
+ *
+ * - `start`: who the run worked for (`by`), the agent session, the harness,
+ *   model and provider, the work item and lease it worked under, the records
+ *   it worked on, and the instruction pinned by hash.
+ * - `end`: the outcome, the turns and tokens, the cost with its currency and
+ *   the source of its prices, the transcript pinned by hash, and the commits
+ *   the run made, each with its `git patch-id --stable` (#3036) and, when
+ *   the writer knows them, the hunks of it the run wrote (#3034).
+ *
+ * The file name is `_agent-runs`, not `runs`, because an Op run already has
+ * `<env>/runs__<op>.jsonl` (`../lifecycle/run-ledger.ts`).
+ *
+ * ## The join
+ *
+ * A commit names its run with the `Chant-Run` trailer (#3149, ws-075). The
+ * run's end can also list commits, which joins a commit that carries no
+ * trailer. `workspace runs` reports both, and `graph --intent` links each
+ * commit to its run.
+ */
+import { z } from "zod";
+import { type RecordRef } from "./trailers.js";
+/** The directory on `chant/lifecycle` that holds the agent runs, under the workspace root's ledger prefix. */
+export declare const AGENT_RUNS_DIR = "_agent-runs";
+/** The branch the ledger is on. */
+export declare const LEDGER_BRANCH = "chant/lifecycle";
+/** A run id: one file name and one trailer value. */
+export declare const RUN_ID_PATTERN: RegExp;
+/** The tokens a run used. Every count is optional, since a harness may report only some. */
+export interface RunUsage {
+    turns: number | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+}
+/** A sum of money, with where its prices came from: a harness's own report, a proxy's price table, a provider's bill. */
+export interface RunCost {
+    amount: number;
+    /** ISO 4217, such as USD. */
+    currency: string;
+    /** What priced it, such as `harness:claude-code`, `lobby:list-2026-09` or `provider:billed`. */
+    source: string;
+}
+/** One model's share of a run, when the harness reports a breakdown. */
+export interface RunModelUsage {
+    model: string;
+    provider: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+    cost: RunCost | null;
+}
+/** A file pinned by hash and never copied: the transcript, or the instruction the run was given. */
+export interface RunPin {
+    sha256: string;
+    /** Its size in bytes, when chant hashed the file itself. */
+    bytes: number | null;
+    /** Where the caller keeps it, as the caller names it: a path on a box, a URL. chant never reads it back. */
+    ref: string | null;
+    /**
+     * For the instruction only: a short excerpt the writer chose to show beside
+     * the hash, such as its first line (#3034). The hash pins the whole
+     * instruction; the excerpt is never checked against it. Absent when none was given.
+     */
+    excerpt?: string;
+}
+/** Lines of one file that a run wrote in a commit: new-side line numbers in the commit's own version of the file. */
+export interface RunHunk {
+    /** From the repository root, as git names it in the commit's diff. */
+    path: string;
+    start: number;
+    end: number;
+}
+/** A commit a run's end lists. */
+export interface RunCommit {
+    sha: string;
+    /** `git patch-id --stable` of the commit, or null for a commit with no patch, such as a merge. */
+    patchId: string | null;
+    /**
+     * The hunks of the commit this run wrote, when the writer knows them, such
+     * as when several runs share one commit (#3034). Absent when not given: the
+     * run is then taken to have made the whole commit.
+     */
+    hunks?: RunHunk[];
+}
+/** The `start` line of `_agent-runs/<id>.jsonl`. */
+export interface RunStartLine {
+    version: 1;
+    event: "start";
+    run: string;
+    at: string;
+    /** The principal the run worked for: the person who prompted it, or the service that asked. */
+    by: string | null;
+    /** The agent session it ran as (ws-067), the value its commits carry in Chant-Agent. */
+    agent: string | null;
+    harness: {
+        name: string;
+        version: string | null;
+    };
+    model: string | null;
+    provider: string | null;
+    /** The work item it worked on, and the work kind's name when the caller gives it. */
+    unit: {
+        id: string;
+        kind: string | null;
+    } | null;
+    /** The work lease's fencing token. */
+    lease: string | null;
+    /** Other records it worked on, such as the decision a decide call answered or the review a chat turn replied to. */
+    records: RecordRef[];
+    instruction: RunPin | null;
+}
+/** The `end` line of `_agent-runs/<id>.jsonl`. */
+export interface RunEndLine {
+    version: 1;
+    event: "end";
+    run: string;
+    at: string;
+    /** How the run ended, free text such as done, not_done, failed or cancelled. */
+    outcome: string | null;
+    usage: RunUsage | null;
+    models: RunModelUsage[];
+    cost: RunCost | null;
+    transcript: RunPin | null;
+    commits: RunCommit[];
+}
+export type RunLine = RunStartLine | RunEndLine;
+/** The longest instruction excerpt kept, in characters. */
+export declare const INSTRUCTION_EXCERPT_MAX = 500;
+/** The fields `runs start --from` takes. */
+export declare const runStartInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    by: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    harness: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    lease: z.ZodOptional<z.ZodString>;
+    records: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodObject<{
+        sha256: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        excerpt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** The fields `runs end <id> --from` takes. */
+export declare const runEndInputSchema: z.ZodObject<{
+    endedAt: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        turns: z.ZodOptional<z.ZodNumber>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            source: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    cost: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strict>>;
+    transcript: z.ZodOptional<z.ZodObject<{
+        sha256: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    commits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        sha: z.ZodString;
+        hunks: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>>>;
+}, z.core.$strict>;
+/** The fields `runs record --from` takes: a start and an end in one. */
+export declare const runRecordInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    by: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    harness: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    lease: z.ZodOptional<z.ZodString>;
+    records: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodObject<{
+        sha256: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        excerpt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        turns: z.ZodOptional<z.ZodNumber>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            source: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    cost: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strict>>;
+    transcript: z.ZodOptional<z.ZodObject<{
+        sha256: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    commits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        sha: z.ZodString;
+        hunks: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>>>;
+}, z.core.$strict>;
+export type RunStartInput = z.infer<typeof runStartInputSchema>;
+export type RunEndInput = z.infer<typeof runEndInputSchema>;
+export type RunRecordInput = z.infer<typeof runRecordInputSchema>;
+/** Why a run write was refused. */
+export type RunWriteRefusal = "run-exists" | "run-unknown" | "run-ended" | "write-input-invalid" | "not-a-git-repository";
+export declare class RunWriteError extends Error {
+    readonly code: RunWriteRefusal;
+    constructor(code: RunWriteRefusal, message: string);
+}
+/** `git patch-id --stable` of one commit, or null when it has no patch, such as a merge. */
+export declare function patchIdOf(top: string, sha: string): string | null;
+/** A new run id: the start time to the second, and eight random hex digits. */
+export declare function newRunId(now: Date): string;
+/** Parse one run file, oldest line first. Lines that aren't run events are counted and skipped. */
+export declare function parseRunFile(content: string, id: string): {
+    lines: RunLine[];
+    malformed: number;
+};
+/** The ledger directory of the workspace whose root is `rootOnDisk`, on the branch. */
+export declare function runsDir(rootOnDisk: string): Promise<string>;
+/** Every run file in `dir` on the local branch, by run id, and the branch tip read. Never fetches. */
+export declare function readRunFiles(top: string, dir: string): {
+    tip: string | null;
+    files: Map<string, {
+        path: string;
+        content: string;
+    }>;
+};
+/** Where a write went. */
+export interface RunLedgerWrite {
+    branch: string;
+    path: string;
+    commit: string;
+    /** Whether chant/lifecycle reached the remote; false with no remote too. */
+    pushed: boolean;
+}
+export interface RunWriteResult {
+    id: string;
+    /** Every line of the run's file after the write. */
+    lines: RunLine[];
+    ledger: RunLedgerWrite;
+}
+export interface RunWriteContext {
+    /** The git top. */
+    top: string;
+    /** The workspace root on disk, whose ledger holds the runs. */
+    rootOnDisk: string;
+    /** What relative paths in the fields resolve against. */
+    cwd: string;
+    now?: () => Date;
+}
+/** `runs start`: a run's start, with a new id unless the fields give one. Refused with `run-exists` for an id in use. */
+export declare function startRun(fields: unknown, ctx: RunWriteContext): Promise<RunWriteResult>;
+/** `runs end <id>`: a started run's end. Refused with `run-unknown` when it never started and `run-ended` when it already ended. */
+export declare function endRun(id: string, fields: unknown, ctx: RunWriteContext): Promise<RunWriteResult>;
+/** `runs record`: a run that has finished, its start and end in one write. */
+export declare function recordRun(fields: unknown, ctx: RunWriteContext): Promise<RunWriteResult>;
+/** A commit a run made, as the read reports it. */
+export interface RunCommitView {
+    sha: string;
+    patchId: string | null;
+    /** How the commit joins the run: `trailer` when it carries `Chant-Run`, `record` when the run's end lists it. */
+    joinedBy: ("trailer" | "record")[];
+    /** The hunks of the commit the run's end says it wrote, or null when it gives none (#3034). */
+    hunks: RunHunk[] | null;
+}
+/** One run, its start and end folded together, as `runs --json` and `graph --intent` report it. */
+export interface RunView {
+    id: string;
+    /** `running` until its end is recorded. */
+    state: "running" | "ended";
+    startedAt: string;
+    endedAt: string | null;
+    outcome: string | null;
+    by: string | null;
+    agent: string | null;
+    harness: {
+        name: string;
+        version: string | null;
+    };
+    model: string | null;
+    provider: string | null;
+    unit: {
+        id: string;
+        kind: string | null;
+    } | null;
+    lease: string | null;
+    records: RecordRef[];
+    instruction: RunPin | null;
+    usage: RunUsage | null;
+    models: RunModelUsage[];
+    cost: RunCost | null;
+    transcript: RunPin | null;
+    commits: RunCommitView[];
+    /** The decisions the run carried out, as `<kind>/<id>`: the ones its work item implements, and the decision records it names. */
+    decisions: string[];
+    /** Its file on the branch. */
+    ledger: string;
+}
+/** Fold a run's lines into one view, or undefined when it has no start. */
+export declare function foldRun(id: string, path: string, lines: RunLine[]): RunView | undefined;
+/** Every run in the ledger of the workspace at `rootOnDisk`, by id, with the malformed line count. Never fetches. */
+export declare function readRuns(top: string, rootOnDisk: string): Promise<{
+    tip: string | null;
+    dir: string;
+    runs: Map<string, RunView>;
+    malformed: number;
+}>;
+/**
+ * The commits reachable from `rev` that carry a `Chant-Run` trailer, by run
+ * id, newest first. One `git log` over the history; nothing is fetched.
+ */
+export declare function commitsByRunTrailer(top: string, rev?: string): Map<string, string[]>;
+/** Add the commits that name each run by trailer to its `commits`, after the ones its end lists. */
+export declare function joinTrailerCommits(runs: Map<string, RunView>, byTrailer: Map<string, string[]>, top: string): void;
+/** A run as a commit in the intent walks names it: enough to say which model and harness made the change, and for whom. */
+export interface RunRef {
+    id: string;
+    /** Whether the ledger has the run. A trailer can name a run whose record is missing or not fetched. */
+    recorded: boolean;
+    state: "running" | "ended" | null;
+    harness: string | null;
+    model: string | null;
+    provider: string | null;
+    by: string | null;
+    agent: string | null;
+    unit: string | null;
+    /** `trailer`: the commit carries `Chant-Run` with the id. `record`: the run's end lists the commit. */
+    joinedBy: ("trailer" | "record")[];
+}
+/**
+ * For each commit, the runs that made it: the run its `Chant-Run` trailer
+ * names, and every run whose end lists it. Reads the run ledger once from the
+ * local branch; never fetches.
+ */
+export declare function runsForCommits(top: string, rootOnDisk: string, commits: {
+    sha: string;
+    run: string | null;
+}[]): Promise<{
+    refs: Map<string, RunRef[]>;
+    runs: Map<string, RunView>;
+}>;
+//# sourceMappingURL=runs.d.ts.map

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

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

package/dist/workspace/source-block.d.ts

@@ -35,8 +35,8 @@ export type SourceVia = (typeof SOURCE_VIAS)[number];
 export declare const sourceBlockSchema: z.ZodObject<{
     via: z.ZodOptional<z.ZodEnum<{
         cli: "cli";
-        mcp: "mcp";
         harvest: "harvest";
+        mcp: "mcp";
     }>>;
     client: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;

package/dist/workspace/source-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-block.d.ts","sourceRoot":"","sources":["../../src/workspace/source-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kDAAkD;AAClD,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAKrD,+GAA+G;AAC/G,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGpH;AAED,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAcpH;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBvH"}
+{"version":3,"file":"source-block.d.ts","sourceRoot":"","sources":["../../src/workspace/source-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kDAAkD;AAClD,eAAO,MAAM,WAAW,YAAI,KAAK,EAAE,KAAK,EAAE,SAAS,CAAU,CAAC;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAKrD,+GAA+G;AAC/G,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGpH;AAED,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAcpH;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBvH"}