@dain-os/mcp-server 0.6.0 → 0.8.0

package/README.md

@@ -1,32 +1,30 @@
 # @dain-os/mcp-server
 
-MCP server for DainOS. Lets Claude Code and other MCP clients manage your projects, tasks, task comments, proposals (including content drafting), and persist + retrieve developer knowledge (changelog / sessions / KB).
+MCP server for DainOS. Lets Claude Code and other MCP clients manage projects, tasks, proposals (including content drafting), PR reviews, instructions library, and developer knowledge (changelog, sessions, KB).
 
 ## What it does
 
-Wraps the DainOS Express API behind 36 tools:
+Wraps the DainOS Express API behind 20 tools: 3 generic tools that cover all standard CRUD operations across every resource, plus 17 semantic tools for operations with real business logic.
 
-| Domain | Tools |
-|---|---|
-| Projects | `list_projects`, `get_project`, `create_project`, `update_project`, `archive_project` |
-| Tasks | `list_tasks`, `get_task`, `create_task`, `update_task`, `complete_task`, `archive_task` |
-| Comments | `add_task_comment` |
-| Developer KB (v0.2+) | `log_changelog_entry`, `log_session_context`, `log_knowledge_base_entry`, `list_recent_sessions`, `search_knowledge_base` |
-| Proposals (v0.3+) | `list_proposals`, `get_proposal`, `create_proposal`, `update_proposal`, `set_proposal_status`, `delete_proposal` |
-| Proposal options (v0.3+) | `list_proposal_options`, `create_proposal_option`, `update_proposal_option`, `set_recommended_option`, `delete_proposal_option` |
-| Proposal content (v0.3+) | `get_proposal_content`, `describe_proposal_block_types`, `upsert_proposal_section`, `delete_proposal_section`, `upsert_proposal_block`, `delete_proposal_block`, `reorder_proposal_blocks`, `replace_proposal_content` |
-
-Project / task / comment / proposal tools run as the user who minted the token, with tenant scoping enforced server-side. Developer KB tools are intentionally cross-tenant: they accept `project` as a required parameter and store entries in a shared developer schema (used by `/wrapup`, `/recap`, `/dev-kb`).
-
-### Drafting proposal content
+### Generic tools (v0.8+)
 
-Proposal content lives in a structured JSON shape: `{ version: 2, sections: [{ id, key, title, blocks: ContentBlock[] }] }`. Eight block types are supported: `text`, `cards`, `diagram`, `chart`, `table`, `image`, `gantt`, `iframe`.
+| Tool | What it does |
+|---|---|
+| `describe_schema` | Returns the schema of all queryable resources. Call once per session to learn what data is available. |
+| `query` | Read any resource: list with filters, get by ID, or free-text search. Replaces 30+ individual list/get tools. |
+| `mutate` | Create, update, or delete any resource. Replaces 9+ individual create/update/delete tools. |
 
-Start a drafting session by calling `describe_proposal_block_types` — it returns the full catalogue (schema + minimal example + when-to-use hints + gotchas like the iframe host allowlist). Then use the granular content tools to add or change one block at a time. Each granular tool ships only the bytes you are editing, so token cost stays low even for fine-grained edits.
+Resources available through `query` and `mutate`: projects, milestones, tasks, task comments, proposals, proposal options, proposal content, session context, developer changelog, developer knowledge base, IAM users, instructions, product repos, product task summaries, PR review findings.
 
-For wholesale rewrites or regeneration, use `replace_proposal_content`.
+### Semantic tools
 
-`get_proposal` includes a computed `shareUrl` field. It is populated as `https://dainos.app/proposals/view/<token>` once the proposal has been transitioned to `sent` (or later: `viewed`, `accepted`). Draft proposals return `shareUrl: null` because the link is not yet meaningful.
+| Domain | Tools |
+|---|---|
+| Tasks | `create_task` (fuzzy milestone resolution), `complete_task` (status state machine), `regenerate_client_view` (Anthropic-powered) |
+| Cadence | `claim_next_task`, `report_task_progress`, `mark_blocked`, `request_unblock` |
+| Proposals | `set_proposal_status`, `create_proposal_option`, `update_proposal_option`, `set_recommended_option` |
+| Proposal content | `proposal_content` (6 ops: upsert/delete sections and blocks, reorder, replace all), `describe_proposal_block_types` |
+| Developer | `log_changelog_entry`, `log_knowledge_base_entry`, `log_time_entry`, `score_pr_finding` |
 
 ## Setup
 
