@nanonets/graft 0.24.0 → 0.24.1

package/dist/trace/run-sheets.js

@@ -0,0 +1,145 @@
+/**
+ * Run sheets (`~/.trail/runs/<run-id>.json`, design 2.4): what one finished
+ * run did, as compile copies it. Written for every closed run with at least
+ * one step call, checked or not, so "save this" can name a run that is no
+ * longer the newest. `runs/index.json` lists them, newest last, so the
+ * previous run of the same job is found by reading one sheet, never by
+ * scanning the folder. Sheets are deleted 7 days after they were last
+ * written.
+ *
+ * A sheet holds commands that ran (secret-checked at fold time), counts and
+ * labels; never what the person typed. Re-exported from `runs.ts`, where the
+ * design names these functions.
+ */
+import { readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+const RUN_ID = /^r-\d{4}-[0-9a-f]{4,8}$/;
+const MAX_ROWS = 500;
+const KEEP_MS = 7 * 24 * 3600 * 1000;
+function runsDir(env) {
+    return trailPath(env, 'runs');
+}
+function indexPath(env) {
+    return join(runsDir(env), 'index.json');
+}
+/** Throws on an id that isn't a run id: it comes from the agent's command line. */
+export function runSheetPath(id, env) {
+    if (!RUN_ID.test(String(id)))
+        throw new Error(`trail: not a run id: ${String(id).slice(0, 40)}`);
+    return join(runsDir(env), `${id}.json`);
+}
+function readIndex(env) {
+    const raw = readJsonSafe(indexPath(env));
+    const rows = raw && Array.isArray(raw.rows) ? raw.rows.filter((r) => r && typeof r.id === 'string' && RUN_ID.test(r.id)) : [];
+    return { v: 1, rows };
+}
+function writeIndex(index, env) {
+    writePrivate(indexPath(env), JSON.stringify({ v: 1, rows: index.rows.slice(-MAX_ROWS) }));
+}
+/** Locked read-modify-write of the index; a timed-out lock leaves it as it was (the sheet is still on disk). */
+function updateIndex(env, change) {
+    withLock(indexPath(env), () => {
+        const index = readIndex(env);
+        writeIndex({ v: 1, rows: change(index.rows) }, env);
+    });
+}
+/** Writes runs/<id>.json and its row in runs/index.json (locked). Sets run.sheet and run.checkIndex. */
+export function writeRunSheet(run, v, meta, env) {
+    const path = runSheetPath(run.id, env);
+    const checked = v.checked && v.checkIndex !== null;
+    const sheet = {
+        v: 1,
+        id: run.id,
+        session: meta.sessionHash,
+        repoKey: run.repoKey,
+        ...(run.checkout ? { checkout: run.checkout } : {}),
+        branch: run.branch,
+        host: meta.host,
+        tier: meta.tier,
+        epoch: run.epoch,
+        startedAt: run.startedAt,
+        endedAt: run.lastAt,
+        job: run.job,
+        jobWords: [...run.jobWords],
+        sharedWords: [...run.sharedWords],
+        promptParams: { ...run.promptParams },
+        // A call in another repo than the run's keeps no folder: compile refuses it as outside the repo.
+        calls: run.calls.map((c) => (c.key === run.repoKey ? { ...c } : { ...c, cwd: null })),
+        checkIndex: checked ? v.checkIndex : null,
+        checked,
+        end: v.end,
+        counts: { commands: run.commands, failed: run.failedCount, toolCalls: run.toolCalls, edits: run.edits },
+        helpers: [...meta.helpers],
+        skillId: run.skillId ?? null,
+        ...(run.carriedFrom ? { carriedFrom: run.carriedFrom } : {}),
+    };
+    writePrivate(path, JSON.stringify(sheet));
+    const row = { id: run.id, session: meta.sessionHash, repoKey: run.repoKey, job: run.job, checked, startedAt: run.startedAt };
+    updateIndex(env, (rows) => [...rows.filter((r) => r.id !== run.id), row]);
+    run.sheet = checked ? 'checked' : 'draft';
+    run.checkIndex = sheet.checkIndex;
+    return sheet;
+}
+function validSheet(v, id) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return false;
+    const s = v;
+    return s.v === 1 && s.id === id && typeof s.repoKey === 'string' && Array.isArray(s.calls) && typeof s.startedAt === 'string';
+}
+export function readRunSheet(id, env) {
+    if (!RUN_ID.test(String(id)))
+        return null;
+    const v = readJsonSafe(runSheetPath(id, env));
+    return validSheet(v, id) ? v : null;
+}
+/** Deletes run sheets older than 7 days (mtime) and their index rows. */
+export function pruneRunSheets(now = new Date(), env) {
+    let names;
+    try {
+        names = readdirSync(runsDir(env));
+    }
+    catch {
+        return 0;
+    }
+    let gone = 0;
+    const cutoff = now.getTime() - KEEP_MS;
+    for (const name of names) {
+        const id = name.replace(/\.json$/, '');
+        if (name === id || !RUN_ID.test(id))
+            continue;
+        const path = join(runsDir(env), name);
+        try {
+            if (statSync(path).mtimeMs >= cutoff)
+                continue;
+            rmSync(path, { force: true });
+            gone++;
+        }
+        catch { /* gone already */ }
+    }
+    updateIndex(env, (rows) => rows.filter((r) => {
+        try {
+            return statSync(runSheetPath(r.id, env)).isFile();
+        }
+        catch {
+            return false;
+        }
+    }));
+    return gone;
+}
+/** 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 function findPriorSheet(sheet, env) {
+    if (sheet.job === null)
+        return null;
+    const rows = readIndex(env).rows;
+    for (let i = rows.length - 1; i >= 0; i--) {
+        const r = rows[i];
+        if (r.id === sheet.id || !r.checked || r.repoKey !== sheet.repoKey || r.job !== sheet.job || !(Date.parse(r.startedAt) < Date.parse(sheet.startedAt)))
+            continue;
+        const prior = readRunSheet(r.id, env);
+        return prior && prior.checked ? prior : null;
+    }
+    return null;
+}
+//# sourceMappingURL=run-sheets.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { type RepairOpts } from './repairs.js';
+import type { JobMatch, RunState, SkillSessionState } from './types.js';
+/**
+ * Closes every open run at a compaction (4.1) and notes the one it cut mid-job (D59a): the next run the agent
+ * starts with no typed ask continues that job. The fold calls it at a compaction line; SessionStart(compact)
+ * calls it when it bumps the epoch before the fold meets that line. Returns the runs it closed.
+ */
+export declare function cutAtCompaction(st: SkillSessionState, fix?: RepairOpts): RunState[];
+/**
+ * D116 item 3: the run checked out and the reply then asked about more work ("Published. Want me to deploy the docs
+ * too?"): a yes to that is the next job, not this one. A go-ahead after a plain reply ("ok") only acknowledges it.
+ */
+export declare function movedOn(run: RunState, replyEnd: SkillSessionState['replyEnd']): boolean;
+/**
+ * D120 (1): the job a typed line over the matching cap names, when it is `open`'s own and `open` has not checked
+ * out; null otherwise (a short line is matchJob's, another job or a checked run starts a new run as before).
+ */
+export declare function continuesOpenJob(text: string, open: RunState | null): JobMatch | null;
+/**
+ * D137: an open run whose block handed a gated step to the person (denied here and printed for their own terminal)
+ * waits 2 hours, past the 30-minute gap, for their next ask of the same job, which continues it.
+ */
+export declare function handedWait(run: RunState, at: string): boolean;
+//# sourceMappingURL=run-turns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-turns.d.ts","sourceRoot":"","sources":["../../src/trace/run-turns.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQxE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,GAAE,UAAe,GAAG,QAAQ,EAAE,CAYvF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,OAAO,CAGvF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAKrF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7D"}

