rootr-cli 0.14.0 → 0.16.0

package/README.md

@@ -6,7 +6,7 @@ Rootr(마크다운 지식협업 SaaS) 공식 CLI + MCP 서버. 에이전트나
 - `rootr` CLI: `ls`, `read`, `write`, `append`, `edit`, `search`, `rm`, `attach`, `ws`, `ask`, `config`
 - `rootr mcp`: stdio 기반 MCP 서버 (Claude Code / Claude Desktop 등에 등록해서 사용), 도구 90종+
   — 문서·워크스페이스/스캐폴딩·LOG 데이터스토어·RCA ask·이슈·웹훅·첨부파일에 더해
-  스프레드시트/화이트보드/폼/프레젠테이션/녹음/CRM/데이터베이스까지. 정확한 목록은 MCP `tools/list`로 확인하세요.
+  스프레드시트/화이트보드/폼/프레젠테이션/페이지/녹음/CRM/데이터베이스까지. 정확한 목록은 MCP `tools/list`로 확인하세요.
 
 순수 Node.js ESM, 빌드 과정 없음. Node 18 이상 필요(내장 `fetch` 사용).
 
@@ -147,8 +147,11 @@ rootr rm /notes/todo.md          # 확인 후 삭제
 rootr rm /notes/todo.md --yes    # 확인 없이 (스크립트용)
 ```
 
-휴지통으로 옮기는 **복구 가능한** 삭제입니다. 앱의 휴지통에서 되돌릴 수 있고,
-30일이 지나면 자동으로 완전 삭제됩니다. `--yes` 없이 실행하면 확인을 묻습니다
+휴지통으로 옮기는 **복구 가능한** 삭제입니다. 30일이 지나면 자동으로 완전 삭제됩니다.
+되돌리려면 `rootr restore <id>` — 화면에서 Ctrl+Z 를 누르는 것과 같은 일입니다.
+**경로가 아니라 id** 입니다(휴지통에 든 것은 이미 트리에 없어 경로로는 못 찾습니다).
+`rootr rm` 이 마지막 줄에 그 id 를 찍어 주니 그대로 쓰면 됩니다. MCP 로는
+`rootr_restore_node`. `--yes` 없이 실행하면 확인을 묻습니다
 (파이프/CI처럼 입력이 없는 환경에서는 "아니오"로 처리되어 안전합니다).
 `docs:write` 스코프가 필요합니다.
 
@@ -275,6 +278,22 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 워크스페이스의 지식그래프(GraphRAG)에 질문하고 답변 본문 + 인용(문서 경로: 인용문)을 출력합니다.
 `ask` 스코프가 필요합니다. `--workspace`를 생략하면 설정된 기본 워크스페이스를 사용합니다.
 
+### 팀의 기억 (memory)
+
+```bash
+rootr memory                                     # 전체 회상 (상태·id·종류·출처)
+rootr memory --query 세미나 --kind 지시          # 걸러서 보기
+rootr memory add "보고 시각은 KST로만 표기한다" --kind 지시 --source /규칙.md
+rootr memory edit <id> --content "고친 문장"     # 그 기억만 고치기(준 칸만 바뀜)
+rootr memory edit <id> --kind 참고               # 종류만 고치기
+rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
+```
+
+세션이 끝나도 남는, 워크스페이스 전체가 공유하는 한 줄 사실입니다. MCP의
+`rootr_remember`/`rootr_recall`/`rootr_forget`과 같은 길을 터미널에서 쓰는
+명령이고, 화면의 "기억" 메뉴와도 같은 데이터를 봅니다. **긴 건 문서로, 한 줄은
+기억으로** — 자세한 규칙은 MCP 도구 설명을 참고하세요.
+
 ## MCP 서버로 사용하기
 
 `rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 152종:
@@ -378,8 +397,8 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_bulk_update_rows_each` | 여러 행을 **행마다 다른 값**으로 한 번에 수정 |
 | `rootr_delete_row` | 행 삭제 |
 | `rootr_bulk_delete_rows` | 행 여러 개를 한 번에 삭제 |
-| `rootr_create_view` | 보기 추가 — 테이블/보드/캘린더/타임라인/갤러리 |
-| `rootr_update_view` | 보기 수정 — 열 숨기기·이름·그룹·필터·정렬·열 너비 |
+| `rootr_create_view` | 보기 추가 — 테이블/보드/캘린더/타임라인/갤러리 (달력은 `calendarScale`로 주·달·해) |
+| `rootr_update_view` | 보기 수정 — 열 숨기기·이름·그룹·필터·정렬·열 너비·달력 단위(`calendarScale`) |
 | `rootr_delete_view` | 보기 삭제 |
 | `rootr_create_row_page` | 행에 상세 페이지 붙이기(문서 또는 서명문서) |
 | `rootr_set_row_page_type` | 앞으로 만드는 행이 무엇으로 열릴지 정하기 |
@@ -391,6 +410,9 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_set_database_permissions` | 표 잠그기 — 칸·뷰 잠금 / 본인 행만 / 관리자만 고칠 칸 |
 | `rootr_read_database_notifications` | 표 알림 규칙 보기 |
 | `rootr_set_database_notifications` | 표 알림 규칙 저장 — 누구에게·언제·어떤 것만 |
