rootr-cli 0.8.1 → 0.10.0

package/lib/mcp-tools/databases.js

@@ -13,6 +13,61 @@ 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. "/제작 공정/칸반")`;
 
+/**
+ * VIEW-FILTER — 사람이 화면에서 거는 "이 조건만 보이게"를 에이전트도 걸 수 있게 한다.
+ * 조건은 전부 만족해야 하고(AND), 한 조건 안의 `values`는 그중 하나만 맞아도 된다(OR).
+ */
+const FILTER_SHAPE = z.array(
+  z.object({
+    propId: z.string().describe('Column NAME or id the condition applies to'),
+    op: z
+      .enum([
+        'is',
+        'is_not',
+        'contains',
+        'is_empty',
+        'is_not_empty',
+        'today',
+        'this_week',
+        'this_month',
+        'past',
+        'upcoming',
+        'before',
+        'after',
+        'on',
+        'between',
+        'eq',
+        'gt',
+        'lt',
+        'checked',
+        'unchecked',
+      ])
+      .describe('Comparison to apply'),
+    values: z
+      .array(z.string())
+      .optional()
+      .describe(
+        'Values the op needs. is/is_not/contains → one or more (OR between them). ' +
+          'before/after/on → one date "YYYY-MM-DD". between → two dates. eq/gt/lt → one number. ' +
+          'is_empty/is_not_empty/today/this_week/this_month/past/upcoming/checked/unchecked take none.',
+      ),
+  }),
+);
+
+const FILTER_DESC =
+  'Only rows matching EVERY condition are shown in this view (AND between conditions, OR inside one ' +
+  'condition\'s values). This is the same filter a person sets on screen, so "검토 대기인 것만 보이게 해줘" ' +
+  'is expressible: [{"propId":"구분","op":"is","values":["검토 대기"]}]. Rows are NOT deleted — other views ' +
+  'still show them. A new row added while a filter is on is seeded with the filtered values so it does not ' +
+  'vanish the moment it is created.';
+
+const SORT_SHAPE = z.object({
+  propId: z.string().describe('Column NAME or id to sort by'),
+  dir: z.enum(['asc', 'desc']).describe('asc = 오름차순, desc = 내림차순'),
+});
+
+const SORT_DESC = 'Row order in this view.';
+
 /**
  * DB-BODY — 행의 상세 내용(본문 메모). 화면에서 칸반 카드를 열면 속성 아래에 붙는 그 글이며,
  * 실체는 표 밑에 달리는 문서 하나다. 예전에는 REST 2단계로만 닿을 수 있어서 CLI·MCP에서는
@@ -60,11 +115,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. "업무 목록"'),
@@ -77,12 +138,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()
@@ -95,10 +198,18 @@ export function registerDatabaseTools(server) {
           .array(z.object({ values: z.record(z.unknown()) }))
           .optional()
           .describe('Initial rows, e.g. [{ values: { "이름": "킥오프", "기한": { "start": "2026-08-01" } } }]'),
+        rowPageType: z
+          .enum(['DOCUMENT', 'SIGNED'])
+          .optional()
+          .describe(
+            'SIGN-001 — what a row\'s detail page is. "SIGNED" makes every row open as a 서명문서/연구노트 ' +
+              '(freezes on submit, ordered signatures + RFC 3161 timestamps, undeletable). Use it for 실험 기록 · ' +
+              '점검 대장 · 결재 대장 표. Default "DOCUMENT".',
+          ),
         workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
       },
     },
-    async ({ name, parentId, path, createParents, icon, properties, views, rows, workspace }) => {
+    async ({ name, parentId, path, createParents, icon, properties, views, rows, rowPageType, workspace }) => {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
@@ -112,6 +223,7 @@ export function registerDatabaseTools(server) {
           properties,
           views,
           rows,
+          rowPageType,
         });
         return jsonResult(database);
       } catch (err) {
@@ -120,6 +232,84 @@ 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)'),
+        filters: FILTER_SHAPE.optional().describe(FILTER_DESC),
+        sort: SORT_SHAPE.optional().describe(SORT_DESC),
+        colWidths: z
+          .record(z.number())
+          .optional()
+          .describe(
+            'Column widths in px for this view, keyed by column NAME or id — e.g. {"공고명": 420}. ' +
+              '40~1200. Use it when a column holds long text and is being cut off. {} resets every column to auto.',
+          ),
+      },
+    },
+    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        const view = await client.createDatabaseView(id, {
+          name,
+          type,
+          groupBy,
+          dateProp,
+          endDateProp,
+          filters,
+          sort,
+          colWidths,
+        });
+        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',
     {
@@ -142,9 +332,29 @@ export function registerDatabaseTools(server) {
         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)'),
+        filters: FILTER_SHAPE.nullable().optional().describe(FILTER_DESC + ' null 또는 []을 주면 조건을 전부 없앤다.'),
+        sort: SORT_SHAPE.nullable().optional().describe(SORT_DESC + ' null을 주면 정렬을 끈다.'),
+        colWidths: z
+          .record(z.number())
+          .optional()
+          .describe(
+            'Column widths in px for this view, keyed by column NAME or id — e.g. {"공고명": 420}. ' +
+              '40~1200. Use it when a column holds long text and is being cut off. {} resets every column to auto.',
+          ),
       },
     },
-    async ({ databaseId, viewId, hiddenProps, name, groupBy, dateProp, endDateProp }) => {
+    async ({
+      databaseId,
+      viewId,
+      hiddenProps,
+      name,
+      groupBy,
+      dateProp,
+      endDateProp,
+      filters,
+      sort,
+      colWidths,
+    }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -154,6 +364,9 @@ export function registerDatabaseTools(server) {
           groupBy,
           dateProp,
           endDateProp,
+          filters,
+          sort,
+          colWidths,
         });
         return jsonResult({ view });
       } catch (err) {
@@ -229,7 +442,8 @@ 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. ' +
         'Pass `body` to also write the row\'s DETAIL PAGE (the note shown under a kanban card\'s properties) — ' +
@@ -328,27 +542,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('select/multi_select only: the choices, e.g. [{ name: "진행중", color: "blue" }]'),
+          .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('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);
@@ -387,6 +665,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',
     {