package/dist/trace/run-turns.js

@@ -0,0 +1,67 @@
+/**
+ * Where one run ends and the next begins, beside the fold (runs.ts): the cut
+ * a compaction makes (D59a), whether a run already moved on (D116 item 3),
+ * and D120 (1): a typed line naming the same job as the open, not-yet-checked
+ * run continues it at any length (the 25-word cap is for matching skills).
+ */
+import { matchJob } from './jobs.js';
+import { noteRepairs } from './repairs.js';
+import { checkedSuccess } from './run-verdict.js';
+/** D59a: a run the compaction cut carries its job on when it had one and had not checked out (as its sheet will say). */
+function carries(run) {
+    if (run.job === null || run.sheet === 'checked')
+        return false;
+    return !(run.calls.length > 0 && checkedSuccess(run, null).checked);
+}
+/**
+ * Closes every open run at a compaction (4.1) and notes the one it cut mid-job (D59a): the next run the agent
+ * starts with no typed ask continues that job. The fold calls it at a compaction line; SessionStart(compact)
+ * calls it when it bumps the epoch before the fold meets that line. Returns the runs it closed.
+ */
+export function cutAtCompaction(st, fix = {}) {
+    const closed = [];
+    for (const r of st.runs) {
+        if (r.closed)
+            continue;
+        r.closed = true;
+        noteRepairs(r, fix); // b2: while the run still has its calls (4.12)
+        closed.push(r);
+    }
+    const cut = closed[closed.length - 1];
+    if (cut && carries(cut))
+        st.cut = cut.id;
+    else if (cut)
+        delete st.cut;
+    return closed;
+}
+/**
+ * D116 item 3: the run checked out and the reply then asked about more work ("Published. Want me to deploy the docs
+ * too?"): a yes to that is the next job, not this one. A go-ahead after a plain reply ("ok") only acknowledges it.
+ */
+export function movedOn(run, replyEnd) {
+    if (!run.calls.length || replyEnd !== 'question')
+        return false;
+    return checkedSuccess({ ...run, end: 'done' }, null).checked;
+}
+/**
+ * D120 (1): the job a typed line over the matching cap names, when it is `open`'s own and `open` has not checked
+ * out; null otherwise (a short line is matchJob's, another job or a checked run starts a new run as before).
+ */
+export function continuesOpenJob(text, open) {
+    if (!open || open.closed || open.job === null)
+        return null;
+    const m = matchJob(text, { anyLength: true });
+    if (!m || m.job !== open.job)
+        return null;
+    return open.calls.length && checkedSuccess({ ...open, end: 'done' }, null).checked ? null : m;
+}
+/**
+ * D137: an open run whose block handed a gated step to the person (denied here and printed for their own terminal)
+ * waits 2 hours, past the 30-minute gap, for their next ask of the same job, which continues it.
+ */
+export function handedWait(run, at) {
+    const d = Date.parse(at) - Date.parse(run.handedAt ?? '');
+    return d >= 0 && d <= HANDED_WAIT_MS;
+}
+const HANDED_WAIT_MS = 2 * 60 * 60 * 1000;
+//# sourceMappingURL=run-turns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-turns.js","sourceRoot":"","sources":["../../src/trace/run-turns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAmB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,yHAAyH;AACzH,SAAS,OAAO,CAAC,GAAa;IAC5B,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,MAAkB,EAAE;IACzE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM;YAAE,SAAS;QACvB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;QAChB,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,+CAA+C;QACpE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;SACpC,IAAI,GAAG;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAa,EAAE,QAAuC;IAC5E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,cAAc,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAqB;IAClE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAa,EAAE,EAAU;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC;AACvC,CAAC;AACD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { CheckedVerdict } from './runs.js';
+import type { RunCall, RunSheet, RunState, SkillSessionState } from './types.js';
+/**
+ * D64: the branches a ship ask named: its beta, prod (prod or production) and staging words, and a branch
+ * name typed in it (`promptParams.branch`, "push branch wa-cutover to beta"). Empty when it named none.
+ */
+export declare function shipBranches(run: Pick<RunState, 'jobWords' | 'promptParams'>): string[];
+/**
+ * The run's essential steps (D58a/b), which conditions 3 to 5 and leg A read: step calls in the checkout of
+ * the run's own repo. A step in another repo or a scratch folder is left out of the skill, so it neither
+ * covers, breaks nor ends the job. A run with no step in its repo (a session outside git) keeps every step.
+ */
+export declare function essentialSteps(calls: RunCall[], repoKey: string): RunCall[];
+/** 4.2. lastAssistant null: judge the end from run.end as the last Stop computed it. */
+export declare function checkedSuccess(run: RunState, lastAssistant: string | null): CheckedVerdict;
+/** 4.7. */
+export declare function lastGoodRun(st: SkillSessionState, env?: NodeJS.ProcessEnv): {
+    run: RunState;
+    sheet: RunSheet;
+} | {
+    none: 'nothing' | 'failed' | 'skill' | 'unproven';
+    skillName?: string;
+};
+//# sourceMappingURL=run-verdict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-verdict.d.ts","sourceRoot":"","sources":["../../src/trace/run-verdict.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAyB,OAAO,EAAU,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAoBhH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAAC,GAAG,MAAM,EAAE,CAKvF;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAI3E;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAoC1F;AAmBD,WAAW;AACX,wBAAgB,WAAW,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CA4B1L"}

