@cmgmyr/hive 1.9.1 → 1.10.0

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

@@ -171,11 +171,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);

package/dist/tools/agents.js

@@ -17,6 +17,7 @@ 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 { leadSessionEnded } from "../leadState.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 { agentIdParam, agentNameParam, idParam, projectIdParam } from "./params.js";
 import { deriveProvenance, lastLogEvent, lastPermissionMode, reportsAgentStateLog, } from "../stateProvenance.js";
@@ -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,
             });
         }
@@ -622,7 +643,7 @@ export function registerAgents(server) {
             }
         }
         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) };
+}

package/dist/transcript.js

@@ -35,6 +35,9 @@ function usageTokens(record) {
     return tokenNumber(sum) && sum > 0 ? sum : null;
 }
 function tailRecords(path) {
+    return tailRead(path).records;
+}
+function tailRead(path) {
     let fd;
     try {
         fd = openSync(path, "r");
@@ -54,10 +57,10 @@ function tailRecords(path) {
             }
             catch { }
         }
-        return records;
+        return { records, clipped: start > 0 };
     }
     catch {
-        return [];
+        return { records: [], clipped: false };
     }
     finally {
         if (fd !== undefined)
@@ -124,3 +127,133 @@ export function readContextTokens(cwd, sessionId, explicitPath = "") {
         return null;
     return claudeTokens(tailRecords(transcriptPath(cwd, sessionId, explicitPath)));
 }
+export const RECENT_TOOL_CALLS = 8;
+export const SKILL_TOOL = "Skill";
+export function lastComponent(name) {
+    return name.split(/__|[.:/]/).filter(Boolean).pop() ?? name;
+}
+function timestamp(record) {
+    return typeof record.timestamp === "string" && record.timestamp !== "" ? record.timestamp : null;
+}
+function reviewMarker(texts, at, skills) {
+    for (const skill of skills) {
+        const invocation = new RegExp(`^\\s*\\$${skill.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?![\\w-])`, "m");
+        if (texts.some((text) => typeof text === "string" && invocation.test(text))) {
+            return [{ name: SKILL_TOOL, input: { skill }, at }];
+        }
+    }
+    return [];
+}
+function claudeToolCalls(record, options) {
+    if (record.type !== "assistant")
+        return [];
+    const content = object(record.message)?.content;
+    if (!Array.isArray(content))
+        return [];
+    const at = timestamp(record);
+    const calls = [];
+    for (const part of content) {
+        const block = object(part);
+        if (!block)
+            continue;
+        if (block.type === "tool_use" && typeof block.name === "string") {
+            calls.push({ name: block.name, input: object(block.input) ?? {}, at });
+        }
+        else if (block.type === "text") {
+            calls.push(...reviewMarker([block.text], at, options.reviewSkills ?? []));
+        }
+    }
+    return calls;
+}
+function stringLiteral(text) {
+    const quote = text[0];
+    if (quote !== '"' && quote !== "'")
+        return null;
+    const json = quote === '"' ? text : `"${text.slice(1, -1).replace(/\\'/g, "'").replace(/(\\.)|"/g, (m, esc) => esc ?? '\\"')}"`;
+    try {
+        const value = JSON.parse(json);
+        return typeof value === "string" ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+function execInnerCalls(source, at) {
+    const marks = [...source.matchAll(/\btools\.([A-Za-z_]\w*)\s*\(/g)];
+    if (marks.length === 0)
+        return null;
+    const calls = [];
+    marks.forEach((mark, i) => {
+        const name = lastComponent(mark[1]);
+        if (name === "write_stdin")
+            return;
+        if (name === "exec_command") {
+            const span = source.slice(mark.index + mark[0].length, marks[i + 1]?.index ?? source.length);
+            const cmd = /["']?\bcmd["']?\s*:\s*("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')/.exec(span);
+            const command = cmd ? stringLiteral(cmd[1]) : null;
+            if (command !== null)
+                calls.push({ name: "Bash", input: { command }, at });
+            return;
+        }
+        calls.push({ name, input: {}, at });
+    });
+    return calls;
+}
+function codexToolCalls(record, options) {
+    const payload = object(record.payload);
+    if (record.type !== "response_item" || !payload)
+        return [];
+    const at = timestamp(record);
+    if (payload.type === "message") {
+        if (payload.role !== "assistant" || !Array.isArray(payload.content))
+            return [];
+        return reviewMarker(payload.content.map((part) => object(part)?.text), at, options.reviewSkills ?? []);
+    }
+    if (typeof payload.name !== "string")
+        return [];
+    const name = lastComponent(payload.name);
+    if (payload.type === "custom_tool_call") {
+        if (name === "exec" && typeof payload.input === "string") {
+            const inner = execInnerCalls(payload.input, at);
+            if (inner)
+                return inner;
+        }
+        return [{ name, input: typeof payload.input === "string" ? { input: payload.input } : {}, at }];
+    }
+    if (payload.type !== "function_call")
+        return [];
+    if (name === "write_stdin" || name === "sleep")
+        return [];
+    let args = {};
+    if (typeof payload.arguments === "string") {
+        try {
+            args = object(JSON.parse(payload.arguments)) ?? {};
+        }
+        catch { }
+    }
+    if (name === "exec_command")
+        return typeof args.cmd === "string" ? [{ name: "Bash", input: { command: args.cmd }, at }] : [];
+    return [{ name, input: args, at }];
+}
+export function readRecentToolCalls(kind, worker, options = {}) {
+    const path = worker.transcript_path || (kind === "claude" && worker.session_id
+        ? join(transcriptDir(worker.cwd), `${worker.session_id}.jsonl`) : "");
+    if (!path)
+        return { calls: [], truncated: false };
+    const { records, clipped } = tailRead(path);
+    const newestFirst = [];
+    let capped = false;
+    for (const record of records) {
+        const calls = (kind === "claude" ? claudeToolCalls : codexToolCalls)(record, options);
+        for (let i = calls.length - 1; i >= 0; i--) {
+            if (newestFirst.length === RECENT_TOOL_CALLS) {
+                capped = true;
+                break;
+            }
+            newestFirst.push(calls[i]);
+        }
+        if (capped)
+            break;
+    }
+    return { calls: newestFirst.reverse(), truncated: clipped || capped };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmgmyr/hive",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Run a crew of Claude Code and Codex workers from one lead session: visible tmux panes, exact state from hooks, one local SQLite store.",
   "type": "module",
   "bin": {