@cmgmyr/hive 1.2.0 → 1.2.2

package/README.md

@@ -1,7 +1,7 @@
 <p align="center"><img src="https://raw.githubusercontent.com/cmgmyr/hive/main/docs/assets/logo-card.svg" alt="hive" height="112"></p>
 <p align="center"><a href="https://www.npmjs.com/package/@cmgmyr/hive"><img src="https://img.shields.io/npm/v/%40cmgmyr%2Fhive?label=npm" alt="npm"></a> <a href="https://github.com/cmgmyr/hive/actions/workflows/ci.yml"><img src="https://github.com/cmgmyr/hive/actions/workflows/ci.yml/badge.svg" alt="CI"></a></p>
 
-Shared, persistent memory and a visible crew of tmux workers for Claude Code and Codex sessions on one project.
+Run a crew of Claude Code and Codex workers from one lead session: visible tmux panes, exact state from hooks, one local SQLite store.
 
 - Visible workers: each one is a real tmux pane you can read and type into.
 - Exact state: workers report it through their own CLI's hooks, so nothing polls.

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"1.2.0","sha":"6abbb1c","dirty":false,"build_id":"7bfa0131-a4ec-4341-a842-7d0cc0cd803d"}
+{"version":"1.2.2","sha":"df20075","dirty":false,"build_id":"2f8ecccc-4d22-424a-8c24-c48551ed2441"}

package/dist/cli.js

@@ -41,7 +41,7 @@ import { checkoutRoot, createProfile, forkProfile, PROFILE_FILES, ProfileError,
 import { COMMENT_COUNT_SQL, getTodoDetail, listTodoSummaries, OPEN_BLOCKERS_SQL, TODO_STATUSES, } from "./tools/todos.js";
 import { createPad, getActivePadByName, listActivePads, overwritePadContent, } from "./tools/pads.js";
 function usage() {
-    console.log(`hive — shared memory and coordination for Claude Code sessions
+    console.log(`hive — run a crew of Claude Code and Codex workers from one lead session
 
 Usage:
   hive --version              version, short sha, and dirty marker for this build

package/dist/help.js

@@ -1,5 +1,5 @@
 export function helpOverview() {
-    return `HIVE — shared memory and coordination across Claude Code sessions
+    return `HIVE — a lead session and a crew of Claude Code and Codex workers, sharing one local store
 
 Many workers, one shared memory. Multiple Claude sessions (and humans) share
 one project-scoped state store: pads, todos, kv, leases.

package/dist/index.js

@@ -10,7 +10,7 @@ import { registerKv } from "./tools/kv.js";
 import { registerLeases } from "./tools/leases.js";
 import { registerWakes } from "./tools/wakes.js";
 import { registerPrompts } from "./prompts.js";
-import { startScheduler } from "./scheduler.js";
+import { schedulerIntervalMs, startScheduler } from "./scheduler.js";
 import { enforceStrictInput } from "./strictInput.js";
 const server = enforceStrictInput(new McpServer({ name: "hive", version: "0.1.0" }, {
     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 work areas, 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.
@@ -30,5 +30,5 @@ registerKv(server);
 registerLeases(server);
 registerWakes(server);
 registerPrompts(server);
-startScheduler();
+startScheduler(schedulerIntervalMs());
 await server.connect(new StdioServerTransport());

package/dist/result.js

@@ -16,6 +16,23 @@ export function registrationNoticeText(notice) {
         `project_select.`);
 }
 const reportedBuilds = new Set();
+const pendingNotices = new WeakMap();
+function addNotice(result, text, build) {
+    result.content.push({ type: "text", text });
+    const pending = pendingNotices.get(result) ?? { texts: [] };
+    pending.texts.push(text);
+    if (build)
+        pending.build = build;
+    pendingNotices.set(result, pending);
+}
+export function noticeFor(result) {
+    return pendingNotices.get(result)?.texts.join("\n");
+}
+export function releaseNotice(result) {
+    const build = pendingNotices.get(result)?.build;
+    if (build)
+        reportedBuilds.delete(build);
+}
 export async function appendRunningBuildNotice(result, session) {
     try {
         const change = runningBuildChange();
@@ -30,8 +47,8 @@ export async function appendRunningBuildNotice(result, session) {
         }
         if (reportedBuilds.has(change.disk.build_id))
             return result;
-        result.content.push({ type: "text", text: runningBuildNotice(change, session) });
         reportedBuilds.add(change.disk.build_id);
+        addNotice(result, runningBuildNotice(change, session), change.disk.build_id);
     }
     catch {
     }
@@ -52,7 +69,7 @@ export async function run(fn) {
     }
     const notice = takeRegistrationNotice();
     if (notice) {
-        result.content.push({ type: "text", text: registrationNoticeText(notice) });
+        addNotice(result, registrationNoticeText(notice));
     }
     return appendRunningBuildNotice(result);
 }

package/dist/scheduler.js

@@ -43,7 +43,7 @@ function bestEffortRun(sql, ...params) {
 }
 let ticking = false;
 let schedulerInterval;
-export function startScheduler(intervalMs = 3000) {
+export function startScheduler(intervalMs = DEFAULT_SCHEDULER_INTERVAL_MS) {
     schedulerInterval = setInterval(() => {
         void tick();
     }, intervalMs).unref();
@@ -1642,3 +1642,13 @@ async function deliver(timer, note, choices, typedSeen, firstHeldAt) {
     if (!strandedTextWouldHold)
         recordTyped();
 }
+export const DEFAULT_SCHEDULER_INTERVAL_MS = 3000;
+const MIN_SCHEDULER_INTERVAL_MS = 100;
+// Node clamps a setInterval delay above this to 1ms.
+const MAX_SCHEDULER_INTERVAL_MS = 2_147_483_647;
+export function schedulerIntervalMs(raw = process.env.HIVE_SCHEDULER_INTERVAL_MS) {
+    const parsed = Number(raw);
+    return raw && Number.isInteger(parsed) && parsed >= MIN_SCHEDULER_INTERVAL_MS && parsed <= MAX_SCHEDULER_INTERVAL_MS
+        ? parsed
+        : DEFAULT_SCHEDULER_INTERVAL_MS;
+}

package/dist/strictInput.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { noticeFor, releaseNotice } from "./result.js";
 function isBuiltSchema(value) {
     return typeof value === "object" && value !== null && ("_zod" in value || "_def" in value);
 }
@@ -14,11 +15,15 @@ function strictSchemaFor(toolName, inputSchema) {
 }
 // The SDK requires structuredContent whenever outputSchema is declared but never populates it itself,
 // so this stays scoped to declaring tools rather than attached blanket in src/result.ts's ok().
+// Claude Code shows the model structuredContent and drops content for these tools, so a notice
+// appended to content reaches it only as structuredContent.hive_notice.
 function withStructuredContent(name, cb) {
     return async (...args) => {
         const result = (await cb(...args));
-        if (result.isError || result.structuredContent)
+        if (result.isError)
             return result;
+        if (result.structuredContent)
+            return withNotice(result);
         const first = result.content[0];
         const text = first?.type === "text" ? first.text : undefined;
         let parsed;
@@ -30,8 +35,9 @@ function withStructuredContent(name, cb) {
         }
         if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
             result.structuredContent = parsed;
-            return result;
+            return withNotice(result);
         }
+        releaseNotice(result);
         return {
             content: [
                 {
@@ -45,8 +51,23 @@ function withStructuredContent(name, cb) {
         };
     };
 }
+function withNotice(result) {
+    const notice = noticeFor(result);
+    if (notice && result.structuredContent)
+        result.structuredContent = { ...result.structuredContent, hive_notice: notice };
+    return result;
+}
+function withNoticeField(outputSchema) {
+    return outputSchema === undefined || isBuiltSchema(outputSchema)
+        ? outputSchema
+        : { ...outputSchema, hive_notice: z.string().optional() };
+}
 export function enforceStrictInput(server) {
     const register = server.registerTool.bind(server);
-    server.registerTool = ((name, config, cb) => register(name, { ...config, inputSchema: strictSchemaFor(name, config.inputSchema) }, (config.outputSchema ? withStructuredContent(name, cb) : cb)));
+    server.registerTool = ((name, config, cb) => register(name, {
+        ...config,
+        inputSchema: strictSchemaFor(name, config.inputSchema),
+        outputSchema: withNoticeField(config.outputSchema),
+    }, (config.outputSchema ? withStructuredContent(name, cb) : cb)));
     return server;
 }

package/dist/version.js

@@ -27,7 +27,7 @@ export function runningBuildChange() {
         if (!loadedBuild)
             return null;
         const stat = statSync(join(moduleDir, "build-info.json"));
-        const signature = `${stat.ino}:${stat.size}:${stat.mtimeMs}`;
+        const signature = `${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
         if (signature !== diskSignature) {
             diskBuild = readRunningBuild();
             diskSignature = signature;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cmgmyr/hive",
-  "version": "1.2.0",
-  "description": "Shared memory and coordination for Claude Code sessions: one lead, many tmux workers, one project-scoped store.",
+  "version": "1.2.2",
+  "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": {
     "hive": "dist/cli.js",