rootr-cli 0.1.0 → 0.2.0

package/lib/client.js

@@ -465,4 +465,40 @@ export class RootrClient {
       method: 'DELETE',
     });
   }
+
+  // ---- Databases (rows) -------------------------------------------------
+
+  /** Database definition: { id, name, icon, path, properties[], views[], rowCount }. */
+  async getDatabase(databaseId) {
+    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`);
+    if (Array.isArray(data)) return data;
+    if (data && Array.isArray(data.rows)) return data.rows;
+    return [];
+  }
+
+  async createRow(databaseId, { values, position } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows`, {
+      method: 'POST',
+      body: { values, position },
+    });
+  }
+
+  async updateRow(databaseId, rowId, { values, position } = {}) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}`,
+      { method: 'PATCH', body: { values, position } },
+    );
+  }
+
+  async deleteRow(databaseId, rowId) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}`,
+      { method: 'DELETE' },
+    );
+  }
 }

package/lib/mcp-tools/databases.js

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+
+import { jsonResult, errorResult, makeClient } from './shared.js';
+
+/**
+ * Resolve a `{propertyNameOrId: value}` map to `{propertyId: value}` using the
+ * database schema, so agents can address columns by their human name OR their
+ * id. `null` is preserved (clear marker for PATCH). Throws on an unknown key so
+ * the model is told to read the schema first.
+ */
+function resolveValueKeys(properties, values) {
+  const byId = new Map(properties.map((p) => [p.id, p]));
+  const byName = new Map(properties.map((p) => [p.name.toLowerCase(), p]));
+  const out = {};
+  for (const [key, v] of Object.entries(values || {})) {
+    const prop = byId.get(key) ?? byName.get(String(key).toLowerCase());
+    if (!prop) {
+      throw new Error(`Unknown property "${key}". Call rootr_read_database first to see the column ids/names.`);
+    }
+    out[prop.id] = v;
+  }
+  return out;
+}
+
+/**
+ * Database (Notion-style table/board/kanban) row tools. The REST layer already
+ * exposes GET /databases/:id (schema), GET/POST /databases/:id/rows and
+ * PATCH/DELETE /databases/:id/rows/:rowId — these tools wrap it so agents can
+ * read the schema, then create/move/edit/delete rows (e.g. change a select
+ * "status" column = move a kanban card between columns).
+ */
+export function registerDatabaseTools(server) {
+  server.registerTool(
+    'rootr_read_database',
+    {
+      title: 'Read a database schema and rows',
+      description:
+        'Read a Rootr (루터) DATABASE node — its schema (properties with ids/types and select options) plus all rows ' +
+        '(each with its rowId and values). ALWAYS call this before rootr_add_row / rootr_update_row so you know the exact ' +
+        'property ids/names and, for board/kanban views, which select column holds the status. Only works on DATABASE nodes.',
+      inputSchema: {
+        databaseId: z.string().describe('DATABASE node id'),
+      },
+    },
+    async ({ databaseId }) => {
+      try {
+        const client = makeClient();
+        const [database, rows] = await Promise.all([
+          client.getDatabase(databaseId),
+          client.listRows(databaseId),
+        ]);
+        return jsonResult({ database, rows });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_list_rows',
+    {
+      title: 'List database rows',
+      description:
+        'List the rows of a Rootr (루터) DATABASE (id + values + position), without the schema. ' +
+        'Use rootr_read_database instead when you also need the property/column definitions.',
+      inputSchema: {
+        databaseId: z.string().describe('DATABASE node id'),
+      },
+    },
+    async ({ databaseId }) => {
+      try {
+        const client = makeClient();
+        const rows = await client.listRows(databaseId);
+        return jsonResult({ rows });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_add_row',
+    {
+      title: 'Add a database row',
+      description:
+        '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.',
+      inputSchema: {
+        databaseId: z.string().describe('DATABASE node id'),
+        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'),
+      },
+    },
+    async ({ databaseId, values, position }) => {
+      try {
+        const client = makeClient();
+        const database = await client.getDatabase(databaseId);
+        const resolved = resolveValueKeys(database.properties || [], values);
+        const row = await client.createRow(databaseId, { values: resolved, position });
+        return jsonResult(row);
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_update_row',
+    {
+      title: 'Update a database row',
+      description:
+        'Merge-patch ONE row of a Rootr (루터) DATABASE by rowId (get rowIds from rootr_read_database). ' +
+        '`values` maps property NAME (or id) → new value; only the passed keys change, `null` clears a key, omitted keys ' +
+        'are left unchanged. To MOVE a kanban card to another column, set its select/status property to the new option name. ' +
+        'Optionally set `position` to reorder the row.',
+      inputSchema: {
+        databaseId: z.string().describe('DATABASE node id'),
+        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'),
+      },
+    },
+    async ({ databaseId, rowId, values, position }) => {
+      try {
+        const client = makeClient();
+        let resolved;
+        if (values !== undefined) {
+          const database = await client.getDatabase(databaseId);
+          resolved = resolveValueKeys(database.properties || [], values);
+        }
+        const row = await client.updateRow(databaseId, rowId, { values: resolved, position });
+        return jsonResult(row);
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_delete_row',
+    {
+      title: 'Delete a database row',
+      description:
+        'Delete ONE row of a Rootr (루터) DATABASE by rowId (its linked page, if any, is moved to the trash). ' +
+        'Verify the row via rootr_read_database first — do not guess rowIds.',
+      inputSchema: {
+        databaseId: z.string().describe('DATABASE node id'),
+        rowId: z.string().describe('Row id to delete (must belong to the database)'),
+      },
+    },
+    async ({ databaseId, rowId }) => {
+      try {
+        const client = makeClient();
+        await client.deleteRow(databaseId, rowId);
+        return jsonResult({ deleted: true, rowId });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+}

package/lib/mcp.js

@@ -6,6 +6,7 @@ import { registerWorkspaceTools } from './mcp-tools/workspaces.js';
 import { registerLogTools } from './mcp-tools/logs.js';
 import { registerAskTools } from './mcp-tools/ask.js';
 import { registerIssueTools } from './mcp-tools/issues.js';
+import { registerDatabaseTools } from './mcp-tools/databases.js';
 import { registerWebhookTools } from './mcp-tools/webhooks.js';
 import { registerMiscTools } from './mcp-tools/misc.js';
 
@@ -20,7 +21,9 @@ export async function startMcpServer({ name, version }) {
         'rootr_edit for targeted changes; use rootr_write only for full rewrites. Beyond documents, this ' +
         'server also covers workspace scaffolding (planning/creating/applying document trees), typed LOG ' +
         'datastores (structured entries + stats), GraphRAG root-cause Q&A (rootr_ask), GitHub-style issue ' +
-        'trackers, and webhooks.\n\n' +
+        'trackers, DATABASE rows (read schema + rows, add/update/delete rows — e.g. move a kanban card by ' +
+        'changing its status column, via rootr_read_database / rootr_add_row / rootr_update_row / rootr_delete_row), ' +
+        'and webhooks.\n\n' +
         'Node types — pick the block that fits, never fake everything with markdown files: ' +
         'DOCUMENT = free-form markdown narrative (overviews, specs, decision logs); ' +
         'DATABASE = typed columns + views (table/board/calendar/timeline) for anything trackable — tasks, requirements, risks, milestones; ' +
@@ -42,6 +45,7 @@ export async function startMcpServer({ name, version }) {
   registerLogTools(server);
   registerAskTools(server);
   registerIssueTools(server);
+  registerDatabaseTools(server);
   registerWebhookTools(server);
   registerMiscTools(server);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.1.0",
+  "version": "0.2.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": {
@@ -14,17 +14,7 @@
     "lib",
     "README.md"
   ],
-  "keywords": [
-    "rootr",
-    "mcp",
-    "model-context-protocol",
-    "ai-agent",
-    "knowledge-base",
-    "markdown",
-    "cli"
-  ],
-  "homepage": "https://rootr.io",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.8"