ai-whisper 0.1.2 → 0.1.4

package/README.md

@@ -50,6 +50,20 @@ It is **not** for:
 - invisible background automation you never watch.
 - people new to coding agents looking for a guided, hand-holding experience.
 
+## Prerequisites
+
+ai-whisper drives the *real* Claude and Codex CLIs, so you need both installed and authenticated first:
+
+- **[Claude Code CLI](https://claude.com/claude-code)** — the `claude` command, signed in.
+- **[Codex CLI](https://github.com/openai/codex)** — the `codex` command, signed in.
+- **Node.js 22+**.
+- **An LLM evaluator with credentials** — workflows are gated by it and refuse to start without it. See [Evaluator configuration](docs/evaluator-configuration.md).
+- **tmux** *(optional)* — only for `whisper collab start`, which auto-arranges both agents into panes. The mount flow below does not need it.
+
+## Safety & permissions
+
+ai-whisper launches each agent in **full-autonomy mode** so the relay can drive it unattended — `claude --dangerously-skip-permissions` and `codex --dangerously-bypass-approvals-and-sandbox`. Inside the mounted workspace the agents read, write, and run commands without prompting. Point it at code you're willing to let two agents change autonomously, watch the run on the dashboard, and remember you are the final gatekeeper — review the result before you ship it. The deeper rationale is in [Concepts](docs/concepts.md).
+
 ## Quickstart
 
 Install from npm:
@@ -90,6 +104,10 @@ whisper collab dashboard
 
 > Running from a repo checkout instead of a packaged install? Build first (`pnpm build`) and invoke the CLI as `node packages/cli/dist/bin/whisper.js ...` wherever these examples say `whisper ...`.
 
+## What happens if it fails?
+
+A run that stops short usually **escalates** — it does not crash. When the evaluator can't resolve a phase (the round budget is spent, an agent reports it's blocked, or confidence stays too low), the loop halts and turn ownership returns to you. That's a designed exit, not a failure: run state is durable, so you read the dashboard, fix the spec or unblock the agent, and `whisper workflow resume <id>` to pick up where it left off. Escalation is the system asking for a human exactly when it should — seeing it is normal, not a sign something broke.
+
 ## Core concepts
 
 ai-whisper is **not a swarm**. The agents never type at once — work moves by a single baton, one owner at a time. Mounted sessions are *real* Claude and Codex sessions in your terminal, and those sessions are the source of truth. Autonomy is supervised: every handoff, verdict, and round is inspectable, and runs are resumable rather than fire-and-forget. Work is organized as structured workflows — explicit loops and state transitions, not a free-form chat.

package/dist/bin/broker-daemon.js

@@ -1702,7 +1702,32 @@ function listActiveCollabSummaries(db, input) {
 			     OR EXISTS (SELECT 1 FROM workflows w
 			                 WHERE w.collab_id = c.collab_id AND w.status = 'running')`).all(cutoff);
   const out = [];
+  const seen = /* @__PURE__ */ new Set();
   for (const e of eligible) {
+    out.push(buildCollabSummary(db, e.collabId));
+    seen.add(e.collabId);
+  }
+  const minResults = input.minResults ?? 3;
+  if (out.length < minResults) {
+    const finished = db.prepare(`SELECT collab_id AS collabId, MAX(created_at) AS lastCreated
+				   FROM workflows
+				  WHERE status IN ('done','halted','canceled')
+				  GROUP BY collab_id
+				  ORDER BY lastCreated DESC, collab_id DESC`).all();
+    for (const f of finished) {
+      if (out.length >= minResults)
+        break;
+      if (seen.has(f.collabId))
+        continue;
+      out.push(buildCollabSummary(db, f.collabId));
+      seen.add(f.collabId);
+    }
+  }
+  return out;
+}
+function buildCollabSummary(db, collabId2) {
+  {
+    const e = { collabId: collabId2 };
     const collab2 = db.prepare(`SELECT display_name AS displayName, workspace_root AS workspaceRoot
 				   FROM collab WHERE collab_id = ?`).get(e.collabId);
     const wf = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -1756,7 +1781,7 @@ function listActiveCollabSummaries(db, input) {
 						   FROM relay_handoff
 						  WHERE collab_id = ? AND workflow_id IS NULL`).get(e.collabId);
     const runLastAct = runLastActRow?.lastAct ?? "";
-    out.push({
+    return {
       collabId: e.collabId,
       label,
       workflowId: wf?.workflowId ?? null,
@@ -1775,9 +1800,8 @@ function listActiveCollabSummaries(db, input) {
       },
       sessions,
       lastActivityAt: runLastAct
-    });
+    };
   }
