@selfagency/beans-mcp 0.1.4 → 0.5.0

package/index.cjs

@@ -14433,7 +14433,7 @@ var init_v4 = __esm({
   }
 });
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
 function assertCompleteRequestPrompt(request) {
   if (request.params.ref.type !== "ref/prompt") {
     throw new TypeError(`Expected CompleteRequestPrompt, but got ${request.params.ref.type}`);
@@ -14448,7 +14448,7 @@ function assertCompleteRequestResourceTemplate(request) {
 }
 var LATEST_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, RELATED_TASK_META_KEY, JSONRPC_VERSION, AssertObjectSchema, ProgressTokenSchema, CursorSchema, TaskCreationParamsSchema, TaskMetadataSchema, RelatedTaskMetadataSchema, RequestMetaSchema, BaseRequestParamsSchema, TaskAugmentedRequestParamsSchema, isTaskAugmentedRequestParams, RequestSchema, NotificationsParamsSchema, NotificationSchema, ResultSchema, RequestIdSchema, JSONRPCRequestSchema, isJSONRPCRequest, JSONRPCNotificationSchema, isJSONRPCNotification, JSONRPCResultResponseSchema, isJSONRPCResultResponse, ErrorCode, JSONRPCErrorResponseSchema, isJSONRPCErrorResponse, JSONRPCMessageSchema, JSONRPCResponseSchema, EmptyResultSchema, CancelledNotificationParamsSchema, CancelledNotificationSchema, IconSchema, IconsSchema, BaseMetadataSchema, ImplementationSchema, FormElicitationCapabilitySchema, ElicitationCapabilitySchema, ClientTasksCapabilitySchema, ServerTasksCapabilitySchema, ClientCapabilitiesSchema, InitializeRequestParamsSchema, InitializeRequestSchema, ServerCapabilitiesSchema, InitializeResultSchema, InitializedNotificationSchema, PingRequestSchema, ProgressSchema, ProgressNotificationParamsSchema, ProgressNotificationSchema, PaginatedRequestParamsSchema, PaginatedRequestSchema, PaginatedResultSchema, TaskStatusSchema, TaskSchema, CreateTaskResultSchema, TaskStatusNotificationParamsSchema, TaskStatusNotificationSchema, GetTaskRequestSchema, GetTaskResultSchema, GetTaskPayloadRequestSchema, GetTaskPayloadResultSchema, ListTasksRequestSchema, ListTasksResultSchema, CancelTaskRequestSchema, CancelTaskResultSchema, ResourceContentsSchema, TextResourceContentsSchema, Base64Schema, BlobResourceContentsSchema, RoleSchema, AnnotationsSchema, ResourceSchema, ResourceTemplateSchema, ListResourcesRequestSchema, ListResourcesResultSchema, ListResourceTemplatesRequestSchema, ListResourceTemplatesResultSchema, ResourceRequestParamsSchema, ReadResourceRequestParamsSchema, ReadResourceRequestSchema, ReadResourceResultSchema, ResourceListChangedNotificationSchema, SubscribeRequestParamsSchema, SubscribeRequestSchema, UnsubscribeRequestParamsSchema, UnsubscribeRequestSchema, ResourceUpdatedNotificationParamsSchema, ResourceUpdatedNotificationSchema, PromptArgumentSchema, PromptSchema, ListPromptsRequestSchema, ListPromptsResultSchema, GetPromptRequestParamsSchema, GetPromptRequestSchema, TextContentSchema, ImageContentSchema, AudioContentSchema, ToolUseContentSchema, EmbeddedResourceSchema, ResourceLinkSchema, ContentBlockSchema, PromptMessageSchema, GetPromptResultSchema, PromptListChangedNotificationSchema, ToolAnnotationsSchema, ToolExecutionSchema, ToolSchema, ListToolsRequestSchema, ListToolsResultSchema, CallToolResultSchema, CompatibilityCallToolResultSchema, CallToolRequestParamsSchema, CallToolRequestSchema, ToolListChangedNotificationSchema, ListChangedOptionsBaseSchema, LoggingLevelSchema, SetLevelRequestParamsSchema, SetLevelRequestSchema, LoggingMessageNotificationParamsSchema, LoggingMessageNotificationSchema, ModelHintSchema, ModelPreferencesSchema, ToolChoiceSchema, ToolResultContentSchema, SamplingContentSchema, SamplingMessageContentBlockSchema, SamplingMessageSchema, CreateMessageRequestParamsSchema, CreateMessageRequestSchema, CreateMessageResultSchema, CreateMessageResultWithToolsSchema, BooleanSchemaSchema, StringSchemaSchema, NumberSchemaSchema, UntitledSingleSelectEnumSchemaSchema, TitledSingleSelectEnumSchemaSchema, LegacyTitledEnumSchemaSchema, SingleSelectEnumSchemaSchema, UntitledMultiSelectEnumSchemaSchema, TitledMultiSelectEnumSchemaSchema, MultiSelectEnumSchemaSchema, EnumSchemaSchema, PrimitiveSchemaDefinitionSchema, ElicitRequestFormParamsSchema, ElicitRequestURLParamsSchema, ElicitRequestParamsSchema, ElicitRequestSchema, ElicitationCompleteNotificationParamsSchema, ElicitationCompleteNotificationSchema, ElicitResultSchema, ResourceTemplateReferenceSchema, PromptReferenceSchema, CompleteRequestParamsSchema, CompleteRequestSchema, CompleteResultSchema, RootSchema, ListRootsRequestSchema, ListRootsResultSchema, RootsListChangedNotificationSchema, ClientRequestSchema, ClientNotificationSchema, ClientResultSchema, ServerRequestSchema, ServerNotificationSchema, ServerResultSchema, McpError, UrlElicitationRequiredError;
 var init_types = __esm({
-  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js"() {
+  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js"() {
     "use strict";
     init_v4();
     LATEST_PROTOCOL_VERSION = "2025-11-25";
@@ -14460,10 +14460,9 @@ var init_types = __esm({
     CursorSchema = string2();
     TaskCreationParamsSchema = looseObject({
       /**
-       * Time in milliseconds to keep task results available after completion.
-       * If null, the task has unlimited lifetime until manually cleaned up.
+       * Requested duration in milliseconds to retain task from creation.
        */
-      ttl: union([number2(), _null3()]).optional(),
+      ttl: number2().optional(),
       /**
        * Time in milliseconds to wait between task status requests.
        */
@@ -14762,7 +14761,11 @@ var init_types = __esm({
       /**
        * Present if the client supports task creation.
        */
-      tasks: ClientTasksCapabilitySchema.optional()
+      tasks: ClientTasksCapabilitySchema.optional(),
+      /**
+       * Extensions that the client supports. Keys are extension identifiers (vendor-prefix/extension-name).
+       */
+      extensions: record(string2(), AssertObjectSchema).optional()
     });
     InitializeRequestParamsSchema = BaseRequestParamsSchema.extend({
       /**
@@ -14823,7 +14826,11 @@ var init_types = __esm({
       /**
        * Present if the server supports task creation.
        */
-      tasks: ServerTasksCapabilitySchema.optional()
+      tasks: ServerTasksCapabilitySchema.optional(),
+      /**
+       * Extensions that the server supports. Keys are extension identifiers (vendor-prefix/extension-name).
+       */
+      extensions: record(string2(), AssertObjectSchema).optional()
     });
     InitializeResultSchema = ResultSchema.extend({
       /**
@@ -15015,6 +15022,12 @@ var init_types = __esm({
        * The MIME type of this resource, if known.
        */
       mimeType: optional(string2()),
+      /**
+       * The size of the raw resource content, in bytes (i.e., before base64 encoding or any tokenization), if known.
+       *
+       * This can be used by Hosts to display file sizes and estimate context window usage.
+       */
+      size: optional(number2()),
       /**
        * Optional annotations for the client.
        */
@@ -22747,7 +22760,7 @@ var init_utils = __esm({
 });
 
 // src/internal/graphql.ts
-var LIST_BEANS_QUERY, CREATE_BEAN_MUTATION, UPDATE_BEAN_MUTATION, DELETE_BEAN_MUTATION;
+var LIST_BEANS_QUERY, CREATE_BEAN_MUTATION, UPDATE_BEAN_MUTATION, UPDATE_BEAN_MUTATION_WITH_IF_MATCH, DELETE_BEAN_MUTATION, LIST_BEANS_TIMESTAMPS_QUERY;
 var init_graphql = __esm({
   "src/internal/graphql.ts"() {
     "use strict";
@@ -22765,11 +22778,21 @@ var init_graphql = __esm({
   mutation($id: ID!, $input: UpdateBeanInput!) {
     updateBean(id: $id, input: $input) { id slug path title body status type priority tags parentId blockingIds blockedByIds createdAt updatedAt etag }
   }
+`;
+    UPDATE_BEAN_MUTATION_WITH_IF_MATCH = `
+  mutation($id: ID!, $input: UpdateBeanInput!, $ifMatch: String!) {
+    updateBean(id: $id, input: $input, ifMatch: $ifMatch) { id slug path title body status type priority tags parentId blockingIds blockedByIds createdAt updatedAt etag }
+  }
 `;
     DELETE_BEAN_MUTATION = `
   mutation($id: ID!) {
     deleteBean(id: $id)
   }
+`;
+    LIST_BEANS_TIMESTAMPS_QUERY = `
+  query {
+    beans { id updatedAt }
+  }
 `;
   }
 });
@@ -22792,12 +22815,26 @@ var init_backend = __esm({
     init_graphql();
     init_utils();
     execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
-    BeansCliBackend = class {
+    BeansCliBackend = class _BeansCliBackend {
       constructor(workspaceRoot, cliPath, logDir) {
         this.workspaceRoot = workspaceRoot;
         this.cliPath = cliPath;
         this.logDir = logDir;
       }
+      // ---------------------------------------------------------------------------
+      // Cache
+      // ---------------------------------------------------------------------------
+      /** Full unfiltered records keyed by bean ID, stored under the fixed cache key `'all'`. */
+      _cache = /* @__PURE__ */ new Map();
+      /** Last time the unfiltered cache entry `'all'` was fetched (ms). */
+      _cacheTime = /* @__PURE__ */ new Map();
+      /** Short-circuit TTL: skip even the timestamp check within this window (ms). */
+      static BURST_TTL_MS = 5e3;
+      /** Invalidate the unfiltered list cache so the next call does a full fetch. */
+      invalidateCache() {
+        this._cache.delete("all");
+        this._cacheTime.delete("all");
+      }
       /**
        * Returns a safe environment for executing the Beans CLI,
        * whitelisting only necessary variables.
@@ -22821,7 +22858,7 @@ var init_backend = __esm({
         return (0, import_node_path2.resolve)(this.workspaceRoot, ".beans");
       }
       resolveBeanFilePath(relativePath) {
-        const cleaned = relativePath.trim().replace(/^\/+/, "");
+        const cleaned = relativePath.trim().replace(/^\/+/, "").replace(/^\.beans(?:[\\/]|$)/, "");
         if (!cleaned) {
           throw new Error("Path is required");
         }
@@ -22879,10 +22916,48 @@ Output: ${stdout.slice(0, 1e3)}`
         if (options?.search) {
           filter.search = options.search;
         }
+        const isCacheable = !filter.status && !filter.type && !filter.search;
+        const cacheKey = "all";
+        if (isCacheable) {
+          const lastFetch = this._cacheTime.get(cacheKey) ?? 0;
+          const cached2 = this._cache.get(cacheKey);
+          const age = Date.now() - lastFetch;
+          if (cached2 && age < _BeansCliBackend.BURST_TTL_MS) {
+            return Array.from(cached2.values());
+          }
+          if (cached2) {
+            try {
+              const { data: tsData } = await this.executeGraphQL(
+                LIST_BEANS_TIMESTAMPS_QUERY
+              );
+              const timestamps = tsData.beans;
+              let dirty = timestamps.length !== cached2.size;
+              if (!dirty) {
+                for (const { id, updatedAt } of timestamps) {
+                  const existing = cached2.get(id);
+                  if (!existing || existing.updatedAt !== updatedAt) {
+                    dirty = true;
+                    break;
+                  }
+                }
+              }
+              if (!dirty) {
+                this._cacheTime.set(cacheKey, Date.now());
+                return Array.from(cached2.values());
+              }
+            } catch {
+            }
+          }
+        }
         const { data, errors } = await this.executeGraphQL(LIST_BEANS_QUERY, { filter });
         if (errors && errors.length > 0) {
           throw new Error(`GraphQL error: ${errors.map((e) => e.message).join(", ")}`);
         }
+        if (isCacheable) {
+          const byId = new Map(data.beans.map((b) => [b.id, b]));
+          this._cache.set(cacheKey, byId);
+          this._cacheTime.set(cacheKey, Date.now());
+        }
         return data.beans;
       }
       async create(input) {
@@ -22891,7 +22966,7 @@ Output: ${stdout.slice(0, 1e3)}`
           type: input.type,
           status: input.status,
           priority: input.priority,
-          body: input.description,
+          body: input.body ?? input.description,
           parent: input.parent
         };
         const { data, errors } = await this.executeGraphQL(CREATE_BEAN_MUTATION, {
@@ -22900,6 +22975,7 @@ Output: ${stdout.slice(0, 1e3)}`
         if (errors && errors.length > 0) {
           throw new Error(`GraphQL error: ${errors.map((e) => e.message).join(", ")}`);
         }
+        this.invalidateCache();
         return data.createBean;
       }
       async update(beanId, updates) {
@@ -22922,13 +22998,54 @@ Output: ${stdout.slice(0, 1e3)}`
         if (updates.body !== void 0) {
           updateInput.body = updates.body;
         }
-        const { data, errors } = await this.executeGraphQL(UPDATE_BEAN_MUTATION, {
-          id: beanId,
-          input: updateInput
-        });
+        const bodyMod = {};
+        if (updates.bodyAppend !== void 0) {
+          bodyMod.append = updates.bodyAppend;
+        }
+        if (Array.isArray(updates.bodyReplace) && updates.bodyReplace.length > 0) {
+          bodyMod.replace = updates.bodyReplace;
+        }
+        if (Object.keys(bodyMod).length > 0) {
+          updateInput.bodyMod = bodyMod;
+        }
+        let data;
+        let errors;
+        if (updates.ifMatch) {
+          try {
+            const res = await this.executeGraphQL(UPDATE_BEAN_MUTATION_WITH_IF_MATCH, {
+              id: beanId,
+              input: updateInput,
+              ifMatch: updates.ifMatch
+            });
+            data = res.data;
+            errors = res.errors;
+          } catch (error48) {
+            const message = error48.message || "";
+            const unsupportedIfMatch = /unknown argument.*ifMatch|unknown field.*ifMatch|ifMatch.*not defined|field .*updateBean.* argument .*ifMatch/i.test(
+              message
+            );
+            if (!unsupportedIfMatch) {
+              throw error48;
+            }
+            const fallback = await this.executeGraphQL(UPDATE_BEAN_MUTATION, {
+              id: beanId,
+              input: updateInput
+            });
+            data = fallback.data;
+            errors = fallback.errors;
+          }
+        } else {
+          const res = await this.executeGraphQL(UPDATE_BEAN_MUTATION, {
+            id: beanId,
+            input: updateInput
+          });
+          data = res.data;
+          errors = res.errors;
+        }
         if (errors && errors.length > 0) {
           throw new Error(`GraphQL error: ${errors.map((e) => e.message).join(", ")}`);
         }
+        this.invalidateCache();
         return data.updateBean;
       }
       async delete(beanId) {
@@ -22938,13 +23055,57 @@ Output: ${stdout.slice(0, 1e3)}`
         if (errors && errors.length > 0) {
           throw new Error(`GraphQL error: ${errors.map((e) => e.message).join(", ")}`);
         }
+        this.invalidateCache();
         return { deleted: true, beanId };
       }
+      async bulkCreate(beans, defaultParent) {
+        const results = [];
+        for (const item of beans) {
+          try {
+            const bean = await this.create({
+              ...item,
+              parent: item.parent ?? defaultParent
+            });
+            results.push({ bean });
+          } catch (error48) {
+            results.push({ error: error48.message });
+          }
+        }
+        return results;
+      }
+      async bulkUpdate(beans, defaultParent) {
+        const results = [];
+        for (const { beanId, ...updates } of beans) {
+          try {
+            const resolvedParent = updates.parent ?? (updates.clearParent ? void 0 : defaultParent);
+            const bean = await this.update(beanId, { ...updates, parent: resolvedParent });
+            results.push({ beanId, bean });
+          } catch (error48) {
+            results.push({ beanId, error: error48.message });
+          }
+        }
+        return results;
+      }
       async openConfig() {
         const configPath = (0, import_node_path2.join)(this.workspaceRoot, ".beans.yml");
         const content = await (0, import_promises.readFile)(configPath, "utf8");
         return { configPath, content };
       }
+      async primeInstructions() {
+        const { stdout } = await execFileAsync(this.cliPath, ["prime"], {
+          cwd: this.workspaceRoot,
+          env: this.getSafeEnv(),
+          maxBuffer: 10 * 1024 * 1024,
+          timeout: 3e4
+        });
+        return stdout.trim();
+      }
+      async writeInstructions(instructions) {
+        const instructionsPath = (0, import_node_path2.join)(this.workspaceRoot, ".github", "instructions", "beans-prime.instructions.md");
+        await (0, import_promises.mkdir)((0, import_node_path2.dirname)(instructionsPath), { recursive: true });
+        await (0, import_promises.writeFile)(instructionsPath, instructions, "utf8");
+        return instructionsPath;
+      }
       async graphqlSchema() {
         const { stdout } = await execFileAsync(this.cliPath, ["graphql", "--schema"], {
           cwd: this.workspaceRoot,
@@ -22983,6 +23144,120 @@ Output: ${stdout.slice(0, 1e3)}`
           linesReturned: ringBuffer.length
         };
       }
+      /**
+       * Split a YAML scalar value from any trailing inline comment.
+       * Understands single-quoted and double-quoted YAML strings so it won't
+       * mistake a `#` inside a quoted value for a comment delimiter.
+       */
+      splitYamlInlineComment(value) {
+        let inSingle = false;
+        let inDouble = false;
+        for (let i = 0; i < value.length; i += 1) {
+          const char = value[i];
+          if (inSingle) {
+            if (char === "'") {
+              if (value[i + 1] === "'") {
+                i += 1;
+              } else {
+                inSingle = false;
+              }
+            }
+            continue;
+          }
+          if (inDouble) {
+            if (char === "\\") {
+              i += 1;
+              continue;
+            }
+            if (char === '"') {
+              inDouble = false;
+            }
+            continue;
+          }
+          if (char === "'") {
+            inSingle = true;
+            continue;
+          }
+          if (char === '"') {
+            inDouble = true;
+            continue;
+          }
+          if (char === "#" && i > 0 && /\s/.test(value[i - 1])) {
+            const valuePart = value.slice(0, i).trimEnd();
+            return {
+              valuePart,
+              commentPart: value.slice(valuePart.length)
+            };
+          }
+        }
+        return { valuePart: value, commentPart: "" };
+      }
+      /** Returns true when `value` looks like a YAML block scalar indicator (`>`, `|`, `>-`, `|-`, etc.) */
+      isYamlBlockScalarIndicator(value) {
+        return /^[>|][+-]?[0-9]*$/.test(value) || /^[>|][0-9]*[+-]?$/.test(value);
+      }
+      /** Escape a plain string for use inside a YAML double-quoted scalar. */
+      escapeForYamlDoubleQuoted(value) {
+        return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+      }
+      /**
+       * Normalise a raw YAML title value to a double-quoted scalar.
+       * Handles: empty, already double-quoted, single-quoted (unescaping `''`),
+       * block-scalar indicators, and plain unquoted values.
+       */
+      normalizeFrontmatterTitleValue(value) {
+        const trimmed = value.trim();
+        if (trimmed === "") {
+          return '""';
+        }
+        if (this.isYamlBlockScalarIndicator(trimmed)) {
+          return value;
+        }
+        if (/^"(?:[^"\\]|\\[\s\S])*"$/.test(trimmed)) {
+          return trimmed;
+        }
+        if (/^'(?:[^']|'')*'$/.test(trimmed)) {
+          const inner = trimmed.slice(1, -1).replace(/''/g, "'");
+          return `"${this.escapeForYamlDoubleQuoted(inner)}"`;
+        }
+        return `"${this.escapeForYamlDoubleQuoted(trimmed)}"`;
+      }
+      /**
+       * Ensure every `title:` line in YAML frontmatter is double-quoted.
+       * Handles already-quoted (single or double), multi-word, and special-char values.
+       * Preserves inline comments and handles both LF and CRLF line endings.
+       */
+      quoteFrontmatterTitles(content) {
+        const crlfOpen = content.startsWith("---\r\n");
+        const lfOpen = content.startsWith("---\n");
+        if (!crlfOpen && !lfOpen) {
+          return content;
+        }
+        const eol = crlfOpen ? "\r\n" : "\n";
+        const openEnd = `---${eol}`.length;
+        const closeMarker = `${eol}---`;
+        const closeIdx = content.indexOf(closeMarker, openEnd);
+        if (closeIdx === -1) {
+          return content;
+        }
+        const frontmatter = content.slice(openEnd, closeIdx);
+        const rest = content.slice(closeIdx);
+        const lines = frontmatter.split(eol);
+        const fixedLines = lines.map((line) => {
+          if (!line.startsWith("title:")) {
+            return line;
+          }
+          const colonIdx = line.indexOf(":");
+          const afterColon = line.slice(colonIdx + 1);
+          const leadingSpace = afterColon.length - afterColon.trimStart().length;
+          const raw = afterColon.trimStart();
+          const { valuePart, commentPart } = this.splitYamlInlineComment(raw);
+          const normalized = this.normalizeFrontmatterTitleValue(valuePart);
+          const prefix = `title:${" ".repeat(Math.max(1, leadingSpace))}`;
+          return `${prefix}${normalized}${commentPart}`;
+        });
+        return `---${eol}${fixedLines.join(eol)}${rest}`;
+      }
       async readBeanFile(relativePath) {
         const absolutePath = this.resolveBeanFilePath(relativePath);
         const content = await (0, import_promises.readFile)(absolutePath, "utf8");
@@ -22990,20 +23265,22 @@ Output: ${stdout.slice(0, 1e3)}`
       }
       async editBeanFile(relativePath, content) {
         const absolutePath = this.resolveBeanFilePath(relativePath);
+        const fixed = this.quoteFrontmatterTitles(content);
         await (0, import_promises.mkdir)((0, import_node_path2.dirname)(absolutePath), { recursive: true });
-        await (0, import_promises.writeFile)(absolutePath, content, "utf8");
-        return { path: absolutePath, bytes: Buffer.byteLength(content, "utf8") };
+        await (0, import_promises.writeFile)(absolutePath, fixed, "utf8");
+        return { path: absolutePath, bytes: Buffer.byteLength(fixed, "utf8") };
       }
       async createBeanFile(relativePath, content, options) {
         const absolutePath = this.resolveBeanFilePath(relativePath);
+        const fixed = this.quoteFrontmatterTitles(content);
         await (0, import_promises.mkdir)((0, import_node_path2.dirname)(absolutePath), { recursive: true });
-        await (0, import_promises.writeFile)(absolutePath, content, {
+        await (0, import_promises.writeFile)(absolutePath, fixed, {
           encoding: "utf8",
           flag: options?.overwrite ? "w" : "wx"
         });
         return {
           path: absolutePath,
-          bytes: Buffer.byteLength(content, "utf8"),
+          bytes: Buffer.byteLength(fixed, "utf8"),
           created: true
         };
       }
@@ -23016,7 +23293,7 @@ Output: ${stdout.slice(0, 1e3)}`
   }
 });
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 function deserializeMessage(line) {
   return JSONRPCMessageSchema.parse(JSON.parse(line));
 }
@@ -23025,7 +23302,7 @@ function serializeMessage(message) {
 }
 var ReadBuffer;
 var init_stdio = __esm({
-  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js"() {
+  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js"() {
     "use strict";
     init_types();
     ReadBuffer = class {
@@ -23051,14 +23328,14 @@ var init_stdio = __esm({
   }
 });
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var stdio_exports = {};
 __export(stdio_exports, {
   StdioServerTransport: () => StdioServerTransport
 });
 var import_node_process, StdioServerTransport;
 var init_stdio2 = __esm({
-  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js"() {
+  "node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js"() {
     "use strict";
     import_node_process = __toESM(require("process"), 1);
     init_stdio();
@@ -27083,7 +27360,7 @@ init_core2();
 // node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/mini/coerce.js
 init_core2();
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
 function isZ4Schema(s) {
   const schema = s;
   return !!schema._zod;
@@ -27227,10 +27504,10 @@ function getLiteralValue(schema) {
   return void 0;
 }
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 init_types();
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
 function isTerminal(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
@@ -28519,7 +28796,7 @@ var zodToJsonSchema = (schema, options) => {
   return combined;
 };
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
 function mapMiniTarget(t) {
   if (!t)
     return "draft-7";
@@ -28561,7 +28838,7 @@ function parseWithCompat(schema, data) {
   return result.data;
 }
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 var DEFAULT_REQUEST_TIMEOUT_MSEC = 6e4;
 var Protocol = class {
   constructor(_options) {
@@ -28773,6 +29050,10 @@ var Protocol = class {
     this._progressHandlers.clear();
     this._taskProgressTokens.clear();
     this._pendingDebouncedNotifications.clear();
+    for (const info of this._timeoutInfo.values()) {
+      clearTimeout(info.timeoutId);
+    }
+    this._timeoutInfo.clear();
     for (const controller of this._requestHandlerAbortControllers.values()) {
       controller.abort();
     }
@@ -28903,7 +29184,9 @@ var Protocol = class {
         await capturedTransport?.send(errorResponse);
       }
     }).catch((error48) => this._onerror(new Error(`Failed to send response: ${error48}`))).finally(() => {
-      this._requestHandlerAbortControllers.delete(request.id);
+      if (this._requestHandlerAbortControllers.get(request.id) === abortController) {
+        this._requestHandlerAbortControllers.delete(request.id);
+      }
     });
   }
   _onprogress(notification) {
@@ -29509,10 +29792,10 @@ function mergeCapabilities(base, additional) {
   return result;
 }
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
 init_types();
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
 var import_ajv = __toESM(require_ajv(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 function createDefaultAjvInstance() {
@@ -29580,7 +29863,7 @@ var AjvJsonSchemaValidator = class {
   }
 };
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
 init_types();
 var ExperimentalServerTasks = class {
   constructor(_server) {
@@ -29794,7 +30077,7 @@ var ExperimentalServerTasks = class {
   }
 };
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
 function assertToolsCallTaskCapability(requests, method, entityName) {
   if (!requests) {
     throw new Error(`${entityName} does not support task creation (required for ${method})`);
@@ -29829,7 +30112,7 @@ function assertClientRequestTaskCapability(requests, method, entityName) {
   }
 }
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
 var Server = class extends Protocol {
   /**
    * Initializes this server with the given name and version information.
@@ -30209,10 +30492,10 @@ var Server = class extends Protocol {
   }
 };
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
 init_types();
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
 var COMPLETABLE_SYMBOL = /* @__PURE__ */ Symbol.for("mcp.completable");
 function isCompletable(schema) {
   return !!schema && typeof schema === "object" && COMPLETABLE_SYMBOL in schema;
@@ -30226,7 +30509,7 @@ var McpZodTypeKind;
   McpZodTypeKind2["Completable"] = "McpCompletable";
 })(McpZodTypeKind || (McpZodTypeKind = {}));
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
 var TOOL_NAME_REGEX = /^[A-Za-z0-9._-]{1,128}$/;
 function validateToolName(name) {
   const warnings = [];
@@ -30284,7 +30567,7 @@ function validateAndWarnToolName(name) {
   return result.isValid;
 }
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
 var ExperimentalMcpServerTasks = class {
   constructor(_mcpServer) {
     this._mcpServer = _mcpServer;
@@ -30303,7 +30586,7 @@ var ExperimentalMcpServerTasks = class {
 init_external();
 init_external();
 
-// node_modules/.pnpm/@modelcontextprotocol+sdk@1.27.1_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+// node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.3.6/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
 var McpServer = class {
   constructor(serverInfo, options) {
     this._registeredResources = {};
@@ -30927,6 +31210,9 @@ var McpServer = class {
           annotations = rest.shift();
         }
       } else if (typeof firstArg === "object" && firstArg !== null) {
+        if (Object.values(firstArg).some((v) => typeof v === "object" && v !== null)) {
+          throw new Error(`Tool ${name} expected a Zod schema or ToolAnnotations, but received an unrecognized object`);
+        }
         annotations = rest.shift();
       }
     }
@@ -31045,6 +31331,9 @@ function getZodSchemaObject(schema) {
   if (isZodRawShapeCompat(schema)) {
     return objectFromShape(schema);
   }
+  if (!isZodSchemaInstance(schema)) {
+    throw new Error("inputSchema must be a Zod schema or raw shape, received an unrecognized object");
+  }
   return schema;
 }
 function promptArgumentsFromSchema(schema) {
@@ -31089,6 +31378,94 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
+// src/server/BeansMcpServer.ts
+var import_node_child_process2 = require("child_process");
+var import_node_util2 = require("util");
+
+// package.json
+var package_default = {
+  name: "@selfagency/beans-mcp",
+  version: "0.5.0",
+  private: false,
+  description: "MCP (Model Context Protocol) server for Beans issue tracker",
+  author: {
+    name: "Daniel Sieradski",
+    email: "daniel@self.agency",
+    url: "https://self.agency"
+  },
+  homepage: "https://github.com/selfagency/beans-mcp",
+  bugs: {
+    url: "https://github.com/selfagency/beans-mcp/issues"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/selfagency/beans-mcp.git"
+  },
+  mcpName: "io.github.selfagency/beans-mcp",
+  keywords: [
+    "beans",
+    "mcp",
+    "model-context-protocol",
+    "issue-tracker",
+    "ai"
+  ],
+  license: "MIT",
+  type: "module",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: {
+    "beans-mcp": "dist/beans-mcp-server.cjs"
+  },
+  scripts: {
+    build: "tsup",
+    format: "oxfmt",
+    "lint:fix": "oxlint --fix",
+    lint: "oxlint",
+    postbuild: "node ./scripts/write-dist-package.js",
+    prepare: "husky",
+    release: "zx ./scripts/release.js",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    test: "vitest run",
+    "type-check": "tsc --noEmit"
+  },
+  devDependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@octokit/rest": "^22.0.1",
+    "@types/node": "25.5.2",
+    "@vitest/coverage-v8": "^4.1.2",
+    "@vitest/ui": "4.1.2",
+    husky: "^9.1.7",
+    "lint-staged": "^16.4.0",
+    ora: "^9.3.0",
+    oxfmt: "^0.43.0",
+    oxlint: "^1.58.0",
+    "oxlint-tsgolint": "^0.20.0",
+    tsup: "8.5.1",
+    typescript: "6.0.2",
+    vitest: "4.1.2",
+    zod: "4.3.6",
+    zx: "^8.8.5"
+  },
+  engines: {
+    node: ">=18"
+  },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "pnpm run lint:fix",
+      "pnpm run format"
+    ]
+  }
+};
+
 // src/internal/queryHelpers.ts
 function sortBeansInternal(beans, mode) {
   const sorted = [...beans];
@@ -31144,15 +31521,23 @@ async function handleQueryOperation(backend, params) {
   const { operation, mode, statuses, types, search, tags, writeToWorkspaceInstructions, includeClosed } = params;
   if (operation === "llm_context") {
     const graphqlSchema = typeof backend.graphqlSchema === "function" ? await backend.graphqlSchema() : "";
-    const instructionsPath = writeToWorkspaceInstructions && typeof backend.writeInstructions === "function" ? await backend.writeInstructions("") : null;
+    let generatedInstructions = "";
+    if (typeof backend.primeInstructions === "function") {
+      try {
+        generatedInstructions = await backend.primeInstructions();
+      } catch {
+        generatedInstructions = "";
+      }
+    }
+    const instructionsPath = writeToWorkspaceInstructions && typeof backend.writeInstructions === "function" ? await backend.writeInstructions(generatedInstructions) : null;
     return {
       content: [
         {
           type: "text",
-          text: JSON.stringify({ graphqlSchema, generatedInstructions: "", instructionsPath }, null, 2)
+          text: JSON.stringify({ graphqlSchema, generatedInstructions, instructionsPath }, null, 2)
         }
       ],
-      structuredContent: { graphqlSchema, generatedInstructions: "", instructionsPath }
+      structuredContent: { graphqlSchema, generatedInstructions, instructionsPath }
     };
   }
   if (operation === "open_config") {
@@ -31198,6 +31583,31 @@ async function handleQueryOperation(backend, params) {
       structuredContent: { query: search, count: beans2.length, beans: beans2 }
     };
   }
+  if (operation === "ready") {
+    const allBeans = await backend.list();
+    const byId = new Map(allBeans.map((bean) => [bean.id, bean]));
+    const candidates = await backend.list({ status: normalizedStatuses, type: normalizedTypes, search });
+    const readyBeans = candidates.filter((bean) => {
+      if (bean.status !== "todo") {
+        return false;
+      }
+      const blockedBy = bean.blockedByIds || [];
+      if (blockedBy.length === 0) {
+        return true;
+      }
+      return blockedBy.every((blockerId) => {
+        const blocker = byId.get(blockerId);
+        if (!blocker) {
+          return false;
+        }
+        return blocker.status === "completed" || blocker.status === "scrapped";
+      });
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify({ count: readyBeans.length, beans: readyBeans }, null, 2) }],
+      structuredContent: { count: readyBeans.length, beans: readyBeans }
+    };
+  }
   const beans = await backend.list({ status: normalizedStatuses, type: normalizedTypes, search });
   const sorted = sortBeansInternal(beans, mode ?? "status-priority-type-title");
   return {
@@ -31216,92 +31626,45 @@ var MAX_PATH_LENGTH = 1024;
 
 // src/server/BeansMcpServer.ts
 init_utils();
-
-// package.json
-var package_default = {
-  name: "@selfagency/beans-mcp",
-  version: "0.1.4",
-  private: false,
-  description: "MCP (Model Context Protocol) server for Beans issue tracker",
-  author: {
-    name: "Daniel Sieradski",
-    email: "daniel@self.agency",
-    url: "https://self.agency"
-  },
-  homepage: "https://github.com/hmans/beans",
-  bugs: {
-    url: "https://github.com/selfagency/beans-mcp/issues"
-  },
-  repository: {
-    type: "git",
-    url: "git+https://github.com/selfagency/beans-mcp.git"
-  },
-  mcpName: "io.github.selfagency/beans-mcp",
-  keywords: [
-    "beans",
-    "mcp",
-    "model-context-protocol",
-    "issue-tracker",
-    "ai"
-  ],
-  license: "MIT",
-  type: "module",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.cjs"
+var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
+var PACKAGE_VERSION = package_default.version ?? "0.0.0-dev";
+function getSafeCliEnv(env) {
+  const whitelist = ["PATH", "HOME", "USER", "LANG", "LC_ALL", "LC_CTYPE", "SHELL"];
+  const safeEnv = {};
+  for (const key of whitelist) {
+    if (env[key]) {
+      safeEnv[key] = env[key];
     }
-  },
-  main: "./dist/index.cjs",
-  module: "./dist/index.js",
-  types: "./dist/index.d.ts",
-  bin: {
-    "beans-mcp": "dist/beans-mcp-server.cjs"
-  },
-  scripts: {
-    build: "tsup",
-    format: "oxfmt",
-    "lint:fix": "oxlint --fix",
-    lint: "oxlint",
-    postbuild: "node ./scripts/write-dist-package.js",
-    prepare: "husky",
-    release: "zx ./scripts/release.js",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    test: "vitest run",
-    "type-check": "tsc --noEmit"
-  },
-  devDependencies: {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@octokit/rest": "^22.0.1",
-    "@types/node": "^20.19.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "@vitest/ui": "4.0.18",
-    husky: "^9.1.7",
-    "lint-staged": "^16.2.7",
-    ora: "^9.3.0",
-    oxfmt: "^0.35.0",
-    oxlint: "^1.50.0",
-    "oxlint-tsgolint": "^0.15.0",
-    tsup: "8.5.1",
-    typescript: "^5.9.3",
-    vitest: "4.0.18",
-    zod: "4.3.6",
-    zx: "^8.8.5"
-  },
-  engines: {
-    node: ">=18"
-  },
-  "lint-staged": {
-    "src/**/*.ts": [
-      "pnpm run lint:fix",
-      "pnpm run format"
-    ]
   }
-};
-
-// src/server/BeansMcpServer.ts
+  for (const key in env) {
+    if (key.startsWith("BEANS_")) {
+      safeEnv[key] = env[key];
+    }
+  }
+  return safeEnv;
+}
+function extractVersionFromOutput(output) {
+  const trimmed = output.trim();
+  if (!trimmed) {
+    return null;
+  }
+  const match = trimmed.match(/(?:^|[^\d])v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)/);
+  return match?.[1] ?? null;
+}
+async function detectBeansCliVersion(cliPath, workspaceRoot) {
+  try {
+    const { stdout, stderr } = await execFileAsync2(cliPath, ["version"], {
+      cwd: workspaceRoot,
+      env: getSafeCliEnv(process.env),
+      maxBuffer: 1024 * 1024,
+      timeout: 5e3
+    });
+    return extractVersionFromOutput(`${stdout}
+${stderr}`);
+  } catch {
+    return null;
+  }
+}
 async function getBeanById(backend, beanId) {
   try {
     const beans = await backend.list();
@@ -31321,7 +31684,40 @@ function initHandler(backend) {
   };
 }
 function viewHandler(backend) {
-  return async ({ beanId }) => makeTextAndStructured({ bean: await getBeanById(backend, beanId) });
+  return async ({ beanId, beanIds }) => {
+    const ids = Array.isArray(beanIds) && beanIds.length > 0 ? beanIds : beanId ? [beanId] : [];
+    if (ids.length === 0) {
+      throw new Error("Either beanId or beanIds must be provided");
+    }
+    if (ids.length === 1) {
+      const bean = await getBeanById(backend, ids[0]);
+      return makeTextAndStructured({ bean });
+    }
+    const beans = await backend.list();
+    const byId = new Map(beans.map((b) => [b.id, b]));
+    const found = ids.map((id) => byId.get(id)).filter(Boolean);
+    const missingBeanIds = ids.filter((id) => !byId.has(id));
+    return makeTextAndStructured({
+      beans: found,
+      missingBeanIds,
+      count: found.length,
+      requestedCount: ids.length
+    });
+  };
+}
+async function checkVersionCompatibility(cliPath, workspaceRoot, detector) {
+  const detectedBeansVersion = await detector(cliPath, workspaceRoot);
+  if (!detectedBeansVersion) {
+    console.error(
+      `[beans-mcp] warning: unable to determine Beans CLI version from \`${cliPath}\`; proceeding without version compatibility checks.`
+    );
+    return;
+  }
+  if (detectedBeansVersion !== PACKAGE_VERSION) {
+    console.error(
+      `[beans-mcp] warning: version mismatch detected (beans=${detectedBeansVersion}, beans-mcp=${PACKAGE_VERSION}); continuing startup.`
+    );
+  }
 }
 function createHandler(backend) {
   return async (input) => makeTextAndStructured({ bean: await backend.create(input) });
@@ -31357,17 +31753,82 @@ function updateHandler(backend) {
       clearParent: input.clearParent,
       blocking: input.blocking,
       blockedBy: input.blockedBy,
-      body: input.body
+      body: input.body,
+      bodyAppend: input.bodyAppend,
+      bodyReplace: input.bodyReplace,
+      ifMatch: input.ifMatch
     })
   });
 }
 function deleteHandler(backend) {
-  return async ({ beanId, force }) => {
-    const bean = await getBeanById(backend, beanId);
-    if (!force && bean.status !== "draft" && bean.status !== "scrapped") {
-      throw new Error("Only draft and scrapped beans are deletable unless force=true");
+  return async ({ beanId, beanIds, force }) => {
+    const ids = Array.isArray(beanIds) && beanIds.length > 0 ? beanIds : beanId ? [beanId] : [];
+    if (ids.length === 0) {
+      throw new Error("Either beanId or beanIds must be provided");
     }
-    return makeTextAndStructured(await backend.delete(beanId));
+    if (ids.length === 1) {
+      const bean = await getBeanById(backend, ids[0]);
+      if (!force && bean.status !== "draft" && bean.status !== "scrapped") {
+        throw new Error("Only draft and scrapped beans are deletable unless force=true");
+      }
+      return makeTextAndStructured(await backend.delete(ids[0]));
+    }
+    const beans = await backend.list();
+    const byId = new Map(beans.map((b) => [b.id, b]));
+    const results = [];
+    for (const id of ids) {
+      const bean = byId.get(id);
+      if (!bean) {
+        results.push({ beanId: id, deleted: false, error: "Bean not found" });
+        continue;
+      }
+      if (!force && bean.status !== "draft" && bean.status !== "scrapped") {
+        results.push({
+          beanId: id,
+          deleted: false,
+          error: "Only draft and scrapped beans are deletable unless force=true"
+        });
+        continue;
+      }
+      try {
+        await backend.delete(id);
+        results.push({ beanId: id, deleted: true });
+      } catch (error48) {
+        results.push({
+          beanId: id,
+          deleted: false,
+          error: error48.message
+        });
+      }
+    }
+    return makeTextAndStructured({
+      results,
+      requestedCount: ids.length,
+      deletedCount: results.filter((r) => r.deleted).length,
+      failedCount: results.filter((r) => !r.deleted).length
+    });
+  };
+}
+function bulkCreateHandler(backend) {
+  return async (input) => {
+    const results = await backend.bulkCreate(input.beans, input.parent);
+    return makeTextAndStructured({
+      results,
+      requestedCount: input.beans.length,
+      successCount: results.filter((r) => r.bean).length,
+      failedCount: results.filter((r) => r.error).length
+    });
+  };
+}
+function bulkUpdateHandler(backend) {
+  return async (input) => {
+    const results = await backend.bulkUpdate(input.beans, input.parent);
+    return makeTextAndStructured({
+      results,
+      requestedCount: input.beans.length,
+      successCount: results.filter((r) => r.bean).length,
+      failedCount: results.filter((r) => r.error).length
+    });
   };
 }
 function queryHandler(backend) {
@@ -31428,7 +31889,12 @@ function registerTools(server, backend) {
     {
       title: "View Bean",
       description: "Fetch full bean details by ID.",
-      inputSchema: external_exports3.object({ beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH) }),
+      inputSchema: external_exports3.object({
+        beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH).optional(),
+        beanIds: external_exports3.array(external_exports3.string().min(1).max(MAX_ID_LENGTH)).optional()
+      }).refine((input) => Boolean(input.beanId) || Array.isArray(input.beanIds) && input.beanIds.length > 0, {
+        message: "Either beanId or beanIds must be provided"
+      }),
       annotations: {
         readOnlyHint: true,
         destructiveHint: false,
@@ -31448,7 +31914,8 @@ function registerTools(server, backend) {
         type: external_exports3.string().min(1).max(MAX_METADATA_LENGTH),
         status: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
         priority: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
-        description: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+        body: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional().describe("Body markdown content"),
+        description: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional().describe("Deprecated alias for body"),
         parent: external_exports3.string().max(MAX_ID_LENGTH).optional()
       }),
       annotations: {
@@ -31517,8 +31984,21 @@ function registerTools(server, backend) {
         clearParent: external_exports3.boolean().optional(),
         blocking: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).optional(),
         blockedBy: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).optional(),
-        body: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional()
-      }),
+        body: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+        bodyAppend: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+        bodyReplace: external_exports3.array(
+          external_exports3.object({
+            old: external_exports3.string().max(MAX_DESCRIPTION_LENGTH),
+            new: external_exports3.string().max(MAX_DESCRIPTION_LENGTH)
+          })
+        ).optional(),
+        ifMatch: external_exports3.string().max(MAX_METADATA_LENGTH).optional()
+      }).refine(
+        (input) => !(input.body !== void 0 && (input.bodyAppend !== void 0 || input.bodyReplace !== void 0)),
+        {
+          message: "body cannot be combined with bodyAppend/bodyReplace"
+        }
+      ),
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -31534,8 +32014,11 @@ function registerTools(server, backend) {
       title: "Delete Bean",
       description: "Delete a bean (intended for draft/scrapped beans).",
       inputSchema: external_exports3.object({
-        beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH),
+        beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH).optional(),
+        beanIds: external_exports3.array(external_exports3.string().min(1).max(MAX_ID_LENGTH)).optional(),
         force: external_exports3.boolean().default(false)
+      }).refine((input) => Boolean(input.beanId) || Array.isArray(input.beanIds) && input.beanIds.length > 0, {
+        message: "Either beanId or beanIds must be provided"
       }),
       annotations: {
         readOnlyHint: false,
@@ -31546,13 +32029,75 @@ function registerTools(server, backend) {
     },
     deleteHandler(backend)
   );
+  const beanCreateItemSchema = external_exports3.object({
+    title: external_exports3.string().min(1).max(MAX_TITLE_LENGTH),
+    type: external_exports3.string().min(1).max(MAX_METADATA_LENGTH),
+    status: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
+    priority: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
+    body: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional().describe("Body markdown content"),
+    description: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional().describe("Deprecated alias for body"),
+    parent: external_exports3.string().max(MAX_ID_LENGTH).optional().describe("Override the top-level parent for this item")
+  });
+  server.registerTool(
+    "beans_bulk_create",
+    {
+      title: "Bulk Create Beans",
+      description: "Create multiple beans in one call. Optionally assign all of them (or a subset) to a shared parent.",
+      inputSchema: external_exports3.object({
+        beans: external_exports3.array(beanCreateItemSchema).min(1),
+        parent: external_exports3.string().max(MAX_ID_LENGTH).optional().describe("Default parent ID applied to any bean that does not specify its own parent")
+      }),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      }
+    },
+    bulkCreateHandler(backend)
+  );
+  const beanUpdateItemSchema = external_exports3.object({
+    beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH),
+    status: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
+    type: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
+    priority: external_exports3.string().max(MAX_METADATA_LENGTH).optional(),
+    parent: external_exports3.string().max(MAX_ID_LENGTH).optional().describe("Override the top-level parent for this item"),
+    clearParent: external_exports3.boolean().optional(),
+    blocking: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).optional(),
+    blockedBy: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).optional(),
+    body: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+    bodyAppend: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+    bodyReplace: external_exports3.array(external_exports3.object({ old: external_exports3.string().max(MAX_DESCRIPTION_LENGTH), new: external_exports3.string().max(MAX_DESCRIPTION_LENGTH) })).optional(),
+    ifMatch: external_exports3.string().max(MAX_METADATA_LENGTH).optional()
+  }).refine(
+    (input) => !(input.body !== void 0 && (input.bodyAppend !== void 0 || input.bodyReplace !== void 0)),
+    { message: "body cannot be combined with bodyAppend/bodyReplace" }
+  );
+  server.registerTool(
+    "beans_bulk_update",
+    {
+      title: "Bulk Update Beans",
+      description: "Update multiple beans in one call. Optionally assign all of them (or a subset) to a shared parent.",
+      inputSchema: external_exports3.object({
+        beans: external_exports3.array(beanUpdateItemSchema).min(1),
+        parent: external_exports3.string().max(MAX_ID_LENGTH).optional().describe("Default parent ID applied to any bean that does not specify its own parent")
+      }),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      }
+    },
+    bulkUpdateHandler(backend)
+  );
   server.registerTool(
     "beans_query",
     {
       title: "Query Beans",
       description: "Unified query tool for refresh, filter, search, and sort operations.",
       inputSchema: external_exports3.object({
-        operation: external_exports3.enum(["refresh", "filter", "search", "sort", "llm_context", "open_config"]).default("refresh"),
+        operation: external_exports3.enum(["refresh", "filter", "search", "sort", "ready", "llm_context", "open_config"]).default("refresh"),
         mode: external_exports3.enum(["status-priority-type-title", "updated", "created", "id"]).optional(),
         statuses: external_exports3.array(external_exports3.string().max(MAX_METADATA_LENGTH)).nullable().optional(),
         types: external_exports3.array(external_exports3.string().max(MAX_METADATA_LENGTH)).nullable().optional(),
@@ -31631,9 +32176,21 @@ var MutableBackend = class {
   delete(id) {
     return this.inner.delete(id);
   }
+  bulkCreate(beans, defaultParent) {
+    return this.inner.bulkCreate(beans, defaultParent);
+  }
+  bulkUpdate(beans, defaultParent) {
+    return this.inner.bulkUpdate(beans, defaultParent);
+  }
   openConfig() {
     return this.inner.openConfig();
   }
+  primeInstructions() {
+    return this.inner.primeInstructions?.() ?? Promise.resolve("");
+  }
+  writeInstructions(instructions) {
+    return this.inner.writeInstructions?.(instructions) ?? Promise.resolve(null);
+  }
   graphqlSchema() {
     return this.inner.graphqlSchema();
   }
@@ -31671,7 +32228,7 @@ async function createBeansMcpServer(opts) {
   const backend = opts.backend || new BeansCliBackend2(opts.workspaceRoot, opts.cliPath || "beans", opts.logDir);
   const server = new McpServer({
     name: opts.name || "beans-mcp-server",
-    version: opts.version || "0.1.0"
+    version: opts.version || PACKAGE_VERSION
   });
   registerTools(server, backend);
   return { server, backend };
@@ -31743,17 +32300,17 @@ function parseCliArgs(argv) {
   }
   return { workspaceRoot, workspaceExplicit, cliPath, port, logDir };
 }
-async function startBeansMcpServer(argv, _resolveRoots) {
+async function startBeansMcpServer(argv, _resolveRoots, _detectBeansVersion) {
   const { BeansCliBackend: BeansCliBackend2 } = await Promise.resolve().then(() => (init_backend(), backend_exports));
   const { StdioServerTransport: StdioServerTransport2 } = await Promise.resolve().then(() => (init_stdio2(), stdio_exports));
   const { workspaceRoot, workspaceExplicit, cliPath, port, logDir } = parseCliArgs(argv);
+  let effectiveWorkspaceRoot = workspaceRoot;
   process.env.BEANS_VSCODE_MCP_PORT = String(port);
   process.env.BEANS_MCP_PORT = String(port);
   try {
-    const version2 = package_default.version ?? "0.0.0-dev";
     const workspaceLabel = workspaceExplicit ? workspaceRoot : "(auto from roots)";
     console.error(
-      `[beans-mcp] v${version2} starting (port=${port}, workspace=${workspaceLabel}, cli=${cliPath}, logDir=${logDir})`
+      `[beans-mcp] v${PACKAGE_VERSION} starting (port=${port}, workspace=${workspaceLabel}, cli=${cliPath}, logDir=${logDir})`
     );
   } catch {
   }
@@ -31770,13 +32327,17 @@ async function startBeansMcpServer(argv, _resolveRoots) {
     const resolver = _resolveRoots ?? resolveWorkspaceFromRoots;
     const rootPath = await resolver(server);
     if (rootPath) {
-      mutable.setInner(new BeansCliBackend2(rootPath, cliPath));
+      mutable.setInner(new BeansCliBackend2(rootPath, cliPath, logDir));
+      effectiveWorkspaceRoot = rootPath;
       try {
         console.error(`[beans-mcp] workspace resolved from roots: ${rootPath}`);
       } catch {
       }
     }
   }
+  const beansVersionDetector = _detectBeansVersion ?? detectBeansCliVersion;
+  void checkVersionCompatibility(cliPath, effectiveWorkspaceRoot, beansVersionDetector).catch(() => {
+  });
 }
 
 // src/index.ts