rootr-cli 0.25.0 → 0.29.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) {
@@ -482,7 +524,8 @@ export function registerDatabaseTools(server) {
       title: 'Read a database schema and rows',
       description:
         'Read a Rootr (루터) DATABASE node — its schema (properties with ids/types and select options) plus all rows ' +
-        '(each with its rowId and values). ALWAYS call this before rootr_add_row / rootr_update_row so you know the exact ' +
+        '(each with its rowId and values; a row whose current value breaks a column check also carries ' +
+        '`issues: { [propId]: { message, askDeleteRow? } }` — saved as typed, just flagged). ALWAYS call this before rootr_add_row / rootr_update_row so you know the exact ' +
         'property ids/names and, for board/kanban views, which select column holds the status. Only works on DATABASE nodes.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
@@ -520,6 +563,7 @@ export function registerDatabaseTools(server) {
       title: 'List database rows',
       description:
         'List the rows of a Rootr (루터) DATABASE (id + values + position), without the schema. ' +
+        'Rows whose current values break a column check carry `issues: { [propId]: { message, askDeleteRow? } }` (omitted when none). ' +
         'Use rootr_read_database instead when you also need the property/column definitions.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
@@ -551,6 +595,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 +986,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 +1094,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 +1139,11 @@ export function registerDatabaseTools(server) {
           prefix,
           searchExcluded,
           dimensions,
+          align,
+          wrap,
+          highlightOverdue,
+          allowTime,
+          allowRange,
         });
         return jsonResult({ property });
       } catch (err) {
@@ -1049,15 +1163,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 +1235,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 +1277,66 @@ 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. ' +
+              'DUPLICATE RULES (all optional, same object): action?: "ask" (dialog; askDefault?: carry|merge_into_old|merge_all preselected) | ' +
+              '"carry" (= auto:true; copy into the new row) | "merge_into_old" (fill the representative earlier row, delete the new row unless ' +
+              'keepNew:true which keeps it linked) | "merge_all" (all same-value rows → one representative row; others deleted or kept linked); ' +
+              'sources?: "all" (default — per column take the most recent earlier row that HAS a value) | "latest" (only the latest earlier row); ' +
+              'strategy?: default per column, one of fill_empty (default) | prefer_new | prefer_old | latest | skip; columns?: { "<column>": ' +
+              'fill_empty | prefer_new | prefer_old | latest | skip | max | min | sum (number) | earliest | latest_date (date) | union ' +
+              '(multi_select/relation/files/person) | { append: { sep?: " / ", datePrefix?: true } } (text) } — a strategy on the wrong column ' +
+              'type is a 400; exclude = skip, overwrite = prefer_old; representative?: "latest" | "oldest", representativeWhen?: [{ propId, op, ' +
+              'values }] (first row matching wins). Every operation returns an opId (undo with rootr_dedupe_undo); preview with ' +
+              'rootr_dedupe_preview. ' +
+              'BY CONDITION: cases?: [{ when?: { within?: { column: "<date column>", days: 0 }, same?: ["<column>"], filters?: [{ propId, op, ' +
+              'values }] (on the earlier row) }, action, …overrides (askDefault/sources/strategy/columns/keepNew/representative/' +
+              'representativeWhen/mark/label; "mark": {} = no marks) }] (≤10) — each earlier row goes to the FIRST matching case, rows ' +
+              'matching none are untouched; any row in an ask case → nothing automatic; merge cases run first, then carry cases fill the ' +
+              'surviving row, which gets the first carry case\'s mark/label (else the merge case\'s). e.g. { cases: [{ when: { within: ' +
+              '{ column: "등록일", days: 0 } }, action: "merge_all", mark: {} }, { action: "carry" }] }. TEMPLATES: map/else values may ' +
+              'use {value} = the value the new row came in with: { "경로": { else: "{value} (다시)" } }; a value already in that shape is ' +
+              'kept; new values become select options.',
+          ),
+        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 +1353,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 +1377,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 +1394,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);
       }
