@cmgmyr/hive 1.4.0 → 1.5.0

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"1.4.0","sha":"0bea55d","dirty":false,"build_id":"9dcef67c-6f6f-4f48-88a1-116efaa27142"}
+{"version":"1.5.0","sha":"c050e7f","dirty":false,"build_id":"56840ccc-881f-49ae-bbc4-440224077976"}

package/dist/cli.js

@@ -19,6 +19,7 @@ import { checkoutUpgradeSteps, detectInstallShape, globalUpgradeSteps } from "./
 import { isLowHeadroom, orphanLoginShellDetails, ptyHeadroom } from "./ptys.js";
 import { addProject, agentProjectPin, assertQueenCrossProjectWrite, captureQueenWriteIdentity, currentActor, effectiveProjectId, findProjectForCwd, findProjectForDir, getProjectByPath, gitPrimaryRoot, getProject, listProjects, QUEEN_PROFILE, queenHomeDir, registeredAncestor, takeRegistrationNotice, } from "./context.js";
 import { confirmQueenWrite, listQueenAudit } from "./queenAudit.js";
+import { formatRowCounts, projectRowCounts, removeProject } from "./projectRemove.js";
 import { ensureHooksFile } from "./hooks.js";
 import { errorMessage, registrationNoticeText, withTrailingNewline } from "./result.js";
 import { ACTIVE_TIMER_WHERE, dashboardFileContained, describeStall, HELD_REASON_CONVERSATION, HELD_REASON_LEAD_PANE_DEAD, HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX, isUnclassifiablePaneHold, HELD_REASON_UNSUBMITTED_INPUT_PREFIX, isUnsubmittedInputHold, janitor, resolveDashboardFile, generateQueenDashboardNow, transcriptStaleness, wasHeldForPaneReissue, } from "./scheduler.js";
@@ -95,6 +96,9 @@ Usage:
   hive todo <id>             print one todo in full, comments included
   hive backups               list automatic store snapshots
   hive restore <name> [--yes] [--force]  overwrite the live store from a snapshot
+  hive project rm <id|path> [--yes]
+                             remove another project and everything it owns,
+                             after a snapshot; never the one you are in
   hive runbook               this project's standing process, vars resolved
   hive posture               the posture text this project's lead starts with
   hive kickoff [--explain]   SessionStart hook output; silent unless this is a lead checkout
