rootr-cli 0.2.1 → 0.4.0

package/lib/mcp.js

@@ -9,8 +9,63 @@ 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';
+import { registerCrmTools } from './mcp-tools/crm.js';
+import { registerPresentationTools } from './mcp-tools/presentations.js';
+import { registerSpreadsheetTools } from './mcp-tools/spreadsheets.js';
+import { registerWhiteboardTools } from './mcp-tools/whiteboards.js';
+import { registerFormTools } from './mcp-tools/forms.js';
+import { registerRecordingTools } from './mcp-tools/recordings.js';
+import { registerAttachmentTools } from './mcp-tools/attachments.js';
+import { withRateLimitSink } from './context.js';
 
-export async function startMcpServer({ name, version }) {
+/** Warn once the workspace has burned this share of its quota. */
+const QUOTA_WARN_AT = 0.8;
+
+function quotaNotice({ limit, remaining, window, upgradeUrl }) {
+  if (!Number.isFinite(limit) || !Number.isFinite(remaining) || limit <= 0) return null;
+  if (remaining <= 0) return null; // already blocked — the 429 says it better
+  if (remaining > Math.ceil(limit * (1 - QUOTA_WARN_AT))) return null;
+  const per = window === 'day' ? '오늘' : '이번 시간';
+  const refill = window === 'day' ? '내일 자정(KST)' : '다음 정시';
+  return (
+    `\n\n⚠️ ${per} 남은 조회 ${remaining}/${limit}회. ` +
+    `다 쓰면 ${refill}까지 조회가 멈춥니다` +
+    (upgradeUrl ? `. 한도를 늘리려면: ${upgradeUrl}` : '.')
+  );
+}
+
+/**
+ * Wraps every tool handler so a nearly-exhausted quota is appended to the tool
+ * result. The assistant reads that text, so the user hears "you have 30 queries
+ * left today" while the work still succeeds — instead of hitting a wall with no
+ * warning mid-task.
+ */
+function withQuotaWarnings(server) {
+  const original = server.registerTool.bind(server);
+  server.registerTool = (name, spec, handler) =>
+    original(name, spec, async (...args) => {
+      const sink = {};
+      const result = await withRateLimitSink(sink, () => handler(...args));
+      if (!result || result.isError || !Array.isArray(result.content)) return result;
+      const notice = quotaNotice(sink);
+      if (!notice) return result;
+      const last = [...result.content].reverse().find((c) => c && c.type === 'text');
+      if (!last) return result;
+      return {
+        ...result,
+        content: result.content.map((c) => (c === last ? { ...c, text: `${c.text}${notice}` } : c)),
+      };
+    });
+  return server;
+}
+
+/**
+ * Builds a fully-configured McpServer (all tool groups registered) without
+ * connecting a transport. Shared by the local stdio CLI server below and by
+ * the backend's hosted Streamable HTTP transport (src/mcp/mcp-transport.controller.ts),
+ * so the 89 tool definitions have exactly one implementation.
+ */
+export function buildMcpServer({ name, version }) {
   const server = new McpServer(
     { name, version },
     {
@@ -23,14 +78,38 @@ export async function startMcpServer({ name, version }) {
         'datastores (structured entries + stats), GraphRAG root-cause Q&A (rootr_ask), GitHub-style issue ' +
         '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' +
+        'CRM nodes (companies/contacts/deals/activities/tasks via the rootr_crm_* tools), and webhooks. ' +
+        'To put a screenshot or photo into a document, use rootr_attach_image_to_document (upload + insert in one ' +
+        'step) or rootr_upload_attachment (upload only, returns a URL/markdown to place yourself).\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; ' +
-        'SPREADSHEET = grid with formulas when content needs calculation (budgets, models, estimates); ' +
-        'WHITEBOARD = freeform visual canvas (flow diagrams, brainstorming, journey maps); ' +
-        'FORM = fillable intake from people outside the tree, optionally feeding a DATABASE (surveys, request queues); ' +
+        'SPREADSHEET = grid with formulas when content needs calculation (budgets, models, estimates) — author with ' +
+        'the rootr_*_spreadsheet / rootr_*_sheet tools (create/read/update, per-sheet create/update/delete, ' +
+        'rootr_patch_spreadsheet_cells for cell values/formulas); ' +
+        'WHITEBOARD = freeform visual canvas (flow diagrams, brainstorming, journey maps) — author with the ' +
+        'rootr_*_whiteboard tools (create/read/update the shapes[]/edges[] scene); ' +
+        'FORM = fillable intake from people outside the tree, optionally feeding a DATABASE (surveys, request queues) ' +
+        '— author with the rootr_*_form tools (create/read/update fields, rootr_list_form_responses / ' +
+        'rootr_submit_form_response for responses, rootr_*_form_share_link for public links); ' +
         'ISSUE_TRACKER = GitHub-style issues with #numbers, states, labels, comments (bug/work tracking with a lifecycle); ' +
+        'CRM = full sales CRM: companies, contacts with lifecycle stages & auto lead-scoring, multi-pipeline deals ' +
+        '(kanban), an activity timeline, follow-up tasks, and CSV import/export — use for sales/lead/customer ' +
+        'tracking; never fake a CRM with plain DATABASEs (use the rootr_crm_* tools: rootr_crm_create/get/update, ' +
+        'rootr_crm_list_companies/upsert_company/get_company, rootr_crm_list_contacts/upsert_contact/get_contact, ' +
+        'rootr_crm_list_deals/upsert_deal/get_deal/move_deal, rootr_crm_log_activity/list_activities, ' +
+        'rootr_crm_upsert_task/list_tasks, rootr_crm_import); ' +
+        'PRESENTATION = slide deck (16:9 HTML slides with themes) — author via the rootr_*_presentation tools ' +
+        '(rootr_create_presentation, rootr_read_presentation, rootr_update_presentation, ' +
+        'rootr_append_presentation_slides, rootr_update_presentation_slide, rootr_reorder_presentation_slides, ' +
+        'plus rootr_generate_image / rootr_remove_image_background for slide art), never as markdown documents; ' +
+        'ALWAYS rootr_read_presentation before updating so slide ids line up; ' +
+        'RECORDING = audio recording with a diarized (speaker-labeled) transcript and minutes — fully drivable from ' +
+        'MCP: rootr_create_recording → rootr_upload_recording_audio (upload a local audio file; stores it as ' +
+        'status UPLOADED, does NOT transcribe) → rootr_transcribe_recording (explicit step that runs speech-to-text ' +
+        'and spends AI credits) → poll rootr_read_recording until status READY → read the transcript, ' +
+        'rename speakers with rootr_rename_recording_speakers, and write the minutes yourself with rootr_write ' +
+        '(preferred — no AI credits) or call rootr_summarize_recording for Rootr\'s built-in summary document; ' +
         'FOLDER = grouping; LOG store = typed event table whose relation fields auto-build a lineage graph (metrics, incidents, pipeline events — use the rootr_*_log_* tools).\n\n' +
         'Scaffolding discipline: ALWAYS rootr_scaffold_plan first, ask the user the 3-10 clarifying questions it ' +
         'prescribes, and only then design and create the tree — every answer must visibly shape the structure. ' +
@@ -40,6 +119,8 @@ export async function startMcpServer({ name, version }) {
     },
   );
 
+  withQuotaWarnings(server);
+
   registerDocumentTools(server);
   registerWorkspaceTools(server);
   registerLogTools(server);
@@ -48,7 +129,19 @@ export async function startMcpServer({ name, version }) {
   registerDatabaseTools(server);
   registerWebhookTools(server);
   registerMiscTools(server);
+  registerCrmTools(server);
+  registerPresentationTools(server);
+  registerSpreadsheetTools(server);
+  registerWhiteboardTools(server);
+  registerFormTools(server);
+  registerRecordingTools(server);
+  registerAttachmentTools(server);
 
+  return server;
+}
+
+export async function startMcpServer({ name, version }) {
+  const server = buildMcpServer({ name, version });
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.2.1",
+  "version": "0.4.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": {
@@ -9,12 +9,31 @@
   "engines": {
     "node": ">=18"
   },
+  "homepage": "https://rootr.io/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gwmage/rootr-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gwmage/rootr-cli/issues"
+  },
+  "keywords": [
+    "rootr",
+    "mcp",
+    "model-context-protocol",
+    "knowledge-base",
+    "team-documentation",
+    "ai-agent",
+    "claude",
+    "cli"
+  ],
   "files": [
     "bin",
     "lib",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.8"