rootr-cli 0.8.0 → 0.9.0

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
@@ -51,11 +60,17 @@ export function registerDatabaseTools(server) {
         'board, a task/requirement/risk tracker, anything with trackable rows. Do NOT fake a table with a markdown ' +
         'document, and do NOT create an empty database and then add columns one by one — `properties` order IS the ' +
         'column order, so one call keeps the columns in exactly the order you list them. ' +
-        'The FIRST property must be type "title" (the row label). Other types: text | number | select | ' +
-        'multi_select | date | checkbox | url | person. select/multi_select take options:[{name,color}]. ' +
-        'Views default to a single table view; a "board" view needs config.groupBy = a select property id, a ' +
-        '"timeline" view needs config.dateProp. Row `values` are keyed by column NAME (or id); date values are ' +
-        '{ start: "YYYY-MM-DD", end? }, multi_select is string[].',
+        'The FIRST property must be type "title" (the row label). Other types: text | number | select | multi_select | ' +
+        'status | date | checkbox | url | email | phone | person | files | relation | formula | rollup | ' +
+        'created_time | last_edited_time | created_by | last_edited_by | unique_id. ' +
+        'select/multi_select/status take options:[{name,color,group?}] (group ∈ todo|in_progress|done, status only); ' +
+        'relation takes relationDatabaseId; formula takes formula ("{수량} * {단가}"); rollup takes ' +
+        'rollup:{relation,property?,function}; unique_id takes prefix ("TASK" → "TASK-42"). The last seven types are ' +
+        'filled in by the server and take no row value. ' +
+        'Views default to a single table view; view types are table | board | gallery | calendar | timeline | list — ' +
+        'a "board" view needs config.groupBy (a select/status property id), a "timeline"/"calendar" view needs ' +
+        'config.dateProp. Row `values` are keyed by column NAME (or id); date values are ' +
+        '{ start: "YYYY-MM-DDTHH:mm" or "YYYY-MM-DD", end? }, multi_select is string[], relation is an array of row ids.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().describe('Table name, e.g. "업무 목록"'),
@@ -68,12 +83,54 @@ export function registerDatabaseTools(server) {
             z.object({
               name: z.string().describe('Column header, e.g. "담당자"'),
               type: z
-                .enum(['title', 'text', 'number', 'select', 'multi_select', 'date', 'checkbox', 'url', 'person'])
+                .enum([
+                  'title',
+                  'text',
+                  'number',
+                  'select',
+                  'multi_select',
+                  'status',
+                  'date',
+                  'checkbox',
+                  'url',
+                  'email',
+                  'phone',
+                  'person',
+                  'files',
+                  'relation',
+                  'formula',
+                  'rollup',
+                  'created_time',
+                  'last_edited_time',
+                  'created_by',
+                  'last_edited_by',
+                  'unique_id',
+                ])
                 .describe('Column type; the FIRST property must be "title"'),
               options: z
-                .array(z.object({ name: z.string(), color: z.string() }))
+                .array(z.object({ name: z.string(), color: z.string(), group: z.string().optional() }))
+                .optional()
+                .describe('select/multi_select/status only: the choices'),
+              relationDatabaseId: z.string().optional().describe('relation only: the table this column points at'),
+              formula: z.string().optional().describe('formula only: e.g. "{수량} * {단가}"'),
+              rollup: z
+                .object({
+                  relation: z.string(),
+                  property: z.string().optional(),
+                  function: z.enum([
+                    'count',
+                    'count_values',
+                    'sum',
+                    'average',
+                    'min',
+                    'max',
+                    'show_original',
+                    'percent_checked',
+                  ]),
+                })
                 .optional()
-                .describe('select/multi_select only: the choices'),
+                .describe('rollup only: what to gather through which relation'),
+              prefix: z.string().optional().describe('unique_id only: e.g. "TASK" → "TASK-42"'),
             }),
           )
           .optional()
@@ -111,6 +168,66 @@ export function registerDatabaseTools(server) {
     },
   );
 