@@ -1168,7 +1414,7 @@ export function registerDatabaseTools(server) {
 
   // ── DEDUPE(F5) — 같은 사람 찾기·합치기·새 행으로 두기 ─────────────────────
   //
-  // 화면의 중복 창과 같은 일을 에이전트도 할 수 있어야 한다. 그렇지 않으면 "지원자 붙여 넣으면서 이미 있는 사람은 합쳐 줘"
+  // 화면의 중복 창과 같은 일을 에이전트도 할 수 있어야 한다. 그렇지 않으면 "명단 붙여 넣으면서 이미 있는 사람은 합쳐 줘"
   // 같은 부탁에서 에이전트가 표 전체를 읽어 전화번호를 손으로 견주게 된다(9천 행이면 수 MB).
 
   server.registerTool(
@@ -1181,7 +1427,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 +1454,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 +1499,173 @@ 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` every earlier row with the same value is used (sources "all": per column the most recent row that has a value; ' +
+        'sources "latest": only the latest row). The response lists the columns that actually changed (copied, changedCount, ' +
+        'nothingChanged) and an opId for rootr_dedupe_undo. Tables whose dedupeCarry action is carry (or auto) do this by themselves on every write path — use this for tables without it 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_dedupe_preview',
+    {
+      title: 'Preview how a row and its same-value rows would be carried/merged',
+      description:
+        'Read-only. For row `rowId` of a Rootr (루터) DATABASE with a dedupe column, shows what the table\'s duplicate rule (dedupeCarry on ' +
+        'the dedupe column — see rootr_update_column) would do: { action, targetRowId (row that stays), deleted, kept, fromRowIds, columns: ' +
+        '[{ column, strategy, before, after, from }], marked, pending, nothingChanged }. `rules` overrides the table rule for this preview ' +
+        'only (same shape: action, sources, strategy, columns, keepNew, representative, representativeWhen …). 404 when no other row has ' +
+        'the same value. Apply with rootr_dedupe_apply.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        rowId: z.string().describe('The (new) row whose duplicates to handle'),
+        rules: z.record(z.any()).optional().describe('Override the table rule for this call (dedupeCarry shape)'),
+        fromRowIds: z.array(z.string()).optional().describe('Limit the earlier rows used as sources'),
+      },
+    },
+    async ({ databaseId, rowId, rules, fromRowIds }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.dedupe(id, rowId, { rules, fromRowIds, dryRun: true }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_dedupe_apply',
+    {
+      title: "Apply the table's duplicate rule to a row (carry / merge into the earlier row / merge all)",
+      description:
+        'Writes. Same input as rootr_dedupe_preview; applies it: carry copies into the row, merge_into_old fills the representative earlier ' +
+        'row and deletes this row (unless keepNew), merge_all keeps one representative row and deletes the rest (unless keepNew). Returns ' +
+        'the same fields plus `opId` — undo the whole operation (restores cells, recreates deleted rows) with rootr_dedupe_undo. Preview ' +
+        'first when deleting rows. The caller must be able to edit the kept row and delete the others.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        rowId: z.string().describe('The (new) row whose duplicates to handle'),
+        action: z.enum(['carry', 'merge_into_old', 'merge_all']).optional().describe('Override the action (default: the table rule; ask → askDefault or carry)'),
+        rules: z.record(z.any()).optional().describe('Override the table rule for this call (dedupeCarry shape)'),
+        fromRowIds: z.array(z.string()).optional().describe('Limit the earlier rows used as sources'),
+        targetRowId: z.string().optional().describe('merge_into_old: the earlier row that stays'),
+      },
+    },
+    async ({ databaseId, rowId, action, rules, fromRowIds, targetRowId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.dedupe(id, rowId, { action, rules, fromRowIds, targetRowId }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_dedupe_undo',
+    {
+      title: 'Undo one duplicate-handling operation',
+      description:
+        'Undo a carry/merge by its `opId` (returned by rootr_dedupe_apply, rootr_carry_over, rootr_merge_rows, row writes that ' +
+        'auto-handled a duplicate as `deduped.opId`, and recorded in row history as via "dedupe:<opId>"). Cells it changed go back to ' +
+        'their values before the operation and rows it deleted are recreated with the same id. A second undo is refused.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        opId: z.string().describe('The operation id'),
+      },
+    },
+    async ({ databaseId, opId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.dedupeUndo(id, opId));
+      } 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(

package/lib/mcp-tools/documents.js

@@ -480,7 +480,9 @@ export function registerDocumentTools(server) {
         'Partially update a published Rootr (루터) document\'s public settings — only the fields you pass are ' +
         'changed, everything else (including slug) is left as-is. Examples: {"isPublic": false} to unpublish; ' +
         '{"allowCommits": true} to let public readers propose edits; {"skin": "tech-dark"} or ' +
-        '{"layout": {"cover": true}} to restyle the public page; {"expiresAt": "2026-12-31T00:00:00Z"} to set an ' +
+        '{"layout": {"cover": true}} to restyle the public page; {"seoDescription": "...", "seoImage": "<attachment id>"} ' +
+        'to set the search-result description and link-preview image (search engines are pinged right away); ' +
+        '{"expiresAt": "2026-12-31T00:00:00Z"} to set an ' +
         'auto-close date, or {"expiresAt": null} to clear it. ' +
         'Owner-level action (MANAGE): works with an account key (PAT), not with workspace-scoped/connector tokens.',
       annotations: { readOnlyHint: false, destructiveHint: false },
@@ -510,6 +512,20 @@ export function registerDocumentTools(server) {
           .boolean()
           .optional()
           .describe('true hides the page from search engines (Team plan and up)'),
+        seoDescription: z
+          .union([z.string().max(300), z.null()])
+          .optional()
+          .describe(
+            'Search-result / link-preview description (meta description, og:description). Aim for ~160 characters ' +
+              'that say what the page covers with the words people search for. null or "" falls back to the opening text.',
+          ),
+        seoImage: z
+          .union([z.string(), z.null()])
+          .optional()
+          .describe(
+            'Cover image for link previews (og:image): an image attachment id from the same workspace — upload one ' +
+              'with rootr_upload_attachment first. 1200×630 landscape fits best. null removes it (the Rootr title card is used).',
+          ),
         skin: z
           .enum([
             'classic',