roam-research-mcp 1.4.0 → 2.4.0

package/build/tools/schemas.js

@@ -1,11 +1,34 @@
 // Tool definitions and input schemas for Roam Research MCP server
+/**
+ * Multi-graph parameters that are added to all tool schemas
+ * These enable targeting specific graphs and providing write confirmation
+ */
+const multiGraphParams = {
+    graph: {
+        type: 'string',
+        description: 'Target graph key from ROAM_GRAPHS config. Defaults to ROAM_DEFAULT_GRAPH. Only needed in multi-graph mode.'
+    },
+    write_key: {
+        type: 'string',
+        description: 'Write confirmation key. Required for write operations on non-default graphs when write_key is configured.'
+    }
+};
+/**
+ * Helper to add multi-graph params to a schema's properties
+ */
+function withMultiGraphParams(properties) {
+    return {
+        ...properties,
+        ...multiGraphParams
+    };
+}
 export const toolSchemas = {
     roam_add_todo: {
         name: 'roam_add_todo',
         description: 'Add a list of todo items as individual blocks to today\'s daily page in Roam. Each item becomes its own actionable block with todo status.\nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 todos: {
                     type: 'array',
                     items: {
@@ -14,7 +37,7 @@ export const toolSchemas = {
                     },
                     description: 'List of todo items to add'
                 }
-            },
+            }),
             required: ['todos'],
         },
     },
@@ -23,7 +46,7 @@ export const toolSchemas = {
         description: 'Fetch page by title. Returns content in the specified format.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the page. For date pages, use ordinal date formats such as January 2nd, 2025'
@@ -34,7 +57,7 @@ export const toolSchemas = {
                     default: 'raw',
                     description: "Format output as markdown or JSON. 'markdown' returns as string; 'raw' returns JSON string of the page's blocks"
                 }
-            },
+            }),
             required: ['title']
         },
     },
@@ -43,7 +66,7 @@ export const toolSchemas = {
         description: 'Create a new standalone page in Roam with optional content, including structured outlines and tables, using explicit nesting levels and headings (H1-H3). This is the preferred method for creating a new page with an outline in a single step. Best for:\n- Creating foundational concept pages that other pages will link to/from\n- Establishing new topic areas that need their own namespace\n- Setting up reference materials or documentation\n- Making permanent collections of information\n- Creating pages with mixed text and table content in one call.\n**Efficiency Tip:** This tool batches page and content creation efficiently. For adding content to existing pages, use `roam_process_batch_actions` instead.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the new page',
@@ -104,7 +127,7 @@ export const toolSchemas = {
                         required: ['level']
                     }
                 },
-            },
+            }),
             required: ['title'],
         },
     },
@@ -113,7 +136,7 @@ export const toolSchemas = {
         description: 'Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. To create a new page with an outline, use the `roam_create_page` tool instead. The `outline` parameter defines *new* blocks to be created. To nest content under an *existing* block, provide its UID or exact text in `block_text_uid`, and ensure the `outline` array contains only the child blocks with levels relative to that parent. Including the parent block\'s text in the `outline` array will create a duplicate block. Best for:\n- Adding supplementary structured content to existing pages\n- Creating temporary or working outlines (meeting notes, brainstorms)\n- Organizing thoughts or research under a specific topic\n- Breaking down subtopics or components of a larger concept\nBest for simpler, contiguous hierarchical content. For complex nesting (e.g., tables) or granular control over block placement, consider `roam_process_batch_actions` instead.\n**API Usage Note:** This tool performs verification queries after creation. For large outlines (10+ items) or when rate limits are a concern, consider using `roam_process_batch_actions` instead to minimize API calls.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 page_title_uid: {
                     type: 'string',
                     description: 'Title or UID of the page (UID is preferred for accuracy). Leave blank to use the default daily page.'
@@ -153,7 +176,7 @@ export const toolSchemas = {
                         required: ['text', 'level']
                     }
                 }
-            },
+            }),
             required: ['outline']
         }
     },
@@ -162,7 +185,7 @@ export const toolSchemas = {
         description: 'Import nested markdown content into Roam under a specific block. Can locate the parent block by UID (preferred) or by exact string match within a specific page. If a `parent_string` is provided and the block does not exist, it will be created. Returns a nested structure of the created blocks.\n**API Usage Note:** This tool fetches the full nested structure after import for verification. For large imports or when rate limits are a concern, consider using `roam_process_batch_actions` with pre-structured actions instead.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 content: {
                     type: 'string',
                     description: 'Nested markdown content to import'
@@ -189,7 +212,7 @@ export const toolSchemas = {
                     enum: ['first', 'last'],
                     default: 'first'
                 }
-            },
+            }),
             required: ['content']
         }
     },
