rootr-cli 0.26.0 → 0.29.0

package/bin/rootr.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join, basename, extname } from 'node:path';
 
@@ -9,6 +9,7 @@ import { RootrClient, RootrApiError, imageMarkdown } from '../lib/client.js';
 import { setGlobalDocMailSink } from '../lib/context.js';
 import { resolveTarget, requireResolved, resolveMoveDestination } from '../lib/resolve.js';
 import { t as tr, lang } from '../lib/i18n.js';
+import { domainPaymentHelp, slotLine } from '../lib/domain-billing.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -23,6 +24,8 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr embed <문서 path|id> <끼울 노드 path|id> [--heading "## X"]  문서 안에 표·시트·발표자료를 **살아 있는 채로** 끼워 넣기
   rootr edit <path|id> --find <text> --replace <text> [--all]      본문 내 텍스트 치환
   rootr comments <path|id> [--block <id>] [--json]  문서에 달린 댓글 읽기 (공개 페이지 댓글 포함)
+  rootr members [--workspace <id>] [--json]         워크스페이스 구성원 목록 (id\t이름\t이메일\t역할)
+  rootr message <userId> <text> [--workspace <id>]  구성원에게 바로 메시지 보내기 (문서/이슈에 매이지 않음)
   rootr search <query>                             워크스페이스 검색
   rootr mv <path|id> <새 경로|폴더 id>              문서/폴더 이동 및/또는 이름 변경
   rootr rm <path|id> [--yes]                       문서/폴더를 휴지통으로 이동 (복구 가능)
@@ -53,6 +56,9 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr db keep-duplicate <path|id> <rowId> --from <이전 rowId>  새 행으로 두되 이전 행과 서로 링크
   rootr db rename-col <path|id> <칸 이름|id> <새 이름> [--dry]  칸 이름 바꾸기 — 수식·버튼/규칙 {칸}·다른 표 롤업·폼 질문·페이지 블록도 함께(--dry: 무엇이 바뀌는지만)
   rootr db carry-over <path|id> <rowId> [--from <이전 rowId>]  이전 정보 가져오기 — 같은 사람의 이전 행 값을 새 행으로(이전 행은 그대로, 이름은 표의 dedupeCarry.label)
+  rootr db dedupe-preview <path|id> <rowId> [--json '<규칙 덮기>']  중복 처리 미리 보기 — 칸별 전·후·출처, 지울 행(쓰지 않음)
+  rootr db dedupe <path|id> <rowId> [--action carry|merge_into_old|merge_all] [--json '<규칙 덮기>']  중복 처리 적용(opId 로 되돌림)
+  rootr db dedupe-undo <path|id> <opId>  중복 처리 한 번을 통째로 되돌리기(지운 행 되살림)
   rootr db column-set <path|id> <칸 이름|id> --json '<설정>'  칸 설정 바꾸기 — 예: '{"validate":{"kind":"pattern","pattern":"[A-Z]{2}-\\\\d{4}","message":"사번 꼴이 아닙니다"}}', '{"dedupeCarry":{…}}'
   rootr db rule-violations <path|id> [--limit N] [--json]  지금 값 가운데 칸 검사(validate)에 안 맞는 것(고치지 않는다)
   rootr db rule-test --json '<규칙>' <값> [<값>…] [--type number]  값 검사 규칙을 걸기 전에 시험(저장 안 함) · --presets: 예시 꼴 목록
@@ -67,6 +73,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr publish <path|id> --status                 지금 공개인지·주소·하위 포함 여부
   rootr publish <표> --layout board --skin paper   공개한 표를 무슨 꼴로 보일지 (배치 9종 × 분위기 6종)
   rootr publish <문서> --comments [false] [--expires <ISO>] [--skin <분위기>]  문서 전용 — 댓글(편집 제안)·만료일·스킨 16종
+  rootr publish <path|id> --description "<글>" --cover <그림|id|none>  검색 설명문·링크 미리보기 대표 이미지 (검색엔진에 바로 알림)
   rootr booking show <표>                           방문자 일정 등록(예약) 설정 보기
   rootr booking set <표> --on --days 1,2,3,4,5 --hours 10:00-18:00 --duration 30  예약 켜기·규칙
   rootr booking set <표> --ask "연락처:required" --approval manual  방문자에게 더 묻기 · 승인 후 확정
@@ -86,6 +93,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr form collect <path|id> --to db|sheet             응답 모을 곳을 새로 만들어 연결 (표는 질문 그대로 칸 생성)
   rootr form mapping <path|id> [--set '<{"질문id":"칸id"}>']  질문이 표의 어느 칸으로 가는지 보기·정하기 (짝 없으면 값이 버려짐)
   rootr form responses <path|id> [--latest] [--json]  폼에 들어온 응답 보기 (--latest: 사람마다 최신 1건만)
+  rootr form submit <path|id> [--values '<json>'] [--files '{"질문id":["a.pdf","b.pdf"]}']  응답 내기 (파일은 올린 뒤 답으로 붙임 — 여러 개 받는 질문은 배열로)
   rootr form response-edit <응답id> --values '<json>'  이미 낸 응답 고치기 (폼 검사 규칙 다시 통과)
   rootr form response-rm <응답id> [--yes]           응답 한 건 삭제 (되돌릴 수 없음)
   rootr sign new <경로> [--file <f>] [--reviewer <userId>] [--line <line.json>]  서명문서 만들기(본문·결재라인까지)
@@ -112,6 +120,14 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr mail webhook add <url> [--events …] | list | rm <id> | test <id>
                                                    받은 문서·회수·읽음을 내 주소로 알려 주는 웹훅(내 계정 것, HMAC 서명)
                                                    ※ 다른 명령 뒤 새로 받은 문서가 있으면 stderr 로 한 줄 알림(끄기: ROOTR_MAIL_NOTICE=0)
