sisyphi 1.2.18 → 1.2.20

package/dist/cli.js

@@ -87,8 +87,8 @@ function askReviewSubmitFlagPath(cwd, sessionId, askId) {
 function askVisualsDir(cwd, sessionId, askId) {
   return join(askEntryDir(cwd, sessionId, askId), "visuals");
 }
-function tmuxSessionName(cwd, sessionLabel) {
-  return `ssyph_${basename(cwd)}_${sessionLabel}`;
+function tmuxSessionName(cwd, sessionLabel2) {
+  return `ssyph_${basename(cwd)}_${sessionLabel2}`;
 }
 function sessionsManifestPath() {
   return join(globalDir(), "sessions-manifest.json");
@@ -422,7 +422,7 @@ var init_state = __esm({
 });
 
 // src/shared/platform.ts
-import { execSync as execSync7 } from "child_process";
+import { execFileSync as execFileSync2, execSync as execSync7 } from "child_process";
 import { existsSync as existsSync9, readFileSync as readFileSync10 } from "fs";
 function detectPlatform() {
   if (cachedPlatform) return cachedPlatform;
@@ -467,6 +467,20 @@ function hasCommand(cmd) {
     return false;
   }
 }
+function isTerminalFrontmost() {
+  if (detectPlatform() !== "darwin") return false;
+  try {
+    const raw = execFileSync2(
+      "osascript",
+      ["-e", 'tell application "System Events" to get name of first application process whose frontmost is true'],
+      { timeout: 1e3, stdio: ["ignore", "pipe", "ignore"] }
+    );
+    const name = raw.toString().trim().toLowerCase();
+    return TERMINAL_APP_NAMES.has(name);
+  } catch {
+    return false;
+  }
+}
 function platformLabel() {
   switch (detectPlatform()) {
     case "darwin":
@@ -483,11 +497,24 @@ function platformLabel() {
       return "unknown";
   }
 }
-var cachedPlatform, cmdCache;
+var cachedPlatform, cmdCache, TERMINAL_APP_NAMES;
 var init_platform = __esm({
   "src/shared/platform.ts"() {
     "use strict";
     cmdCache = /* @__PURE__ */ new Map();
+    TERMINAL_APP_NAMES = /* @__PURE__ */ new Set([
+      "iterm2",
+      "iterm",
+      "terminal",
+      "apple_terminal",
+      "alacritty",
+      "kitty",
+      "wezterm",
+      "ghostty",
+      "hyper",
+      "warp",
+      "tmux"
+    ]);
   }
 });
 
@@ -635,13 +662,14 @@ var init_notify = __esm({
 });
 
 // src/daemon/ask-store.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync11, readdirSync as readdirSync3 } from "fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync11, readdirSync as readdirSync3, unlinkSync as unlinkSync3 } from "fs";
 import { basename as basename3 } from "path";
-function maybeNotifyOnAskCreated(cwd, sessionId, meta) {
+function maybeNotifyOnAskCreated(cwd, sessionId, meta, suppress = false) {
   if (process.env.NODE_ENV === "test" || process.env.SISYPHUS_DISABLE_NOTIFY === "1") return;
   const isActionable = meta.kind !== void 0 && ACTIONABLE_KINDS.has(meta.kind);
   const isHeartbeat = meta.askedBy === HEARTBEAT_ASKED_BY;
   if (!isActionable && !isHeartbeat) return;
+  if (suppress) return;
   try {
     const config = loadConfig(cwd);
     if (config.notifications?.enabled === false) return;
@@ -667,8 +695,7 @@ function createAsk(cwd, sessionId, params) {
     ...params.title !== void 0 ? { title: params.title } : {},
     ...params.subtitle !== void 0 ? { subtitle: params.subtitle } : {},
     ...params.kind !== void 0 ? { kind: params.kind } : {},
-    ...params.orphanTarget !== void 0 ? { orphanTarget: params.orphanTarget } : {},
-    ...params.modeTransition !== void 0 ? { modeTransition: params.modeTransition } : {}
+    ...params.orphanTarget !== void 0 ? { orphanTarget: params.orphanTarget } : {}
   };
   atomicWrite(askMetaPath(cwd, sessionId, params.askId), JSON.stringify(meta, null, 2));
   emitHistoryEvent(sessionId, "ask-issued", {
@@ -677,7 +704,7 @@ function createAsk(cwd, sessionId, params) {
     blocking: params.blocking,
     askedAt
   });
-  maybeNotifyOnAskCreated(cwd, sessionId, meta);
+  maybeNotifyOnAskCreated(cwd, sessionId, meta, params.suppressTerminalNotification === true);
   return meta;
 }
 function writeDecisions(cwd, sessionId, askId, deck) {
@@ -898,9 +925,9 @@ var init_exec = __esm({
 });
 
 // src/daemon/frontmatter.ts
-import { readFileSync as readFileSync15, existsSync as existsSync14, readdirSync as readdirSync5 } from "fs";
+import { readFileSync as readFileSync16, existsSync as existsSync14, readdirSync as readdirSync5 } from "fs";
 import { homedir as homedir8 } from "os";
-import { join as join15, basename as basename5 } from "path";
+import { join as join16, basename as basename5 } from "path";
 function parseAgentFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return {};
@@ -950,7 +977,7 @@ function discoverAgentTypes(pluginDir, cwd) {
       if (seen.has(qualifiedName)) continue;
       seen.add(qualifiedName);
       try {
-        const content = readFileSync15(join15(dir, file), "utf-8");
+        const content = readFileSync16(join16(dir, file), "utf-8");
         const fm = parseAgentFrontmatter(content);
         results.push({ qualifiedName, source, description: fm.description, model: fm.model });
       } catch {
@@ -958,14 +985,14 @@ function discoverAgentTypes(pluginDir, cwd) {
       }
     }
   }
-  scanDir(join15(projectAgentPluginDir(cwd), "agents"), null, "project-sis");
-  scanDir(join15(userAgentPluginDir(), "agents"), null, "user-sis");
-  scanDir(join15(cwd, ".claude", "agents"), null, "project");
-  scanDir(join15(homedir8(), ".claude", "agents"), null, "user");
-  scanDir(join15(pluginDir, "agents"), "sisyphus", "bundled");
+  scanDir(join16(projectAgentPluginDir(cwd), "agents"), null, "project-sis");
+  scanDir(join16(userAgentPluginDir(), "agents"), null, "user-sis");
+  scanDir(join16(cwd, ".claude", "agents"), null, "project");
+  scanDir(join16(homedir8(), ".claude", "agents"), null, "user");
+  scanDir(join16(pluginDir, "agents"), "sisyphus", "bundled");
   try {
-    const registryPath2 = join15(homedir8(), ".claude", "plugins", "installed_plugins.json");
-    const registry = JSON.parse(readFileSync15(registryPath2, "utf-8"));
+    const registryPath2 = join16(homedir8(), ".claude", "plugins", "installed_plugins.json");
+    const registry = JSON.parse(readFileSync16(registryPath2, "utf-8"));
     const pluginEntries = registry.plugins ?? registry;
     for (const key of Object.keys(pluginEntries)) {
       const atIdx = key.indexOf("@");
@@ -974,7 +1001,7 @@ function discoverAgentTypes(pluginDir, cwd) {
       const entry = pluginEntries[key];
       const installPath = Array.isArray(entry) ? entry[0]?.installPath : entry?.installPath;
       if (installPath) {
-        scanDir(join15(installPath, "agents"), namespace, "plugin");
+        scanDir(join16(installPath, "agents"), namespace, "plugin");
       }
     }
   } catch {
@@ -996,8 +1023,8 @@ var init_effort_render = __esm({
 });
 
 // src/daemon/extensions.ts
-import { existsSync as existsSync15, readFileSync as readFileSync16, readdirSync as readdirSync6, copyFileSync as copyFileSync2, mkdirSync as mkdirSync8, statSync as statSync3, rmSync as rmSync4, writeFileSync as writeFileSync8 } from "fs";
-import { resolve as resolve6, join as join16, basename as basename6, relative } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync17, readdirSync as readdirSync6, copyFileSync as copyFileSync2, mkdirSync as mkdirSync8, statSync as statSync3, rmSync as rmSync4, writeFileSync as writeFileSync9 } from "fs";
+import { resolve as resolve6, join as join17, basename as basename6, relative } from "path";
 function resolveBundledTemplateDir(kind) {
   const built = resolve6(import.meta.dirname, "../templates", kind);
   if (existsSync15(built)) return built;
@@ -1014,12 +1041,12 @@ var init_extensions = __esm({
 });
 
 // src/shared/version.ts
-import { readFileSync as readFileSync21 } from "fs";
+import { readFileSync as readFileSync22 } from "fs";
 import { resolve as resolve7 } from "path";
 function readSisyphusVersion() {
   for (const rel of ["../package.json", "../../package.json"]) {
     try {
-      const raw = readFileSync21(resolve7(import.meta.dirname, rel), "utf-8");
+      const raw = readFileSync22(resolve7(import.meta.dirname, rel), "utf-8");
       const pkg = JSON.parse(raw);
       if (pkg.name === "sisyphi" && pkg.version) return pkg.version;
     } catch {
@@ -1086,9 +1113,9 @@ var init_upload = __esm({
 // src/shared/session-export.ts
 import { execFile as execFile2 } from "child_process";
 import { promisify } from "util";
-import { existsSync as existsSync25, readFileSync as readFileSync25, mkdirSync as mkdirSync11, symlinkSync, rmSync as rmSync5, writeFileSync as writeFileSync12 } from "fs";
+import { existsSync as existsSync25, readFileSync as readFileSync26, mkdirSync as mkdirSync11, symlinkSync, rmSync as rmSync5, writeFileSync as writeFileSync13 } from "fs";
 import { homedir as homedir12 } from "os";
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 function sanitizeName(name) {
   return name.replace(/[^a-zA-Z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
 }
@@ -1096,11 +1123,11 @@ function buildOutputPath(label, dir) {
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   mkdirSync11(dir, { recursive: true });
   const base = `sisyphus-${label}-${date}`;
-  let candidate = join22(dir, `${base}.zip`);
+  let candidate = join23(dir, `${base}.zip`);
   let counter = 1;
   while (existsSync25(candidate)) {
     counter++;
-    candidate = join22(dir, `${base}-${counter}.zip`);
+    candidate = join23(dir, `${base}-${counter}.zip`);
   }
   return candidate;
 }
@@ -1170,24 +1197,24 @@ async function exportSessionToZip(sessionId, cwd, options) {
   const stPath = statePath(cwd, sessionId);
   if (existsSync25(stPath)) {
     try {
-      const state = JSON.parse(readFileSync25(stPath, "utf-8"));
+      const state = JSON.parse(readFileSync26(stPath, "utf-8"));
       if (state.name) {
         label = sanitizeName(state.name);
       }
     } catch {
     }
   }
-  const dir = options?.outputDir ?? join22(homedir12(), "Downloads");
+  const dir = options?.outputDir ?? join23(homedir12(), "Downloads");
   const outputPath = buildOutputPath(label, dir);
   const tmpDir = `/tmp/sisyphus-export-${sessionId.slice(0, 8)}-${Date.now()}`;
   try {
     mkdirSync11(tmpDir, { recursive: true });
-    writeFileSync12(join22(tmpDir, "CLAUDE.md"), generateGuide(), "utf-8");
+    writeFileSync13(join23(tmpDir, "CLAUDE.md"), generateGuide(), "utf-8");
     if (sessExists) {
-      symlinkSync(sessDir, join22(tmpDir, "session"));
+      symlinkSync(sessDir, join23(tmpDir, "session"));
     }
     if (histExists) {
-      symlinkSync(histDir, join22(tmpDir, "history"));
+      symlinkSync(histDir, join23(tmpDir, "history"));
     }
     const parts = ["CLAUDE.md", sessExists ? "session/" : "", histExists ? "history/" : ""].filter(Boolean);
     await execFileAsync("zip", ["-rq", outputPath, ...parts], { cwd: tmpDir });
@@ -1398,9 +1425,9 @@ var init_companion_normalize = __esm({
 });
 
 // src/daemon/companion.ts
-import { existsSync as existsSync27, mkdirSync as mkdirSync12, readFileSync as readFileSync27, renameSync as renameSync4, writeFileSync as writeFileSync14 } from "fs";
+import { existsSync as existsSync27, mkdirSync as mkdirSync12, readFileSync as readFileSync28, renameSync as renameSync4, writeFileSync as writeFileSync15 } from "fs";
 import { randomUUID as randomUUID3 } from "crypto";
-import { dirname as dirname9, join as join24 } from "path";
+import { dirname as dirname9, join as join25 } from "path";
 function loadCompanion() {
   const path = companionPath();
   if (!existsSync27(path)) {
@@ -1408,7 +1435,7 @@ function loadCompanion() {
     saveCompanion(state2);
     return state2;
   }
-  const raw = readFileSync27(path, "utf-8");
+  const raw = readFileSync28(path, "utf-8");
   const state = JSON.parse(raw);
   return normalizeCompanion(state);
 }
@@ -1416,8 +1443,8 @@ function saveCompanion(state) {
   const path = companionPath();
   const dir = dirname9(path);
   mkdirSync12(dir, { recursive: true });
-  const tmp = join24(dir, `.companion.${randomUUID3()}.tmp`);
-  writeFileSync14(tmp, JSON.stringify(state, null, 2), "utf-8");
+  const tmp = join25(dir, `.companion.${randomUUID3()}.tmp`);
+  writeFileSync15(tmp, JSON.stringify(state, null, 2), "utf-8");
   renameSync4(tmp, path);
 }
 function createDefaultCompanion() {
@@ -1470,8 +1497,8 @@ var init_companion = __esm({
 });
 
 // src/daemon/companion-memory.ts
-import { existsSync as existsSync28, mkdirSync as mkdirSync13, readFileSync as readFileSync28, renameSync as renameSync5, writeFileSync as writeFileSync15 } from "fs";
-import { dirname as dirname10, join as join25 } from "path";
+import { existsSync as existsSync28, mkdirSync as mkdirSync13, readFileSync as readFileSync29, renameSync as renameSync5, writeFileSync as writeFileSync16 } from "fs";
+import { dirname as dirname10, join as join26 } from "path";
 import { randomUUID as randomUUID4 } from "crypto";
 import { z } from "zod";
 function isSafeObservationText(text) {
@@ -1501,7 +1528,7 @@ function loadMemoryStrict() {
   if (!existsSync28(path)) return defaultMemoryState();
   let raw;
   try {
-    raw = readFileSync28(path, "utf-8");
+    raw = readFileSync29(path, "utf-8");
   } catch (err) {
     throw new MemoryStoreParseError(err);
   }
@@ -1597,10 +1624,10 @@ var init_companion_render = __esm({
 });
 
 // src/daemon/companion-popup.ts
-import { writeFileSync as writeFileSync16, readFileSync as readFileSync29, unlinkSync as unlinkSync4, existsSync as existsSync29 } from "fs";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join26, resolve as resolve10 } from "path";
-function wrapText(text, width) {
+import { writeFileSync as writeFileSync17, readFileSync as readFileSync30, unlinkSync as unlinkSync6, existsSync as existsSync29 } from "fs";
+import { tmpdir as tmpdir3 } from "os";
+import { join as join27, resolve as resolve10 } from "path";
+function wrapText2(text, width) {
   const words = text.split(" ");
   const lines = [];
   let current = "";
@@ -1630,16 +1657,16 @@ function showCommentaryPopupQueue(pages) {
     const defaultTitle = ` (${face}) `;
     let maxContentHeight = 0;
     for (let i = 0; i < pages.length; i++) {
-      const lines = wrapText(pages[i].text, INNER_WIDTH);
+      const lines = wrapText2(pages[i].text, INNER_WIDTH2);
       const isLast = i === pages.length - 1;
       const hint = isLast ? "[0:ok 1:good 2:bad 3:whip]" : "[enter:next  0-3:rate]";
-      const hintPad = Math.max(0, Math.floor((INNER_WIDTH - hint.length) / 2));
+      const hintPad = Math.max(0, Math.floor((INNER_WIDTH2 - hint.length) / 2));
       const hintLine = " ".repeat(hintPad + 2) + hint;
       const content = "\n\n" + lines.map((l) => `  ${l}`).join("\n") + "\n\n" + hintLine + "\n";
       const contentLineCount = content.split("\n").length - 1;
       const contentHeight = Math.max(contentLineCount + 2, 5);
       if (contentHeight > maxContentHeight) maxContentHeight = contentHeight;
-      writeFileSync16(`${POPUP_TMP_PREFIX}-${i}.txt`, content);
+      writeFileSync17(`${POPUP_TMP_PREFIX}-${i}.txt`, content);
     }
     const whipAvailable = existsSync29(WHIP_ANIMATION_PATH);
     if (whipAvailable && maxContentHeight < WHIP_ANIMATION_ROWS + 2) {
@@ -1688,9 +1715,9 @@ if [ ! -f "$RESULT_FILE" ]; then
   printf 'neutral' > "$RESULT_FILE"
 fi
 `;
-    writeFileSync16(POPUP_SCRIPT, script, { mode: 493 });
+    writeFileSync17(POPUP_SCRIPT, script, { mode: 493 });
     try {
-      unlinkSync4(POPUP_RESULT_PREFIX);
+      unlinkSync6(POPUP_RESULT_PREFIX);
     } catch {
     }
     const clientsRaw = execSafe('tmux list-clients -F "#{client_name} #{client_width}"');
@@ -1700,27 +1727,27 @@ fi
       const client = line.slice(0, lastSpace);
       const clientWidth = parseInt(line.slice(lastSpace + 1), 10);
       if (!clientWidth) continue;
-      const x = Math.max(0, clientWidth - POPUP_WIDTH);
+      const x = Math.max(0, clientWidth - POPUP_WIDTH2 - 1);
       const args2 = [
         `-c ${shellQuote(client)}`,
         "-E -b rounded",
         `-T ${shellQuote(initialTitle)}`,
         `-S "fg=${moodColor}"`,
         `-s "fg=${moodColor}"`,
-        `-x ${x} -y 0`,
-        `-w ${POPUP_WIDTH} -h ${maxContentHeight}`,
+        `-x ${x} -y 2`,
+        `-w ${POPUP_WIDTH2} -h ${maxContentHeight}`,
         shellQuote(POPUP_SCRIPT)
       ].join(" ");
       execSafe(`tmux display-popup ${args2}`);
     }
     let raw;
     try {
-      raw = readFileSync29(POPUP_RESULT_PREFIX, "utf8").trim();
+      raw = readFileSync30(POPUP_RESULT_PREFIX, "utf8").trim();
     } catch {
       return null;
     } finally {
       try {
-        unlinkSync4(POPUP_RESULT_PREFIX);
+        unlinkSync6(POPUP_RESULT_PREFIX);
       } catch {
       }
     }
@@ -1734,7 +1761,7 @@ fi
   }
   return null;
 }
-var POPUP_WIDTH, INNER_WIDTH, POPUP_DURATION, POPUP_TMP_PREFIX, POPUP_SCRIPT, POPUP_RESULT_PREFIX, WHIP_ANIMATION_PATH, WHIP_ANIMATION_ROWS;
+var POPUP_WIDTH2, INNER_WIDTH2, POPUP_DURATION, POPUP_TMP_PREFIX, POPUP_SCRIPT, POPUP_RESULT_PREFIX, WHIP_ANIMATION_PATH, WHIP_ANIMATION_ROWS;
 var init_companion_popup = __esm({
   "src/daemon/companion-popup.ts"() {
     "use strict";
@@ -1743,12 +1770,12 @@ var init_companion_popup = __esm({
     init_config();
     init_exec();
     init_shell();
-    POPUP_WIDTH = 38;
-    INNER_WIDTH = POPUP_WIDTH - 6;
+    POPUP_WIDTH2 = 38;
+    INNER_WIDTH2 = POPUP_WIDTH2 - 6;
     POPUP_DURATION = 15;
-    POPUP_TMP_PREFIX = join26(tmpdir2(), "sisyphus-popup");
-    POPUP_SCRIPT = join26(tmpdir2(), "sisyphus-popup.sh");
-    POPUP_RESULT_PREFIX = join26(tmpdir2(), "sisyphus-popup-result");
+    POPUP_TMP_PREFIX = join27(tmpdir3(), "sisyphus-popup");
+    POPUP_SCRIPT = join27(tmpdir3(), "sisyphus-popup.sh");
+    POPUP_RESULT_PREFIX = join27(tmpdir3(), "sisyphus-popup-result");
     WHIP_ANIMATION_PATH = resolve10(import.meta.dirname, "../templates/whip-animation.sh");
     WHIP_ANIMATION_ROWS = 12;
   }
@@ -1776,9 +1803,9 @@ __export(tmux_exports, {
   windowExists: () => windowExists
 });
 import { execSync as execSync17 } from "child_process";
-import { join as join27 } from "path";
-import { readFileSync as readFileSync30, writeFileSync as writeFileSync17, mkdtempSync, rmSync as rmSync7, cpSync as cpSync3, existsSync as existsSync30, mkdirSync as mkdirSync14 } from "fs";
-import { tmpdir as tmpdir3 } from "os";
+import { join as join28 } from "path";
+import { readFileSync as readFileSync31, writeFileSync as writeFileSync18, mkdtempSync, rmSync as rmSync7, cpSync as cpSync3, existsSync as existsSync30, mkdirSync as mkdirSync14 } from "fs";
+import { tmpdir as tmpdir4 } from "os";
 function getWindowId() {
   const pane = process.env["TMUX_PANE"];
   if (pane) {
@@ -1829,8 +1856,8 @@ function registerDashboardWindow(cwd) {
   }
 }
 function setupCompanionPlugin() {
-  const srcDir = join27(import.meta.dirname, "templates", "companion-plugin");
-  const destDir = join27(globalDir(), "companion-plugin");
+  const srcDir = join28(import.meta.dirname, "templates", "companion-plugin");
+  const destDir = join28(globalDir(), "companion-plugin");
   if (!existsSync30(destDir)) mkdirSync14(destDir, { recursive: true });
   cpSync3(srcDir, destDir, { recursive: true });
   return destDir;
@@ -1858,18 +1885,18 @@ function openCompanionPane(cwd) {
     return;
   }
   const pluginDir = setupCompanionPlugin();
-  const templatePath2 = join27(import.meta.dirname, "templates", "dashboard-claude.md");
+  const templatePath2 = join28(import.meta.dirname, "templates", "dashboard-claude.md");
   let template;
   try {
-    template = readFileSync30(templatePath2, "utf-8");
+    template = readFileSync31(templatePath2, "utf-8");
   } catch {
     template = `You are a Sisyphus dashboard companion. Help the user manage multi-agent sessions.
 Project: ${cwd}
 Run \`sis session inspect list\` and \`sis session inspect status\` to see current state.`;
   }
   const rendered = template.replace(/\{\{CWD\}\}/g, cwd);
-  const promptPath = join27(globalDir(), "dashboard-companion-prompt.md");
-  writeFileSync17(promptPath, rendered, "utf-8");
+  const promptPath = join28(globalDir(), "dashboard-companion-prompt.md");
+  writeFileSync18(promptPath, rendered, "utf-8");
   const pathEnv = augmentedPath();
   const claudeCmd = `SISYPHUS_COMPANION_CWD=${shellQuote(cwd)} PATH=${shellQuote(pathEnv)} claude --dangerously-skip-permissions --plugin-dir ${shellQuote(pluginDir)} --append-system-prompt "$(cat ${shellQuote(promptPath)})"`;
   const result = exec2(
@@ -1884,12 +1911,12 @@ function switchToSession(sessionName) {
   execSafe(`tmux switch-client -t ${shellQuote(sessionName)}`);
 }
 function editInPopup(cwd, editor, opts) {
-  const tmpDir = mkdtempSync(join27(tmpdir3(), "sisyphus-"));
-  const filePath = join27(tmpDir, "input.md");
+  const tmpDir = mkdtempSync(join28(tmpdir4(), "sisyphus-"));
+  const filePath = join28(tmpDir, "input.md");
   try {
-    writeFileSync17(filePath, opts?.content ? opts.content : "", "utf-8");
+    writeFileSync18(filePath, opts?.content ? opts.content : "", "utf-8");
     openEditorPopup(cwd, editor, filePath, opts?.size);
-    const result = readFileSync30(filePath, "utf-8").trim();
+    const result = readFileSync31(filePath, "utf-8").trim();
     return result || null;
   } finally {
     rmSync7(tmpDir, { recursive: true, force: true });
@@ -1897,8 +1924,8 @@ function editInPopup(cwd, editor, opts) {
 }
 function promptInPopup(prompt, opts) {
   const { w = "50%", h = "3" } = opts ?? {};
-  const tmpDir = mkdtempSync(join27(tmpdir3(), "sisyphus-"));
-  const outFile = join27(tmpDir, "result");
+  const tmpDir = mkdtempSync(join28(tmpdir4(), "sisyphus-"));
+  const outFile = join28(tmpDir, "result");
   try {
     const script = `printf ${shellQuote(prompt + " ")} && read -r line && printf '%s' "$line" > ${shellQuote(outFile)}`;
     execSync17(
@@ -1906,7 +1933,7 @@ function promptInPopup(prompt, opts) {
       { stdio: "inherit", env: EXEC_ENV }
     );
     if (!existsSync30(outFile)) return null;
-    const result = readFileSync30(outFile, "utf-8").trim();
+    const result = readFileSync31(outFile, "utf-8").trim();
     return result || null;
   } finally {
     rmSync7(tmpDir, { recursive: true, force: true });
@@ -1937,10 +1964,10 @@ function openClaudeResumePopup(cwd, claudeSessionId, resumeEnv, resumeArgs) {
     { stdio: "inherit", env: EXEC_ENV }
   );
 }
-function openClaudeResumeSession(cwd, sessionId, claudeSessionId, sessionLabel, resumeEnv, resumeArgs, cycleNum, mode) {
-  const sessionName = tmuxSessionName(cwd, sessionLabel);
+function openClaudeResumeSession(cwd, sessionId, claudeSessionId, sessionLabel2, resumeEnv, resumeArgs, cycleNum, mode) {
+  const sessionName = tmuxSessionName(cwd, sessionLabel2);
   const cycleLabel = cycleNum != null ? `c${cycleNum}` : "";
-  const paneTitle = cycleLabel ? `ssph:orch ${sessionLabel} ${cycleLabel}` : `ssph:orch ${sessionLabel}`;
+  const paneTitle = cycleLabel ? `ssph:orch ${sessionLabel2} ${cycleLabel}` : `ssph:orch ${sessionLabel2}`;
   const existing = execSafe('tmux list-sessions -F "#{session_id}|#{session_name}"');
   const existingLine = existing?.split("\n").find((line) => line.slice(line.indexOf("|") + 1) === sessionName);
   if (existingLine) {
@@ -1948,7 +1975,7 @@ function openClaudeResumeSession(cwd, sessionId, claudeSessionId, sessionLabel,
     execSafe(`tmux set-option -t ${shellQuote(existingSessId)} @sisyphus_cwd ${shellQuote(cwd.replace(/\/+$/, ""))}`);
     execSafe(`tmux set-option -t ${shellQuote(existingSessId)} @sisyphus_session_id ${shellQuote(sessionId)}`);
     const firstPaneId2 = execSafe(`tmux list-panes -t ${shellQuote(existingSessId)} -F '#{pane_id}'`)?.split("\n")[0];
-    if (firstPaneId2) applyOrchestratorPaneStyle(firstPaneId2, paneTitle, sessionLabel, cycleLabel, mode);
+    if (firstPaneId2) applyOrchestratorPaneStyle(firstPaneId2, paneTitle, sessionLabel2, cycleLabel, mode);
     return sessionName;
   }
   const pathEnv = augmentedPath();
@@ -1964,14 +1991,14 @@ function openClaudeResumeSession(cwd, sessionId, claudeSessionId, sessionLabel,
   execSafe(`tmux set -w -t ${shellQuote(newSessId + ":")} pane-border-status top`);
   execSafe(`tmux set -w -t ${shellQuote(newSessId + ":")} allow-rename off`);
   execSafe(`tmux set -w -t ${shellQuote(newSessId + ":")} automatic-rename off`);
-  if (firstPaneId) applyOrchestratorPaneStyle(firstPaneId, paneTitle, sessionLabel, cycleLabel, mode);
+  if (firstPaneId) applyOrchestratorPaneStyle(firstPaneId, paneTitle, sessionLabel2, cycleLabel, mode);
   return sessionName;
 }
-function applyOrchestratorPaneStyle(paneId, title, sessionLabel, cycleLabel, mode) {
+function applyOrchestratorPaneStyle(paneId, title, sessionLabel2, cycleLabel, mode) {
   const color = "yellow";
   execSafe(`tmux select-pane -t ${shellQuote(paneId)} -T ${shellQuote(title)}`);
   execSafe(`tmux set -p -t ${shellQuote(paneId)} @pane_role ${shellQuote("orch")}`);
-  execSafe(`tmux set -p -t ${shellQuote(paneId)} @pane_session ${shellQuote(sessionLabel)}`);
+  execSafe(`tmux set -p -t ${shellQuote(paneId)} @pane_session ${shellQuote(sessionLabel2)}`);
   if (cycleLabel) execSafe(`tmux set -p -t ${shellQuote(paneId)} @pane_cycle ${shellQuote(cycleLabel)}`);
   if (mode) execSafe(`tmux set -p -t ${shellQuote(paneId)} @pane_mode ${shellQuote(mode)}`);
   const gitBranch = `#(cd #{pane_current_path} && git branch --show-current 2>/dev/null)`;
@@ -2024,7 +2051,7 @@ __export(creds_exports, {
   readTailscaleEnv: () => readTailscaleEnv,
   writeTailscaleEnv: () => writeTailscaleEnv
 });
-import { chmodSync as chmodSync3, existsSync as existsSync31, mkdirSync as mkdirSync16, readFileSync as readFileSync32 } from "fs";
+import { chmodSync as chmodSync3, existsSync as existsSync31, mkdirSync as mkdirSync16, readFileSync as readFileSync33 } from "fs";
 import { createInterface as createInterface4 } from "readline";
 function isValidProvider(value) {
   return PROVIDERS.includes(value);
@@ -2058,7 +2085,7 @@ function serializeEnvFile(values) {
 }
 function readEnvFile(path) {
   if (!existsSync31(path)) return null;
-  return parseEnvFile(readFileSync32(path, "utf-8"));
+  return parseEnvFile(readFileSync33(path, "utf-8"));
 }
 function writeEnvFile(path, values) {
   ensureDeployDir();
@@ -2188,12 +2215,12 @@ var init_pricing = __esm({
 });
 
 // src/cli/deploy/runtime.ts
-import { existsSync as existsSync32, readFileSync as readFileSync33, unlinkSync as unlinkSync5 } from "fs";
+import { existsSync as existsSync32, readFileSync as readFileSync34, unlinkSync as unlinkSync7 } from "fs";
 function readRuntimeState(provider) {
   const path = deployRuntimePath(provider);
   if (!existsSync32(path)) return null;
   try {
-    return JSON.parse(readFileSync33(path, "utf-8"));
+    return JSON.parse(readFileSync34(path, "utf-8"));
   } catch {
     return null;
   }
@@ -2203,7 +2230,7 @@ function writeRuntimeState(provider, state) {
 }
 function clearRuntimeState(provider) {
   const path = deployRuntimePath(provider);
-  if (existsSync32(path)) unlinkSync5(path);
+  if (existsSync32(path)) unlinkSync7(path);
 }
 var init_runtime = __esm({
   "src/cli/deploy/runtime.ts"() {
@@ -2447,7 +2474,7 @@ var init_tailscale = __esm({
 
 // src/cli/deploy/runner.ts
 import { spawn as spawn2, spawnSync as spawnSync5 } from "child_process";
-import { copyFileSync as copyFileSync3, existsSync as existsSync34, mkdirSync as mkdirSync17, readFileSync as readFileSync34 } from "fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync34, mkdirSync as mkdirSync17, readFileSync as readFileSync35 } from "fs";
 function runTerraform(provider, args2, extraEnv) {
   ensureProviderStateDir(provider);
   ensureTerraformInstalled();
@@ -2485,7 +2512,7 @@ function readSshPubkey(path) {
 or pass --ssh-key <path>.`
     );
   }
-  return readFileSync34(path, "utf-8").trim();
+  return readFileSync35(path, "utf-8").trim();
 }
 function readOutputs(provider) {
   const result = spawnSync5("terraform", ["output", "-json", `-state=${deployStatePath(provider)}`], {
@@ -2800,7 +2827,7 @@ var init_grove = __esm({
 // src/cli/cloud/repo.ts
 import { spawnSync as spawnSync7 } from "child_process";
 import { existsSync as existsSync35 } from "fs";
-import { basename as basename8, join as join30 } from "path";
+import { basename as basename8, join as join31 } from "path";
 function captureGit(args2, cwd) {
   const result = spawnSync7("git", args2, {
     encoding: "utf-8",
@@ -2840,10 +2867,10 @@ function buildRsyncArgs(localDir, remoteTarget) {
   ];
 }
 function detectPackageManager(toplevel) {
-  if (existsSync35(join30(toplevel, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync35(join30(toplevel, "bun.lockb"))) return "bun";
-  if (existsSync35(join30(toplevel, "yarn.lock"))) return "yarn";
-  if (existsSync35(join30(toplevel, "package-lock.json"))) return "npm";
+  if (existsSync35(join31(toplevel, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync35(join31(toplevel, "bun.lockb"))) return "bun";
+  if (existsSync35(join31(toplevel, "yarn.lock"))) return "yarn";
+  if (existsSync35(join31(toplevel, "package-lock.json"))) return "npm";
   return null;
 }
 function packageManagerInstallCmd(pm) {
@@ -3126,7 +3153,7 @@ var init_protocol = __esm({
 });
 
 // src/daemon/spawn-helpers.ts
-import { writeFileSync as writeFileSync20, existsSync as existsSync38 } from "fs";
+import { writeFileSync as writeFileSync21, existsSync as existsSync38 } from "fs";
 import { resolve as resolve13 } from "path";
 var init_spawn_helpers = __esm({
   "src/daemon/spawn-helpers.ts"() {
@@ -3135,17 +3162,180 @@ var init_spawn_helpers = __esm({
   }
 });
 
+// src/cli/help-rubric.ts
+function commandPath(cmd) {
+  const parts = [];
+  let cur = cmd;
+  while (cur !== null) {
+    parts.push(cur.name());
+    cur = cur.parent;
+  }
+  parts.reverse();
+  parts.shift();
+  return parts.join(" ");
+}
+function subcommandRubric(cmd) {
+  if (cmd.name() === "help") {
+    return cmd.summary() || cmd.description();
+  }
+  const p = commandPath(cmd);
+  let key = p;
+  const deployProviderMatch = p.match(/^deploy (hetzner|aws) (.+)$/);
+  if (deployProviderMatch) {
+    key = `deploy * ${deployProviderMatch[2]}`;
+  }
+  const r = RUBRICS[key];
+  if (r) {
+    return `${r.short}  | use when ${r.useWhen}`;
+  }
+  return cmd.summary() || cmd.description();
+}
+var RUBRICS, CONCEPTS_BLOCK, ROOT_AFTER_HELP;
+var init_help_rubric = __esm({
+  "src/cli/help-rubric.ts"() {
+    "use strict";
+    RUBRICS = {
+      "session": { short: "Manage tracked orchestration sessions", useWhen: "acting on a unit of orchestrated work" },
+      "agent": { short: "Operate on worker agents", useWhen: "directing or reading a spawned agent" },
+      "orch": { short: "Talk to / steer the orchestrator", useWhen: "guiding the session's orchestrator" },
+      "ask": { short: "Human-in-the-loop question I/O", useWhen: "answering or polling a blocking ask" },
+      "ui": { short: "Interactive surfaces", useWhen: "a human wants the dashboard, guide, or scratch" },
+      "segment": { short: "Status-line segment registration", useWhen: "wiring tmux status indicators" },
+      "admin": { short: "Install, verify, and report", useWhen: "setting up or diagnosing the install" },
+      "companion": { short: "Companion-pane helper", useWhen: "driving the companion Claude pane" },
+      "deploy": { short: "Provision cloud boxes (Terraform)", useWhen: "standing up or tearing down infra" },
+      "cloud": { short: "Per-repo workflow on a deployed box", useWhen: "syncing work to/from the box" },
+      "feedback": { short: "Report a problem with sisyphus itself", useWhen: "the user complains about the tool or workflow" },
+      "session lifecycle": { short: "Start/stop/advance a session", useWhen: "changing whether a session runs" },
+      "session inspect": { short: "Read session state", useWhen: "you need status/history/context without mutating" },
+      "session config": { short: "Change a session's settings", useWhen: "adjusting task, effort, or dangerous mode" },
+      "session recover": { short: "Repair or relocate a session", useWhen: "a session is stuck, lost, or needs rollback" },
+      "session scratch": { short: "Open a standalone (non-sisyphus) Claude", useWhen: "you want a throwaway Claude in this repo" },
+      "session lifecycle start": { short: "Start a new session", useWhen: "beginning work on a new task" },
+      "session lifecycle complete": { short: "Mark the current cycle complete", useWhen: "the orchestrator finished its work" },
+      "session lifecycle continue": { short: "Continue past completion into a new cycle", useWhen: "more work follows completion" },
+      "session lifecycle resume": { short: "Resume a paused/handed-off session", useWhen: "bringing a stopped session back" },
+      "session lifecycle kill": { short: "Stop a session, keep its state", useWhen: "halting work but preserving the record" },
+      "session lifecycle delete": { short: "Remove a session and its state", useWhen: "discarding a session permanently" },
+      "session inspect status": { short: "Show live session status", useWhen: "checking what is running now" },
+      "session inspect list": { short: "List sessions", useWhen: "enumerating sessions in this repo" },
+      "session inspect history": { short: "Show past sessions/cycles", useWhen: "reviewing prior runs" },
+      "session inspect context": { short: "Print the orchestrator's context", useWhen: "auditing what the orchestrator sees" },
+      "session inspect export": { short: "Export session transcript/state", useWhen: "archiving or sharing a session" },
+      "session inspect requirements": { short: "Show/export the session requirements", useWhen: "reviewing the locked requirements doc" },
+      "session config task": { short: "Set the session's task text", useWhen: "retargeting what the session works on" },
+      "session config effort": { short: "Set the effort tier", useWhen: "tuning model effort for a session" },
+      "session config dangerous": { short: "Toggle dangerous (skip-permissions) mode", useWhen: "allowing unattended tool use" },
+      "session recover rollback": { short: "Roll back to an earlier cycle", useWhen: "a cycle went wrong" },
+      "session recover reconnect": { short: "Reattach the daemon to a live session", useWhen: "the tmux/daemon link dropped" },
+      "session recover quiesce": { short: "Pause a session at the next safe point", useWhen: "you need it to stop cleanly" },
+      "session recover clone": { short: "Clone a session toward a new goal", useWhen: "forking work from an existing session" },
+      "agent spawn": { short: "Spawn a worker agent", useWhen: "delegating a scoped sub-task" },
+      "agent submit": { short: "Submit this agent's result upstream", useWhen: "from inside an agent, its work is done" },
+      "agent report": { short: "Post a progress report", useWhen: "from inside an agent, updating mid-task" },
+      "agent await": { short: "Block until a spawned agent submits", useWhen: "you need an agent's result before continuing" },
+      "agent ctl": { short: "Agent process control", useWhen: "killing or restarting an agent process" },
+      "agent io": { short: "Agent message I/O", useWhen: "sending text to or reading an agent" },
+      "agent ctl kill": { short: "Kill an agent", useWhen: "an agent must stop immediately" },
+      "agent ctl restart": { short: "Restart an agent", useWhen: "an agent is wedged and should start over" },
+      "agent io tell": { short: "Send text to an agent", useWhen: "injecting instructions into a running agent" },
+      "agent io read": { short: "Read an agent's transcript", useWhen: "inspecting what an agent produced" },
+      "orch yield": { short: "Yield control back to the human/parent", useWhen: "the orchestrator is done or blocked" },
+      "orch tell": { short: "Send text to the orchestrator", useWhen: "injecting guidance into the orchestrator" },
+      "orch message": { short: "Queue a message for the orchestrator", useWhen: "leaving async input for the next turn" },
+      "orch read": { short: "Read the orchestrator's transcript", useWhen: "inspecting orchestrator output" },
+      "ask submit": { short: "Submit an ask deck for a human", useWhen: "an agent needs a human decision" },
+      "ask poll": { short: "Block until an ask is answered", useWhen: "you need the human's answer before continuing" },
+      "ask peek": { short: "Read an ask's state without blocking", useWhen: "checking ask status non-blocking" },
+      "ui dashboard": { short: "Open the TUI dashboard", useWhen: "a human wants the monitoring UI" },
+      "ui guide": { short: "Print the full usage guide", useWhen: "a human needs end-to-end docs" },
+      "segment register": { short: "Register a status-line segment", useWhen: "adding a tmux status indicator" },
+      "segment unregister": { short: "Remove a status-line segment", useWhen: "tearing one down" },
+      "admin install": { short: "Install / uninstall sisyphus bits", useWhen: "first setup or removal" },
+      "admin check": { short: "Verify the installation", useWhen: "diagnosing a broken or partial install" },
+      "admin report": { short: "Diagnostics & telemetry", useWhen: "filing a bug or uploading session data" },
+      "admin install setup": { short: "Run first-time setup", useWhen: "installing sisyphus on this machine" },
+      "admin install setup-keybind": { short: "Install the tmux keybind", useWhen: "wiring the dashboard hotkey" },
+      "admin install init": { short: "Initialize repo-local config", useWhen: "onboarding a new repo" },
+      "admin install uninstall": { short: "Remove sisyphus", useWhen: "fully removing the install" },
+      "admin check doctor": { short: "Run install diagnostics", useWhen: "something is not working and you want a health check" },
+      "admin check check-keybinds": { short: "Verify tmux keybinds", useWhen: "the dashboard hotkey does not fire" },
+      "admin check check-statusbar": { short: "Verify status-line wiring", useWhen: "status segments do not render" },
+      "admin report bug": { short: "File a bug report", useWhen: "reporting a defect with context" },
+      "admin report upload": { short: "Upload session data", useWhen: "sharing a session for support" },
+      "admin report configure-upload": { short: "Configure the upload target", useWhen: "setting where uploads go" },
+      "admin clean-zombies": { short: "Sweep stale zombie processes", useWhen: "cleaning up after a crashed daemon or hung agent" },
+      "cloud box": { short: "Provision / operate the box for this repo", useWhen: "working with the box-side environment" },
+      "cloud handoff": { short: "Move a session between local and box", useWhen: "relocating in-flight work" },
+      "cloud box sync": { short: "Rsync this repo to the box", useWhen: "pushing local code to the box" },
+      "cloud box install": { short: "Run the package install on the box", useWhen: "box deps are missing/stale" },
+      "cloud box session": { short: "Create/refresh the box tmux home", useWhen: "the box-side session is absent" },
+      "cloud box attach": { short: "Attach to the box session", useWhen: "you want to work on the box interactively" },
+      "cloud box status": { short: "Print box-side status", useWhen: "checking box state for this repo" },
+      "cloud box login": { short: "Run claude auth login on the box", useWhen: "the box needs Claude credentials" },
+      "cloud box up": { short: "Sync+install+session in one shot", useWhen: "bringing the box up from cold" },
+      "cloud handoff push": { short: "Hand a live session off to the box", useWhen: "moving local work to the cloud" },
+      "cloud handoff pull": { short: "Reclaim a handed-off session locally", useWhen: "bringing cloud work back home" },
+      "agent types": { short: "Agent-type catalog", useWhen: "discovering installable agent types" },
+      "agent types list": { short: "List agent types", useWhen: "enumerating spawnable agent types" },
+      "deploy list": { short: "List deploy providers", useWhen: "discovering supported providers" },
+      "companion profile": { short: "Print companion profile", useWhen: "reading the combined memory + context + badges blob" },
+      "companion memory": { short: "Show accumulated companion observations", useWhen: "reviewing what the companion noticed" },
+      "companion context": { short: "Emit per-prompt companion context", useWhen: "the companion plugin hook needs context" },
+      "companion pane": { short: "Open/focus the side claude pane", useWhen: "you want the companion pane by the dashboard" },
+      "companion popup-test": { short: "Show a test commentary popup", useWhen: "validating feedback-key handling" },
+      "deploy auth": { short: "Configure provider auth", useWhen: "setting up Tailscale/provider credentials" },
+      "deploy hetzner": { short: "Hetzner box lifecycle", useWhen: "targeting Hetzner" },
+      "deploy aws": { short: "AWS box lifecycle", useWhen: "targeting AWS" },
+      "deploy auth tailscale": { short: "Configure Tailscale OAuth", useWhen: "joining the box to your tailnet" },
+      "deploy * up": { short: "Provision the box", useWhen: "standing the box up" },
+      "deploy * down": { short: "Destroy the box", useWhen: "tearing the box down" },
+      "deploy * status": { short: "Print box outputs", useWhen: "checking IP/cost/instance" },
+      "deploy * ssh": { short: "SSH/mosh into the box", useWhen: "getting a shell on the box" },
+      "deploy * logs": { short: "Tail cloud-init + daemon logs", useWhen: "diagnosing a box-side failure" },
+      "deploy * update": { short: "Upgrade sisyphus on the box", useWhen: "pulling the latest daemon onto the box" }
+    };
+    CONCEPTS_BLOCK = `
+Concepts
+  session       a tracked unit of orchestrated work on one task
+  agent         a worker Claude spawned to execute a scoped sub-task
+  orchestrator  the Claude that owns a session: decomposes, spawns, advances
+  cycle         one discovery\u2192plan\u2192implement\u2192validate iteration; the rollback unit
+  ask           a blocking question surfaced for a human to answer
+  mode          the session's current phase, driving orchestrator behavior
+`;
+    ROOT_AFTER_HELP = `
+I/O contract: flags and positional args on input, JSON on stdout (JSONL for streams).
+
+Exit codes:
+  0   success
+  1   permanent error (fallback)
+  2   usage error (bad args/shape)
+  3   not found
+  4   ambiguous (multiple matches \u2014 see error.candidates)
+  5   conflict (already-exists, wrong-state)
+  60  transient (retry-safe: daemon down, timeout, lock contention)
+
+Errors:
+  {"ok": false,
+   "error": {"code": "<stable-enum>", "kind": "<usage|not_found|ambiguous|conflict|transient|permanent>",
+             "message": "...", "received"?: ..., "expected"?: ..., "next"?: "...", "candidates"?: [...]}}
+`;
+  }
+});
+
 // src/daemon/help-inject.ts
 import { execSync as execSync19 } from "child_process";
 var init_help_inject = __esm({
   "src/daemon/help-inject.ts"() {
     "use strict";
     init_spawn_helpers();
+    init_help_rubric();
   }
 });
 
 // src/shared/digest-verbs.ts
-import { existsSync as existsSync39, readFileSync as readFileSync37 } from "fs";
+import { existsSync as existsSync39, readFileSync as readFileSync38 } from "fs";
 var init_digest_verbs = __esm({
   "src/shared/digest-verbs.ts"() {
     "use strict";
@@ -3161,8 +3351,8 @@ var init_colors = __esm({
 });
 
 // src/daemon/orchestrator-modes.ts
-import { existsSync as existsSync40, readdirSync as readdirSync10, readFileSync as readFileSync38 } from "fs";
-import { resolve as resolve14, join as join32 } from "path";
+import { existsSync as existsSync40, readdirSync as readdirSync10, readFileSync as readFileSync39 } from "fs";
+import { resolve as resolve14, join as join33 } from "path";
 import { homedir as homedir14 } from "os";
 var init_orchestrator_modes = __esm({
   "src/daemon/orchestrator-modes.ts"() {
@@ -3173,8 +3363,8 @@ var init_orchestrator_modes = __esm({
 });
 
 // src/daemon/lib/render-plugin.ts
-import { readdirSync as readdirSync11, readFileSync as readFileSync39, writeFileSync as writeFileSync21, mkdirSync as mkdirSync18, copyFileSync as copyFileSync4, rmSync as rmSync8, existsSync as existsSync41 } from "fs";
-import { join as join33 } from "path";
+import { readdirSync as readdirSync11, readFileSync as readFileSync40, writeFileSync as writeFileSync22, mkdirSync as mkdirSync18, copyFileSync as copyFileSync4, rmSync as rmSync8, existsSync as existsSync41 } from "fs";
+import { join as join34 } from "path";
 var init_render_plugin = __esm({
   "src/daemon/lib/render-plugin.ts"() {
     "use strict";
@@ -3255,10 +3445,10 @@ var init_orphan_sweep = __esm({
 });
 
 // src/daemon/agent.ts
-import { readFileSync as readFileSync40, writeFileSync as writeFileSync22, mkdirSync as mkdirSync19, readdirSync as readdirSync12, existsSync as existsSync43, unlinkSync as unlinkSync6 } from "fs";
+import { readFileSync as readFileSync41, writeFileSync as writeFileSync23, mkdirSync as mkdirSync19, readdirSync as readdirSync12, existsSync as existsSync43, unlinkSync as unlinkSync8 } from "fs";
 import { execSync as execSync21 } from "child_process";
 import { randomUUID as randomUUID5 } from "crypto";
-import { resolve as resolve15, relative as relative2, dirname as dirname13, join as join34 } from "path";
+import { resolve as resolve15, relative as relative2, dirname as dirname13, join as join35 } from "path";
 var init_agent = __esm({
   "src/daemon/agent.ts"() {
     "use strict";
@@ -3336,25 +3526,11 @@ var init_pane_monitor = __esm({
   }
 });
 
-// src/daemon/mode-notify.ts
-import { existsSync as existsSync44 } from "fs";
-import { ulid as ulid3 } from "ulid";
-var init_mode_notify = __esm({
-  "src/daemon/mode-notify.ts"() {
-    "use strict";
-    init_ask_store();
-    init_state();
-    init_orchestrator_modes();
-    init_paths();
-    init_types();
-  }
-});
-
 // src/daemon/orchestrator.ts
-import { existsSync as existsSync45, readdirSync as readdirSync13, readFileSync as readFileSync41, writeFileSync as writeFileSync23 } from "fs";
+import { existsSync as existsSync44, readdirSync as readdirSync13, readFileSync as readFileSync42, writeFileSync as writeFileSync24 } from "fs";
 import { execSync as execSync22 } from "child_process";
 import { randomUUID as randomUUID6 } from "crypto";
-import { resolve as resolve16, join as join35, relative as relative3 } from "path";
+import { resolve as resolve16, join as join36, relative as relative3 } from "path";
 var init_orchestrator = __esm({
   "src/daemon/orchestrator.ts"() {
     "use strict";
@@ -3376,13 +3552,12 @@ var init_orchestrator = __esm({
     init_tmux2();
     init_pane_registry();
     init_pane_monitor();
-    init_mode_notify();
     init_plugins();
   }
 });
 
 // src/daemon/status-dots.ts
-import { readFileSync as readFileSync42 } from "fs";
+import { readFileSync as readFileSync43 } from "fs";
 var COMPLETED_TTL_MS;
 var init_status_dots = __esm({
   "src/daemon/status-dots.ts"() {
@@ -3394,9 +3569,17 @@ var init_status_dots = __esm({
   }
 });
 
+// src/daemon/mode-transition.ts
+var init_mode_transition = __esm({
+  "src/daemon/mode-transition.ts"() {
+    "use strict";
+    init_orchestrator_modes();
+  }
+});
+
 // src/daemon/uploader.ts
 import { rm } from "fs/promises";
-import { tmpdir as tmpdir4 } from "os";
+import { tmpdir as tmpdir5 } from "os";
 var init_uploader = __esm({
   "src/daemon/uploader.ts"() {
     "use strict";
@@ -3435,7 +3618,7 @@ var init_format = __esm({
 
 // src/daemon/session-manager.ts
 import { v4 as uuidv4 } from "uuid";
-import { existsSync as existsSync46, readFileSync as readFileSync43, readdirSync as readdirSync14, rmSync as rmSync9 } from "fs";
+import { existsSync as existsSync45, readFileSync as readFileSync44, readdirSync as readdirSync14, rmSync as rmSync9 } from "fs";
 var init_session_manager = __esm({
   "src/daemon/session-manager.ts"() {
     "use strict";
@@ -3458,6 +3641,7 @@ var init_session_manager = __esm({
     init_companion_render();
     init_companion_commentary();
     init_companion_popup();
+    init_mode_transition();
     init_history();
     init_uploader();
     init_upload();
@@ -3472,7 +3656,7 @@ var init_session_manager = __esm({
 // src/daemon/transcript-digest.ts
 import { openSync, fstatSync, readSync, closeSync } from "fs";
 import { homedir as homedir15 } from "os";
-import { join as join36 } from "path";
+import { join as join37 } from "path";
 var BYTE_CAP, TAIL_BYTES;
 var init_transcript_digest = __esm({
   "src/daemon/transcript-digest.ts"() {
@@ -3486,7 +3670,7 @@ var init_transcript_digest = __esm({
 import {
   closeSync as closeSync2,
   constants,
-  existsSync as existsSync47,
+  existsSync as existsSync46,
   fstatSync as fstatSync2,
   lstatSync as lstatSync2,
   openSync as openSync2,
@@ -3522,17 +3706,17 @@ var init_ask_visual = __esm({
 
 // src/daemon/server.ts
 import { createServer } from "net";
-import { unlinkSync as unlinkSync7, existsSync as existsSync48, writeFileSync as writeFileSync24, readFileSync as readFileSync45, mkdirSync as mkdirSync20, readdirSync as readdirSync15, rmSync as rmSync11, chmodSync as chmodSync4 } from "fs";
-import { join as join37, basename as basename10, dirname as dirname15 } from "path";
+import { unlinkSync as unlinkSync9, existsSync as existsSync47, writeFileSync as writeFileSync25, readFileSync as readFileSync46, mkdirSync as mkdirSync20, readdirSync as readdirSync15, rmSync as rmSync11, chmodSync as chmodSync4 } from "fs";
+import { join as join38, basename as basename10, dirname as dirname15 } from "path";
 import { scanInbox } from "@crouton-kit/humanloop";
 function registryPath() {
-  return join37(globalDir(), "session-registry.json");
+  return join38(globalDir(), "session-registry.json");
 }
 function loadSessionRegistry() {
   const p = registryPath();
-  if (!existsSync48(p)) return {};
+  if (!existsSync47(p)) return {};
   try {
-    return JSON.parse(readFileSync45(p, "utf-8"));
+    return JSON.parse(readFileSync46(p, "utf-8"));
   } catch (err) {
     console.warn("[sisyphus] Failed to parse session registry:", err instanceof Error ? err.message : err);
     return {};
@@ -3563,8 +3747,8 @@ var init_server = __esm({
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { existsSync as existsSync50, mkdirSync as mkdirSync21, readFileSync as readFileSync46 } from "fs";
-import { dirname as dirname16, join as join38 } from "path";
+import { existsSync as existsSync49, mkdirSync as mkdirSync21, readFileSync as readFileSync47 } from "fs";
+import { dirname as dirname16, join as join39 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 
 // src/cli/commands/start.ts
@@ -5670,6 +5854,10 @@ function assertTmux() {
     throw new Error("Not running inside a tmux pane. Sisyphus requires tmux.");
   }
 }
+function getTmuxSession() {
+  assertTmux();
+  return execSync4('tmux display-message -p "#{session_name}"', { encoding: "utf8" }).trim();
+}
 function getTmuxSessionInfo() {
   assertTmux();
   const out = execSync4('tmux display-message -p "#{session_id}|#{session_name}"', { encoding: "utf8" }).trim();
@@ -5686,6 +5874,27 @@ function getCurrentTmuxSessionHome(sessionId) {
     return "";
   }
 }
+function findHomeSession(cwd) {
+  const normalizedCwd = cwd.replace(/\/+$/, "");
+  let output;
+  try {
+    output = execSync4('tmux list-sessions -F "#{session_id}|#{session_name}"', {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return null;
+  }
+  for (const line of output.split("\n").filter(Boolean)) {
+    const pipeIdx = line.indexOf("|");
+    if (pipeIdx < 0) continue;
+    const sessId = line.slice(0, pipeIdx);
+    const name = line.slice(pipeIdx + 1);
+    if (name.startsWith("ssyph_")) continue;
+    if (getCurrentTmuxSessionHome(sessId) === normalizedCwd) return sessId;
+  }
+  return null;
+}
 
 // src/cli/commands/start.ts
 init_shell();
@@ -5939,6 +6148,27 @@ function openDashboardWindow(tmuxSession, cwd) {
     }
   } catch {
   }
+  try {
+    const windows = execSync6(
+      `tmux list-windows -t ${shellQuote(tmuxSession)} -F "#{window_id} #{window_name}"`,
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
+    ).trim();
+    for (const line of windows.split("\n").filter(Boolean)) {
+      const spaceIdx = line.indexOf(" ");
+      if (spaceIdx < 0) continue;
+      const wid = line.slice(0, spaceIdx);
+      const wname = line.slice(spaceIdx + 1);
+      if (wname === "sisyphus-dashboard") {
+        execSync6(
+          `tmux set-option -t ${shellQuote(tmuxSession)} @sisyphus_dashboard ${shellQuote(wid)}`,
+          { stdio: "pipe" }
+        );
+        execSync6(`tmux select-window -t ${shellQuote(wid)}`, { stdio: "pipe" });
+        return false;
+      }
+    }
+  } catch {
+  }
   const tuiPath = join6(import.meta.dirname, "tui.js");
   const windowId = execSync6(
     `tmux new-window -t ${shellQuote(tmuxSession + ":")} -n "sisyphus-dashboard" -c ${shellQuote(cwd)} -P -F "#{window_id}"`,
@@ -6407,8 +6637,8 @@ Exit codes: 0 ok | 2 usage (missing content or --session) | 3 not_found.`
 }
 
 // src/cli/commands/ask.ts
-import { existsSync as existsSync12, readFileSync as readFileSync12, unlinkSync as unlinkSync3, watchFile, unwatchFile } from "fs";
-import { basename as basename4, join as join13, resolve as resolve5 } from "path";
+import { existsSync as existsSync12, readFileSync as readFileSync13, unlinkSync as unlinkSync5, watchFile, unwatchFile } from "fs";
+import { basename as basename4, join as join14, resolve as resolve5 } from "path";
 import { ulid } from "ulid";
 
 // src/shared/ask-schema.ts
@@ -6471,6 +6701,125 @@ init_state();
 init_types();
 init_exec();
 init_shell();
+init_platform();
+
+// src/cli/commands/ask-popup.ts
+init_exec();
+init_shell();
+import { writeFileSync as writeFileSync8, readFileSync as readFileSync12, unlinkSync as unlinkSync4 } from "fs";
+import { tmpdir } from "os";
+import { join as join13 } from "path";
+var POPUP_WIDTH = 46;
+var INNER_WIDTH = POPUP_WIDTH - 6;
+var POPUP_TIMEOUT = 10;
+var ACCENT_COLOR = "colour214";
+function wrapText(text, width) {
+  const words = text.split(/\s+/).filter(Boolean);
+  const lines = [];
+  let current = "";
+  for (const word of words) {
+    if (current && current.length + 1 + word.length > width) {
+      lines.push(current);
+      current = word;
+    } else {
+      current = current ? `${current} ${word}` : word;
+    }
+  }
+  if (current) lines.push(current);
+  return lines.length > 0 ? lines : [""];
+}
+function hasAttachedClient() {
+  const out = execSafe('tmux list-clients -F "#{client_name}"');
+  return !!out && out.split("\n").filter(Boolean).length > 0;
+}
+function showAskTriagePopup(opts) {
+  const scriptPath2 = join13(tmpdir(), `sisyphus-ask-${opts.askId}.sh`);
+  const resultPath = join13(tmpdir(), `sisyphus-ask-${opts.askId}.result`);
+  try {
+    const safeTitle = opts.title.trim().length > 0 ? opts.title : "Question pending";
+    const titleLines = wrapText(safeTitle, INNER_WIDTH);
+    const bodyLines = [
+      "",
+      ...titleLines.map((l) => `  ${l}`),
+      "",
+      "  [1] Dismiss",
+      "  [2] Open in dashboard",
+      "  [3] Open in agent",
+      "",
+      `  (auto-dismiss in ${POPUP_TIMEOUT}s)`,
+      ""
+    ];
+    const content = bodyLines.join("\n") + "\n";
+    const height = bodyLines.length + 2;
+    const script = `#!/bin/sh
+printf '\\033[?25l'
+stty -echo 2>/dev/null
+RESULT_FILE=${shellQuote(resultPath)}
+printf '\\033[2J\\033[H'
+cat <<'__SISYPHUS_ASK_EOF__'
+${content}__SISYPHUS_ASK_EOF__
+while IFS= read -r -n1 -t ${POPUP_TIMEOUT} k; do
+  case "$k" in
+    1|d|D|q|Q|'') printf 'dismiss' > "$RESULT_FILE"; break ;;
+    2|b|B) printf 'dashboard' > "$RESULT_FILE"; break ;;
+    3|a|A) printf 'agent' > "$RESULT_FILE"; break ;;
+  esac
+done
+if [ ! -f "$RESULT_FILE" ]; then printf 'dismiss' > "$RESULT_FILE"; fi
+`;
+    writeFileSync8(scriptPath2, script, { mode: 493 });
+    try {
+      unlinkSync4(resultPath);
+    } catch {
+    }
+    const popupTitle = ` \u2691 ${opts.sessionLabel} `;
+    const clientsRaw = execSafe('tmux list-clients -F "#{client_name} #{client_width}"');
+    if (!clientsRaw) return "dismiss";
+    const lines = clientsRaw.split("\n").filter(Boolean);
+    if (lines.length === 0) return "dismiss";
+    let raw = null;
+    for (const line of lines) {
+      const lastSpace = line.lastIndexOf(" ");
+      const client = line.slice(0, lastSpace);
+      const clientWidth = parseInt(line.slice(lastSpace + 1), 10);
+      if (!clientWidth) continue;
+      const x = Math.max(0, clientWidth - POPUP_WIDTH - 1);
+      const args2 = [
+        `-c ${shellQuote(client)}`,
+        "-E -b double",
+        `-T ${shellQuote(popupTitle)}`,
+        `-S "fg=${ACCENT_COLOR}"`,
+        `-s "fg=${ACCENT_COLOR}"`,
+        `-x ${x} -y 2`,
+        `-w ${POPUP_WIDTH} -h ${height}`,
+        shellQuote(scriptPath2)
+      ].join(" ");
+      execSafe(`tmux display-popup ${args2}`);
+      try {
+        raw = readFileSync12(resultPath, "utf8").trim();
+      } catch {
+        raw = null;
+      }
+      if (raw) break;
+    }
+    if (raw === "dashboard") return "dashboard";
+    if (raw === "agent") return "agent";
+    return "dismiss";
+  } catch {
+    return "dismiss";
+  } finally {
+    try {
+      unlinkSync4(resultPath);
+    } catch {
+    }
+    try {
+      unlinkSync4(scriptPath2);
+    } catch {
+    }
+  }
+}
+
+// src/cli/commands/ask.ts
 import { approveDeck, notifyDeck, launchReview, display } from "@crouton-kit/humanloop";
 var ULID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
 function validateAskId(askId) {
@@ -6862,7 +7211,7 @@ async function markAnswered(cwd, sessionId, askId) {
 function waitForOutput(cwd, sessionId, askId, initialPpid) {
   const outputPath = askOutputPath(cwd, sessionId, askId);
   if (existsSync12(outputPath)) {
-    return Promise.resolve(JSON.parse(readFileSync12(outputPath, "utf-8")));
+    return Promise.resolve(JSON.parse(readFileSync13(outputPath, "utf-8")));
   }
   return new Promise((res, _rej) => {
     let ppidWatcher;
@@ -6874,7 +7223,7 @@ function waitForOutput(cwd, sessionId, askId, initialPpid) {
     const onChange = () => {
       if (!existsSync12(outputPath)) return;
       try {
-        const out = JSON.parse(readFileSync12(outputPath, "utf-8"));
+        const out = JSON.parse(readFileSync13(outputPath, "utf-8"));
         cleanup();
         res(out);
       } catch (err) {
@@ -6901,22 +7250,86 @@ function waitForOutput(cwd, sessionId, askId, initialPpid) {
     process.once("SIGINT", onSigint);
   });
 }
+function focusAgentPane(callerPane) {
+  const sess = execSafe(`tmux display-message -p -t ${shellQuote(callerPane)} "#{session_name}"`)?.trim();
+  const win = execSafe(`tmux display-message -p -t ${shellQuote(callerPane)} "#{window_id}"`)?.trim();
+  if (sess) switchAllClientsToSession(sess);
+  if (win) execSafe(`tmux select-window -t ${shellQuote(win)}`);
+}
+function switchAllClientsToSession(session2) {
+  const clients = execSafe('tmux list-clients -F "#{client_name}"');
+  if (!clients) return;
+  for (const c of clients.split("\n").filter(Boolean)) {
+    execSafe(`tmux switch-client -c ${shellQuote(c)} -t ${shellQuote(session2)}`);
+  }
+}
 function maybeSpawnAskPane(cwd, sessionId, askId, kind) {
   if (kind === "review") return;
   const callerPane = process.env.TMUX_PANE;
   if (!callerPane) return;
   if (process.env.SISYPHUS_DISABLE_ASK_PANE === "1") return;
-  const tuiPath = join13(import.meta.dirname, "tui.js");
+  const tuiPath = join14(import.meta.dirname, "tui.js");
   const cmd = `node ${shellQuote(tuiPath)} --cwd ${shellQuote(cwd)} --session-id ${shellQuote(sessionId)} --ask ${shellQuote(askId)}`;
-  execSafe(`tmux split-window -d -h -t ${shellQuote(callerPane)} -c ${shellQuote(cwd)} ${shellQuote(cmd)}`);
+  execSafe(`tmux split-window -h -t ${shellQuote(callerPane)} -c ${shellQuote(cwd)} ${shellQuote(cmd)}`);
+  focusAgentPane(callerPane);
 }
 function maybeSpawnReviewPane(cwd, sessionId, askId) {
   const callerPane = process.env.TMUX_PANE;
   if (!callerPane) return;
   if (process.env.SISYPHUS_DISABLE_ASK_PANE === "1") return;
-  const cliPath = join13(import.meta.dirname, "cli.js");
+  const cliPath = join14(import.meta.dirname, "cli.js");
   const cmd = `node ${shellQuote(cliPath)} ask review open ${shellQuote(askId)} --session ${shellQuote(sessionId)}`;
   execSafe(`tmux split-window -h -t ${shellQuote(callerPane)} -c ${shellQuote(cwd)} ${shellQuote(cmd)}`);
+  focusAgentPane(callerPane);
+}
+function sessionLabel(cwd, sessionId) {
+  try {
+    if (existsSync12(statePath(cwd, sessionId))) {
+      const s = getSession(cwd, sessionId);
+      if (s.name) return s.name;
+    }
+  } catch {
+  }
+  return sessionId.slice(0, 8);
+}
+function shouldSuppressBanner() {
+  const popupWillShow = !!process.env.TMUX_PANE && process.env.SISYPHUS_DISABLE_ASK_PANE !== "1" && hasAttachedClient();
+  return popupWillShow && isTerminalFrontmost();
+}
+async function triageAsk(cwd, sessionId, askId, kind, title) {
+  const callerPane = process.env.TMUX_PANE;
+  if (!callerPane) return;
+  if (process.env.SISYPHUS_DISABLE_ASK_PANE === "1") return;
+  const choice = showAskTriagePopup({
+    askId,
+    sessionLabel: sessionLabel(cwd, sessionId),
+    title: title !== void 0 ? title : "Question pending"
+  });
+  if (choice === "dismiss") return;
+  if (choice === "agent") {
+    if (kind === "review") maybeSpawnReviewPane(cwd, sessionId, askId);
+    else maybeSpawnAskPane(cwd, sessionId, askId, kind);
+    return;
+  }
+  await openInDashboard(cwd, sessionId, askId, kind);
+}
+async function openInDashboard(cwd, sessionId, askId, kind) {
+  try {
+    assertTmux();
+    const tmuxSession = findHomeSession(cwd) ?? getTmuxSession();
+    if (kind === "review") {
+      openDashboardWindow(tmuxSession, cwd);
+      switchAllClientsToSession(tmuxSession);
+      const cliPath = join14(import.meta.dirname, "cli.js");
+      const cmd = `node ${shellQuote(cliPath)} ask review open ${shellQuote(askId)} --session ${shellQuote(sessionId)}`;
+      execSafe(`tmux display-popup -E -w 90% -h 90% -d ${shellQuote(cwd)} ${shellQuote(cmd)}`);
+      return;
+    }
+    await rawSend({ type: "focus-set", cwd, sessionId, askId });
+    openDashboardWindow(tmuxSession, cwd);
+    switchAllClientsToSession(tmuxSession);
+  } catch {
+  }
 }
 async function submitDeck(deck, opts, options) {
   const blocking = options?.blocking !== false;
@@ -6926,6 +7339,8 @@ async function submitDeck(deck, opts, options) {
   const claudeSessionId = resolveClaudeSessionId(cwd, sessionId, askedBy);
   const askId = mintAskId();
   const q0 = deck.interactions[0];
+  const askTitle = deck.title !== void 0 ? deck.title : q0?.title;
+  const suppressTerminalNotification = blocking ? shouldSuppressBanner() : false;
   createAsk(cwd, sessionId, {
     askId,
     askedBy,
@@ -6933,15 +7348,16 @@ async function submitDeck(deck, opts, options) {
     pid: process.pid,
     claudeSessionId,
     cwd,
-    title: deck.title !== void 0 ? deck.title : q0?.title,
+    title: askTitle,
     subtitle: q0?.subtitle,
-    kind: options?.kindOverride !== void 0 ? options.kindOverride : q0?.kind
+    kind: options?.kindOverride !== void 0 ? options.kindOverride : q0?.kind,
+    suppressTerminalNotification
   });
   writeDecisions(cwd, sessionId, askId, deck);
   if (!blocking) {
     return { askId };
   }
-  maybeSpawnAskPane(cwd, sessionId, askId, q0?.kind);
+  await triageAsk(cwd, sessionId, askId, q0?.kind, askTitle);
   const output = await waitForOutput(cwd, sessionId, askId, initialPpid);
   await markAnswered(cwd, sessionId, askId);
   return { askId, output };
@@ -6994,6 +7410,8 @@ async function submitReview(absFile, opts, options) {
   const initialPpid = process.ppid;
   const claudeSessionId = resolveClaudeSessionId(cwd, sessionId, askedBy);
   const askId = mintAskId();
+  const reviewTitle = `Review ${basename4(absFile)}`;
+  const suppressTerminalNotification = blocking ? shouldSuppressBanner() : false;
   createAsk(cwd, sessionId, {
     askId,
     askedBy,
@@ -7001,12 +7419,13 @@ async function submitReview(absFile, opts, options) {
     pid: process.pid,
     claudeSessionId,
     cwd,
-    title: `Review ${basename4(absFile)}`,
-    kind: "review"
+    title: reviewTitle,
+    kind: "review",
+    suppressTerminalNotification
   });
   writeReview(cwd, sessionId, askId, { file: absFile });
   if (!blocking) return { askId };
-  maybeSpawnReviewPane(cwd, sessionId, askId);
+  await triageAsk(cwd, sessionId, askId, "review", reviewTitle);
   const output = await waitForOutput(cwd, sessionId, askId, initialPpid);
   await markAnswered(cwd, sessionId, askId);
   return { askId, output };
@@ -7038,7 +7457,7 @@ async function reviewOpen(askId, opts) {
   if (!reviewData) exitUsage("missing-review-pointer", `review.json missing for ${askId}`, { received: askId });
   const draftPath = askReviewDraftPath(cwd, sessionId, askId);
   const flagPath = askReviewSubmitFlagPath(cwd, sessionId, askId);
-  if (existsSync12(flagPath)) unlinkSync3(flagPath);
+  if (existsSync12(flagPath)) unlinkSync5(flagPath);
   const result = await launchReview(reviewData.file, {
     output: draftPath,
     submitFlagPath: flagPath,
@@ -7064,7 +7483,7 @@ async function reviewSubmit(askId, opts) {
   let comments = [];
   if (existsSync12(draftPath)) {
     try {
-      const draft = JSON.parse(readFileSync12(draftPath, "utf-8"));
+      const draft = JSON.parse(readFileSync13(draftPath, "utf-8"));
       if (Array.isArray(draft.comments)) comments = draft.comments;
     } catch {
     }
@@ -7181,7 +7600,7 @@ async function peek(askId, opts) {
   if (meta.completedAt) result.completedAt = meta.completedAt;
   try {
     if (existsSync12(outputPath)) {
-      result.output = JSON.parse(readFileSync12(outputPath, "utf-8"));
+      result.output = JSON.parse(readFileSync13(outputPath, "utf-8"));
     }
   } catch (err) {
     if (!(err instanceof SyntaxError)) throw err;
@@ -7593,13 +8012,13 @@ Exit codes: 0 ok | 2 usage (bad state) | 3 not_found.`
 
 // src/tui/lib/context.ts
 init_paths();
-import { readFileSync as readFileSync14, readdirSync as readdirSync4 } from "fs";
+import { readFileSync as readFileSync15, readdirSync as readdirSync4 } from "fs";
 
 // src/tui/lib/reports.ts
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
 function loadReportContent(report) {
   try {
-    return readFileSync13(report.filePath, "utf-8");
+    return readFileSync14(report.filePath, "utf-8");
   } catch {
     return report.summary;
   }
@@ -7616,7 +8035,7 @@ function resolveReports(reports) {
 // src/tui/lib/context.ts
 function readFileSafe(filePath) {
   try {
-    return readFileSync14(filePath, "utf-8");
+    return readFileSync15(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -7795,7 +8214,7 @@ Exit codes: 0 ok | 3 not_found (unknown session).`
 
 // src/cli/commands/spawn.ts
 import { existsSync as existsSync13 } from "fs";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 function registerSpawn(program2) {
   program2.command("spawn").description("Spawn a new agent (orchestrator only)").option("--agent-type <type>", "Agent type (e.g. sisyphus:debug, devcore:programmer)").option("--name <name>", "Agent name").option("--stdin", "Force-read instruction from stdin (avoids shell escaping for long prompts)").option("--repo <name>", "Repo subdirectory to use for this agent").option("--session <sessionId>", "Session ID (defaults to SISYPHUS_SESSION_ID env var)").addHelpText(
     "after",
@@ -7872,7 +8291,7 @@ Exit codes: 0 ok | 2 usage | 3 not_found (unknown session) | 5 conflict.`
       });
     }
     if (opts.repo && opts.repo !== ".") {
-      const repoPath = join14(sisyphusCwd, opts.repo);
+      const repoPath = join15(sisyphusCwd, opts.repo);
       if (!existsSync13(repoPath)) {
         exitError({
           code: "repo_not_found",
@@ -8058,7 +8477,7 @@ Exit codes: 0 ok | 2 usage | 3 not_found | 60 transient.`
 }
 
 // src/cli/commands/await.ts
-import { existsSync as existsSync16, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync18 } from "fs";
 var AWAIT_TIMEOUT_MS = 24 * 60 * 60 * 1e3;
 function registerAwait(program2) {
   program2.command("await").description("Block until an agent reaches a terminal status, then print its final report inline. Marks the agent as consumed-inline so its report is suppressed from the next cycle.").argument("<agentId>", "Agent ID to await").option("--session <sessionId>", "Session ID (defaults to SISYPHUS_SESSION_ID env var)").addHelpText(
@@ -8098,7 +8517,7 @@ Exit codes: 0 ok | 2 usage (missing --session) | 3 not_found (unknown agent) | 6
     let report = "";
     if (reportPath && existsSync16(reportPath)) {
       try {
-        report = readFileSync17(reportPath, "utf-8");
+        report = readFileSync18(reportPath, "utf-8");
       } catch (err) {
         process.stderr.write(`Warning: could not read report at ${reportPath}: ${err instanceof Error ? err.message : err}
 `);
@@ -8303,15 +8722,15 @@ import { execSync as execSync10 } from "child_process";
 
 // src/cli/onboard.ts
 import { execSync as execSync9 } from "child_process";
-import { existsSync as existsSync17, readFileSync as readFileSync18, writeFileSync as writeFileSync9 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync19, writeFileSync as writeFileSync10 } from "fs";
 import { homedir as homedir9 } from "os";
-import { dirname as dirname5, join as join17 } from "path";
+import { dirname as dirname5, join as join18 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 init_platform();
 
 // src/shared/clipboard.ts
 init_platform();
-import { execFileSync as execFileSync2, spawnSync } from "child_process";
+import { execFileSync as execFileSync3, spawnSync } from "child_process";
 function detectClipboard() {
   const platform = detectPlatform();
   if (platform === "darwin") {
@@ -8402,7 +8821,7 @@ function checkItermOptionKey() {
   if (process.platform !== "darwin") {
     return { checked: false, allCorrect: true, incorrectProfiles: [] };
   }
-  const plistPath2 = join17(homedir9(), "Library", "Preferences", "com.googlecode.iterm2.plist");
+  const plistPath2 = join18(homedir9(), "Library", "Preferences", "com.googlecode.iterm2.plist");
   if (!existsSync17(plistPath2)) {
     return { checked: false, allCorrect: false, incorrectProfiles: [] };
   }
@@ -8427,7 +8846,7 @@ function checkItermOptionKey() {
   }
 }
 function hasExistingTmuxConf() {
-  return existsSync17(join17(homedir9(), ".tmux.conf")) || existsSync17(join17(homedir9(), ".config", "tmux", "tmux.conf"));
+  return existsSync17(join18(homedir9(), ".tmux.conf")) || existsSync17(join18(homedir9(), ".config", "tmux", "tmux.conf"));
 }
 var SISYPHUS_DEFAULTS_MARKER = "# sisyphus-managed \u2014 do not edit";
 function buildTmuxDefaults() {
@@ -8539,8 +8958,8 @@ source-file -q ${sisyphusConf} ${SISYPHUS_DEFAULTS_MARKER}
 `;
 }
 function writeTmuxDefaults() {
-  const confPath = join17(homedir9(), ".tmux.conf");
-  writeFileSync9(confPath, buildTmuxDefaults(), "utf8");
+  const confPath = join18(homedir9(), ".tmux.conf");
+  writeFileSync10(confPath, buildTmuxDefaults(), "utf8");
 }
 function isNvimAvailable() {
   try {
@@ -8558,21 +8977,21 @@ function getNvimVersion() {
   }
 }
 function hasLazyVimConfig() {
-  return existsSync17(join17(homedir9(), ".config", "nvim", "lazy-lock.json"));
+  return existsSync17(join18(homedir9(), ".config", "nvim", "lazy-lock.json"));
 }
 function bundledBaleiaPluginPath() {
   const distDir = dirname5(fileURLToPath2(import.meta.url));
-  return join17(distDir, "templates", "baleia.lua");
+  return join18(distDir, "templates", "baleia.lua");
 }
 function installBaleiaPlugin() {
-  const pluginsDir = join17(homedir9(), ".config", "nvim", "lua", "plugins");
+  const pluginsDir = join18(homedir9(), ".config", "nvim", "lua", "plugins");
   if (!existsSync17(pluginsDir)) return false;
-  const dest = join17(pluginsDir, "sisyphus-baleia.lua");
+  const dest = join18(pluginsDir, "sisyphus-baleia.lua");
   if (existsSync17(dest)) return true;
   const src = bundledBaleiaPluginPath();
   if (!existsSync17(src)) return false;
   try {
-    writeFileSync9(dest, readFileSync18(src, "utf-8"), "utf8");
+    writeFileSync10(dest, readFileSync19(src, "utf-8"), "utf8");
     return true;
   } catch {
     return false;
@@ -8595,7 +9014,7 @@ function tryAutoInstallNvim() {
   if (!isNvimAvailable()) {
     return { installed: false, autoInstalled: false, version: "", lazyVimInstalled: false, baleiaInstalled: false };
   }
-  const nvimConfigDir = join17(homedir9(), ".config", "nvim");
+  const nvimConfigDir = join18(homedir9(), ".config", "nvim");
   let lazyVimInstalled = false;
   if (!existsSync17(nvimConfigDir)) {
     const cloneCmd = [
@@ -8613,7 +9032,7 @@ function tryAutoInstallNvim() {
         stdio: "inherit",
         env: { ...process.env, GIT_LFS_SKIP_SMUDGE: "1" }
       });
-      const gitDir = join17(nvimConfigDir, ".git");
+      const gitDir = join18(nvimConfigDir, ".git");
       if (existsSync17(gitDir)) {
         execSync9(`rm -rf "${gitDir}"`, { stdio: "pipe" });
       }
@@ -8900,7 +9319,7 @@ Exit codes: 0 ok | 1 conflict or requires-force`
 
 // src/cli/commands/check-keybinds.ts
 import { execSync as execSync11 } from "child_process";
-import { readFileSync as readFileSync19 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 function isTmuxInstalled2() {
   try {
     execSync11("which tmux", { stdio: "pipe" });
@@ -8953,7 +9372,7 @@ function runCheck() {
   let userConfAlreadySources = false;
   if (userConfPath !== null) {
     try {
-      userConfAlreadySources = readFileSync19(userConfPath, "utf-8").includes(sisyphusConfPath);
+      userConfAlreadySources = readFileSync20(userConfPath, "utf-8").includes(sisyphusConfPath);
     } catch {
     }
   }
@@ -9124,9 +9543,9 @@ Exit codes: 0 ok`
 // src/cli/commands/check-statusbar.ts
 init_paths();
 import { execSync as execSync12 } from "child_process";
-import { existsSync as existsSync18, readFileSync as readFileSync20 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync21 } from "fs";
 import { homedir as homedir10 } from "os";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 var SISYPHUS_LEFT_TOKEN = "@sisyphus_left";
 var SISYPHUS_RIGHT_TOKEN = "@sisyphus_right";
 var TMUX_DEFAULT_STATUS_LEFT = "[#S] ";
@@ -9151,7 +9570,7 @@ function isDaemonRunning() {
   const pidFile = daemonPidPath();
   if (!existsSync18(pidFile)) return false;
   try {
-    const pid = parseInt(readFileSync20(pidFile, "utf-8").trim(), 10);
+    const pid = parseInt(readFileSync21(pidFile, "utf-8").trim(), 10);
     if (Number.isNaN(pid) || pid <= 0) return false;
     process.kill(pid, 0);
     return true;
@@ -9194,8 +9613,8 @@ function probeTmuxOptions(serverRunning) {
   };
 }
 function findUserTmuxConf() {
-  const xdg = join18(homedir10(), ".config", "tmux", "tmux.conf");
-  const dotfile = join18(homedir10(), ".tmux.conf");
+  const xdg = join19(homedir10(), ".config", "tmux", "tmux.conf");
+  const dotfile = join19(homedir10(), ".tmux.conf");
   if (existsSync18(xdg)) return xdg;
   if (existsSync18(dotfile)) return dotfile;
   return null;
@@ -9207,21 +9626,21 @@ function probeUserConf() {
   }
   let contents = "";
   try {
-    contents = readFileSync20(path, "utf-8");
+    contents = readFileSync21(path, "utf-8");
   } catch {
     return { path, setsStatusLeft: false, setsStatusRight: false, sourcesSisyphusManaged: false };
   }
   const lines = contents.split("\n").filter((line) => !line.trim().startsWith("#"));
   const setsStatusLeft = lines.some((line) => /^\s*(set|set-option)\s+-g(?:\s+-\w+)*\s+status-left\b/.test(line));
   const setsStatusRight = lines.some((line) => /^\s*(set|set-option)\s+-g(?:\s+-\w+)*\s+status-right\b/.test(line));
-  const sourcesSisyphusManaged = contents.includes(join18(homedir10(), ".sisyphus", "tmux.conf"));
+  const sourcesSisyphusManaged = contents.includes(join19(homedir10(), ".sisyphus", "tmux.conf"));
   return { path, setsStatusLeft, setsStatusRight, sourcesSisyphusManaged };
 }
 function loadGlobalSisyphusConfig() {
   const path = globalConfigPath();
   if (!existsSync18(path)) return null;
   try {
-    const parsed = JSON.parse(readFileSync20(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync21(path, "utf-8"));
     return parsed.statusBar === void 0 ? null : parsed.statusBar;
   } catch {
     return null;
@@ -9561,7 +9980,7 @@ init_paths();
 import { execSync as execSync14 } from "child_process";
 import { existsSync as existsSync19, statSync as statSync4 } from "fs";
 import { homedir as homedir11 } from "os";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 init_platform();
 init_plugins();
 function checkNodeVersion() {
@@ -9795,7 +10214,7 @@ function checkNvim() {
 }
 function checkNotifyBinary() {
   if (process.platform === "darwin") {
-    const binary = join19(homedir11(), ".sisyphus", "SisyphusNotify.app", "Contents", "MacOS", "sisyphus-notify");
+    const binary = join20(homedir11(), ".sisyphus", "SisyphusNotify.app", "Contents", "MacOS", "sisyphus-notify");
     if (existsSync19(binary)) {
       return { name: "Notifications", status: "ok", detail: "SisyphusNotify.app built" };
     }
@@ -9909,13 +10328,13 @@ init_version();
 init_platform();
 init_paths();
 init_state();
-import { execFileSync as execFileSync3, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync20, readFileSync as readFileSync22 } from "fs";
+import { execFileSync as execFileSync4, spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync20, readFileSync as readFileSync23 } from "fs";
 import os from "os";
 var REPO = "crouton-labs/sisyphus";
 function tryCmd(bin, args2) {
   try {
-    const out = execFileSync3(bin, args2, {
+    const out = execFileSync4(bin, args2, {
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 5e3
@@ -9971,7 +10390,7 @@ function tailLog(lines) {
   const path = daemonLogPath();
   if (!existsSync20(path)) return null;
   try {
-    const all = readFileSync22(path, "utf-8").split("\n");
+    const all = readFileSync23(path, "utf-8").split("\n");
     return all.slice(-lines).join("\n").trim() || null;
   } catch {
     return null;
@@ -10260,8 +10679,8 @@ Exit codes: 0 ok | 1 filing error | 2 usage | 60 cloud unreachable (retry-safe)`
 }
 
 // src/cli/commands/init.ts
-import { existsSync as existsSync21, mkdirSync as mkdirSync9, writeFileSync as writeFileSync10 } from "fs";
-import { join as join20 } from "path";
+import { existsSync as existsSync21, mkdirSync as mkdirSync9, writeFileSync as writeFileSync11 } from "fs";
+import { join as join21 } from "path";
 var DEFAULT_CONFIG2 = {};
 var ORCHESTRATOR_TEMPLATE = `# Custom Orchestrator Prompt
 
@@ -10290,19 +10709,19 @@ Effects
 Exit codes: 0 ok`
   ).action((opts) => {
     const cwd = process.cwd();
-    const sisDir = join20(cwd, ".sisyphus");
-    const configPath = join20(sisDir, "config.json");
+    const sisDir = join21(cwd, ".sisyphus");
+    const configPath = join21(sisDir, "config.json");
     if (existsSync21(configPath)) {
       console.log(`Already initialized: ${configPath}`);
       return;
     }
     mkdirSync9(sisDir, { recursive: true });
-    writeFileSync10(configPath, JSON.stringify(DEFAULT_CONFIG2, null, 2) + "\n", "utf-8");
+    writeFileSync11(configPath, JSON.stringify(DEFAULT_CONFIG2, null, 2) + "\n", "utf-8");
     console.log(`Created ${configPath}`);
     if (opts.orchestrator) {
-      const orchPath = join20(sisDir, "orchestrator.md");
+      const orchPath = join21(sisDir, "orchestrator.md");
       if (!existsSync21(orchPath)) {
-        writeFileSync10(orchPath, ORCHESTRATOR_TEMPLATE, "utf-8");
+        writeFileSync11(orchPath, ORCHESTRATOR_TEMPLATE, "utf-8");
         console.log(`Created ${orchPath}`);
       }
     }
@@ -10362,7 +10781,7 @@ Exit codes: 0 ok`
 
 // src/cli/commands/configure-upload.ts
 init_paths();
-import { chmodSync as chmodSync2, existsSync as existsSync22, mkdirSync as mkdirSync10, readFileSync as readFileSync23, writeFileSync as writeFileSync11 } from "fs";
+import { chmodSync as chmodSync2, existsSync as existsSync22, mkdirSync as mkdirSync10, readFileSync as readFileSync24, writeFileSync as writeFileSync12 } from "fs";
 import { createInterface as createInterface3 } from "readline";
 import { dirname as dirname6 } from "path";
 async function readUrlFromInput(interactive) {
@@ -10443,7 +10862,7 @@ Exit codes: 0 ok | 1 validation or write error`
     let existing = {};
     if (existsSync22(configPath)) {
       try {
-        existing = JSON.parse(readFileSync23(configPath, "utf-8"));
+        existing = JSON.parse(readFileSync24(configPath, "utf-8"));
       } catch {
         console.error(`Error: ${configPath} could not be parsed \u2014 fix or delete it first`);
         process.exit(1);
@@ -10451,7 +10870,7 @@ Exit codes: 0 ok | 1 validation or write error`
     }
     const merged = { ...existing, upload: { url, token } };
     mkdirSync10(dirname6(configPath), { recursive: true });
-    writeFileSync11(configPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+    writeFileSync12(configPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
     chmodSync2(configPath, 384);
     console.log(`\u2713 upload configured (${configPath})`);
   });
@@ -10460,10 +10879,10 @@ Exit codes: 0 ok | 1 validation or write error`
 // src/cli/commands/getting-started.ts
 import { execSync as execSync15 } from "child_process";
 import { existsSync as existsSync23 } from "fs";
-import { dirname as dirname7, join as join21 } from "path";
+import { dirname as dirname7, join as join22 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 function templatePath(name) {
-  return join21(dirname7(fileURLToPath3(import.meta.url)), "templates", name);
+  return join22(dirname7(fileURLToPath3(import.meta.url)), "templates", name);
 }
 function isClaudeCode() {
   return !!process.env["CLAUDECODE"];
@@ -10830,7 +11249,7 @@ sis ui guide --tutorial 4
 `);
 }
 function printStep4() {
-  const demoPath = join21(process.cwd(), "tmp", "sisyphus-tutorial-demo");
+  const demoPath = join22(process.cwd(), "tmp", "sisyphus-tutorial-demo");
   console.log(`
 <claude-instructions>
 # Sisyphus Getting Started \u2014 Step 4: Demo Session
@@ -10874,7 +11293,7 @@ Have the user confirm they understand these keybinds before proceeding.
 
 First, copy the demo todo app into ./tmp/ under the user's current directory and init a git repo (sisyphus needs git). Run from the user's current shell \u2014 don't \`cd\` away first:
 \`\`\`
-mkdir -p ${join21(process.cwd(), "tmp")}
+mkdir -p ${join22(process.cwd(), "tmp")}
 rm -rf ${demoPath}
 cp -r ${templatePath("tutorial-demo")} ${demoPath}
 git -C ${demoPath} init
@@ -10952,7 +11371,7 @@ sis ui guide --tutorial 5
 `);
 }
 function printStep5() {
-  const demoPath = join21(process.cwd(), "tmp", "sisyphus-tutorial-demo");
+  const demoPath = join22(process.cwd(), "tmp", "sisyphus-tutorial-demo");
   const demoExists = existsSync23(demoPath);
   let recentCommits = "";
   let topLevelFiles = "";
@@ -11057,9 +11476,9 @@ If they say yes, run:
 rm -rf ${demoPath}
 \`\`\`
 
-Then check whether \`${join21(process.cwd(), "tmp")}\` is now empty, and if so remove it too:
+Then check whether \`${join22(process.cwd(), "tmp")}\` is now empty, and if so remove it too:
 \`\`\`
-rmdir ${join21(process.cwd(), "tmp")} 2>/dev/null || true
+rmdir ${join22(process.cwd(), "tmp")} 2>/dev/null || true
 \`\`\`
 
 If they say no or want to explore first, leave it. They can clean up later with the same
@@ -11492,7 +11911,7 @@ Exit codes: 0 ok | 2 usage (invalid --tutorial value)`
 
 // src/cli/commands/history.ts
 init_paths();
-import { readdirSync as readdirSync7, readFileSync as readFileSync24, existsSync as existsSync24 } from "fs";
+import { readdirSync as readdirSync7, readFileSync as readFileSync25, existsSync as existsSync24 } from "fs";
 import { resolve as resolve8 } from "path";
 function loadAllSummaries() {
   const base = historyBaseDir();
@@ -11502,7 +11921,7 @@ function loadAllSummaries() {
     const summaryPath = historySessionSummaryPath(name);
     if (existsSync24(summaryPath)) {
       try {
-        const raw = readFileSync24(summaryPath, "utf-8");
+        const raw = readFileSync25(summaryPath, "utf-8");
         results.push({ id: name, summary: JSON.parse(raw) });
         continue;
       } catch {
@@ -11519,7 +11938,7 @@ function buildLiveSummary(sessionId) {
   if (!existsSync24(eventsPath)) return null;
   let cwd = null;
   try {
-    const lines = readFileSync24(eventsPath, "utf-8").split("\n");
+    const lines = readFileSync25(eventsPath, "utf-8").split("\n");
     for (const line of lines) {
       if (!line.trim()) continue;
       try {
@@ -11540,7 +11959,7 @@ function buildLiveSummary(sessionId) {
   if (!existsSync24(sPath)) return null;
   let session2;
   try {
-    session2 = JSON.parse(readFileSync24(sPath, "utf-8"));
+    session2 = JSON.parse(readFileSync25(sPath, "utf-8"));
   } catch {
     return null;
   }
@@ -11602,7 +12021,7 @@ function buildLiveSummary(sessionId) {
 function loadEvents(sessionId) {
   const eventsPath = historyEventsPath(sessionId);
   if (!existsSync24(eventsPath)) return [];
-  const lines = readFileSync24(eventsPath, "utf-8").split("\n").filter((l) => l.trim());
+  const lines = readFileSync25(eventsPath, "utf-8").split("\n").filter((l) => l.trim());
   const events = [];
   for (const line of lines) {
     try {
@@ -11617,7 +12036,7 @@ function findSession(idOrName) {
   const summaryPath = historySessionSummaryPath(idOrName);
   if (existsSync24(summaryPath)) {
     try {
-      return { id: idOrName, summary: JSON.parse(readFileSync24(summaryPath, "utf-8")) };
+      return { id: idOrName, summary: JSON.parse(readFileSync25(summaryPath, "utf-8")) };
     } catch {
     }
   }
@@ -11865,7 +12284,7 @@ Exit codes: 0 ok | 2 usage | 1 export_failed.`).action(async (sessionIdArg, opts
 
 // src/cli/commands/upload.ts
 import { rmSync as rmSync6 } from "fs";
-import { tmpdir } from "os";
+import { tmpdir as tmpdir2 } from "os";
 init_config();
 init_session_export();
 init_upload();
@@ -11921,7 +12340,7 @@ Exit codes: 0 ok | 1 upload or export error | 2 usage`
     }
     let zipPath;
     try {
-      zipPath = await exportSessionToZip(sessionId, cwd, { reveal: false, outputDir: tmpdir() });
+      zipPath = await exportSessionToZip(sessionId, cwd, { reveal: false, outputDir: tmpdir2() });
     } catch (err) {
       exitError({
         code: "export_failed",
@@ -11986,7 +12405,7 @@ Exit codes: 0 ok | 1 upload or export error | 2 usage`
 // src/cli/commands/scratch.ts
 import { execSync as execSync16 } from "child_process";
 init_shell();
-function findHomeSession(cwd) {
+function findHomeSession2(cwd) {
   const normalizedCwd = cwd.replace(/\/+$/, "");
   let output;
   try {
@@ -12034,7 +12453,7 @@ Effects
 Exit codes: 0 ok | 2 usage.`).action((promptParts, opts) => {
     assertTmux();
     const cwd = opts.cwd ?? process.env["SISYPHUS_CWD"] ?? process.cwd();
-    const homeSession = findHomeSession(cwd);
+    const homeSession = findHomeSession2(cwd);
     if (!homeSession) {
       const current = execSync16('tmux display-message -p "#{session_name}"', {
         encoding: "utf-8"
@@ -12062,15 +12481,15 @@ function openScratchWindow(tmuxSession, cwd, prompt) {
 
 // src/cli/commands/review.ts
 init_paths();
-import { join as join23, resolve as resolve9, dirname as dirname8 } from "path";
-import { existsSync as existsSync26, readFileSync as readFileSync26, writeFileSync as writeFileSync13, renameSync as renameSync3, readdirSync as readdirSync8 } from "fs";
+import { join as join24, resolve as resolve9, dirname as dirname8 } from "path";
+import { existsSync as existsSync26, readFileSync as readFileSync27, writeFileSync as writeFileSync14, renameSync as renameSync3, readdirSync as readdirSync8 } from "fs";
 var _statusCheck = ["draft", "question", "approved", "rejected", "deferred"];
 function resolveContextArtifact(file, opts, filename, notFoundMessage) {
   const cwd = opts.cwd || process.env.SISYPHUS_CWD || process.cwd();
   if (file) return resolve9(file);
   const sessionId = opts.sessionId || process.env.SISYPHUS_SESSION_ID;
   if (sessionId) {
-    const target = join23(contextDir(cwd, sessionId), filename);
+    const target = join24(contextDir(cwd, sessionId), filename);
     if (!existsSync26(target)) {
       exitUsage("file-not-found", `File not found: ${target}`, { received: target });
     }
@@ -12080,7 +12499,7 @@ function resolveContextArtifact(file, opts, filename, notFoundMessage) {
   if (existsSync26(dir)) {
     const sessions = readdirSync8(dir);
     for (const session2 of sessions.reverse()) {
-      const candidate = join23(dir, session2, "context", filename);
+      const candidate = join24(dir, session2, "context", filename);
       if (existsSync26(candidate)) return candidate;
     }
   }
@@ -12139,12 +12558,12 @@ Exit codes: 0 ok | 2 usage.`).action(async (file, opts) => {
       if (!existsSync26(targetPath)) {
         exitUsage("file-not-found", `File not found: ${targetPath}`, { received: targetPath });
       }
-      const parsed = JSON.parse(readFileSync26(targetPath, "utf-8"));
+      const parsed = JSON.parse(readFileSync27(targetPath, "utf-8"));
       const rendered = renderRequirementsMarkdown(parsed);
-      const outPath = join23(dirname8(targetPath), "requirements.md");
+      const outPath = join24(dirname8(targetPath), "requirements.md");
       const tmpPath = outPath + ".tmp";
       if (existsSync26(outPath)) {
-        const existing = readFileSync26(outPath, "utf-8");
+        const existing = readFileSync27(outPath, "utf-8");
         if (existing !== rendered) {
           if (!opts.force) {
             exitUsage("conflict", `${outPath} has been hand-edited (differs from rendered output)`, {
@@ -12157,7 +12576,7 @@ Exit codes: 0 ok | 2 usage.`).action(async (file, opts) => {
 `);
         }
       }
-      writeFileSync13(tmpPath, rendered, "utf-8");
+      writeFileSync14(tmpPath, rendered, "utf-8");
       renameSync3(tmpPath, outPath);
       emitJsonOk({ path: resolve9(outPath) });
       return;
@@ -12521,8 +12940,8 @@ function renderRequirementsMarkdown(json) {
 }
 
 // src/cli/commands/companion.ts
-import { basename as basename7, dirname as dirname11, join as join28 } from "path";
-import { mkdirSync as mkdirSync15, readFileSync as readFileSync31, writeFileSync as writeFileSync18 } from "fs";
+import { basename as basename7, dirname as dirname11, join as join29 } from "path";
+import { mkdirSync as mkdirSync15, readFileSync as readFileSync32, writeFileSync as writeFileSync19 } from "fs";
 init_paths();
 init_companion_types();
 init_companion_memory();
@@ -12625,10 +13044,10 @@ Effects
   Writes/updates ~/.sisyphus/companion-context-cache/<session-id>.json on each call that produces output.
 
 Exit codes: 0 ok.`).action((opts) => {
-    const cachePath = join28(globalDir(), "companion-context-cache", `${opts.sessionId}.json`);
+    const cachePath = join29(globalDir(), "companion-context-cache", `${opts.sessionId}.json`);
     let prev = {};
     try {
-      prev = JSON.parse(readFileSync31(cachePath, "utf-8"));
+      prev = JSON.parse(readFileSync32(cachePath, "utf-8"));
     } catch {
       prev = {};
     }
@@ -12642,7 +13061,7 @@ Exit codes: 0 ok.`).action((opts) => {
       process.stdout.write(renderFullContext(next));
     }
     mkdirSync15(dirname11(cachePath), { recursive: true });
-    writeFileSync18(cachePath, JSON.stringify(next), "utf-8");
+    writeFileSync19(cachePath, JSON.stringify(next), "utf-8");
   });
   companion.command("pane").description("Open (or focus) a side claude pane next to the dashboard").option("--cwd <path>", "Project directory (default: current directory)").addHelpText("after", `
 companion pane: open (or focus) the companion side pane next to the dashboard.
@@ -12746,7 +13165,7 @@ Exit codes: 0 ok | 3 not_found.`
       }));
       emitJsonOk({ ...companionData, badges });
     } else {
-      emitJsonOk(companionData);
+      emitJsonOk({ ...companionData });
     }
   });
 }
@@ -12756,7 +13175,7 @@ init_runner();
 init_creds();
 init_tailscale();
 import { homedir as homedir13 } from "os";
-import { join as join29 } from "path";
+import { join as join30 } from "path";
 function assertArch(raw) {
   if (raw === "arm" || raw === "x86") return raw;
   throw new Error(`Invalid --arch: ${raw}. Must be 'arm' or 'x86'.`);
@@ -12802,7 +13221,7 @@ Exit codes: 0 ok | 1 error (bad credentials or API failure).`).action(async () =
     const sub = deploy.command(provider).description(`${provider} commands.`).addHelpText("before", `
 deploy ${provider}: per-provider box lifecycle. up | down | status | ssh | logs | update.
 `);
-    sub.command("up").description(`Provision the ${provider} box (terraform init \u2192 plan \u2192 apply).`).option("--region <region>", `Provider region (defaults: hetzner=nbg1, aws=us-east-1).`).option("--arch <arch>", "'arm' (default) or 'x86'. Picks the default --size and image.", "arm").option("--size <size>", "Instance type override (defaults follow --arch).").option("--ssh-key <path>", "Path to SSH public key.", join29(homedir13(), ".ssh", "id_ed25519.pub")).option("--no-chromium", "Skip headless Chromium install.").option("--no-auto-update", "Skip the daily auto-update systemd timer.").option("--name <name>", "Box hostname / Tailscale node name.", "sisyphus").option("--yes", "Skip the re-provision confirmation prompt when state already exists.").addHelpText("after", `
+    sub.command("up").description(`Provision the ${provider} box (terraform init \u2192 plan \u2192 apply).`).option("--region <region>", `Provider region (defaults: hetzner=nbg1, aws=us-east-1).`).option("--arch <arch>", "'arm' (default) or 'x86'. Picks the default --size and image.", "arm").option("--size <size>", "Instance type override (defaults follow --arch).").option("--ssh-key <path>", "Path to SSH public key.", join30(homedir13(), ".ssh", "id_ed25519.pub")).option("--no-chromium", "Skip headless Chromium install.").option("--no-auto-update", "Skip the daily auto-update systemd timer.").option("--name <name>", "Box hostname / Tailscale node name.", "sisyphus").option("--yes", "Skip the re-provision confirmation prompt when state already exists.").addHelpText("after", `
 deploy ${provider} up: provision the ${provider} box via Terraform (init \u2192 plan \u2192 apply).
 
 Input
@@ -12949,14 +13368,14 @@ init_runner2();
 
 // src/cli/cloud/handoff.ts
 import { spawn as spawn5 } from "child_process";
-import { existsSync as existsSync36, readFileSync as readFileSync35, writeFileSync as writeFileSync19 } from "fs";
+import { existsSync as existsSync36, readFileSync as readFileSync36, writeFileSync as writeFileSync20 } from "fs";
 init_exec();
 init_paths();
 init_shell();
 init_runner();
 init_ssh_exec();
 init_provider_pick();
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 async function cloudHandoff(sessionId, opts) {
   const cwd = process.env["SISYPHUS_CWD"] ?? process.cwd();
   const request = {
@@ -13001,7 +13420,7 @@ async function waitForSentOrError(cwd, sessionId) {
     if (!existsSync36(path)) continue;
     let session2;
     try {
-      session2 = JSON.parse(readFileSync35(path, "utf-8"));
+      session2 = JSON.parse(readFileSync36(path, "utf-8"));
     } catch (err) {
       void err;
       continue;
@@ -13082,16 +13501,16 @@ async function cloudReclaim(sessionId, opts) {
   await rsyncDown(target, `${remoteRepoDir}/`, `${cwd}/`, { withDelete: false, excludeSisyphus: true, update: true });
   for (const name of ["config.json", "orchestrator.md", "orchestrator-settings.json"]) {
     const remotePath = `${remoteRepoDir}/.sisyphus/${name}`;
-    const localPath = join31(projectDir(cwd), name);
+    const localPath = join32(projectDir(cwd), name);
     const probe = runOnBox(provider, `test -f ${shellQuote(remotePath.replace(/^~\//, ""))} && echo y || echo n`);
     if (probe.stdout.trim() !== "y") continue;
     await rsyncDown(target, remotePath, localPath, { withDelete: false });
   }
   const localStatePath = statePath(cwd, sessionId);
-  const merged = JSON.parse(readFileSync35(localStatePath, "utf-8"));
+  const merged = JSON.parse(readFileSync36(localStatePath, "utf-8"));
   merged.cwd = cwd;
   merged.handoff = local.handoff;
-  writeFileSync19(localStatePath, JSON.stringify(merged, null, 2));
+  writeFileSync20(localStatePath, JSON.stringify(merged, null, 2));
   const reclaimMessage = `Session reclaimed from cloud (${provider}:${repo}). Resuming locally.`;
   console.log(`\u2192 local sis resume`);
   const resumeResp = await sendRequest({
@@ -13124,7 +13543,7 @@ function readLocalSession(cwd, sessionId) {
       received: sessionId
     });
   }
-  return JSON.parse(readFileSync35(path, "utf-8"));
+  return JSON.parse(readFileSync36(path, "utf-8"));
 }
 async function waitForBoxPaused(provider, remoteSessionDir) {
   const POLL_INTERVAL_MS = 2e3;
@@ -13408,7 +13827,7 @@ function attachNotify(diagnostic2) {
 // src/cli/commands/tmux-sessions.ts
 init_paths();
 import { execSync as execSync18 } from "child_process";
-import { readFileSync as readFileSync36, existsSync as existsSync37 } from "fs";
+import { readFileSync as readFileSync37, existsSync as existsSync37 } from "fs";
 var DOT_MAP = {
   "orchestrator:processing": { icon: "\u25CF", color: "#d4ad6a" },
   "orchestrator:idle": { icon: "\u25CF", color: "#d47766" },
@@ -13421,7 +13840,7 @@ function readManifest() {
   const p = sessionsManifestPath();
   if (!existsSync37(p)) return null;
   try {
-    return JSON.parse(readFileSync36(p, "utf-8"));
+    return JSON.parse(readFileSync37(p, "utf-8"));
   } catch {
     return null;
   }
@@ -13462,7 +13881,7 @@ init_server();
 init_ask_store();
 init_state();
 init_paths();
-import { existsSync as existsSync49 } from "fs";
+import { existsSync as existsSync48 } from "fs";
 var HEARTBEAT_ASKED_BY2 = "system:heartbeat";
 var ORPHAN_ASKED_BY2 = "system:orphan-handler";
 function isHeartbeatZombie(cwd, sessionId, askId) {
@@ -13470,14 +13889,14 @@ function isHeartbeatZombie(cwd, sessionId, askId) {
   if (!meta) return false;
   if (meta.askedBy !== HEARTBEAT_ASKED_BY2) return false;
   if (meta.status === "answered") return false;
-  if (existsSync49(askOutputPath(cwd, sessionId, askId))) return false;
+  if (existsSync48(askOutputPath(cwd, sessionId, askId))) return false;
   for (const candidateId of listAsks(cwd, sessionId)) {
     if (candidateId === askId) continue;
     const candidateMeta = readMeta(cwd, sessionId, candidateId);
     if (!candidateMeta) continue;
     if (candidateMeta.heartbeatAskId !== askId) continue;
     if (candidateMeta.status === "answered") return true;
-    if (existsSync49(askOutputPath(cwd, sessionId, candidateId))) return true;
+    if (existsSync48(askOutputPath(cwd, sessionId, candidateId))) return true;
   }
   return false;
 }
@@ -13486,7 +13905,7 @@ function isOrphanZombie(cwd, sessionId, askId) {
   if (!meta) return false;
   if (meta.askedBy !== ORPHAN_ASKED_BY2) return false;
   if (meta.status === "answered") return false;
-  if (existsSync49(askOutputPath(cwd, sessionId, askId))) return false;
+  if (existsSync48(askOutputPath(cwd, sessionId, askId))) return false;
   if (meta.orphanTarget?.kind !== "agent") return false;
   let session2;
   try {
@@ -13499,27 +13918,6 @@ function isOrphanZombie(cwd, sessionId, askId) {
   if (!agent2) return false;
   return agent2.status !== "running";
 }
-function isModeGateZombie(cwd, sessionId, askId) {
-  const meta = readMeta(cwd, sessionId, askId);
-  if (!meta) return false;
-  if (meta.modeTransition !== true) return false;
-  if (meta.status === "answered") return false;
-  if (existsSync49(askOutputPath(cwd, sessionId, askId))) return false;
-  const deck = readDecisions(cwd, sessionId, askId);
-  if (!deck) return false;
-  const source = deck.source;
-  const chain = source?.modeChain;
-  if (!chain || chain.length === 0) return false;
-  let currentMode;
-  try {
-    const session2 = getSession(cwd, sessionId);
-    currentMode = session2.orchestratorCycles[session2.orchestratorCycles.length - 1]?.mode;
-  } catch {
-    return false;
-  }
-  if (!currentMode) return false;
-  return !chain.some((e) => e.mode === currentMode);
-}
 async function resolveZombie(cwd, sessionId, entry) {
   const { askId, kind } = entry;
   const completedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -13537,11 +13935,6 @@ async function resolveZombie(cwd, sessionId, entry) {
       selectedOptionId = "dismiss";
       freetext = "auto-resolved: agent superseded by replacement (clean-zombies sweep)";
       break;
-    case "mode-gate":
-      interactionId = "mode-transition";
-      selectedOptionId = "ack";
-      freetext = "auto-resolved: session advanced past mode-transition (clean-zombies sweep)";
-      break;
   }
   writeOutput(cwd, sessionId, askId, [{
     id: interactionId,
@@ -13560,14 +13953,12 @@ async function sweepSession(cwd, sessionId) {
       const meta = readMeta(cwd, sessionId, askId);
       const agentId = meta?.orphanTarget?.kind === "agent" ? meta.orphanTarget.agentId : "unknown";
       zombies.push({ sessionId, askId, kind: "orphan", reason: `agent ${agentId} is no longer running` });
-    } else if (isModeGateZombie(cwd, sessionId, askId)) {
-      zombies.push({ sessionId, askId, kind: "mode-gate", reason: "session advanced past mode-transition" });
     }
   }
   return zombies;
 }
 function registerCleanZombies(program2) {
-  program2.command("clean-zombies").description("Sweep all sessions for zombie asks (heartbeats whose original is answered, orphans whose agent is superseded, stale mode-gate notifications) and dismiss them").addHelpText(
+  program2.command("clean-zombies").description("Sweep all sessions for zombie asks (heartbeats whose original is answered, orphans whose agent is superseded) and dismiss them").addHelpText(
     "after",
     `
 clean-zombies: sweep all sessions and dismiss stale ask records.
@@ -13580,8 +13971,8 @@ Output (stdout, plain text \u2014 human-readable maintenance summary; not for ag
 
 Effects
   Mutates ask records: writes response.json and updates status to "answered" for each
-  zombie found. Dismisses heartbeat asks whose original was answered, orphan asks whose
-  target agent is no longer running, and mode-gate asks the session has advanced past.
+  zombie found. Dismisses heartbeat asks whose original was answered and orphan asks whose
+  target agent is no longer running.
 
 Exit codes: 0 ok`
   ).action(async () => {
@@ -13594,7 +13985,7 @@ Exit codes: 0 ok`
     const allZombies = [];
     const sessionsSweept = /* @__PURE__ */ new Set();
     for (const [sessionId, cwd] of entries) {
-      if (!existsSync49(statePath(cwd, sessionId))) continue;
+      if (!existsSync48(statePath(cwd, sessionId))) continue;
       try {
         const zombies = await sweepSession(cwd, sessionId);
         if (zombies.length > 0) {
@@ -13610,8 +14001,7 @@ Exit codes: 0 ok`
     }
     const summary = {
       heartbeats: allZombies.filter((z4) => z4.kind === "heartbeat").length,
-      orphans: allZombies.filter((z4) => z4.kind === "orphan").length,
-      modeGates: allZombies.filter((z4) => z4.kind === "mode-gate").length
+      orphans: allZombies.filter((z4) => z4.kind === "orphan").length
     };
     const total = allZombies.length;
     if (total === 0) {
@@ -13619,7 +14009,7 @@ Exit codes: 0 ok`
       return;
     }
     for (const [sessionId, cwd] of entries) {
-      if (!existsSync49(statePath(cwd, sessionId))) continue;
+      if (!existsSync48(statePath(cwd, sessionId))) continue;
       const sessionZombies = allZombies.filter((z4) => z4.sessionId === sessionId);
       for (const zombie of sessionZombies) {
         try {
@@ -13632,153 +14022,13 @@ Exit codes: 0 ok`
         }
       }
     }
-    console.log(`Dismissed ${total} zombie${total === 1 ? "" : "s"} across ${sessionsSweept.size} session${sessionsSweept.size === 1 ? "" : "s"}: ${summary.heartbeats} heartbeat${summary.heartbeats === 1 ? "" : "s"}, ${summary.orphans} orphan${summary.orphans === 1 ? "" : "s"}, ${summary.modeGates} mode-gate${summary.modeGates === 1 ? "" : "s"}.`);
+    console.log(`Dismissed ${total} zombie${total === 1 ? "" : "s"} across ${sessionsSweept.size} session${sessionsSweept.size === 1 ? "" : "s"}: ${summary.heartbeats} heartbeat${summary.heartbeats === 1 ? "" : "s"}, ${summary.orphans} orphan${summary.orphans === 1 ? "" : "s"}.`);
   });
 }
 
 // src/cli/index.ts
 init_paths();
-
-// src/cli/help-rubric.ts
-function commandPath(cmd) {
-  const parts = [];
-  let cur = cmd;
-  while (cur !== null) {
-    parts.push(cur.name());
-    cur = cur.parent;
-  }
-  parts.reverse();
-  parts.shift();
-  return parts.join(" ");
-}
-var RUBRICS = {
-  "session": { short: "Manage tracked orchestration sessions", useWhen: "acting on a unit of orchestrated work" },
-  "agent": { short: "Operate on worker agents", useWhen: "directing or reading a spawned agent" },
-  "orch": { short: "Talk to / steer the orchestrator", useWhen: "guiding the session's orchestrator" },
-  "ask": { short: "Human-in-the-loop question I/O", useWhen: "answering or polling a blocking ask" },
-  "ui": { short: "Interactive surfaces", useWhen: "a human wants the dashboard, guide, or scratch" },
-  "segment": { short: "Status-line segment registration", useWhen: "wiring tmux status indicators" },
-  "admin": { short: "Install, verify, and report", useWhen: "setting up or diagnosing the install" },
-  "companion": { short: "Companion-pane helper", useWhen: "driving the companion Claude pane" },
-  "deploy": { short: "Provision cloud boxes (Terraform)", useWhen: "standing up or tearing down infra" },
-  "cloud": { short: "Per-repo workflow on a deployed box", useWhen: "syncing work to/from the box" },
-  "feedback": { short: "Report a problem with sisyphus itself", useWhen: "the user complains about the tool or workflow" },
-  "session lifecycle": { short: "Start/stop/advance a session", useWhen: "changing whether a session runs" },
-  "session inspect": { short: "Read session state", useWhen: "you need status/history/context without mutating" },
-  "session config": { short: "Change a session's settings", useWhen: "adjusting task, effort, or dangerous mode" },
-  "session recover": { short: "Repair or relocate a session", useWhen: "a session is stuck, lost, or needs rollback" },
-  "session scratch": { short: "Open a standalone (non-sisyphus) Claude", useWhen: "you want a throwaway Claude in this repo" },
-  "session lifecycle start": { short: "Start a new session", useWhen: "beginning work on a new task" },
-  "session lifecycle complete": { short: "Mark the current cycle complete", useWhen: "the orchestrator finished its work" },
-  "session lifecycle continue": { short: "Continue past completion into a new cycle", useWhen: "more work follows completion" },
-  "session lifecycle resume": { short: "Resume a paused/handed-off session", useWhen: "bringing a stopped session back" },
-  "session lifecycle kill": { short: "Stop a session, keep its state", useWhen: "halting work but preserving the record" },
-  "session lifecycle delete": { short: "Remove a session and its state", useWhen: "discarding a session permanently" },
-  "session inspect status": { short: "Show live session status", useWhen: "checking what is running now" },
-  "session inspect list": { short: "List sessions", useWhen: "enumerating sessions in this repo" },
-  "session inspect history": { short: "Show past sessions/cycles", useWhen: "reviewing prior runs" },
-  "session inspect context": { short: "Print the orchestrator's context", useWhen: "auditing what the orchestrator sees" },
-  "session inspect export": { short: "Export session transcript/state", useWhen: "archiving or sharing a session" },
-  "session inspect requirements": { short: "Show/export the session requirements", useWhen: "reviewing the locked requirements doc" },
-  "session config task": { short: "Set the session's task text", useWhen: "retargeting what the session works on" },
-  "session config effort": { short: "Set the effort tier", useWhen: "tuning model effort for a session" },
-  "session config dangerous": { short: "Toggle dangerous (skip-permissions) mode", useWhen: "allowing unattended tool use" },
-  "session recover rollback": { short: "Roll back to an earlier cycle", useWhen: "a cycle went wrong" },
-  "session recover reconnect": { short: "Reattach the daemon to a live session", useWhen: "the tmux/daemon link dropped" },
-  "session recover quiesce": { short: "Pause a session at the next safe point", useWhen: "you need it to stop cleanly" },
-  "session recover clone": { short: "Clone a session toward a new goal", useWhen: "forking work from an existing session" },
-  "agent spawn": { short: "Spawn a worker agent", useWhen: "delegating a scoped sub-task" },
-  "agent submit": { short: "Submit this agent's result upstream", useWhen: "from inside an agent, its work is done" },
-  "agent report": { short: "Post a progress report", useWhen: "from inside an agent, updating mid-task" },
-  "agent await": { short: "Block until a spawned agent submits", useWhen: "you need an agent's result before continuing" },
-  "agent ctl": { short: "Agent process control", useWhen: "killing or restarting an agent process" },
-  "agent io": { short: "Agent message I/O", useWhen: "sending text to or reading an agent" },
-  "agent ctl kill": { short: "Kill an agent", useWhen: "an agent must stop immediately" },
-  "agent ctl restart": { short: "Restart an agent", useWhen: "an agent is wedged and should start over" },
-  "agent io tell": { short: "Send text to an agent", useWhen: "injecting instructions into a running agent" },
-  "agent io read": { short: "Read an agent's transcript", useWhen: "inspecting what an agent produced" },
-  "orch yield": { short: "Yield control back to the human/parent", useWhen: "the orchestrator is done or blocked" },
-  "orch tell": { short: "Send text to the orchestrator", useWhen: "injecting guidance into the orchestrator" },
-  "orch message": { short: "Queue a message for the orchestrator", useWhen: "leaving async input for the next turn" },
-  "orch read": { short: "Read the orchestrator's transcript", useWhen: "inspecting orchestrator output" },
-  "ask submit": { short: "Submit an ask deck for a human", useWhen: "an agent needs a human decision" },
-  "ask poll": { short: "Block until an ask is answered", useWhen: "you need the human's answer before continuing" },
-  "ask peek": { short: "Read an ask's state without blocking", useWhen: "checking ask status non-blocking" },
-  "ui dashboard": { short: "Open the TUI dashboard", useWhen: "a human wants the monitoring UI" },
-  "ui guide": { short: "Print the full usage guide", useWhen: "a human needs end-to-end docs" },
-  "segment register": { short: "Register a status-line segment", useWhen: "adding a tmux status indicator" },
-  "segment unregister": { short: "Remove a status-line segment", useWhen: "tearing one down" },
-  "admin install": { short: "Install / uninstall sisyphus bits", useWhen: "first setup or removal" },
-  "admin check": { short: "Verify the installation", useWhen: "diagnosing a broken or partial install" },
-  "admin report": { short: "Diagnostics & telemetry", useWhen: "filing a bug or uploading session data" },
-  "admin install setup": { short: "Run first-time setup", useWhen: "installing sisyphus on this machine" },
-  "admin install setup-keybind": { short: "Install the tmux keybind", useWhen: "wiring the dashboard hotkey" },
-  "admin install init": { short: "Initialize repo-local config", useWhen: "onboarding a new repo" },
-  "admin install uninstall": { short: "Remove sisyphus", useWhen: "fully removing the install" },
-  "admin check doctor": { short: "Run install diagnostics", useWhen: "something is not working and you want a health check" },
-  "admin check check-keybinds": { short: "Verify tmux keybinds", useWhen: "the dashboard hotkey does not fire" },
-  "admin check check-statusbar": { short: "Verify status-line wiring", useWhen: "status segments do not render" },
-  "admin report bug": { short: "File a bug report", useWhen: "reporting a defect with context" },
-  "admin report upload": { short: "Upload session data", useWhen: "sharing a session for support" },
-  "admin report configure-upload": { short: "Configure the upload target", useWhen: "setting where uploads go" },
-  "admin clean-zombies": { short: "Sweep stale zombie processes", useWhen: "cleaning up after a crashed daemon or hung agent" },
-  "cloud box": { short: "Provision / operate the box for this repo", useWhen: "working with the box-side environment" },
-  "cloud handoff": { short: "Move a session between local and box", useWhen: "relocating in-flight work" },
-  "cloud box sync": { short: "Rsync this repo to the box", useWhen: "pushing local code to the box" },
-  "cloud box install": { short: "Run the package install on the box", useWhen: "box deps are missing/stale" },
-  "cloud box session": { short: "Create/refresh the box tmux home", useWhen: "the box-side session is absent" },
-  "cloud box attach": { short: "Attach to the box session", useWhen: "you want to work on the box interactively" },
-  "cloud box status": { short: "Print box-side status", useWhen: "checking box state for this repo" },
-  "cloud box login": { short: "Run claude auth login on the box", useWhen: "the box needs Claude credentials" },
-  "cloud box up": { short: "Sync+install+session in one shot", useWhen: "bringing the box up from cold" },
-  "cloud handoff push": { short: "Hand a live session off to the box", useWhen: "moving local work to the cloud" },
-  "cloud handoff pull": { short: "Reclaim a handed-off session locally", useWhen: "bringing cloud work back home" },
-  "agent types": { short: "Agent-type catalog", useWhen: "discovering installable agent types" },
-  "agent types list": { short: "List agent types", useWhen: "enumerating spawnable agent types" },
-  "deploy list": { short: "List deploy providers", useWhen: "discovering supported providers" },
-  "companion profile": { short: "Print companion profile", useWhen: "reading the combined memory + context + badges blob" },
-  "companion memory": { short: "Show accumulated companion observations", useWhen: "reviewing what the companion noticed" },
-  "companion context": { short: "Emit per-prompt companion context", useWhen: "the companion plugin hook needs context" },
-  "companion pane": { short: "Open/focus the side claude pane", useWhen: "you want the companion pane by the dashboard" },
-  "companion popup-test": { short: "Show a test commentary popup", useWhen: "validating feedback-key handling" },
-  "deploy auth": { short: "Configure provider auth", useWhen: "setting up Tailscale/provider credentials" },
-  "deploy hetzner": { short: "Hetzner box lifecycle", useWhen: "targeting Hetzner" },
-  "deploy aws": { short: "AWS box lifecycle", useWhen: "targeting AWS" },
-  "deploy auth tailscale": { short: "Configure Tailscale OAuth", useWhen: "joining the box to your tailnet" },
-  "deploy * up": { short: "Provision the box", useWhen: "standing the box up" },
-  "deploy * down": { short: "Destroy the box", useWhen: "tearing the box down" },
-  "deploy * status": { short: "Print box outputs", useWhen: "checking IP/cost/instance" },
-  "deploy * ssh": { short: "SSH/mosh into the box", useWhen: "getting a shell on the box" },
-  "deploy * logs": { short: "Tail cloud-init + daemon logs", useWhen: "diagnosing a box-side failure" },
-  "deploy * update": { short: "Upgrade sisyphus on the box", useWhen: "pulling the latest daemon onto the box" }
-};
-function subcommandRubric(cmd) {
-  if (cmd.name() === "help") {
-    return cmd.summary() || cmd.description();
-  }
-  const p = commandPath(cmd);
-  let key = p;
-  const deployProviderMatch = p.match(/^deploy (hetzner|aws) (.+)$/);
-  if (deployProviderMatch) {
-    key = `deploy * ${deployProviderMatch[2]}`;
-  }
-  const r = RUBRICS[key];
-  if (r) {
-    return `${r.short}  | use when ${r.useWhen}`;
-  }
-  return cmd.summary() || cmd.description();
-}
-var CONCEPTS_BLOCK = `
-Concepts
-  session       a tracked unit of orchestrated work on one task
-  agent         a worker Claude spawned to execute a scoped sub-task
-  orchestrator  the Claude that owns a session: decomposes, spawns, advances
-  cycle         one discovery\u2192plan\u2192implement\u2192validate iteration; the rollback unit
-  ask           a blocking question surfaced for a human to answer
-  mode          the session's current phase, driving orchestrator behavior
-`;
-
-// src/cli/index.ts
+init_help_rubric();
 var nodeVersion = parseInt(process.versions.node.split(".")[0], 10);
 if (nodeVersion < 22) {
   console.error(`Sisyphus requires Node.js v22+ (current: v${process.versions.node})`);
@@ -13801,7 +14051,7 @@ var sessionCounts = null;
 var program = new Command();
 program.name("sis").description("tmux-integrated orchestration daemon for Claude Code").helpOption("-h, --help", "print -h for any node or leaf").version(
   JSON.parse(
-    readFileSync46(join38(dirname16(fileURLToPath6(import.meta.url)), "..", "package.json"), "utf-8")
+    readFileSync47(join39(dirname16(fileURLToPath6(import.meta.url)), "..", "package.json"), "utf-8")
   ).version,
   "--version",
   "output the version number"
@@ -13811,23 +14061,7 @@ program.configureHelp({
   subcommandDescription: (cmd) => subcommandRubric(cmd)
 });
 program.addHelpText("before", CONCEPTS_BLOCK);
-program.addHelpText("after", `
-I/O contract: flags and positional args on input, JSON on stdout (JSONL for streams).
-
-Exit codes:
-  0   success
-  1   permanent error (fallback)
-  2   usage error (bad args/shape)
-  3   not found
-  4   ambiguous (multiple matches \u2014 see error.candidates)
-  5   conflict (already-exists, wrong-state)
-  60  transient (retry-safe: daemon down, timeout, lock contention)
-
-Errors:
-  {"ok": false,
-   "error": {"code": "<stable-enum>", "kind": "<usage|not_found|ambiguous|conflict|transient|permanent>",
-             "message": "...", "received"?: ..., "expected"?: ..., "next"?: "...", "candidates"?: [...]}}
-`);
+program.addHelpText("after", ROOT_AFTER_HELP);
 if ((process.argv.includes("--help") || process.argv.includes("-h")) && process.argv.some((a) => a === "session")) {
   try {
     const resp = await rawSend2({ type: "list", cwd: process.cwd(), all: true }, 250);
@@ -13929,7 +14163,7 @@ registerHomeInit(diagnostic);
 var args = process.argv.slice(2);
 var firstArg = args[0];
 var skipWelcome = ["session", "start", "dashboard", "agent", "orch", "ask", "ui", "segment", "admin", "feedback", "help", "--help", "--version"];
-if (!existsSync50(globalDir()) && firstArg && !skipWelcome.includes(firstArg)) {
+if (!existsSync49(globalDir()) && firstArg && !skipWelcome.includes(firstArg)) {
   mkdirSync21(globalDir(), { recursive: true });
   console.log("");
   console.log("  Welcome to Sisyphus. Run 'sis admin install setup' to get started.");