mcp-taskflow 0.1.0

package/dist/server/mcpServer.js

@@ -0,0 +1,236 @@
+/**
+ * MCP Server Setup & Tool Registration
+ *
+ * Implements the Model Context Protocol (MCP) server using @modelcontextprotocol/sdk.
+ * The server uses STDIO transport for universal compatibility and follows the
+ * JSON-RPC 2.0 protocol for request/response communication.
+ *
+ * Key Concepts:
+ * - STDIO Transport: Uses stdin for input, stdout for output, stderr for logs
+ * - JSON-RPC: Protocol for request correlation (id, method, params, result/error)
+ * - Tool Discovery: Clients call tools/list to see available capabilities
+ * - Stateless Design: Each request is independent (no session state)
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/architecture
+ * @see https://www.jsonrpc.org/specification
+ */
+// Using Server from index.js instead of McpServer from mcp.js
+// The new McpServer API is different and would require significant refactoring
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { registerTaskPlanningTools, registerTaskCRUDTools, registerTaskWorkflowTools } from '../tools/task/taskTools.js';
+import { registerProjectTools } from '../tools/project/projectTools.js';
+import { registerThoughtTools } from '../tools/thought/thoughtTools.js';
+import { registerResearchTools } from '../tools/research/researchTools.js';
+/**
+ * MCP Server instance
+ *
+ * Manages the lifecycle of the MCP server including:
+ * - Tool registration and discovery
+ * - Request handling and routing
+ * - Error handling and logging
+ * - Graceful shutdown
+ *
+ * Dependencies are injected via the constructor (Dependency Injection pattern).
+ */
+export class McpServer {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    server;
+    logger;
+    tools = new Map();
+    container;
+    /**
+     * Create a new MCP server instance
+     *
+     * @param container - Service container with all dependencies
+     */
+    constructor(container) {
+        this.container = container;
+        this.logger = container.logger;
+        // Create MCP server with metadata
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        this.server = new Server({
+            name: 'mcp-taskflow',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {}, // Enables tool support
+            },
+        });
+        this.setupHandlers();
+        this.logger.info('MCP server initialized');
+    }
+    /**
+     * Setup request handlers
+     *
+     * Registers handlers for MCP protocol methods:
+     * - tools/list: Returns available tools
+     * - tools/call: Executes a specific tool
+     */
+    setupHandlers() {
+        // Handle tools/list - return all registered tools
+        this.server.setRequestHandler(ListToolsRequestSchema, (_request) => {
+            this.logger.debug({ method: 'tools/list' }, 'Listing tools');
+            const tools = Array.from(this.tools.values()).map((handler) => ({
+                name: handler.name,
+                description: handler.description,
+                inputSchema: handler.inputSchema,
+            }));
+            return { tools };
+        });
+        // Handle tools/call - execute a tool
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            this.logger.info({ tool: name }, 'Executing tool');
+            const handler = this.tools.get(name);
+            if (!handler) {
+                const error = `Unknown tool: ${name}`;
+                this.logger.error({ tool: name }, error);
+                throw new Error(error);
+            }
+            try {
+                const result = await handler.execute(args ?? {});
+                this.logger.debug({ tool: name }, 'Tool executed successfully');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                this.logger.error({ tool: name, err: error }, 'Tool execution failed');
+                // Re-throw as MCP error (JSON-RPC format)
+                throw error;
+            }
+        });
+    }
+    /**
+     * Register a tool with the server
+     *
+     * @param handler - Tool handler with name, description, schema, and execute function
+     *
+     * @example
+     * ```typescript
+     * server.registerTool({
+     *   name: 'list_tasks',
+     *   description: 'List all tasks',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       status: { type: 'string', enum: ['pending', 'in_progress', 'completed'] }
+     *     }
+     *   },
+     *   execute: async (args) => {
+     *     const tasks = await taskStore.listAsync();
+     *     return { tasks };
+     *   }
+     * });
+     * ```
+     */
+    registerTool(handler) {
+        if (handler.inputSchema && !handler.inputSchema.type) {
+            const hasRef = Object.prototype.hasOwnProperty.call(handler.inputSchema, '$ref');
+            if (!hasRef) {
+                handler.inputSchema = {
+                    ...handler.inputSchema,
+                    type: 'object',
+                };
+            }
+        }
+        if (this.tools.has(handler.name)) {
+            throw new Error(`Tool already registered: ${handler.name}`);
+        }
+        this.tools.set(handler.name, handler);
+        this.logger.debug({ tool: handler.name }, 'Tool registered');
+    }
+    /**
+     * Start the MCP server with STDIO transport
+     *
+     * The server will:
+     * 1. Connect to stdin/stdout for communication
+     * 2. Listen for initialize request from client
+     * 3. Process tool/list and tools/call requests
+     * 4. Handle graceful shutdown on SIGINT/SIGTERM
+     *
+     * @returns Promise that resolves when server starts
+     */
+    async start() {
+        const transport = new StdioServerTransport();
+        // Setup graceful shutdown
+        const shutdown = () => {
+            this.logger.info('Shutting down MCP server');
+            void this.server.close().then(() => {
+                process.exit(0);
+            });
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        this.logger.info({ toolCount: this.tools.size }, 'Starting MCP server');
+        // Connect and start processing requests
+        await this.server.connect(transport);
+        this.logger.info('MCP server ready');
+    }
+    /**
+     * Get server instance (for testing)
+     */
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    getServer() {
+        return this.server;
+    }
+    /**
+     * Get the service container
+     *
+     * Provides access to all application services for tool implementations
+     *
+     * @returns The service container
+     */
+    getContainer() {
+        return this.container;
+    }
+    /**
+     * Get registered tool count (for testing)
+     */
+    getToolCount() {
+        return this.tools.size;
+    }
+}
+/**
+ * Create and configure MCP server
+ *
+ * Factory function that creates a server instance and registers all tools.
+ * Separates server creation from tool registration for testing.
+ *
+ * @returns Configured MCP server instance
+ */
+/**
+ * Factory function to create a configured MCP server
+ *
+ * This is the main entry point for server creation. It accepts a
+ * ServiceContainer with all dependencies already configured.
+ *
+ * @param container - Service container with all dependencies
+ * @returns Configured MCP server ready to start
+ *
+ * @example
+ * ```typescript
+ * const container = createContainer();
+ * const server = createMcpServer(container);
+ * await server.start();
+ * ```
+ */
+export function createMcpServer(container) {
+    const server = new McpServer(container);
+    // Register task planning tools
+    registerTaskPlanningTools(server);
+    registerTaskCRUDTools(server);
+    registerTaskWorkflowTools(server);
+    registerProjectTools(server);
+    registerThoughtTools(server);
+    registerResearchTools(server);
+    return server;
+}
+//# sourceMappingURL=mcpServer.js.map