+| `rootr_list_database_buttons` | 표 위 **버튼** 목록 보기(고칠 수 있는지 `myLevel`도 함께) |
+| `rootr_set_database_buttons` | 버튼 만들고 고치기 — **목록 통째로 교체**(남길 것도 같이 보내야 함) |
+| `rootr_run_database_button` | 버튼 누르기 — 행 만들기·값 채우기·AI로 칸 채우기가 순서대로 |
 | `rootr_list_document_commits` | 공개 문서에 온 변경 제안 목록 |
 | `rootr_merge_document_commit` | 변경 제안 반영(세 벌 병합 — 덮어쓰기 아님) |
 | `rootr_reject_document_commit` | 변경 제안 거절(사유는 제안자에게 전달) |
@@ -402,6 +424,35 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_delete_form_response` | 폼 응답 한 건 삭제 |
 | `rootr_create_form_collector` | 응답 모을 표·스프레드시트를 **만들어서** 연결(표는 질문 그대로 칸 생성) |
 
+**표 버튼 — 매번 하는 준비 동작을 한 번에.** 새 건이 생길 때마다 상태=접수, 담당=나,
+마감=오늘+7 을 손으로 다시 채우는 일을 버튼 하나로 만듭니다. 단계는 **적힌 순서대로**
+돌고 **앞 단계가 만든 행을 뒤 단계가 받으므로**, "행을 만들고 → 그 행의 요약을 AI가 쓰고
+→ 그 행을 연다"가 한 번 누름으로 끝납니다. 값에는 `@today` · `@today+7` · `@me` 를 쓸 수
+있고 누르는 그 시점에 채워집니다. 버튼은 권한을 늘리지 않습니다 — **누른 사람 권한 그대로**
+돕니다(만들기·고치기는 관리자, 누르기는 편집 권한).
+
+```bash
+rootr db buttons <표>                      # 지금 달린 버튼 보기
+rootr db buttons <표> --file buttons.json  # 목록 통째로 저장(남길 것도 같이)
+rootr db button-run <표> <버튼id>           # 한 번 누르기 (--rows id,id 로 고른 행 지정)
+rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해 중에서
+```
+
+```json
+[{ "label": "접수", "icon": "📥", "steps": [
+    { "kind": "add_row", "values": { "상태": "접수", "담당": "@me", "마감": "@today+7" } },
+    { "kind": "ai_fill", "target": "created", "propId": "요약", "prompt": "{제목}을 한 문장으로 요약해." },
+    { "kind": "open_row" }
+] }]
+```
+
+스캐폴드로 표를 지을 때도 `database.buttons` 에 같은 모양을 넣으면 **표와 함께** 달립니다.
+
+**행에 댓글 달기.** 표의 한 행에 댓글을 달려면 `rootr_comment_document` 에 **표**를
+`target` 으로, **행 id**를 `blockId` 으로 줍니다(읽기는 `rootr_list_document_comments`,
+명령줄은 `rootr comments <표> --block <행id>`). 상세 문서가 없는 행에도 달립니다.
+`@[userId]` 로 사람을 부르면 알림이 가고, 그 알림은 **그 행**을 열면서 댓글을 짚어 줍니다.
+
 **사람 칸은 여러 명을 담습니다.** 회의 참석자·공동 담당처럼 여럿이 들어가는 자리가
 흔해서, 값은 이름 목록(`["김대표","이팀장"]`)입니다. 이름 하나만 보내도 받아 주고
 목록으로 맞춰 돌려줍니다. 새로 들어온 사람에게만 알림이 갑니다.
@@ -527,6 +578,28 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_save_as_template` | 지금 노드를(또는 즉석 정의를) 템플릿으로 저장 |
 | `rootr_update_template` | 템플릿 수정 |
 
