@cmgmyr/hive 1.9.1 → 1.10.1

package/dist/queenDashboard.js

@@ -2,6 +2,7 @@ import { existsSync, realpathSync } from "node:fs";
 import { join, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 import { db } from "./db.js";
+import { SECTION_STYLE, SPRITE, chevron, renderBoardPadsTodos, sectionScript } from "./dashboard.js";
 export const QUEEN_BRIEF_KEY = "queen:brief";
 const LANE_ORDER = ["waiting_on_you", "stuck", "moving", "quiet"];
 const LANE_RANK = { waiting_on_you: 0, stuck: 1, moving: 2, quiet: 3 };
@@ -158,6 +159,8 @@ function leadPill(p) {
             return `<span class="status status-ok">lead up</span>${turnPill(p)}`;
         case "dead_pane":
             return '<span class="status status-fail">lead dead</span>';
+        case "dormant":
+            return '<span class="status status-off">lead dormant</span>';
         case "unknown":
             return '<span class="status status-off">lead unknown</span>';
         default:
@@ -243,7 +246,7 @@ function quietList(list, asOf, href) {
     return ('<section class="card"><ul class="quiet-list">' +
         list
             .map((p) => {
-            const sub = `${p.lead.state === "alive" ? (turnText(p) ? `lead up, ${turnText(p)}` : "lead up") : p.lead.state === "dead_pane" ? "lead dead" : p.lead.state === "unknown" ? "lead unknown" : "no lead"}, ${p.todos.open} open`;
+            const sub = `${p.lead.state === "alive" ? (turnText(p) ? `lead up, ${turnText(p)}` : "lead up") : p.lead.state === "dead_pane" ? "lead dead" : p.lead.state === "dormant" ? "lead dormant" : p.lead.state === "unknown" ? "lead unknown" : "no lead"}, ${p.todos.open} open`;
             return (`<li data-project="${p.id}"><span>${projectLink(p, href)}` +
                 `<a class="sub" href="#row-${p.id}" data-jump="${p.id}">${esc(sub)}</a></span>` +
                 `<span class="age">${esc(age(p.last_activity_at, asOf))}</span></li>`);
@@ -338,7 +341,7 @@ function briefSection(state, report, href, queenHomeId) {
         (picks ? `<ol>${picks}</ol>` : "") +
         `${driftLine(brief, report, queenHomeId)}</section>`);
 }
-const CSS = `
+const CSS = `${SECTION_STYLE}
 :root { color-scheme: light;
   --font-mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
   --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
@@ -350,7 +353,7 @@ const CSS = `
   --accent: #1f5fd0; --focus: #1f5fd0; --hover: #f1f4f8;
   --shadow: 0 1px 2px rgba(19, 26, 38, 0.06), 0 2px 8px rgba(19, 26, 38, 0.05);
   --card-border: transparent; --r-card: 14px; --r-ctl: 9px; --r-pill: 999px;
-  --ease-out: cubic-bezier(0.23, 1, 0.32, 1); }
+  --ease-out: cubic-bezier(0.23, 1, 0.32, 1); --header-offset: 5rem; }
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme="light"]) { color-scheme: dark;
     --bg: #101317; --panel: #171b21; --panel-sunken: #1c2129;
@@ -478,17 +481,22 @@ a.proj:hover { color: var(--accent); text-decoration: underline; text-underline-
 a.sub:hover { color: var(--accent); text-decoration: underline; text-underline-offset: 2px; }
 .turn { font-size: 0.75rem; color: var(--fg-muted); }
 .turn-work { color: var(--live); }
-.c-audit { margin-top: 1.5rem; padding-bottom: 0.85rem; }
+.c-audit { margin-top: 1.5rem; }
+.c-audit[open] { padding-bottom: 0.85rem; }
+details.card:not([open]) > .card-head { padding-bottom: 0.9rem; }
 .c-audit .audit-list, .c-audit .brief-empty { padding: 0 1.1rem; }
 .audit-list { list-style: none; margin: 0.5rem 0 0; padding: 0; display: grid; gap: 0.4rem; font-size: 0.8125rem; }
 .audit-list li { display: flex; flex-wrap: wrap; gap: 0.15rem 0.75rem; align-items: baseline; }
 .audit-op { font-weight: 600; }
 .audit-sum { color: var(--fg-muted); min-width: 0; overflow-wrap: anywhere; }
 .d-grid { margin-top: 1.5rem; }
+.card-head > .chev { margin-left: auto; }
+.home { margin-top: 1.5rem; }
+.home-head { padding: 0 0.2rem 0.6rem; }
 .d-grid .g-row:not(.g-head) { box-shadow: inset 3px 0 0 var(--lane, transparent); }
 .d-grid .g-row { scroll-margin-top: 6rem; transition: background-color 600ms ease; }
 .d-grid .g-row.is-flash { background: var(--live-bg); transition: none; }
-.empty { margin-top: 1.25rem; padding: 1.25rem 1.1rem; color: var(--fg-muted); }
+.no-projects { margin-top: 1.25rem; padding: 1.25rem 1.1rem; color: var(--fg-muted); }
 @media (prefers-reduced-motion: reduce) { * { transition: none !important; } }
 `;
 const SCRIPT = `(function () {
@@ -504,12 +512,17 @@ const SCRIPT = `(function () {
     var row = document.getElementById("row-" + j.getAttribute("data-jump"));
     if (!row) return;
     e.preventDefault();
+    var box = row.closest("details");
+    if (box) box.open = true;
     var still = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
     row.scrollIntoView({ behavior: still ? "auto" : "smooth", block: "center" });
     row.classList.add("is-flash");
     setTimeout(function () { row.classList.remove("is-flash"); }, 900);
   });
 })();`;
+const SECTIONS_SCRIPT = `(function () {
+${sectionScript("hive-queen-state")}
+})();`;
 const MARK = '<symbol id="mark" viewBox="0 0 32 32"><path d="M16 3.2 27 9.6v12.8L16 28.8 5 22.4V9.6Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"/><path d="M16 11 21 14v6l-5 3-5-3v-6Z" fill="currentColor" fill-opacity="0.22" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/></symbol>';
 export const QUEEN_GENERATED_MARKER = "data-generated";
 function auditSection(audit, report) {
@@ -525,7 +538,7 @@ function auditSection(audit, report) {
                 .join("") +
             "</ul>"
         : '<p class="brief-empty">No queen actions recorded yet.</p>';
-    return `<section class="card c-audit"><div class="card-head"><h2>Recent queen actions</h2><span class="card-sub">the newest writes the queen made into other projects</span></div>${body}</section>`;
+    return `<details class="card c-audit" id="queen-recent-actions" open><summary class="card-head"><h2>Recent queen actions</h2><span class="card-sub">the newest writes the queen made into other projects</span>${chevron()}</summary>${body}</details>`;
 }
 export function renderQueenDashboard(report, briefState, href = (p) => dashboardHref(p.root), audit = [], queenHomeId = null) {
     const asOf = report.as_of;
@@ -552,22 +565,26 @@ export function renderQueenDashboard(report, briefState, href = (p) => dashboard
             `<span class="count">${report.totals.lanes[lane]}</span></h2></div>` +
             `<p class="lane-rule">${LANE_RULE[lane]}</p>${body}</section>`);
     }).join("");
+    const home = queenHomeId === null
+        ? ""
+        : `<div class="home"><div class="home-head"><h2>Queen home project</h2></div>${renderBoardPadsTodos(queenHomeId)}</div>`;
     const main = n === 0
-        ? `${briefSection(briefState, report, href, queenHomeId)}<section class="card empty"><h2>No projects registered</h2><p>Run <code>hive lead</code> in a project folder to register it, and it will appear here.</p></section>`
+        ? `${briefSection(briefState, report, href, queenHomeId)}<section class="card no-projects"><h2>No projects registered</h2><p>Run <code>hive lead</code> in a project folder to register it, and it will appear here.</p></section>`
         : `${briefSection(briefState, report, href, queenHomeId)}<div class="lanes">${lanes}</div>` +
-            `<section class="card d-grid"><div class="card-head"><h2>Every project <span class="count">${n}</span></h2>` +
-            '<span class="card-sub">in lane order; a name opens that project’s dashboard</span></div>' +
+            `<details class="card d-grid" id="queen-every-project" open><summary class="card-head"><h2>Every project <span class="count">${n}</span></h2>` +
+            `<span class="card-sub">in lane order; a name opens that project’s dashboard</span>${chevron()}</summary>` +
             `<div class="grid" role="table">${GRID_HEAD}${ordered.map((p) => gridRow(p, asOf, href)).join("")}</div>` +
-            '<p class="freshnote">Every row here is read from the store when the page is written. Only the picks are written by a model, which is why they carry a time.</p></section>' +
-            auditSection(audit, report);
+            '<p class="freshnote">Every row here is read from the store when the page is written. Only the picks are written by a model, which is why they carry a time.</p></details>';
+    const page = main + home + (n === 0 ? "" : auditSection(audit, report));
     return ('<!doctype html><html lang="en"><head><meta charset="utf-8">' +
         '<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">' +
         `<title>All projects</title><style>${CSS}</style></head><body>` +
+        SPRITE +
         `<svg style="position:absolute;width:0;height:0" aria-hidden="true"><defs>${MARK}</defs></svg>` +
-        '<header class="topbar"><div class="wrap topbar-inner"><div class="brand">' +
+        '<header class="topbar" id="topbar"><div class="wrap topbar-inner"><div class="brand">' +
         '<svg class="mark" role="img" aria-label="hive"><use href="#mark"/></svg><div><h1>All projects</h1>' +
         `<p class="generated" ${QUEEN_GENERATED_MARKER}>Live rows as of ${esc(asOf)} UTC. ${n} project${n === 1 ? "" : "s"} on this machine.</p></div></div>` +
         '<label class="live-toggle" title="Off stops this page reloading. The scheduler still rewrites the file.">' +
         '<input type="checkbox" id="autoreload"> Reload every minute</label></div></header>' +
-        `<main class="wrap">${main}</main><script>${SCRIPT}</script></body></html>\n`);
+        `<main class="wrap">${page}</main><script>${SCRIPT}\n${SECTIONS_SCRIPT}</script></body></html>\n`);
 }

package/dist/spawn.js

@@ -4,7 +4,7 @@ import { preservedRolloutPath, reapCodexHome } from "./codexHome.js";
 import { getProject } from "./context.js";
 import { dataDir, db } from "./db.js";
 import { loadProjectYml } from "./projectYml.js";
-import { applyLayout, claimInitialWindow, createWindow, DEFAULT_LAYOUT, ensureSession, crossServerRefusal, findProcessesWindow, findProjectWindow, isPaneTarget, panePidForRecord, paneWindow, PROCESSES_LAYOUT, processesPaneTitle, processesWindowName, retainOnExitArgs, rowLive, sessionName, setPaneTitle, makeProcessesWindow, tmux, tmuxSocketPath, untrustedTmuxServer, waitForPaneEstablished, windowLayout, windowOwner, windowTitle, rowOwnership, } from "./tmux.js";
+import { applyLayout, claimInitialWindow, createWindow, DEFAULT_LAYOUT, ensureSession, crossServerRefusal, findProcessesWindow, findProjectWindow, isPaneTarget, paneProcessExited, paneWindow, PROCESSES_LAYOUT, processesPaneTitle, processesWindowName, retainOnExitArgs, rowLive, sessionName, setPaneTitle, setRemainOnExit, makeProcessesWindow, tmux, tmuxSocketPath, untrustedTmuxServer, waitForPaneEstablished, windowLayout, windowOwner, windowTitle, rowOwnership, } from "./tmux.js";
 export function withWindowClaim(claim) {
     if (db.inTransaction) {
         throw new Error("withWindowClaim was called from inside an already-open transaction. better-sqlite3 nests a " +
@@ -56,13 +56,21 @@ function recordPane(agentId, target, socket, pid) {
         .prepare("UPDATE agents SET tmux_target = ?, tmux_socket = ?, pane_pid = ? WHERE id = ? AND status = 'running'")
         .run(target, socket, pid, agentId).changes > 0);
 }
-function readPidOrDiscard(target) {
-    const pid = panePidForRecord(target);
-    if (pid !== "")
+// The creation pid proves the pane existed, not that its process still runs. A retained pane is
+// left to the caller's readiness wait, which reports the exit with its tail.
+function refuseIfExitedImmediately(target, retained) {
+    if (retained || paneProcessExited(target) !== true)
+        return;
+    discardOrphanedPane(target);
+    throw new Error(`The command exited immediately, so its pane ${target} was discarded rather than recorded as running. ` +
+        "Check the command and its arguments, then retry.");
+}
+export function createdPidOrDiscard(target, pid) {
+    if (/^\d+$/.test(pid))
         return pid;
     discardOrphanedPane(target);
-    throw new Error(`tmux did not report a process id for the new pane ${target} (asked twice), so it was discarded rather than ` +
-        "recorded: a row with no pane pid can never be verified as owning its pane. Retry.");
+    throw new Error(`tmux did not report a process id for the new pane ${target} when it created it, so it was discarded rather ` +
+        "than recorded: a row with no pane pid can never be verified as owning its pane. Retry.");
 }
 // Two callers, one meaning: whatever is left in the window re-tiles to the layout it was arranged
 // with. agent_close kills a worker's pane through this; stopProcess (src/processes.ts) is the only
@@ -116,10 +124,11 @@ export function upsertActor(actorId, name, kind) {
     db.prepare(`INSERT INTO actors (id, name, kind) VALUES (?, ?, ?)
      ON CONFLICT(id) DO UPDATE SET name = excluded.name, last_seen_at = datetime('now')`).run(actorId, name, kind);
 }
-function placeAgentPane(session, spec, envFlags, commandString, title) {
+function placeAgentPane(session, spec, envFlags, commandString, title, onRetainArmed = () => { }) {
     let landedInProjectId = null;
     let layoutApplied = false;
     let inProcessesWindow = false;
+    let pid = "";
     const target = withWindowClaim(() => {
         const windowName = spec.placement === "split" ? spec.projectName : title;
         const windowOwnerId = spec.placement === "split" ? spec.projectId : null;
@@ -127,10 +136,14 @@ function placeAgentPane(session, spec, envFlags, commandString, title) {
         if (started.created) {
             // Deliberate for placement "processes" too: this pane IS the new session's initial window, so it
             // takes that window rather than a tile. The caller reports it; `hive hide` moves it in later.
+            pid = started.pid;
             return claimInitialWindow(started, windowName, windowOwnerId).pane;
         }
         const splitInto = (window, layout) => {
-            const pane = tmux("split-window", "-d", "-P", "-F", "#{pane_id}", "-t", window, "-c", spec.cwd, ...envFlags, commandString, ...(spec.retainOnExit ? retainOnExitArgs(window) : []));
+            const [pane, created = ""] = tmux("split-window", "-d", "-P", "-F", "#{pane_id}\t#{pane_pid}", "-t", window, "-c", spec.cwd, ...envFlags, commandString, ...(spec.retainOnExit ? retainOnExitArgs(window) : [])).split("\t");
+            pid = created;
+            if (spec.retainOnExit)
+                onRetainArmed(window);
             applyLayout(window, layout);
             layoutApplied = true;
             return pane;
@@ -143,6 +156,9 @@ function placeAgentPane(session, spec, envFlags, commandString, title) {
             }
             else {
                 const made = createWindow(session, processesWindowName(spec.projectName), spec.cwd, envFlags, commandString, null, true, spec.retainOnExit ?? false);
+                pid = made.pid;
+                if (spec.retainOnExit)
+                    onRetainArmed(made.window);
                 makeProcessesWindow(made.window, spec.projectId);
                 pane = made.pane;
             }
@@ -160,9 +176,13 @@ function placeAgentPane(session, spec, envFlags, commandString, title) {
                 return pane;
             }
         }
-        return createWindow(session, windowName, spec.cwd, envFlags, commandString, windowOwnerId, true, spec.retainOnExit ?? false).pane;
+        const made = createWindow(session, windowName, spec.cwd, envFlags, commandString, windowOwnerId, true, spec.retainOnExit ?? false);
+        pid = made.pid;
+        if (spec.retainOnExit)
+            onRetainArmed(made.window);
+        return made.pane;
     });
-    return { target, landedInProjectId, layoutApplied, inProcessesWindow };
+    return { target, pid, landedInProjectId, layoutApplied, inProcessesWindow };
 }
 export function launchAgent(spec) {
     if (untrustedTmuxServer())
@@ -171,11 +191,11 @@ export function launchAgent(spec) {
     let info;
     try {
         info = db
-            .prepare("INSERT INTO agents (project_id, name, command, cwd, kind, parent_actor_id, tmux_socket, session_id, codex_home, model, extra_args) " +
-            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)")
+            .prepare("INSERT INTO agents (project_id, name, command, cwd, kind, parent_actor_id, tmux_socket, session_id, codex_home, model, extra_args, todo_id) " +
+            "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)")
             .run(spec.projectId, spec.name, typeof spec.commandString === "string" ? spec.commandString : "", spec.cwd, spec.kind, spec.parentActor, socket, spec.sessionId ?? "", spec.codexHome ?? "", spec.model ?? null, spec.readOnly
             ? JSON.stringify({ args: spec.extraArgs ?? [], read_only: true })
-            : spec.extraArgs ? JSON.stringify(spec.extraArgs) : null);
+            : spec.extraArgs ? JSON.stringify(spec.extraArgs) : null, spec.todoId ?? null);
     }
     catch (e) {
         throw asNameClash(e, spec.name);
@@ -183,6 +203,7 @@ export function launchAgent(spec) {
     const agentId = Number(info.lastInsertRowid);
     const actorId = `${spec.kind}:${agentId}`;
     let paneUp = false;
+    let retainedWindow = null;
     try {
         const commandString = typeof spec.commandString === "string" ? spec.commandString : spec.commandString({ agentId, actorId });
         db.prepare("UPDATE agents SET actor_id = ?, command = ? WHERE id = ?").run(actorId, commandString, agentId);
@@ -193,16 +214,22 @@ export function launchAgent(spec) {
             : spec.env;
         const envFlags = buildEnvFlags(env);
         const title = windowTitle(spec.projectName, spec.name);
-        const { target, landedInProjectId, layoutApplied, inProcessesWindow } = placeAgentPane(session, spec, envFlags, commandString, title);
-        const pid = readPidOrDiscard(target);
+        const placed = placeAgentPane(session, spec, envFlags, commandString, title, (window) => {
+            retainedWindow = window;
+        });
+        const { target, landedInProjectId, layoutApplied, inProcessesWindow } = placed;
+        const pid = createdPidOrDiscard(target, placed.pid);
+        refuseIfExitedImmediately(target, spec.retainOnExit ?? false);
         paneUp = true;
         if (!recordPane(agentId, target, socket, pid)) {
             discardOrphanedPane(target);
             throw paneRacedRetirement(agentId);
         }
-        return { agentId, actorId, target, landedInProjectId, layoutApplied, inProcessesWindow };
+        return { agentId, actorId, target, landedInProjectId, layoutApplied, inProcessesWindow, retainedWindow };
     }
     catch (e) {
+        if (retainedWindow)
+            setRemainOnExit(retainedWindow, false);
         if (paneUp)
             throw e;
         db.prepare("DELETE FROM agents WHERE id = ?").run(agentId);
@@ -269,8 +296,10 @@ export function resumeAgent(spec) {
         });
         const session = sessionName();
         const title = windowTitle(spec.projectName, spec.name);
-        const { target, landedInProjectId } = placeAgentPane(session, spec, envFlags, spec.commandString, title);
-        const pid = readPidOrDiscard(target);
+        const placed = placeAgentPane(session, spec, envFlags, spec.commandString, title);
+        const { target, landedInProjectId } = placed;
+        const pid = createdPidOrDiscard(target, placed.pid);
+        refuseIfExitedImmediately(target, false);
         paneUp = true;
         if (!recordPane(spec.agentId, target, socket, pid)) {
             discardOrphanedPane(target);

package/dist/tmux.js

@@ -184,16 +184,19 @@ function unsetAtSessionScope(name, envFlags) {
         // HIVE_PROJECT_PATH at session scope, silently, for that session's whole life.
     }
 }
+// The pid is read from the creating call because tmux 3.8 reports an empty #{pane_pid} once a pane's
+// process has exited, so a later list-panes can lose the race against a command that dies at once.
+export const CREATED_PANE_FORMAT = "#{pane_id}\t#{session_name}:#{window_id}\t#{pane_pid}";
 export function ensureSession(name, cwd, initial) {
     if (quietTmux("has-session", "-t", `=${name}`))
         return { created: false };
     if (untrustedTmuxServer())
         throw crossServerRefusal("create a tmux session");
     try {
-        const [pane, window] = tmux("new-session", "-d", "-P", "-F", "#{pane_id}\t#{session_name}:#{window_id}", "-s", name, "-c", cwd, ...(initial && "command" in initial ? [...initial.envFlags, initial.command] : [])).split("\t");
+        const [pane, window, pid = ""] = tmux("new-session", "-d", "-P", "-F", CREATED_PANE_FORMAT, "-s", name, "-c", cwd, ...(initial && "command" in initial ? [...initial.envFlags, initial.command] : [])).split("\t");
         if (initial && "command" in initial)
             unsetAtSessionScope(name, initial.envFlags);
-        return { created: true, pane, window };
+        return { created: true, pane, window, pid };
     }
     catch (e) {
         if (!isDuplicateSession(e))
@@ -360,7 +363,7 @@ export function targetLiveProbe(target) {
         const rows = tmux("list-panes", "-t", target, "-F", "#{pane_id} #{pane_pid}")
             .split("\n")
             .map((line) => line.split(" "));
-        const pid = isPaneTarget(target) ? (rows.find(([id]) => id === target)?.[1] ?? null) : null;
+        const pid = isPaneTarget(target) ? (rows.find(([id]) => id === target)?.[1] || null) : null;
         return { live: true, pid };
     }
     catch (e) {
@@ -700,10 +703,10 @@ export function captureFinalScreen(target, lines) {
     }
 }
 export function createWindow(session, windowName, cwd, envFlags, command, projectId, detach = false, retainOnExit = false) {
-    const created = tmux("new-window", ...(detach ? ["-d"] : []), "-P", "-F", "#{pane_id}\t#{session_name}:#{window_id}", "-t", `=${session}`, "-n", windowName, "-c", cwd, ...envFlags, command, ...(retainOnExit ? retainOnExitArgs(`=${session}:${windowName}`) : []));
-    const [pane, window] = created.split("\t");
+    const created = tmux("new-window", ...(detach ? ["-d"] : []), "-P", "-F", CREATED_PANE_FORMAT, "-t", `=${session}`, "-n", windowName, "-c", cwd, ...envFlags, command, ...(retainOnExit ? retainOnExitArgs(`=${session}:${windowName}`) : []));
+    const [pane, window, pid = ""] = created.split("\t");
     configureHiveWindow(window, true, projectId);
-    return { pane, window };
+    return { pane, window, pid };
 }
 function viewSessionChain(session, view) {
     return [

package/dist/tools/agents.js

@@ -17,7 +17,8 @@ import { markGoneReported } from "../scheduler.js";
 import { agentIdentityEnv, branchAt, closeAgentRow, currentOwnership, discardOrphanedPane, isReservedAgentName, isRunningLeadActor, killAgentPane, launchAgent, LEAD_KIND, PaneOwnershipLost, paneIdentity, parkAgentRow, reapCodexHomeForClosedAgent, requireStillOwned, releaseParkRow, renameAgent, resumeAgent, storedLaunchOptions, } from "../spawn.js";
 import { COMMAND_KIND, runningCommandRow, stopLine, stopProcess, STOP_REASONS } from "../processes.js";
 import { readContextTokens, readContextFill, resolveTranscriptDir } from "../transcript.js";
-import { capturePane, captureFinalScreen, DEFAULT_LAYOUT, cancelCopyMode, describePaneChoice, ensureAttached, findUnsafeControlChar, holdsHumanInput, liveTargets, observationFailed, observeRowOwnership, ownershipLiveness, paneCurrentCommand, paneInCopyMode, paneWindow, pollPaneReadiness, rowOwnership, sendText, sessionName, setRemainOnExit, sleep, TEXT_ALLOWED_CONTROL_CHARS, tmux, TmuxTimeoutError, WINDOW_LAYOUTS, } from "../tmux.js";
+import { leadSessionEnded } from "../leadState.js";
+import { capturePane, captureFinalScreen, DEFAULT_LAYOUT, cancelCopyMode, describePaneChoice, ensureAttached, findUnsafeControlChar, holdsHumanInput, liveTargets, observationFailed, observeRowOwnership, ownershipLiveness, paneCurrentCommand, paneInCopyMode, pollPaneReadiness, rowOwnership, sendText, sessionName, setRemainOnExit, sleep, TEXT_ALLOWED_CONTROL_CHARS, tmux, TmuxTimeoutError, WINDOW_LAYOUTS, } from "../tmux.js";
 import { agentIdParam, agentNameParam, idParam, projectIdParam } from "./params.js";
 import { deriveProvenance, lastLogEvent, lastPermissionMode, reportsAgentStateLog, } from "../stateProvenance.js";
 const CLOSED_ROW_ORDER = "(parked_at != '') DESC, closed_at DESC, id DESC";
@@ -357,7 +358,7 @@ function paneField(row, alive) {
     return { pane: describePaneChoice(awaitingChoice) };
 }
 function agentSummary(row, snapshot) {
-    const alive = summaryLiveness(row, snapshot);
+    const { alive, dormant } = row.kind === LEAD_KIND ? leadSummaryLiveness(row, snapshot) : { alive: summaryLiveness(row, snapshot), dormant: null };
     const { state, ...provenance } = deriveProvenance(row, alive);
     return {
         agent_id: row.id,
@@ -378,7 +379,9 @@ function agentSummary(row, snapshot) {
         command: row.command,
         cwd: row.cwd,
         parent_actor_id: row.parent_actor_id,
+        todo_id: row.todo_id,
         created_at: row.created_at,
+        ...(dormant ? { dormant_since: dormant.ended_at } : {}),
     };
 }
 export function contextCheckpointEnv(config) {
@@ -419,6 +422,9 @@ export function registerAgents(server) {
                 .describe("Spawn a known harness by name (e.g. \"codex\") instead of a raw command. Ignored when command is also given. Must be in the project's hive.yml agents: list (default: claude only)."),
             extra_args: z.array(z.string()).optional().describe("Extra CLI arguments."),
             read_only: z.boolean().optional().describe("Prevent local file writes and mutating shell commands while allowing Hive MCP tools. Only bare claude/codex executables. Extra args allow codex -c model_reasoning_effort=low|medium|high|xhigh, or claude --effort low|medium|high|xhigh|max; all other arguments are refused."),
+            todo_id: idParam
+                .optional()
+                .describe("The todo this worker is on, recorded as a link (a non-archived todo in the same project). Changes no todo status."),
             cwd: z
                 .string()
                 .optional()
@@ -468,6 +474,20 @@ export function registerAgents(server) {
                 throw new Error(`cwd ${cwd} belongs to project "${cwdProject.name}" (id ${cwdProject.id}), but this spawn resolved to project "${project.name}" (id ${project.id}). ${remedy}`);
             }
         }
+        if (args.todo_id !== undefined) {
+            const linked = db
+                .prepare("SELECT archived_at FROM todos WHERE id = ? AND project_id = ?")
+                .get(args.todo_id, project.id);
+            if (!linked)
+                throw new Error(`todo_id ${args.todo_id} is not a todo in project "${project.name}" (id ${project.id}).`);
+            if (linked.archived_at != null)
+                throw new Error(`todo_id ${args.todo_id} is archived; unarchive it or link another todo.`);
+        }
+        const omittedTodoWarning = args.todo_id === undefined && db
+            .prepare("SELECT 1 FROM todos WHERE project_id = ? AND status = 'in_progress' AND archived_at IS NULL LIMIT 1")
+            .get(project.id)
+            ? "todo_id was omitted while this project has an in-progress todo; the crew view may infer a link from this worker's comments or pad updates."
+            : undefined;
         const name = args.name != null
             ? normalizeAgentName(args.name, "name")
             : nextWorkerName(project.id);
@@ -566,6 +586,7 @@ export function registerAgents(server) {
                 model: args.model,
                 extraArgs: args.extra_args,
                 readOnly: args.read_only,
+                todoId: args.todo_id,
                 retainOnExit: harness.classifiesPaneScreen,
             });
         }
@@ -578,51 +599,51 @@ export function registerAgents(server) {
                 rmSync(codexHomeDir(codexHomeKey), { recursive: true, force: true });
             throw e;
         }
-        const { agentId, actorId, target, landedInProjectId, layoutApplied } = spawned;
-        ensureAttached(sessionName());
+        const { agentId, actorId, target, landedInProjectId, layoutApplied, retainedWindow } = spawned;
         let ready = false;
         let dialogTail;
         let exited = false;
         let exitTail;
-        if (harness.classifiesPaneScreen) {
-            const classifier = harness.paneClassifier;
-            // Captured before anything below can kill the pane: remain-on-exit is a WINDOW option,
-            // and the pane id itself stops being addressable once discardOrphanedPane has run.
-            const windowTarget = paneWindow(target) ?? target;
-            try {
-                const outcome = await pollPaneReadiness(target, PANE_READY_MS, classifier.hasInputBox);
-                if (outcome === "gone") {
-                    // remain-on-exit held the pane so its final screen is still readable; capture it,
-                    // persist it onto the row (the pane below is about to be killed), then release it.
-                    // Never run choiceCheck against a retained-but-dead pane: it is frozen content, not
-                    // a live dialog, and choiceCheck's own capture is tuned to read a live screen.
-                    exited = true;
-                    exitTail = captureFinalScreen(target, 30);
-                    db.prepare("UPDATE agents SET exit_tail = ? WHERE id = ?").run(exitTail, agentId);
-                    discardOrphanedPane(target);
-                }
-                else {
-                    const { awaitingChoice, tail } = classifier.choiceCheck(target);
-                    if (awaitingChoice === true) {
-                        dialogTail = tail;
+        try {
+            ensureAttached(sessionName());
+            if (harness.classifiesPaneScreen) {
+                const classifier = harness.paneClassifier;
+                try {
+                    const outcome = await pollPaneReadiness(target, PANE_READY_MS, classifier.hasInputBox);
+                    if (outcome === "gone") {
+                        // remain-on-exit held the pane so its final screen is still readable; capture it,
+                        // persist it onto the row (the pane below is about to be killed), then release it.
+                        // Never run choiceCheck against a retained-but-dead pane: it is frozen content, not
+                        // a live dialog, and choiceCheck's own capture is tuned to read a live screen.
+                        exited = true;
+                        exitTail = captureFinalScreen(target, 30);
+                        db.prepare("UPDATE agents SET exit_tail = ? WHERE id = ?").run(exitTail, agentId);
+                        discardOrphanedPane(target);
                     }
-                    else if (outcome === "ready") {
-                        ready = true;
+                    else {
+                        const { awaitingChoice, tail } = classifier.choiceCheck(target);
+                        if (awaitingChoice === true) {
+                            dialogTail = tail;
+                        }
+                        else if (outcome === "ready") {
+                            ready = true;
+                        }
                     }
                 }
-            }
-            catch {
-                ready = false;
-            }
-            finally {
-                // Unconditional: every early return, throw, or timeout between arming remain-on-exit
-                // and here must still clear it, or the shared window (the default split placement's)
-                // is left silently retaining every later exit in it, not just this one.
-                setRemainOnExit(windowTarget, false);
+                catch {
+                    ready = false;
+                }
             }
         }
+        finally {
+            // Unconditional: every early return, throw, or timeout between arming remain-on-exit
+            // and here must still clear it, or the shared window (the default split placement's)
+            // is left silently retaining every later exit in it, not just this one.
+            if (retainedWindow)
+                setRemainOnExit(retainedWindow, false);
+        }
         const codexInstructions = codexHomeKey ? codexInstructionsPhrase(codexInstructionLayers) : undefined;
-        return {
+        const receipt = {
             agent_id: agentId,
             ...(args.read_only ? { read_only: true } : {}),
             actor_id: actorId,
@@ -671,6 +692,11 @@ export function registerAgents(server) {
                             "Wakes aimed at this worker are refused for the same reason.",
                     }),
         };
+        if (omittedTodoWarning) {
+            const existingNote = typeof receipt.note === "string" ? receipt.note : "";
+            receipt.note = existingNote ? `${existingNote} ${omittedTodoWarning}` : omittedTodoWarning;
+        }
+        return receipt;
     }));
     server.registerTool("agent_resume", {
         description: "Resume a CLOSED claude or codex worker from its recorded session id (claude --resume / codex resume): a fresh pane, the same actor_id, and the worker's full prior context. Addressed by name or agent_id among closed agents (agent_list(include_closed: true)). Send it its next instruction with agent_send once resumed - this tool does not.",
@@ -1580,3 +1606,8 @@ function readInputBox(classifier, target) {
     const box = classifier.inputBoxState(target);
     return box === null ? null : { box };
 }
+function leadSummaryLiveness(row, snapshot) {
+    const ownership = row.status === "running" ? rowOwnership(row, snapshot) : null;
+    const alive = ownership === null ? false : ownershipLiveness(ownership);
+    return { alive, dormant: ownership === null ? null : leadSessionEnded(row, ownership) };
+}