rootr-cli 0.18.0 → 0.20.0

package/bin/rootr.js

@@ -5,7 +5,7 @@ import { dirname, join, basename, extname } from 'node:path';
 
 import { loadConfig, saveConfig, keyForWorkspace, maskKey, upsertKey, CONFIG_PATH, DEFAULT_BASE_URL } from '../lib/config.js';
 import { candidateClients, rememberWorkspace, resolveWorkspaceSwitch, surveyWorkspaces } from '../lib/credentials.js';
-import { RootrClient, RootrApiError } from '../lib/client.js';
+import { RootrClient, RootrApiError, imageMarkdown } from '../lib/client.js';
 import { resolveTarget, requireResolved, resolveMoveDestination } from '../lib/resolve.js';
 import { t as tr, lang } from '../lib/i18n.js';
 
@@ -19,6 +19,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr read <path|id> [--json]                    문서 읽기 (마크다운 또는 JSON)
   rootr write <path|id> [--file <f>] [--if-match <etag>]   문서 전체 교체(파일 없으면 생성)
   rootr append <path|id> [<text>] [--heading "## X"] [--file <f>]  문서 끝(또는 헤딩 아래)에 안전하게 추가
+  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 search <query>                             워크스페이스 검색
@@ -53,6 +54,12 @@ 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 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  방문자에게 더 묻기 · 승인 후 확정
+  rootr booking set <표> --gcal-connection <id> --gcal-busy <캘린더> --gcal-write <캘린더>  구글 캘린더 연동
+  rootr booking slots <표> [--from 2026-10-01] [--to 2026-10-31]  방문자에게 보이는 빈 시간
+  rootr gcal list|connect|calendars <id>|disconnect <id>  구글 캘린더 계정 연결(동의는 브라우저에서 한 번)
   rootr readreq <path|id> [--json]                 읽음 확인 현황 — 누가 읽었나·완료율
   rootr readreq <path|id> --users <id,id> [--due <ISO>] [--ack]  읽어야 할 사람 지정(명단 통째로 교체)
   rootr readreq <path|id> --clear                  읽음 확인 해제
@@ -90,12 +97,12 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr scaffold review --file tree.json [--json]  짓기 2단계 — 만들기 전에 검사받기(점수·고칠 곳)
   rootr scaffold apply --file tree.json [--root /경로]  짓기 3단계 — 실제로 만들기(검사 결과도 같이 나옴)
   rootr scaffold built [--root /경로] [--json]      짓고 나서 — 실제로 만들어진 것의 **모양**을 검사
-  rootr scaffold test [--root /경로] [--json]       짓고 나서 — 실제로 **돌려 본다**(관계·롤업·수식·폼·시트). 실패 시 exit 1
+  rootr scaffold test [--root /경로] [--json]       짓고 나서 — 실제로 **돌려 본다**(관계·롤업·수식·폼·시트·대시보드 차트). 실패 시 exit 1
   rootr memory [--query <q>] [--kind <k>] [--json]  팀의 기억 회상 — AI 에이전트가 읽는 같은 목록
   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 서버 구동 (도구 167종 — README 참고)
+  rootr mcp                                        MCP stdio 서버 구동 (도구 178종 — README 참고)
   rootr --help                                     도움말
   rootr --version                                  버전 출력
 
@@ -113,6 +120,7 @@ usage:
   rootr read <path|id> [--json]                    read a document (markdown, or JSON)
   rootr write <path|id> [--file <f>] [--if-match <etag>]   replace a document (creates it if missing)
   rootr append <path|id> [<text>] [--heading "## X"] [--file <f>]  append safely to the end (or under a heading)
+  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 search <query>                             search the workspace
@@ -147,6 +155,12 @@ 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 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
+  rootr booking set <table> --gcal-connection <id> --gcal-busy <cal> --gcal-write <cal>  Google Calendar
+  rootr booking slots <table> [--from 2026-10-01] [--to 2026-10-31]  open times visitors see
+  rootr gcal list|connect|calendars <id>|disconnect <id>  connect a Google account (consent once in a browser)
   rootr readreq <path|id> [--json]                 read receipts — who has read it, completion rate
   rootr readreq <path|id> --users <id,id> [--due <ISO>] [--ack]  set who must read it (replaces the whole list)
   rootr readreq <path|id> --clear                  clear the read requirement
@@ -183,12 +197,12 @@ usage:
   rootr scaffold review --file tree.json [--json]  build step 2 — get graded before anything is created
   rootr scaffold apply --file tree.json [--root /path]  build step 3 — actually create it (grades come along)
   rootr scaffold built [--root /path] [--json]     after building — inspect the **shape** of what exists
