rootr-cli 0.19.0 → 0.22.0

package/README.ko.md

@@ -211,6 +211,11 @@ rootr config                       # 등록된 키 목록 확인
 워크스페이스가 바뀌고, 그 워크스페이스를 담당하는 키가 자동으로 선택·기억됩니다. 계정
 키(PAT)를 쓰면 소속된 어느 워크스페이스로든 바로 전환됩니다.
 
+MCP 서버를 `ROOTR_WORKSPACE` 환경변수로 띄웠다면(MCP 클라이언트 설정의 `env: {…}`), 재시작할 때마다
+환경변수가 다시 이깁니다. `rootr_use_workspace` 전환은 그 서버 프로세스가 켜져 있는 동안만 적용되고,
+전환 응답이 "재시작하면 어느 워크스페이스로 돌아가는지"를 알려 줍니다. 전환을 계속 유지하려면 그 설정의
+`ROOTR_WORKSPACE` 를 바꾸거나 지우세요.
+
 워크스페이스 키는 자기 워크스페이스 밖에서는 열리지 않습니다 — `rootr ws`(=`rootr_workspaces`)
 목록에 보여도 접근은 안 되는 경우가 있어, 등록된 키가 워크스페이스 키뿐이면 목록에
 `[등록된 키로는 접근 불가]`를 함께 표시합니다.
@@ -346,7 +351,7 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 
 ## MCP 서버로 사용하기
 
-`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 178종:
+`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 186종:
 
 노드를 가리키는 인자(`target`, `databaseId`, `spreadsheetId`, `formId`, `crmId`, `trackerId`,
 `recordingId`, `presentationId`, `whiteboardId`, `logId`, `parentId` 등)는 **노드 id와 경로를 모두**
@@ -380,6 +385,8 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 |---|---|
 | `rootr_upload_attachment` | 로컬 파일(`filePath`) 또는 base64(`base64Data`)를 업로드하고 `{id, url, markdown}` 반환 |
 | `rootr_attach_image_to_document` | 위 업로드 + 지정 문서에 `rootr_append`로 바로 삽입 (가장 흔한 용법) |
+| `rootr_create_upload_url` | 잠깐(5분) 쓰는 올리기 주소를 받는다 — 파일 바이트를 그 주소에 직접 `PUT`. 큰 파일, 그리고 `filePath` 를 못 쓰는 원격 커넥터용 |
+| `rootr_complete_upload` | `PUT` 이 끝난 뒤 호출 — 올라간 것을 확인하고 `{id, url, markdown}` 반환 |
 
 `url`은 `/attachments/{id}/raw` — 로그인 없이 렌더되는 공개 경로라 published(`/p/`) 문서에도
 그대로 쓸 수 있습니다. CLI에서는 `rootr attach <file> [--doc <path|id>] [--heading "## X"] [--alt <text>]`.
