rootr-cli 0.26.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와 경로를 모두**
@@ -843,6 +870,16 @@ rootr db column <표> 특이사항 --wrap on --align center  # 긴 글 줄바꿈
 | `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` | 연결 해제(인증서 호스트도 바로 지움) |
+
 문서함은 워크스페이스가 아니라 **사람(이메일)**에 붙습니다. 사람 없는 워크스페이스 키(원격 커넥터)는
 그 키를 만든 구성원으로 동작합니다.
 

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`).
 
@@ -256,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
@@ -294,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
@@ -452,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 |
 |---|---|---|
@@ -478,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