rootr-cli 0.25.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]                       문서/폴더를 휴지통으로 이동 (복구 가능)
@@ -40,7 +43,8 @@ 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 새이름] [--cards "칸,칸"]  뷰 목록·달력 주/달/해 단위·보드 카드에 보일 칸
+  rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--cards "칸,칸"]  뷰 목록·달력 주/달/해 단위·보드 카드에 보일 칸 ·[--density compact|normal] [--freeze 0~3] 촘촘하게·왼쪽 칸 고정
+  rootr db column <path|id> <칸> [--align left|center|right] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off]  칸 정렬·줄바꿈·지난 날짜 빨강·시간·기간
   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 <파일>   여러 행 한 번에 넣기 (하나라도 틀리면 전부 취소)
@@ -50,6 +54,14 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   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 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: 예시 꼴 목록
   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]     이 행만 원하는 타입으로 상세 붙이기(녹음·스프레드시트·서명문서…)
@@ -61,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  방문자에게 더 묻기 · 승인 후 확정
@@ -80,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>]  서명문서 만들기(본문·결재라인까지)
@@ -106,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 <주소>]
@@ -119,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                                  버전 출력
 
@@ -140,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)
@@ -157,7 +181,8 @@ usage:
   rootr db button-run <path|id> <buttonId> [--rows id,id]     press a button once (create rows, fill values, AI fill)
   rootr db automations <path|id> [--file rules.json] [--clear] automatic rules — "when a value becomes X, do Y", or at a set time
   rootr db import-sheets <file.xlsx> --ws <id> [--dry]        fold a one-sheet-per-record workbook into ONE table
-  rootr db view <path|id> [view name] [--scale week|month|year] [--name <new name>]  list views; calendar week/month/year
+  rootr db view <path|id> [view name] [--scale week|month|year] [--name <new name>]  list views; calendar week/month/year [--density compact|normal] [--freeze 0-3]  compact rows · frozen left columns
+  rootr db column <path|id> <column> [--align left|center|right] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off]  column alignment · wrapping · overdue red · time · end date
   rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  add a row (with its body)
   rootr db row-body <path|id> <rowId> [--file <f>] write a row's body — reads stdin if no file
   rootr db rows-new <path|id> --json '[{…},…]' | --file <file>   insert many rows at once (one bad row cancels all)
@@ -165,8 +190,18 @@ usage:
   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 pick <path|id> [name] [--limit N] [--json]        find rows to link — whole table, newest first, with the identify line (phone last 4 · date)
+  rootr db identify <path|id> <col[:last4],col…> | --clear  columns shown next to a row's title when another table picks it (same-name people)
   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 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
   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…)
@@ -178,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
@@ -196,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)
@@ -219,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>]
@@ -232,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
 
@@ -359,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]`));
@@ -1010,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)`)),
   );
 }
 
@@ -1074,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`));
   }
 }
@@ -1098,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}`);
@@ -1249,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>'")));
@@ -1646,6 +1816,44 @@ async function cmdDbDuplicates(args) {
   }
 }
 