+  rootr domain list                                내 도메인 목록 — 종류(내 도메인·무료 주소)·상태와 가리키는 페이지, 자리 사용(유료 n/m·무료 n/3)
+  rootr domain detect <도메인> [--provider <업체>]   등록 전에 — DNS 를 어디서 관리하는지(가비아·Cloudflare…)와 넣을 한 줄·단계 안내
+  rootr domain add <도메인> <페이지·문서 path|id> [--provider <업체>] [--confirm-charge]  발행한 페이지·문서를 내 도메인(www.회사.co.kr)으로 연결 (Team 플랜, 도메인 1개당 월 $10·연 결제 시 월 $8 — 자리가 꽉 찼으면 --confirm-charge 로 1개 추가 결제)
+  rootr domain add <이름>.rootr.site <페이지 path|id>  무료 주소로 바로 열기(Team 플랜, DNS·결제 없음, 3개까지) — --subdomain <이름> 으로도
+  rootr domain available <이름>                    무료 주소 이름(이름.rootr.site)을 쓸 수 있는지
+  rootr domain check <id>                          지금 다시 확인(연결 전이면 exit 2)
+  rootr domain rename <id> <새 도메인> [--provider <업체>]  연결 전 도메인의 이름 바꾸기(결제 그대로, 새 id 가 나옴)
+  rootr domain remove <id>                         연결 해제
   rootr config [--api-key <k>] [--workspace <w>] [--base-url <u>]  설정 조회/저장
   rootr config --add-key <k> [--label <name>] [--workspace <w>]     워크스페이스별 키 추가 등록
   rootr feedback "<무엇이 안 되는지>" [--kind bug|friction|idea|praise] [--email <주소>]
@@ -125,7 +141,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr memory add "<내용>" [--kind 지시|사람|프로젝트|참고] [--source <경로|id>] [--related a,b]  기억 저장
   rootr memory edit <id> [--content "<내용>"] [--kind …] [--source …] [--related a,b]  기억 고치기(준 칸만)
   rootr memory forget <id> [--hard]                 기억 폐기(--hard면 행 삭제)
-  rootr mcp                                        MCP stdio 서버 구동 (도구 197종 — README 참고)
+  rootr mcp                                        MCP stdio 서버 구동 (도구 214종 — README 참고)
   rootr --help                                     도움말
   rootr --version                                  버전 출력
 
@@ -146,6 +162,8 @@ usage:
   rootr embed <doc path|id> <node path|id> [--heading "## X"]  embed a LIVE table/sheet/deck inside a document
   rootr edit <path|id> --find <text> --replace <text> [--all]      replace text inside the body
   rootr comments <path|id> [--block <id>] [--json]  read comments (including ones left on the public page)
+  rootr members [--workspace <id>] [--json]         list workspace members (id\tname\temail\trole)
+  rootr message <userId> <text> [--workspace <id>]  send a direct message to a member (not tied to a doc/issue)
   rootr search <query>                             search the workspace
   rootr mv <path|id> <new path|folder id>          move and/or rename a document or folder
   rootr rm <path|id> [--yes]                       move to the trash (recoverable)
@@ -178,6 +196,9 @@ usage:
   rootr db keep-duplicate <path|id> <rowId> --from <earlier rowId>  keep as a new row but link both rows
   rootr db rename-col <path|id> <column name|id> <new name> [--dry]  rename a column — formulas, button/rule {col}, other tables' rollups, form questions and page blocks follow (--dry: list only)
   rootr db carry-over <path|id> <rowId> [--from <earlier rowId>]  carry the person's previous row into this row (earlier row untouched)
+  rootr db dedupe-preview <path|id> <rowId> [--json '<rule overrides>']  preview duplicate handling — per-column before/after/source, rows to delete
+  rootr db dedupe <path|id> <rowId> [--action carry|merge_into_old|merge_all] [--json '<rule overrides>']  apply duplicate handling (undo by opId)
+  rootr db dedupe-undo <path|id> <opId>  undo one duplicate-handling operation (recreates deleted rows)
   rootr db column-set <path|id> <column name|id> --json '<settings>'  change a column's settings, e.g. '{"validate":{"kind":"pattern","pattern":"[A-Z]{2}-\\\\d{4}","message":"not an employee id"}}'
   rootr db rule-violations <path|id> [--limit N] [--json]  current values that break a column's validate rule (nothing is changed)
   rootr db rule-test --json '<rule>' <value> [<value>…] [--type number]  try a validate rule on sample values (saves nothing) · --presets: example patterns
@@ -192,6 +213,7 @@ usage:
   rootr publish <path|id> --status                 is it public, at what URL, children included?
   rootr publish <table> --layout board --skin paper   how a published table looks (9 layouts × 6 skins)
   rootr publish <doc> --comments [false] [--expires <ISO>] [--skin <skin>]  documents only — comments, expiry, 16 skins
+  rootr publish <path|id> --description "<text>" --cover <image|id|none>  search description & link-preview cover image (search engines pinged)
   rootr booking show <table>                        show visitor booking settings
   rootr booking set <table> --on --days 1,2,3,4,5 --hours 10:00-18:00 --duration 30  turn on + rules
   rootr booking set <table> --ask "Phone:required" --approval manual  ask more · confirm after approval
@@ -210,6 +232,7 @@ usage:
   rootr form set <path|id> --fields '<json>' | --config '<json>'  change questions/settings (settings merge)
   rootr form collect <path|id> --to db|sheet             create and wire a destination (a table gets a column per question)
   rootr form responses <path|id> [--latest] [--json]  read responses (--latest: newest one per person)
+  rootr form submit <path|id> [--values '<json>'] [--files '{"fieldId":["a.pdf","b.pdf"]}']  submit a response (files are uploaded, then attached — several for a "multiple" file question)
   rootr form response-edit <responseId> --values '<json>'  edit a submitted response (revalidated against the form)
   rootr form response-rm <responseId> [--yes]       delete one response (cannot be undone)
   rootr sign new <path> [--file <f>] [--reviewer <userId>] [--line <line.json>]  create a signed document (body + approval line)
