rootr-cli 0.24.0 → 0.26.0

package/lib/mcp-tools/databases.js

@@ -59,6 +59,8 @@ const FILTER_SHAPE = z.array(
       .optional()
       .describe(
         'Values the op needs. is/is_not/contains → one or more (OR between them). ' +
+          'Text matching ignores case, spaces and brackets/punctuation ( ) [ ] · - . , / and treats ㈜ as (주). On a RELATION column, contains matches the linked rows\' ' +
+          'titles (e.g. a business name) and is/is_not take linked row ids (from rootr_pick_rows) or exact titles. ' +
           'before/after/on → one date "YYYY-MM-DD". between → two dates. eq/gt/lt → one number. ' +
           'is_empty/is_not_empty/today/this_week/this_month/past/upcoming/checked/unchecked take none.',
       ),
@@ -324,9 +326,25 @@ export function registerDatabaseTools(server) {
               'Default month. The year view shows twelve mini-months at once (darker = more rows that day). ' +
               'Saved on the view, so everyone who opens it sees that span.',
           ),
+        density: z
+          .enum(['normal', 'compact'])
+          .nullable()
+          .optional()
+          .describe('table view: "compact" = lower rows and smaller text so more rows fit on one screen. null/"normal" = default.'),
+        frozenColumns: z
+          .number()
+          .int()
+          .min(0)
+          .max(3)
+          .nullable()
+          .optional()
+          .describe(
+            'table view: keep the first N VISIBLE columns fixed on the left while scrolling sideways (Excel freeze panes). ' +
+              '0/null = off. e.g. 1 keeps the title column (상호명) in place.',
+          ),
       },
     },
