squadrant 0.16.5 → 0.17.0

package/dist/index.js

@@ -205,6 +205,14 @@ var init_control = __esm({
   }
 });
 
+// packages/shared/dist/types/work.js
+var TERMINAL_WORK_STATES;
+var init_work = __esm({
+  "packages/shared/dist/types/work.js"() {
+    TERMINAL_WORK_STATES = /* @__PURE__ */ new Set(["done", "cancelled"]);
+  }
+});
+
 // packages/shared/dist/types/projection.js
 var init_projection = __esm({
   "packages/shared/dist/types/projection.js"() {
@@ -226,22 +234,22 @@ function defaultCmuxConfigPath() {
   return join(homedir(), ".config", "cmux", "cmux.json");
 }
 function ensureSocketAutomation(opts = {}) {
-  const path30 = opts.path ?? defaultCmuxConfigPath();
-  if (!existsSync(path30)) {
-    mkdirSync(dirname(path30), { recursive: true });
-    writeFileSync(path30, MINIMAL_TEMPLATE);
-    return { path: path30, changed: true, alreadySet: false };
+  const path34 = opts.path ?? defaultCmuxConfigPath();
+  if (!existsSync(path34)) {
+    mkdirSync(dirname(path34), { recursive: true });
+    writeFileSync(path34, MINIMAL_TEMPLATE);
+    return { path: path34, changed: true, alreadySet: false };
   }
-  const text = readFileSync(path30, "utf-8");
+  const text = readFileSync(path34, "utf-8");
   const current = parse(text)?.automation?.socketControlMode;
   if (current === AUTOMATION_MODE) {
-    return { path: path30, changed: false, alreadySet: true };
+    return { path: path34, changed: false, alreadySet: true };
   }
   const edits = modify(text, [...SOCKET_CONTROL_MODE_PATH], AUTOMATION_MODE, {
     formattingOptions: { insertSpaces: true, tabSize: 2 }
   });
-  writeFileSync(path30, applyEdits(text, edits));
-  return { path: path30, changed: true, alreadySet: false };
+  writeFileSync(path34, applyEdits(text, edits));
+  return { path: path34, changed: true, alreadySet: false };
 }
 var SOCKET_CONTROL_MODE_PATH, AUTOMATION_MODE, MINIMAL_TEMPLATE;
 var init_cmux_config = __esm({
@@ -394,9 +402,9 @@ import { dirname as dirname2, join as join4 } from "path";
 function defaultStatePath() {
   return join4(homedir3(), ".config", "squadrant", "state", "cmux-autoconfig.json");
 }
-function readState(path30) {
+function readState(path34) {
   try {
-    return JSON.parse(readFileSync4(path30, "utf-8"));
+    return JSON.parse(readFileSync4(path34, "utf-8"));
   } catch {
     return {};
   }
@@ -644,8 +652,8 @@ function formatUpdateNotice(latest, current) {
   return `\u2B06 squadrant ${latest} available (you have ${current}) \u2014 npm i -g squadrant@latest`;
 }
 async function fetchLatestVersion(requestFn = requestJson, timeoutMs = FETCH_TIMEOUT_MS) {
-  const timeout = new Promise((resolve3) => {
-    const timer = setTimeout(() => resolve3(null), timeoutMs);
+  const timeout = new Promise((resolve4) => {
+    const timer = setTimeout(() => resolve4(null), timeoutMs);
     timer.unref?.();
   });
   const request = (async () => {
@@ -717,11 +725,11 @@ var init_update_check = __esm({
     CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
     FAILURE_RETRY_MS = 60 * 60 * 1e3;
     FETCH_TIMEOUT_MS = 1500;
-    requestJson = (url, timeoutMs) => new Promise((resolve3) => {
+    requestJson = (url, timeoutMs) => new Promise((resolve4) => {
       const req = https.get(url, { headers: { "user-agent": "squadrant-update-check" } }, (res) => {
         if (res.statusCode !== 200) {
           res.resume();
-          resolve3(null);
+          resolve4(null);
           return;
         }
         let body = "";
@@ -729,15 +737,15 @@ var init_update_check = __esm({
         res.on("data", (chunk) => body += chunk);
         res.on("end", () => {
           try {
-            resolve3(JSON.parse(body));
+            resolve4(JSON.parse(body));
           } catch {
-            resolve3(null);
+            resolve4(null);
           }
         });
       });
       req.on("socket", (socket) => socket.unref());
       req.setTimeout(timeoutMs, () => req.destroy());
-      req.on("error", () => resolve3(null));
+      req.on("error", () => resolve4(null));
     });
   }
 });
@@ -929,6 +937,22 @@ function mirrorFlat(src, dest, match, chmod) {
     }
   }
 }
+function mirrorPluginSubset(src, dest, skills) {
+  fs6.mkdirSync(dest, { recursive: true });
+  mirrorDir(path5.join(src, ".claude-plugin"), path5.join(dest, ".claude-plugin"));
+  const skillsDest = path5.join(dest, "skills");
+  fs6.mkdirSync(skillsDest, { recursive: true });
+  for (const name of skills) {
+    const skillSrc = path5.join(src, "skills", name);
+    if (fs6.existsSync(skillSrc))
+      mirrorDir(skillSrc, path5.join(skillsDest, name));
+  }
+  for (const entry of fs6.readdirSync(skillsDest, { withFileTypes: true })) {
+    if (!skills.includes(entry.name)) {
+      fs6.rmSync(path5.join(skillsDest, entry.name), { recursive: true, force: true });
+    }
+  }
+}
 function ensureRuntimeSynced(opts) {
   const targets = opts.targets ?? MANAGED_TARGETS;
   for (const t of targets) {
@@ -939,8 +963,10 @@ function ensureRuntimeSynced(opts) {
       const destDir = path5.join(opts.runtimeRoot, t.name);
       if (t.mode === "tree") {
         mirrorDir(srcDir, destDir);
-      } else {
+      } else if (t.mode === "flat") {
         mirrorFlat(srcDir, destDir, t.match, t.chmod);
+      } else {
+        mirrorPluginSubset(srcDir, destDir, t.skills);
       }
     } catch (err) {
       process.stderr.write(`squadrant: runtime sync skipped for ${t.name}: ${err.message}
@@ -948,11 +974,13 @@ function ensureRuntimeSynced(opts) {
     }
   }
 }
-var MANAGED_TARGETS;
+var CREW_SKILLS, MANAGED_TARGETS;
 var init_runtime_sync = __esm({
   "packages/shared/dist/lib/runtime-sync.js"() {
+    CREW_SKILLS = ["karpathy-principles"];
     MANAGED_TARGETS = [
       { name: "plugin", srcRel: "plugin", mode: "tree" },
+      { name: "plugin-crew", srcRel: "plugin", mode: "subset", skills: CREW_SKILLS },
       { name: "scripts", srcRel: "scripts", mode: "flat", match: /\.sh$/, chmod: 493 },
       {
         name: "templates",
@@ -1209,6 +1237,7 @@ var init_daemon_keys = __esm({
 var dist_exports = {};
 __export(dist_exports, {
   AUTOMATION_MODE: () => AUTOMATION_MODE,
+  CREW_SKILLS: () => CREW_SKILLS,
   DEFAULT_CONFIG_PATH: () => DEFAULT_CONFIG_PATH,
   DEFAULT_NOTIFY: () => DEFAULT_NOTIFY,
   MANAGED_TARGETS: () => MANAGED_TARGETS,
@@ -1216,6 +1245,7 @@ __export(dist_exports, {
   SOCKET_CONTROL_MODE_PATH: () => SOCKET_CONTROL_MODE_PATH,
   SPOKE_SUBDIRS: () => SPOKE_SUBDIRS,
   TERMINAL_STATES: () => TERMINAL_STATES,
+  TERMINAL_WORK_STATES: () => TERMINAL_WORK_STATES,
   UPDATE_CHECK_STATE_PATH: () => UPDATE_CHECK_STATE_PATH,
   addWorktree: () => addWorktree,
   applySafeFixes: () => applySafeFixes,
@@ -1283,6 +1313,7 @@ var init_dist = __esm({
     init_runtime();
     init_liveness();
     init_control();
+    init_work();
     init_projection();
     init_workspaces();
     init_cmux_autoconfig();
@@ -1323,6 +1354,11 @@ function nextPendingTool(current, ev, now) {
     return void 0;
   return current;
 }
+function nextPendingMonitor(current, ev, now) {
+  if (ev.note === "agent.hook.PreToolUse" && ev.tool === "Monitor")
+    return { since: now };
+  return current;
+}
 function reduce(rec, ev, now) {
   if (ev.type === "task.reopened") {
     return { ...rec, state: "working", question: void 0, error: void 0, lastHeartbeat: now, lastEvent: ev.type };
@@ -1339,14 +1375,17 @@ function reduce(rec, ev, now) {
         sessionId: ev.sessionId ?? rec.sessionId,
         question: void 0,
         // resuming after a blocked→reply clears the question
-        pendingTool: void 0
+        pendingTool: void 0,
         // #354: a new turn closes any prior tool window
+        pendingMonitor: void 0
+        // #594a: same reset — a new turn moots any prior watch
       };
     case "task.progress": {
       const pendingTool = nextPendingTool(rec.pendingTool, ev, now);
+      const pendingMonitor = nextPendingMonitor(rec.pendingMonitor, ev, now);
       if (isStickyAttention(rec.state))
-        return { ...rec, lastHeartbeat: now, lastEvent: ev.type, pendingTool };
-      const b = { ...base, pendingTool };
+        return { ...rec, lastHeartbeat: now, lastEvent: ev.type, pendingTool, pendingMonitor };
+      const b = { ...base, pendingTool, pendingMonitor };
       if (rec.state === "awaiting-input" || rec.state === "stalled")
         return { ...stampAttempt(b, {}, now), state: "working" };
       return stampAttempt(b, {}, now);
@@ -1360,9 +1399,9 @@ function reduce(rec, ev, now) {
     case "task.blocked":
       if (rec.state === "blocked")
         return { ...rec, lastHeartbeat: now, lastEvent: ev.type };
-      return { ...base, state: "blocked", question: ev.question, pendingTool: void 0 };
+      return { ...base, state: "blocked", question: ev.question, pendingTool: void 0, pendingMonitor: void 0 };
     case "task.review":
-      return { ...base, state: "review", reviewNote: ev.message, pendingTool: void 0 };
+      return { ...base, state: "review", reviewNote: ev.message, pendingTool: void 0, pendingMonitor: void 0 };
     case "task.done":
       if (rec.state === "review" && ev.source !== "approve") {
         return { ...rec, lastHeartbeat: now, lastEvent: ev.type };
@@ -1377,19 +1416,19 @@ function reduce(rec, ev, now) {
     case "task.session":
       return stampAttempt(base, { resumeRef: ev.resumeRef }, now);
     case "task.turn.started":
-      return { ...stampAttempt(base, {}, now), state: "working", pendingTool: void 0 };
+      return { ...stampAttempt(base, {}, now), state: "working", pendingTool: void 0, pendingMonitor: void 0 };
     case "task.turn.completed":
       if (isStickyAttention(rec.state))
         return { ...rec, lastHeartbeat: now, lastEvent: ev.type };
-      if (rec.pendingTool)
+      if (rec.pendingTool || rec.pendingMonitor)
         return stampAttempt(base, {}, now);
-      return { ...stampAttempt(base, {}, now), state: "awaiting-input", pendingTool: void 0 };
+      return { ...stampAttempt(base, {}, now), state: "awaiting-input", pendingTool: void 0, pendingMonitor: void 0 };
     case "task.delta":
       return stampAttempt(base, {}, now);
     // heartbeat-only
     case "task.input.requested":
     case "task.approval.requested":
-      return { ...stampAttempt(base, {}, now), state: "blocked", question: ev.question, pendingTool: void 0 };
+      return { ...stampAttempt(base, {}, now), state: "blocked", question: ev.question, pendingTool: void 0, pendingMonitor: void 0 };
     case "task.reattached":
       return stampAttempt(base, {}, now);
     case "task.first-turn.confirmed":
@@ -1414,15 +1453,21 @@ var init_state_machine = __esm({
 });
 
 // packages/core/dist/watchdog.js
-function evaluateStall(rec, now, toolStallMs = TOOL_STALL_BUDGET_MS) {
+function evaluateStall(rec, now, toolStallMs = TOOL_STALL_BUDGET_MS, monitorStallMs = MONITOR_STALL_BUDGET_MS) {
   if (rec.state !== "working")
     return null;
   if (rec.mode === "interactive") {
-    if (!rec.pendingTool)
-      return null;
-    if (now - rec.pendingTool.since <= toolStallMs)
-      return null;
-    return { ...rec, state: "stalled", lastEvent: "watchdog.tool-stall" };
+    if (rec.pendingTool) {
+      if (now - rec.pendingTool.since <= toolStallMs)
+        return null;
+      return { ...rec, state: "stalled", lastEvent: "watchdog.tool-stall" };
+    }
+    if (rec.pendingMonitor) {
+      if (now - rec.pendingMonitor.since <= monitorStallMs)
+        return null;
+      return { ...rec, state: "stalled", lastEvent: "watchdog.monitor-stall" };
+    }
+    return null;
   }
   const liveness = rec.attempts.at(-1)?.lastHeartbeatAt ?? rec.lastHeartbeat;
   if (now - liveness <= rec.heartbeatBudgetMs)
@@ -1432,12 +1477,13 @@ function evaluateStall(rec, now, toolStallMs = TOOL_STALL_BUDGET_MS) {
 function recoverStall(rec, now) {
   if (rec.state !== "stalled")
     return null;
-  return { ...rec, state: "working", lastHeartbeat: now, lastEvent: "watchdog.recover", pendingTool: void 0 };
+  return { ...rec, state: "working", lastHeartbeat: now, lastEvent: "watchdog.recover", pendingTool: void 0, pendingMonitor: void 0 };
 }
-var TOOL_STALL_BUDGET_MS;
+var TOOL_STALL_BUDGET_MS, MONITOR_STALL_BUDGET_MS;
 var init_watchdog = __esm({
   "packages/core/dist/watchdog.js"() {
     TOOL_STALL_BUDGET_MS = 10 * 60 * 1e3;
+    MONITOR_STALL_BUDGET_MS = 60 * 60 * 1e3;
   }
 });
 
@@ -1711,7 +1757,7 @@ function createDaemon(deps) {
           store.delete(r.project, r.id);
           continue;
         }
-        if (!TERMINAL_STATES.has(r.state)) {
+        if (!TERMINAL_STATES.has(r.state) && !isStickyAttention(r.state)) {
           const ceiling = deps.taskTimeoutMs ?? DEFAULT_TASK_TIMEOUT_MS;
           if (t - r.createdAt > ceiling) {
             const prevState = r.state;
@@ -1756,7 +1802,7 @@ function createDaemon(deps) {
         const idle = evaluateStall(r, t);
         if (idle) {
           store.put(idle);
-          const synthEvent = idle.pendingTool ? { type: "task.stalled", id: r.id, heartbeatBudgetMs: r.heartbeatBudgetMs, tool: idle.pendingTool.name, elapsedMs: t - idle.pendingTool.since } : { type: "task.stalled", id: r.id, heartbeatBudgetMs: r.heartbeatBudgetMs };
+          const synthEvent = idle.pendingTool ? { type: "task.stalled", id: r.id, heartbeatBudgetMs: r.heartbeatBudgetMs, tool: idle.pendingTool.name, elapsedMs: t - idle.pendingTool.since } : idle.pendingMonitor ? { type: "task.stalled", id: r.id, heartbeatBudgetMs: r.heartbeatBudgetMs, tool: "Monitor", elapsedMs: t - idle.pendingMonitor.since } : { type: "task.stalled", id: r.id, heartbeatBudgetMs: r.heartbeatBudgetMs };
           firePush(deps, r.project, r.state, idle, synthEvent, lastCaptainTurnAt.get(r.id));
           continue;
         }
@@ -2251,9 +2297,9 @@ function startServer(sockPath, handlerOrCallbacks, onListenError = defaultListen
   return server;
 }
 function isDaemonSocketLive(sockPath, timeoutMs = 500) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     if (!existsSync5(sockPath)) {
-      resolve3(false);
+      resolve4(false);
       return;
     }
     const conn = createConnection(sockPath);
@@ -2262,7 +2308,7 @@ function isDaemonSocketLive(sockPath, timeoutMs = 500) {
         conn.destroy();
       } catch {
       }
-      resolve3(v);
+      resolve4(v);
     };
     const timer = setTimeout(() => finish(false), timeoutMs);
     conn.on("connect", () => {
@@ -2276,7 +2322,7 @@ function isDaemonSocketLive(sockPath, timeoutMs = 500) {
   });
 }
 function sendRequest(sockPath, msg, timeoutMs = 5e3) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const conn = createConnection(sockPath);
     const dec = createDecoder();
     const timer = setTimeout(() => {
@@ -2292,7 +2338,7 @@ function sendRequest(sockPath, msg, timeoutMs = 5e3) {
         if (m._v !== void 0 && m._v !== PROTOCOL_VERSION) {
           reject(new Error(`squadrantd protocol v${m._v}, this client expects v${PROTOCOL_VERSION} \u2014 upgrade squadrantd or this CLI`));
         } else if (m.ok) {
-          resolve3(m.reply);
+          resolve4(m.reply);
         } else {
           reject(new Error(m.error));
         }
@@ -2512,6 +2558,151 @@ var init_store = __esm({
   }
 });
 
+// packages/core/dist/work-store.js
+import { homedir as homedir4 } from "os";
+import { join as join7, resolve as resolve2, sep as sep2 } from "path";
+import { randomBytes } from "crypto";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, readdirSync as readdirSync2, renameSync as renameSync2, writeFileSync as writeFileSync5, existsSync as existsSync7, rmSync as rmSync4, statSync as statSync2 } from "fs";
+function defaultWorkRoot() {
+  return join7(homedir4(), ".config", "squadrant", "work");
+}
+function safeSegment2(kind, s) {
+  if (typeof s !== "string" || s.length === 0) {
+    throw new Error(`invalid ${kind}: must be a non-empty string`);
+  }
+  if (s.includes("\0"))
+    throw new Error(`invalid ${kind}: NUL byte not allowed`);
+  if (s === "." || s === ".." || /[/\\]/.test(s)) {
+    throw new Error(`invalid ${kind}: '${s}' \u2014 path separators/traversal not allowed`);
+  }
+  return s;
+}
+function createWorkStore(root = defaultWorkRoot()) {
+  const rootResolved = resolve2(root);
+  const assertUnderRoot = (target) => {
+    const r = resolve2(target);
+    if (r !== rootResolved && !r.startsWith(rootResolved + sep2)) {
+      throw new Error(`path escapes state root: ${target}`);
+    }
+    return target;
+  };
+  const projDir = (p) => assertUnderRoot(join7(root, safeSegment2("project", p)));
+  const itemFile = (p, id) => assertUnderRoot(join7(projDir(p), `${safeSegment2("id", id)}.json`));
+  return {
+    put(item) {
+      mkdirSync4(projDir(item.project), { recursive: true });
+      const dest = itemFile(item.project, item.id);
+      const tmp = `${dest}.tmp`;
+      writeFileSync5(tmp, JSON.stringify(item, null, 2));
+      renameSync2(tmp, dest);
+    },
+    get(project, id) {
+      const f = itemFile(project, id);
+      if (!existsSync7(f))
+        return void 0;
+      try {
+        return JSON.parse(readFileSync6(f, "utf-8"));
+      } catch {
+        return void 0;
+      }
+    },
+    list(project) {
+      const d = projDir(project);
+      if (!existsSync7(d))
+        return [];
+      return readdirSync2(d).filter((n) => n.endsWith(".json") && !n.endsWith(".json.tmp")).map((n) => {
+        try {
+          return JSON.parse(readFileSync6(join7(d, n), "utf-8"));
+        } catch {
+          return void 0;
+        }
+      }).filter((r) => r !== void 0);
+    },
+    listAll() {
+      if (!existsSync7(root))
+        return [];
+      return readdirSync2(root).filter((p) => {
+        try {
+          return statSync2(join7(root, p)).isDirectory();
+        } catch {
+          return false;
+        }
+      }).flatMap((p) => this.list(p));
+    },
+    delete(project, id) {
+      const f = itemFile(project, id);
+      if (existsSync7(f))
+        rmSync4(f);
+    }
+  };
+}
+function purgeExpiredWorkItems(store, now = Date.now()) {
+  let purged = 0;
+  for (const item of store.listAll()) {
+    if (item.closedAt !== null && now - item.closedAt > WORK_ITEM_TTL_MS) {
+      store.delete(item.project, item.id);
+      purged++;
+    }
+  }
+  return purged;
+}
+function generateWorkId(store) {
+  const existing = new Set(store.listAll().map((i) => i.id));
+  for (let attempt = 0; attempt < 20; attempt++) {
+    const id = `w_${randomBytes(2).toString("hex")}`;
+    if (!existing.has(id))
+      return id;
+  }
+  throw new Error("could not generate a unique work item id");
+}
+function createWorkItem(store, opts) {
+  const now = opts.now ?? Date.now();
+  const item = {
+    id: generateWorkId(store),
+    project: opts.project,
+    title: opts.title,
+    state: "working",
+    parent: opts.parent ?? null,
+    tags: opts.tags ?? [],
+    note: "",
+    crewTaskIds: [],
+    issue: null,
+    createdAt: now,
+    updatedAt: now,
+    closedAt: null
+  };
+  store.put(item);
+  return item;
+}
+function findWorkItemById(store, id) {
+  return store.listAll().find((i) => i.id === id);
+}
+function findOpenChildren(store, id) {
+  return store.listAll().filter((i) => i.parent === id && !TERMINAL_WORK_STATES.has(i.state));
+}
+function closeWorkItem(store, id, state, opts = {}) {
+  const item = findWorkItemById(store, id);
+  if (!item)
+    return void 0;
+  const now = opts.now ?? Date.now();
+  const updated = {
+    ...item,
+    state,
+    note: opts.note ?? item.note,
+    updatedAt: now,
+    closedAt: now
+  };
+  store.put(updated);
+  return updated;
+}
+var WORK_ITEM_TTL_MS;
+var init_work_store = __esm({
+  "packages/core/dist/work-store.js"() {
+    init_dist();
+    WORK_ITEM_TTL_MS = 30 * 24 * 60 * 60 * 1e3;
+  }
+});
+
 // packages/core/dist/snapshot.js
 var snapshot_exports = {};
 __export(snapshot_exports, {
@@ -2565,16 +2756,16 @@ var init_snapshot = __esm({
 
 // packages/core/dist/launchd.js
 import { execFileSync as execFileSync3 } from "child_process";
-import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync5, readFileSync as readFileSync6, existsSync as existsSync7, openSync, writeSync, closeSync, unlinkSync as unlinkSync2, constants } from "fs";
-import { homedir as homedir4 } from "os";
-import { dirname as dirname3, join as join7 } from "path";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync6, readFileSync as readFileSync7, existsSync as existsSync8, openSync, writeSync, closeSync, unlinkSync as unlinkSync2, constants } from "fs";
+import { homedir as homedir5 } from "os";
+import { dirname as dirname3, join as join8 } from "path";
 import { fileURLToPath } from "url";
 function plistPath() {
-  return join7(homedir4(), "Library", "LaunchAgents", `${LABEL}.plist`);
+  return join8(homedir5(), "Library", "LaunchAgents", `${LABEL}.plist`);
 }
 function daemonEntryPath() {
-  const p = join7(dirname3(fileURLToPath(import.meta.url)), "squadrantd.js");
-  if (!existsSync7(p)) {
+  const p = join8(dirname3(fileURLToPath(import.meta.url)), "squadrantd.js");
+  if (!existsSync8(p)) {
     throw new Error(`daemonEntryPath: compiled entry not found at '${p}'; run 'npm run build' \u2014 a src-tree or missing path in the launchd plist causes a MODULE_NOT_FOUND crash-loop (#259)`);
   }
   return p;
@@ -2582,10 +2773,10 @@ function daemonEntryPath() {
 function xmlEscape(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function sanitizePathForPlist(path30) {
+function sanitizePathForPlist(path34) {
   const seen = /* @__PURE__ */ new Set();
   const stable = [];
-  for (const p of path30.split(":")) {
+  for (const p of path34.split(":")) {
     if (!p)
       continue;
     if (p.includes("/.claude/plugins/"))
@@ -2631,7 +2822,7 @@ function buildDaemonPath(shellPath) {
   }).join(":");
 }
 function renderPlist(nodeBin, daemonEntry, pathEnv = "") {
-  const logPath2 = join7(homedir4(), ".config", "squadrant", "squadrantd.log");
+  const logPath2 = join8(homedir5(), ".config", "squadrant", "squadrantd.log");
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -2660,13 +2851,13 @@ function _resetRestartInFlightForTest() {
   restartInFlight = false;
 }
 function daemonLockPath() {
-  return join7(homedir4(), ".config", "squadrant", "daemon.lock");
+  return join8(homedir5(), ".config", "squadrant", "daemon.lock");
 }
 function tryAcquireDaemonLock() {
   const lp = daemonLockPath();
-  if (existsSync7(lp)) {
+  if (existsSync8(lp)) {
     try {
-      const pid = parseInt(readFileSync6(lp, "utf-8").trim(), 10);
+      const pid = parseInt(readFileSync7(lp, "utf-8").trim(), 10);
       if (!Number.isFinite(pid) || pid <= 0) {
         unlinkSync2(lp);
       } else {
@@ -2699,37 +2890,57 @@ function releaseDaemonLock() {
   } catch {
   }
 }
-function ensureDaemon(nodeBin = process.execPath) {
+function computeDaemonDrift(nodeBin) {
+  const p = plistPath();
+  const entry = daemonEntryPath();
+  const desired = renderPlist(nodeBin, entry, buildDaemonPath(process.env.PATH ?? ""));
+  const current = existsSync8(p) ? readFileSync7(p, "utf-8") : null;
+  const uid = process.getuid?.() ?? 0;
+  const target = `gui/${uid}/${LABEL}`;
+  const changed = current !== desired;
+  const programChanged = current !== null && changed && !current.includes(programArgsBlock(nodeBin, entry));
+  return { plistPath: p, target, desired, current, changed, programChanged };
+}
+function applyDaemonDrift(drift) {
+  if (drift.changed) {
+    mkdirSync5(dirname3(drift.plistPath), { recursive: true });
+    writeFileSync6(drift.plistPath, drift.desired);
+  }
+  if (drift.programChanged) {
+    try {
+      execFileSync3("launchctl", ["bootout", drift.target], { stdio: "ignore" });
+    } catch {
+    }
+  }
+  const uid = process.getuid?.() ?? 0;
+  try {
+    execFileSync3("launchctl", ["bootstrap", `gui/${uid}`, drift.plistPath], { stdio: "ignore" });
+  } catch {
+  }
+  execFileSync3("launchctl", ["kickstart", drift.target], { stdio: "ignore" });
+}
+function isOperatorInitiatedCommand(topLevelArg) {
+  return topLevelArg !== void 0 && OPERATOR_INITIATED_COMMANDS.has(topLevelArg);
+}
+function ensureDaemon(nodeBin = process.execPath, opts = {}) {
   if (restartInFlight)
     return;
   restartInFlight = true;
+  const authorized = process.env.SQUADRANT_ROLE === "captain" || opts.operatorInitiated === true;
+  if (!authorized) {
+    try {
+      if (computeDaemonDrift(nodeBin).changed) {
+        process.stderr.write("[squadrant] note: this machine's registered squadrant daemon config is out of date for the version/PATH running right now (common right after an `npm update -g squadrant`) \u2014 NOT applying it automatically because this command isn't the captain and isn't `launch`/`init`. This is usually harmless: the next captain command reconciles it on its own. If something looks stale or broken right now, run `squadrant heal daemon` to fix it immediately.\n");
+      }
+    } catch {
+    }
+    return;
+  }
   if (!tryAcquireDaemonLock()) {
     return;
   }
   try {
-    const p = plistPath();
-    const entry = daemonEntryPath();
-    const desired = renderPlist(nodeBin, entry, buildDaemonPath(process.env.PATH ?? ""));
-    const current = existsSync7(p) ? readFileSync6(p, "utf-8") : null;
-    const uid = process.getuid?.() ?? 0;
-    const target = `gui/${uid}/${LABEL}`;
-    const changed = current !== desired;
-    const programChanged = current !== null && changed && !current.includes(programArgsBlock(nodeBin, entry));
-    if (changed) {
-      mkdirSync4(dirname3(p), { recursive: true });
-      writeFileSync5(p, desired);
-    }
-    if (programChanged) {
-      try {
-        execFileSync3("launchctl", ["bootout", target], { stdio: "ignore" });
-      } catch {
-      }
-    }
-    try {
-      execFileSync3("launchctl", ["bootstrap", `gui/${uid}`, p], { stdio: "ignore" });
-    } catch {
-    }
-    execFileSync3("launchctl", ["kickstart", target], { stdio: "ignore" });
+    applyDaemonDrift(computeDaemonDrift(nodeBin));
   } catch (e) {
     process.stderr.write(`[squadrant] warn: ensureDaemon failed (${e instanceof Error ? e.message : e})
 `);
@@ -2737,12 +2948,22 @@ function ensureDaemon(nodeBin = process.execPath) {
     releaseDaemonLock();
   }
 }
-var LABEL, AGENT_BINS, restartInFlight;
+function reregisterDaemon(nodeBin = process.execPath) {
+  if (!tryAcquireDaemonLock())
+    return;
+  try {
+    applyDaemonDrift(computeDaemonDrift(nodeBin));
+  } finally {
+    releaseDaemonLock();
+  }
+}
+var LABEL, AGENT_BINS, restartInFlight, OPERATOR_INITIATED_COMMANDS;
 var init_launchd = __esm({
   "packages/core/dist/launchd.js"() {
     LABEL = "com.squadrant.daemon";
     AGENT_BINS = ["cmux", "claude", "opencode", "codex", "gemini", "node"];
     restartInFlight = false;
+    OPERATOR_INITIATED_COMMANDS = /* @__PURE__ */ new Set(["launch", "init"]);
   }
 });
 
@@ -2890,7 +3111,7 @@ var init_gate = __esm({
 });
 
 // packages/core/dist/daemon/liveness-registry.js
-import { writeFileSync as writeFileSync6, readFileSync as readFileSync7, renameSync as renameSync2 } from "fs";
+import { writeFileSync as writeFileSync7, readFileSync as readFileSync8, renameSync as renameSync3 } from "fs";
 var LivenessRegistry;
 var init_liveness_registry = __esm({
   "packages/core/dist/daemon/liveness-registry.js"() {
@@ -2904,14 +3125,14 @@ var init_liveness_registry = __esm({
         this.path = opts.path;
         this.readFile = opts.readFile ?? ((p) => {
           try {
-            return readFileSync7(p, "utf-8");
+            return readFileSync8(p, "utf-8");
           } catch {
             return void 0;
           }
         });
         this.writeFile = opts.writeFile ?? ((p, c) => {
-          writeFileSync6(`${p}.tmp`, c);
-          renameSync2(`${p}.tmp`, p);
+          writeFileSync7(`${p}.tmp`, c);
+          renameSync3(`${p}.tmp`, p);
         });
       }
       load() {
@@ -2960,10 +3181,10 @@ var init_liveness_registry = __esm({
 });
 
 // packages/core/dist/daemon/context.js
-import { homedir as homedir5 } from "os";
-import { join as join8 } from "path";
+import { homedir as homedir6 } from "os";
+import { join as join9 } from "path";
 import { spawn as realSpawn } from "child_process";
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync5 } from "fs";
+import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync6 } from "fs";
 function defaultIsPidAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -2973,18 +3194,18 @@ function defaultIsPidAlive(pid) {
   }
 }
 function buildContext(opts) {
-  const stateRoot = opts.stateRoot ?? join8(homedir5(), ".config", "squadrant", "state");
-  const sockPath = opts.sockPath ?? join8(homedir5(), ".config", "squadrant", "squadrant.sock");
+  const stateRoot = opts.stateRoot ?? join9(homedir6(), ".config", "squadrant", "state");
+  const sockPath = opts.sockPath ?? join9(homedir6(), ".config", "squadrant", "squadrant.sock");
   const store = createStore(stateRoot);
   const bootedAt = Date.now();
   const taskTimeoutMs = loadConfig().defaults.taskTimeoutMs;
   const isPidAlive = opts.isPidAlive ?? defaultIsPidAlive;
   const spawn2 = opts.spawn ?? realSpawn;
-  const resultsDir = join8(stateRoot, "_results");
-  mkdirSync5(resultsDir, { recursive: true });
+  const resultsDir = join9(stateRoot, "_results");
+  mkdirSync6(resultsDir, { recursive: true });
   const writeResult = (id, payload) => {
-    const p = join8(resultsDir, `${id}.txt`);
-    writeFileSync7(p, payload);
+    const p = join9(resultsDir, `${id}.txt`);
+    writeFileSync8(p, payload);
     return p;
   };
   const log = (m) => process.stderr.write(`[squadrantd] ${(/* @__PURE__ */ new Date()).toISOString()} ${m}
@@ -3006,7 +3227,7 @@ function buildContext(opts) {
     inFlightHeadlessIds: /* @__PURE__ */ new Set(),
     activeHeadlessKills: /* @__PURE__ */ new Set(),
     livenessRegistry: (() => {
-      const r = new LivenessRegistry({ path: join8(stateRoot, "liveness.json") });
+      const r = new LivenessRegistry({ path: join9(stateRoot, "liveness.json") });
       r.load();
       return r;
     })(),
@@ -3319,9 +3540,11 @@ var init_defer_delivery = __esm({
   "packages/core/dist/delivery/defer-delivery.js"() {
     DeferDelivery = class extends Error {
       draft;
-      constructor(draft = null) {
+      reason;
+      constructor(draft = null, reason = "draft") {
         super("deferred: captain composing");
         this.draft = draft;
+        this.reason = reason;
         this.name = "DeferDelivery";
       }
     };
@@ -3345,6 +3568,7 @@ var init_captain_delivery = __esm({
       deferCounts = /* @__PURE__ */ new Map();
       lastContent = /* @__PURE__ */ new Map();
       stableCounts = /* @__PURE__ */ new Map();
+      lastReason = /* @__PURE__ */ new Map();
       constructor(opts) {
         this.opts = opts;
       }
@@ -3367,29 +3591,40 @@ var init_captain_delivery = __esm({
           this.deferCounts.delete(seq);
           this.stableCounts.delete(seq);
           this.lastContent.delete(seq);
+          this.lastReason.delete(seq);
           return { delivered: true };
         } catch (e) {
           if (e instanceof DeferDelivery) {
             this.deferCounts.set(seq, deferCount + 1);
             const content = e.draft;
+            let stableCount;
             if (content && content === this.lastContent.get(seq)) {
-              this.stableCounts.set(seq, (this.stableCounts.get(seq) ?? 0) + 1);
+              stableCount = (this.stableCounts.get(seq) ?? 0) + 1;
+              this.stableCounts.set(seq, stableCount);
             } else {
+              stableCount = 0;
               this.stableCounts.set(seq, 0);
             }
             this.lastContent.set(seq, content);
-            return { deferred: true };
+            const reason = e.reason !== "draft" ? e.reason : stableCount >= this.opts.stableProbePolls ? "stable" : "draft";
+            this.lastReason.set(seq, reason);
+            return { deferred: true, reason };
           }
-          return { deferred: true };
+          this.lastReason.set(seq, "unknown");
+          return { deferred: true, reason: "unknown" };
         }
       }
       /** Read-only. Never mutates — safe to poll from the snapshot assembler every tick. */
       stats() {
         let maxDeferCount = 0;
-        for (const c of this.deferCounts.values())
-          if (c > maxDeferCount)
+        let reason;
+        for (const [seq, c] of this.deferCounts) {
+          if (c > maxDeferCount) {
             maxDeferCount = c;
-        return { maxDeferCount, stuck: maxDeferCount >= this.opts.maxDefers };
+            reason = this.lastReason.get(seq);
+          }
+        }
+        return { maxDeferCount, stuck: maxDeferCount >= this.opts.maxDefers, reason };
       }
     };
   }
@@ -3489,6 +3724,10 @@ function createDelivery(ctx, daemonCmux) {
   const notifyFault = ctx.notifyFault ?? (() => {
   });
   const defaultNotify = async (args) => {
+    const fresh = store.get(args.project, args.record.id);
+    if (fresh && TERMINAL_STATES.has(fresh.state) && fresh.state !== args.record.state) {
+      return;
+    }
     try {
       await appendToMailbox({
         stateRoot,
@@ -3578,16 +3817,19 @@ function createDelivery(ctx, daemonCmux) {
           log(`delivery seq=${entry.seq} kind=${entry.kind} outcome=delivered`);
           await writeCursor({ stateRoot, project, subscriber: CURSOR_SUBSCRIBER, lastAckedSeq: entry.seq });
         } else {
-          log(`delivery seq=${entry.seq} kind=${entry.kind} outcome=deferred`);
+          const { maxDeferCount } = d.stats();
+          if (maxDeferCount === 1 || maxDeferCount % 30 === 0) {
+            log(`delivery seq=${entry.seq} kind=${entry.kind} outcome=deferred project=${project} reason=${result.reason}`);
+          }
           break;
         }
       }
       const stuck = d.stats().stuck;
       if (stuck && !stuckNotified.has(project)) {
         stuckNotified.add(project);
-        const { maxDeferCount } = d.stats();
-        log(`delivery stuck project=${project} deferCount=${maxDeferCount}`);
-        const text = `\u26A0\uFE0F DELIVERY STUCK: an in-progress draft (or ghost text) in your input box has blocked pending notification(s) for ${maxDeferCount}+ retries. Your input is never touched \u2014 this keeps retrying safely and will deliver automatically once you submit or clear it.`;
+        const { maxDeferCount, reason } = d.stats();
+        log(`delivery stuck project=${project} deferCount=${maxDeferCount} reason=${reason ?? "unknown"}`);
+        const text = reason === "modal" ? `\u26A0\uFE0F DELIVERY STUCK: a modal question is open in your captain pane and has blocked pending notification(s) for ${maxDeferCount}+ retries. This keeps retrying safely and will deliver automatically once you answer or dismiss it.` : `\u26A0\uFE0F DELIVERY STUCK: an in-progress draft (or ghost text) in your input box has blocked pending notification(s) for ${maxDeferCount}+ retries. Your input is never touched \u2014 this keeps retrying safely and will deliver automatically once you submit or clear it.`;
         appendCaptainMessage({ stateRoot, project, text, source: "daemon" }).catch((e) => log(`delivery stuck alert failed project=${project}: ${e.message}`));
         Promise.resolve(notifyFault(project, text)).catch((e) => log(`delivery stuck fault-notify failed project=${project}: ${e.message}`));
         telegramBridge?.pushRaw(project, text);
@@ -3707,19 +3949,19 @@ var init_server = __esm({
 
 // packages/core/dist/daemon/snapshot-gather.js
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { join as join9 } from "path";
-import { statSync as statSync2, openSync as openSync2, readSync, closeSync as closeSync2, readdirSync as readdirSync2, readFileSync as readFileSync8 } from "fs";
+import { join as join10 } from "path";
+import { statSync as statSync3, openSync as openSync2, readSync, closeSync as closeSync2, readdirSync as readdirSync3, readFileSync as readFileSync9 } from "fs";
 function distBuiltAt() {
   try {
-    return statSync2(SELF_PATH).mtimeMs;
+    return statSync3(SELF_PATH).mtimeMs;
   } catch {
     return 0;
   }
 }
-function gatherLogStats(path30, now, windowMs) {
+function gatherLogStats(path34, now, windowMs) {
   let sizeBytes = 0;
   try {
-    sizeBytes = statSync2(path30).size;
+    sizeBytes = statSync3(path34).size;
   } catch {
     return { errorCount: 0, sizeBytes: 0, windowMs };
   }
@@ -3730,7 +3972,7 @@ function gatherLogStats(path30, now, windowMs) {
   const len = sizeBytes - start;
   let text = "";
   try {
-    const fd = openSync2(path30, "r");
+    const fd = openSync2(path34, "r");
     try {
       const buf = Buffer.alloc(len);
       readSync(fd, buf, 0, len, start);
@@ -3761,9 +4003,9 @@ function gatherStoreStats(store, stateRoot, project) {
   for (const r of store.list(project))
     byState[r.state] = (byState[r.state] ?? 0) + 1;
   let corruptCount = 0;
-  const dir = join9(stateRoot, project);
+  const dir = join10(stateRoot, project);
   try {
-    for (const n of readdirSync2(dir)) {
+    for (const n of readdirSync3(dir)) {
       if (n.includes(".corrupt.")) {
         corruptCount++;
         continue;
@@ -3771,7 +4013,7 @@ function gatherStoreStats(store, stateRoot, project) {
       if (!n.endsWith(".json"))
         continue;
       try {
-        JSON.parse(readFileSync8(join9(dir, n), "utf-8"));
+        JSON.parse(readFileSync9(join10(dir, n), "utf-8"));
       } catch {
         corruptCount++;
       }
@@ -3784,9 +4026,9 @@ function gatherResults(resultsDir) {
   let fileCount = 0;
   let totalBytes = 0;
   try {
-    for (const n of readdirSync2(resultsDir)) {
+    for (const n of readdirSync3(resultsDir)) {
       try {
-        const s = statSync2(join9(resultsDir, n));
+        const s = statSync3(join10(resultsDir, n));
         if (s.isFile()) {
           fileCount++;
           totalBytes += s.size;
@@ -3806,7 +4048,7 @@ var init_snapshot_gather = __esm({
 });
 
 // packages/core/dist/daemon/start.js
-import { join as join10, dirname as dirname4 } from "path";
+import { join as join11, dirname as dirname4 } from "path";
 import { readdir } from "fs/promises";
 function startDaemon(ctx, opts, pkgVersion) {
   const { stateRoot, store, log, isPidAlive, resultsDir, taskTimeoutMs, inFlightHeadlessIds, activeHeadlessKills, broadcast, cancelPromotionsFor } = ctx;
@@ -3881,7 +4123,7 @@ function startDaemon(ctx, opts, pkgVersion) {
     return out;
   }
   async function gatherSnapshotInputs(now) {
-    const logPath2 = join10(dirname4(stateRoot), "squadrantd.log");
+    const logPath2 = join11(dirname4(stateRoot), "squadrantd.log");
     const tier2Projects = opts.registeredProjects ?? Object.keys(loadConfig().projects);
     const projects = await Promise.all(tier2Projects.map(async (project) => {
       const cursor = await readCursor({ stateRoot, project, subscriber: CURSOR_SUBSCRIBER2 });
@@ -4015,7 +4257,7 @@ function startDaemon(ctx, opts, pkgVersion) {
   };
   let rotationTimer;
   if (rotationInterval > 0) {
-    const inboxPath = join10(stateRoot, "inbox");
+    const inboxPath = join11(stateRoot, "inbox");
     rotationTimer = setInterval(async () => {
       try {
         let entries;
@@ -4058,9 +4300,9 @@ function startDaemon(ctx, opts, pkgVersion) {
       }
       for (const kill of ctx.activeHeadlessKills)
         kill();
-      return new Promise((resolve3) => server.close(() => {
+      return new Promise((resolve4) => server.close(() => {
         log(`exit-complete pid=${process.pid}`);
-        resolve3();
+        resolve4();
       }));
     },
     tickDelivery: deliveryTick,
@@ -4211,8 +4453,8 @@ import { exec as nodeExec } from "child_process";
 async function reapCrewChildren(taskId, graceMs = 2e3, execFn = nodeExec) {
   const marker = `SQUADRANT_CREW_TASK_ID=${taskId}`;
   try {
-    const stdout = await new Promise((resolve3, reject) => {
-      execFn("ps auxE", { maxBuffer: 64 * 1024 * 1024 }, (err, out) => err ? reject(err) : resolve3(out));
+    const stdout = await new Promise((resolve4, reject) => {
+      execFn("ps auxE", { maxBuffer: 64 * 1024 * 1024 }, (err, out) => err ? reject(err) : resolve4(out));
     });
     const pids = [];
     for (const line of stdout.split("\n").slice(1)) {
@@ -4428,7 +4670,7 @@ function createIsCaptainAlive(sock) {
   };
 }
 function createLaunch(cliBin, log) {
-  return (project) => new Promise((resolve3, reject) => {
+  return (project) => new Promise((resolve4, reject) => {
     execFile(process.execPath, [cliBin, "launch", project, "--headless"], { timeout: 3e4 }, (err, stdout, stderr) => {
       const output = capOutput(stdout ?? "", stderr ?? "");
       if (err) {
@@ -4438,7 +4680,7 @@ function createLaunch(cliBin, log) {
       }
       if (output !== "(no output)")
         log?.(`launch ${project}: ${output}`);
-      resolve3();
+      resolve4();
     });
   });
 }
@@ -4586,10 +4828,10 @@ function findProjectByThread(stateRoot, threadId) {
   for (const [key, id] of Object.entries(s.topics)) {
     if (id !== threadId)
       continue;
-    const sep2 = key.indexOf("::");
-    if (sep2 === -1)
+    const sep3 = key.indexOf("::");
+    if (sep3 === -1)
       continue;
-    return { project: key.slice(0, sep2), scope: key.slice(sep2 + 2) };
+    return { project: key.slice(0, sep3), scope: key.slice(sep3 + 2) };
   }
   return null;
 }
@@ -5140,11 +5382,11 @@ var init_bridge = __esm({
 
 // packages/core/dist/restart-daemon.js
 import { execFileSync as execFileSync4 } from "child_process";
-import { existsSync as existsSync8 } from "fs";
-import { homedir as homedir6 } from "os";
-import { join as join11 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { homedir as homedir7 } from "os";
+import { join as join12 } from "path";
 function defaultIsRunning() {
-  return existsSync8(DEFAULT_SOCK_PATH);
+  return existsSync9(DEFAULT_SOCK_PATH);
 }
 function defaultRunKickstart() {
   const uid = process.getuid?.() ?? 0;
@@ -5174,7 +5416,7 @@ var DEFAULT_SOCK_PATH;
 var init_restart_daemon = __esm({
   "packages/core/dist/restart-daemon.js"() {
     init_launchd();
-    DEFAULT_SOCK_PATH = join11(homedir6(), ".config", "squadrant", "squadrant.sock");
+    DEFAULT_SOCK_PATH = join12(homedir7(), ".config", "squadrant", "squadrant.sock");
   }
 });
 
@@ -5274,8 +5516,8 @@ function runTelegramStatus(opts) {
   const env = opts.env ?? process.env;
   const tokenSet = !!(tg?.botToken ?? env.TELEGRAM_BOT_TOKEN);
   const links = Object.entries(loadState(opts.stateRoot).topics).map(([key, topicId]) => {
-    const sep2 = key.indexOf("::");
-    return { project: key.slice(0, sep2), scope: key.slice(sep2 + 2), topicId };
+    const sep3 = key.indexOf("::");
+    return { project: key.slice(0, sep3), scope: key.slice(sep3 + 2), topicId };
   });
   return { tokenSet, supergroupId: tg?.supergroupId ?? null, links };
 }
@@ -5299,8 +5541,8 @@ function runTelegramNotifyStatus(opts) {
   const s = loadState(opts.stateRoot);
   const projects = /* @__PURE__ */ new Set();
   for (const key of Object.keys(s.topics)) {
-    const sep2 = key.indexOf("::");
-    projects.add(sep2 === -1 ? key : key.slice(0, sep2));
+    const sep3 = key.indexOf("::");
+    projects.add(sep3 === -1 ? key : key.slice(0, sep3));
   }
   for (const p of Object.keys(s.notify))
     projects.add(p);
@@ -5398,8 +5640,8 @@ var init_crew_routing = __esm({
 
 // packages/core/dist/group-dispatch.js
 import { randomUUID as randomUUID3 } from "crypto";
-import { homedir as homedir7 } from "os";
-import { join as join12 } from "path";
+import { homedir as homedir8 } from "os";
+import { join as join13 } from "path";
 function resolveCurrentProject(config) {
   const cwd = process.cwd();
   for (const [name, proj] of Object.entries(config.projects)) {
@@ -5476,7 +5718,7 @@ var init_group_dispatch = __esm({
   "packages/core/dist/group-dispatch.js"() {
     init_dist();
     init_protocol();
-    DEFAULT_SOCK_PATH2 = join12(homedir7(), ".config", "squadrant", "squadrant.sock");
+    DEFAULT_SOCK_PATH2 = join13(homedir8(), ".config", "squadrant", "squadrant.sock");
     GROUP_DISPATCH_WARMUP_TIMEOUT_MS = 12e4;
     GROUP_DISPATCH_WARMUP_POLL_MS = 1e3;
   }
@@ -5557,7 +5799,8 @@ async function launchOneWorkspace(opts) {
       forceFresh = true;
     }
   }
-  const agentCmd = opts.agentCmdFactory(forceFresh);
+  const builtCmd = opts.agentCmdFactory(forceFresh);
+  const agentCmd = opts.role === "captain" ? `SQUADRANT_ROLE=captain ${builtCmd}` : builtCmd;
   recordSession(opts.workspaceName, opts.role, {
     sessionsPath: opts.sessionsPath,
     templatesDir: opts.templatesDir
@@ -6079,12 +6322,15 @@ __export(dist_exports2, {
   GROUP_DISPATCH_WARMUP_TIMEOUT_MS: () => GROUP_DISPATCH_WARMUP_TIMEOUT_MS,
   IDLE_DEBOUNCE_MS: () => IDLE_DEBOUNCE_MS,
   LABEL: () => LABEL,
+  MONITOR_STALL_BUDGET_MS: () => MONITOR_STALL_BUDGET_MS,
+  OPERATOR_INITIATED_COMMANDS: () => OPERATOR_INITIATED_COMMANDS,
   PROBE_QUIET_MS: () => PROBE_QUIET_MS,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
   STALE_THRESHOLD_MS: () => STALE_THRESHOLD_MS,
   TERMINAL_RECORD_KEEP_PER_PROJECT: () => TERMINAL_RECORD_KEEP_PER_PROJECT,
   TERMINAL_RECORD_TTL_MS: () => TERMINAL_RECORD_TTL_MS,
   TOOL_STALL_BUDGET_MS: () => TOOL_STALL_BUDGET_MS,
+  WORK_ITEM_TTL_MS: () => WORK_ITEM_TTL_MS,
   WRITABLE_CONFIG_KEYS: () => WRITABLE_CONFIG_KEYS,
   _resetRestartInFlightForTest: () => _resetRestartInFlightForTest,
   ageText: () => ageText,
@@ -6100,6 +6346,7 @@ __export(dist_exports2, {
   capAllowed: () => capAllowed,
   capOutput: () => capOutput,
   classifyHealth: () => classifyHealth,
+  closeWorkItem: () => closeWorkItem,
   computeTemplateHash: () => computeTemplateHash,
   createAttach: () => createAttach,
   createCrewPaneReader: () => createCrewPaneReader,
@@ -6117,6 +6364,8 @@ __export(dist_exports2, {
   createSurfaceLivenessProbe: () => createSurfaceLivenessProbe,
   createTelegramBridge: () => createTelegramBridge,
   createTelegramClient: () => createTelegramClient,
+  createWorkItem: () => createWorkItem,
+  createWorkStore: () => createWorkStore,
   crewPaneTitle: () => crewPaneTitle,
   crewTag: () => crewTag,
   daemonEntryPath: () => daemonEntryPath,
@@ -6124,6 +6373,7 @@ __export(dist_exports2, {
   decodeFrames: () => decodeFrames,
   defaultIsPidAlive: () => defaultIsPidAlive,
   defaultListenError: () => defaultListenError,
+  defaultWorkRoot: () => defaultWorkRoot,
   deliverStartupPrompt: () => deliverStartupPrompt,
   deliverable: () => deliverable,
   deriveCaptainState: () => deriveCaptainState,
@@ -6135,7 +6385,9 @@ __export(dist_exports2, {
   encodeMsg: () => encodeMsg,
   ensureDaemon: () => ensureDaemon,
   evaluateStall: () => evaluateStall,
+  findOpenChildren: () => findOpenChildren,
   findProjectByThread: () => findProjectByThread,
+  findWorkItemById: () => findWorkItemById,
   formatInbound: () => formatInbound,
   formatLifecycle: () => formatLifecycle,
   healCmdFor: () => healCmdFor,
@@ -6147,7 +6399,9 @@ __export(dist_exports2, {
   isCrewTitle: () => isCrewTitle,
   isDaemonSocketLive: () => isDaemonSocketLive,
   isNotifyActive: () => isNotifyActive,
+  isOperatorInitiatedCommand: () => isOperatorInitiatedCommand,
   isSideTitle: () => isSideTitle,
+  isStickyAttention: () => isStickyAttention,
   isTurnAccepted: () => isTurnAccepted,
   kickstartArgv: () => kickstartArgv,
   launchOneWorkspace: () => launchOneWorkspace,
@@ -6165,6 +6419,7 @@ __export(dist_exports2, {
   plistPath: () => plistPath,
   programArgsBlock: () => programArgsBlock,
   projectHealth: () => projectHealth,
+  purgeExpiredWorkItems: () => purgeExpiredWorkItems,
   readCursor: () => readCursor,
   readFromCursor: () => readFromCursor,
   reapCrewChildren: () => reapCrewChildren,
@@ -6176,6 +6431,7 @@ __export(dist_exports2, {
   reduceLifecycle: () => reduceLifecycle,
   releaseDaemonLock: () => releaseDaemonLock,
   renderPlist: () => renderPlist,
+  reregisterDaemon: () => reregisterDaemon,
   resolveAgentBinDirs: () => resolveAgentBinDirs,
   resolveCrewRoute: () => resolveCrewRoute,
   resolveCurrentProject: () => resolveCurrentProject,
@@ -6240,6 +6496,7 @@ var init_dist2 = __esm({
     init_liveness2();
     init_watchdog();
     init_store();
+    init_work_store();
     init_snapshot();
     init_launchd();
     init_crew_pane_reader();
@@ -6279,7 +6536,7 @@ function cmuxLocal(args) {
   }).trim();
 }
 function cmux(args) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     execFile2(
       resolveCmuxBin(),
       args,
@@ -6293,19 +6550,19 @@ function cmux(args) {
           reject(err.code === "ETIMEDOUT" ? new CmuxTimeoutError(args.join(" ")) : err);
           return;
         }
-        resolve3(stdout.trim());
+        resolve4(stdout.trim());
       }
     );
   });
 }
 function cmuxStdin(args, input) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const child = execFile2(resolveCmuxBin(), args, { encoding: "utf-8", timeout: CMUX_TIMEOUT, env: { ...process.env, CMUX_QUIET: "1" } }, (err, stdout) => {
       if (err) {
         reject(err.code === "ETIMEDOUT" ? new CmuxTimeoutError(args.join(" ")) : err);
         return;
       }
-      resolve3(stdout.trim());
+      resolve4(stdout.trim());
     });
     child.stdin.end(input);
   });
@@ -6666,9 +6923,9 @@ function createCmuxDriver() {
       }
       const draft = parseDraftFromScreen(screen);
       if (draft === null)
-        throw new DeferDelivery(null);
+        throw new DeferDelivery(null, "no-box");
       if (hasModalOptionList(screen))
-        throw new DeferDelivery(null);
+        throw new DeferDelivery(null, "modal");
       if (draft === "") {
         await deliver();
         return;
@@ -6912,7 +7169,7 @@ var init_notifiers = __esm({
 
 // packages/workspaces/dist/workspaces/obsidian.js
 import fs15 from "fs/promises";
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import path12 from "path";
 function resolveInRoot(root, relative) {
   const joined = path12.resolve(root, relative);
@@ -6932,7 +7189,7 @@ function createObsidianDriver(scope) {
     async probe() {
       return {
         installed: true,
-        rootExists: existsSync9(root)
+        rootExists: existsSync10(root)
       };
     },
     async read(rel) {
@@ -7087,12 +7344,12 @@ var init_events_bridge = __esm({
             continue;
           }
           this.child = child;
-          await new Promise((resolve3) => {
+          await new Promise((resolve4) => {
             let settled = false;
             const done = () => {
               if (!settled) {
                 settled = true;
-                resolve3();
+                resolve4();
               }
             };
             child.stdout?.on("data", (b) => this.onData(b));
@@ -7223,9 +7480,9 @@ var init_store_fingerprint = __esm({
 });
 
 // packages/workspaces/dist/cmux-daemon/daemon-cmux.js
-import { readdirSync as readdirSync3, readFileSync as readFileSync9 } from "fs";
-import { join as join13 } from "path";
-import { homedir as homedir8 } from "os";
+import { readdirSync as readdirSync4, readFileSync as readFileSync10 } from "fs";
+import { join as join14 } from "path";
+import { homedir as homedir9 } from "os";
 var DaemonCmux;
 var init_daemon_cmux = __esm({
   "packages/workspaces/dist/cmux-daemon/daemon-cmux.js"() {
@@ -7288,24 +7545,24 @@ var init_daemon_cmux = __esm({
        * file failed to read/parse — see the class doc above.
        */
       async liveness() {
-        const dir = process.env.CMUX_AGENT_HOOK_STATE_DIR ?? join13(homedir8(), ".cmuxterm");
+        const dir = process.env.CMUX_AGENT_HOOK_STATE_DIR ?? join14(homedir9(), ".cmuxterm");
         const projects = loadConfig().projects;
         let files;
         try {
-          files = readdirSync3(dir).filter((f) => f.endsWith("-hook-sessions.json") && !f.endsWith(".lock"));
+          files = readdirSync4(dir).filter((f) => f.endsWith("-hook-sessions.json") && !f.endsWith(".lock"));
         } catch (e) {
           throw new Error(`liveness: could not read cmux state dir ${dir}: ${e.message}`);
         }
-        return readLivenessSnapshot(files, (f) => readFileSync9(join13(dir, f), "utf-8"), projects);
+        return readLivenessSnapshot(files, (f) => readFileSync10(join14(dir, f), "utf-8"), projects);
       }
     };
   }
 });
 
 // packages/workspaces/dist/cmux-daemon/cmux-store-source.js
-import { join as join14 } from "path";
-import { homedir as homedir9 } from "os";
-import { watch, readdirSync as readdirSync4, readFileSync as readFileSync10, existsSync as existsSync10 } from "fs";
+import { join as join15 } from "path";
+import { homedir as homedir10 } from "os";
+import { watch, readdirSync as readdirSync5, readFileSync as readFileSync11, existsSync as existsSync11 } from "fs";
 function parseLifecycleState(s) {
   if (s === "running" || s === "idle" || s === "needsInput" || s === "unknown") {
     return s;
@@ -7322,14 +7579,14 @@ function defaultIsPidAlive2(pid) {
 }
 function defaultListFiles(dir) {
   try {
-    return readdirSync4(dir).filter((f) => f.endsWith("-hook-sessions.json") && !f.endsWith(".lock"));
+    return readdirSync5(dir).filter((f) => f.endsWith("-hook-sessions.json") && !f.endsWith(".lock"));
   } catch {
     return [];
   }
 }
-function defaultReadFile(path30) {
+function defaultReadFile(path34) {
   try {
-    return readFileSync10(path30, "utf-8");
+    return readFileSync11(path34, "utf-8");
   } catch {
     return void 0;
   }
@@ -7365,12 +7622,12 @@ var init_cmux_store_source = __esm({
       active = false;
       lastError = null;
       constructor(opts = {}) {
-        this.stateDir = opts.stateDir ?? process.env.CMUX_AGENT_HOOK_STATE_DIR ?? join14(homedir9(), ".cmuxterm");
+        this.stateDir = opts.stateDir ?? process.env.CMUX_AGENT_HOOK_STATE_DIR ?? join15(homedir10(), ".cmuxterm");
         this.debounceMs = opts.debounceMs ?? 50;
         this.isPidAlive = opts.isPidAlive ?? defaultIsPidAlive2;
         this.listFiles = opts.listFiles ?? defaultListFiles;
         this.readFile = opts.readFile ?? defaultReadFile;
-        this.fileExists = opts.fileExists ?? existsSync10;
+        this.fileExists = opts.fileExists ?? existsSync11;
         this.watchDir = opts.watchDir ?? defaultWatchDir;
         this.scheduleTimer = opts.scheduleTimer ?? setTimeout;
         this.cancelTimer = opts.cancelTimer ?? clearTimeout;
@@ -7427,7 +7684,7 @@ var init_cmux_store_source = __esm({
       }
       scanFile(filename) {
         const deps = this.deps;
-        const filePath = join14(this.stateDir, filename);
+        const filePath = join15(this.stateDir, filename);
         const lockPath = `${filePath}.lock`;
         if (this.fileExists(lockPath)) {
           this.log(`cmux-store: skipping ${filename} (locked)`);
@@ -7481,11 +7738,11 @@ var init_cmux_store_source = __esm({
 });
 
 // packages/workspaces/dist/native-hooks/native-hook-source.js
-import { join as join15 } from "path";
-import { homedir as homedir10 } from "os";
-import { mkdirSync as mkdirSync6, readFileSync as readFileSync11, writeFileSync as writeFileSync8 } from "fs";
+import { join as join16 } from "path";
+import { homedir as homedir11 } from "os";
+import { mkdirSync as mkdirSync7, readFileSync as readFileSync12, writeFileSync as writeFileSync9 } from "fs";
 function installClaudeHooks(opts = {}) {
-  const settingsPath = opts.settingsPath ?? join15(homedir10(), ".claude", "settings.json");
+  const settingsPath = opts.settingsPath ?? join16(homedir11(), ".claude", "settings.json");
   const hookCmd = opts.hookCmd ?? DEFAULT_HOOK_CMD;
   const readFile6 = opts.readFile ?? defaultReadFile2;
   const writeFile5 = opts.writeFile ?? defaultWriteFile;
@@ -7493,6 +7750,7 @@ function installClaudeHooks(opts = {}) {
   });
   let settings = {};
   const raw = readFile6(settingsPath);
+  const hadExistingSettings = raw !== void 0;
   if (raw) {
     try {
       settings = JSON.parse(raw);
@@ -7505,6 +7763,7 @@ function installClaudeHooks(opts = {}) {
   }
   const hooks = settings.hooks;
   let changed = false;
+  const repaired = [];
   for (const [eventName, sub, matcher] of CLAUDE_HOOK_EVENTS) {
     if (!Array.isArray(hooks[eventName])) {
       hooks[eventName] = [];
@@ -7516,6 +7775,26 @@ function installClaudeHooks(opts = {}) {
     if (!alreadyPresent) {
       entries.push({ matcher: hookMatcher, hooks: [{ type: "command", command, timeout: 10 }] });
       changed = true;
+      repaired.push(`${eventName}/${sub}`);
+    }
+  }
+  if (repaired.length > 0 && hadExistingSettings) {
+    log(`native-hook: repaired ${repaired.length} missing squadrant hook(s) in ${settingsPath} [${repaired.join(", ")}] \u2014 WARNING: blocked-signalling or lifecycle tracking may have been broken until this run`);
+  }
+  if (opts.claudeEnv && Object.keys(opts.claudeEnv).length > 0) {
+    if (typeof settings.env !== "object" || settings.env === null || Array.isArray(settings.env)) {
+      settings.env = {};
+    }
+    const env = settings.env;
+    for (const [key, value] of Object.entries(opts.claudeEnv)) {
+      if (key in env) {
+        if (env[key] !== value) {
+          log(`native-hook: claudeEnv key '${key}' already set to '${String(env[key])}' in ${settingsPath} \u2014 not overwriting with '${value}'`);
+        }
+        continue;
+      }
+      env[key] = value;
+      changed = true;
     }
   }
   if (changed) {
@@ -7557,16 +7836,16 @@ function extractDetail(sub, payload) {
   }
   return void 0;
 }
-function defaultReadFile2(path30) {
+function defaultReadFile2(path34) {
   try {
-    return readFileSync11(path30, "utf-8");
+    return readFileSync12(path34, "utf-8");
   } catch {
     return void 0;
   }
 }
-function defaultWriteFile(path30, content) {
-  mkdirSync6(path30.replace(/\/[^/]+$/, ""), { recursive: true });
-  writeFileSync8(path30, content, "utf-8");
+function defaultWriteFile(path34, content) {
+  mkdirSync7(path34.replace(/\/[^/]+$/, ""), { recursive: true });
+  writeFileSync9(path34, content, "utf-8");
 }
 var CLAUDE_HOOK_EVENTS, DEFAULT_HOOK_CMD, NativeHookSource;
 var init_native_hook_source = __esm({
@@ -7590,9 +7869,9 @@ var init_native_hook_source = __esm({
       cache = /* @__PURE__ */ new Map();
       active = false;
       constructor(opts = {}) {
-        this.hookInstall = opts.hookInstall ?? {};
         this.log = opts.log ?? (() => {
         });
+        this.hookInstall = { log: this.log, ...opts.hookInstall };
       }
       start(deps) {
         this.deps = deps;
@@ -7676,13 +7955,13 @@ async function settleInputBox(runtime, pane) {
   return sawContent;
 }
 function getFreePort() {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const srv = net.createServer();
     srv.once("error", reject);
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
       const port = typeof addr === "object" && addr ? addr.port : 0;
-      srv.close(() => port ? resolve3(port) : reject(new Error("no free port assigned")));
+      srv.close(() => port ? resolve4(port) : reject(new Error("no free port assigned")));
     });
   });
 }
@@ -7925,7 +8204,8 @@ function createClaudeDriver() {
       if (opts.settingsPath) {
         cmd += ` --settings ${opts.settingsPath}`;
       }
-      const pluginDir = `${process.env.HOME}/.config/squadrant/plugin`;
+      const pluginSubdir = opts.role === "crew" ? "plugin-crew" : "plugin";
+      const pluginDir = `${process.env.HOME}/.config/squadrant/${pluginSubdir}`;
       cmd += ` --plugin-dir ${pluginDir}`;
       if (!opts.interactive) {
         cmd += ` -p "${opts.prompt.replace(/"/g, '\\"')}"`;
@@ -8347,8 +8627,8 @@ ${MARKER_END}
   const startIdx = existing.indexOf(MARKER_START);
   const endIdx = existing.indexOf(MARKER_END);
   if (startIdx === -1 && endIdx === -1) {
-    const sep2 = existing.endsWith("\n") ? "\n" : "\n\n";
-    return `${existing}${sep2}${block}`;
+    const sep3 = existing.endsWith("\n") ? "\n" : "\n\n";
+    return `${existing}${sep3}${block}`;
   }
   if (startIdx === -1 || endIdx === -1) {
     throw new Error(`Corrupted squadrant markers \u2014 found only ${startIdx === -1 ? "end" : "start"} marker. Remove the stray marker or delete the file and re-run projection emit.`);
@@ -8679,8 +8959,8 @@ var init_app_server_client = __esm({
         const info = this.opts.clientInfo ?? { name: "squadrant", version: "0" };
         const id = this.nextId++;
         const env = { jsonrpc: "2.0", id, method: "initialize", params: { clientInfo: info } };
-        const res = await new Promise((resolve3, reject) => {
-          this.pending.set(id, { resolve: resolve3, reject });
+        const res = await new Promise((resolve4, reject) => {
+          this.pending.set(id, { resolve: resolve4, reject });
           this.proc.stdin.write(JSON.stringify(env) + "\n");
         });
         this.proc.stdin.write(JSON.stringify({ jsonrpc: "2.0", method: "initialized" }) + "\n");
@@ -8713,13 +8993,13 @@ var init_app_server_client = __esm({
         const turnId = ack?.turn?.id;
         if (typeof turnId !== "string")
           throw new Error(`turn/start: unexpected ack shape (no turn.id): ${JSON.stringify(ack).slice(0, 200)}`);
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           const onNote = (n) => {
             if (n.params?.turn?.id !== turnId)
               return;
             if (n.method === "turn/completed") {
               cleanup();
-              resolve3({ turnId });
+              resolve4({ turnId });
             }
             if (n.method === "turn/failed") {
               cleanup();
@@ -8770,8 +9050,8 @@ var init_app_server_client = __esm({
           throw new Error("AppServerClient not started");
         const id = this.nextId++;
         const env = { jsonrpc: "2.0", id, method, params: params ?? {} };
-        return new Promise((resolve3, reject) => {
-          this.pending.set(id, { resolve: resolve3, reject });
+        return new Promise((resolve4, reject) => {
+          this.pending.set(id, { resolve: resolve4, reject });
           this.proc.stdin.write(JSON.stringify(env) + "\n");
         });
       }
@@ -8903,11 +9183,11 @@ var init_codex_app_server_source = __esm({
 
 // packages/agents/dist/codex/config.js
 import { readFile as readFile5 } from "fs/promises";
-import { homedir as homedir12 } from "os";
-import { join as join17 } from "path";
+import { homedir as homedir13 } from "os";
+import { join as join18 } from "path";
 async function resolveCodexModel() {
-  const home = process.env["CODEX_HOME"] ?? join17(homedir12(), ".codex");
-  const configPath = join17(home, "config.toml");
+  const home = process.env["CODEX_HOME"] ?? join18(homedir13(), ".codex");
+  const configPath = join18(home, "config.toml");
   let text;
   try {
     text = await readFile5(configPath, "utf8");
@@ -9022,11 +9302,11 @@ function buildCodexDeveloperInstructions(rec) {
 ${directive}` : directive;
 }
 function withTimeout(p, ms, msg) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const t = setTimeout(() => reject(new Error(msg)), ms);
     p.then((v) => {
       clearTimeout(t);
-      resolve3(v);
+      resolve4(v);
     }, (e) => {
       clearTimeout(t);
       reject(e);
@@ -9428,9 +9708,9 @@ var init_sse_bridge = __esm({
 
 // packages/agents/dist/interactive/claude.js
 import { execSync as execSync7 } from "child_process";
-import { readFileSync as readFileSync12 } from "fs";
-import { homedir as homedir13 } from "os";
-import { join as join18 } from "path";
+import { readFileSync as readFileSync13 } from "fs";
+import { homedir as homedir14 } from "os";
+import { join as join19 } from "path";
 function probeClaudeSettingsFlag() {
   try {
     const help = execSync7("claude --help", { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
@@ -9488,11 +9768,11 @@ function deriveTranscriptPath(sessionId, cwd) {
   if (!sessionId || !cwd)
     return null;
   const escaped = cwd.replace(/[^a-zA-Z0-9]/g, "-");
-  return join18(homedir13(), ".claude", "projects", escaped, `${sessionId}.jsonl`);
+  return join19(homedir14(), ".claude", "projects", escaped, `${sessionId}.jsonl`);
 }
 function readLastAssistantText(transcriptPath) {
   try {
-    const raw = readFileSync12(transcriptPath, "utf-8");
+    const raw = readFileSync13(transcriptPath, "utf-8");
     const lines = raw.split(/\r?\n/);
     for (let i = lines.length - 1; i >= 0; i--) {
       const line = lines[i].trim();
@@ -9534,8 +9814,8 @@ function resolveLastAssistantText(payload) {
   const derived = deriveTranscriptPath(p?.session_id, cwd);
   if (derived)
     candidates.push(derived);
-  for (const path30 of candidates) {
-    const text = readLastAssistantText(path30);
+  for (const path34 of candidates) {
+    const text = readLastAssistantText(path34);
     if (text != null)
       return text;
   }
@@ -9885,14 +10165,14 @@ function runHeadless(opts) {
     if (err.length > ERR_CAP)
       err = err.slice(err.length - ERR_CAP);
   });
-  const result = new Promise((resolve3) => {
+  const result = new Promise((resolve4) => {
     child.once("error", (e) => {
       if (debounceTimer) {
         clearTimeout(debounceTimer);
         debounceTimer = null;
       }
       opts.emit({ type: "task.failed", id: opts.id, error: `spawn error: ${e.message}`, exitCode: void 0 });
-      resolve3();
+      resolve4();
     });
     child.on("close", (code) => {
       if (chunksSinceProgress > 0)
@@ -9909,7 +10189,7 @@ function runHeadless(opts) {
         const ref = opts.writeResult ? opts.writeResult(opts.id, res.payload ?? "") : "";
         opts.emit({ type: "task.done", id: opts.id, resultRef: ref, parseWarning: res.parseWarning });
       }
-      resolve3();
+      resolve4();
     });
   });
   return { result, kill: () => child.kill("SIGTERM") };
@@ -9989,8 +10269,8 @@ var require_daemon_exports = {};
 __export(require_daemon_exports, {
   requireDaemon: () => requireDaemon
 });
-import { join as join24 } from "path";
-import { homedir as homedir19 } from "os";
+import { join as join25 } from "path";
+import { homedir as homedir20 } from "os";
 async function requireDaemon(sockPath = DEFAULT_SOCK_PATH3) {
   const isLive = await isDaemonSocketLive(sockPath);
   if (!isLive) {
@@ -10001,18 +10281,18 @@ var DEFAULT_SOCK_PATH3;
 var init_require_daemon = __esm({
   "packages/cli/src/lib/require-daemon.ts"() {
     init_dist2();
-    DEFAULT_SOCK_PATH3 = join24(homedir19(), ".config", "squadrant", "squadrant.sock");
+    DEFAULT_SOCK_PATH3 = join25(homedir20(), ".config", "squadrant", "squadrant.sock");
   }
 });
 
 // packages/cli/src/index.ts
 init_dist();
 init_dist2();
-import { Command as Command32 } from "commander";
-import { readFileSync as readFileSync15, existsSync as existsSync12, writeFileSync as writeFileSync11 } from "fs";
+import { Command as Command35 } from "commander";
+import { readFileSync as readFileSync16, existsSync as existsSync13, writeFileSync as writeFileSync12 } from "fs";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname9, join as join29 } from "path";
-import { homedir as homedir21 } from "os";
+import { dirname as dirname9, join as join30 } from "path";
+import { homedir as homedir22 } from "os";
 
 // packages/cli/src/commands/doctor.ts
 init_dist();
@@ -10029,10 +10309,10 @@ import chalk3 from "chalk";
 // packages/cli/src/commands/health-view.ts
 init_dist2();
 init_dist2();
-import { homedir as homedir11 } from "os";
-import { join as join16 } from "path";
+import { homedir as homedir12 } from "os";
+import { join as join17 } from "path";
 import chalk2 from "chalk";
-var SOCK = join16(homedir11(), ".config", "squadrant", "squadrant.sock");
+var SOCK = join17(homedir12(), ".config", "squadrant", "squadrant.sock");
 async function queryHealth(project) {
   try {
     const reply = await sendRequest(SOCK, { kind: "health", project });
@@ -10371,9 +10651,9 @@ import chalk4 from "chalk";
 
 // packages/cli/src/lib/per-crew-settings.ts
 init_dist4();
-import { mkdirSync as mkdirSync7, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "fs";
-import { dirname as dirname5, join as join19 } from "path";
-import { homedir as homedir14 } from "os";
+import { mkdirSync as mkdirSync8, readFileSync as readFileSync14, writeFileSync as writeFileSync10 } from "fs";
+import { dirname as dirname5, join as join20 } from "path";
+import { homedir as homedir15 } from "os";
 var CREW_PERMISSION_ALLOWLIST = [
   // git — read + safe mutations (reset/clean/config intentionally excluded)
   "Bash(git status:*)",
@@ -10464,29 +10744,29 @@ function mergeCrewPermissions(settings) {
   return next;
 }
 function writePerCrewSettingsLocal(o) {
-  const dir = join19(o.projectCwd, ".claude");
-  mkdirSync7(dir, { recursive: true });
-  const file = join19(dir, "settings.local.json");
+  const dir = join20(o.projectCwd, ".claude");
+  mkdirSync8(dir, { recursive: true });
+  const file = join20(dir, "settings.local.json");
   let existing = {};
   try {
-    const raw = healStaleCockpitRefs(readFileSync13(file, "utf-8"));
+    const raw = healStaleCockpitRefs(readFileSync14(file, "utf-8"));
     existing = JSON.parse(raw);
   } catch {
   }
   const withHooks = mergeClaudeHooks(existing, o.hookCmd ?? "squadrant crew _hook");
   const merged = mergeCrewPermissions(withHooks);
-  writeFileSync9(file, JSON.stringify(merged, null, 2));
+  writeFileSync10(file, JSON.stringify(merged, null, 2));
   return file;
 }
-var DEFAULT_GLOBAL_OPENCODE_CONFIG_PATH = join19(homedir14(), ".config", "opencode", "opencode.json");
+var DEFAULT_GLOBAL_OPENCODE_CONFIG_PATH = join20(homedir15(), ".config", "opencode", "opencode.json");
 function ensureGlobalOpencodeConfig(configPath = DEFAULT_GLOBAL_OPENCODE_CONFIG_PATH) {
-  mkdirSync7(dirname5(configPath), { recursive: true });
+  mkdirSync8(dirname5(configPath), { recursive: true });
   const defaultConfig = {
     $schema: "https://opencode.ai/config.json",
     model: "anthropic/claude-sonnet-4-5"
   };
   try {
-    writeFileSync9(configPath, JSON.stringify(defaultConfig, null, 2) + "\n", { flag: "wx" });
+    writeFileSync10(configPath, JSON.stringify(defaultConfig, null, 2) + "\n", { flag: "wx" });
     return configPath;
   } catch (err) {
     if (err.code === "EEXIST") return null;
@@ -10494,9 +10774,9 @@ function ensureGlobalOpencodeConfig(configPath = DEFAULT_GLOBAL_OPENCODE_CONFIG_
   }
 }
 function writePerCrewOpencodeConfig(o) {
-  const dir = join19(o.stateRoot, o.project, o.taskId);
-  mkdirSync7(dir, { recursive: true });
-  const file = join19(dir, "opencode.json");
+  const dir = join20(o.stateRoot, o.project, o.taskId);
+  mkdirSync8(dir, { recursive: true });
+  const file = join20(dir, "opencode.json");
   const config = {
     permission: {
       read: "allow",
@@ -10511,7 +10791,7 @@ function writePerCrewOpencodeConfig(o) {
       external_directory: { "**": "allow" }
     }
   };
-  writeFileSync9(file, JSON.stringify(config, null, 2));
+  writeFileSync10(file, JSON.stringify(config, null, 2));
   return file;
 }
 
@@ -10542,11 +10822,11 @@ function stepHeader(n, total, label) {
   ${n}/${total}  ${label}`));
 }
 function promptLine(question) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(question, (answer) => {
       rl.close();
-      resolve3(answer.trim());
+      resolve4(answer.trim());
     });
   });
 }
@@ -10874,48 +11154,22 @@ var projectsCommand = new Command3("projects").description("Manage registered pr
 
 // packages/cli/src/commands/status.ts
 init_dist();
-init_dist3();
 import { Command as Command4 } from "commander";
 import chalk6 from "chalk";
-import matter2 from "gray-matter";
-function timeAgo(dateStr) {
-  if (!dateStr) return chalk6.dim("\u2014");
-  const date = new Date(dateStr);
-  if (isNaN(date.getTime())) return chalk6.dim("\u2014");
-  const diff = Date.now() - date.getTime();
-  const mins = Math.floor(diff / 6e4);
-  const hours = Math.floor(diff / 36e5);
-  const days = Math.floor(diff / 864e5);
-  if (mins < 1) return "just now";
-  if (mins < 60) return `${mins}m ago`;
-  if (hours < 24) return `${hours}h ago`;
-  return `${days}d ago`;
-}
-function progressBar(completed, total) {
-  if (total === 0) return chalk6.dim("no tasks");
-  const pct = Math.round(completed / total * 100);
-  const filled = Math.round(pct / 10);
-  const bar = "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
-  return `${bar} ${pct}%`;
-}
 function captainIndicator(state) {
   if (state === "alive" || state === "stale") return chalk6.green("\u25CF");
   if (state === "stopped") return chalk6.magenta("\u23FB");
   if (state === void 0 || state === "unknown") return chalk6.dim("?");
   return chalk6.dim("\u25CB");
 }
-function formatProjectRow(name, captainName, fm, statusMdState, captainState) {
+function formatProjectRow(name, captainName, captainState) {
   const sessionIndicator = captainIndicator(captainState);
   const captainDisplay = `${captainName.padEnd(11)} ${sessionIndicator}`;
-  const crew = statusMdState === "ok" ? String(fm.active_crew ?? 0).padEnd(6) : chalk6.dim("?").padEnd(6);
-  const progress = statusMdState === "ok" ? progressBar(fm.tasks_completed ?? 0, fm.tasks_total ?? 0).padEnd(25) : statusMdState === "unreadable" ? chalk6.red("status.md unreadable").padEnd(25) : chalk6.dim("no notes").padEnd(25);
-  const updated = statusMdState === "ok" ? timeAgo(fm.last_updated) : chalk6.dim("\u2014");
-  return `  ${name.padEnd(18)} ${captainDisplay}  ${crew} ${progress} ${updated}`;
+  return `  ${name.padEnd(18)} ${captainDisplay}`;
 }
-var statusCommand = new Command4("status").description("Show status of all projects from spoke vault status files").option("--detailed", "also show live per-component service health from the daemon (#77)").action(async (opts) => {
+var statusCommand = new Command4("status").description("Show captain liveness for all projects (task/crew counts have no data source \u2014 #630)").option("--detailed", "also show live per-component service health from the daemon (#77)").action(async (opts) => {
   const config = loadConfig();
   const projects = Object.entries(config.projects);
-  const registry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
   if (projects.length === 0) {
     console.log(chalk6.yellow("\nNo projects registered. Use: squadrant projects add <name> <path>\n"));
     return;
@@ -10928,30 +11182,12 @@ var statusCommand = new Command4("status").description("Show status of all proje
     }
   }
   console.log(chalk6.bold("\nProject Status\n"));
-  console.log(
-    chalk6.dim(
-      `  ${"PROJECT".padEnd(18)} ${"CAPTAIN".padEnd(12)} ${"CREW".padEnd(6)} ${"PROGRESS".padEnd(25)} LAST UPDATE`
-    )
-  );
-  console.log(chalk6.dim("  " + "\u2500".repeat(85)));
+  console.log(chalk6.dim(`  ${"PROJECT".padEnd(18)} CAPTAIN`));
+  console.log(chalk6.dim("  " + "\u2500".repeat(35)));
   for (const [name, project] of projects) {
-    const workspace = registry.forProject(name, config);
-    let fm = {};
-    let statusMdState = "missing";
-    if (await workspace.exists("status.md")) {
-      try {
-        const raw = await workspace.read("status.md");
-        fm = matter2(raw).data;
-        statusMdState = "ok";
-      } catch {
-        statusMdState = "unreadable";
-      }
-    }
-    console.log(
-      formatProjectRow(name, project.captainName, fm, statusMdState, captainStateByProject.get(name))
-    );
+    console.log(formatProjectRow(name, project.captainName, captainStateByProject.get(name)));
   }
-  console.log("");
+  console.log(chalk6.dim("\n  Task/crew counts: no data source yet \u2014 see squadrant/squadrant#630\n"));
   if (opts.detailed) {
     printServiceHealth(health);
   }
@@ -11040,9 +11276,9 @@ import { Command as Command8 } from "commander";
 import { createConnection as createConnection3 } from "net";
 import { randomUUID as randomUUID4 } from "crypto";
 import { execFileSync as execFileSync6 } from "child_process";
-import { homedir as homedir16 } from "os";
-import { join as join21 } from "path";
-import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync10 } from "fs";
+import { homedir as homedir17 } from "os";
+import { join as join22 } from "path";
+import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync11 } from "fs";
 
 // packages/cli/src/commands/crew-output.ts
 function tailLines(text, maxLines = 40, maxBytes = 4096) {
@@ -11100,11 +11336,11 @@ init_dist2();
 import { Command as Command6 } from "commander";
 import chalk8 from "chalk";
 import { createConnection as createConnection2 } from "net";
-import { homedir as homedir15 } from "os";
-import { join as join20 } from "path";
+import { homedir as homedir16 } from "os";
+import { join as join21 } from "path";
 import { createInterface } from "readline";
 function socketPath() {
-  return process.env.SQUADRANTD_SOCK ?? join20(homedir15(), ".config", "squadrant", "squadrant.sock");
+  return process.env.SQUADRANTD_SOCK ?? join21(homedir16(), ".config", "squadrant", "squadrant.sock");
 }
 function rule(width, ch = "\u2500") {
   return ch.repeat(Math.max(0, width));
@@ -11340,11 +11576,11 @@ var crewChatCommand = new Command7("chat").description("[DEPRECATED] alias for `
 });
 
 // packages/cli/src/commands/crew-control.ts
-var SOCK2 = join21(homedir16(), ".config", "squadrant", "squadrant.sock");
+var SOCK2 = join22(homedir17(), ".config", "squadrant", "squadrant.sock");
 var CODEX_FIRST_TURN_DELAY_MS = 1500;
 async function sendCodexFirstTurn(taskId, text) {
   await new Promise((r) => setTimeout(r, CODEX_FIRST_TURN_DELAY_MS));
-  await new Promise((resolve3, reject) => {
+  await new Promise((resolve4, reject) => {
     const conn = createConnection3(SOCK2);
     conn.setEncoding("utf-8");
     conn.on("data", () => {
@@ -11360,7 +11596,7 @@ async function sendCodexFirstTurn(taskId, text) {
       }
       setTimeout(() => {
         conn.end();
-        resolve3();
+        resolve4();
       }, 100);
     });
   });
@@ -11447,10 +11683,10 @@ function buildSignalRequest(signal, o) {
   return { kind: "event", project, event };
 }
 function defaultWriteResult(id, payload) {
-  const dir = join21(homedir16(), ".config", "squadrant", "state", "_results");
-  mkdirSync8(dir, { recursive: true });
-  const file = join21(dir, `${id}.txt`);
-  writeFileSync10(file, payload);
+  const dir = join22(homedir17(), ".config", "squadrant", "state", "_results");
+  mkdirSync9(dir, { recursive: true });
+  const file = join22(dir, `${id}.txt`);
+  writeFileSync11(file, payload);
   return file;
 }
 async function runCrewSignal(signal, o, deps) {
@@ -11484,6 +11720,16 @@ function defaultCreatePr(cwd, o) {
     { cwd, encoding: "utf-8" }
   ).trim();
 }
+function defaultGetCommitSubject(cwd) {
+  try {
+    return execFileSync6("git", ["-C", cwd, "log", "-1", "--format=%s"], {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return "";
+  }
+}
 async function runCrewApprove(project, crew, deps) {
   const config = loadConfig();
   const proj = config.projects[project];
@@ -11499,8 +11745,12 @@ async function runCrewApprove(project, crew, deps) {
   const cwd = task.cwd ?? proj.path;
   const base = resolveWorktreeBase(proj.path);
   const branch = crewBranch(crew);
-  const title = (task.task ?? branch).split(/\r?\n/)[0].trim().slice(0, 100);
   const body = (task.reviewNote ?? task.task ?? "").trim();
+  const getCommitSubject = deps.getCommitSubject ?? defaultGetCommitSubject;
+  const commitSubject = getCommitSubject(cwd).trim();
+  const reviewNoteFirstLine = (task.reviewNote ?? "").split(/\r?\n/)[0].trim();
+  const taskFirstLine = (task.task ?? branch).split(/\r?\n/)[0].trim();
+  const title = (commitSubject || reviewNoteFirstLine || taskFirstLine).slice(0, 100);
   const pushBranch = deps.pushBranch ?? defaultPushBranch;
   const createPr = deps.createPr ?? defaultCreatePr;
   pushBranch(cwd, branch);
@@ -11838,11 +12088,11 @@ function parseCrewPick(raw, stats) {
   throw new Error(`Invalid selection '${raw}'. Enter a number 1-${stats.length} or a crew name.`);
 }
 function promptLine2(question) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(question, (answer) => {
       rl.close();
-      resolve3(answer);
+      resolve4(answer);
     });
   });
 }
@@ -12116,8 +12366,8 @@ init_dist();
 init_dist3();
 import { Command as Command12 } from "commander";
 import { execSync as execSync10 } from "child_process";
-import { homedir as homedir18 } from "os";
-import { join as join23 } from "path";
+import { homedir as homedir19 } from "os";
+import { join as join24 } from "path";
 import chalk13 from "chalk";
 
 // packages/web/dist/read-status.js
@@ -12330,9 +12580,9 @@ function mergeSnapshot(daemon, external, now) {
 // packages/web/dist/probes.js
 init_dist();
 init_dist();
-import { join as join22 } from "path";
-import { homedir as homedir17 } from "os";
-import { existsSync as existsSync11, readFileSync as readFileSync14 } from "fs";
+import { join as join23 } from "path";
+import { homedir as homedir18 } from "os";
+import { existsSync as existsSync12, readFileSync as readFileSync15 } from "fs";
 import { execFile as execFile4 } from "child_process";
 var DEFAULT_TIMEOUT_MS = 2e3;
 var AGENT_CLIS = ["claude", "codex", "gemini", "opencode"];
@@ -12368,7 +12618,7 @@ function vaultProbe(run, dir) {
       return { state: "unknown", detail: "no vault configured" };
     if (!run.pathExists(dir))
       return { state: "gone", detail: "vault directory missing" };
-    if (!run.pathExists(join22(dir, ".obsidian")))
+    if (!run.pathExists(join23(dir, ".obsidian")))
       return { state: "gone", detail: "no .obsidian/ (not a vault)" };
     return { state: "alive" };
   } catch {
@@ -12436,27 +12686,27 @@ async function runExternalProbes(run, timeoutMs = DEFAULT_TIMEOUT_MS) {
   const sessions = probeSessions(run);
   return { cmux: cmux2, agentClis, vaults, config: { parseable, projectPaths, sessions } };
 }
-var SESSIONS_PATH = join22(homedir17(), ".config", "squadrant", "sessions.json");
+var SESSIONS_PATH = join23(homedir18(), ".config", "squadrant", "sessions.json");
 function onPath(cli) {
   const dirs = (process.env.PATH ?? "").split(":").filter(Boolean);
-  return dirs.some((d) => existsSync11(join22(d, cli)));
+  return dirs.some((d) => existsSync12(join23(d, cli)));
 }
 function readSessionsHashes() {
-  const raw = JSON.parse(readFileSync14(SESSIONS_PATH, "utf-8"));
+  const raw = JSON.parse(readFileSync15(SESSIONS_PATH, "utf-8"));
   const hashes = Object.values(raw.workspaces ?? {}).map((w) => w.templateHash).filter((h) => typeof h === "string" && h.length > 0);
   return [...new Set(hashes)];
 }
 function defaultProbeRunners() {
   return {
-    probeCmuxBin: () => new Promise((resolve3) => {
+    probeCmuxBin: () => new Promise((resolve4) => {
       try {
-        execFile4(resolveCmuxBin(), ["--version"], { timeout: 1500 }, (err) => resolve3(!err));
+        execFile4(resolveCmuxBin(), ["--version"], { timeout: 1500 }, (err) => resolve4(!err));
       } catch {
-        resolve3(false);
+        resolve4(false);
       }
     }),
     probeOnPath: async (cli) => onPath(cli),
-    pathExists: (p) => existsSync11(p),
+    pathExists: (p) => existsSync12(p),
     loadConfig: () => loadConfig(),
     loadSessionsHashes: () => readSessionsHashes()
   };
@@ -13317,9 +13567,9 @@ async function startWebServer(opts) {
     }
     res.writeHead(404).end();
   });
-  await new Promise((resolve3, reject) => {
+  await new Promise((resolve4, reject) => {
     server.once("error", reject);
-    server.listen(opts.port, host, resolve3);
+    server.listen(opts.port, host, resolve4);
   });
   const addr = server.address();
   const boundPort = typeof addr === "object" && addr ? addr.port : opts.port;
@@ -13331,7 +13581,7 @@ async function startWebServer(opts) {
   timer.unref?.();
   return {
     port: boundPort,
-    close: () => new Promise((resolve3) => {
+    close: () => new Promise((resolve4) => {
       clearInterval(timer);
       for (const res of clients) {
         try {
@@ -13340,14 +13590,14 @@ async function startWebServer(opts) {
         }
       }
       clients.clear();
-      server.close(() => resolve3());
+      server.close(() => resolve4());
     })
   };
 }
 
 // packages/cli/src/commands/dashboard.ts
 init_dist();
-var SOCK3 = join23(homedir18(), ".config", "squadrant", "squadrant.sock");
+var SOCK3 = join24(homedir19(), ".config", "squadrant", "squadrant.sock");
 function detectCurrentWorkspace2() {
   const out = execSync10(`"${resolveCmuxBin()}" current-workspace`, { encoding: "utf-8" }).trim();
   const match = out.match(/workspace:\d+/);
@@ -13866,29 +14116,16 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command16 } from "commander";
-import fs24 from "fs";
-import path26 from "path";
 import chalk17 from "chalk";
-import matter3 from "gray-matter";
 function getDateStr(yesterday) {
   return iso(daysAgo(yesterday ? 1 : 0));
 }
 async function getProjectStandup(name, project, dateStr, registry, config) {
   const workspace = registry.forProject(name, config);
-  const spokeVault = resolveHome(project.spokeVault);
-  const statusFile = path26.join(spokeVault, "status.md");
-  let status = {};
-  if (fs24.existsSync(statusFile)) {
-    try {
-      status = matter3(fs24.readFileSync(statusFile, "utf-8")).data;
-    } catch {
-    }
-  }
   const log = await readDailyLog(workspace, dateStr);
   const gitCommits = getGitCommits(project.path, dateStr);
   return {
     name,
-    status,
     dailyLog: log?.content ?? null,
     gitCommits,
     blockers: log?.blockers ?? []
@@ -13907,26 +14144,16 @@ ${header}
   }
   let hasBlockers = false;
   for (const s of standups) {
-    const tasksDone = s.status.tasks_completed ?? 0;
-    const tasksTotal = s.status.tasks_total ?? 0;
-    const tasksInProgress = s.status.tasks_in_progress ?? 0;
     if (!raw) {
       lines.push(chalk17.cyan.bold(`## ${s.name}`));
     } else {
       lines.push(`## ${s.name}`);
     }
-    if (s.gitCommits.length > 0 || tasksDone > 0) {
+    if (s.gitCommits.length > 0) {
       lines.push(!raw ? chalk17.green("Done:") : "**Done:**");
       for (const commit of s.gitCommits) {
         lines.push(`  - ${commit}`);
       }
-      if (tasksDone > 0 && s.gitCommits.length === 0) {
-        lines.push(`  - ${tasksDone}/${tasksTotal} tasks completed`);
-      }
-    }
-    if (tasksInProgress > 0) {
-      lines.push(!raw ? chalk17.yellow("In Progress:") : "**In Progress:**");
-      lines.push(`  - ${tasksInProgress} task(s) active`);
     }
     if (s.dailyLog) {
       const sections = ["Completed", "In Progress", "Tomorrow"];
@@ -13948,19 +14175,18 @@ ${header}
         lines.push(`  - ${b}`);
       }
     }
-    if (s.gitCommits.length === 0 && tasksDone === 0 && !s.dailyLog) {
+    if (s.gitCommits.length === 0 && !s.dailyLog) {
       lines.push(!raw ? chalk17.dim("  (no activity)") : "  (no activity)");
     }
     lines.push("");
   }
   const totalCommits = standups.reduce((sum, s) => sum + s.gitCommits.length, 0);
-  const totalDone = standups.reduce((sum, s) => sum + (s.status.tasks_completed ?? 0), 0);
   if (!raw) {
-    lines.push(chalk17.dim(`--- ${totalCommits} commits, ${totalDone} tasks done${hasBlockers ? ", HAS BLOCKERS" : ""} ---
+    lines.push(chalk17.dim(`--- ${totalCommits} commits${hasBlockers ? ", HAS BLOCKERS" : ""} (task tracking: no data source \u2014 #630) ---
 `));
   } else {
     lines.push(`---
-*${totalCommits} commits, ${totalDone} tasks done${hasBlockers ? ", HAS BLOCKERS" : ""}*
+*${totalCommits} commits${hasBlockers ? ", HAS BLOCKERS" : ""} (task tracking: no data source \u2014 #630)*
 `);
   }
   return lines.join("\n");
@@ -13998,19 +14224,7 @@ init_dist();
 init_dist();
 init_dist3();
 import { Command as Command17 } from "commander";
-import fs25 from "fs";
-import path27 from "path";
 import chalk18 from "chalk";
-import matter4 from "gray-matter";
-function readStatus(spokeVault) {
-  const statusFile = path27.join(spokeVault, "status.md");
-  if (!fs25.existsSync(statusFile)) return {};
-  try {
-    return matter4(fs25.readFileSync(statusFile, "utf-8")).data;
-  } catch {
-    return {};
-  }
-}
 function dedupe(items) {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
@@ -14025,8 +14239,6 @@ function dedupe(items) {
 }
 async function getProjectRetro(name, project, fromStr, toStr, registry, config) {
   const workspace = registry.forProject(name, config);
-  const spokeVault = resolveHome(project.spokeVault);
-  const status = readStatus(spokeVault);
   const shipped = [];
   const inProgress = [];
   const blocked = [];
@@ -14056,9 +14268,7 @@ async function getProjectRetro(name, project, fromStr, toStr, registry, config)
     blocked: dedupe(blocked),
     decisions: dedupe(decisions),
     commits,
-    mergedPRs,
-    tasksCompletedNow: status.tasks_completed ?? 0,
-    tasksInProgressNow: status.tasks_in_progress ?? 0
+    mergedPRs
   };
 }
 function renderList(lines, items, raw, label, color) {
@@ -14214,9 +14424,9 @@ async function runRuntimeSend(arg1, arg2, opts, confirmOpts) {
   const resolved = resolveTarget(registry, config, target, !!opts.command);
   await needRef(resolved);
   const finalProject = opts.command ? config.commandName : target;
-  const { join: join30, dirname: dirname10 } = await import("path");
+  const { join: join31, dirname: dirname10 } = await import("path");
   const { DEFAULT_CONFIG_PATH: DEFAULT_CONFIG_PATH2 } = await Promise.resolve().then(() => (init_dist(), dist_exports));
-  const stateRoot = join30(dirname10(DEFAULT_CONFIG_PATH2), "state");
+  const stateRoot = join31(dirname10(DEFAULT_CONFIG_PATH2), "state");
   const seq = await appendCaptainMessage2({
     stateRoot,
     project: finalProject,
@@ -14329,9 +14539,9 @@ workspaceCommand.command("read").description("Print the contents of a scope-rela
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path30 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path34 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const content = await driver.read(path30);
+    const content = await driver.read(path34);
     process.stdout.write(content);
   } catch (err) {
     console.error(chalk20.red(err.message));
@@ -14343,26 +14553,26 @@ workspaceCommand.command("write").description("Write content to a scope-relative
   const registry = buildRegistry2();
   try {
     let projectTarget;
-    let path30;
+    let path34;
     let rawContent;
     if (opts.hub) {
       if (arg3 !== void 0) {
         throw new Error("With --hub, pass only the path and content");
       }
       projectTarget = void 0;
-      path30 = arg1;
+      path34 = arg1;
       rawContent = arg2;
     } else {
       if (arg3 === void 0) {
         throw new Error("Missing content \u2014 usage: <project> <path> <content>");
       }
       projectTarget = arg1;
-      path30 = arg2;
+      path34 = arg2;
       rawContent = arg3;
     }
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
     const payload = rawContent === "-" ? await readStdin() : rawContent;
-    await driver.write(path30, payload);
+    await driver.write(path34, payload);
   } catch (err) {
     console.error(chalk20.red(err.message));
     process.exit(1);
@@ -14372,9 +14582,9 @@ workspaceCommand.command("list").description("List entries in a scope-relative d
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path30 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path34 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const entries = await driver.list(path30);
+    const entries = await driver.list(path34);
     for (const entry of entries) console.log(entry);
   } catch (err) {
     console.error(chalk20.red(err.message));
@@ -14385,9 +14595,9 @@ workspaceCommand.command("exists").description("Exit 0 if path exists, 1 if not"
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path30 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path34 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    const ok2 = await driver.exists(path30);
+    const ok2 = await driver.exists(path34);
     process.exit(ok2 ? 0 : 1);
   } catch (err) {
     console.error(chalk20.red(err.message));
@@ -14398,9 +14608,9 @@ workspaceCommand.command("mkdir").description("Recursively create a scope-relati
   const config = loadConfig();
   const registry = buildRegistry2();
   try {
-    const { projectTarget, path: path30 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
+    const { projectTarget, path: path34 } = resolveTargetAndPath(arg1, arg2, !!opts.hub);
     const driver = resolveDriver(registry, config, projectTarget, !!opts.hub);
-    await driver.mkdir(path30);
+    await driver.mkdir(path34);
   } catch (err) {
     console.error(chalk20.red(err.message));
     process.exit(1);
@@ -14439,8 +14649,8 @@ init_dist3();
 init_dist();
 import { Command as Command21 } from "commander";
 import chalk22 from "chalk";
-import fs26 from "fs";
-import path28 from "path";
+import fs24 from "fs";
+import path26 from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function parseScope(v) {
   if (v !== "user" && v !== "project") {
@@ -14449,10 +14659,10 @@ function parseScope(v) {
   return v;
 }
 function findPackageRoot3() {
-  let dir = path28.dirname(fileURLToPath4(import.meta.url));
+  let dir = path26.dirname(fileURLToPath4(import.meta.url));
   while (dir !== "/" && dir !== "") {
-    if (fs26.existsSync(path28.join(dir, "package.json"))) return dir;
-    dir = path28.dirname(dir);
+    if (fs24.existsSync(path26.join(dir, "package.json"))) return dir;
+    dir = path26.dirname(dir);
   }
   return process.cwd();
 }
@@ -14576,7 +14786,7 @@ projectionCommand.command("list").description("List registered projection target
 // packages/cli/src/commands/codex-chat-smoke.ts
 init_dist4();
 import { Command as Command22 } from "commander";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 var codexChatSmokeCommand = new Command22("codex-chat-smoke").description("Phase 1 gate: prove the codex app-server JSON-RPC path works end-to-end.").option("--cwd <dir>", "working dir for the codex thread", process.cwd()).option("--model <m>", "model id (optional)").option(
   "--approval",
   "include the approval round-trip (Phase 1 PASS requires this)",
@@ -14593,7 +14803,7 @@ var codexChatSmokeCommand = new Command22("codex-chat-smoke").description("Phase
     c.start();
     await c.initialize();
     const { threadId } = await c.startThread({
-      cwd: resolve2(opts.cwd),
+      cwd: resolve3(opts.cwd),
       model: opts.model,
       sandbox: "workspace-write",
       // With --approval, force untrusted policy so codex requests approval
@@ -14614,7 +14824,7 @@ var codexChatSmokeCommand = new Command22("codex-chat-smoke").description("Phase
       pendingApprovals.push({ id: r.id, method: r.method });
       c.respondToServerRequest(r.id, { decision: "approve" });
     });
-    await c.sendTurn(threadId, `Write the text "approval-ok" to a file at ${resolve2(opts.cwd)}/.squadrant-smoke.txt`);
+    await c.sendTurn(threadId, `Write the text "approval-ok" to a file at ${resolve3(opts.cwd)}/.squadrant-smoke.txt`);
     if (pendingApprovals.length === 0) {
       throw new Error("approval gate: expected at least one server-request (approval/input) during the turn");
     }
@@ -14647,12 +14857,12 @@ init_dist();
 init_dist();
 init_dist2();
 import { Command as Command23 } from "commander";
-import fs27 from "fs";
+import fs25 from "fs";
 import { fileURLToPath as fileURLToPath5 } from "url";
-import { dirname as dirname6, join as join25 } from "path";
+import { dirname as dirname6, join as join26 } from "path";
 import chalk23 from "chalk";
 function runConfigCheck(opts) {
-  const raw = JSON.parse(fs27.readFileSync(opts.configPath, "utf-8"));
+  const raw = JSON.parse(fs25.readFileSync(opts.configPath, "utf-8"));
   const def = getDefaultConfig();
   const items = detectDrift(raw, def);
   let working = raw;
@@ -14669,7 +14879,7 @@ function runConfigCheck(opts) {
     stamped = true;
   }
   if (opts.fix || opts.accept || stamped) {
-    fs27.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
+    fs25.writeFileSync(opts.configPath, JSON.stringify(working, null, 2) + "\n");
   }
   return { items, applied, remaining, stamped };
 }
@@ -14740,7 +14950,7 @@ function printItems(items) {
 var configCommand = new Command23("config").description("Inspect and reconcile squadrant config");
 configCommand.command("check").description("Detect config drift vs the current default schema").option("--fix", "Apply the safe tier (add missing, remove deprecated)", false).option("--accept", "Stamp the current version without changing config (dismiss advisories)", false).option("--json", "Output drift items as JSON", false).action((opts) => {
   const pkgVersion = readPkgVersion2();
-  if (!fs27.existsSync(DEFAULT_CONFIG_PATH)) {
+  if (!fs25.existsSync(DEFAULT_CONFIG_PATH)) {
     console.log(chalk23.yellow("No config found \u2014 run `squadrant init` first."));
     return;
   }
@@ -14785,8 +14995,8 @@ configCommand.command("set").description("Write a config value by dotted key (e.
   }
 });
 function readPkgVersion2() {
-  const pkgPath = join25(dirname6(fileURLToPath5(import.meta.url)), "..", "package.json");
-  return JSON.parse(fs27.readFileSync(pkgPath, "utf-8")).version;
+  const pkgPath = join26(dirname6(fileURLToPath5(import.meta.url)), "..", "package.json");
+  return JSON.parse(fs25.readFileSync(pkgPath, "utf-8")).version;
 }
 
 // packages/cli/src/commands/heal.ts
@@ -14871,9 +15081,9 @@ var healCommand = new Command24("heal").description("Targeted, idempotent remedi
     process.exit(code);
   })
 ).addCommand(
-  new Command24("daemon").description("Restart squadrantd via the idempotent launchd kickstart path").action(async () => {
+  new Command24("daemon").description("Explicitly reconcile + restart squadrantd (#636 operator opt-in \u2014 reads current PATH/entry drift and applies it, regardless of role)").action(async () => {
     const code = await runHealDaemon({
-      ensureDaemon: () => restartDaemonIfRunning({ reason: "heal", isRunning: () => true }),
+      ensureDaemon: () => reregisterDaemon(),
       stdout: process.stdout,
       stderr: process.stderr
     });
@@ -14939,7 +15149,7 @@ var groupCommand = new Command26("group").description("Cross-project intra-group
 // packages/cli/src/commands/ping.ts
 init_dist();
 init_dist2();
-import { join as join26, dirname as dirname7 } from "path";
+import { join as join27, dirname as dirname7 } from "path";
 import { Command as Command27 } from "commander";
 import chalk27 from "chalk";
 init_require_daemon();
@@ -14949,7 +15159,7 @@ async function runPing(project, message) {
   const resolved = resolveTarget(registry, config, project, false);
   await requireDaemon();
   await needRef(resolved);
-  const stateRoot = join26(dirname7(DEFAULT_CONFIG_PATH), "state");
+  const stateRoot = join27(dirname7(DEFAULT_CONFIG_PATH), "state");
   await appendCaptainMessage({
     stateRoot,
     project,
@@ -15026,8 +15236,8 @@ var cmuxCommand = new Command28("cmux").description("cmux integration helpers").
 // packages/cli/src/commands/effort.ts
 init_dist();
 init_dist2();
-import fs28 from "fs";
-import path29 from "path";
+import fs26 from "fs";
+import path27 from "path";
 import { Command as Command29 } from "commander";
 import chalk29 from "chalk";
 var VALID_EFFORTS = ["max", "balance", "low"];
@@ -15070,9 +15280,9 @@ function effortScopeLabel(projectName) {
 }
 function canonical(p) {
   try {
-    return fs28.realpathSync(p);
+    return fs26.realpathSync(p);
   } catch {
-    return path29.resolve(p);
+    return path27.resolve(p);
   }
 }
 async function notifyCaptainsOfEffort(effort, config, driver, cwd = process.cwd(), append, scopeProject, projectConfigRoot) {
@@ -15122,7 +15332,7 @@ var effortCommand = new Command29("effort").description("Get or set the crew tok
     const config = loadConfig();
     const registry = new RuntimeRegistry2({ cmux: createCmuxDriver2() });
     const driver = registry.global(config);
-    const stateRoot = path29.join(path29.dirname(DEFAULT_CONFIG_PATH), "state");
+    const stateRoot = path27.join(path27.dirname(DEFAULT_CONFIG_PATH), "state");
     const append = (project, text) => appendCaptainMessage({ stateRoot, project, text, source: "daemon" });
     await notifyCaptainsOfEffort(effort, config, driver, process.cwd(), append, options.project);
   } catch {
@@ -15130,18 +15340,308 @@ var effortCommand = new Command29("effort").description("Get or set the crew tok
   }
 });
 
+// packages/cli/src/commands/tokens.ts
+init_dist();
+import fs27 from "fs";
+import path28 from "path";
+import os15 from "os";
+import readline3 from "readline";
+import { Command as Command30 } from "commander";
+import chalk30 from "chalk";
+var CLAUDE_PROJECTS_DIR = path28.join(os15.homedir(), ".claude", "projects");
+function parseTranscriptLine(rawLine) {
+  const line = rawLine.trim();
+  if (!line) return { timestamp: null, usage: null };
+  let obj;
+  try {
+    obj = JSON.parse(line);
+  } catch {
+    return { timestamp: null, usage: null };
+  }
+  const entry = obj;
+  const timestamp = typeof entry?.timestamp === "string" ? entry.timestamp : null;
+  if (entry?.type !== "assistant" || entry.message?.role !== "assistant") return { timestamp, usage: null };
+  const usage2 = entry.message?.usage;
+  if (!usage2) return { timestamp, usage: null };
+  return {
+    timestamp,
+    usage: {
+      input: usage2.input_tokens ?? 0,
+      output: usage2.output_tokens ?? 0,
+      cacheRead: usage2.cache_read_input_tokens ?? 0,
+      cacheWrite: usage2.cache_creation_input_tokens ?? 0
+    }
+  };
+}
+function emptySessionAggregate() {
+  return { calls: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, turns: [], earliest: null, latest: null };
+}
+function extendRange(range, timestamp) {
+  if (!timestamp) return;
+  if (range.earliest === null || timestamp < range.earliest) range.earliest = timestamp;
+  if (range.latest === null || timestamp > range.latest) range.latest = timestamp;
+}
+function foldTranscriptLine(agg, rawLine, state) {
+  const { timestamp, usage: usage2 } = parseTranscriptLine(rawLine);
+  extendRange(agg, timestamp);
+  if (!usage2) return;
+  agg.calls++;
+  agg.input += usage2.input;
+  agg.output += usage2.output;
+  agg.cacheRead += usage2.cacheRead;
+  agg.cacheWrite += usage2.cacheWrite;
+  if (usage2.cacheRead !== state.lastCacheRead) {
+    state.lastCacheRead = usage2.cacheRead;
+    agg.turns.push({ total: usage2.input + usage2.cacheWrite + usage2.cacheRead, cacheRead: usage2.cacheRead });
+  }
+}
+async function aggregateTranscriptFile(filePath) {
+  const agg = emptySessionAggregate();
+  const state = { lastCacheRead: null };
+  const rl = readline3.createInterface({ input: fs27.createReadStream(filePath), crlfDelay: Infinity });
+  for await (const line of rl) {
+    foldTranscriptLine(agg, line, state);
+  }
+  return agg;
+}
+function escapeClaudeProjectPath(cwd) {
+  return cwd.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function isCrewDirName(dirName, captainSlug) {
+  return dirName !== captainSlug && dirName.startsWith(`${captainSlug}-`);
+}
+function mergeRanges(ranges) {
+  const merged = { earliest: null, latest: null };
+  for (const r of ranges) {
+    extendRange(merged, r.earliest);
+    extendRange(merged, r.latest);
+  }
+  return merged;
+}
+function buildRoleReport(role, sessions) {
+  let calls = 0;
+  let input = 0;
+  let output = 0;
+  let cacheRead = 0;
+  let cacheWrite = 0;
+  const boots = [];
+  let bootConfirmedSessions = 0;
+  for (const s of sessions) {
+    calls += s.calls;
+    input += s.input;
+    output += s.output;
+    cacheRead += s.cacheRead;
+    cacheWrite += s.cacheWrite;
+    const [first, second] = s.turns;
+    if (first) {
+      boots.push(first.total);
+      if (second && first.total > 0) {
+        const rel = Math.abs(second.cacheRead - first.total) / first.total;
+        if (rel < 0.02) bootConfirmedSessions++;
+      }
+    }
+  }
+  const meanCacheReadPerCall = calls > 0 ? cacheRead / calls : null;
+  const meanBoot = boots.length > 0 ? boots.reduce((a, b) => a + b, 0) / boots.length : null;
+  const accumulated = meanCacheReadPerCall !== null && meanBoot !== null ? meanCacheReadPerCall - meanBoot : null;
+  const accumulatedPct = accumulated !== null && meanCacheReadPerCall ? accumulated / meanCacheReadPerCall : null;
+  const { earliest, latest } = mergeRanges(sessions);
+  return {
+    role,
+    sessionFiles: sessions.length,
+    calls,
+    input,
+    output,
+    cacheRead,
+    cacheWrite,
+    meanCacheReadPerCall,
+    meanBoot,
+    accumulated,
+    accumulatedPct,
+    bootConfirmedSessions,
+    bootSampledSessions: boots.length,
+    earliest,
+    latest
+  };
+}
+async function readdirSafe(dir) {
+  try {
+    return await fs27.promises.readdir(dir);
+  } catch {
+    return [];
+  }
+}
+async function listJsonlFiles(dir) {
+  const entries = await readdirSafe(dir);
+  return entries.filter((e) => e.endsWith(".jsonl")).map((e) => path28.join(dir, e));
+}
+async function findTranscriptDirs(claudeProjectsDir, captainSlug) {
+  const entries = await readdirSafe(claudeProjectsDir);
+  const captainDirs = [];
+  const crewDirs = [];
+  for (const entry of entries) {
+    if (entry === captainSlug) captainDirs.push(path28.join(claudeProjectsDir, entry));
+    else if (isCrewDirName(entry, captainSlug)) crewDirs.push(path28.join(claudeProjectsDir, entry));
+  }
+  return { captainDirs, crewDirs };
+}
+async function aggregateFiles(files) {
+  const sessions = [];
+  for (const file of files) {
+    sessions.push(await aggregateTranscriptFile(file));
+  }
+  return sessions;
+}
+async function collectProjectTokenReport(name, projectPath, claudeProjectsDir = CLAUDE_PROJECTS_DIR) {
+  const captainSlug = escapeClaudeProjectPath(projectPath);
+  const { captainDirs, crewDirs } = await findTranscriptDirs(claudeProjectsDir, captainSlug);
+  const captainFiles = (await Promise.all(captainDirs.map(listJsonlFiles))).flat();
+  const crewFiles = (await Promise.all(crewDirs.map(listJsonlFiles))).flat();
+  const [captainSessions, crewSessions] = await Promise.all([
+    aggregateFiles(captainFiles),
+    aggregateFiles(crewFiles)
+  ]);
+  return {
+    project: name,
+    path: projectPath,
+    captain: buildRoleReport("captain", captainSessions),
+    crews: buildRoleReport("crews", crewSessions)
+  };
+}
+function formatTokens(n) {
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
+  return String(Math.round(n));
+}
+function formatPct(n) {
+  return n === null ? "n/a" : `${Math.round(n * 100)}%`;
+}
+function printRoleRow(label, r) {
+  const totalVolume = r.input + r.output + r.cacheRead + r.cacheWrite;
+  console.log(
+    `  ${label.padEnd(10)} ${String(r.sessionFiles).padStart(6)} ${String(r.calls).padStart(8)} ${formatTokens(r.input).padStart(8)} ${formatTokens(r.output).padStart(8)} ${formatTokens(r.cacheRead).padStart(10)} ${formatTokens(r.cacheWrite).padStart(10)} ${formatTokens(totalVolume).padStart(10)} ` + chalk30.dim(formatRange(r))
+  );
+}
+function printBootLine(label, r) {
+  if (r.meanBoot === null || r.meanCacheReadPerCall === null) {
+    console.log(chalk30.dim(`  ${label.padEnd(10)} no sessions with turn data`));
+    return;
+  }
+  const bootPct = r.meanCacheReadPerCall > 0 ? r.meanBoot / r.meanCacheReadPerCall : null;
+  console.log(
+    `  ${label.padEnd(10)} mean ctx/call ${formatTokens(r.meanCacheReadPerCall).padStart(8)}  boot ${formatTokens(r.meanBoot).padStart(8)} (${formatPct(bootPct)})  accumulated ${formatTokens(r.accumulated ?? 0).padStart(8)} (${formatPct(r.accumulatedPct)})` + chalk30.dim(`  [boot confirmed ${r.bootConfirmedSessions}/${r.bootSampledSessions} sessions]`)
+  );
+}
+function sumRoleReports(role, reports) {
+  const calls = reports.reduce((a, r) => a + r.calls, 0);
+  const cacheRead = reports.reduce((a, r) => a + r.cacheRead, 0);
+  const bootWeighted = reports.reduce(
+    (a, r) => a + (r.meanBoot !== null ? r.meanBoot * r.bootSampledSessions : 0),
+    0
+  );
+  const bootSampledSessions = reports.reduce((a, r) => a + r.bootSampledSessions, 0);
+  const meanBoot = bootSampledSessions > 0 ? bootWeighted / bootSampledSessions : null;
+  const meanCacheReadPerCall = calls > 0 ? cacheRead / calls : null;
+  const accumulated = meanCacheReadPerCall !== null && meanBoot !== null ? meanCacheReadPerCall - meanBoot : null;
+  const accumulatedPct = accumulated !== null && meanCacheReadPerCall ? accumulated / meanCacheReadPerCall : null;
+  const { earliest, latest } = mergeRanges(reports);
+  return {
+    role,
+    sessionFiles: reports.reduce((a, r) => a + r.sessionFiles, 0),
+    calls,
+    input: reports.reduce((a, r) => a + r.input, 0),
+    output: reports.reduce((a, r) => a + r.output, 0),
+    cacheRead,
+    cacheWrite: reports.reduce((a, r) => a + r.cacheWrite, 0),
+    meanCacheReadPerCall,
+    meanBoot,
+    accumulated,
+    accumulatedPct,
+    bootConfirmedSessions: reports.reduce((a, r) => a + r.bootConfirmedSessions, 0),
+    bootSampledSessions,
+    earliest,
+    latest
+  };
+}
+var ROLLING_WINDOW_NOTE = "Rolling window, not all-time: Claude Code prunes transcripts older than `cleanupPeriodDays` (default 30 days). Totals shrink over time purely from retention as old sessions age out \u2014 that is NOT the same as spend going down.";
+function formatDate(iso2) {
+  return iso2 ? iso2.slice(0, 10) : "?";
+}
+function formatRange(r) {
+  if (!r.earliest && !r.latest) return "no dated turns";
+  return `${formatDate(r.earliest)} \u2192 ${formatDate(r.latest)}`;
+}
+var tokensCommand = new Command30("tokens").description(
+  "Attribute token spend across captain vs crews and boot prefix vs accumulated conversation (Claude Code transcripts only)"
+).option("--project <name>", "scope to a single registered project").option("--json", "print machine-readable JSON instead of a table").action(async (opts) => {
+  const config = loadConfig();
+  let entries = Object.entries(config.projects);
+  if (opts.project) {
+    if (!(opts.project in config.projects)) {
+      const known = Object.keys(config.projects).sort().join(", ") || "(no projects registered)";
+      console.error(chalk30.red(`Unknown project '${opts.project}'. Known projects: ${known}`));
+      process.exit(1);
+    }
+    entries = entries.filter(([name]) => name === opts.project);
+  }
+  const reports = [];
+  for (const [name, project] of entries) {
+    reports.push(await collectProjectTokenReport(name, resolveHome(project.path)));
+  }
+  const active = reports.filter((r) => r.captain.calls > 0 || r.crews.calls > 0);
+  const skipped = reports.length - active.length;
+  const dataWindow = mergeRanges(active.flatMap((r) => [r.captain, r.crews]));
+  if (opts.json) {
+    console.log(JSON.stringify({ dataWindow, rollingWindowNote: ROLLING_WINDOW_NOTE, projects: active }, null, 2));
+    return;
+  }
+  if (active.length === 0) {
+    console.log(chalk30.yellow("\nNo Claude Code transcripts found for any registered project.\n"));
+    return;
+  }
+  console.log(chalk30.bold("\nToken spend by project (Claude Code transcripts only)\n"));
+  console.log(chalk30.yellow(`  Data window: ${formatRange(dataWindow)}`));
+  console.log(chalk30.dim(`  ${ROLLING_WINDOW_NOTE}
+`));
+  console.log(chalk30.dim(`  ${"PROJECT/ROLE".padEnd(10)} ${"FILES".padStart(6)} ${"CALLS".padStart(8)} ${"INPUT".padStart(8)} ${"OUTPUT".padStart(8)} ${"CACHE_READ".padStart(10)} ${"CACHE_WRITE".padStart(10)} ${"TOTAL".padStart(10)} WINDOW`));
+  console.log(chalk30.dim("  " + "\u2500".repeat(78)));
+  for (const r of active) {
+    console.log(chalk30.bold(`  ${r.project}`));
+    if (r.captain.calls > 0) printRoleRow("captain", r.captain);
+    if (r.crews.calls > 0) printRoleRow("crews", r.crews);
+  }
+  const totalCaptain = sumRoleReports("captain", active.map((r) => r.captain));
+  const totalCrews = sumRoleReports("crews", active.map((r) => r.crews));
+  console.log(chalk30.dim("  " + "\u2500".repeat(78)));
+  console.log(chalk30.bold("  TOTAL"));
+  printRoleRow("captain", totalCaptain);
+  printRoleRow("crews", totalCrews);
+  console.log(chalk30.bold("\nBoot prefix vs accumulated conversation\n"));
+  printBootLine("captain", totalCaptain);
+  printBootLine("crews", totalCrews);
+  console.log(
+    chalk30.dim(
+      "\n  cache_read is ~1/10 the price of fresh input \u2014 do not read the TOTAL column as spend.\n  claude-only reader today; squadrant is multi-agent but no other driver writes an equivalent transcript yet.\n"
+    )
+  );
+  if (skipped > 0) {
+    console.log(chalk30.dim(`  ${skipped} project(s) with no local Claude transcripts omitted.
+`));
+  }
+});
+
 // packages/cli/src/commands/telegram.ts
 init_dist();
 init_dist2();
-import { join as join27, dirname as dirname8 } from "path";
+import { join as join28, dirname as dirname8 } from "path";
 import { emitKeypressEvents } from "readline";
-import { Command as Command30 } from "commander";
-import chalk30 from "chalk";
+import { Command as Command31 } from "commander";
+import chalk31 from "chalk";
 function defaultStateRoot() {
-  return join27(dirname8(DEFAULT_CONFIG_PATH), "state");
+  return join28(dirname8(DEFAULT_CONFIG_PATH), "state");
 }
 async function questionMasked() {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     emitKeypressEvents(process.stdin);
     process.stdin.setRawMode(true);
     process.stdin.resume();
@@ -15158,7 +15658,7 @@ async function questionMasked() {
         process.stdin.setRawMode(false);
         process.stdin.pause();
         process.stdout.write("\n");
-        resolve3(answer);
+        resolve4(answer);
       } else if (key.name === "backspace") {
         if (answer.length > 0) {
           answer = answer.slice(0, -1);
@@ -15175,19 +15675,19 @@ async function questionMasked() {
 async function questionYesNo(prompt) {
   const { createInterface: createInterface2 } = await import("readline");
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     rl.question(prompt, (ans) => {
       rl.close();
       process.stdin.pause();
-      resolve3(/^y(es)?$/i.test(ans.trim()));
+      resolve4(/^y(es)?$/i.test(ans.trim()));
     });
   });
 }
-var telegramCommand = new Command30("telegram").description("Two-way Telegram integration: push crew events to a topic and reply into the captain pane");
+var telegramCommand = new Command31("telegram").description("Two-way Telegram integration: push crew events to a topic and reply into the captain pane");
 telegramCommand.command("status").description("Show Telegram config and linked projects").action(() => {
   const { tokenSet, supergroupId, links } = runTelegramStatus({ config: loadConfig(), stateRoot: defaultStateRoot() });
-  console.log(`token: ${tokenSet ? chalk30.green("set") : chalk30.yellow("unset")}`);
-  console.log(`supergroup: ${supergroupId ?? chalk30.yellow("unset")}`);
+  console.log(`token: ${tokenSet ? chalk31.green("set") : chalk31.yellow("unset")}`);
+  console.log(`supergroup: ${supergroupId ?? chalk31.yellow("unset")}`);
   if (links.length === 0) {
     console.log("no projects linked");
     return;
@@ -15197,32 +15697,32 @@ telegramCommand.command("status").description("Show Telegram config and linked p
 telegramCommand.command("link").argument("<project>", "project to bind to a Telegram topic").description("Create (or reuse) a forum topic for a project and bind it").action(async (project) => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk30.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
+    console.error(chalk31.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk30.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk31.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   const { topicId, created } = await runTelegramLink({ project, cfg, client, stateRoot: defaultStateRoot() });
-  console.log(chalk30.green(`${created ? "linked" : "already linked"}: ${project} \u2192 topic ${topicId}`));
+  console.log(chalk31.green(`${created ? "linked" : "already linked"}: ${project} \u2192 topic ${topicId}`));
 });
 telegramCommand.command("setup").description("Interactive wizard \u2014 bot token, validate, auto-detect supergroup, write config").option("--reset-token", "force re-entry of the bot token even if one already exists").option("--redetect", "force group re-detection even when a supergroup is already configured").option("--user-id <id>", "allowlist user-id \u2014 enables remote control on a re-run without getUpdates detection", (v) => parseInt(v, 10)).action(async (opts) => {
   if (!process.stdin.isTTY) {
-    console.error(chalk30.red("setup requires a TTY \u2014 pipe input is not supported"));
+    console.error(chalk31.red("setup requires a TTY \u2014 pipe input is not supported"));
     process.exit(1);
   }
   console.log();
-  console.log(chalk30.bold("Telegram setup") + " \u2014 connect squadrant to a Telegram bot for notifications + remote control");
+  console.log(chalk31.bold("Telegram setup") + " \u2014 connect squadrant to a Telegram bot for notifications + remote control");
   console.log();
   console.log("Before you start you need:");
   console.log("  1. A bot token from @BotFather (send /newbot)");
   console.log("  2. A forum supergroup with the bot added as an admin (Topics enabled)");
   console.log("  3. Bot privacy mode set to OFF (@BotFather \u2192 /setprivacy \u2192 Disable)");
   console.log();
-  console.log(chalk30.bold("Step 1/3 \u2014 Bot token"));
+  console.log(chalk31.bold("Step 1/3 \u2014 Bot token"));
   const existingCfg = loadConfig().telegram;
   const existingToken = existingCfg?.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   const decision = resolveSetupToken(existingToken, { resetToken: opts.resetToken ?? false });
@@ -15234,67 +15734,67 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
     try {
       botUser = await client.getMe();
       token = existingToken;
-      console.log(chalk30.green(`Using existing bot token (@${botUser.username})`));
+      console.log(chalk31.green(`Using existing bot token (@${botUser.username})`));
       console.log();
     } catch {
-      console.log(chalk30.yellow("Existing token is invalid \u2014 please enter a new one."));
+      console.log(chalk31.yellow("Existing token is invalid \u2014 please enter a new one."));
       console.log("Paste your bot token then press Enter (input is hidden):");
       token = await questionMasked();
       if (!token) {
-        console.error(chalk30.red("token required"));
+        console.error(chalk31.red("token required"));
         process.exit(1);
       }
       client = createTelegramClient({ token });
       try {
         botUser = await client.getMe();
       } catch (e) {
-        console.error(chalk30.red(`token rejected: ${e.message}`));
+        console.error(chalk31.red(`token rejected: ${e.message}`));
         process.exit(1);
       }
-      console.log(chalk30.green(`Connected as @${botUser.username}`));
+      console.log(chalk31.green(`Connected as @${botUser.username}`));
       console.log();
     }
   } else {
     console.log("Paste your bot token then press Enter (input is hidden):");
     token = await questionMasked();
     if (!token) {
-      console.error(chalk30.red("token required"));
+      console.error(chalk31.red("token required"));
       process.exit(1);
     }
     client = createTelegramClient({ token });
     try {
       botUser = await client.getMe();
     } catch (e) {
-      console.error(chalk30.red(`token rejected: ${e.message}`));
+      console.error(chalk31.red(`token rejected: ${e.message}`));
       process.exit(1);
     }
-    console.log(chalk30.green(`Connected as @${botUser.username}`));
+    console.log(chalk31.green(`Connected as @${botUser.username}`));
     console.log();
   }
-  console.log(chalk30.bold("Step 2/3 \u2014 Supergroup"));
+  console.log(chalk31.bold("Step 2/3 \u2014 Supergroup"));
   const groupDecision = resolveSetupGroup(existingCfg?.supergroupId, { redetect: opts.redetect ?? false });
   let supergroupId;
   let detectedUserId;
   if (groupDecision === "reuse") {
     supergroupId = existingCfg.supergroupId;
-    console.log(chalk30.green(`Using existing group: ${supergroupId}`));
+    console.log(chalk31.green(`Using existing group: ${supergroupId}`));
     console.log();
   } else {
     console.log("Add the bot to your forum supergroup, then send any message in it.");
-    console.log(chalk30.dim("Waiting for a message (up to 60s)\u2026"));
+    console.log(chalk31.dim("Waiting for a message (up to 60s)\u2026"));
     try {
       ({ supergroupId, userId: detectedUserId } = await detectGroupAndUser(client, { timeoutMs: 6e4 }));
     } catch {
-      console.error(chalk30.red("Timed out \u2014 no supergroup message received within 60s."));
-      console.error(chalk30.yellow("Check: bot is an admin in the group \xB7 privacy mode is OFF \xB7 Topics enabled"));
+      console.error(chalk31.red("Timed out \u2014 no supergroup message received within 60s."));
+      console.error(chalk31.yellow("Check: bot is an admin in the group \xB7 privacy mode is OFF \xB7 Topics enabled"));
       process.exit(1);
     }
-    console.log(chalk30.green(`Found group: ${supergroupId}`));
+    console.log(chalk31.green(`Found group: ${supergroupId}`));
     console.log();
   }
-  console.log(chalk30.bold("Step 3/3 \u2014 Remote control + Save"));
-  console.log(chalk30.dim("Remote control enables auto-launching captains and the General command channel"));
-  console.log(chalk30.dim("from your phone \u2014 gated to your Telegram user-id only (fail-closed)."));
+  console.log(chalk31.bold("Step 3/3 \u2014 Remote control + Save"));
+  console.log(chalk31.dim("Remote control enables auto-launching captains and the General command channel"));
+  console.log(chalk31.dim("from your phone \u2014 gated to your Telegram user-id only (fail-closed)."));
   const finalUserId = resolveSetupUserId(opts.userId, detectedUserId, defaultStateRoot());
   let users;
   let remoteControl;
@@ -15308,32 +15808,32 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
       remoteControl = true;
     }
   } else if (groupDecision === "detect") {
-    console.log(chalk30.yellow("Could not read your user-id from that message \u2014 skipping remote control."));
-    console.log(chalk30.yellow("Re-run with --user-id <id> to enable, or edit telegram.users in config manually."));
+    console.log(chalk31.yellow("Could not read your user-id from that message \u2014 skipping remote control."));
+    console.log(chalk31.yellow("Re-run with --user-id <id> to enable, or edit telegram.users in config manually."));
     printedRemoteControlState = true;
   } else {
     const existingUsers = existingCfg?.users;
     if (existingUsers && existingUsers.length > 0) {
-      console.log(chalk30.dim(`Remote control: already configured (user-id ${existingUsers[0]}). Use --user-id to update.`));
+      console.log(chalk31.dim(`Remote control: already configured (user-id ${existingUsers[0]}). Use --user-id to update.`));
     } else {
-      console.log(chalk30.dim("Remote control: off. Re-run with --user-id <id> to enable."));
+      console.log(chalk31.dim("Remote control: off. Re-run with --user-id <id> to enable."));
     }
     printedRemoteControlState = true;
   }
   writeTelegramConfig(DEFAULT_CONFIG_PATH, { token, supergroupId, users, remoteControl });
-  console.log(chalk30.green(`Wrote telegram config \u2014 token: ${maskToken(token)}  group: ${supergroupId}`));
+  console.log(chalk31.green(`Wrote telegram config \u2014 token: ${maskToken(token)}  group: ${supergroupId}`));
   if (!printedRemoteControlState) {
     if (remoteControl) {
-      console.log(chalk30.green(`Remote control: ON (allowlisted user-id ${users[0]})`));
+      console.log(chalk31.green(`Remote control: ON (allowlisted user-id ${users[0]})`));
     } else {
-      console.log(chalk30.dim("Remote control: off (default). Re-run with --user-id <id> to enable."));
+      console.log(chalk31.dim("Remote control: off (default). Re-run with --user-id <id> to enable."));
     }
   }
   try {
     await runRegisterCommands({ client });
-    console.log(chalk30.dim("Registered the /command menu."));
+    console.log(chalk31.dim("Registered the /command menu."));
   } catch (e) {
-    console.log(chalk30.yellow(`command-menu registration skipped: ${e.message}`));
+    console.log(chalk31.yellow(`command-menu registration skipped: ${e.message}`));
   }
   const topics = loadState(defaultStateRoot()).topics;
   const topicEntries = Object.entries(topics);
@@ -15342,28 +15842,28 @@ telegramCommand.command("setup").description("Interactive wizard \u2014 bot toke
       const project = key.slice(0, key.indexOf("::"));
       return `${project}\u2192${id}`;
     }).join(", ");
-    console.log(chalk30.dim(`Existing topics: ${summary} (already created \u2014 not recreated)`));
+    console.log(chalk31.dim(`Existing topics: ${summary} (already created \u2014 not recreated)`));
   } else {
-    console.log(chalk30.dim("No project topics yet \u2014 they're created on first delivery or via: squadrant telegram link <project>"));
+    console.log(chalk31.dim("No project topics yet \u2014 they're created on first delivery or via: squadrant telegram link <project>"));
   }
   runTelegramPostSetup({});
   console.log();
-  console.log(`Next: ${chalk30.cyan("squadrant telegram link <project>")}`);
+  console.log(`Next: ${chalk31.cyan("squadrant telegram link <project>")}`);
 });
 telegramCommand.command("register-commands").description("Register (or re-register) the bot's / command menu with Telegram").action(async () => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk30.red("telegram config absent \u2014 run: squadrant telegram setup"));
+    console.error(chalk31.red("telegram config absent \u2014 run: squadrant telegram setup"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk30.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk31.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   await runRegisterCommands({ client });
-  console.log(chalk30.green(`registered ${BOT_COMMANDS.length} bot commands`));
+  console.log(chalk31.green(`registered ${BOT_COMMANDS.length} bot commands`));
 });
 telegramCommand.command("notify").argument("[project]", "project to toggle").argument("[state]", "on | off | crew | cap").argument("[value]", "tier for crew (all|alert_only|done_only|none) or on|off for cap").option("--status", "list notification state for all projects").description("Live on|off (state), or crew <tier> / cap <on|off> preference (per-project config)").action(async (project, state, value, opts) => {
   const stateRoot = defaultStateRoot();
@@ -15374,7 +15874,7 @@ telegramCommand.command("notify").argument("[project]", "project to toggle").arg
       return;
     }
     for (const r of rows) {
-      console.log(`  ${r.project}: ${r.active ? chalk30.green("on") : chalk30.dim("off (muted)")}`);
+      console.log(`  ${r.project}: ${r.active ? chalk31.green("on") : chalk31.dim("off (muted)")}`);
     }
     return;
   }
@@ -15383,53 +15883,53 @@ telegramCommand.command("notify").argument("[project]", "project to toggle").arg
   const token = tgCfg?.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (state === "crew" || state === "cap") {
     if (value === void 0) {
-      console.error(chalk30.red(`usage: squadrant telegram notify <project> ${state} <value>`));
+      console.error(chalk31.red(`usage: squadrant telegram notify <project> ${state} <value>`));
       process.exit(1);
     }
     const resolved2 = resolveNotify(globalNotify, loadProjectOverride(project));
     const before2 = { ...resolved2, active: isNotifyActive(stateRoot, project) };
     const res = runTelegramNotifyPref({ project, dimension: state, value });
     if (!res.ok) {
-      console.error(chalk30.red(res.message));
+      console.error(chalk31.red(res.message));
       process.exit(1);
     }
-    console.log(chalk30.green(`${project} ${state} = ${value}`));
+    console.log(chalk31.green(`${project} ${state} = ${value}`));
     const after2 = state === "crew" ? { ...before2, crew: value } : { ...before2, cap: value === "on" };
     if (tgCfg && token) {
       const client = createTelegramClient({ token });
       const sent = await runNotifyConfirmation({ project, before: before2, after: after2, cfg: tgCfg, client, stateRoot });
-      if (sent) console.log(chalk30.dim(`\u2192 notified ${project} topic`));
+      if (sent) console.log(chalk31.dim(`\u2192 notified ${project} topic`));
     }
     return;
   }
   if (state !== "on" && state !== "off") {
-    console.error(chalk30.red("usage: squadrant telegram notify <project> <on|off|crew <tier>|cap <on|off>>"));
+    console.error(chalk31.red("usage: squadrant telegram notify <project> <on|off|crew <tier>|cap <on|off>>"));
     process.exit(1);
   }
   const resolved = resolveNotify(globalNotify, loadProjectOverride(project));
   const before = { ...resolved, active: isNotifyActive(stateRoot, project) };
   const after = { ...before, active: state === "on" };
   runTelegramNotifySet({ project, active: state === "on", stateRoot });
-  console.log(chalk30.green(`${project} notifications ${state === "on" ? "ON" : "OFF"}`));
+  console.log(chalk31.green(`${project} notifications ${state === "on" ? "ON" : "OFF"}`));
   if (tgCfg && token) {
     const client = createTelegramClient({ token });
     const sent = await runNotifyConfirmation({ project, before, after, cfg: tgCfg, client, stateRoot });
-    if (sent) console.log(chalk30.dim(`\u2192 notified ${project} topic`));
+    if (sent) console.log(chalk31.dim(`\u2192 notified ${project} topic`));
   }
 });
 telegramCommand.command("send").argument("<project>", "project whose topic receives the message").argument("[message...]", "message text (omit to read from stdin)").description("Send a message to a project's linked Telegram topic").action(async (project, messageParts) => {
   const cfg = loadConfig().telegram;
   if (!cfg) {
-    console.error(chalk30.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
+    console.error(chalk31.red("telegram config absent \u2014 add a `telegram` block to ~/.config/squadrant/config.json"));
     process.exit(1);
   }
   const token = cfg.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
   if (!token) {
-    console.error(chalk30.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
+    console.error(chalk31.red("no botToken in config and TELEGRAM_BOT_TOKEN is unset"));
     process.exit(1);
   }
   if (!capAllowed(project, cfg.notify)) {
-    console.log(chalk30.dim(`${project}: captain messages muted (cap=off) \u2014 not sent`));
+    console.log(chalk31.dim(`${project}: captain messages muted (cap=off) \u2014 not sent`));
     return;
   }
   let message;
@@ -15442,19 +15942,19 @@ telegramCommand.command("send").argument("<project>", "project whose topic recei
     for await (const line of rl) lines.push(line);
     message = lines.join("\n").trimEnd();
     if (!message) {
-      console.error(chalk30.red("no message provided (stdin was empty)"));
+      console.error(chalk31.red("no message provided (stdin was empty)"));
       process.exit(1);
     }
   } else {
-    console.error(chalk30.red("message required \u2014 pass as argument or pipe via stdin"));
+    console.error(chalk31.red("message required \u2014 pass as argument or pipe via stdin"));
     process.exit(1);
   }
   const client = createTelegramClient({ token });
   try {
     const { chatId, topicId } = await runTelegramSend({ project, message, cfg, client, stateRoot: defaultStateRoot() });
-    console.log(chalk30.green(`sent to group ${chatId} topic ${topicId}`));
+    console.log(chalk31.green(`sent to group ${chatId} topic ${topicId}`));
   } catch (e) {
-    console.error(chalk30.red(e.message));
+    console.error(chalk31.red(e.message));
     process.exit(1);
   }
 });
@@ -15462,10 +15962,92 @@ telegramCommand.command("send").argument("<project>", "project whose topic recei
 // packages/cli/src/commands/hooks.ts
 init_dist2();
 init_dist4();
-import { Command as Command31 } from "commander";
-import { join as join28 } from "path";
-import { homedir as homedir20 } from "os";
-var SOCK4 = join28(homedir20(), ".config", "squadrant", "squadrant.sock");
+init_dist();
+import { Command as Command32 } from "commander";
+import { join as join29 } from "path";
+import { homedir as homedir21 } from "os";
+
+// packages/cli/src/lib/captain-session-registry.ts
+import fs28 from "fs";
+import path29 from "path";
+
+// packages/cli/src/lib/handoff-facts.ts
+var STALE_FETCH_WARNING_MS = 24 * 60 * 60 * 1e3;
+var SESSION_WINDOW_MS = 7 * 24 * 60 * 60 * 1e3;
+function staleWarning(live) {
+  if (live.aheadOfBaseSource !== "local-git") return null;
+  if (live.fetchAgeMs === null) {
+    return "aheadOfBase came from local git with no known last-fetch time \u2014 treat as possibly stale";
+  }
+  if (live.fetchAgeMs > STALE_FETCH_WARNING_MS) {
+    const hours = Math.round(live.fetchAgeMs / 36e5);
+    return `aheadOfBase came from local git, last fetched ${hours}h ago \u2014 may be stale`;
+  }
+  return null;
+}
+function sourceAvailability(live, claudeMem, checkpoint, gapSessions) {
+  const available = [];
+  const missing = [];
+  const liveHasData = live.openPRs.length > 0 || live.liveCrews.length > 0 || live.aheadOfBaseSource !== "unknown" || live.recentCommits.length > 0;
+  (liveHasData ? available : missing).push("liveRepo");
+  const claudeMemHasData = !!claudeMem && (claudeMem.latestSessionSummary !== null || claudeMem.recentDecisions.length > 0);
+  (claudeMemHasData ? available : missing).push("claudeMem");
+  (checkpoint ? available : missing).push("checkpoint");
+  (gapSessions.length > 0 ? available : missing).push("gapSessions");
+  return { available, missing };
+}
+function assembleHandoffFacts(live, claudeMem, gapSessions, checkpoint, now, extras = {}) {
+  const sortedGap = [...gapSessions].sort((a, b) => Date.parse(b.session.startedAt) - Date.parse(a.session.startedAt));
+  const { available, missing } = sourceAvailability(live, claudeMem, checkpoint, sortedGap);
+  return {
+    meta: {
+      generatedAt: now,
+      checkpointFilename: checkpoint?.filename ?? null,
+      usedFallbackWindow: extras.usedFallbackWindow ?? false,
+      fallbackWindowMs: extras.usedFallbackWindow ? extras.fallbackWindowMs ?? SESSION_WINDOW_MS : null,
+      gapSessionIds: sortedGap.map((s) => s.session.sessionId),
+      sourcesAvailable: available,
+      sourcesMissing: missing,
+      registryNote: extras.registryNote ?? null
+    },
+    liveRepo: { ...live, staleWarning: staleWarning(live) },
+    claudeMem,
+    checkpoint,
+    gapSessions: sortedGap
+  };
+}
+
+// packages/cli/src/lib/captain-session-registry.ts
+var CAPTAIN_SESSION_REGISTRY_FILE = "captain-sessions.jsonl";
+function appendCaptainSession(spokeVault, record) {
+  fs28.mkdirSync(spokeVault, { recursive: true });
+  const file = path29.join(spokeVault, CAPTAIN_SESSION_REGISTRY_FILE);
+  fs28.appendFileSync(file, JSON.stringify(record) + "\n");
+}
+function readCaptainSessionRegistry(spokeVault) {
+  const file = path29.join(spokeVault, CAPTAIN_SESSION_REGISTRY_FILE);
+  if (!fs28.existsSync(file)) return [];
+  const records = [];
+  for (const line of fs28.readFileSync(file, "utf-8").split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      records.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  return records;
+}
+function selectGapSessions(records, currentSessionId, checkpoint, now, fallbackWindowMs = SESSION_WINDOW_MS) {
+  const excludingCurrent = records.filter((r) => r.sessionId !== currentSessionId);
+  const filtered = checkpoint ? excludingCurrent.filter((r) => Date.parse(r.startedAt) > now - checkpoint.ageMs) : excludingCurrent.filter((r) => now - Date.parse(r.startedAt) <= fallbackWindowMs);
+  return {
+    gapSessions: filtered.sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt)),
+    usedFallbackWindow: !checkpoint
+  };
+}
+
+// packages/cli/src/commands/hooks.ts
+var SOCK4 = join29(homedir21(), ".config", "squadrant", "squadrant.sock");
 async function sendToSock(req) {
   await sendRequest(SOCK4, req);
 }
@@ -15488,14 +16070,31 @@ function mapHookSub(sub, payload, taskId) {
       return null;
   }
 }
+function buildCaptainSessionRecord(payload, project, fallbackCwd, now) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const p = payload;
+  const sessionId = typeof p.session_id === "string" && p.session_id ? p.session_id : null;
+  if (!sessionId) return null;
+  const cwd = typeof p.cwd === "string" && p.cwd ? p.cwd : fallbackCwd;
+  const transcriptPath = (typeof p.transcript_path === "string" && p.transcript_path ? p.transcript_path : null) ?? deriveTranscriptPath(sessionId, cwd) ?? "";
+  return { sessionId, project, agent: "claude", startedAt: now, cwd, transcriptPath };
+}
+function recordCaptainSessionStart(payload) {
+  try {
+    const config = loadConfig();
+    const project = resolveCurrentProject(config);
+    if (!project) return;
+    const proj = config.projects[project];
+    if (!proj) return;
+    const record = buildCaptainSessionRecord(payload, project, process.cwd(), (/* @__PURE__ */ new Date()).toISOString());
+    if (!record) return;
+    appendCaptainSession(proj.spokeVault, record);
+  } catch {
+  }
+}
 function hooksCommand() {
-  const hooks = new Command31("hooks").description("(internal) receive lifecycle hook events from agent processes");
+  const hooks = new Command32("hooks").description("(internal) receive lifecycle hook events from agent processes");
   hooks.command("claude <sub>", { hidden: true }).description("internal: bridge a NativeHookSource claude hook to squadrantd").action(async (sub) => {
-    const taskId = process.env.SQUADRANT_CREW_TASK_ID;
-    const project = process.env.SQUADRANT_CREW_PROJECT;
-    if (!taskId || !project) {
-      process.exit(0);
-    }
     let stdin = "";
     try {
       for await (const chunk of process.stdin) stdin += chunk;
@@ -15508,6 +16107,14 @@ function hooksCommand() {
       } catch {
       }
     }
+    if (sub === "session-start" && process.env.SQUADRANT_ROLE === "captain") {
+      recordCaptainSessionStart(payload);
+    }
+    const taskId = process.env.SQUADRANT_CREW_TASK_ID;
+    const project = process.env.SQUADRANT_CREW_PROJECT;
+    if (!taskId || !project) {
+      process.exit(0);
+    }
     const ev = mapHookSub(sub, payload, taskId);
     if (!ev) {
       process.exit(0);
@@ -15521,26 +16128,553 @@ function hooksCommand() {
   return hooks;
 }
 
+// packages/cli/src/commands/work.ts
+init_dist();
+init_dist2();
+import path30 from "path";
+import { Command as Command33 } from "commander";
+import chalk32 from "chalk";
+function detectCurrentProject(config, cwd = process.cwd()) {
+  for (const [name, proj] of Object.entries(config.projects)) {
+    const projPath = resolveHome(proj.path);
+    if (cwd === projPath || cwd.startsWith(projPath + path30.sep)) return name;
+  }
+  return void 0;
+}
+function groupByParent(items) {
+  const byId = new Map(items.map((i) => [i.id, i]));
+  const childrenOf = /* @__PURE__ */ new Map();
+  const roots = [];
+  for (const item of items) {
+    if (item.parent && byId.has(item.parent)) {
+      const list = childrenOf.get(item.parent) ?? [];
+      list.push(item);
+      childrenOf.set(item.parent, list);
+    } else {
+      roots.push(item);
+    }
+  }
+  return { roots, childrenOf };
+}
+function visibleItems(items, includeDone) {
+  if (includeDone) return items;
+  const { childrenOf } = groupByParent(items);
+  const memo = /* @__PURE__ */ new Map();
+  const keep = (item) => {
+    const cached = memo.get(item.id);
+    if (cached !== void 0) return cached;
+    memo.set(item.id, false);
+    const result = !TERMINAL_WORK_STATES.has(item.state) || (childrenOf.get(item.id) ?? []).some(keep);
+    memo.set(item.id, result);
+    return result;
+  };
+  return items.filter(keep);
+}
+function stateColor(state) {
+  switch (state) {
+    case "done":
+      return chalk32.green;
+    case "cancelled":
+      return chalk32.dim;
+    case "blocked":
+      return chalk32.red;
+    case "paused":
+      return chalk32.yellow;
+    default:
+      return chalk32.cyan;
+  }
+}
+function printItem(item, indent) {
+  const color = stateColor(item.state);
+  const line = "  ".repeat(indent) + `${chalk32.dim(item.id)}  ${item.title}  ${color(`[${item.state}]`)}` + (indent === 0 ? chalk32.dim(`  (${item.project})`) : "");
+  console.log(TERMINAL_WORK_STATES.has(item.state) ? chalk32.dim(line) : line);
+}
+function printTree(items) {
+  const { roots, childrenOf } = groupByParent(items);
+  const walk = (item, depth) => {
+    printItem(item, depth);
+    for (const child of childrenOf.get(item.id) ?? []) walk(child, depth + 1);
+  };
+  for (const root of roots) walk(root, 0);
+}
+function printFlat(items) {
+  for (const item of items) printItem(item, 0);
+}
+var startCmd = new Command33("start").description("Start a new work item").argument("<title>", "what you're doing").option("--project <name>", "project this work belongs to (defaults to the current registered project)").option("--parent <id>", "id of the wave/parent item this nests under").option("--tag <tag>", "attach a tag (repeatable)", (v, prev) => [...prev, v], []).action((title, opts) => {
+  const config = loadConfig();
+  const store = createWorkStore();
+  purgeExpiredWorkItems(store);
+  const project = opts.project ?? detectCurrentProject(config);
+  if (!project) {
+    console.error(chalk32.red("No --project given and cwd is not inside a registered project."));
+    process.exit(1);
+  }
+  if (opts.parent && !findWorkItemById(store, opts.parent)) {
+    console.error(chalk32.red(`Parent work item '${opts.parent}' not found.`));
+    process.exit(1);
+  }
+  const item = createWorkItem(store, { project, title, parent: opts.parent ?? null, tags: opts.tag });
+  console.log(chalk32.green(`\u2713 ${item.id}`) + `  ${item.title}` + chalk32.dim(`  (${item.project})`));
+});
+var listCmd2 = new Command33("list").description("List work items").option("--project <name>", "scope to one project").option("--all", "list across every project").option("--tree", "render parent/child nesting").option("--include-done", "include done/cancelled items").action((opts) => {
+  const config = loadConfig();
+  const store = createWorkStore();
+  purgeExpiredWorkItems(store);
+  let items;
+  if (opts.project) {
+    items = store.list(opts.project);
+  } else if (opts.all) {
+    items = store.listAll();
+  } else {
+    const project = detectCurrentProject(config);
+    if (!project) {
+      console.error(chalk32.red("cwd is not inside a registered project \u2014 pass --project or --all."));
+      process.exit(1);
+    }
+    items = store.list(project);
+  }
+  items = visibleItems(items, opts.includeDone ?? false);
+  if (items.length === 0) {
+    console.log(chalk32.dim("\nNo work items.\n"));
+    return;
+  }
+  console.log();
+  if (opts.tree) printTree(items);
+  else printFlat(items);
+  console.log();
+});
+function closeCommand(name, state, flag, key, desc) {
+  return new Command33(name).description(`Mark a work item ${state}`).argument("<id>", "work item id").option(flag, desc).action((id, opts) => {
+    const store = createWorkStore();
+    purgeExpiredWorkItems(store);
+    const item = closeWorkItem(store, id, state, { note: opts[key] });
+    if (!item) {
+      console.error(chalk32.red(`Work item '${id}' not found.`));
+      process.exit(1);
+    }
+    console.log(chalk32.green(`\u2713 ${item.id}`) + `  ${item.title}  ${chalk32.dim(`[${item.state}]`)}`);
+    if (state === "done") {
+      const openChildren = findOpenChildren(store, item.id);
+      if (openChildren.length > 0) {
+        const names = openChildren.map((c) => `${c.id} [${c.state}]`).join(", ");
+        console.log(chalk32.yellow(`\u26A0 still has ${openChildren.length} unfinished child item(s): ${names}`));
+      }
+    }
+  });
+}
+var doneCmd = closeCommand("done", "done", "--note <text>", "note", "closing note");
+var cancelCmd = closeCommand("cancel", "cancelled", "--why <text>", "why", "reason");
+var workCommand = new Command33("work").description("Track your own in-flight work \u2014 persisted, cross-project, cross-session").addCommand(startCmd).addCommand(listCmd2).addCommand(doneCmd).addCommand(cancelCmd);
+
+// packages/cli/src/commands/handoff.ts
+init_dist();
+import { Command as Command34 } from "commander";
+import path33 from "path";
+import os16 from "os";
+
+// packages/cli/src/lib/handoff-live-repo.ts
+init_dist();
+import { execFileSync as execFileSync8 } from "child_process";
+import fs29 from "fs";
+import path31 from "path";
+
+// packages/cli/src/lib/handoff-branch-state.ts
+function tryRun(runner, cmd, args, cwd) {
+  try {
+    return runner.run(cmd, args, cwd);
+  } catch {
+    return null;
+  }
+}
+function parseUpstreamTrack(raw) {
+  if (raw === null) return { upstreamStatus: "unknown", aheadOfUpstream: null, behindUpstream: null };
+  const [upstreamShort = "", track = ""] = raw.trim().split("|");
+  if (!upstreamShort.trim()) return { upstreamStatus: "no-upstream", aheadOfUpstream: null, behindUpstream: null };
+  if (track.includes("[gone]")) return { upstreamStatus: "upstream-gone", aheadOfUpstream: null, behindUpstream: null };
+  const aheadMatch = track.match(/ahead (\d+)/);
+  const behindMatch = track.match(/behind (\d+)/);
+  const ahead = aheadMatch ? Number(aheadMatch[1]) : 0;
+  const behind = behindMatch ? Number(behindMatch[1]) : 0;
+  if (ahead > 0 && behind > 0) return { upstreamStatus: "diverged", aheadOfUpstream: ahead, behindUpstream: behind };
+  if (ahead > 0) return { upstreamStatus: "ahead", aheadOfUpstream: ahead, behindUpstream: 0 };
+  if (behind > 0) return { upstreamStatus: "behind", aheadOfUpstream: 0, behindUpstream: behind };
+  return { upstreamStatus: "up-to-date", aheadOfUpstream: 0, behindUpstream: 0 };
+}
+function gatherMergedIntoBase(runner, projectPath, branch, baseBranch) {
+  if (branch === baseBranch) return null;
+  const originBase = `origin/${baseBranch}`;
+  const originResolved = tryRun(runner, "git", ["-C", projectPath, "rev-parse", "--verify", originBase], projectPath) !== null;
+  const target = originResolved ? originBase : baseBranch;
+  const branchSha = tryRun(runner, "git", ["-C", projectPath, "rev-parse", branch], projectPath);
+  const mergeBaseSha = tryRun(runner, "git", ["-C", projectPath, "merge-base", branch, target], projectPath);
+  if (branchSha === null || mergeBaseSha === null) return null;
+  return branchSha.trim() === mergeBaseSha.trim();
+}
+function gatherDirty(runner, projectPath) {
+  const status = tryRun(runner, "git", ["-C", projectPath, "status", "--porcelain"], projectPath);
+  if (status === null) return null;
+  return status.trim().length > 0;
+}
+function gatherBranchState(runner, projectPath, branch, baseBranch, detached, fetch2) {
+  const fetchPerformed = fetch2 && tryRun(runner, "git", ["-C", projectPath, "fetch", "origin"], projectPath) !== null;
+  const dirtyWorkingTree = gatherDirty(runner, projectPath);
+  if (detached) {
+    return {
+      upstreamStatus: "unknown",
+      aheadOfUpstream: null,
+      behindUpstream: null,
+      mergedIntoBase: null,
+      dirtyWorkingTree,
+      onUnexpectedBranch: false,
+      fetchPerformed
+    };
+  }
+  const trackRaw = tryRun(
+    runner,
+    "git",
+    ["-C", projectPath, "for-each-ref", "--format=%(upstream:short)|%(upstream:track)", `refs/heads/${branch}`],
+    projectPath
+  );
+  const { upstreamStatus, aheadOfUpstream, behindUpstream } = parseUpstreamTrack(trackRaw);
+  return {
+    upstreamStatus,
+    aheadOfUpstream,
+    behindUpstream,
+    mergedIntoBase: gatherMergedIntoBase(runner, projectPath, branch, baseBranch),
+    dirtyWorkingTree,
+    onUnexpectedBranch: branch.startsWith("crew/"),
+    fetchPerformed
+  };
+}
+
+// packages/cli/src/lib/handoff-live-repo.ts
+var RECENT_COMMITS_LIMIT = 15;
+var OPEN_PR_LIMIT = 20;
+var RELEASE_BRANCH = "main";
+var defaultCommandRunner = {
+  run(cmd, args, cwd) {
+    return execFileSync8(cmd, args, { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] });
+  }
+};
+function tryRun2(runner, cmd, args, cwd) {
+  try {
+    return runner.run(cmd, args, cwd);
+  } catch {
+    return null;
+  }
+}
+function tryInt(raw) {
+  if (raw === null) return null;
+  const n = Number.parseInt(raw.trim(), 10);
+  return Number.isFinite(n) ? n : null;
+}
+function gatherGhRepoInfo(runner, projectPath) {
+  const out = tryRun2(runner, "gh", ["repo", "view", "--json", "nameWithOwner,defaultBranchRef"], projectPath);
+  if (!out) return null;
+  try {
+    const parsed = JSON.parse(out);
+    if (!parsed.defaultBranchRef) return null;
+    return { nameWithOwner: parsed.nameWithOwner, defaultBranch: parsed.defaultBranchRef.name };
+  } catch {
+    return null;
+  }
+}
+function gatherOpenPRs(runner, projectPath) {
+  const out = tryRun2(
+    runner,
+    "gh",
+    ["pr", "list", "--json", "number,title,headRefName", "--limit", String(OPEN_PR_LIMIT)],
+    projectPath
+  );
+  if (!out) return [];
+  try {
+    const parsed = JSON.parse(out);
+    return parsed.map((pr) => ({ number: pr.number, title: pr.title, headRefName: pr.headRefName }));
+  } catch {
+    return [];
+  }
+}
+function gatherLiveCrews(tasks) {
+  return tasks.filter((t) => !TERMINAL_STATES.has(t.state)).map((t) => ({ name: t.name ?? t.id, state: t.state, task: t.task, question: t.question }));
+}
+function ghAheadOfBase(runner, projectPath, nameWithOwner, base, branch) {
+  return tryInt(
+    tryRun2(runner, "gh", ["api", `repos/${nameWithOwner}/compare/${base}...${branch}`, "--jq", ".ahead_by"], projectPath)
+  );
+}
+function ghBaseSha(runner, projectPath, nameWithOwner, base) {
+  const out = tryRun2(runner, "gh", ["api", `repos/${nameWithOwner}/commits/${base}`, "--jq", ".sha"], projectPath);
+  return out ? out.trim() : null;
+}
+function localBaseSha(runner, projectPath, base) {
+  const out = tryRun2(runner, "git", ["-C", projectPath, "rev-parse", `origin/${base}`], projectPath);
+  return out ? out.trim() : null;
+}
+function localAheadOfBase(runner, projectPath, base) {
+  return tryInt(tryRun2(runner, "git", ["-C", projectPath, "rev-list", "--count", `origin/${base}..HEAD`], projectPath));
+}
+function readFetchAgeMs(projectPath, now) {
+  try {
+    const stat2 = fs29.statSync(path31.join(projectPath, ".git", "FETCH_HEAD"));
+    return now - stat2.mtime.getTime();
+  } catch {
+    return null;
+  }
+}
+function gatherLiveRepoState(projectPath, fallbackBaseBranch, tasks, runner = defaultCommandRunner, now = Date.now(), fetch2 = false) {
+  const branch = (tryRun2(runner, "git", ["-C", projectPath, "rev-parse", "--abbrev-ref", "HEAD"], projectPath) ?? "").trim();
+  const detached = branch === "HEAD";
+  const log = tryRun2(runner, "git", ["-C", projectPath, "log", `-${RECENT_COMMITS_LIMIT}`, "--oneline"], projectPath) ?? "";
+  const recentCommits = log.split("\n").map((l) => l.trim()).filter(Boolean);
+  const ghInfo = gatherGhRepoInfo(runner, projectPath);
+  const baseBranch = ghInfo?.defaultBranch ?? fallbackBaseBranch;
+  const baseBranchSource = ghInfo ? "gh-api" : "local-fallback";
+  const fetchAgeMs = readFetchAgeMs(projectPath, now);
+  let aheadOfBase = 0;
+  let aheadOfBaseSource = "unknown";
+  if (branch === baseBranch) {
+    aheadOfBase = null;
+    aheadOfBaseSource = "n-a";
+  } else {
+    if (ghInfo && !detached) {
+      const ghAhead = ghAheadOfBase(runner, projectPath, ghInfo.nameWithOwner, baseBranch, branch);
+      if (ghAhead !== null) {
+        aheadOfBase = ghAhead;
+        aheadOfBaseSource = "gh-api";
+      }
+    }
+    if (aheadOfBaseSource === "unknown") {
+      const localAhead = localAheadOfBase(runner, projectPath, baseBranch);
+      if (localAhead !== null) {
+        aheadOfBase = localAhead;
+        aheadOfBaseSource = "local-git";
+      }
+    }
+  }
+  const unreleasedAheadOfReleaseBranch = ghInfo && baseBranch !== RELEASE_BRANCH ? ghAheadOfBase(runner, projectPath, ghInfo.nameWithOwner, RELEASE_BRANCH, baseBranch) : null;
+  const conflicts = [];
+  if (ghInfo) {
+    const ghSha = ghBaseSha(runner, projectPath, ghInfo.nameWithOwner, baseBranch);
+    const localSha = localBaseSha(runner, projectPath, baseBranch);
+    if (ghSha && localSha && ghSha !== localSha) {
+      const ageNote = fetchAgeMs !== null ? `fetched ${Math.round(fetchAgeMs / 36e5)}h ago` : "fetch age unknown";
+      conflicts.push({
+        field: "baseBranch",
+        claim: `local git's last-known ${baseBranch} is ${localSha} (${ageNote})`,
+        fact: `GitHub's live ${baseBranch} is ${ghSha}`,
+        resolution: "GitHub API wins \u2014 local git may be stale"
+      });
+    }
+  }
+  return {
+    branch,
+    detached,
+    baseBranch,
+    baseBranchSource,
+    recentCommits,
+    aheadOfBase,
+    aheadOfBaseSource,
+    fetchAgeMs,
+    openPRs: gatherOpenPRs(runner, projectPath),
+    liveCrews: gatherLiveCrews(tasks),
+    conflicts,
+    branchState: gatherBranchState(runner, projectPath, branch, baseBranch, detached, fetch2),
+    unreleasedAheadOfReleaseBranch
+  };
+}
+
+// packages/cli/src/lib/handoff-claude-mem.ts
+import { createRequire } from "module";
+import fs30 from "fs";
+var { DatabaseSync } = createRequire(import.meta.url)("node:sqlite");
+var CLAUDE_MEM_RECENCY_LIMIT = 20;
+function decisionText(row) {
+  if (row.facts) {
+    try {
+      const parsed = JSON.parse(row.facts);
+      if (Array.isArray(parsed) && parsed.length > 0) return parsed.join("; ");
+    } catch {
+    }
+  }
+  return row.narrative ?? "";
+}
+function queryClaudeMem(dbPath, project) {
+  if (!fs30.existsSync(dbPath)) return null;
+  let db;
+  try {
+    db = new DatabaseSync(dbPath, { readOnly: true });
+  } catch {
+    return null;
+  }
+  try {
+    const summaryRow = db.prepare(
+      `SELECT request, completed, next_steps, created_at FROM session_summaries
+         WHERE project = ? ORDER BY created_at_epoch DESC LIMIT 1`
+    ).get(project);
+    const decisionRows = db.prepare(
+      `SELECT title, narrative, facts, created_at FROM observations
+         WHERE project = ? AND type = 'decision' ORDER BY created_at_epoch DESC LIMIT ?`
+    ).all(project, CLAUDE_MEM_RECENCY_LIMIT);
+    const recentDecisions = decisionRows.map((r) => ({
+      title: r.title,
+      text: decisionText(r),
+      createdAt: r.created_at
+    }));
+    const candidates = [summaryRow?.created_at, ...decisionRows.map((r) => r.created_at)].filter(
+      (v) => !!v
+    );
+    const oldestCreatedAt = candidates.length > 0 ? candidates.reduce((a, b) => a < b ? a : b) : null;
+    return {
+      latestSessionSummary: summaryRow ? {
+        request: summaryRow.request,
+        completed: summaryRow.completed,
+        nextSteps: summaryRow.next_steps,
+        createdAt: summaryRow.created_at
+      } : null,
+      recentDecisions,
+      oldestCreatedAt
+    };
+  } catch {
+    return null;
+  } finally {
+    db.close();
+  }
+}
+
+// packages/cli/src/lib/handoff-transcript.ts
+import fs31 from "fs";
+var TRANSCRIPT_BYTE_CAP = 2e5;
+function tailOf(content, byteCap) {
+  const buf = Buffer.from(content, "utf-8");
+  if (buf.length <= byteCap) return content;
+  const text = buf.subarray(buf.length - byteCap).toString("utf-8");
+  return text.split("\n").slice(1).join("\n");
+}
+function extractMessages(tailText) {
+  let lastUserMessage = null;
+  let lastAssistantText = null;
+  for (const line of tailText.split("\n")) {
+    if (!line.trim()) continue;
+    let obj;
+    try {
+      obj = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (obj.type === "user" && typeof obj.message?.content === "string") {
+      lastUserMessage = obj.message.content;
+    } else if (obj.type === "assistant" && Array.isArray(obj.message?.content)) {
+      const texts = obj.message.content.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text);
+      if (texts.length > 0) lastAssistantText = texts.join("\n");
+    }
+  }
+  return { lastUserMessage, lastAssistantText };
+}
+function extractTranscriptTail(transcriptPath, byteCap = TRANSCRIPT_BYTE_CAP) {
+  if (!fs31.existsSync(transcriptPath)) return null;
+  const content = fs31.readFileSync(transcriptPath, "utf-8");
+  const { lastUserMessage, lastAssistantText } = extractMessages(tailOf(content, byteCap));
+  const mtimeIso = fs31.statSync(transcriptPath).mtime.toISOString();
+  return { path: transcriptPath, mtimeIso, lastUserMessage, lastAssistantText };
+}
+
+// packages/cli/src/lib/handoff-archive.ts
+import fs32 from "fs";
+import path32 from "path";
+function readNewestArchivedHandoff(spokeVault, now) {
+  const dir = path32.join(spokeVault, "handoffs");
+  if (!fs32.existsSync(dir)) return null;
+  const candidates = fs32.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".json")).map((e) => {
+    const full = path32.join(dir, e.name);
+    return { name: e.name, full, mtime: fs32.statSync(full).mtime };
+  }).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  for (const candidate of candidates) {
+    let content;
+    try {
+      content = JSON.parse(fs32.readFileSync(candidate.full, "utf-8"));
+    } catch {
+      continue;
+    }
+    return { filename: candidate.name, path: candidate.full, ageMs: now - candidate.mtime.getTime(), content };
+  }
+  return null;
+}
+
+// packages/cli/src/commands/handoff.ts
+var CLAUDE_MEM_DB_PATH = path33.join(os16.homedir(), ".claude-mem", "claude-mem.db");
+async function defaultFetchTasks(project) {
+  return await squadrantdCall({ kind: "list", project });
+}
+async function runHandoffFacts(project, deps = {}) {
+  const config = loadConfig();
+  const proj = config.projects[project];
+  if (!proj) {
+    throw new Error(`Project '${project}' not found. Run 'squadrant projects list'.`);
+  }
+  const fallbackBaseBranch = resolveWorktreeBase(proj.path);
+  let tasks;
+  try {
+    tasks = await (deps.fetchTasks ?? defaultFetchTasks)(project);
+  } catch {
+    tasks = [];
+  }
+  const nowIso = deps.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const nowMs = Date.parse(nowIso);
+  const fallbackWindowMs = deps.windowMs ?? SESSION_WINDOW_MS;
+  const live = gatherLiveRepoState(proj.path, fallbackBaseBranch, tasks, deps.runner ?? defaultCommandRunner, nowMs, deps.fetch ?? false);
+  const claudeMem = queryClaudeMem(deps.claudeMemDbPath ?? CLAUDE_MEM_DB_PATH, project);
+  const checkpoint = readNewestArchivedHandoff(proj.spokeVault, nowMs);
+  const currentSessionId = deps.currentSessionId !== void 0 ? deps.currentSessionId : process.env.CLAUDE_CODE_SESSION_ID ?? null;
+  let registryNote = null;
+  let gapSessions = [];
+  let usedFallbackWindow = false;
+  if (currentSessionId === null) {
+    registryNote = "current session id unknown (CLAUDE_CODE_SESSION_ID unset) \u2014 cannot safely exclude the running session, so the gap was skipped";
+  } else {
+    const allRecords = readCaptainSessionRegistry(proj.spokeVault);
+    if (allRecords.length === 0) {
+      registryNote = "no session registry found yet for this project (#651's SessionStart hook may not have fired before now)";
+    }
+    const selection = selectGapSessions(allRecords, currentSessionId, checkpoint, nowMs, fallbackWindowMs);
+    usedFallbackWindow = selection.usedFallbackWindow;
+    gapSessions = selection.gapSessions.map((session) => ({ session, transcript: extractTranscriptTail(session.transcriptPath) }));
+  }
+  return assembleHandoffFacts(live, claudeMem, gapSessions, checkpoint, nowIso, {
+    registryNote,
+    usedFallbackWindow,
+    fallbackWindowMs
+  });
+}
+var handoffCommand = new Command34("handoff").description(
+  "Handoff continuity \u2014 gather verified facts for the captain to synthesize a handoff from (#650/#651)"
+);
+handoffCommand.command("facts <project>").description(
+  "Gather structured facts (gh API > local git > claude-mem > registry-attributed session window) \u2014 NOT a handoff. Read-only, pre-rendered JSON on stdout; the caller synthesizes."
+).option("--fetch", "update remote-tracking refs (git fetch origin) before computing branch state \u2014 the only opt-in exception to this command's read-only contract", false).action(async (project, opts) => {
+  const out = await runHandoffFacts(project, { fetch: opts.fetch });
+  console.log(JSON.stringify(out, null, 2));
+});
+
 // packages/cli/src/index.ts
 init_dist();
 init_dist();
 init_dist();
 init_dist();
 var __dirname = dirname9(fileURLToPath6(import.meta.url));
-var pkg = JSON.parse(readFileSync15(join29(__dirname, "..", "package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync16(join30(__dirname, "..", "package.json"), "utf-8"));
 ensureRuntimeSynced({
-  sourceRoot: join29(__dirname, ".."),
-  runtimeRoot: join29(homedir21(), ".config", "squadrant")
+  sourceRoot: join30(__dirname, ".."),
+  runtimeRoot: join30(homedir22(), ".config", "squadrant")
 });
 if (process.argv[2] !== "config") {
   try {
-    const cfgPath = join29(homedir21(), ".config", "squadrant", "config.json");
-    if (existsSync12(cfgPath)) {
-      const cfg = JSON.parse(readFileSync15(cfgPath, "utf-8"));
+    const cfgPath = join30(homedir22(), ".config", "squadrant", "config.json");
+    if (existsSync13(cfgPath)) {
+      const cfg = JSON.parse(readFileSync16(cfgPath, "utf-8"));
       if (needsCheck(cfg, pkg.version)) {
         const items = detectDrift(cfg, getDefaultConfig());
         if (items.length === 0) {
-          writeFileSync11(cfgPath, JSON.stringify(withStamp(cfg, pkg.version), null, 2) + "\n");
+          writeFileSync12(cfgPath, JSON.stringify(withStamp(cfg, pkg.version), null, 2) + "\n");
         } else {
           const from = cfg._squadrantVersion ?? "an earlier version";
           process.stderr.write(
@@ -15558,9 +16692,9 @@ if (process.argv[2] !== "config") {
   }
 }
 if (!process.env.SQUADRANT_DAEMON_SKIP) {
-  ensureDaemon();
+  ensureDaemon(void 0, { operatorInitiated: isOperatorInitiatedCommand(process.argv[2]) });
 }
-var program = new Command32();
+var program = new Command35();
 program.name("squadrant").description("Multi-project orchestration for your coding agents (Claude, Codex, opencode, Gemini)").version(pkg.version);
 program.addCommand(doctorCommand);
 program.addCommand(initCommand);
@@ -15589,8 +16723,11 @@ program.addCommand(pingCommand);
 program.addCommand(dispatchCommand);
 program.addCommand(cmuxCommand);
 program.addCommand(effortCommand);
+program.addCommand(tokensCommand);
 program.addCommand(telegramCommand);
 program.addCommand(hooksCommand());
+program.addCommand(workCommand);
+program.addCommand(handoffCommand);
 program.parseAsync().catch((e) => {
   process.stderr.write(`error: ${e instanceof Error ? e.message : String(e)}
 `);