roam-research-mcp 1.6.0 → 2.4.3

package/build/cli/commands/refs.js

@@ -1,8 +1,8 @@
 import { Command } from 'commander';
-import { initializeGraph } from '@roam-research/roam-api-sdk';
-import { API_TOKEN, GRAPH_NAME } from '../../config/environment.js';
 import { SearchOperations } from '../../tools/operations/search/index.js';
 import { printDebug, exitWithError } from '../utils/output.js';
+import { resolveGraph } from '../utils/graph.js';
+import { readStdin } from '../utils/input.js';
 /**
  * Format results grouped by page (default output)
  */
@@ -72,46 +72,77 @@ function parseIdentifier(identifier) {
 }
 export function createRefsCommand() {
     return new Command('refs')
-        .description('Find blocks referencing a page or block')
-        .argument('<identifier>', 'Page title or block UID (use ((uid)) for block refs)')
+        .description('Find all blocks that reference a page, tag, or block')
+        .argument('[identifier]', 'Page title, #tag, [[Page]], or ((block-uid)). Reads from stdin if "-" or omitted.')
         .option('-n, --limit <n>', 'Limit number of results', '50')
         .option('--json', 'Output as JSON array')
         .option('--raw', 'Output raw UID + content lines (no grouping)')
         .option('--debug', 'Show query metadata')
+        .option('-g, --graph <name>', 'Target graph key (for multi-graph mode)')
+        .addHelpText('after', `
+Examples:
+  # Page references
+  roam refs "Project Alpha"               # Blocks linking to page
+  roam refs "#TODO"                       # Blocks with #TODO tag
+
+  # Stdin / Batch references
+  echo "Project A" | roam refs            # Pipe page title
+  cat uids.txt | roam refs --json         # Find refs for multiple UIDs
+
+  # Block references
+  roam refs "((abc123def))"               # Blocks embedding this block
+`)
         .action(async (identifier, options) => {
         try {
-            const graph = initializeGraph({
-                token: API_TOKEN,
-                graph: GRAPH_NAME
-            });
+            const graph = resolveGraph(options, false);
             const limit = parseInt(options.limit || '50', 10);
-            const { block_uid, title } = parseIdentifier(identifier);
-            if (options.debug) {
-                printDebug('Identifier', identifier);
-                printDebug('Parsed', { block_uid, title });
-                printDebug('Options', options);
+            // Determine identifiers
+            let identifiers = [];
+            if (identifier && identifier !== '-') {
+                identifiers = [identifier];
             }
-            const searchOps = new SearchOperations(graph);
-            const result = await searchOps.searchBlockRefs({ block_uid, title });
-            if (options.debug) {
-                printDebug('Total matches', result.matches.length);
-            }
-            // Apply limit
-            const limitedMatches = result.matches.slice(0, limit);
-            // Format output
-            if (options.json) {
-                const jsonOutput = limitedMatches.map(m => ({
-                    uid: m.block_uid,
-                    content: m.content,
-                    page: m.page_title
-                }));
-                console.log(JSON.stringify(jsonOutput, null, 2));
+            else {
+                if (process.stdin.isTTY && identifier !== '-') {
+                    exitWithError('Identifier is required. Use: roam refs <title> or pipe identifiers via stdin');
+                }
+                const input = await readStdin();
+                if (input) {
+                    identifiers = input.split('\n').map(t => t.trim()).filter(Boolean);
+                }
             }
-            else if (options.raw) {
-                console.log(formatRaw(limitedMatches));
+            if (identifiers.length === 0) {
+                exitWithError('No identifiers provided');
             }
-            else {
-                console.log(formatGrouped(limitedMatches));
+            const searchOps = new SearchOperations(graph);
+            // Helper to process a single identifier
+            const processIdentifier = async (id) => {
+                const { block_uid, title } = parseIdentifier(id);
+                if (options.debug) {
+                    printDebug('Identifier', id);
+                    printDebug('Parsed', { block_uid, title });
+                }
+                const result = await searchOps.searchBlockRefs({ block_uid, title });
+                const limitedMatches = result.matches.slice(0, limit);
+                if (options.json) {
+                    return JSON.stringify(limitedMatches.map(m => ({
+                        uid: m.block_uid,
+                        content: m.content,
+                        page: m.page_title
+                    })));
+                }
+                else if (options.raw) {
+                    return formatRaw(limitedMatches);
+                }
+                else {
+                    return formatGrouped(limitedMatches);
+                }
+            };
+            // Execute
+            for (const id of identifiers) {
+                const output = await processIdentifier(id);
+                console.log(output);
+                if (identifiers.length > 1 && !options.json)
+                    console.log('\n---\n');
             }
         }
         catch (error) {

package/build/cli/commands/rename.js

@@ -0,0 +1,58 @@
+import { Command } from 'commander';
+import { updatePage } from '@roam-research/roam-api-sdk';
+import { printDebug, exitWithError } from '../utils/output.js';
+import { resolveGraph } from '../utils/graph.js';
+export function createRenameCommand() {
+    return new Command('rename')
+        .description('Rename a page')
+        .argument('<old-title>', 'Current page title (or use --uid for UID)')
+        .argument('<new-title>', 'New page title')
+        .option('-u, --uid <uid>', 'Use page UID instead of title')
+        .option('-g, --graph <name>', 'Target graph key (multi-graph mode)')
+        .option('--write-key <key>', 'Write confirmation key (non-default graphs)')
+        .option('--debug', 'Show debug information')
+        .addHelpText('after', `
+Examples:
+  # Rename by title
+  roam rename "Old Page Name" "New Page Name"
+
+  # Rename by UID
+  roam rename --uid abc123def "New Page Name"
+
+  # Multi-graph
+  roam rename "Draft" "Published" -g work --write-key confirm
+`)
+        .action(async (oldTitle, newTitle, options) => {
+        try {
+            if (options.debug) {
+                printDebug('Old title', oldTitle);
+                printDebug('New title', newTitle);
+                printDebug('UID', options.uid || 'none (using title)');
+                printDebug('Graph', options.graph || 'default');
+            }
+            const graph = resolveGraph(options, true); // Write operation
+            // Build the page identifier
+            const pageIdentifier = options.uid
+                ? { uid: options.uid }
+                : { title: oldTitle };
+            if (options.debug) {
+                printDebug('Page identifier', pageIdentifier);
+            }
+            const success = await updatePage(graph, {
+                page: pageIdentifier,
+                title: newTitle
+            });
+            if (success) {
+                const identifier = options.uid ? `((${options.uid}))` : `"${oldTitle}"`;
+                console.log(`Renamed ${identifier} → "${newTitle}"`);
+            }
+            else {
+                exitWithError('Failed to rename page (API returned false)');
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            exitWithError(message);
+        }
+    });
+}