rootr-cli 0.24.0 → 0.26.0

package/bin/rootr.js

@@ -6,6 +6,7 @@ import { dirname, join, basename, extname } from 'node:path';
 import { loadConfig, saveConfig, keyForWorkspace, maskKey, upsertKey, CONFIG_PATH, DEFAULT_BASE_URL } from '../lib/config.js';
 import { candidateClients, rememberWorkspace, resolveWorkspaceSwitch, surveyWorkspaces } from '../lib/credentials.js';
 import { RootrClient, RootrApiError, 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';
 
@@ -39,7 +40,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 <파일>   여러 행 한 번에 넣기 (하나라도 틀리면 전부 취소)
@@ -49,6 +51,11 @@ 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 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]     이 행만 원하는 타입으로 상세 붙이기(녹음·스프레드시트·서명문서…)
@@ -95,11 +102,16 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr sign list [--pending] [--status <S>] [--mode <M>] [--json]  서명문서 목록 (--pending: 내 차례)
   rootr sign bulk <id…> --code <6자리>              여러 건 한 번에 올리기+서명 (코드 하나로, 초안 포함)
   rootr sign ledger [--json]                       워크스페이스 원장(해시 체인) 전체 검증
-  rootr send <path|id> --to a@x.com[,b@y.com] [--message "..."]  문서(어떤 타입이든)를 이메일로 보내기 — 보낼 때의 복사본, 계정 없어도 열림
+  rootr send <path|id> --to a@x.com[,b@y.com] [--access read|comment|write] [--message "..."]
+                                                   문서(어떤 타입이든)를 이메일로 보내기 — 복사본이 아니라 원본을 그 이메일에 열어 줌(기본 보기)
   rootr mail [inbox|sent] [--limit N] [--q <찾기>] [--json]  문서함 — 받은 문서(기본)·보낸 문서
-  rootr mail show <id> [--json]                    받은/보낸 문서 열기(문서면 본문, 그 밖은 요약) — 받은 것은 읽음 처리
-  rootr mail revoke <id>                           보낸 문서 회수 — 받는 쪽에서 본문이 안 보임
-  rootr mail hide <id> [--box inbox|sent]          내 문서함에서만 지우기(상대 화면은 그대로)
+  rootr mail show <id> [--node <아래 노드 id>] [--json]  받은/보낸 문서의 지금 내용(문서면 본문, 그 밖은 요약) — 받은 것은 읽음 처리
+  rootr mail access <id> read|comment|write        보낸 문서의 받는 사람 권한 바꾸기
+  rootr mail revoke <id>                           보낸 문서 회수 — 받는 사람이 원본을 더 못 연다
+  rootr mail hide <id> [--box inbox|sent]          내 문서함에서만 지우기(받은 것을 지우면 그 계정으로는 더 안 열린다)
+  rootr mail webhook add <url> [--events …] | list | rm <id> | test <id>
+                                                   받은 문서·회수·읽음을 내 주소로 알려 주는 웹훅(내 계정 것, HMAC 서명)
+                                                   ※ 다른 명령 뒤 새로 받은 문서가 있으면 stderr 로 한 줄 알림(끄기: ROOTR_MAIL_NOTICE=0)
   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 <주소>]
@@ -151,7 +163,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)
@@ -159,8 +172,15 @@ 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 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…)
@@ -206,11 +226,13 @@ usage:
   rootr sign list [--pending] [--status <S>] [--mode <M>] [--json]  list signed documents (--pending: waiting on you)
   rootr sign bulk <id…> --code <6 digits>           submit+sign many at once (one code, drafts included)
   rootr sign ledger [--json]                       verify the whole workspace ledger (hash chain)
-  rootr send <path|id> --to a@x.com[,b@y.com] [--message "..."]  email any node as a frozen copy — opens without an account
+  rootr send <path|id> --to a@x.com[,b@y.com] [--access read|comment|write] [--message "..."]
+                                                   give email addresses access to any node — the original itself, not a copy (default: read)
   rootr mail [inbox|sent] [--limit N] [--q <text>] [--json]  your document mailbox — received (default) or sent
