rootr-cli 0.5.0 → 0.6.0

package/README.md

@@ -204,7 +204,7 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 
 ## MCP 서버로 사용하기
 
-`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 29종:
+`rootr mcp`는 stdio로 MCP(Model Context Protocol) 서버를 구동합니다. 제공 도구 96종:
 
 노드를 가리키는 인자(`target`, `databaseId`, `spreadsheetId`, `formId`, `crmId`, `trackerId`,
 `recordingId`, `presentationId`, `whiteboardId`, `logId`, `parentId` 등)는 **노드 id와 경로를 모두**
@@ -282,6 +282,28 @@ rootr ask "왜 결제 실패가 늘었지?" --workspace ws_123
 | `rootr_create_webhook` | 웹훅 생성 — 응답의 secret은 **1회만 노출** |
 | `rootr_delete_webhook` | 웹훅 삭제 |
 
+#### 표(DATABASE) — 행과 열 (docs:read/docs:write)
+
+| 도구 | 설명 |
+|---|---|
+| `rootr_read_database` | 스키마(열 정의)+행 전체 읽기 — **다른 표 도구를 쓰기 전에 먼저** |
+| `rootr_list_rows` | 행만 조회(스키마 제외) |
+| `rootr_add_row` | 행 추가 (`values`는 열 이름 또는 id로 지정) |
+| `rootr_update_row` | 행 수정 (칸반 카드 이동 = select 열 값 변경) |
+| `rootr_delete_row` | 행 삭제 |
+| `rootr_add_column` | **열 추가** — 기존 열·행은 그대로 |
+| `rootr_update_column` | 열 이름 변경 / select 선택지 교체 |
+| `rootr_delete_column` | 열 삭제(파괴적) |
+
+열은 **한 번에 하나씩** 다룹니다. REST의 `PATCH /databases/:id`는 `properties`
+배열을 통째로 교체하기 때문에, 에이전트가 배열을 다시 만들다 빠뜨린 열이 그대로
+사라집니다. 위 세 도구는 서버가 병합하므로 나머지 열이 없어지지 않습니다.
+
+- **열을 추가해도 기존 행 데이터는 건드리지 않습니다** — 새 열은 값이 채워지기 전까지 빈 칸으로 읽힙니다.
+- **열의 `type`은 바꿀 수 없습니다**(모든 행의 값을 다시 써야 하므로). 새 열을 만들어 값을 옮기세요.
+- `title` 열은 추가로 만들 수도, 삭제할 수도 없습니다.
+- 삭제한 열의 값은 행 안에 남아 있지만 화면에는 나오지 않습니다 — 사용자 확인 후 호출하세요.
+
 #### 문서 버전 / 삭제
 
 | 도구 | 설명 |

package/lib/client.js

@@ -565,6 +565,31 @@ export class RootrClient {
     );
   }
 
+  // ---- DB-COL: one column at a time --------------------------------------
+  // PATCH /databases/:id replaces the whole properties array, so rebuilding it
+  // client-side drops any column left out. These merge server-side instead.
+
+  async addColumn(databaseId, { name, type, options } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/columns`, {
+      method: 'POST',
+      body: { name, type, options },
+    });
+  }
+
+  async updateColumn(databaseId, propertyId, { name, options } = {}) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}`,
+      { method: 'PATCH', body: { name, options } },
+    );
+  }
+
+  async deleteColumn(databaseId, propertyId) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}`,
+      { method: 'DELETE' },
+    );
+  }
+
   // ---- CRM ----------------------------------------------------------------
 
   /** Create a CRM node. pipelines/fields/config optional (server fills sane defaults). */

package/lib/mcp-tools/databases.js

@@ -171,4 +171,102 @@ export function registerDatabaseTools(server) {
       }
     },
   );
+
+  // ---- DB-COL: columns ----------------------------------------------------
+  // Row tools above cover the data; these cover the SHAPE. Deliberately one
+  // column per call: the underlying PATCH /databases/:id takes the entire
+  // properties array, and a model rebuilding that array drops whatever it
+  // forgets. Here the server merges, so nothing else in the table can be lost.
+
+  server.registerTool(
+    'rootr_add_column',
+    {
+      title: 'Add a column to a database',
+      description:
+        'Add ONE column to a Rootr (루터) DATABASE. The existing columns and every row are left untouched — ' +
+        'rows simply read empty for the new column until you fill them with rootr_update_row. ' +
+        'type ∈ text | number | select | multi_select | date | checkbox | url | person ' +
+        '("title" is not allowed: a database already has exactly one title column). ' +
+        'For select/multi_select pass options: [{ name, color }]. Returns the created column WITH ITS id.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        name: z.string().describe('Column header, e.g. "담당자"'),
+        type: z
+          .enum(['text', 'number', 'select', 'multi_select', 'date', 'checkbox', 'url', 'person'])
+          .describe('Column type'),
+        options: z
+          .array(z.object({ name: z.string(), color: z.string() }))
+          .optional()
+          .describe('select/multi_select only: the choices, e.g. [{ name: "진행중", color: "blue" }]'),
+      },
+    },
+    async ({ databaseId, name, type, options }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const property = await client.addColumn(id, { name, type, options });
+        return jsonResult({ property });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_update_column',
+    {
+      title: 'Rename a column / set its options',
+      description:
+        'Rename ONE column of a Rootr (루터) DATABASE, and/or replace the choices of a select/multi_select column. ' +
+        'The column TYPE cannot be changed — that would rewrite every row — so add a new column and move the values instead. ' +
+        'Call rootr_read_database first to get the exact propertyId.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        propertyId: z.string().describe('Column id from rootr_read_database (NOT the header text)'),
+        name: z.string().optional().describe('New header text'),
+        options: z
+          .array(z.object({ name: z.string(), color: z.string() }))
+          .optional()
+          .describe('select/multi_select only: REPLACES the full choice list'),
+      },
+    },
+    async ({ databaseId, propertyId, name, options }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const property = await client.updateColumn(id, propertyId, { name, options });
+        return jsonResult({ property });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_delete_column',
+    {
+      title: 'Delete a column from a database',
+      description:
+        'Remove ONE column from a Rootr (루터) DATABASE. The values stored under it are NOT erased from the rows, ' +
+        'so re-adding a column is not enough to bring them back in the UI — confirm with the user before calling this. ' +
+        'The title column cannot be deleted. Views grouped/dated by the column are cleared automatically.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        propertyId: z.string().describe('Column id from rootr_read_database'),
+      },
+    },
+    async ({ databaseId, propertyId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const property = await client.deleteColumn(id, propertyId);
+        return jsonResult({ deleted: true, property });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.5.0",
+  "version": "0.6.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": {