@@ -38,19 +36,45 @@ Tokens look like `dain_pat_<43 base64url chars>`.
 
 ### 2. Add the server to your MCP client
 
-#### Claude Code
+#### Option A: Cloud HTTP (recommended)
+
+The MCP server is hosted at `mcp.dainos.app`. This is the recommended setup: it works with Claude Code subagents (which cannot access local stdio servers), requires no local install, and is always up to date.
+
+```json
+{
+  "mcpServers": {
+    "dainos": {
+      "type": "http",
+      "url": "https://mcp.dainos.app/mcp",
+      "headers": {
+        "Authorization": "Bearer ${DAINOS_API_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Set the token in your environment:
+
+```bash
+export DAINOS_API_TOKEN=dain_pat_<your token>
+```
+
+#### Option B: Local stdio
+
+For offline development or if you prefer a local process:
 
 ```bash
 claude mcp add dainos -- npx -y @dain-os/mcp-server
 ```
 
-Then set the token in your environment (or pass it inline):
+Then set the token:
 
 ```bash
 export DAINOS_API_TOKEN=dain_pat_<your token>
 ```
 
-Or, for one-machine setup, add it to your Claude Code config directly:
+Or add it to your Claude Code config directly:
 
 ```json
 {
@@ -77,6 +101,38 @@ Claude Code picks up new MCP servers on restart.
 | `DAINOS_API_TOKEN` | yes | n/a | Personal access token from `/settings/api-tokens` |
 | `DAINOS_API_URL` | no | `https://api.dainos.app` | Override for local dev or staging |
 
+## Using the generic tools
+
+Start by calling `describe_schema` to discover available resources and their fields. Then use `query` and `mutate` for all standard reads and writes.
+
+```
+query({ resource: "projects", filters: { status: "active" } })
+query({ resource: "tasks", id: "<uuid>" })
+query({ resource: "milestones", parentId: "<project-uuid>" })
+query({ resource: "instructions", id: "rule-core-rules" })
+query({ resource: "developer_knowledge_base", filters: { project: "dain-os" }, search: "auth" })
+
+mutate({ resource: "projects", operation: "create", data: { name: "New Project" } })
+mutate({ resource: "tasks", operation: "update", id: "<uuid>", data: { status: "in_progress" } })
+mutate({ resource: "session_context", operation: "create", data: { project: "dain-os", ... } })
+```
+
+For operations with business logic, use the dedicated semantic tools:
+
+```
+create_task({ title: "Wire up sidebar", projectId: "<uuid>", milestoneName: "Phase 1" })
+complete_task({ id: "<uuid>" })
+proposal_content({ proposalId: "<uuid>", op: "upsert_block", sectionKey: "exec", block: { ... } })
+```
+
+## Drafting proposal content
+
+Proposal content lives in a structured JSON shape: `{ version: 2, sections: [{ id, key, title, blocks: ContentBlock[] }] }`. Eight block types are supported: `text`, `cards`, `diagram`, `chart`, `table`, `image`, `gantt`, `iframe`.
+
+Start a drafting session by calling `describe_proposal_block_types` for the full catalogue. Then use `proposal_content` with the appropriate `op` to add or change one block at a time. Available ops: `upsert_section`, `delete_section`, `upsert_block`, `delete_block`, `reorder_blocks`, `replace_all`.
+
+`query({ resource: "proposals", id: "<uuid>" })` includes a computed `shareUrl` field, populated as `https://dainos.app/proposals/view/<token>` once the proposal has been transitioned to `sent`. Draft proposals return `shareUrl: null`.
+
 ## Usage examples
 
 Once connected, ask Claude Code things like:
@@ -85,8 +141,8 @@ Once connected, ask Claude Code things like:
 - "What tasks are assigned to me?"
 - "Create a task on the Portunus project called 'wire up the new sidebar' due Friday."
 - "Mark that task complete and add a comment that the PR is #312."
-
-The model uses `list_projects` to find ids, `create_task` / `update_task` / `complete_task` to mutate state, and `add_task_comment` for follow-ups.
+- "List all active rules for the herbert project."
+- "Fetch the core-rules instruction with template variables resolved for dain-os."
 
 ## Troubleshooting
 
@@ -104,7 +160,37 @@ The token is valid but your account does not have permission for the operation (
 
 ### Tool is not visible to Claude Code
 
-Restart Claude Code after `claude mcp add ...`. MCP servers are loaded once at startup.
+Restart Claude Code after adding the server. MCP servers are loaded once at startup.
+
+### MCP shows "still connecting" (HTTP mode)
+
+Verify the endpoint is reachable: `curl https://mcp.dainos.app/mcp` should return a 405 JSON error (GET is not allowed; MCP uses POST). If you get an HTML page or SSL error, check your DNS and network.
+
+## Migration from v0.7
+
+v0.8 replaces 56 individual tools with 20 (3 generic + 17 semantic). If you have scripts or prompts that reference old tool names:
+
+| Old tool | New equivalent |
+|---|---|
+| `list_projects`, `get_project` | `query({ resource: "projects", ... })` |
+| `create_project`, `update_project`, `archive_project` | `mutate({ resource: "projects", ... })` |
+| `list_tasks`, `get_task`, `update_task`, `archive_task` | `query` / `mutate` with `resource: "tasks"` |
+| `list_milestones`, `update_milestone` | `query` / `mutate` with `resource: "milestones"` |
+| `add_task_comment` | `mutate({ resource: "task_comments", operation: "create", parentId: taskId, ... })` |
+| `list_proposals`, `get_proposal`, `create_proposal`, `update_proposal`, `delete_proposal` | `query` / `mutate` with `resource: "proposals"` |
+| `list_proposal_options`, `delete_proposal_option` | `query` / `mutate` with `resource: "proposal_options"` |
+| `get_proposal_content` | `query({ resource: "proposal_content", parentId: proposalId })` |
+| `upsert_proposal_section`, `delete_proposal_section`, `upsert_proposal_block`, `delete_proposal_block`, `reorder_proposal_blocks`, `replace_proposal_content` | `proposal_content({ op: "...", ... })` |
+| `list_recent_sessions`, `log_session_context`, `update_session_context` | `query` / `mutate` with `resource: "session_context"` |
+| `list_changelog`, `update_changelog_entry` | `query` / `mutate` with `resource: "developer_changelog"` |
+| `search_knowledge_base`, `update_knowledge_base_entry` | `query` / `mutate` with `resource: "developer_knowledge_base"` |
+| `list_tenant_users`, `get_user` | `query({ resource: "iam_users", ... })` |
+| `list_instructions`, `get_instruction`, `search_instructions` | `query({ resource: "instructions", ... })` |
+| `lookup_product_repos` | `query({ resource: "product_repos", filters: { owner, repo } })` |
+| `summarise_product_tasks` | `query({ resource: "product_task_summary", parentId: productId })` |
+| `list_unscored_pr_findings` | `query({ resource: "pr_review_findings", filters: { repo, prNumber, scoredBy } })` |
+
+Semantic tools that kept their names unchanged: `create_task`, `complete_task`, `regenerate_client_view`, `claim_next_task`, `report_task_progress`, `mark_blocked`, `request_unblock`, `set_proposal_status`, `create_proposal_option`, `update_proposal_option`, `set_recommended_option`, `describe_proposal_block_types`, `log_changelog_entry`, `log_knowledge_base_entry`, `log_time_entry`, `score_pr_finding`.
 
 ## Local development
 
@@ -132,10 +218,6 @@ Then point your MCP client at the local build:
 }
 ```
 
-## Why a small tool surface
-
-The Notion MCP works well because it exposes a focused, opinionated set of operations rather than a one-to-one mirror of every API endpoint. The DainOS MCP server follows the same principle: project and task work covers the bulk of the day-to-day "keep things updated" use case, and the model picks the right verb every time. Tools for time entries, deals, proposals, and attachments are tracked for follow-up versions.
-
 ## Licence
 
 Proprietary. Internal use by Dain only.

package/dist/tools/generic.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generic MCP tools: describe_schema, query, mutate.
+ *
+ * These three tools replace ~36 thin CRUD tools by operating on any
+ * resource defined in the registry. The LLM calls describe_schema once
+ * to learn what's available, then uses query/mutate for all reads and
+ * simple writes.
+ */
+import type { ToolDefinition } from './types.js';
+export declare const describeSchema: ToolDefinition;
+export declare const query: ToolDefinition;
+export declare const mutate: ToolDefinition;
+export declare const genericTools: ToolDefinition[];
+//# sourceMappingURL=generic.d.ts.map

package/dist/tools/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/tools/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,eAAO,MAAM,cAAc,EAAE,cA0B5B,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,cAwHnB,CAAC;AAIF,eAAO,MAAM,MAAM,EAAE,cAoEpB,CAAC;AAkDF,eAAO,MAAM,YAAY,EAAE,cAAc,EAIxC,CAAC"}

package/dist/tools/generic.js

@@ -0,0 +1,238 @@
+/**
+ * Generic MCP tools: describe_schema, query, mutate.
+ *
+ * These three tools replace ~36 thin CRUD tools by operating on any
+ * resource defined in the registry. The LLM calls describe_schema once
+ * to learn what's available, then uses query/mutate for all reads and
+ * simple writes.
+ */
+import { z } from 'zod';
+import { RESOURCES, serializeRegistry } from './registry.js';
+// ─── describe_schema ────────────────────────────────────────────────
+export const describeSchema = {
+    name: 'describe_schema',
+    description: 'Returns the schema of all queryable resources in DainOS. ' +
+        'Call this once at the start of a session to understand what data is available. ' +
+        'Each resource lists its fields, types, filter options, supported operations, ' +
+        'and whether it supports text search or batch create.',
+    inputSchema: z.object({
+        resource: z
+            .string()
+            .optional()
+            .describe('Return schema for a single resource. Omit to get all resources.'),
+    }),
+    handler: async (_client, input) => {
+        if (input.resource) {
+            const def = RESOURCES[input.resource];
+            if (!def) {
+                throw new Error(`Unknown resource "${input.resource}". Available: ${Object.keys(RESOURCES).join(', ')}`);
+            }
+            const { afterFetch: _af, ...serializable } = def;
+            return { [input.resource]: serializable };
+        }
+        return serializeRegistry();
+    },
+};
+// ─── query ──────────────────────────────────────────────────────────
+export const query = {
+    name: 'query',
+    description: 'Read data from any DainOS resource. ' +
+        'Use describe_schema first to discover available resources and their fields. ' +
+        'Pass `id` to fetch a single record, or `filters` to list/search. ' +
+        'For nested resources (e.g. milestones under projects), pass `parentId`. ' +
+        'Pass `search` for free-text search (only on resources with searchable: true).',
+    inputSchema: z.object({
+        resource: z
+            .string()
+            .describe('Resource name from describe_schema, e.g. "tasks", "projects"'),
+        id: z
+            .string()
+            .optional()
+            .describe('Fetch a single record by ID or slug. Omit to list/search.'),
+        parentId: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Parent resource ID for nested resources (e.g. projectId for milestones)'),
+        filters: z
+            .record(z.union([z.string(), z.number(), z.boolean()]))
+            .optional()
+            .describe('Key-value filters. Keys must be filterable fields from describe_schema.'),
+        search: z
+            .string()
+            .optional()
+            .describe('Free-text search. Only works on resources with searchable: true.'),
+        sort: z
+            .object({
+            field: z.string(),
+            direction: z.enum(['asc', 'desc']).default('desc'),
+        })
+            .optional()
+            .describe('Sort override. Defaults to the resource default sort.'),
+        limit: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('Max records to return (default varies by resource, max 200)'),
+        offset: z.coerce
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Pagination offset'),
+    }),
+    handler: async (client, input) => {
+        const def = lookupResource(input.resource);
+        if (input.search && !def.searchable) {
+            const filterable = listFilterableFields(def);
+            throw new Error(`Resource "${input.resource}" does not support text search. ` +
+                `Use filters instead. Filterable fields: ${filterable.join(', ')}`);
+        }
+        const basePath = resolveBasePath(def, input.parentId);
+        // ── Singleton GET (e.g. proposal_content, product_task_summary) ──
+        if (def.singleton) {
+            if (!input.parentId) {
+                throw new Error(`Resource "${input.resource}" is a singleton nested resource. ` +
+                    `Provide parentId (the ${def.parentIdParam}).`);
+            }
+            const raw = await client.get(basePath);
+            return def.afterFetch ? def.afterFetch(raw, {}) : raw;
+        }
+        // ── Single record by ID ──
+        if (input.id) {
+            const raw = await client.get(`${basePath}/${input.id}`);
+            return def.afterFetch ? def.afterFetch(raw, { id: input.id }) : raw;
+        }
+        // ── List with filters ──
+        const searchBase = def.searchable && input.search && def.searchPath
+            ? def.searchPath
+            : basePath;
+        const params = new URLSearchParams();
+        if (input.filters) {
+            for (const [key, value] of Object.entries(input.filters)) {
+                const field = def.fields[key];
+                if (!field?.filterable) {
+                    const filterable = listFilterableFields(def);
+                    throw new Error(`Field "${key}" is not filterable on "${input.resource}". ` +
+                        `Filterable fields: ${filterable.join(', ')}`);
+                }
+                params.set(key, String(value));
+            }
+        }
+        if (input.search)
+            params.set(def.searchPath ? 'q' : 'search', input.search);
+        if (input.sort) {
+            params.set('sortBy', input.sort.field);
+            params.set('sortDir', input.sort.direction);
+        }
+        const limit = Math.min(input.limit ?? def.defaultLimit ?? 25, def.maxLimit ?? 200);
+        params.set('limit', String(limit));
+        if (input.offset)
+            params.set('offset', String(input.offset));
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const raw = await client.get(`${searchBase}${qs}`);
+        return def.afterFetch ? def.afterFetch(raw, {}) : raw;
+    },
+};
+// ─── mutate ─────────────────────────────────────────────────────────
+export const mutate = {
+    name: 'mutate',
+    description: 'Create, update, or delete a record in any DainOS resource. ' +
+        'Use describe_schema first to discover writable fields and required fields. ' +
+        'For operations with business logic (complete_task, set_proposal_status, ' +
+        'create_proposal_option, proposal_content, etc.), use the dedicated named tool.',
+    inputSchema: z.object({
+        resource: z
+            .string()
+            .describe('Resource name from describe_schema'),
+        operation: z
+            .enum(['create', 'update', 'delete'])
+            .describe('The mutation type'),
+        id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Record ID. Required for update and delete.'),
+        parentId: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Parent ID for nested resources'),
+        data: z
+            .record(z.unknown())
+            .optional()
+            .describe('Fields to set. Required for create/update. Ignored for delete.'),
+    }),
+    handler: async (client, input) => {
+        const def = lookupResource(input.resource);
+        if (def.operations && !def.operations.includes(input.operation)) {
+            throw new Error(`Operation "${input.operation}" is not supported on "${input.resource}". ` +
+                `Allowed: ${def.operations.join(', ')}`);
+        }
+        const basePath = resolveBasePath(def, input.parentId);
+        switch (input.operation) {
+            case 'create': {
+                if (!input.data)
+                    throw new Error('data is required for create operations');
+                validateWritable(def, input.data, input.resource);
+                return client.post(basePath, input.data);
+            }
+            case 'update': {
+                if (!input.id)
+                    throw new Error('id is required for update');
+                if (input.data)
+                    validateWritable(def, input.data, input.resource);
+                const body = Object.fromEntries(Object.entries(input.data ?? {}).filter(([, v]) => v !== undefined));
+                const method = def.updateMethod ?? 'PUT';
+                return method === 'PATCH'
+                    ? client.patch(`${basePath}/${input.id}`, body)
+                    : client.put(`${basePath}/${input.id}`, body);
+            }
+            case 'delete': {
+                if (!input.id)
+                    throw new Error('id is required for delete');
+                return client.delete(`${basePath}/${input.id}`);
+            }
+        }
+    },
+};
+// ─── Helpers ────────────────────────────────────────────────────────
+function lookupResource(name) {
+    const def = RESOURCES[name];
+    if (!def) {
+        throw new Error(`Unknown resource "${name}". Available: ${Object.keys(RESOURCES).join(', ')}`);
+    }
+    return def;
+}
+function resolveBasePath(def, parentId) {
+    if (def.nestedBasePath && parentId) {
+        return def.nestedBasePath.replace('${parentId}', parentId);
+    }
+    if (def.parentIdParam && !parentId) {
+        throw new Error(`Resource requires parentId (${def.parentIdParam}). ` +
+            `Pass it to access this nested resource.`);
+    }
+    return def.basePath;
+}
+function listFilterableFields(def) {
+    return Object.entries(def.fields)
+        .filter(([, f]) => f.filterable)
+        .map(([k]) => k);
+}
+function validateWritable(def, data, resourceName) {
+    for (const key of Object.keys(data)) {
+        const field = def.fields[key];
+        if (field && field.writable === false) {
+            throw new Error(`Field "${key}" is read-only on resource "${resourceName}". Remove it from data.`);
+        }
+    }
+}
+// ─── Export ─────────────────────────────────────────────────────────
+export const genericTools = [
+    describeSchema,
+    query,
+    mutate,
+];
+//# sourceMappingURL=generic.js.map

package/dist/tools/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/tools/generic.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -1,19 +1,13 @@
 import type { ToolDefinition } from './types.js';
-import { projectTools } from './projects.js';
-import { taskTools } from './tasks.js';
-import { commentTools } from './comments.js';
-import { developerTools } from './developer.js';
-import { proposalTools } from './proposals.js';
-import { proposalOptionTools } from './proposal-options.js';
-import { proposalContentTools } from './proposal-content.js';
-import { prReviewTools } from './pr-review.js';
-import { iamTools } from './iam.js';
-import { productTools } from './products.js';
-import { cadenceTools } from './cadence.js';
-import { libraryTools } from './library.js';
-export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, cadenceTools, libraryTools, };
+export { genericTools } from './generic.js';
+export { semanticTools } from './semantic/index.js';
 export type { ToolDefinition };
-/** All tools exposed by the DainOS MCP server. */
+/**
+ * All tools exposed by the DainOS MCP server.
+ *
+ * 3 generic tools (describe_schema, query, mutate) replace ~36 thin CRUD tools.
+ * ~17 semantic tools carry real business logic and keep their named interfaces.
+ */
 export declare const allTools: ToolDefinition[];
 /** Look up a tool by its exposed name. */
 export declare function getTool(name: string): ToolDefinition | undefined;

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,kDAAkD;AAClD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAiBpC,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,cAAc,EAGpC,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}

package/dist/tools/index.js

@@ -1,40 +1,16 @@
-import { projectTools } from './projects.js';
-import { taskTools } from './tasks.js';
-import { commentTools } from './comments.js';
-import { developerTools } from './developer.js';
-import { proposalTools } from './proposals.js';
-import { proposalOptionTools } from './proposal-options.js';
-import { proposalContentTools } from './proposal-content.js';
-import { prReviewTools } from './pr-review.js';
-import { iamTools } from './iam.js';
-import { productTools } from './products.js';
-// @anchor:cadence:mcp-import
-// Sprint + Cadence (R4): claim_next_task, report_task_progress, mark_blocked, request_unblock
-import { cadenceTools } from './cadence.js';
-// @anchor:cadence:mcp-import-end
-// @anchor:cloud-mcp:library-import
-// CLOUD MCP (PRD-086): list_instructions, get_instruction, search_instructions
-import { libraryTools } from './library.js';
-// @anchor:cloud-mcp:library-import-end
-export { projectTools, taskTools, commentTools, developerTools, proposalTools, proposalOptionTools, proposalContentTools, prReviewTools, iamTools, productTools, cadenceTools, libraryTools, };
-/** All tools exposed by the DainOS MCP server. */
+import { genericTools } from './generic.js';
+import { semanticTools } from './semantic/index.js';
+export { genericTools } from './generic.js';
+export { semanticTools } from './semantic/index.js';
+/**
+ * All tools exposed by the DainOS MCP server.
+ *
+ * 3 generic tools (describe_schema, query, mutate) replace ~36 thin CRUD tools.
+ * ~17 semantic tools carry real business logic and keep their named interfaces.
+ */
 export const allTools = [
-    ...projectTools,
-    ...taskTools,
-    ...commentTools,
-    ...developerTools,
-    ...proposalTools,
-    ...proposalOptionTools,
-    ...proposalContentTools,
-    ...prReviewTools,
-    ...iamTools,
-    ...productTools,
-    // @anchor:cadence:mcp-registry
-    ...cadenceTools,
-    // @anchor:cadence:mcp-registry-end
-    // @anchor:cloud-mcp:library-registry
-    ...libraryTools,
-    // @anchor:cloud-mcp:library-registry-end
+    ...genericTools,
+    ...semanticTools,
 ];
 /** Look up a tool by its exposed name. */
 export function getTool(name) {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,6BAA6B;AAC7B,8FAA8F;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,iCAAiC;AACjC,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,uCAAuC;AAEvC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,CAAC;AAGF,kDAAkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,YAAY;IACf,+BAA+B;IAC/B,GAAG,YAAY;IACf,mCAAmC;IACnC,qCAAqC;IACrC,GAAG,YAAY;IACf,yCAAyC;CAC1C,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,GAAG,YAAY;IACf,GAAG,aAAa;CACjB,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Resource registry — single source of truth for every API resource
+ * the generic query/mutate tools can operate on.
+ *
+ * Adding a new resource to the MCP = adding an entry here.
+ * No new tool handler needed.
+ */
+type FieldType = 'string' | 'uuid' | 'number' | 'boolean' | 'date' | 'json' | 'enum';
+export interface FieldDef {
+    type: FieldType;
+    description: string;
+    enumValues?: string[];
+    filterable?: boolean;
+    writable?: boolean;
+    required?: boolean;
+    nullable?: boolean;
+}
+export interface ResourceDef {
+    /** Base REST path, e.g. '/projects', '/crm/proposals' */
+    basePath: string;
+    description: string;
+    fields: Record<string, FieldDef>;
+    /** Supported operations. Omit = all standard CRUD */
+    operations?: Array<'list' | 'get' | 'create' | 'update' | 'delete'>;
+    /** For nested resources: which filter param is the parent ID */
+    parentIdParam?: string;
+    /** For nested resources: path template, e.g. '/projects/${parentId}/milestones' */
+    nestedBasePath?: string;
+    /** GET with parentId returns a single object (no :id needed) */
+    singleton?: boolean;
+    /** Whether free-text search via `search` param is supported */
+    searchable?: boolean;
+    /** Override search endpoint when it differs from basePath */
+    searchPath?: string;
+    /** HTTP method for update (default: PUT) */
+    updateMethod?: 'PUT' | 'PATCH';
+    defaultSort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    defaultLimit?: number;
+    maxLimit?: number;
+    /**
+     * Stateless post-fetch transform. Runs after every GET response.
+     * If this needs extra API calls, extract a semantic tool instead.
+     */
+    afterFetch?: (data: unknown, input: {
+        id?: string;
+    }) => unknown;
+}
+export declare const RESOURCES: Record<string, ResourceDef>;
+/** Serialize registry for describe_schema output, stripping non-serializable hooks. */
+export declare function serializeRegistry(resources?: Record<string, ResourceDef>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,qDAAqD;IACrD,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACpE,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;CACjE;AAKD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAiUjD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}