package/dist/server/mcpServer.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Project Tools - Barrel Export
+ *
+ * Exports project rules management tools.
+ */
+export { registerProjectTools } from './projectTools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/project/index.js

@@ -0,0 +1,7 @@
+/**
+ * Project Tools - Barrel Export
+ *
+ * Exports project rules management tools.
+ */
+export { registerProjectTools } from './projectTools.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Project Tools Implementation
+ *
+ * Implements MCP tools for project rules management and server metadata.
+ *
+ * Tools:
+ * - init_project_rules: Initialize or update project coding rules
+ * - get_server_info: Return server metadata and health status
+ */
+import type { McpServer } from '../../server/mcpServer.js';
+/**
+ * Register all project tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export declare function registerProjectTools(server: McpServer): void;
+//# sourceMappingURL=projectTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectTools.d.ts","sourceRoot":"","sources":["../../../src/tools/project/projectTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAW3D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAK5D"}

package/dist/tools/project/projectTools.js

@@ -0,0 +1,73 @@
+/**
+ * Project Tools Implementation
+ *
+ * Implements MCP tools for project rules management and server metadata.
+ *
+ * Tools:
+ * - init_project_rules: Initialize or update project coding rules
+ * - get_server_info: Return server metadata and health status
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { InitProjectRulesParamsSchema, GetServerInfoParamsSchema, } from '../../data/schemas.js';
+import { InitProjectRulesPromptBuilder, GetServerInfoPromptBuilder, } from '../../prompts/projectPromptBuilder.js';
+/**
+ * Register all project tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export function registerProjectTools(server) {
+    const container = server.getContainer();
+    registerInitProjectRules(server, container);
+    registerGetServerInfo(server, container);
+}
+/**
+ * Register init_project_rules tool
+ */
+function registerInitProjectRules(server, container) {
+    server.registerTool({
+        name: 'init_project_rules',
+        description: 'Initialize or update project coding rules and guidelines.',
+        inputSchema: zodToJsonSchema(InitProjectRulesParamsSchema, { $refStrategy: 'none' }),
+        execute: async (_args) => {
+            const { rulesStore, logger } = container;
+            logger.info('Initializing project rules');
+            const rulesExist = await rulesStore.rulesExistAsync();
+            if (!rulesExist) {
+                await rulesStore.initializeRulesAsync();
+                logger.info('Created default project rules');
+            }
+            const rules = await rulesStore.loadRulesAsync();
+            const builder = new InitProjectRulesPromptBuilder();
+            const result = await builder.build(rules, rulesExist);
+            logger.info({ rulesExist }, 'Project rules initialized');
+            return result;
+        },
+    });
+}
+/**
+ * Register get_server_info tool
+ */
+function registerGetServerInfo(server, container) {
+    server.registerTool({
+        name: 'get_server_info',
+        description: 'Get server metadata, version, and health status.',
+        inputSchema: zodToJsonSchema(GetServerInfoParamsSchema, { $refStrategy: 'none' }),
+        execute: async (_args) => {
+            const { taskStore, logger } = container;
+            logger.info('Getting server info');
+            const allTasks = await taskStore.getAllAsync();
+            const taskCounts = {
+                pending: allTasks.filter(t => t.status === 'pending').length,
+                in_progress: allTasks.filter(t => t.status === 'in_progress').length,
+                completed: allTasks.filter(t => t.status === 'completed').length,
+                blocked: allTasks.filter(t => t.status === 'blocked').length,
+                total: allTasks.length,
+            };
+            const builder = new GetServerInfoPromptBuilder();
+            const result = builder.build('1.0.0', 'mcp-taskflow', 'MCP Task and Research Manager - Task planning, analysis, and research workflow tools');
+            logger.info(taskCounts, 'Server info retrieved');
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=projectTools.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Research Tools - Barrel Export
+ *
+ * Exports research workflow tools.
+ */
+export { registerResearchTools } from './researchTools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/research/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/research/index.js

@@ -0,0 +1,7 @@
+/**
+ * Research Tools - Barrel Export
+ *
+ * Exports research workflow tools.
+ */
+export { registerResearchTools } from './researchTools.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/research/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/research/researchTools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Research Tools Implementation
+ *
+ * Implements MCP tools for guided technical research workflows.
+ *
+ * Tools:
+ * - research_mode: Iterative research with state management
+ */
+import type { McpServer } from '../../server/mcpServer.js';
+/**
+ * Register all research tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export declare function registerResearchTools(server: McpServer): void;
+//# sourceMappingURL=researchTools.d.ts.map

package/dist/tools/research/researchTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researchTools.d.ts","sourceRoot":"","sources":["../../../src/tools/research/researchTools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAI7D"}

package/dist/tools/research/researchTools.js

@@ -0,0 +1,41 @@
+/**
+ * Research Tools Implementation
+ *
+ * Implements MCP tools for guided technical research workflows.
+ *
+ * Tools:
+ * - research_mode: Iterative research with state management
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ResearchModeParamsSchema, } from '../../data/schemas.js';
+import { ResearchModePromptBuilder, } from '../../prompts/researchPromptBuilder.js';
+/**
+ * Register all research tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export function registerResearchTools(server) {
+    const container = server.getContainer();
+    registerResearchMode(server, container);
+}
+/**
+ * Register research_mode tool
+ */
+function registerResearchMode(server, container) {
+    server.registerTool({
+        name: 'research_mode',
+        description: 'Enter research mode to explore a programming topic in depth with iterative state tracking.',
+        inputSchema: zodToJsonSchema(ResearchModeParamsSchema, { $refStrategy: 'none' }),
+        execute: async (args) => {
+            const params = ResearchModeParamsSchema.parse(args);
+            const { logger } = container;
+            logger.info({ topic: params.topic }, 'Starting research mode');
+            const isInitialIteration = !params.previousState || params.previousState.trim() === '';
+            const builder = new ResearchModePromptBuilder();
+            const result = await builder.build(params.topic, params.previousState, params.currentState, params.nextSteps);
+            logger.info({ topic: params.topic, isInitial: isInitialIteration }, 'Research mode prompt generated');
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=researchTools.js.map

package/dist/tools/research/researchTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"researchTools.js","sourceRoot":"","sources":["../../../src/tools/research/researchTools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,wBAAwB,GAEzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAExC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,MAAiB,EAAE,SAA2B;IAC1E,MAAM,CAAC,YAAY,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4FAA4F;QACzG,WAAW,EAAE,eAAe,CAAC,wBAAwB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAI9E;QACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;YAC1E,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;YAE/D,MAAM,kBAAkB,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAEvF,MAAM,OAAO,GAAG,IAAI,yBAAyB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAChC,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,SAAS,CACjB,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,gCAAgC,CAAC,CAAC;YACtG,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Task Management Tools - Planning & Analysis
+ *
+ * Exports MCP tools for task planning, analysis, reflection, and splitting.
+ * These tools enable AI assistants to structure complex work into manageable tasks.
+ */
+export { registerTaskPlanningTools, registerTaskCRUDTools, registerTaskWorkflowTools } from './taskTools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/task/index.js

@@ -0,0 +1,8 @@
+/**
+ * Task Management Tools - Planning & Analysis
+ *
+ * Exports MCP tools for task planning, analysis, reflection, and splitting.
+ * These tools enable AI assistants to structure complex work into manageable tasks.
+ */
+export { registerTaskPlanningTools, registerTaskCRUDTools, registerTaskWorkflowTools } from './taskTools.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/task/taskTools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Task Planning Tools Implementation
+ *
+ * Implements MCP tools for task planning, analysis, reflection, and splitting.
+ * These tools guide AI assistants through structured workflow patterns.
+ *
+ * Tools:
+ * - plan_task: Convert natural language requests into structured tasks
+ * - analyze_task: Deep analysis with threat modeling and design decisions
+ * - reflect_task: Critical review and optimization recommendations
+ * - split_tasks: Bulk task creation with dependency management
+ */
+import type { McpServer } from '../../server/mcpServer.js';
+/**
+ * Register all task planning tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export declare function registerTaskPlanningTools(server: McpServer): void;
+/**
+ * Register all task CRUD tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export declare function registerTaskCRUDTools(server: McpServer): void;
+/**
+ * Register all task workflow tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export declare function registerTaskWorkflowTools(server: McpServer): void;
+//# sourceMappingURL=taskTools.d.ts.map

package/dist/tools/task/taskTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskTools.d.ts","sourceRoot":"","sources":["../../../src/tools/task/taskTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA+C3D;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAS7D;AA8PD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAKjE"}