-  rootr scaffold test [--root /path] [--json]      after building — actually **exercise** it (relations, rollups, formulas, forms, sheets). Exits 1 on failure
+  rootr scaffold test [--root /path] [--json]      after building — actually **exercise** it (relations, rollups, formulas, forms, sheets, dashboard charts). Exits 1 on failure
   rootr memory [--query <q>] [--kind <k>] [--json]  recall team memory — the same list AI agents read
   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 (167 tools — see the README)
+  rootr mcp                                        run the MCP stdio server (178 tools — see the README)
   rootr --help                                     this help
   rootr --version                                  print the version
 
@@ -359,7 +373,9 @@ async function cmdWrite(args) {
       content,
     });
     const id = created.id || (created.node && created.node.id);
-    console.error(`created ${resolved.path} (id ${id})`);
+    // 서버가 실제로 둔 경로(이름에 꼬리가 붙는 자리에서는 요청한 경로와 다르다 — 그 경로로 다시 써야 같은 문서에 닿는다)
+    const at = created.path || (created.node && created.node.path) || resolved.path;
+    console.error(`created ${at} (id ${id})`);
     return;
   }
 
@@ -367,6 +383,25 @@ async function cmdWrite(args) {
   console.error(`wrote ${target} (etag ${etag || 'n/a'})`);
 }
 
+/**
+ * EMBED-API — 문서 안에 다른 노드를 끼워 넣는다(편집기의 "끼워 넣기" 블록과 같다). 둘 다 경로든 id 든 된다.
+ * 서버가 문서 끝(또는 헤딩 아래)에 `[[embed:<id>]]` 한 줄을 붙이고, 편집기는 그 줄을 살아 있는 표로 그린다.
+ */
+async function cmdEmbed(args) {
+  const [doc, node] = args._;
+  if (!doc || !node) throw new Error(usage(`rootr embed <doc path|id> <node path|id> [--heading "## X"]`));
+  const client = makeClient();
+  const docId = requireResolved(await resolveTarget(client, doc));
+  const nodeId = requireResolved(await resolveTarget(client, node));
+  const heading = typeof args.heading === 'string' ? args.heading : undefined;
+  const res = await client.embedNode(docId, { node: nodeId, underHeading: heading });
+  if (args.json) {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  console.error(tr(`끼워 넣음: ${node} → ${doc} (${res.marker})`, `embedded ${node} into ${doc} (${res.marker})`));
+}
+
 async function cmdAppend(args) {
   const target = args._[0];
   if (!target) throw new Error(usage(`rootr append <path|id> [<text>] [--heading "## X"] [--file <f>]`));
@@ -527,7 +562,8 @@ async function cmdAttach(args) {
     });
   }
 
-  const client = new RootrClient({ ...cfg, workspace });
+  // ISSUE-61 — --workspace 로 고른 워크스페이스에 묶인 키로(MCP 첨부 도구와 같은 결함: 기본 키로 가면 403)
+  const client = new RootrClient({ ...cfg, workspace, apiKey: keyForWorkspace(cfg, workspace) });
   const data = readFileSync(filePath);
   const filename = basename(filePath);
   const mimeType = args.mime || MIME_BY_EXT[extname(filePath).toLowerCase()] || 'application/octet-stream';