@@ -1877,7 +1881,7 @@ function reportProjectScope(here) {
         if (locked && project.id !== here?.id)
             continue;
         if (project.path === homePath || project.path === "/") {
-            warn("project scope", `"${project.name}" (${project.path}) is a home directory; every unregistered directory under it resolves to this project. The project_prune tool with this project's id (from any hive session) removes it once it holds nothing.`);
+            warn("project scope", `"${project.name}" (${project.path}) is a home directory; every unregistered directory under it resolves to this project. The project_prune tool with this project's id (from an unlocked session in another project) removes it once it holds nothing.`);
         }
     }
     for (const parent of projects) {
@@ -2887,6 +2891,57 @@ function cmdPortfolio(argv) {
     const l = report.totals.lanes;
     console.log(`\n${report.totals.projects} project(s): ${l.waiting_on_you} waiting on you, ${l.stuck} stuck, ${l.moving} moving, ${l.quiet} quiet`);
 }
+async function cmdProject(argv) {
+    const parsed = parseArgs(argv, { flags: ["--yes", "-y"] });
+    rejectUnknownFlags("project", parsed, "--yes/-y");
+    const [verb, ref] = parsed.positional;
+    if (verb !== "rm" || !ref || parsed.positional.length > 2) {
+        console.log("Usage: hive project rm <id|path> [--yes]");
+        process.exit(1);
+    }
+    if (process.env.HIVE_PROJECT_LOCK === "1" || agentProjectPin() != null) {
+        console.log("hive project rm: this session is locked to one project (HIVE_PROJECT_LOCK=1) and cannot remove projects.");
+        process.exit(1);
+    }
+    let target;
+    if (/^\d+$/.test(ref))
+        target = getProject(Number(ref));
+    else
+        target = getProjectByPath(ref) ?? getProjectByPath(canonicalPath(ref));
+    if (!target) {
+        console.log(`hive project rm: "${ref}" is not a registered project id or exact registered path. List them with the project_list tool.`);
+        process.exit(1);
+    }
+    if (findProjectForCwd()?.id === target.id) {
+        console.log(`hive project rm: project ${target.id} ("${target.name}") is the one this directory belongs to and is never removed from itself. Run it from another project.`);
+        process.exit(1);
+    }
+    assertQueenCrossProjectWrite("hive project rm", target.id, {});
+    const counts = projectRowCounts(target.id);
+    console.log(`Project ${target.id}: "${target.name}" (${target.path})`);
+    console.log(Object.keys(counts).length > 0 ? `It owns ${formatRowCounts(counts)}.` : "It owns no rows.");
+    console.log("A snapshot of the store is taken first. Restore it with: hive restore <name>");
+    if (!parsed.flags.has("--yes") && !parsed.flags.has("-y")) {
+        const confirmed = await confirmYesNo("Remove this project and everything it owns? [y/N] ");
+        if (confirmed === null) {
+            console.log("Not removed: run hive interactively to confirm, or pass --yes.");
+            process.exit(1);
+        }
+        if (!confirmed) {
+            console.log("Not removed.");
+            process.exit(1);
+        }
+    }
+    const removed = removeProject(target.id, {
+        snapshot: true,
+        onRemoved: (r) => confirmQueenWrite("hive project rm", r.deleted.id, {}, { project_id: r.deleted.id, name: r.deleted.name, counts: r.counts }),
+    });
+    console.log(`Removed project ${removed.deleted.id} ("${removed.deleted.name}").`);
+    if (Object.keys(removed.counts).length > 0)
+        console.log(`Deleted ${formatRowCounts(removed.counts)}.`);
+    console.log(`Snapshot: ${removed.snapshot}`);
+    console.log("Its actors and any files it left on disk are untouched; actor_prune removes inert actors.");
+}
 function cmdBackups() {
     const snapshots = listSnapshots(dataDir);
     if (snapshots.length === 0) {
@@ -3259,7 +3314,7 @@ if (command === "--version" || command === "-v") {
 const COMMANDS = [
     "lead", "queen", "queen-audit", "init", "attach", "start", "stop", "show", "hide", "status", "portfolio", "next", "setup", "upgrade", "doctor",
     LEAD_PANE_EXITED_VERB,
-    "pads", "pad", "todos", "todo", "backups", "restore", "runbook", "posture", "profile", "kickoff", "statusline",
+    "pads", "pad", "todos", "todo", "backups", "restore", "project", "runbook", "posture", "profile", "kickoff", "statusline",
 ];
 if (!COMMANDS.includes(command)) {
     if (command.startsWith("--")) {
@@ -3344,6 +3399,9 @@ try {
         case "restore":
             await cmdRestore(rest);
             break;
+        case "project":
+            await cmdProject(rest);
+            break;
         case "runbook":
             cmdRunbook(rest[0]);
             break;

package/dist/context.js

@@ -339,10 +339,11 @@ export const QUEEN_REACH = {
     agent_close: "home",
     project_select: "select",
     project_add: "global",
-    project_prune: "global",
+    project_prune: "prune",
     actor_prune: "global",
     "hive lead": "spin_up",
     "hive queen-audit": "read",
+    "hive project rm": "prune",
     "hive init": "home",
     "hive attach": "home",
     "hive next": "home",
@@ -365,6 +366,7 @@ function foreignWriteProblem(reach, targetProjectId, args) {
     switch (reach) {
         case "spin_up":
         case "todo":
+        case "prune":
             return null;
         case "lead_wake": {
             if (args.scope !== undefined)
@@ -440,6 +442,6 @@ function queenRefusal(operation, targetProjectId, problem) {
     const target = targetProjectId === null ? null : getProject(targetProjectId);
     const where = target ? `in project ${target.id} ("${target.name}")` : "outside the queen's own project";
     return new Error(`${QUEEN_REFUSAL}: the queen cannot run ${operation} ${where}: ${problem}. Into another project the ` +
-        "queen may only todo_create, todo_comment, send text or wakes to its running lead, and start its lead " +
-        "with `hive lead <path>`. Everything else there is its lead's to do.");
+        "queen may only todo_create, todo_comment, send text or wakes to its running lead, start its lead " +
+        "with `hive lead <path>`, and run project_prune or `hive project rm` on it. Everything else there is its lead's to do.");
 }

package/dist/help.js

@@ -252,10 +252,13 @@ Every pad, todo, kv entry, and lease belongs to one project (a directory).
   project_list — all registered projects plus the current selection
   project_add(path?, name?) — register a directory (defaults to cwd)
   project_select(project_id) — set this session's default scope
-  project_prune() — delete every registered project that owns no rows
+  project_prune(project_id?, confirm_name?) — delete every registered project that owns no rows
     anywhere in the store, verified individually; never your own; refuses
     under HIVE_PROJECT_LOCK=1 since it sweeps every project, not just yours.
-    With project_id, removes only that project, and only if it owns no rows
+    With project_id, removes only that project, and only if it owns no rows.
+    With project_id and confirm_name (its exact name), removes it with every
+    row it owns after a snapshot; refuses while it has a running agent. From a
+    terminal: hive project rm <id|path> [--yes].
 
 Resolution order: explicit project_id argument, then session selection, then
 working-directory auto-detection. When the working directory matches no

package/dist/projectRemove.js

@@ -0,0 +1,68 @@
+import { backupNow } from "./backup.js";
+import { dataDir, db } from "./db.js";
+export const PROJECT_OWNER_TABLES = [
+    "pads",
+    "todos",
+    "kv",
+    "leases",
+    "agents",
+    "wakes",
+    "command_trust",
+];
+const COUNTED_TABLES = [
+    ...PROJECT_OWNER_TABLES.map((t) => [t, `SELECT COUNT(*) AS n FROM ${t} WHERE project_id = ?`]),
+    ["todo_comments", "SELECT COUNT(*) AS n FROM todo_comments WHERE todo_id IN (SELECT id FROM todos WHERE project_id = ?)"],
+    ["agent_messages", "SELECT COUNT(*) AS n FROM agent_messages WHERE project_id = ?"],
+];
+export function projectRowCounts(projectId) {
+    const counts = {};
+    for (const [table, sql] of COUNTED_TABLES) {
+        const n = db.prepare(sql).get(projectId).n;
+        if (n > 0)
+            counts[table] = n;
+    }
+    return counts;
+}
+export function formatRowCounts(counts) {
+    return Object.entries(counts)
+        .map(([table, n]) => `${table}: ${n}`)
+        .join(", ");
+}
+function assertNoRunningAgents(projectId, name) {
+    const running = db
+        .prepare("SELECT id, name FROM agents WHERE project_id = ? AND status = 'running' ORDER BY id")
+        .all(projectId);
+    if (running.length === 0)
+        return;
+    const names = running.map((a) => `${a.name} (agent ${a.id})`).join(", ");
+    throw new Error(`project ${projectId} ("${name}") has running agents: ${names}. Nothing deleted. Run hive doctor to close rows whose panes are gone, or agent_close them.`);
+}
+const deleteProjectRows = db.transaction((projectId, name, expected, after) => {
+    assertNoRunningAgents(projectId, name);
+    if (JSON.stringify(projectRowCounts(projectId)) !== JSON.stringify(expected)) {
+        throw new Error(`project ${projectId} ("${name}") changed while the snapshot was taken; nothing removed, run it again.`);
+    }
+    db.prepare("DELETE FROM agent_messages WHERE project_id = ?").run(projectId);
+    if (db.prepare("DELETE FROM projects WHERE id = ?").run(projectId).changes === 0) {
+        throw new Error(`no project ${projectId}.`);
+    }
+    after();
+});
+export function removeProject(projectId, opts) {
+    const target = db.prepare("SELECT id, name, path FROM projects WHERE id = ?").get(projectId);
+    if (!target)
+        throw new Error(`no project ${projectId}.`);
+    assertNoRunningAgents(projectId, target.name);
+    const counts = projectRowCounts(projectId);
+    let snapshot = null;
+    if (opts.snapshot) {
+        const result = backupNow(db, dataDir, "manual");
+        if (!result.ok)
+            throw new Error(`could not snapshot the store first, nothing deleted: ${result.error ?? "unknown error"}`);
+        snapshot = result.path ?? null;
+    }
+    opts.afterSnapshot?.();
+    const removed = { deleted: { id: target.id, name: target.name, path: target.path }, counts, snapshot };
+    deleteProjectRows.immediate(projectId, target.name, counts, () => opts.onRemoved?.(removed));
+    return removed;
+}

package/dist/queenAudit.js

@@ -9,6 +9,10 @@ export const QUEEN_AUDIT_MAX_ROWS = 20_000;
 function resource(type, value) {
     return typeof value === "number" && Number.isInteger(value) && value > 0 ? { type, id: value } : null;
 }
+function removalSummary(r) {
+    const counts = Object.entries((r.counts ?? {})).map(([t, n]) => `${t} ${n}`);
+    return `removed project "${r.name}"${counts.length > 0 ? ` with ${counts.join(", ")}` : ""}`;
+}
 export const QUEEN_AUDIT_OPERATIONS = {
     todo_create: {
         mode: "database",
@@ -45,6 +49,16 @@ export const QUEEN_AUDIT_OPERATIONS = {
         resource: (r) => r.sent === true ? resource("agent", r.agent_id) : null,
         summary: (a, r) => `agent #${r.agent_id} ${a.submit === false ? "pasted without submit" : "submitted"}: ${a.text}`,
     },
+    project_prune: {
+        mode: "database",
+        resource: (r) => resource("project", r.project_id),
+        summary: (_a, r) => removalSummary(r),
+    },
+    "hive project rm": {
+        mode: "database",
+        resource: (r) => resource("project", r.project_id),
+        summary: (_a, r) => removalSummary(r),
+    },
     "hive lead": {
         mode: "external",
         resource: (r) => r.disposition === "started" || r.disposition === "adopted" ? resource("agent", r.agent_id) : null,

package/dist/tmux.js

@@ -1018,7 +1018,8 @@ export function paneChoiceCheck(target) {
 // codex has no box border to anchor on, so the box's bottom edge used to be inferred from the literal
 // text of its footer status line - but that text is not stable (todo 524: two different compositions
 // seen on one codex version, one with no shared substring at all). The anchor below reads structure
-// instead of content: the pane's own last non-blank row IS the bottom edge, whatever it says.
+// instead of content: the pane's own last non-blank row IS the bottom edge, whatever it says, except that a
+// "? for shortcuts" row or a right-aligned footer row pulls the edge up to the status row above it.
 // codex's own choice-menu shape (see hive-internals), not claude's CHOICE_DIALOG wording. Declared
 // above findCodexPromptBox because the box search itself now needs it to reject a choice row rather
 // than mistake it for a live prompt.
@@ -1037,6 +1038,7 @@ function codexPromptContentStart(promptRow) {
         i += 1;
     return i;
 }
+const CODEX_SHORTCUTS_ROW = /^\?\s+for shortcuts/;
 function findCodexPromptBox(rows) {
     const text = rows.map((row) => stripControlBytes(stripSgr(row)).trim());
     let footer = text.length - 1;
@@ -1044,6 +1046,17 @@ function findCodexPromptBox(rows) {
         footer -= 1;
     if (footer < 0)
         return null;
+    // The row directly above "? for shortcuts" starts one footer block if it has codex's " · " status separator.
+    if (CODEX_SHORTCUTS_ROW.test(text[footer]) && footer > 0 && text[footer - 1].includes(" · "))
+        footer -= 1;
+    else if (footer > 0 && text[footer - 1].includes(" · ")) {
+        const footerRow = stripControlBytes(stripSgr(rows[footer]));
+        const footerContent = footerRow.trim();
+        const leadingWhitespace = footerRow.length - footerRow.trimStart().length;
+        // Use the row's geometry so this remains independent of whatever Codex writes in its footer.
+        if (leadingWhitespace > footerContent.length)
+            footer -= 1;
+    }
     let prompt = -1;
     for (let i = footer - 1; i >= 0 && footer - i <= BOX_MAX_ROWS; i--) {
         // The arrow ALONE, against the trimmed row: capture-pane strips a trailing space, and a box with
@@ -1062,12 +1075,10 @@ function findCodexPromptBox(rows) {
     // stale submitted prompt that also starts with "›").
     if (CODEX_CHOICE_LINE.test(text[prompt]))
         return null;
-    // Nothing but the prompt's own continuation, then one blank gap, may sit between the prompt row and
-    // the footer. Real content in that gap means the "›" found above is stale scrollback, not the live
-    // box - a busy/mid-turn screen can have an old prompt sitting within BOX_MAX_ROWS of whatever text
-    // is currently at the bottom, and only this check tells the two apart (see hive-internals).
+    // Only indented continuation rows, then one blank gap, may sit between the prompt and footer.
+    // Left-aligned output in that gap means the prompt is stale, not a live box (see hive-internals).
     let i = prompt + 1;
-    while (i <= footer && text[i] !== "")
+    while (i <= footer && text[i] !== "" && /^\s/.test(stripControlBytes(stripSgr(rows[i]))))
         i += 1;
     while (i <= footer && text[i] === "")
         i += 1;

package/dist/tools/meta.js

@@ -1,39 +1,29 @@
 import { z } from "zod";
 import { db } from "../db.js";
-import { addProject, currentActor, listProjects, resolveProject, selectProjectById, TOUCH_INTERVAL_MS, trySelectedProject, } from "../context.js";
+import { addProject, currentActor, listProjects, findProjectForCwd, resolveProject, selectProjectById, TOUCH_INTERVAL_MS, trySelectedProject, } from "../context.js";
+import { confirmQueenWrite } from "../queenAudit.js";
 import { errorMessage, run } from "../result.js";
 import { HELP_TOPICS, helpOverview } from "../help.js";
 import { idParam } from "./params.js";
+import { formatRowCounts, PROJECT_OWNER_TABLES, projectRowCounts, removeProject } from "../projectRemove.js";
 function refuseIfLocked(tool) {
     if (process.env.HIVE_PROJECT_LOCK === "1") {
         throw new Error(`${tool} sweeps the whole store, across every project and every actor. This session is locked to one project (HIVE_PROJECT_LOCK=1) and cannot run it. Run it from an unlocked session (a lead).`);
     }
 }
-export const PROJECT_OWNER_TABLES = [
-    "pads",
-    "todos",
-    "kv",
-    "leases",
-    "agents",
-    "wakes",
-    "command_trust",
-];
 function existsWhere(table, column, value) {
     return db.prepare(`SELECT 1 FROM ${table} WHERE ${column} = ? LIMIT 1`).get(value) !== undefined;
 }
 function projectOwnsRows(projectId) {
     return PROJECT_OWNER_TABLES.some((table) => existsWhere(table, "project_id", projectId));
 }
-function ownedRowCounts(projectId) {
-    return PROJECT_OWNER_TABLES.flatMap((table) => {
-        const n = db.prepare(`SELECT COUNT(*) AS n FROM ${table} WHERE project_id = ?`).get(projectId).n;
-        return n > 0 ? [`${table}: ${n}`] : [];
-    });
-}
-const pruneProjectIfEmpty = db.transaction((projectId) => {
-    if (projectOwnsRows(projectId))
+const pruneProjectIfEmpty = db.transaction((project) => {
+    if (projectOwnsRows(project.id))
+        return false;
+    if (db.prepare("DELETE FROM projects WHERE id = ?").run(project.id).changes === 0)
         return false;
-    return db.prepare("DELETE FROM projects WHERE id = ?").run(projectId).changes > 0;
+    confirmQueenWrite("project_prune", project.id, {}, { project_id: project.id, name: project.name });
+    return true;
 });
 export const ACTOR_OWNER_COLUMNS = [
     ["agents", "actor_id"],
@@ -149,30 +139,52 @@ export function registerMeta(server) {
         inputSchema: { project_id: idParam },
     }, ({ project_id }) => run(() => selectProjectById(project_id)));
     server.registerTool("project_prune", {
-        description: "Delete every registered project that owns no rows anywhere in the store (pads, todos, kv, leases, agents, wakes, command_trust), verified individually before each delete. Never prunes the caller's own project. With project_id, removes exactly that one project instead of sweeping, and only if it owns no rows; otherwise refuses and names what it owns. Refuses under HIVE_PROJECT_LOCK=1: this is a whole-store sweep, and a project-locked session may only touch its own project. Immediate, permanent: no dry-run mode.",
+        description: "Delete every registered project that owns no rows anywhere in the store (pads, todos, kv, leases, agents, wakes, command_trust), verified individually before each delete. Never prunes the caller's own project. With project_id, removes exactly that one project instead of sweeping, and only if it owns no rows; otherwise refuses and names what it owns. With project_id AND confirm_name (the project's exact name), removes that one project even when it owns rows: it takes a snapshot first, refuses while the project has a running agent, then deletes the project with everything it owns (todos, comments, pads, kv, leases, agents, wakes, trust, agent messages) in one transaction and reports per-table counts and the snapshot path. queen_audit rows naming it are kept, and so are other projects' lead-idle subscriptions that target it, so a watch on its lead ends with a named reason. confirm_name without project_id is refused, and there is no forced sweep. Refuses under HIVE_PROJECT_LOCK=1: this is a whole-store sweep, and a project-locked session may only touch its own project. Immediate, permanent: no dry-run mode.",
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
             idempotentHint: true,
             openWorldHint: false,
         },
-        inputSchema: { project_id: idParam.optional() },
+        inputSchema: { project_id: idParam.optional(), confirm_name: z.string().optional() },
         outputSchema: {
             deleted: z.array(z.object({ id: idParam, name: z.string() })),
             held_back: z.object({ project_id: idParam, reason: z.string() }),
             errors: z.array(z.object({ id: idParam, name: z.string(), error: z.string() })).optional(),
+            counts: z.record(z.string(), z.number()).optional(),
+            snapshot: z.string().nullable().optional(),
         },
-    }, ({ project_id }) => run(() => {
+    }, ({ project_id, confirm_name }) => run(() => {
         refuseIfLocked("project_prune");
         const homeId = resolveProject().id;
+        const cwdId = findProjectForCwd()?.id;
+        const isOwn = (id) => id === homeId || id === cwdId;
+        if (confirm_name !== undefined && project_id === undefined) {
+            throw new Error("project_prune: confirm_name needs project_id; there is no forced sweep.");
+        }
         if (project_id !== undefined) {
-            if (project_id === homeId)
+            if (isOwn(project_id))
                 throw new Error(`project_prune: project ${project_id} is the caller's own project and is never pruned.`);
             const target = listProjects().find((p) => p.id === project_id);
             if (!target)
                 throw new Error(`project_prune: no project ${project_id}. List them with project_list.`);
-            if (!pruneProjectIfEmpty.immediate(project_id)) {
-                throw new Error(`project_prune: project ${project_id} ("${target.name}") is not empty, nothing deleted. It owns ${ownedRowCounts(project_id).join(", ")}.`);
+            if (confirm_name !== undefined) {
+                if (confirm_name !== target.name) {
+                    throw new Error(`project_prune: confirm_name does not match project ${project_id}, whose name is "${target.name}". Nothing deleted.`);
+                }
+                const removed = removeProject(project_id, {
+                    snapshot: true,
+                    onRemoved: (r) => confirmQueenWrite("project_prune", project_id, {}, { project_id, name: r.deleted.name, counts: r.counts }),
+                });
+                return {
+                    deleted: [{ id: removed.deleted.id, name: removed.deleted.name }],
+                    held_back: { project_id: homeId, reason: "caller's own project" },
+                    counts: removed.counts,
+                    snapshot: removed.snapshot,
+                };
+            }
+            if (!pruneProjectIfEmpty.immediate(target)) {
+                throw new Error(`project_prune: project ${project_id} ("${target.name}") is not empty, nothing deleted. It owns ${formatRowCounts(projectRowCounts(project_id))}. To remove it with everything it owns, pass confirm_name with its exact name.`);
             }
             return {
                 deleted: [{ id: target.id, name: target.name }],
@@ -182,10 +194,10 @@ export function registerMeta(server) {
         const deleted = [];
         const errors = [];
         for (const project of listProjects()) {
-            if (project.id === homeId)
+            if (isOwn(project.id))
                 continue;
             try {
-                if (pruneProjectIfEmpty.immediate(project.id)) {
+                if (pruneProjectIfEmpty.immediate(project)) {
                     deleted.push({ id: project.id, name: project.name });
                 }
             }
@@ -200,7 +212,7 @@ export function registerMeta(server) {
         };
     }));
     server.registerTool("actor_prune", {
-        description: "Delete every actor that owns no rows anywhere in the store and has not been active in the last minute: agents.actor_id, agents.parent_actor_id, todos.locked_by, todo_comments.author, kv.updated_by, leases.owner, pads.updated_by, wakes.owner, wakes.deliver_actor, agent_state_log.actor_id. The scan is global across every project, never scoped to the caller's: actors carry no project_id, so an actor can own rows in a project the caller cannot see, and a project-scoped scan would misread that actor as inert and delete it. Never prunes the caller's own actor. Refuses under HIVE_PROJECT_LOCK=1: this is a whole-store sweep. Run this after project_prune when sweeping the store: an empty project owns no agents rows either, so today the order cannot orphan an actor, but that stops being true the day project deletion ever covers a non-empty project, and this ordering is the one that stays safe if it does. Immediate, permanent: no dry-run mode.",
+        description: "Delete every actor that owns no rows anywhere in the store and has not been active in the last minute: agents.actor_id, agents.parent_actor_id, todos.locked_by, todo_comments.author, kv.updated_by, leases.owner, pads.updated_by, wakes.owner, wakes.deliver_actor, agent_state_log.actor_id. The scan is global across every project, never scoped to the caller's: actors carry no project_id, so an actor can own rows in a project the caller cannot see, and a project-scoped scan would misread that actor as inert and delete it. Never prunes the caller's own actor. Refuses under HIVE_PROJECT_LOCK=1: this is a whole-store sweep. Run this after project_prune when sweeping the store: project_prune with confirm_name removes a non-empty project together with its agents rows, so run this afterwards to clear that project's actors that own nothing else. Actors with agent_state_log rows stay, because that log is append-only and has no project, which means every actor that ever ran a lead or worker stays. Immediate, permanent: no dry-run mode.",
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmgmyr/hive",
-  "version": "1.4.0",
+  "version": "1.5.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": {