pitroom 0.24.1 → 0.26.0

package/dist/pitroom.mjs

@@ -775,7 +775,7 @@ function invocation(req) {
   return { command, args: [...prefix, ...args], env };
 }
 function classify(message) {
-  if (/RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|overloaded|\b503\b|capacity/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|overloaded|\b503\b|capacity/i.test(message)) return "rate-limited";
   if (/not (signed|logged) in|\bsign.?in\b|\blog ?in\b|authenticat|PERMISSION_DENIED|oauth|credential|keyring|keychain|\b401\b|unauthori[sz]ed/i.test(message)) {
     return "auth";
   }
@@ -1013,7 +1013,7 @@ function classify2(message) {
   if (/authentication_failed|failed to authenticate|oauth|not logged in|\/login|invalid api key|\b40[13]\b|unauthori[sz]ed/i.test(message)) {
     return "auth";
   }
-  if (/rate.?limit|too many requests|\b429\b|\b529\b|overloaded|usage limit|limit reached|quota|capacity/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|limit reached|rate.?limit|too many requests|\b429\b|\b529\b|overloaded|quota|capacity/i.test(message)) return "rate-limited";
   if (/model[^.]*(not found|does not exist|invalid|not available)|invalid model|not_found_error/i.test(message)) return "model-unavailable";
   return "other";
 }
@@ -1214,7 +1214,7 @@ function classify3(message) {
   if (/not supported|model[^.]*(not found|does not exist|unknown|unavailable)|unsupported model|no such model/i.test(message)) {
     return "model-unavailable";
   }
-  if (/rate.?limit|too many requests|\b429\b|usage limit|quota|overloaded|\b50[23]\b|capacity/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|rate.?limit|too many requests|\b429\b|quota|overloaded|\b50[23]\b|capacity/i.test(message)) return "rate-limited";
   if (/unauthori[sz]ed|\b40[13]\b|not logged in|log ?in|api.?key|credits?\b|billing|subscription/i.test(message)) return "auth";
   return "other";
 }
@@ -1452,7 +1452,7 @@ function classify4(message) {
   if (/IneligibleTier|no longer supported for Gemini|error authenticating|not logged in|please (log ?in|sign in)|credentials|api key|UNAUTHENTICATED|PERMISSION_DENIED|\b40[13]\b|unauthori[sz]ed/i.test(message)) {
     return "auth";
   }
-  if (/RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|overloaded|\b503\b|exhausted your capacity|capacity/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|RESOURCE_EXHAUSTED|\b429\b|quota|rate.?limit|too many requests|overloaded|\b503\b|exhausted your capacity|capacity/i.test(message)) return "rate-limited";
   if (/model.{0,80}(not found|not available|no longer available|does not exist|unsupported|invalid)|\b404\b|NOT_FOUND|invalid model|is not supported/i.test(message)) return "model-unavailable";
   return "other";
 }
@@ -1896,7 +1896,7 @@ function majorVersion(output) {
 }
 function classify5(message) {
   if (/model not found|ModelNotFound|unknown model|no such model|deprecated/i.test(message)) return "model-unavailable";
-  if (/rate.?limit|too many requests|\b429\b|quota|overloaded|\b50[23]\b|unavailable|capacity/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|rate.?limit|too many requests|\b429\b|quota|overloaded|\b50[23]\b|unavailable|capacity/i.test(message)) return "rate-limited";
   if (/provider\.auth|FreeTierError|free tier|unauthori[sz]ed|\b40[13]\b|api.?key|insufficient|credits?\b|billing|payment/i.test(message)) {
     return "auth";
   }
@@ -2241,7 +2241,7 @@ function invocation7(req) {
 }
 function classify6(message) {
   if (/\b40[13]\b|incorrect api key|invalid api key|unauthori[sz]ed|authenticat|not logged in|no auth/i.test(message)) return "auth";
-  if (/\b429\b|rate.?limit|too many requests|quota|capacity|overloaded|\b529\b/i.test(message)) return "rate-limited";
+  if (/usage limit|session limit|\b429\b|rate.?limit|too many requests|quota|capacity|overloaded|\b529\b/i.test(message)) return "rate-limited";
   if (/model[^.]*(not found|does not exist|not available|not supported)|invalid model|model_not_found|\b404\b/i.test(message)) return "model-unavailable";
   return "other";
 }
@@ -2946,6 +2946,15 @@ exec "$real" "$@"
 function shimDir() {
   return path14.join(home(), "shim", `v${VERSION}`);
 }
+function scoopTarget(exe) {
+  try {
+    const text = fs15.readFileSync(exe.replace(/\.exe$/i, ".shim"), "utf8");
+    const target = /^\s*path\s*=\s*"?([^"\r\n]+?)"?\s*$/m.exec(text)?.[1];
+    return target && fs15.statSync(target).isFile() ? target : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function findRealGit(skip) {
   const same2 = (a, b) => WINDOWS ? a.toLowerCase() === b.toLowerCase() : a === b;
   for (const dir of (process.env.PATH ?? "").split(path14.delimiter).filter(Boolean)) {
@@ -2953,7 +2962,7 @@ function findRealGit(skip) {
     const p = path14.join(dir, WINDOWS ? "git.exe" : "git");
     try {
       fs15.accessSync(p, fs15.constants.X_OK);
-      if (fs15.statSync(p).isFile()) return p;
+      if (fs15.statSync(p).isFile()) return WINDOWS && scoopTarget(p) || p;
     } catch {
     }
   }
@@ -2972,11 +2981,28 @@ function findGitSh(realGit) {
   }
   return void 0;
 }
-var cmdShim = (sh) => `@echo off\r
-set "MSYS2_ARG_CONV_EXCL=*"\r
-"${sh}" "%~dp0git" %*\r
-exit /b %errorlevel%\r
-`;
+var cmdShim = (sh) => [
+  "@echo off",
+  "setlocal EnableExtensions DisableDelayedExpansion",
+  'set "MSYS2_ARG_CONV_EXCL=*"',
+  'set "PITROOM_SELF=%~f0"',
+  'set q=^"',
+  "setlocal EnableDelayedExpansion",
+  'set "line=!cmdcmdline!"',
+  'if not "!line: /d =!"=="!line!" goto plain',
+  'if not "!line: /s =!"=="!line!" goto plain',
+  'set "tail=!line:*/c ""%PITROOM_SELF%"=!"',
+  'if "!tail!"=="!line!" set "tail=!line:*/c "%PITROOM_SELF%=!"',
+  'if "!tail!"=="!line!" goto plain',
+  'if "!tail:~-1!"=="!q!" set "tail=!tail:~0,-1!"',
+  `"${sh}" "%~dp0git" !tail!`,
+  "exit /b !errorlevel!",
+  ":plain",
+  "endlocal",
+  `"${sh}" "%~dp0git" %*`,
+  "exit /b %errorlevel%",
+  ""
+].join("\r\n");
 var HOOK_VERSION = 1;
 var REF_HOOK = `#!/bin/sh
 # pitroom git guard (layer 2, v${HOOK_VERSION}): refuse ref updates made by workers.
@@ -3116,6 +3142,7 @@ import fs17 from "node:fs";
 import path15 from "node:path";
 var MAX_MS = 24 * 36e5;
 var OVERLOAD_MS = 20 * 6e4;
+var USAGE_MS = 36e5;
 var DAILY_MS = 4 * 36e5;
 var file = () => path15.join(home(), "cooldowns.json");
 function cooldownKey(target, backend) {
@@ -3133,10 +3160,41 @@ function retryAfterMs(message) {
   }
   return ms > 0 ? ms : void 0;
 }
-function cooldownMs(message) {
-  const told = retryAfterMs(message);
+function wallClock(at, timeZone) {
+  const p = Object.fromEntries(
+    new Intl.DateTimeFormat("en-US", { timeZone, hourCycle: "h23", year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", second: "numeric" }).formatToParts(at).map((x) => [x.type, Number(x.value)])
+  );
+  return Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
+}
+function retryAtMs(message, now = Date.now()) {
+  const m = /(?:try again at|resets?(?: at)?)\s+(\d{1,2})(?::(\d{2}))?\s*([ap])\.?m\b\.?(?:\s*\(([A-Za-z_]+(?:\/[A-Za-z0-9_+-]+)*)\))?/i.exec(message) ?? /(?:try again at|resets?(?: at)?)\s+(\d{1,2}):(\d{2})()(?!\d)(?:\s*\(([A-Za-z_]+(?:\/[A-Za-z0-9_+-]+)*)\))?/i.exec(message);
+  if (!m) return void 0;
+  let hour = Number(m[1]);
+  const minute = Number(m[2] ?? 0);
+  const half = m[3]?.toLowerCase();
+  if (minute > 59 || (half ? hour < 1 || hour > 12 : hour > 23)) return void 0;
+  if (half === "p" && hour < 12) hour += 12;
+  if (half === "a" && hour === 12) hour = 0;
+  let zone = m[4];
+  try {
+    if (zone) new Intl.DateTimeFormat("en-US", { timeZone: zone });
+  } catch {
+    zone = void 0;
+  }
+  const wall = wallClock(now, zone);
+  for (const day of [0, 1]) {
+    const d = new Date(wall);
+    const target = Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() + day, hour, minute);
+    const at = target - (wallClock(target, zone) - target);
+    if (at > now) return at - now;
+  }
+  return void 0;
+}
+function cooldownMs(message, now = Date.now()) {
+  const told = retryAfterMs(message) ?? retryAtMs(message, now);
   if (told !== void 0) return Math.min(Math.max(told, 6e4), MAX_MS);
-  return /daily|per.?day|per day|exhausted your/i.test(message) ? DAILY_MS : OVERLOAD_MS;
+  if (/daily|per.?day|per day|exhausted your/i.test(message)) return DAILY_MS;
+  return /usage limit|session limit|quota|FreeUsageLimit/i.test(message) ? USAGE_MS : OVERLOAD_MS;
 }
 function read() {
   try {
@@ -3160,7 +3218,7 @@ var activeCooldown = (key, now = Date.now()) => activeCooldowns(now)[key];
 function recordCooldown(key, targetName, message, now = Date.now()) {
   try {
     const all = activeCooldowns(now);
-    all[key] = { until: new Date(now + cooldownMs(message)).toISOString(), reason: message.replace(/\s+/g, " ").trim().slice(0, 160), target: targetName };
+    all[key] = { until: new Date(now + cooldownMs(message, now)).toISOString(), reason: message.replace(/\s+/g, " ").trim().slice(0, 160), target: targetName };
     write(all);
   } catch {
   }
@@ -3349,12 +3407,22 @@ function focusedRate(base2, task, record2) {
   return { rate: Math.min(rate2, 1), why };
 }
 function pickAuditor(meta) {
+  return auditors(meta)[0];
+}
+function auditors(meta) {
   const eff = effective();
   const tiers = eff.tiers.value;
   const def = parseTarget(eff.worker.value, DEFAULT_BACKEND).backend;
   const ran = meta.ran ?? meta.worker;
+  const bare = (t) => ({ backend: t.backend, model: t.model?.split("#")[0] || void 0 });
   const candidates = [tiers.audit, tiers.cheap, ...eff.fallback.value, eff.worker.value].filter((s) => !!s);
-  return candidates.find((c) => !sameTarget(parseTarget(c, def), ran));
+  const out = [];
+  for (const c of candidates) {
+    const t = bare(parseTarget(c, def));
+    if (sameTarget(t, bare(ran)) || out.some((o) => sameTarget(bare(parseTarget(o, def)), t))) continue;
+    out.push(c);
+  }
+  return out;
 }
 function relativeToAuditor(answer, meta) {
   let out = answer;
@@ -3611,12 +3679,21 @@ function workerPrice(backend, ...models) {
 }
 var costAt = (usage2, price) => (usage2.input * price.input + usage2.cacheRead * price.cachedInput + (usage2.output + usage2.reasoning) * price.output) / 1e6;
 var workerCostOf = (usage2) => usage2?.cost ?? usage2?.costEstimate;
+function addUsage(a, b) {
+  const sum = (k) => (a[k] ?? 0) + (b[k] ?? 0);
+  const out = { input: sum("input"), output: sum("output"), reasoning: sum("reasoning"), cacheRead: sum("cacheRead"), cacheWrite: sum("cacheWrite"), total: sum("total"), steps: sum("steps"), toolCalls: sum("toolCalls"), denied: sum("denied") };
+  const ca = workerCostOf(a);
+  const cb = workerCostOf(b);
+  if (ca === void 0 && cb === void 0) return out;
+  if (a.cost !== void 0 && b.cost !== void 0) return { ...out, cost: a.cost + b.cost };
+  return { ...out, costEstimate: (ca ?? 0) + (cb ?? 0), costSource: a.costSource ?? b.costSource };
+}
 function savedUsd(usage2, returnedTokens, price = primaryPrice()) {
   const readingTheReport = returnedTokens * price.input / 1e6;
   return Math.max(0, costAt(usage2, price) - (workerCostOf(usage2) ?? 0) - readingTheReport);
 }
 function record(meta) {
-  if (!meta.usage?.steps || meta.auditOf) return;
+  if (meta.auditOf || !meta.usage?.steps && meta.state !== "done") return false;
   const entry = {
     id: meta.id,
     at: meta.endedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
@@ -3624,22 +3701,49 @@ function record(meta) {
     state: meta.state,
     backend: (meta.ran ?? meta.worker).backend,
     model: meta.resolvedModel ?? (meta.ran ?? meta.worker).model,
-    tokens: meta.usage.total,
+    tokens: meta.usage?.total ?? 0,
     returned: meta.returnedTokens ?? 0,
     workerCost: workerCostOf(meta.usage) ?? 0,
-    ...meta.usage.cost === void 0 && meta.usage.costEstimate !== void 0 ? { costEstimated: true, costSource: meta.usage.costSource } : {},
+    ...meta.usage?.cost === void 0 && meta.usage?.costEstimate !== void 0 ? { costEstimated: true, costSource: meta.usage.costSource } : {},
     saved: meta.savedUsd ?? 0,
     price: primaryPrice().name
   };
   fs20.mkdirSync(path19.dirname(ledgerFile()), { recursive: true });
   fs20.appendFileSync(ledgerFile(), `${JSON.stringify(entry)}
 `);
+  return true;
+}
+var SETTLING_MS = 10 * 6e4;
+function settleLedger(metas) {
+  const known = new Set(readLedger().map((e) => e.id));
+  let n = 0;
+  for (const m of metas ?? finishedRuns()) {
+    if (known.has(m.id) || !TERMINAL.includes(m.state)) continue;
+    if (m.pid !== process.pid && isAlive(m.pid) && (!m.endedAt || Date.now() - Date.parse(m.endedAt) < SETTLING_MS)) continue;
+    if (record(m)) {
+      known.add(m.id);
+      n++;
+    }
+  }
+  return n;
+}
+function* finishedRuns() {
+  for (const id2 of listRunIds()) {
+    try {
+      yield readMeta(id2);
+    } catch {
+    }
+  }
 }
 function readLedger(sinceMs2) {
   if (!fs20.existsSync(ledgerFile())) return [];
+  const seen = /* @__PURE__ */ new Set();
   return fs20.readFileSync(ledgerFile(), "utf8").split("\n").filter(Boolean).flatMap((l) => {
     try {
-      return [JSON.parse(l)];
+      const e = JSON.parse(l);
+      if (seen.has(e.id)) return [];
+      seen.add(e.id);
+      return [e];
     } catch {
       return [];
     }
@@ -4036,6 +4140,7 @@ function archivedId(ref) {
   }
 }
 var VERIFY_FAILED = "(r.state = 'done' AND json_extract(r.meta_json, '$.verifyResult.ok') = 0)";
+var COST_ESTIMATED = "(json_extract(r.meta_json, '$.usage.cost') IS NULL AND json_extract(r.meta_json, '$.usage.costEstimate') IS NOT NULL)";
 var ftsQuery = (text) => text.split(/\s+/).filter(Boolean).map((w) => `"${w.replace(/"/g, '""')}"*`).join(" ");
 function listHistory(q = {}) {
   const db = openDb();
@@ -4070,7 +4175,7 @@ function listHistory(q = {}) {
   try {
     const total = db.prepare(`SELECT COUNT(*) AS n FROM runs r ${base2}`).get(...args).n;
     const page2 = q.beforeId ? `${base2 ? `${base2} AND` : "WHERE"} r.id < ?` : base2;
-    const rows = db.prepare(`SELECT r.*, json_extract(r.meta_json, '$.audit.state') AS audit_state, json_extract(r.meta_json, '$.audit.verdict') AS audit_verdict, ${VERIFY_FAILED} AS verify_failed FROM runs r ${page2} ORDER BY r.id DESC LIMIT ?`).all(...args, ...q.beforeId ? [q.beforeId] : [], Math.min(Math.max(q.limit ?? 30, 1), 200));
+    const rows = db.prepare(`SELECT r.*, json_extract(r.meta_json, '$.audit.state') AS audit_state, json_extract(r.meta_json, '$.audit.verdict') AS audit_verdict, ${VERIFY_FAILED} AS verify_failed, ${COST_ESTIMATED} AS cost_estimated FROM runs r ${page2} ORDER BY r.id DESC LIMIT ?`).all(...args, ...q.beforeId ? [q.beforeId] : [], Math.min(Math.max(q.limit ?? 30, 1), 200));
     return {
       total,
       rows: rows.map((r) => ({
@@ -4088,6 +4193,8 @@ function listHistory(q = {}) {
         seconds: r.seconds ?? void 0,
         steps: r.steps ?? void 0,
         tokens: r.tokens ?? void 0,
+        cost: r.cost ?? void 0,
+        ...r.cost_estimated ? { costEstimated: true } : {},
         saved: r.saved ?? void 0,
         files: r.files_changed ?? 0,
         applied: !!r.applied
@@ -4122,18 +4229,32 @@ function auditStats(db, since2) {
   }
   return { total, byWorker };
 }
-function workerRecord(backend, model, sinceMs2) {
+var WORK_SQL = { research: "kind = 'research'", change: "kind LIKE 'change%'", review: "kind LIKE '%review'" };
+function workerRecord(backend, model, sinceMs2, work) {
   const db = openDb();
   if (!db) return void 0;
   const since2 = new Date(sinceMs2).toISOString();
   const fits = (m) => !model || m === model || !!m?.endsWith(`/${model}`) || model.endsWith(`/${m}`);
   const rec = { runs: 0, ok: 0, audited: 0, agreed: 0 };
   try {
-    for (const r of db.prepare(`SELECT model, SUM(NOT ${LIMITED}) runs, SUM(state='done') ok FROM runs WHERE backend = ? AND started_at >= ? AND ${NOT_AUDIT} AND ${ATTEMPTED} GROUP BY model`).all(backend, since2)) {
+    for (const r of db.prepare(`SELECT model, SUM(NOT ${LIMITED}) runs, SUM(state='done') ok FROM runs WHERE backend = ? AND started_at >= ? AND ${NOT_AUDIT} AND ${ATTEMPTED} AND ${work ? WORK_SQL[work] : "1"} GROUP BY model`).all(backend, since2)) {
       if (!fits(r.model)) continue;
       rec.runs += r.runs ?? 0;
       rec.ok += r.ok ?? 0;
     }
+    if (work === "review") return rec;
+    if (work === "change") {
+      const reviews = db.prepare(`SELECT r.model, json_extract(v.meta_json, '$.verdict.spec') spec, json_extract(v.meta_json, '$.verdict.quality') quality, COUNT(*) n
+        FROM runs v JOIN runs r ON r.id = v.review_of
+        WHERE r.backend = ? AND v.started_at >= ? AND v.state = 'done' AND r.kind LIKE 'change%' AND json_extract(v.meta_json, '$.reviewOf') IS NOT NULL
+        GROUP BY r.model, spec, quality`).all(backend, since2);
+      for (const r of reviews) {
+        if (!fits(r.model) || !["approved", "needs-fixes"].includes(r.quality)) continue;
+        rec.audited += r.n;
+        if (r.spec === "pass" && r.quality === "approved") rec.agreed += r.n;
+      }
+      return rec;
+    }
     const audits = db.prepare(`SELECT r.model, json_extract(a.meta_json, '$.auditVerdict') v, COUNT(*) n
       FROM runs a JOIN runs r ON r.id = json_extract(a.meta_json, '$.auditOf')
       WHERE r.backend = ? AND a.started_at >= ? AND a.state = 'done' AND json_extract(a.meta_json, '$.auditOf') IS NOT NULL
@@ -4279,7 +4400,7 @@ function scoreOf(r) {
   return r.audited >= MIN_AUDITS ? ok * (r.agreed / r.audited) : ok;
 }
 var pct = (x) => `${Math.round(x * 100)}%`;
-function rankChain(chain, recordOf) {
+function rankChain(chain, recordOf, work) {
   const scored = chain.map((t, i) => ({ t, i, score: scoreOf(recordOf(t)) }));
   const slots = scored.filter((s) => s.score !== void 0);
   if (slots.length < 2) return { chain };
@@ -4290,7 +4411,7 @@ function rankChain(chain, recordOf) {
   const by = (t) => scored.find((s) => s.t === t).score;
   return {
     chain: out,
-    note: `ranked by record ("rankWorkers"): ${describeTarget(out[0])} (${pct(by(out[0]))}) goes before ${describeTarget(chain[0])} (${pct(by(chain[0]))})`
+    note: `ranked by record${work ? ` on ${work}` : ""} ("rankWorkers"): ${describeTarget(out[0])} (${pct(by(out[0]))}) goes before ${describeTarget(chain[0])} (${pct(by(chain[0]))})`
   };
 }
 
@@ -4451,7 +4572,7 @@ function formatReport(meta, finalText = readSummary(meta), maxLines = 400) {
     const status = meta.taskStatus ? ` \xB7 STATUS ${meta.taskStatus}` : "";
     out.push(`plan: ${planName(meta.plan.file)} \xB7 Task ${meta.plan.step}: ${meta.plan.title}${status}`);
   }
-  for (const a of meta.attempts ?? []) out.push(a.skipped ? `skipped: ${a.target} (${a.error.slice(0, 160)})` : `fallback: ${a.target} failed (${a.error.slice(0, 160)})`);
+  for (const a of meta.attempts ?? []) out.push(a.skipped ? `skipped: ${a.target} (${a.error.slice(0, 160)})` : a.partial ? `fallback: ${a.target} hit a limit part way and handed the task over (${a.error.slice(0, 160)})` : `fallback: ${a.target} failed (${a.error.slice(0, 160)})`);
   if (meta.error) out.push(`error: ${meta.error}`);
   for (const w of meta.warnings) out.push(`warning: ${w}`);
   if (meta.state === "timeout") {
@@ -5161,7 +5282,7 @@ function inside2(file2, roots) {
 var escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 
 // src/core/run.ts
-var VERSION2 = true ? "0.24.1" : "0.0.0-dev";
+var VERSION2 = true ? "0.26.0" : "0.0.0-dev";
 function planWork(o) {
   if (!o.plan) return { task: o.task.trim(), tier: o.tier };
   if (o.continueFrom) throw new UserError("a follow-up continues its parent's task; drop --plan/--step");
@@ -5200,12 +5321,14 @@ function prepareRun(o) {
     worker = o.model ? { ...ran, model: o.model } : ran;
     fallback = o.noFallback ? [] : parent.fallback.filter((t) => t.backend === ran.backend);
   } else {
-    const chain = resolveChain({ worker: o.worker, model: o.model, tier: work.tier, effort: o.effort, noFallback: o.noFallback });
+    const chain = resolveChain({ worker: o.worker, model: o.model, tier: work.tier, effort: o.effort, noFallback: o.noFallback || !!o.fallbackTo });
     ({ worker, fallback } = chain);
+    if (o.fallbackTo && !o.noFallback) fallback = o.fallbackTo.map((w) => resolveChain({ worker: w, noFallback: true }).worker);
     warnings2.push(...chain.warnings);
     if (effective().rankWorkers.value && !o.worker && !o.model && !work.tier && fallback.length) {
       const since2 = Date.now() - 30 * 864e5;
-      const ranked = rankChain([worker, ...fallback], (t) => workerRecord(t.backend, t.model, since2));
+      const work2 = o.review ? "review" : o.mode === "read" ? "research" : "change";
+      const ranked = rankChain([worker, ...fallback], (t) => workerRecord(t.backend, t.model, since2, work2), work2 === "change" ? "changes" : work2);
       [worker, ...fallback] = ranked.chain;
       if (ranked.note) warnings2.push(ranked.note);
     }
@@ -5396,7 +5519,8 @@ async function execute(meta) {
         }
       }
       if (i === chain.length - 1) break;
-      (meta.attempts ??= []).push({ target: describeTarget(target), error: why.message });
+      if (why.partial) handOver(meta, backend, target);
+      (meta.attempts ??= []).push({ target: describeTarget(target), error: why.message, ...why.partial ? { partial: true } : {} });
       for (const f of ["events.jsonl", "stderr.log"]) {
         const from = runFile(meta.id, f);
         if (fs31.existsSync(from)) fs31.renameSync(from, runFile(meta.id, f.replace(".", `.attempt-${i + 1}.`)));
@@ -5422,7 +5546,7 @@ function autoAudit(meta) {
     let rate2 = auditRate(meta);
     if (meta.auditRate === void 0 && effective().auditFocus.value) {
       const ran = meta.ran ?? meta.worker;
-      const focus = focusedRate(rate2, meta.task, workerRecord(ran.backend, meta.resolvedModel ?? ran.model, Date.now() - 30 * 864e5));
+      const focus = focusedRate(rate2, meta.task, workerRecord(ran.backend, meta.resolvedModel ?? ran.model, Date.now() - 30 * 864e5, "research"));
       rate2 = focus.rate;
       if (focus.why.length) {
         meta.auditFocus = { rate: rate2, why: focus.why };
@@ -5436,7 +5560,7 @@ function autoAudit(meta) {
 }
 function startAudit(meta, worker) {
   const answer = read2(runFile(meta.id, "summary.md"));
-  const auditor = worker ?? pickAuditor(meta);
+  const [auditor, ...others] = worker ? [worker] : auditors(meta);
   if (!auditor) return void 0;
   const a = prepareRun({
     mode: "read",
@@ -5448,8 +5572,9 @@ function startAudit(meta, worker) {
     timeoutSec: Math.min(meta.timeoutSec, 15 * 60),
     allowNonGit: true,
     web: false,
-    // never fall back to the worker being audited
-    noFallback: true,
+    // the other auditors, never the worker being audited; one you named has none
+    noFallback: !!worker,
+    fallbackTo: others,
     group: meta.group,
     audit: { of: meta.id }
   });
@@ -5572,7 +5697,9 @@ function sharedSnapshot(meta, root) {
 function attempt(meta, backend, target) {
   const inv = backend.invocation({
     mode: meta.mode,
-    prompt: buildPrompt(meta.mode, meta.task, !!meta.parent, !!meta.auditOf),
+    prompt: buildPrompt(meta.mode, meta.handoff ? `${meta.task}
+
+${meta.handoff}` : meta.task, !!meta.parent, !!meta.auditOf),
     cwd: meta.cwd,
     model: target.model,
     sessionId: meta.sessionId,
@@ -5591,9 +5718,28 @@ function attempt(meta, backend, target) {
 var read2 = (f) => fs31.existsSync(f) ? fs31.readFileSync(f, "utf8") : "";
 function retryableFailure(meta, backend, res) {
   const run2 = backend.parse(read2(runFile(meta.id, "events.jsonl")));
-  if (run2.usage.steps > 0) return void 0;
   const f = backend.failure(run2, read2(runFile(meta.id, "stderr.log")), res.code);
-  return f && f.kind !== "other" ? f : void 0;
+  if (!f || f.kind === "other") return void 0;
+  if (run2.usage.steps === 0) return f;
+  return f.kind === "rate-limited" ? { ...f, partial: true } : void 0;
+}
+function handOver(meta, backend, target) {
+  const run2 = backend.parse(read2(runFile(meta.id, "events.jsonl")));
+  const used = { ...run2.usage };
+  if (used.cost === void 0) {
+    const price = workerPrice(target.backend, run2.model, target.model);
+    if (price) Object.assign(used, { costEstimate: costAt(used, price), costSource: price.source ?? "config" });
+  }
+  meta.priorUsage = meta.priorUsage ? addUsage(meta.priorUsage, used) : used;
+  if (meta.mode === "read") return;
+  let changed = [];
+  try {
+    const root = meta.mode === "isolate" ? meta.worktree : meta.repoRoot;
+    if (meta.baseTree) changed = diffTrees(root, meta.baseTree, snapshotTree(root, meta.mode === "isolate" ? meta.link : [])).changes.map((c) => c.path);
+  } catch {
+  }
+  const list2 = changed.length ? `: ${changed.slice(0, 30).join(", ")}${changed.length > 30 ? `, and ${changed.length - 30} more` : ""}` : "";
+  meta.handoff = `Another worker started this task and stopped part way, at its usage limit. Its edits are already in the files${list2}. Do not start over: check what it changed against the task, keep what is right, fix what is not, and finish the task.`;
 }
 var HINTS = {
   "model-unavailable": "the model is not available; fix the worker config, pass --worker/--model, or configure fallback workers (see `pitroom doctor`)",
@@ -5659,6 +5805,7 @@ function finalize(meta, res) {
       meta.usage.costSource = price.source ?? "config";
     }
   }
+  if (meta.priorUsage && meta.usage) meta.usage = addUsage(meta.priorUsage, meta.usage);
   meta.returnedTokens = estimateTokens(formatReport(meta, run2.finalText));
   meta.savedUsd = meta.auditOf ? 0 : savedUsd(meta.usage, meta.returnedTokens);
   writeMeta(meta);
@@ -6103,6 +6250,7 @@ var TOPICS = {
   stats: ["since"],
   savings: ["since", "perModel"],
   models: ["worker", "all"],
+  prices: ["worker"],
   cooldown: [],
   config: [],
   doctor: []
@@ -6128,6 +6276,8 @@ function infoArgs(topic, a) {
       return { args: ["history", "stats", ...since(a)] };
     case "savings":
       return { args: ["savings", ...since(a), ...bool(a, "perModel") ? ["--models"] : []] };
+    case "prices":
+      return { args: ["prices", ...worker ? ["--", worker] : []] };
     case "models":
       return { args: ["models", ...worker ? [worker] : [], ...bool(a, "all") ? ["--all"] : []] };
     case "doctor":
@@ -6210,7 +6360,7 @@ var TOOLS2 = [
   {
     name: "pitroom_info",
     title: "Pitroom information",
-    description: "Reports, changing nothing. topic: runs (latest runs; running, group), history (search earlier answers before asking again; text, state, model, since, limit), stats (success rate, time, tokens, audits per worker; since), savings (since, perModel), models (a backend's models and costs; worker, all), cooldown (rate-limited models being skipped), config, doctor (setup check).",
+    description: "Reports, changing nothing. topic: runs (latest runs; running, group), history (search earlier answers before asking again; text, state, model, since, limit), stats (success rate, time, tokens, audits per worker; since), savings (since, perModel), models (a backend's models and costs; worker, all), prices (USD per 1M tokens: the primary the savings are measured against, and each worker in use or the one named; worker), cooldown (rate-limited models being skipped), config, doctor (setup check).",
     inputSchema: {
       type: "object",
       properties: {
@@ -6695,7 +6845,8 @@ var MISSING = `<!doctype html><meta charset="utf-8"><title>Pitroom</title><body
 
 // src/core/dash.ts
 var DEFAULT_PORT = 7878;
-var WEEK_MS2 = 7 * 24 * 3600 * 1e3;
+var DAY_MS = 24 * 3600 * 1e3;
+var PERIODS = { day: 1, week: 7, month: 30, half: 182, all: Infinity };
 var SCAN = 400;
 var RUN_ID3 = /^\d{8}-\d{6}-[0-9a-f]{4}$/;
 var LOCAL_HOST = /^(127\.0\.0\.1|localhost|\[::1\]):\d+$/i;
@@ -6752,6 +6903,7 @@ function toRun(m) {
 }
 function dashState(opts = {}) {
   const limit = Math.min(Math.max(opts.limit ?? 40, 1), 200);
+  const scanned = [];
   const metas = [];
   const groups = /* @__PURE__ */ new Set();
   for (const id2 of listRunIds().slice(-SCAN).reverse()) {
@@ -6761,16 +6913,25 @@ function dashState(opts = {}) {
     } catch {
       continue;
     }
+    scanned.push(m);
     if (m.group) groups.add(m.group);
     if (opts.group && m.group !== opts.group) continue;
     metas.push(m);
   }
   const whole = new Set(metas.slice(0, limit).flatMap((m) => m.group ? [m.group] : []));
   const runs = metas.filter((m, i) => i < limit || m.group && whole.has(m.group)).map(toRun);
+  const now = Date.now();
+  settleLedger(scanned);
+  const ledger = readLedger();
+  const within = (at, days2) => !!at && Date.parse(at) >= now - days2 * DAY_MS;
+  const per = (f) => Object.fromEntries(Object.entries(PERIODS).map(([p, days2]) => [p, f(days2)]));
   return {
     price: primaryPrice().name,
     running: runs.filter((r) => r.state === "running" || r.state === "queued").length,
-    saved: totals(readLedger(Date.now() - WEEK_MS2)).saved,
+    finished: per(
+      (days2) => opts.group ? metas.filter((m) => m.state === "done" && !m.auditOf && within(m.endedAt, days2)).length : ledger.filter((e) => e.state === "done" && within(e.at, days2)).length
+    ),
+    saved: per((days2) => totals(ledger.filter((e) => within(e.at, days2))).saved),
     groups: [...groups].sort(),
     runs
   };
@@ -7050,6 +7211,7 @@ async function dashCommand(o) {
     throw new UserError("pitroom dash did not start (is the port taken? try --port 0)");
   }
   importRuns();
+  settleLedger();
   const explicit = o.port !== void 0;
   let dash;
   try {
@@ -8171,7 +8333,8 @@ async function cmdAudit(p) {
   if (m.mode !== "read") throw new UserError(`run ${m.id} changed files; an audit re-checks a read run's answer: pitroom review ${m.id} judges a change`);
   const answer = readSummary(m);
   if (!answer.trim()) throw new UserError(`run ${m.id} gave no answer to audit`);
-  const worker = flag(p, "worker") ?? (flag(p, "tier") ? void 0 : pickAuditor(m));
+  const named = flag(p, "worker") ?? flag(p, "tier");
+  const [worker, ...others] = named ? [flag(p, "worker")] : auditors(m);
   if (!worker && !flag(p, "tier")) {
     throw new UserError('no other worker to audit with: name one with -W, or configure tiers "audit" or "cheap", or fallback workers, that differ from the one that answered', 3);
   }
@@ -8181,7 +8344,8 @@ async function cmdAudit(p) {
     dir: m.dir,
     worker,
     group: flag(p, "group") ?? m.group,
-    noFallback: true,
+    noFallback: !!named,
+    fallbackTo: others,
     audit: { of: m.id },
     auditRate: void 0
   });
@@ -8199,33 +8363,37 @@ async function cmdPrices(p) {
     if (!has(p, "quiet")) console.log(`price catalog updated: ${r.models} priced models`);
   }
   const st = catalogStatus();
-  const used = (() => {
+  const priced = (t) => {
+    const backend = getBackend(t.backend);
+    const model = (t.model ?? "").split("#")[0];
+    const price = workerPrice(t.backend, model);
+    return {
+      worker: model ? `${t.backend}:${model}` : t.backend,
+      reportsCost: backend.capabilities.reportsCost,
+      price: price ? { name: price.name, source: price.source, input: price.input, output: price.output, cachedInput: price.cachedInput } : void 0
+    };
+  };
+  const asked = p.positional.length > 0;
+  const used = asked ? p.positional.map((spec) => priced(parseTarget(spec, resolveChain().worker.backend))) : (() => {
     try {
       const chain = resolveChain();
-      return [chain.worker, ...chain.fallback].map((t) => {
-        const backend = getBackend(t.backend);
-        const model = (t.model ?? "").split("#")[0];
-        const price = workerPrice(t.backend, model);
-        return {
-          worker: model ? `${t.backend}:${model}` : t.backend,
-          reportsCost: backend.capabilities.reportsCost,
-          price: price ? { name: price.name, source: price.source, input: price.input, output: price.output, cachedInput: price.cachedInput } : void 0
-        };
-      });
+      return [chain.worker, ...chain.fallback].map(priced);
     } catch {
       return [];
     }
   })();
-  if (has(p, "json")) return console.log(JSON.stringify({ ...st, workers: used }, null, 2)), 0;
+  const primary = primaryPrice();
+  if (has(p, "json")) return console.log(JSON.stringify({ ...st, primary, workers: used }, null, 2)), 0;
   console.log(`price feed: ${st.enabled ? "on" : 'off ("priceFeed": true in the config turns it on: Pitroom then fetches one public file, see PRIVACY.md)'}`);
   console.log(`source:     ${st.url}${st.enabled ? `, refreshed after a run when older than ${st.hours} h` : ""}`);
   console.log(st.models ? `catalog:    ${st.models} priced models, updated ${st.ageHours < 1 ? "within the hour" : `${st.ageHours.toFixed(1)} h ago`}` : "catalog:    none yet (pitroom prices --refresh fetches it)");
   if (st.lastFailure) console.log(`last try:   failed: ${st.lastFailure.replace(/^\S+ /, "")}`);
+  console.log(`primary:    ${primary.name}: in ${primary.input} \xB7 out ${primary.output} \xB7 cached ${primary.cachedInput} USD/1M  (what the savings are measured against)`);
   if (used.length) {
-    console.log("\nthe workers in use:");
+    console.log(asked ? "\nthe workers asked about:" : "\nthe workers in use:");
     for (const u of used) {
       const what2 = u.reportsCost ? "reports its own cost" : u.price ? `in ${u.price.input} \xB7 out ${u.price.output} \xB7 cached ${u.price.cachedInput} USD/1M  (${u.price.source === "catalog" ? `price catalog ${catalogLabel()}` : "your workerPrices"})` : "no price: its runs count as free in the savings";
-      console.log(`  ${u.worker.padEnd(36)} ${what2}`);
+      console.log(`  ${u.worker.padEnd(Math.max(36, ...used.map((x) => x.worker.length)))} ${what2}`);
     }
   }
   return 0;
@@ -8397,6 +8565,7 @@ function cmdHistory(p) {
     return 0;
   }
   importRuns();
+  settleLedger();
   const since2 = sinceMs(flag(p, "since"));
   if (sub === "stats") {
     const s = historyStats(since2);
@@ -8416,14 +8585,16 @@ ${[fmt2(head2), ...rows2.map(fmt2)].join("\n")}`);
   const { rows, total } = listHistory({ text: p.positional.join(" "), model: flag(p, "model"), state: flag(p, "state"), group: flag(p, "group"), sinceMs: since2, limit });
   if (has(p, "json")) return console.log(JSON.stringify({ total, rows }, null, 2)), 0;
   if (!rows.length) return console.log(total ? "nothing on this page" : "no matching runs"), 0;
-  const body = rows.map((r) => [r.id, when(r.startedAt), r.verifyFailed ? "verify failed" : r.state, `${r.backend}${r.model ? ` (${r.model.split("/").pop()})` : ""}`, secs(r.seconds), r.task.length > 60 ? `${r.task.slice(0, 59)}\u2026` : r.task]);
-  const head = ["RUN", "WHEN", "STATE", "WORKER", "TIME", "TASK"];
+  const cost = (r) => r.cost === void 0 ? "-" : r.cost === 0 ? "free" : `${r.costEstimated ? "~" : ""}${usd(r.cost)}`;
+  const body = rows.map((r) => [r.id, when(r.startedAt), r.verifyFailed ? "verify failed" : r.state, `${r.backend}${r.model ? ` (${r.model.split("/").pop()})` : ""}`, secs(r.seconds), cost(r), r.task.length > 60 ? `${r.task.slice(0, 59)}\u2026` : r.task]);
+  const head = ["RUN", "WHEN", "STATE", "WORKER", "TIME", "COST", "TASK"];
   const widths = head.map((h, i) => Math.max(h.length, ...body.map((r) => r[i].length)));
   const fmt = (r, header = false) => r.map((c, i) => {
     const cell2 = i === r.length - 1 ? c : c.padEnd(widths[i]);
     return header ? dim(cell2) : i === 2 ? stateColour(r[2], cell2) : cell2;
   }).join("  ");
   console.log([fmt(head, true), ...body.map((r) => fmt(r))].join("\n"));
+  if (rows.some((r) => r.costEstimated)) console.log(dim("\n~ estimated from a price: the worker's CLI reported no cost"));
   if (total > rows.length) console.log(`
 ${rows.length} of ${total} \xB7 --limit N for more \xB7 pitroom show <run> for one`);
   return 0;
@@ -8548,19 +8719,21 @@ function cmdInit(p) {
 }
 function cmdSavings(p) {
   const since2 = flag(p, "since") ?? "all";
+  settleLedger();
   const t = totals(readLedger(sinceMs(since2)));
   if (has(p, "models")) {
     const by = /* @__PURE__ */ new Map();
     for (const e of readLedger(sinceMs(since2))) {
       const key = `${e.backend ?? "?"}  ${e.model ?? "(default model)"}`;
-      const a = by.get(key) ?? { runs: 0, tokens: 0, returned: 0, cost: 0, saved: 0 };
-      by.set(key, { runs: a.runs + 1, tokens: a.tokens + e.tokens, returned: a.returned + e.returned, cost: a.cost + e.workerCost, saved: a.saved + e.saved });
+      const a = by.get(key) ?? { runs: 0, tokens: 0, returned: 0, cost: 0, estimated: false, saved: 0 };
+      by.set(key, { runs: a.runs + 1, tokens: a.tokens + e.tokens, returned: a.returned + e.returned, cost: a.cost + e.workerCost, estimated: a.estimated || !!e.costEstimated, saved: a.saved + e.saved });
     }
     const width = Math.max(12, ...[...by.keys()].map((k) => k.length));
     console.log(`${"worker  model".padEnd(width)}  ${"runs".padStart(5)} ${"processed".padStart(10)} ${"returned".padStart(9)} ${"cost".padStart(8)} ${"saved".padStart(8)}`);
     for (const [key, a] of [...by].sort((x, y) => y[1].runs - x[1].runs)) {
-      console.log(`${key.padEnd(width)}  ${String(a.runs).padStart(5)} ${compact(a.tokens).padStart(10)} ${compact(a.returned).padStart(9)} ${usd(a.cost).padStart(8)} ${usd(a.saved).padStart(8)}`);
+      console.log(`${key.padEnd(width)}  ${String(a.runs).padStart(5)} ${compact(a.tokens).padStart(10)} ${compact(a.returned).padStart(9)} ${`${a.estimated ? "~" : ""}${usd(a.cost)}`.padStart(8)} ${usd(a.saved).padStart(8)}`);
     }
+    if ([...by.values()].some((a) => a.estimated)) console.log(dim("\n~ the cost is estimated from a price, in part or in all: the worker's CLI reported none"));
     return 0;
   }
   const period = since2 === "all" ? "all time" : `last ${since2.replace("d", " days")}`;
@@ -9053,7 +9226,7 @@ Usage
   pitroom statusline [--then CMD]       status-bar line: running workers, savings this week (after CMD's)
   pitroom hook-card                     PostToolUse hook: a card after each Bash \`pitroom\` command
   pitroom hook-start                    SessionStart hook: introduces Pitroom to the agent (Codex; Claude Code uses its plugin)
-  pitroom prices [--refresh] [--json]   the price catalog (config "priceFeed") and the price each worker in use gets
+  pitroom prices [WORKER\u2026] [--refresh] [--json]   the price catalog (config "priceFeed"), the primary's price and the price each worker in use (or named) gets
   pitroom cooldown [--clear]            models that said "rate limited" and are skipped for a while (a quota used up);
                                         --clear tries them again
   pitroom mcp [-d DIR] [--http [--port N]]