rootr-cli 0.26.0 → 0.30.0

package/lib/mcp-tools/forms.js

@@ -35,6 +35,18 @@ const fieldShape = z
       .boolean()
       .optional()
       .describe('date only: false = a single date (no end-date input). Omitted/true = start + optional end.'),
+    multiple: z
+      .boolean()
+      .optional()
+      .describe('file only: true = accept SEVERAL files; the answer becomes an array of { id, filename, size }. Default: one file.'),
+    maxFiles: z
+      .number()
+      .optional()
+      .describe('file + multiple only: most files one person may attach (1–20, default 10).'),
+    allowImages: z
+      .boolean()
+      .optional()
+      .describe('text/textarea only: let respondents insert images into the answer (stored as ![name](url) markdown inside the text).'),
     showIf: z
       .object({ fieldId: z.string(), equals: z.string() })
       .optional()
@@ -46,7 +58,9 @@ const FIELDS_GUIDE =
   'Fields are typed inputs shown to respondents. Basic: text | textarea | number | select | multi_select | ' +
   'checkbox | date. Contact: email | phone | url (each is format-checked server-side). Survey: rating (stars) | ' +
   'scale (numbered buttons) | csat (1-5) | nps (0-10) | matrix (rows x options, Likert) | ranking (drag order). ' +
-  'Also: time (HH:MM) and file (uploaded on the published page only). ' +
+  'Also: time (HH:MM) and file (one file by default; `multiple: true` + optional `maxFiles` (1-20, default 10) ' +
+  'takes several). `allowImages: true` on a text/textarea question lets people paste/insert images into the ' +
+  'answer (kept as ![name](url) inside the text). ' +
   'select/multi_select/matrix/ranking need `options` ({name,color}[]); matrix also needs `rows`. ' +
   'Per-field extras: `help` (a hint line), `placeholder`, `page` (split into multiple pages), `hidden` + URL ' +
   'params (record the traffic source), `showIf` (show only when an earlier answer matches), `range: false` on a ' +
@@ -217,7 +231,10 @@ export function registerFormTools(server) {
       description:
         'Submit one response to a Rootr (루터) FORM on behalf of the caller (authenticated submission, not the ' +
         'public/anonymous share-link flow). `values` is keyed by field id — call rootr_read_form first to get the ' +
-        'exact field ids and types.',
+        'exact field ids and types. File questions: upload each file first (rootr_upload_attachment, or ' +
+        'rootr_create_upload_url → PUT → rootr_complete_upload) and pass `{ id, filename }` — an ARRAY of those when ' +
+        'the field has `multiple: true` (more than `maxFiles` is refused; several files on a single-file question is ' +
+        'refused). Images in a text answer with `allowImages` go in as markdown: `![name](url)` using the upload\'s url.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         formId: z.string().describe(`FORM node id${NODE_TARGET_HINT}`),
@@ -273,6 +290,7 @@ export function registerFormTools(server) {
       title: 'Fix an already-submitted Rootr form response',
       description:
         'Correct one response that was already submitted to a Rootr (루터) FORM. `values` REPLACES the whole ' +
+        '(file answers too — to add a file to a `multiple` question send the old array plus the new { id, filename }) ' +
         'answer set and is re-checked against the form\'s current fields (required/type rules), so send every ' +
         'answer you want to keep — call rootr_list_form_responses first. Use this instead of deleting and ' +
         're-submitting when you want the original submitter and submission time preserved.',

package/lib/mcp-tools/pages.js

@@ -309,4 +309,41 @@ export function registerPageTools(server) {
       }
     },
   );
