@selfagency/beans-mcp 0.1.4 → 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>;
@@ -69,12 +71,53 @@ interface BackendInterface {
         blocking?: string[];
         blockedBy?: string[];
         body?: string;
+        bodyAppend?: string;
+        bodyReplace?: Array<{
+            old: string;
+            new: string;
+        }>;
+        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;
     }>;
+    primeInstructions?(): Promise<string>;
+    writeInstructions?(instructions: string): Promise<string | null>;
     graphqlSchema(): Promise<string>;
     readOutputLog(options?: {
         lines?: number;
@@ -112,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.
@@ -134,6 +185,7 @@ declare class BeansCliBackend implements BackendInterface {
         type: string;
         status?: string;
         priority?: string;
+        body?: string;
         description?: string;
         parent?: string;
     }): Promise<BeanRecord>;
@@ -146,12 +198,53 @@ declare class BeansCliBackend implements BackendInterface {
         blocking?: string[];
         blockedBy?: string[];
         body?: string;
+        bodyAppend?: string;
+        bodyReplace?: Array<{
+            old: string;
+            new: string;
+        }>;
+        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;
     }>;
+    primeInstructions(): Promise<string>;
+    writeInstructions(instructions: string): Promise<string>;
     graphqlSchema(): Promise<string>;
     readOutputLog(options?: {
         lines?: number;
@@ -160,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;
@@ -202,7 +317,9 @@ declare function parseCliArgs(argv: string[]): {
 };
 declare function startBeansMcpServer(argv: string[], 
 /** For testing only: override the roots resolver so tests can cover the setInner branch. */
-_resolveRoots?: (server: McpServer) => Promise<string | null>): Promise<void>;
+_resolveRoots?: (server: McpServer) => Promise<string | null>, 
+/** For testing only: override Beans CLI version detection. */
+_detectBeansVersion?: (cliPath: string, workspaceRoot: string) => Promise<string | null>): Promise<void>;
 
 /**
  * Check whether `target` is contained within `root` after resolving both paths.