@specforge/mcp 2.0.1 → 2.0.3

package/dist/tools/core/help.js

@@ -0,0 +1,112 @@
+// mcp/src/tools/core/help.ts
+import { createOperationRouter } from './router.js';
+// Tool registry for help system
+const CONSOLIDATED_TOOLS = [
+    { name: 'ticket', description: 'Manage tickets', operations: ['create', 'get', 'update', 'list', 'search'] },
+    { name: 'epic', description: 'Manage epics', operations: ['create', 'get', 'update', 'list', 'lookup'] },
+    { name: 'specification', description: 'Manage specifications', operations: ['create', 'get', 'update', 'import', 'list'] },
+    { name: 'project', description: 'Manage projects', operations: ['get', 'list', 'lookup'] },
+    { name: 'session', description: 'Manage work sessions', operations: ['start', 'complete', 'progress', 'end', 'report'] },
+    { name: 'context', description: 'Get and manage context', operations: ['working', 'implementation', 'set'] },
+    { name: 'dependency', description: 'Manage ticket dependencies', operations: ['add', 'remove', 'tree'] },
+    { name: 'bulk', description: 'Bulk operations', operations: ['create_tickets', 'update_tickets', 'add_dependencies'] },
+    { name: 'lookup', description: 'Look up entities', operations: ['ticket', 'epic', 'specification', 'project', 'tickets_by_status'] },
+    { name: 'workflow', description: 'Get workflow info', operations: ['next_actionable', 'blocked', 'critical_path'] },
+    { name: 'pattern', description: 'Manage patterns', operations: ['get', 'set'] },
+    { name: 'job', description: 'Manage async jobs', operations: ['status', 'cancel'] },
+    { name: 'link', description: 'Link external resources', operations: ['commit', 'pull_request'] },
+    { name: 'admin', description: 'Admin utilities', operations: ['reset_tickets', 'validate_counts'] },
+    { name: 'help', description: 'Get help', operations: ['tools', 'operations', 'examples'] },
+];
+const TOOL_EXAMPLES = {
+    ticket: [
+        { description: 'Create a ticket', call: { operation: 'create', epicId: 'epic-123', title: 'Fix bug', priority: 'high' } },
+        { description: 'Get a ticket', call: { operation: 'get', ticketId: 'ticket-456' } },
+        { description: 'Update status', call: { operation: 'update', ticketId: 'ticket-456', status: 'done' } },
+        { description: 'List tickets', call: { operation: 'list', epicId: 'epic-123' } },
+        { description: 'Search tickets', call: { operation: 'search', query: 'authentication', projectId: 'proj-1' } },
+    ],
+    epic: [
+        { description: 'Create an epic', call: { operation: 'create', specificationId: 'spec-123', title: 'Auth', description: 'Auth epic', objective: 'Implement auth' } },
+        { description: 'Get an epic', call: { operation: 'get', epicId: 'epic-456' } },
+    ],
+    session: [
+        { description: 'Start working', call: { operation: 'start', ticketId: 'ticket-123' } },
+        { description: 'Report progress', call: { operation: 'progress', ticketId: 'ticket-123', progress: 50 } },
+        { description: 'Complete work', call: { operation: 'complete', ticketId: 'ticket-123', summary: 'Fixed the bug' } },
+    ],
+    bulk: [
+        { description: 'Create multiple tickets', call: { operation: 'create_tickets', epicId: 'epic-1', tickets: [{ title: 'Task 1' }, { title: 'Task 2' }] } },
+    ],
+};
+export const helpTool = {
+    name: 'help',
+    description: `Get help and documentation. Operations:
+- tools: List all available tools
+- operations: List operations for a tool
+- examples: Show usage examples`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['tools', 'operations', 'examples'],
+                description: 'The operation to perform',
+            },
+            tool: { type: 'string', description: 'Tool name for operations/examples' },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createHelpOperations() {
+    return {
+        tools: async (_args, _userId) => {
+            return {
+                tools: CONSOLIDATED_TOOLS,
+                count: CONSOLIDATED_TOOLS.length,
+            };
+        },
+        operations: async (args, _userId) => {
+            validateRequired(args, 'tool');
+            const toolName = args.tool;
+            const tool = CONSOLIDATED_TOOLS.find((t) => t.name === toolName);
+            if (!tool) {
+                const validTools = CONSOLIDATED_TOOLS.map((t) => t.name).join(', ');
+                throw new Error(`Unknown tool '${toolName}'. Valid tools: ${validTools}`);
+            }
+            return {
+                tool: tool.name,
+                description: tool.description,
+                operations: tool.operations,
+            };
+        },
+        examples: async (args, _userId) => {
+            validateRequired(args, 'tool');
+            const toolName = args.tool;
+            const examples = TOOL_EXAMPLES[toolName];
+            if (!examples) {
+                return {
+                    tool: toolName,
+                    examples: [],
+                    message: `No examples available for '${toolName}'`,
+                };
+            }
+            return {
+                tool: toolName,
+                examples,
+            };
+        },
+    };
+}
+export function createHelpHandler() {
+    const operations = createHelpOperations();
+    return createOperationRouter('help', operations);
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/core/help.js.map

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

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

@@ -0,0 +1,18 @@
+export * from './types.js';
+export * from './router.js';
+export * from './ticket.js';
+export * from './epic.js';
+export * from './specification.js';
+export * from './project.js';
+export * from './session.js';
+export * from './context.js';
+export * from './dependency.js';
+export * from './bulk.js';
+export * from './lookup.js';
+export * from './workflow.js';
+export * from './pattern.js';
+export * from './job.js';
+export * from './link.js';
+export * from './admin.js';
+export * from './help.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/core/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/tools/core/index.js

@@ -0,0 +1,20 @@
+// mcp/src/tools/core/index.ts
+export * from './types.js';
+export * from './router.js';
+export * from './ticket.js';
+export * from './epic.js';
+export * from './specification.js';
+export * from './project.js';
+export * from './session.js';
+export * from './context.js';
+export * from './dependency.js';
+export * from './bulk.js';
+export * from './lookup.js';
+export * from './workflow.js';
+export * from './pattern.js';
+export * from './job.js';
+export * from './link.js';
+export * from './admin.js';
+export * from './help.js';
+// Consolidated tools will be exported here
+//# sourceMappingURL=index.js.map

package/dist/tools/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/core/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAE1B,2CAA2C"}

package/dist/tools/core/job.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const jobTool: Tool;
+export declare function createJobOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createJobHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=job.d.ts.map

package/dist/tools/core/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../../src/tools/core/job.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,OAAO,EAAE,IAmBrB,CAAC;AAUF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAgB1F;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,oEAGpD"}

package/dist/tools/core/job.js

@@ -0,0 +1,50 @@
+// mcp/src/tools/core/job.ts
+import { createOperationRouter } from './router.js';
+export const jobTool = {
+    name: 'job',
+    description: `Manage async jobs. Operations:
+- status: Get job status
+- cancel: Cancel a running job`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['status', 'cancel'],
+                description: 'The operation to perform',
+            },
+            jobId: { type: 'string', description: 'Job ID' },
+            // Response options
+            format: { type: 'string', enum: ['json', 'toon'] },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createJobOperations(apiClient) {
+    return {
+        status: async (args, _userId) => {
+            validateRequired(args, 'jobId');
+            return await apiClient.call('get_job_status', {
+                jobId: args.jobId,
+            });
+        },
+        cancel: async (args, _userId) => {
+            validateRequired(args, 'jobId');
+            return await apiClient.call('cancel_job', {
+                jobId: args.jobId,
+            });
+        },
+    };
+}
+export function createJobHandler(apiClient) {
+    const operations = createJobOperations(apiClient);
+    return createOperationRouter('job', operations);
+}
+//# sourceMappingURL=job.js.map

package/dist/tools/core/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../../src/tools/core/job.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAG5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,KAAK;IACX,WAAW,EAAE;;+BAEgB;IAC7B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAC1B,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;YAChD,mBAAmB;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;SACnD;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,IAA0B,EAAE,GAAG,MAAgB;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YAC5D,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YAC5D,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE;gBACxC,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/tools/core/link.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const linkTool: Tool;
+export declare function createLinkOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createLinkHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=link.d.ts.map

package/dist/tools/core/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/tools/core/link.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,IA2BtB,CAAC;AAgBF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA6B3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,oEAGrD"}

package/dist/tools/core/link.js

@@ -0,0 +1,76 @@
+// mcp/src/tools/core/link.ts
+import { createOperationRouter } from './router.js';
+export const linkTool = {
+    name: 'link',
+    description: `Link external resources to tickets. Operations:
+- commit: Link a git commit
+- pull_request: Link a pull request`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['commit', 'pull_request'],
+                description: 'The operation to perform',
+            },
+            ticketId: { type: 'string', description: 'Ticket ID' },
+            // For commit
+            sha: { type: 'string', description: 'Git commit SHA' },
+            message: { type: 'string', description: 'Commit message' },
+            // For pull_request
+            prNumber: { type: 'number', description: 'PR number' },
+            prUrl: { type: 'string', description: 'PR URL' },
+            title: { type: 'string', description: 'PR title' },
+            // Common
+            author: { type: 'string', description: 'Author' },
+            repoUrl: { type: 'string', description: 'Repository URL' },
+        },
+        required: ['operation', 'ticketId'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+function validateSha(sha) {
+    if (!/^[a-f0-9]{7,40}$/i.test(sha)) {
+        throw new Error('sha must be a valid git commit hash (7-40 hex characters)');
+    }
+}
+export function createLinkOperations(apiClient) {
+    return {
+        commit: async (args, _userId) => {
+            validateRequired(args, 'ticketId', 'sha');
+            validateSha(args.sha);
+            return await apiClient.call('link_commit', {
+                ticketId: args.ticketId,
+                sha: args.sha,
+                message: args.message,
+                author: args.author,
+                repoUrl: args.repoUrl,
+            });
+        },
+        pull_request: async (args, _userId) => {
+            validateRequired(args, 'ticketId');
+            if (!args.prNumber && !args.prUrl) {
+                throw new Error('Either prNumber or prUrl must be provided');
+            }
+            return await apiClient.call('link_pull_request', {
+                ticketId: args.ticketId,
+                prNumber: args.prNumber,
+                prUrl: args.prUrl,
+                title: args.title,
+                author: args.author,
+                repoUrl: args.repoUrl,
+            });
+        },
+    };
+}
+export function createLinkHandler(apiClient) {
+    const operations = createLinkOperations(apiClient);
+    return createOperationRouter('link', operations);
+}
+//# sourceMappingURL=link.js.map

package/dist/tools/core/link.js.map

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

package/dist/tools/core/lookup.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const lookupTool: Tool;
+export declare function createLookupOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createLookupHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/tools/core/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../src/tools/core/lookup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,IAiCxB,CAAC;AAUF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA8D7F;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,oEAGvD"}

package/dist/tools/core/lookup.js

@@ -0,0 +1,107 @@
+// mcp/src/tools/core/lookup.ts
+import { createOperationRouter } from './router.js';
+export const lookupTool = {
+    name: 'lookup',
+    description: `Look up entities by name or criteria. Operations:
+- ticket: Find ticket by name or number
+- epic: Find epic by name or number
+- specification: Find specification by name
+- project: Find project by name
+- tickets_by_status: Look up multiple tickets by IDs`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['ticket', 'epic', 'specification', 'project', 'tickets_by_status'],
+                description: 'The operation to perform',
+            },
+            // For ticket lookup
+            epicId: { type: 'string', description: 'Epic ID for ticket lookup' },
+            // For epic lookup
+            specificationId: { type: 'string', description: 'Specification ID for epic lookup' },
+            // For specification lookup
+            projectId: { type: 'string', description: 'Project ID for specification lookup' },
+            // For name-based lookups
+            name: { type: 'string', description: 'Name to search for' },
+            title: { type: 'string', description: 'Title to search for' },
+            number: { type: 'number', description: 'Number for ticket/epic lookup' },
+            // For tickets_by_status
+            ticketIds: { type: 'array', items: { type: 'string' }, description: 'Ticket IDs to look up' },
+            // Response options
+            format: { type: 'string', enum: ['json', 'toon'] },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createLookupOperations(apiClient) {
+    return {
+        ticket: async (args, _userId) => {
+            validateRequired(args, 'epicId');
+            if (!args.title && args.number === undefined) {
+                throw new Error("Must provide either 'title' or 'number'");
+            }
+            return await apiClient.call('lookup_ticket', {
+                epicId: args.epicId,
+                title: args.title,
+                number: args.number,
+                format: args.format,
+            });
+        },
+        epic: async (args, _userId) => {
+            validateRequired(args, 'specificationId');
+            if (!args.title && args.number === undefined) {
+                throw new Error("Must provide either 'title' or 'number'");
+            }
+            return await apiClient.call('lookup_epic', {
+                specificationId: args.specificationId,
+                title: args.title,
+                number: args.number,
+                format: args.format,
+            });
+        },
+        specification: async (args, _userId) => {
+            validateRequired(args, 'projectId', 'title');
+            return await apiClient.call('lookup_specification', {
+                projectId: args.projectId,
+                title: args.title,
+                format: args.format,
+            });
+        },
+        project: async (args, _userId) => {
+            validateRequired(args, 'name');
+            return await apiClient.call('lookup_project', {
+                name: args.name,
+                format: args.format,
+            });
+        },
+        tickets_by_status: async (args, _userId) => {
+            validateRequired(args, 'ticketIds');
+            if (!Array.isArray(args.ticketIds)) {
+                throw new Error('ticketIds must be an array');
+            }
+            const MAX_BATCH_SIZE = 50;
+            if (args.ticketIds.length > MAX_BATCH_SIZE) {
+                throw new Error(`Maximum ${MAX_BATCH_SIZE} tickets per call`);
+            }
+            if (args.ticketIds.length === 0) {
+                return { tickets: [], notFound: [] };
+            }
+            return await apiClient.call('lookup_tickets_by_status', {
+                ticketIds: args.ticketIds,
+            });
+        },
+    };
+}
+export function createLookupHandler(apiClient) {
+    const operations = createLookupOperations(apiClient);
+    return createOperationRouter('lookup', operations);
+}
+//# sourceMappingURL=lookup.js.map

package/dist/tools/core/lookup.js.map

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

package/dist/tools/core/pattern.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const patternTool: Tool;
+export declare function createPatternOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createPatternHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=pattern.d.ts.map

package/dist/tools/core/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../src/tools/core/pattern.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,IAsBzB,CAAC;AAUF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAwB9F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,oEAGxD"}

package/dist/tools/core/pattern.js

@@ -0,0 +1,61 @@
+// mcp/src/tools/core/pattern.ts
+import { createOperationRouter } from './router.js';
+export const patternTool = {
+    name: 'pattern',
+    description: `Manage implementation patterns. Operations:
+- get: Get patterns for a specification or ticket
+- set: Set patterns for a specification/epic`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['get', 'set'],
+                description: 'The operation to perform',
+            },
+            specificationId: { type: 'string', description: 'Specification ID' },
+            epicId: { type: 'string', description: 'Epic ID' },
+            ticketId: { type: 'string', description: 'Ticket ID for get operation' },
+            patterns: { type: 'object', description: 'Patterns to set' },
+            // Response options
+            format: { type: 'string', enum: ['json', 'toon'] },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createPatternOperations(apiClient) {
+    return {
+        get: async (args, _userId) => {
+            if (!args.specificationId && !args.ticketId) {
+                throw new Error('Either specificationId or ticketId is required');
+            }
+            return await apiClient.call('get_patterns', {
+                specificationId: args.specificationId,
+                ticketId: args.ticketId,
+            });
+        },
+        set: async (args, _userId) => {
+            if (!args.specificationId && !args.epicId) {
+                throw new Error('Either specificationId or epicId is required');
+            }
+            validateRequired(args, 'patterns');
+            return await apiClient.call('set_patterns', {
+                specificationId: args.specificationId,
+                epicId: args.epicId,
+                patterns: args.patterns,
+            });
+        },
+    };
+}
+export function createPatternHandler(apiClient) {
+    const operations = createPatternOperations(apiClient);
+    return createOperationRouter('pattern', operations);
+}
+//# sourceMappingURL=pattern.js.map

package/dist/tools/core/pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../../src/tools/core/pattern.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAGhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE;;6CAE8B;IAC3C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;gBACpB,WAAW,EAAE,0BAA0B;aACxC;YACD,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE;YAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACxE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;YAC5D,mBAAmB;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;SACnD;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,IAA0B,EAAE,GAAG,MAAgB;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YACzD,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC1C,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QAED,GAAG,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YACzD,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;YACD,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACnC,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC1C,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/dist/tools/core/project.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const projectTool: Tool;
+export declare function createProjectOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createProjectHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=project.d.ts.map

package/dist/tools/core/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/tools/core/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,IAyBzB,CAAC;AAUF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAqB9F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,oEAGxD"}

package/dist/tools/core/project.js

@@ -0,0 +1,60 @@
+// mcp/src/tools/core/project.ts
+import { createOperationRouter } from './router.js';
+export const projectTool = {
+    name: 'project',
+    description: `Manage projects. Operations:
+- get: Get project by ID
+- list: List all projects
+- lookup: Find project by name`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['get', 'list', 'lookup'],
+                description: 'The operation to perform',
+            },
+            // For get
+            projectId: { type: 'string', description: 'Project ID' },
+            // For lookup
+            name: { type: 'string', description: 'Project name for lookup' },
+            // Response options
+            format: { type: 'string', enum: ['json', 'toon'] },
+            responseMode: { type: 'string', enum: ['full', 'minimal', 'summary', 'id-only'] },
+            include: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createProjectOperations(apiClient) {
+    return {
+        get: async (args, _userId) => {
+            validateRequired(args, 'projectId');
+            return await apiClient.call('get_project', {
+                projectId: args.projectId,
+            });
+        },
+        list: async (_args, _userId) => {
+            return await apiClient.call('list_projects', {});
+        },
+        lookup: async (args, _userId) => {
+            validateRequired(args, 'name');
+            return await apiClient.call('lookup_project', {
+                name: args.name,
+                format: args.format,
+            });
+        },
+    };
+}
+export function createProjectHandler(apiClient) {
+    const operations = createProjectOperations(apiClient);
+    return createOperationRouter('project', operations);
+}
+//# sourceMappingURL=project.js.map

package/dist/tools/core/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/tools/core/project.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAGhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE;;;+BAGgB;IAC7B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC;gBAC/B,WAAW,EAAE,0BAA0B;aACxC;YACD,UAAU;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,aAAa;YACb,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAChE,mBAAmB;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YACjF,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SACtD;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,SAAS,gBAAgB,CAAC,IAA0B,EAAE,GAAG,MAAgB;IACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YACzD,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACpC,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE;gBACzC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,EAAE,KAAK,EAAE,KAA2B,EAAE,OAAe,EAAE,EAAE;YAC3D,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAA0B,EAAE,OAAe,EAAE,EAAE;YAC5D,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/dist/tools/core/router.d.ts

@@ -0,0 +1,3 @@
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+export declare function createOperationRouter(toolName: string, operations: Record<string, OperationHandler>): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=router.d.ts.map