@@ -540,7 +576,7 @@ async function cmdAttach(args) {
 
   const { id } = await client.uploadAttachment(workspace, { filename, mimeType, nodeId, data });
   const url = client.attachmentRawUrl(id);
-  const markdown = `![${args.alt || filename}](${url})`;
+  const markdown = imageMarkdown(args.alt || filename, url);
 
   if (nodeId) {
     const result = await client.appendDocument(nodeId, { content: markdown, underHeading: args.heading });
@@ -617,7 +653,12 @@ async function cmdAsk(args) {
   if (citations.length) {
     console.log('\nCitations:');
     for (const c of citations) {
-      console.log(`- ${c.documentPath}: ${c.quote}`);
+      // DB-SEARCH — MCP rootr_ask 와 같은 모양: 표의 행은 "표 › 행 제목 (행 주소)".
+      if (c.rowId) {
+        console.log(`- ${c.documentTitle || c.documentPath} › ${c.rowTitle || '(untitled row)'}${c.url ? ` (${c.url})` : ''}: ${c.quote}`);
+      } else {
+        console.log(`- ${c.documentPath}${c.url ? ` (${c.url})` : ''}: ${c.quote}`);
+      }
     }
   }
 }
@@ -1544,6 +1585,20 @@ async function cmdPublish(args) {
       console.log(tr('이 종류는 공개할 수 없습니다(폴더).', `This node type cannot be published (folder).`));
       return;
     }
+    if (st.closed) {
+      // 공개를 끈 것과 다르다 — 설정은 켜져 있고, "본인이 만든 행만" 표의 행에서 나온 것이라 지금 닫혀 있다(서버 응답의 closed)
+      console.log(tr(`공개가 켜져 있지만 지금은 닫혀 있습니다(주소: /p/${st.slug}).`, `Publishing is on, but it is closed right now (address: /p/${st.slug}).`));
+      console.log(
+        '  ' +
+          tr(
+            st.closedTableGone
+              ? '"본인이 만든 행만 보기"를 켠 표의 행에서 나온 것이라 로그인하지 않은 사람에게는 열리지 않습니다. 그 표는 이미 지워져 표 설정을 바꿀 수 없습니다 — 내용을 새 문서에 옮겨 적어 그 문서를 공개하세요.'
+              : '"본인이 만든 행만 보기"를 켠 표의 행에서 나온 것이라 로그인하지 않은 사람에게는 열리지 않습니다. 표 권한에서 그 설정을 끄거나 행 연결을 끊으면 같은 주소로 다시 열립니다.',
+            st.closedReason ?? 'This item comes from a row of a table with "Own rows only" turned on, so it does not open for people who are not signed in.',
+          ),
+      );
+      return;
+    }
     if (!st.isPublic) {
       console.log(st.slug ? tr(`닫혀 있습니다(주소는 남아 있음: /p/${st.slug})`, `Closed (the address is still reserved: /p/${st.slug})`) : tr('아직 공개한 적이 없습니다.', `Never published.`));
       return;
@@ -1625,6 +1680,405 @@ async function cmdPublish(args) {
  * 표·폴더에 걸면 그 안의 문서 전부에 걸린다(완료율은 사람마다 굴러 올라온다).
  * 읽음 기록은 사람의 것이라, 사람이 붙지 않은 열쇠로는 걸 수 없다.
  */
+/**
+ * BOOKING — 공개한 표를 **예약 페이지**로 쓰는 명령(창업자 지시 2026-09-23).
+ *
+ * 화면에서 하던 것을 그대로 명령줄에서도 할 수 있어야 한다 —
+ * 켜기·규칙·확정 방식·물어볼 칸·구글 캘린더 고르기, 그리고 방문자가 보는 빈 시간 확인까지.
+ */
+const BOOKING_WEEKDAYS = { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 };
+
+/**
+ * `--block-time` 한 토막을 규칙 한 줄로. 사람이 손으로 쓰는 자리라 너그럽게 읽는다.
+ *   "daily 12:00-13:00=점심"  · "mon 09:00-11:00"  · "fri"  · "2026-10-05 13:00-15:00"
+ *   "12:00-13:00"(앞을 비우면 매일) · "mon 14:00-"(뒤를 비우면 그날 끝까지)
+ */
+function parseBlockTime(tok) {
+  let t = String(tok).trim();
+  if (!t) return null;
+  let label;
+  const eq = t.indexOf('=');
+  if (eq >= 0) {
+    label = t.slice(eq + 1).trim();
+    t = t.slice(0, eq).trim();
+  }
+  const pad = (v) => (v && /^\d:/.test(v) ? `0${v}` : v);
+  let start;
+  let end;
+  const m = t.match(/(\d{1,2}:\d{2})?\s*-\s*(\d{1,2}:\d{2})?$/);
+  if (m && (m[1] || m[2])) {
+    start = pad(m[1]);
+    end = pad(m[2]);
+    t = t.slice(0, m.index).trim();
+  }
+  const head = t.toLowerCase();
+  let out;
+  if (/^\d{4}-\d{2}-\d{2}$/.test(head)) out = { kind: 'date', date: head };
+  else if (head in BOOKING_WEEKDAYS) out = { kind: 'weekly', weekday: BOOKING_WEEKDAYS[head] };
+  else if (!head || head === 'daily' || head === 'every') out = { kind: 'daily' };
+  else {
+    throw new Error(
+      tr(
+        `막는 시간을 못 읽었습니다: "${tok}"\n  이렇게 적어 주세요: daily 12:00-13:00 · mon 09:00-11:00 · fri · 2026-10-05 13:00-15:00`,
+        `Could not read the blocked time: "${tok}"\n  Write it like: daily 12:00-13:00 · mon 09:00-11:00 · fri · 2026-10-05 13:00-15:00`,
+      ),
+    );
+  }
+  if (start) out.start = start;
+  if (end) out.end = end;
+  if (label) out.label = label;
+  return out;
+}
+
+/**
+ * `30분 상담=30m|화면 보며 설명` 한 토막을 약속 종류 한 줄로.
+ * 길이를 못 읽으면 버린다 — 조용히 기본 길이로 만들면 "30분으로 적었는데 60분이 잡힌다"가 된다.
+ */
+function parseType(part) {
+  const t = String(part || '').trim();
+  if (!t) return null;
+  const [head, description] = t.split('|');
+  const eq = head.lastIndexOf('=');
+  if (eq < 0) return null;
+  const name = head.slice(0, eq).trim();
+  const min = parseRemind(head.slice(eq + 1));
+  if (!name || !min) return null;
+  return { name, durationMin: min, ...(description && description.trim() ? { description: description.trim() } : {}) };
+}
+
+/**
+ * `1d`·`3h`·`90m`·`1440` 을 분으로. 사람이 손으로 쓰는 자리라 너그럽게 읽는다.
+ * 읽을 수 없으면 null — 조용히 0으로 만들면 "곧 시작합니다"가 약속 시각에 나간다.
+ */
+function parseRemind(raw) {
+  const t = String(raw || '').trim().toLowerCase();
+  const m = /^(\d+)\s*(d|일|h|시간|m|분)?$/.exec(t);
+  if (!m) return null;
+  const n = Number(m[1]);
+  if (!n) return null;
+  const unit = m[2] || 'm';
+  if (unit === 'd' || unit === '일') return n * 1440;
+  if (unit === 'h' || unit === '시간') return n * 60;
+  return n;
+}
+
+/** 1440 → `1d`. 사람이 읽는 줄에 쓴다. */
+function remindText(min) {
+  if (min % 1440 === 0) return `${min / 1440}d`;
+  if (min % 60 === 0) return `${min / 60}h`;
+  return `${min}m`;
+}
+
+/** 규칙 한 줄을 사람이 읽을 한 마디로(booking show 용). */
+function blockTimeText(b) {
+  const when =
+    b.kind === 'date'
+      ? b.date
+      : b.kind === 'weekly'
+        ? Object.keys(BOOKING_WEEKDAYS).find((k) => BOOKING_WEEKDAYS[k] === b.weekday)
+        : tr('매일', 'daily');
+  const span = b.start || b.end ? ` ${b.start ?? ''}-${b.end ?? ''}` : tr(' 하루 전체', ' all day');
+  return `${when}${span}${b.label ? ` (${b.label})` : ''}`;
+}
+
+async function cmdBooking(args) {
+  const sub = args._[0];
+  const target = args._[1];
+  if (!sub || (sub !== 'slots' && !target)) {
+    throw new Error(
+      usage(tr(`rootr booking show <path|id>`, `rootr booking show <path|id>`)) +
+        tr(
+          `\n  rootr booking set <path|id> [--on|--off] [--days 1,2,3,4,5] [--hours 10:00-18:00]\n` +
+            `      [--duration 30] [--buffer 10] [--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` +
+            `      [--self-move on|off] [--remind 1d,1h   (안 보내려면 --remind off)]\n` +
+            `      [--types "30분 상담=30m,데모=60m|화면 보며 설명"] [--guests on|off] [--max-guests 5]\n` +
+            `      [--after https://example.com/thanks]\n` +
+            `      [--hosts "김상담=a@acme.com,이데모=b@acme.com"] [--assign roundrobin|collective|off]\n` +
+            `      [--ask "연락처:required,상담 종류"] [--message "안내 문구"]\n` +
+            `      [--gcal-connection <id>] [--gcal-busy <캘린더id,...>] [--gcal-write <캘린더id|none>]\n` +
+            `  rootr booking slots <path|id> [--from 2026-10-01] [--to 2026-10-31] [--type <종류 이름표>]\n`,
+          `\n  rootr booking set <path|id> [--on|--off] [--days 1,2,3,4,5] [--hours 10:00-18:00]\n` +
+            `      [--duration 30] [--buffer 10] [--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` +
+            `      [--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]\n` +
+            `      [--after https://example.com/thanks]\n` +
+            `      [--hosts "Sam=a@acme.com,Lee=b@acme.com"] [--assign roundrobin|collective|off]\n` +
+            `      [--ask "Phone:required,Topic"] [--message "note for visitors"]\n` +
+            `      [--gcal-connection <id>] [--gcal-busy <calendarId,...>] [--gcal-write <calendarId|none>]\n` +
+            `  rootr booking slots <path|id> [--from 2026-10-01] [--to 2026-10-31] [--type <type id>]\n`,
+        ),
+    );
+  }
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+
+  if (sub === 'show') {
+    const st = await client.getBooking(id);
+    if (args.json) return console.log(JSON.stringify(st, null, 2));
+    const b = st.booking;
+    if (!b?.enabled) {
+      console.log(tr('방문자 일정 등록: 꺼져 있음', `Visitor booking: off`));
+      if (!st.published) console.log(tr('  (이 표는 아직 웹에 공개되지 않았습니다 — rootr publish 를 먼저)', `  (not published yet — run rootr publish first)`));
+      return;
+    }
+    const days = (b.weekdays || []).map((d) => DAY_NAMES[d]).join('·');
+    console.log(tr(`방문자 일정 등록: 켜짐`, `Visitor booking: on`));
+    console.log(tr(`  받는 때: ${days} ${b.startTime}~${b.endTime} (${b.timezone})`, `  when: ${days} ${b.startTime}-${b.endTime} (${b.timezone})`));
+    console.log(tr(`  한 번 길이: ${b.durationMin}분 · 사이 여유 ${b.bufferMin}분`, `  slot: ${b.durationMin} min · gap ${b.bufferMin} min`));
+    console.log(tr(`  ${b.minNoticeHours}시간 전까지 · ${b.maxDaysAhead}일 뒤까지 · 하루 ${b.maxPerDay || '제한 없음'}`, `  ${b.minNoticeHours}h notice · up to ${b.maxDaysAhead} days · per day ${b.maxPerDay || 'unlimited'}`));
+    console.log(tr(`  확정: ${b.approval === 'manual' ? '승인 후' : '바로'}`, `  confirm: ${b.approval === 'manual' ? 'after approval' : 'instantly'}`));
+    if (b.blockedDates?.length) console.log(tr(`  쉬는 날: ${b.blockedDates.join(', ')}`, `  days off: ${b.blockedDates.join(', ')}`));
+    if (b.types?.length) {
+      console.log(tr('  약속 종류:', '  event types:'));
+      for (const ty of b.types) {
+        console.log(`    ${ty.name} · ${ty.durationMin}${tr('분', ' min')}${ty.description ? ` — ${ty.description}` : ''} (?type=${ty.id})`);
+      }
+    }
+    if (b.hosts?.length) {
+      const mode = b.assign === 'collective' ? tr('다 같이', 'collective') : b.assign === 'roundRobin' ? tr('돌아가며', 'round robin') : tr('안 씀', 'off');
+      console.log(tr(`  담당자(${mode}):`, `  hosts (${mode}):`));
+      for (const h of b.hosts) console.log(`    ${h.name} <${h.email}>${h.google ? tr(' · 구글 연결됨', ' · google linked') : ''}`);
+    }
+    if (b.allowGuests && b.maxGuests > 0) {
+      console.log(tr(`  손님 함께 부르기: 최대 ${b.maxGuests}명`, `  guests: up to ${b.maxGuests}`));
+    }
+    if (b.redirectUrl) console.log(tr(`  잡은 뒤 보낼 곳: ${b.redirectUrl}`, `  after booking: ${b.redirectUrl}`));
+    if (b.allowVisitorCancel === false) console.log(tr('  방문자 직접 취소: 꺼짐', '  visitor self-cancel: off'));
+    if (b.allowVisitorReschedule === false) console.log(tr('  방문자 직접 시간 변경: 꺼짐', '  visitor reschedule: off'));
+    console.log(
+      b.reminders?.length
+        ? tr(`  미리 알림: ${b.reminders.map(remindText).join(', ')} 전`, `  reminders: ${b.reminders.map(remindText).join(', ')} before`)
+        : tr('  미리 알림: 안 보냄', '  reminders: off'),
+    );
+    if (b.google?.meet) console.log(tr('  구글 밋: 예약마다 회의 만듦', '  Google Meet: a room per booking'));
+    const mailTo = [
+      ...(b.notifyVisitor === false ? [] : [tr('방문자', 'visitor')]),
+      ...(b.notifyEmails ?? []),
+    ];
+    console.log(
+      mailTo.length
+        ? tr(`  결과 메일: ${mailTo.join(', ')}`, `  result email: ${mailTo.join(', ')}`)
+        : tr('  결과 메일: 안 보냄', '  result email: off'),
+    );
+    if (b.blockedTimes?.length) {
+      console.log(tr('  막는 시간:', '  blocked times:'));
+      for (const bt of b.blockedTimes) console.log(`    ${blockTimeText(bt)}`);
+    }
+    if (b.askFields?.length) console.log(tr(`  더 묻는 칸: ${b.askFields.length}개`, `  extra fields: ${b.askFields.length}`));
+    if (st.googleAccount) {
+      const g = st.googleAccount;
+      console.log(tr(`  구글 캘린더: ${g.email}${g.broken ? ' (연결 끊김 — 다시 연결하세요)' : ''}`, `  Google Calendar: ${g.email}${g.broken ? ' (disconnected — reconnect)' : ''}`));
+      console.log(tr(`    막는 캘린더 ${b.google?.busyCalendarIds?.length || 0}개 · 적는 곳: ${b.google?.writeCalendarId || '안 적음'}`, `    blocking ${b.google?.busyCalendarIds?.length || 0} · writes to: ${b.google?.writeCalendarId || 'none'}`));
+    } else {
+      console.log(tr('  구글 캘린더: 안 씀', `  Google Calendar: not used`));
+    }
+    if (st.syncError) console.log(tr(`  ⚠ 구글에 못 적은 예약이 있습니다(5분마다 다시 시도).`, `  ⚠ some bookings failed to sync (retrying every 5 min).`));
+    return;
+  }
+
+  if (sub === 'slots') {
+    const st = await client.nodePublicStatus(id);
+    if (!st.slug) throw new Error(tr('공개된 표가 아닙니다 — rootr publish 를 먼저 하세요.', `Not published — run rootr publish first.`));
+    // 기간을 안 주면 오늘부터 한 달 — 서버는 from/to 를 반드시 요구한다.
+    const today = new Date(Date.now() + 9 * 3600e3).toISOString().slice(0, 10);
+    const from = args.from || today;
+    const to = args.to || new Date(Date.parse(`${from}T00:00:00Z`) + 30 * 864e5).toISOString().slice(0, 10);
+    const days = await client.bookingSlots(st.slug, { from, to, type: args.type });
+    if (args.json) return console.log(JSON.stringify(days, null, 2));
+    const entries = Object.entries(days.days || {});
+    if (!entries.length) return console.log(tr('그 기간에는 비어 있는 시간이 없습니다.', `No open times in that range.`));
+    const kind = days.type ? ` · ${days.type}` : '';
+    console.log(
+      tr(`빈 시간 (${days.durationMin}분 단위, ${days.timezone}${kind})`, `Open times (${days.durationMin} min, ${days.timezone}${kind})`),
+    );
+    for (const [date, times] of entries) console.log(`  ${date}  ${times.join(' ')}`);
+    return;
+  }
+
+  if (sub !== 'set') throw new Error(usage('rootr booking <show|set|slots> <path|id>'));
+
+  const body = {};
+  if (args.on) body.enabled = true;
+  if (args.off) body.enabled = false;
+  if (args.days) body.weekdays = String(args.days).split(',').map((d) => Number(d.trim())).filter((d) => Number.isInteger(d));
+  if (args.hours) {
+    const [start, end] = String(args.hours).split('-').map((x) => x.trim());
+    if (!start || !end) throw new Error(tr('--hours 는 10:00-18:00 처럼 적어 주세요.', `--hours looks like 10:00-18:00`));
+    body.startTime = start;
+    body.endTime = end;
+  }
+  if (args.duration !== undefined) body.durationMin = Number(args.duration);
+  if (args.buffer !== undefined) body.bufferMin = Number(args.buffer);
+  if (args.notice !== undefined) body.minNoticeHours = Number(args.notice);
+  if (args.ahead !== undefined) body.maxDaysAhead = Number(args.ahead);
+  if (args['per-day'] !== undefined) body.maxPerDay = Number(args['per-day']);
+  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['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;
+  if (args['guests'] !== undefined) body.allowGuests = args['guests'] !== 'off' && args['guests'] !== false;
+  if (args['max-guests'] !== undefined) body.maxGuests = Number(args['max-guests']);
+  if (args['after'] !== undefined) body.redirectUrl = String(args['after'] === true ? '' : args['after']).trim();
+  if (args['assign'] !== undefined) {
+    const a = String(args['assign']).trim().toLowerCase();
+    body.assign = a === 'roundrobin' || a === 'rr' ? 'roundRobin' : a === 'collective' || a === 'all' ? 'collective' : 'none';
+  }
+  // `--hosts "김상담=a@acme.com,이데모=b@acme.com"` → 목록을 통째로 바꾼다. 빈 값이면 없앤다.
+  if (args['hosts'] !== undefined) {
+    const raw = String(args['hosts'] === true ? '' : args['hosts']).trim();
+    body.hosts = raw
+      ? raw
+          .split(',')
+          .map((part) => {
+            const t = part.trim();
+            const eq = t.lastIndexOf('=');
+            if (eq < 0) return null;
+            const name = t.slice(0, eq).trim();
+            const email = t.slice(eq + 1).trim();
+            return name && email.includes('@') ? { name, email } : null;
+          })
+          .filter(Boolean)
+      : [];
+  }
+  // `--types "상담=30m,데모=60m|설명"` → 목록을 통째로 바꾼다. 빈 값을 주면 종류를 없앤다.
+  if (args['types'] !== undefined) {
+    const raw = String(args['types'] === true ? '' : args['types']).trim();
+    body.types = raw
+      ? raw
+          .split(',')
+          .map((part) => parseType(part))
+          .filter(Boolean)
+      : [];
+  }
+  // `--remind 1d,1h` → [1440, 60]. `off`·빈 값이면 안 보낸다.
+  if (args['remind'] !== undefined) {
+    const raw = String(args['remind']).trim().toLowerCase();
+    body.reminders =
+      raw === '' || raw === 'off' || args['remind'] === false
+        ? []
+        : raw
+            .split(',')
+            .map((x) => parseRemind(x))
+            .filter((n) => n !== null);
+  }
+  if (args['notify-email'] !== undefined) {
+    body.notifyEmails = String(args['notify-email']).split(',').map((x) => x.trim()).filter(Boolean);
+  }
+  if (args['block-time'] !== undefined) {
+    body.blockedTimes = String(args['block-time'])
+      .split(',')
+      .map((x) => parseBlockTime(x))
+      .filter(Boolean);
+  }
+  if (args.approval) body.approval = String(args.approval);
+  if (args.tz) body.timezone = String(args.tz);
+  if (args.message !== undefined) body.notice = String(args.message);
+  if (args.ask !== undefined) {
+    // "연락처:required,상담 종류" → [{propId:'연락처',required:true},{propId:'상담 종류',required:false}]
+    // 칸 이름으로 적어도 받는다(id 를 외우고 있는 사람은 없다).
+    body.askFields = String(args.ask)
+      .split(',')
+      .map((x) => x.trim())
+      .filter(Boolean)
+      .map((x) => {
+        const required = /:required$/i.test(x);
+        return { propId: x.replace(/:required$/i, '').trim(), required };
+      });
+  }
+  if (args['gcal-connection'] || args['gcal-busy'] || args['gcal-write']) {
+    const cur = (await client.getBooking(id)).booking?.google || {};
+    const google = { ...cur };
+    if (args['gcal-connection']) google.connectionId = String(args['gcal-connection']);
+    if (args['gcal-busy']) google.busyCalendarIds = String(args['gcal-busy']).split(',').map((x) => x.trim()).filter(Boolean);
+    if (args['gcal-write']) google.writeCalendarId = args['gcal-write'] === 'none' ? null : String(args['gcal-write']);
+    if (!google.connectionId) {
+      throw new Error(tr('먼저 --gcal-connection 으로 구글 연결을 고르세요(rootr gcal list).', `Pick a connection first with --gcal-connection (see rootr gcal list).`));
+    }
+    body.google = google;
+  }
+  if (!Object.keys(body).length) throw new Error(usage('rootr booking set <path|id> --on [...]'));
+
+  // 칸 이름으로 물어볼 칸을 골랐으면 id 로 바꿔 준다 — 서버는 id 만 받는다.
+  if (body.askFields?.length) {
+    const db = await client.getDatabase(id);
+    const byName = new Map((db.properties || []).map((p) => [p.name, p.id]));
+    const ids = new Set((db.properties || []).map((p) => p.id));
+    body.askFields = body.askFields.map((a) => {
+      if (ids.has(a.propId)) return a;
+      const found = byName.get(a.propId);
+      if (!found) throw new Error(tr(`"${a.propId}" 칸이 이 표에 없습니다.`, `No column named "${a.propId}" in this table.`));
+      return { ...a, propId: found };
+    });
+  }
+
+  const st = await client.setBooking(id, body);
+  if (args.json) return console.log(JSON.stringify(st, null, 2));
+  const pub = await client.nodePublicStatus(id);
+  console.log(st.booking.enabled ? tr('방문자 일정 등록을 켰습니다.', `Visitor booking is on.`) : tr('방문자 일정 등록을 껐습니다.', `Visitor booking is off.`));
+  if (st.booking.enabled && pub.slug) console.log(tr(`  예약 주소: /p/${pub.slug}`, `  booking link: /p/${pub.slug}`));
+}
+
+const DAY_NAMES = ['일', '월', '화', '수', '목', '금', '토'];
+
+/**
+ * BOOKING-GCAL — 구글 캘린더 연결. 연결은 **사람 한 명의 것**이라, 동의 화면은
+ * 브라우저에서 한 번 거쳐야 한다(구글이 그렇게만 허락한다). 그 한 번을 빼면 다 여기서 된다.
+ */
+async function cmdGcal(args) {
+  const sub = args._[0] || 'list';
+  const client = makeClient();
+
+  if (sub === 'list') {
+    const res = await client.googleCalendarConnections();
+    if (args.json) return console.log(JSON.stringify(res, null, 2));
+    if (!res.available) return console.log(tr('이 서버에는 구글 캘린더 연결이 아직 준비되지 않았습니다.', `Google Calendar isn't configured on this server yet.`));
+    if (!res.connections.length) return console.log(tr('연결된 구글 계정이 없습니다. rootr gcal connect 로 시작하세요.', `No Google account connected. Run rootr gcal connect.`));
+    for (const c of res.connections) {
+      console.log(`${c.id}  ${c.email}${c.broken ? tr('  (연결 끊김 — 다시 연결 필요)', `  (disconnected — reconnect)`) : ''}`);
+    }
+    return;
+  }
+
+  if (sub === 'connect') {
+    const { url } = await client.googleCalendarAuthorizeUrl(args.return || '/');
+    if (args.json) return console.log(JSON.stringify({ url }, null, 2));
+    console.log(tr('아래 주소를 브라우저에서 열고 허용해 주세요(구글은 이 한 번을 꼭 사람 손으로 받습니다):', `Open this in a browser and approve (Google requires this one step by hand):`));
+    console.log(url);
+    console.log(tr('\n허용한 뒤 rootr gcal list 로 연결을 확인하세요.', `\nThen run rootr gcal list to see the connection.`));
+    return;
+  }
+
+  if (sub === 'calendars') {
+    const connId = args._[1];
+    if (!connId) throw new Error(usage('rootr gcal calendars <connectionId>'));
+    const res = await client.googleCalendars(connId);
+    if (args.json) return console.log(JSON.stringify(res, null, 2));
+    for (const c of res.calendars) {
+      const marks = [c.primary ? tr('기본', `primary`) : '', c.writable ? tr('쓰기 가능', `writable`) : tr('읽기만', `read-only`)].filter(Boolean).join(', ');
+      console.log(`${c.id}  ${c.name}  (${marks})`);
+    }
+    return;
+  }
+
+  if (sub === 'disconnect') {
+    const connId = args._[1];
+    if (!connId) throw new Error(usage('rootr gcal disconnect <connectionId>'));
+    await client.disconnectGoogleCalendar(connId);
+    console.log(tr('연결을 끊었습니다(구글 쪽 권한도 거뒀습니다).', `Disconnected (access revoked on Google too).`));
+    return;
+  }
+
+  throw new Error(usage('rootr gcal <list|connect|calendars|disconnect>'));
+}
+
 async function cmdReadReq(args) {
   const target = args._[0];
   if (!target) {
@@ -1673,11 +2127,21 @@ async function cmdReadReq(args) {
       tr(` · 마감: ${r.dueAt ?? '없음'}${r.overdue ? ' (지남)' : ''}`, ` · due: ${r.dueAt ?? 'none'}${r.overdue ? ' (overdue)' : ''}`) +
       tr(`${r.requireExplicitAck ? ' · 확인 버튼 필요' : ''}`, `${r.requireExplicitAck ? ' · acknowledge button required' : ''}`),
   );
+  // 표·폴더에 걸었으면 사람마다 "자기가 열 수 있는 문서를 다 읽었나"(completed)가 완료이고, 진도는 그 사람의 readCount/readTotal 이다
+  // — 읽을 수는 사람마다 다르다("본인이 만든 행만" 표). 남의 수를 볼 수 없는 사람에게는 서버가 수를 싣지 않는다(감사 ROUND-15 #4:
+  // 예전엔 모두 같은 childTotal 로 나눠 다 읽은 사람을 "not yet 2/4"로 찍었다).
+  const rollup = r.rollup ?? r.childTotal > 0;
   for (const target of r.targets ?? []) {
-    const mark = target.ackedAt ? tr('확인', `acknowledged`) : target.firstViewedAt ? tr('읽음', `read`) : tr('아직', `not yet`);
-    // 표·폴더에 걸었으면 "안의 문서를 몇 개 읽었나"가 진짜 진도다.
-    const progress =
-      r.childTotal > 0 ? ` ${target.readCount ?? 0}/${r.childTotal}` : '';
+    const mark = rollup
+      ? target.completed
+        ? tr('다 읽음', `done`)
+        : tr('아직', `not yet`)
+      : target.ackedAt
+        ? tr('확인', `acknowledged`)
+        : target.firstViewedAt
+          ? tr('읽음', `read`)
+          : tr('아직', `not yet`);
+    const progress = rollup && target.readTotal !== undefined ? ` ${target.readCount ?? 0}/${target.readTotal}` : '';
     console.log(`  ${mark}${progress}  ${target.name || target.email}`);
   }
 }
@@ -2449,6 +2913,8 @@ async function main() {
       return cmdWrite(args);
     case 'append':
       return cmdAppend(args);
+    case 'embed':
+      return cmdEmbed(args);
     case 'edit':
       return cmdEdit(args);
     case 'search':
@@ -2475,6 +2941,10 @@ async function main() {
       return cmdForm(args);
     case 'publish':
       return cmdPublish(args);
+    case 'booking':
+      return cmdBooking(args);
+    case 'gcal':
+      return cmdGcal(args);
     case 'readreq':
       return cmdReadReq(args);
     case 'access':