squadrant 0.17.0 → 0.18.0

package/dist/index.js

@@ -773,6 +773,12 @@ function ensureSpotlightExcluded(repoRoot, worktreeDir) {
   }
 }
 function resolveWorktreeBase(repoRoot, fallback = "develop") {
+  try {
+    const head = execFileSync2("git", ["-C", repoRoot, "rev-parse", "--abbrev-ref", "HEAD"], { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+    if (head && head !== "HEAD")
+      return head;
+  } catch {
+  }
   try {
     const ref = execFileSync2("git", ["-C", repoRoot, "symbolic-ref", "refs/remotes/origin/HEAD"], { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
     const m = ref.match(/^refs\/remotes\/origin\/(.+)$/);
@@ -839,13 +845,17 @@ function installWorktreeDependencies(wt) {
 `);
   }
 }
-function removeWorktree(repoRoot, wtPath) {
+function worktreeDirtyFiles(wtPath) {
   try {
-    execFileSync2("git", ["-C", repoRoot, "worktree", "remove", wtPath], { stdio: "pipe" });
+    return execFileSync2("git", ["-C", wtPath, "status", "--porcelain", "--untracked-files=all"], { stdio: ["ignore", "pipe", "ignore"] }).toString().split("\n").map((l) => l.slice(3).trim()).filter(Boolean);
   } catch {
-    execFileSync2("git", ["-C", repoRoot, "worktree", "remove", "--force", wtPath], { stdio: "pipe" });
+    return [];
   }
 }
+function removeWorktree(repoRoot, wtPath, opts) {
+  const args = ["-C", repoRoot, "worktree", "remove", ...opts?.force ? ["--force"] : [], wtPath];
+  execFileSync2("git", args, { stdio: "pipe" });
+}
 var init_git_worktree = __esm({
   "packages/shared/dist/lib/git-worktree.js"() {
   }
@@ -977,7 +987,7 @@ function ensureRuntimeSynced(opts) {
 var CREW_SKILLS, MANAGED_TARGETS;
 var init_runtime_sync = __esm({
   "packages/shared/dist/lib/runtime-sync.js"() {
-    CREW_SKILLS = ["karpathy-principles"];
+    CREW_SKILLS = ["karpathy-principles", "takeover", "handback"];
     MANAGED_TARGETS = [
       { name: "plugin", srcRel: "plugin", mode: "tree" },
       { name: "plugin-crew", srcRel: "plugin", mode: "subset", skills: CREW_SKILLS },
@@ -1302,6 +1312,7 @@ __export(dist_exports, {
   saveConfig: () => saveConfig,
   saveProjectOverride: () => saveProjectOverride,
   withStamp: () => withStamp,
+  worktreeDirtyFiles: () => worktreeDirtyFiles,
   worktreePath: () => worktreePath,
   writeUpdateCheckState: () => writeUpdateCheckState
 });
@@ -1361,7 +1372,21 @@ function nextPendingMonitor(current, ev, now) {
 }
 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 };
+    return { ...rec, state: "working", question: void 0, error: void 0, lastHeartbeat: now, lastEvent: ev.type, workingStretchStartedAt: now };
+  }
+  if (ev.type === "crew.takeover.started") {
+    if (rec.operatorHold)
+      return { ...rec, lastHeartbeat: now, lastEvent: ev.type };
+    return {
+      ...rec,
+      operatorHold: { since: now, ...ev.note !== void 0 ? { note: ev.note } : {} },
+      lastHeartbeat: now,
+      lastEvent: ev.type
+    };
+  }
+  if (ev.type === "crew.takeover.ended") {
+    const { operatorHold: _dropped, ...rest } = rec;
+    return { ...rest, lastHeartbeat: now, lastEvent: ev.type };
   }
   if (TERMINAL_STATES.has(rec.state))
     return rec;
@@ -1377,8 +1402,9 @@ function reduce(rec, ev, now) {
         // resuming after a blocked→reply clears the question
         pendingTool: void 0,
         // #354: a new turn closes any prior tool window
-        pendingMonitor: void 0
+        pendingMonitor: void 0,
         // #594a: same reset — a new turn moots any prior watch
+        workingStretchStartedAt: now
       };
     case "task.progress": {
       const pendingTool = nextPendingTool(rec.pendingTool, ev, now);
@@ -1549,6 +1575,8 @@ function firePush(deps, project, prev, next, event, lastCaptainTurnAt) {
     return;
   if (!ATTENTION_STATES.has(next.state))
     return;
+  if (next.operatorHold)
+    return;
   if (next.state === "awaiting-input" && lastCaptainTurnAt != null && deps.now() - lastCaptainTurnAt <= IDLE_DEBOUNCE_MS) {
     return;
   }
@@ -1757,9 +1785,32 @@ function createDaemon(deps) {
           store.delete(r.project, r.id);
           continue;
         }
+        if (r.operatorHold) {
+          const threshold = (deps.takeoverNudgeHours ?? 6) * 36e5;
+          const holdAge = t - r.operatorHold.since;
+          if (holdAge > threshold) {
+            const timeSinceLastNudge = t - (r.operatorHold.lastNudgeAt ?? 0);
+            if (timeSinceLastNudge > threshold) {
+              const hrs = Math.round(holdAge / 36e5);
+              const tag = crewTag(r);
+              const message = `CREW HELD-LONG ${tag} \u2014 held ${hrs}h. Ask the operator whether it is still in use. Do not release it yourself.`;
+              store.put({ ...r, operatorHold: { ...r.operatorHold, lastNudgeAt: t } });
+              if (deps.notify) {
+                try {
+                  const p = deps.notify({ project: r.project, message, record: r, event: { type: "task.progress", id: r.id } });
+                  if (p && typeof p.catch === "function")
+                    p.catch(() => {
+                    });
+                } catch {
+                }
+              }
+            }
+          }
+        }
         if (!TERMINAL_STATES.has(r.state) && !isStickyAttention(r.state)) {
           const ceiling = deps.taskTimeoutMs ?? DEFAULT_TASK_TIMEOUT_MS;
-          if (t - r.createdAt > ceiling) {
+          const refTime = r.workingStretchStartedAt ?? r.createdAt;
+          if (t - refTime > ceiling) {
             const prevState = r.state;
             const tag = crewTag(r);
             const hrs = Math.round(ceiling / 36e5);
@@ -1913,8 +1964,11 @@ var init_reduce = __esm({
       "task.reconcile-failed",
       "task.cancelled",
       "task.session.ended",
-      "task.first-turn.confirmed"
+      "task.first-turn.confirmed",
       // #466: delivery confirmation
+      "crew.takeover.started",
+      "crew.takeover.ended"
+      // #649: operator takeover
     ]);
   }
 });
@@ -3198,7 +3252,9 @@ function buildContext(opts) {
   const sockPath = opts.sockPath ?? join9(homedir6(), ".config", "squadrant", "squadrant.sock");
   const store = createStore(stateRoot);
   const bootedAt = Date.now();
-  const taskTimeoutMs = loadConfig().defaults.taskTimeoutMs;
+  const config = loadConfig();
+  const taskTimeoutMs = config.defaults.taskTimeoutMs;
+  const takeoverNudgeHours = config.defaults.takeoverNudgeHours;
   const isPidAlive = opts.isPidAlive ?? defaultIsPidAlive;
   const spawn2 = opts.spawn ?? realSpawn;
   const resultsDir = join9(stateRoot, "_results");
@@ -3218,6 +3274,7 @@ function buildContext(opts) {
     bootedAt,
     lastSweepAt: { value: null },
     taskTimeoutMs,
+    takeoverNudgeHours,
     isPidAlive,
     spawn: spawn2,
     resultsDir,
@@ -4068,6 +4125,7 @@ function startDaemon(ctx, opts, pkgVersion) {
     isPidAlive,
     notify,
     taskTimeoutMs,
+    takeoverNudgeHours: ctx.takeoverNudgeHours,
     isSurfaceAlive: surfaceProbe,
     resendFirstTurn: ctx.resendFirstTurn,
     launchHeadless: opts.launchHeadless,
@@ -6008,12 +6066,17 @@ async function runCrewSpawn(input, config, deps) {
     }
   }
   const name = input.name ?? nextAutoName(existingTitles, input.project);
+  let base = "";
+  if (!input.shared) {
+    base = resolveWorktreeBase(proj.path);
+    deps.onBaseResolved?.(base);
+  }
   const spawnCwd = !input.shared ? addWorktree({
     repoRoot: proj.path,
     worktreeDir: config.defaults.worktreeDir ?? ".worktrees",
     project: input.project,
     name,
-    base: resolveWorktreeBase(proj.path)
+    base
   }) : proj.path;
   let firstTurnTask = input.task;
   if (input.taskFile && input.taskFile !== "-" && !input.shared) {
@@ -6181,7 +6244,7 @@ ${buildCompletionProtocol(rec.id, input.project)}`, preLaunchScreen, {
 function pickMostRecentTask(tasks) {
   return tasks.reduce((a, b) => (b.createdAt ?? 0) > (a.createdAt ?? 0) ? b : a);
 }
-async function runCrewSend(project, name, message, runtime, workspaceId, deps) {
+async function runCrewSend(project, name, message, runtime, workspaceId, deps, opts) {
   const crew = await findCrewPane(runtime, workspaceId, project, name);
   if (!crew) {
     throw new Error(`Crew '${name}' not found for ${project}. Run 'squadrant crew list ${project}'.`);
@@ -6190,9 +6253,17 @@ async function runCrewSend(project, name, message, runtime, workspaceId, deps) {
   if (deps.isBlockedByModal && await deps.isBlockedByModal(crew)) {
     throw new Error(blockedByModalMessage());
   }
+  let task;
   try {
     const matches = (await deps.listTasks(project)).filter((t) => t.name === name);
-    const task = matches.length > 0 ? pickMostRecentTask(matches) : void 0;
+    task = matches.length > 0 ? pickMostRecentTask(matches) : void 0;
+  } catch {
+  }
+  if (task && task.operatorHold && !opts?.force) {
+    const heldForMin = Math.round((Date.now() - task.operatorHold.since) / 6e4);
+    throw new Error(`Crew '${name}' is under operator takeover (held ${heldForMin}m${task.operatorHold.note ? `: ${task.operatorHold.note}` : ""}). The operator is working in that tab \u2014 sending a message disrupts their conversation. Ask them to run 'squadrant crew handback ${project} ${name}', or pass --force if they told you to.`);
+  }
+  try {
     if (task) {
       if (TERMINAL_STATES.has(task.state)) {
         await deps.emitEvent(project, { type: "task.reopened", id: task.id });
@@ -6218,23 +6289,60 @@ async function runCrewRead(project, name, runtime, workspaceId) {
   }
   return runtime.readPaneScreen(crew);
 }
-async function runCrewClose(project, name, runtime, workspaceId, deps) {
+function buildRecoveryHint(sessId, provider, worktreeCwd) {
+  if (!sessId || !worktreeCwd)
+    return "";
+  if (provider === "claude") {
+    const escaped = worktreeCwd.replace(/[^a-zA-Z0-9]/g, "-");
+    const transcriptPath = path11.join(os5.homedir(), ".claude", "projects", escaped, `${sessId}.jsonl`);
+    return `
+transcript: ${transcriptPath}
+resume:     claude --resume ${sessId}   (run from the worktree path above)
+`;
+  }
+  return "";
+}
+async function runCrewClose(project, name, runtime, workspaceId, deps, opts) {
   const sleep3 = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   const projRoot = loadConfig().projects[project]?.path;
-  let taskId;
-  let worktreeCwd;
+  let matches = [];
   try {
-    let matches = (await deps.listTasks(project)).filter((t) => t.name === name);
+    matches = (await deps.listTasks(project)).filter((t) => t.name === name);
     for (let attempt = 0; attempt < CLOSE_LOOKUP_RETRIES && matches.length === 0; attempt++) {
       await sleep3(CLOSE_LOOKUP_RETRY_DELAY_MS);
       matches = (await deps.listTasks(project)).filter((t) => t.name === name);
     }
-    if (matches.length > 0) {
-      const primary = pickMostRecentTask(matches);
-      taskId = primary.id;
-      if (primary.cwd && projRoot && primary.cwd !== projRoot) {
-        worktreeCwd = primary.cwd;
-      }
+  } catch {
+  }
+  let taskId;
+  let worktreeCwd;
+  let sessId;
+  let provider;
+  if (matches.length > 0) {
+    const primary = pickMostRecentTask(matches);
+    taskId = primary.id;
+    sessId = primary.sessionId;
+    provider = primary.provider;
+    if (primary.cwd && projRoot && primary.cwd !== projRoot) {
+      worktreeCwd = primary.cwd;
+    }
+    if (primary.operatorHold && !opts?.force) {
+      const heldForMin = Math.round((Date.now() - primary.operatorHold.since) / 6e4);
+      throw new Error(`Crew '${name}' is under operator takeover (held ${heldForMin}m${primary.operatorHold.note ? `: ${primary.operatorHold.note}` : ""}). The operator is working in that tab \u2014 closing it kills their session and prunes the worktree. Ask them to run 'squadrant crew handback ${project} ${name}', or pass --force if they told you to.`);
+    }
+  }
+  if (worktreeCwd && projRoot) {
+    const dirty = worktreeDirtyFiles(worktreeCwd);
+    if (dirty.length > 0 && !opts?.force) {
+      const transcriptStr = buildRecoveryHint(sessId, provider, worktreeCwd);
+      throw new Error(`Worktree '${worktreeCwd}' has uncommitted files:
+${dirty.map((f) => `  ${f}`).join("\n")}
+Why are they uncommitted? Commit them, or pass --force to destroy them.
+${transcriptStr}`);
+    }
+  }
+  if (matches.length > 0) {
+    try {
       for (const task of matches) {
         if (!TERMINAL_STATES.has(task.state)) {
           await deps.emitEvent(project, { type: "task.cancelled", id: task.id, reason: "closed by captain" });
@@ -6243,8 +6351,8 @@ async function runCrewClose(project, name, runtime, workspaceId, deps) {
           await deps.closeCodexThread(task.id);
         }
       }
+    } catch {
     }
-  } catch {
   }
   const crew = await findCrewPane(runtime, workspaceId, project, name);
   if (crew) {
@@ -6257,12 +6365,16 @@ async function runCrewClose(project, name, runtime, workspaceId, deps) {
   }
   if (worktreeCwd && projRoot) {
     try {
-      removeWorktree(projRoot, worktreeCwd);
+      removeWorktree(projRoot, worktreeCwd, opts);
     } catch (e) {
       process.stderr.write(`(worktree remove failed: ${e.message})
 `);
     }
   }
+  const hint = buildRecoveryHint(sessId, provider, worktreeCwd);
+  if (hint) {
+    process.stdout.write(hint);
+  }
 }
 async function runCrewList(project, runtime, workspaceId) {
   const crews = await listCrewPanes(runtime, workspaceId, project);
@@ -10269,8 +10381,8 @@ var require_daemon_exports = {};
 __export(require_daemon_exports, {
   requireDaemon: () => requireDaemon
 });
-import { join as join25 } from "path";
-import { homedir as homedir20 } from "os";
+import { join as join22 } from "path";
+import { homedir as homedir17 } from "os";
 async function requireDaemon(sockPath = DEFAULT_SOCK_PATH3) {
   const isLive = await isDaemonSocketLive(sockPath);
   if (!isLive) {
@@ -10281,7 +10393,168 @@ var DEFAULT_SOCK_PATH3;
 var init_require_daemon = __esm({
   "packages/cli/src/lib/require-daemon.ts"() {
     init_dist2();
-    DEFAULT_SOCK_PATH3 = join25(homedir20(), ".config", "squadrant", "squadrant.sock");
+    DEFAULT_SOCK_PATH3 = join22(homedir17(), ".config", "squadrant", "squadrant.sock");
+  }
+});
+
+// packages/cli/src/commands/runtime.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  buildRegistry: () => buildRegistry,
+  needRef: () => needRef,
+  resolveTarget: () => resolveTarget,
+  runRuntimeSend: () => runRuntimeSend,
+  runtimeCommand: () => runtimeCommand
+});
+import { Command as Command8 } from "commander";
+import chalk9 from "chalk";
+function buildRegistry() {
+  return new RuntimeRegistry({
+    cmux: createCmuxDriver()
+  });
+}
+function resolveTarget(registry, config, target, useCommand) {
+  if (useCommand) {
+    return {
+      driver: registry.global(config),
+      workspaceName: config.commandName
+    };
+  }
+  if (!target) {
+    throw new Error("Missing target: pass a project name or use --command");
+  }
+  const proj = config.projects[target];
+  if (!proj) {
+    throw new Error(`Project '${target}' not found. Run 'squadrant projects list'.`);
+  }
+  return {
+    driver: registry.forProject(target, config),
+    workspaceName: proj.captainName
+  };
+}
+async function needRef(resolved) {
+  const ref = await resolved.driver.status(resolved.workspaceName);
+  if (!ref) {
+    throw new Error(`Workspace '${resolved.workspaceName}' is not running`);
+  }
+  return ref.id;
+}
+async function runRuntimeSend(arg1, arg2, opts, confirmOpts) {
+  const config = loadConfig();
+  const registry = buildRegistry();
+  if (opts.command && arg2 !== void 0) {
+    throw new Error("With --command, pass only the message (not a project name)");
+  }
+  const target = opts.command ? void 0 : arg1;
+  const message = opts.command ? arg1 : arg2;
+  if (!message) throw new Error("Message is required");
+  const { requireDaemon: requireDaemon2 } = await Promise.resolve().then(() => (init_require_daemon(), require_daemon_exports));
+  const { appendCaptainMessage: appendCaptainMessage2, waitForCaptainDelivery: waitForCaptainDelivery2 } = await Promise.resolve().then(() => (init_dist2(), dist_exports2));
+  await requireDaemon2();
+  const resolved = resolveTarget(registry, config, target, !!opts.command);
+  await needRef(resolved);
+  const finalProject = opts.command ? config.commandName : target;
+  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 = join31(dirname10(DEFAULT_CONFIG_PATH2), "state");
+  const seq = await appendCaptainMessage2({
+    stateRoot,
+    project: finalProject,
+    text: message,
+    source: "cli"
+  });
+  const timeoutMs = confirmOpts?.timeoutMs ?? SEND_CONFIRM_TIMEOUT_MS;
+  const delivered = await waitForCaptainDelivery2({
+    stateRoot,
+    project: finalProject,
+    seq,
+    timeoutMs,
+    pollMs: confirmOpts?.pollMs ?? SEND_CONFIRM_POLL_MS
+  });
+  if (!delivered) {
+    throw new Error(
+      `Message queued for '${finalProject}' (seq=${seq}) but delivery was not confirmed within ${Math.round(timeoutMs / 1e3)}s. It may still be pending \u2014 check with 'squadrant runtime read-screen ${finalProject}${opts.command ? " --command" : ""}'.`
+    );
+  }
+}
+var runtimeCommand, SEND_CONFIRM_TIMEOUT_MS, SEND_CONFIRM_POLL_MS;
+var init_runtime2 = __esm({
+  "packages/cli/src/commands/runtime.ts"() {
+    init_dist();
+    init_dist3();
+    runtimeCommand = new Command8("runtime").description("Interact with the runtime layer (workspaces). Bridges bash scripts to the RuntimeDriver.");
+    runtimeCommand.command("status").description("Print 'running' or 'stopped' for a target; exit 0 if running, 1 if not").argument("[target]", "Project name").option("--command", "Target the command workspace instead of a project captain").action(async (target, opts) => {
+      const config = loadConfig();
+      const registry = buildRegistry();
+      try {
+        const resolved = resolveTarget(registry, config, target, !!opts.command);
+        const ref = await resolved.driver.status(resolved.workspaceName);
+        if (ref) {
+          console.log("running");
+          process.exit(0);
+        } else {
+          console.log("stopped");
+          process.exit(1);
+        }
+      } catch (err) {
+        console.error(chalk9.red(err.message));
+        process.exit(2);
+      }
+    });
+    SEND_CONFIRM_TIMEOUT_MS = 15e3;
+    SEND_CONFIRM_POLL_MS = 500;
+    runtimeCommand.command("send").description("Send a message to a target workspace AND commit with Enter. With --command, the first positional is the message.").argument("<arg1>", "Project name, or the message when --command is used").argument("[arg2]", "Message (when target is a project). Omit when using --command.").option("--command", "Target the command workspace").action(async (arg1, arg2, opts) => {
+      try {
+        await runRuntimeSend(arg1, arg2, opts);
+        console.log(chalk9.green("\u2714 Delivered (confirmed)"));
+      } catch (err) {
+        console.error(chalk9.red(err.message));
+        process.exit(1);
+      }
+    });
+    runtimeCommand.command("list").description("List all workspaces from the global runtime").option("-j, --json", "Output as JSON").action(async (opts) => {
+      const config = loadConfig();
+      const registry = buildRegistry();
+      const driver = registry.global(config);
+      const refs = await driver.list();
+      if (opts.json) {
+        console.log(JSON.stringify(refs, null, 2));
+      } else {
+        for (const r of refs) {
+          console.log(`${r.id}	${r.name}	${r.status}`);
+        }
+      }
+    });
+    runtimeCommand.command("read-screen").description("Print a terminal snapshot of a target workspace").argument("[target]", "Project name").option("--command", "Target the command workspace").action(async (target, opts) => {
+      const config = loadConfig();
+      const registry = buildRegistry();
+      try {
+        const resolved = resolveTarget(registry, config, target, !!opts.command);
+        const ref = await needRef(resolved);
+        const screen = await resolved.driver.readScreen(ref);
+        process.stdout.write(screen);
+      } catch (err) {
+        console.error(chalk9.red(err.message));
+        process.exit(1);
+      }
+    });
+    runtimeCommand.command("stop").description("Stop a target workspace").argument("[target]", "Project name").option("--command", "Target the command workspace").action(async (target, opts) => {
+      const config = loadConfig();
+      const registry = buildRegistry();
+      try {
+        const resolved = resolveTarget(registry, config, target, !!opts.command);
+        const ref = await resolved.driver.status(resolved.workspaceName);
+        if (!ref) {
+          console.log(chalk9.yellow(`Workspace '${resolved.workspaceName}' already stopped`));
+          return;
+        }
+        await resolved.driver.stop(ref.id);
+        console.log(chalk9.green(`\u2714 Stopped ${resolved.workspaceName}`));
+      } catch (err) {
+        console.error(chalk9.red(err.message));
+        process.exit(1);
+      }
+    });
   }
 });
 
@@ -11264,20 +11537,20 @@ init_dist();
 init_dist3();
 init_dist4();
 init_dist2();
-import { Command as Command9 } from "commander";
-import chalk9 from "chalk";
+import { Command as Command10 } from "commander";
+import chalk10 from "chalk";
 
 // packages/cli/src/commands/crew-control.ts
 init_dist2();
 init_dist2();
 init_dist();
 init_dist4();
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 import { createConnection as createConnection3 } from "net";
 import { randomUUID as randomUUID4 } from "crypto";
 import { execFileSync as execFileSync6 } from "child_process";
-import { homedir as homedir17 } from "os";
-import { join as join22 } from "path";
+import { homedir as homedir18 } from "os";
+import { join as join23 } from "path";
 import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync11 } from "fs";
 
 // packages/cli/src/commands/crew-output.ts
@@ -11328,7 +11601,26 @@ function formatCompactTasks(records, opts) {
   if (opts.compact === false) {
     return JSON.stringify(records, null, 2);
   }
-  return records.map(formatTaskLine).join("\n");
+  const active = records.filter((r) => !r.operatorHold);
+  const held = records.filter((r) => r.operatorHold);
+  let out = "";
+  if (active.length > 0) {
+    if (held.length > 0) out += `active (${active.length}):
+`;
+    out += active.map((r) => (held.length > 0 ? "  " : "") + formatTaskLine(r)).join("\n");
+  }
+  if (held.length > 0) {
+    if (out) out += "\n";
+    out += `HELD BY OPERATOR (${held.length}) \u2014 not counted toward maxCrew:
+`;
+    out += held.map((r) => {
+      const m = Math.round((Date.now() - r.operatorHold.since) / 6e4);
+      const hm = m >= 60 ? `${Math.floor(m / 60)}h${m % 60}m` : `${m}m`;
+      const note = r.operatorHold.note ? ` \xB7 "${r.operatorHold.note}"` : "";
+      return `  ${formatTaskLine(r)} \xB7 held ${hm}${note}`;
+    }).join("\n");
+  }
+  return out;
 }
 
 // packages/cli/src/commands/crew-attach.ts
@@ -11576,7 +11868,7 @@ var crewChatCommand = new Command7("chat").description("[DEPRECATED] alias for `
 });
 
 // packages/cli/src/commands/crew-control.ts
-var SOCK2 = join22(homedir17(), ".config", "squadrant", "squadrant.sock");
+var SOCK2 = join23(homedir18(), ".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));
@@ -11640,6 +11932,40 @@ function buildGateResolveRequest(o) {
     payload: { text: o.message, ...decision ? { decision } : {} }
   };
 }
+async function runCrewTakeover(mode, opts, deps) {
+  const taskId = opts.taskId ?? process.env.SQUADRANT_CREW_TASK_ID;
+  let project = opts.project ?? process.env.SQUADRANT_CREW_PROJECT;
+  let target;
+  if (taskId) {
+    if (!project) {
+      throw new Error("not running under a crew (SQUADRANT_CREW_PROJECT unset)");
+    }
+    const tasks = await deps.listTasks(project);
+    target = tasks.find((t) => t.id === taskId);
+    if (!target) throw new Error(`Task '${taskId}' not found for project '${project}'`);
+  } else if (project && opts.crew) {
+    const tasks = await deps.listTasks(project);
+    target = resolveApproveTarget(tasks, opts.crew) || void 0;
+    if (!target) throw new Error(`Crew '${opts.crew}' not found for ${project}. Run 'squadrant crew list ${project}'.`);
+  } else {
+    throw new Error("must provide either <project> <crew> or --task-id");
+  }
+  const nameDisp = project && opts.crew ? `${project}/${opts.crew}` : target.name ? `${target.project}/${target.name}` : `${target.project}/${target.id}`;
+  if (mode === "start") {
+    const event = { type: "crew.takeover.started", id: target.id, ...opts.note !== void 0 ? { note: opts.note } : {} };
+    await deps.emitEvent(target.project, event);
+    const msg = `CREW TAKEOVER [${nameDisp}] \u2014 operator is driving this tab. Do not send, do not close, do not act on its signals until handback.`;
+    await deps.runtimeSend(target.project, msg);
+    deps.printSuccess(msg);
+  } else {
+    const event = { type: "crew.takeover.ended", id: target.id };
+    await deps.emitEvent(target.project, event);
+    const msg = `CREW HANDBACK [${nameDisp}] \u2014 operator returned control. State: ${target.state}. Run 'squadrant crew read ${target.project} ${target.name || target.id}' before acting; the tab has history you did not see.`;
+    await deps.runtimeSend(target.project, msg);
+    deps.printSuccess(msg);
+  }
+  return target;
+}
 async function squadrantdCall(req) {
   try {
     return await sendRequest(SOCK2, req);
@@ -11683,9 +12009,9 @@ function buildSignalRequest(signal, o) {
   return { kind: "event", project, event };
 }
 function defaultWriteResult(id, payload) {
-  const dir = join22(homedir17(), ".config", "squadrant", "state", "_results");
+  const dir = join23(homedir18(), ".config", "squadrant", "state", "_results");
   mkdirSync9(dir, { recursive: true });
-  const file = join22(dir, `${id}.txt`);
+  const file = join23(dir, `${id}.txt`);
   writeFileSync11(file, payload);
   return file;
 }
@@ -11865,6 +12191,60 @@ function addControlPlaneCrewCommands(crew) {
 `);
     } catch (e) {
       process.stderr.write(`${e.message}
+`);
+      process.exit(1);
+    }
+  });
+  crew.command("takeover [project] [crewName]").description("Take over a crew's tab explicitly, suppressing captain action until handback (#649)").option("--task-id <id>", "Explicit task id (overrides SQUADRANT_CREW_TASK_ID env)").option("--note <note>", "Optional note explaining the takeover").action(async (project, crewName, opts) => {
+    try {
+      await runCrewTakeover("start", { project, crew: crewName, taskId: opts.taskId, note: opts.note }, {
+        listTasks: async (p) => await squadrantdCall({ kind: "list", project: p }),
+        emitEvent: async (p, event) => {
+          await squadrantdCall({ kind: "event", project: p, event });
+        },
+        runtimeSend: async (p, msg) => {
+          const { runRuntimeSend: runRuntimeSend2 } = await Promise.resolve().then(() => (init_runtime2(), runtime_exports));
+          await runRuntimeSend2(p, msg, {});
+        },
+        printError: (msg) => {
+          process.stderr.write(`${msg}
+`);
+        },
+        printSuccess: (msg) => {
+          process.stdout.write(`\u2714 ${msg}
+`);
+        }
+      });
+      process.exit(0);
+    } catch (e) {
+      process.stderr.write(`${e.message}
+`);
+      process.exit(1);
+    }
+  });
+  crew.command("handback [project] [crewName]").description("Return control of a held crew tab to the captain (#649)").option("--task-id <id>", "Explicit task id (overrides SQUADRANT_CREW_TASK_ID env)").action(async (project, crewName, opts) => {
+    try {
+      await runCrewTakeover("end", { project, crew: crewName, taskId: opts.taskId }, {
+        listTasks: async (p) => await squadrantdCall({ kind: "list", project: p }),
+        emitEvent: async (p, event) => {
+          await squadrantdCall({ kind: "event", project: p, event });
+        },
+        runtimeSend: async (p, msg) => {
+          const { runRuntimeSend: runRuntimeSend2 } = await Promise.resolve().then(() => (init_runtime2(), runtime_exports));
+          await runRuntimeSend2(p, msg, {});
+        },
+        printError: (msg) => {
+          process.stderr.write(`${msg}
+`);
+        },
+        printSuccess: (msg) => {
+          process.stdout.write(`\u2714 ${msg}
+`);
+        }
+      });
+      process.exit(0);
+    } catch (e) {
+      process.stderr.write(`${e.message}
 `);
       process.exit(1);
     }
@@ -11872,7 +12252,7 @@ function addControlPlaneCrewCommands(crew) {
   crew.addCommand(crewAttachCommand);
   crew.addCommand(crewChatCommand);
 }
-var crewControlCommand = new Command8("crew").description("Dispatch and track crew via the squadrant control plane");
+var crewControlCommand = new Command9("crew").description("Dispatch and track crew via the squadrant control plane");
 addControlPlaneCrewCommands(crewControlCommand);
 
 // packages/cli/src/commands/crew.ts
@@ -11904,13 +12284,14 @@ async function runCrewSpawn2(input) {
       await squadrantdCall({ kind: "event", project: p, event });
     },
     onRouted: (route) => console.log(
-      chalk9.dim(
+      chalk10.dim(
         `routed: tier=${route.tier} \u2192 ${route.agent}${route.model ? `/${route.model}` : ""} (rule: "${route.matchedRule}")`
       )
-    )
+    ),
+    onBaseResolved: (base) => console.log(chalk10.dim(`base: ${base}`))
   });
 }
-async function runCrewSend2(project, name, message) {
+async function runCrewSend2(project, name, message, opts) {
   const { runtime, workspaceId } = await resolveCaptainWorkspace(project);
   return runCrewSend(project, name, message, runtime, workspaceId, {
     listTasks: async (p) => await squadrantdCall({ kind: "list", project: p }),
@@ -11922,13 +12303,13 @@ async function runCrewSend2(project, name, message) {
     sendToPane: (pane, msg) => confirmedSendToPane(runtime, pane, msg),
     // #516: side-effect-free modal precheck, run before any daemon-state emit.
     isBlockedByModal: (pane) => paneHasOpenModal(runtime, pane)
-  });
+  }, opts);
 }
 async function runCrewRead2(project, name) {
   const { runtime, workspaceId } = await resolveCaptainWorkspace(project);
   return runCrewRead(project, name, runtime, workspaceId);
 }
-async function runCrewClose2(project, name) {
+async function runCrewClose2(project, name, opts) {
   const { runtime, workspaceId } = await resolveCaptainWorkspace(project);
   return runCrewClose(project, name, runtime, workspaceId, {
     listTasks: async (p) => await squadrantdCall({ kind: "list", project: p }),
@@ -11938,13 +12319,13 @@ async function runCrewClose2(project, name) {
     closeCodexThread: async (taskId) => {
       await squadrantdCall({ kind: "codex-close", taskId });
     }
-  });
+  }, opts);
 }
 async function runCrewList2(project) {
   const { runtime, workspaceId } = await resolveCaptainWorkspace(project);
   return runCrewList(project, runtime, workspaceId);
 }
-var crewCommand = new Command9("crew").description(
+var crewCommand = new Command10("crew").description(
   "Spawn and manage interactive crew sessions next to the project's captain"
 );
 crewCommand.command("spawn").description(
@@ -11970,9 +12351,9 @@ crewCommand.command("spawn").description(
         // into the isolated worktree root for relative-path access.
         ...opts.taskFile && opts.taskFile !== "-" ? { taskFile: opts.taskFile } : {}
       });
-      console.log(chalk9.green(`\u2714 Crew '${pane.title}' spawned (${pane.surfaceId})`));
+      console.log(chalk10.green(`\u2714 Crew '${pane.title}' spawned (${pane.surfaceId})`));
     } catch (err) {
-      console.error(chalk9.red(err.message));
+      console.error(chalk10.red(err.message));
       process.exit(1);
     }
   }
@@ -11981,24 +12362,48 @@ crewCommand.command("list").description("List live crew sessions for a project")
   try {
     const crews = await runCrewList2(project);
     if (crews.length === 0) {
-      console.log(chalk9.yellow(`No live crew sessions for ${project}.`));
+      console.log(chalk10.yellow(`No live crew sessions for ${project}.`));
       return;
     }
+    const tasks = await squadrantdCall({ kind: "list", project }).catch(() => []);
+    const active = [];
+    const held = [];
     for (const c of crews) {
-      console.log(`  ${c.name}  (${c.surfaceId})`);
+      const task = tasks.find((t2) => t2.name === c.name);
+      const t = task ? resolveApproveTarget(tasks, c.name) : void 0;
+      if (t?.operatorHold) {
+        held.push({ c, t });
+      } else {
+        active.push({ c, t });
+      }
+    }
+    if (active.length > 0) {
+      console.log(`active (${active.length}):`);
+      for (const { c, t } of active) {
+        console.log(`  ${c.name.padEnd(10)} ${t ? t.state : "unknown"}  (${c.surfaceId})`);
+      }
+    }
+    if (held.length > 0) {
+      console.log(`HELD BY OPERATOR (${held.length}) \u2014 not counted toward maxCrew:`);
+      for (const { c, t } of held) {
+        const m = Math.round((Date.now() - t.operatorHold.since) / 6e4);
+        const hm = m >= 60 ? `${Math.floor(m / 60)}h${m % 60}m` : `${m}m`;
+        const note = t.operatorHold.note ? ` \xB7 "${t.operatorHold.note}"` : "";
+        console.log(`  ${c.name.padEnd(10)} ${t.state} \xB7 held ${hm}${note}  (${c.surfaceId})`);
+      }
     }
   } catch (err) {
-    console.error(chalk9.red(err.message));
+    console.error(chalk10.red(err.message));
     process.exit(1);
   }
 });
-crewCommand.command("send").description("Send a follow-up message to an existing crew session").argument("<project>", "Project name").argument("<name>", "Crew name (e.g. crew-1)").argument("[message]", "Message to send (omit with --message-file)").option("--message-file <path>", "Read message from file instead of positional arg ('-' for stdin)").action(async (project, name, message, opts) => {
+crewCommand.command("send").description("Send a follow-up message to an existing crew session").argument("<project>", "Project name").argument("<name>", "Crew name (e.g. crew-1)").argument("[message]", "Message to send (omit with --message-file)").option("--message-file <path>", "Read message from file instead of positional arg ('-' for stdin)").option("--force", "override an operator takeover (only when the operator told you to)", false).action(async (project, name, message, opts) => {
   try {
     const resolvedMessage = await resolveTextInput({ positional: message, filePath: opts.messageFile, label: "message" });
-    await runCrewSend2(project, name, resolvedMessage);
-    console.log(chalk9.green(`\u2714 Sent to ${project}:${name}`));
-  } catch (err) {
-    console.error(chalk9.red(err.message));
+    await runCrewSend2(project, name, resolvedMessage, opts);
+    console.log(chalk10.green(`\u2714 Sent to ${project}:${name}`));
+  } catch (e) {
+    console.error(chalk10.red(e.message));
     process.exit(1);
   }
 });
@@ -12008,16 +12413,16 @@ crewCommand.command("read").description("Read the current screen of a crew sessi
     const out = opts.full ? screen : tailLines(screen, Number(opts.lines ?? 40));
     console.log(out);
   } catch (err) {
-    console.error(chalk9.red(err.message));
+    console.error(chalk10.red(err.message));
     process.exit(1);
   }
 });
-crewCommand.command("close").description("Shutdown a crew session (closes its tab)").argument("<project>", "Project name").argument("<name>", "Crew name").action(async (project, name) => {
+crewCommand.command("close").description("Shutdown a crew session (closes its tab)").argument("<project>", "Project name").argument("<name>", "Crew name").option("--force", "override an operator takeover (only when the operator told you to)", false).action(async (project, name, opts) => {
   try {
-    await runCrewClose2(project, name);
-    console.log(chalk9.green(`\u2714 Closed ${project}:${name}`));
+    await runCrewClose2(project, name, opts);
+    console.log(chalk10.green(`\u2714 Closed ${project}:${name}`));
   } catch (err) {
-    console.error(chalk9.red(err.message));
+    console.error(chalk10.red(err.message));
     process.exit(1);
   }
 });
@@ -12025,8 +12430,8 @@ crewCommand.command("close").description("Shutdown a crew session (closes its ta
 // packages/cli/src/commands/diff.ts
 init_dist();
 init_dist3();
-import { Command as Command10 } from "commander";
-import chalk10 from "chalk";
+import { Command as Command11 } from "commander";
+import chalk11 from "chalk";
 import { execFileSync as execFileSync7 } from "child_process";
 import readline2 from "readline";
 function resolveDiffTarget(tasks, crew, projectPath) {
@@ -12143,7 +12548,7 @@ async function openCrewDiff(project, proj, crew, opts, runtime, workspaceId) {
       const label = sources.length > 1 ? "staged or unstaged" : sources[0];
       console.log(`No ${label} changes on ${branchLabel}.`);
     } else {
-      console.log(chalk10.dim(`Opened ${opened} working-tree diff(s) (${sources.join(", ")}) for ${branchLabel}.`));
+      console.log(chalk11.dim(`Opened ${opened} working-tree diff(s) (${sources.join(", ")}) for ${branchLabel}.`));
     }
     return;
   }
@@ -12166,7 +12571,7 @@ async function openCrewDiff(project, proj, crew, opts, runtime, workspaceId) {
     lastTurn: opts.lastTurn,
     source: "branch"
   });
-  console.log(chalk10.dim(`Opened ${branchLabel} vs ${base} in cmux diff.`));
+  console.log(chalk11.dim(`Opened ${branchLabel} vs ${base} in cmux diff.`));
 }
 async function runDiff(project, crewArg, opts) {
   const config = loadConfig();
@@ -12187,7 +12592,7 @@ async function runDiff(project, crewArg, opts) {
       return;
     }
     await runtime.showPatch({ workspaceId, patch, title, layout: opts.layout, focus: opts.focus });
-    console.log(chalk10.dim(`Opened ${title} in cmux diff.`));
+    console.log(chalk11.dim(`Opened ${title} in cmux diff.`));
     return;
   }
   let crew;
@@ -12213,7 +12618,7 @@ async function runDiff(project, crewArg, opts) {
   }
   await openCrewDiff(project, proj, crew, opts, runtime, workspaceId);
 }
-var diffCommand = new Command10("diff").description("Open a crew's branch diff, a PR, or a ref comparison in cmux's native diff viewer \u2014 no VSCode required (#596/#604)").argument("<project>", "Project name (must be registered)").argument("[crew]", "Crew name (e.g. crew-1); omit with no other flags to pick from live crews").option("--pr <n>", "Review a PR: wraps `gh pr diff <n>` (mutually exclusive with crew/--base/--head)").option("--base <ref>", "Base ref for a --head ref comparison (merge-base diff)").option("--head <ref>", "Head ref for a --base ref comparison").option("--against <ref>", "Alias: diff <ref>...HEAD (mutually exclusive with --base/--head)").option("--layout <mode>", "split (default) or unified", "split").option("--last-turn", "diff only changes since the crew's last agent turn", false).option("--no-focus", "open the diff pane without stealing focus").option("--staged", "show only staged (index) changes \u2014 VSCode's 'Staged Changes' panel (#599)", false).option("--unstaged", "show only unstaged working-tree changes \u2014 VSCode's 'Changes' panel (#599)", false).option("--working", "show both staged and unstaged changes (mid-task working-tree review, #599)", false).action(runDiff);
+var diffCommand = new Command11("diff").description("Open a crew's branch diff, a PR, or a ref comparison in cmux's native diff viewer \u2014 no VSCode required (#596/#604)").argument("<project>", "Project name (must be registered)").argument("[crew]", "Crew name (e.g. crew-1); omit with no other flags to pick from live crews").option("--pr <n>", "Review a PR: wraps `gh pr diff <n>` (mutually exclusive with crew/--base/--head)").option("--base <ref>", "Base ref for a --head ref comparison (merge-base diff)").option("--head <ref>", "Head ref for a --base ref comparison").option("--against <ref>", "Alias: diff <ref>...HEAD (mutually exclusive with --base/--head)").option("--layout <mode>", "split (default) or unified", "split").option("--last-turn", "diff only changes since the crew's last agent turn", false).option("--no-focus", "open the diff pane without stealing focus").option("--staged", "show only staged (index) changes \u2014 VSCode's 'Staged Changes' panel (#599)", false).option("--unstaged", "show only unstaged working-tree changes \u2014 VSCode's 'Changes' panel (#599)", false).option("--working", "show both staged and unstaged changes (mid-task working-tree review, #599)", false).action(runDiff);
 
 // packages/cli/src/commands/side.ts
 init_dist();
@@ -12222,11 +12627,11 @@ init_dist4();
 init_dist3();
 init_dist();
 init_dist2();
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import fs20 from "fs";
 import path22 from "path";
 import os12 from "os";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 var TEMPLATES_DIR3 = path22.join(os12.homedir(), ".config", "squadrant", "templates");
 async function runSideSpawn2(input) {
   const config = loadConfig();
@@ -12288,7 +12693,7 @@ async function runSideClose2(project, name) {
     config.defaults.worktreeDir ?? ".worktrees"
   );
 }
-var sideCommand = new Command11("side").description(
+var sideCommand = new Command12("side").description(
   "Spawn and manage side-sessions (research/debug) \u2014 fresh-context tabs off the daemon lifecycle"
 );
 sideCommand.command("spawn").description(
@@ -12313,9 +12718,9 @@ sideCommand.command("spawn").description(
         direction: opts.direction,
         agent: opts.agent
       });
-      console.log(chalk11.green(`\u2714 Side session '${pane.title}' spawned (${pane.surfaceId})`));
+      console.log(chalk12.green(`\u2714 Side session '${pane.title}' spawned (${pane.surfaceId})`));
     } catch (err) {
-      console.error(chalk11.red(err.message));
+      console.error(chalk12.red(err.message));
       process.exit(1);
     }
   }
@@ -12324,14 +12729,14 @@ sideCommand.command("list").description("List live side-sessions for a project")
   try {
     const sessions = await runSideList2(project);
     if (sessions.length === 0) {
-      console.log(chalk11.yellow(`No live side-sessions for ${project}.`));
+      console.log(chalk12.yellow(`No live side-sessions for ${project}.`));
       return;
     }
     for (const s of sessions) {
       console.log(`  ${s.name}  (${s.surfaceId})`);
     }
   } catch (err) {
-    console.error(chalk11.red(err.message));
+    console.error(chalk12.red(err.message));
     process.exit(1);
   }
 });
@@ -12344,9 +12749,9 @@ sideCommand.command("send").description("Send a follow-up message to an existing
         label: "message"
       });
       await runSideSend2(project, name, resolvedMessage);
-      console.log(chalk11.green(`\u2714 Sent to ${project}:${name}`));
+      console.log(chalk12.green(`\u2714 Sent to ${project}:${name}`));
     } catch (err) {
-      console.error(chalk11.red(err.message));
+      console.error(chalk12.red(err.message));
       process.exit(1);
     }
   }
@@ -12354,9 +12759,9 @@ sideCommand.command("send").description("Send a follow-up message to an existing
 sideCommand.command("close").description("Close a side-session (closes its tab)").argument("<project>", "Project name").argument("<name>", "Session name").action(async (project, name) => {
   try {
     await runSideClose2(project, name);
-    console.log(chalk11.green(`\u2714 Closed ${project}:${name}`));
+    console.log(chalk12.green(`\u2714 Closed ${project}:${name}`));
   } catch (err) {
-    console.error(chalk11.red(err.message));
+    console.error(chalk12.red(err.message));
     process.exit(1);
   }
 });
@@ -12364,11 +12769,11 @@ sideCommand.command("close").description("Close a side-session (closes its tab)"
 // packages/cli/src/commands/dashboard.ts
 init_dist();
 init_dist3();
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 import { execSync as execSync10 } from "child_process";
-import { homedir as homedir19 } from "os";
-import { join as join24 } from "path";
-import chalk13 from "chalk";
+import { homedir as homedir20 } from "os";
+import { join as join25 } from "path";
+import chalk14 from "chalk";
 
 // packages/web/dist/read-status.js
 function deriveState(tasks) {
@@ -12445,14 +12850,14 @@ async function readAllStatuses(deps) {
 }
 
 // packages/web/dist/render.js
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var ICON = {
-  idle: chalk12.green,
-  busy: chalk12.cyan,
-  blocked: chalk12.yellow,
-  errored: chalk12.red,
-  offline: chalk12.dim,
-  unknown: chalk12.gray
+  idle: chalk13.green,
+  busy: chalk13.cyan,
+  blocked: chalk13.yellow,
+  errored: chalk13.red,
+  offline: chalk13.dim,
+  unknown: chalk13.gray
 };
 var ICON_CHAR = {
   idle: "\u25CF",
@@ -12495,10 +12900,10 @@ function renderDashboard(rows, opts) {
   const width = opts.width ?? 100;
   const lines = [];
   lines.push("");
-  lines.push("  " + chalk12.bold("\u{1F4CA} Squadrant Dashboard") + "  " + chalk12.dim(opts.now));
+  lines.push("  " + chalk13.bold("\u{1F4CA} Squadrant Dashboard") + "  " + chalk13.dim(opts.now));
   lines.push("");
   if (rows.length === 0) {
-    lines.push("  " + chalk12.yellow("No projects registered. Add one with: squadrant projects add <name> <path>"));
+    lines.push("  " + chalk13.yellow("No projects registered. Add one with: squadrant projects add <name> <path>"));
     lines.push("");
     return lines.join("\n");
   }
@@ -12509,14 +12914,14 @@ function renderDashboard(rows, opts) {
   const excerptW = Math.max(20, width - FIXED);
   for (const r of rows) {
     const icon = ICON[r.state](ICON_CHAR[r.state]);
-    const name = chalk12.cyan(pad(r.project, NAME_W));
+    const name = chalk13.cyan(pad(r.project, NAME_W));
     const state = ICON[r.state](pad(r.state, STATE_W));
     const age = pad(formatAge(r.lastChecked, opts.now), AGE_W);
-    const excerpt = chalk12.dim(truncate(firstLine(r.excerpt), excerptW));
+    const excerpt = chalk13.dim(truncate(firstLine(r.excerpt), excerptW));
     lines.push(`  ${icon} ${name} ${state} ${age} \u2502 ${excerpt}`);
   }
   lines.push("");
-  lines.push(chalk12.dim("  Refreshes every 10s \xB7 Ctrl+C to exit"));
+  lines.push(chalk13.dim("  Refreshes every 10s \xB7 Ctrl+C to exit"));
   lines.push("");
   return lines.join("\n");
 }
@@ -12580,8 +12985,8 @@ function mergeSnapshot(daemon, external, now) {
 // packages/web/dist/probes.js
 init_dist();
 init_dist();
-import { join as join23 } from "path";
-import { homedir as homedir18 } from "os";
+import { join as join24 } from "path";
+import { homedir as homedir19 } from "os";
 import { existsSync as existsSync12, readFileSync as readFileSync15 } from "fs";
 import { execFile as execFile4 } from "child_process";
 var DEFAULT_TIMEOUT_MS = 2e3;
@@ -12618,7 +13023,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(join23(dir, ".obsidian")))
+    if (!run.pathExists(join24(dir, ".obsidian")))
       return { state: "gone", detail: "no .obsidian/ (not a vault)" };
     return { state: "alive" };
   } catch {
@@ -12686,10 +13091,10 @@ async function runExternalProbes(run, timeoutMs = DEFAULT_TIMEOUT_MS) {
   const sessions = probeSessions(run);
   return { cmux: cmux2, agentClis, vaults, config: { parseable, projectPaths, sessions } };
 }
-var SESSIONS_PATH = join23(homedir18(), ".config", "squadrant", "sessions.json");
+var SESSIONS_PATH = join24(homedir19(), ".config", "squadrant", "sessions.json");
 function onPath(cli) {
   const dirs = (process.env.PATH ?? "").split(":").filter(Boolean);
-  return dirs.some((d) => existsSync12(join23(d, cli)));
+  return dirs.some((d) => existsSync12(join24(d, cli)));
 }
 function readSessionsHashes() {
   const raw = JSON.parse(readFileSync15(SESSIONS_PATH, "utf-8"));
@@ -13597,7 +14002,7 @@ async function startWebServer(opts) {
 
 // packages/cli/src/commands/dashboard.ts
 init_dist();
-var SOCK3 = join24(homedir19(), ".config", "squadrant", "squadrant.sock");
+var SOCK3 = join25(homedir20(), ".config", "squadrant", "squadrant.sock");
 function detectCurrentWorkspace2() {
   const out = execSync10(`"${resolveCmuxBin()}" current-workspace`, { encoding: "utf-8" }).trim();
   const match = out.match(/workspace:\d+/);
@@ -13639,10 +14044,10 @@ async function runDashboardWeb(input) {
     sockPath: SOCK3,
     runners: defaultProbeRunners()
   });
-  console.log(chalk13.green(`\u2714 Squadrant system dashboard \u2192 http://127.0.0.1:${handle.port}`));
-  console.log(chalk13.dim(`  polling the daemon every ${input.interval}s \xB7 localhost only \xB7 read-only \xB7 Ctrl-C to stop`));
+  console.log(chalk14.green(`\u2714 Squadrant system dashboard \u2192 http://127.0.0.1:${handle.port}`));
+  console.log(chalk14.dim(`  polling the daemon every ${input.interval}s \xB7 localhost only \xB7 read-only \xB7 Ctrl-C to stop`));
 }
-var dashboardCommand = new Command12("dashboard").description("Live status grid of all projects (derived from daemon task state)").option("--once", "Print one snapshot and exit (used by --pane's refresh loop)").option("--pane", "Open a refreshing sidebar pane in the current cmux workspace").option("--web", "Serve the live system-health web dashboard on 127.0.0.1 (HTTP + SSE)").option("--port <port>", "Port for --web (default 7878)", (v) => parseInt(v, 10), 7878).option("--direction <dir>", "Pane split direction (right|left|up|down)", "right").option("--interval <seconds>", "Daemon poll interval for --web (default 5); refresh interval for --pane (default 10)", (v) => parseInt(v, 10)).action(async (opts) => {
+var dashboardCommand = new Command13("dashboard").description("Live status grid of all projects (derived from daemon task state)").option("--once", "Print one snapshot and exit (used by --pane's refresh loop)").option("--pane", "Open a refreshing sidebar pane in the current cmux workspace").option("--web", "Serve the live system-health web dashboard on 127.0.0.1 (HTTP + SSE)").option("--port <port>", "Port for --web (default 7878)", (v) => parseInt(v, 10), 7878).option("--direction <dir>", "Pane split direction (right|left|up|down)", "right").option("--interval <seconds>", "Daemon poll interval for --web (default 5); refresh interval for --pane (default 10)", (v) => parseInt(v, 10)).action(async (opts) => {
   try {
     if (opts.web) {
       await runDashboardWeb({ port: opts.port, interval: opts.interval ?? 5 });
@@ -13650,12 +14055,12 @@ var dashboardCommand = new Command12("dashboard").description("Live status grid
     }
     if (opts.pane) {
       const pane = await runDashboardPane({ direction: opts.direction, interval: opts.interval ?? 10 });
-      console.log(chalk13.green(`\u2714 Dashboard pane opened in ${pane.workspaceId} ${pane.surfaceId}`));
+      console.log(chalk14.green(`\u2714 Dashboard pane opened in ${pane.workspaceId} ${pane.surfaceId}`));
       return;
     }
     await runDashboardOnce();
   } catch (err) {
-    console.error(chalk13.red(err.message));
+    console.error(chalk14.red(err.message));
     process.exit(1);
   }
 });
@@ -13666,12 +14071,12 @@ dashboardCommand.command("sync-hub").description("Mirror each spoke status.md in
     return;
   }
   if (results.length === 0) {
-    console.log(chalk13.dim("\n  No mirrors written (no projects with usable status.md, or hubVault unset).\n"));
+    console.log(chalk14.dim("\n  No mirrors written (no projects with usable status.md, or hubVault unset).\n"));
     return;
   }
-  console.log(chalk13.bold("\n  \u{1F4CA} Hub mirror sync\n"));
+  console.log(chalk14.bold("\n  \u{1F4CA} Hub mirror sync\n"));
   for (const r of results) {
-    console.log(`  ${chalk13.green("\u2714")} ${chalk13.cyan(r.project.padEnd(16))} \u2192 ${chalk13.dim(r.hubPath)}`);
+    console.log(`  ${chalk14.green("\u2714")} ${chalk14.cyan(r.project.padEnd(16))} \u2192 ${chalk14.dim(r.hubPath)}`);
   }
   console.log("");
 });
@@ -13681,12 +14086,12 @@ init_dist();
 init_dist4();
 init_dist3();
 init_dist2();
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 import { execSync as execSync11 } from "child_process";
 import fs22 from "fs";
 import path24 from "path";
 import os13 from "os";
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 
 // packages/cli/src/commands/launch-interactive.ts
 import checkbox, { Separator } from "@inquirer/checkbox";
@@ -13767,16 +14172,16 @@ var TEMPLATES_DIR4 = path24.join(os13.homedir(), ".config", "squadrant", "templa
 var SESSIONS_PATH2 = path24.join(os13.homedir(), ".config", "squadrant", "sessions.json");
 function ensureCmuxReady(headless) {
   if (headless || isInsideCmux()) return;
-  console.log(chalk14.yellow("\n  Not running inside cmux. Opening cmux app...\n"));
+  console.log(chalk15.yellow("\n  Not running inside cmux. Opening cmux app...\n"));
   execSync11(`open "${CMUX_APP}"`, { stdio: "inherit" });
-  console.log(chalk14.bold("  Run `squadrant launch` from inside a cmux workspace.\n"));
+  console.log(chalk15.bold("  Run `squadrant launch` from inside a cmux workspace.\n"));
   process.exit(0);
 }
-var launchCommand = new Command13("launch").description(
+var launchCommand = new Command14("launch").description(
   "Launch a project captain (with project arg) or all captains (--all). Use `squadrant command` for one-shot Command tasks."
 ).argument("[project]", "Project name to launch captain for").option("--fresh", "Start a new session instead of resuming the last one").option("--keep", "Resume the latest session even on a new day / after a template change").option("--all", "Launch all captain workspaces").option("--headless", "Skip the interactive cmux-app requirement (used by the daemon to boot captains without a terminal)").action(async (project, opts) => {
   if (opts.fresh && opts.keep) {
-    console.error(chalk14.red("\n  \u2718 --fresh and --keep are mutually exclusive\n"));
+    console.error(chalk15.red("\n  \u2718 --fresh and --keep are mutually exclusive\n"));
     process.exit(1);
   }
   const config = loadConfig();
@@ -13824,29 +14229,29 @@ var launchCommand = new Command13("launch").description(
             return null;
           }
         },
-        onFreshReason: (reason) => console.log(chalk14.cyan(`  \u21BB ${reason}`)),
-        onStoppingStale: (name) => console.log(chalk14.yellow(`  Closing stale workspace '${name}' for fresh start`)),
-        onAlreadyExists: (name) => console.log(chalk14.yellow(`  Workspace '${name}' already exists \u2014 switching to it`)),
-        onCreated: (name) => console.log(chalk14.green(`  \u2714 Workspace '${name}' created`))
+        onFreshReason: (reason) => console.log(chalk15.cyan(`  \u21BB ${reason}`)),
+        onStoppingStale: (name) => console.log(chalk15.yellow(`  Closing stale workspace '${name}' for fresh start`)),
+        onAlreadyExists: (name) => console.log(chalk15.yellow(`  Workspace '${name}' already exists \u2014 switching to it`)),
+        onCreated: (name) => console.log(chalk15.green(`  \u2714 Workspace '${name}' created`))
       });
     } catch (err) {
-      console.error(chalk14.red(`  \u2718 Failed: ${err.message}`));
+      console.error(chalk15.red(`  \u2718 Failed: ${err.message}`));
       hadFailure = true;
     }
   }
   if (opts.all) {
     const hubPath = resolveHome(config.hubVault);
     fs22.mkdirSync(hubPath, { recursive: true });
-    console.log(chalk14.bold("\nLaunching all captain workspaces\n"));
+    console.log(chalk15.bold("\nLaunching all captain workspaces\n"));
     for (const [name, proj] of Object.entries(config.projects)) {
       const projPath = resolveHome(proj.path);
       const spokePath = resolveHome(proj.spokeVault);
       if (!fs22.existsSync(spokePath)) {
         const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(name, config);
         await ensureSpokeLayout(spokeDriver);
-        console.log(chalk14.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
+        console.log(chalk15.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
       }
-      console.log(chalk14.bold(`
+      console.log(chalk15.bold(`
   Captain: ${proj.captainName} (${name})`));
       await launchOne(proj.captainName, "captain", projPath, config.defaults.permissions?.captain || "auto", false, true, name);
     }
@@ -13854,7 +14259,7 @@ var launchCommand = new Command13("launch").description(
   } else if (!project) {
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
       console.error(
-        chalk14.red(
+        chalk15.red(
           "\n  \u2718 Specify a project name, or pass --all to launch every captain.\n    For one-shot Command tasks, use `squadrant command --task <briefing|learnings-review|wiki-aggregate>`.\n"
         )
       );
@@ -13869,10 +14274,10 @@ var launchCommand = new Command13("launch").description(
     }));
     const selected = await selectCaptainsInteractive(entries);
     if (selected.length === 0) {
-      console.log(chalk14.yellow("\n  No captains selected.\n"));
+      console.log(chalk15.yellow("\n  No captains selected.\n"));
       return;
     }
-    console.log(chalk14.bold(`
+    console.log(chalk15.bold(`
 Launching ${selected.length} captain workspace(s) in parallel
 `));
     await Promise.all(selected.map(async (name) => {
@@ -13882,9 +14287,9 @@ Launching ${selected.length} captain workspace(s) in parallel
       if (!fs22.existsSync(spokePath)) {
         const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(name, config);
         await ensureSpokeLayout(spokeDriver);
-        console.log(chalk14.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
+        console.log(chalk15.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
       }
-      console.log(chalk14.bold(`
+      console.log(chalk15.bold(`
   Captain: ${proj.captainName} (${name})`));
       await launchOne(proj.captainName, "captain", projPath, config.defaults.permissions?.captain || "auto", false, true, name);
     }));
@@ -13892,7 +14297,7 @@ Launching ${selected.length} captain workspace(s) in parallel
   } else {
     if (!config.projects[project]) {
       console.error(
-        chalk14.red(
+        chalk15.red(
           `
   \u2718 Project '${project}' not found. Run 'squadrant projects list' to see registered projects.
 `
@@ -13906,10 +14311,10 @@ Launching ${selected.length} captain workspace(s) in parallel
     if (!fs22.existsSync(spokePath)) {
       const spokeDriver = new WorkspaceRegistry({ obsidian: createObsidianDriver }).forProject(project, config);
       await ensureSpokeLayout(spokeDriver);
-      console.log(chalk14.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
+      console.log(chalk15.cyan(`  \u2714 Created spoke vault at ${spokePath}`));
     }
     console.log(
-      chalk14.bold(
+      chalk15.bold(
         `
 Launching captain workspace for '${project}' (${proj.captainName})
 `
@@ -13923,8 +14328,8 @@ Launching captain workspace for '${project}' (${proj.captainName})
 // packages/cli/src/commands/shutdown.ts
 init_dist();
 init_dist3();
-import { Command as Command14 } from "commander";
-import chalk15 from "chalk";
+import { Command as Command15 } from "commander";
+import chalk16 from "chalk";
 init_dist();
 function nameVariants(name) {
   const stripped = name.replace(/^⚓\s+/, "").trim();
@@ -13937,23 +14342,23 @@ async function closeMatching(runtime, variants, label) {
   const failed = [];
   if (matches.length === 0) {
     console.log(
-      chalk15.yellow(`  \u26A0 Workspace '${label}' not found \u2014 already closed?`)
+      chalk16.yellow(`  \u26A0 Workspace '${label}' not found \u2014 already closed?`)
     );
     return { closed, failed };
   }
   for (const ws of matches) {
     try {
       await runtime.stop(ws.id);
-      console.log(chalk15.green(`  \u2714 Closed: ${ws.name}`));
+      console.log(chalk16.green(`  \u2714 Closed: ${ws.name}`));
       closed.push(ws.name);
     } catch {
-      console.log(chalk15.red(`  \u2718 Failed to close: ${ws.name}`));
+      console.log(chalk16.red(`  \u2718 Failed to close: ${ws.name}`));
       failed.push(ws.name);
     }
   }
   return { closed, failed };
 }
-var shutdownCommand = new Command14("shutdown").description(
+var shutdownCommand = new Command15("shutdown").description(
   "Shutdown command + all captain workspaces (no args) or one captain workspace"
 ).argument("[project]", "Project name to shut down captain for").action(async (project) => {
   const config = loadConfig();
@@ -13969,11 +14374,11 @@ var shutdownCommand = new Command14("shutdown").description(
     const allVariants = /* @__PURE__ */ new Set([...captainVariants, ...commandVariants]);
     const squadrantWorkspaces = workspaces.filter((w) => allVariants.has(w.name));
     if (squadrantWorkspaces.length === 0) {
-      console.log(chalk15.yellow("\nNo squadrant workspaces found to close.\n"));
+      console.log(chalk16.yellow("\nNo squadrant workspaces found to close.\n"));
       return;
     }
     console.log(
-      chalk15.bold(
+      chalk16.bold(
         `
 Shutting down ${squadrantWorkspaces.length} workspace(s)...
 `
@@ -13993,9 +14398,9 @@ Shutting down ${squadrantWorkspaces.length} workspace(s)...
     for (const ws of squadrantWorkspaces) {
       try {
         await globalRuntime.stop(ws.id);
-        console.log(chalk15.green(`  \u2714 Closed: ${ws.name}`));
+        console.log(chalk16.green(`  \u2714 Closed: ${ws.name}`));
       } catch {
-        console.log(chalk15.red(`  \u2718 Failed to close: ${ws.name}`));
+        console.log(chalk16.red(`  \u2718 Failed to close: ${ws.name}`));
       }
     }
     console.log("");
@@ -14003,7 +14408,7 @@ Shutting down ${squadrantWorkspaces.length} workspace(s)...
   }
   if (!config.projects[project]) {
     console.error(
-      chalk15.red(
+      chalk16.red(
         `
   \u2718 Project '${project}' not found. Run 'squadrant projects list' to see registered projects.
 `
@@ -14014,7 +14419,7 @@ Shutting down ${squadrantWorkspaces.length} workspace(s)...
   const captainName = config.projects[project].captainName;
   const runtime = runtimes.forProject(project, config);
   console.log(
-    chalk15.bold(`
+    chalk16.bold(`
 Shutting down captain workspace for '${project}'...
 `)
   );
@@ -14038,13 +14443,13 @@ Shutting down captain workspace for '${project}'...
 
 // packages/cli/src/commands/feedback.ts
 init_dist();
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 import fs23 from "fs";
 import os14 from "os";
 import path25 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { execSync as execSync12 } from "child_process";
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 var REPO_URL = "https://github.com/tu11aa/squadrant";
 function readPkgVersion() {
   try {
@@ -14092,21 +14497,21 @@ function buildIssueUrl(metrics, squadrantVersion) {
   });
   return `${REPO_URL}/issues/new?${params.toString()}`;
 }
-var feedbackCommand = new Command15("feedback").description("Open a pre-filled GitHub issue for feedback or bug reports").action(() => {
+var feedbackCommand = new Command16("feedback").description("Open a pre-filled GitHub issue for feedback or bug reports").action(() => {
   const config = loadConfig();
   const metricsPath = config.metrics?.path || path25.join(os14.homedir(), ".config", "squadrant", "metrics.json");
   const metrics = readMetrics(metricsPath);
   const version = readStamp(config) ?? readPkgVersion();
   const issueUrl = buildIssueUrl(metrics, version);
-  console.log(chalk16.bold("\nOpening feedback issue in browser...\n"));
-  console.log(chalk16.dim(`  URL: ${issueUrl.substring(0, 80)}...
+  console.log(chalk17.bold("\nOpening feedback issue in browser...\n"));
+  console.log(chalk17.dim(`  URL: ${issueUrl.substring(0, 80)}...
 `));
   try {
     execSync12(`open "${issueUrl}"`, { stdio: "ignore" });
-    console.log(chalk16.green("  \u2714 Browser opened\n"));
+    console.log(chalk17.green("  \u2714 Browser opened\n"));
   } catch {
-    console.log(chalk16.yellow("  \u26A0 Could not open browser automatically."));
-    console.log(`  Open manually: ${chalk16.cyan(issueUrl)}
+    console.log(chalk17.yellow("  \u26A0 Could not open browser automatically."));
+    console.log(`  Open manually: ${chalk17.cyan(issueUrl)}
 `);
   }
 });
@@ -14115,8 +14520,8 @@ var feedbackCommand = new Command15("feedback").description("Open a pre-filled G
 init_dist();
 init_dist();
 init_dist3();
-import { Command as Command16 } from "commander";
-import chalk17 from "chalk";
+import { Command as Command17 } from "commander";
+import chalk18 from "chalk";
 function getDateStr(yesterday) {
   return iso(daysAgo(yesterday ? 1 : 0));
 }
@@ -14135,7 +14540,7 @@ function formatStandup(standups, dateStr, raw) {
   const lines = [];
   const header = `Standup \u2014 ${dateStr}`;
   if (!raw) {
-    lines.push(chalk17.bold(`
+    lines.push(chalk18.bold(`
 ${header}
 `));
   } else {
@@ -14145,12 +14550,12 @@ ${header}
   let hasBlockers = false;
   for (const s of standups) {
     if (!raw) {
-      lines.push(chalk17.cyan.bold(`## ${s.name}`));
+      lines.push(chalk18.cyan.bold(`## ${s.name}`));
     } else {
       lines.push(`## ${s.name}`);
     }
     if (s.gitCommits.length > 0) {
-      lines.push(!raw ? chalk17.green("Done:") : "**Done:**");
+      lines.push(!raw ? chalk18.green("Done:") : "**Done:**");
       for (const commit of s.gitCommits) {
         lines.push(`  - ${commit}`);
       }
@@ -14162,7 +14567,7 @@ ${header}
         if (match) {
           const items = match[1].trim().split("\n").filter((l) => l.trim().startsWith("-"));
           if (items.length > 0 && section === "Tomorrow") {
-            lines.push(!raw ? chalk17.blue("Next:") : "**Next:**");
+            lines.push(!raw ? chalk18.blue("Next:") : "**Next:**");
             for (const item of items) lines.push(`  ${item.trim()}`);
           }
         }
@@ -14170,19 +14575,19 @@ ${header}
     }
     if (s.blockers.length > 0) {
       hasBlockers = true;
-      lines.push(!raw ? chalk17.red("Blocked:") : "**Blocked:**");
+      lines.push(!raw ? chalk18.red("Blocked:") : "**Blocked:**");
       for (const b of s.blockers) {
         lines.push(`  - ${b}`);
       }
     }
     if (s.gitCommits.length === 0 && !s.dailyLog) {
-      lines.push(!raw ? chalk17.dim("  (no activity)") : "  (no activity)");
+      lines.push(!raw ? chalk18.dim("  (no activity)") : "  (no activity)");
     }
     lines.push("");
   }
   const totalCommits = standups.reduce((sum, s) => sum + s.gitCommits.length, 0);
   if (!raw) {
-    lines.push(chalk17.dim(`--- ${totalCommits} commits${hasBlockers ? ", HAS BLOCKERS" : ""} (task tracking: no data source \u2014 #630) ---
+    lines.push(chalk18.dim(`--- ${totalCommits} commits${hasBlockers ? ", HAS BLOCKERS" : ""} (task tracking: no data source \u2014 #630) ---
 `));
   } else {
     lines.push(`---
@@ -14191,12 +14596,12 @@ ${header}
   }
   return lines.join("\n");
 }
-var standupCommand = new Command16("standup").description("Generate daily standup report from spoke vault data and git logs (zero tokens)").option("-p, --project <name>", "Show standup for a specific project only").option("-a, --all", "Show all projects (default)").option("-y, --yesterday", "Show yesterday's standup instead of today").option("-r, --raw", "Output raw markdown (for pasting into Slack/chat)").action(async (opts) => {
+var standupCommand = new Command17("standup").description("Generate daily standup report from spoke vault data and git logs (zero tokens)").option("-p, --project <name>", "Show standup for a specific project only").option("-a, --all", "Show all projects (default)").option("-y, --yesterday", "Show yesterday's standup instead of today").option("-r, --raw", "Output raw markdown (for pasting into Slack/chat)").action(async (opts) => {
   const config = loadConfig();
   const registry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
   const projects = Object.entries(config.projects);
   if (projects.length === 0) {
-    console.log(chalk17.yellow("\nNo projects registered. Use: squadrant projects add <name> <path>\n"));
+    console.log(chalk18.yellow("\nNo projects registered. Use: squadrant projects add <name> <path>\n"));
     return;
   }
   const dateStr = getDateStr(!!opts.yesterday);
@@ -14205,7 +14610,7 @@ var standupCommand = new Command16("standup").description("Generate daily standu
   if (opts.project) {
     const match = projects.find(([name]) => name === opts.project);
     if (!match) {
-      console.error(chalk17.red(`Project "${opts.project}" not found.`));
+      console.error(chalk18.red(`Project "${opts.project}" not found.`));
       process.exit(1);
     }
     targets = [match];
@@ -14223,8 +14628,8 @@ var standupCommand = new Command16("standup").description("Generate daily standu
 init_dist();
 init_dist();
 init_dist3();
-import { Command as Command17 } from "commander";
-import chalk18 from "chalk";
+import { Command as Command18 } from "commander";
+import chalk19 from "chalk";
 function dedupe(items) {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
@@ -14280,7 +14685,7 @@ function formatRetro(retros, fromStr, toStr, raw) {
   const lines = [];
   const header = `Retro \u2014 ${fromStr} \u2192 ${toStr}`;
   lines.push(raw ? `# ${header}
-` : chalk18.bold(`
+` : chalk19.bold(`
 ${header}
 `));
   let totalCommits = 0;
@@ -14290,39 +14695,39 @@ ${header}
     totalCommits += r.commits.length;
     totalPRs += r.mergedPRs.length;
     totalShipped += r.shipped.length;
-    lines.push(raw ? `## ${r.name}` : chalk18.cyan.bold(`## ${r.name}`));
-    renderList(lines, r.shipped, raw, "Shipped", chalk18.green);
+    lines.push(raw ? `## ${r.name}` : chalk19.cyan.bold(`## ${r.name}`));
+    renderList(lines, r.shipped, raw, "Shipped", chalk19.green);
     if (r.mergedPRs.length > 0) {
-      lines.push(raw ? `**PRs merged:**` : chalk18.green("PRs merged:"));
+      lines.push(raw ? `**PRs merged:**` : chalk19.green("PRs merged:"));
       for (const pr of r.mergedPRs) lines.push(`  - ${pr}`);
     }
-    renderList(lines, r.inProgress, raw, "In Progress", chalk18.yellow);
-    renderList(lines, r.blocked, raw, "Blocked", chalk18.red);
-    renderList(lines, r.decisions, raw, "Key Decisions", chalk18.magenta);
+    renderList(lines, r.inProgress, raw, "In Progress", chalk19.yellow);
+    renderList(lines, r.blocked, raw, "Blocked", chalk19.red);
+    renderList(lines, r.decisions, raw, "Key Decisions", chalk19.magenta);
     const metricBits = [
       `${r.commits.length} commits`,
       `${r.mergedPRs.length} PRs merged`,
       `${r.shipped.length} shipped`
     ];
-    lines.push(raw ? `*${metricBits.join(" \xB7 ")}*` : chalk18.dim(`  ${metricBits.join(" \xB7 ")}`));
+    lines.push(raw ? `*${metricBits.join(" \xB7 ")}*` : chalk19.dim(`  ${metricBits.join(" \xB7 ")}`));
     if (r.shipped.length === 0 && r.commits.length === 0 && r.mergedPRs.length === 0 && r.inProgress.length === 0 && r.blocked.length === 0) {
-      lines.push(raw ? "_(no activity in this window)_" : chalk18.dim("  (no activity in this window)"));
+      lines.push(raw ? "_(no activity in this window)_" : chalk19.dim("  (no activity in this window)"));
     }
     lines.push("");
   }
   const summary = `${totalShipped} items shipped \xB7 ${totalCommits} commits \xB7 ${totalPRs} PRs merged`;
   lines.push(raw ? `---
 *${summary}*
-` : chalk18.dim(`--- ${summary} ---
+` : chalk19.dim(`--- ${summary} ---
 `));
   return lines.join("\n");
 }
-var retroCommand = new Command17("retro").description("Generate a retro (weekly/sprint summary) from daily logs and git (zero tokens)").option("-w, --week", "Trailing 7 days (default)").option("-s, --sprint [days]", "Custom window of N days (default 14 if N omitted)").option("-p, --project <name>", "Retro for a single project").option("-a, --all", "All projects (default)").option("-r, --raw", "Raw markdown output (for pasting into Slack/Obsidian)").action(async (opts) => {
+var retroCommand = new Command18("retro").description("Generate a retro (weekly/sprint summary) from daily logs and git (zero tokens)").option("-w, --week", "Trailing 7 days (default)").option("-s, --sprint [days]", "Custom window of N days (default 14 if N omitted)").option("-p, --project <name>", "Retro for a single project").option("-a, --all", "All projects (default)").option("-r, --raw", "Raw markdown output (for pasting into Slack/Obsidian)").action(async (opts) => {
   const config = loadConfig();
   const registry = new WorkspaceRegistry({ obsidian: createObsidianDriver });
   const projects = Object.entries(config.projects);
   if (projects.length === 0) {
-    console.log(chalk18.yellow("\nNo projects registered. Use: squadrant projects add <name> <path>\n"));
+    console.log(chalk19.yellow("\nNo projects registered. Use: squadrant projects add <name> <path>\n"));
     return;
   }
   let windowDays = 7;
@@ -14339,7 +14744,7 @@ var retroCommand = new Command17("retro").description("Generate a retro (weekly/
   if (opts.project) {
     const match = projects.find(([name]) => name === opts.project);
     if (!match) {
-      console.error(chalk18.red(`Project "${opts.project}" not found.`));
+      console.error(chalk19.red(`Project "${opts.project}" not found.`));
       process.exit(1);
     }
     targets = [match];
@@ -14352,153 +14757,8 @@ var retroCommand = new Command17("retro").description("Generate a retro (weekly/
   console.log(formatRetro(retros, fromStr, toStr, raw));
 });
 
-// packages/cli/src/commands/runtime.ts
-init_dist();
-init_dist3();
-import { Command as Command18 } from "commander";
-import chalk19 from "chalk";
-function buildRegistry() {
-  return new RuntimeRegistry({
-    cmux: createCmuxDriver()
-  });
-}
-function resolveTarget(registry, config, target, useCommand) {
-  if (useCommand) {
-    return {
-      driver: registry.global(config),
-      workspaceName: config.commandName
-    };
-  }
-  if (!target) {
-    throw new Error("Missing target: pass a project name or use --command");
-  }
-  const proj = config.projects[target];
-  if (!proj) {
-    throw new Error(`Project '${target}' not found. Run 'squadrant projects list'.`);
-  }
-  return {
-    driver: registry.forProject(target, config),
-    workspaceName: proj.captainName
-  };
-}
-async function needRef(resolved) {
-  const ref = await resolved.driver.status(resolved.workspaceName);
-  if (!ref) {
-    throw new Error(`Workspace '${resolved.workspaceName}' is not running`);
-  }
-  return ref.id;
-}
-var runtimeCommand = new Command18("runtime").description("Interact with the runtime layer (workspaces). Bridges bash scripts to the RuntimeDriver.");
-runtimeCommand.command("status").description("Print 'running' or 'stopped' for a target; exit 0 if running, 1 if not").argument("[target]", "Project name").option("--command", "Target the command workspace instead of a project captain").action(async (target, opts) => {
-  const config = loadConfig();
-  const registry = buildRegistry();
-  try {
-    const resolved = resolveTarget(registry, config, target, !!opts.command);
-    const ref = await resolved.driver.status(resolved.workspaceName);
-    if (ref) {
-      console.log("running");
-      process.exit(0);
-    } else {
-      console.log("stopped");
-      process.exit(1);
-    }
-  } catch (err) {
-    console.error(chalk19.red(err.message));
-    process.exit(2);
-  }
-});
-var SEND_CONFIRM_TIMEOUT_MS = 15e3;
-var SEND_CONFIRM_POLL_MS = 500;
-async function runRuntimeSend(arg1, arg2, opts, confirmOpts) {
-  const config = loadConfig();
-  const registry = buildRegistry();
-  if (opts.command && arg2 !== void 0) {
-    throw new Error("With --command, pass only the message (not a project name)");
-  }
-  const target = opts.command ? void 0 : arg1;
-  const message = opts.command ? arg1 : arg2;
-  if (!message) throw new Error("Message is required");
-  const { requireDaemon: requireDaemon2 } = await Promise.resolve().then(() => (init_require_daemon(), require_daemon_exports));
-  const { appendCaptainMessage: appendCaptainMessage2, waitForCaptainDelivery: waitForCaptainDelivery2 } = await Promise.resolve().then(() => (init_dist2(), dist_exports2));
-  await requireDaemon2();
-  const resolved = resolveTarget(registry, config, target, !!opts.command);
-  await needRef(resolved);
-  const finalProject = opts.command ? config.commandName : target;
-  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 = join31(dirname10(DEFAULT_CONFIG_PATH2), "state");
-  const seq = await appendCaptainMessage2({
-    stateRoot,
-    project: finalProject,
-    text: message,
-    source: "cli"
-  });
-  const timeoutMs = confirmOpts?.timeoutMs ?? SEND_CONFIRM_TIMEOUT_MS;
-  const delivered = await waitForCaptainDelivery2({
-    stateRoot,
-    project: finalProject,
-    seq,
-    timeoutMs,
-    pollMs: confirmOpts?.pollMs ?? SEND_CONFIRM_POLL_MS
-  });
-  if (!delivered) {
-    throw new Error(
-      `Message queued for '${finalProject}' (seq=${seq}) but delivery was not confirmed within ${Math.round(timeoutMs / 1e3)}s. It may still be pending \u2014 check with 'squadrant runtime read-screen ${finalProject}${opts.command ? " --command" : ""}'.`
-    );
-  }
-}
-runtimeCommand.command("send").description("Send a message to a target workspace AND commit with Enter. With --command, the first positional is the message.").argument("<arg1>", "Project name, or the message when --command is used").argument("[arg2]", "Message (when target is a project). Omit when using --command.").option("--command", "Target the command workspace").action(async (arg1, arg2, opts) => {
-  try {
-    await runRuntimeSend(arg1, arg2, opts);
-    console.log(chalk19.green("\u2714 Delivered (confirmed)"));
-  } catch (err) {
-    console.error(chalk19.red(err.message));
-    process.exit(1);
-  }
-});
-runtimeCommand.command("list").description("List all workspaces from the global runtime").option("-j, --json", "Output as JSON").action(async (opts) => {
-  const config = loadConfig();
-  const registry = buildRegistry();
-  const driver = registry.global(config);
-  const refs = await driver.list();
-  if (opts.json) {
-    console.log(JSON.stringify(refs, null, 2));
-  } else {
-    for (const r of refs) {
-      console.log(`${r.id}	${r.name}	${r.status}`);
-    }
-  }
-});
-runtimeCommand.command("read-screen").description("Print a terminal snapshot of a target workspace").argument("[target]", "Project name").option("--command", "Target the command workspace").action(async (target, opts) => {
-  const config = loadConfig();
-  const registry = buildRegistry();
-  try {
-    const resolved = resolveTarget(registry, config, target, !!opts.command);
-    const ref = await needRef(resolved);
-    const screen = await resolved.driver.readScreen(ref);
-    process.stdout.write(screen);
-  } catch (err) {
-    console.error(chalk19.red(err.message));
-    process.exit(1);
-  }
-});
-runtimeCommand.command("stop").description("Stop a target workspace").argument("[target]", "Project name").option("--command", "Target the command workspace").action(async (target, opts) => {
-  const config = loadConfig();
-  const registry = buildRegistry();
-  try {
-    const resolved = resolveTarget(registry, config, target, !!opts.command);
-    const ref = await resolved.driver.status(resolved.workspaceName);
-    if (!ref) {
-      console.log(chalk19.yellow(`Workspace '${resolved.workspaceName}' already stopped`));
-      return;
-    }
-    await resolved.driver.stop(ref.id);
-    console.log(chalk19.green(`\u2714 Stopped ${resolved.workspaceName}`));
-  } catch (err) {
-    console.error(chalk19.red(err.message));
-    process.exit(1);
-  }
-});
+// packages/cli/src/index.ts
+init_runtime2();
 
 // packages/cli/src/commands/workspace.ts
 init_dist();
@@ -15149,10 +15409,11 @@ var groupCommand = new Command26("group").description("Cross-project intra-group
 // packages/cli/src/commands/ping.ts
 init_dist();
 init_dist2();
+init_runtime2();
+init_require_daemon();
 import { join as join27, dirname as dirname7 } from "path";
 import { Command as Command27 } from "commander";
 import chalk27 from "chalk";
-init_require_daemon();
 async function runPing(project, message) {
   const config = loadConfig();
   const registry = buildRegistry();
@@ -16395,7 +16656,7 @@ function gatherOpenPRs(runner, projectPath) {
   }
 }
 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 }));
+  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, operatorHold: t.operatorHold }));
 }
 function ghAheadOfBase(runner, projectPath, nameWithOwner, base, branch) {
   return tryInt(
@@ -16416,7 +16677,7 @@ function localAheadOfBase(runner, projectPath, base) {
 function readFetchAgeMs(projectPath, now) {
   try {
     const stat2 = fs29.statSync(path31.join(projectPath, ".git", "FETCH_HEAD"));
-    return now - stat2.mtime.getTime();
+    return Math.max(0, now - stat2.mtime.getTime());
   } catch {
     return null;
   }
@@ -16429,6 +16690,7 @@ function gatherLiveRepoState(projectPath, fallbackBaseBranch, tasks, runner = de
   const ghInfo = gatherGhRepoInfo(runner, projectPath);
   const baseBranch = ghInfo?.defaultBranch ?? fallbackBaseBranch;
   const baseBranchSource = ghInfo ? "gh-api" : "local-fallback";
+  const branchState = gatherBranchState(runner, projectPath, branch, baseBranch, detached, fetch2);
   const fetchAgeMs = readFetchAgeMs(projectPath, now);
   let aheadOfBase = 0;
   let aheadOfBaseSource = "unknown";
@@ -16478,7 +16740,7 @@ function gatherLiveRepoState(projectPath, fallbackBaseBranch, tasks, runner = de
     openPRs: gatherOpenPRs(runner, projectPath),
     liveCrews: gatherLiveCrews(tasks),
     conflicts,
-    branchState: gatherBranchState(runner, projectPath, branch, baseBranch, detached, fetch2),
+    branchState,
     unreleasedAheadOfReleaseBranch
   };
 }