rootr-cli 0.8.0 → 0.9.0

package/README.md

@@ -296,14 +296,52 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 
 | 도구 | 설명 |
 |---|---|
-| `rootr_read_database` | 스키마(열 정의)+행 전체 읽기 — **다른 표 도구를 쓰기 전에 먼저** |
-| `rootr_list_rows` | 행만 조회(스키마 제외) |
-| `rootr_add_row` | 행 추가 (`values`는 열 이름 또는 id로 지정) |
-| `rootr_update_row` | 행 수정 (칸반 카드 이동 = select 열 값 변경) |
+| `rootr_read_database` | 스키마(열 정의)+행 전체 읽기 — **다른 표 도구를 쓰기 전에 먼저** (`includeBody: true` 면 행마다 상세 내용까지) |
+| `rootr_list_rows` | 행만 조회(스키마 제외, `includeBody` 지원) |
+| `rootr_add_row` | 행 추가 (`values`는 열 이름 또는 id로 지정, `body`로 상세 내용까지) |
+| `rootr_update_row` | 행 수정 (칸반 카드 이동 = select 열 값 변경, `body`로 상세 내용 교체) |
 | `rootr_delete_row` | 행 삭제 |
 | `rootr_add_column` | **열 추가** — 기존 열·행은 그대로 |
 | `rootr_update_column` | 열 이름 변경 / select 선택지 교체 |
 | `rootr_delete_column` | 열 삭제(파괴적) |
+| `rootr_read_database_permissions` | 표에 걸린 자물쇠 보기 |
+| `rootr_set_database_permissions` | 표 잠그기 — 칸·뷰 잠금 / 본인 행만 / 관리자만 고칠 칸 |
+| `rootr_read_database_notifications` | 표 알림 규칙 보기 |
+| `rootr_set_database_notifications` | 표 알림 규칙 저장 — 누구에게·언제·어떤 것만 |
+| `rootr_list_document_commits` | 공개 문서에 온 변경 제안 목록 |
+| `rootr_merge_document_commit` | 변경 제안 반영(세 벌 병합 — 덮어쓰기 아님) |
+| `rootr_reject_document_commit` | 변경 제안 거절(사유는 제안자에게 전달) |
+| `rootr_read_node_access` | 이 문서·폴더를 누가 볼 수 있는지(공개범위 + 따로 준 권한) |
+| `rootr_set_node_visibility` | 비공개로 잠그기 / 상위 설정 따르기 |
+| `rootr_grant_node_permission` | 한 사람(또는 그룹)에게 READ·WRITE·MANAGE 주기 |
+| `rootr_revoke_node_permission` | 준 권한 거두기 |
+| `rootr_update_form_response` | 이미 들어온 폼 응답 고치기(폼 검사 규칙 다시 통과) |
+| `rootr_delete_form_response` | 폼 응답 한 건 삭제 |
+| `rootr_create_form_collector` | 응답 모을 표·스프레드시트를 **만들어서** 연결(표는 질문 그대로 칸 생성) |
+
+**사람 칸은 여러 명을 담습니다.** 회의 참석자·공동 담당처럼 여럿이 들어가는 자리가
+흔해서, 값은 이름 목록(`["김대표","이팀장"]`)입니다. 이름 하나만 보내도 받아 주고
+목록으로 맞춰 돌려줍니다. 새로 들어온 사람에게만 알림이 갑니다.
+
+**"만들면서 같이 잠그기".** 공개범위는 스캐폴드 트리에서도 노드마다 지정할 수 있습니다 —
+`{ name: "채용", visibility: "PRIVATE", access: [{ subjectId: "<userId>", level: "READ" }] }`.
+폴더는 만들어 주면서 잠그는 건 사람이 따로 해야 하는 상태가 되지 않도록, 한 번에 갑니다.
+명령줄에서는 `rootr access <경로|id> --private`, `--grant <userId> --level READ`,
+`--revoke <userId>` 입니다. (웹에 공개하는 것과는 다릅니다 — 그건 `rootr_set_document_public`.)
+
+응답 모을 곳은 `rootr form collect <폼> --to db|sheet`로 **만들면서** 연결합니다 —
+표로 만들면 폼 질문 그대로 칸이 생기므로, 표를 미리 만들고 칸 이름을 맞출 필요가 없습니다
+(이름이 하나라도 어긋나면 그 칸은 영영 빈 칸으로 남습니다). 스캐폴드 트리에서는 폼 노드에
+`form.collectInto: "database" | "spreadsheet"`로 같은 일을 합니다.
+
+폼 응답은 `rootr form responses <폼> [--latest]`로 보고, `rootr form response-edit <응답id>
+--values '{"필드id":"값"}'`로 고치고, `rootr form response-rm <응답id> --yes`로 지웁니다.
+`--latest`는 같은 사람이 여러 번 낸 것 중 마지막 한 건만 남깁니다(익명 제출은 합치지 않습니다).
+
+행의 **상세 내용(본문 메모)** — 화면에서 칸반 카드를 열면 속성 아래에 적는 그 글 — 은
+`body`로 오갑니다. 실체는 표 밑에 달리는 문서 한 장이고, 없으면 쓸 때 만들어집니다.
+명령줄에서도 됩니다: `rootr db row-add <표> --values '{"제목":"킥오프"}' --body "..."`,
+`rootr db row-body <표> <rowId> --file memo.md`, `rootr db rows <표> --body`.
 
 열은 **한 번에 하나씩** 다룹니다. REST의 `PATCH /databases/:id`는 `properties`
 배열을 통째로 교체하기 때문에, 에이전트가 배열을 다시 만들다 빠뜨린 열이 그대로