@@ -198,7 +221,7 @@ export const toolSchemas = {
         description: 'Search for blocks containing a specific tag and optionally filter by blocks that also contain another tag nearby or exclude blocks with a specific tag. This tool supports pagination via the `limit` and `offset` parameters. Use this tool to search for memories tagged with the MEMORIES_TAG.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 primary_tag: {
                     type: 'string',
                     description: 'The main tag to search for (without the [[ ]] brackets)',
@@ -226,7 +249,7 @@ export const toolSchemas = {
                     description: 'Optional: The number of results to skip before returning matches. Useful for pagination. Defaults to 0.',
                     default: 0
                 }
-            },
+            }),
             required: ['primary_tag']
         }
     },
@@ -235,7 +258,7 @@ export const toolSchemas = {
         description: 'Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 status: {
                     type: 'string',
                     description: 'Status to search for (TODO or DONE)',
@@ -253,25 +276,29 @@ export const toolSchemas = {
                     type: 'string',
                     description: 'Optional: Comma-separated list of terms to filter results by exclusion (matches content or page title)'
                 }
-            },
+            }),
             required: ['status']
         }
     },
     roam_search_block_refs: {
         name: 'roam_search_block_refs',
-        description: 'Search for block references within a page or across the entire graph. Can search for references to a specific block or find all block references.',
+        description: 'Search for block references within a page or across the entire graph. Can search for references to a specific block, a page title, or find all block references.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 block_uid: {
                     type: 'string',
-                    description: 'Optional: UID of the block to find references to'
+                    description: 'Optional: UID of the block to find references to (searches for ((uid)) patterns in text)'
+                },
+                title: {
+                    type: 'string',
+                    description: 'Optional: Page title to find references to (uses :block/refs for [[page]] and #tag links)'
                 },
                 page_title_uid: {
                     type: 'string',
                     description: 'Optional: Title or UID of the page to search in (UID is preferred for accuracy). If not provided, searches across all pages.'
                 }
-            }
+            })
         }
     },
     roam_search_hierarchy: {
@@ -279,7 +306,7 @@ export const toolSchemas = {
         description: 'Search for parent or child blocks in the block hierarchy. Can search up or down the hierarchy from a given block.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 parent_uid: {
                     type: 'string',
                     description: 'Optional: UID of the block to find children of'
@@ -298,7 +325,7 @@ export const toolSchemas = {
                     minimum: 1,
                     maximum: 10
                 }
-            }
+            })
             // Note: Validation for either parent_uid or child_uid is handled in the server code
         }
     },
@@ -307,7 +334,7 @@ export const toolSchemas = {
         description: 'Find pages that have been modified today (since midnight), with pagination and sorting options.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 limit: {
                     type: 'integer',
                     description: 'The maximum number of pages to retrieve (default: 50). Use -1 for no limit, but be aware that very large result sets can impact performance.',
@@ -324,7 +351,7 @@ export const toolSchemas = {
                     enum: ['asc', 'desc'],
                     default: 'desc'
                 }
-            }
+            })
         }
     },
     roam_search_by_text: {
@@ -332,7 +359,7 @@ export const toolSchemas = {
         description: 'Search for blocks containing specific text across all pages or within a specific page. This tool supports pagination via the `limit` and `offset` parameters.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 text: {
                     type: 'string',
                     description: 'The text to search for'
@@ -356,7 +383,7 @@ export const toolSchemas = {
                     description: 'Optional: The number of results to skip before returning matches. Useful for pagination. Defaults to 0.',
                     default: 0
                 }
-            },
+            }),
             required: ['text']
         }
     },
@@ -365,7 +392,7 @@ export const toolSchemas = {
         description: 'Search for blocks or pages based on creation or modification dates. Not for daily pages with ordinal date titles.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 start_date: {
                     type: 'string',
                     description: 'Start date in ISO format (YYYY-MM-DD)',
@@ -389,7 +416,7 @@ export const toolSchemas = {
                     description: 'Whether to include the content of matching blocks/pages',
                     default: true,
                 }
-            },
+            }),
             required: ['start_date', 'type', 'scope']
         }
     },
