@specforge/mcp 2.0.1 → 2.0.3

package/dist/tools/core/admin.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 adminTool: Tool;
+export declare function createAdminOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createAdminHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/tools/core/admin.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,SAAS,EAAE,IA+BvB,CAAC;AAUF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA+B5F;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,oEAGtD"}

package/dist/tools/core/admin.js

@@ -0,0 +1,77 @@
+// mcp/src/tools/core/admin.ts
+import { createOperationRouter } from './router.js';
+export const adminTool = {
+    name: 'admin',
+    description: `Administrative utilities. Operations:
+- reset_tickets: Reset ticket statuses
+- validate_counts: Validate and fix count aggregations`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['reset_tickets', 'validate_counts'],
+                description: 'The operation to perform',
+            },
+            // For reset_tickets
+            specificationId: { type: 'string', description: 'Specification ID' },
+            epicId: { type: 'string', description: 'Epic ID' },
+            ticketIds: { type: 'array', items: { type: 'string' } },
+            fromTicketId: { type: 'string' },
+            allTickets: { type: 'boolean' },
+            targetStatus: { type: 'string' },
+            resetDependents: { type: 'boolean' },
+            includeCompleted: { type: 'boolean' },
+            preserveNotes: { type: 'boolean' },
+            clearTestResults: { type: 'boolean' },
+            // For validate_counts
+            projectId: { type: 'string', description: 'Project ID' },
+            repair: { type: 'boolean', description: 'Auto-repair issues' },
+            verbose: { type: 'boolean', description: 'Verbose output' },
+        },
+        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 createAdminOperations(apiClient) {
+    return {
+        reset_tickets: async (args, _userId) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('reset_tickets', {
+                specificationId: args.specificationId,
+                ticketIds: args.ticketIds,
+                fromTicketId: args.fromTicketId,
+                epicId: args.epicId,
+                allTickets: args.allTickets,
+                targetStatus: args.targetStatus,
+                resetDependents: args.resetDependents,
+                includeCompleted: args.includeCompleted,
+                preserveNotes: args.preserveNotes,
+                clearTestResults: args.clearTestResults,
+            });
+        },
+        validate_counts: async (args, _userId) => {
+            if (!args.projectId && !args.specificationId && !args.epicId) {
+                throw new Error('Must specify projectId, specificationId, or epicId');
+            }
+            return await apiClient.call('validate_counts', {
+                projectId: args.projectId,
+                specificationId: args.specificationId,
+                epicId: args.epicId,
+                repair: args.repair,
+                verbose: args.verbose,
+            });
+        },
+    };
+}
+export function createAdminHandler(apiClient) {
+    const operations = createAdminOperations(apiClient);
+    return createOperationRouter('admin', operations);
+}
+//# sourceMappingURL=admin.js.map

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

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

package/dist/tools/core/bulk.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 bulkTool: Tool;
+export declare function createBulkOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createBulkHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=bulk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../../src/tools/core/bulk.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,IAqDtB,CAAC;AAUF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA0D3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,oEAGrD"}

package/dist/tools/core/bulk.js