package/bin/rootr.js

@@ -19,6 +19,7 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr write <path|id> [--file <f>] [--if-match <etag>]   문서 전체 교체(파일 없으면 생성)
   rootr append <path|id> [<text>] [--heading "## X"] [--file <f>]  문서 끝(또는 헤딩 아래)에 안전하게 추가
   rootr edit <path|id> --find <text> --replace <text> [--all]      본문 내 텍스트 치환
+  rootr comments <path|id> [--block <id>] [--json]  문서에 달린 댓글 읽기 (공개 페이지 댓글 포함)
   rootr search <query>                             워크스페이스 검색
   rootr mv <path|id> <새 경로|폴더 id>              문서/폴더 이동 및/또는 이름 변경
   rootr rm <path|id> [--yes]                       문서/폴더를 휴지통으로 이동 (복구 가능)
@@ -27,6 +28,19 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr use <id|이름|주소>                          활성 워크스페이스 전환 (그 워크스페이스용 키도 기억)
   rootr ask <question> [--workspace <w>]           GraphRAG 질의응답 (RCA), 인용 포함 출력
   rootr db create [--file <spec.json>] [--parent <path|id>]  표(DATABASE) 생성 — 컬럼 순서 그대로, 행까지 한 번에
+  rootr db rows <path|id> [--body] [--json]        표의 행 목록 (--body: 상세 내용까지)
+  rootr db lock <path|id> [--schema managers] [--rows own] [--locked "승인,점수"]  표 자물쇠 보기·걸기
+  rootr db notify <path|id> [--file rules.json] [--clear]  표 알림 규칙 보기·저장
+  rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  행 추가(상세 내용 포함)
+  rootr db row-body <path|id> <rowId> [--file <f>] 행의 상세 내용(본문 메모) 쓰기 — 없으면 표준입력
+  rootr access <path|id> [--json]                  공개범위·권한 보기 (관리 권한 필요)
+  rootr access <path|id> --private|--public|--inherit   공개범위 바꾸기
+  rootr access <path|id> --grant <userId> --level READ|WRITE|MANAGE   사람에게 권한 주기
+  rootr access <path|id> --revoke <userId>          준 권한 거두기
+  rootr form collect <path|id> --to db|sheet             응답 모을 곳을 새로 만들어 연결 (표는 질문 그대로 칸 생성)
+  rootr form responses <path|id> [--latest] [--json]  폼에 들어온 응답 보기 (--latest: 사람마다 최신 1건만)
+  rootr form response-edit <응답id> --values '<json>'  이미 낸 응답 고치기 (폼 검사 규칙 다시 통과)
+  rootr form response-rm <응답id> [--yes]           응답 한 건 삭제 (되돌릴 수 없음)
   rootr config [--api-key <k>] [--workspace <w>] [--base-url <u>]  설정 조회/저장
   rootr config --add-key <k> [--label <name>] [--workspace <w>]     워크스페이스별 키 추가 등록
   rootr mcp                                        MCP stdio 서버 구동 (도구 90종+ — README 참고)