@@ -535,6 +542,26 @@ rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해
    "steps": [{ "kind": "update_rows", "target": "selected", "values": { "오늘 할 일": true } }] }]
 ```
 
+**같은 행이 이미 있으면 잇기.** 마스터 표에 등록하는 규칙(투입확정 → 사업장 마스터)은 기존 고객이면
+이미 행이 있습니다. `add_row` 에 `match` 를 주면 만들기 전에 찾습니다 — 같은 이름이 **하나**면 새로
+만들지 않고 그 행에 잇고, **없으면** 만들고, **여럿**이면 아무것도 안 만들고 요청 행에 "후보 여러 곳"
+댓글을 남깁니다. 먼저 공백만 무시하고 똑같은 이름을 찾으므로 지점명까지 같으면 그 지점에 잇습니다.
+관계 칸은 `"{배정 매니저}"` 처럼 칸 하나만 적으면(받는 칸이 같은 표를 가리킬 때) 행 자체가 옮겨집니다.
+
+```json
+[{ "label": "투입확정 시 사업장 등록",
+   "when": [{ "property": "상태", "op": "changed_to", "value": "투입확정" },
+            { "property": "사업장", "op": "is_empty" }],
+   "steps": [{ "kind": "add_row", "database": "/사업장 마스터",
+     "values": { "업체명": "{요청 건}", "담당 매니저": "{배정 매니저}" },
+     "link": { "relation": "채용 요청", "from": "selected" },
+     "match": { "key": "{요청 건}", "on": "업체명",
+                "normalize": ["spaces", "parens", "suffix:의원", "trailingDigits"], "fill": "empty" } }] }]
+```
+
+`rootr db automations <표>` 는 규칙마다 "같은 행이 있으면 잇기"와 마지막 사유(후보 여러 곳·조건에 걸려
+비운 칸)를 함께 보여 줍니다.
+
 스캐폴드로 표를 지을 때도 `database.buttons` · `database.automations` 에 같은 모양을 넣으면
 **표와 함께** 달립니다.
 
@@ -782,9 +809,24 @@ rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해
 `rootr_append_page_blocks`, `rootr_update_page`, `rootr_update_page_block`,
 `rootr_read_page_live_data`)로 저작합니다.
 
-HTML을 짜는 것이 아니라 **정해진 블록 14종을 골라 쌓습니다** — `hero` `text`
+HTML을 짜는 것이 아니라 **정해진 블록 15종을 골라 쌓습니다** — `hero` `text`
 `features` `gallery` `pricing` `testimonials` `faq` `timeline` `cta` `footer` +
-표에서 값을 끌어오는 `liveStats` `liveTable` `liveChart` + 신청을 받는 `form` + 자유 블록 `custom`.
+표에서 값을 끌어오는 `liveStats` `liveTable` `liveChart` + 신청을 받는 `form` +
+방문자가 시간을 잡는 `booking`(`{bookingNodeId, headline?, type?}` — 예약을 켜고 공개한 표의 노드 id) +
+자유 블록 `custom`.
+
+**랜딩 페이지**용으로 두 블록은 가운데 본문 기둥을 벗어나 화면 폭 전체를 쓸 수 있습니다.
+`hero`에 `size: "screen"`을 주면 화면 한 장을 채우는 큰 제목(화면 폭 전체·화면 높이·큰 글자)이 되고,
+`custom`에 `bleed: true`를 주면 좌우·위아래 여백 없이 화면 폭 전체를 써서 연달아 놓은 블록이
+틈 없는 색 띠로 이어집니다. `custom`에 `minHeight: "screen"`을 주면 어느 기기에서나 틀 높이가
+화면 한 장이 되고(숫자 `height`를 같이 주면 그 값이 하한), `bleed: true`와 함께 쓰면 화면을 꽉 채우는
+섹션이 됩니다. 맨 위 이름 줄은 `config.navEnabled: false`로 끕니다.
+
+**스크롤 등장 효과** — 어느 블록이나 `reveal: "fade"`(서서히) 또는 `"fade-up"`(아래에서 위로)을 주면
+(기본 `"none"`), 발행한 페이지에서 그 블록이 화면에 들어올 때 한 번 나타납니다(큰 제목은 제목 → 부제 →
+버튼 순서로). `custom`에 `reveal`을 주면 **틀 안의 CSS 애니메이션도 그 순간에 시작**합니다 — 틀을 블록이
+화면에 들어올 때 만들기 때문입니다. `@keyframes`는 `@media (prefers-reduced-motion: no-preference)` 안에
+적으세요. 움직임 줄이기를 켠 방문자에게는 효과 없이 바로 보입니다.
 
 `custom`은 **격리된 방**입니다: HTML/CSS를 마음대로 쓰되 `sandbox` 아이프레임 안에서만
 그려집니다(스크립트 없음·같은 출처 아님·바깥 통신 차단). 그래서 대담한 CSS도 바깥 화면을

package/README.md

@@ -11,7 +11,7 @@ citations back to the exact paragraph.
 *(한국어 문서: [README.ko.md](https://github.com/gwmage/rootr-cli/blob/main/README.ko.md))*
 
 - `rootr` CLI — documents, databases, forms, signed documents, publishing, permissions, memory
-- `rootr mcp` — stdio MCP server, **178 tools** (see [MCP tools](#mcp-tools))
+- `rootr mcp` — stdio MCP server, **192 tools** (see [MCP tools](#mcp-tools))
 
 Plain Node.js ESM, no build step. Node 18+ (uses the built-in `fetch`).
 
@@ -117,6 +117,11 @@ After that, `rootr use` (and the `rootr_use_workspace` MCP tool) accepts a **nam
 rootr.io URL**; the key that opens that workspace is selected and remembered automatically. An
 account key (PAT) switches to any workspace you belong to.
 
+If the MCP server was started with `ROOTR_WORKSPACE` set (the usual `env: {…}` block in an MCP client
+config), the env var wins again on every restart: a `rootr_use_workspace` switch applies for as long as
+that server process runs, and the reply says which workspace it returns to after a restart/reconnect.
+To make the switch permanent, change (or remove) `ROOTR_WORKSPACE` in that config.
+
 A workspace key does not open anything outside its own workspace. Because of that, `rootr ws`
 marks entries your registered keys cannot open — **being listed and being reachable are not the
 same thing**.
@@ -192,7 +197,13 @@ rootr db rows-new /projects/tasks --file rows.json    # many at once — all or
 rootr db rows-set /projects/tasks --ids r1,r2 --values '{"Status":"Done"}'
 rootr db rows-each /projects/tasks --json '[{"rowId":"r1","values":{"Score":3}}]'
 rootr db rows-rm  /projects/tasks --ids r1,r2 --yes
+rootr db duplicates /hr/applicants --row r9            # same person (dedupe column) + latest linked history
+rootr db merge /hr/applicants r9 --into r1             # merge a duplicate into the existing row
+rootr db keep-duplicate /hr/applicants r9 --from r1    # keep as a new row, link both
+rootr db history /hr/applicants --row r1               # who changed what, when, how
+rootr db restore /hr/applicants --at 2026-10-15T09:00:00+09:00 --yes  # rows + columns/views back to that time
 rootr db view /projects/tasks Calendar --scale month  # views: table, board, calendar, timeline
+rootr db view /hr/applicants Board --cards "Interview date,Phone"  # fields shown on board cards
 rootr db lock /projects/tasks --schema managers --rows own --locked "Approved,Score"
 rootr db notify  /projects/tasks --file rules.json    # notification rules
 rootr db buttons /projects/tasks --file buttons.json  # buttons that do work when pressed
@@ -210,6 +221,13 @@ add `on: ["schedule"]` with `schedule: { at: "09:00" }` for a daily job (Korean
 Prefer `changed_to` over `is`: `is` stays true on every later edit, so a rule that creates
 rows would create them again each time the row is saved.
 
+A rule that registers into a master table should not duplicate customers who are already
+there: give the `add_row` a `match: { key: "{Request}", on: "Company", normalize: ["spaces",
+"parens", "suffix:Clinic", "trailingDigits"], fill: "empty" }`. One matching row → linked
+instead of created; none → created; several → nothing is created and the request row gets a
+"several candidates" comment. A value that is exactly `"{Assigned manager}"` going into a
+relation to the same table copies the linked rows, not their titles.
+
 `--upsert-key` is what makes a migration or a sync safe to retry — without it, retrying
 after a partial failure silently double-loads (a real incident: 903 duplicate rows).
 
@@ -389,12 +407,12 @@ is refused and says when the grace was used.
 
 ## MCP tools
 
-`rootr mcp` speaks MCP over stdio. 178 tools:
+`rootr mcp` speaks MCP over stdio. 192 tools:
 
 | Group | Count | Tools |
 |---|---|---|
 | Documents | 22 | list, read, write, append, edit, search, comment, version history, commits & merges, publish, trash & restore |
-| Databases | 26 | create, columns, views, rows (single & bulk), row pages, permissions, notifications, buttons |
+| Databases | 32 | create, columns, views, rows (single & bulk), row pages, permissions, notifications, buttons, duplicates (find / merge / keep & link), history & point-in-time restore (row / whole table) |
 | CRM | 18 | companies, contacts, deals (incl. pipeline moves), activities, tasks, CSV import |
 | Signed documents & research notes | 14 | create, sign, revise, reject, reopen, approval lines, signing codes, ledger verification, research-note preset |
 | Forms | 10 | create, read, update, responses, share links, collectors |
@@ -408,7 +426,7 @@ is refused and says when the grace was used.
 | LOG datastores | 5 | create store, update fields, add entries, query, stats |
 | Templates | 4 | list, apply, save as template, update |
 | Whiteboards | 3 | create, read and update the shapes & edges scene |
-| Attachments | 2 | upload a file, attach an image straight into a document |
+| Attachments | 4 | upload a file, attach an image straight into a document, upload by presigned URL (`rootr_create_upload_url` → PUT the bytes → `rootr_complete_upload`; for large files and the remote connector, where `filePath` is not available) |
 | Agent memory | 3 | remember, recall, forget |
 | Webhooks | 3 | list, create (secret shown once), delete |
 | Visitor booking & Google Calendar | 6 | turn a published table into a booking page, rules, open slots, connect / list / disconnect Google Calendar |
@@ -446,9 +464,26 @@ signed-document, issue, CRM and LOG tools need `docs:read` / `docs:write`; `root
 ### Pages
 
 A PAGE is **a screen for people outside the workspace** — an event announcement, a product page,
