@chit-run/cli 0.7.0 → 0.8.0

package/dist/chit.js

@@ -10820,6 +10820,11 @@ class ClaudeCliAdapter {
         if (noProgress)
           throw new Error(`claude --print made no progress for ${noProgressMs}ms`);
         if (exitCode !== 0) {
+          const rateLimit = detectClaudeRateLimit(`${stdoutText}
+${stderrText}`);
+          if (rateLimit !== undefined) {
+            throw new Error(`claude --print rate limited${rateLimit ? `: ${rateLimit}` : ` (exit ${exitCode})`}`);
+          }
           const cleaned = sanitize(stderrText || stdoutText, sensitive);
           const tail = cleaned.trim().split(`
 `).slice(-5).join(`
@@ -10953,6 +10958,42 @@ function parseClaudeResult(stdout) {
   }
   return result;
 }
+function detectClaudeRateLimit(stdout) {
+  const pickStr = (v) => typeof v === "string" && v.trim() !== "" ? v.trim().replace(/\s+/g, " ").slice(0, 120) : undefined;
+  const pickNum = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
+  let found = false;
+  let detail = "";
+  for (const line of stdout.split(`
+`)) {
+    const trimmed = line.trim();
+    if (!trimmed)
+      continue;
+    let evt;
+    try {
+      evt = JSON.parse(trimmed);
+    } catch {
+      continue;
+    }
+    if (evt.type !== "rate_limit_event")
+      continue;
+    found = true;
+    const rl = evt.rate_limit_info && typeof evt.rate_limit_info === "object" ? evt.rate_limit_info : evt.rate_limit && typeof evt.rate_limit === "object" ? evt.rate_limit : evt;
+    const parts = [];
+    const status = pickStr(rl.status);
+    if (status)
+      parts.push(`status=${status}`);
+    const resetsAt = pickStr(rl.resetsAt);
+    if (resetsAt)
+      parts.push(`resets ${resetsAt}`);
+    const retryAfter = pickNum(rl.retryAfter) ?? pickNum(rl.resetInSeconds);
+    if (retryAfter !== undefined)
+      parts.push(`retry after ${retryAfter}s`);
+    if (rl.isUsingOverage === false)
+      parts.push("overage disabled");
+    detail = parts.join(", ");
+  }
+  return found ? detail : undefined;
+}
 
 // src/adapters/codex-exec.ts
 var DEFAULT_CALL_TIMEOUT_MS2 = 15 * 60000;
@@ -10972,7 +11013,7 @@ class CodexExecAdapter {
     const sensitive = findSensitiveValues(this.config.env);
     try {
       const priorThreadId = getCodexThreadId(req.session);
-      const cmd = this.buildCommand(priorThreadId);
+      const cmd = this.buildCommand(priorThreadId, req.filesystem);
       const proc = Bun.spawn({
         cmd,
         cwd: req.cwd,
@@ -11049,7 +11090,7 @@ class CodexExecAdapter {
       throw new Error(message);
     }
   }
-  buildCommand(priorThreadId) {
+  buildCommand(priorThreadId, filesystem) {
     if (priorThreadId) {
       return ["codex", "exec", "resume", "--json", "--skip-git-repo-check", priorThreadId, "-"];
     }
@@ -11059,7 +11100,8 @@ class CodexExecAdapter {
     if (this.config.reasoningEffort) {
       cmd.push("-c", `model_reasoning_effort="${this.config.reasoningEffort}"`);
     }
-    cmd.push("--sandbox", "read-only", "--skip-git-repo-check", "-");
+    const sandbox = filesystem === "write" ? "workspace-write" : "read-only";
+    cmd.push("--sandbox", sandbox, "--skip-git-repo-check", "-");
     return cmd;
   }
 }
@@ -12146,6 +12188,9 @@ function computeFingerprint(input) {
     reasoningEffort: agent.reasoningEffort ?? null,
     passModelOnResume: agent.adapter === "claude-cli" ? agent.passModelOnResume : null,
     strictMcp: agent.adapter === "claude-cli" ? agent.strictMcp !== false : null,
+    ...agent.adapter === "codex-exec" && {
+      codexSandbox: participant.permissions.filesystem === "write" ? "workspace-write" : "read-only"
+    },
     baseUrl,
     role: participant.role,
     session: participant.session,
@@ -12554,7 +12599,8 @@ async function runConvergeIteration(ctx) {
   if (!result.ok) {
     return {
       ok: false,
-      failure: `manifest run failed at step "${result.failedStep}": ${result.error}`
+      failure: `manifest run failed at step "${result.failedStep}": ${result.error}`,
+      ...result.auditRunId && { auditRunId: result.auditRunId }
     };
   }
   const reviewText = result.outputs.review ?? "";
@@ -12923,7 +12969,12 @@ async function runJobWorker(jobId, deps) {
   const workerToken = crypto.randomUUID();
   const setPhase = (phase) => {
     try {
-      store.update(jobId, (c) => ({ ...c, phase, lastHeartbeatAt: iso2(now()) }));
+      store.update(jobId, (c) => ({
+        ...c,
+        phase,
+        ...c.phase !== phase && { phaseStartedAt: iso2(now()) },
+        lastHeartbeatAt: iso2(now())
+      }));
     } catch {}
   };
   const controller = new AbortController;
@@ -12946,7 +12997,8 @@ async function runJobWorker(jobId, deps) {
       pgid: process.pid,
       workerToken,
       lastHeartbeatAt: iso2(now()),
-      phase: "starting"
+      phase: "starting",
+      phaseStartedAt: iso2(now())
     }));
     const resolved = resolveExecute(job);
     if (!resolved.ok) {
@@ -12981,6 +13033,7 @@ async function runJobWorker(jobId, deps) {
         ...c,
         iteration: i,
         phase: "implementing",
+        ...c.phase !== "implementing" && { phaseStartedAt: iso2(now()) },
         lastHeartbeatAt: iso2(now())
       }));
       let iter;
@@ -13010,6 +13063,10 @@ async function runJobWorker(jobId, deps) {
         return;
       }
       if (!iter.ok) {
+        if (iter.auditRunId) {
+          const ref = iter.auditRunId;
+          store.update(jobId, (c) => ({ ...c, auditRefs: [...c.auditRefs, ref] }));
+        }
         if (controller.signal.aborted) {
           stopLoopSafely(job, "cancelled", "cancelled mid-iteration (signal)");
           finish(store, jobId, now, "cancelled", { stopStatus: "cancelled" });
@@ -13022,6 +13079,7 @@ async function runJobWorker(jobId, deps) {
       store.update(jobId, (c) => ({
         ...c,
         phase: "recording",
+        ...c.phase !== "recording" && { phaseStartedAt: iso2(now()) },
         iterationsCompleted: i,
         lastVerdict: iter.verdict,
         auditRefs: iter.auditRunId ? [...c.auditRefs, iter.auditRunId] : c.auditRefs,
@@ -13062,6 +13120,7 @@ function finish(store, jobId, now, state, extra) {
     state,
     endedAt: iso2(now()),
     phase: undefined,
+    phaseStartedAt: undefined,
     lastHeartbeatAt: iso2(now()),
     ...extra.stopStatus !== undefined && { stopStatus: extra.stopStatus },
     ...extra.failure !== undefined && { failure: extra.failure }
@@ -36126,6 +36185,40 @@ function isStale(job, nowMs, staleAfterMs = STALE_AFTER_MS) {
   const heartbeatOld = !Number.isFinite(beat) || nowMs - beat > staleAfterMs;
   return heartbeatOld || !pidAlive(job.pid);
 }
+function jobTiming(job, nowMs) {
+  const inFlight = job.state === "queued" || job.state === "running";
+  const timing = {};
+  const startMs = Date.parse(job.startedAt ?? job.createdAt);
+  const endMs = job.endedAt ? Date.parse(job.endedAt) : nowMs;
+  if (Number.isFinite(startMs) && Number.isFinite(endMs) && endMs >= startMs) {
+    timing.elapsedMs = endMs - startMs;
+  }
+  if (inFlight && job.lastHeartbeatAt) {
+    const beat = Date.parse(job.lastHeartbeatAt);
+    if (Number.isFinite(beat) && nowMs >= beat)
+      timing.lastHeartbeatAgeMs = nowMs - beat;
+  }
+  if (job.phase !== undefined && job.phaseStartedAt) {
+    const phaseStart = Date.parse(job.phaseStartedAt);
+    if (Number.isFinite(phaseStart) && nowMs >= phaseStart) {
+      timing.phaseElapsedMs = nowMs - phaseStart;
+    }
+  }
+  return timing;
+}
+function formatDuration(ms) {
+  const totalSec = Math.floor(ms / 1000);
+  if (totalSec < 60)
+    return `${totalSec}s`;
+  const totalMin = Math.floor(totalSec / 60);
+  if (totalMin < 60) {
+    const sec = totalSec % 60;
+    return sec ? `${totalMin}m${sec}s` : `${totalMin}m`;
+  }
+  const hours = Math.floor(totalMin / 60);
+  const min = totalMin % 60;
+  return min ? `${hours}h${min}m` : `${hours}h`;
+}
 
 // src/surfaces/mcp/converge-engine.ts
 class ConvergeEngineError extends Error {
@@ -36578,10 +36671,22 @@ function summarizeRunForStatus(run) {
     audited: run.recorder !== undefined && run.recorder.lastError === undefined
   };
 }
+function runningNextAction(job, timing) {
+  const parts = [];
+  if (timing.elapsedMs !== undefined)
+    parts.push(`running for ${formatDuration(timing.elapsedMs)}`);
+  if (job.phase) {
+    parts.push(timing.phaseElapsedMs !== undefined ? `${job.phase} for ${formatDuration(timing.phaseElapsedMs)}` : job.phase);
+  }
+  const lead = parts.length > 0 ? parts.join(", ") : "in progress";
+  return `${lead}; chit_job_status / chit_job_cancel "${job.jobId}"`;
+}
 function summarizeJobForStatus(job, nowMs) {
   const stale = isStale(job, nowMs);
   const display = stale ? "stale" : job.state;
-  const nextAction = display === "running" ? `in progress${job.phase ? ` (${job.phase})` : ""}; chit_job_status / chit_job_cancel "${job.jobId}"` : display === "queued" ? "queued; the worker is starting" : display === "stale" ? `worker appears dead; chit_job_status "${job.jobId}" to inspect, then start a fresh job` : `${display}${job.stopStatus ? ` (${job.stopStatus})` : ""}; chit_job_status "${job.jobId}" or chit_audit_show <ref>`;
+  const timing = jobTiming(job, nowMs);
+  const latestRef = job.auditRefs.at(-1);
+  const nextAction = display === "running" ? runningNextAction(job, timing) : display === "queued" ? "queued; the worker is starting" : display === "stale" ? `worker appears dead; chit_job_status "${job.jobId}" to inspect, then start a fresh job` : `${display}${job.stopStatus ? ` (${job.stopStatus})` : ""}; chit_job_status "${job.jobId}"${latestRef ? ` or chit_audit_show ${latestRef}` : ""}`;
   return {
     jobId: job.jobId,
     loopId: job.loopId,
@@ -36594,6 +36699,11 @@ function summarizeJobForStatus(job, nowMs) {
     ...job.stopStatus !== undefined && { stopStatus: job.stopStatus },
     auditRefs: job.auditRefs,
     createdAt: job.createdAt,
+    ...timing.elapsedMs !== undefined && { elapsedMs: timing.elapsedMs },
+    ...timing.lastHeartbeatAgeMs !== undefined && {
+      lastHeartbeatAgeMs: timing.lastHeartbeatAgeMs
+    },
+    ...timing.phaseElapsedMs !== undefined && { phaseElapsedMs: timing.phaseElapsedMs },
     nextAction
   };
 }
@@ -37118,7 +37228,13 @@ function describeJob(job) {
       };
     }
   } catch {}
-  const nextAction = display === "running" ? "in progress; chit_job_cancel to stop, or wait and poll again" : display === "queued" ? "queued; the worker is starting" : display === "stale" ? "worker appears dead; inspect with chit_job_status (and chit_audit_show <auditRef> for transcripts), then start a fresh job" : `${display}${job.stopStatus ? ` (${job.stopStatus})` : ""}; open a transcript with chit_audit_show <auditRef>`;
+  const timing = jobTiming(job, now);
+  const latestRef = job.auditRefs.at(-1);
+  const runningDetail = [
+    timing.elapsedMs !== undefined ? `running for ${formatDuration(timing.elapsedMs)}` : undefined,
+    job.phase ? timing.phaseElapsedMs !== undefined ? `${job.phase} for ${formatDuration(timing.phaseElapsedMs)}` : job.phase : undefined
+  ].filter(Boolean);
+  const nextAction = display === "running" ? `${runningDetail.length > 0 ? `${runningDetail.join(", ")}; ` : ""}chit_job_cancel to stop, or wait and poll again` : display === "queued" ? "queued; the worker is starting" : display === "stale" ? `worker appears dead; inspect with chit_job_status${latestRef ? ` (chit_audit_show ${latestRef} for the transcript)` : ""}, then start a fresh job` : `${display}${job.stopStatus ? ` (${job.stopStatus})` : ""}; ${latestRef ? `open a transcript with chit_audit_show ${latestRef}` : "no audit transcript was recorded"}`;
   return {
     jobId: job.jobId,
     loopId: job.loopId,
@@ -37140,12 +37256,18 @@ function describeJob(job) {
     ...job.startedAt !== undefined && { startedAt: job.startedAt },
     ...job.endedAt !== undefined && { endedAt: job.endedAt },
     ...job.lastHeartbeatAt !== undefined && { lastHeartbeatAt: job.lastHeartbeatAt },
+    ...job.phaseStartedAt !== undefined && { phaseStartedAt: job.phaseStartedAt },
+    ...timing.elapsedMs !== undefined && { elapsedMs: timing.elapsedMs },
+    ...timing.lastHeartbeatAgeMs !== undefined && {
+      lastHeartbeatAgeMs: timing.lastHeartbeatAgeMs
+    },
+    ...timing.phaseElapsedMs !== undefined && { phaseElapsedMs: timing.phaseElapsedMs },
     ...latest !== undefined && { latest },
     nextAction
   };
 }
 server.registerTool("chit_job_status", {
-  description: "Show one background job: state (queued/running/completed/cancelled/failed, or derived `stale` when the worker is gone), current phase, loop id, iterations, last verdict, audit refs, and the latest iteration's changed files / workspace warnings / usage. Read-only.",
+  description: "Show one background job: state (queued/running/completed/cancelled/failed, or derived `stale` when the worker is gone), current phase, timing fields (elapsedMs, lastHeartbeatAgeMs, phaseElapsedMs), loop id, iterations, last verdict, audit refs, and the latest iteration's changed files / workspace warnings / usage. Read-only.",
   inputSchema: { job_id: exports_external.string() }
 }, async ({ job_id }) => {
   const job = jobStore.get(job_id);
@@ -38092,9 +38214,10 @@ Permission enforcement: each participant's declared permissions are checked
 against the chosen adapter's capabilities at install time. If the adapter
 cannot enforce a permission, the run is rejected unless
 --allow-unenforced-permissions is set. Both built-in adapters enforce
-filesystem read_only today: codex-exec via --sandbox read-only (a hard OS
-sandbox), claude-cli via --permission-mode plan (Claude plan-mode permissions,
-not an OS/filesystem sandbox).
+filesystem read_only today: codex-exec via an OS sandbox (--sandbox read-only
+for a reviewer, --sandbox workspace-write for a write-capable implementer),
+claude-cli via --permission-mode plan (a Claude plan-mode permission, not an
+OS/filesystem sandbox).
 
 Limitations in this build:
 - file[] inputs are not yet supported via the CLI.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chit-run/cli",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"description": "Versioned, cross-vendor agent routines with an audit trail. Stop being the glue between your agents.",
 	"type": "module",
 	"license": "MIT",