rootr-cli 0.25.0 → 0.29.0

package/README.ko.md

@@ -331,6 +331,33 @@ stdout 과 `--json` 출력은 그대로입니다. 끄려면 `ROOTR_MAIL_NOTICE=0
 키마다 한 번 붙입니다. 웹훅 요청은 서명되어 있습니다 — `add` 때 한 번 보이는 비밀값으로
 `X-Rootr-Signature: sha256=HMAC_SHA256(secret, 원문)` 을 확인하세요. 몸통에는 문서 내용이 없습니다(`apiUrl` 을 부르세요).
 
+### 내 도메인 연결 (domain)
+
+발행한 페이지(PAGE)를 내 도메인(`www.회사.co.kr`)에서 보통 홈페이지처럼 엽니다 — 첫 화면은 그 페이지, `/{하위}` 는
+공개된 하위 페이지, 루터 서명은 붙지 않습니다. Team 플랜부터, 워크스페이스 관리자만 됩니다.
+
+- **무료 주소** `이름.rootr.site` — 결제·DNS 없이 바로 열립니다(워크스페이스당 3개, 영어 소문자·숫자·하이픈 3~30자, `www`·`api`·`admin` 같은 이름과 `rootr` 가 들어간 이름은 예약).
+- **내 도메인** — 1개당 월 $10, 연 결제 시 월 $8(연 $96). "도메인 연결" 애드온의 자리를 하나 씁니다. 자리가 없으면
+  `402`(결제 필요)와 함께 설정 › 결제 주소를 알려 줍니다. 애드온이 있는데 꽉 찼으면 `--confirm-charge` 로 1개를 더 삽니다(일할 계산).
+  해제하면 수량이 줄고(일할 환불), 마지막 하나면 이번 주기 끝에 애드온이 끝나도록 예약됩니다.
+
+```bash
+rootr domain detect www.회사.co.kr        # DNS 를 어디서 관리하는지(가비아·카페24·Cloudflare…) + 단계 안내
+rootr domain add www.회사.co.kr /홈페이지   # 등록 — 넣을 한 줄과 그 업체 화면 기준 단계가 나온다
+rootr domain add --subdomain acme /홈페이지  # 무료 주소 acme.rootr.site — 바로 열린다
+rootr domain available acme               # 무료 주소 이름을 쓸 수 있는지
+rootr domain check <id>                   # 지금 다시 확인(연결 전이면 exit 2)
+rootr domain list                         # 종류·상태(DNS 확인 중 / 인증서 발급 중 / 연결됨 / 일시 중지) + 자리 사용
+rootr domain rename <id> www.right.co.kr  # 연결 전 도메인의 이름 바꾸기(결제 그대로, 새 id)
+rootr domain remove <id>                  # 연결 해제(업체 DNS 의 CNAME 줄도 지우세요)
+```
+
+고객이 넣는 것은 **딱 한 줄**입니다: 타입 `CNAME`, 이름 `www`, 값 `connect.rootr.site`. 그다음 HTTPS 인증서는
+루터가 알아서 발급하고 5분마다 다시 확인합니다 — 연결되면 등록한 사람에게 알림과 메일이 갑니다. 루트 도메인
+(`회사.co.kr`)에는 CNAME 을 못 거는 곳이 많아 `www.` 으로 연결하고 루트는 포워딩합니다(업체별 방법이 안내에 나옵니다).
+같은 주소를 **다른 워크스페이스가 전에 등록했던** 경우에만 소유 확인 줄(`TXT`, 이름 `_rootr-verify.www`)이 하나 더 필요합니다 —
+남겨 둔 CNAME 으로 남의 도메인을 가로채지 못하게.
+
 ### 제보 보내기 (feedback)
 
 ```bash
@@ -378,7 +405,7 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 
 ## MCP 서버로 사용하기
 
-`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 202종:
+`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 214종:
 
 노드를 가리키는 인자(`target`, `databaseId`, `spreadsheetId`, `formId`, `crmId`, `trackerId`,
 `recordingId`, `presentationId`, `whiteboardId`, `logId`, `parentId` 등)는 **노드 id와 경로를 모두**
@@ -530,6 +557,10 @@ rootr db buttons <표> --file buttons.json  # 목록 통째로 저장(남길 것
 rootr db button-run <표> <버튼id>           # 한 번 누르기 (--rows id,id 로 고른 행 지정)
 rootr db automations <표> --file rules.json # 자동 규칙 — 사람이 안 눌러도 도는 것
 rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해 중에서