+#### 기억 (docs:read / docs:write)
+
+| 도구 | 설명 |
+|---|---|
+| `rootr_remember` | 한 줄 사실을 기억시키기(같은 내용이면 갈아끼움). `memoryId`를 함께 주면 그 기억을 그 자리에서 고치기 |
+| `rootr_recall` | 이 워크스페이스가 아는 것 꺼내 오기 |
+| `rootr_forget` | 더 이상 맞지 않는 기억 폐기 |
+
+**에이전트에게**: 이건 세션이 끝나도 남는, **워크스페이스 전체가 공유하는** 기억입니다
+(개인 메모는 여기 두지 말고 자기 메모리에 두세요). **긴 건 문서로, 한 줄은
+기억으로, 그리고 기억은 반드시 문서를 가리키게** 하세요 — 이야기를 기억에 밀어
+넣으면 기억이 "짧은 문서 더미"가 되면서 둘 다 망합니다. 규칙·결정한 이유·한 번
+겪은 함정을 남기고, 그 근거가 된 문서 경로를 `source`로 같이 주세요(그래야 그
+문서가 바뀔 때 루터가 "확인 필요" 표시를 답니다).
+
+기억은 워크스페이스를 처음 만질 때 **도구 응답에 자동으로 딸려옵니다** — 굳이
+`rootr_recall`을 먼저 부르지 않아도 눈앞에 놓입니다. 이 자동 회상은 무료 조회
+한도를 쓰지 않습니다.
+
+사람이 직접 보고 고치려면 워크스페이스 왼쪽 메뉴의 **기억**에서 볼 수 있고,
+"표로 열기"를 누르면 평범한 표로 열려 권한·기록이 그대로 따라옵니다.
+
 #### 제보 (인증 불필요)
 
 | 도구 | 설명 |
