rootr-cli 0.8.0 → 0.8.1

package/README.md

@@ -296,15 +296,20 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 
 | 도구 | 설명 |
 |---|---|
-| `rootr_read_database` | 스키마(열 정의)+행 전체 읽기 — **다른 표 도구를 쓰기 전에 먼저** |
-| `rootr_list_rows` | 행만 조회(스키마 제외) |
-| `rootr_add_row` | 행 추가 (`values`는 열 이름 또는 id로 지정) |
-| `rootr_update_row` | 행 수정 (칸반 카드 이동 = select 열 값 변경) |
+| `rootr_read_database` | 스키마(열 정의)+행 전체 읽기 — **다른 표 도구를 쓰기 전에 먼저** (`includeBody: true` 면 행마다 상세 내용까지) |
+| `rootr_list_rows` | 행만 조회(스키마 제외, `includeBody` 지원) |
+| `rootr_add_row` | 행 추가 (`values`는 열 이름 또는 id로 지정, `body`로 상세 내용까지) |
+| `rootr_update_row` | 행 수정 (칸반 카드 이동 = select 열 값 변경, `body`로 상세 내용 교체) |
 | `rootr_delete_row` | 행 삭제 |
 | `rootr_add_column` | **열 추가** — 기존 열·행은 그대로 |
 | `rootr_update_column` | 열 이름 변경 / select 선택지 교체 |
 | `rootr_delete_column` | 열 삭제(파괴적) |
 
+행의 **상세 내용(본문 메모)** — 화면에서 칸반 카드를 열면 속성 아래에 적는 그 글 — 은
+`body`로 오갑니다. 실체는 표 밑에 달리는 문서 한 장이고, 없으면 쓸 때 만들어집니다.
+명령줄에서도 됩니다: `rootr db row-add <표> --values '{"제목":"킥오프"}' --body "..."`,
+`rootr db row-body <표> <rowId> --file memo.md`, `rootr db rows <표> --body`.
+
 열은 **한 번에 하나씩** 다룹니다. REST의 `PATCH /databases/:id`는 `properties`
 배열을 통째로 교체하기 때문에, 에이전트가 배열을 다시 만들다 빠뜨린 열이 그대로
 사라집니다. 위 세 도구는 서버가 병합하므로 나머지 열이 없어지지 않습니다.

package/bin/rootr.js

@@ -27,6 +27,9 @@ const USAGE = `Rootr CLI v${pkg.version}
   rootr use <id|이름|주소>                          활성 워크스페이스 전환 (그 워크스페이스용 키도 기억)
   rootr ask <question> [--workspace <w>]           GraphRAG 질의응답 (RCA), 인용 포함 출력
   rootr db create [--file <spec.json>] [--parent <path|id>]  표(DATABASE) 생성 — 컬럼 순서 그대로, 행까지 한 번에
+  rootr db rows <path|id> [--body] [--json]        표의 행 목록 (--body: 상세 내용까지)
+  rootr db row-add <path|id> --values '<json>' [--body <md>|--body-file <f>]  행 추가(상세 내용 포함)
+  rootr db row-body <path|id> <rowId> [--file <f>] 행의 상세 내용(본문 메모) 쓰기 — 없으면 표준입력
   rootr config [--api-key <k>] [--workspace <w>] [--base-url <u>]  설정 조회/저장
   rootr config --add-key <k> [--label <name>] [--workspace <w>]     워크스페이스별 키 추가 등록
   rootr mcp                                        MCP stdio 서버 구동 (도구 90종+ — README 참고)
@@ -444,8 +447,13 @@ async function cmdMcp() {
  */
 async function cmdDb(args) {
   const sub = args._[0];
+  if (sub === 'rows') return cmdDbRows(args);
+  if (sub === 'row-add') return cmdDbRowAdd(args);
+  if (sub === 'row-body') return cmdDbRowBody(args);
   if (sub !== 'create') {
-    throw new Error('사용법: rootr db create [--file <spec.json>] [--parent <path|id>] [--ws <id>]');
+    throw new Error(
+      '사용법: rootr db create|rows|row-add|row-body … (자세한 건 rootr --help)',
+    );
   }
   const raw = typeof args.file === 'string' ? readFileSync(args.file, 'utf8') : await readStdin();
   let spec;
@@ -472,6 +480,84 @@ async function cmdDb(args) {
   if (cols) console.log(`컬럼 순서: ${cols}`);
   if (typeof db.rowCount === 'number') console.log(`행: ${db.rowCount}개`);
 }
+
+/** 표의 행 목록. --body 를 주면 행마다 상세 내용(본문 메모)까지 가져온다. */
+async function cmdDbRows(args) {
+  const target = args._[1];
+  if (!target) throw new Error('사용법: rootr db rows <path|id> [--body] [--json]');
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const rows = await client.listRows(id, { withBody: !!args.body });
+  if (args.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  for (const row of rows) {
+    const values = Object.values(row.values || {})
+      .map((v) => (v && typeof v === 'object' ? JSON.stringify(v) : String(v)))
+      .join(' | ');
+    console.log(`${row.id}\t${values}`);
+    if (args.body && row.body) {
+      for (const line of String(row.body).trimEnd().split('\n')) console.log(`    ${line}`);
+    }
+  }
+}
+
+/** 행 추가. 값은 JSON으로, 상세 내용(본문 메모)은 --body / --body-file 로. */
+async function cmdDbRowAdd(args) {
+  const target = args._[1];
+  if (!target || typeof args.values !== 'string') {
+    throw new Error("사용법: rootr db row-add <path|id> --values '{\"제목\":\"...\"}' [--body <md>|--body-file <f>]");
+  }
+  let values;
+  try {
+    values = JSON.parse(args.values);
+  } catch {
+    throw new Error('--values 는 JSON이어야 합니다. 예: --values \'{"제목":"킥오프"}\'');
+  }
+  const body =
+    typeof args['body-file'] === 'string'
+      ? readFileSync(args['body-file'], 'utf8')
+      : typeof args.body === 'string'
+        ? args.body
+        : undefined;
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const row = await client.createRow(id, { values, body });
+  console.log(`행 추가: ${row.id}`);
+  if (row.pageNodeId) console.log(`상세 내용 문서: ${row.pageNodeId}`);
+}
+
+/** 행의 상세 내용(본문 메모)을 통째로 쓴다. 내용은 인자·--file·표준입력 순으로 받는다. */
+async function cmdDbRowBody(args) {
+  const target = args._[1];
+  const rowId = args._[2];
+  if (!target || !rowId) {
+    throw new Error('사용법: rootr db row-body <path|id> <rowId> [<본문>] [--file <f>]');
+  }
+  const body =
+    typeof args.file === 'string'
+      ? readFileSync(args.file, 'utf8')
+      : args._[3] !== undefined
+        ? String(args._[3])
+        : await readStdin();
+  if (!body) throw new Error('쓸 내용이 없습니다 (본문 인자, --file, 또는 표준입력 필요).');
+  const client = makeClient();
+  const id = await resolveDatabaseId(client, target);
+  const row = await client.updateRow(id, rowId, { body });
+  console.log(`상세 내용 저장: 행 ${rowId}${row.pageNodeId ? ` → 문서 ${row.pageNodeId}` : ''}`);
+}
+
+/** 경로로 줘도 되게 — 표 인자도 문서 도구들과 같은 규칙을 따른다. */
+async function resolveDatabaseId(client, target) {
+  if (typeof target === 'string' && target.startsWith('/')) {
+    const resolved = await resolveTarget(client, target);
+    if (!resolved.existed) throw new Error(`표를 찾을 수 없습니다: ${target}`);
+    return resolved.id;
+  }
+  return target;
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   const args = parseArgs(argv);

package/lib/client.js

@@ -618,25 +618,29 @@ export class RootrClient {
     return this.request(`/databases/${encodeURIComponent(databaseId)}`);
   }
 
-  /** All rows of a database, in position order. Returns the raw rows array. */
-  async listRows(databaseId) {
-    const data = await this.request(`/databases/${encodeURIComponent(databaseId)}/rows`);
+  /**
+   * All rows of a database, in position order. Returns the raw rows array.
+   * DB-BODY — `withBody` 를 주면 행마다 상세 내용(본문 메모)까지 함께 온다.
+   */
+  async listRows(databaseId, { withBody = false } = {}) {
+    const query = withBody ? '?body=1' : '';
+    const data = await this.request(`/databases/${encodeURIComponent(databaseId)}/rows${query}`);
     if (Array.isArray(data)) return data;
     if (data && Array.isArray(data.rows)) return data.rows;
     return [];
   }
 
-  async createRow(databaseId, { values, position } = {}) {
+  async createRow(databaseId, { values, position, body } = {}) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/rows`, {
       method: 'POST',
-      body: { values, position },
+      body: { values, position, body },
     });
   }
 
