@selfagency/beans-mcp 0.4.2 → 0.6.0

package/index.js

@@ -14431,7 +14431,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}`);
@@ -14446,7 +14446,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";
@@ -14458,10 +14458,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.
        */
@@ -14760,7 +14759,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({
       /**
@@ -14821,7 +14824,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({
       /**
@@ -15013,6 +15020,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.
        */
@@ -22744,7 +22757,7 @@ var init_utils = __esm({
 });
 
 // src/internal/graphql.ts
-var LIST_BEANS_QUERY, CREATE_BEAN_MUTATION, UPDATE_BEAN_MUTATION, UPDATE_BEAN_MUTATION_WITH_IF_MATCH, 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";
@@ -22772,6 +22785,11 @@ var init_graphql = __esm({
   mutation($id: ID!) {
     deleteBean(id: $id)
   }
+`;
+    LIST_BEANS_TIMESTAMPS_QUERY = `
+  query {
+    beans { id updatedAt }
+  }
 `;
   }
 });
@@ -22783,7 +22801,7 @@ __export(backend_exports, {
 });
 import { execFile } from "child_process";
 import { createReadStream } from "fs";
-import { mkdir, readFile, rm, writeFile } from "fs/promises";
+import { mkdir, readFile, realpath, rename, rm, writeFile } from "fs/promises";
 import { dirname, join, resolve as resolve2 } from "path";
 import { createInterface } from "readline";
 import { promisify } from "util";