-a sign-up. You do not write HTML: you stack **14 predefined block types** — `hero`, `text`,
+a sign-up. You do not write HTML: you stack **15 predefined block types** — `hero`, `text`,
 `features`, `gallery`, `pricing`, `testimonials`, `faq`, `timeline`, `cta`, `footer`, the
-table-backed `liveStats`, `liveTable`, `liveChart`, the `form` block, and the free-form `custom`.
+table-backed `liveStats`, `liveTable`, `liveChart`, the `form` block, the `booking` block
+(a visitor scheduling calendar: `{bookingNodeId, headline?, type?}` — the node id of a published
+table with visitor booking on) — plus the free-form `custom`.
+
+For a **landing page**, two options let a block use the whole page width instead of the centred
+text column: `hero` with `size: "screen"` is a full-screen hero (edge to edge, one viewport tall,
+large headline), and `custom` with `bleed: true` spans the full width with no gap around it, so
+consecutive bleed blocks read as seamless colour bands. `custom` with `minHeight: "screen"` is one
+viewport tall on every device (a numeric `height` given with it is the floor), so
+`bleed: true` + `minHeight: "screen"` is a section that fills the screen. Pair them with
+`config.navEnabled: false`.
+
+For **scroll-in animation**, any block takes `reveal: "fade"` or `"fade-up"` (default `"none"`): on
+the published page it appears once, when it scrolls into view (a hero staggers title → subtitle →
+button). On a `custom` block `reveal` also **starts the CSS animations inside the frame at that
+moment** — the frame is created only when the block scrolls in — so put your `@keyframes` there and
+wrap them in `@media (prefers-reduced-motion: no-preference)`. Visitors who ask for reduced motion
+see everything at once.
 
 `custom` is an **isolated room**: write any HTML/CSS you like, but it renders inside a `sandbox`
 iframe (no scripts, not same-origin, no outbound calls), so even bold CSS cannot leak onto the