@@ -398,7 +425,7 @@ export const toolSchemas = {
         description: 'Provides the content of the Roam Markdown Cheatsheet resource, optionally concatenated with custom instructions if CUSTOM_INSTRUCTIONS_PATH is set.',
         inputSchema: {
             type: 'object',
-            properties: {},
+            properties: withMultiGraphParams({}),
             required: [],
         },
     },
@@ -407,7 +434,7 @@ export const toolSchemas = {
         description: 'Add a memory or piece of information to remember, stored on the daily page with MEMORIES_TAG tag and optional categories. \nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 memory: {
                     type: 'string',
                     description: 'The memory detail or information to remember'
@@ -418,8 +445,16 @@ export const toolSchemas = {
                         type: 'string'
                     },
                     description: 'Optional categories to tag the memory with (will be converted to Roam tags)'
+                },
+                heading: {
+                    type: 'string',
+                    description: 'Optional heading text to nest the memory under (e.g., "Memories" or "## LLM Memories"). If the heading does not exist on the daily page, it will be created. Ignored if parent_uid is provided.'
+                },
+                parent_uid: {
+                    type: 'string',
+                    description: 'Optional UID of a specific block to nest the memory under. Takes precedence over heading parameter.'
                 }
-            },
+            }),
             required: ['memory']
         }
     },
@@ -428,7 +463,7 @@ export const toolSchemas = {
         description: 'Retrieve all stored memories on page titled MEMORIES_TAG, or tagged block content with the same name. Returns a combined, deduplicated list of memories. Optionally filter blcoks with a specific tag and sort by creation date.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 sort_by: {
                     type: 'string',
                     description: 'Sort order for memories based on creation date',
@@ -439,7 +474,7 @@ export const toolSchemas = {
                     type: 'string',
                     description: 'Include only memories with a specific filter tag. For single word tags use format "tag", for multi-word tags use format "tag word" (without brackets)'
                 }
-            }
+            })
         }
     },
     roam_datomic_query: {
@@ -447,7 +482,7 @@ export const toolSchemas = {
         description: 'Execute a custom Datomic query on the Roam graph for advanced data retrieval beyond the available search tools. This provides direct access to Roam\'s query engine. Note: Roam graph is case-sensitive.\n\n__Optimal Use Cases for `roam_datomic_query`:__\n- __Advanced Filtering (including Regex):__ Use for scenarios requiring complex filtering, including regex matching on results post-query, which Datalog does not natively support for all data types. It can fetch broader results for client-side post-processing.\n- __Highly Complex Boolean Logic:__ Ideal for intricate combinations of "AND", "OR", and "NOT" conditions across multiple terms or attributes.\n- __Arbitrary Sorting Criteria:__ The go-to for highly customized sorting needs beyond default options.\n- __Proximity Search:__ For advanced search capabilities involving proximity, which are difficult to implement efficiently with simpler tools.\n\nList of some of Roam\'s data model Namespaces and Attributes: ancestor (descendants), attrs (lookup), block (children, heading, open, order, page, parents, props, refs, string, text-align, uid), children (view-type), create (email, time), descendant (ancestors), edit (email, seen-by, time), entity (attrs), log (id), node (title), page (uid, title), refs (text).\nPredicates (clojure.string/includes?, clojure.string/starts-with?, clojure.string/ends-with?, <, >, <=, >=, =, not=, !=).\nAggregates (distinct, count, sum, max, min, avg, limit).\nTips: Use :block/parents for all ancestor levels, :block/children for direct descendants only; combine clojure.string for complex matching, use distinct to deduplicate, leverage Pull patterns for hierarchies, handle case-sensitivity carefully, and chain ancestry rules for multi-level queries.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 query: {
                     type: 'string',
                     description: 'The Datomic query to execute (in Datalog syntax). Example: `[:find ?block-string :where [?block :block/string ?block-string] (or [(clojure.string/includes? ?block-string "hypnosis")] [(clojure.string/includes? ?block-string "trance")] [(clojure.string/includes? ?block-string "suggestion")]) :limit 25]`'
@@ -474,7 +509,7 @@ export const toolSchemas = {
                     },
                     description: 'Optional: An array of field paths (e.g., ["block_string", "page_title"]) within each Datomic result object to apply the regex filter to. If not provided, the regex is applied to the stringified full result.'
                 }
-            },
+            }),
             required: ['query']
         }
     },