@@ -22794,12 +22812,26 @@ var init_backend = __esm({
     init_graphql();
     init_utils();
     execFileAsync = promisify(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.
@@ -22823,7 +22855,7 @@ var init_backend = __esm({
         return resolve2(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");
         }
@@ -22870,6 +22902,26 @@ Output: ${stdout.slice(0, 1e3)}`
         });
         return { initialized: true };
       }
+      async archive() {
+        const { stdout } = await execFileAsync(this.cliPath, ["archive", "--json"], {
+          cwd: this.workspaceRoot,
+          env: this.getSafeEnv(),
+          maxBuffer: 10 * 1024 * 1024,
+          timeout: 3e4
+        });
+        this.invalidateCache();
+        if (!stdout.trim()) {
+          return { archived: true };
+        }
+        try {
+          return JSON.parse(stdout);
+        } catch {
+          return { archived: true, output: stdout.trim() };
+        }
+      }
+      async queryGraphql(query, variables) {
+        return this.executeGraphQL(query, variables);
+      }
       async list(options) {
         const filter = {};
         if (options?.status && options.status.length > 0) {
@@ -22881,10 +22933,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) {
@@ -22893,7 +22983,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, {
@@ -22902,6 +22992,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) {
@@ -22971,6 +23062,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.updateBean;
       }
       async delete(beanId) {
@@ -22980,8 +23072,44 @@ 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 settled = await Promise.allSettled(
+          beans.map(
+            async (item) => this.create({
+              ...item,
+              parent: item.parent ?? defaultParent
+            })
+          )
+        );
+        return settled.map(
+          (result) => result.status === "fulfilled" ? { bean: result.value } : { error: result.reason instanceof Error ? result.reason.message : String(result.reason) }
+        );
+      }
+      async bulkUpdate(beans, defaultParent) {
+        const settled = await Promise.allSettled(
+          beans.map(async ({ beanId, ...updates }) => {
+            const resolvedParent = updates.parent ?? (updates.clearParent ? void 0 : defaultParent);
+            const bean = await this.update(beanId, { ...updates, parent: resolvedParent });
+            return { beanId, bean };
+          })
+        );
+        return settled.map((result, index) => {
+          const beanId = beans[index]?.beanId;
+          if (!beanId) {
+            return { beanId: "unknown", error: "Unknown bean id" };
+          }
+          if (result.status === "fulfilled") {
+            return result.value;
+          }
+          return {
+            beanId,
+            error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+          };
+        });
+      }
       async openConfig() {
         const configPath = join(this.workspaceRoot, ".beans.yml");
         const content = await readFile(configPath, "utf8");
@@ -23015,9 +23143,12 @@ Output: ${stdout.slice(0, 1e3)}`
         const outputPath = resolve2(
           process.env.BEANS_VSCODE_OUTPUT_LOG || join(this.workspaceRoot, ".vscode", "logs", "beans-output.log")
         );
-        const isWithinWorkspace = isPathWithinRoot(this.workspaceRoot, outputPath);
+        const canonicalOutputPath = await realpath(outputPath).catch(() => outputPath);
+        const canonicalWorkspaceRoot = await realpath(this.workspaceRoot).catch(() => resolve2(this.workspaceRoot));
+        const isWithinWorkspace = isPathWithinRoot(canonicalWorkspaceRoot, canonicalOutputPath);
         const vscodeLogDir = process.env.BEANS_VSCODE_LOG_DIR || this.logDir ? resolve2(process.env.BEANS_VSCODE_LOG_DIR || this.logDir || "") : void 0;
-        const isWithinVscodeLogDir = vscodeLogDir ? isPathWithinRoot(vscodeLogDir, outputPath) : false;
+        const canonicalVscodeLogDir = vscodeLogDir ? await realpath(vscodeLogDir).catch(() => resolve2(vscodeLogDir)) : void 0;
+        const isWithinVscodeLogDir = canonicalVscodeLogDir ? isPathWithinRoot(canonicalVscodeLogDir, canonicalOutputPath) : false;
         if (!isWithinWorkspace && !isWithinVscodeLogDir) {
           throw new Error("Output log path must stay within the workspace or VS Code log directory");
         }
@@ -23040,6 +23171,219 @@ 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, '\\"');
+      }
+      shouldQuoteFrontmatterValue(value) {
+        return !/^[A-Za-z0-9._-]+$/.test(value);
+      }
+      parseFrontmatterLine(line) {
+        const separatorIndex = line.indexOf(":");
+        if (separatorIndex <= 0) {
+          return null;
+        }
+        const key = line.slice(0, separatorIndex).trim();
+        if (key.length === 0) {
+          return null;
+        }
+        for (const character of key) {
+          const isAlphaNumericUnderscore = character >= "a" && character <= "z" || character >= "A" && character <= "Z" || character >= "0" && character <= "9" || character === "_";
+          if (!isAlphaNumericUnderscore) {
+            return null;
+          }
+        }
+        const rawValue = line.slice(separatorIndex + 1).trimStart();
+        return { key, rawValue };
+      }
+      buildFrontmatterIndex(frontmatterLines) {
+        const indexByKey = /* @__PURE__ */ new Map();
+        frontmatterLines.forEach((line, index) => {
+          const parsed = this.parseFrontmatterLine(line);
+          if (!parsed) {
+            return;
+          }
+          indexByKey.set(parsed.key, index);
+        });
+        return indexByKey;
+      }
+      serializeFrontmatterValue(key, value) {
+        if (Array.isArray(value)) {
+          return JSON.stringify(value);
+        }
+        if (key === "title") {
+          return this.normalizeFrontmatterTitleValue(value);
+        }
+        if (this.shouldQuoteFrontmatterValue(value)) {
+          return `"${this.escapeForYamlDoubleQuoted(value)}"`;
+        }
+        return value;
+      }
+      deserializeFrontmatterValue(value) {
+        const trimmed = value.trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+          try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed) && parsed.every((item) => typeof item === "string")) {
+              return parsed;
+            }
+          } catch {
+          }
+        }
+        if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+          return trimmed.slice(1, -1).replaceAll('\\"', '"').replaceAll("\\\\", "\\").replaceAll("''", "'");
+        }
+        return trimmed;
+      }
+      splitFrontmatterDocument(content) {
+        const crlfOpen = content.startsWith("---\r\n");
+        const lfOpen = content.startsWith("---\n");
+        const eol = crlfOpen ? "\r\n" : "\n";
+        if (!crlfOpen && !lfOpen) {
+          return { eol: "\n", hasFrontmatter: false, frontmatterLines: [], body: content };
+        }
+        const openEnd = `---${eol}`.length;
+        const closeMarker = `${eol}---`;
+        const closeIdx = content.indexOf(closeMarker, openEnd);
+        if (closeIdx === -1) {
+          return { eol, hasFrontmatter: false, frontmatterLines: [], body: content };
+        }
+        const frontmatter = content.slice(openEnd, closeIdx);
+        const body = content.slice(closeIdx + closeMarker.length);
+        return {
+          eol,
+          hasFrontmatter: true,
+          frontmatterLines: frontmatter.length > 0 ? frontmatter.split(eol) : [],
+          body
+        };
+      }
+      parseFrontmatterFields(frontmatterLines) {
+        const fields = {};
+        for (const line of frontmatterLines) {
+          const parsed = this.parseFrontmatterLine(line);
+          if (!parsed) {
+            continue;
+          }
+          const { valuePart } = this.splitYamlInlineComment(parsed.rawValue);
+          fields[parsed.key] = this.deserializeFrontmatterValue(valuePart);
+        }
+        return fields;
+      }
+      async writeFileAtomically(absolutePath, content) {
+        const tempPath = `${absolutePath}.tmp-${process.pid}-${Date.now()}`;
+        await writeFile(tempPath, content, "utf8");
+        await rename(tempPath, absolutePath);
+      }
+      /**
+       * 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 readFile(absolutePath, "utf8");
@@ -23047,20 +23391,74 @@ Output: ${stdout.slice(0, 1e3)}`
       }
       async editBeanFile(relativePath, content) {
         const absolutePath = this.resolveBeanFilePath(relativePath);
+        const fixed = this.quoteFrontmatterTitles(content);
         await mkdir(dirname(absolutePath), { recursive: true });
-        await writeFile(absolutePath, content, "utf8");
-        return { path: absolutePath, bytes: Buffer.byteLength(content, "utf8") };
+        await writeFile(absolutePath, fixed, "utf8");
+        return { path: absolutePath, bytes: Buffer.byteLength(fixed, "utf8") };
+      }
+      async updateBeanFrontmatter(relativePath, updates) {
+        const absolutePath = this.resolveBeanFilePath(relativePath);
+        const content = await readFile(absolutePath, "utf8");
+        const { eol, hasFrontmatter, frontmatterLines, body } = this.splitFrontmatterDocument(content);
+        const updatedFields = Object.entries(updates).filter(([, value]) => value !== void 0).map(([key]) => key);
+        if (updatedFields.length === 0) {
+          throw new Error("At least one frontmatter field update is required");
+        }
+        const nextLines = [...frontmatterLines];
+        let indexByKey = this.buildFrontmatterIndex(nextLines);
+        for (const [key, value] of Object.entries(updates)) {
+          if (value === void 0) {
+            continue;
+          }
+          const existingIndex = indexByKey.get(key);
+          if (value === null) {
+            if (existingIndex !== void 0) {
+              nextLines.splice(existingIndex, 1);
+              indexByKey = this.buildFrontmatterIndex(nextLines);
+            }
+            continue;
+          }
+          const serialized = `${key}: ${this.serializeFrontmatterValue(key, value)}`;
+          if (existingIndex !== void 0) {
+            const existingLine = nextLines[existingIndex] ?? "";
+            const existingParsed = this.parseFrontmatterLine(existingLine);
+            const commentPart = existingParsed ? this.splitYamlInlineComment(existingParsed.rawValue).commentPart : "";
+            nextLines[existingIndex] = `${serialized}${commentPart}`;
+          } else {
+            nextLines.push(serialized);
+            indexByKey.set(key, nextLines.length - 1);
+          }
+        }
+        const frontmatterBlock = nextLines.length > 0 ? nextLines.join(eol) : "";
+        const nextContent = hasFrontmatter ? `---${eol}${frontmatterBlock}${eol}---${body}` : `---${eol}${frontmatterBlock}${eol}---${eol}${body}`;
+        const fixed = this.quoteFrontmatterTitles(nextContent);
+        await this.writeFileAtomically(absolutePath, fixed);
+        return {
+          path: absolutePath,
+          bytes: Buffer.byteLength(fixed, "utf8"),
+          updatedFields,
+          frontmatter: this.parseFrontmatterFields(this.splitFrontmatterDocument(fixed).frontmatterLines)
+        };
       }
       async createBeanFile(relativePath, content, options) {
         const absolutePath = this.resolveBeanFilePath(relativePath);
+        const fixed = this.quoteFrontmatterTitles(content);
         await mkdir(dirname(absolutePath), { recursive: true });
-        await writeFile(absolutePath, content, {
-          encoding: "utf8",
-          flag: options?.overwrite ? "w" : "wx"
-        });
+        try {
+          await writeFile(absolutePath, fixed, {
+            encoding: "utf8",
+            flag: options?.overwrite ? "w" : "wx"
+          });
+        } catch (error48) {
+          const maybeNodeError = error48;
+          if (maybeNodeError.code === "EEXIST" && !options?.overwrite) {
+            throw new Error("Bean file already exists. Pass overwrite=true to replace it.");
+          }
+          throw error48;
+        }
         return {
           path: absolutePath,
-          bytes: Buffer.byteLength(content, "utf8"),
+          bytes: Buffer.byteLength(fixed, "utf8"),
           created: true
         };
       }
@@ -23073,7 +23471,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));
 }
@@ -23082,7 +23480,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 {
@@ -23108,7 +23506,7 @@ 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
@@ -23116,7 +23514,7 @@ __export(stdio_exports, {
 import process3 from "process";
 var 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";
     init_stdio();
     StdioServerTransport = class {
@@ -27123,7 +27521,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;
@@ -27267,10 +27665,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";
 }
@@ -28559,7 +28957,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";
@@ -28601,7 +28999,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) {
@@ -28813,6 +29211,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();
     }
@@ -28943,7 +29345,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) {
@@ -29549,10 +29953,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() {
@@ -29620,7 +30024,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) {
@@ -29834,7 +30238,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})`);
@@ -29869,7 +30273,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.
@@ -30249,10 +30653,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;
@@ -30266,7 +30670,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 = [];
@@ -30324,7 +30728,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;
@@ -30343,7 +30747,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 = {};
@@ -30967,6 +31371,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();
       }
     }
@@ -31085,6 +31492,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) {
@@ -31133,6 +31543,100 @@ var EMPTY_COMPLETION_RESULT = {
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
 
+// package.json
+var package_default = {
+  name: "@selfagency/beans-mcp",
+  version: "0.6.0",
+  private: false,
+  description: "MCP (Model Context Protocol) server for Beans issue tracker",
+  keywords: [
+    "ai",
+    "beans",
+    "issue-tracker",
+    "mcp",
+    "model-context-protocol"
+  ],
+  homepage: "https://github.com/selfagency/beans-mcp",
+  bugs: {
+    url: "https://github.com/selfagency/beans-mcp/issues"
+  },
+  license: "MIT",
+  author: {
+    name: "Daniel Sieradski",
+    email: "daniel@self.agency",
+    url: "https://self.agency"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/selfagency/beans-mcp.git"
+  },
+  bin: {
+    "beans-mcp": "dist/beans-mcp-server.cjs"
+  },
+  files: [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  scripts: {
+    build: "tsup",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    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.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "@vitest/ui": "4.1.4",
+    husky: "^9.1.7",
+    "lint-staged": "^16.4.0",
+    ora: "^9.3.0",
+    oxfmt: "^0.45.0",
+    oxlint: "^1.60.0",
+    "oxlint-tsgolint": "^0.21.1",
+    tsup: "8.5.1",
+    typescript: "6.0.3",
+    vitepress: "^1.6.4",
+    vitest: "4.1.4",
+    zod: "4.3.6",
+    zx: "^8.8.5"
+  },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "pnpm run lint:fix",
+      "pnpm run format"
+    ]
+  },
+  engines: {
+    node: ">=18"
+  },
+  mcpName: "io.github.selfagency/beans-mcp"
+};
+
 // src/internal/queryHelpers.ts
 function sortBeansInternal(beans, mode) {
   const sorted = [...beans];
@@ -31293,94 +31797,10 @@ var MAX_PATH_LENGTH = 1024;
 
 // src/server/BeansMcpServer.ts
 init_utils();
-
-// package.json
-var package_default = {
-  name: "@selfagency/beans-mcp",
-  version: "0.4.2",
-  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"
-    }
-  },
-  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": "25.5.0",
-    "@vitest/coverage-v8": "^4.1.0",
-    "@vitest/ui": "4.1.0",
-    husky: "^9.1.7",
-    "lint-staged": "^16.3.3",
-    ora: "^9.3.0",
-    oxfmt: "^0.40.0",
-    oxlint: "^1.55.0",
-    "oxlint-tsgolint": "^0.16.0",
-    tsup: "8.5.1",
-    typescript: "^5.9.3",
-    vitest: "4.1.0",
-    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
 var execFileAsync2 = promisify2(execFile2);
 var PACKAGE_VERSION = package_default.version ?? "0.0.0-dev";
+var CLOSED_STATUSES = /* @__PURE__ */ new Set(["completed", "scrapped"]);
+var BEAN_ID_HINT = "Missing required field `beanId`. Did you mean `beanId`?";
 function getSafeCliEnv(env) {
   const whitelist = ["PATH", "HOME", "USER", "LANG", "LC_ALL", "LC_CTYPE", "SHELL"];
   const safeEnv = {};
@@ -31401,7 +31821,8 @@ function extractVersionFromOutput(output) {
   if (!trimmed) {
     return null;
   }
-  const match = trimmed.match(/(?:^|[^\d])v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)/);
+  const versionRegex = /(?:^|[^\d])v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)/;
+  const match = versionRegex.exec(trimmed);
   return match?.[1] ?? null;
 }
 async function detectBeansCliVersion(cliPath, workspaceRoot) {
@@ -31418,10 +31839,10 @@ ${stderr}`);
     return null;
   }
 }
-async function getBeanById(backend, beanId) {
+async function getBeanById(backend, beanId, beans) {
   try {
-    const beans = await backend.list();
-    const found = beans.find((b) => b.id === beanId);
+    const allBeans = beans ?? await backend.list();
+    const found = allBeans.find((b) => b.id === beanId);
     if (!found) {
       throw new Error(`Bean not found: ${beanId}`);
     }
@@ -31430,12 +31851,111 @@ async function getBeanById(backend, beanId) {
     throw new Error(`Failed to fetch bean ${beanId}: ${error48.message}`);
   }
 }
+function collectDescendantBeans(beans, rootBeanId) {
+  const byParent = /* @__PURE__ */ new Map();
+  const byId = new Map(beans.map((bean) => [bean.id, bean]));
+  for (const bean of beans) {
+    if (!bean.parentId) {
+      continue;
+    }
+    const children = byParent.get(bean.parentId) ?? [];
+    children.push(bean.id);
+    byParent.set(bean.parentId, children);
+  }
+  const queue = [...byParent.get(rootBeanId) ?? []];
+  const visited = /* @__PURE__ */ new Set();
+  const descendants = [];
+  while (queue.length > 0) {
+    const currentId = queue.shift();
+    if (!currentId || visited.has(currentId)) {
+      continue;
+    }
+    visited.add(currentId);
+    const currentBean = byId.get(currentId);
+    if (!currentBean) {
+      continue;
+    }
+    descendants.push(currentBean);
+    const children = byParent.get(currentId);
+    if (children && children.length > 0) {
+      queue.push(...children);
+    }
+  }
+  return descendants;
+}
+async function cascadeStatusToDescendants(backend, rootBeanId, targetStatus, options) {
+  const beans = options?.beans ?? await backend.list();
+  const descendants = collectDescendantBeans(beans, rootBeanId);
+  const updatedBeanIds = [];
+  const skippedBeanIds = [];
+  const errors = [];
+  const toUpdate = [];
+  for (const bean of descendants) {
+    if (options?.onlyCurrentStatuses && !options.onlyCurrentStatuses.has(bean.status)) {
+      skippedBeanIds.push(bean.id);
+      continue;
+    }
+    toUpdate.push(bean);
+  }
+  const settled = await Promise.allSettled(
+    toUpdate.map(async (bean) => backend.update(bean.id, { status: targetStatus }))
+  );
+  settled.forEach((result, index) => {
+    const bean = toUpdate[index];
+    if (!bean) {
+      return;
+    }
+    if (result.status === "fulfilled") {
+      updatedBeanIds.push(bean.id);
+      return;
+    }
+    errors.push({
+      beanId: bean.id,
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+    });
+  });
+  return {
+    totalDescendants: descendants.length,
+    updatedBeanIds,
+    skippedBeanIds,
+    errors
+  };
+}
+function completeMarkdownTasks(body) {
+  const lines = body.split(/\r?\n/);
+  let totalTaskCount = 0;
+  let updatedTaskCount = 0;
+  const taskLinePattern = /^\s*(?:[-*+]|\d+\.)\s+\[[ xX]\]/;
+  const uncheckedTaskLinePattern = /^(\s*(?:[-*+]|\d+\.)\s+\[)\s(\].*)$/;
+  const nextLines = lines.map((line) => {
+    if (!taskLinePattern.test(line)) {
+      return line;
+    }
+    totalTaskCount += 1;
+    const uncheckedMatch = uncheckedTaskLinePattern.exec(line);
+    if (!uncheckedMatch) {
+      return line;
+    }
+    updatedTaskCount += 1;
+    return `${uncheckedMatch[1]}x${uncheckedMatch[2]}`;
+  });
+  const nextBody = nextLines.join("\n");
+  return { nextBody, totalTaskCount, updatedTaskCount };
+}
 function initHandler(backend) {
   return async ({ prefix }) => {
     const result = await backend.init(prefix);
     return makeTextAndStructured(result);
   };
 }
+function archiveHandler(backend) {
+  return async () => {
+    if (typeof backend.archive !== "function") {
+      throw new TypeError("Archive is not supported by the current backend");
+    }
+    return makeTextAndStructured(await backend.archive());
+  };
+}
 function viewHandler(backend) {
   return async ({ beanId, beanIds }) => {
     const ids = Array.isArray(beanIds) && beanIds.length > 0 ? beanIds : beanId ? [beanId] : [];
@@ -31450,7 +31970,12 @@ function viewHandler(backend) {
     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 });
+    return makeTextAndStructured({
+      beans: found,
+      missingBeanIds,
+      count: found.length,
+      requestedCount: ids.length
+    });
   };
 }
 async function checkVersionCompatibility(cliPath, workspaceRoot, detector) {
@@ -31468,7 +31993,14 @@ async function checkVersionCompatibility(cliPath, workspaceRoot, detector) {
   }
 }
 function createHandler(backend) {
-  return async (input) => makeTextAndStructured({ bean: await backend.create(input) });
+  return async (input) => {
+    const bean = await backend.create(input);
+    const warnings = input.description !== void 0 ? ["`description` is deprecated; use `body` instead."] : void 0;
+    return makeTextAndStructured({
+      bean,
+      ...warnings ? { warnings } : {}
+    });
+  };
 }
 function editHandler(backend) {
   return async ({
@@ -31482,18 +32014,30 @@ function reopenHandler(backend) {
     requiredCurrentStatus,
     targetStatus
   }) => {
-    const bean = await getBeanById(backend, beanId);
-    if (bean.status !== requiredCurrentStatus) {
-      throw new Error(`Bean ${beanId} is not ${requiredCurrentStatus}`);
+    const beans = await backend.list();
+    const bean = await getBeanById(backend, beanId, beans);
+    if (bean.status === requiredCurrentStatus) {
+      const updatedParentBean = await backend.update(beanId, { status: targetStatus });
+      const cascade = await cascadeStatusToDescendants(backend, beanId, targetStatus, {
+        onlyCurrentStatuses: CLOSED_STATUSES,
+        beans
+      });
+      return makeTextAndStructured({
+        bean: updatedParentBean,
+        cascade: {
+          totalDescendants: cascade.totalDescendants,
+          updatedBeanIds: cascade.updatedBeanIds,
+          skippedBeanIds: cascade.skippedBeanIds,
+          errors: cascade.errors
+        }
+      });
     }
-    return makeTextAndStructured({
-      bean: await backend.update(beanId, { status: targetStatus })
-    });
+    throw new Error(`Bean ${beanId} is not ${requiredCurrentStatus}`);
   };
 }
 function updateHandler(backend) {
-  return async (input) => makeTextAndStructured({
-    bean: await backend.update(input.beanId, {
+  return async (input) => {
+    const updatedBean = await backend.update(input.beanId, {
       status: input.status,
       type: input.type,
       priority: input.priority,
@@ -31505,8 +32049,37 @@ function updateHandler(backend) {
       bodyAppend: input.bodyAppend,
       bodyReplace: input.bodyReplace,
       ifMatch: input.ifMatch
-    })
-  });
+    });
+    const closeStatus = input.status;
+    const shouldCascadeClose = Boolean(closeStatus && CLOSED_STATUSES.has(closeStatus));
+    const cascade = shouldCascadeClose ? await cascadeStatusToDescendants(backend, input.beanId, closeStatus, {
+      beans: await backend.list()
+    }) : null;
+    return makeTextAndStructured({
+      bean: updatedBean,
+      ...cascade ? {
+        cascade: {
+          totalDescendants: cascade.totalDescendants,
+          updatedBeanIds: cascade.updatedBeanIds,
+          skippedBeanIds: cascade.skippedBeanIds,
+          errors: cascade.errors
+        }
+      } : {}
+    });
+  };
+}
+function completeTasksHandler(backend) {
+  return async ({ beanId }) => {
+    const bean = await getBeanById(backend, beanId);
+    const { nextBody, totalTaskCount, updatedTaskCount } = completeMarkdownTasks(bean.body || "");
+    const updatedBean = updatedTaskCount > 0 ? await backend.update(beanId, { body: nextBody }) : bean;
+    return makeTextAndStructured({
+      bean: updatedBean,
+      totalTaskCount,
+      updatedTaskCount,
+      unchangedTaskCount: totalTaskCount - updatedTaskCount
+    });
+  };
 }
 function deleteHandler(backend) {
   return async ({ beanId, beanIds, force }) => {
@@ -31542,7 +32115,11 @@ function deleteHandler(backend) {
         await backend.delete(id);
         results.push({ beanId: id, deleted: true });
       } catch (error48) {
-        results.push({ beanId: id, deleted: false, error: error48.message });
+        results.push({
+          beanId: id,
+          deleted: false,
+          error: error48.message
+        });
       }
     }
     return makeTextAndStructured({
@@ -31553,15 +32130,53 @@ function deleteHandler(backend) {
     });
   };
 }
+function bulkCreateHandler(backend) {
+  return async (input) => {
+    const results = await backend.bulkCreate(input.beans, input.parent);
+    const deprecatedDescriptionCount = input.beans.filter((bean) => bean.description !== void 0).length;
+    return makeTextAndStructured({
+      results,
+      requestedCount: input.beans.length,
+      successCount: results.filter((r) => r.bean).length,
+      failedCount: results.filter((r) => r.error).length,
+      ...deprecatedDescriptionCount > 0 ? {
+        warnings: [
+          `Found ${deprecatedDescriptionCount} bean(s) using deprecated field \`description\`; use \`body\` instead.`
+        ]
+      } : {}
+    });
+  };
+}
+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) {
-  return async (opts) => handleQueryOperation(backend, opts);
+  return async (opts) => {
+    if (opts.operation === "graphql") {
+      if (typeof backend.queryGraphql !== "function") {
+        throw new TypeError("GraphQL passthrough is not supported by the current backend");
+      }
+      const result = await backend.queryGraphql(opts.graphql || "", opts.variables);
+      return makeTextAndStructured({ data: result.data, errors: result.errors ?? [] });
+    }
+    return handleQueryOperation(backend, opts);
+  };
 }
 function beanFileHandler(backend) {
   return async ({
     operation,
     path,
     content,
-    overwrite
+    overwrite,
+    fields
   }) => {
     if (operation === "read") {
       return makeTextAndStructured(await backend.readBeanFile(path));
@@ -31572,6 +32187,9 @@ function beanFileHandler(backend) {
     if (operation === "create") {
       return makeTextAndStructured(await backend.createBeanFile(path, content || "", { overwrite }));
     }
+    if (operation === "update_frontmatter") {
+      return makeTextAndStructured(await backend.updateBeanFrontmatter(path, fields || {}));
+    }
     if (operation === "delete") {
       return makeTextAndStructured(await backend.deleteBeanFile(path));
     }
@@ -31606,6 +32224,21 @@ function registerTools(server, backend) {
     },
     initHandler(backend)
   );
+  server.registerTool(
+    "beans_archive",
+    {
+      title: "Archive Beans",
+      description: "Archive completed or scrapped beans, equivalent to the beans CLI archive command.",
+      inputSchema: external_exports3.object({}),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      }
+    },
+    archiveHandler(backend)
+  );
   server.registerTool(
     "beans_view",
     {
@@ -31615,7 +32248,7 @@ function registerTools(server, backend) {
         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"
+        message: `Either beanId or beanIds must be provided. ${BEAN_ID_HINT}`
       }),
       annotations: {
         readOnlyHint: true,
@@ -31636,7 +32269,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: {
@@ -31654,7 +32288,7 @@ function registerTools(server, backend) {
       title: "Edit Bean Metadata",
       description: "Update bean metadata fields (status/type/priority/parent/blocking).",
       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(),
         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(),
@@ -31662,7 +32296,11 @@ 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()
-      }),
+      }).superRefine((input, ctx) => {
+        if (!input.beanId) {
+          ctx.addIssue({ code: external_exports3.ZodIssueCode.custom, path: ["beanId"], message: BEAN_ID_HINT });
+        }
+      }).transform((input) => ({ ...input, beanId: input.beanId })),
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -31678,10 +32316,14 @@ function registerTools(server, backend) {
       title: "Reopen Bean",
       description: "Reopen a completed or scrapped bean into a non-closed status.",
       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(),
         requiredCurrentStatus: external_exports3.enum(["completed", "scrapped"]),
         targetStatus: external_exports3.string().max(MAX_METADATA_LENGTH).default("todo")
-      }),
+      }).superRefine((input, ctx) => {
+        if (!input.beanId) {
+          ctx.addIssue({ code: external_exports3.ZodIssueCode.custom, path: ["beanId"], message: BEAN_ID_HINT });
+        }
+      }).transform((input) => ({ ...input, beanId: input.beanId })),
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -31697,7 +32339,7 @@ function registerTools(server, backend) {
       title: "Update Bean",
       description: "Update bean metadata fields (status/type/priority/parent/blocking). Consolidated replacement for per-field update tools.",
       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(),
         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(),
@@ -31714,12 +32356,16 @@ function registerTools(server, backend) {
           })
         ).optional(),
         ifMatch: external_exports3.string().max(MAX_METADATA_LENGTH).optional()