-  rootr mail show <id> [--json]                    open a received/sent document (body for docs, a summary otherwise); marks received ones read
-  rootr mail revoke <id>                           withdraw a document you sent — the recipient no longer sees the content
-  rootr mail hide <id> [--box inbox|sent]          remove from your own mailbox only (the other side keeps it)
+  rootr mail show <id> [--node <child id>] [--json]  the document's current content (body for docs, a summary otherwise); marks received ones read
+  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 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>]
@@ -1638,6 +1660,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._;
@@ -1653,6 +1713,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];
@@ -1698,6 +1795,75 @@ 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.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(', ')}` : ''}`,
+    ),
+  );
+}
+
+/** `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._;
@@ -1749,6 +1915,18 @@ async function cmdPublish(args) {
       console.log(tr('이 종류는 공개할 수 없습니다(폴더).', `This node type cannot be published (folder).`));
       return;
     }
+    if (st.closed === 'PAGE_PUBLISH_REQUIRES_TEAM') {
+      // PAGE-PUBLISH-TEAM — 공개는 켜져 있지만 워크스페이스가 무료라 방문자에게 안 보인다. Team 으로 올리면 같은 주소가 다시 열린다.
+      console.log(tr(`공개가 켜져 있지만 지금은 방문자에게 보이지 않습니다(주소: /p/${st.slug}).`, `Publishing is on, but visitors cannot see it right now (address: /p/${st.slug}).`));
+      console.log(
+        '  ' +
+          tr(
+            '페이지를 웹에 게시하는 기능은 Team 플랜에서만 됩니다. Team 으로 올리면 다시 발행하지 않아도 같은 주소로 열립니다.',
+            'Publishing pages to the web needs the Team plan. Upgrade to Team and the same address opens again — no need to publish again.',
+          ),
+      );
+      return;
+    }
     if (st.closed) {
       // 공개를 끈 것과 다르다 — 설정은 켜져 있고, "본인이 만든 행만" 표의 행에서 나온 것이라 지금 닫혀 있다(서버 응답의 closed)
       console.log(tr(`공개가 켜져 있지만 지금은 닫혀 있습니다(주소: /p/${st.slug}).`, `Publishing is on, but it is closed right now (address: /p/${st.slug}).`));
@@ -1833,6 +2011,15 @@ async function cmdPublish(args) {
   });
   console.log(tr(`공개했습니다: /p/${res.slug}`, `Published: /p/${res.slug}`));
   if (args.children) console.log(tr('  이 문서 아래 전부(손자·증손자 포함)도 각자 주소로 공개됩니다.', `  Everything under this document (grandchildren included) gets its own public address.`));
+  if (res.skippedPagesRequireTeam) {
+    // PAGE-PUBLISH-TEAM — 무료 워크스페이스에서는 아래의 페이지(PAGE)는 따라 나가지 않는다.
+    console.log(
+      tr(
+        `  단, 아래의 페이지 ${res.skippedPagesRequireTeam}개는 공개하지 않았습니다 — 페이지를 웹에 게시하는 기능은 Team 플랜부터입니다.`,
+        `  ${res.skippedPagesRequireTeam} page(s) underneath were NOT published — publishing pages to the web needs the Team plan.`,
+      ),
+    );
+  }
   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'}`));
   }
@@ -1956,7 +2143,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` +
@@ -1968,7 +2155,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` +
@@ -2022,6 +2209,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 ?? []),
@@ -2088,6 +2276,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;
@@ -2330,8 +2521,15 @@ 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 === '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);
@@ -2343,9 +2541,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();
@@ -2507,8 +2706,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);
@@ -2522,6 +2732,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 — 표 위의 "누르면 일하는 버튼".
  *
@@ -3074,7 +3344,7 @@ async function cmdSign(args) {
 // ---- doc mail (DOC-MAIL — 문서 송수신) ------------------------------------
 
 const MAIL_USAGE =
-  usage(`rootr mail [inbox|sent] | show <id> | revoke <id> | hide <id>\n`) +
+  usage(`rootr mail [inbox|sent] | show <id> | access <id> <read|comment|write> | revoke <id> | hide <id> | webhook …\n`) +
   tr('       (자세한 건 rootr --help)', `       (see rootr --help)`);
 
 const NODE_TYPE_KO = {
@@ -3092,23 +3362,34 @@ const NODE_TYPE_KO = {
   SIGNED: tr('서명문서', 'signed document'),
 };
 
+const ACCESS_LABEL = {
+  READ: tr('보기', 'view'),
+  COMMENT: tr('댓글', 'comment'),
+  WRITE: tr('편집', 'edit'),
+};
+
 async function cmdSend(args) {
   const target = args._[0];
   const toArg = typeof args.to === 'string' ? args.to : '';
   const to = toArg.split(/[,;\s]+/).map((s) => s.trim()).filter(Boolean);
-  if (!target || !to.length) {
-    throw new Error(usage(tr(`rootr send <path|id> --to a@x.com[,b@y.com] [--message "..."]`, `rootr send <path|id> --to a@x.com[,b@y.com] [--message "..."]`)));
+  const SEND_USAGE = `rootr send <path|id> --to a@x.com[,b@y.com] [--access read|comment|write] [--message "..."]`;
+  if (!target || !to.length) throw new Error(usage(SEND_USAGE));
+  const access = typeof args.access === 'string' ? args.access.trim().toLowerCase() : undefined;
+  if (access && !['read', 'comment', 'write', 'view', 'edit'].includes(access)) {
+    throw new Error(tr(`--access 는 read(보기)·comment(댓글)·write(편집) 중 하나입니다.`, `--access must be read, comment or write.`));
   }
   const client = makeClient();
   const nodeId = requireResolved(await resolveTarget(client, target));
-  const out = await client.sendNode(nodeId, { to, message: typeof args.message === 'string' ? args.message : undefined });
+  const out = await client.sendNode(nodeId, { to, access, message: typeof args.message === 'string' ? args.message : undefined });
   if (args.json) return console.log(JSON.stringify(out, null, 2));
   const items = out.items ?? [];
-  console.log(tr(`${items.length}명에게 보냈습니다 (묶음 ${out.batchId})`, `Sent to ${items.length} ${items.length === 1 ? 'person' : 'people'} (batch ${out.batchId})`));
+  const lvl = ACCESS_LABEL[out.access] ?? out.access;
+  console.log(tr(`${items.length}명에게 보냈습니다 — 원본을 ${lvl} 권한으로 열어 줌 (묶음 ${out.batchId})`, `Sent to ${items.length} ${items.length === 1 ? 'person' : 'people'} — they can ${lvl} the original (batch ${out.batchId})`));
   for (const it of items) {
     console.log(
       `  ${it.to}\t${it.id}\t` +
-        (it.emailed ? tr('메일 보냄', 'emailed') : tr(`메일 실패${it.error ? `: ${it.error}` : ''} — 문서는 받은 문서함에 있습니다`, `email failed${it.error ? `: ${it.error}` : ''} — the copy is still in their inbox`)),
+        (it.emailed ? tr('메일 보냄', 'emailed') : tr(`메일 실패${it.error ? `: ${it.error}` : ''} — 권한은 그대로 있습니다(받은 문서함)`, `email failed${it.error ? `: ${it.error}` : ''} — the access still stands (their inbox)`)) +
+        (it.resent ? tr('  (다시 보냄 — 권한·메시지만 바꿈)', '  (re-sent — access/message updated)') : ''),
     );
   }
 }
@@ -3132,34 +3413,41 @@ async function cmdMail(args) {
       const type = NODE_TYPE_KO[m.nodeType] ?? m.nodeType;
       const state = m.revoked
         ? tr('[회수됨]', '[withdrawn]')
+        : m.originalDeleted
+          ? tr('[원본 삭제됨]', '[original deleted]')
         : box === 'inbox'
           ? m.readAt ? '' : tr('[새 문서]', '[new]')
           : m.readAt ? tr(`[읽음 ${mailWhen(m.readAt)}]`, `[read ${mailWhen(m.readAt)}]`) : tr('[안 읽음]', '[unread]');
       const who = box === 'inbox' ? `${m.senderName} <${m.senderEmail}>` : `→ ${m.recipientEmail}`;
       const mailFail = box === 'sent' && m.emailed === false ? tr('  [메일 실패]', '  [email failed]') : '';
-      console.log(`${m.id}\t${mailWhen(m.createdAt)}\t${type}\t${m.title}\t${who}${state ? `  ${state}` : ''}${mailFail}`);
+      const lvl = ACCESS_LABEL[m.access] ? ` (${ACCESS_LABEL[m.access]})` : '';
+      console.log(`${m.id}\t${mailWhen(m.createdAt)}\t${type}${lvl}\t${m.title}\t${who}${state ? `  ${state}` : ''}${mailFail}`);
       if (m.message) console.log(`    ${String(m.message).split('\n')[0].slice(0, 100)}`);
     }
     if (out.nextCursor) console.log(tr(`\n다음 쪽: rootr mail ${box} --cursor ${out.nextCursor}`, `\nNext page: rootr mail ${box} --cursor ${out.nextCursor}`));
     return;
   }
+  if (sub === 'webhook' || sub === 'webhooks') return cmdMailWebhook(client, args);
   const id = args._[1];
   if (!id) throw new Error(MAIL_USAGE);
   switch (sub) {
     case 'show':
     case 'read': {
-      const m = await client.getDocMail(id);
+      const m = await client.getDocMail(id, { node: typeof args.node === 'string' ? args.node : undefined });
       if (args.json) return console.log(JSON.stringify(m, null, 2));
-      console.log(`${m.title}  (${NODE_TYPE_KO[m.nodeType] ?? m.nodeType})`);
+      console.log(`${m.title}  (${NODE_TYPE_KO[m.nodeType] ?? m.nodeType} · ${tr('권한', 'access')} ${ACCESS_LABEL[m.access] ?? m.access})`);
       console.log(tr(`보낸 사람: ${m.senderName} <${m.senderEmail}> · ${m.workspaceName}`, `From: ${m.senderName} <${m.senderEmail}> · ${m.workspaceName}`));
       console.log(tr(`받는 사람: ${m.recipientEmail} · 보낸 때 ${mailWhen(m.createdAt)}${m.readAt ? ` · 읽음 ${mailWhen(m.readAt)}` : ''}`, `To: ${m.recipientEmail} · sent ${mailWhen(m.createdAt)}${m.readAt ? ` · read ${mailWhen(m.readAt)}` : ''}`));
       if (m.message) console.log(tr(`메시지: ${m.message}`, `Message: ${m.message}`));
-      if (m.revoked && !m.payload) return console.log(tr('\n보낸 사람이 이 문서를 회수했습니다.', '\nThe sender withdrew this document.'));
-      if (m.revoked) console.log(tr('(회수함 — 받는 쪽에서는 본문이 안 보입니다)', '(withdrawn — the recipient no longer sees the content)'));
+      if (m.revoked && m.viewer !== 'sender') return console.log(tr('\n보낸 사람이 이 문서를 회수했습니다.', '\nThe sender withdrew this document.'));
+      if (m.originalDeleted) return console.log(tr('\n원본이 삭제되었습니다.', '\nThe original has been deleted.'));
+      if (m.revoked) console.log(tr('(회수함 — 받는 사람은 더 못 엽니다)', '(withdrawn — the recipient can no longer open it)'));
+      if (m.openUrl) console.log(tr(`원본 열기(편집기): ${m.openUrl}`, `Open the original (editor): ${m.openUrl}`));
+      if (m.picked) console.log(tr(`보고 있는 것: ${m.picked.name} (${m.picked.id})`, `Showing: ${m.picked.name} (${m.picked.id})`));
       const p = m.payload ?? {};
       console.log('');
-      if (p.kind === 'doc') return console.log(p.content ?? '');
-      if (p.kind === 'database') {
+      if (typeof m.contentMd === 'string' || p.kind === 'doc') console.log(m.contentMd ?? p.content ?? '');
+      else if (p.kind === 'database') {
         const props = p.properties ?? [];
         const rows = p.rows ?? [];
         console.log(props.map((c) => c.name).join('\t'));
@@ -3169,30 +3457,107 @@ async function cmdMail(args) {
             return v === null || v === undefined ? '' : typeof v === 'object' ? JSON.stringify(v) : String(v);
           }).join('\t'));
         }
-        if (p.truncated) console.log(tr(`… ${p.truncated.total}행 중 ${p.truncated.shown}행만 담겼습니다`, `… ${p.truncated.shown} of ${p.truncated.total} rows were included`));
-        return;
+        if (p.truncated) console.log(tr(`… ${p.truncated.total}행 중 ${p.truncated.shown}행만 보입니다`, `… showing ${p.truncated.shown} of ${p.truncated.total} rows`));
+        if (p.rowsHidden === 'booking') console.log(tr('(예약을 받는 표라 행은 안 보입니다)', '(a booking table — rows are not shown)'));
+      } else if (p.kind) {
+        const keys = Object.keys(p).filter((k) => k !== 'kind');
+        console.log(tr(`[${p.kind}] 담긴 것: ${keys.join(', ')} — 전부 보려면 --json`, `[${p.kind}] contains: ${keys.join(', ')} — use --json for everything`));
+      }
+      if (m.children?.length) {
+        console.log(tr('\n안에 든 것 (rootr mail show <id> --node <아래 id>):', '\nInside (rootr mail show <id> --node <child id>):'));
+        for (const c of m.children) console.log(`  ${c.id}\t${NODE_TYPE_KO[c.type] ?? c.type}\t${c.name}`);
       }
-      const keys = Object.keys(p).filter((k) => k !== 'kind');
-      console.log(tr(`[${p.kind}] 담긴 것: ${keys.join(', ')} — 전부 보려면 --json`, `[${p.kind}] contains: ${keys.join(', ')} — use --json for everything`));
       return;
     }
+    case 'access': {
+      const level = args._[2];
+      if (!level || !['read', 'comment', 'write', 'view', 'edit'].includes(String(level).toLowerCase())) throw new Error(MAIL_USAGE);
+      const out = await client.setDocMailAccess(id, String(level).toLowerCase());
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      return console.log(tr(`받는 사람 권한을 ${ACCESS_LABEL[out.access] ?? out.access}(으)로 바꿨습니다.`, `The recipient can now ${ACCESS_LABEL[out.access] ?? out.access}.`));
+    }
     case 'revoke': {
       const out = await client.revokeDocMail(id);
       if (args.json) return console.log(JSON.stringify(out, null, 2));
-      return console.log(tr(`회수했습니다 (${mailWhen(out.revokedAt)}) — 받는 쪽에서 본문이 안 보입니다.`, `Withdrawn (${mailWhen(out.revokedAt)}) — the recipient no longer sees the content.`));
+      return console.log(tr(`회수했습니다 (${mailWhen(out.revokedAt)}) — 받는 사람이 원본을 더 못 엽니다.`, `Withdrawn (${mailWhen(out.revokedAt)}) — the recipient can no longer open the original.`));
     }
     case 'hide':
     case 'rm': {
       const box = args.box === 'inbox' || args.box === 'sent' ? args.box : undefined;
       const out = await client.hideDocMail(id, { box });
       if (args.json) return console.log(JSON.stringify(out, null, 2));
-      return console.log(tr(`내 문서함에서 지웠습니다 (${out.hidden}). 상대 화면은 그대로입니다.`, `Removed from your mailbox (${out.hidden}). The other side still has it.`));
+      return console.log(tr(`내 문서함에서 지웠습니다 (${out.hidden}). 상대 화면은 그대로입니다(받은 것을 지웠으면 내 계정으로는 더 안 열립니다).`, `Removed from your mailbox (${out.hidden}). The other side still has it (a removed received document no longer opens for your account).`));
     }
     default:
       throw new Error(MAIL_USAGE);
   }
 }
 
+const WEBHOOK_USAGE = usage(
+  tr(
+    `rootr mail webhook add <url> [--events doc_mail.received,doc_mail.revoked,doc_mail.read] [--name <이름>]\n` +
+      `       rootr mail webhook list | rm <id> | test <id>`,
+    `rootr mail webhook add <url> [--events doc_mail.received,doc_mail.revoked,doc_mail.read] [--name <name>]\n` +
+      `       rootr mail webhook list | rm <id> | test <id>`,
+  ),
+);
+
+/** DOC-MAIL-HOOK — 내(계정) 받은 문서 웹훅. 워크스페이스 웹훅과 따로 — 받은 문서는 사람의 것이다. */
+async function cmdMailWebhook(client, args) {
+  const op = args._[1];
+  const arg = args._[2];
+  switch (op) {
+    case 'add': {
+      if (!arg) throw new Error(WEBHOOK_USAGE);
+      const events = typeof args.events === 'string' ? args.events.split(',').map((x) => x.trim()).filter(Boolean) : undefined;
+      const out = await client.addDocMailWebhook({ url: arg, events, name: typeof args.name === 'string' ? args.name : undefined });
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      console.log(tr(`웹훅을 만들었습니다: ${out.id}`, `Webhook created: ${out.id}`));
+      console.log(`  url: ${out.url}`);
+      console.log(`  events: ${out.events.join(', ')}`);
+      console.log(tr(`  비밀값(지금 한 번만 보입니다 — 서명 X-Rootr-Signature 검증용): ${out.secret}`, `  secret (shown once — verify X-Rootr-Signature with it): ${out.secret}`));
+      return;
+    }
+    case 'list':
+    case 'ls':
+    case undefined: {
+      const out = await client.listDocMailWebhooks();
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      if (!out.items?.length) return console.log(tr('웹훅이 없습니다. rootr mail webhook add <url>', 'No webhooks. rootr mail webhook add <url>'));
+      for (const h of out.items) {
+        const last = h.lastDelivery ? ` · ${h.lastDelivery.event} ${h.lastDelivery.status}${h.lastDelivery.responseCode ? ` ${h.lastDelivery.responseCode}` : ''}` : '';
+        console.log(`${h.id}\t${h.active ? 'on' : 'off'}\t${h.url}\t${h.events.join(',')}${last}`);
+      }
+      return;
+    }
+    case 'rm':
+    case 'remove':
+    case 'delete': {
+      if (!arg) throw new Error(WEBHOOK_USAGE);
+      const out = await client.removeDocMailWebhook(arg);
+      if (args.json) return console.log(JSON.stringify(out, null, 2));
+      return console.log(tr(`웹훅을 지웠습니다: ${arg}`, `Webhook removed: ${arg}`));
+    }
+    case 'test': {
+      if (!arg) throw new Error(WEBHOOK_USAGE);
+      const queued = await client.testDocMailWebhook(arg);
+      let d = null;
+      for (let i = 0; i < 10; i++) {
+        await new Promise((r) => setTimeout(r, 750));
+        d = (await client.docMailWebhookDeliveries(arg)).items?.find((x) => x.id === queued.deliveryId) ?? null;
+        if (d && d.status !== 'PENDING') break;
+      }
+      if (args.json) return console.log(JSON.stringify({ ...queued, delivery: d }, null, 2));
+      if (!d || d.status === 'PENDING') return console.log(tr(`시험 전송을 큐에 넣었습니다(${queued.deliveryId}) — 아직 결과가 없습니다.`, `Test queued (${queued.deliveryId}) — no result yet.`));
+      if (d.status === 'SUCCESS') return console.log(tr(`시험 전송 성공 (HTTP ${d.responseCode})`, `Test delivered (HTTP ${d.responseCode})`));
+      process.exitCode = 1;
+      return console.log(tr(`시험 전송 실패: ${d.error ?? d.responseCode} — 다시 시도합니다(최대 5번).`, `Test failed: ${d.error ?? d.responseCode} — it will be retried (up to 5 times).`));
+    }
+    default:
+      throw new Error(WEBHOOK_USAGE);
+  }
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   const args = parseArgs(argv);
@@ -3277,4 +3642,31 @@ async function main() {
   }
 }
 
