@cmgmyr/hive 1.9.0 → 1.10.0

package/dist/leadMessageDelivery.js

@@ -0,0 +1,379 @@
+import { join } from "node:path";
+import { dataDir, db } from "./db.js";
+import { CROSS_SESSION_CLOSE, postClaudeWake, senderAddress } from "./claudeWake.js";
+import { harnessFor, paneClassifierFor } from "./harnesses.js";
+import { LEAD_MESSAGE_THRESHOLD, renderLeadMessage, senderTag, shortenedSendNote, storeLeadMessage, } from "./leadMessage.js";
+import { readLeadTurnState } from "./leadState.js";
+import { loadProjectYml } from "./projectYml.js";
+import { currentOwnership, PaneOwnershipLost, paneIdentity, requireStillOwned } from "./spawn.js";
+import { holdsHumanInput, paneInCopyMode, sendText, sleep, TmuxTimeoutError, } from "./tmux.js";
+export const SOCKET_MESSAGE_FOOTER = "Automated hive worker message. Do not reply to this socket sender.";
+export const MESSAGE_STATUS = {
+    socketPending: "socket-pending",
+    fallbackPending: "fallback-pending",
+    fallbackClaimed: "fallback-claimed",
+    complete: "complete",
+    failed: "failed",
+};
+export const MESSAGE_METHOD = {
+    socket: "socket",
+    pty: "pty",
+    ptyAfterSocketTimeout: "pty-after-socket-timeout",
+};
+const PANE_LEASE_TTL_SECONDS = 6;
+const PANE_LEASE_SETTLE_MS = 500;
+const CONFIRM_GRACE_SECONDS = 60;
+const ENVELOPE_OPEN = '<cross-session-message from="';
+const ENVELOPE_SENDER_CLOSE = '" from-name="hive">';
+const EV_PROMPT = "(CASE WHEN json_valid(ev.payload) THEN COALESCE(json_extract(ev.payload, '$.prompt'), '') ELSE ev.payload END)";
+const EV_MARKER = "(agent_messages.sender_tag || '[message #' || agent_messages.id || ',')";
+const EV_HEADER_END = `instr(${EV_PROMPT}, char(10))`;
+// The exact "[hive:worker NAME] [message #N," at prompt offset 0 (typed) or opening hive's own envelope body (socket).
+const messageEvidenceSql = (select) => `
+  SELECT ${select} FROM agent_state_log ev
+   WHERE ev.actor_id = (SELECT a.actor_id FROM agents a WHERE a.id = agent_messages.to_agent_id)
+     AND ev.event = 'prompt'
+     AND ev.created_at >= COALESCE(agent_messages.socket_attempt_at, agent_messages.created_at)
+     AND (substr(${EV_PROMPT}, 1, length(${EV_MARKER})) = ${EV_MARKER}
+          OR (${EV_HEADER_END} > ${ENVELOPE_OPEN.length + ENVELOPE_SENDER_CLOSE.length}
+              AND substr(${EV_PROMPT}, 1, ${ENVELOPE_OPEN.length}) = '${ENVELOPE_OPEN}'
+              AND substr(${EV_PROMPT}, ${EV_HEADER_END} - ${ENVELOPE_SENDER_CLOSE.length}, ${ENVELOPE_SENDER_CLOSE.length}) = '${ENVELOPE_SENDER_CLOSE}'
+              AND instr(substr(${EV_PROMPT}, ${ENVELOPE_OPEN.length + 1}, ${EV_HEADER_END} - ${ENVELOPE_OPEN.length + ENVELOPE_SENDER_CLOSE.length + 1}), '"') = 0
+              AND substr(${EV_PROMPT}, ${EV_HEADER_END} + 1, length(${EV_MARKER})) = ${EV_MARKER}
+              AND instr(${EV_PROMPT}, char(10) || '${CROSS_SESSION_CLOSE}') > ${EV_HEADER_END}))`;
+const RETAINED = "agent_messages.created_at >= datetime('now', '-7 days')";
+function quietMessagingOn(projectId) {
+    const project = db.prepare("SELECT path FROM projects WHERE id = ?").get(projectId);
+    return project !== undefined && loadProjectYml(project.path).config?.quiet_messaging === true;
+}
+function eligible(options) {
+    const { projectId, fromActor, target, submit } = options;
+    if (!submit || target.kind !== "lead" || target.status !== "running" || target.actor_id === fromActor)
+        return false;
+    if (harnessFor(target.command).name !== "claude")
+        return false;
+    const sender = db
+        .prepare("SELECT 1 AS hit FROM agents WHERE project_id = ? AND actor_id = ? AND status = 'running' AND kind = 'agent'")
+        .get(projectId, fromActor);
+    return sender !== undefined && quietMessagingOn(projectId);
+}
+function registeredSocket(target) {
+    return (target.claude_messaging_socket !== "" &&
+        target.claude_messaging_pane_pid !== "" &&
+        target.claude_messaging_pane_pid === target.pane_pid);
+}
+function leadSession(agentId, panePid) {
+    const turn = readLeadTurnState(agentId);
+    return turn !== null && turn.pane_pid === panePid ? turn.session_id : "";
+}
+function readRow(id) {
+    return db.prepare("SELECT * FROM agent_messages WHERE id = ?").get(id);
+}
+function setStatus(id, from, to, fields = {}) {
+    const names = Object.keys(fields);
+    const sets = ["delivery_status = ?", ...names.map((n) => `${n} = ?`)].join(", ");
+    try {
+        return (db
+            .prepare(`UPDATE agent_messages SET ${sets} WHERE id = ? AND delivery_status = ?`)
+            .run(to, ...names.map((n) => fields[n]), id, from).changes === 1);
+    }
+    catch {
+        return false;
+    }
+}
+const NOW = "strftime('%Y-%m-%d %H:%M:%f', 'now')";
+function stamp(id, column) {
+    try {
+        db.prepare(`UPDATE agent_messages SET ${column} = ${NOW} WHERE id = ?`).run(id);
+    }
+    catch {
+    }
+}
+function socketText(id, text, tag) {
+    return `${renderLeadMessage(id, text, tag)}\n\n${SOCKET_MESSAGE_FOOTER}`;
+}
+function acquirePaneLease(row, key) {
+    try {
+        db.prepare("INSERT OR IGNORE INTO actors (id, name, kind) VALUES (?, ?, 'agent')").run(row.from_actor, row.from_name);
+        db.prepare("DELETE FROM leases WHERE project_id = ? AND lock_key = ? AND expires_at < datetime('now')").run(row.project_id, key);
+        const held = db
+            .prepare(`INSERT INTO leases (project_id, lock_key, owner, expires_at)
+         VALUES (?, ?, ?, datetime('now', printf('+%d seconds', ?)))
+         ON CONFLICT(project_id, lock_key) DO NOTHING
+         RETURNING expires_at`)
+            .get(row.project_id, key, row.from_actor, PANE_LEASE_TTL_SECONDS);
+        return held?.expires_at ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function releasePaneLease(row, key, expiresAt) {
+    try {
+        db.prepare("DELETE FROM leases WHERE project_id = ? AND lock_key = ? AND expires_at = ?").run(row.project_id, key, expiresAt);
+    }
+    catch {
+    }
+}
+function hold(row, reason) {
+    try {
+        db.prepare("UPDATE agent_messages SET delivery_note = ? WHERE id = ? AND delivery_status = ?").run(reason, row.id, MESSAGE_STATUS.fallbackPending);
+    }
+    catch {
+    }
+    return { kind: "held", reason };
+}
+function failPending(row, reason) {
+    setStatus(row.id, MESSAGE_STATUS.fallbackPending, MESSAGE_STATUS.failed, { delivery_note: reason });
+    return { kind: "failed", reason };
+}
+function pasteFailure(err, pasted, buffered) {
+    const why = err instanceof Error ? err.message : String(err);
+    if (pasted) {
+        return err instanceof PaneOwnershipLost
+            ? `pasted, then the Enter was withheld because pane ownership was lost: ${why} The text may be on screen unsubmitted.`
+            : `pasted, then the Enter failed: ${why} The text is on screen unsubmitted.`;
+    }
+    if (buffered && err instanceof TmuxTimeoutError)
+        return `the paste timed out, so the text MAY be on screen unsubmitted: ${why}`;
+    return `nothing was pasted: ${why}`;
+}
+// One guarded pane attempt. The claim is the CAS that makes it at most one per message.
+async function paneFallback(row, snapshot) {
+    let identity;
+    try {
+        identity = paneIdentity(JSON.parse(row.target_identity ?? ""));
+    }
+    catch {
+        return failPending(row, "the accepted target identity is unreadable, so no pane can be certified as the lead's");
+    }
+    const target = db.prepare("SELECT kind, command FROM agents WHERE id = ?").get(row.to_agent_id);
+    const ownership = currentOwnership(row.to_agent_id, identity, snapshot);
+    if (ownership === "unknown")
+        return hold(row, "the lead's pane ownership reads unknown");
+    if (ownership !== "live" || target === undefined) {
+        return failPending(row, `the lead pane this message was accepted for is ${ownership}; nothing is typed into a replacement`);
+    }
+    const key = `wake-pane:${identity.tmux_socket}:${identity.tmux_target}`;
+    const expiresAt = acquirePaneLease(row, key);
+    if (expiresAt === null)
+        return hold(row, "another delivery holds the lead's pane");
+    let wrote = false;
+    try {
+        const pane = identity.tmux_target;
+        if (paneInCopyMode(pane) === true)
+            return hold(row, "the lead's pane is in copy mode");
+        const classifier = paneClassifierFor(target.command);
+        if (!classifier)
+            return hold(row, "hive cannot classify the lead's screen");
+        const choice = classifier.choiceCheck(pane).awaitingChoice;
+        if (choice !== false)
+            return hold(row, choice ? "the lead's pane is waiting on a choice" : "the lead's pane could not be read");
+        if (holdsHumanInput(classifier.inputBoxState(pane)))
+            return hold(row, "the lead's input box holds unsubmitted text");
+        const claimed = (() => {
+            try {
+                return (db
+                    .prepare(`UPDATE agent_messages SET delivery_status = ?, fallback_claimed_at = ${NOW}
+                WHERE id = ? AND delivery_status = ? AND NOT EXISTS (${messageEvidenceSql("1")})`)
+                    .run(MESSAGE_STATUS.fallbackClaimed, row.id, MESSAGE_STATUS.fallbackPending).changes === 1);
+            }
+            catch {
+                return false;
+            }
+        })();
+        if (!claimed)
+            return { kind: "settled" };
+        let pasted = false;
+        let buffered = false;
+        wrote = true;
+        try {
+            await sendText(pane, renderLeadMessage(row.id, row.text, row.sender_tag ?? "", row.socket_attempt_at !== null), true, () => {
+                pasted = true;
+                stamp(row.id, "typed_at");
+            }, () => {
+                buffered = true;
+            }, () => requireStillOwned(row.to_agent_id, identity, `message #${row.id} fallback`));
+        }
+        catch (err) {
+            const reason = pasteFailure(err, pasted, buffered);
+            setStatus(row.id, MESSAGE_STATUS.fallbackClaimed, MESSAGE_STATUS.failed, { delivery_note: reason });
+            return { kind: "failed", reason };
+        }
+        setStatus(row.id, MESSAGE_STATUS.fallbackClaimed, MESSAGE_STATUS.complete);
+        return { kind: "typed" };
+    }
+    finally {
+        if (wrote)
+            await sleep(PANE_LEASE_SETTLE_MS);
+        releasePaneLease(row, key, expiresAt);
+    }
+}
+function earlierFallbackPending(row) {
+    return (db
+        .prepare(`SELECT 1 AS hit FROM agent_messages
+          WHERE from_actor = ? AND to_agent_id = ? AND id < ? AND delivery_status = ? AND ${RETAINED}`)
+        .get(row.from_actor, row.to_agent_id, row.id, MESSAGE_STATUS.fallbackPending) !== undefined);
+}
+const DO_NOT_RESEND = "do not resend";
+// null means this send is not eligible, and agent_send's ordinary pane path runs unchanged.
+export async function sendQuietLeadMessage(options) {
+    if (!eligible(options))
+        return null;
+    const { projectId, fromActor, target, text } = options;
+    const identity = paneIdentity(target);
+    const tag = senderTag(projectId, fromActor);
+    const session = leadSession(target.id, target.pane_pid);
+    const { id } = storeLeadMessage(projectId, fromActor, target.id, text);
+    const long = text.length > LEAD_MESSAGE_THRESHOLD;
+    const base = { agent_id: target.id, name: target.name, message_id: id, ...(long ? { shortened: true } : {}) };
+    const shortNote = (channel, redelivered = false) => long ? ` ${shortenedSendNote(id, renderLeadMessage(id, text, tag, redelivered).length, channel)}` : "";
+    const body = socketText(id, text, tag);
+    const skip = !registeredSocket(target)
+        ? "no messaging socket registered for this lead pane"
+        : body.includes(CROSS_SESSION_CLOSE)
+            ? "the text contains the envelope's closing tag"
+            : null;
+    // One statement makes the row visible to the scheduler, already in its route's status.
+    db.prepare(`UPDATE agent_messages SET delivery_status = ?, delivery_method = ?, socket_attempt_at = ${skip === null ? NOW : "NULL"},
+       delivery_note = ?, target_identity = ?, sender_tag = ? WHERE id = ?`).run(skip === null ? MESSAGE_STATUS.socketPending : MESSAGE_STATUS.fallbackPending, skip === null ? MESSAGE_METHOD.socket : MESSAGE_METHOD.pty, skip, JSON.stringify(identity), tag, id);
+    if (skip === null) {
+        const posted = await postClaudeWake({
+            socketPath: target.claude_messaging_socket,
+            senderAddress: senderAddress(join(dataDir, "wake-sender.sock")),
+            text: body,
+            beforeWrite: () => {
+                requireStillOwned(target.id, identity, `message #${id} socket delivery`);
+                const now = db
+                    .prepare(`SELECT a.status, a.kind, a.pane_pid, a.claude_messaging_socket AS socket, a.claude_messaging_pane_pid AS pid,
+                    m.delivery_status
+               FROM agents a, agent_messages m WHERE a.id = ? AND m.id = ?`)
+                    .get(target.id, id);
+                return (now !== undefined &&
+                    now.status === "running" &&
+                    now.kind === "lead" &&
+                    now.socket === target.claude_messaging_socket &&
+                    now.pid === identity.pane_pid &&
+                    now.pane_pid === identity.pane_pid &&
+                    now.delivery_status === MESSAGE_STATUS.socketPending &&
+                    leadSession(target.id, identity.pane_pid) === session);
+            },
+        });
+        if (posted) {
+            return {
+                ...base,
+                sent: true,
+                pending: true,
+                delivery_method: MESSAGE_METHOD.socket,
+                confirmed: false,
+                note: `Posted locally to the lead's messaging socket as message #${id}, awaiting prompt confirmation; ${DO_NOT_RESEND}. ` +
+                    "sent means handed to the transport, not read: if no prompt confirms it, hive types it into the lead's pane once." +
+                    shortNote("socket"),
+            };
+        }
+        setStatus(id, MESSAGE_STATUS.socketPending, MESSAGE_STATUS.fallbackPending, {
+            delivery_method: MESSAGE_METHOD.ptyAfterSocketTimeout,
+            delivery_note: "the socket post failed or timed out",
+        });
+    }
+    const row = readRow(id);
+    const method = (row.delivery_method ?? MESSAGE_METHOD.pty);
+    const outcome = earlierFallbackPending(row)
+        ? hold(row, "an earlier message from this sender to this lead is still awaiting its pane fallback, and this one follows it")
+        : await paneFallback(row);
+    if (outcome.kind === "typed") {
+        const note = shortNote("pane", row.socket_attempt_at !== null).trim();
+        return { ...base, sent: true, pending: false, delivery_method: method, ...(note ? { note } : {}) };
+    }
+    if (outcome.kind === "held") {
+        return {
+            ...base,
+            sent: false,
+            pending: true,
+            delivery_method: method,
+            note: `Not typed yet: ${outcome.reason}. Message #${id} is accepted and stored, and hive retries it from the ` +
+                `scheduler; do NOT resubmit it. agent_message_get(${id}) shows its delivery state.` +
+                shortNote("socket"),
+        };
+    }
+    if (outcome.kind === "settled") {
+        const now = readRow(id);
+        return {
+            ...base,
+            sent: true,
+            pending: now?.delivery_status !== MESSAGE_STATUS.complete,
+            delivery_method: method,
+            confirmed: now?.confirmed_at != null,
+            note: `Message #${id} was settled by another delivery path; ${DO_NOT_RESEND}. agent_message_get(${id}) shows its state.`,
+        };
+    }
+    throw new Error(`[agent_send:quiet-fallback-failed] message #${id} to ${target.name}: ${outcome.reason} hive will not type it again. ` +
+        `Do NOT resend blindly: read the lead's pane first, and agent_message_get(${id}) shows the recorded state.`);
+}
+function graceExpired(row, actorId, panePid) {
+    const firstStop = db
+        .prepare("SELECT MIN(created_at) AS t FROM agent_state_log WHERE actor_id = ? AND event = 'stop' AND created_at >= ?")
+        .get(actorId, row.socket_attempt_at).t;
+    let from = firstStop;
+    if (from === null) {
+        const turn = readLeadTurnState(row.to_agent_id);
+        if (turn !== null && turn.state === "working" && turn.pane_pid === panePid)
+            return false;
+        from = row.socket_attempt_at;
+    }
+    return db.prepare("SELECT (julianday('now') - julianday(?)) * 86400 >= ? AS due").get(from, CONFIRM_GRACE_SECONDS).due === 1;
+}
+function confirmFromPrompts() {
+    db.prepare(`UPDATE agent_messages SET confirmed_at = (${messageEvidenceSql("MIN(ev.created_at)")}), delivery_status = ?
+      WHERE delivery_status IS NOT NULL AND delivery_status != ? AND confirmed_at IS NULL AND ${RETAINED}
+        AND EXISTS (${messageEvidenceSql("1")})`).run(MESSAGE_STATUS.complete, MESSAGE_STATUS.complete);
+}
+function expireGrace() {
+    const pending = db
+        .prepare(`SELECT agent_messages.* FROM agent_messages WHERE delivery_status = ? AND ${RETAINED} ORDER BY id`)
+        .all(MESSAGE_STATUS.socketPending);
+    for (const row of pending) {
+        try {
+            const target = db.prepare("SELECT actor_id FROM agents WHERE id = ?").get(row.to_agent_id);
+            const panePid = JSON.parse(row.target_identity ?? "{}").pane_pid ?? "";
+            if (target === undefined || !graceExpired(row, target.actor_id, panePid))
+                continue;
+            db.prepare(`UPDATE agent_messages SET delivery_status = ?, delivery_method = ?, delivery_note = ?
+          WHERE id = ? AND delivery_status = ? AND NOT EXISTS (${messageEvidenceSql("1")})`).run(MESSAGE_STATUS.fallbackPending, MESSAGE_METHOD.ptyAfterSocketTimeout, "no prompt confirmed the socket post within its grace", row.id, MESSAGE_STATUS.socketPending);
+        }
+        catch {
+        }
+    }
+}
+// Runs inside tick's try; each row's failure is contained so one bad delivery cannot strand the rest.
+export async function retryQuietLeadMessages(snapshot) {
+    try {
+        confirmFromPrompts();
+    }
+    catch {
+    }
+    expireGrace();
+    let due;
+    try {
+        due = db
+            .prepare(`SELECT agent_messages.* FROM agent_messages WHERE delivery_status = ? AND ${RETAINED} ORDER BY id`)
+            .all(MESSAGE_STATUS.fallbackPending);
+    }
+    catch {
+        return;
+    }
+    const blocked = new Set();
+    for (const row of due) {
+        const pair = `${row.from_actor}\u0000${row.to_agent_id}`;
+        if (blocked.has(pair))
+            continue;
+        try {
+            const outcome = await paneFallback(row, snapshot);
+            if (outcome.kind === "held")
+                blocked.add(pair);
+        }
+        catch {
+            blocked.add(pair);
+        }
+    }
+}

package/dist/leadState.js

@@ -3,6 +3,12 @@ import { FIRST_MESSAGE_SHA_ENV, firstMessageDigest } from "./firstMessage.js";
 export function readLeadTurnState(agentId) {
     return db.prepare("SELECT * FROM lead_turn_state WHERE agent_id = ?").get(agentId) ?? null;
 }
+export function leadSessionEnded(row, ownership) {
+    if ((ownership !== "gone" && ownership !== "reissued") || row.pane_pid === "")
+        return null;
+    const turn = readLeadTurnState(row.id);
+    return turn?.last_event === "session_end" && turn.pane_pid === row.pane_pid ? { ended_at: turn.changed_at } : null;
+}
 function isHiveFirstMessage(payload) {
     if (typeof payload.prompt !== "string")
         return false;
@@ -44,7 +50,8 @@ const applyInTransaction = db.transaction((agentId, panePid, event, payload, sub
         cur.pane_pid === next.pane_pid &&
         cur.session_id === next.session_id &&
         cur.state === next.state &&
-        cur.idle_seq === next.idle_seq) {
+        cur.idle_seq === next.idle_seq &&
+        (event !== "session_end" || cur.last_event === "session_end")) {
         return;
     }
     db.prepare(`INSERT INTO lead_turn_state (agent_id, pane_pid, session_id, state, idle_seq, last_event, changed_at)

package/dist/portfolio.js

@@ -3,7 +3,7 @@ import { listProjects } from "./context.js";
 import { existsSync } from "node:fs";
 import { parseTags } from "./result.js";
 import { OPEN_BLOCKERS_SQL } from "./tools/todos.js";
-import { readLeadTurnState } from "./leadState.js";
+import { leadSessionEnded, readLeadTurnState } from "./leadState.js";
 import { liveTargets, ownershipLiveness, rowOwnership } from "./tmux.js";
 export const PORTFOLIO_REASONS = [
     "needs_human",
@@ -88,14 +88,17 @@ function projectRow(project, now, snapshot) {
     const workers = { working: 0, idle: 0, needs_input: 0, other: 0, unreachable: 0, unconfirmed: 0 };
     let liveWorking = 0;
     let liveWaiting = 0;
-    let lead = { state: "none", agent_id: null, turn: "unknown" };
+    let lead = { state: "none", agent_id: null, turn: "unknown", ended_at: null };
     for (const a of agents) {
         if (a.kind === "lead") {
-            const live = liveness(a);
+            const ownership = rowOwnership(a, snapshot);
+            const live = ownershipLiveness(ownership);
+            const ended = leadSessionEnded(a, ownership);
             lead = {
-                state: live === true ? "alive" : live === false ? "dead_pane" : "unknown",
+                state: live === true ? "alive" : live === false ? (ended ? "dormant" : "dead_pane") : "unknown",
                 agent_id: a.id,
                 turn: live === true ? leadTurnFor(a.id, a.pane_pid) : "unknown",
+                ended_at: ended?.ended_at ?? null,
             };
             continue;
         }
@@ -135,7 +138,7 @@ function projectRow(project, now, snapshot) {
     const found = new Set();
     if (tagged.length > 0)
         found.add("needs_human");
-    if (lead.state === "dead_pane" && (todos.in_progress > 0 || wakeCounts.pending > 0))
+    if ((lead.state === "dead_pane" || lead.state === "dormant") && (todos.in_progress > 0 || wakeCounts.pending > 0))
         found.add("dead_lead_pane");
     if (!rootExists && (activeTodos > 0 || wakeCounts.pending > 0))
         found.add("missing_root_with_work");

package/dist/projectYml.js

@@ -18,6 +18,7 @@ export const BUILT_IN_PROJECT_YML = Object.freeze({
     context_checkpoint_percent: null,
     lead_turn_budget: null,
     dashboard: false,
+    lead_sidebar: false,
     quiet_messaging: false,
     vars: Object.freeze({}),
     processes: Object.freeze({}),
@@ -199,6 +200,19 @@ function applyLayer(root, path, source, config, sources, warnings) {
         else
             warn(`dashboard must be true or false; ignoring "${String(value)}".`);
     }
+    if (has("lead_sidebar")) {
+        const value = root.lead_sidebar;
+        if (value == null) {
+            config.lead_sidebar = false;
+            sources.lead_sidebar = source;
+        }
+        else if (typeof value === "boolean") {
+            config.lead_sidebar = value;
+            sources.lead_sidebar = source;
+        }
+        else
+            warn(`lead_sidebar must be true or false; ignoring "${String(value)}".`);
+    }
     if (has("quiet_messaging")) {
         const value = root.quiet_messaging;
         if (value == null) {

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`);
 }