@@ -585,6 +658,44 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_update_node` | 아무 노드나 이름·아이콘 변경 / 옮기기 |
 | `rootr_delete_node` | 노드를 휴지통으로 이동(복구 가능) |
 
+#### 페이지 (웹페이지)
+
+페이지(PAGE)는 **바깥 사람이 볼 화면**입니다 — 행사 안내·제품 소개·신청 받기처럼
+링크 하나로 보여 줄 것. 전용 MCP 도구(`rootr_create_page`, `rootr_read_page`,
+`rootr_append_page_blocks`, `rootr_update_page`, `rootr_update_page_block`,
+`rootr_read_page_live_data`)로 저작합니다.
+
+HTML을 짜는 것이 아니라 **정해진 블록 14종을 골라 쌓습니다** — `hero` `text`
+`features` `gallery` `pricing` `testimonials` `faq` `timeline` `cta` `footer` +
+표에서 값을 끌어오는 `liveStats` `liveTable` `liveChart` + 신청을 받는 `form` + 자유 블록 `custom`.
+
+`custom`은 **격리된 방**입니다: HTML/CSS를 마음대로 쓰되 `sandbox` 아이프레임 안에서만
+그려집니다(스크립트 없음·같은 출처 아님·바깥 통신 차단). 그래서 대담한 CSS도 바깥 화면을
+못 덮습니다 — 저장할 때 `<script>`와 `on*=`는 지워집니다. 방 안에서는 페이지 분위기 색을
+`var(--pg-text)` `var(--pg-card)` `var(--pg-accent)` 처럼 쓸 수 있습니다.
+블록별 props는 **`/llms.txt`의 "Pages" 섹션**에 표로 정리돼 있습니다.
+
+```bash
+# 페이지 만들기 (블록을 생략하면 hero/text/footer 뼈대로 시작)
+curl -X POST "$BASE/workspaces/$WS/pages" -H "x-api-key: $KEY" \
+  -H 'Content-Type: application/json' \
+  -d '{"name":"가을 행사","config":{"theme":"midnight"},
+       "blocks":[{"type":"hero","props":{"title":"가을 개발자 밋업","subtitle":"10월 12일 · 서울"}}]}'
+
+# 블록 덧붙이기(있는 블록은 그대로) / 통째 교체 / 라이브 값 확인
+curl -X POST  "$BASE/pages/$ID/blocks" -d '{"blocks":[{"type":"faq","props":{"items":[...]}}]}' ...
+curl -X PATCH "$BASE/pages/$ID"        -d '{"config":{"theme":"warm"}}' ...
+curl        "$BASE/pages/$ID/live-data" -H "x-api-key: $KEY"
+```
+
+`liveStats`/`liveTable`/`liveChart`의 `source.nodeId`는 같은 워크스페이스의
+DATABASE·LOG 노드이고, 칸은 **이름**으로 가리킵니다(칸 id가 아닙니다).
+`form` 블록의 `formNodeId`에 폼 노드를 걸면 방문자가 **그 자리에서 신청**합니다 —
+폼을 따로 공개할 필요가 없습니다. 비공개(PRIVATE) 서브트리에 있는 표·폼은 공개
+페이지에서 조용히 빠집니다(일부러 그렇습니다).
+
+공개는 여느 노드와 같습니다: `POST /v1/nodes/:id/publish` → `rootr.io/p/{slug}`.
+
 #### 프레젠테이션
 
 프레젠테이션(PRESENTATION)은 전용 MCP 도구(`rootr_create_presentation`,

package/bin/rootr.js

@@ -23,6 +23,7 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr search <query>                             워크스페이스 검색
   rootr mv <path|id> <새 경로|폴더 id>              문서/폴더 이동 및/또는 이름 변경
   rootr rm <path|id> [--yes]                       문서/폴더를 휴지통으로 이동 (복구 가능)
+  rootr restore <id>                               지운 것 되돌리기 (화면의 Ctrl+Z 와 같은 일 — 경로 아닌 id)
   rootr attach <file> [--doc <path|id>] [--heading "## X"] [--alt <text>]  파일 업로드(+문서에 삽입)
   rootr ws                                         내 워크스페이스 목록 (id\tname, 열 수 없는 곳은 표시)
   rootr use <id|이름|주소>                          활성 워크스페이스 전환 (그 워크스페이스용 키도 기억)
@@ -31,6 +32,9 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr db rows <path|id> [--body] [--backlinks] [--json]        표의 행 목록 (--body: 상세 내용까지, --backlinks: 나를 가리키는 다른 표의 행까지)
   rootr db lock <path|id> [--schema managers] [--rows own] [--locked "승인,점수"]  표 자물쇠 보기·걸기
   rootr db notify <path|id> [--file rules.json] [--clear]  표 알림 규칙 보기·저장
+  rootr db buttons <path|id> [--file buttons.json] [--clear]  표 위 "누르면 일하는 버튼" 보기·저장
+  rootr db button-run <path|id> <buttonId> [--rows id,id]     버튼 한 번 누르기 (행 만들기·값 채우기·AI 채우기)
+  rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름]  뷰 목록·달력 주/달/해 단위
   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 <파일>   여러 행 한 번에 넣기 (하나라도 틀리면 전부 취소)
@@ -45,6 +49,7 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr publish <path|id> --off                    공개 닫기 (딸려 나간 하위도 같이 닫힘)
   rootr publish <path|id> --status                 지금 공개인지·주소·하위 포함 여부
   rootr publish <표> --layout board --skin paper   공개한 표를 무슨 꼴로 보일지 (배치 9종 × 분위기 6종)
+  rootr publish <문서> --comments [false] [--expires <ISO>] [--skin <분위기>]  문서 전용 — 댓글(편집 제안)·만료일·스킨 16종
   rootr readreq <path|id> [--json]                 읽음 확인 현황 — 누가 읽었나·완료율
   rootr readreq <path|id> --users <id,id> [--due <ISO>] [--ack]  읽어야 할 사람 지정(명단 통째로 교체)
   rootr readreq <path|id> --clear                  읽음 확인 해제
@@ -82,6 +87,10 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr scaffold apply --file tree.json [--root /경로]  짓기 3단계 — 실제로 만들기(검사 결과도 같이 나옴)
   rootr scaffold built [--root /경로] [--json]      짓고 나서 — 실제로 만들어진 것의 **모양**을 검사
   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 서버 구동 (도구 151종 — README 참고)
   rootr --help                                     도움말
   rootr --version                                  버전 출력
@@ -349,7 +358,32 @@ async function cmdRm(args) {
 
   await client.deleteNode(id);
   console.log(`휴지통으로 옮겼습니다: ${resolved.path || id}`);
-  console.log('복구하려면 앱의 휴지통에서 되돌리세요 (30일 뒤 자동 삭제).');
+  // 되돌리려면 id 가 있어야 한다 — 휴지통에 든 것은 경로로는 못 찾는다.
+  console.log(`되돌리려면: rootr restore ${id}   (30일 뒤 자동 삭제)`);
+}
+
+/**
+ * UNDO-DELETE — `rootr restore <id>`
+ *
+ * 지운 것을 제자리로 되살린다. 화면의 Ctrl+Z 와 같은 일이다.
+ * **경로가 아니라 id** 다 — 휴지통에 든 것은 이미 트리에 없어서 경로로는 못 찾는다.
+ * `rootr rm` 이 마지막 줄에 그 id 를 찍어 준다.
+ */
+async function cmdRestore(args) {
+  const id = args._[0];
+  if (!id) {
+    throw new Error(
+      '사용법: rootr restore <id>\n' +
+        '  (경로가 아니라 id 입니다 — 휴지통에 든 것은 경로로 못 찾습니다. rootr rm 이 찍어 준 id 를 쓰세요.)',
+    );
+  }
+  const client = makeClient();
+  const node = await client.restoreNode(id);
+  if (args.json) {
+    console.log(JSON.stringify(node, null, 2));
+    return;
+  }
+  console.log(`되돌렸습니다: ${node.path ?? node.name ?? id}`);
 }
 
 /** Minimal y/N prompt. Non-interactive stdin (pipes, CI) answers "no". */
@@ -567,6 +601,93 @@ async function cmdMcp() {
   await startMcpServer({ name: 'rootr', version: pkg.version });
 }
 
+// ---- memory (MEM-001) ---------------------------------------------------
+//
+// 팀의 기억 — 저장·회상·고치기·잊기. MCP의 rootr_remember/recall/forget과 같은 길을
+// 터미널에서도 쓸 수 있게. 고치기(edit)는 2026-09-01에 붙었다.
+
+const MEMORY_KINDS = ['지시', '사람', '프로젝트', '참고'];
+
+function parseRelated(val) {
+  if (!val) return undefined;
+  if (Array.isArray(val)) return val;
+  return String(val)
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+async function cmdMemory(args) {
+  const sub = args._.shift();
+  const client = makeClient();
+
+  if (!sub || sub === 'ls' || sub === 'list') {
+    const result = await client.recall({ query: args.query, kind: args.kind, limit: args.limit });
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (!result.memories.length) {
+      console.log('아직 기억이 없습니다. rootr memory add "한 줄 사실" 으로 남겨 보세요.');
+      return;
+    }
+    for (const m of result.memories) {
+      const when = String(m.updatedAt ?? '').slice(0, 10);
+      console.log(`- [${m.status}] ${m.content}`);
+      console.log(`  ${m.id} · ${m.kind}${m.source ? ` · ${m.source}` : ''} · ${when}`);
+    }
+    return;
+  }
+
+  if (sub === 'add') {
+    const content = args._.join(' ');
+    if (!content) throw new Error('사용법: rootr memory add "<내용>" [--kind 지시|사람|프로젝트|참고] [--source <경로|id>] [--related a,b]');
+    if (args.kind && !MEMORY_KINDS.includes(args.kind)) {
+      throw new Error(`종류는 ${MEMORY_KINDS.join('/')} 중 하나여야 합니다: ${args.kind}`);
+    }
+    const result = await client.remember({
+      content,
+      kind: args.kind,
+      source: args.source,
+      related: parseRelated(args.related),
+    });
+    console.log(`${result.replaced ? '기억을 갈아끼웠습니다' : '기억했습니다'}: ${result.memory.content}`);
+    console.log(`id: ${result.memory.id} · 상태: ${result.memory.status}`);
+    return;
+  }
+
+  if (sub === 'edit') {
+    const id = args._[0];
+    if (!id) throw new Error('사용법: rootr memory edit <id> [--content "<내용>"] [--kind …] [--source …] [--related a,b]');
+    const content = args._.slice(1).join(' ') || args.content;
+    if (!content && !args.kind && !args.source && !args.related) {
+      throw new Error('고칠 칸이 하나도 없습니다 — --content/--kind/--source/--related 중 하나는 주어야 합니다.');
+    }
+    if (args.kind && !MEMORY_KINDS.includes(args.kind)) {
+      throw new Error(`종류는 ${MEMORY_KINDS.join('/')} 중 하나여야 합니다: ${args.kind}`);
+    }
+    const result = await client.revise(id, {
+      ...(content ? { content } : {}),
+      ...(args.kind ? { kind: args.kind } : {}),
+      ...(args.source !== undefined ? { source: args.source } : {}),
+      ...(args.related !== undefined ? { related: parseRelated(args.related) } : {}),
+    });
+    console.log(`고쳤습니다: ${result.content}`);
+    console.log(`상태: ${result.status}${result.mergedIds?.length ? ` · 같은 사실 ${result.mergedIds.length}건을 폐기로 내렸습니다` : ''}`);
+    return;
+  }
+
+  if (sub === 'forget') {
+    const id = args._[0];
+    if (!id) throw new Error('사용법: rootr memory forget <id> [--hard]');
+    await client.forget(id, { hard: args.hard === true });
+    console.log(args.hard ? '기억을 지웠습니다.' : '기억을 폐기 상태로 내렸습니다.');
+    return;
+  }
+
+  throw new Error(`알 수 없는 하위명령: ${sub}\n사용법: rootr memory [ls|add|edit|forget] …`);
+}
+
 // ---- entry ------------------------------------------------------------
 
 
@@ -1040,20 +1161,35 @@ async function cmdDbRowsRm(args) {
 /** PUBLIC-DB-DESIGN — 서버가 받는 값과 **같은 목록**이어야 한다. */
 const DB_LAYOUTS = ['table', 'cards', 'gallery', 'list', 'board', 'timeline', 'calendar', 'chart', 'ranking'];
 const DB_SKINS = ['clean', 'paper', 'dark', 'vivid', 'bento', 'brutal'];
+// DOCUMENT만 갖는 스킨 목록 — 서버(`public-config.ts`의 SKIN_IDS)와 같아야 한다.
+const DOC_SKINS = [
+  'classic', 'minimal', 'magazine', 'paper', 'tech-dark', 'vivid', 'manual', 'book',
+  'editorial', 'bento', 'glass', 'mesh', 'immersive', 'brutal', 'neumorph', 'y2k',
+];
+
+/** `--comments` 단독이면 true, `--comments false`면 false, 안 주면 undefined. */
+function flagToBool(v) {
+  if (v === undefined) return undefined;
+  return v !== 'false' && v !== '0';
+}
 
 async function cmdPublish(args) {
   const target = args._[0];
   if (!target) {
     throw new Error(
-      '사용법: rootr publish <path|id> [--children] [--view <id>] [--layout <배치>] [--skin <분위기>] | --off | --status',
+      '사용법: rootr publish <path|id> [--children] [--view <id>] [--layout <배치>] [--skin <분위기>] ' +
+        '[--comments] [--expires <ISO>] | --off | --status',
     );
   }
   const client = makeClient();
   const id = await resolveDatabaseId(client, target);
+  // DOCUMENT는 예전(더 풍부한) 경로를 쓴다 — 댓글(편집 제안) 허용, 문서 전용 스킨
+  // 16종, 만료일이 이쪽에만 있다. 노드 공통 공개 경로(표·시트 등)는 이 셋을 모른다.
+  const isDocument = (await client.nodePublicStatus(id)).nodeType === 'DOCUMENT';
 
   if (args.status) {
-    const st = await client.nodePublicStatus(id);
-    if (!st.publishable) {
+    const st = isDocument ? await client.getDocumentPublicStatus(id) : await client.nodePublicStatus(id);
+    if (!isDocument && !st.publishable) {
       console.log('이 종류는 공개할 수 없습니다(폴더).');
       return;
     }
@@ -1063,21 +1199,52 @@ async function cmdPublish(args) {
     }
     console.log(`공개 중: /p/${st.slug}`);
     if (st.expiresAt) console.log(`  만료: ${st.expiresAt}`);
-    if (st.hasPassword) console.log('  비밀번호 걸려 있음');
-    console.log(`  하위 문서도 공개: ${st.includeChildren ? '예' : '아니오'}`);
-    console.log(`  복제 허용: ${st.allowClone === false ? '아니오' : '예'}`);
-    if (st.design && (st.design.layout || st.design.skin)) {
-      console.log(`  보이는 방식: ${st.design.layout ?? 'table'} / ${st.design.skin ?? 'clean'}`);
+    if (isDocument) {
+      console.log(`  댓글(편집 제안) 허용: ${st.allowCommits ? '예' : '아니오'}`);
+      if (st.publicConfig?.skin) console.log(`  스킨: ${st.publicConfig.skin}`);
+    } else {
+      if (st.hasPassword) console.log('  비밀번호 걸려 있음');
+      console.log(`  하위 문서도 공개: ${st.includeChildren ? '예' : '아니오'}`);
+      console.log(`  복제 허용: ${st.allowClone === false ? '아니오' : '예'}`);
+      if (st.design && (st.design.layout || st.design.skin)) {
+        console.log(`  보이는 방식: ${st.design.layout ?? 'table'} / ${st.design.skin ?? 'clean'}`);
+      }
     }
     return;
   }
 
   if (args.off) {
-    await client.setNodePublic(id, { isPublic: false });
+    if (isDocument) await client.setDocumentPublic(id, { isPublic: false });
+    else await client.setNodePublic(id, { isPublic: false });
     console.log('공개를 닫았습니다. 딸려 나갔던 하위 문서도 같이 닫혔습니다(주소는 남아 있습니다).');
     return;
   }
 
+  if (isDocument) {
+    if (args.skin !== undefined && !DOC_SKINS.includes(args.skin)) {
+      throw new Error(`--skin 은 다음 중 하나여야 합니다: ${DOC_SKINS.join(', ')}`);
+    }
+    const cur = await client.getDocumentPublicStatus(id);
+    if (!cur.isPublic) {
+      const res = await client.publishDocument(id);
+      console.log(`공개했습니다: /p/${res.slug}`);
+    }
+    const patch = {};
+    const comments = flagToBool(args.comments);
+    if (comments !== undefined) patch.allowCommits = comments;
+    if (typeof args.expires === 'string') patch.expiresAt = args.expires;
+    if (typeof args.skin === 'string') patch.skin = args.skin;
+    if (Object.keys(patch).length) {
+      await client.setDocumentPublic(id, patch);
+      if (patch.allowCommits !== undefined) {
+        console.log(`  댓글(편집 제안) 허용: ${patch.allowCommits ? '예' : '아니오'}`);
+      }
+      if (patch.expiresAt !== undefined) console.log(`  만료: ${patch.expiresAt}`);
+      if (patch.skin !== undefined) console.log(`  스킨: ${patch.skin}`);
+    }
+    return;
+  }
+
   // PUBLIC-DB-DESIGN — 표는 표 모양으로만 보일 이유가 없다. 준 것만 바뀐다.
   const design = {
     ...(typeof args.layout === 'string' ? { layout: args.layout } : {}),
@@ -1183,9 +1350,12 @@ async function cmdDb(args) {
   if (sub === 'row-page-type') return cmdDbRowPageType(args);
   if (sub === 'lock') return cmdDbLock(args);
   if (sub === 'notify') return cmdDbNotify(args);
+  if (sub === 'buttons') return cmdDbButtons(args);
+  if (sub === 'button-run') return cmdDbButtonRun(args);
+  if (sub === 'view') return cmdDbView(args);
   if (sub !== 'create') {
     throw new Error(
-      '사용법: rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|row-page|row-page-type|lock|notify … (자세한 건 rootr --help)',
+      '사용법: rootr db create|rows|row-add|rows-new|row-body|rows-set|rows-each|rows-rm|row-page|row-page-type|lock|notify|buttons|button-run|view … (자세한 건 rootr --help)',
     );
   }
   const raw = typeof args.file === 'string' ? readFileSync(args.file, 'utf8') : await readStdin();
@@ -1299,6 +1469,175 @@ async function cmdDbNotify(args) {
   }
 }
 
+/**
+ * `rootr db view <path|id> <뷰이름|뷰id> [--scale week|month|year] [--name 새이름]`
+ *
+ * 뷰 하나만 고친다. 인자 없이 부르면 이 표의 뷰 목록을 보여 준다.
+ * `--scale` 은 **달력 뷰**가 주·달·해 중 무엇으로 열릴지다(기본 달).
+ * 해 보기는 열두 달을 한 번에 보여 주고, 고른 단위는 뷰에 저장돼 모두에게 그대로 보인다.
+ */
+async function cmdDbView(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--json]');
+
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const viewRef = args._[2];
+
+  if (!viewRef) {
+    const db = await client.getDatabase(id);
+    const views = db.views ?? [];
+    if (args.json) {
+      console.log(JSON.stringify(views, null, 2));
+      return;
+    }
+    if (!views.length) {
+      console.log('뷰가 없습니다.');
+      return;
+    }
+    const SPAN = { week: '주', month: '달', year: '해' };
+    for (const v of views) {
+      const span = v.type === 'calendar' ? ` · ${SPAN[v.config?.calendarScale] ?? '달'} 단위` : '';
+      console.log(`- ${v.name} (${v.type})${span}  ${v.id}`);
+    }
+    return;
+  }
+
+  const patch = {};
+  if (args.scale !== undefined) {
+    const scale = String(args.scale);
+    if (!['week', 'month', 'year'].includes(scale)) {
+      throw new Error('--scale 은 week · month · year 중 하나여야 합니다.');
+    }
+    patch.calendarScale = scale;
+  }
+  if (typeof args.name === 'string') patch.name = args.name;
+  if (!Object.keys(patch).length) {
+    throw new Error('바꿀 것을 주세요: --scale week|month|year 또는 --name 새이름');
+  }
+
+  const view = await client.updateDatabaseView(id, viewRef, patch);
+  if (args.json) {
+    console.log(JSON.stringify(view, null, 2));
+    return;
+  }
+  const SPAN = { week: '주', month: '달', year: '해' };
+  const span = view.type === 'calendar' ? ` · ${SPAN[view.config?.calendarScale] ?? '달'} 단위` : '';
+  console.log(`뷰를 고쳤습니다: ${view.name} (${view.type})${span}`);
+}
+
+
+/**
+ * DB-BUTTON — 표 위의 "누르면 일하는 버튼".
+ *
+ *   rootr db buttons <path|id>                  지금 달린 버튼 보기
+ *   rootr db buttons <path|id> --file b.json    버튼 목록을 통째로 갈아끼우기
+ *   rootr db buttons <path|id> --clear          버튼 전부 없애기
+ *
+ * `--file` 은 **통째로 갈아끼운다** — 남길 버튼도 파일에 같이 있어야 한다.
+ * 파일 모양: [{ "label":"접수", "icon":"📥",
+ *              "steps":[{"kind":"add_row","values":{"상태":"접수","담당":"@me","마감":"@today+7"}}] }]
+ */
+async function cmdDbButtons(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db buttons <path|id> [--file buttons.json] [--clear] [--json]');
+
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+
+  if (args.clear) {
+    const cleared = await client.setDatabaseButtons(id, []);
+    console.log('버튼을 모두 지웠습니다.');
+    if (args.json) console.log(JSON.stringify(cleared, null, 2));
+    return;
+  }
+  if (args.file) {
+    const raw = readFileSync(args.file, 'utf8');
+    let buttons;
+    try {
+      buttons = JSON.parse(raw);
+    } catch {
+      throw new Error('버튼 파일을 JSON으로 읽을 수 없습니다. [{ "label": "...", "steps": [...] }] 형태여야 합니다.');
+    }
+    if (!Array.isArray(buttons)) throw new Error('버튼 파일은 배열이어야 합니다(버튼 목록 전체).');
+    const saved = await client.setDatabaseButtons(id, buttons);
+    console.log(`버튼 ${saved.buttons.length}개를 저장했습니다.`);
+    if (args.json) console.log(JSON.stringify(saved, null, 2));
+    return;
+  }
+
+  const { buttons, myLevel } = await client.listDatabaseButtons(id);
+  if (args.json) {
+    console.log(JSON.stringify(buttons, null, 2));
+    return;
+  }
+  if (!buttons.length) {
+    console.log('버튼이 없습니다.');
+    return;
+  }
+  const WHAT = {
+    add_row: '행 만들기',
+    update_rows: '값 바꾸기',
+    ai_fill: 'AI로 칸 채우기',
+    open_row: '만든 행 열기',
+  };
+  const WHERE = { created: '방금 만든 행', selected: '고른 행' };
+  for (const b of buttons) {
+    console.log(`${b.icon ? b.icon + ' ' : ''}${b.label}  (${b.id})`);
+    for (const [i, st] of (b.steps ?? []).entries()) {
+      const what = WHAT[st.kind] ?? st.kind;
+      const where = st.target ? ` · ${WHERE[st.target] ?? st.target}` : '';
+      const detail =
+        st.kind === 'ai_fill'
+          ? ` · ${st.propId} 칸 ← "${st.prompt}"`
+          : st.values
+            ? ' · ' + Object.entries(st.values).map(([k, v]) => `${k}=${v}`).join(', ')
+            : '';
+      console.log(`  ${i + 1}. ${what}${where}${detail}`);
+    }
+  }
+  if (myLevel && myLevel !== 'MANAGE' && myLevel !== 'FULL') {
+    console.log('\n(버튼을 고치려면 이 표의 관리 권한이 필요합니다. 누르는 것은 지금 권한으로도 됩니다.)');
+  }
+}
+
+/**
+ * `rootr db button-run <path|id> <buttonId> [--rows id1,id2]`
+ *
+ * 버튼을 한 번 누른다. `--rows` 는 "고른 행"을 대상으로 하는 단계가 있을 때만 쓴다.
+ * 누른 사람 권한 그대로 돈다 — 잠긴 칸을 건드리는 버튼은 거기서 막힌다.
+ */
+async function cmdDbButtonRun(args) {
+  const target = args._[1];
+  const buttonId = args._[2];
+  if (!target || !buttonId) {
+    throw new Error('사용법: rootr db button-run <path|id> <buttonId> [--rows id1,id2] [--json]');
+  }
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const rowIds =
+    typeof args.rows === 'string'
+      ? args.rows.split(',').map((x) => x.trim()).filter(Boolean)
+      : undefined;
+
+  const r = await client.runDatabaseButton(id, buttonId, { rowIds });
+  if (args.json) {
+    console.log(JSON.stringify(r, null, 2));
+    return;
+  }
+  // created 는 **만든 행의 id 목록**이다(개수가 아니다) — 세어서 보여 준다.
+  const madeCount = Array.isArray(r.created) ? r.created.length : (r.created ?? 0);
+  const parts = [];
+  if (madeCount) parts.push(`행 ${madeCount}개 만듦`);
+  if (r.updated) parts.push(`행 ${r.updated}개 고침`);
+  if (r.filled) parts.push(`AI로 칸 ${r.filled}개 채움`);
+  console.log(parts.length ? parts.join(' · ') : '바뀐 것이 없습니다.');
+  if (r.openRowId) console.log(`열 행: ${r.openRowId}`);
+  // AI가 못 채워도 버튼은 계속 돈다 — 조용히 넘어가면 사람이 왜 빈칸인지 모른다.
+  if (r.aiFailed) console.log(`AI가 못 채운 칸 ${r.aiFailed}개${r.aiError ? ` — ${r.aiError}` : ''}`);
+}
+
+
 async function cmdDbRows(args) {
   const target = args._[1];
   if (!target) throw new Error('사용법: rootr db rows <path|id> [--body] [--backlinks] [--json]');
@@ -1732,6 +2071,8 @@ async function main() {
       return cmdMv(args);
     case 'rm':
       return cmdRm(args);
+    case 'restore':
+      return cmdRestore(args);
     case 'ws':
       return cmdWs(args);
     case 'ask':
@@ -1756,6 +2097,8 @@ async function main() {
       return cmdFeedback(args);
     case 'scaffold':
       return cmdScaffold(args);
+    case 'memory':
+      return cmdMemory(args);
     case 'mcp':
       return cmdMcp(args);
     default: