rootr-cli 0.4.0 → 0.5.0

package/lib/mcp-tools/spreadsheets.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
 
 const CELL_VALUE = z
   .union([z.string(), z.number(), z.boolean(), z.null()])
@@ -32,7 +32,7 @@ export function registerSpreadsheetTools(server) {
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Spreadsheet name/title'),
-        parentId: z.string().optional().describe('Parent folder/node id to create it under'),
+        parentId: z.string().optional().describe(`Parent folder/node id${NODE_TARGET_HINT}`),
         icon: z.string().optional().describe('Emoji icon for the node'),
         data: z
           .object({ sheets: z.array(z.record(z.unknown())).optional() })
@@ -46,6 +46,7 @@ export function registerSpreadsheetTools(server) {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
+        parentId = await resolveOptionalNodeId(client, parentId);
         const result = await client.createSpreadsheet(ws, { name, parentId, icon, data, config });
         return jsonResult(result);
       } catch (err) {
@@ -64,12 +65,13 @@ export function registerSpreadsheetTools(server) {
         'and cell contents.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
       },
     },
     async ({ spreadsheetId }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         const result = await client.getSpreadsheet(spreadsheetId);
         return jsonResult(result);
       } catch (err) {
@@ -88,7 +90,7 @@ export function registerSpreadsheetTools(server) {
         'you want to keep, or prefer rootr_create_sheet / rootr_patch_spreadsheet_cells for incremental changes).',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         sheets: z
           .array(z.record(z.unknown()))
           .optional()
@@ -100,6 +102,7 @@ export function registerSpreadsheetTools(server) {
     async ({ spreadsheetId, sheets, config, icon }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         const result = await client.updateSpreadsheet(spreadsheetId, { sheets, config, icon });
         return jsonResult(result);
       } catch (err) {
@@ -115,7 +118,7 @@ export function registerSpreadsheetTools(server) {
       description: 'Add a new empty sheet (tab) to an existing Rootr (루터) SPREADSHEET, without touching other sheets.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         name: z.string().optional().describe('Sheet name, e.g. "Q1 Budget"'),
         rowCount: z.number().int().min(1).max(10_000).optional().describe('Row count (default 1000)'),
         colCount: z.number().int().min(1).max(500).optional().describe('Column count (default 52)'),
@@ -124,6 +127,7 @@ export function registerSpreadsheetTools(server) {
     async ({ spreadsheetId, name, rowCount, colCount }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         const result = await client.createSheet(spreadsheetId, { name, rowCount, colCount });
         return jsonResult(result);
       } catch (err) {
@@ -141,7 +145,7 @@ export function registerSpreadsheetTools(server) {
         'Call rootr_read_spreadsheet first to get the exact sheetId.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         sheetId: z.string().describe('Sheet id to update'),
         name: z.string().optional().describe('New sheet name'),
         rowCount: z.number().int().min(1).max(10_000).optional(),
@@ -157,6 +161,7 @@ export function registerSpreadsheetTools(server) {
     async ({ spreadsheetId, sheetId, name, rowCount, colCount, rowSizes, colSizes, merges }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         const result = await client.patchSheet(spreadsheetId, sheetId, {
           name,
           rowCount,
@@ -179,13 +184,14 @@ export function registerSpreadsheetTools(server) {
       description: 'Delete one sheet (tab) from a Rootr (루터) SPREADSHEET by sheetId. Not recoverable — read first to confirm.',
       annotations: { readOnlyHint: false, destructiveHint: true },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         sheetId: z.string().describe('Sheet id to delete'),
       },
     },
     async ({ spreadsheetId, sheetId }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         await client.deleteSheet(spreadsheetId, sheetId);
         return jsonResult({ deleted: sheetId });
       } catch (err) {
@@ -204,7 +210,7 @@ export function registerSpreadsheetTools(server) {
         CELLS_GUIDE,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        spreadsheetId: z.string().describe('SPREADSHEET node id'),
+        spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         sheetId: z.string().describe('Sheet id to patch'),
         cells: z
           .record(cellShape.nullable())
@@ -214,6 +220,7 @@ export function registerSpreadsheetTools(server) {
     async ({ spreadsheetId, sheetId, cells }) => {
       try {
         const client = makeClient();
+        spreadsheetId = await resolveNodeId(client, spreadsheetId);
         const result = await client.patchCells(spreadsheetId, sheetId, cells);
         return jsonResult(result);
       } catch (err) {

package/lib/mcp-tools/webhooks.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveOptionalNodeId, NODE_TARGET_HINT } from './shared.js';
 
 const VALID_EVENTS = [
   'document.created',
@@ -60,7 +60,7 @@ export function registerWebhookTools(server) {
         url: z.string().describe('HTTPS endpoint to receive webhook POSTs'),
         events: z.array(z.string()).describe(`Event names to subscribe to, from: ${VALID_EVENTS.join(', ')}`),
         name: z.string().optional().describe('Human-readable name for the webhook'),
-        scopeNodeId: z.string().optional().describe('Restrict to this node and its descendants'),
+        scopeNodeId: z.string().optional().describe(`Node id${NODE_TARGET_HINT} — restrict to this node and its descendants`),
         filterTags: z.array(z.string()).optional().describe('Only fire for nodes carrying one of these tags'),
         debounceSeconds: z.number().optional().describe('Trailing debounce window in seconds (server-capped)'),
         workspace: z
@@ -73,6 +73,7 @@ export function registerWebhookTools(server) {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
+        scopeNodeId = await resolveOptionalNodeId(client, scopeNodeId);
         const result = await client.createWebhook(ws, {
           name,
           url,

package/lib/mcp-tools/whiteboards.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
 
 const shapeShape = z
   .object({
@@ -67,7 +67,7 @@ export function registerWhiteboardTools(server) {
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Whiteboard name/title'),
-        parentId: z.string().optional().describe('Parent folder/node id to create it under'),
+        parentId: z.string().optional().describe(`Parent folder/node id${NODE_TARGET_HINT}`),
         icon: z.string().optional().describe('Emoji icon for the node'),
         scene: z
           .union([sceneShape, excalidrawSceneShape])
@@ -81,6 +81,7 @@ export function registerWhiteboardTools(server) {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
+        parentId = await resolveOptionalNodeId(client, parentId);
         const result = await client.createWhiteboard(ws, { name, parentId, icon, scene, config });
         return jsonResult(result);
       } catch (err) {
@@ -101,13 +102,14 @@ export function registerWhiteboardTools(server) {
         'the current ids.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
-        whiteboardId: z.string().describe('WHITEBOARD node id'),
+        whiteboardId: z.string().describe(`WHITEBOARD node id${NODE_TARGET_HINT}`),
         mode: z.enum(['summary', 'full']).optional().describe('"summary" (default) or "full" (raw elements too)'),
       },
     },
     async ({ whiteboardId, mode }) => {
       try {
         const client = makeClient();
+        whiteboardId = await resolveNodeId(client, whiteboardId);
         const result = await client.getWhiteboard(whiteboardId);
         const { scene, ...rest } = result ?? {};
         if (mode !== 'full') return jsonResult(rest);
@@ -139,7 +141,7 @@ export function registerWhiteboardTools(server) {
         AUTHORING_GUIDE,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        whiteboardId: z.string().describe('WHITEBOARD node id'),
+        whiteboardId: z.string().describe(`WHITEBOARD node id${NODE_TARGET_HINT}`),
         scene: z
           .union([sceneShape, excalidrawSceneShape])
           .optional()
@@ -155,6 +157,7 @@ export function registerWhiteboardTools(server) {
     async ({ whiteboardId, scene, merge, config, icon }) => {
       try {
         const client = makeClient();
+        whiteboardId = await resolveNodeId(client, whiteboardId);
         const result = await client.updateWhiteboard(whiteboardId, { scene, merge, config, icon });
         const { scene: _scene, ...rest } = result ?? {};
         return jsonResult(rest);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Official Rootr CLI + MCP server — read, write, edit and search Rootr documents from the shell or from an AI agent.",
   "type": "module",
   "bin": {