@cmgmyr/hive 1.11.7 → 1.11.9

package/README.md

@@ -57,7 +57,7 @@ hive is a personal daily-driver tool, released low-key. It is single-user by des
 
 | Page | What's there |
 |---|---|
-| [Architecture](docs/architecture.md) | Seven diagrams: process topology, module layering, spawn sequence, wake lifecycle, worker state, project scoping, store and server identity |
+| [Architecture](docs/architecture.md) | Eight diagrams: process topology, module layering, spawn sequence, wake lifecycle, worker state (with the lead handoff), project scoping, store and server identity |
 | [Patterns](docs/patterns.md) | Standing trades, refused approaches, evidence standards, and guard shapes distilled from the project's own decisions and dead-ends |
 | [Concepts](docs/concepts.md) | Vocabulary, why not subagents, identity, the workflow, project scope, the shared store |
 | [Daily driver](docs/daily-driver.md) | A day with hive, starting a session, watching workers, wake-ups |

package/claude-plugin/README.md

@@ -51,4 +51,4 @@ path is ever written into a committed file.
 
 ## The crew mod
 
-`crew/` is a second, separate plugin (`hive-crew`) that `hive lead` loads with `--plugin-dir` only when `lead_sidebar: true` is set and the lead is Claude. It is not part of the symlink install above and workers never load it. See [docs/crew.md](../docs/crew.md).
+`crew/` is a second, separate plugin (`hive-crew`) that `hive lead` loads with `--plugin-dir` for Claude leads by default. Set `lead_sidebar: false` to disable it. It is not part of the symlink install above and workers never load it. See [docs/crew.md](../docs/crew.md).

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"1.11.7","sha":"4861c81","dirty":false,"build_id":"2b159fa2c2519fbd7edef9cf4396ac349c3fb25ec433f76a9b91c5ad98188f43"}
+{"version":"1.11.9","sha":"5d08b61","dirty":false,"build_id":"c6006fe410e3627175581a5b66e7d8fbb68b92f1b2edc49a00ce1c9256bacc30"}

package/dist/claudeWake.js

@@ -1,7 +1,9 @@
 import { createConnection } from "node:net";
 import { join } from "node:path";
-import { db } from "./db.js";
-import { loadProjectYml } from "./projectYml.js";
+import { dataDir, db } from "./db.js";
+import { harnessFor } from "./harnesses.js";
+import { loadProjectYml, quietMessagingEnabled } from "./projectYml.js";
+import { shellQuote } from "./tmux.js";
 export { DELIVERY_METHOD } from "./wakeSql.js";
 export const CROSS_SESSION_CLOSE = "</cross-session-message>";
 export const ENVELOPE_OPEN = '<cross-session-message from="';
@@ -23,7 +25,12 @@ function claudeWakeFrame(sender, text) {
 }
 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;