-  return out;
 }
 function listWorkflowsForCollab(db, collabId2) {
   const rows = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,

package/dist/bin/companion-agent.js

@@ -1735,7 +1735,32 @@ function listActiveCollabSummaries(db, input) {
 			     OR EXISTS (SELECT 1 FROM workflows w
 			                 WHERE w.collab_id = c.collab_id AND w.status = 'running')`).all(cutoff);
   const out = [];
+  const seen = /* @__PURE__ */ new Set();
   for (const e of eligible) {
+    out.push(buildCollabSummary(db, e.collabId));
+    seen.add(e.collabId);
+  }
+  const minResults = input.minResults ?? 3;
+  if (out.length < minResults) {
+    const finished = db.prepare(`SELECT collab_id AS collabId, MAX(created_at) AS lastCreated
+				   FROM workflows
+				  WHERE status IN ('done','halted','canceled')
+				  GROUP BY collab_id
+				  ORDER BY lastCreated DESC, collab_id DESC`).all();
+    for (const f of finished) {
+      if (out.length >= minResults)
+        break;
+      if (seen.has(f.collabId))
+        continue;
+      out.push(buildCollabSummary(db, f.collabId));
+      seen.add(f.collabId);
+    }
+  }
+  return out;
+}
+function buildCollabSummary(db, collabId) {
+  {
+    const e = { collabId };
     const collab = db.prepare(`SELECT display_name AS displayName, workspace_root AS workspaceRoot
 				   FROM collab WHERE collab_id = ?`).get(e.collabId);
     const wf = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -1789,7 +1814,7 @@ function listActiveCollabSummaries(db, input) {
 						   FROM relay_handoff
 						  WHERE collab_id = ? AND workflow_id IS NULL`).get(e.collabId);
     const runLastAct = runLastActRow?.lastAct ?? "";
-    out.push({
+    return {
       collabId: e.collabId,
       label,
       workflowId: wf?.workflowId ?? null,
@@ -1808,9 +1833,8 @@ function listActiveCollabSummaries(db, input) {
       },
       sessions,
       lastActivityAt: runLastAct
-    });
+    };
   }
-  return out;
 }
 function listWorkflowsForCollab(db, collabId) {
   const rows = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,

package/dist/bin/relay-monitor.js

@@ -1705,7 +1705,32 @@ function listActiveCollabSummaries(db, input) {
 			     OR EXISTS (SELECT 1 FROM workflows w
 			                 WHERE w.collab_id = c.collab_id AND w.status = 'running')`).all(cutoff);
   const out = [];
+  const seen = /* @__PURE__ */ new Set();
   for (const e of eligible) {
+    out.push(buildCollabSummary(db, e.collabId));
+    seen.add(e.collabId);
+  }
+  const minResults = input.minResults ?? 3;
+  if (out.length < minResults) {
+    const finished = db.prepare(`SELECT collab_id AS collabId, MAX(created_at) AS lastCreated
+				   FROM workflows
+				  WHERE status IN ('done','halted','canceled')
+				  GROUP BY collab_id
+				  ORDER BY lastCreated DESC, collab_id DESC`).all();
+    for (const f of finished) {
+      if (out.length >= minResults)
+        break;
+      if (seen.has(f.collabId))
+        continue;
+      out.push(buildCollabSummary(db, f.collabId));
+      seen.add(f.collabId);
+    }
+  }
+  return out;
+}
+function buildCollabSummary(db, collabId2) {
+  {
+    const e = { collabId: collabId2 };
     const collab = db.prepare(`SELECT display_name AS displayName, workspace_root AS workspaceRoot
 				   FROM collab WHERE collab_id = ?`).get(e.collabId);
     const wf = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -1759,7 +1784,7 @@ function listActiveCollabSummaries(db, input) {
 						   FROM relay_handoff
 						  WHERE collab_id = ? AND workflow_id IS NULL`).get(e.collabId);
     const runLastAct = runLastActRow?.lastAct ?? "";
-    out.push({
+    return {
       collabId: e.collabId,
       label,
       workflowId: wf?.workflowId ?? null,
@@ -1778,9 +1803,8 @@ function listActiveCollabSummaries(db, input) {
       },
       sessions,
       lastActivityAt: runLastAct
-    });
+    };
   }