@@ -233,6 +256,14 @@ usage:
   rootr mail access <id> read|comment|write        change what the recipient of a document you sent can do
   rootr mail revoke <id>                           withdraw a document you sent — the recipient can no longer open the original
   rootr mail hide <id> [--box inbox|sent]          remove from your own mailbox (a received one then stops opening for your account)
+  rootr domain list                                your custom domains — status (waiting for DNS / issuing certificate / connected) and page
+  rootr domain detect <domain> [--provider <id>]   before adding — where the DNS is managed (Gabia, Cloudflare…), the one line to add, step by step
+  rootr domain add <domain> <page|doc path|id> [--provider <id>] [--confirm-charge]  open a published page or document at your own domain (Team plan; $10/month per domain, $8 billed yearly — when slots are full, --confirm-charge buys one more)
+  rootr domain add <name>.rootr.site <page path|id>  a free address, live at once (Team plan; no DNS, no payment, up to 3) — or --subdomain <name>
+  rootr domain available <name>                    is the free address name.rootr.site available
+  rootr domain check <id>                          re-check now (exit 2 while not live)
+  rootr domain rename <id> <new domain> [--provider <id>]  change the name of a not-yet-live domain (billing unchanged, new id)
+  rootr domain remove <id>                         disconnect
   rootr config [--api-key <k>] [--workspace <w>] [--base-url <u>]  read/save configuration
   rootr config --add-key <k> [--label <name>] [--workspace <w>]     register an extra per-workspace key
   rootr feedback "<what is not working>" [--kind bug|friction|idea|praise] [--email <address>]
@@ -246,7 +277,7 @@ usage:
   rootr memory add "<content>" [--kind instruction|person|project|reference] [--source <path|id>] [--related a,b]  save a memory
   rootr memory edit <id> [--content "<content>"] [--kind …] [--source …] [--related a,b]  edit a memory (only the fields you pass)
   rootr memory forget <id> [--hard]                 retire a memory (--hard deletes the row)
-  rootr mcp                                        run the MCP stdio server (197 tools — see the README)
+  rootr mcp                                        run the MCP stdio server (214 tools — see the README)
   rootr --help                                     this help
   rootr --version                                  print the version
 
@@ -373,6 +404,51 @@ async function cmdComments(args) {
   }
 }
 
+/** `rootr members [--workspace <id>]` — list the current workspace's members (id, name, email, role). */
+async function cmdMembers(args) {
+  const cfg = loadConfig();
+  const workspace = args.workspace || cfg.workspace;
+  if (!workspace) {
+    throw new RootrApiError(tr('워크스페이스가 설정되지 않았습니다.', `No workspace is configured.`), {
+      hint: tr('--workspace <id>로 넘기거나 rootr config --workspace <id> 또는 ROOTR_WORKSPACE 환경변수를 지정하세요.', `Pass --workspace <id>, or set it with rootr config --workspace <id> or the ROOTR_WORKSPACE environment variable.`),
+    });
+  }
+  const client = new RootrClient({ ...cfg, workspace, apiKey: keyForWorkspace(cfg, workspace) });
+  const members = await client.listMembers(workspace);
+  if (args.json) {
+    console.log(JSON.stringify(members, null, 2));
+    return;
+  }
+  for (const m of members) {
+    console.log(`${m.userId ?? m.user?.id}\t${m.user?.name ?? ''}\t${m.user?.email ?? ''}\t${m.role}`);
+  }
+}
+
+/**
+ * MEMBER-MSG — `rootr message <userId> <text> [--workspace <id>]`
+ *
+ * 2026-10-22 제보(#226): 앱에서는 구성원에게 바로 메시지를 보낼 수 있는데 CLI/MCP에는
+ * 그 길이 없어서 이슈 댓글에 @멘션을 다는 것으로 때워야 했다. 문서/이슈에 매이지 않은
+ * 1:1 알림 경로를 그대로 연다.
+ */
+async function cmdMessage(args) {
+  const userId = args._[0];
+  const body = args._[1];
+  if (!userId || !body) {
+    throw new Error(usage(`rootr message <userId> <text> [--workspace <id>]`));
+  }
+  const cfg = loadConfig();
+  const workspace = args.workspace || cfg.workspace;
+  if (!workspace) {
+    throw new RootrApiError(tr('워크스페이스가 설정되지 않았습니다.', `No workspace is configured.`), {
+      hint: tr('--workspace <id>로 넘기거나 rootr config --workspace <id> 또는 ROOTR_WORKSPACE 환경변수를 지정하세요.', `Pass --workspace <id>, or set it with rootr config --workspace <id> or the ROOTR_WORKSPACE environment variable.`),
+    });
+  }
+  const client = new RootrClient({ ...cfg, workspace, apiKey: keyForWorkspace(cfg, workspace) });
+  await client.messageMember(workspace, userId, body);
+  console.log(tr(`${userId} 에게 메시지를 보냈습니다.`, `Message sent to ${userId}.`));
+}
+
 async function cmdRead(args) {
   const target = args._[0];
   if (!target) throw new Error(usage(`rootr read <path|id> [--json]`));
@@ -1024,10 +1100,11 @@ async function cmdForm(args) {
   if (sub === 'collect') return cmdFormCollect(args);
   if (sub === 'mapping') return cmdFormMapping(args);
   if (sub === 'responses') return cmdFormResponses(args);
+  if (sub === 'submit') return cmdFormSubmit(args);
   if (sub === 'response-edit') return cmdFormResponseEdit(args);
   if (sub === 'response-rm') return cmdFormResponseRm(args);
   throw new Error(
-    usage(tr(`rootr form new|show|set|collect|responses|response-edit|response-rm … (자세한 건 rootr --help)`, `rootr form new|show|set|collect|responses|response-edit|response-rm … (see rootr --help)`)),
+    usage(tr(`rootr form new|show|set|collect|responses|submit|response-edit|response-rm … (자세한 건 rootr --help)`, `rootr form new|show|set|collect|responses|submit|response-edit|response-rm … (see rootr --help)`)),
   );
 }
 
@@ -1088,7 +1165,8 @@ async function cmdFormNew(args) {
   console.log(`  id: ${id}`);
   if (args.collect === 'db' || args.collect === 'sheet') {
     const to = args.collect === 'db' ? 'database' : 'spreadsheet';
-    await client.request(`/forms/${encodeURIComponent(id)}/collect`, { method: 'POST', body: { to } });
+    // 서버는 `target` 만 받는다(`to` 는 검증 파이프가 지워 400 이 났다) — form collect 와 같은 길로.
+    await client.createFormCollector(id, to);
     console.log(tr(`  응답 모을 곳: ${args.collect === 'db' ? '표' : '스프레드시트'} 생성됨`, `  Responses collected into: a ${args.collect === 'db' ? 'table' : 'spreadsheet'} was created`));
   }
 }
@@ -1112,6 +1190,7 @@ async function cmdFormShow(args) {
       f.hidden ? tr('숨김', `hidden`) : null,
       f.page && f.page > 1 ? tr(`${f.page}쪽`, `page ${f.page}`) : null,
       f.showIf ? tr('조건부', `conditional`) : null,
+      f.type === 'file' && f.multiple ? tr(`파일 여러 개(최대 ${f.maxFiles ?? 10})`, `several files (max ${f.maxFiles ?? 10})`) : null,
     ].filter(Boolean);
     console.log(`  ${i + 1}. ${f.name} [${f.type}]${marks.length ? ' · ' + marks.join('·') : ''}`);
     if (f.help) console.log(`     ${f.help}`);
@@ -1263,6 +1342,83 @@ async function cmdFormResponses(args) {
   }
 }
 