package/bin/rootr.js

@@ -5,7 +5,7 @@ import { dirname, join, basename, extname } from 'node:path';
 
 import { loadConfig, saveConfig, keyForWorkspace, maskKey, upsertKey, CONFIG_PATH, DEFAULT_BASE_URL } from '../lib/config.js';
 import { candidateClients, rememberWorkspace, resolveWorkspaceSwitch, surveyWorkspaces } from '../lib/credentials.js';
-import { RootrClient, RootrApiError } from '../lib/client.js';
+import { RootrClient, RootrApiError, imageMarkdown } from '../lib/client.js';
 import { resolveTarget, requireResolved, resolveMoveDestination } from '../lib/resolve.js';
 import { t as tr, lang } from '../lib/i18n.js';
 
@@ -38,13 +38,18 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr db button-run <path|id> <buttonId> [--rows id,id]     버튼 한 번 누르기 (행 만들기·값 채우기·AI 채우기)
   rootr db automations <path|id> [--file rules.json] [--clear] 자동 규칙 — "값이 이렇게 되면 이 일을 해라"·정해진 시각
   rootr db import-sheets <파일.xlsx> --ws <id> [--dry]         시트 수백 장짜리 엑셀을 표 하나로 접어 가져오기
-  rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름]  뷰 목록·달력 주/달/해 단위
+  rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--cards "칸,칸"]  뷰 목록·달력 주/달/해 단위·보드 카드에 보일 칸
   rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  행 추가(상세 내용 포함)
   rootr db row-body <path|id> <rowId> [--file <f>] 행의 상세 내용(본문 메모) 쓰기 — 없으면 표준입력
   rootr db rows-new <path|id> --json '[{…},…]' | --file <파일>   여러 행 한 번에 넣기 (하나라도 틀리면 전부 취소)
   rootr db rows-set <path|id> --ids <id,id> --values '<json>'  고른 행 전부에 같은 값 (날짜 일괄 변경 등)
   rootr db rows-each <path|id> --json '[{"rowId":…,"values":{…}},…]'  행마다 다른 값으로 한 번에 수정
   rootr db rows-rm <path|id> --ids <id,id> [--yes]  고른 행 한 번에 삭제 — 하나라도 막히면 통째로 거절
+  rootr db duplicates <path|id> (--row <rowId> | --values '<json>') [--json]  같은 사람(중복 감지 칸 값이 같은 행)과 그 이력
+  rootr db merge <path|id> <rowId> --into <기존 rowId>       중복 행을 기존 행에 합치기(빈 칸만 채움, rowId 행은 지움)
+  rootr db keep-duplicate <path|id> <rowId> --from <이전 rowId>  새 행으로 두되 이전 행과 서로 링크
+  rootr db history <path|id> [--row <rowId>] [--limit N] [--json]  행·표 변경 이력(누가·언제·어떻게·전후 값)
+  rootr db restore <path|id> --at <ISO 시각> [--yes]          표 전체(행+칸·보기·버튼·규칙)를 그 시각으로 — --yes 없으면 미리보기만
   rootr db row-page <rowId> [--type RECORDING]     이 행만 원하는 타입으로 상세 붙이기(녹음·스프레드시트·서명문서…)
   rootr db row-page <rowId> --node <path|id>       이미 있는 문서를 이 행에 잇기 (옮기지 않고 가리킴)
   rootr db row-page <rowId> --unlink               연결만 끊기 — 문서는 그대로 남음
@@ -146,6 +151,11 @@ usage:
   rootr db rows-set <path|id> --ids <id,id> --values '<json>'  same value on every chosen row (bulk date changes, …)
   rootr db rows-each <path|id> --json '[{"rowId":…,"values":{…}},…]'  a different value per row, in one call
   rootr db rows-rm <path|id> --ids <id,id> [--yes]  delete chosen rows at once — one blocked row rejects all
+  rootr db duplicates <path|id> (--row <rowId> | --values '<json>') [--json]  rows of the same person (same dedupe value) with history
+  rootr db merge <path|id> <rowId> --into <existing rowId>   merge a duplicate into the existing row (fills blanks, deletes rowId)
+  rootr db keep-duplicate <path|id> <rowId> --from <earlier rowId>  keep as a new row but link both rows
+  rootr db history <path|id> [--row <rowId>] [--limit N] [--json]  change history (who, when, how, before/after)
+  rootr db restore <path|id> --at <ISO time> [--yes]           restore the whole table (rows + columns/views/buttons/rules) — preview without --yes
   rootr db row-page <rowId> [--type RECORDING]     give this row a typed detail page (recording, spreadsheet, signed doc…)
   rootr db row-page <rowId> --node <path|id>       attach an existing document to this row (points at it, does not move it)
   rootr db row-page <rowId> --unlink               unlink only — the document stays