@@ -0,0 +1,125 @@
+// mcp/src/tools/core/bulk.ts
+import { createOperationRouter } from './router.js';
+export const bulkTool = {
+    name: 'bulk',
+    description: `Bulk operations on multiple items. Operations:
+- create_tickets: Create multiple tickets at once
+- update_tickets: Update multiple tickets
+- add_dependencies: Add multiple dependencies`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create_tickets', 'update_tickets', 'add_dependencies'],
+                description: 'The operation to perform',
+            },
+            // For create_tickets
+            epicId: { type: 'string', description: 'Epic ID for create_tickets' },
+            tickets: {
+                type: 'array',
+                items: { type: 'object' },
+                description: 'Ticket data for create_tickets',
+            },
+            // For update_tickets
+            updates: {
+                type: 'array',
+                items: { type: 'object' },
+                description: 'Updates for update_tickets',
+            },
+            // For add_dependencies
+            dependencies: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        ticketId: { type: 'string' },
+                        dependsOnId: { type: 'string' },
+                    },
+                },
+                description: 'Dependencies to add',
+            },
+            // Options
+            onError: {
+                type: 'string',
+                enum: ['stop', 'continue', 'rollback'],
+                description: 'Error handling strategy',
+            },
+            skipCircularCheck: { type: 'boolean' },
+            validateDependencies: { type: 'boolean' },
+            atomic: { type: 'boolean' },
+            // Response options
+            responseMode: { type: 'string', enum: ['full', 'id-only', 'summary'] },
+        },
+        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 createBulkOperations(apiClient) {
+    return {
+        create_tickets: async (args, _userId) => {
+            validateRequired(args, 'epicId', 'tickets');
+            if (!Array.isArray(args.tickets) || args.tickets.length === 0) {
+                throw new Error('tickets array is required and must not be empty');
+            }
+            // Validate each ticket has a title
+            const tickets = args.tickets;
+            for (let i = 0; i < tickets.length; i++) {
+                if (!tickets[i].title || typeof tickets[i].title !== 'string') {
+                    throw new Error(`tickets[${i}].title is required and must be a string`);
+                }
+            }
+            return await apiClient.call('bulk_create_tickets', {
+                epicId: args.epicId,
+                tickets: args.tickets,
+                dependencies: args.dependencies,
+                onError: args.onError,
+            });
+        },
+        update_tickets: async (args, _userId) => {
+            if (!args.updates || !Array.isArray(args.updates) || args.updates.length === 0) {
+                throw new Error('updates array is required and must not be empty');
+            }
+            return await apiClient.call('bulk_update_tickets', {
+                updates: args.updates,
+                validateDependencies: args.validateDependencies,
+                atomic: args.atomic,
+            });
+        },
+        add_dependencies: async (args, _userId) => {
+            validateRequired(args, 'dependencies');
+            if (!Array.isArray(args.dependencies) || args.dependencies.length === 0) {
+                throw new Error('dependencies array is required and must not be empty');
+            }
+            // Validate each dependency has required fields
+            const deps = args.dependencies;
+            for (let i = 0; i < deps.length; i++) {
+                if (!deps[i].ticketId || typeof deps[i].ticketId !== 'string') {
+                    throw new Error(`dependencies[${i}].ticketId is required`);
+                }
+                if (!deps[i].dependsOnId || typeof deps[i].dependsOnId !== 'string') {
+                    throw new Error(`dependencies[${i}].dependsOnId is required`);
+                }
+                if (deps[i].ticketId === deps[i].dependsOnId) {
+                    throw new Error(`dependencies[${i}]: ticket cannot depend on itself`);
+                }
+            }
+            return await apiClient.call('bulk_add_dependencies', {
+                dependencies: args.dependencies,
+                skipCircularCheck: args.skipCircularCheck,
+                onError: args.onError,
+            });
+        },
+    };
+}
+export function createBulkHandler(apiClient) {
+    const operations = createBulkOperations(apiClient);
+    return createOperationRouter('bulk', operations);
+}
+//# sourceMappingURL=bulk.js.map

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

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

package/dist/tools/core/context.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 contextTool: Tool;
+export declare function createContextOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createContextHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/tools/core/context.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,IA+BzB,CAAC;AAUF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAgC9F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,oEAGxD"}

package/dist/tools/core/context.js