-    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale }) => {
+    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -340,6 +358,8 @@ export function registerDatabaseTools(server) {
           sort,
           colWidths,
           calendarScale,
+          density,
+          frozenColumns,
         });
         return jsonResult(view);
       } catch (err) {
@@ -382,7 +402,9 @@ export function registerDatabaseTools(server) {
         'the same table can look different per view (a "담당자" view hiding the amounts, etc). Hiding a column ' +
         'does NOT erase its values: it disappears from that view only and comes back when you unhide it. ' +
         'Columns may be given by NAME or id; the title column cannot be hidden and is ignored if listed. ' +
-        'Pass an empty array to show everything again. Only the fields you pass change, and other views are untouched.',
+        'Pass an empty array to show everything again. Only the fields you pass change, and other views are untouched. ' +
+        'For an at-a-glance table also pass density "compact" (lower rows, smaller text) and frozenColumns N (first N visible ' +
+        'columns stay fixed while scrolling sideways).',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
@@ -436,6 +458,22 @@ export function registerDatabaseTools(server) {
             'Tint rows/cards by value: the first matching rule wins. e.g. [{propId:"진행상태",op:"is",values:["채용불가"],color:"red"}, ' +
               '{propId:"면접예정일",op:"is_not_empty",color:"yellow"}]. Colors: gray, brown, orange, yellow, green, blue, purple, pink, red. null or [] turns it off.',
           ),
+        density: z
+          .enum(['normal', 'compact'])
+          .nullable()
+          .optional()
+          .describe('table view: "compact" = lower rows and smaller text so more rows fit on one screen. null/"normal" = default.'),
+        frozenColumns: z
+          .number()
+          .int()
+          .min(0)
+          .max(3)
+          .nullable()
+          .optional()
+          .describe(
+            'table view: keep the first N VISIBLE columns fixed on the left while scrolling sideways (Excel freeze panes). ' +
+              '0/null = off. e.g. 1 keeps the title column (상호명) in place.',
+          ),
       },
     },
     async ({
@@ -452,6 +490,8 @@ export function registerDatabaseTools(server) {
       calendarScale,
       cardProps,
       rowColors,
+      density,
+      frozenColumns,
     }) => {
       try {
         const client = makeClient();
@@ -468,6 +508,8 @@ export function registerDatabaseTools(server) {
           calendarScale,
           cardProps,
           rowColors,
+          density,
+          frozenColumns,
         });
         return jsonResult({ view });
       } catch (err) {
@@ -551,6 +593,40 @@ export function registerDatabaseTools(server) {
     },
   );
 
+  // REL-PICK(P5) — 화면의 관계 고르기와 같은 찾기. 표 전체를 읽어 이름을 손으로 견주지 않게(9천 행이면 수 MB).
+  server.registerTool(
+    'rootr_pick_rows',
+    {
+      title: 'Find rows to link (relation picker search)',
+      description:
+        'Search a Rootr (루터) DATABASE for rows to put into a relation column — the same search the app\'s relation picker uses. ' +
+        'Searches the WHOLE table by title: exact name → names starting with q → names containing q → the identify columns ' +
+        '(e.g. last 4 phone digits "5678"); newest rows first within each rank. Returns `{ rows: [{ id, title, subtitle }], total, hasMore }` ' +
+        'only — `subtitle` comes from the title column\'s identifyProps (rootr_update_column) such as "***-5678 · 2026-10-02", so ' +
+        'people with the same name can be told apart. Pass the relation column\'s relationFilter as `filters` to see only linkable rows, ' +
+        'or `ids` to label rows you already have. Matching ignores spaces/case/brackets/punctuation and treats ㈜ as (주).',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe('The TARGET database (the one the relation column points at): ' + DATABASE_TARGET_DESC),
+        q: z.string().optional().describe('Name (or part of it, or last phone digits). Empty → newest rows.'),
+        filters: z
+          .array(z.object({ propId: z.string(), op: z.string(), values: z.array(z.string()).optional() }))
+          .optional()
+          .describe('Optional conditions on the target table, e.g. the relation column\'s relationFilter'),
+        ids: z.array(z.string()).optional().describe('Only these row ids (to label them); q/filters are ignored'),
+        limit: z.number().optional().describe('Default 30, max 100'),
+      },
+    },
+    async ({ databaseId, q, filters, ids, limit }) => {
+      try {
+        const client = makeClient();
+        return jsonResult(await client.pickRows(await resolveNodeId(client, databaseId), { q, filters, ids, limit }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
   server.registerTool(
     'rootr_add_row',
     {
@@ -908,6 +984,8 @@ export function registerDatabaseTools(server) {
         'rootr_query_vectors (Rootr never embeds it for you; people see only "vector · N dims" in the grid). ' +
         'created_time / last_edited_time / created_by / last_edited_by / unique_id / formula / rollup are filled in by the server — ' +
         'they take no value and rootr_update_row will refuse to set them. ' +
+        'Display options: align (left|center|right), wrap true; date columns: highlightOverdue true (past dates red — off by default), ' +
+        'allowTime false (no time), allowRange false (no end date). ' +
         'Returns the created column WITH ITS id.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
@@ -1014,9 +1092,38 @@ export function registerDatabaseTools(server) {
               'chat, button AI-fill steps, formula/rollup columns and MCP reads still see the values; to hide values from ' +
               'people, use an "own rows only" table or a private node. Table managers only.',
           ),
+        align: z
+          .enum(['left', 'center', 'right'])
+          .optional()
+          .describe('Text alignment of this column in the table (default: numbers right, the rest left). null resets.'),
+        wrap: z
+          .boolean()
+          .optional()
+          .describe('true = long text wraps inside the cell instead of being cut off (the row grows). false/null = one line.'),
+        highlightOverdue: z
+          .boolean()
+          .optional()
+          .describe(
+            'date only: show PAST dates in red (deadline-like columns). Default OFF — application/call dates stay plain. ' +
+              'Refused (400) on a non-date column.',
+          ),
+        allowTime: z
+          .boolean()
+          .optional()
+          .describe(
+            'date only: false = no 「시간」 toggle; any value written later is stored as a plain date (time dropped). ' +
+              'Existing values keep showing. true/null = allowed (default).',
+          ),
+        allowRange: z
+          .boolean()
+          .optional()
+          .describe(
+            'date only: false = no 「기간」 (end date) button; values written later keep only the start date. ' +
+              'Existing ranges keep showing and can be cleared. true/null = allowed (default).',
+          ),
       },
     },
-    async ({ databaseId, name, type, options, relationDatabaseId, formula, rollup, prefix, searchExcluded, dimensions }) => {
+    async ({ databaseId, name, type, options, relationDatabaseId, formula, rollup, prefix, searchExcluded, dimensions, align, wrap, highlightOverdue, allowTime, allowRange }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -1030,6 +1137,11 @@ export function registerDatabaseTools(server) {
           prefix,
           searchExcluded,
           dimensions,
+          align,
+          wrap,
+          highlightOverdue,
+          allowTime,
+          allowRange,
         });
         return jsonResult({ property });
       } catch (err) {
@@ -1049,15 +1161,29 @@ export function registerDatabaseTools(server) {
         'The column TYPE and a vector column\'s dimensions cannot be changed — that would rewrite every row (or every stored vector) — ' +
         'so passing type or dimensions is refused; add a new column and move the values instead. ' +
         'Call rootr_read_database first to get the exact propertyId.\n' +
+        'RENAMES CASCADE: a new `name` also rewrites everything that refers to the column BY NAME, in the same transaction — ' +
+        'formulas ({col} / prop("col")) in this table, button/automation {col} {col+1} {relation.col} templates here and in ' +
+        'tables that link to this one, rollups in other tables (pinned to the column id), linked form questions (kept connected ' +
+        'by id; the question text stays) and page live blocks (liveTable/liveStats/liveChart). Do NOT edit the formula first ' +
+        '(a formula naming a column that does not exist yet is refused). The result has `renameCascade` {formulas, buttons, ' +
+        'automations, rollups, forms, pages, warnings, summary}; `warnings` lists what could not follow (e.g. two form questions ' +
+        'now landing on one column). Pass dryRun: true with `name` to get that list without changing anything.\n' +
         '`reverseName` on a relation column pairs it with the linked table: that table gets a matching column with ' +
         'this name and filling either side fills the other. Pass an empty string to unpair (neither column is deleted). ' +
         'Use it to make an existing one-way link two-way rather than rebuilding the table — a one-way column leaves ' +
-        'every aggregate on the other side wrong until somebody backfills it by hand.',
+        'every aggregate on the other side wrong until somebody backfills it by hand.\n' +
+        'Display options (only what you pass changes; null resets): align left|center|right, wrap true (long text wraps), ' +
+        'and for DATE columns highlightOverdue true (past dates in red — off by default), allowTime false (no time), ' +
+        'allowRange false (no end date). e.g. { "allowTime": false, "allowRange": false } makes 「지원일」 a plain single date.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
         propertyId: z.string().describe('Column id from rootr_read_database (NOT the header text)'),
-        name: z.string().optional().describe('New header text'),
+        name: z.string().optional().describe('New header text — formulas, button/automation templates, rollups, linked forms and page blocks follow it'),
+        dryRun: z
+          .boolean()
+          .optional()
+          .describe('With `name` only: return what the rename would also change (renameCascade) without renaming'),
         options: z
           .array(z.object({ name: z.string(), color: z.string() }))
           .optional()
@@ -1107,6 +1233,40 @@ export function registerDatabaseTools(server) {
               'shows the latest 5 linked rows (contact history) and the total. Names or ids; an unknown name is refused (400), not dropped. ' +
               'null/[] = automatic (status, notes, dates, rollups; relations as history).',
           ),
+        align: z
+          .enum(['left', 'center', 'right'])
+          .nullable()
+          .optional()
+          .describe('Text alignment of this column in the table (default: numbers right, the rest left). null resets.'),
+        wrap: z
+          .boolean()
+          .nullable()
+          .optional()
+          .describe('true = long text wraps inside the cell instead of being cut off (the row grows). false/null = one line.'),
+        highlightOverdue: z
+          .boolean()
+          .nullable()
+          .optional()
+          .describe(
+            'date only: show PAST dates in red (deadline-like columns). Default OFF — application/call dates stay plain. ' +
+              'Refused (400) on a non-date column.',
+          ),
+        allowTime: z
+          .boolean()
+          .nullable()
+          .optional()
+          .describe(
+            'date only: false = no 「시간」 toggle; any value written later is stored as a plain date (time dropped). ' +
+              'Existing values keep showing. true/null = allowed (default).',
+          ),
+        allowRange: z
+          .boolean()
+          .nullable()
+          .optional()
+          .describe(
+            'date only: false = no 「기간」 (end date) button; values written later keep only the start date. ' +
+              'Existing ranges keep showing and can be cleared. true/null = allowed (default).',
+          ),
         relationFilter: z
           .array(z.object({ propId: z.string(), op: z.enum(['is', 'is_not_empty']), values: z.array(z.string()).optional() }))
           .nullable()
@@ -1115,6 +1275,48 @@ export function registerDatabaseTools(server) {
             'relation only: which rows of the linked table may be linked (all rules must match; propId is a column of the LINKED table). ' +
               'e.g. [{propId:"진행상태",op:"is",values:["채용"]}]. The picker hides others and the server refuses new links that fail. null turns it off.',
           ),
+        dedupeCarry: z
+          .record(z.any())
+          .nullable()
+          .optional()
+          .describe(
+            'With dedupe on: "carry over previous info" (the same entry came back). When a NEW row has the same value as an earlier row, copy the ' +
+              'earlier row\'s values INTO the new row (the earlier row is untouched). { auto?: true = do it on every entry path (row add, cell, ' +
+              'form, button/automation add_row, REST/MCP/bulk) without asking; false/omitted = only the duplicate dialog button / ' +
+              'rootr_carry_over. label?: name of this action for the table (≤30 chars, e.g. "재등록"; toasts/merge comments use it; blank = neutral ' +
+              'default), exclude?: [columns not copied, e.g. "접수일"], overwrite?: [columns copied even if the new row has a value; ' +
+              'default fills empty cells only], relations?: true to copy relation columns too (default false — they are two-way), ' +
+              'latestBy?: date column or "createdAt" — which earlier row wins when several match (latest), mark?: values stamped on the new ' +
+              'row: { "재등록 여부": true, "구분": { map: { "A": "A(재등록)" }, else: "재등록" } } — map looks at the value the ' +
+              'NEW row came in with; else covers any value not in map; if that column is still EMPTY when carried, the mark waits and is ' +
+              'applied once to the first value written there later (e.g. a later button step); missing select options are added }. ' +
+              'Names or ids. null turns it off.',
+          ),
+        validate: z
+          .record(z.any())
+          .nullable()
+          .optional()
+          .describe(
+            'Value check for NEW writes to this column — it only FLAGS a wrong input: the value is saved exactly as typed and the ' +
+              'response carries warnings[] (send checkWarnings: true on row PATCH/form submit to get 422 VALUE_WARNINGS first). The user ' +
+              'writes the rule: { kind: "pattern", pattern: "<regex the WHOLE value must match>", flags?: "i"|"s"|"m", negate?: true ' +
+              '(flag values that CONTAIN the pattern instead), message?: "{name}: {value} …" } — linear-time engine, no back-references/' +
+              'look-arounds, max 500 chars; starting points via rootr_test_value_rule { presets: true } (email, URL, intl/KR/US phone, ' +
+              'postal codes …); formats differ per country, so pick/adapt one rather than assuming Korean formats. Other kinds: ' +
+              '"range" (number: min/max), "date" (text reads as a date), "birthdate" (text/date; min/max = age). askDeleteRow?: true — ' +
+              'the in-app dialog also offers deleting the row. Applies to cells, row panel, forms, REST/MCP/bulk, buttons/automations. ' +
+              'Existing values are not changed. null turns it off.',
+          ),
+        identifyProps: z
+          .array(z.object({ propId: z.string(), mask: z.enum(['last4']).optional() }))
+          .nullable()
+          .optional()
+          .describe(
+            'TITLE column only: up to 3 columns of THIS table shown next to the title wherever another table picks one of these rows ' +
+              '(relation picker, relation filter, rootr_pick_rows `subtitle`) so same-name rows can be told apart. mask "last4" shows only ' +
+              'the last 4 digits (***-5678) — use it for phone numbers. Names or ids; unknown/relation/files columns are refused (400). ' +
+              'e.g. on 지원자.이름: [{propId:"연락처",mask:"last4"},{propId:"지원일"}]. null/[] turns it off.',
+          ),
       },
     },
     async ({
@@ -1131,8 +1333,17 @@ export function registerDatabaseTools(server) {
       dedupe,
       dedupeShow,
       relationFilter,
+      align,
+      wrap,
+      highlightOverdue,
+      allowTime,
+      allowRange,
+      dedupeCarry,
+      validate,
+      identifyProps,
       type,
       dimensions,
+      dryRun,
     }) => {
       // 조용히 무시하지 않는다 — 못 바꾸는 것을 넘기면 까닭과 할 일을 말한다(벡터 차원을 바꾸면 저장된 벡터가 전부 틀려진다).
       if (type !== undefined || dimensions !== undefined) {
@@ -1146,6 +1357,11 @@ export function registerDatabaseTools(server) {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
+        // COL-RENAME — 미리 보기: 이름을 바꾸면 무엇이 함께 바뀌는지(쓰지 않는다).
+        if (dryRun) {
+          if (typeof name !== 'string' || !name.trim()) return errorResult(new Error('dryRun 은 name(바꿀 이름)과 함께 보내 주세요.'));
+          return jsonResult({ dryRun: true, renameCascade: await client.columnRenameImpact(id, propertyId, name) });
+        }
         const property = await client.updateColumn(id, propertyId, {
           name,
           options,
@@ -1158,8 +1374,18 @@ export function registerDatabaseTools(server) {
           dedupe,
           dedupeShow,
           relationFilter,
+          align,
+          wrap,
+          highlightOverdue,
+          allowTime,
+          allowRange,
+          dedupeCarry,
+          validate,
+          identifyProps,
         });
-        return jsonResult({ property });
+        // COL-RENAME — 함께 바뀐 것을 위로 꺼내 둔다(에이전트가 경고를 놓치지 않게).
+        const { renameCascade, ...column } = property ?? {};
+        return jsonResult(renameCascade ? { property: column, renameCascade } : { property });
       } catch (err) {
         return errorResult(err);
       }
@@ -1181,7 +1407,7 @@ export function registerDatabaseTools(server) {
         'and spaces. Give `rowId` to check an existing row (it is excluded from the result) or `values` ({column name or id: value}) ' +
         'to check before adding. Each match comes with the fields the duplicate dialog shows (`preview`: status, notes, dates, rollups ' +
         '— or the column\'s dedupeShow list) and `history`: the latest 5 linked rows per relation column (e.g. call log) with the total. ' +
-        'Only rows the caller can see are returned. Then use rootr_merge_rows or rootr_keep_duplicate.',
+        'Only rows the caller can see are returned. Then use rootr_merge_rows, rootr_keep_duplicate or rootr_carry_over (copy the earlier row into the new one).',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
@@ -1208,7 +1434,7 @@ export function registerDatabaseTools(server) {
       description:
         'Merge row `rowId` into row `into` of the same Rootr (루터) DATABASE — the "same person applied again" case. Empty cells of ' +
         '`into` are filled from `rowId` (existing values are kept), relation/multi-select/people/files are unioned (so a call log linked ' +
-        'to the new row moves to the old one), a "🔁 재지원" comment listing the new values is left on `into`, and `rowId` is DELETED ' +
+        'to the new row moves to the old one), a "🔁 <dedupeCarry.label or 다시 들어옴>" comment listing the new values is left on `into`, and `rowId` is DELETED ' +
         '(row history records it as merged into `into`). Both rows must be editable by the caller. Not reversible except by the table history.',
       annotations: { readOnlyHint: false, destructiveHint: true },
       inputSchema: {
@@ -1253,6 +1479,88 @@ export function registerDatabaseTools(server) {
     },
   );
 
+  server.registerTool(
+    'rootr_carry_over',
+    {
+      title: "Carry over a person's previous row into this row",
+      description:
+        'The "이전 정보 가져오기" choice: copy the values of an EARLIER row of the same person (same dedupe value, e.g. phone) ' +
+        'INTO row `rowId`, following the dedupe column\'s dedupeCarry settings (excluded columns such as the entry date, ' +
+        'marks such as 재등록 여부=true / 구분 A→A(재등록)). The earlier row is NOT changed and nothing is linked. ' +
+        'Without `from` the most recent matching row (latestBy, else creation time) is used. Row history records it as carried from that ' +
+        'row. Tables with dedupeCarry.auto do this by themselves on every write path — use this for tables without auto or to pick a ' +
+        'specific earlier row. Only rows the caller can see are used.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        rowId: z.string().describe('The new row that receives the values'),
+        from: z.string().optional().describe('The earlier row to copy from (default: latest row with the same dedupe value)'),
+      },
+    },
+    async ({ databaseId, rowId, from }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.carryOver(id, rowId, from));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_rule_violations',
+    {
+      title: 'List existing values that break column validation rules',
+      description:
+        'Read-only. Lists cells of a Rootr (루터) DATABASE whose CURRENT value breaks the column\'s validate rule (rootr_update_column ' +
+        'validate: pattern / range / date / birthdate). Rules only check new writes, so values entered before the rule (or imported) ' +
+        'stay as they were — use this to find and fix them. Returns { checkedColumns, total, items: [{ rowId, title, propName, value, message }] }.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        limit: z.number().int().min(1).max(1000).optional().describe('Max items (default 200)'),
+      },
+    },
+    async ({ databaseId, limit }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.ruleViolations(id, { limit }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_test_value_rule',
+    {
+      title: 'Try a column validation rule on sample values (or list example patterns)',
+      description:
+        'Read-only, saves nothing. Runs a validate rule (the same shape rootr_update_column takes, e.g. { kind: "pattern", pattern: ' +
+        '"\\\\+\\\\d{1,3} .+", message: "…" }) against sample values and returns { rule, results: [{ value, ok, message? }] } — use it to ' +
+        'check a pattern before putting it on a column. `presets: true` returns example patterns to start from (email, URL, ' +
+        'international / KR / US phone, postal codes, digits only, …); formats differ per country and company, so adapt them.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        rule: z.record(z.any()).optional().describe('The validate rule to try (omit with presets: true)'),
+        values: z.array(z.union([z.string(), z.number()])).max(20).optional().describe('Up to 20 sample values'),
+        type: z.string().optional().describe('Column type the rule is for (default "text"; "number" for range)'),
+        presets: z.boolean().optional().describe('true = list example patterns instead'),
+      },
+    },
+    async ({ rule, values, type, presets }) => {
+      try {
+        const client = makeClient();
+        if (presets || !rule) return jsonResult(await client.valueRulePresets());
+        return jsonResult(await client.testValueRule(rule, values ?? [], type));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
   // ── ROW-HISTORY / RESTORE(F6·F7·G3) — 행·표 이력과 되돌리기 ─────────────────
 
   server.registerTool(