-  async updateRow(databaseId, rowId, { values, position } = {}) {
+  async updateRow(databaseId, rowId, { values, position, body } = {}) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}`,
-      { method: 'PATCH', body: { values, position } },
+      { method: 'PATCH', body: { values, position, body } },
     );
   }
 

package/lib/mcp-tools/databases.js

@@ -13,6 +13,15 @@ import {
 /** Human text for the `databaseId` param — accepts a path just like the document tools. */
 const DATABASE_TARGET_DESC = `DATABASE node id${NODE_TARGET_HINT} (e.g. "/제작 공정/칸반")`;
 
+/**
+ * DB-BODY — 행의 상세 내용(본문 메모). 화면에서 칸반 카드를 열면 속성 아래에 붙는 그 글이며,
+ * 실체는 표 밑에 달리는 문서 하나다. 예전에는 REST 2단계로만 닿을 수 있어서 CLI·MCP에서는
+ * 아예 손댈 수 없었다.
+ */
+const BODY_DESC =
+  "The row's detail body — the note shown under a kanban card's properties, in markdown " +
+  '(행의 상세 내용/본문 메모). Creates the row\'s page on demand; replaces the whole body.';
+
 /**
  * Resolve a `{propertyNameOrId: value}` map to `{propertyId: value}` using the
  * database schema, so agents can address columns by their human name OR their
@@ -164,15 +173,19 @@ export function registerDatabaseTools(server) {
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        includeBody: z
+          .boolean()
+          .optional()
+          .describe("true → also return each row's detail body (the note under a card). Off by default."),
       },
     },
-    async ({ databaseId }) => {
+    async ({ databaseId, includeBody }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
         const [database, rows] = await Promise.all([
           client.getDatabase(id),
-          client.listRows(id),
+          client.listRows(id, { withBody: includeBody === true }),
         ]);
         return jsonResult({ database, rows });
       } catch (err) {
@@ -191,12 +204,18 @@ export function registerDatabaseTools(server) {
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        includeBody: z
+          .boolean()
+          .optional()
+          .describe("true → also return each row's detail body (the note under a card). Off by default."),
       },
     },
-    async ({ databaseId }) => {
+    async ({ databaseId, includeBody }) => {
       try {
         const client = makeClient();
-        const rows = await client.listRows(await resolveNodeId(client, databaseId));
+        const rows = await client.listRows(await resolveNodeId(client, databaseId), {
+          withBody: includeBody === true,
+        });
         return jsonResult({ rows });
       } catch (err) {
         return errorResult(err);
@@ -212,21 +231,24 @@ export function registerDatabaseTools(server) {
         'Append a row to a Rootr (루터) DATABASE. `values` maps property NAME (or id) → value. ' +
         'Value shapes by type: title/text/url/select/person → string; number → number; multi_select → string[]; ' +
         'checkbox → boolean; date → { start: "YYYY-MM-DD", end? }. A select value is the OPTION NAME. ' +
-        'Call rootr_read_database first to learn the columns. Optionally set `position` to insert at an index.',
+        'Call rootr_read_database first to learn the columns. Optionally set `position` to insert at an index. ' +
+        'Pass `body` to also write the row\'s DETAIL PAGE (the note shown under a kanban card\'s properties) — ' +
+        'that page is created on demand, so a row with `body` is the one-call equivalent of "메모 추가".',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         databaseId: z.string().describe(DATABASE_TARGET_DESC),
         values: z.record(z.unknown()).describe('{ propertyNameOrId: value } for the new row'),
         position: z.number().optional().describe('0-based insert index; appended at the end if omitted'),
+        body: z.string().optional().describe(BODY_DESC),
       },
     },
-    async ({ databaseId, values, position }) => {
+    async ({ databaseId, values, position, body }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
         const database = await client.getDatabase(id);
         const resolved = resolveValueKeys(database.properties || [], values);
-        const row = await client.createRow(id, { values: resolved, position });
+        const row = await client.createRow(id, { values: resolved, position, body });
         return jsonResult(row);
       } catch (err) {
         return errorResult(err);
@@ -249,9 +271,10 @@ export function registerDatabaseTools(server) {
         rowId: z.string().describe('Row id (must belong to the database)'),
         values: z.record(z.unknown()).optional().describe('{ propertyNameOrId: newValue | null } partial patch'),
         position: z.number().optional().describe('New 0-based position for the row'),
+        body: z.string().optional().describe(BODY_DESC),
       },
     },
-    async ({ databaseId, rowId, values, position }) => {
+    async ({ databaseId, rowId, values, position, body }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -260,7 +283,7 @@ export function registerDatabaseTools(server) {
           const database = await client.getDatabase(id);
           resolved = resolveValueKeys(database.properties || [], values);
         }
-        const row = await client.updateRow(id, rowId, { values: resolved, position });
+        const row = await client.updateRow(id, rowId, { values: resolved, position, body });
         return jsonResult(row);
       } catch (err) {
         return errorResult(err);

package/package.json

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