+rootr db view <표> <뷰> --density compact --freeze 1   # 촘촘한 줄 · 왼쪽 첫 칸 고정
+rootr db column <표> 지원일 --time off --range off      # 시간·기간 없이 날짜 하나만
+rootr db column <표> 마감일 --overdue on                # 지난 날짜를 빨갛게(기본은 꺼짐)
+rootr db column <표> 특이사항 --wrap on --align center  # 긴 글 줄바꿈 · 가운데 정렬
 ```
 
 ```json
@@ -839,6 +870,16 @@ rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해
 | `rootr_remove_doc_mail_webhook` | 내 받은 문서 웹훅 지우기 |
 | `rootr_test_doc_mail_webhook` | 시험 전송(doc_mail.test) 후 전달 결과 |
 
+#### 내 도메인 연결 (워크스페이스 관리자, Team 플랜)
+
+| 도구 | 설명 |
+|---|---|
+| `rootr_list_custom_domains` | 워크스페이스의 도메인 목록 — 종류(내 도메인·무료 주소)·상태·가리키는 페이지·넣을 DNS 줄·사이트 주소 + 자리 요약(`slots`) |
+| `rootr_add_custom_domain` | 발행한 페이지를 내 도메인으로 연결 — 넣을 한 줄 + 이름서버로 짚은 업체(가비아·카페24·Cloudflare…)의 단계 안내(`instructions`). `subdomain` 이면 무료 주소(바로 열림), 자리가 꽉 찼으면 사람 동의 뒤 `confirmCharge: true` |
+| `rootr_check_custom_domain` | 지금 다시 확인 — DNS·인증서 상태와 쉬운 말 사유 |
+| `rootr_rename_custom_domain` | 연결 전 내 도메인의 이름 바꾸기(결제 자리는 새 이름으로 옮겨 감) |
+| `rootr_remove_custom_domain` | 연결 해제(인증서 호스트도 바로 지움) |
+
 문서함은 워크스페이스가 아니라 **사람(이메일)**에 붙습니다. 사람 없는 워크스페이스 키(원격 커넥터)는
 그 키를 만든 구성원으로 동작합니다.
 
@@ -859,11 +900,20 @@ rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해
 `rootr_append_page_blocks`, `rootr_update_page`, `rootr_update_page_block`,
 `rootr_read_page_live_data`)로 저작합니다.
 
-HTML을 짜는 것이 아니라 **정해진 블록 15종을 골라 쌓습니다** — `hero` `text`
+HTML을 짜는 것이 아니라 **정해진 블록 16종을 골라 쌓습니다** — `hero` `text`
 `features` `gallery` `pricing` `testimonials` `faq` `timeline` `cta` `footer` +
 표에서 값을 끌어오는 `liveStats` `liveTable` `liveChart` + 신청을 받는 `form` +
 방문자가 시간을 잡는 `booking`(`{bookingNodeId, headline?, type?}` — 예약을 켜고 공개한 표의 노드 id) +
-자유 블록 `custom`.
+모션그래픽 동영상 `video` + 자유 블록 `custom`.
+
+**같은 페이지 안 이동** — 버튼·링크의 `target`에 `{"kind":"block","blockId":"booking"}`을 주면 새 탭 없이
+그 블록까지 부드럽게 내려갑니다(인스타그램 앱 안 브라우저에서 사람을 잃지 않는 광고 랜딩용). 가리킨 블록이
+페이지에 없으면 400이라, 만들 때 그 블록에 `id`를 직접 붙여 둡니다. `text` 본문에서는 `[글](#블록id)`.
+
+**동영상(Team 플랜)** — `hero.background`에 `{"kind":"video","attachmentId":"…","posterAttachmentId":"…"}`,
+동영상 블록은 `{attachmentId, posterAttachmentId?, caption?, aspect?: "16:9"|"9:16"|"1:1"|"4:5", bleed?}`.
+둘 다 소리 없이 자동 재생·반복·컨트롤 없음이고, 동작 줄이기를 켠 방문자에게는 포스터 그림만 보입니다.
+히어로 동영상에는 `portraitAttachmentId`·`portraitPosterAttachmentId`(휴대폰 세로판)를 더할 수 있습니다 — 세로 화면은 그 판을, 아니면 기본판을 하나만 내려받습니다.
 
 **랜딩 페이지**용으로 두 블록은 가운데 본문 기둥을 벗어나 화면 폭 전체를 쓸 수 있습니다.
 `hero`에 `size: "screen"`을 주면 화면 한 장을 채우는 큰 제목(화면 폭 전체·화면 높이·큰 글자)이 되고,

package/README.md

