@cmgmyr/hive 1.2.1 → 1.3.0

package/dist/tools/todos.js

@@ -201,6 +201,12 @@ const completeTodo = db.transaction((projectId, todoId, completed) => {
 export function registerTodos(server) {
     server.registerTool("todo_create", {
         description: "Create a project-scoped todo. Pass a short slug to have it render beside the id wherever this todo is listed; left unset, those surfaces fall back to the title instead (truncated in the dashboard). Optionally pass blocked_by todo ids to encode ordering. Returns a slim receipt.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             title: z.string(),
             body: z.string().optional().describe("Objective, owned files, acceptance criteria."),
@@ -225,6 +231,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_list", {
         description: "List todo summaries. is_blocked=false finds dispatchable work. query matches title, body, and slug. Archived todos are excluded by default; include_archived=true retrieves them too.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             status: statusParam.optional(),
             is_blocked: z.boolean().optional(),
@@ -256,6 +268,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_get", {
         description: "Read one todo in full: body, blockers, what it blocks, and optionally comments.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             include_comments: z.boolean().optional(),
@@ -267,6 +285,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_update", {
         description: "Update todo fields. Omitted fields are preserved. Returns a slim receipt.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             title: z.string().optional(),
@@ -292,6 +316,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_archive", {
         description: "Archive a todo (or unarchive with archived=false), mirroring pad_archive. Archived todos are excluded from todo_list by default; todo_get always reaches them by id. Refuses when this todo still blocks another todo that is not completed.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             archived: z.boolean().optional().describe("Default true. Pass false to unarchive."),
@@ -305,6 +335,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_complete", {
         description: "Mark a todo complete (or reopen with completed=false). Returns todo ids that this completion newly unblocked.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             completed: z.boolean().optional().describe("Defaults to true."),
@@ -323,6 +359,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_comment", {
         description: "Add a comment to a todo. Use for handoffs: changed files, tests run, decisions, remaining risk.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             body: z.string(),
@@ -340,6 +382,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_block", {
         description: "Add a blocker: todo_id cannot start until blocker_id completes. Cycles are rejected.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             blocker_id: idParam,
@@ -354,6 +402,12 @@ export function registerTodos(server) {
     }));
     server.registerTool("todo_unblock", {
         description: "Remove one blocker relationship from a todo.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             todo_id: idParam,
             blocker_id: idParam,

package/dist/tools/wakes.js

@@ -179,6 +179,12 @@ export function registerWakes(server) {
             "instead of polling. Write the body self-contained: ids, context, next action - it may arrive in " +
             "a session that has none of this conversation. Delivering to your OWN lead pane, where the " +
             "context is already there, prefer the action, the ids, and a pointer to where the detail lives.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             delay_seconds: z.number().int().positive(),
             body: z.string(),
@@ -210,6 +216,12 @@ export function registerWakes(server) {
     }));
     server.registerTool("wake_when_idle", {
         description: "Wake up when watched agents go idle (exact state from Claude Code hooks) or max_wait_seconds passes - except delivery HOLDS past that bound instead, for as long as the target pane is on a dialog or has unsubmitted human text in it, rather than pasting the wake body into either (.claude/rules/tmux-and-panes.md). Two shapes, and you pass EXACTLY ONE of them. agents=[...] is a ONE-SHOT over a named list: mode=any fires on the first fresh idle transition, mode=all fires when every watched agent is idle (returns already_satisfied without scheduling anything if they all are now), and either way it stops watching once it fires. scope=\"project\" is a STANDING WATCH over the crew you spawn in this project, including workers spawned later: it never stops watching, and on each finish it delivers a roster naming who finished and who is still going, until max_wait_seconds runs out or you wake_cancel it. You may hold ONE standing watch per project: a second call is refused and names the one already running, since two would report every finish twice. Use the standing watch when you are running more than one worker - a one-shot leaves every other worker unwatched from the moment it fires. Use either instead of polling. Refuses a lead target: a lead has no idle/working state channel.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             agents: z
                 .array(agentRefParam)
@@ -322,6 +334,12 @@ export function registerWakes(server) {
         description: "Read one wake-up by id, in this project, with its UNTRUNCATED body. wake_list truncates " +
             "body at 120 chars; use this to see exactly what a wake will say, or to confirm what " +
             "wake_update just changed.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: { wake_id: idParam, project_id: projectIdParam },
     }, (args) => run(() => {
         const projectId = effectiveProjectId(args.project_id);
@@ -352,6 +370,12 @@ export function registerWakes(server) {
             "delay_seconds and repeat_every_seconds only apply to a delay wake (from wake_set) - an idle " +
             "wake (from wake_when_idle) fires on watched-agent state and max_wait_seconds instead, so " +
             "only body can be edited on one.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         inputSchema: {
             wake_id: idParam,
             delay_seconds: z.number().int().positive().optional(),
@@ -409,6 +433,12 @@ export function registerWakes(server) {
             "per-worker block notice (a crew member stopped on a dialog): that carries no parent link, so one " +
             "already filed still delivers, and it may still be true - the worker is probably still on that " +
             "dialog - but it no longer claims anything about the watch's own liveness, deliberately.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: { wake_id: idParam, project_id: projectIdParam },
         outputSchema: {
             wake_id: idParam,
@@ -441,6 +471,12 @@ export function registerWakes(server) {
             "state (typed_at, held_at/held_reason, confirmation). A one-shot wake leaves the " +
             "pending list the moment it fires; recently_delivered is where to check whether it " +
             "was actually typed and, if its target has a confirmation channel, acknowledged.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         inputSchema: { project_id: projectIdParam },
     }, (args) => run(() => {
         const projectId = effectiveProjectId(args.project_id);

package/package.json

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