-  return out;
 }
 function listWorkflowsForCollab(db, collabId2) {
   const rows = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -5076,7 +5100,9 @@ function computeLiveness(snap) {
   let why = null;
   let stuck = false;
   let liveOverride = null;
-  if (terminal === "halted" || terminal === "canceled") {
+  if (terminal === "done") {
+    return { stuck: false, why: null, liveText: "done" };
+  } else if (terminal === "halted" || terminal === "canceled") {
     stuck = true;
     why = snap.workflow?.haltReason ? `${terminal}: ${snap.workflow.haltReason}` : `workflow ${terminal}`;
   } else if (chainStatus === "escalated" || chainStatus === "abandoned") {

package/dist/bin/whisper.js

@@ -14,6 +14,7 @@ function loadDotEnv() {
 
 // src/create-cli.ts
 import { execSync as execSync4 } from "node:child_process";
+import { readFileSync as readFileSync3 } from "node:fs";
 import { Command, Option } from "commander";
 
 // ../broker/dist/config.js
@@ -1775,7 +1776,32 @@ function listActiveCollabSummaries(db, input) {
 			     OR EXISTS (SELECT 1 FROM workflows w
 			                 WHERE w.collab_id = c.collab_id AND w.status = 'running')`).all(cutoff);
   const out = [];
+  const seen = /* @__PURE__ */ new Set();
   for (const e of eligible) {
+    out.push(buildCollabSummary(db, e.collabId));
+    seen.add(e.collabId);
+  }
+  const minResults = input.minResults ?? 3;
+  if (out.length < minResults) {
+    const finished = db.prepare(`SELECT collab_id AS collabId, MAX(created_at) AS lastCreated
+				   FROM workflows
+				  WHERE status IN ('done','halted','canceled')
+				  GROUP BY collab_id
+				  ORDER BY lastCreated DESC, collab_id DESC`).all();
+    for (const f of finished) {
+      if (out.length >= minResults)
+        break;
+      if (seen.has(f.collabId))
+        continue;
+      out.push(buildCollabSummary(db, f.collabId));
+      seen.add(f.collabId);
+    }
+  }
+  return out;
+}
+function buildCollabSummary(db, collabId) {
+  {
+    const e = { collabId };
     const collab = db.prepare(`SELECT display_name AS displayName, workspace_root AS workspaceRoot
 				   FROM collab WHERE collab_id = ?`).get(e.collabId);
     const wf = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -1829,7 +1855,7 @@ function listActiveCollabSummaries(db, input) {
 						   FROM relay_handoff
 						  WHERE collab_id = ? AND workflow_id IS NULL`).get(e.collabId);
     const runLastAct = runLastActRow?.lastAct ?? "";
-    out.push({
+    return {
       collabId: e.collabId,
       label,
       workflowId: wf?.workflowId ?? null,
@@ -1848,9 +1874,8 @@ function listActiveCollabSummaries(db, input) {
       },
       sessions,
       lastActivityAt: runLastAct
-    });
+    };
   }
-  return out;
 }
 function listWorkflowsForCollab(db, collabId) {
   const rows = db.prepare(`SELECT workflow_id AS workflowId, workflow_type AS workflowType,
@@ -9165,7 +9190,9 @@ function computeLiveness(snap) {
   let why = null;
   let stuck = false;
   let liveOverride = null;
-  if (terminal === "halted" || terminal === "canceled") {
+  if (terminal === "done") {
+    return { stuck: false, why: null, liveText: "done" };
+  } else if (terminal === "halted" || terminal === "canceled") {
     stuck = true;
     why = snap.workflow?.haltReason ? `${terminal}: ${snap.workflow.haltReason}` : `workflow ${terminal}`;
   } else if (chainStatus === "escalated" || chainStatus === "abandoned") {
@@ -9946,6 +9973,8 @@ function createDashboardRuntime(input) {
   let lastSig = null;
   let renderCount = 0;
   let recycles = 0;
+  let lastRenderedMode = "wall";
+  let clearCount = 0;
   const recycleEvery = Math.max(1, input.__recycleEveryRenders ?? 750);
   function toPhaseRuns(raw) {
     return raw.map((p) => ({
@@ -10151,6 +10180,11 @@ function createDashboardRuntime(input) {
       lastSig = pendingSig;
       renderCount += 1;
       const full = createElement2(DashboardApp, { node: el, onKey: handleKey });
+      if (mode !== lastRenderedMode) {
+        ink.clear();
+        clearCount += 1;
+        lastRenderedMode = mode;
+      }
       if (renderCount % recycleEvery === 0) {
         ink.unmount();
         ink = render2(full, inkOptions);
@@ -10260,7 +10294,8 @@ function createDashboardRuntime(input) {
       lastError: lastPollError
     }),
     __renderCount: () => renderCount,
-    __recycles: () => recycles
+    __recycles: () => recycles,
+    __clears: () => clearCount
   };
 }
 
@@ -11006,8 +11041,18 @@ async function connectToWorkspaceBroker(input) {
 function collectArtifact(value, previous = []) {
   return [...previous, value];
 }
+function resolveCliVersion() {
+  for (const rel of ["../../package.json", "../package.json"]) {
+    try {
+      const pkg = JSON.parse(readFileSync3(new URL(rel, import.meta.url), "utf8"));
+      if (pkg.name === "ai-whisper" && typeof pkg.version === "string") return pkg.version;
+    } catch {
+    }
+  }
+  return "0.0.0-dev";
+}
 function createCli() {
-  const cli = new Command().name("whisper").description("ai-whisper CLI");
+  const cli = new Command().name("whisper").description("ai-whisper CLI").version(resolveCliVersion(), "-v, --version", "output the version number");
   const collab = cli.command("collab").description("Manage AI agent collaboration sessions");
   collab.command("start").description("Start a new collaboration session").option("--workspace <path>", "Workspace root", process.cwd()).option("--no-tmux", "Disable tmux even if available").option("--no-launch", "Start broker only, do not launch agent terminals").option(
     "--port <port>",
@@ -11310,6 +11355,69 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
   return cli;
 }
 
+// src/runtime/version-check.ts
+var PKG = "ai-whisper";
+var REGISTRY_LATEST = `https://registry.npmjs.org/${PKG}/latest`;
+var DEFAULT_TIMEOUT_MS = 1500;
+function coreParts(v) {
+  const core = v.split("-")[0] ?? "";
+  const [a, b, c] = core.split(".").map((n) => Number.parseInt(n, 10) || 0);
+  return [a ?? 0, b ?? 0, c ?? 0];
+}
+function isNewerVersion(candidate, current) {
+  const cand = coreParts(candidate);
+  const cur = coreParts(current);
+  for (let i = 0; i < 3; i++) {
+    if (cand[i] > cur[i]) return true;
+    if (cand[i] < cur[i]) return false;
+  }
+  const candPre = candidate.includes("-");
+  const curPre = current.includes("-");
+  if (candPre !== curPre) return !candPre;
+  return false;
+}
+function formatVersionReport(current, latest) {
+  if (latest && isNewerVersion(latest, current)) {
+    return `${current}
+A newer version is available: ${current} \u2192 ${latest}  \xB7  update: npm install -g ${PKG}@latest`;
+  }
+  return current;
+}
+async function fetchLatestVersion(opts) {
+  const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const f = opts?.fetchImpl ?? fetch;
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  try {
+    const res = await f(REGISTRY_LATEST, { signal: ac.signal });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function reportVersion(input) {
+  const write = input.write ?? ((line) => process.stdout.write(`${line}
+`));
+  if (input.disabled) {
+    write(input.current);
+    return;
+  }
+  const latest = await (input.fetchLatest ? input.fetchLatest() : fetchLatestVersion());
+  write(formatVersionReport(input.current, latest));
+}
+
 // src/bin/whisper.ts
 loadDotEnv();
+var argv = process.argv.slice(2);
+if (argv.includes("-v") || argv.includes("--version")) {
+  await reportVersion({
+    current: resolveCliVersion(),
+    disabled: process.env.AI_WHISPER_NO_UPDATE_CHECK === "1"
+  });
+  process.exit(0);
+}
 await createCli().parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-whisper",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Terminal-first relay for paired AI coding agents (Claude + Codex), driven by structured workflows.",
   "license": "Apache-2.0",
   "repository": {
@@ -8,6 +8,22 @@
     "url": "https://github.com/ai-creed/ai-whisper.git"
   },
   "homepage": "https://ai-creed.dev/projects/ai-whisper/",
+  "keywords": [
+    "ai-agents",
+    "claude",
+    "codex",
+    "coding-agent",
+    "cli",
+    "developer-tools",
+    "tmux",
+    "spec-driven-development",
+    "agent-orchestration",
+    "pair-programming",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
   "type": "module",
   "bin": {
     "whisper": "./dist/bin/whisper.js",
@@ -30,10 +46,10 @@
     "@types/react": "^19.2.14",
     "ink-testing-library": "^4.0.0",
     "@ai-whisper/adapter-claude": "0.0.0",
-    "@ai-whisper/broker": "0.0.0",
-    "@ai-whisper/companion-core": "0.0.0",
+    "@ai-whisper/adapter-codex": "0.0.0",
     "@ai-whisper/shared": "0.0.0",
-    "@ai-whisper/adapter-codex": "0.0.0"
+    "@ai-whisper/companion-core": "0.0.0",
+    "@ai-whisper/broker": "0.0.0"
   },
   "files": [
     "dist",