@@ -483,7 +518,7 @@ export const toolSchemas = {
         description: '**RATE LIMIT EFFICIENT:** This is the most API-efficient tool for multiple block operations. Combine all create/update/delete operations into a single call whenever possible. For intensive page updates or revisions, prefer this tool over multiple sequential calls.\n\nExecutes a sequence of low-level block actions (create, update, move, delete) in a single, non-transactional batch. Actions are executed in the provided order.\n\n**UID Placeholders for Nested Blocks:** Use `{{uid:name}}` syntax for parent-child references within the same batch. The server generates proper random UIDs and returns a `uid_map` showing placeholder→UID mappings. Example: `{ uid: "{{uid:parent1}}", string: "Parent" }` then `{ location: { "parent-uid": "{{uid:parent1}}" }, string: "Child" }`. Response includes `{ success: true, uid_map: { "parent1": "Xk7mN2pQ9" } }`.\n\nFor actions on existing blocks, a valid block UID is required. Note: Roam-flavored markdown, including block embedding with `((UID))` syntax, is supported within the `string` property for `create-block` and `update-block` actions. For actions on existing blocks or within a specific page context, it is often necessary to first obtain valid page or block UIDs. Tools like `roam_fetch_page_by_title` or other search tools can be used to retrieve these UIDs before executing batch actions. For simpler, sequential outlines, `roam_create_outline` is often more suitable.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 actions: {
                     type: 'array',
                     description: 'An array of action objects to execute in order.',
@@ -540,7 +575,7 @@ export const toolSchemas = {
                         required: ['action']
                     }
                 }
-            },
+            }),
             required: ['actions']
         }
     },
@@ -549,7 +584,7 @@ export const toolSchemas = {
         description: 'Fetch a block by its UID along with its hierarchical children down to a specified depth. Returns a nested object structure containing the block\'s UID, text, order, and an array of its children.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 block_uid: {
                     type: 'string',
                     description: 'The UID of the block to fetch.'
@@ -560,7 +595,7 @@ export const toolSchemas = {
                     minimum: 0,
                     maximum: 10
                 }
-            },
+            }),
             required: ['block_uid']
         },
     },
@@ -569,7 +604,7 @@ export const toolSchemas = {
         description: 'Create a table in Roam with specified headers and rows. This tool abstracts the complex nested structure that Roam tables require, making it much easier to create properly formatted tables.\n\n**Why use this tool:**\n- Roam tables require precise nested block structures that are error-prone to create manually\n- Automatically handles the {{[[table]]}} container and nested column structure\n- Validates row/column consistency before execution\n- Converts empty cells to spaces (required by Roam)\n\n**Example:** A table with headers ["", "Column A", "Column B"] and rows [{label: "Row 1", cells: ["A1", "B1"]}] creates a 2x3 table.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 parent_uid: {
                     type: 'string',
                     description: 'The UID of the parent block or page where the table should be created.'
@@ -608,16 +643,39 @@ export const toolSchemas = {
                         required: ['label', 'cells']
                     }
                 }
-            },
+            }),
             required: ['parent_uid', 'headers', 'rows']
         }
     },
+    roam_move_block: {
+        name: 'roam_move_block',
+        description: 'Move a block to a new location (different parent or position). This is a convenience wrapper around `roam_process_batch_actions` for single block moves.',
+        inputSchema: {
+            type: 'object',
+            properties: withMultiGraphParams({
+                block_uid: {
+                    type: 'string',
+                    description: 'The UID of the block to move'
+                },
+                parent_uid: {
+                    type: 'string',
+                    description: 'The UID of the new parent block or page'
+                },
+                order: {
+                    type: ['integer', 'string'],
+                    description: 'Position under the new parent. Can be a number (0-based index) or "first"/"last". Defaults to "last".',
+                    default: 'last'
+                }
+            }),
+            required: ['block_uid', 'parent_uid']
+        }
+    },
     roam_update_page_markdown: {
         name: 'roam_update_page_markdown',
         description: 'Update an existing page with new markdown content using smart diff. Preserves block UIDs where possible and generates minimal changes. This is ideal for:\n- Syncing external markdown files to Roam\n- AI-assisted content updates that preserve references\n- Batch content modifications without losing block references\n\n**How it works:**\n1. Fetches existing page blocks\n2. Matches new content to existing blocks by text similarity\n3. Generates minimal create/update/move/delete operations\n4. Preserves UIDs for matched blocks (keeping references intact)\n\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the page to update'
@@ -631,8 +689,30 @@ export const toolSchemas = {
                     description: 'If true, returns the planned actions without executing them. Useful for previewing changes.',
                     default: false
                 }
-            },
+            }),
             required: ['title', 'markdown']
         }
     },