@@ -576,7 +586,7 @@ async function cmdAttach(args) {
 
   const { id } = await client.uploadAttachment(workspace, { filename, mimeType, nodeId, data });
   const url = client.attachmentRawUrl(id);
-  const markdown = `![${args.alt || filename}](${url})`;
+  const markdown = imageMarkdown(args.alt || filename, url);
 
   if (nodeId) {
     const result = await client.appendDocument(nodeId, { content: markdown, underHeading: args.heading });
@@ -1361,11 +1371,24 @@ async function cmdDbAutomations(args) {
     if (a.when) console.log(`  ${tr('조건', `if`)}: ${a.when.property} ${a.when.op} ${a.when.value ?? ''}`);
     for (const [i, st] of (a.steps ?? []).entries()) {
       const where = st.database ? ` → ${st.database}` : '';
-      console.log(`  ${i + 1}. ${st.kind}${where}`);
+      console.log(`  ${i + 1}. ${st.kind}${where}${matchNote(st)}`);
     }
+    // AUTO-MATCH · AUTO-REL-COPY — 후보 여러 곳·조건에 걸려 비운 칸도 여기(사유 자리)에 남는다.
+    if (a.lastError?.message) console.log(`  ${tr('사유', `note`)}: ${a.lastError.message}`);
   }
 }
 
+/** AUTO-MATCH — `add_row.match` 가 있으면 "같은 행이 있으면 잇기"를 한 줄로. */
+function matchNote(st) {
+  if (st.kind !== 'add_row' || !st.match) return '';
+  const norm = st.match.normalize?.length ? ` [${st.match.normalize.join(', ')}]` : '';
+  const fill = st.match.fill === 'empty' ? tr(', 빈 칸 채움', `, fill blanks`) : '';
+  return tr(
+    ` · 같은 행이 있으면 잇기(${st.match.on} = ${st.match.key}${norm}${fill})`,
+    ` · link to an existing row if one matches (${st.match.on} = ${st.match.key}${norm}${fill})`,
+  );
+}
+
 /**
  * XLSX-FOLD — 시트가 수백 장인 엑셀을 **표 하나로 접어** 가져온다.
  *
@@ -1544,6 +1567,111 @@ async function cmdDbRowsRm(args) {
   console.log(tr(`${res.deleted}개 행을 지웠습니다.`, `${res.deleted} rows deleted.`));
 }
 
+/**
+ * DEDUPE(F5) — `rootr db duplicates <표> --row <rowId>` 또는 `--values '{"연락처":"010-…"}'`.
+ * 같은 사람(중복 감지 칸 값이 같은 행)마다 보일 칸과 이어진 행 최근 5건(연락 이력)을 보인다.
+ */
+async function cmdDbDuplicates(args) {
+  const target = args._[1];
+  if (!target || (typeof args.row !== 'string' && typeof args.values !== 'string')) {
+    throw new Error(usage(`rootr db duplicates <path|id> (--row <rowId> | --values '<json>') [--json]`));
+  }
+  let values;
+  if (typeof args.values === 'string') {
+    try {
+      values = JSON.parse(args.values);
+    } catch {
+      throw new Error(tr('--values 를 JSON 으로 읽을 수 없습니다.', 'Could not read --values as JSON.'));
+    }
+  }
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.findDuplicates(id, { rowId: typeof args.row === 'string' ? args.row : undefined, values });
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  if (!res.matches.length) return console.log(tr('같은 값의 기존 행이 없습니다.', 'No existing row has the same value.'));
+  for (const m of res.matches) {
+    console.log(tr(`「${m.propName}」 ${m.value} 같은 행:`, `Rows with ${m.propName} = ${m.value}:`));
+    for (const r of m.rows) {
+      console.log(`- ${r.title || '(제목 없음)'}\t${r.id}`);
+      for (const p of r.preview) console.log(`    ${p.name}: ${p.value}`);
+      for (const h of r.history ?? []) {
+        console.log(`    ${h.propName} ${h.total}${tr('건', '')}`);
+        for (const x of h.rows) console.log(`      · ${[x.title, ...x.fields.map((f) => f.value)].filter(Boolean).join(' · ')}`);
+      }
+    }
+  }
+}
+
+/** DEDUPE — `rootr db merge <표> <rowId> --into <기존 rowId>` */
+async function cmdDbMerge(args) {
+  const [, target, rowId] = args._;
+  if (!target || !rowId || typeof args.into !== 'string') throw new Error(usage(`rootr db merge <path|id> <rowId> --into <rowId>`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.mergeRows(id, rowId, args.into);
+  console.log(
+    tr(
+      `합쳤습니다 → ${res.into} (빈 칸 채움: ${res.filled.join(', ') || '없음'}). ${rowId} 행은 지웠습니다.`,
+      `Merged into ${res.into} (filled: ${res.filled.join(', ') || 'none'}). Row ${rowId} was deleted.`,
+    ),
+  );
+}
+
+/** ROW-HISTORY — `rootr db history <표> [--row <rowId>] [--limit N] [--json]` */
+async function cmdDbHistory(args) {
+  const target = args._[1];
+  if (!target) throw new Error(usage(`rootr db history <path|id> [--row <rowId>] [--limit N] [--json]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.databaseHistory(id, { rowId: typeof args.row === 'string' ? args.row : undefined, limit: args.limit ? Number(args.limit) : 50 });
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  for (const c of res.changes) {
+    const cols = [...new Set([...Object.keys(c.before ?? {}), ...Object.keys(c.after ?? {})])];
+    console.log(`${c.at}\t${c.kind}\t${c.rowId}\t${c.actor?.name ?? '-'}${c.via ? ` (${c.via})` : ''}\t${cols.join(',')}\t${c.id}`);
+  }
+}
+
+/** ROW-RESTORE — `rootr db restore <표> --at <ISO> [--yes]` (--yes 없으면 미리보기) */
+async function cmdDbRestore(args) {
+  const target = args._[1];
+  if (!target || typeof args.at !== 'string') throw new Error(usage(`rootr db restore <path|id> --at <ISO time> [--yes]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const preview = await client.restoreDatabase(id, args.at, { dryRun: true });
+  const sc = preview.schema ?? {};
+  console.log(
+    tr(
+      `고칠 행 ${preview.updates} · 되살릴 행 ${preview.creates} · 지울 행 ${preview.deletes}` +
+        (sc.restorable ? (sc.differs ? ` · 표 정의: 되살릴 칸 ${sc.propsAdded}, 뺄 칸 ${sc.propsRemoved}, 바뀌는 칸 ${sc.propsChanged}${sc.views ? ', 보기' : ''}${sc.buttons ? ', 버튼' : ''}${sc.automations ? ', 자동 규칙' : ''}` : ' · 표 정의는 같음') : ' · 그 시각의 표 정의 기록 없음(행만)'),
+      `rows to edit ${preview.updates} · revive ${preview.creates} · delete ${preview.deletes}` +
+        (sc.restorable ? (sc.differs ? ` · definition: ${sc.propsAdded} column(s) back, ${sc.propsRemoved} removed, ${sc.propsChanged} changed${sc.views ? ', views' : ''}${sc.buttons ? ', buttons' : ''}${sc.automations ? ', automations' : ''}` : ' · definition unchanged') : ' · no definition record at that time (rows only)'),
+    ),
+  );
+  if (!args.yes) return console.log(tr('미리보기입니다. 되돌리려면 --yes 를 붙이세요.', 'Preview only. Add --yes to restore.'));
+  const res = await client.restoreDatabase(id, args.at);
+  if (res.job) {
+    let job = { done: 0, total: res.job.total, state: 'running' };
+    while (job.state !== 'done') {
+      await new Promise((r) => setTimeout(r, 2000));
+      job = await client.restoreJob(id, res.job.id);
+      process.stderr.write(`\r${job.done}/${job.total}`);
+    }
+    process.stderr.write('\n');
+    if (job.failed) console.log(tr(`되돌리지 못한 행 ${job.failed}개 — 같은 시각으로 다시 실행하세요.`, `${job.failed} row(s) failed — run the same restore again.`));
+  }
+  console.log(tr('되돌렸습니다.', 'Restored.'));
+}
+
+/** DEDUPE-KEEP — `rootr db keep-duplicate <표> <rowId> --from <이전 rowId>` */
+async function cmdDbKeepDuplicate(args) {
+  const [, target, rowId] = args._;
+  if (!target || !rowId || typeof args.from !== 'string') throw new Error(usage(`rootr db keep-duplicate <path|id> <rowId> --from <rowId>`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  await client.keepDuplicate(id, rowId, args.from);
+  console.log(tr(`새 행으로 두고 ${args.from} 행과 서로 링크를 남겼습니다.`, `Kept as a new row and linked with ${args.from}.`));
+}
+
 /**
  * PUBLIC-ANY — `rootr publish <노드> [--children|--off|--status]`
  *
@@ -2161,6 +2289,11 @@ async function cmdDb(args) {
   if (sub === 'rows-each') return cmdDbRowsEach(args);
   if (sub === 'rows-set') return cmdDbRowsSet(args);
   if (sub === 'rows-rm') return cmdDbRowsRm(args);
+  if (sub === 'duplicates') return cmdDbDuplicates(args);
+  if (sub === 'merge') return cmdDbMerge(args);
+  if (sub === 'keep-duplicate') return cmdDbKeepDuplicate(args);
+  if (sub === 'history') return cmdDbHistory(args);
+  if (sub === 'restore') return cmdDbRestore(args);
   if (sub === 'row-page') return cmdDbRowPage(args);
   if (sub === 'row-page-type') return cmdDbRowPageType(args);
   if (sub === 'lock') return cmdDbLock(args);
@@ -2172,7 +2305,7 @@ async function cmdDb(args) {
   if (sub === 'view') return cmdDbView(args);
   if (sub !== 'create') {
     throw new Error(
-      usage(tr(`rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|row-page|row-page-type|lock|notify|buttons|button-run|automations|import-sheets|view … (자세한 건 rootr --help)`, `rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|row-page|row-page-type|lock|notify|buttons|button-run|view … (see rootr --help)`)),
+      usage(tr(`rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|duplicates|merge|keep-duplicate|history|restore|row-page|row-page-type|lock|notify|buttons|button-run|automations|import-sheets|view … (자세한 건 rootr --help)`, `rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|duplicates|merge|keep-duplicate|history|restore|row-page|row-page-type|lock|notify|buttons|button-run|view … (see rootr --help)`)),
     );
   }
   const raw = typeof args.file === 'string' ? readFileSync(args.file, 'utf8') : await readStdin();
@@ -2295,7 +2428,7 @@ async function cmdDbNotify(args) {
  */
 async function cmdDbView(args) {
   const target = args._[1];
-  if (!target) throw new Error(usage(tr(`rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--json]`, `rootr db view <path|id> [view name] [--scale week|month|year] [--name <new name>] [--json]`)));
+  if (!target) throw new Error(usage(tr(`rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--cards "칸,칸"] [--json]`, `rootr db view <path|id> [view name] [--scale week|month|year] [--name <new name>] [--cards "field,field"] [--json]`)));
 
   const client = makeClient();
   const id = await resolveDatabaseId(client, target);
@@ -2329,8 +2462,13 @@ async function cmdDbView(args) {
     patch.calendarScale = scale;
   }
   if (typeof args.name === 'string') patch.name = args.name;
+  // CARD-PROPS — 보드 카드에 보일 칸(이름 또는 id, 쉼표로). "" 이면 기본으로.
+  if (typeof args.cards === 'string') {
+    const cards = args.cards.split(',').map((c) => c.trim()).filter(Boolean);
+    patch.cardProps = cards.length ? cards : null;
+  }
   if (!Object.keys(patch).length) {
-    throw new Error(tr('바꿀 것을 주세요: --scale week|month|year 또는 --name 새이름', `Give something to change: --scale week|month|year, or --name <new name>`));
+    throw new Error(tr('바꿀 것을 주세요: --scale week|month|year, --name 새이름 또는 --cards "칸,칸"', `Give something to change: --scale week|month|year, --name <new name>, or --cards "field,field"`));
   }
 
   const view = await client.updateDatabaseView(id, viewRef, patch);
@@ -2410,7 +2548,7 @@ async function cmdDbButtons(args) {
           : st.values
             ? ' · ' + Object.entries(st.values).map(([k, v]) => `${k}=${v}`).join(', ')
             : '';
-      console.log(`  ${i + 1}. ${what}${where}${detail}`);
+      console.log(`  ${i + 1}. ${what}${where}${detail}${matchNote(st)}`);
     }
   }
   if (myLevel && myLevel !== 'MANAGE' && myLevel !== 'FULL') {
@@ -2448,6 +2586,9 @@ async function cmdDbButtonRun(args) {
   if (madeCount) parts.push(tr(`행 ${madeCount}개 만듦`, `${madeCount} rows created`));
   if (r.updated) parts.push(tr(`행 ${r.updated}개 고침`, `${r.updated} rows changed`));
   if (r.filled) parts.push(tr(`AI로 칸 ${r.filled}개 채움`, `${r.filled} columns filled by AI`));
+  // AUTO-MATCH — 새로 만들지 않고 있던 행에 이은 것 / 후보가 여럿이라 멈춘 것.
+  if (r.matched?.linked) parts.push(tr(`있던 행 ${r.matched.linked}개에 이음`, `${r.matched.linked} linked to existing rows`));
+  if (r.matched?.ambiguous) parts.push(tr(`후보 여러 곳이라 멈춤 ${r.matched.ambiguous}건(행 댓글 확인)`, `${r.matched.ambiguous} stopped — several candidates (see the row comment)`));
   console.log(parts.length ? parts.join(' · ') : tr('바뀐 것이 없습니다.', `Nothing changed.`));
   if (r.openRowId) console.log(tr(`열 행: ${r.openRowId}`, `Row to open: ${r.openRowId}`));
   // AI가 못 채워도 버튼은 계속 돈다 — 조용히 넘어가면 사람이 왜 빈칸인지 모른다.
@@ -2458,6 +2599,8 @@ async function cmdDbButtonRun(args) {
         `${r.aiFailed} columns the AI could not fill${r.aiError ? ` — ${r.aiError}` : ''}`,
       ),
     );
+  for (const n of r.notes ?? []) console.log(`· ${n}`);
+  if (r.linkWarning) console.log(`· ${r.linkWarning}`);
 }
 
 

package/lib/client.js

@@ -1221,13 +1221,74 @@ export class RootrClient {
     });
   }
 
-  async updateColumn(databaseId, propertyId, { name, options, formula, rollup, prefix, reverseName, searchExcluded } = {}) {
+  async updateColumn(
+    databaseId,
+    propertyId,
+    { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter } = {},
+  ) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}`,
-      { method: 'PATCH', body: { name, options, formula, rollup, prefix, reverseName, searchExcluded } },
+      {
+        method: 'PATCH',
+        body: { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter },
+      },
     );
   }
 
+  /**
+   * DEDUPE(F5) — 중복 감지 칸 값이 같은 기존 행. `rowId` 를 주면 그 행의 지금 값으로(그 행은 빠진다), 아니면 `values`
+   * ({칸 id 또는 이름: 값})로 찾는다. 기존 행마다 보일 칸(preview)과 이어진 행 최근 5건(history)이 함께 온다.
+   */
+  async findDuplicates(databaseId, { rowId, values } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/duplicates`, {
+      method: 'POST',
+      body: rowId ? { rowId } : { values: values ?? {} },
+    });
+  }
+
+  /** DEDUPE — `rowId` 행을 `into` 행에 합친다(빈 칸만 채우고 "재지원" 댓글, `rowId` 행은 지운다). */
+  async mergeRows(databaseId, rowId, into) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}/merge`, {
+      method: 'POST',
+      body: { into },
+    });
+  }
+
+  /** ROW-HISTORY(F6) — 표(또는 한 행)의 변경 이력, 최신부터. `before`+`beforeId` 로 이어 읽는다. */
+  async databaseHistory(databaseId, { rowId, before, beforeId, limit } = {}) {
+    const q = new URLSearchParams();
+    if (rowId) q.set('rowId', rowId);
+    if (before) q.set('before', before);
+    if (beforeId) q.set('beforeId', beforeId);
+    if (limit) q.set('limit', String(limit));
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/history${q.toString() ? `?${q}` : ''}`);
+  }
+
+  /** ROW-RESTORE(F7) — 행 하나를 그 변경의 전(`before`)/후(`after`) 모습으로. 지운 행도 되살린다. */
+  async restoreRow(databaseId, rowId, changeId, side = 'after') {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}/restore`, {
+      method: 'POST',
+      body: { changeId, side },
+    });
+  }
+
+  /** ROW-RESTORE(F7·G3) — 표 전체(행 + 칸·보기·버튼·자동 규칙)를 그 시각으로. `dryRun` 이면 미리보기만. 큰 표는 `job` 이 온다. */
+  async restoreDatabase(databaseId, at, { dryRun } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/restore`, { method: 'POST', body: { at, dryRun: dryRun === true } });
+  }
+
+  async restoreJob(databaseId, jobId) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/restore/${encodeURIComponent(jobId)}`);
+  }
+
+  /** DEDUPE-KEEP — 새 행으로 두되 같은 사람의 이전 행(`from`)과 서로 링크 댓글을 남긴다. */
+  async keepDuplicate(databaseId, rowId, from) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}/keep-duplicate`, {
+      method: 'POST',
+      body: { from },
+    });
+  }
+
   // DB-VECTOR — 에이전트용 벡터 칸(칸 id 또는 이름).
   async putVectors(databaseId, column, items) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/vectors/${encodeURIComponent(column)}`, {
@@ -1652,6 +1713,24 @@ export class RootrClient {
     return `${this.publicBaseUrl}/attachments/${encodeURIComponent(attachmentId)}/raw`;
   }
 
+  /**
+   * ISSUE-222 — presigned-URL upload (option 1 from the feature request): the
+   * caller PUTs the file bytes straight to S3 from wherever it has local disk
+   * access, instead of inlining them into an MCP tool call as base64Data.
+   * Mirrors the editor's presign→PUT→complete flow (`/attachments/presign`).
+   */
+  async presignAttachment(workspaceId, { filename, mimeType, size, nodeId } = {}) {
+    return this.request('/attachments/presign', {
+      method: 'POST',
+      body: { workspaceId, filename, mimeType, size, nodeId },
+    });
+  }
+
+  /** Marks a presigned attachment READY after the bytes have been PUT to S3. */
+  async completeAttachment(attachmentId) {
+    return this.request(`/attachments/${encodeURIComponent(attachmentId)}/complete`, { method: 'POST' });
+  }
+
   // ---- Spreadsheets ---------------------------------------------------------
 
   async listSpreadsheets(workspace) {
@@ -2043,3 +2122,22 @@ export class RootrClient {
   }
 
 }
+
+/**
+ * `![alt](url)` — 문서에 그대로 붙여 넣을 그림 한 줄.
+ *
+ * alt 자리에는 파일 이름이 그대로 들어가는데, 이름에 `]` 가 있으면 거기서 대괄호가 닫혀 그림이
+ * 아니라 깨진 글자가 되고(실측: 편집기에서 그림이 안 뜬다), `![가짜](http://…)` 같은 이름은
+ * 남의 주소의 그림을 문서에 끼워 넣는다. 역슬래시로 피하는 방법은 편집기의 해석기가 역슬래시를
+ * 글자 그대로 보여 줘서 쓰지 않는다 — 대괄호는 소괄호로, 역슬래시는 빗금으로, 줄바꿈·탭은
+ * 빈칸으로 바꾼다(alt 는 설명 글이라 뜻이 달라지지 않는다). 저장되는 파일 이름은 건드리지 않는다.
+ */
+export function imageMarkdown(alt, url) {
+  const safe = String(alt ?? '')
+    .replace(/\[/g, '(')
+    .replace(/\]/g, ')')
+    .replace(/\\/g, '/')
+    .replace(/[\r\n\t]+/g, ' ')
+    .trim();
+  return `![${safe}](${url})`;
+}