ai-whisper 0.10.0 → 0.11.0

package/dist/bin/broker-daemon.js

@@ -633,6 +633,40 @@ function countActiveWorkflowsForCollab(db, collabId2) {
   const row = db.prepare("SELECT COUNT(*) AS n FROM workflows WHERE collab_id = ? AND status IN ('running', 'paused')").get(collabId2);
   return row.n;
 }
+var COUNTED_STATUSES = ["done", "halted"];
+function getHandsOffStats(db) {
+  const placeholders = COUNTED_STATUSES.map(() => "?").join(",");
+  const rows = db.prepare(`SELECT status, created_at, updated_at
+			   FROM workflows
+			  WHERE status IN (${placeholders})`).all(...COUNTED_STATUSES);
+  const stats = {
+    totalMs: 0,
+    count: 0,
+    byStatus: {
+      done: { count: 0, totalMs: 0 },
+      halted: { count: 0, totalMs: 0 }
+    },
+    earliestKickoffAt: null,
+    skipped: 0
+  };
+  for (const row of rows) {
+    const start = Date.parse(row.created_at);
+    const end = Date.parse(row.updated_at);
+    if (Number.isNaN(start) || Number.isNaN(end)) {
+      stats.skipped += 1;
+      continue;
+    }
+    const elapsed = Math.max(0, end - start);
+    stats.totalMs += elapsed;
+    stats.count += 1;
+    stats.byStatus[row.status].count += 1;
+    stats.byStatus[row.status].totalMs += elapsed;
+    if (stats.earliestKickoffAt === null || row.created_at < stats.earliestKickoffAt) {
+      stats.earliestKickoffAt = row.created_at;
+    }
+  }
+  return stats;
+}
 
 // ../broker/dist/runtime/workspace-snapshot.js
 import { execFileSync } from "node:child_process";
@@ -4352,6 +4386,9 @@ function createControlService(db, events) {
         ...now !== void 0 ? { now } : {}
       });
     },
+    getHandsOffStats() {
+      return getHandsOffStats(db);
+    },
     listRunCostRows(collabId2, workflowId) {
       return listRunCostRows(db, { collabId: collabId2, workflowId });
     },
@@ -5310,19 +5347,20 @@ async function sweepStaleBrokerDaemons(input) {
   }
   return { deleted };
 }
-function defaultIsAlive(pid) {
+function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
-    return Promise.resolve({ alive: true, startTime: null });
+    return true;
   } catch (err) {
     const code = err.code;
-    if (code === "ESRCH")
-      return Promise.resolve({ alive: false, startTime: null });
     if (code === "EPERM")
-      return Promise.resolve({ alive: true, startTime: null });
-    return Promise.resolve({ alive: false, startTime: null });
+      return true;
+    return false;
   }
 }
+function defaultIsAlive(pid) {
+  return Promise.resolve({ alive: isPidAlive(pid), startTime: null });
+}
 
 // ../broker/dist/runtime/daemon-heartbeat.js
 function createDaemonHeartbeat(input) {

package/dist/bin/companion-agent.js

@@ -666,6 +666,40 @@ function countActiveWorkflowsForCollab(db, collabId) {
   const row = db.prepare("SELECT COUNT(*) AS n FROM workflows WHERE collab_id = ? AND status IN ('running', 'paused')").get(collabId);
   return row.n;
 }
+var COUNTED_STATUSES = ["done", "halted"];
+function getHandsOffStats(db) {
+  const placeholders = COUNTED_STATUSES.map(() => "?").join(",");
+  const rows = db.prepare(`SELECT status, created_at, updated_at
+			   FROM workflows
+			  WHERE status IN (${placeholders})`).all(...COUNTED_STATUSES);
+  const stats = {
+    totalMs: 0,
+    count: 0,
+    byStatus: {
+      done: { count: 0, totalMs: 0 },
+      halted: { count: 0, totalMs: 0 }
+    },
+    earliestKickoffAt: null,
+    skipped: 0
+  };
+  for (const row of rows) {
+    const start = Date.parse(row.created_at);
+    const end = Date.parse(row.updated_at);
+    if (Number.isNaN(start) || Number.isNaN(end)) {
+      stats.skipped += 1;
+      continue;
+    }
+    const elapsed = Math.max(0, end - start);
+    stats.totalMs += elapsed;
+    stats.count += 1;
+    stats.byStatus[row.status].count += 1;
+    stats.byStatus[row.status].totalMs += elapsed;
+    if (stats.earliestKickoffAt === null || row.created_at < stats.earliestKickoffAt) {
+      stats.earliestKickoffAt = row.created_at;
+    }
+  }
+  return stats;
+}
 
 // ../broker/dist/runtime/workspace-snapshot.js
 import { execFileSync } from "node:child_process";
@@ -4372,6 +4406,9 @@ function createControlService(db, events) {
         ...now !== void 0 ? { now } : {}
       });
     },
+    getHandsOffStats() {
+      return getHandsOffStats(db);
+    },
     listRunCostRows(collabId, workflowId) {
       return listRunCostRows(db, { collabId, workflowId });
     },
@@ -5320,19 +5357,20 @@ async function sweepStaleBrokerDaemons(input) {
   }
   return { deleted };
 }
-function defaultIsAlive(pid) {
+function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
-    return Promise.resolve({ alive: true, startTime: null });
+    return true;
   } catch (err) {
     const code = err.code;
-    if (code === "ESRCH")
-      return Promise.resolve({ alive: false, startTime: null });
     if (code === "EPERM")
-      return Promise.resolve({ alive: true, startTime: null });
-    return Promise.resolve({ alive: false, startTime: null });
+      return true;
+    return false;
   }
 }
