@cmgmyr/hive 1.11.5 → 1.11.7

package/dist/agentKinds.js

@@ -0,0 +1,6 @@
+export const LEAD_KIND = "lead";
+export const LEAD_ACTOR_PREFIX = `${LEAD_KIND}:`;
+export const isLeadActorId = (actorId) => actorId.startsWith(LEAD_ACTOR_PREFIX);
+export const mintLeadActorId = (agentId) => `${LEAD_ACTOR_PREFIX}${agentId}`;
+export const LEAD_NAME = LEAD_KIND;
+export const isReservedAgentName = (name) => name.toLowerCase() === LEAD_NAME;

package/dist/agentRecords.js

@@ -0,0 +1,98 @@
+import { db } from "./db.js";
+import { LEAD_KIND } from "./agentKinds.js";
+import { observationFailed, observeRowOwnership, ownershipLiveness, rowOwnership } from "./tmux.js";
+export const CLOSED_ROW_ORDER = "(parked_at != '') DESC, closed_at DESC, id DESC";
+export function getAgentRow(projectId, id, notFoundHint) {
+    const row = db.prepare("SELECT * FROM agents WHERE project_id = ? AND id = ?").get(projectId, id);
+    if (!row)
+        throw new Error(`No agent ${id} in project ${projectId}. ${notFoundHint}`);
+    return row;
+}
+function closedAgentNamed(projectId, needle) {
+    return db
+        .prepare(`SELECT id, name, kind, parked_at FROM agents WHERE project_id = ? AND status != 'running' ORDER BY ${CLOSED_ROW_ORDER}`)
+        .all(projectId).find((r) => r.name.toLowerCase() === needle);
+}
+export function findAgent(projectId, ref) {
+    if (ref.agent_id != null) {
+        return getAgentRow(projectId, ref.agent_id, "Call agent_list.");
+    }
+    if (ref.name) {
+        const rows = db
+            .prepare("SELECT * FROM agents WHERE project_id = ? AND status = 'running' ORDER BY id")
+            .all(projectId);
+        const exact = rows.filter((r) => r.name === ref.name);
+        if (exact.length === 1)
+            return exact[0];
+        if (exact.length > 1) {
+            throw new Error(`Multiple running agents named "${ref.name}". Target by agent_id instead.`);
+        }
+        const needle = ref.name.toLowerCase();
+        const sameName = rows.filter((r) => r.name.toLowerCase() === needle);
+        if (sameName.length === 1)
+            return sameName[0];
+        const closed = closedAgentNamed(projectId, needle);
+        if (closed) {
+            if (closed.parked_at) {
+                throw new Error(`Agent ${closed.id} ("${closed.name}") is PARKED, not finished - it was paused on ` +
+                    `${closed.parked_at} and its session is waiting. Bring it back with agent_resume(agent_id: ` +
+                    `${closed.id}), or abandon the park with agent_close(agent_id: ${closed.id}).`);
+            }
+            const remedy = closed.kind === LEAD_KIND ? "Run `hive lead` to start a new one" : "Spawn a new worker";
+            throw new Error(`Agent ${closed.id} ("${closed.name}") is closed. ${remedy}, or target a running one by name or agent_id.`);
+        }
+        const partial = rows.filter((r) => r.name.toLowerCase().includes(needle));
+        if (partial.length === 1)
+            return partial[0];
+        if (partial.length > 1) {
+            const candidates = partial.map((r) => `${r.name} (agent_id ${r.id})`).join(", ");
+            throw new Error(`"${ref.name}" matches ${partial.length} running agents: ${candidates}. Use the full name or agent_id.`);
+        }
+        if (/^\d+$/.test(ref.name)) {
+            const id = Number(ref.name);
+            if (Number.isSafeInteger(id)) {
+                const byId = db
+                    .prepare("SELECT * FROM agents WHERE project_id = ? AND id = ? AND status = 'running'")
+                    .get(projectId, id);
+                if (byId)
+                    return byId;
+            }
+        }
+        else if (/^[a-z]+:\d+$/i.test(ref.name)) {
+            const byActorId = db
+                .prepare("SELECT * FROM agents WHERE project_id = ? AND actor_id = ? AND status = 'running'")
+                .get(projectId, ref.name);
+            if (byActorId)
+                return byActorId;
+        }
+        throw new Error(`No running agent matching "${ref.name}" in project ${projectId}. Call agent_list.`);
+    }
+    throw new Error("Pass agent_id or name.");
+}
+export const PROBE_FAILED_NOTE = "tmux could not be probed, so liveness is unknown. Nothing was changed. Retry in a few seconds.";
+const unknownOwnershipNote = (snapshot) => observationFailed(snapshot) ? PROBE_FAILED_NOTE : UNVERIFIED_OWNERSHIP_NOTE;
+export const UNVERIFIED_OWNERSHIP_NOTE = "This row's pane cannot be verified as its own: it is on another tmux socket, or no pane pid was recorded for it, so liveness is unknown and no screen was read. Nothing was changed. If the row is stale, a human or peer lead can retire it with agent_close(row_only=true).";
+export const probeFailed = (agent) => new Error(`Agent ${agent.id} ("${agent.name}"): ${PROBE_FAILED_NOTE}`);
+// A failed probe throws rather than answering unknown, so callers keep the retry wording.
+export function observeOwnership(agent) {
+    const ownership = observeRowOwnership(agent);
+    if (ownership === "probe-failed")
+        throw probeFailed(agent);
+    return ownership;
+}
+export const REISSUED_PANE_NOTE = "Its recorded pane id now belongs to a different process (the recorded pane pid no longer matches), so its own process is gone and the pane is someone else's. Nothing was typed, read or killed there.";
+export function notOwnedError(agent, ownership) {
+    const who = `Agent ${agent.id} ("${agent.name}")`;
+    if (ownership === "gone") {
+        return new Error(`${who} has no live tmux window (its process exited or the window was killed). Close it with agent_close and spawn a new one.`);
+    }
+    if (ownership === "reissued") {
+        return new Error(`${who}: pane ownership reads reissued. ${REISSUED_PANE_NOTE} Close the row with agent_close, which retires it without touching that pane.`);
+    }
+    return new Error(`${who}: pane ownership reads unknown. ${UNVERIFIED_OWNERSHIP_NOTE}`);
+}
+export function summaryLiveness(row, snapshot) {
+    if (row.status !== "running")
+        return false;
+    return ownershipLiveness(rowOwnership(row, snapshot));
+}