+    return project !== undefined && quietMessagingEnabled(loadProjectYml(project.path).config);
+}
+export function quietMessagingHooksLaunched(projectId, command) {
+    const path = join(dataDir, `lead-${projectId}-hooks.json`);
+    const args = harnessFor("claude").briefDelivery?.settingsArgs(path);
+    return args !== undefined && command.includes(args.map(shellQuote).join(" "));
 }
 export function promptMarkerEvidenceSql(markerAt) {
     const evPrompt = "(CASE WHEN json_valid(ev.payload) THEN COALESCE(json_extract(ev.payload, '$.prompt'), '') ELSE ev.payload END)";

package/dist/cli.js

@@ -38,7 +38,7 @@ import { adoptableWindow, applyLayout, claimInitialWindow, configureHiveWindow,
 import { collectCrew, crewStoreProblem } from "./crew.js";
 import { describeVisibility, formatLocal, processCounts } from "./dashboard.js";
 import { runningCommandRow, runningCommandRows, snapshotProcesses, stopAllProcesses, stopLine, stopProcess, renderStart, STOP_REASONS, } from "./processes.js";
-import { activeProfile, agentVarKeys, BUILT_IN_PROJECT_YML, configHash, loadProjectYml, mergedProjectVars, NO_PROFILE, PROJECT_YML_KEYS, resolveCommandDir, resolveFirstMessage, } from "./projectYml.js";
+import { activeProfile, agentVarKeys, BUILT_IN_PROJECT_YML, configHash, leadSidebarEnabled, loadProjectYml, mergedProjectVars, NO_PROFILE, PROJECT_YML_KEYS, quietMessagingEnabled, resolveCommandDir, resolveFirstMessage, } from "./projectYml.js";
 import { appendClaudeLeadArgs, crewPluginDir, isTrusted, leadIdentityEnv, renderLeadPosture } from "./leadLaunch.js";
 import { handoffStatusSegment } from "./leadHandoff.js";
 import { cmdLeadHandoff, runHandoffGrace, runHandoffStart } from "./leadHandoffCli.js";
@@ -421,7 +421,7 @@ async function cmdLead(argv) {
         for (const w of warnings)
             console.log(`! ${w}`);
         const session = sessionName();
-        const hooksPath = ensureLeadHooksFile(project.id, config?.quiet_messaging === true);
+        const hooksPath = ensureLeadHooksFile(project.id, quietMessagingEnabled(config));
         let leadCommand = "claude";
         if (!config) {
             console.log("No hive.yml here; starting a plain claude lead. Add a hive.yml to define project commands and a custom lead (run hive --help for the format).");
@@ -464,7 +464,7 @@ async function cmdLead(argv) {
                 projectId: project.id,
                 projectName: project.name,
                 hooksPath,
-                sidebarPluginDir: config?.lead_sidebar === true && leadHarness.name === "claude" ? crewPluginDir() : null,
+                sidebarPluginDir: leadSidebarEnabled(config) && leadHarness.name === "claude" ? crewPluginDir() : null,
                 posture: renderedPosture,
                 firstMessage,
             }));
@@ -749,13 +749,13 @@ const HIVE_YML_TEMPLATE = `# hive project config. Read by \`hive lead\` from the
 
 # context_checkpoint_percent: null # unset means off; integer 1-100 to enable
 
-# lead_turn_budget: {warn: 300, stop: 600} # optional lead statusline thresholds
+# lead_turn_budget: {warn: 300, stop: 600} # optional thresholds; auto_handoff defaults on
 
 # dashboard: true               # write .hive/dashboard.html (default: false)
 
-# lead_sidebar: true            # a crew pane in a claude lead (default: false; restart the lead)
+# lead_sidebar: false           # disable the crew pane in a claude lead; restart the lead
 
-# quiet_messaging: true        # wakes and worker messages reach a claude lead as one row (default: false; restart the lead)
+# quiet_messaging: false       # use typed wakes and worker messages instead of one row; restart the lead
 
 # vars:                         # substituted into the profile runbook
 #   repo: owner/name            # {{repo}}

package/dist/help.js

@@ -253,7 +253,9 @@ Delivery contract:
   and the next action. Plain English, no markup.
   Waking your OWN lead pane is the exception: it is not cold, so carry the
   action and the ids and point at where the detail lives.
-  With lead_turn_budget.auto_handoff on, a lead past its warn budget gets
+  With a lead_turn_budget, auto_handoff is on by default. Set
+  lead_turn_budget.auto_handoff to false to keep the lead in this session.
+  When enabled, a lead past its warn budget gets
   a "hive lead handoff request #N" wake: follow its steps, then run
   hive lead-handoff. A human prompt during the grace postpones it.
 

package/dist/index.js

@@ -15,11 +15,12 @@ import { registerQueenAudit } from "./tools/queenAudit.js";
 import { registerPrompts } from "./prompts.js";
 import { schedulerIntervalMs, startScheduler } from "./scheduler.js";
 import { enforceStrictInput } from "./strictInput.js";
+import { hiveVersion } from "./version.js";
 migrate();
 const SCOPE_DISCIPLINE = isQueenLead()
     ? "Scope discipline: you are the queen, the lead of hive's queen home. Your own project is the working directory's. You may read any registered project by passing its project_id. Into another project you may write only todo_create and todo_comment, plus wakes and agent_send text addressed to that project's running lead; every other write there refuses with QUEEN_CROSS_PROJECT_WRITE_REFUSED. See help(topic=\"projects\")."
     : "Scope discipline: all state is project-scoped, and the current project is the working directory's. An empty result means there is nothing IN THIS PROJECT; report that and stop. Never browse other projects' state (project_id overrides, project_select) unless the user explicitly names another project and asks for it.";
-const server = enforceStrictInput(new McpServer({ name: "hive", version: "0.1.0" }, {
+const server = enforceStrictInput(new McpServer({ name: "hive", version: hiveVersion() }, {
     instructions: `Hive gives Claude Code sessions shared, persistent state for coordinating work on a project: pads for plans and findings, todos for tracked work with blockers, kv for small shared values, leases for claiming shared state, agents for spawning and directing other sessions, and wake-ups for scheduled or idle-triggered check-ins. Search for these tools when a task needs to persist past this conversation, hand off to or watch another session, or track multi-step work with dependencies.
 Getting started:
 1. Call whoami to see your actor identity and effective project scope.

package/dist/leadHandoff.js

@@ -11,8 +11,11 @@ import { readTurnCount } from "./turnCount.js";
 export { casHandoff, HELD_REASON_HANDOFF, handoffHoldsWake, readActiveHandoff, readHandoff, readHandoffGate, SUCCESSOR_NOT_READY, } from "./leadHandoffState.js";
 export const HANDOFF_PAD_NAME = "hive-lead-handoff";
 export const sha256 = (text) => createHash("sha256").update(text).digest("hex");
+function autoHandoffEnabled(budget) {
+    return budget !== null && (budget.auto_handoff ?? true);
+}
 export function handoffEligibility(lead, budget, snapshot = readLeadSafetySnapshot(lead.id)) {
-    if (budget === null || budget.auto_handoff !== true)
+    if (budget === null || !autoHandoffEnabled(budget))
         return { eligible: false, why: "auto_handoff is not enabled" };
     if (harnessFor(lead.command).name !== "claude")
         return { eligible: false, why: "the lead is not a Claude lead" };
@@ -274,7 +277,7 @@ export function driveLeadHandoff(actorId, budgetFor) {
         settleAfterRespawn(row, lead);
         return;
     }
-    if (budget?.auto_handoff !== true) {
+    if (!autoHandoffEnabled(budget)) {
         failHandoff(row.id, "lead_turn_budget.auto_handoff is no longer on");
         return;
     }
@@ -364,7 +367,7 @@ export function padProblem(pad, projectId, revision) {
 }
 // The final quiet check. A screen or probe that cannot be read waits; it never establishes quiet.
 export async function respawnVerdict(row, lead, budget) {
-    if (budget?.auto_handoff !== true)
+    if (!autoHandoffEnabled(budget))
         return { fail: "lead_turn_budget.auto_handoff is no longer on" };
     if (lead === undefined || lead.pane_pid !== row.predecessor_pane_pid || lead.tmux_target !== row.pane_target) {
         return { fail: "the lead row no longer names the pane this handoff was requested for" };

package/dist/leadHandoffCli.js

@@ -7,7 +7,7 @@ import { cliPath } from "./dispatcher.js";
 import { FIRST_MESSAGE_SHA_ENV, firstMessageDigest } from "./firstMessage.js";
 import { ensureLeadHooksFile } from "./hooks.js";
 import { appendClaudeLeadArgs, crewPluginDir, isTrusted, leadIdentityEnv, renderLeadPosture } from "./leadLaunch.js";
-import { loadProjectYml } from "./projectYml.js";
+import { leadSidebarEnabled, loadProjectYml, quietMessagingEnabled } from "./projectYml.js";
 import { buildEnvFlags } from "./spawn.js";
 import { panePidForRecord, rowOwnership, shellQuote, tmux, TmuxTimeoutError } from "./tmux.js";
 import { automationBlocker, failHandoff, missingHeadings, padProblem, readPad, RESPAWN_WAIT_LIMIT_SECONDS, respawnVerdict, runningLeadByActor, sha256, successorPrompt, } from "./leadHandoff.js";
@@ -152,8 +152,8 @@ async function successorLaunch(row, lead, attempt, token) {
         harness,
         projectId: lead.project_id,
         projectName: lead.name,
-        hooksPath: ensureLeadHooksFile(lead.project_id, config?.quiet_messaging === true),
-        sidebarPluginDir: config?.lead_sidebar === true ? crewPluginDir() : null,
+        hooksPath: ensureLeadHooksFile(lead.project_id, quietMessagingEnabled(config)),
+        sidebarPluginDir: leadSidebarEnabled(config) ? crewPluginDir() : null,
         posture: renderLeadPosture(config).rendered,
         firstMessage,
     });

package/dist/leadMessageDelivery.js

@@ -1,5 +1,5 @@
 import { dataDir, db } from "./db.js";
-import { CROSS_SESSION_CLOSE, promptMarkerEvidenceSql, postClaudeWake, quietMessagingOn, socketGraceDue, socketSenderAddress, SOCKET_MESSAGE_FOOTER, } from "./claudeWake.js";
+import { CROSS_SESSION_CLOSE, promptMarkerEvidenceSql, quietMessagingHooksLaunched, postClaudeWake, quietMessagingOn, socketGraceDue, socketSenderAddress, SOCKET_MESSAGE_FOOTER, } from "./claudeWake.js";
 import { harnessFor, paneClassifierFor } from "./harnesses.js";
 import { LEAD_MESSAGE_THRESHOLD, MESSAGE_METHOD, MESSAGE_RETENTION, MESSAGE_STATUS, renderLeadMessage, senderTag, shortenedSendNote, storeLeadMessage, } from "./leadMessage.js";
 import { readHandoffGate } from "./leadHandoffState.js";
@@ -30,7 +30,7 @@ function eligible(options) {
     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);
+    return sender !== undefined && quietMessagingOn(projectId) && quietMessagingHooksLaunched(projectId, target.command);
 }
 function registeredSocket(target) {
     return (target.claude_messaging_socket !== "" &&

package/dist/projectYml.js

@@ -18,8 +18,8 @@ export const BUILT_IN_PROJECT_YML = Object.freeze({
     context_checkpoint_percent: null,
     lead_turn_budget: null,
     dashboard: false,
-    lead_sidebar: false,
-    quiet_messaging: false,
+    lead_sidebar: true,
+    quiet_messaging: true,
     vars: Object.freeze({}),
     processes: Object.freeze({}),
 });
@@ -33,6 +33,12 @@ export function activeProfile(config) {
     const name = config?.profile;
     return name == null || name === NO_PROFILE ? null : name;
 }
+export function quietMessagingEnabled(config) {
+    return config?.quiet_messaging ?? BUILT_IN_PROJECT_YML.quiet_messaging;
+}
+export function leadSidebarEnabled(config) {
+    return config?.lead_sidebar ?? BUILT_IN_PROJECT_YML.lead_sidebar;
+}
 // First entry is the default; absent or empty means claude only (todo 526).
 export function allowedAgents(config) {
     const list = config?.agents;
@@ -184,8 +190,10 @@ function applyLayer(root, path, source, config, sources, warnings) {
             if (value.auto_handoff !== undefined) {
                 if (typeof value.auto_handoff === "boolean")
                     budget.auto_handoff = value.auto_handoff;
-                else
+                else {
+                    budget.auto_handoff = false;
                     warn(`lead_turn_budget.auto_handoff must be true or false; ignoring "${String(value.auto_handoff)}", so automatic handoff stays off.`);
+                }
             }
             config.lead_turn_budget = budget;
             sources.lead_turn_budget = source;
@@ -210,7 +218,7 @@ function applyLayer(root, path, source, config, sources, warnings) {
     if (has("lead_sidebar")) {
         const value = root.lead_sidebar;
         if (value == null) {
-            config.lead_sidebar = false;
+            config.lead_sidebar = BUILT_IN_PROJECT_YML.lead_sidebar;
             sources.lead_sidebar = source;
         }
         else if (typeof value === "boolean") {
@@ -223,7 +231,7 @@ function applyLayer(root, path, source, config, sources, warnings) {
     if (has("quiet_messaging")) {
         const value = root.quiet_messaging;
         if (value == null) {
-            config.quiet_messaging = false;
+            config.quiet_messaging = BUILT_IN_PROJECT_YML.quiet_messaging;
             sources.quiet_messaging = source;
         }
         else if (typeof value === "boolean") {

package/dist/scheduler.js

@@ -23,7 +23,7 @@ import { evaluateLeadWatch, leadSubscription } from "./leadWatch.js";
 import { describeLiveTasks, describeOneTask, liveBackgroundTasks, STALL_BOUND_SECONDS, } from "./backgroundTasks.js";
 import { MESSAGE_MAX_ROWS, MESSAGE_RETENTION } from "./leadMessage.js";
 import { PANE_LEASE_SETTLE_MS, releasePaneLease, tryAcquirePaneLease } from "./leaseStore.js";
-import { CROSS_SESSION_CLOSE, postClaudeWake, promptMarkerEvidenceSql, quietMessagingOn, socketGraceDue, socketSenderAddress, SOCKET_WAKE_FOOTER, } from "./claudeWake.js";
+import { CROSS_SESSION_CLOSE, quietMessagingHooksLaunched, postClaudeWake, promptMarkerEvidenceSql, quietMessagingOn, socketGraceDue, socketSenderAddress, SOCKET_WAKE_FOOTER, } from "./claudeWake.js";
 import { driveLeadHandoff } from "./leadHandoff.js";
 import { handoffHoldsWake } from "./leadHandoffState.js";
 import { FIRST_MESSAGE_LOG_STATE, humanPromptSql, readLeadTurnState } from "./leadState.js";
@@ -1949,7 +1949,8 @@ function socketRoute(timer, owner) {
         timer.deliver_messaging_pane_pid !== "" &&
         timer.deliver_messaging_pane_pid === timer.deliver_pane_pid &&
         timer.deliver_row_target === timer.deliver_pane &&
-        quietMessagingOn(timer.project_id));
+        quietMessagingOn(timer.project_id) &&
+        quietMessagingHooksLaunched(timer.project_id, timer.deliver_command));
 }
 function socketStillRegistered(timer, owner) {
     requireStillOwned(owner.rowId, owner.identity, `wake #${timer.id} socket delivery`);

package/dist/version.js

@@ -59,6 +59,9 @@ function packageVersion() {
         return "0.0.0";
     }
 }
+export function hiveVersion() {
+    return readBuildInfo()?.version ?? packageVersion();
+}
 function currentGit() {
     const sha = gitOut(checkoutRoot, ["rev-parse", "--short", "HEAD"]);
     const status = gitOut(checkoutRoot, ["status", "--porcelain"]);
@@ -67,7 +70,7 @@ function currentGit() {
 const describe = (sha, dirty) => `${sha}${dirty ? "-dirty" : ""}`;
 export function versionInfo() {
     const info = readBuildInfo();
-    const version = info?.version ?? packageVersion();
+    const version = hiveVersion();
     if (!info || info.sha == null) {
         const now = currentGit();
         return now

package/package.json

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