+function defaultIsAlive(pid) {
+  return Promise.resolve({ alive: isPidAlive(pid), startTime: null });
+}
 
 // ../broker/dist/runtime/daemon-heartbeat.js
 function createDaemonHeartbeat(input) {

package/dist/bin/relay-monitor.js

@@ -636,6 +636,40 @@ function countActiveWorkflowsForCollab(db, collabId2) {
   const row = db.prepare("SELECT COUNT(*) AS n FROM workflows WHERE collab_id = ? AND status IN ('running', 'paused')").get(collabId2);
   return row.n;
 }
+var COUNTED_STATUSES = ["done", "halted"];
+function getHandsOffStats(db) {
+  const placeholders = COUNTED_STATUSES.map(() => "?").join(",");
+  const rows = db.prepare(`SELECT status, created_at, updated_at
+			   FROM workflows
+			  WHERE status IN (${placeholders})`).all(...COUNTED_STATUSES);
+  const stats = {
+    totalMs: 0,
+    count: 0,
+    byStatus: {
+      done: { count: 0, totalMs: 0 },
+      halted: { count: 0, totalMs: 0 }
+    },
+    earliestKickoffAt: null,
+    skipped: 0
+  };
+  for (const row of rows) {
+    const start = Date.parse(row.created_at);
+    const end = Date.parse(row.updated_at);
+    if (Number.isNaN(start) || Number.isNaN(end)) {
+      stats.skipped += 1;
+      continue;
+    }
+    const elapsed = Math.max(0, end - start);
+    stats.totalMs += elapsed;
+    stats.count += 1;
+    stats.byStatus[row.status].count += 1;
+    stats.byStatus[row.status].totalMs += elapsed;
+    if (stats.earliestKickoffAt === null || row.created_at < stats.earliestKickoffAt) {
+      stats.earliestKickoffAt = row.created_at;
+    }
+  }
+  return stats;
+}
 
 // ../broker/dist/runtime/workspace-snapshot.js
 import { execFileSync } from "node:child_process";
@@ -4342,6 +4376,9 @@ function createControlService(db, events) {
         ...now !== void 0 ? { now } : {}
       });
     },
+    getHandsOffStats() {
+      return getHandsOffStats(db);
+    },
     listRunCostRows(collabId2, workflowId) {
       return listRunCostRows(db, { collabId: collabId2, workflowId });
     },
@@ -5294,19 +5331,20 @@ async function sweepStaleBrokerDaemons(input) {
   }
   return { deleted };
 }
-function defaultIsAlive(pid) {
+function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
-    return Promise.resolve({ alive: true, startTime: null });
+    return true;
   } catch (err) {
     const code = err.code;
-    if (code === "ESRCH")
-      return Promise.resolve({ alive: false, startTime: null });
     if (code === "EPERM")
-      return Promise.resolve({ alive: true, startTime: null });
-    return Promise.resolve({ alive: false, startTime: null });
+      return true;
+    return false;
   }
 }