@@ -0,0 +1,75 @@
+// mcp/src/tools/core/context.ts
+import { createOperationRouter } from './router.js';
+export const contextTool = {
+    name: 'context',
+    description: `Get and manage context. Operations:
+- working: Get current working context (project scope)
+- implementation: Get implementation context for a ticket
+- set: Set/update current working context`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['working', 'implementation', 'set'],
+                description: 'The operation to perform',
+            },
+            // For set working context
+            projectId: { type: 'string', description: 'Project ID' },
+            specificationId: { type: 'string', description: 'Specification ID' },
+            epicId: { type: 'string', description: 'Epic ID' },
+            // For implementation context
+            ticketId: { type: 'string', description: 'Ticket ID for implementation context' },
+            depth: {
+                type: 'string',
+                enum: ['minimal', 'standard', 'full'],
+                description: 'Context depth level',
+            },
+            // Response options
+            format: { type: 'string', enum: ['json', 'toon'] },
+            responseMode: { type: 'string', enum: ['full', 'minimal', 'summary', 'id-only'] },
+        },
+        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 createContextOperations(apiClient) {
+    return {
+        working: async (_args, _userId) => {
+            // Note: In actual implementation, this uses client.getSessionId()
+            // For the consolidated tool, we pass through to the API
+            return await apiClient.call('get_working_context', {});
+        },
+        implementation: async (args, _userId) => {
+            validateRequired(args, 'ticketId');
+            const depth = args.depth || 'standard';
+            return await apiClient.call('get_implementation_context', {
+                ticketId: args.ticketId,
+                depth,
+            });
+        },
+        set: async (args, _userId) => {
+            // At least one context field should be provided
+            if (!args.projectId && !args.specificationId && !args.epicId && !args.ticketId) {
+                throw new Error('At least one of projectId, specificationId, epicId, or ticketId is required');
+            }
+            return await apiClient.call('set_working_context', {
+                projectId: args.projectId,
+                specificationId: args.specificationId,
+                epicId: args.epicId,
+                ticketId: args.ticketId,
+            });
+        },
+    };
+}
+export function createContextHandler(apiClient) {
+    const operations = createContextOperations(apiClient);
+    return createOperationRouter('context', operations);
+}
+//# sourceMappingURL=context.js.map

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

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

package/dist/tools/core/dependency.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 dependencyTool: Tool;
+export declare function createDependencyOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createDependencyHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=dependency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../../src/tools/core/dependency.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,cAAc,EAAE,IA8B5B,CAAC;AAUF,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA8BjG;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,oEAG3D"}

package/dist/tools/core/dependency.js

@@ -0,0 +1,74 @@
+// mcp/src/tools/core/dependency.ts
+import { createOperationRouter } from './router.js';
+export const dependencyTool = {
+    name: 'dependency',
+    description: `Manage ticket dependencies. Operations:
+- add: Add a dependency between tickets
+- remove: Remove a dependency
+- tree: Get dependency tree for a specification`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['add', 'remove', 'tree'],
+                description: 'The operation to perform',
+            },
+            // For add/remove
+            ticketId: { type: 'string', description: 'Ticket ID' },
+            dependsOnId: { type: 'string', description: 'Ticket that must complete first' },
+            dependencyId: { type: 'string', description: 'Dependency ID for remove' },
+            type: {
+                type: 'string',
+                enum: ['blocks', 'requires', 'related'],
+                description: 'Dependency type',
+            },
+            // For tree
+            specificationId: { type: 'string', description: 'Specification ID for tree' },
+            // 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 createDependencyOperations(apiClient) {
+    return {
+        add: async (args, _userId) => {
+            validateRequired(args, 'ticketId', 'dependsOnId');
+            return await apiClient.call('add_dependency', {
+                ticketId: args.ticketId,
+                dependsOnId: args.dependsOnId,
+                type: args.type,
+            });
+        },
+        remove: async (args, _userId) => {
+            // Either dependencyId or (ticketId + dependsOnId) required
+            if (!args.dependencyId && !args.ticketId) {
+                throw new Error('Either dependencyId or ticketId is required');
+            }
+            return await apiClient.call('remove_dependency', {
+                ticketId: args.ticketId,
+                dependsOnId: args.dependsOnId,
+                dependencyId: args.dependencyId,
+            });
+        },
+        tree: async (args, _userId) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('get_dependency_tree', {
+                specificationId: args.specificationId,
+            });
+        },
+    };
+}
+export function createDependencyHandler(apiClient) {
+    const operations = createDependencyOperations(apiClient);
+    return createOperationRouter('dependency', operations);
+}
+//# sourceMappingURL=dependency.js.map

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

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

package/dist/tools/core/epic.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 epicTool: Tool;
+export declare function createEpicOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createEpicHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=epic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../src/tools/core/epic.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,IAsFtB,CAAC;AAUF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA4D3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,oEAGrD"}

package/dist/tools/core/epic.js