+    roam_rename_page: {
+        name: 'roam_rename_page',
+        description: 'Rename a page by changing its title. Identifies the page by current title or UID.',
+        inputSchema: {
+            type: 'object',
+            properties: withMultiGraphParams({
+                old_title: {
+                    type: 'string',
+                    description: 'Current title of the page to rename (use this OR uid, not both)'
+                },
+                uid: {
+                    type: 'string',
+                    description: 'UID of the page to rename (use this OR old_title, not both)'
+                },
+                new_title: {
+                    type: 'string',
+                    description: 'New title for the page'
+                }
+            }),
+            required: ['new_title']
+        }
+    },
 };

package/build/tools/tool-handlers.js

@@ -39,6 +39,9 @@ export class ToolHandlers {
     async fetchBlockWithChildren(block_uid, depth) {
         return this.blockRetrievalOps.fetchBlockWithChildren(block_uid, depth);
     }
+    async moveBlock(block_uid, parent_uid, order = 'last') {
+        return this.blockOps.moveBlock(block_uid, parent_uid, order);
+    }
     // Search Operations
     async searchByStatus(status, page_title_uid, include, exclude) {
         return this.searchOps.searchByStatus(status, page_title_uid, include, exclude);
@@ -64,8 +67,8 @@ export class ToolHandlers {
         return handler.execute();
     }
     // Memory Operations
-    async remember(memory, categories) {
-        return this.memoryOps.remember(memory, categories);
+    async remember(memory, categories, heading, parent_uid) {
+        return this.memoryOps.remember(memory, categories, heading, parent_uid);
     }
     async recall(sort_by = 'newest', filter_tag) {
         return this.memoryOps.recall(sort_by, filter_tag);
@@ -93,6 +96,10 @@ export class ToolHandlers {
     async updatePageMarkdown(title, markdown, dryRun = false) {
         return this.pageOps.updatePageMarkdown(title, markdown, dryRun);
     }
+    // Page Rename
+    async renamePage(params) {
+        return this.pageOps.renamePage(params);
+    }
     async getRoamMarkdownCheatsheet() {
         if (this.cachedCheatsheet) {
             return this.cachedCheatsheet;

package/build/utils/helpers.js

@@ -17,3 +17,25 @@ export function formatRoamDate(date) {
     const year = date.getFullYear();
     return `${month} ${day}${getOrdinalSuffix(day)}, ${year}`;
 }
+/**
+ * Resolve relative date keywords to Roam date format.
+ * Returns the original string if not a recognized keyword.
+ */
+export function resolveRelativeDate(input) {
+    const lower = input.toLowerCase().trim();
+    const today = new Date();
+    switch (lower) {
+        case 'today':
+            return formatRoamDate(today);
+        case 'yesterday':
+            const yesterday = new Date(today);
+            yesterday.setDate(today.getDate() - 1);
+            return formatRoamDate(yesterday);
+        case 'tomorrow':
+            const tomorrow = new Date(today);
+            tomorrow.setDate(today.getDate() + 1);
+            return formatRoamDate(tomorrow);
+        default:
+            return input;
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "roam-research-mcp",
-  "version": "1.4.0",
-  "description": "A Model Context Protocol (MCP) server for Roam Research API integration",
+  "version": "2.4.0",
+  "description": "MCP server and CLI for Roam Research",
   "private": false,
   "repository": {
     "type": "git",
@@ -23,31 +23,35 @@
   "type": "module",
   "bin": {
     "roam-research-mcp": "build/index.js",
-    "roam-import": "build/cli/import-markdown.js"
+    "roam": "build/cli/roam.js"
   },
   "files": [
     "build"
   ],
   "scripts": {
-    "build": "echo \"Using custom instructions: .roam/${CUSTOM_INSTRUCTIONS_PREFIX}custom-instructions.md\" && tsc && cat Roam_Markdown_Cheatsheet.md .roam/${CUSTOM_INSTRUCTIONS_PREFIX}custom-instructions.md > build/Roam_Markdown_Cheatsheet.md && chmod 755 build/index.js build/cli/import-markdown.js",
+    "build": "echo \"Using custom instructions: .roam/${CUSTOM_INSTRUCTIONS_PREFIX}custom-instructions.md\" && tsc && cat Roam_Markdown_Cheatsheet.md .roam/${CUSTOM_INSTRUCTIONS_PREFIX}custom-instructions.md > build/Roam_Markdown_Cheatsheet.md && chmod 755 build/index.js build/cli/roam.js",
     "clean": "rm -rf build",
     "watch": "tsc --watch",
     "inspector": "npx @modelcontextprotocol/inspector build/index.js",
     "start": "node build/index.js",
     "prepublishOnly": "npm run clean && npm run build",
-    "release:patch": "npm version patch && git push origin v$(node -p \"require('./package.json').version\")",
-    "release:minor": "npm version minor && git push origin v$(node -p \"require('./package.json').version\")",
-    "release:major": "npm version major && git push origin v$(node -p \"require('./package.json').version\")",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:first": "standard-version --first-release",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.13.2",
     "@roam-research/roam-api-sdk": "^0.10.0",
+    "commander": "^14.0.2",
     "dotenv": "^16.4.7"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
+    "standard-version": "^9.5.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3",
     "vitest": "^3.2.4"

package/build/cli/import-markdown.js

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-import { initializeGraph } from '@roam-research/roam-api-sdk';
-import { API_TOKEN, GRAPH_NAME } from '../config/environment.js';
-import { PageOperations } from '../tools/operations/pages.js';
-import { parseMarkdown } from '../markdown-utils.js';
-/**
- * Flatten nested MarkdownNode[] to flat array with absolute levels
- */
-function flattenNodes(nodes, baseLevel = 1) {
-    const result = [];
-    for (const node of nodes) {
-        result.push({
-            text: node.content,
-            level: baseLevel,
-            ...(node.heading_level && { heading: node.heading_level })
-        });
-        if (node.children.length > 0) {
-            result.push(...flattenNodes(node.children, baseLevel + 1));
-        }
-    }
-    return result;
-}
-/**
- * Read all input from stdin
- */
-async function readStdin() {
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-        chunks.push(chunk);
-    }
-    return Buffer.concat(chunks).toString('utf-8');
-}
-/**
- * Show usage help
- */
-function showUsage() {
-    console.error('Usage: roam-import <page-title>');
-    console.error('');
-    console.error('Reads markdown from stdin and imports to Roam Research.');
-    console.error('');
-    console.error('Examples:');
-    console.error('  cat document.md | roam-import "Meeting Notes"');
-    console.error('  pbpaste | roam-import "Ideas"');
-    console.error('  echo "- Item 1\\n- Item 2" | roam-import "Quick Note"');
-    console.error('');
-    console.error('Environment variables required:');
-    console.error('  ROAM_API_TOKEN   Your Roam Research API token');
-    console.error('  ROAM_GRAPH_NAME  Your Roam graph name');
-}
-async function main() {
-    // Parse CLI arguments
-    const args = process.argv.slice(2);
-    const pageTitle = args[0];
-    if (!pageTitle || pageTitle === '--help' || pageTitle === '-h') {
-        showUsage();
-        process.exit(pageTitle ? 0 : 1);
-    }
-    // Check if stdin is a TTY (no input piped)
-    if (process.stdin.isTTY) {
-        console.error('Error: No input received. Pipe markdown content to this command.');
-        console.error('');
-        showUsage();
-        process.exit(1);
-    }
-    // Read markdown from stdin
-    const markdownContent = await readStdin();
-    if (!markdownContent.trim()) {
-        console.error('Error: Empty input received.');
-        process.exit(1);
-    }
-    // Initialize Roam graph
-    const graph = initializeGraph({
-        token: API_TOKEN,
-        graph: GRAPH_NAME
-    });
-    // Parse markdown to nodes
-    const nodes = parseMarkdown(markdownContent);
-    // Flatten nested structure to content blocks
-    const contentBlocks = flattenNodes(nodes);
-    if (contentBlocks.length === 0) {
-        console.error('Error: No content blocks parsed from input.');
-        process.exit(1);
-    }
-    // Create page with content
-    const pageOps = new PageOperations(graph);
-    const result = await pageOps.createPage(pageTitle, contentBlocks);
-    if (result.success) {
-        console.log(`Created page '${pageTitle}' (uid: ${result.uid})`);
-    }
-    else {
-        console.error(`Failed to create page '${pageTitle}'`);
-        process.exit(1);
-    }
-}
-main().catch((error) => {
-    console.error(`Error: ${error.message}`);
-    process.exit(1);
-});