+      }).superRefine((input, ctx) => {
+        if (!input.beanId) {
+          ctx.addIssue({ code: external_exports3.ZodIssueCode.custom, path: ["beanId"], message: BEAN_ID_HINT });
+        }
       }).refine(
         (input) => !(input.body !== void 0 && (input.bodyAppend !== void 0 || input.bodyReplace !== void 0)),
         {
           message: "body cannot be combined with bodyAppend/bodyReplace"
         }
-      ),
+      ).transform((input) => ({ ...input, beanId: input.beanId })),
       annotations: {
         readOnlyHint: false,
         destructiveHint: false,
@@ -31739,7 +32385,7 @@ function registerTools(server, backend) {
         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"
+        message: `Either beanId or beanIds must be provided. ${BEAN_ID_HINT}`
       }),
       annotations: {
         readOnlyHint: false,
@@ -31750,25 +32396,122 @@ 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).optional(),
+    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()
+  }).superRefine((input, ctx) => {
+    if (!input.beanId) {
+      ctx.addIssue({ code: external_exports3.ZodIssueCode.custom, path: ["beanId"], message: BEAN_ID_HINT });
+    }
+  }).refine(
+    (input) => !(input.body !== void 0 && (input.bodyAppend !== void 0 || input.bodyReplace !== void 0)),
+    { message: "body cannot be combined with bodyAppend/bodyReplace" }
+  ).transform((input) => ({ ...input, beanId: input.beanId }));
+  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_complete_tasks",
+    {
+      title: "Complete Markdown Tasks",
+      description: "Mark all markdown checklist tasks within a bean as completed.",
+      inputSchema: external_exports3.object({
+        beanId: external_exports3.string().min(1).max(MAX_ID_LENGTH).optional()
+      }).superRefine((input, ctx) => {
+        if (!input.beanId) {
+          ctx.addIssue({ code: external_exports3.ZodIssueCode.custom, path: ["beanId"], message: BEAN_ID_HINT });
+        }
+      }).transform((input) => ({ ...input, beanId: input.beanId })),
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    completeTasksHandler(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", "ready", "llm_context", "open_config"]).default("refresh"),
+        operation: external_exports3.enum(["refresh", "filter", "search", "sort", "ready", "llm_context", "open_config", "graphql"]).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(),
         search: external_exports3.string().max(MAX_TITLE_LENGTH).optional(),
         includeClosed: external_exports3.boolean().optional(),
         tags: external_exports3.array(external_exports3.string().max(MAX_METADATA_LENGTH)).nullable().optional(),
+        graphql: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
+        variables: external_exports3.record(external_exports3.string(), external_exports3.unknown()).optional(),
         writeToWorkspaceInstructions: external_exports3.boolean().optional()
+      }).superRefine((input, ctx) => {
+        if (input.operation === "graphql" && (!input.graphql || input.graphql.trim().length === 0)) {
+          ctx.addIssue({
+            code: external_exports3.ZodIssueCode.custom,
+            path: ["graphql"],
+            message: "graphql query string is required when operation is graphql"
+          });
+        }
       }),
       annotations: {
-        readOnlyHint: true,
+        readOnlyHint: false,
         destructiveHint: false,
-        idempotentHint: true,
+        idempotentHint: false,
         openWorldHint: false
       }
     },