+function defaultIsAlive(pid) {
+  return Promise.resolve({ alive: isPidAlive(pid), startTime: null });
+}
 
 // ../broker/dist/runtime/daemon-heartbeat.js
 function createDaemonHeartbeat(input) {

package/dist/bin/whisper.js

@@ -821,6 +821,46 @@ function insertCollab(db, collab) {
       orchestrator_max_rounds
     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(collab.collabId, collab.workspaceRoot, collab.displayName, collab.status, collab.createdAt, collab.updatedAt, collab.orchestratorEnabled ? 1 : 0, collab.orchestratorMaxRounds);
 }
+function listAllCollabs(db) {
+  const rows = db.prepare(`SELECT collab_id, workspace_root, workspace_id, status, tmux_session
+         FROM collab
+        ORDER BY created_at`).all();
+  return rows.map((r) => ({
+    collabId: r.collab_id,
+    workspaceRoot: r.workspace_root,
+    workspaceId: r.workspace_id,
+    status: r.status,
+    tmuxSession: r.tmux_session
+  }));
+}
+function tableHasCollabIdColumn(db, table) {
+  const cols = db.prepare(`PRAGMA table_info("${table}")`).all();
+  return cols.some((c) => c.name === "collab_id");
+}
+function listCollabIdTables(db) {
+  const names = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name").all().map((r) => r.name);
+  return names.filter((name) => name !== "collab" && tableHasCollabIdColumn(db, name));
+}
+function countCollabRows(db, collabId) {
+  let total = 0;
+  for (const table of listCollabIdTables(db)) {
+    total += db.prepare(`SELECT COUNT(*) AS n FROM "${table}" WHERE collab_id = ?`).get(collabId).n;
+  }
+  total += db.prepare("SELECT COUNT(*) AS n FROM workflow_phases WHERE workflow_id IN (SELECT workflow_id FROM workflows WHERE collab_id = ?)").get(collabId).n;
+  total += db.prepare("SELECT COUNT(*) AS n FROM work_item_cancellation WHERE work_item_id IN (SELECT work_item_id FROM work_item WHERE collab_id = ?)").get(collabId).n;
+  total += db.prepare("SELECT COUNT(*) AS n FROM clipboard_capture_lease WHERE holder_collab_id = ?").get(collabId).n;
+  total += db.prepare("SELECT COUNT(*) AS n FROM collab WHERE collab_id = ?").get(collabId).n;
+  return total;
+}
+function deleteCollabCascade(db, collabId) {
+  db.prepare("DELETE FROM workflow_phases WHERE workflow_id IN (SELECT workflow_id FROM workflows WHERE collab_id = ?)").run(collabId);
+  db.prepare("DELETE FROM work_item_cancellation WHERE work_item_id IN (SELECT work_item_id FROM work_item WHERE collab_id = ?)").run(collabId);
+  for (const table of listCollabIdTables(db)) {
+    db.prepare(`DELETE FROM "${table}" WHERE collab_id = ?`).run(collabId);
+  }
+  db.prepare("DELETE FROM clipboard_capture_lease WHERE holder_collab_id = ?").run(collabId);
+  db.prepare("DELETE FROM collab WHERE collab_id = ?").run(collabId);
+}
 function getCollab(db, collabId) {
   const row = db.prepare(`SELECT collab_id, workspace_root, display_name, status, created_at, updated_at,
 			        orchestrator_enabled, orchestrator_max_rounds
@@ -912,9 +952,52 @@ function countActiveWorkflowsForCollab(db, collabId) {
   const row = db.prepare("SELECT COUNT(*) AS n FROM workflows WHERE collab_id = ? AND status IN ('running', 'paused')").get(collabId);
   return row.n;
 }
+function findNonTerminalWorkflow(db, collabId) {
+  const row = db.prepare(`SELECT workflow_id, status
+			   FROM workflows
+			  WHERE collab_id = ? AND status NOT IN ('done', 'canceled')
+			  ORDER BY created_at DESC
+			  LIMIT 1`).get(collabId);
+  return row ? { workflowId: row.workflow_id, status: row.status } : null;
+}
+function getHandsOffStats(db) {
+  const placeholders = COUNTED_STATUSES.map(() => "?").join(",");
+  const rows = db.prepare(`SELECT status, created_at, updated_at
+			   FROM workflows
+			  WHERE status IN (${placeholders})`).all(...COUNTED_STATUSES);
+  const stats = {
+    totalMs: 0,
+    count: 0,
+    byStatus: {
+      done: { count: 0, totalMs: 0 },
+      halted: { count: 0, totalMs: 0 }
+    },
+    earliestKickoffAt: null,
+    skipped: 0
+  };
+  for (const row of rows) {
+    const start = Date.parse(row.created_at);
+    const end = Date.parse(row.updated_at);
+    if (Number.isNaN(start) || Number.isNaN(end)) {
+      stats.skipped += 1;
+      continue;
+    }
+    const elapsed = Math.max(0, end - start);
+    stats.totalMs += elapsed;
+    stats.count += 1;
+    stats.byStatus[row.status].count += 1;
+    stats.byStatus[row.status].totalMs += elapsed;
+    if (stats.earliestKickoffAt === null || row.created_at < stats.earliestKickoffAt) {
+      stats.earliestKickoffAt = row.created_at;
+    }
+  }
+  return stats;
+}
+var COUNTED_STATUSES;
 var init_workflow_repository = __esm({
   "../broker/dist/storage/repositories/workflow-repository.js"() {
     "use strict";
+    COUNTED_STATUSES = ["done", "halted"];
   }
 });
 
@@ -4773,6 +4856,9 @@ function createControlService(db, events) {
         ...now !== void 0 ? { now } : {}
       });
     },
+    getHandsOffStats() {
+      return getHandsOffStats(db);
+    },
     listRunCostRows(collabId, workflowId) {
       return listRunCostRows(db, { collabId, workflowId });
     },
@@ -5836,19 +5922,20 @@ async function sweepStaleBrokerDaemons(input) {
   }
   return { deleted };
 }
-function defaultIsAlive(pid) {
+function isPidAlive(pid) {
   try {
     process.kill(pid, 0);
-    return Promise.resolve({ alive: true, startTime: null });
+    return true;
   } catch (err) {
     const code = err.code;
-    if (code === "ESRCH")
-      return Promise.resolve({ alive: false, startTime: null });
     if (code === "EPERM")
-      return Promise.resolve({ alive: true, startTime: null });
-    return Promise.resolve({ alive: false, startTime: null });
+      return true;
+    return false;
   }
 }
+function defaultIsAlive(pid) {
+  return Promise.resolve({ alive: isPidAlive(pid), startTime: null });
+}
 var init_broker_daemon_sweep = __esm({
   "../broker/dist/runtime/broker-daemon-sweep.js"() {
     "use strict";
@@ -6490,6 +6577,8 @@ var init_dist2 = __esm({
     init_session_attachment_repository();
     init_broker_daemon_repository();
     init_recovery_state_repository();
+    init_collab_repository();
+    init_workflow_repository();
   }
 });
 
@@ -6582,6 +6671,15 @@ function fmtDur(ms) {
   const m = Math.floor(s / 60);
   return m > 0 ? `${m}m${String(s % 60).padStart(2, "0")}s` : `${s}s`;
 }
+function fmtDurCoarse(ms) {
+  const totalMin = Math.floor(Math.max(0, ms) / 6e4);
+  const d = Math.floor(totalMin / 1440);
+  const h = Math.floor(totalMin % 1440 / 60);
+  const m = totalMin % 60;
+  if (d > 0) return `${d}d ${h}h`;
+  if (h > 0) return `${h}h ${m}m`;
+  return `${m}m`;
+}
 function isOkOutcome(outcome) {
   if (!outcome) return false;
   return !/escalat|halt|fail|cancel/i.test(outcome);
@@ -7088,10 +7186,13 @@ function Wall(props) {
   const paneWidth = Math.floor(props.cols / colsCount);
   let globalIdx = 0;
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", width: props.cols, children: [
-    props.counts ? /* @__PURE__ */ jsx3(Text2, { wrap: "truncate", children: SUMMARY_SEGMENTS.map((seg, i) => {
-      const n = props.counts[seg.key];
-      return /* @__PURE__ */ jsx3(Text2, { color: n > 0 ? seg.color : THEME.muted, children: (i > 0 ? "  " : "") + `${seg.glyph} ${n} ${seg.label}` }, seg.key);
-    }) }) : null,
+    props.counts ? /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
+      SUMMARY_SEGMENTS.map((seg, i) => {
+        const n = props.counts[seg.key];
+        return /* @__PURE__ */ jsx3(Text2, { color: n > 0 ? seg.color : THEME.muted, children: (i > 0 ? "  " : "") + `${seg.glyph} ${n} ${seg.label}` }, seg.key);
+      }),
+      /* @__PURE__ */ jsx3(Text2, { color: THEME.muted, children: `  \u2502  hands-off saved ${fmtDurCoarse(state.handsOff.totalMs)} (or ${Math.floor(state.handsOff.totalMs / 36e5)}h) (${state.handsOff.count} wf runs)` })
+    ] }) : null,
     state.sections.map((sec) => {
       const rows = [];
       for (let i = 0; i < sec.panes.length; i += colsCount) {
@@ -7693,7 +7794,8 @@ function buildWallState(input) {
     page: alloc.page,
     pageCount: alloc.pageCount,
     totalRuns: alloc.totalRuns,
-    selected
+    selected,
+    handsOff: input.handsOff ?? { totalMs: 0, count: 0 }
   };
 }
 var MIN_PANE_COLS2, CARD_HEIGHT, HEADER_ROWS, GROUP_ORDER, GROUP_LABEL;
@@ -8035,6 +8137,7 @@ function createDashboardRuntime(input) {
         mountAlive: mountAliveOf(sess.agentType)
       }));
     }
+    const handsOff = c.getHandsOffStats();
     const wallState = buildWallState({
       summaries,
       now: isoNow,
@@ -8043,7 +8146,8 @@ function createDashboardRuntime(input) {
       rows,
       page: wallPage,
       selected: wallSelected,
-      snapshots
+      snapshots,
+      handsOff: { totalMs: handsOff.totalMs, count: handsOff.count }
     });
     wallPage = wallState.page;
     wallSelected = wallState.selected;
@@ -8238,7 +8342,8 @@ function loadDotEnv() {
 }
 
 // src/create-cli.ts
-import { execSync as execSync4 } from "node:child_process";
+init_dist2();
+import { execSync as execSync5 } from "node:child_process";
 import { Command, Option } from "commander";
 
 // src/runtime/wait-for-broker-ready.ts
@@ -13934,8 +14039,8 @@ function compareSemver(a, b) {
 var EZIO_PROVENANCE = {
   ezioCliVersion: "0.3.0",
   ezioGitSha: "ffd95dc",
-  builtAt: "2026-06-30T04:51:15.900Z",
-  whisperVersion: "0.10.0"
+  builtAt: "2026-07-01T04:07:32.417Z",
+  whisperVersion: "0.11.0"
 };
 
 // src/ezio-provenance-types.ts
@@ -17862,6 +17967,250 @@ function runCollabStop(input) {
   }
 }
 
+// src/commands/collab/purge.ts
+init_dist2();
+init_dist2();
+import { execSync as execSync3 } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+function isCollabLive(db, collabId, isAlive) {
+  const daemon = getBrokerDaemonByCollab(db, collabId);
+  if (daemon?.pid != null && isAlive(daemon.pid)) return true;
+  return listSessionAttachmentsByCollab(db, collabId).some(
+    (a) => a.pid != null && isAlive(a.pid)
+  );
+}
+function classifyCollab(db, collab, isAlive) {
+  const base = {
+    collabId: collab.collabId,
+    workspaceRoot: collab.workspaceRoot,
+    workspaceId: collab.workspaceId,
+    status: collab.status,
+    tmuxSession: collab.tmuxSession,
+    rowCount: countCollabRows(db, collab.collabId)
+  };
+  const daemon = getBrokerDaemonByCollab(db, collab.collabId);
+  const daemonAlive = daemon?.pid != null && isAlive(daemon.pid);
+  const mountAlive = listSessionAttachmentsByCollab(db, collab.collabId).some(
+    (a) => a.pid != null && isAlive(a.pid)
+  );
+  if (daemonAlive || mountAlive) {
+    return {
+      ...base,
+      bucket: "live",
+      reason: daemonAlive ? "live-daemon" : "live-mount"
+    };
+  }
+  const wf = findNonTerminalWorkflow(db, collab.collabId);
+  if (wf) {
+    return {
+      ...base,
+      bucket: "protected",
+      reason: `workflow ${wf.status}`,
+      workflowId: wf.workflowId,
+      workflowStatus: wf.status
+    };
+  }
+  const reason = collab.status === "stopped" ? "stopped" : daemon ? "dead-daemon" : "dead-mounts";
+  return { ...base, bucket: "stale", reason };
+}
+function classifyAllCollabs(db, collabs, isAlive) {
+  return collabs.map((c) => classifyCollab(db, c, isAlive));
+}
+function defaultConfirm(promptText) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return rl.question(`${promptText} [y/N] `).then((answer) => /^y(es)?$/i.test(answer.trim())).finally(() => rl.close());
+}
+function defaultKillTmuxSession(session) {
+  try {
+    const escaped = session.replace(/'/g, "'\\''");
+    execSync3(`tmux kill-session -t '${escaped}'`, { stdio: "ignore" });
+  } catch {
+  }
+}
+function buildJsonPayload(classifications, purged, skippedWentLive, skippedError, protectedSkipped, aborted) {
+  return {
+    classifications,
+    purged,
+    skipped: { wentLive: skippedWentLive, error: skippedError },
+    protected: protectedSkipped,
+    aborted
+  };
+}
+function renderTable(classifications, log) {
+  if (classifications.length === 0) {
+    log("No collabs found.");
+    return;
+  }
+  log(
+    "COLLAB                          BUCKET     REASON           ROWS  WORKSPACE"
+  );
+  for (const c of classifications) {
+    const wf = c.workflowId ? ` [${c.workflowId} ${c.workflowStatus}]` : "";
+    log(
+      `${c.collabId.padEnd(31)} ${c.bucket.padEnd(10)} ${c.reason.padEnd(16)} ${String(c.rowCount).padStart(4)}  ${c.workspaceRoot}${wf}`
+    );
+  }
+}
+async function runCollabPurge(opts) {
+  if (opts.collabId && opts.workspace) {
+    throw new Error("--collab and --workspace are mutually exclusive");
+  }
+  const isAlive = opts.isAlive ?? isPidAlive;
+  const log = opts.log ?? ((line) => console.log(line));
+  const isTTY = opts.isTTY ?? Boolean(process.stdin.isTTY);
+  const confirm = opts.confirm ?? defaultConfirm;
+  const killTmux = opts.killTmuxSession ?? defaultKillTmuxSession;
+  const empty = (exitCode, classifications = [], protectedSkipped = [], aborted = false) => ({
+    classifications,
+    purged: [],
+    skippedWentLive: [],
+    skippedError: [],
+    protectedSkipped,
+    aborted,
+    exitCode
+  });
+  let workspaceFilter = null;
+  if (opts.workspace) {
+    try {
+      workspaceFilter = workspaceIdFromPath(opts.workspace);
+    } catch {
+      log(`Cannot resolve --workspace path: ${opts.workspace}`);
+      return empty(1);
+    }
+  }
+  const db = openDatabase(getSharedSqlitePath());
+  applyMigrations(db);
+  try {
+    let collabs = listAllCollabs(db);
+    if (opts.collabId)
+      collabs = collabs.filter((c) => c.collabId === opts.collabId);
+    if (workspaceFilter)
+      collabs = collabs.filter((c) => c.workspaceId === workspaceFilter);
+    const classifications = classifyAllCollabs(db, collabs, isAlive);
+    const protectedSkipped = classifications.filter((c) => c.bucket === "protected").map((c) => c.collabId);
+    const candidates = classifications.filter(
+      (c) => c.bucket === "stale" || opts.force === true && c.bucket === "protected"
+    );
+    if (!opts.json) {
+      renderTable(classifications, log);
+    }
+    if (candidates.length === 0) {
+      if (opts.json) {
+        log(
+          JSON.stringify(
+            buildJsonPayload(
+              classifications,
+              [],
+              [],
+              [],
+              protectedSkipped,
+              false
+            ),
+            null,
+            2
+          )
+        );
+      } else {
+        log("Nothing to purge.");
+      }
+      return empty(0, classifications, protectedSkipped);
+    }
+    const previewOnly = opts.dryRun === true || opts.json === true && opts.yes !== true;
+    if (previewOnly) {
+      if (opts.json) {
+        log(
+          JSON.stringify(
+            buildJsonPayload(
+              classifications,
+              [],
+              [],
+              [],
+              protectedSkipped,
+              false
+            ),
+            null,
+            2
+          )
+        );
+      } else {
+        log(
+          `Dry run \u2014 ${candidates.length} collab(s) would be purged. Nothing deleted.`
+        );
+      }
+      return empty(0, classifications, protectedSkipped);
+    }
+    if (opts.yes !== true) {
+      if (!isTTY) {
+        log(
+          `Refusing to delete ${candidates.length} collab(s) without confirmation. Re-run with --yes.`
+        );
+        return empty(1, classifications, protectedSkipped, true);
+      }
+      const ok = await confirm(`Delete these ${candidates.length} collab(s)?`);
+      if (!ok) {
+        log("Aborted. Nothing deleted.");
+        return empty(0, classifications, protectedSkipped, true);
+      }
+    }
+    const purged = [];
+    const skippedWentLive = [];
+    const skippedError = [];
+    const cascade = opts.deleteCascade ?? deleteCollabCascade;
+    const purgeOne = db.transaction((collabId) => {
+      if (isCollabLive(db, collabId, isAlive)) return false;
+      cascade(db, collabId);
+      return true;
+    });
+    for (const cand of candidates) {
+      try {
+        const deleted = purgeOne.immediate(cand.collabId);
+        if (deleted) {
+          purged.push(cand.collabId);
+          if (cand.tmuxSession) killTmux(cand.tmuxSession);
+        } else {
+          skippedWentLive.push(cand.collabId);
+        }
+      } catch (err) {
+        skippedError.push({
+          collabId: cand.collabId,
+          error: err.message
+        });
+      }
+    }
+    if (opts.json) {
+      log(
+        JSON.stringify(
+          buildJsonPayload(
+            classifications,
+            purged,
+            skippedWentLive,
+            skippedError,
+            protectedSkipped,
+            false
+          ),
+          null,
+          2
+        )
+      );
+    } else {
+      log(
+        `Purged ${purged.length}, skipped (went live) ${skippedWentLive.length}, errors ${skippedError.length}, protected ${protectedSkipped.length}.`
+      );
+    }
+    return {
+      classifications,
+      purged,
+      skippedWentLive,
+      skippedError,
+      protectedSkipped,
+      aborted: false,
+      exitCode: skippedError.length > 0 ? 1 : 0
+    };
+  } finally {
+    db.close();
+  }
+}
+
 // src/commands/collab/tell.ts
 init_dist2();
 init_dist();
@@ -18049,7 +18398,7 @@ async function runCollabTell(input) {
 }
 
 // src/runtime/launcher.ts
-import { execSync as execSync3, spawn as nodeSpawn2 } from "node:child_process";
+import { execSync as execSync4, spawn as nodeSpawn2 } from "node:child_process";
 import { dirname as dirname8, resolve as resolve4 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 var __dirname = dirname8(fileURLToPath5(import.meta.url));
@@ -18060,7 +18409,7 @@ function shellQuote(value) {
 }
 function detectTmux() {
   try {
-    execSync3("which tmux", { stdio: "ignore" });
+    execSync4("which tmux", { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -18103,7 +18452,7 @@ function defaultSpawn(command) {
   return child.pid;
 }
 function defaultExec(command) {
-  execSync3(command, { stdio: "inherit" });
+  execSync4(command, { stdio: "inherit" });
 }
 function wrapForTerminalWindow(agentCommand, label) {
   if (process.platform === "darwin") {
@@ -18323,6 +18672,53 @@ async function runWorkflowTypes() {
   return listWorkflowTypes();
 }
 
+// src/commands/workflow/stats.ts
+init_relay_view_state();
+function runWorkflowStats(deps) {
+  const stats = deps.broker.control.getHandsOffStats();
+  const out = deps.stdout ?? process.stdout;
+  if (deps.json) {
+    const payload = {
+      totalMs: stats.totalMs,
+      totalHuman: fmtDurCoarse(stats.totalMs),
+      count: stats.count,
+      since: stats.earliestKickoffAt,
+      byStatus: {
+        done: {
+          count: stats.byStatus.done.count,
+          totalMs: stats.byStatus.done.totalMs,
+          human: fmtDurCoarse(stats.byStatus.done.totalMs)
+        },
+        halted: {
+          count: stats.byStatus.halted.count,
+          totalMs: stats.byStatus.halted.totalMs,
+          human: fmtDurCoarse(stats.byStatus.halted.totalMs)
+        }
+      },
+      skipped: stats.skipped
+    };
+    out.write(`${JSON.stringify(payload, null, 2)}
+`);
+    return;
+  }
+  if (stats.count === 0) {
+    out.write("Hands-off time saved: 0m (no completed workflows yet)\n");
+    return;
+  }
+  const since = (stats.earliestKickoffAt ?? "").slice(0, 10);
+  out.write(
+    `Hands-off time saved: ${fmtDurCoarse(stats.totalMs)}  (${stats.count} workflows, since ${since})
+`
+  );
+  for (const status of ["done", "halted"]) {
+    const b = stats.byStatus[status];
+    out.write(
+      `  ${status.padEnd(9)}${b.count} runs \xB7 ${fmtDurCoarse(b.totalMs)}
+`
+    );
+  }
+}
+
 // src/commands/skill/install.ts
 import { cp, mkdir, readdir, stat } from "node:fs/promises";
 import path3 from "node:path";
@@ -18548,9 +18944,7 @@ function createCli() {
         launch
       });
     }
-    console.log(
-      `Collab started: ${r.collabId} (launch: ${launchMode})`
-    );
+    console.log(`Collab started: ${r.collabId} (launch: ${launchMode})`);
     if (launchMode === "none") {
       console.log("Collab started (no-launch mode).");
     }
@@ -18563,7 +18957,10 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       );
     }
   });
-  collab.command("status").description("Show current collaboration status").option("--collab <id>", "Inspect a specific collab id (defaults to the active collab for cwd)").option("--json", "Emit machine-readable JSON instead of text").action((opts) => {
+  collab.command("status").description("Show current collaboration status").option(
+    "--collab <id>",
+    "Inspect a specific collab id (defaults to the active collab for cwd)"
+  ).option("--json", "Emit machine-readable JSON instead of text").action((opts) => {
     const output = runCollabStatus({
       cwd: process.cwd(),
       ...opts.collab ? { collabIdOverride: opts.collab } : {},
@@ -18571,7 +18968,13 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     });
     console.log(output);
   });
-  collab.command("tell").description("Send an instruction to an agent").requiredOption("--target <agent>", "Target agent: codex, claude, ezio, or agy").option("--collab <id>", "Send to a specific collab id (defaults to the active collab for cwd)").option("--action <action>", "Explicit requested action").option(
+  collab.command("tell").description("Send an instruction to an agent").requiredOption(
+    "--target <agent>",
+    "Target agent: codex, claude, ezio, or agy"
+  ).option(
+    "--collab <id>",
+    "Send to a specific collab id (defaults to the active collab for cwd)"
+  ).option("--action <action>", "Explicit requested action").option(
     "--artifact <path>",
     "Artifact file path. Repeat for multiple files.",
     collectArtifact,
@@ -18600,7 +19003,10 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       console.log("No work items to process.");
     }
   });
-  collab.command("recover").description("Recover the current workspace collab after broker loss").option("--collab <id>", "Recover a specific collab id (defaults to the active collab for cwd)").option(
+  collab.command("recover").description("Recover the current workspace collab after broker loss").option(
+    "--collab <id>",
+    "Recover a specific collab id (defaults to the active collab for cwd)"
+  ).option(
     "--port <port>",
     "Explicit port to bind for the recovered daemon",
     (v) => Number.parseInt(v, 10)
@@ -18624,18 +19030,30 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       `Collab recovered: ${result.collabId} (pid ${result.pid}, port ${result.port})`
     );
   });
-  collab.command("reconnect").description("Reconnect a remembered role after broker recovery (mount mode)").argument("<agent>", "Target agent: codex, claude, ezio, or agy").option("--workspace <path>", "Workspace root", process.cwd()).option("--collab <id>", "Target a specific collab id (defaults to the active collab for cwd)").action(async (target, opts) => {
-    await runCollabReconnect({
-      workspaceRoot: opts.workspace,
-      ...opts.collab ? { collabIdOverride: opts.collab } : {},
-      target,
-      now: (/* @__PURE__ */ new Date()).toISOString()
-    });
-  });
-  collab.command("mount").description("Mount the current terminal as the managed session surface for a role").argument("<agent>", "Target agent: codex, claude, ezio, or agy").argument(
+  collab.command("reconnect").description(
+    "Reconnect a remembered role after broker recovery (mount mode)"
+  ).argument("<agent>", "Target agent: codex, claude, ezio, or agy").option("--workspace <path>", "Workspace root", process.cwd()).option(
+    "--collab <id>",
+    "Target a specific collab id (defaults to the active collab for cwd)"
+  ).action(
+    async (target, opts) => {
+      await runCollabReconnect({
+        workspaceRoot: opts.workspace,
+        ...opts.collab ? { collabIdOverride: opts.collab } : {},
+        target,
+        now: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  );
+  collab.command("mount").description(
+    "Mount the current terminal as the managed session surface for a role"
+  ).argument("<agent>", "Target agent: codex, claude, ezio, or agy").argument(
     "[passthroughArgs...]",
     "Args forwarded after `--` to the agent binary spawn (e.g. `mount codex -- --full-auto`)"
-  ).option("--workspace <path>", "Workspace root", process.cwd()).option("--collab <id>", "Target a specific collab id (defaults to the active collab for cwd)").option(
+  ).option("--workspace <path>", "Workspace root", process.cwd()).option(
+    "--collab <id>",
+    "Target a specific collab id (defaults to the active collab for cwd)"
+  ).option(
     "--turn-events <providers>",
     "Scope the push turn-completion event path to the given providers (comma-separated providers with turn-end hooks: claude,codex,agy), or disable it with `off`/`none` to revert to pure clipboard capture. Overrides AI_WHISPER_TURN_EVENTS. Default: on (claude,codex,agy)."
   ).action(
@@ -18650,7 +19068,10 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       });
     }
   );
-  collab.command("inspect").description("Inspect the active collab thread").option("--collab <id>", "Inspect a specific collab id (defaults to the active collab for cwd)").option("--watch", "Continuously redraw the active-thread operator view").option(
+  collab.command("inspect").description("Inspect the active collab thread").option(
+    "--collab <id>",
+    "Inspect a specific collab id (defaults to the active collab for cwd)"
+  ).option("--watch", "Continuously redraw the active-thread operator view").option(
     "--captures [chainId]",
     "Show recent capture-diagnostics rows. Pass a chain id to filter, or 'all' for the full history."
   ).option(
@@ -18673,13 +19094,20 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       }
     }
   );
-  collab.command("relay-monitor").description("Run the relay monitor in the current terminal (renders the relay conversation stream)").option("--collab <id>", "Monitor a specific collab id (defaults to the active collab for cwd)").action(async (opts) => {
+  collab.command("relay-monitor").description(
+    "Run the relay monitor in the current terminal (renders the relay conversation stream)"
+  ).option(
+    "--collab <id>",
+    "Monitor a specific collab id (defaults to the active collab for cwd)"
+  ).action(async (opts) => {
     await runCollabRelayMonitor({
       cwd: process.cwd(),
       ...opts.collab ? { collabIdOverride: opts.collab } : {}
     });
   });
-  collab.command("dashboard").description("Full-screen dashboard: live wall of recently-active runs + per-run inspector").option(
+  collab.command("dashboard").description(
+    "Full-screen dashboard: live wall of recently-active runs + per-run inspector"
+  ).option(
     "--window <duration>",
     "Eligible-collab activity window. Accepts ms or Ns/Nm/Nh/Nd (e.g. 45s, 30m, 2h, 1d), or 'all' for no limit. Default: 30m."
   ).option(
@@ -18716,7 +19144,7 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
         },
         execCommand: (cmd) => {
           try {
-            execSync4(cmd, { stdio: "ignore" });
+            execSync5(cmd, { stdio: "ignore" });
           } catch {
           }
         }
@@ -18736,10 +19164,43 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       throw err;
     }
   });
+  collab.command("purge").description("Remove stale collabs (no live process) across all workspaces").option("--dry-run", "Classify and print only; never prompt or delete").option("-y, --yes", "Skip the confirmation prompt and delete").option(
+    "--force",
+    "Also purge collabs with a non-terminal (resumable) workflow"
+  ).option("--collab <id>", "Limit the sweep to a single collab id").option("--workspace <path>", "Limit the sweep to a single workspace root").option("--json", "Emit machine-readable JSON instead of the table").action(
+    async (opts) => {
+      if (opts.collab && opts.workspace) {
+        console.error("--collab and --workspace are mutually exclusive.");
+        process.exitCode = 1;
+        return;
+      }
+      const result = await runCollabPurge({
+        cwd: process.cwd(),
+        ...opts.dryRun ? { dryRun: opts.dryRun } : {},
+        ...opts.yes ? { yes: opts.yes } : {},
+        ...opts.force ? { force: opts.force } : {},
+        ...opts.json ? { json: opts.json } : {},
+        ...opts.collab ? { collabId: opts.collab } : {},
+        ...opts.workspace ? { workspace: opts.workspace } : {}
+      });
+      process.exitCode = result.exitCode;
+    }
+  );
   const workflow = cli.command("workflow").description("Manage AI agent workflows");
-  workflow.command("start").description("Start a new workflow").requiredOption("--type <type>", "Workflow type (e.g. spec-driven-development)").requiredOption("--spec <path>", "Spec file path").option("--implementer <agent>", "Implementer agent: claude, codex, ezio, or agy (defaults to the workflow type's defaultImplementer)").option("--reviewer <agent>", "Reviewer agent: claude, codex, ezio, or agy (defaults to the workflow type's defaultReviewer)").option("--name <name>", "Optional workflow display name").option("--workspace <path>", "Workspace root", process.cwd()).action(
+  workflow.command("start").description("Start a new workflow").requiredOption(
+    "--type <type>",
+    "Workflow type (e.g. spec-driven-development)"
+  ).requiredOption("--spec <path>", "Spec file path").option(
+    "--implementer <agent>",
+    "Implementer agent: claude, codex, ezio, or agy (defaults to the workflow type's defaultImplementer)"
+  ).option(
+    "--reviewer <agent>",
+    "Reviewer agent: claude, codex, ezio, or agy (defaults to the workflow type's defaultReviewer)"
+  ).option("--name <name>", "Optional workflow display name").option("--workspace <path>", "Workspace root", process.cwd()).action(
     async (opts) => {
-      const { broker, collabId } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+      const { broker, collabId } = await connectToWorkspaceBroker({
+        cwd: opts.workspace
+      });
       try {
         const result = await runWorkflowStart({
           broker,
@@ -18760,7 +19221,9 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     }
   );
   workflow.command("list").description("List workflows for the active collab").option("--workspace <path>", "Workspace root", process.cwd()).action(async (opts) => {
-    const { broker, collabId } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+    const { broker, collabId } = await connectToWorkspaceBroker({
+      cwd: opts.workspace
+    });
     try {
       const list = runWorkflowList({ broker, collabId });
       if (list.length === 0) {
@@ -18775,7 +19238,9 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     }
   });
   workflow.command("inspect").description("Inspect a workflow and its phase runs").argument("<workflowId>", "Workflow ID").option("--workspace <path>", "Workspace root", process.cwd()).action(async (workflowId, opts) => {
-    const { broker } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+    const { broker } = await connectToWorkspaceBroker({
+      cwd: opts.workspace
+    });
     try {
       const result = await runWorkflowInspect({ broker, workflowId });
       console.log(JSON.stringify(result, null, 2));
@@ -18784,17 +19249,28 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     }
   });
   workflow.command("pause").description("Pause a running workflow").argument("<workflowId>", "Workflow ID").option("--workspace <path>", "Workspace root", process.cwd()).action(async (workflowId, opts) => {
-    const { broker } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+    const { broker } = await connectToWorkspaceBroker({
+      cwd: opts.workspace
+    });
     try {
-      await runWorkflowPause({ broker, workflowId, now: (/* @__PURE__ */ new Date()).toISOString() });
+      await runWorkflowPause({
+        broker,
+        workflowId,
+        now: (/* @__PURE__ */ new Date()).toISOString()
+      });
       console.log(`Workflow paused: ${workflowId}`);
     } finally {
       await broker.stop();
     }
   });
-  workflow.command("resume").description("Resume a paused or halted workflow").argument("<workflowId>", "Workflow ID").option("--workspace <path>", "Workspace root", process.cwd()).option("--message <note>", "Operator note delivered to the agents on resume").action(
+  workflow.command("resume").description("Resume a paused or halted workflow").argument("<workflowId>", "Workflow ID").option("--workspace <path>", "Workspace root", process.cwd()).option(
+    "--message <note>",
+    "Operator note delivered to the agents on resume"
+  ).action(
     async (workflowId, opts) => {
-      const { broker } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+      const { broker } = await connectToWorkspaceBroker({
+        cwd: opts.workspace
+      });
       try {
         await runWorkflowResume({
           broker,
@@ -18809,9 +19285,15 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     }
   );
   workflow.command("cancel").description("Cancel a running or halted workflow").argument("<workflowId>", "Workflow ID").option("--workspace <path>", "Workspace root", process.cwd()).action(async (workflowId, opts) => {
-    const { broker } = await connectToWorkspaceBroker({ cwd: opts.workspace });
+    const { broker } = await connectToWorkspaceBroker({
+      cwd: opts.workspace
+    });
     try {
-      await runWorkflowCancel({ broker, workflowId, now: (/* @__PURE__ */ new Date()).toISOString() });
+      await runWorkflowCancel({
+        broker,
+        workflowId,
+        now: (/* @__PURE__ */ new Date()).toISOString()
+      });
       console.log(`Workflow canceled: ${workflowId}`);
     } finally {
       await broker.stop();
@@ -18823,22 +19305,37 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
       console.log(t);
     }
   });
+  workflow.command("stats").description(
+    "Show accumulated hands-off time saved across all workflows (global, all-time)"
+  ).option("--json", "Output raw JSON instead of the human summary").action(async (opts) => {
+    const sqlitePath = getSharedSqlitePath();
+    const broker = createBrokerRuntime({
+      sqlitePath,
+      runWorkflowDriver: false,
+      runDiagnosticsSweep: false,
+      runDaemonHeartbeat: false,
+      runBrokerDaemonSweep: false
+    });
+    try {
+      runWorkflowStats({ broker, json: opts.json ?? false });
+    } finally {
+      await broker.stop();
+    }
+  });
   const skill = cli.command("skill").description("Manage bundled agent skills");
   skill.command("install").description(
     "Install the bundled ai-whisper skills into your agent skill directories"
   ).addOption(
     new Option("--target <target>", "Agent install target").choices(["claude", "codex", "ezio", "agy", "all"]).default("all")
-  ).option("--force", "Overwrite existing skill destinations").action(
-    async (opts) => {
-      const result = await runSkillInstall({
-        target: opts.target,
-        ...opts.force ? { force: true } : {}
-      });
-      for (const p of result.installedAt) {
-        console.log(`Installed: ${p}`);
-      }
+  ).option("--force", "Overwrite existing skill destinations").action(async (opts) => {
+    const result = await runSkillInstall({
+      target: opts.target,
+      ...opts.force ? { force: true } : {}
+    });
+    for (const p of result.installedAt) {
+      console.log(`Installed: ${p}`);
     }
-  );
+  });
   cli.command("env").description(
     "Print machine-readable engine/integration facts for external supervisors"
   ).option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-whisper",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Terminal-first relay for paired AI coding agents (Claude + Codex), driven by structured workflows.",
   "license": "Apache-2.0",
   "repository": {
@@ -52,13 +52,13 @@
     "@types/better-sqlite3": "^7.6.12",
     "@types/react": "^19.2.14",
     "ink-testing-library": "^4.0.0",
+    "@ai-whisper/adapter-ai-ezio": "0.0.0",
+    "@ai-whisper/adapter-claude": "0.0.0",
     "@ai-whisper/adapter-antigravity": "0.0.0",
     "@ai-whisper/adapter-codex": "0.0.0",
-    "@ai-whisper/adapter-claude": "0.0.0",
-    "@ai-whisper/adapter-ai-ezio": "0.0.0",
     "@ai-whisper/broker": "0.0.0",
-    "@ai-whisper/companion-core": "0.0.0",
-    "@ai-whisper/shared": "0.0.0"
+    "@ai-whisper/shared": "0.0.0",
+    "@ai-whisper/companion-core": "0.0.0"
   },
   "files": [
     "dist",