@@ -11,7 +11,7 @@ citations back to the exact paragraph.
 *(한국어 문서: [README.ko.md](https://github.com/gwmage/rootr-cli/blob/main/README.ko.md))*
 
 - `rootr` CLI — documents, databases, forms, signed documents, publishing, permissions, memory
-- `rootr mcp` — stdio MCP server, **202 tools** (see [MCP tools](#mcp-tools))
+- `rootr mcp` — stdio MCP server, **214 tools** (see [MCP tools](#mcp-tools))
 
 Plain Node.js ESM, no build step. Node 18+ (uses the built-in `fetch`).
 
@@ -201,10 +201,18 @@ rootr db rows-rm  /projects/tasks --ids r1,r2 --yes
 rootr db duplicates /hr/applicants --row r9            # same person (dedupe column) + latest linked history
 rootr db merge /hr/applicants r9 --into r1             # merge a duplicate into the existing row
 rootr db keep-duplicate /hr/applicants r9 --from r1    # keep as a new row, link both
+rootr db rename-col /hr/applicants "대처-클레임" "대처-청소 후 사진 제출" --dry  # what follows a rename (formulas, {col} templates, rollups, forms, pages); drop --dry to rename
+rootr db carry-over /hr/applicants r9                  # re-application: copy the latest earlier row into r9 (earlier row untouched)
+rootr db column-set /hr/applicants Phone --json '{"dedupe":true,"dedupeCarry":{"auto":true,"exclude":["Applied on"],"mark":{"Re-applied":true}}}'
+rootr db column-set /hr/applicants Phone --json '{"validate":{"kind":"mobile_kr","mode":"block"}}'   # also date · birthdate · range, mode warn
+rootr db rule-violations /hr/applicants                # existing values that break a validate rule (nothing changed)
 rootr db history /hr/applicants --row r1               # who changed what, when, how
 rootr db restore /hr/applicants --at 2026-10-15T09:00:00+09:00 --yes  # rows + columns/views back to that time
 rootr db view /projects/tasks Calendar --scale month  # views: table, board, calendar, timeline
 rootr db view /hr/applicants Board --cards "Interview date,Phone"  # fields shown on board cards
+rootr db view /hr/applicants Table --density compact --freeze 1  # compact rows, keep the first column fixed
+rootr db column /hr/applicants "Applied on" --overdue off --time off --range off  # plain single date, no red
+rootr db column /hr/applicants Notes --wrap on --align center     # wrap long text, center it
 rootr db lock /projects/tasks --schema managers --rows own --locked "Approved,Score"
 rootr db notify  /projects/tasks --file rules.json    # notification rules
 rootr db buttons /projects/tasks --file buttons.json  # buttons that do work when pressed
@@ -248,8 +256,14 @@ rootr form mapping /intake/request                    # which column each questi
 rootr form mapping /intake/request --set '{"f_name":"p_title"}'
 rootr form responses /intake/request --latest         # --latest = newest one per person
 rootr form response-edit <responseId> --values '{"Email":"a@b.com"}'
+rootr form submit /intake/request --values '{"f_email":"a@b.com"}' \
+  --files '{"Portfolio":["a.pdf","b.png"]}'          # uploads each file, then submits
 ```
 
+A `file` question takes one file unless it has `"multiple": true` (add `"maxFiles": 5`
+to cap it, default 10); then the answer is an array. `"allowImages": true` on a
+`text`/`textarea` question lets respondents put images inside their answer.
+
 Run `form mapping` right after pointing a form at a hand-built table. Answers reach the
 table by matching the question name to the column name, so a question the table has no
 column for is **dropped with no error anywhere** — this command is the only place that
@@ -286,6 +300,37 @@ rootr readreq /handbook/policy.md --users u1,u2 --due 2026-10-01T00:00:00Z --ack
 rootr readreq /handbook/policy.md               # who has read it, completion rate
 ```
 
+### Custom domains (your own website address)
+
+Open a published PAGE at your own domain (`www.customer.co.kr`) as a normal website — the root shows the
+page, `/{child}` shows its published child pages, and there is no Rootr signature. Team plan and up,
+workspace admins only.
+
+- **Free address** `name.rootr.site` — live at once, no DNS and no payment (3 per workspace; lowercase a-z, 0-9 and
+  hyphen, 3–30 chars; names like `www`, `api`, `admin` and anything containing `rootr` are reserved).
+- **Your own domain** — $10/month per domain, $8/month billed yearly ($96/year): one slot of the "Custom domain"
+  add-on. With no free slot the API answers `402` and points to Settings → Billing; when the add-on exists but is
+  full, `--confirm-charge` buys one more slot (prorated). Removing a domain lowers the quantity (prorated credit);
+  removing the last one schedules the add-on to end at the end of the billing period.
+
+```bash
+rootr domain detect www.customer.co.kr          # where is the DNS managed (Gabia, Cafe24, Cloudflare…) + the steps
+rootr domain add www.customer.co.kr /홈페이지      # register; prints the one DNS line and provider-specific steps
+rootr domain add --subdomain acme /홈페이지        # free address acme.rootr.site — live immediately
+rootr domain available acme                     # is acme.rootr.site free to take
+rootr domain check <id>                         # re-check now (exit 2 until it is live)
+rootr domain list                               # kind, status (waiting for DNS / issuing certificate / connected / paused) + slot usage
+rootr domain rename <id> www.right.co.kr        # fix the name of a not-yet-live domain (billing unchanged, new id)
+rootr domain remove <id>                        # disconnect (then remove the CNAME at your provider)
+```
+
+The customer adds exactly **one** DNS line: `CNAME`, name `www`, value `connect.rootr.site`. Rootr then
+issues the HTTPS certificate on its own and re-checks every 5 minutes; whoever registered the domain
+gets a notification and an email when it goes live. A bare root domain (`customer.co.kr`) usually
+cannot hold a CNAME — connect `www.` and forward the root to it (the guide shows how for your provider).
+Only when the same name was registered before by a *different* workspace, one extra `TXT` line
+(`_rootr-verify.www`) is required, so nobody can take over a domain whose CNAME was left behind.
+
 ### Signed documents and research notes
 
 A signed document is a markdown document whose body **freezes the moment it is submitted**; the
@@ -444,7 +489,7 @@ is refused and says when the grace was used.
 
 ## MCP tools
 
-`rootr mcp` speaks MCP over stdio. 202 tools:
+`rootr mcp` speaks MCP over stdio. 214 tools:
 
 | Group | Count | Tools |
 |---|---|---|
@@ -470,6 +515,7 @@ is refused and says when the grace was used.
 | Visitor booking & Google Calendar | 6 | turn a published table into a booking page, rules, open slots, connect / list / disconnect Google Calendar |
 | Root-cause Q&A | 1 | ask the workspace knowledge graph, answer with citations |
 | Feedback | 1 | send feedback to the Rootr team |
+| Custom domains | 4 | list (with kind + slot usage), add (own domain: the one DNS line + click-by-click steps for the detected DNS provider; `subdomain` for a free name.rootr.site; `confirmCharge` after the person agrees to buy a slot), check now, remove |
 
 Two gaps keep breathing room: `bufferMin` around bookings made through the table (CLI `--buffer`) and
 `calendarBufferMin` around events already on the connected Google Calendar, e.g. travel time to an outside
@@ -506,11 +552,23 @@ signed-document, issue, CRM and LOG tools need `docs:read` / `docs:write`; `root
 ### Pages
 
 A PAGE is **a screen for people outside the workspace** — an event announcement, a product page,
-a sign-up. You do not write HTML: you stack **15 predefined block types** — `hero`, `text`,
+a sign-up. You do not write HTML: you stack **16 predefined block types** — `hero`, `text`,
 `features`, `gallery`, `pricing`, `testimonials`, `faq`, `timeline`, `cta`, `footer`, the
 table-backed `liveStats`, `liveTable`, `liveChart`, the `form` block, the `booking` block
 (a visitor scheduling calendar: `{bookingNodeId, headline?, type?}` — the node id of a published
-table with visitor booking on) — plus the free-form `custom`.
+table with visitor booking on), the `video` block (a looping motion-graphic clip) — plus the free-form `custom`.
+
+**Same-page links.** A button or link `target` can be `{"kind":"block","blockId":"booking"}` — it
+jumps to that block on the same page (smooth scroll, same tab; ideal for a hero "Book now" button
+on an ad landing page opened in an in-app browser). The block must exist on the page (else 400),
+so give it an explicit `id`. In a `text` block, `[label](#<blockId>)` does the same.
+
+**Videos (Team plan).** `hero.background` can be `{"kind":"video","attachmentId":"…","posterAttachmentId":"…"}`
+and the `video` block is `{attachmentId, posterAttachmentId?, caption?, aspect?: "16:9"|"9:16"|"1:1"|"4:5", bleed?}`.
+Both autoplay muted and looped with no controls; the poster shows for reduced-motion visitors. A hero video can add
+`portraitAttachmentId` / `portraitPosterAttachmentId` — a vertical cut that portrait phone screens play instead (only one file is downloaded). Upload the
+mp4 with `POST /v1/attachments/upload?workspaceId=…&nodeId=<page>&mimeType=video/mp4` (body = bytes,
+`Content-Type: application/octet-stream`).
 
 For a **landing page**, two options let a block use the whole page width instead of the centred
 text column: `hero` with `size: "screen"` is a full-screen hero (edge to edge, one viewport tall,