package/dist/backup.js

@@ -2,7 +2,7 @@ import SqliteDb from "better-sqlite3";
 import { randomUUID } from "node:crypto";
 import { cpSync, existsSync, mkdirSync, readdirSync, renameSync, rmSync, statSync } from "node:fs";
 import { join } from "node:path";
-import { errorMessage } from "./result.js";
+import { errorMessage } from "./errors.js";
 export const BACKUP_DIRNAME = "backups";
 export function backupsDir(dataDir) {
     return join(dataDir, BACKUP_DIRNAME);

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"1.11.5","sha":"486161d","dirty":false,"build_id":"3a33da919c1ac52f423bfdb530cfeda01207921e9c0fb8b262462fae1c266b12"}
+{"version":"1.11.7","sha":"4861c81","dirty":false,"build_id":"2b159fa2c2519fbd7edef9cf4396ac349c3fb25ec433f76a9b91c5ad98188f43"}

package/dist/claudeWake.js

@@ -1,14 +1,62 @@
 import { createConnection } from "node:net";
+import { join } from "node:path";
+import { db } from "./db.js";
+import { loadProjectYml } from "./projectYml.js";
+export { DELIVERY_METHOD } from "./wakeSql.js";
 export const CROSS_SESSION_CLOSE = "</cross-session-message>";
+export const ENVELOPE_OPEN = '<cross-session-message from="';
+export const ENVELOPE_SENDER_CLOSE = '" from-name="hive">';
 export const SOCKET_WAKE_FOOTER = "Automated hive wake. Do not reply to this sender.";
-const SOCKET_WRITE_BOUND_MS = 1000;
+export const SOCKET_MESSAGE_FOOTER = "Automated hive worker message. Do not reply to this socket sender.";
+export const SOCKET_WRITE_BOUND_MS = 1000;
+export const SOCKET_CONFIRM_GRACE_SECONDS = 60;
 export function senderAddress(socketPath) {
     const encoded = socketPath.replace(/[^A-Za-z0-9/._-]/gu, (c) => [...Buffer.from(c)].map((b) => `%${b.toString(16).toUpperCase().padStart(2, "0")}`).join(""));
     return `uds:${encoded}`;
 }
-function claudeWakeFrame(senderAddress, text) {
-    const content = `<cross-session-message from="${senderAddress}" from-name="hive">\n${text}\n${CROSS_SESSION_CLOSE}`;
-    return JSON.stringify({ type: "user", from: senderAddress, message: { role: "user", content } }) + "\n";
+export function socketSenderAddress(dir) {
+    return senderAddress(join(dir, "wake-sender.sock"));
+}
+function claudeWakeFrame(sender, text) {
+    const content = `${ENVELOPE_OPEN}${sender}${ENVELOPE_SENDER_CLOSE}\n${text}\n${CROSS_SESSION_CLOSE}`;
+    return JSON.stringify({ type: "user", from: sender, message: { role: "user", content } }) + "\n";
+}
+export 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;
+}
+export function promptMarkerEvidenceSql(markerAt) {
+    const evPrompt = "(CASE WHEN json_valid(ev.payload) THEN COALESCE(json_extract(ev.payload, '$.prompt'), '') ELSE ev.payload END)";
+    const headerEnd = `instr(${evPrompt}, char(10))`;
+    return `(${markerAt(evPrompt, "1")}\n               OR (${headerEnd} > ${ENVELOPE_OPEN.length + ENVELOPE_SENDER_CLOSE.length}
+                   AND substr(${evPrompt}, 1, ${ENVELOPE_OPEN.length}) = '${ENVELOPE_OPEN}'
+                   AND substr(${evPrompt}, ${headerEnd} - ${ENVELOPE_SENDER_CLOSE.length}, ${ENVELOPE_SENDER_CLOSE.length}) = '${ENVELOPE_SENDER_CLOSE}'
+                   AND instr(substr(${evPrompt}, ${ENVELOPE_OPEN.length + 1}, ${headerEnd} - ${ENVELOPE_OPEN.length + ENVELOPE_SENDER_CLOSE.length + 1}), '"') = 0
+                   AND ${markerAt(evPrompt, `${headerEnd} + 1`)}
+                   AND instr(${evPrompt}, char(10) || '${CROSS_SESSION_CLOSE}') > ${headerEnd}))`;
+}
+export function hiveWorkerEnvelopeLikeSql(promptSql) {
+    return `(${promptSql} LIKE '${ENVELOPE_OPEN}%${ENVELOPE_SENDER_CLOSE}' || char(10) || '[hive:worker %] [message #%,%' || char(10) || '${CROSS_SESSION_CLOSE}%')`;
+}
+export function isHiveWorkerEnvelope(prompt) {
+    const p = prompt.toLowerCase();
+    const open = ENVELOPE_OPEN.toLowerCase().replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    const senderClose = ENVELOPE_SENDER_CLOSE.toLowerCase().replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    const close = CROSS_SESSION_CLOSE.toLowerCase().replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    return new RegExp(`^${open}[\\s\\S]*${senderClose}\\n\\[hive:worker [\\s\\S]*\\] \\[message #[\\s\\S]*,[\\s\\S]*\\n${close}`).test(p);
+}
+export function socketGraceDue(actorId, attemptAt, panePid, readTurn) {
+    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, attemptAt).t;
+    let from = firstStop;
+    if (from === null) {
+        const turn = readTurn();
+        if (turn !== null && turn.state === "working" && turn.pane_pid === panePid)
+            return false;
+        from = attemptAt;
+    }
+    return db.prepare("SELECT (julianday('now') - julianday(?)) * 86400 >= ? AS due").get(from, SOCKET_CONFIRM_GRACE_SECONDS).due === 1;
 }
 // True only for a completed local write. The socket sends no ack, so true never means the lead read it.
 export function postClaudeWake(options) {

package/dist/cli.js

@@ -23,7 +23,8 @@ import { confirmQueenWrite, listQueenAudit } from "./queenAudit.js";
 import { formatRowCounts, projectRowCounts, removeProject } from "./projectRemove.js";
 import { ensureHooksFile, ensureLeadHooksFile } from "./hooks.js";
 import { errorMessage, registrationNoticeText, withTrailingNewline } from "./result.js";
-import { ACTIVE_TIMER_WHERE, socketAwaitingWhere, dashboardFileContained, describeStall, HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX, HELD_REASON_UNSUBMITTED_INPUT_PREFIX, janitor, resolveDashboardFile, generateQueenDashboardNow, transcriptStaleness, } from "./scheduler.js";
+import { dashboardFileContained, describeStall, janitor, resolveDashboardFile, generateQueenDashboardNow, transcriptStaleness, } from "./scheduler.js";
+import { ACTIVE_TIMER_WHERE, HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX, HELD_REASON_UNSUBMITTED_INPUT_PREFIX, heldWakeWhere, socketAwaitingWhere, } from "./wakeSql.js";
 import { readTurnCount } from "./turnCount.js";
 import { leadSessionEnded } from "./leadState.js";
 import { heldReasonLabel } from "./heldLabel.js";
@@ -47,9 +48,9 @@ import { FIRST_MESSAGE_SHA_ENV, firstMessageDigest } from "./firstMessage.js";
 import { ageSecondsSince, deriveProvenance, describeForHuman, describeLastLogEvent, humanizeAge, lastLogEvent, lastPermissionMode, reportsAgentStateLog, } from "./stateProvenance.js";
 import { awaitingFirstPromptSql } from "./firstPrompt.js";
 import { checkoutRoot, createProfile, forkProfile, PROFILE_FILES, ProfileError, profileExists, profileFileNames, profileNames, profileStatus, readProfileFile, referencedPads, referencedPaths, renderProfileFile, resolveProfileFile, REWRITE_THRESHOLD, templateVars, userProfilesDir, } from "./profiles.js";
-import { getTodoDetail, listTodoSummaries, TODO_STATUSES, } from "./tools/todos.js";
-import { ACTIVE_TODO_SQL, OPEN_BLOCKERS_SQL } from "./todoScope.js";
-import { createPad, getActivePadByName, listActivePads, overwritePadContent, } from "./tools/pads.js";
+import { getTodoDetail, listTodoSummaries, } from "./todos.js";
+import { ACTIVE_TODO_SQL, OPEN_BLOCKERS_SQL, TODO_STATUSES } from "./todoScope.js";
+import { createPad, getActivePadByName, listActivePads, overwritePadContent, } from "./pads.js";
 import { answerQuestion, listQuestions } from "./questions.js";
 function usage() {
     console.log(`hive — run a crew of Claude Code and Codex workers from one lead session
@@ -389,14 +390,11 @@ function reportMigrationResult(result) {
         console.error(`! ${warning}`);
 }
 async function cmdLead(argv) {
-    const unknownFlag = argv.find((a) => a.startsWith("--") && a !== "--no-dashboard" && a !== "--detach");
-    if (unknownFlag !== undefined) {
-        console.error(`hive lead: unknown flag "${unknownFlag}". Flags are --no-dashboard and --detach.`);
-        process.exit(1);
-    }
-    const noDashboard = argv.includes("--no-dashboard");
-    const detach = argv.includes("--detach");
-    const path = argv.find((a) => !a.startsWith("--"));
+    const parsed = parseArgs(argv, { flags: ["--no-dashboard", "--detach"] });
+    rejectUnknownFlags("lead", parsed, "--no-dashboard and --detach");
+    const noDashboard = parsed.flags.has("--no-dashboard");
+    const detach = parsed.flags.has("--detach");
+    const path = parsed.positional[0];
     let registrationNotice = null;
     try {
         const project = resolveProjectForWrite("hive lead", path, (text) => {
@@ -1162,6 +1160,8 @@ function profileSizeAdvisory(name, file) {
 }
 function cmdProfile(argv) {
     const [sub, ...rest] = argv;
+    if (sub?.startsWith("-"))
+        rejectUnknownFlags("profile", parseArgs(argv, {}), "none");
     try {
         switch (sub) {
             case undefined:
@@ -1339,12 +1339,9 @@ function openDashboardOnce(project, dashboardFile) {
     }
 }
 function cmdAttach(argv) {
-    const unknownFlag = argv.find((a) => a.startsWith("--"));
-    if (unknownFlag !== undefined) {
-        console.error(`hive attach: unknown flag "${unknownFlag}". hive attach takes no flags.`);
-        process.exit(1);
-    }
-    const path = argv.find((a) => !a.startsWith("--"));
+    const parsed = parseArgs(argv, {});
+    rejectUnknownFlags("attach", parsed, "none");
+    const path = parsed.positional[0];
     const project = resolveProjectForWrite("hive attach", path);
     maybeOpenDashboard(project, !!loadProjectYml(project.path).config?.dashboard);
     const session = sessionName();
@@ -1495,8 +1492,7 @@ const leadPaneExitedHookArmed = () => globalHooks(LEAD_PANE_EXITED_HOOK).some((e
 function cmdLeadPaneExited(argv) {
     try {
         const parsed = parseArgs(argv, {});
-        if (parsed.unknown.length > 0)
-            return;
+        rejectUnknownFlags("lead-pane-exited", parsed, "none");
         const pane = parsed.positional[0];
         if (!pane)
             return;
@@ -2314,14 +2310,13 @@ function reportEffectiveConfig(loaded) {
             : `${autoAttach} (default; set with \`hive setup --auto-attach\`; source: built-in)`);
 }
 function cmdDoctor(argv) {
-    const strict = argv.includes("--strict");
-    doctorVerbose = argv.includes("--verbose");
-    const KNOWN_DOCTOR_FLAGS = new Set(["--strict", "--verbose"]);
-    const unknown = argv.find((a) => !KNOWN_DOCTOR_FLAGS.has(a));
-    if (unknown !== undefined) {
-        console.error(`hive doctor: unknown argument "${unknown}". Flags are --strict and --verbose.`);
-        process.exit(1);
-    }
+    const parsed = parseArgs(argv, { flags: ["--strict", "--verbose"] });
+    const unexpected = argv.find((arg) => arg !== "--strict" && arg !== "--verbose");
+    if (unexpected !== undefined)
+        parsed.unknown = [unexpected];
+    rejectUnknownFlags("doctor", parsed, "--strict and --verbose");
+    const strict = parsed.flags.has("--strict");
+    doctorVerbose = parsed.flags.has("--verbose");
     reportMigrationResult(migrateLegacyConfig());
     let failures = 0;
     const fail = (label, ...lines) => {
@@ -2800,13 +2795,13 @@ function cmdStatusline() {
     const held = db
         .prepare(`WITH chosen AS (
          SELECT held_reason, first_held_at FROM wakes
-          WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE} AND held_at IS NOT NULL
+          WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE} AND ${heldWakeWhere()}
           ORDER BY (held_reason LIKE ?) DESC, (held_reason LIKE ?) ASC,
                    first_held_at IS NULL ASC, first_held_at ASC
           LIMIT 1
        )
        SELECT
-         (SELECT COUNT(*) FROM wakes WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE} AND held_at IS NOT NULL) AS n,
+         (SELECT COUNT(*) FROM wakes WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE} AND ${heldWakeWhere()}) AS n,
          (SELECT held_reason FROM chosen) AS held_reason,
          (SELECT first_held_at FROM chosen) AS first_held_at`)
         .get(project.id, `${HELD_REASON_UNSUBMITTED_INPUT_PREFIX}%`, `${HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX}%`, project.id);
@@ -3255,11 +3250,26 @@ function requireFlagValues(command, parsed) {
     process.exit(1);
 }
 function cmdTodos(argv) {
+    const parsed = parseArgs(argv, { flags: ["--all"], valued: ["--status", "--tag"] });
+    for (const flag of ["--status", "--tag"]) {
+        const index = argv.indexOf(flag);
+        const value = index === -1 ? undefined : argv[index + 1];
+        if (index === -1 || (value !== undefined && !value.startsWith("--")))
+            continue;
+        if (flag === "--status") {
+            console.log(`Usage: hive todos --status <s>  where <s> is one of: ${TODO_STATUSES.join(", ")}`);
+        }
+        else {
+            console.log("Usage: hive todos --tag <t>");
+        }
+        process.exit(1);
+    }
+    rejectUnknownFlags("todos", parsed, "--all, --status <status>, --tag <tag>");
+    requireFlagValues("todos", parsed);
     const project = resolveProjectForRead("todos");
-    const all = argv.includes("--all");
-    const statusIdx = argv.indexOf("--status");
-    const status = flagValue(argv, "--status");
-    if (statusIdx !== -1 && (status === undefined || status.startsWith("--"))) {
+    const all = parsed.flags.has("--all");
+    const status = parsed.values.get("--status");
+    if (parsed.values.has("--status") && status === undefined) {
         console.log(`Usage: hive todos --status <s>  where <s> is one of: ${TODO_STATUSES.join(", ")}`);
         process.exit(1);
     }
@@ -3267,9 +3277,8 @@ function cmdTodos(argv) {
         console.log(`Unknown status "${status}". Valid: ${TODO_STATUSES.join(", ")}`);
         process.exit(1);
     }
-    const tagIdx = argv.indexOf("--tag");
-    const tag = flagValue(argv, "--tag");
-    if (tagIdx !== -1 && (tag === undefined || tag.startsWith("--"))) {
+    const tag = parsed.values.get("--tag");
+    if (parsed.values.has("--tag") && tag === undefined) {
         console.log("Usage: hive todos --tag <t>");
         process.exit(1);
     }
@@ -3299,8 +3308,10 @@ function cmdTodos(argv) {
     }
 }
 function cmdTodo(argv) {
+    const parsed = parseArgs(argv, {});
+    rejectUnknownFlags("todo", parsed, "none");
     const project = resolveProjectForRead("todo");
-    const id = Number(argv.find((a) => !a.startsWith("--")));
+    const id = Number(parsed.positional[0]);
     if (!Number.isInteger(id)) {
         console.log("Usage: hive todo <id>  (run inside the project)");
         process.exit(1);
@@ -3504,6 +3515,8 @@ let rest = args.slice(1);
 if (command === "--help" || command === "-h" || command === "help")
     usage();
 if (command === "--version" || command === "-v") {
+    const parsed = parseArgs(rest, { flags: ["--check"] });
+    rejectUnknownFlags("version", parsed, "--check");
     const { line, drift } = versionInfo();
     console.log(line);
     if (drift)
@@ -3583,6 +3596,7 @@ try {
             cmdHide(rest);
             break;
         case "status":
+            rejectUnknownFlags("status", parseArgs(rest, {}), "none");
             cmdStatus();
             break;
         case "portfolio":
@@ -3607,6 +3621,7 @@ try {
             cmdDoctor(rest);
             break;
         case "pads":
+            rejectUnknownFlags("pads", parseArgs(rest, {}), "none");
             cmdPads();
             break;
         case "pad":
@@ -3625,6 +3640,7 @@ try {
             cmdAnswer(rest);
             break;
         case "backups":
+            rejectUnknownFlags("backups", parseArgs(rest, {}), "none");
             cmdBackups();
             break;
         case "restore":
@@ -3633,19 +3649,29 @@ try {
         case "project":
             await cmdProject(rest);
             break;
-        case "runbook":
-            cmdRunbook(rest[0]);
+        case "runbook": {
+            const parsed = parseArgs(rest, {});
+            rejectUnknownFlags("runbook", parsed, "none");
+            cmdRunbook(parsed.positional[0]);
             break;
-        case "posture":
-            cmdPosture(rest[0]);
+        }
+        case "posture": {
+            const parsed = parseArgs(rest, {});
+            rejectUnknownFlags("posture", parsed, "none");
+            cmdPosture(parsed.positional[0]);
             break;
+        }
         case "profile":
             cmdProfile(rest);
             break;
-        case "kickoff":
+        case "kickoff": {
+            const parsed = parseArgs(rest, { flags: ["--explain", "--codex"] });
+            rejectUnknownFlags("kickoff", parsed, "--explain, --codex");
             await (await import("./kickoff.js")).runKickoff(rest);
             break;
+        }
         case "statusline":
+            rejectUnknownFlags("statusline", parseArgs(rest, {}), "none");
             cmdStatusline();
             break;
         default:

package/dist/context.js

@@ -3,9 +3,9 @@ import { userInfo } from "node:os";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { storeDir } from "./dataDir.js";
 import { db } from "./db.js";
-import { LEAD_KIND } from "./spawn.js";
+import { LEAD_KIND } from "./agentKinds.js";
 import { rowOwnership } from "./tmux.js";
-import { recordQueenRefusal } from "./queenAudit.js";
+import { recordQueenRefusal } from "./queenAuditStore.js";
 import { gitOut } from "./git.js";
 let selectedId = null;
 let cachedActorId = null;

package/dist/crew.js

@@ -1,6 +1,7 @@
+import { parseStoreTimestamp } from "./storeClock.js";
 import { db } from "./db.js";
 import { isLinkedWorktree } from "./context.js";
-import { awaitingFirstPrompt } from "./firstPrompt.js";
+import { finishedIdle } from "./firstPrompt.js";
 import { heldReasonLabel } from "./heldLabel.js";
 import { harnessFor, paneClassifierFor } from "./harnesses.js";
 import { NEEDS_HUMAN_TAG } from "./portfolio.js";
@@ -8,7 +9,7 @@ import { ACTIVE_TODO_SQL } from "./todoScope.js";
 import { pendingQuestionCount } from "./questions.js";
 import { loadProjectYml } from "./projectYml.js";
 import { parseTags } from "./result.js";
-import { ACTIVE_TIMER_WHERE } from "./scheduler.js";
+import { ACTIVE_TIMER_WHERE } from "./wakeSql.js";
 import { reportsAgentStateLog } from "./stateProvenance.js";
 import { gitOut } from "./git.js";
 import { liveTargets, rowOwnership } from "./tmux.js";
@@ -29,7 +30,7 @@ export function crewStoreProblem(database = db) {
 function isoUtc(value) {
     if (!value)
         return null;
-    const date = new Date(/(Z|[+-]\d\d:?\d\d)$/.test(value) ? value : `${value.replace(" ", "T")}Z`);
+    const date = new Date(parseStoreTimestamp(value));
     return Number.isNaN(date.getTime()) ? null : date.toISOString();
 }
 const WAKE_LABEL_MAX = 60;
@@ -452,7 +453,7 @@ export function collectCrew(project, now) {
                 age_seconds: Math.max(0, Math.floor((now.getTime() - Date.parse(isoUtc(row.created_at) ?? "")) / 1000) || 0),
                 activity,
                 context_fill: kind ? readContextFill(kind, worker) : null,
-                your_turn: row.agent_state === "idle" && !awaitingFirstPrompt(row),
+                your_turn: finishedIdle(row),
                 commits_ahead: commitsByCwd.get(row.cwd) ?? null,
             },
         });

package/dist/dashboard.js

@@ -1,8 +1,10 @@
 import { createHash } from "node:crypto";
-import { createRequire } from "node:module";
+import { listQuestions, pendingQuestionCount } from "./questions.js";
+import { ACTIVE_TIMER_WHERE } from "./wakeSql.js";
 import { db } from "./db.js";
 import { ACTIVE_TODO_SQL, NOT_COMPLETED_TODO_SQL, OPEN_BLOCKERS_SQL } from "./todoScope.js";
 import { getProject } from "./context.js";
+import { parseStoreTimestamp } from "./storeClock.js";
 export const describeVisibility = (visibility) => visibility === null ? "running" : visibility === "window" ? "own window" : visibility;
 export function processCounts(procs) {
     return {
@@ -12,9 +14,8 @@ export function processCounts(procs) {
         notStarted: procs.filter((p) => !p.running).length,
     };
 }
-import { awaitingFirstPrompt } from "./firstPrompt.js";
+import { finishedIdle } from "./firstPrompt.js";
 import { SLUG_MAX_LEN, cutToUnitBudget } from "./slug.js";
-const requireFromHere = createRequire(import.meta.url);
 export const TODO_CAP = 100;
 export const AGENT_CAP = 50;
 export const WAKE_CAP = 50;
@@ -55,7 +56,7 @@ function formatDate(d) {
 export function formatLocal(utc) {
     if (!utc)
         return "-";
-    const d = new Date(`${utc.replace(" ", "T")}Z`);
+    const d = new Date(parseStoreTimestamp(utc));
     if (Number.isNaN(d.getTime()))
         return utc;
     return formatDate(d);
@@ -70,7 +71,7 @@ function timeEl(utc) {
 function shortWhenEl(utc) {
     if (!utc)
         return '<span class="muted">-</span>';
-    const d = new Date(`${utc.replace(" ", "T")}Z`);
+    const d = new Date(parseStoreTimestamp(utc));
     if (Number.isNaN(d.getTime()))
         return `<span class="time">${escapeHtml(utc)}</span>`;
     const local = formatDate(d);
@@ -87,7 +88,6 @@ function fetchProject(projectId) {
         throw new Error(`No project ${projectId}.`);
     return row;
 }
-const PENDING_WAKE_WHERE = "cancelled_at IS NULL AND (fired_at IS NULL OR repeat_every_ms IS NOT NULL)";
 function agentStatusLevel(state) {
     if (state === "working")
         return "live";
@@ -98,7 +98,7 @@ function agentStatusLevel(state) {
     return "warn";
 }
 function agentStateBadge(a) {
-    return awaitingFirstPrompt(a) && a.agent_state === "idle"
+    return a.agent_state === "idle" && !finishedIdle(a)
         ? statusBadge("live", "idle (no assignment yet)")
         : statusBadge(agentStatusLevel(a.agent_state), a.agent_state);
 }
@@ -121,7 +121,7 @@ function fetchNowAgents(projectId) {
 function fetchNextWake(projectId) {
     return db
         .prepare(`SELECT kind, due_at, max_wait_at, deliver_actor FROM wakes
-       WHERE project_id = ? AND ${PENDING_WAKE_WHERE}
+       WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE}
        ORDER BY COALESCE(due_at, max_wait_at, created_at) LIMIT 1`)
         .get(projectId);
 }
@@ -428,7 +428,7 @@ function renderThroughputSection(index, stats) {
 function renderWakesSection(index, projectId) {
     const all = db
         .prepare(`SELECT id, kind, body, owner, deliver_actor, due_at, max_wait_at, fire_count, repeat_every_ms, held_at
-       FROM wakes WHERE project_id = ? AND ${PENDING_WAKE_WHERE}
+       FROM wakes WHERE project_id = ? AND ${ACTIVE_TIMER_WHERE}
        ORDER BY COALESCE(due_at, max_wait_at, created_at)`)
         .all(projectId);
     const shown = all.slice(0, WAKE_CAP);
@@ -449,7 +449,7 @@ function renderWakesSection(index, projectId) {
     return section(index, "wakes", "Wakes", `${all.length} pending`, "bell", String(shown.length), body);
 }
 function questionAge(createdAt) {
-    const timestamp = Date.parse(`${createdAt.replace(" ", "T")}Z`);
+    const timestamp = parseStoreTimestamp(createdAt);
     if (!Number.isFinite(timestamp))
         return "unknown";
     const seconds = Math.max(0, Math.floor((Date.now() - timestamp) / 1000));
@@ -462,8 +462,6 @@ function questionAge(createdAt) {
     return "now";
 }
 function renderQuestionsSection(index, projectId) {
-    // A static import of questions.js cycles through tools/wakes.ts and scheduler.ts.
-    const { listQuestions, pendingQuestionCount } = requireFromHere("./questions.js");
     const questions = listQuestions(projectId);
     if (questions.length === 0)
         return "";

package/dist/db.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { guardAbi } from "./abi.js";
 import { guardStoreDir } from "./dataDir.js";
 import { maybeBackupBeforeMigrations } from "./backup.js";
-import { errorMessage } from "./result.js";
+import { errorMessage } from "./errors.js";
 export const dataDir = guardStoreDir();
 mkdirSync(dataDir, { recursive: true });
 function sleepSync(ms) {

package/dist/errors.js

@@ -0,0 +1,3 @@
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}

package/dist/etime.js

@@ -0,0 +1,37 @@
+export function parseEtimeSeconds(value) {
+    const dayForm = /^(\d+)-(\d{1,2}):(\d{2}):(\d{2})$/.exec(value);
+    const digitForm = /^(\d+)$/.exec(value);
+    const fields = dayForm ? dayForm.slice(1).map(Number) : value.split(":").map(Number);
+    if (!dayForm &&
+        !digitForm &&
+        ((fields.length === 2 && !/^\d+:\d+$/.test(value)) ||
+            (fields.length === 3 && !/^\d+:\d+:\d+$/.test(value)) ||
+            (fields.length !== 2 && fields.length !== 3))) {
+        return null;
+    }
+    if (fields.some((field) => !Number.isSafeInteger(field) || field < 0))
+        return null;
+    let total;
+    if (digitForm) {
+        total = fields[0];
+    }
+    else if (dayForm) {
+        const [days, hours, minutes, seconds] = fields;
+        if (hours > 23 || minutes > 59 || seconds > 59)
+            return null;
+        total = ((days * 24 + hours) * 60 + minutes) * 60 + seconds;
+    }
+    else if (fields.length === 2) {
+        const [minutes, seconds] = fields;
+        if (seconds > 59)
+            return null;
+        total = minutes * 60 + seconds;
+    }
+    else {
+        const [hours, minutes, seconds] = fields;
+        if (minutes > 59 || seconds > 59)
+            return null;
+        total = (hours * 60 + minutes) * 60 + seconds;
+    }
+    return Number.isSafeInteger(total) ? total : null;
+}

package/dist/firstPrompt.js

@@ -4,3 +4,9 @@ export function awaitingFirstPrompt(row) {
 export function awaitingFirstPromptSql(alias) {
     return `${alias}.resumed_at != ''`;
 }
+export function finishedIdle(row) {
+    return row.agent_state === "idle" && !awaitingFirstPrompt(row);
+}
+export function finishedIdleSql(alias) {
+    return `${alias}.agent_state = 'idle' AND NOT (${awaitingFirstPromptSql(alias)})`;
+}

package/dist/globalConfig.js

@@ -3,7 +3,7 @@ import { chmodSync, closeSync, lstatSync, mkdirSync, openSync, readFileSync, ren
 import { basename, dirname, join } from "node:path";
 import { isMap, parse, parseDocument } from "yaml";
 import { storeDir } from "./dataDir.js";
-import { errorMessage } from "./result.js";
+import { errorMessage } from "./errors.js";
 export const ATTACH_MODES = ["auto", "raw", "control"];
 export const AUTO_ATTACH_MODES = ["auto", "on", "off"];
 export function isAttachMode(value) {

package/dist/heldLabel.js

@@ -1,4 +1,4 @@
-import { HELD_REASON_CONVERSATION, HELD_REASON_LEAD_PANE_DEAD, isLeadRowClosedHold, isUnclassifiablePaneHold, isUnsubmittedInputHold, wasHeldForPaneIdentity, } from "./scheduler.js";
+import { HELD_REASON_CONVERSATION, HELD_REASON_LEAD_PANE_DEAD, isLeadRowClosedHold, isUnclassifiablePaneHold, isUnsubmittedInputHold, wasHeldForPaneIdentity, } from "./wakeSql.js";
 // test/docs.test.mjs fails if a label here is missing from docs/install.md. It checks
 // presence only: docs/install.md also counts the set in prose, and nothing guards that number.
 export const HELD_REASON_LABELS = ["typing", "talking", "needs you", "blocked"];