+/** REL-PICK — `rootr db pick <표> [이름]` : 관계 칸에 이을 행 찾기(표 전체, 같은 이름은 최근 행 먼저, 구분 글자). */
+async function cmdDbPick(args) {
+  const [, target, ...words] = args._;
+  if (!target) throw new Error(usage(`rootr db pick <path|id> [name] [--limit N] [--json]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.pickRows(id, { q: words.join(' '), limit: args.limit ? Number(args.limit) : undefined });
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  if (!res.rows.length) return console.log(tr('맞는 행이 없습니다.', 'No matching rows.'));
+  for (const r of res.rows) console.log(`- ${r.title || '(제목 없음)'}${r.subtitle ? `  (${r.subtitle})` : ''}\t${r.id}`);
+  if (res.hasMore) console.log(tr(`… ${res.total}개 중 ${res.rows.length}개 — 이름을 더 적거나 전화 끝자리로 좁히세요.`, `… ${res.rows.length} of ${res.total} — narrow it down.`));
+}
+
+/** REL-PICK-IDENTIFY — `rootr db identify <표> 연락처:last4,지원일` : 제목 칸의 identifyProps 를 건다(--clear 로 끈다). */
+async function cmdDbIdentify(args) {
+  const [, target, spec] = args._;
+  if (!target || (!spec && !args.clear)) throw new Error(usage(`rootr db identify <path|id> <col[:last4],col…> | --clear`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const db = await client.getDatabase(id);
+  const title = (db.properties || []).find((p) => p.type === 'title');
+  if (!title) throw new Error(tr('이 표에 제목 칸이 없습니다.', 'This table has no title column.'));
+  const identifyProps = args.clear
+    ? null
+    : String(spec)
+        .split(',')
+        .map((x) => x.trim())
+        .filter(Boolean)
+        .map((x) => {
+          const [propId, mask] = x.split(':');
+          return mask ? { propId: propId.trim(), mask: mask.trim() } : { propId: propId.trim() };
+        });
+  const res = await client.updateColumn(id, title.id, { identifyProps });
+  const names = new Map((db.properties || []).map((p) => [p.id, p.name]));
+  const shown = (res.identifyProps || []).map((it) => `${names.get(it.propId) ?? it.propId}${it.mask ? `(${it.mask})` : ''}`);
+  console.log(shown.length ? tr(`구분 칸: ${shown.join(' · ')}`, `Identify columns: ${shown.join(' · ')}`) : tr('구분 칸을 껐습니다.', 'Identify columns cleared.'));
+}
+
 /** DEDUPE — `rootr db merge <표> <rowId> --into <기존 rowId>` */
 async function cmdDbMerge(args) {
   const [, target, rowId] = args._;
@@ -1661,6 +1869,43 @@ async function cmdDbMerge(args) {
   );
 }
 
+/**
+ * COL-RENAME — `rootr db rename-col <표> <칸 이름|id> <새 이름> [--dry] [--json]`
+ * 칸 이름을 바꾸면 그 칸을 이름으로 가리키던 수식·버튼/자동 규칙 치환·다른 표 롤업·이어진 폼 질문·페이지 블록이 함께 바뀐다.
+ * --dry 는 무엇이 바뀌는지만 보여 준다(쓰지 않는다).
+ */
+async function cmdDbRenameCol(args) {
+  const [, target, col, ...rest] = args._;
+  const to = rest.join(' ').trim();
+  if (!target || !col || !to) throw new Error(usage(`rootr db rename-col <path|id> <column name|id> <new name> [--dry] [--json]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const db = await client.getDatabase(id);
+  const prop =
+    (db.properties ?? []).find((p) => p.id === col) ??
+    (db.properties ?? []).find((p) => p.name.trim().toLowerCase() === String(col).trim().toLowerCase());
+  if (!prop) throw new Error(tr(`"${col}" 칸이 이 표에 없습니다.`, `No column "${col}" in this table.`));
+  const cascade = args.dry
+    ? await client.columnRenameImpact(id, prop.id, to)
+    : (await client.updateColumn(id, prop.id, { name: to })).renameCascade ?? null;
+  if (args.json) return console.log(JSON.stringify({ propertyId: prop.id, from: prop.name, to, dryRun: !!args.dry, renameCascade: cascade }, null, 2));
+  console.log(
+    args.dry
+      ? tr(`미리보기: 「${prop.name}」 → 「${to}」`, `Preview: "${prop.name}" → "${to}"`)
+      : tr(`바꿨습니다: 「${prop.name}」 → 「${to}」`, `Renamed "${prop.name}" → "${to}"`),
+  );
+  if (!cascade || !cascade.summary) console.log(tr('이 칸을 이름으로 가리키는 곳이 없습니다.', 'Nothing else refers to this column by name.'));
+  else console.log(cascade.summary);
+  for (const f of cascade?.formulas ?? []) console.log(`  ${tr('수식', 'formula')} ${f.column}: ${f.before}  →  ${f.after}`);
+  for (const b of cascade?.buttons ?? []) console.log(`  ${tr('버튼', 'button')} ${b.table} / ${b.label}`);
+  for (const a of cascade?.automations ?? []) console.log(`  ${tr('자동 규칙', 'automation')} ${a.table} / ${a.label}`);
+  for (const r of cascade?.rollups ?? []) console.log(`  ${tr('롤업', 'rollup')} ${r.table} / ${r.column}`);
+  for (const f of cascade?.forms ?? []) for (const q of f.pinned) console.log(`  ${tr('폼', 'form')} ${f.form} / ${q.field} → ${q.column}`);
+  for (const p of cascade?.pages ?? []) console.log(`  ${tr('페이지', 'page')} ${p.page} (${p.blocks})`);
+  for (const w of cascade?.warnings ?? []) console.log(`⚠ ${w}`);
+  if (args.dry) console.log(tr('미리보기입니다. 바꾸려면 --dry 를 빼세요.', 'Preview only. Drop --dry to rename.'));
+}
+
 /** ROW-HISTORY — `rootr db history <표> [--row <rowId>] [--limit N] [--json]` */
 async function cmdDbHistory(args) {
   const target = args._[1];
@@ -1706,6 +1951,116 @@ async function cmdDbRestore(args) {
   console.log(tr('되돌렸습니다.', 'Restored.'));
 }
 
+/** DEDUPE-CARRY(P1) — `rootr db carry-over <표> <rowId> [--from <이전 rowId>]` */
+async function cmdDbCarryOver(args) {
+  const [, target, rowId] = args._;
+  if (!target || !rowId) throw new Error(usage(`rootr db carry-over <path|id> <rowId> [--from <rowId>]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.carryOver(id, rowId, typeof args.from === 'string' ? args.from : undefined);
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  console.log(
+    tr(
+      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._;
+  if (!target || !column || typeof args.json !== 'string') throw new Error(usage(`rootr db column-set <path|id> <column> --json '<settings>'`));
+  let body;
+  try {
+    body = 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 db = await client.getDatabase(id);
+  const prop = (db.properties ?? []).find((p) => p.id === column) ?? (db.properties ?? []).find((p) => p.name.trim().toLowerCase() === String(column).trim().toLowerCase());
+  if (!prop) throw new Error(tr(`"${column}" 칸이 없습니다. 칸: ${(db.properties ?? []).map((p) => p.name).join(', ')}`, `No column "${column}".`));
+  const res = await client.updateColumn(id, prop.id, body);
+  console.log(JSON.stringify(res, null, 2));
+}
+
+/** VALUE-RULE(P2) — `rootr db rule-violations <표> [--limit N] [--json]` */
+async function cmdDbRuleViolations(args) {
+  const [, target] = args._;
+  if (!target) throw new Error(usage(`rootr db rule-violations <path|id> [--limit N]`));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const res = await client.ruleViolations(id, { limit: args.limit ? Number(args.limit) : undefined });
+  if (args.json) return console.log(JSON.stringify(res, null, 2));
+  if (!res.checkedColumns.length) return console.log(tr('검사를 건 칸이 없습니다.', 'No column has a validate rule.'));
+  console.log(tr(`검사한 칸: ${res.checkedColumns.join(', ')} · 안 맞는 값 ${res.total}건`, `Checked: ${res.checkedColumns.join(', ')} · ${res.total} violations`));
+  for (const it of res.items) console.log(`  ${it.rowId}  ${it.title || '-'}  ${it.propName}: ${it.value}  — ${it.message}`);
+}
+
+/** VALUE-RULE — `rootr db rule-test --json '<규칙>' <값>…` · `rootr db rule-test --presets` */
+async function cmdDbRuleTest(args) {
+  const client = makeClient();
+  if (args.presets) {
+    const { presets } = await client.valueRulePresets();
+    if (args.json) return console.log(JSON.stringify(presets, null, 2));
+    for (const p of presets) console.log(`  ${p.id.padEnd(12)} ${tr(p.label.ko, p.label.en)}  ${p.pattern}${p.flags ? `  (flags ${p.flags})` : ''}  ${tr('예', 'e.g.')} ${p.example}`);
+    return;
+  }
+  const values = args._.slice(1);
+  if (typeof args.json !== 'string' || !values.length) throw new Error(usage(`rootr db rule-test --json '{"pattern":"\\\\d{5}"}' <값> [<값>…]`));
+  let rule;
+  try {
+    rule = JSON.parse(args.json);
+  } catch {
+    throw new Error(tr('--json 이 JSON 이 아닙니다.', '--json is not valid JSON.'));
+  }
+  const res = await client.testValueRule(rule, values, typeof args.type === 'string' ? args.type : undefined);
+  for (const r of res.results) console.log(`  ${r.ok ? '✓' : '✗'} ${r.value}${r.ok ? '' : `  — ${r.message}`}`);
+}
+
 /** DEDUPE-KEEP — `rootr db keep-duplicate <표> <rowId> --from <이전 rowId>` */
 async function cmdDbKeepDuplicate(args) {
   const [, target, rowId] = args._;
@@ -1731,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;
@@ -1742,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();
@@ -1792,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'}`));
@@ -1799,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;
   }
@@ -1824,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'}`));
       }
@@ -1865,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);
 }
 
 /**
@@ -1985,7 +2377,7 @@ async function cmdBooking(args) {
             `      [--duration 30] [--buffer 10] [--calendar-buffer 60] [--notice 2] [--ahead 60] [--per-day 4]\n` +
             `      [--block 2026-10-03,2026-10-09] [--approval instant|manual] [--tz Asia/Seoul]\n` +
             `      [--block-time "daily 12:00-13:00=점심, mon 09:00-11:00, fri"]\n` +
-            `      [--meet on|off] [--notify-visitor on|off] [--notify-email a@b.com,c@d.com] [--self-cancel on|off]\n` +
+            `      [--meet on|off] [--all-day-busy on|off] [--notify-visitor on|off] [--notify-email a@b.com,c@d.com] [--self-cancel on|off]\n` +
             `      [--self-move on|off] [--remind 1d,1h   (안 보내려면 --remind off)]\n` +
             `      [--types "30분 상담=30m,데모=60m|화면 보며 설명"] [--guests on|off] [--max-guests 5] [--track-source on|off]\n` +
             `      [--after https://example.com/thanks]\n` +
@@ -1997,7 +2389,7 @@ async function cmdBooking(args) {
             `      [--duration 30] [--buffer 10] [--calendar-buffer 60] [--notice 2] [--ahead 60] [--per-day 4]\n` +
             `      [--block 2026-10-03,2026-10-09] [--approval instant|manual] [--tz Asia/Seoul]\n` +
             `      [--block-time "daily 12:00-13:00=lunch, mon 09:00-11:00, fri"]\n` +
-            `      [--meet on|off] [--notify-visitor on|off] [--notify-email a@b.com,c@d.com] [--self-cancel on|off]\n` +
+            `      [--meet on|off] [--all-day-busy on|off] [--notify-visitor on|off] [--notify-email a@b.com,c@d.com] [--self-cancel on|off]\n` +
             `      [--self-move on|off] [--remind 1d,1h   (--remind off to stop)]\n` +
             `      [--types "Intro=30m,Demo=60m|walk through the product"] [--guests on|off] [--max-guests 5] [--track-source on|off]\n` +
             `      [--after https://example.com/thanks]\n` +
@@ -2051,6 +2443,7 @@ async function cmdBooking(args) {
         : tr('  미리 알림: 안 보냄', '  reminders: off'),
     );
     if (b.google?.meet) console.log(tr('  구글 밋: 예약마다 회의 만듦', '  Google Meet: a room per booking'));
+    if (b.google && b.google.allDayBusy === false) console.log(tr('  하루 종일 일정: 안 막음', '  All-day events: do not block'));
     const mailTo = [
       ...(b.notifyVisitor === false ? [] : [tr('방문자', 'visitor')]),
       ...(b.notifyEmails ?? []),
@@ -2117,6 +2510,9 @@ async function cmdBooking(args) {
   if (args.block !== undefined) body.blockedDates = String(args.block).split(',').map((x) => x.trim()).filter(Boolean);
   // 목록을 통째로 바꾼다 — 빈 값을 주면 다 지운다.
   if (args.meet !== undefined) body.google = { ...(body.google ?? {}), meet: args.meet !== 'off' && args.meet !== false };
+  if (args['all-day-busy'] !== undefined) {
+    body.google = { ...(body.google ?? {}), allDayBusy: args['all-day-busy'] !== 'off' && args['all-day-busy'] !== false };
+  }
   if (args['notify-visitor'] !== undefined) body.notifyVisitor = args['notify-visitor'] !== 'off' && args['notify-visitor'] !== false;
   if (args['self-cancel'] !== undefined) body.allowVisitorCancel = args['self-cancel'] !== 'off' && args['self-cancel'] !== false;
   if (args['self-move'] !== undefined) body.allowVisitorReschedule = args['self-move'] !== 'off' && args['self-move'] !== false;
@@ -2359,8 +2755,18 @@ async function cmdDb(args) {
   if (sub === 'rows-set') return cmdDbRowsSet(args);
   if (sub === 'rows-rm') return cmdDbRowsRm(args);
   if (sub === 'duplicates') return cmdDbDuplicates(args);
+  if (sub === 'pick') return cmdDbPick(args);
+  if (sub === 'identify') return cmdDbIdentify(args);
   if (sub === 'merge') return cmdDbMerge(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);
   if (sub === 'history') return cmdDbHistory(args);
   if (sub === 'restore') return cmdDbRestore(args);
   if (sub === 'row-page') return cmdDbRowPage(args);
@@ -2372,9 +2778,10 @@ async function cmdDb(args) {
   if (sub === 'automations') return cmdDbAutomations(args);
   if (sub === 'import-sheets') return cmdDbImportSheets(args);
   if (sub === 'view') return cmdDbView(args);
+  if (sub === 'column') return cmdDbColumn(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|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)`)),
+      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|column … (자세한 건 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|column … (see rootr --help)`)),
     );
   }
   const raw = typeof args.file === 'string' ? readFileSync(args.file, 'utf8') : await readStdin();
@@ -2536,8 +2943,19 @@ async function cmdDbView(args) {
     const cards = args.cards.split(',').map((c) => c.trim()).filter(Boolean);
     patch.cardProps = cards.length ? cards : null;
   }
+  // VIEW-DENSITY · FREEZE-COLS — 표 보기를 한눈에(촘촘한 줄·왼쪽 칸 고정).
+  if (args.density !== undefined) {
+    const density = String(args.density);
+    if (!['compact', 'normal'].includes(density)) throw new Error(tr('--density 는 compact · normal 중 하나여야 합니다.', `--density must be compact or normal.`));
+    patch.density = density;
+  }
+  if (args.freeze !== undefined) {
+    const n = Number(args.freeze);
+    if (!Number.isInteger(n) || n < 0 || n > 3) throw new Error(tr('--freeze 는 0~3 (왼쪽에 붙여 둘 칸 수)', `--freeze must be 0-3 (columns kept on the left)`));
+    patch.frozenColumns = n;
+  }
   if (!Object.keys(patch).length) {
-    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"`));
+    throw new Error(tr('바꿀 것을 주세요: --scale week|month|year, --name 새이름, --cards "칸,칸", --density compact|normal 또는 --freeze 0~3', `Give something to change: --scale week|month|year, --name <new name>, --cards "field,field", --density compact|normal, or --freeze 0-3`));
   }
 
   const view = await client.updateDatabaseView(id, viewRef, patch);
@@ -2551,6 +2969,66 @@ async function cmdDbView(args) {
 }
 
 
+/**
+ * `rootr db column <path|id> <칸 이름|id> [--align left|center|right|auto] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off]`
+ *
+ * 칸 하나의 표시 설정(COL-ALIGN·COL-WRAP·DATE-OVERDUE·DATE-NO-TIME/RANGE). 준 것만 바뀐다. `--align auto` 는 기본(숫자 오른쪽).
+ * 옵션 없이 부르면 지금 설정을 보여 준다. 2026-10-21 클린베테랑 P4·P8·P9·P10.
+ */
+async function cmdDbColumn(args) {
+  const target = args._[1];
+  const ref = args._[2];
+  const USAGE = tr(
+    `rootr db column <path|id> <칸> [--align left|center|right|auto] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off] [--json]`,
+    `rootr db column <path|id> <column> [--align left|center|right|auto] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off] [--json]`,
+  );
+  if (!target || !ref) throw new Error(usage(USAGE));
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const db = await client.getDatabase(id);
+  const prop = (db.properties ?? []).find((p) => p.id === ref || p.name.trim().toLowerCase() === String(ref).trim().toLowerCase());
+  if (!prop) throw new Error(tr(`"${ref}" 칸이 없습니다. 칸: ${(db.properties ?? []).map((p) => p.name).join(', ')}`, `No column "${ref}". Columns: ${(db.properties ?? []).map((p) => p.name).join(', ')}`));
+  const onOff = (key) => {
+    const v = args[key];
+    if (v === undefined) return undefined;
+    if (v === 'on' || v === true || v === 'true') return true;
+    if (v === 'off' || v === 'false') return false;
+    throw new Error(tr(`--${key} 는 on · off 중 하나여야 합니다.`, `--${key} must be on or off.`));
+  };
+  const patch = {};
+  if (args.align !== undefined) {
+    const a = String(args.align);
+    if (!['left', 'center', 'right', 'auto'].includes(a)) throw new Error(tr('--align 은 left · center · right · auto', `--align must be left, center, right or auto`));
+    patch.align = a === 'auto' ? null : a;
+  }
+  const wrap = onOff('wrap');
+  if (wrap !== undefined) patch.wrap = wrap;
+  const overdue = onOff('overdue');
+  if (overdue !== undefined) patch.highlightOverdue = overdue;
+  const time = onOff('time');
+  if (time !== undefined) patch.allowTime = time;
+  const range = onOff('range');
+  if (range !== undefined) patch.allowRange = range;
+  const show = (p) => {
+    const parts = [
+      `${tr('정렬', 'align')}=${p.align ?? tr('기본', 'auto')}`,
+      `${tr('줄바꿈', 'wrap')}=${p.wrap ? 'on' : 'off'}`,
+    ];
+    if (p.type === 'date') {
+      parts.push(`${tr('지난 날짜 빨강', 'overdue')}=${p.highlightOverdue ? 'on' : 'off'}`);
+      parts.push(`${tr('시간', 'time')}=${p.allowTime === false ? 'off' : 'on'}`);
+      parts.push(`${tr('기간', 'range')}=${p.allowRange === false ? 'off' : 'on'}`);
+    }
+    return `${p.name} (${p.type})  ${parts.join('  ')}`;
+  };
+  if (!Object.keys(patch).length) {
+    console.log(args.json ? JSON.stringify(prop, null, 2) : show(prop));
+    return;
+  }
+  const updated = await client.updateColumn(id, prop.id, patch);
+  console.log(args.json ? JSON.stringify(updated, null, 2) : tr(`칸을 고쳤습니다: ${show(updated)}`, `Column updated: ${show(updated)}`));
+}
+
 /**
  * DB-BUTTON — 표 위의 "누르면 일하는 버튼".
  *
@@ -3317,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);
@@ -3336,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':
@@ -3386,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':