rootr-cli 0.14.1 → 0.17.0

package/lib/mcp-tools/pages.js

@@ -0,0 +1,243 @@
+import { z } from 'zod';
+
+import {
+  jsonResult,
+  errorResult,
+  makeClient,
+  requireWorkspace,
+  resolveNodeId,
+  resolveOptionalNodeId,
+  NODE_TARGET_HINT,
+  NODE_URL_HINT,
+} from './shared.js';
+
+/**
+ * PAGE (web page) tools.
+ *
+ * A Rootr page is an ordered list of typed blocks — that is the safety model:
+ * a published page cannot carry a script or a phishing overlay. The agent's job
+ * is to CHOOSE BLOCKS. The one escape hatch is the `custom` block, whose free
+ * HTML/CSS renders inside a locked-down sandboxed iframe (no scripts, opaque
+ * origin, no network), so even bold CSS stays inside its own box.
+ *
+ * The guide below is repeated (shortened) on every tool, so an agent that only
+ * sees one of these tools still knows the block vocabulary.
+ */
+const BLOCK_GUIDE =
+  'A page is `blocks[]` (ordered, max 200) + `config`. Each block is {id?, type, props}. ' +
+  'You assemble a page from these 15 block types:\n' +
+  '· hero {title, subtitle?, align?:"left"|"center", background?:{kind:"color",color}|{kind:"image",attachmentId}, button?:{label,target}} — the opening banner\n' +
+  '· text {body (markdown), title?} — prose section; markdown is sanitized when rendered\n' +
+  '· features {columns?:1|2|3, items:[{title, body, icon?(emoji)}]} — "what it does" grid\n' +
+  '· gallery {images:[{attachmentId, caption?}]} — images must be workspace attachments (no external image URLs)\n' +
+  '· pricing {plans:[{name, price, period?, features:[string], highlight?, buttonLabel?, target?}]}\n' +
+  '· testimonials {items:[{quote, name, affiliation?}]}\n' +
+  '· faq {items:[{q, a}]}\n' +
+  '· timeline {items:[{date, title, body?}]}\n' +
+  '· cta {title, buttonLabel, target, body?} — closing call to action\n' +
+  '· footer {links:[{label, target}], contact?, copyright?}\n' +
+  '· liveStats {cards:[{label, icon?, source:{nodeId(DATABASE/LOG node), agg:"count"|"sum"|"avg"|"min"|"max", column?}}]} — numbers read LIVE from a table\n' +
+  '· liveTable {source:{nodeId}, columns?:[name], rowLimit?(1-200), orderBy?:{column, dir:"asc"|"desc"}}\n' +
+  '· liveChart {source:{nodeId}, chart:"bar"|"line"|"donut", labelColumn, valueColumn, agg:"count"|"sum"|"avg"}\n' +
+  '· form {formNodeId(FORM node), headline?, submitLabel?} — visitors submit right on the page\n' +
+  '· custom {html, height?(40-4000, default 260)} — free HTML/CSS, rendered inside a locked-down sandboxed iframe ' +
+  '(no scripts, no same-origin, no network). Use it for a look the other blocks cannot make. Page theme colors are ' +
+  'available inside as var(--pg-bg|text|muted|faint|card|line|accent|on-accent) and var(--pg-font). Scripts and ' +
+  'on*= handlers are stripped on save — do not put behaviour here, only markup and CSS.\n' +
+  'LIVE/FORM BLOCKS: `source.nodeId` / `formNodeId` must be a node in the SAME workspace, and `column`/`labelColumn`/' +
+  '`valueColumn`/`orderBy.column` are the column NAMES as shown in the table (not column ids). A table or form that ' +
+  'sits in a PRIVATE subtree is silently skipped on the published page — that is deliberate, never a bug to work around.\n' +
+  'LINKS: every `target` is {kind:"url", href} (absolute http(s)://, mailto: or tel: only) or {kind:"node", nodeId} ' +
+  'for a document in the same workspace. Internal path strings are rejected. A node link renders as the in-app ' +
+  'document for members, as the public address on the published page, and is hidden entirely if that document is ' +
+  'not published — so link to nodes rather than pasting addresses.\n' +
+  'CONFIG: {theme, accentColor?, navEnabled?}. theme is one of classic | minimal | warm | pastel | editorial | mono | ' +
+  'dark | midnight. accentColor is a hex like "#1A4A7A"; leave it out and the theme picks a matching accent. ' +
+  'Every published page carries the Rootr signature at the bottom.\n' +
+  'Block ids are optional — omit them and they are generated. Keep the ids you get back if you want to edit one block later.';
+
+/** PAGE (block-assembled web page) node tools: create/read/update/append + live values. */
+export function registerPageTools(server) {
+  server.registerTool(
+    'rootr_create_page',
+    {
+      title: 'Create a Rootr page (block-assembled web page)',
+      description:
+        'Create a new PAGE node in a Rootr (루터) workspace — a web page assembled from safe typed blocks, which ' +
+        'can then be published to the web at a public address (see rootr_publish_node). Use this when someone asks ' +
+        'for a landing page, an announcement page, an event page, a product/pricing page or a signup page. ' +
+        'Omit `blocks` to start from a hero/text/footer skeleton. ' +
+        BLOCK_GUIDE +
+        ' ' +
+        NODE_URL_HINT +
+        ' (that is the editor address; use rootr_publish_node for the public address.)',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        name: z.string().optional().describe('Page name (also the browser tab title of the published page)'),
+        parentId: z.string().optional().describe(`Parent folder/node id${NODE_TARGET_HINT}`),
+        path: z.string().optional().describe('Full path including the name, e.g. "/마케팅/가을 행사" — wins over parentId+name'),
+        createParents: z.boolean().optional().describe('Create missing parent folders in `path`'),
+        autoRename: z.boolean().optional().describe('On a name clash, append " (2)" instead of failing with 409'),
+        icon: z.string().optional().describe('Emoji icon for the page node'),
+        blocks: z.array(z.record(z.unknown())).optional().describe('Ordered blocks — see the block vocabulary in this description'),
+        config: z
+          .record(z.unknown())
+          .optional()
+          .describe('{theme, accentColor?, navEnabled?} — theme: classic|minimal|warm|pastel|editorial|mono|dark|midnight'),
+        workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
+      },
+    },
+    async ({ name, parentId, path, createParents, autoRename, icon, blocks, config, workspace }) => {
+      try {
+        const ws = requireWorkspace(workspace);
+        const client = makeClient(ws);
+        parentId = await resolveOptionalNodeId(client, parentId);
+        return jsonResult(
+          await client.createPage(ws, { name, parentId, path, createParents, autoRename, icon, blocks, config }),
+        );
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_read_page',
+    {
+      title: 'Read a Rootr page',
+      description:
+        'Read a Rootr (루터) PAGE node — its full blocks array and config. Read this before rootr_update_page or ' +
+        'rootr_update_page_block so you know the current block ids, order and contents.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+      },
+    },
+    async ({ pageId }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        return jsonResult(await client.getPage(pageId));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_append_page_blocks',
+    {
+      title: 'Append blocks to a Rootr page (preferred way to add sections)',
+      description:
+        'Append one or more blocks to the END of a Rootr (루터) PAGE, leaving existing blocks untouched. ' +
+        'PREFER this over rootr_update_page when you are only adding sections — update replaces the whole page. ' +
+        BLOCK_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+        blocks: z.array(z.record(z.unknown())).describe('Blocks to append, in order'),
+      },
+    },
+    async ({ pageId, blocks }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        return jsonResult(await client.appendPageBlocks(pageId, blocks));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_update_page',
+    {
+      title: 'Update a Rootr page (blocks/theme)',
+      description:
+        'Update a Rootr (루터) PAGE. Passing `blocks` REPLACES THE WHOLE PAGE — call rootr_read_page first and ' +
+        'resend every block you want to keep, or use rootr_append_page_blocks / rootr_update_page_block for ' +
+        'incremental edits. Passing only `config` changes the theme/accent without touching content. ' +
+        BLOCK_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+        blocks: z
+          .array(z.record(z.unknown()))
+          .optional()
+          .describe('COMPLETE blocks array to set — any block you omit is deleted'),
+        config: z.record(z.unknown()).optional().describe('{theme, accentColor?, navEnabled?}'),
+      },
+    },
+    async ({ pageId, blocks, config }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        return jsonResult(await client.updatePage(pageId, { blocks, config }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_update_page_block',
+    {
+      title: 'Edit one block of a Rootr page',
+      description:
+        'Replace the props of a SINGLE block on a Rootr (루터) PAGE, leaving every other block alone — the safe way ' +
+        'to fix one section (a headline, a price, a live table source). The block keeps its id and position. ' +
+        'Get block ids from rootr_read_page. ' +
+        BLOCK_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+        blockId: z.string().describe('Block id, from rootr_read_page'),
+        props: z.record(z.unknown()).describe('COMPLETE props object for this block type (replaces the old props)'),
+        type: z.string().optional().describe('Change the block type too (rare) — props must then match the new type'),
+      },
+    },
+    async ({ pageId, blockId, props, type }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        const page = await client.getPage(pageId);
+        const blocks = Array.isArray(page.blocks) ? page.blocks : [];
+        const idx = blocks.findIndex((b) => b && b.id === blockId);
+        if (idx === -1) {
+          // 있는 id를 알려 준다 — 못 찾았다고만 하면 다음 시도도 똑같이 틀린다.
+          const ids = blocks.map((b) => `${b.id}(${b.type})`).join(', ') || '(none)';
+          return errorResult(new Error(`block "${blockId}" not found on this page. Blocks: ${ids}`));
+        }
+        const next = blocks.map((b, i) => (i === idx ? { ...b, ...(type ? { type } : {}), props } : b));
+        return jsonResult(await client.updatePage(pageId, { blocks: next }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_read_page_live_data',
+    {
+      title: 'Read what a page\'s live blocks currently show',
+      description:
+        'Read the values a Rootr (루터) PAGE\'s live blocks (liveStats/liveTable/liveChart) are showing right now — ' +
+        'the aggregates, rows and chart points computed from their source tables. Use it to check that a live block ' +
+        'points at the right table and column: an empty result usually means the source is missing, is in a PRIVATE ' +
+        'subtree, or the column name does not match.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+      },
+    },
+    async ({ pageId }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        return jsonResult(await client.getPageLiveData(pageId));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+}

package/lib/mcp-tools/presentations.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 /**
  * Authoring guide, repeated (shortened) across every tool description so an
@@ -123,7 +123,9 @@ export function registerPresentationTools(server) {
       description:
         'Create a new PRESENTATION node (a slide deck) in a Rootr (루터) workspace, optionally seeded with an ' +
         'initial theme and slides. ' +
-        AUTHORING_GUIDE,
+        AUTHORING_GUIDE +
+        ' ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Deck name/title'),

package/lib/mcp-tools/recordings.js

@@ -4,7 +4,7 @@ import { basename, extname, join, isAbsolute } from 'node:path';
 
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 import { RootrApiError } from '../client.js';
 
 /** 100MB — the backend's hard limit on a single audio upload. */
@@ -68,7 +68,8 @@ export function registerRecordingTools(server) {
         'speech-to-text; nothing is transcribed until you call it) → poll rootr_read_recording until status is ' +
         'READY → read the transcript (and optionally name the speakers with rootr_rename_recording_speakers) → ' +
         'write the minutes yourself with rootr_write, or call rootr_summarize_recording to use Rootr\'s built-in ' +
-        'summarizer.',
+        'summarizer. ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Recording name/title, e.g. "2026-07-21 주간회의"'),
@@ -208,6 +209,7 @@ export function registerRecordingTools(server) {
         'UPLOADED = audio stored but no transcript yet — call rootr_transcribe_recording to create one; ' +
         'TRANSCRIBING = speech-to-text still running (poll again later); ' +
         'READY = transcript available; FAILED = last transcription errored (see `error`).',
+      annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         recordingId: z.string().describe(`RECORDING node id${NODE_TARGET_HINT}`),
       },
@@ -242,6 +244,7 @@ export function registerRecordingTools(server) {
         'Assign display names to the diarized speaker labels of a Rootr (루터) RECORDING node, e.g. ' +
         '{"S1":"김대표","S2":"이팀장"}. Merge-patch: only the keys you send change. The names apply to the ' +
         'transcript everywhere (web UI, rootr_read_recording, knowledge graph).',
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
       inputSchema: {
         recordingId: z.string().describe(`RECORDING node id${NODE_TARGET_HINT}`),
         speakerNames: z

package/lib/mcp-tools/shared.js

@@ -10,6 +10,15 @@ import { resolveTarget, requireResolved } from '../resolve.js';
  */
 export const NODE_TARGET_HINT = ', or its path starting with "/", or a full rootr.io URL';
 
+/**
+ * ISSUE-103 — every node create/read tool's result carries `url` (the address
+ * to hand a human) and `routeSegment` (the URL segment, in case `url` is
+ * missing). Never guess the segment yourself: DOCUMENT/db/log/sheet/whiteboard/
+ * form/issues/deck/crm/rec are all different, and SIGNED reuses DOCUMENT's 'd'.
+ */
+export const NODE_URL_HINT =
+  'The result includes `url` — the address to open this node at. Use it as-is; never guess or construct it.';
+
 /**
  * Resolve a path-or-id argument to a node id. Paths go through the by-path
  * endpoint; anything else is already an id and is passed through untouched.

package/lib/mcp-tools/signed.js

@@ -9,6 +9,7 @@ import {
   resolveNodeId,
   resolveOptionalNodeId,
   NODE_TARGET_HINT,
+  NODE_URL_HINT,
 } from './shared.js';
 
 /**
@@ -77,7 +78,9 @@ export function registerSignedDocTools(server) {
         '문서, 연구노트, 점검 기록, 회의 확인서. ' +
         'Flow: create (body + approval line) → edit the body freely with rootr_write/rootr_append → ' +
         'rootr_request_signing_code → ask the human for the 6-digit code → rootr_submit_signed_document ' +
-        '(freezes + first signature) → each remaining signer does request-code + rootr_sign_document.',
+        '(freezes + first signature) → each remaining signer does request-code + rootr_sign_document. ' +
+        NODE_URL_HINT +
+        ' (SIGNED opens on the DOCUMENT screen, not a dedicated one.)',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('문서 이름, 예: "2026-08-25 실험 기록"'),

package/lib/mcp-tools/spreadsheets.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 const CELL_VALUE = z
   .union([z.string(), z.number(), z.boolean(), z.null()])
@@ -28,7 +28,9 @@ export function registerSpreadsheetTools(server) {
         'Create a new SPREADSHEET node (a grid with formulas) in a Rootr (루터) workspace. Use SPREADSHEET when ' +
         'content needs calculation (budgets, models, estimates) — for plain tracked lists use DATABASE instead. ' +
         'Defaults to a single empty "Sheet1" if no `data` is given. ' +
-        CELLS_GUIDE,
+        CELLS_GUIDE +
+        ' ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Spreadsheet name/title'),
@@ -60,7 +62,8 @@ export function registerSpreadsheetTools(server) {
     {
       title: 'Read a Rootr spreadsheet',
       description:
-        'Read a Rootr (루터) SPREADSHEET node — its sheets, each with a sparse `cells` map and dimensions. Call ' +
+        'Read a Rootr (루터) SPREADSHEET node — returns { data: { sheets: [...] }, ... }, where each sheet has ' +
+        'a sparse `cells` map and dimensions (sheets are under `data.sheets`, not top-level `sheets`). Call ' +
         'this before rootr_update_spreadsheet / rootr_patch_spreadsheet_cells so you know the current sheetIds ' +
         'and cell contents.',
       annotations: { readOnlyHint: true, destructiveHint: false },
@@ -88,7 +91,8 @@ export function registerSpreadsheetTools(server) {
         'Merge-patch a Rootr (루터) SPREADSHEET: update config/icon, or REPLACE THE WHOLE sheets array (if you ' +
         'pass `sheets`, it replaces every existing sheet — call rootr_read_spreadsheet first and resend sheets ' +
         'you want to keep, or prefer rootr_create_sheet / rootr_patch_spreadsheet_cells for incremental changes).',
-      annotations: { readOnlyHint: false, destructiveHint: false },
+      // `sheets`를 주면 시트 배열 전체를 갈아끼운다 — 안 보낸 시트는 사라진다.
+      annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
       inputSchema: {
         spreadsheetId: z.string().describe(`SPREADSHEET node id${NODE_TARGET_HINT}`),
         sheets: z

package/lib/mcp-tools/templates.js

@@ -132,7 +132,8 @@ export function registerTemplateTools(server) {
         'Change a Rootr (루터) template — its name, emoji, description or `spec`. Editing a builtin transparently ' +
         'creates a workspace copy, so the builtin itself is never damaged. Use this for "change the standard format" ' +
         'requests instead of saving a second near-identical template.',
-      annotations: { readOnlyHint: false, destructiveHint: false },
+      // `spec`을 주면 템플릿 정의를 통째로 덮어쓴다(버전 기록 없음).
+      annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
       inputSchema: {
         templateId: z.string().describe('Template id from rootr_list_templates'),
         name: z.string().optional().describe('New name'),

package/lib/mcp-tools/whiteboards.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 const shapeShape = z
   .object({
@@ -63,7 +63,9 @@ export function registerWhiteboardTools(server) {
         'Create a new WHITEBOARD node (a freeform visual canvas) in a Rootr (루터) workspace, optionally seeded ' +
         'with an initial scene. Use WHITEBOARD for flow diagrams, brainstorming, journey maps — not for anything ' +
         'that needs typed/trackable rows (use DATABASE) or calculation (use SPREADSHEET). ' +
-        AUTHORING_GUIDE,
+        AUTHORING_GUIDE +
+        ' ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Whiteboard name/title'),
@@ -139,7 +141,8 @@ export function registerWhiteboardTools(server) {
         'content). merge=false/omitted REPLACES the whole scene — call rootr_read_whiteboard first and resend ' +
         'anything you want to keep. ' +
         AUTHORING_GUIDE,
-      annotations: { readOnlyHint: false, destructiveHint: false },
+      // merge=false 면 장면 전체를 갈아끼운다 — 사람이 손으로 그린 것까지 날아간다.
+      annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
       inputSchema: {
         whiteboardId: z.string().describe(`WHITEBOARD node id${NODE_TARGET_HINT}`),
         scene: z

package/lib/mcp-tools/workspaces.js

@@ -118,12 +118,12 @@ export function registerWorkspaceTools(server) {
         }
         const cfg = loadConfig();
         const candidates = candidateClients(cfg);
-        // Probing costs one API call per workspace (they count against the
-        // daily read quota), so only do it in the case it actually diagnoses:
-        // no account key registered, i.e. every credential here is scoped to
-        // one workspace and most of the list is unusable.
+        // Probe only matters as a fallback for servers that predate the
+        // `accessible` field on GET /workspaces — surveyWorkspaces() reads
+        // that field for free when present, so this no longer costs extra
+        // API calls in the normal case.
         const probe = !cfg.apiKey && (cfg.keys || []).length > 0;
-        const { workspaces, reachable, failures } = await surveyWorkspaces(candidates, { probe });
+        const { workspaces, reachable, failures, probed } = await surveyWorkspaces(candidates, { probe });
         if (!workspaces.length) {
           return textResult(
             (failures ? '등록된 키로 워크스페이스 목록을 조회하지 못했습니다 (키 만료/취소 가능성).\n' : '이 컴퓨터에 등록된 Rootr 키가 없습니다.\n') +
@@ -133,13 +133,14 @@ export function registerWorkspaceTools(server) {
         const rows = workspaces.map(
           (w) =>
             `${w.id === cfg.workspace ? '* ' : '  '}${w.id}\t${w.name || w.slug || ''}` +
-            (!probe || reachable.has(w.id) ? '' : '\t[등록된 키로는 접근 불가]'),
+            (!probed || reachable.has(w.id) ? '' : '\t[등록된 키로는 접근 불가]'),
         );
-        const blocked = probe && workspaces.some((w) => !reachable.has(w.id));
+        const blocked = probed && workspaces.some((w) => !reachable.has(w.id));
         return textResult(
           `${rows.join('\n')}\n\n(* = 현재 워크스페이스, rootr_use_workspace 로 전환)` +
             (blocked
               ? '\n"접근 불가" = 내 소속 워크스페이스지만 등록된 키가 워크스페이스 전용이라 못 엽니다. ' +
+                '쓰기 전에 이 목록에서 "접근 불가"가 없는 워크스페이스만 고르세요. ' +
                 '계정 키(PAT)를 등록하면 전부 열립니다: rootr.io > 설정 > API 키 → `rootr config --api-key <키>`'
               : ''),
         );

package/lib/mcp.js

@@ -13,6 +13,7 @@ import { registerMiscTools } from './mcp-tools/misc.js';
 import { registerPublicTools } from './mcp-tools/public.js';
 import { registerCrmTools } from './mcp-tools/crm.js';
 import { registerPresentationTools } from './mcp-tools/presentations.js';
+import { registerPageTools } from './mcp-tools/pages.js';
 import { registerSpreadsheetTools } from './mcp-tools/spreadsheets.js';
 import { registerWhiteboardTools } from './mcp-tools/whiteboards.js';
 import { registerFormTools } from './mcp-tools/forms.js';
@@ -261,6 +262,7 @@ export function buildMcpServer({ name, version }) {
   registerPublicTools(server);
   registerCrmTools(server);
   registerPresentationTools(server);
+  registerPageTools(server);
   registerSpreadsheetTools(server);
   registerWhiteboardTools(server);
   registerFormTools(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.14.1",
+  "version": "0.17.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": {