+  server.registerTool(
+    'rootr_page_analytics',
+    {
+      title: 'Turn on / read visit tracking for a published page',
+      description:
+        'GA-style visit tracking for a Rootr (루터) PAGE, stored in the workspace itself. action "enable" creates, next to the page, ' +
+        'a folder "<page> · 방문 분석" (Analytics) holding: a LOG node (one entry per visitor action — visit, scroll 25/50/75/90%, ' +
+        'block seen, click, form seen/started/submitted, booking steps, time on page — with channel/utm/referrer/device/browser/' +
+        'country columns), a DATABASE "일별 방문" (Daily visits: one row per KST day — visitors, sessions, new visitors, page views, ' +
+        'avg seconds, read-half/read-to-end sessions, clicks, form submits, bookings, conversions, conversion rate; filled every 15 min), ' +
+        'and a PAGE dashboard of live charts over both. Read the numbers with rootr_read_database (daily table), ' +
+        'rootr_query_log_entries / rootr_log_stats (the log) or rootr_read_page_live_data (the dashboard). ' +
+        'Only the PUBLISHED page records (rootr_publish_node, Team plan); the editor preview never does. "disable" stops recording ' +
+        'and keeps every node. "refresh" recounts the daily table now (default 90 days). "status" (default) returns the node ids, ' +
+        'last visit time and last-7-day totals. Field names follow `locale` (ko|en, first enable only). No cookies; visitors are ' +
+        'random per-page tags, IPs are never stored.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        pageId: z.string().describe(`PAGE node id${NODE_TARGET_HINT}`),
+        action: z.enum(['status', 'enable', 'disable', 'refresh']).optional().describe('default "status"'),
+        locale: z.enum(['ko', 'en']).optional().describe('column/node names on first enable (default ko)'),
+        days: z.number().int().min(1).max(400).optional().describe('refresh: how many days back to recount (default 90)'),
+      },
+    },
+    async ({ pageId, action, locale, days }) => {
+      try {
+        const client = makeClient();
+        pageId = await resolveNodeId(client, pageId);
+        if (action === 'enable') return jsonResult(await client.setPageAnalytics(pageId, { enabled: true, locale }));
+        if (action === 'disable') return jsonResult(await client.setPageAnalytics(pageId, { enabled: false }));
+        if (action === 'refresh') return jsonResult(await client.refreshPageAnalytics(pageId, days));
+        return jsonResult(await client.getPageAnalytics(pageId));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
 }

package/lib/mcp-tools/public.js

@@ -94,6 +94,8 @@ export function registerPublicTools(server) {
         'PLAN_UPGRADE_REQUIRED; a password-locked page is always hidden and cannot be re-exposed until unlocked); ' +
         '`{"design": {"layout": "board", "skin": "paper"}}` changes how a published TABLE looks — it does not ' +
         'have to be a table (cards, gallery, list, board, timeline, calendar, chart, ranking). ' +
+        '`{"seoDescription": "...", "seoImage": "<attachment id>"}` sets the search-result description and link-preview ' +
+        'image (search engines are pinged right away). ' +
         '`{"isPublic": true}` on a PAGE needs the Team plan (Free → 403 PLAN_UPGRADE_REQUIRED); closing it works on any plan. ' +
         'For DOCUMENT nodes use rootr_set_document_public instead — documents keep their own settings (skins, ' +
         'edit proposals) on the older path. Owner-level action (MANAGE): use an account key (PAT).',
@@ -106,6 +108,17 @@ export function registerPublicTools(server) {
         noIndex: z.boolean().optional(),
         expiresAt: z.string().nullable().optional().describe('ISO date, or null to clear'),
         password: z.string().nullable().optional().describe('null or "" removes the lock'),
+        seoDescription: z
+          .string()
+          .max(300)
+          .nullable()
+          .optional()
+          .describe('Search-result / link-preview description (~160 chars recommended). null or "" falls back to the opening text.'),
+        seoImage: z
+          .string()
+          .nullable()
+          .optional()
+          .describe('Link-preview cover image: an image attachment id from the same workspace (rootr_upload_attachment). null removes it.'),
         view: z.string().optional().describe('DATABASE only: view id the public page opens with'),
         design: DB_DESIGN_SCHEMA.optional().describe(
           'DATABASE only: how the public page presents the table. `layout` — table, cards, gallery, list, ' +

package/lib/mcp-tools/workspaces.js

@@ -43,7 +43,7 @@ const ACCESS_HINT =
   'property needs `dimensions` (an embedding column agents fill with rootr_set_row_vectors). ' +
   'A phone/email/name property may carry `dedupe: true` (warn when the same person is entered again) with ' +
   '`dedupeShow: ["상태","메모","통화 기록"]` (fields of the existing row the warning shows — a relation shows its latest 5 rows) and ' +
-  '`dedupeCarry: { label: "재등록", auto: true, exclude: ["접수일"], mark: { "재등록 여부": true, "구분": { map: { "A": "A(재등록)" }, else: "재등록" } } }` ' +
+  '`dedupeCarry: { label: "재등록", action: "carry"|"merge_into_old"|"merge_all"|"ask", sources: "all", columns: { "메모": { append: { sep: " / " } } }, exclude: ["접수일"], mark: { "재등록 여부": true, "구분": { map: { "A": "A(재등록)" }, else: "{value} (재등록)" } }, cases: [{ when: { within: { column: "접수일", days: 0 } }, action: "merge_all", mark: {} }, { action: "carry" }] }` ' +
   '(same entry came back: copy the earlier row into the new one — see rootr_update_column); any property may carry ' +
   '`validate: { kind: "pattern"|"range"|"date"|"birthdate", pattern?, flags?, negate?, min?, max?, message? }` (flags a wrong value on every new write, never blocks); ' +
   'a relation property may carry `relationFilter: [{ propId, op: "is"|"is_not_empty", values? }]` (which linked rows may be picked). ' +
@@ -54,6 +54,7 @@ const ACCESS_HINT =
   'Any property may carry `align: "left"|"center"|"right"` and `wrap: true`; a date property `highlightOverdue: true` ' +
   '(past dates red — off by default), `allowTime: false` (no time) and `allowRange: false` (no end date). A table view ' +
   'config may carry `density: "compact"` and `frozenColumns: 1` (first N visible columns fixed while scrolling sideways). ' +
+  'A PAGE node may carry `page.analytics: true` (visit tracking — an "Analytics" folder with a visit LOG, a daily visits table and a dashboard is created next to it; records once published). ' +
   'A DOCUMENT\'s `content` may embed a live ' +
   'table/sheet/deck with a line `[[embed:<name of a node in this same tree>]]` or `[[embed:/absolute/path]]` — it is ' +
   'linked to the real node after the whole tree is built (an unknown name rolls the whole tree back).';
@@ -236,6 +237,68 @@ export function registerWorkspaceTools(server) {
     },
   );
 
+  server.registerTool(
+    'rootr_workspace_members',
+    {
+      title: 'List members of a Rootr workspace',
+      description:
+        'List the members of a Rootr (루터) workspace — each with their user id, name, email, and role. Use the ' +
+        'id to address rootr_message_member, or to pass as assigneeId/userId elsewhere.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
+      },
+    },
+    async ({ workspace }) => {
+      try {
+        const ws = requireWorkspace(workspace);
+        const client = makeClient(ws);
+        const members = await client.listMembers(ws);
+        return jsonResult(
+          members.map((m) => ({
+            userId: m.userId ?? m.user?.id,
+            name: m.user?.name ?? '',
+            email: m.user?.email ?? '',
+            role: m.role,
+          })),
+        );
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_message_member',
+    {
+      title: 'Send a direct message to a workspace member',
+      description:
+        'Send a direct notification-style message to another member of a Rootr (루터) workspace — not tied to ' +
+        'any document, issue, or comment. The message is posted as the person the ROOTR_API_KEY belongs to and ' +
+        'shows up for the recipient in their Rootr notification bell (and by email). Use rootr_workspace_members ' +
+        'first to find the recipient\'s userId.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        userId: z.string().describe('User id of the workspace member to message (see rootr_workspace_members)'),
+        body: z.string().describe('Message text'),
+        workspace: z
+          .string()
+          .optional()
+          .describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
+      },
+    },
+    async ({ userId, body, workspace }) => {
+      try {
+        const ws = requireWorkspace(workspace);
+        const client = makeClient(ws);
+        await client.messageMember(ws, userId, body);
+        return textResult(`${userId} 에게 메시지를 보냈습니다.`);
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
   server.registerTool(
     'rootr_scaffold_plan',
     {

package/lib/mcp.js

@@ -25,6 +25,7 @@ import { registerSignedDocTools } from './mcp-tools/signed.js';
 import { registerFeedbackTools } from './mcp-tools/feedback.js';
 import { registerMemoryTools } from './mcp-tools/memory.js';
 import { registerDocMailTools } from './mcp-tools/doc-mail.js';
+import { registerDomainTools } from './mcp-tools/domains.js';
 import { withDocMailSink, withRateLimitSink } from './context.js';
 import { makeClient } from './mcp-tools/shared.js';
 import { t as tr } from './i18n.js';
@@ -330,6 +331,7 @@ export function buildMcpServer({ name, version }) {
   registerFeedbackTools(server);
   registerMemoryTools(server);
   registerDocMailTools(server);
+  registerDomainTools(server);
 
   return server;
 }

package/package.json

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