@@ -0,0 +1,158 @@
+// mcp/src/tools/core/epic.ts
+import { createOperationRouter } from './router.js';
+export const epicTool = {
+    name: 'epic',
+    description: `Manage epics. Operations:
+- create: Create a new epic in a specification
+- get: Get epic by ID
+- update: Update epic fields
+- list: List epics with filters
+- lookup: Find epic by title or number`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create', 'get', 'update', 'list', 'lookup'],
+                description: 'The operation to perform',
+            },
+            // For get/update
+            epicId: { type: 'string', description: 'Epic ID' },
+            // For create/list/lookup
+            specificationId: { type: 'string', description: 'Specification ID' },
+            // For create/update
+            title: { type: 'string' },
+            description: { type: 'string' },
+            objective: { type: 'string' },
+            status: { type: 'string', enum: ['pending', 'active', 'done', 'archived'] },
+            priority: { type: 'string', enum: ['critical', 'high', 'medium', 'low'] },
+            tags: { type: 'array', items: { type: 'string' } },
+            estimatedHours: { type: 'number' },
+            // For create - inline tickets
+            tickets: {
+                type: 'array',
+                description: 'Inline tickets to create with the epic',
+                items: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string', description: 'Ticket title (required)' },
+                        description: { type: 'string', description: 'Ticket description' },
+                        complexity: {
+                            type: 'string',
+                            enum: ['small', 'medium', 'large', 'xlarge'],
+                            description: 'Ticket complexity',
+                        },
+                        priority: {
+                            type: 'string',
+                            enum: ['critical', 'high', 'medium', 'low'],
+                            description: 'Ticket priority',
+                        },
+                        tags: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Tags for the ticket',
+                        },
+                        estimatedHours: {
+                            type: 'number',
+                            description: 'Estimated hours to complete',
+                        },
+                        acceptanceCriteria: {
+                            type: 'array',
+                            items: { type: 'object' },
+                            description: 'Acceptance criteria objects',
+                        },
+                        dependsOn: {
+                            type: 'array',
+                            items: { type: 'number' },
+                            description: 'Array of ticket indexes this ticket depends on (0-indexed)',
+                        },
+                    },
+                    required: ['title'],
+                },
+            },
+            // For lookup
+            number: { type: 'number', description: 'Epic number for lookup' },
+            // For list
+            filter: {
+                type: 'object',
+                properties: {
+                    status: { type: 'string' },
+                },
+            },
+            // 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 createEpicOperations(apiClient) {
+    return {
+        create: async (args, _userId) => {
+            validateRequired(args, 'specificationId', 'title', 'description', 'objective');
+            return await apiClient.call('create_epic', {
+                specificationId: args.specificationId,
+                title: args.title,
+                description: args.description,
+                objective: args.objective,
+                priority: args.priority,
+                tags: args.tags,
+                estimatedHours: args.estimatedHours,
+                tickets: args.tickets,
+            });
+        },
+        get: async (args, _userId) => {
+            validateRequired(args, 'epicId');
+            return await apiClient.call('get_epic', {
+                epicId: args.epicId,
+                include: args.include,
+            });
+        },
+        update: async (args, _userId) => {
+            validateRequired(args, 'epicId');
+            return await apiClient.call('update_epic', {
+                epicId: args.epicId,
+                title: args.title,
+                description: args.description,
+                objective: args.objective,
+                status: args.status,
+                priority: args.priority,
+                tags: args.tags,
+                estimatedHours: args.estimatedHours,
+            });
+        },
+        list: async (args, _userId) => {
+            validateRequired(args, 'specificationId');
+            const filter = args.filter;
+            return await apiClient.call('list_epics', {
+                specificationId: args.specificationId,
+                status: filter?.status || args.status,
+            });
+        },
+        lookup: 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,
+            });
+        },
+    };
+}
+export function createEpicHandler(apiClient) {
+    const operations = createEpicOperations(apiClient);
+    return createOperationRouter('epic', operations);
+}
+//# sourceMappingURL=epic.js.map

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

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

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

@@ -0,0 +1,6 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+export declare const helpTool: Tool;
+export declare function createHelpOperations(): Record<string, OperationHandler>;
+export declare function createHelpHandler(): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/tools/core/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2CpE,eAAO,MAAM,QAAQ,EAAE,IAkBtB,CAAC;AAUF,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyCvE;AAED,wBAAgB,iBAAiB,qEAGhC"}