package/dist/trace/run-verdict.js

@@ -0,0 +1,176 @@
+/**
+ * Whether a run worked (design 4.2) and which run "save this" means (4.7).
+ * Re-exported from `runs.ts`, where the design names these functions.
+ *
+ * A run is a checked success when a check that fits its job passed, no step
+ * came after it, nothing broke after it, and the turn ended done. A push that
+ * moved the remote ref is a ship check (D56a), and a deploy seen still
+ * building after it undoes it.
+ */
+import { callText, endsInFailure, endsInQuestion, fallbackOnly } from './checks.js';
+import { OFFER_FAMILIES } from './jobs.js';
+import { runHelpers } from './run-calls.js';
+import { joinCarriedSheet } from './run-join.js';
+import { readRunSheet, writeRunSheet } from './run-sheets.js';
+/** A real check passed: one not behind a fallback (D101). */
+const realPass = (c) => c.check?.passed === true && !fallbackOnly(callText(c));
+const SHIP_PROOF = new Set(['push', 'deploy', 'ls-remote']);
+/**
+ * The families whose later unpassed check undoes check `k` (D56a): a push, a deploy or ls-remote is undone by
+ * a deploy or ls-remote after it that did not pass (still building, queued, not at the pushed commit).
+ * Tests and queries are steps, so condition 3 already covers them; npm-view is left as 4.2 has it.
+ */
+function proofFamilies(k, fits) {
+    if (!SHIP_PROOF.has(k))
+        return new Set();
+    return fits === null ? SHIP_PROOF : new Set(fits.filter((f) => SHIP_PROOF.has(f)));
+}
+/** The ship vocabulary's branch words (jobs.ts: production is canonical prod). */
+const SHIP_BRANCH_WORDS = { beta: ['beta'], prod: ['prod', 'production'], staging: ['staging'] };
+/**
+ * D64: the branches a ship ask named: its beta, prod (prod or production) and staging words, and a branch
+ * name typed in it (`promptParams.branch`, "push branch wa-cutover to beta"). Empty when it named none.
+ */
+export function shipBranches(run) {
+    const out = run.jobWords.flatMap((w) => SHIP_BRANCH_WORDS[w] ?? []);
+    const typed = run.promptParams.branch;
+    if (typed && !out.includes(typed))
+        out.push(typed);
+    return out;
+}
+/**
+ * Whether a passing check proves the run's job (4.2 condition 2). D64: for ship, a push proves it only when
+ * it moved a branch the ask named; a push of any other branch (a side branch after the prod push was
+ * refused) is no ship check.
+ */
+function fitsJob(run, ch, fits) {
+    if (fits === null)
+        return true;
+    if (!fits.includes(ch.family))
+        return false;
+    if (run.job !== 'ship' || ch.family !== 'push')
+        return true;
+    const branch = ch.facts.branch;
+    return branch !== undefined && shipBranches(run).includes(branch);
+}
+/**
+ * The run's essential steps (D58a/b), which conditions 3 to 5 and leg A read: step calls in the checkout of
+ * the run's own repo. A step in another repo or a scratch folder is left out of the skill, so it neither
+ * covers, breaks nor ends the job. A run with no step in its repo (a session outside git) keeps every step.
+ */
+export function essentialSteps(calls, repoKey) {
+    const steps = calls.filter((c) => c.kind === 'step');
+    const inRepo = steps.filter((c) => c.key === repoKey && c.cwd !== null);
+    return inRepo.length ? inRepo : steps;
+}
+/** 4.2. lastAssistant null: judge the end from run.end as the last Stop computed it. */
+export function checkedSuccess(run, lastAssistant) {
+    const calls = run.calls;
+    const essential = essentialSteps(calls, run.repoKey);
+    let end;
+    if (essential[essential.length - 1]?.failed)
+        end = 'failure';
+    else if (lastAssistant === null)
+        end = run.end;
+    else if (endsInFailure(lastAssistant))
+        end = 'failure';
+    else if (endsInQuestion(lastAssistant))
+        end = 'question';
+    else
+        end = 'done';
+    if (run.job === 'pr-green' || run.job === 'sweep')
+        return { checked: false, checkIndex: null, end, why: 'judgement' };
+    if (run.job === 'run-local')
+        return { checked: false, checkIndex: null, end, why: 'no-check-for-job' };
+    const fits = run.job === null ? null : OFFER_FAMILIES[run.job] ?? [];
+    let k = -1;
+    for (let i = calls.length - 1; i >= 0; i--) {
+        const ch = calls[i].check;
+        // D101: a pass that may come only from an `|| echo` / `|| true` fallback (stored by an older fold) is no check.
+        if (ch?.passed && fitsJob(run, ch, fits) && !fallbackOnly(callText(calls[i]))) {
+            k = i;
+            break;
+        }
+    }
+    if (k < 0) {
+        const passed = calls.some(realPass);
+        return { checked: false, checkIndex: null, end, why: passed ? 'check-misfit' : 'no-check' };
+    }
+    // D116 item 3: after a go-ahead to a turn that ended in failure, only a check from then on checks the run out.
+    if (run.failedTurn !== undefined && k < run.failedTurn)
+        return { checked: false, checkIndex: null, end, why: 'failed-turn' };
+    const kept = new Set(essential);
+    const after = calls.slice(k + 1).filter((c) => kept.has(c));
+    if (after.some((c) => c.failed))
+        return { checked: false, checkIndex: null, end, why: 'failed-after-check' };
+    if (after.length)
+        return { checked: false, checkIndex: null, end, why: 'step-after-check' };
+    // D56a: a later check of the same proof that did not pass (a deploy still building after the push) undoes it.
+    const proof = proofFamilies(calls[k].check.family, fits);
+    if (calls.slice(k + 1).some((c) => c.check && !c.check.passed && proof.has(c.check.family))) {
+        return { checked: false, checkIndex: null, end, why: 'unpassed-after-check' };
+    }
+    if (end !== 'done')
+        return { checked: false, checkIndex: k, end, why: `end-${end}` };
+    return { checked: true, checkIndex: k, end };
+}
+const ECHO_FALLBACK = /\|\|\s*[({]?\s*(?:echo|printf)(?![\w.-])/;
+/**
+ * D101 item 5: the run's success may come only from fallbacks. Its last essential step ends in an `|| echo` /
+ * `|| printf` (that echo is usually the failure's own message: "docker not running"), or every essential step ends
+ * in a fallback, and no real check passed. A cleanup's `|| true` after real work is fine.
+ */
+function unproven(calls, repoKey) {
+    if (calls.some(realPass))
+        return false;
+    const steps = essentialSteps(calls, repoKey);
+    const last = steps[steps.length - 1];
+    if (!last)
+        return false;
+    const text = callText(last);
+    if (fallbackOnly(text) && ECHO_FALLBACK.test(text))
+        return true;
+    return steps.every((c) => fallbackOnly(callText(c)));
+}
+/** 4.7. */
+export function lastGoodRun(st, env) {
+    let run;
+    for (let i = st.runs.length - 1; i >= 0; i--) {
+        const r = st.runs[i];
+        if (r.epoch === st.epoch && r.stepCalls > 0) {
+            run = r;
+            break;
+        }
+    }
+    if (!run)
+        return { none: 'nothing' };
+    if (run.skillId) {
+        const name = [...st.injected].reverse().find((i) => i.skillId === run.skillId)?.name;
+        return name ? { none: 'skill', skillName: name } : { none: 'skill' };
+    }
+    const meta = { host: st.host, tier: st.tier, sessionHash: st.sessionHash };
+    let sheet = null;
+    if (run.calls.length) {
+        const steps = essentialSteps(run.calls, run.repoKey);
+        if (steps[steps.length - 1]?.failed || run.end === 'failure')
+            return { none: 'failed' };
+        if (unproven(run.calls, run.repoKey))
+            return { none: 'unproven' };
+        sheet = run.sheet !== 'none' && run.closed ? readRunSheet(run.id, env) : null;
+        if (!sheet)
+            sheet = writeRunSheet(run, checkedSuccess(run, null), { ...meta, helpers: runHelpers(run) }, env);
+    }
+    else {
+        sheet = readRunSheet(run.id, env);
+        if (!sheet)
+            return { none: 'nothing' };
+        const steps = essentialSteps(sheet.calls, sheet.repoKey);
+        if (steps[steps.length - 1]?.failed || sheet.end === 'failure' || run.end === 'failure')
+            return { none: 'failed' };
+        if (unproven(sheet.calls, sheet.repoKey))
+            return { none: 'unproven' };
+    }
+    // A run a compaction cut (D59a): the draft and the save copy the whole job, its earlier parts first.
+    return { run, sheet: joinCarriedSheet(sheet, (id) => readRunSheet(id, env)) };
+}
+//# sourceMappingURL=run-verdict.js.map

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

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

package/dist/trace/runs.d.ts

@@ -0,0 +1,54 @@
+import type { TraceEvent } from './claude.js';
+import type { PostMark } from './gate-file.js';
+import type { RunEnd, RunState, SkillSessionState, TypedAnswer } from './types.js';
+export { findPriorSheet, pruneRunSheets, readRunSheet, runSheetPath, writeRunSheet } from './run-sheets.js';
+export { MAX_CARRY_HOPS, joinCarriedSheet } from './run-join.js';
+export { runHelpers } from './run-calls.js';
+export { cutAtCompaction } from './run-turns.js';
+export { checkedSuccess, lastGoodRun } from './run-verdict.js';
+export interface FoldContext {
+    sessionHash: string;
+    checkout: string;
+    /** Cached repoPlace(path).key for a folder inside git; null outside git. */
+    repoKeyOf(path: string): string | null;
+    /** Cached repoPlace(path).checkout for a folder inside git (the root `cwd` is relative to); null outside git. Defaults to `checkout` for its key. */
+    rootOf?(path: string): string | null;
+    /** The session's repo key (GateCtx.repoKey): a run with no step calls in git is put down to it. */
+    repoKey?: string;
+    trailHome: string;
+    transcriptPath: string;
+    /** From takePostMarks: outcomes for calls whose result the transcript doesn't have yet (3.4). */
+    marks: PostMark[];
+    now: Date;
+}
+export interface FoldResult {
+    closed: RunState[];
+    lastAssistant: string;
+    compactions: number;
+    /** Every typed event folded, as hashes and labels only (never stored). The gate reads these. */
+    typed: Array<{
+        offset: number;
+        at: string;
+        sha: string;
+        answer: TypedAnswer;
+        save: boolean;
+    }>;
+}
+export interface CheckedVerdict {
+    checked: boolean;
+    checkIndex: number | null;
+    end: RunEnd;
+    why?: string;
+}
+/** 'r-' + MMDD + '-' + 4 hex. */
+export declare function newRunId(now?: Date): string;
+/**
+ * A run id no one holds: 4 hex a day is 65,536 ids shared by every session, so a new one is drawn until
+ * `taken` (a run in this session, or a sheet on disk from any session) says it is free; after 64 tries, any.
+ */
+export declare function freshRunId(now: Date, taken: (id: string) => boolean): string;
+/** toolCalls >= 5 or failedCount >= 1. */
+export declare function costly(run: RunState): boolean;
+/** Folds new events into the session's runs (4.1). Mutates st. */
+export declare function foldEvents(st: SkillSessionState, events: TraceEvent[], ctx: FoldContext): FoldResult;
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/trace/runs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,KAAK,EAAmC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGpH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,qJAAqJ;IACrJ,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,GAAG,EAAE,IAAI,CAAC;CACX;AACD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC/F;AACD,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAW1G,iCAAiC;AACjC,wBAAgB,QAAQ,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAGvD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAI5E;AAOD,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAE7C;AAiBD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,WAAW,GAAG,UAAU,CA0WpG"}