@@ -112,6 +126,41 @@ async function cmdLs(args) {
   }
 }
 
+/**
+ * `rootr comments <path|id>` — 그 문서에 달린 댓글을 읽는다.
+ *
+ * 2026-08-23 창업자 확인 요청: "댓글 써진 거 mcp/api/cli로 읽어올 수 있는 거 맞는지."
+ * API와 MCP에는 있었고 CLI에만 없었다. 공개 페이지에 달린 댓글도 같은 곳에 쌓이므로
+ * 여기서 함께 나온다.
+ */
+async function cmdComments(args) {
+  const target = args._[0];
+  if (!target) throw new Error('사용법: rootr comments <path|id> [--block <blockId>] [--json]');
+
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+  const threads = await client.listComments(id, { blockId: args.block });
+
+  if (args.json) {
+    console.log(JSON.stringify(threads, null, 2));
+    return;
+  }
+  if (!threads.length) {
+    console.log('댓글이 없습니다.');
+    return;
+  }
+  for (const t of threads) {
+    const when = String(t.createdAt ?? '').slice(0, 16).replace('T', ' ');
+    console.log(`- ${t.author?.name ?? '(알 수 없음)'} · ${when}`);
+    console.log(`  ${String(t.body ?? '').replace(/\n/g, '\n  ')}`);
+    for (const r of t.replies ?? []) {
+      const rWhen = String(r.createdAt ?? '').slice(0, 16).replace('T', ' ');
+      console.log(`    ↳ ${r.author?.name ?? '(알 수 없음)'} · ${rWhen}`);
+      console.log(`      ${String(r.body ?? '').replace(/\n/g, '\n      ')}`);
+    }
+  }
+}
+
 async function cmdRead(args) {
   const target = args._[0];
   if (!target) throw new Error('사용법: rootr read <path|id> [--json]');
@@ -442,10 +491,167 @@ async function cmdMcp() {
  * 컬럼을 하나씩 붙이는 방식은 호출 순서가 곧 컬럼 순서가 되어 옮겨온 표가 뒤죽박죽이
  * 됐다 — 그래서 CLI도 "한 번에" 쪽만 제공한다.
  */
+/**
+ * `rootr access <path|id> [--private|--public|--inherit] [--grant <id> --level …] [--revoke <id>]`
+ *
+ * 화면의 "공개범위"·"권한" 창을 터미널에서. 인자 없이 부르면 지금 상태를 보여 준다.
+ * 관리 권한이 없으면 서버가 막는다(보기도 안 된다).
+ */
+async function cmdAccess(args) {
+  const target = args._[0];
+  if (!target) {
+    throw new Error(
+      '사용법: rootr access <path|id> [--private|--public|--inherit] [--grant <userId> --level READ|WRITE|MANAGE] [--revoke <userId>]',
+    );
+  }
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+  const group = args.group ? 'GROUP' : 'USER';
+
+  let changed = false;
+  if (args.private || args.public || args.inherit) {
+    const visibility = args.private ? 'PRIVATE' : args.public ? 'PUBLIC' : null;
+    await client.setNodeVisibility(id, visibility);
+    console.log(
+      `공개범위: ${visibility === 'PRIVATE' ? '비공개(만든 사람·관리자·따로 준 사람만)' : visibility === 'PUBLIC' ? '워크스페이스 전체' : '상위 폴더/워크스페이스 기본값을 따름'}`,
+    );
+    changed = true;
+  }
+  if (typeof args.grant === 'string') {
+    const level = String(args.level || '').toUpperCase();
+    if (!['READ', 'WRITE', 'MANAGE'].includes(level)) {
+      throw new Error('--grant 에는 --level READ|WRITE|MANAGE 를 함께 주세요.');
+    }
+    await client.grantNodePermission(id, { subjectType: group, subjectId: args.grant, level });
+    console.log(`권한 부여: ${args.grant} → ${level}`);
+    changed = true;
+  }
+  if (typeof args.revoke === 'string') {
+    await client.revokeNodePermission(id, { subjectType: group, subjectId: args.revoke });
+    console.log(`권한 회수: ${args.revoke}`);
+    changed = true;
+  }
+
+  const info = await client.getNodeAccess(id);
+  if (args.json) {
+    console.log(JSON.stringify(info, null, 2));
+    return;
+  }
+  if (!changed) {
+    const eff = info.effectiveVisibility ?? info.visibility;
+    console.log(`공개범위: ${eff === 'PRIVATE' ? '비공개' : '워크스페이스 전체'}${info.visibility === null ? ' (상속받음)' : ''}`);
+  }
+  const direct = info.direct ?? [];
+  console.log(`따로 준 권한: ${direct.length ? '' : '없음'}`);
+  for (const p of direct) console.log(`  - ${p.subjectType} ${p.subjectId} → ${p.level}`);
+}
+
+/**
+ * `rootr form responses|response-edit|response-rm`
+ *
+ * 폼에 들어온 응답을 터미널에서 보고 고치고 지운다. 화면에서만 되면
+ * 에이전트에게는 없는 기능이라 여기까지 열어 둔다.
+ */
+async function cmdForm(args) {
+  const sub = args._[0];
+  if (sub === 'collect') return cmdFormCollect(args);
+  if (sub === 'responses') return cmdFormResponses(args);
+  if (sub === 'response-edit') return cmdFormResponseEdit(args);
+  if (sub === 'response-rm') return cmdFormResponseRm(args);
+  throw new Error('사용법: rootr form collect|responses|response-edit|response-rm … (자세한 건 rootr --help)');
+}
+
+/**
+ * `rootr form collect <path|id> --to db|sheet`
+ *
+ * 응답 모을 곳을 새로 만들어 연결한다. 표로 만들면 폼 질문 그대로 칸이 생기므로,
+ * 표를 미리 만들고 칸 이름을 하나하나 맞출 필요가 없다.
+ */
+async function cmdFormCollect(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr form collect <path|id> --to db|sheet');
+  const to = String(args.to || '').toLowerCase();
+  const map = { db: 'database', database: 'database', sheet: 'spreadsheet', spreadsheet: 'spreadsheet' };
+  if (!map[to]) throw new Error('--to 에 db 또는 sheet 를 주세요.');
+
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+  const made = await client.createFormCollector(id, map[to]);
+  if (args.json) {
+    console.log(JSON.stringify(made, null, 2));
+    return;
+  }
+  console.log(
+    made.kind === 'database'
+      ? `표를 만들어 연결했습니다: ${made.nodeId}  (폼 질문 그대로 칸이 생겼습니다)`
+      : `스프레드시트를 만들어 연결했습니다: ${made.nodeId}`,
+  );
+}
+
+async function cmdFormResponses(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr form responses <path|id> [--latest] [--json]');
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+  const rows = await client.listFormResponses(id, { latestPerRespondent: Boolean(args.latest) });
+
+  if (args.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (!rows.length) {
+    console.log('아직 들어온 응답이 없습니다.');
+    return;
+  }
+  console.log(`응답 ${rows.length}건${args.latest ? ' (사람마다 최신 1건만)' : ''}`);
+  for (const r of rows) {
+    const who = r.submitterUserId ? r.submitterUserId : '익명';
+    console.log(`- ${r.id}  ${new Date(r.createdAt).toISOString()}  제출자:${who}`);
+    console.log(`  ${JSON.stringify(r.values)}`);
+  }
+}
+
+async function cmdFormResponseEdit(args) {
+  const responseId = args._[1];
+  if (!responseId) throw new Error("사용법: rootr form response-edit <응답id> --values '<json>'");
+  const raw = typeof args.values === 'string' ? args.values : await readStdin();
+  let values;
+  try {
+    values = JSON.parse(raw);
+  } catch {
+    throw new Error('--values 를 JSON으로 읽을 수 없습니다. {"필드id":"값"} 형태여야 합니다.');
+  }
+  // 통째로 바뀐다 — 남기고 싶은 답도 같이 보내야 한다.
+  const result = await makeClient().updateFormResponse(responseId, values);
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`응답 수정됨: ${result.id ?? responseId}`);
+  console.log(`  ${JSON.stringify(result.values ?? values)}`);
+}
+
+async function cmdFormResponseRm(args) {
+  const responseId = args._[1];
+  if (!responseId) throw new Error('사용법: rootr form response-rm <응답id> [--yes]');
+  if (!args.yes) {
+    throw new Error('응답 삭제는 되돌릴 수 없습니다. 정말 지우려면 --yes 를 붙이세요.');
+  }
+  await makeClient().deleteFormResponse(responseId);
+  console.log(`응답 삭제됨: ${responseId}`);
+}
+
 async function cmdDb(args) {
   const sub = args._[0];
+  if (sub === 'rows') return cmdDbRows(args);
+  if (sub === 'row-add') return cmdDbRowAdd(args);
+  if (sub === 'row-body') return cmdDbRowBody(args);
+  if (sub === 'lock') return cmdDbLock(args);
+  if (sub === 'notify') return cmdDbNotify(args);
   if (sub !== 'create') {
-    throw new Error('사용법: rootr db create [--file <spec.json>] [--parent <path|id>] [--ws <id>]');
+    throw new Error(
+      '사용법: rootr db create|rows|row-add|row-body|lock|notify … (자세한 건 rootr --help)',
+    );
   }
   const raw = typeof args.file === 'string' ? readFileSync(args.file, 'utf8') : await readStdin();
   let spec;
@@ -472,6 +678,168 @@ async function cmdDb(args) {
   if (cols) console.log(`컬럼 순서: ${cols}`);
   if (typeof db.rowCount === 'number') console.log(`행: ${db.rowCount}개`);
 }
+
+/** 표의 행 목록. --body 를 주면 행마다 상세 내용(본문 메모)까지 가져온다. */
+/**
+ * `rootr db lock <path|id> [--schema managers|open] [--rows own|all] [--locked <칸,칸>]`
+ *
+ * 표에 거는 자물쇠 — 노션에 없는 것이다. 인자 없이 부르면 지금 상태를 보여 준다.
+ */
+async function cmdDbLock(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db lock <path|id> [--schema managers|open] [--rows own|all] [--locked "승인,점수"]');
+
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+
+  const patch = {};
+  if (args.schema !== undefined) patch.schemaLock = args.schema;
+  if (args.rows !== undefined) patch.rowScope = args.rows;
+  if (args.locked !== undefined) {
+    patch.lockedProps = String(args.locked)
+      .split(',')
+      .map((x) => x.trim())
+      .filter(Boolean);
+  }
+
+  const result = Object.keys(patch).length
+    ? await client.setDatabasePermissions(id, patch)
+    : await client.getDatabasePermissions(id);
+
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`칸·뷰 잠금: ${result.schemaLock === 'managers' ? '관리자만' : '누구나'}`);
+  console.log(`행 보기   : ${result.rowScope === 'own' ? '본인이 만든 행만' : '전부'}`);
+  console.log(`잠긴 칸   : ${(result.lockedProps ?? []).length ? result.lockedProps.join(', ') : '없음'}`);
+}
+
+/**
+ * `rootr db notify <path|id> [--file rules.json]`
+ *
+ * 표에 무슨 일이 생기면 누구에게 알릴지. 파일 없이 부르면 지금 규칙을 보여 준다.
+ * 규칙 모양: [{ "userIds": ["…"], "events": ["created"], "filter": {"propId":"p1","op":"is","value":"긴급"} }]
+ */
+async function cmdDbNotify(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db notify <path|id> [--file rules.json] [--clear] [--json]');
+
+  const client = makeClient();
+  const id = requireResolved(await resolveTarget(client, target));
+
+  if (args.clear) {
+    const cleared = await client.setDatabaseNotifications(id, []);
+    console.log('알림 규칙을 모두 지웠습니다.');
+    if (args.json) console.log(JSON.stringify(cleared, null, 2));
+    return;
+  }
+  if (args.file) {
+    const raw = readFileSync(args.file, 'utf8');
+    const saved = await client.setDatabaseNotifications(id, JSON.parse(raw));
+    console.log(`알림 규칙 ${saved.watchers.length}개를 저장했습니다.`);
+    if (args.json) console.log(JSON.stringify(saved, null, 2));
+    return;
+  }
+
+  const { watchers } = await client.getDatabaseNotifications(id);
+  if (args.json) {
+    console.log(JSON.stringify(watchers, null, 2));
+    return;
+  }
+  if (!watchers.length) {
+    console.log('알림 규칙이 없습니다.');
+    return;
+  }
+  const WHEN = { created: '행 추가', updated: '행 수정', deleted: '행 삭제' };
+  for (const w of watchers) {
+    const when = (w.events ?? []).map((e) => WHEN[e] ?? e).join(' · ');
+    const f = w.filter;
+    const only = f
+      ? f.op === 'changed'
+        ? ` (${f.propId} 칸이 바뀌었을 때만)`
+        : ` (${f.propId} ${f.op === 'is' ? '=' : '⊃'} ${f.value})`
+      : '';
+    console.log(`- ${when}${only} → ${(w.userIds ?? []).length}명`);
+  }
+}
+
+async function cmdDbRows(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db rows <path|id> [--body] [--json]');
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const rows = await client.listRows(id, { withBody: !!args.body });
+  if (args.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  for (const row of rows) {
+    const values = Object.values(row.values || {})
+      .map((v) => (v && typeof v === 'object' ? JSON.stringify(v) : String(v)))
+      .join(' | ');
+    console.log(`${row.id}\t${values}`);
+    if (args.body && row.body) {
+      for (const line of String(row.body).trimEnd().split('\n')) console.log(`    ${line}`);
+    }
+  }
+}
+
+/** 행 추가. 값은 JSON으로, 상세 내용(본문 메모)은 --body / --body-file 로. */
+async function cmdDbRowAdd(args) {
+  const target = args._[1];
+  if (!target || typeof args.values !== 'string') {
+    throw new Error("사용법: rootr db row-add <path|id> --values '{\"제목\":\"...\"}' [--body <md>|--body-file <f>]");
+  }
+  let values;
+  try {
+    values = JSON.parse(args.values);
+  } catch {
+    throw new Error('--values 는 JSON이어야 합니다. 예: --values \'{"제목":"킥오프"}\'');
+  }
+  const body =
+    typeof args['body-file'] === 'string'
+      ? readFileSync(args['body-file'], 'utf8')
+      : typeof args.body === 'string'
+        ? args.body
+        : undefined;
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const row = await client.createRow(id, { values, body });
+  console.log(`행 추가: ${row.id}`);
+  if (row.pageNodeId) console.log(`상세 내용 문서: ${row.pageNodeId}`);
+}
+
+/** 행의 상세 내용(본문 메모)을 통째로 쓴다. 내용은 인자·--file·표준입력 순으로 받는다. */
+async function cmdDbRowBody(args) {
+  const target = args._[1];
+  const rowId = args._[2];
+  if (!target || !rowId) {
+    throw new Error('사용법: rootr db row-body <path|id> <rowId> [<본문>] [--file <f>]');
+  }
+  const body =
+    typeof args.file === 'string'
+      ? readFileSync(args.file, 'utf8')
+      : args._[3] !== undefined
+        ? String(args._[3])
+        : await readStdin();
+  if (!body) throw new Error('쓸 내용이 없습니다 (본문 인자, --file, 또는 표준입력 필요).');
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const row = await client.updateRow(id, rowId, { body });
+  console.log(`상세 내용 저장: 행 ${rowId}${row.pageNodeId ? ` → 문서 ${row.pageNodeId}` : ''}`);
+}
+
+/** 경로로 줘도 되게 — 표 인자도 문서 도구들과 같은 규칙을 따른다. */
+async function resolveDatabaseId(client, target) {
+  if (typeof target === 'string' && target.startsWith('/')) {
+    const resolved = await resolveTarget(client, target);
+    if (!resolved.existed) throw new Error(`표를 찾을 수 없습니다: ${target}`);
+    return resolved.id;
+  }
+  return target;
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   const args = parseArgs(argv);
@@ -489,6 +857,8 @@ async function main() {
   switch (cmd) {
     case 'ls':
       return cmdLs(args);
+    case 'comments':
+      return cmdComments(args);
     case 'read':
       return cmdRead(args);
     case 'write':
@@ -515,6 +885,10 @@ async function main() {
       return cmdUse(args);
     case 'db':
       return cmdDb(args);
+    case 'form':
+      return cmdForm(args);
+    case 'access':
+      return cmdAccess(args);
     case 'mcp':
       return cmdMcp(args);
     default: