rootr-cli 0.30.1 → 0.31.0

package/README.ko.md

@@ -555,6 +555,7 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 rootr db buttons <표>                      # 지금 달린 버튼 보기
 rootr db buttons <표> --file buttons.json  # 목록 통째로 저장(남길 것도 같이)
 rootr db button-run <표> <버튼id>           # 한 번 누르기 (--rows id,id 로 고른 행 지정)
+rootr db button-run <표> <버튼id> --input-file 원문.txt   # 글 받는 버튼에 글 넣어 누르기(--input "글" · --input - 도 됨)
 rootr db automations <표> --file rules.json # 자동 규칙 — 사람이 안 눌러도 도는 것
 rootr db view <표> <뷰> --scale year       # 달력 보기를 주·달·해 중에서
 rootr db view <표> <뷰> --density compact --freeze 1   # 촘촘한 줄 · 왼쪽 첫 칸 고정
@@ -584,6 +585,20 @@ rootr db column <표> 특이사항 --wrap on --align center  # 긴 글 줄바꿈
 ] }]
 ```
 
+**누르면 글부터 받는 버튼.** 버튼에 `input` 을 달면 누를 때 글 상자가 뜨고, 적은 글이 단계 값·AI 지시문의
+`{@input}` 자리에 들어갑니다. "행을 만들고 → 원문 칸에 붙여 넣고 → 버튼을 눌러 AI 로 나머지 칸 채우기"가
+**버튼 → 붙여 넣기 → 확인** 한 번이 됩니다(고른 행이 없어도 됩니다). 여러 건을 한 번에 붙여 넣으면 `split` 으로
+건마다 한 번씩 돌립니다(`blank_line` 빈 줄 · `separator` 구분 글자 · `ai` AI 가 건의 시작 줄을 찾음, 한 번에 50건까지).
+
+```json
+[{ "label": "원문으로 행 만들기", "icon": "📋",
+   "input": { "label": "붙여 넣을 원문", "multiline": true, "split": { "by": "separator", "separator": "---" } },
+   "steps": [
+     { "kind": "add_row", "values": { "원문": "{@input}", "상태": "접수" } },
+     { "kind": "ai_fill", "target": "created", "propId": "제목", "prompt": "{원문}에서 제목만 한 줄로 뽑아." }
+] }]
+```
+
 **사람이 기억해서 눌러야 하는 일**은 버튼이 아니라 **자동 규칙**으로 겁니다 — 버튼은 안 누른
 날 그 일이 그냥 빠집니다. 단계 문법은 버튼과 똑같고, 조건은 거의 언제나 `changed_to` 입니다
 (`is` 는 그 뒤로 그 행을 고칠 때마다 계속 참이라 행이 몇 벌씩 생깁니다).
@@ -648,6 +663,11 @@ rootr db column <표> 특이사항 --wrap on --align center  # 긴 글 줄바꿈
 (이름이 하나라도 어긋나면 그 칸은 영영 빈 칸으로 남습니다). 스캐폴드 트리에서는 폼 노드에
 `form.collectInto: "database" | "spreadsheet"`로 같은 일을 합니다.
 
+**다른 표에서 고르기**(`"type": "relation"`) 질문은 다른 표의 행을 찾아 고릅니다(`"relationDatabaseId"` 또는 응답 표의 관계 칸이
+가리키는 표, 여러 개면 `"multiple": true`). 행 id 는 `rootr form pick <폼> <질문> [검색어]`로 찾아 답에 넣습니다. 관계 칸에는
+이 질문만 들어가고, 글자 질문이 걸려 있으면 `form mapping` 이 "넣을 수 없음"으로 알립니다. 바깥 사람이 고르게 하려면 질문에
+`"publicPick": { "enabled": true }` 를 켭니다.
+
 폼 응답은 `rootr form responses <폼> [--latest]`로 보고, `rootr form response-edit <응답id>
 --values '{"필드id":"값"}'`로 고치고, `rootr form response-rm <응답id> --yes`로 지웁니다.
 `--latest`는 같은 사람이 여러 번 낸 것 중 마지막 한 건만 남깁니다(익명 제출은 합치지 않습니다).

package/README.md

@@ -211,18 +211,27 @@ rootr db restore /hr/applicants --at 2026-10-15T09:00:00+09:00 --yes  # rows + c
 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 view /ops/requests Table --entry-row on --day-pager "Received"  # Excel-like empty bottom row · one day per page (◀ ▶ / Today)
+rootr db view /ops/requests Table --quick "Region,Owner" --row-hidden on  # columns pinned atop the filter panel · hidden columns still shown in the row page
 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
 rootr db button-run /projects/tasks fill-summary --rows r1,r2
+rootr db button-run /projects/tasks from-text --input-file raw.txt   # a button with `input` (also --input "text" / --input -)
 rootr db automations /projects/tasks --file rules.json # "when a value becomes X, do Y" (also: at a set time)
 rootr db rows-new /projects/tasks --file rows.json --upsert-key 외부키  # idempotent load: retries cannot duplicate
 rootr db import-sheets sites.xlsx --ws <id> --dry     # fold a one-sheet-per-record workbook into ONE table
 rootr db row-page <rowId> --type RECORDING            # give one row a typed detail page
 ```
 
+A button can **ask for text first**: give it `input: { label, multiline?, required?, split? }` and pressing it opens a
+text box; the text goes wherever a step says `{@input}` (e.g. `add_row` values `{ "Original": "{@input}" }`, then an
+`ai_fill` with `target: "created"` parses it into the other columns — no row has to be selected). `split`
+(`{ by: "blank_line" }`, `{ by: "separator", separator: "---" }` or `{ by: "ai" }`) runs the steps once per pasted
+item, up to 50.
+
 `db automations` takes the same step syntax as `db buttons`, so there is nothing new to
 learn — the difference is that nobody has to press it. A rule is
 `{ label, on: ["updated"], when: { property, op: "changed_to", value }, steps: [...] }`;
@@ -263,6 +272,10 @@ rootr form submit /intake/request --values '{"f_email":"a@b.com"}' \
 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.
+A `relation` question picks rows from another table (`"relationDatabaseId"`, or the table the response table's
+relation column points to; `"multiple": true` for several). Find ids with `rootr form pick <form> <question> [search]`
+and answer with the row id. A relation column only takes a `relation` question; `form mapping` marks a text question
+there as "can't go in". Outsiders can pick only if the question has `"publicPick": { "enabled": true }`.
 
 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

package/bin/rootr.js

@@ -40,10 +40,11 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   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 button-run <path|id> <buttonId> [--rows id,id] [--input 글|--input-file f|--input -]  버튼 한 번 누르기 (행 만들기·값 채우기·AI 채우기 · 글 받는 버튼이면 --input)
   rootr db automations <path|id> [--file rules.json] [--clear] 자동 규칙 — "값이 이렇게 되면 이 일을 해라"·정해진 시각
   rootr db import-sheets <파일.xlsx> --ws <id> [--dry]         시트 수백 장짜리 엑셀을 표 하나로 접어 가져오기
   rootr db view <path|id> [뷰이름] [--scale week|month|year] [--name 새이름] [--cards "칸,칸"]  뷰 목록·달력 주/달/해 단위·보드 카드에 보일 칸 ·[--density compact|normal] [--freeze 0~3] 촘촘하게·왼쪽 칸 고정
+  rootr db view <path|id> <뷰이름> [--row-hidden on|off] [--quick "칸,칸"] [--entry-row on|off] [--day-pager 날짜칸|off]  행 열면 감춘 칸 보이기·필터 맨 위 고정 칸·맨 아래 입력 줄·하루씩 보기
   rootr db column <path|id> <칸> [--align left|center|right] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off]  칸 정렬·줄바꿈·지난 날짜 빨강·시간·기간
   rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  행 추가(상세 내용 포함)
   rootr db row-body <path|id> <rowId> [--file <f>] 행의 상세 내용(본문 메모) 쓰기 — 없으면 표준입력
@@ -96,6 +97,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr form submit <path|id> [--values '<json>'] [--files '{"질문id":["a.pdf","b.pdf"]}']  응답 내기 (파일은 올린 뒤 답으로 붙임 — 여러 개 받는 질문은 배열로)
   rootr form response-edit <응답id> --values '<json>'  이미 낸 응답 고치기 (폼 검사 규칙 다시 통과)
   rootr form response-rm <응답id> [--yes]           응답 한 건 삭제 (되돌릴 수 없음)
+  rootr form pick <path|id> <질문 이름|id> [검색어] [--json]  "다른 표에서 고르기" 질문에서 고를 행 찾기(답에는 행 id 를 넣는다)
   rootr sign new <경로> [--file <f>] [--reviewer <userId>] [--line <line.json>]  서명문서 만들기(본문·결재라인까지)
   rootr sign show <path|id> [--json]               결재라인 진행·서명 목록 보기
   rootr sign line <path|id> --file <line.json>     결재라인 다시 짜기 (올리기 전에만)
@@ -181,10 +183,11 @@ usage:
   rootr db lock <path|id> [--schema managers] [--rows own] [--locked "Approved,Score"]  view/set table locks
   rootr db notify <path|id> [--file rules.json] [--clear]  view/save notification rules
   rootr db buttons <path|id> [--file buttons.json] [--clear]  view/save buttons that do work when pressed
-  rootr db button-run <path|id> <buttonId> [--rows id,id]     press a button once (create rows, fill values, AI fill)
+  rootr db button-run <path|id> <buttonId> [--rows id,id] [--input text|--input-file f|--input -]  press a button once (create rows, fill values, AI fill · --input for a button that asks for text)
   rootr db automations <path|id> [--file rules.json] [--clear] automatic rules — "when a value becomes X, do Y", or at a set time
   rootr db import-sheets <file.xlsx> --ws <id> [--dry]        fold a one-sheet-per-record workbook into ONE table
   rootr db view <path|id> [view name] [--scale week|month|year] [--name <new name>]  list views; calendar week/month/year [--density compact|normal] [--freeze 0-3]  compact rows · frozen left columns
+  rootr db view <path|id> <view name> [--row-hidden on|off] [--quick "field,field"] [--entry-row on|off] [--day-pager <date field>|off]  hidden fields shown in the row page · pinned filters · entry row · one day at a time
   rootr db column <path|id> <column> [--align left|center|right] [--wrap on|off] [--overdue on|off] [--time on|off] [--range on|off]  column alignment · wrapping · overdue red · time · end date
   rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  add a row (with its body)
   rootr db row-body <path|id> <rowId> [--file <f>] write a row's body — reads stdin if no file
@@ -238,6 +241,7 @@ usage:
   rootr form submit <path|id> [--values '<json>'] [--files '{"fieldId":["a.pdf","b.pdf"]}']  submit a response (files are uploaded, then attached — several for a "multiple" file question)
   rootr form response-edit <responseId> --values '<json>'  edit a submitted response (revalidated against the form)
   rootr form response-rm <responseId> [--yes]       delete one response (cannot be undone)
+  rootr form pick <path|id> <question name|id> [search] [--json]  find rows for a "pick from another table" question (answer with the row id)
   rootr sign new <path> [--file <f>] [--reviewer <userId>] [--line <line.json>]  create a signed document (body + approval line)
   rootr sign show <path|id> [--json]               approval-line progress and signatures
   rootr sign line <path|id> --file <line.json>     rebuild the approval line (before submitting only)
@@ -1109,11 +1113,39 @@ async function cmdForm(args) {
   if (sub === 'submit') return cmdFormSubmit(args);
   if (sub === 'response-edit') return cmdFormResponseEdit(args);
   if (sub === 'response-rm') return cmdFormResponseRm(args);
+  if (sub === 'pick') return cmdFormPick(args);
   throw new Error(
-    usage(tr(`rootr form new|show|set|collect|responses|submit|response-edit|response-rm … (자세한 건 rootr --help)`, `rootr form new|show|set|collect|responses|submit|response-edit|response-rm … (see rootr --help)`)),
+    usage(tr(`rootr form new|show|set|collect|responses|submit|response-edit|response-rm|pick … (자세한 건 rootr --help)`, `rootr form new|show|set|collect|responses|submit|response-edit|response-rm|pick … (see rootr --help)`)),
   );
 }
 
+/**
+ * FORM-REL-PICK — `rootr form pick <폼> <질문> [검색어]`: "다른 표에서 고르기" 질문에서 고를 행 찾기. 나온 id 를
+ * `rootr form submit --values '{"<질문id>":"<행id>"}'` 로 낸다(여러 개 받는 질문이면 배열).
+ */
+async function cmdFormPick(args) {
+  const [, target, question, ...words] = args._;
+  if (!target || !question) throw new Error(usage(tr(`rootr form pick <path|id> <질문 이름|id> [검색어] [--json]`, `rootr form pick <path|id> <question name|id> [search] [--json]`)));
+  const client = makeClient();
+  const formId = await resolveNodeId(client, target);
+  const form = await client.getForm(formId);
+  const field = (form.fields ?? []).find((f) => f.id === question) ?? (form.fields ?? []).find((f) => f.name === question);
+  if (!field || field.type !== 'relation') {
+    throw new Error(tr(`"${question}"은(는) 이 폼의 "다른 표에서 고르기" 질문이 아닙니다.`, `"${question}" is not a "pick from another table" question on this form.`));
+  }
+  const res = await client.formRelationOptions(formId, field.id, words.join(' '));
+  if (args.json) {
+    console.log(JSON.stringify(res, null, 2));
+    return;
+  }
+  if (!res.rows?.length) {
+    console.log(tr('맞는 행이 없습니다.', 'No matching rows.'));
+    return;
+  }
+  for (const r of res.rows) console.log(`${r.id}  ${r.title}${r.subtitle ? `  · ${r.subtitle}` : ''}`);
+  if (res.hasMore) console.log(tr('(더 있습니다 — 검색어를 더 적어 주세요)', '(more — narrow the search)'));
+}
+
 /**
  * FORM-TALLY — `rootr form new <경로> --fields '<json>'`
  *
@@ -2960,8 +2992,26 @@ async function cmdDbView(args) {
     if (!Number.isInteger(n) || n < 0 || n > 3) throw new Error(tr('--freeze 는 0~3 (왼쪽에 붙여 둘 칸 수)', `--freeze must be 0-3 (columns kept on the left)`));
     patch.frozenColumns = n;
   }
+  // VIEW-ROW-SHOW-HIDDEN · VIEW-ENTRY-ROW — on|off. VIEW-QUICK-FILTER — 필터 창 맨 위에 고정할 칸(쉼표로, "" 이면 끔).
+  // VIEW-DAY-PAGER — 하루씩 볼 날짜 칸(이름 또는 id), off 이면 끔.
+  const onOff = (flag, raw) => {
+    const v = String(raw).toLowerCase();
+    if (['on', 'true', '1'].includes(v)) return true;
+    if (['off', 'false', '0'].includes(v)) return null;
+    throw new Error(tr(`--${flag} 는 on 또는 off`, `--${flag} must be on or off`));
+  };
+  if (args['row-hidden'] !== undefined) patch.rowPaneShowHidden = onOff('row-hidden', args['row-hidden']);
+  if (args['entry-row'] !== undefined) patch.entryRow = onOff('entry-row', args['entry-row']);
+  if (typeof args.quick === 'string') {
+    const quick = args.quick.split(',').map((c) => c.trim()).filter(Boolean);
+    patch.quickFilters = quick.length ? quick : null;
+  }
+  if (args['day-pager'] !== undefined) {
+    const v = String(args['day-pager']).trim();
+    patch.dayPager = !v || v === 'off' || v === 'false' ? null : { dateProp: v };
+  }
   if (!Object.keys(patch).length) {
-    throw new Error(tr('바꿀 것을 주세요: --scale week|month|year, --name 새이름, --cards "칸,칸", --density compact|normal 또는 --freeze 0~3', `Give something to change: --scale week|month|year, --name <new name>, --cards "field,field", --density compact|normal, or --freeze 0-3`));
+    throw new Error(tr('바꿀 것을 주세요: --scale week|month|year, --name 새이름, --cards "칸,칸", --density compact|normal, --freeze 0~3, --row-hidden on|off, --quick "칸,칸", --entry-row on|off 또는 --day-pager 날짜칸|off', `Give something to change: --scale week|month|year, --name <new name>, --cards "field,field", --density compact|normal, --freeze 0-3, --row-hidden on|off, --quick "field,field", --entry-row on|off, or --day-pager <date field>|off`));
   }
 
   const view = await client.updateDatabaseView(id, viewRef, patch);
@@ -3094,6 +3144,11 @@ async function cmdDbButtons(args) {
     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;
+      if (i === 0 && b.input) {
+        // BTN-INPUT — 누르면 글부터 받는 버튼. button-run 에 --input 이 필요하다는 것을 여기서 보인다.
+        const split = b.input.split ? ` · ${tr('나누기', 'split')}: ${b.input.split.by}${b.input.split.separator ? ` "${b.input.split.separator}"` : ''}` : '';
+        console.log(`  ${tr('글 받기', 'asks for text')}: "${b.input.label}"${split} ${tr('(button-run --input)', '(button-run --input)')}`);
+      }
       const where = st.target ? ` · ${WHERE[st.target] ?? st.target}` : '';
       const detail =
         st.kind === 'ai_fill'
@@ -3119,7 +3174,7 @@ async function cmdDbButtonRun(args) {
   const target = args._[1];
   const buttonId = args._[2];
   if (!target || !buttonId) {
-    throw new Error(usage(`rootr db button-run <path|id> <buttonId> [--rows id1,id2] [--json]`));
+    throw new Error(usage(`rootr db button-run <path|id> <buttonId> [--rows id1,id2] [--input <글> | --input-file <파일> | --input -] [--json]`));
   }
   const client = makeClient();
   const id = await resolveDatabaseId(client, target);
@@ -3127,8 +3182,17 @@ async function cmdDbButtonRun(args) {
     typeof args.rows === 'string'
       ? args.rows.split(',').map((x) => x.trim()).filter(Boolean)
       : undefined;
-
-  const r = await client.runDatabaseButton(id, buttonId, { rowIds });
+  // BTN-INPUT — 글을 받는 버튼에 넣을 글. 여러 줄 원문은 파일이나 표준입력(`--input -`)으로.
+  const input =
+    typeof args['input-file'] === 'string'
+      ? readFileSync(args['input-file'], 'utf8')
+      : args.input === '-'
+        ? await readStdin()
+        : typeof args.input === 'string'
+          ? args.input
+          : undefined;
+
+  const r = await client.runDatabaseButton(id, buttonId, { rowIds, input });
   if (args.json) {
     console.log(JSON.stringify(r, null, 2));
     return;
@@ -3154,6 +3218,11 @@ async function cmdDbButtonRun(args) {
     );
   for (const n of r.notes ?? []) console.log(`· ${n}`);
   if (r.linkWarning) console.log(`· ${r.linkWarning}`);
+  // BTN-INPUT — 여러 건으로 나눠 돌렸으면 몇 건이 됐는지, 막힌 건은 몇 번째가 왜.
+  if (r.records) {
+    console.log(tr(`${r.records.total}건 중 ${r.records.done}건 실행`, `${r.records.done} of ${r.records.total} items ran`));
+    for (const e of r.records.errors ?? []) console.log(tr(`· ${e.index}번째 건 실패 — ${e.message}`, `· item ${e.index} failed — ${e.message}`));
+  }
 }
 
 

package/lib/client.js

@@ -643,10 +643,11 @@ export class RootrClient {
   }
 
   /** 버튼 한 번 누르기. `rowIds` 는 "고른 행"을 대상으로 하는 단계가 있을 때만 쓴다. */
-  async runDatabaseButton(databaseId, buttonId, { rowIds } = {}) {
+  async runDatabaseButton(databaseId, buttonId, { rowIds, input } = {}) {
+    // BTN-INPUT — 글을 받는 버튼이면 그 글(`{@input}` 자리). 안 받는 버튼에는 싣지 않는다(서버가 400 으로 말한다).
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/buttons/${encodeURIComponent(buttonId)}/run`,
-      { method: 'POST', body: { rowIds } },
+      { method: 'POST', body: { rowIds, ...(input !== undefined ? { input } : {}) } },
     );
   }
 
@@ -1132,11 +1133,11 @@ export class RootrClient {
    */
   async createDatabaseView(
     databaseId,
-    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns } = {},
+    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns, rowPaneShowHidden, quickFilters, entryRow, dayPager } = {},
   ) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/views`, {
       method: 'POST',
-      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns },
+      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns, rowPaneShowHidden, quickFilters, entryRow, dayPager },
     });
   }
 
@@ -1318,14 +1319,14 @@ export class RootrClient {
   async updateColumn(
     databaseId,
     propertyId,
-    { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, validate, identifyProps } = {},
+    { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, keySync, validate, identifyProps } = {},
   ) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}`,
       {
         method: 'PATCH',
         // identifyProps — 제목 칸만: 다른 표에서 이 표의 행을 고를 때 제목 옆에 붙일 칸(REL-PICK-IDENTIFY).
-        body: { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, validate, identifyProps },
+        body: { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, keySync, validate, identifyProps },
       },
     );
   }
@@ -1995,6 +1996,12 @@ export class RootrClient {
     return this.request(`/forms/${encodeURIComponent(formId)}`);
   }
 
+  /** FORM-REL-PICK — "다른 표에서 고르기" 질문의 고를 행 목록(그 표를 읽을 수 있으면 표 전체에서). */
+  async formRelationOptions(formId, fieldId, q = '') {
+    const qs = new URLSearchParams({ field: fieldId, q });
+    return this.request(`/forms/${encodeURIComponent(formId)}/relation-options?${qs}`);
+  }
+
   /** Merge-patch fields/targetDatabaseId/config/icon. */
   async updateForm(formId, { fields, targetDatabaseId, config, icon } = {}) {
     return this.request(`/forms/${encodeURIComponent(formId)}`, {

package/lib/mcp-tools/databases.js

@@ -81,6 +81,50 @@ const SORT_SHAPE = z.object({
 
 const SORT_DESC = 'Row order in this view.';
 
+/**
+ * VIEW-ROW-SHOW-HIDDEN · VIEW-QUICK-FILTER · VIEW-ENTRY-ROW · VIEW-DAY-PAGER — 표 보기 설정 넷. 만들기(rootr_create_view)와
+ * 고치기(rootr_update_view)가 같은 모양을 쓴다(한쪽만 고치면 "만들 때는 되는데 바꿀 때는 안 된다"가 된다).
+ */
+const VIEW_EXTRA_SHAPE = {
+  rowPaneShowHidden: z
+    .boolean()
+    .nullable()
+    .optional()
+    .describe(
+      'Columns hidden in THIS view (hiddenProps) are hidden in the table only — when a row is opened (side pane / row page) ' +
+        'they are shown expanded instead of folded under "N hidden". false/null = default (folded).',
+    ),
+  quickFilters: z
+    .array(z.string())
+    .max(6)
+    .nullable()
+    .optional()
+    .describe(
+      'Columns pinned at the TOP of the filter panel (names or ids, in order, up to 6). Each gets a direct input with no ' +
+        'operator picker: text/title/phone/email/url → "contains", select/status → "is" (pick an option), multi_select/person → ' +
+        'has value, relation → pick linked rows, date → that day. null or [] turns it off.',
+    ),
+  entryRow: z
+    .boolean()
+    .nullable()
+    .optional()
+    .describe(
+      'table view: keep one always-empty entry row at the bottom (spreadsheet-like). Typing a value into any of its cells ' +
+        'creates the row (pre-filled to match the view filters, like the "new row" button) and a fresh empty row appears. ' +
+        'Focus/click alone creates nothing. false/null = off.',
+    ),
+  dayPager: z
+    .union([z.object({ dateProp: z.string() }), z.string()])
+    .nullable()
+    .optional()
+    .describe(
+      'table view: show ONE DAY at a time — {dateProp: "<date column name or id>"} (must be a date column). A bar with ' +
+        '◀ date ▶ / Today / date picker appears; only rows whose date falls on the chosen day are listed (combined with the ' +
+        'view filters, applied server-side so counts/paging stay right on big tables), rows created in the view get that ' +
+        'day, and "search all dates" lifts the day limit. View filters on that same date column are replaced by the pager. null = off.',
+    ),
+};
+
 /**
  * DB-BODY — 행의 상세 내용(본문 메모). 화면에서 칸반 카드를 열면 속성 아래에 붙는 그 글이며,
  * 실체는 표 밑에 달리는 문서 하나다. 예전에는 REST 2단계로만 닿을 수 있어서 CLI·MCP에서는
@@ -197,6 +241,7 @@ export function registerDatabaseTools(server) {
                 .object({
                   relation: z.string(),
                   property: z.string().optional(),
+                  sameKey: z.string().optional().describe('a key column (title/text/phone/email/url, name or id): also gather what the OTHER rows with the same key value link to (deduplicated) — per-person totals when one person has several rows'),
                   function: z.enum([
                     'count',
                     'count_values',
@@ -342,9 +387,10 @@ export function registerDatabaseTools(server) {
             'table view: keep the first N VISIBLE columns fixed on the left while scrolling sideways (Excel freeze panes). ' +
               '0/null = off. e.g. 1 keeps the title column (상호명) in place.',
           ),
+        ...VIEW_EXTRA_SHAPE,
       },
     },
-    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns }) => {
+    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns, rowPaneShowHidden, quickFilters, entryRow, dayPager }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -360,6 +406,10 @@ export function registerDatabaseTools(server) {
           calendarScale,
           density,
           frozenColumns,
+          rowPaneShowHidden,
+          quickFilters,
+          entryRow,
+          dayPager,
         });
         return jsonResult(view);
       } catch (err) {
@@ -404,7 +454,9 @@ export function registerDatabaseTools(server) {
         'Columns may be given by NAME or id; the title column cannot be hidden and is ignored if listed. ' +
         'Pass an empty array to show everything again. Only the fields you pass change, and other views are untouched. ' +
         'For an at-a-glance table also pass density "compact" (lower rows, smaller text) and frozenColumns N (first N visible ' +
-        'columns stay fixed while scrolling sideways).',
+        'columns stay fixed while scrolling sideways). Data-entry helpers: rowPaneShowHidden (hidden columns still show when a row ' +
+        'is opened), quickFilters (columns pinned at the top of the filter panel, just type), entryRow (always-empty bottom row, ' +
+        'Excel-like) and dayPager {dateProp} (one day per page with ◀ ▶ / Today, new rows get that day).',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
@@ -474,6 +526,7 @@ export function registerDatabaseTools(server) {
             'table view: keep the first N VISIBLE columns fixed on the left while scrolling sideways (Excel freeze panes). ' +
               '0/null = off. e.g. 1 keeps the title column (상호명) in place.',
           ),
+        ...VIEW_EXTRA_SHAPE,
       },
     },
     async ({
@@ -492,6 +545,10 @@ export function registerDatabaseTools(server) {
       rowColors,
       density,
       frozenColumns,
+      rowPaneShowHidden,
+      quickFilters,
+      entryRow,
+      dayPager,
     }) => {
       try {
         const client = makeClient();
@@ -510,6 +567,10 @@ export function registerDatabaseTools(server) {
           rowColors,
           density,
           frozenColumns,
+          rowPaneShowHidden,
+          quickFilters,
+          entryRow,
+          dayPager,
         });
         return jsonResult({ view });
       } catch (err) {
@@ -980,6 +1041,8 @@ export function registerDatabaseTools(server) {
         '"how many of this applicant\'s calls were no-answer": { relation: "콜", function: "count", ' +
         'where: [{ property: "결과", op: "is", value: "부재" }] }. ' +
         'A rollup may also read a FORMULA column in the linked table, and min/max work on date columns ' +
+        '(sameKey: "<key column>" also gathers the links of the other rows with the same key value — e.g. "all calls of this person" when ' +
+        'the same phone has several rows; nothing is copied, each linked row counts once) ' +
         '(that is how "last call date" is built). ' +
         'For unique_id pass prefix to get "TASK-42" style ids. ' +
         'For vector pass dimensions — an embedding column YOU fill with rootr_set_row_vectors and search with ' +
@@ -1040,6 +1103,7 @@ export function registerDatabaseTools(server) {
         rollup: z
           .object({
             relation: z.string().describe('the relation column (id or name) to follow'),
+            sameKey: z.string().optional().describe('a key column (title/text/phone/email/url, name or id): also gather what the OTHER rows with the same key value link to (deduplicated) — per-person totals when one person has several rows'),
             property: z.string().optional().describe('the column to read in the linked table'),
             function: z.enum([
               'count',
@@ -1194,7 +1258,7 @@ export function registerDatabaseTools(server) {
         rollup: z
           .record(z.any())
           .optional()
-          .describe('rollup only: { relation, property?, function, where? } — replaces the whole config'),
+          .describe('rollup only: { relation, property?, function, where?, sameKey? } — replaces the whole config'),
         prefix: z.string().optional().describe('unique_id only: the new prefix'),
         type: z.string().optional().describe('Not changeable — passing it is refused with the reason'),
         dimensions: z.number().optional().describe('Not changeable (vector only) — passing it is refused with the reason'),
@@ -1277,6 +1341,19 @@ export function registerDatabaseTools(server) {
             'relation only: which rows of the linked table may be linked (all rules must match; propId is a column of the LINKED table). ' +
               'e.g. [{propId:"진행상태",op:"is",values:["채용"]}]. The picker hides others and the server refuses new links that fail. null turns it off.',
           ),
+        keySync: z
+          .record(z.any())
+          .nullable()
+          .optional()
+          .describe(
+            'On a KEY column (title/text/phone/email/url): keep rows that share the same key value (e.g. the same phone kept as several ' +
+              'rows) in step. { columns: { "<column>": "mirror" | "append" | "items" } } (names or ids, ≤20). After a row is EDITED (cell, ' +
+              'row panel, bulk edit, button, automation, REST/MCP, or a link made from the other side of a two-way relation) the change is ' +
+              'copied to the other rows with the same key: mirror = copy the changed value; append (text/title) = append only the newly ' +
+              'added text, skipped if the other row already has it; items (relation/multi_select) = add the added items, remove the removed ' +
+              'ones. Not on row creation, key changes, imports, restores or merges; copied writes do not wake automations (no loops). ' +
+              'Keys compare like dedupe. Existing differences are not back-filled. null turns it off.',
+          ),
         dedupeCarry: z
           .record(z.any())
           .nullable()
@@ -1359,6 +1436,7 @@ export function registerDatabaseTools(server) {
       allowTime,
       allowRange,
       dedupeCarry,
+      keySync,
       validate,
       identifyProps,
       type,
@@ -1400,6 +1478,7 @@ export function registerDatabaseTools(server) {
           allowTime,
           allowRange,
           dedupeCarry,
+          keySync,
           validate,
           identifyProps,
         });
@@ -1984,6 +2063,15 @@ export function registerDatabaseTools(server) {
         'is exactly "{관계 칸}" and the column it goes into is a relation to the SAME table: then the row ids are ' +
         'copied (e.g. 담당 매니저: "{배정 매니저}"). Ids the receiving column\'s relationFilter rejects are left out ' +
         'of that cell only (the rest still runs), commented on the row and reported in `notes`.\n' +
+        'ASK FOR TEXT FIRST: give the button `input: { label, placeholder?, multiline?, required?, split? }` and ' +
+        'pressing it opens a text box (label = the prompt; required defaults to true = empty text does not run). ' +
+        'The text goes wherever a step writes {@input} — add_row/update_rows values (e.g. {"원문":"{@input}"}) or ' +
+        'an ai_fill prompt — so "paste the raw text → a new row holds it → ai_fill target:\"created\" parses it into ' +
+        'the other columns" is one press with NO row selected. `split` runs the steps once PER ITEM when several are ' +
+        'pasted together: {by:"blank_line"}, {by:"separator", separator:"---"} or {by:"ai"} (AI only returns where ' +
+        'each item starts; the text itself is cut server-side); max 50 items. Saving is refused when a step uses ' +
+        '{@input} but the button has no `input`, or the button has `input` but no step uses {@input}. Automations ' +
+        'cannot use {@input}.\n' +
         'A button never grants permission: it runs as whoever presses it — writing into another table needs ' +
         'write access there too.',
       annotations: { readOnlyHint: false, destructiveHint: true },
@@ -1995,6 +2083,23 @@ export function registerDatabaseTools(server) {
               id: z.string().optional().describe('Keep an existing button by passing its id; omit to create one'),
               label: z.string().describe('Button text, e.g. "접수"'),
               icon: z.string().optional().describe('One emoji shown on the button'),
+              input: z
+                .object({
+                  label: z.string().describe('Prompt shown above the text box, e.g. "붙여 넣을 원문"'),
+                  placeholder: z.string().optional().describe('Greyed-out example inside the box'),
+                  multiline: z.boolean().optional().describe('Multi-line text area (default single line)'),
+                  required: z.boolean().optional().describe('Default true — empty text does not run'),
+                  split: z
+                    .union([
+                      z.object({ by: z.literal('blank_line') }),
+                      z.object({ by: z.literal('separator'), separator: z.string() }),
+                      z.object({ by: z.literal('ai') }),
+                    ])
+                    .optional()
+                    .describe('Run once per item when several are pasted together (max 50)'),
+                })
+                .optional()
+                .describe('Ask for text when pressed; steps use it as {@input}. Omit for a plain button.'),
               steps: z
                 .array(z.record(z.any()))
                 .describe('Ordered steps — see the tool description for each kind (max 8)'),
@@ -2028,7 +2133,10 @@ export function registerDatabaseTools(server) {
         'with the reason (the rest of the button still ran). `aiSkipped` counts rows where the AI answered but the ' +
         'answer could not go in the cell (e.g. not one of a select\'s options), with one sample in `aiSkippedAnswer`; ' +
         '`aiUnchanged` counts rows whose AI answer equals the current value (left as is, not counted in `filled`). ' +
-        'It runs with YOUR permissions: a button that writes a locked column stops there if you cannot edit it.',
+        'It runs with YOUR permissions: a button that writes a locked column stops there if you cannot edit it. ' +
+        'A button with `input` (see rootr_list_database_buttons) needs `input` — the text a person would paste into its ' +
+        'box; it fills {@input}. With `input.split` the result also has `records: { total, done, failed, errors: ' +
+        '[{ index, message }] }` (an item that fails is rolled back on its own; the others stay).',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
@@ -2037,13 +2145,17 @@ export function registerDatabaseTools(server) {
           .array(z.string())
           .optional()
           .describe('Rows for steps whose target is "selected". Omit for buttons that only add rows.'),
+        input: z
+          .string()
+          .optional()
+          .describe('Text for a button that asks for input (its `input` config) — fills {@input}. Max 30,000 chars.'),
       },
     },
-    async ({ databaseId, buttonId, rowIds }) => {
+    async ({ databaseId, buttonId, rowIds, input }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
-        return jsonResult(await client.runDatabaseButton(id, buttonId, { rowIds }));
+        return jsonResult(await client.runDatabaseButton(id, buttonId, { rowIds, input }));
       } catch (err) {
         return errorResult(err);
       }

package/lib/mcp-tools/forms.js

@@ -12,7 +12,7 @@ const fieldShape = z
       .enum([
         'text', 'textarea', 'number', 'select', 'multi_select', 'checkbox', 'date',
         'email', 'phone', 'url', 'rating', 'scale', 'time', 'file',
-        'matrix', 'ranking', 'csat', 'nps',
+        'matrix', 'ranking', 'csat', 'nps', 'relation',
       ])
       .describe('Field input type'),
     required: z.boolean().optional().describe('Whether the field must be filled in'),
@@ -23,8 +23,18 @@ const fieldShape = z
       .describe('Choices for select/multi_select/matrix/ranking fields'),
     help: z.string().optional().describe('One line under the question, e.g. "예: 010-0000-0000"'),
     placeholder: z.string().optional().describe('Greyed-out example inside the input'),
-    min: z.number().optional().describe('rating/scale only: lowest number (rating 1, scale 0 or 1)'),
-    max: z.number().optional().describe('rating/scale only: highest number (rating 5, scale 10). 2–10.'),
+    min: z
+      .number()
+      .optional()
+      .describe('rating/scale: lowest number (rating 1, scale 0 or 1). number: smallest accepted answer — below it the submission is REFUSED (400).'),
+    max: z
+      .number()
+      .optional()
+      .describe('rating/scale: highest number (rating 5, scale 10; 2–10). number: largest accepted answer — above it the submission is REFUSED.'),
+    rangeMessage: z
+      .string()
+      .optional()
+      .describe('number only: sentence shown when the answer is outside min/max (≤200 chars). Default "N 이상 M 이하로 적어 주세요".'),
     rows: z.array(z.string()).optional().describe('matrix only: the rows down the left side'),
     page: z.number().optional().describe('Which page this question is on (1-based). Split a long form.'),
     hidden: z
@@ -38,7 +48,19 @@ const fieldShape = z
     multiple: z
       .boolean()
       .optional()
-      .describe('file only: true = accept SEVERAL files; the answer becomes an array of { id, filename, size }. Default: one file.'),
+      .describe('file: true = accept SEVERAL files (answer = array of { id, filename, size }). relation: true = pick several rows. Default: one.'),
+    relationDatabaseId: z
+      .string()
+      .optional()
+      .describe('relation only: table (id or "/path") to pick rows from. Omit to use the table that the response table\'s relation column (same name / field map) points to.'),
+    publicPick: z
+      .object({
+        enabled: z.boolean(),
+        showProps: z.array(z.string()).max(2).optional(),
+        filter: z.array(z.object({ propId: z.string(), op: z.enum(['is', 'is_not_empty']), values: z.array(z.string()).optional() })).optional(),
+      })
+      .optional()
+      .describe('relation only: let people WITHOUT access to the table (public link) search and pick. Off by default. Even on: a 2+ char search is required, ≤20 rows, only the title + `showProps` (≤2 column names) are shown, `filter` adds conditions on top of the relation column\'s relationFilter.'),
     maxFiles: z
       .number()
       .optional()
@@ -65,6 +87,18 @@ const FIELDS_GUIDE =
   'Per-field extras: `help` (a hint line), `placeholder`, `page` (split into multiple pages), `hidden` + URL ' +
   'params (record the traffic source), `showIf` (show only when an earlier answer matches), `range: false` on a ' +
   'date field (ask for ONE date — by default a date field also shows an optional end date). ' +
+  '`relation` = PICK ROWS FROM ANOTHER TABLE: respondents search the table (`relationDatabaseId`, or the table the ' +
+  'response table\'s relation column points to) and pick a row (`multiple: true` for several); the answer is stored as ' +
+  '{ id, title } and lands as a real link in the response table\'s relation column. Only `relation` questions can go ' +
+  'into a relation column (a text question there is reported as "can\'t go in" by the mapping). Picking is for members who ' +
+  'can read that table; set `publicPick: { enabled: true, showProps? }` to allow it on the public link too. To answer one ' +
+  'via API, find row ids with `rootr form pick` / GET /v1/forms/:id/relation-options?field=&q= (or rootr_pick_rows on the ' +
+  'table) and send the row id (or an array). ' +
+  '`min`/`max` on a ' +
+  'number field (an allowed range — answers outside it are REFUSED on every submit path, public link included; ' +
+  'decimals ok; either side may be omitted) with optional `rangeMessage` (what the respondent reads instead of the ' +
+  'default "N 이상 M 이하로 적어 주세요"). This blocks the form only — a column `validate` rule on the linked table ' +
+  'just warns. ' +
   'Read the form first (rootr_read_form) before updating so ' +
   'you keep each field\'s `id` stable — response values are keyed by field id, so renaming/dropping an id orphans ' +
   'past responses\' answers for that field.';
@@ -234,7 +268,9 @@ export function registerFormTools(server) {
         'exact field ids and types. File questions: upload each file first (rootr_upload_attachment, or ' +
         'rootr_create_upload_url → PUT → rootr_complete_upload) and pass `{ id, filename }` — an ARRAY of those when ' +
         'the field has `multiple: true` (more than `maxFiles` is refused; several files on a single-file question is ' +
-        'refused). Images in a text answer with `allowImages` go in as markdown: `![name](url)` using the upload\'s url.',
+        'refused). Images in a text answer with `allowImages` go in as markdown: `![name](url)` using the upload\'s url. ' +
+        '"relation" (pick from another table) questions take the picked row id — or an array of ids when `multiple` — ' +
+        'found with rootr_pick_rows on that table; rows that do not exist, you cannot see, or break the column\'s condition are refused (400).',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         formId: z.string().describe(`FORM node id${NODE_TARGET_HINT}`),
@@ -394,7 +430,9 @@ export function registerFormTools(server) {
         'point of this tool — `unmatched`: the questions with NO column, whose answers are silently dropped ' +
         'when someone submits. Check this right after linking a form to a table or renaming anything: a ' +
         'mismatch produces no error anywhere, and the loss is usually found weeks later. ' +
-        '`how` is "manual" (someone chose it), "auto" (names matched) or "none" (dropped). ' +
+        '`how` is "manual" (someone chose it), "auto" (names matched), "none" (dropped) or "unfit" (the name matches ' +
+        'but the column cannot take that question — e.g. a text question on a relation column; `why` says so, and it ' +
+        'counts as dropped: change the question to `relation` or pin another column). ' +
         '`lastError` carries why the most recent submission failed to reach the table, if it did.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
@@ -421,7 +459,8 @@ export function registerFormTools(server) {
         'Questions you leave out keep matching BY NAME, and passing null for one puts it back to automatic. ' +
         'Use this whenever the question wording differs from the column header ("성함" vs "이름") — otherwise ' +
         'that answer is dropped with no warning. Call rootr_form_mapping first for the ids and the current state. ' +
-        'A field or column that does not exist is refused, not ignored.',
+        'A field or column that does not exist is refused, not ignored. A relation column only takes a `relation` ' +
+        '(pick from another table) question pointing at the same table.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         formId: z.string().describe(`FORM node id${NODE_TARGET_HINT}`),

package/lib/mcp-tools/workspaces.js

@@ -44,7 +44,8 @@ const ACCESS_HINT =
   'A phone/email/name property may carry `dedupe: true` (warn when the same person is entered again) with ' +
   '`dedupeShow: ["상태","메모","통화 기록"]` (fields of the existing row the warning shows — a relation shows its latest 5 rows) and ' +
   '`dedupeCarry: { label: "재등록", action: "carry"|"merge_into_old"|"merge_all"|"ask", sources: "all", columns: { "메모": { append: { sep: " / " } } }, exclude: ["접수일"], mark: { "재등록 여부": true, "구분": { map: { "A": "A(재등록)" }, else: "{value} (재등록)" } }, cases: [{ when: { within: { column: "접수일", days: 0 } }, action: "merge_all", mark: {} }, { action: "carry" }] }` ' +
-  '(same entry came back: copy the earlier row into the new one — see rootr_update_column); any property may carry ' +
+  '(same entry came back: copy the earlier row into the new one — see rootr_update_column); a key property (title/text/phone/email/url) may carry ' +
+  '`keySync: { columns: { "상태": "mirror", "메모": "append", "연락 기록": "items" } }` (rows sharing that key keep those columns in step after edits — see rootr_update_column); any property may carry ' +
   '`validate: { kind: "pattern"|"range"|"date"|"birthdate", pattern?, flags?, negate?, min?, max?, message? }` (flags a wrong value on every new write, never blocks); ' +
   'a relation property may carry `relationFilter: [{ propId, op: "is"|"is_not_empty", values? }]` (which linked rows may be picked). ' +
   'The title property may carry `identifyProps: [{ propId: "연락처", mask: "last4" }, { propId: "지원일" }]` (shown next to the name ' +
@@ -54,6 +55,9 @@ const ACCESS_HINT =
   'Any property may carry `align: "left"|"center"|"right"` and `wrap: true`; a date property `highlightOverdue: true` ' +
   '(past dates red — off by default), `allowTime: false` (no time) and `allowRange: false` (no end date). A table view ' +
   'config may carry `density: "compact"` and `frozenColumns: 1` (first N visible columns fixed while scrolling sideways). ' +
+  'Data-entry table views may also carry `entryRow: true` (always-empty bottom row), `dayPager: {dateProp: "<date column>"}` ' +
+  '(one day at a time), `quickFilters: ["<column>", …]` (pinned at the top of the filter panel, max 6) and `rowPaneShowHidden: true` ' +
+  '(columns hidden in the view still show when a row is opened). ' +
   'A PAGE node may carry `page.analytics: true` (visit tracking — an "Analytics" folder with a visit LOG, a daily visits table and a dashboard is created next to it; records once published). ' +
   'A DOCUMENT\'s `content` may embed a live ' +
   'table/sheet/deck with a line `[[embed:<name of a node in this same tree>]]` or `[[embed:/absolute/path]]` — it is ' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "Official Rootr CLI + MCP server — read, write, edit and search Rootr documents from the shell or from an AI agent.",
   "type": "module",
   "bin": {