+/**
+ * FORM-FILE-MULTI — `rootr form submit <폼> --values '<json>' --files '{"질문id":["a.pdf","b.pdf"]}'`
+ *
+ * 파일 질문은 값으로 **이미 올라간 파일의 표**(`{ id, filename, size }`)를 받는다. 터미널에서 그걸 손으로
+ * 만들려면 `rootr attach` 를 파일마다 부르고 id 를 옮겨 적어야 했다 — 여기서 올리기와 내기를 한 번에 한다.
+ * 여러 개 받는 질문(`multiple`)은 배열로, 한 개 받는 질문은 객체로 붙인다(서버 약속과 같은 모양).
+ */
+async function cmdFormSubmit(args) {
+  const target = args._[1];
+  const usageLine = tr(
+    `rootr form submit <path|id> [--values '<json>'] [--files '{"질문id":["a.pdf","b.pdf"]}']`,
+    `rootr form submit <path|id> [--values '<json>'] [--files '{"fieldId":["a.pdf","b.pdf"]}']`,
+  );
+  if (!target) throw new Error(usage(usageLine));
+  const parseJson = (raw, flag) => {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      throw new Error(tr(`${flag} 를 JSON으로 읽을 수 없습니다.`, `Could not read ${flag} as JSON.`));
+    }
+  };
+  const values = typeof args.values === 'string' ? parseJson(args.values, '--values') : {};
+  const files = typeof args.files === 'string' ? parseJson(args.files, '--files') : {};
+  if (!values || typeof values !== 'object' || Array.isArray(values) || !files || typeof files !== 'object' || Array.isArray(files)) {
+    throw new Error(usage(usageLine));
+  }
+
+  const cfg = loadConfig();
+  const workspace = args.workspace || cfg.workspace;
+  const client = new RootrClient({ ...cfg, workspace, apiKey: keyForWorkspace(cfg, workspace) });
+  const id = await resolveDatabaseId(client, target);
+  const form = await client.getForm(id);
+  const byKey = new Map();
+  for (const f of form.fields ?? []) {
+    byKey.set(f.id, f);
+    if (!byKey.has(f.name)) byKey.set(f.name, f); // 질문 이름으로 적어도 된다
+  }
+
+  for (const [key, list] of Object.entries(files)) {
+    const field = byKey.get(key);
+    if (!field || field.type !== 'file') {
+      throw new Error(tr(`"${key}" 은 이 폼의 파일 질문이 아닙니다.`, `"${key}" is not a file question on this form.`));
+    }
+    const paths = Array.isArray(list) ? list : [list];
+    if (paths.length > 1 && !field.multiple) {
+      throw new Error(
+        tr(
+          `"${field.name}" 은 파일을 한 개만 받습니다. 여러 개를 받으려면: rootr form set <폼> --fields 로 그 질문에 "multiple": true`,
+          `"${field.name}" takes a single file. To take several, set "multiple": true on it with rootr form set <form> --fields`,
+        ),
+      );
+    }
+    if (!workspace) {
+      throw new RootrApiError(tr('워크스페이스가 설정되지 않았습니다.', `No workspace is configured.`), {
+        hint: tr('--workspace <id> 를 주세요.', `Pass --workspace <id>.`),
+      });
+    }
+    const uploaded = [];
+    for (const filePath of paths) {
+      const filename = basename(String(filePath));
+      const mimeType = MIME_BY_EXT[extname(filename).toLowerCase()] || 'application/octet-stream';
+      const att = await client.uploadAttachment(workspace, { filename, mimeType, nodeId: id, data: readFileSync(String(filePath)) });
+      uploaded.push({ id: att.id, filename });
+      console.error(tr(`올림: ${filename} (id ${att.id})`, `uploaded ${filename} (id ${att.id})`));
+    }
+    values[field.id] = field.multiple ? uploaded : uploaded[0];
+  }
+
+  const result = await client.createFormResponse(id, values);
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(tr(`응답 접수됨: ${result.id ?? ''}`, `Response submitted: ${result.id ?? ''}`));
+  console.log(`  ${JSON.stringify(result.values ?? values)}`);
+}
+
 async function cmdFormResponseEdit(args) {
   const responseId = args._[1];
   if (!responseId) throw new Error(usage(tr("rootr form response-edit <응답id> --values '<json>'", "rootr form response-edit <responseId> --values '<json>'")));
@@ -1805,12 +1961,53 @@ async function cmdDbCarryOver(args) {
   if (args.json) return console.log(JSON.stringify(res, null, 2));
   console.log(
     tr(
-      `이전 행(${res.fromTitle || res.fromRowId})에서 가져왔습니다 — 옮긴 칸: ${res.copied.join(', ') || '없음'}${res.marked.length ? ` · 표시: ${res.marked.join(', ')}` : ''}`,
-      `Carried from ${res.fromTitle || res.fromRowId} — copied: ${res.copied.join(', ') || 'none'}${res.marked.length ? ` · marked: ${res.marked.join(', ')}` : ''}`,
+      res.nothingChanged && !res.marked.length
+        ? `같은 값의 이전 행 ${res.fromRowIds?.length ?? 1}개를 찾았지만 채울 칸이 없었습니다(바뀐 칸 없음).`
+        : `이전 행 ${res.fromRowIds?.length ?? 1}개(${res.fromTitle || res.fromRowId} 등)에서 가져왔습니다 — 바뀐 칸 ${res.copied.length}개: ${res.copied.join(', ') || '없음'}${res.marked.length ? ` · 표시: ${res.marked.join(', ')}` : ''}${res.opId ? ` · 되돌리기: rootr db dedupe-undo <표> ${res.opId}` : ''}`,
+      res.nothingChanged && !res.marked.length
+        ? `Found ${res.fromRowIds?.length ?? 1} earlier row(s) but nothing to fill (no column changed).`
+        : `Carried from ${res.fromRowIds?.length ?? 1} earlier row(s) — ${res.copied.length} column(s): ${res.copied.join(', ') || 'none'}${res.marked.length ? ` · marked: ${res.marked.join(', ')}` : ''}${res.opId ? ` · undo: rootr db dedupe-undo <table> ${res.opId}` : ''}`,
     ),
   );
 }
 
+/** DEDUPE-RULES — `rootr db dedupe-preview|dedupe <표> <rowId> [--action …] [--json '<규칙 덮기>']` */
+async function cmdDbDedupe(args, dryRun) {
+  const [, target, rowId] = args._;
+  if (!target || !rowId) throw new Error(usage(`rootr db ${dryRun ? 'dedupe-preview' : 'dedupe'} <path|id> <rowId> [--action carry|merge_into_old|merge_all] [--json '<rules>']`));
+  let rules;
+  if (typeof args.json === 'string') {
+    try {
+      rules = JSON.parse(args.json);
+    } catch {
+      throw new Error(tr('--json 이 JSON 이 아닙니다.', '--json is not valid JSON.'));
+    }
+  }
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.dedupe(id, rowId, { action: typeof args.action === 'string' ? args.action : undefined, rules, dryRun });
+  if (args.json === true || args.raw) return console.log(JSON.stringify(res, null, 2));
+  console.log(
+    tr(
+      `${dryRun ? '미리 보기' : '적용'} — ${res.action} · 남는 행 ${res.targetRowId}${res.deleted?.length ? ` · 지움 ${res.deleted.length}행` : ''}${res.kept?.length ? ` · 이어 둠 ${res.kept.length}행` : ''}${res.opId ? ` · opId ${res.opId}` : ''}`,
+      `${dryRun ? 'Preview' : 'Applied'} — ${res.action} · keeps ${res.targetRowId}${res.deleted?.length ? ` · deletes ${res.deleted.length}` : ''}${res.kept?.length ? ` · keeps linked ${res.kept.length}` : ''}${res.opId ? ` · opId ${res.opId}` : ''}`,
+    ),
+  );
+  if (!res.columns?.length) console.log(tr('  바뀌는 칸 없음', '  no column changes'));
+  for (const c of res.columns ?? []) console.log(`  ${c.column} [${c.strategy}]: ${JSON.stringify(c.before)} → ${JSON.stringify(c.after)}`);
+}
+
+/** DEDUPE-RULES — `rootr db dedupe-undo <표> <opId>` */
+async function cmdDbDedupeUndo(args) {
+  const [, target, opId] = args._;
+  if (!target || !opId) throw new Error(usage(`rootr db dedupe-undo <path|id> <opId>`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.dedupeUndo(id, opId);
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  console.log(tr(`되돌렸습니다 — ${res.rows.map((r) => `${r.rowId}(${r.state})`).join(', ')}`, `Undone — ${res.rows.map((r) => `${r.rowId}(${r.state})`).join(', ')}`));
+}
+
 /** `rootr db column-set <표> <칸> --json '<PATCH 본문>'` — 칸 설정(validate·dedupe·dedupeCarry·이름·선택지…)을 바꾼다. */
 async function cmdDbColumnSet(args) {
   const [, target, column] = args._;
@@ -1889,6 +2086,37 @@ const DOC_SKINS = [
   'editorial', 'bento', 'glass', 'mesh', 'immersive', 'brutal', 'neumorph', 'y2k',
 ];
 
+/**
+ * PUBLIC-SEO — `--description "<글>"`(검색 설명문, 빈 글이면 지움)·`--cover <그림 파일|첨부 id|none>`(링크 미리보기 대표 이미지).
+ * 그림 파일을 주면 그 워크스페이스에 올려 id 로 바꾼다. 안 주면 빈 객체 — 아무것도 안 바뀐다.
+ */
+async function seoPatchFromArgs(client, args, nodeId) {
+  const patch = {};
+  if (args.description !== undefined) patch.seoDescription = typeof args.description === 'string' ? args.description : null;
+  if (args.cover !== undefined) {
+    const cover = typeof args.cover === 'string' ? args.cover.trim() : '';
+    if (!cover || cover === 'none') patch.seoImage = null;
+    else if (/^[0-9a-f-]{36}$/i.test(cover)) patch.seoImage = cover;
+    else {
+      if (!existsSync(cover)) throw new Error(tr(`--cover 파일을 찾을 수 없습니다: ${cover}`, `--cover file not found: ${cover}`));
+      const mimeType = MIME_BY_EXT[extname(cover).toLowerCase()] || 'application/octet-stream';
+      if (!mimeType.startsWith('image/')) throw new Error(tr('--cover 는 그림 파일(png·jpg·gif·webp)이어야 합니다.', '--cover must be an image file (png, jpg, gif, webp).'));
+      const cfg = loadConfig();
+      const workspace = args.workspace || cfg.workspace;
+      if (!workspace) throw new Error(tr('--cover 파일을 올릴 워크스페이스가 없습니다 — --workspace <id> 를 주세요.', 'No workspace to upload the --cover file to — pass --workspace <id>.'));
+      const { id } = await client.uploadAttachment(workspace, { filename: basename(cover), mimeType, nodeId, data: readFileSync(cover) });
+      patch.seoImage = id;
+    }
+  }
+  return patch;
+}
+
+function printSeo(seo) {
+  if (!seo || (!seo.description && !seo.imageAttachmentId)) return;
+  if (seo.description) console.log(tr(`  검색 설명문: ${seo.description}`, `  search description: ${seo.description}`));
+  if (seo.imageAttachmentId) console.log(tr(`  대표 이미지: ${seo.imageAttachmentId}`, `  cover image: ${seo.imageAttachmentId}`));
+}
+
 /** `--comments` 단독이면 true, `--comments false`면 false, 안 주면 undefined. */
 function flagToBool(v) {
   if (v === undefined) return undefined;
@@ -1900,7 +2128,7 @@ async function cmdPublish(args) {
   if (!target) {
     throw new Error(
       usage(tr(`rootr publish <path|id> [--children] [--view <id>] [--layout <배치>] [--skin <분위기>] `, `rootr publish <path|id> [--children] [--view <id>] [--layout <layout>] [--skin <skin>] `)) +
-        '[--comments] [--expires <ISO>] | --off | --status',
+        '[--comments] [--expires <ISO>] [--description <text>] [--cover <image|id|none>] | --off | --status',
     );
   }
   const client = makeClient();
@@ -1950,6 +2178,7 @@ async function cmdPublish(args) {
     if (isDocument) {
       console.log(tr(`  댓글(편집 제안) 허용: ${st.allowCommits ? '예' : '아니오'}`, `  comments (edit suggestions) allowed: ${st.allowCommits ? 'yes' : 'no'}`));
       if (st.publicConfig?.skin) console.log(tr(`  스킨: ${st.publicConfig.skin}`, `  skin: ${st.publicConfig.skin}`));
+      printSeo(st.publicConfig?.seo);
     } else {
       if (st.hasPassword) console.log(tr('  비밀번호 걸려 있음', `  password protected`));
       console.log(tr(`  하위 문서도 공개: ${st.includeChildren ? '예' : '아니오'}`, `  children published too: ${st.includeChildren ? 'yes' : 'no'}`));
@@ -1957,6 +2186,7 @@ async function cmdPublish(args) {
       if (st.design && (st.design.layout || st.design.skin)) {
         console.log(tr(`  보이는 방식: ${st.design.layout ?? 'table'} / ${st.design.skin ?? 'clean'}`, `  looks like: ${st.design.layout ?? 'table'} / ${st.design.skin ?? 'clean'}`));
       }
+      printSeo(st.seo);
     }
     return;
   }
@@ -1982,8 +2212,10 @@ async function cmdPublish(args) {
     if (comments !== undefined) patch.allowCommits = comments;
     if (typeof args.expires === 'string') patch.expiresAt = args.expires;
     if (typeof args.skin === 'string') patch.skin = args.skin;
+    Object.assign(patch, await seoPatchFromArgs(client, args, id));
     if (Object.keys(patch).length) {
-      await client.setDocumentPublic(id, patch);
+      const after = await client.setDocumentPublic(id, patch);
+      if (patch.seoDescription !== undefined || patch.seoImage !== undefined) printSeo(after?.publicConfig?.seo);
       if (patch.allowCommits !== undefined) {
         console.log(tr(`  댓글(편집 제안) 허용: ${patch.allowCommits ? '예' : '아니오'}`, `  comments (edit suggestions) allowed: ${patch.allowCommits ? 'yes' : 'no'}`));
       }
@@ -2023,6 +2255,8 @@ async function cmdPublish(args) {
   if (Object.keys(design).length) {
     console.log(tr(`  보이는 방식: ${res.design?.layout ?? 'table'} / ${res.design?.skin ?? 'clean'}`, `  looks like: ${res.design?.layout ?? 'table'} / ${res.design?.skin ?? 'clean'}`));
   }
+  const seo = await seoPatchFromArgs(client, args, id);
+  if (Object.keys(seo).length) printSeo((await client.setNodePublic(id, seo))?.seo);
 }
 
 /**
@@ -2527,6 +2761,9 @@ async function cmdDb(args) {
   if (sub === 'keep-duplicate') return cmdDbKeepDuplicate(args);
   if (sub === 'rename-col') return cmdDbRenameCol(args);
   if (sub === 'carry-over') return cmdDbCarryOver(args);
+  if (sub === 'dedupe-preview') return cmdDbDedupe(args, true);
+  if (sub === 'dedupe') return cmdDbDedupe(args, false);
+  if (sub === 'dedupe-undo') return cmdDbDedupeUndo(args);
   if (sub === 'column-set') return cmdDbColumnSet(args);
   if (sub === 'rule-violations') return cmdDbRuleViolations(args);
   if (sub === 'rule-test') return cmdDbRuleTest(args);
@@ -3558,6 +3795,175 @@ async function cmdMailWebhook(client, args) {
   }
 }
 
+// ---- custom domains (CUSTOM-DOMAIN — 발행한 페이지를 내 도메인으로) ----------------
+
+const DOMAIN_USAGE = () =>
+  usage(
+    tr(
+      `rootr domain list | detect <도메인> [--provider <업체>] | add <도메인|이름.rootr.site> <페이지 path|id> [--provider <업체>] [--confirm-charge] | add --subdomain <이름> <페이지> | available <이름> | check <id> | rename <id> <새 도메인> | remove <id>`,
+      `rootr domain list | detect <domain> [--provider <id>] | add <domain|name.rootr.site> <page path|id> [--provider <id>] [--confirm-charge] | add --subdomain <name> <page> | available <name> | check <id> | rename <id> <new domain> | remove <id>`,
+    ),
+  );
+
+const DOMAIN_STATUS = {
+  PENDING_DNS: tr('DNS 확인 중', 'waiting for DNS'),
+  PENDING_CERT: tr('인증서 발급 중', 'issuing certificate'),
+  ACTIVE: tr('연결됨', 'connected'),
+  ERROR: tr('오류', 'error'),
+  SUSPENDED: tr('일시 중지(결제 필요)', 'paused (payment needed)'),
+  REMOVED: tr('해제됨', 'removed'),
+};
+const DOMAIN_KIND = { PAID: tr('내 도메인', 'own'), FREE: tr('무료 주소', 'free') };
+
+function domainWorkspace() {
+  const ws = loadConfig().workspace;
+  if (!ws) throw new Error(tr('워크스페이스가 설정되지 않았습니다. rootr use <워크스페이스> 또는 ROOTR_WORKSPACE', 'No workspace set. rootr use <workspace> or ROOTR_WORKSPACE'));
+  return ws;
+}
+
+function printDomainRecords(records) {
+  console.log(tr('DNS 에 이 한 줄을 넣으세요:', 'Add this one DNS line:'));
+  for (const r of records ?? []) {
+    console.log(`  ${tr('타입', 'type')} ${r.type}   ${tr('이름(호스트)', 'name (host)')} ${r.name}   ${tr('값', 'value')} ${r.value ?? tr('(서버에 연결 주소가 아직 없음)', '(not configured on the server yet)')}   TTL ${tr('기본값', 'default')}`);
+  }
+}
+
+function printDomainGuide(provider) {
+  if (!provider) return;
+  const l = lang() === 'ko' ? 'ko' : 'en';
+  console.log(`\n${provider.name?.[l] ?? provider.id}${provider.dnsUrl ? ` — ${provider.dnsUrl}` : ''}`);
+  (provider.steps?.[l] ?? []).forEach((s, i) => console.log(`  ${i + 1}. ${s}`));
+  if (provider.quirks?.[l]?.length) {
+    console.log(tr('  주의:', '  Watch out:'));
+    for (const q of provider.quirks[l]) console.log(`   - ${q}`);
+  }
+}
+
+function printDomainStatus(d) {
+  const st = DOMAIN_STATUS[d.status] ?? d.status;
+  console.log(`${d.hostname}\t${st}${d.status === 'ACTIVE' ? `\t${d.siteUrl}` : ''}`);
+  if (d.message || d.lastError) console.log(`  ${d.message || d.lastError}`);
+}
+
+async function cmdDomain(args) {
+  const sub = args._[0];
+  const client = makeClient();
+  switch (sub) {
+    case undefined:
+    case 'list':
+    case 'ls': {
+      const out = await client.listCustomDomains(domainWorkspace());
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      if (out.slots) console.log(slotLine(out.slots, tr));
+      if (!out.domains?.length) return console.log(tr('연결된 도메인이 없습니다. rootr domain add <도메인> <페이지>  (무료: rootr domain add --subdomain <이름> <페이지>)', 'No custom domains. rootr domain add <domain> <page>  (free: rootr domain add --subdomain <name> <page>)'));
+      for (const d of out.domains) {
+        console.log(`${d.id}\t${d.hostname}\t${DOMAIN_KIND[d.kind] ?? DOMAIN_KIND.PAID}\t${DOMAIN_STATUS[d.status] ?? d.status}\t${d.rootNode ? d.rootNode.name : tr('(페이지 없음)', '(page missing)')}`);
+        if (d.status !== 'ACTIVE' && d.lastError) console.log(`    ${d.lastError}`);
+      }
+      return;
+    }
+    case 'available': {
+      const name = args._[1];
+      if (!name) throw new Error(DOMAIN_USAGE());
+      const out = await client.customSubdomainAvailability(domainWorkspace(), name);
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      const why = {
+        invalid: tr('영어 소문자·숫자·하이픈 3~30자, 앞뒤 하이픈 없이', 'lowercase a-z 0-9 and hyphen, 3–30 chars, no leading/trailing hyphen'),
+        reserved: tr('예약된 이름', 'reserved name'),
+        taken: tr('이미 다른 곳에서 씀', 'already taken'),
+        mine: tr('이미 이 워크스페이스 것', 'already yours'),
+        limit: tr(`워크스페이스당 ${out.limit}개까지`, `limit of ${out.limit} per workspace reached`),
+      };
+      console.log(out.available ? tr(`${out.hostname} — 쓸 수 있습니다`, `${out.hostname} — available`) : `${out.hostname} — ${tr('안 됩니다', 'not available')}: ${why[out.reason] ?? out.reason}`);
+      if (!out.available) process.exitCode = 2;
+      return;
+    }
+    case 'detect': {
+      const host = args._[1];
+      if (!host) throw new Error(DOMAIN_USAGE());
+      const out = await client.detectCustomDomain(domainWorkspace(), host, typeof args.provider === 'string' ? args.provider : undefined);
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      if (out.isApex) console.log(tr(`${out.hostname} 은(는) 루트 도메인이라 CNAME 을 못 거는 곳이 많습니다 — ${out.suggestedHostname} 로 연결하고 루트는 포워딩하세요.`, `${out.hostname} is a root domain; most providers cannot put a CNAME there — connect ${out.suggestedHostname} and forward the root.`));
+      console.log(out.detectedProvider ? tr(`DNS 관리: ${out.provider.name.ko} (이름서버 ${out.nameservers.join(', ')})`, `DNS managed at: ${out.provider.name.en} (name servers ${out.nameservers.join(', ')})`) : tr('DNS 관리 업체를 알아내지 못했습니다 — 일반 안내를 보여 드립니다.', 'Could not tell where the DNS is managed — showing the generic guide.'));
+      printDomainRecords([out.record]);
+      printDomainGuide(out.provider);
+      return;
+    }
+    case 'add': {
+      // 무료 주소는 `--subdomain <이름> <페이지>` 로도 받는다(그때는 페이지가 첫 칸).
+      const subdomain = typeof args.subdomain === 'string' ? args.subdomain : undefined;
+      const host = subdomain ? undefined : args._[1];
+      const page = subdomain ? args._[1] : args._[2];
+      if ((!host && !subdomain) || !page) throw new Error(DOMAIN_USAGE());
+      const rootNodeId = requireResolved(await resolveTarget(client, page));
+      let out;
+      try {
+        out = await client.addCustomDomain(domainWorkspace(), {
+          hostname: host,
+          subdomain,
+          rootNodeId,
+          provider: typeof args.provider === 'string' ? args.provider : undefined,
+          confirmCharge: args['confirm-charge'] === true || args.yes === true,
+        });
+      } catch (err) {
+        const help = err instanceof RootrApiError ? domainPaymentHelp(err, tr) : null;
+        if (help) err.hint = help;
+        throw err;
+      }
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      if (out.kind === 'FREE') {
+        console.log(tr(`무료 주소가 바로 열렸습니다: https://${out.hostname} (id ${out.id}) — DNS 설정이 필요 없습니다.`, `The free address is live: https://${out.hostname} (id ${out.id}) — no DNS setup needed.`));
+        return;
+      }
+      if (out.billing?.charged) console.log(tr(`도메인 연결 애드온을 ${out.billing.quantity}개로 늘렸습니다(일할 계산 청구).`, `Custom-domain add-on increased to ${out.billing.quantity} (prorated charge).`));
+      console.log(tr(`등록했습니다: ${out.hostname} (id ${out.id})`, `Registered ${out.hostname} (id ${out.id})`));
+      printDomainRecords(out.records);
+      printDomainGuide(out.guide?.provider);
+      console.log(tr(`\n넣은 뒤: rootr domain check ${out.id}  (5분마다 저절로도 확인하고, 연결되면 알림이 갑니다)`, `\nThen: rootr domain check ${out.id}  (also re-checked every 5 minutes; you get a notification when it is live)`));
+      return;
+    }
+    case 'check': {
+      const id = args._[1];
+      if (!id) throw new Error(DOMAIN_USAGE());
+      const out = await client.checkCustomDomain(domainWorkspace(), id);
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      printDomainStatus(out);
+      if (out.status !== 'ACTIVE') process.exitCode = 2;
+      return;
+    }
+    case 'rename':
+    case 'mv': {
+      const id = args._[1];
+      const host = args._[2];
+      if (!id || !host) throw new Error(DOMAIN_USAGE());
+      const out = await client.renameCustomDomain(domainWorkspace(), id, { hostname: host, provider: typeof args.provider === 'string' ? args.provider : undefined });
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      console.log(tr(`이름을 바꿨습니다: ${out.renamedFrom?.hostname ?? id} → ${out.hostname} (새 id ${out.id}, 결제 그대로)`, `Renamed ${out.renamedFrom?.hostname ?? id} → ${out.hostname} (new id ${out.id}, billing unchanged)`));
+      printDomainRecords(out.records);
+      printDomainGuide(out.guide?.provider);
+      console.log(tr(`\n넣은 뒤: rootr domain check ${out.id}`, `\nThen: rootr domain check ${out.id}`));
+      return;
+    }
+    case 'remove':
+    case 'rm':
+    case 'delete': {
+      const id = args._[1];
+      if (!id) throw new Error(DOMAIN_USAGE());
+      const out = await client.removeCustomDomain(domainWorkspace(), id);
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      if (out.kind === 'FREE') console.log(tr(`${out.hostname} 무료 주소를 해제했습니다.`, `Released the free address ${out.hostname}.`));
+      else console.log(tr(`${out.hostname} 연결을 해제했습니다. DNS 의 CNAME 줄도 지워 주세요.`, `Disconnected ${out.hostname}. Remove the CNAME line at your DNS provider too.`));
+      const b = out.billing;
+      if (b?.action === 'decreased') console.log(tr(`도메인 연결 애드온을 ${b.quantity}개로 줄였습니다(남은 기간은 일할 계산으로 돌려받습니다).`, `Custom-domain add-on reduced to ${b.quantity} (prorated credit).`));
+      if (b?.action === 'cancel_scheduled') console.log(tr(`마지막 도메인이라 도메인 연결 애드온이 ${String(b.cancelAt).slice(0, 10)} 에 끝나도록 예약했습니다(그때까지 자리는 남습니다).`, `That was the last one — the custom-domain add-on ends on ${String(b.cancelAt).slice(0, 10)} (the slot stays until then).`));
+      if (b?.action === 'failed') console.log(tr('결제 수량 조정이 실패했습니다 — 설정 › 결제에서 확인해 주세요.', 'Could not adjust the add-on quantity — check Settings → Billing.'));
+      return;
+    }
+    default:
+      throw new Error(DOMAIN_USAGE());
+  }
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   const args = parseArgs(argv);
@@ -3577,6 +3983,10 @@ async function main() {
       return cmdLs(args);
     case 'comments':
       return cmdComments(args);
+    case 'members':
+      return cmdMembers(args);
+    case 'message':
+      return cmdMessage(args);
     case 'read':
       return cmdRead(args);
     case 'write':
@@ -3627,6 +4037,9 @@ async function main() {
       return cmdSend(args);
     case 'mail':
       return cmdMail(args);
+    case 'domain':
+    case 'domains':
+      return cmdDomain(args);
     case 'feedback':
       return cmdFeedback(args);
     case 'scaffold':