+  server.registerTool(
+    'rootr_create_view',
+    {
+      title: 'Add a view to an existing database',
+      description:
+        'Add ONE more view (table / board / gallery / calendar / timeline) to a Rootr (루터) DATABASE that ' +
+        'already exists. Until now views could only be set when the table was CREATED, so a Notion table with ' +
+        'four views could only be migrated with one. Existing views are untouched — the server merges, unlike ' +
+        'a full PATCH which replaces the whole views array and silently drops anything you leave out. ' +
+        'A board needs `groupBy` (a select column); calendar/timeline need `dateProp`. Columns may be given ' +
+        'by NAME or id.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        name: z.string().describe('View name shown on the tab, e.g. "일정"'),
+        type: z
+          .enum(['table', 'board', 'gallery', 'calendar', 'timeline'])
+          .describe('View layout'),
+        groupBy: z.string().optional().describe('board view: the select column to group by (name or id)'),
+        dateProp: z.string().optional().describe('calendar/timeline view: the date column (name or id)'),
+        endDateProp: z.string().optional().describe('timeline view: the end-date column (name or id)'),
+      },
+    },
+    async ({ databaseId, name, type, groupBy, dateProp, endDateProp }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const view = await client.createDatabaseView(id, { name, type, groupBy, dateProp, endDateProp });
+        return jsonResult(view);
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_delete_view',
+    {
+      title: 'Delete one view from a database',
+      description:
+        'Remove ONE view from a Rootr (루터) DATABASE. Rows and column values are NOT touched — only that ' +
+        'view\'s layout is removed. The last remaining view cannot be deleted (there would be nothing to look at).',
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        viewId: z.string().describe('View id or view NAME (from rootr_read_database)'),
+      },
+    },
+    async ({ databaseId, viewId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        await client.deleteDatabaseView(id, viewId);
+        return jsonResult({ deleted: viewId });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
   server.registerTool(
     'rootr_update_view',
     {
@@ -164,15 +281,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 +312,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);
@@ -210,23 +337,27 @@ export function registerDatabaseTools(server) {
       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[]; ' +
+        'Value shapes by type: title/text/url/select → string; number → number; multi_select → string[]; ' +
+        'person → string[] (a LIST of names — a meeting has several attendees; one bare name is also accepted); ' +
         '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 +380,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 +392,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);
@@ -305,27 +437,91 @@ export function registerDatabaseTools(server) {
       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 ' +
+        'type ∈ text | number | select | multi_select | status | date | checkbox | url | email | phone | person | files | ' +
+        'relation | formula | rollup | created_time | last_edited_time | created_by | last_edited_by | unique_id ' +
         '("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.',
+        'For select/multi_select/status pass options: [{ name, color, group? }] (group ∈ todo|in_progress|done, status only). ' +
+        'For relation pass relationDatabaseId (the node id of the table it points at). ' +
+        'For formula pass formula, e.g. "{수량} * {단가}" or "if({금액} >= 5000, \\"큰 건\\", \\"작은 건\\")" — ' +
+        'available functions: if, concat, length, upper, lower, contains, abs, round, floor, ceil, min, max, dateBetween, now, empty. ' +
+        'For rollup pass rollup: { relation, property?, function } (function ∈ count|count_values|sum|average|min|max|show_original|percent_checked). ' +
+        'For unique_id pass prefix to get "TASK-42" style ids. ' +
+        'created_time / last_edited_time / created_by / last_edited_by / unique_id / formula / rollup are filled in by the server — ' +
+        'they take no value and rootr_update_row will refuse to set them. ' +
+        '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'])
+          .enum([
+            'text',
+            'number',
+            'select',
+            'multi_select',
+            'status',
+            'date',
+            'checkbox',
+            'url',
+            'email',
+            'phone',
+            'person',
+            'files',
+            'relation',
+            'formula',
+            'rollup',
+            'created_time',
+            'last_edited_time',
+            'created_by',
+            'last_edited_by',
+            'unique_id',
+          ])
           .describe('Column type'),
         options: z
-          .array(z.object({ name: z.string(), color: z.string() }))
+          .array(z.object({ name: z.string(), color: z.string(), group: z.string().optional() }))
+          .optional()
+          .describe('select/multi_select/status only: the choices, e.g. [{ name: "진행중", color: "blue" }]'),
+        relationDatabaseId: z
+          .string()
+          .optional()
+          .describe('relation only: the node id of the database this column points at'),
+        formula: z
+          .string()
+          .optional()
+          .describe('formula only: the expression, e.g. "{수량} * {단가}"'),
+        rollup: z
+          .object({
+            relation: z.string().describe('the relation column (id or name) to follow'),
+            property: z.string().optional().describe('the column to read in the linked table'),
+            function: z.enum([
+              'count',
+              'count_values',
+              'sum',
+              'average',
+              'min',
+              'max',
+              'show_original',
+              'percent_checked',
+            ]),
+          })
           .optional()
-          .describe('select/multi_select only: the choices, e.g. [{ name: "진행중", color: "blue" }]'),
+          .describe('rollup only: what to gather through which relation'),
+        prefix: z.string().optional().describe('unique_id only: prefix for the number, e.g. "TASK" → "TASK-42"'),
       },
     },
-    async ({ databaseId, name, type, options }) => {
+    async ({ databaseId, name, type, options, relationDatabaseId, formula, rollup, prefix }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
-        const property = await client.addColumn(id, { name, type, options });
+        const property = await client.addColumn(id, {
+          name,
+          type,
+          options,
+          relationDatabaseId,
+          formula,
+          rollup,
+          prefix,
+        });
         return jsonResult({ property });
       } catch (err) {
         return errorResult(err);
@@ -364,6 +560,131 @@ export function registerDatabaseTools(server) {
     },
   );
 
+  // ── DB-PERM-001 / DB-WATCH — 노션에 없는 두 가지: 자물쇠와 알림 ────────────
+  //
+  // 표를 만들 수 있으면 잠글 수도, 누구에게 알릴지 정할 수도 있어야 한다. 이게 없으면
+  // 에이전트가 "지원서 표 만들어 줘. 서로 못 보게 하고, 새 지원 들어오면 김승수한테
+  // 알려 줘" 같은 부탁의 절반만 해내고 만다.
+
+  server.registerTool(
+    'rootr_read_database_permissions',
+    {
+      title: 'Read a database\'s locks',
+      description:
+        'Read the three locks on a Rootr (루터) DATABASE — schema lock (only managers change columns/views), ' +
+        'own-rows-only (people see just what they submitted), and manager-only columns. Notion has none of these.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: { databaseId: z.string().describe(DATABASE_TARGET_DESC) },
+    },
+    async ({ databaseId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.getDatabasePermissions(id));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_set_database_permissions',
+    {
+      title: 'Lock a database',
+      description:
+        'Set the locks on a Rootr (루터) DATABASE. `schemaLock: "managers"` stops editors from changing columns and ' +
+        'views; `rowScope: "own"` hides other people\'s rows (application forms, report boxes); `lockedProps` names ' +
+        'the columns only managers may edit (approval flags, final scores). Omitted fields keep their current value. ' +
+        'Requires MANAGE on the table.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        schemaLock: z.enum(['open', 'managers']).optional().describe('Who may change columns and views'),
+        rowScope: z.enum(['all', 'own']).optional().describe('"own" = each person sees only the rows they created'),
+        lockedProps: z
+          .array(z.string())
+          .optional()
+          .describe('Column ids (or names) only managers may edit'),
+      },
+    },
+    async ({ databaseId, schemaLock, rowScope, lockedProps }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const body = {};
+        if (schemaLock !== undefined) body.schemaLock = schemaLock;
+        if (rowScope !== undefined) body.rowScope = rowScope;
+        if (lockedProps !== undefined) body.lockedProps = lockedProps;
+        return jsonResult(await client.setDatabasePermissions(id, body));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_read_database_notifications',
+    {
+      title: 'Read a database\'s notification rules',
+      description:
+        'Read who gets notified when rows are added, changed or deleted in a Rootr (루터) DATABASE. ' +
+        'Notion cannot do this — there each person must turn on watching for themselves.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: { databaseId: z.string().describe(DATABASE_TARGET_DESC) },
+    },
+    async ({ databaseId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.getDatabaseNotifications(id));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_set_database_notifications',
+    {
+      title: 'Set who gets notified about a database',
+      description:
+        'Replace the notification rules on a Rootr (루터) DATABASE. Each rule names the people to notify (`userIds`), ' +
+        'when (`events`: created / updated / deleted), and optionally a filter so only some rows ping — ' +
+        '`{propId, op: "is"|"contains"|"changed", value}` (e.g. status is 긴급, owner changed). ' +
+        'Rules replace the existing set; pass [] to clear. Requires MANAGE. A person is never notified about their own change.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        watchers: z
+          .array(
+            z.object({
+              id: z.string().optional(),
+              userIds: z.array(z.string()).describe('Workspace member user ids to notify'),
+              events: z.array(z.enum(['created', 'updated', 'deleted'])),
+              filter: z
+                .object({
+                  propId: z.string(),
+                  op: z.enum(['is', 'contains', 'changed']),
+                  value: z.string().optional(),
+                })
+                .optional(),
+              label: z.string().optional(),
+            }),
+          )
+          .describe('The complete rule set (replaces what is stored)'),
+      },
+    },
+    async ({ databaseId, watchers }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.setDatabaseNotifications(id, watchers));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
   server.registerTool(
     'rootr_delete_column',
     {