@nanonets/graft 0.24.0 → 0.25.0

package/dist/trace/run-calls.js

@@ -0,0 +1,331 @@
+/**
+ * One Bash call as the fold keeps it (design 4.1): the command with secrets
+ * named or refused (4.10), the folder it really ran in, what kind of call it
+ * is. The tamper check is in `tamper.ts`.
+ *
+ * The folder is the transcript entry's `cwd`, which follows a `cd` from an
+ * earlier call (the agent's shell keeps its folder between calls), then the
+ * command's own leading `cd`s. A call whose folder can't be known (`cd "$X"`,
+ * `cd -`) has none, so compile refuses it rather than guess.
+ *
+ * Interpreter heredocs (D51): `python3 - <<'EOF' ... EOF` that writes files is
+ * `work`, left out of skills like a file edit; one that only reads or prints
+ * is `look`; one that runs programs or the network stays a `step`.
+ *
+ * A result where the host refused to run the command (the person said no, a
+ * classifier or hook blocked it, D51) counts as never run.
+ */
+import { homedir, tmpdir } from 'node:os';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+import { flatLine } from '../notes/flatten.js';
+import { secretReason } from '../notes/secrets.js';
+import { callKind } from './checks.js';
+import { redactSecrets } from './redact.js';
+import { ignoredFailure } from './repairs.js';
+import { loginFeed } from '../skills/answers-prompt.js';
+import { ASSIGN, base, scan, words } from './shell-scan.js';
+import { bareCommand, heredocInterpreter, isMultiLine, leadingCds, normalizeCommand, scriptKind, simpleCommands, splitTop } from './shell.js';
+import { programWords } from './shell-words.js';
+import { matchWall } from './walls.js';
+export const EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+/** Longer raw commands are never compiled or kept (redactSecrets refuses them, 4.10). */
+export const MAX_RAW = 2000;
+const TAIL_CHARS = 200;
+/* ------------------------------------------------------------------ folder */
+/** A `cd` argument as a path relative to `folder`, or null when only the shell could know it. */
+function cdTarget(arg, folder, home) {
+    let a = arg;
+    if (a === '~' || a === '')
+        return home;
+    if (a.startsWith('~/'))
+        a = home + a.slice(1);
+    a = a.replace(/^\$\{?HOME\}?(?=\/|$)/, home);
+    if (a === '-' || /[$`*?]/.test(a))
+        return null;
+    return resolve(folder, a);
+}
+/**
+ * The entry's folder, then each leading `cd` in order; null when unknown. `cd -` goes back to the folder
+ * before the last `cd` of this call; with none before it, that folder was the shell's, so it is unknown.
+ */
+export function effectiveFolder(entryCwd, raw, home = homedir()) {
+    if (!entryCwd)
+        return null;
+    let folder = entryCwd;
+    let prev = null;
+    for (const arg of leadingCds(raw).cds) {
+        const next = arg === '-' ? prev : cdTarget(arg, folder, home);
+        if (next === null)
+            return null;
+        prev = folder;
+        folder = next;
+    }
+    return folder;
+}
+/** `key` and `cwd` (relative to the checkout root, '' at the root) of a folder; nulls outside git. */
+export function placeFields(folder, placeOf) {
+    if (!folder)
+        return { key: null, cwd: null };
+    const p = placeOf(folder);
+    if (!p.key || !p.root)
+        return { key: null, cwd: null };
+    const rel = relative(p.root, folder);
+    if (rel.startsWith('..') || isAbsolute(rel))
+        return { key: p.key, cwd: null };
+    return { key: p.key, cwd: rel.split(sep).join('/') };
+}
+/* ------------------------------------------------------------------- kinds */
+export const INTERPRETERS = /^(?:python[\d.]*|node|ruby|perl|deno|bun|php)$/;
+/**
+ * The kind of an interpreter's heredoc program (D51, D58 e): work when it writes files, starts programs or
+ * sends to the network, a look when it only reads or prints; never a step. One reader for the fold and compile:
+ * shell.ts `scriptKind`.
+ */
+export function interpreterKind(body) {
+    return scriptKind(body) === 'look' ? 'look' : 'work';
+}
+/** An interpreter fed its program by a heredoc (`python3 - <<'EOF'`, `node <<EOF`), not data for a script: shell.ts reads it. */
+function heredocProgram(head) {
+    return heredocInterpreter(programWords(head)) !== null;
+}
+/** 4.1 kinds, with interpreter heredocs judged by their program (D51). */
+export function foldKind(raw, job) {
+    const kind = callKind(raw, job);
+    if (kind !== 'step' || !raw.includes('<<'))
+        return kind;
+    const { segs } = scan(raw);
+    if (!segs.some((p) => p.bodies.length && !p.group && heredocProgram(raw.slice(p.start, p.end))))
+        return kind;
+    const kinds = segs.map((p) => {
+        const head = raw.slice(p.start, p.end);
+        if (p.bodies.length && !p.group && heredocProgram(head))
+            return interpreterKind(p.bodies.map(([a, b]) => raw.slice(a, b)).join('\n'));
+        return callKind(head, job);
+    });
+    if (kinds.every((k) => k === 'plumbing'))
+        return 'plumbing';
+    if (kinds.includes('step'))
+        return 'step';
+    return kinds.includes('work') ? 'work' : 'look';
+}
+/* --------------------------------------------------------------- refusals */
+const REFUSED = [
+    /^The user doesn't want to proceed with this tool use/,
+    /^Permission (?:for this (?:action|command)|to use \S+(?: with command [\s\S]*?)?) (?:was|has been) denied/,
+    /^\S+ is temporarily unavailable\b[\s\S]{0,60}\bso auto mode cannot\b/,
+    /^<tool_use_error>(?:Blocked:|Error: No such tool available)/,
+    /^\w+:\w+ hook (?:error|returned blocking error)/,
+    /^This session is isolated in the worktree\b[\s\S]*\bRefusing to run it/,
+    /^\S+ in '[^']*' was blocked\b/,
+    /^Claude requested permissions to use\b/,
+];
+/** The host refused to run the call (D51): the person said no, a classifier, a safety check or a hook blocked it. */
+export function hostRefused(text) {
+    const t = String(text ?? '').trimStart();
+    return REFUSED.some((re) => re.test(t));
+}
+/**
+ * Claude Code's own result for a command that went to the background (fix-lab5): one run past its Bash timeout
+ * ("Command did not complete within its 300s timeout and was moved to the background (ID: …)"), or a
+ * `run_in_background` start ("Command running in background with ID: …"). It says the command started, never that it
+ * worked, so no check passes on it. Only a result that is that text (from its start, or a mark's one-line tail of
+ * it): a log quoting it is something else.
+ */
+const BACKGROUNDED = /^(?:Command did not complete within its \d+m?s timeout and was moved to the background\b|Command running in background with ID: )/;
+/** How the same text ends: a PostToolUse mark keeps only a result's last 200 characters. */
+const BACKGROUNDED_END = /\/tasks\/[\w-]{1,40}\.output\. You will be notified when it completes\.(?: To check interim output, use Read on that file path\.)?$/;
+export function wentToBackground(text) {
+    const t = String(text ?? '').trim();
+    return BACKGROUNDED.test(t) || (t.length <= 400 && BACKGROUNDED_END.test(t) && !/\n/.test(t));
+}
+/* -------------------------------------------------------------- the call */
+/**
+ * The last 200 characters of a result, each line cleaned (flatLine), line
+ * breaks kept: the run facts read pushes and publishes line by line
+ * (`+ pkg@1.2.3`, `abc..def  main -> beta`). Undefined when it holds a secret.
+ */
+export function cleanTail(text) {
+    const t = String(text ?? '').slice(-TAIL_CHARS);
+    if (secretReason(t) !== null)
+        return undefined;
+    const out = t.split(/\r?\n/).map((l) => flatLine(l, TAIL_CHARS)).filter(Boolean).join('\n');
+    return out && secretReason(out) === null ? out : undefined;
+}
+/** At most this many pieces of a long call are kept; the rest is one work marker. */
+const MAX_PARTS = 200;
+/**
+ * A call over 2,000 characters, piece by piece (D58c): each top-level piece redacted on its own, a piece
+ * over 2,000 characters (a heredoc body, an inline edit) a work marker that keeps nothing of it.
+ */
+export function callParts(segs, job) {
+    const out = [];
+    for (const [i, seg] of segs.entries()) {
+        if (i === MAX_PARTS - 1 && segs.length > MAX_PARTS) {
+            out.push({ cmd: null, sep: '', kind: 'work', long: true });
+            break;
+        }
+        const text = seg.text.trim();
+        if (text.length > MAX_RAW) {
+            out.push({ cmd: null, sep: seg.sep, kind: 'work', long: true });
+            continue;
+        }
+        const red = redactSecrets(text);
+        const part = { cmd: red.cmd, sep: seg.sep, kind: foldKind(text, job) };
+        if (red.secret)
+            part.secret = red.secret;
+        out.push(part);
+    }
+    return out;
+}
+/** A RunCall from a Bash tool_call (4.1), before its result. */
+export function makeCall(ev, raw, job, placeOf, fallbackCwd, home = homedir()) {
+    const input = ev.input && typeof ev.input === 'object' ? ev.input : {};
+    const segs = splitTop(raw);
+    const truncated = raw.length > MAX_RAW;
+    const parts = truncated ? callParts(segs, job) : null;
+    // D116 item 5: a call that only feeds keystrokes into a login keeps the login alone, never what was fed.
+    const feed = parts ? null : loginFeed(raw);
+    const red = feed ? { cmd: feed.login, secret: undefined } : parts ? { cmd: null, secret: worstSecret(parts) } : redactSecrets(raw);
+    const call = {
+        id: ev.id,
+        at: ev.at,
+        cmd: red.cmd, // null when it holds a secret, or is long and kept as `parts` (D58c)
+        ...placeFields(effectiveFolder(ev.cwd || fallbackCwd, raw, home), placeOf),
+        bg: input.run_in_background === true || segs[segs.length - 1]?.sep === '&',
+        failed: false,
+        isError: false,
+        kind: foldKind(raw, job),
+        src: { use: ev.offset ?? -1, result: null },
+    };
+    if (red.secret)
+        call.secret = red.secret;
+    if (feed)
+        call.loginFeed = feed.service;
+    if (truncated)
+        call.truncated = true;
+    if (isMultiLine(raw))
+        call.multiLine = true;
+    if (parts)
+        call.parts = parts;
+    return call;
+}
+/**
+ * A call's wall class (b2, R8), set from its result where the fold still holds the text: `makeCall` runs before
+ * the result exists, so the fold calls this once `failed` and `errorLine` are known. matchWall's own rules hold
+ * (the program a class needs, exit-0 only for three classes, never a look-only call); a failure that never
+ * counts (`ignoredFailure`: a deny, a CI log read, a query, a look) or a result the host refused gets none.
+ */
+export function setWall(call, raw, text) {
+    delete call.wall;
+    if (hostRefused(text) || ignoredFailure(call, null))
+        return;
+    const wall = matchWall(text, raw, call.failed);
+    if (wall)
+        call.wall = wall;
+}
+/** A deployment status tool call over MCP (D59b): a look with no folder, its check filled from its result. */
+export function makeToolCall(ev, name) {
+    return {
+        id: ev.id, at: ev.at, cmd: null, tool: name, key: null, cwd: null, bg: false, failed: false, isError: false, kind: 'look',
+        src: { use: ev.offset ?? -1, result: null },
+    };
+}
+const GREPS = /^(?:grep|egrep|fgrep|zgrep|rg|ag|ack)$/;
+/**
+ * D59d: a grep that found nothing. grep and rg exit 1 when nothing matched; with nothing printed (the host
+ * writes only `Exit code 1`, a mark's tail is empty) that is an answer, not a failure, also when it stopped a
+ * chain of reads (`grep -n A f && echo --- && grep -n B f`). Exit 2, any message, or a call with no grep in it
+ * keeps the call failed. The fold asks this for look and plumbing calls only.
+ */
+export function grepNoMatch(raw, text) {
+    if (String(text ?? '').trim().replace(/^(?:Error: )?Exit code 1$/, '') !== '')
+        return false;
+    return simpleCommands(raw).some((simple) => {
+        const w = words(bareCommand(simple));
+        return GREPS.test(base(w[0] ?? '')) || (w[0] === 'git' && w[1] === 'grep');
+    });
+}
+function worstSecret(parts) {
+    if (parts.some((p) => p.secret === 'refused'))
+        return 'refused';
+    return parts.some((p) => p.secret === 'named') ? 'named' : undefined;
+}
+/** Calls whose result keeps a tail: checks, polls, `git rev-parse`, `git push`, publishes (4.1). */
+export function keepsTail(raw, isCheck, poll) {
+    if (isCheck || poll)
+        return true;
+    if (!/\b(?:rev-parse|push|publish)\b/.test(raw))
+        return false;
+    return simpleCommands(raw).some((s) => /^(?:git (?:rev-parse|push)|(?:npm|pnpm|yarn(?: npm)?) publish)\b/.test(normalizeCommand(s).replace(/^(?:\w+=\S+\s+)+/, '')));
+}
+/** Calls a poll looks back over: enough for a wait loop, bounded for a long run. */
+const POLL_LOOKBACK = 20;
+/**
+ * The same command (normalized) as an earlier call, with only look, plumbing or work calls between (a
+ * poll). `normOf` gives a call's normalized command (the fold caches it).
+ */
+export function isPoll(me, calls, normOf) {
+    for (let i = calls.length - 1; i >= Math.max(0, calls.length - POLL_LOOKBACK); i--) {
+        const c = calls[i];
+        if (normOf(c) === me)
+            return true;
+        if (c.kind === 'step')
+            return false;
+    }
+    return false;
+}
+/* ----------------------------------------------------------------- helpers */
+function scratchRoots() {
+    return [tmpdir(), process.env.TMPDIR ?? '', '/tmp', '/private/tmp', '/var/folders'].filter(Boolean).map((p) => resolve(p));
+}
+const POSIX_SCRATCH = ['/tmp', '/private/tmp', '/var/folders'];
+function inScratch(p) {
+    if (/\/scratchpad\//.test(p) || scratchRoots().some((r) => p === r || p.startsWith(r + sep)))
+        return true;
+    if (process.platform !== 'win32')
+        return false;
+    // Windows: a path may use either slash and any case, and Git Bash's /tmp is the person's temp folder.
+    const fwd = p.replace(/\\/g, '/').toLowerCase();
+    if (fwd.includes('/scratchpad/') || POSIX_SCRATCH.some((r) => fwd === r || fwd.startsWith(`${r}/`)))
+        return true;
+    const q = resolve(p).toLowerCase();
+    return scratchRoots().some((r) => q === r.toLowerCase() || q.startsWith(r.toLowerCase() + sep));
+}
+/** Absolute paths of helper scripts the run executed from scratch folders (4.5 step 7), from its ok step calls. */
+export function runHelpers(run) {
+    const out = [];
+    for (const c of run.calls) {
+        if (!c.cmd || c.failed || c.kind !== 'step')
+            continue;
+        for (const simple of simpleCommands(leadingCds(c.cmd).rest || c.cmd)) {
+            const w = words(simple).filter((x) => !ASSIGN.test(x)).map((x) => x.replace(/^(['"])(.*)\1$/, '$2'));
+            const runner = /^(?:ba|z|da)?sh$|^node$|^python3?$/.test(base(w[0] ?? ''));
+            const script = runner ? w.slice(1).find((a) => !a.startsWith('-')) : w[0];
+            if (script && isAbsolute(script) && inScratch(script) && !out.includes(script))
+                out.push(script);
+        }
+    }
+    return out;
+}
+/* ------------------------------------------------------------ shared words */
+const STOP = new Set(('a an the to and then please can could would you we i it its this that now also just so okay ok yes lets let\'s do some me my '
+    + 'our for of on in at first again too as well be is are will').split(' '));
+/** The ask's content words (4.6 stop words dropped), 3 characters or more. */
+export function contentWords(typed) {
+    const out = [];
+    for (const w of String(typed ?? '').toLowerCase().split(/[^a-z0-9]+/))
+        if (w.length >= 3 && !STOP.has(w) && !out.includes(w))
+            out.push(w);
+    return out;
+}
+/** Words both in the ask and in the command, added to `into` up to 6 (4.1 `sharedWords`). */
+export function addSharedWords(into, typed, raw) {
+    const cmdWords = new Set(String(raw).toLowerCase().split(/\W+/));
+    for (const w of contentWords(typed)) {
+        if (into.length >= 6)
+            return;
+        if (cmdWords.has(w) && !into.includes(w))
+            into.push(w);
+    }
+}
+//# sourceMappingURL=run-calls.js.map

package/dist/trace/run-calls.js.map

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

package/dist/trace/run-join.d.ts

@@ -0,0 +1,20 @@
+import type { RunCall, RunSheet } from './types.js';
+/** At most this many sheets back. Real jobs were cut 2 to 4 times. */
+export declare const MAX_CARRY_HOPS = 5;
+/** The key most of the calls' steps ran in; a tie or none keeps `fallback`. */
+export declare function majorityKey(run: {
+    calls: RunCall[];
+}, fallback: string): string;
+/**
+ * The whole job of a carried sheet: follow `carriedFrom` back at most `MAX_CARRY_HOPS` sheets, stop at a sheet
+ * that can't be read or a link that doesn't hold, and join the parts oldest first. Calls are concatenated, so
+ * `checkIndex` moves by the calls before the newest part. The verdict, the job and its words, the params and the
+ * skill come from the newest part (the carry copies them forward, follow-ups only add to them). `branch` is the
+ * first one any part saw, `startedAt` the oldest part's, `endedAt` the newest's; counts are summed, helpers and
+ * shared words joined; the repo key is the one most joined steps ran in (a tie keeps the newest part's).
+ * The result has no `carriedFrom` and lists the earlier parts (and their call counts) in `joined`, so joining it
+ * again changes nothing.
+ * A sheet with nothing to join is returned as it is.
+ */
+export declare function joinCarriedSheet(sheet: RunSheet, read?: (id: string) => RunSheet | null): RunSheet;
+//# sourceMappingURL=run-join.d.ts.map

package/dist/trace/run-join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-join.d.ts","sourceRoot":"","sources":["../../src/trace/run-join.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,sEAAsE;AACtE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU/E;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,QAAQ,GAAG,IAA+B,GAAG,QAAQ,CAmC5H"}

package/dist/trace/run-join.js

@@ -0,0 +1,99 @@
+/**
+ * A run a compaction cut carries its job into the next run (D59a), so the
+ * carried run's sheet holds only the calls after the compaction; the job's
+ * first part is on the sheet `carriedFrom` names, which may itself be
+ * carried. `joinCarriedSheet` puts the parts back together, oldest first,
+ * so compile and "save this" see the whole job. Re-exported from `runs.ts`.
+ *
+ * A part that can't be read (pruned after 7 days, or never written because
+ * it had no step call) means there is nothing more to copy: the walk keeps
+ * what it found, it never refuses.
+ */
+import { readRunSheet } from './run-sheets.js';
+/** At most this many sheets back. Real jobs were cut 2 to 4 times. */
+export const MAX_CARRY_HOPS = 5;
+/** The key most of the calls' steps ran in; a tie or none keeps `fallback`. */
+export function majorityKey(run, fallback) {
+    const count = new Map();
+    for (const c of run.calls)
+        if (c.kind === 'step' && c.key)
+            count.set(c.key, (count.get(c.key) ?? 0) + 1);
+    let best = fallback;
+    let top = 0;
+    let tie = false;
+    for (const [k, n] of count) {
+        if (n > top) {
+            best = k;
+            top = n;
+            tie = false;
+        }
+        else if (n === top)
+            tie = true;
+    }
+    return top === 0 || tie ? fallback : best;
+}
+const time = (iso) => Date.parse(iso);
+/**
+ * `prev` is the part before `next`: the same session and job, the epoch before (or the same one, when
+ * SessionStart closed the run before the fold met the compaction line), and it ended before `next` began.
+ */
+function links(prev, next) {
+    if (prev.session !== next.session || prev.job !== next.job)
+        return false;
+    if (prev.epoch !== next.epoch - 1 && prev.epoch !== next.epoch)
+        return false;
+    return time(prev.endedAt) <= time(next.startedAt);
+}
+const union = (lists) => [...new Set(lists.flat())];
+/**
+ * The whole job of a carried sheet: follow `carriedFrom` back at most `MAX_CARRY_HOPS` sheets, stop at a sheet
+ * that can't be read or a link that doesn't hold, and join the parts oldest first. Calls are concatenated, so
+ * `checkIndex` moves by the calls before the newest part. The verdict, the job and its words, the params and the
+ * skill come from the newest part (the carry copies them forward, follow-ups only add to them). `branch` is the
+ * first one any part saw, `startedAt` the oldest part's, `endedAt` the newest's; counts are summed, helpers and
+ * shared words joined; the repo key is the one most joined steps ran in (a tie keeps the newest part's).
+ * The result has no `carriedFrom` and lists the earlier parts (and their call counts) in `joined`, so joining it
+ * again changes nothing.
+ * A sheet with nothing to join is returned as it is.
+ */
+export function joinCarriedSheet(sheet, read = (id) => readRunSheet(id)) {
+    if (!sheet.carriedFrom || sheet.joined)
+        return sheet;
+    const parts = [sheet];
+    for (let hop = 0; hop < MAX_CARRY_HOPS; hop++) {
+        const next = parts[0];
+        if (!next.carriedFrom)
+            break;
+        let prev;
+        try {
+            prev = read(next.carriedFrom);
+        }
+        catch {
+            prev = null;
+        }
+        if (!prev || prev.id !== next.carriedFrom || parts.some((p) => p.id === prev.id) || !links(prev, next))
+            break;
+        parts.unshift(prev);
+    }
+    if (parts.length === 1)
+        return sheet;
+    const calls = parts.flatMap((p) => p.calls.map((c) => ({ ...c })));
+    const before = calls.length - sheet.calls.length;
+    const sum = (k) => parts.reduce((n, p) => n + (p.counts?.[k] ?? 0), 0);
+    const { carriedFrom: _carried, ...newest } = sheet;
+    return {
+        ...newest,
+        repoKey: majorityKey({ calls }, sheet.repoKey),
+        branch: parts.find((p) => p.branch)?.branch ?? null,
+        startedAt: parts[0].startedAt,
+        jobWords: [...sheet.jobWords],
+        sharedWords: union(parts.map((p) => p.sharedWords ?? [])),
+        promptParams: { ...sheet.promptParams },
+        calls,
+        checkIndex: sheet.checkIndex === null ? null : sheet.checkIndex + before,
+        counts: { commands: sum('commands'), failed: sum('failed'), toolCalls: sum('toolCalls'), edits: sum('edits') },
+        helpers: union(parts.map((p) => p.helpers ?? [])),
+        joined: parts.slice(0, -1).map((p) => ({ id: p.id, calls: p.calls.length })),
+    };
+}
+//# sourceMappingURL=run-join.js.map

package/dist/trace/run-join.js.map

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

package/dist/trace/run-sheets.d.ts

@@ -0,0 +1,26 @@
+import type { RunSheet, RunState } from './types.js';
+import type { CheckedVerdict } from './runs.js';
+export interface RunIndexRow {
+    id: string;
+    session: string;
+    repoKey: string;
+    job: RunSheet['job'];
+    checked: boolean;
+    startedAt: string;
+}
+/** Throws on an id that isn't a run id: it comes from the agent's command line. */
+export declare function runSheetPath(id: string, env?: NodeJS.ProcessEnv): string;
+/** Writes runs/<id>.json and its row in runs/index.json (locked). Sets run.sheet and run.checkIndex. */
+export declare function writeRunSheet(run: RunState, v: CheckedVerdict, meta: {
+    host: string;
+    tier: RunSheet['tier'];
+    sessionHash: string;
+    helpers: string[];
+}, env?: NodeJS.ProcessEnv): RunSheet;
+export declare function readRunSheet(id: string, env?: NodeJS.ProcessEnv): RunSheet | null;
+/** Deletes run sheets older than 7 days (mtime) and their index rows. */
+export declare function pruneRunSheets(now?: Date, env?: NodeJS.ProcessEnv): number;
+/** The newest other checked sheet with the same repoKey and job, started before this one, found through
+ *  runs/index.json (one sheet read, never a folder scan). The Stop offer, the gate and the CLI all call it. */
+export declare function findPriorSheet(sheet: RunSheet, env?: NodeJS.ProcessEnv): RunSheet | null;
+//# sourceMappingURL=run-sheets.d.ts.map

package/dist/trace/run-sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-sheets.d.ts","sourceRoot":"","sources":["../../src/trace/run-sheets.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAWxI,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAGxE;AAoBD,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAmCzL;AAQD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,GAAG,IAAI,CAIjF;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,GAAG,GAAE,IAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CA2BtF;AAED;+GAC+G;AAC/G,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,GAAG,IAAI,CAUxF"}