@selfagency/beans-mcp 0.4.2 → 0.5.0

package/index.d.ts

@@ -57,6 +57,8 @@ interface BackendInterface {
         type: string;
         status?: string;
         priority?: string;
+        /** Body markdown content. `description` is a deprecated alias. */
+        body?: string;
         description?: string;
         parent?: string;
     }): Promise<BeanRecord>;
@@ -77,6 +79,39 @@ interface BackendInterface {
         ifMatch?: string;
     }): Promise<BeanRecord>;
     delete(beanId: string): Promise<Record<string, unknown>>;
+    bulkCreate(beans: Array<{
+        title: string;
+        type: string;
+        status?: string;
+        priority?: string;
+        body?: string;
+        description?: string;
+        parent?: string;
+    }>, defaultParent?: string): Promise<Array<{
+        bean?: BeanRecord;
+        error?: string;
+    }>>;
+    bulkUpdate(beans: Array<{
+        beanId: string;
+        status?: string;
+        type?: string;
+        priority?: string;
+        parent?: string;
+        clearParent?: boolean;
+        blocking?: string[];
+        blockedBy?: string[];
+        body?: string;
+        bodyAppend?: string;
+        bodyReplace?: Array<{
+            old: string;
+            new: string;
+        }>;
+        ifMatch?: string;
+    }>, defaultParent?: string): Promise<Array<{
+        beanId: string;
+        bean?: BeanRecord;
+        error?: string;
+    }>>;
     openConfig(): Promise<{
         configPath: string;
         content: string;
@@ -120,6 +155,14 @@ declare class BeansCliBackend implements BackendInterface {
     private readonly cliPath;
     private readonly logDir?;
     constructor(workspaceRoot: string, cliPath: string, logDir?: string | undefined);
+    /** Full unfiltered records keyed by bean ID, stored under the fixed cache key `'all'`. */
+    private readonly _cache;
+    /** Last time the unfiltered cache entry `'all'` was fetched (ms). */
+    private readonly _cacheTime;
+    /** Short-circuit TTL: skip even the timestamp check within this window (ms). */
+    private static readonly BURST_TTL_MS;
+    /** Invalidate the unfiltered list cache so the next call does a full fetch. */
+    private invalidateCache;
     /**
      * Returns a safe environment for executing the Beans CLI,
      * whitelisting only necessary variables.
@@ -142,6 +185,7 @@ declare class BeansCliBackend implements BackendInterface {
         type: string;
         status?: string;
         priority?: string;
+        body?: string;
         description?: string;
         parent?: string;
     }): Promise<BeanRecord>;
@@ -162,6 +206,39 @@ declare class BeansCliBackend implements BackendInterface {
         ifMatch?: string;
     }): Promise<BeanRecord>;
     delete(beanId: string): Promise<Record<string, unknown>>;
+    bulkCreate(beans: Array<{
+        title: string;
+        type: string;
+        status?: string;
+        priority?: string;
+        body?: string;
+        description?: string;
+        parent?: string;
+    }>, defaultParent?: string): Promise<Array<{
+        bean?: BeanRecord;
+        error?: string;
+    }>>;
+    bulkUpdate(beans: Array<{
+        beanId: string;
+        status?: string;
+        type?: string;
+        priority?: string;
+        parent?: string;
+        clearParent?: boolean;
+        blocking?: string[];
+        blockedBy?: string[];
+        body?: string;
+        bodyAppend?: string;
+        bodyReplace?: Array<{
+            old: string;
+            new: string;
+        }>;
+        ifMatch?: string;
+    }>, defaultParent?: string): Promise<Array<{
+        beanId: string;
+        bean?: BeanRecord;
+        error?: string;
+    }>>;
     openConfig(): Promise<{
         configPath: string;
         content: string;
@@ -176,6 +253,28 @@ declare class BeansCliBackend implements BackendInterface {
         content: string;
         linesReturned: number;
     }>;
+    /**
+     * 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.
+     */
+    private splitYamlInlineComment;
+    /** Returns true when `value` looks like a YAML block scalar indicator (`>`, `|`, `>-`, `|-`, etc.) */
+    private isYamlBlockScalarIndicator;
+    /** Escape a plain string for use inside a YAML double-quoted scalar. */
+    private escapeForYamlDoubleQuoted;
+    /**
+     * 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.
+     */
+    private normalizeFrontmatterTitleValue;
+    /**
+     * 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.
+     */
+    private quoteFrontmatterTitles;
     readBeanFile(relativePath: string): Promise<{
         path: string;
         content: string;