-main().catch(printErrorAndExit);
+/**
+ * DOC-MAIL-NOTIFY — 아무 명령이든 끝난 뒤, 그 명령이 부른 API 응답 머리줄에 **새로 받은 문서**가 있었으면 stderr 로 한 줄
+ * (stdout·--json 출력은 더럽히지 않는다). 따로 묻는 호출은 없다. 서버가 키마다 한 번만 알려 준다(channel 'cli').
+ * `rootr mail`·`rootr mcp` 에서는 안 낸다(이미 문서함을 보고 있다 / 표준 입출력이 MCP 통로다).
+ * 끄기: `ROOTR_MAIL_NOTICE=0`.
+ */
+const docMailSink = { channel: 'cli', items: [] };
+const firstArg = process.argv.slice(2).find((a) => !a.startsWith('-'));
+const docMailNoticeOn = process.env.ROOTR_MAIL_NOTICE !== '0' && firstArg !== 'mail' && firstArg !== 'mcp';
+if (docMailNoticeOn) setGlobalDocMailSink(docMailSink);
+function printDocMailNotice() {
+  if (!docMailNoticeOn || !docMailSink.items.length) return;
+  const n = Math.max(docMailSink.items.length, docMailSink.newCount || 0);
+  const first = docMailSink.items[0];
+  console.error(
+    tr(
+      `📬 받은 문서 ${n}건 — 「${first.title}」 ${first.sender}${n > 1 ? ' 외' : ''} · rootr mail`,
+      `📬 ${n} new document${n > 1 ? 's' : ''} received — "${first.title}" from ${first.sender}${n > 1 ? ' and more' : ''} · rootr mail`,
+    ),
+  );
+}
+
+main()
+  .then(printDocMailNotice)
+  .catch((err) => {
+    printDocMailNotice();
+    printErrorAndExit(err);
+  });