@@ -31780,10 +32523,33 @@ function registerTools(server, backend) {
       title: "Bean File Operations",
       description: "Read, create, edit, or delete files under .beans (operation param).",
       inputSchema: external_exports3.object({
-        operation: external_exports3.enum(["read", "edit", "create", "delete"]),
+        operation: external_exports3.enum(["read", "edit", "create", "delete", "update_frontmatter"]),
         path: external_exports3.string().min(1).max(MAX_PATH_LENGTH),
         content: external_exports3.string().max(MAX_DESCRIPTION_LENGTH).optional(),
-        overwrite: external_exports3.boolean().optional()
+        overwrite: external_exports3.boolean().optional(),
+        fields: external_exports3.object({
+          title: external_exports3.string().max(MAX_TITLE_LENGTH).optional(),
+          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_id: external_exports3.string().max(MAX_ID_LENGTH).nullable().optional(),
+          tags: external_exports3.array(external_exports3.string().max(MAX_METADATA_LENGTH)).nullable().optional(),
+          blocking_ids: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).nullable().optional(),
+          blocked_by_ids: external_exports3.array(external_exports3.string().max(MAX_ID_LENGTH)).nullable().optional(),
+          pr: external_exports3.string().max(MAX_TITLE_LENGTH).nullable().optional(),
+          branch: external_exports3.string().max(MAX_TITLE_LENGTH).nullable().optional()
+        }).optional()
+      }).superRefine((input, ctx) => {
+        if (input.operation === "update_frontmatter") {
+          const fieldCount = Object.values(input.fields || {}).filter((value) => value !== void 0).length;
+          if (fieldCount === 0) {
+            ctx.addIssue({
+              code: external_exports3.ZodIssueCode.custom,
+              path: ["fields"],
+              message: "At least one frontmatter field update is required"
+            });
+          }
+        }
       }),
       annotations: {
         readOnlyHint: false,
@@ -31823,6 +32589,18 @@ var MutableBackend = class {
   init(prefix) {
     return this.inner.init(prefix);
   }
+  archive() {
+    if (typeof this.inner.archive === "function") {
+      return this.inner.archive();
+    }
+    throw new TypeError("Archive is not supported by backend");
+  }
+  queryGraphql(query, variables) {
+    if (typeof this.inner.queryGraphql === "function") {
+      return this.inner.queryGraphql(query, variables);
+    }
+    throw new TypeError("GraphQL passthrough is not supported by backend");
+  }
   list(opts) {
     return this.inner.list(opts);
   }
@@ -31835,6 +32613,12 @@ 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();
   }
@@ -31856,6 +32640,9 @@ var MutableBackend = class {
   editBeanFile(path, content) {
     return this.inner.editBeanFile(path, content);
   }
+  updateBeanFrontmatter(path, updates) {
+    return this.inner.updateBeanFrontmatter(path, updates);
+  }
   createBeanFile(path, content, opts) {
     return this.inner.createBeanFile(path, content, opts);
   }
@@ -31922,6 +32709,16 @@ function parseCliArgs(argv) {
   const envPort = Number.parseInt(process.env.BEANS_VSCODE_MCP_PORT || process.env.BEANS_MCP_PORT || "", 10);
   let port = Number.isInteger(envPort) && envPort > 0 ? envPort : DEFAULT_MCP_PORT;
   let logDir;
+  const parseStrictPositiveInt = (raw, flagName) => {
+    if (!/^\d+$/.test(raw)) {
+      throw new Error(`Invalid value for ${flagName}: ${raw}`);
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+      throw new Error(`Invalid value for ${flagName}: ${raw}`);
+    }
+    return parsed;
+  };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if ((arg === "--workspace" || arg === "--workspace-root") && argv[i + 1]) {
@@ -31935,10 +32732,7 @@ function parseCliArgs(argv) {
       }
       i += 1;
     } else if (arg === "--port" && argv[i + 1]) {
-      const parsedPort = Number.parseInt(argv[i + 1], 10);
-      if (Number.isInteger(parsedPort) && parsedPort > 0) {
-        port = parsedPort;
-      }
+      port = parseStrictPositiveInt(argv[i + 1], "--port");
       i += 1;
     } else if (arg === "--log-dir" && argv[i + 1]) {
       logDir = argv[i + 1];
@@ -32001,6 +32795,7 @@ export {
   DEFAULT_MCP_PORT,
   MAX_ID_LENGTH,
   MAX_METADATA_LENGTH,
+  MAX_PATH_LENGTH,
   MAX_TITLE_LENGTH,
   createBeansMcpServer,
   isPathWithinRoot,