@codemcp/workflows 3.1.21

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Vibe Feature MCP Server Entry Point
+ *
+ * Starts the MCP server with stdio transport for process-based usage.
+ * The core server logic is in server.ts for better testability.
+ */
+export { ResponsibleVibeMCPServer, createResponsibleVibeMCPServer, } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAMH,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Vibe Feature MCP Server Entry Point
+ *
+ * Starts the MCP server with stdio transport for process-based usage.
+ * The core server logic is in server.ts for better testability.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createResponsibleVibeMCPServer } from './server.js';
+// Re-export for external use
+export { ResponsibleVibeMCPServer, createResponsibleVibeMCPServer, } from './server.js';
+import { createLogger } from '@codemcp/workflows-core';
+const logger = createLogger('Main');
+/**
+ * Parse command line arguments and handle special flags
+ */
+function parseCliArgs() {
+    // Since routing is handled at root level, always start server when this module is loaded
+    return { shouldStartServer: true };
+}
+/**
+ * Main entry point for the MCP server process
+ */
+async function main() {
+    // Parse CLI arguments first
+    const { shouldStartServer } = parseCliArgs();
+    // If special flags were handled, exit gracefully
+    if (!shouldStartServer) {
+        return;
+    }
+    // Normal MCP server startup
+    try {
+        const projectPath = process.env.PROJECT_PATH;
+        // Create server instance with project path configuration
+        const server = await createResponsibleVibeMCPServer({
+            projectPath: projectPath,
+        });
+        // Initialize server
+        await server.initialize();
+        // Create stdio transport
+        const transport = new StdioServerTransport();
+        // Connect server to transport
+        await server.getMcpServer().connect(transport);
+        // Note: No logging here to ensure compatibility with Amazon Q CLI
+        // Amazon Q CLI expects no logging notifications before MCP initialization completes
+        // Handle graceful shutdown
+        process.on('SIGINT', async () => {
+            logger.info('Shutting down Vibe Feature MCP Server...');
+            await server.cleanup();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            logger.info('Shutting down Vibe Feature MCP Server...');
+            await server.cleanup();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        logger.error('Failed to start server', error);
+        process.exit(1);
+    }
+}
+// Start the server if this file is run directly
+// More robust check that works with npx and direct execution
+const isMainModule = import.meta.url === `file://${process.argv[1]}` ||
+    process.argv[1]?.endsWith('responsible-vibe-mcp') ||
+    process.argv[1]?.endsWith('index.js');
+if (isMainModule) {
+    main().catch(error => {
+        logger.error('Unhandled error in main', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAE7D,6BAA6B;AAC7B,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpC;;GAEG;AACH,SAAS,YAAY;IACnB,yFAAyF;IACzF,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,4BAA4B;IAC5B,MAAM,EAAE,iBAAiB,EAAE,GAAG,YAAY,EAAE,CAAC;IAE7C,iDAAiD;IACjD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAE7C,yDAAyD;QACzD,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC;YAClD,WAAW,EAAE,WAAW;SACzB,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAE1B,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,8BAA8B;QAC9B,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE/C,kEAAkE;QAClE,oFAAoF;QAEpF,2BAA2B;QAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACxD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACxD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAc,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,6DAA6D;AAC7D,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;AAExC,IAAI,YAAY,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACnB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/notification-service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Notification Service
+ *
+ * Simple event system for notifying MCP client of changes
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare class NotificationService {
+    private mcpServer?;
+    setMcpServer(server: McpServer): void;
+    notifyToolListChanged(): Promise<void>;
+}
+export declare const notificationService: NotificationService;
+export {};
+//# sourceMappingURL=notification-service.d.ts.map

package/dist/notification-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.d.ts","sourceRoot":"","sources":["../src/notification-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,cAAM,mBAAmB;IACvB,OAAO,CAAC,SAAS,CAAC,CAAY;IAE9B,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI/B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7C;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

package/dist/notification-service.js

@@ -0,0 +1,18 @@
+/**
+ * Notification Service
+ *
+ * Simple event system for notifying MCP client of changes
+ */
+class NotificationService {
+    mcpServer;
+    setMcpServer(server) {
+        this.mcpServer = server;
+    }
+    async notifyToolListChanged() {
+        if (this.mcpServer) {
+            this.mcpServer.sendToolListChanged();
+        }
+    }
+}
+export const notificationService = new NotificationService();
+//# sourceMappingURL=notification-service.js.map

package/dist/notification-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.js","sourceRoot":"","sources":["../src/notification-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,mBAAmB;IACf,SAAS,CAAa;IAE9B,YAAY,CAAC,MAAiB;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/resource-handlers/conversation-state.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Conversation State Resource Handler
+ *
+ * Handles the conversation-state resource which provides access to current
+ * conversation state and phase information including conversation ID, project context,
+ * current development phase, and plan file location.
+ */
+import { ResourceHandler, ServerContext, HandlerResult, ResourceContent } from '../types.js';
+/**
+ * Conversation State resource handler implementation
+ */
+export declare class ConversationStateResourceHandler implements ResourceHandler {
+    handle(uri: URL, context: ServerContext): Promise<HandlerResult<ResourceContent>>;
+}
+//# sourceMappingURL=conversation-state.d.ts.map

package/dist/resource-handlers/conversation-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.d.ts","sourceRoot":"","sources":["../../src/resource-handlers/conversation-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,qBAAa,gCAAiC,YAAW,eAAe;IAChE,MAAM,CACV,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;CA4B3C"}

package/dist/resource-handlers/conversation-state.js

@@ -0,0 +1,40 @@
+/**
+ * Conversation State Resource Handler
+ *
+ * Handles the conversation-state resource which provides access to current
+ * conversation state and phase information including conversation ID, project context,
+ * current development phase, and plan file location.
+ */
+import { createLogger } from '@codemcp/workflows-core';
+import { safeExecute } from '../server-helpers.js';
+const logger = createLogger('ConversationStateResourceHandler');
+/**
+ * Conversation State resource handler implementation
+ */
+export class ConversationStateResourceHandler {
+    async handle(uri, context) {
+        logger.debug('Processing conversation state resource request', {
+            uri: uri.href,
+        });
+        return safeExecute(async () => {
+            // Get conversation context
+            const conversationContext = await context.conversationManager.getConversationContext();
+            // Build state information
+            const stateInfo = {
+                conversationId: conversationContext.conversationId,
+                projectPath: conversationContext.projectPath,
+                gitBranch: conversationContext.gitBranch,
+                currentPhase: conversationContext.currentPhase,
+                planFilePath: conversationContext.planFilePath,
+                timestamp: new Date().toISOString(),
+                description: 'Current state of the development workflow conversation',
+            };
+            return {
+                uri: uri.href,
+                text: JSON.stringify(stateInfo, null, 2),
+                mimeType: 'application/json',
+            };
+        }, 'Failed to retrieve conversation state resource');
+    }
+}
+//# sourceMappingURL=conversation-state.js.map

package/dist/resource-handlers/conversation-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.js","sourceRoot":"","sources":["../../src/resource-handlers/conversation-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,GAAG,YAAY,CAAC,kCAAkC,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,gCAAgC;IAC3C,KAAK,CAAC,MAAM,CACV,GAAQ,EACR,OAAsB;QAEtB,MAAM,CAAC,KAAK,CAAC,gDAAgD,EAAE;YAC7D,GAAG,EAAE,GAAG,CAAC,IAAI;SACd,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,2BAA2B;YAC3B,MAAM,mBAAmB,GACvB,MAAM,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,CAAC;YAE7D,0BAA0B;YAC1B,MAAM,SAAS,GAAG;gBAChB,cAAc,EAAE,mBAAmB,CAAC,cAAc;gBAClD,WAAW,EAAE,mBAAmB,CAAC,WAAW;gBAC5C,SAAS,EAAE,mBAAmB,CAAC,SAAS;gBACxC,YAAY,EAAE,mBAAmB,CAAC,YAAY;gBAC9C,YAAY,EAAE,mBAAmB,CAAC,YAAY;gBAC9C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,WAAW,EAAE,wDAAwD;aACtE,CAAC;YAEF,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxC,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC,EAAE,gDAAgD,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/resource-handlers/development-plan.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Development Plan Resource Handler
+ *
+ * Handles the development-plan resource which provides access to the current
+ * development plan document (markdown) that tracks project progress, tasks, and decisions.
+ */
+import { ResourceHandler, ServerContext, HandlerResult, ResourceContent } from '../types.js';
+/**
+ * Development Plan resource handler implementation
+ */
+export declare class DevelopmentPlanResourceHandler implements ResourceHandler {
+    handle(uri: URL, context: ServerContext): Promise<HandlerResult<ResourceContent>>;
+}
+//# sourceMappingURL=development-plan.d.ts.map

package/dist/resource-handlers/development-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-plan.d.ts","sourceRoot":"","sources":["../../src/resource-handlers/development-plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,qBAAa,8BAA+B,YAAW,eAAe;IAC9D,MAAM,CACV,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;CAsB3C"}

package/dist/resource-handlers/development-plan.js

@@ -0,0 +1,31 @@
+/**
+ * Development Plan Resource Handler
+ *
+ * Handles the development-plan resource which provides access to the current
+ * development plan document (markdown) that tracks project progress, tasks, and decisions.
+ */
+import { createLogger } from '@codemcp/workflows-core';
+import { safeExecute } from '../server-helpers.js';
+const logger = createLogger('DevelopmentPlanResourceHandler');
+/**
+ * Development Plan resource handler implementation
+ */
+export class DevelopmentPlanResourceHandler {
+    async handle(uri, context) {
+        logger.debug('Processing development plan resource request', {
+            uri: uri.href,
+        });
+        return safeExecute(async () => {
+            // Get conversation context
+            const conversationContext = await context.conversationManager.getConversationContext();
+            // Get plan file content
+            const planContent = await context.planManager.getPlanFileContent(conversationContext.planFilePath);
+            return {
+                uri: uri.href,
+                text: planContent,
+                mimeType: 'text/markdown',
+            };
+        }, 'Failed to retrieve development plan resource');
+    }
+}
+//# sourceMappingURL=development-plan.js.map

package/dist/resource-handlers/development-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-plan.js","sourceRoot":"","sources":["../../src/resource-handlers/development-plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,GAAG,YAAY,CAAC,gCAAgC,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,8BAA8B;IACzC,KAAK,CAAC,MAAM,CACV,GAAQ,EACR,OAAsB;QAEtB,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE;YAC3D,GAAG,EAAE,GAAG,CAAC,IAAI;SACd,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,2BAA2B;YAC3B,MAAM,mBAAmB,GACvB,MAAM,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,CAAC;YAE7D,wBAAwB;YACxB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAC9D,mBAAmB,CAAC,YAAY,CACjC,CAAC;YAEF,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,eAAe;aAC1B,CAAC;QACJ,CAAC,EAAE,8CAA8C,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/resource-handlers/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resource Handler Registry
+ *
+ * Central registry for all resource handlers. Provides registration and lookup
+ * functionality for resource handlers used by the MCP server.
+ */
+import { ResourceHandler, ResourceRegistry } from '../types.js';
+/**
+ * Default implementation of ResourceRegistry
+ */
+export declare class DefaultResourceRegistry implements ResourceRegistry {
+    private handlers;
+    register(pattern: string, handler: ResourceHandler): void;
+    resolve(uri: string): ResourceHandler | undefined;
+}
+/**
+ * Create and configure the default resource registry with all standard handlers
+ */
+export declare function createResourceRegistry(): ResourceRegistry;
+export { DevelopmentPlanResourceHandler } from './development-plan.js';
+export { ConversationStateResourceHandler } from './conversation-state.js';
+export { WorkflowResourceHandler } from './workflow-resource.js';
+export { SystemPromptResourceHandler } from './system-prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resource-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resource-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIhE;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAsC;IAEtD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQzD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;CAYlD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAmBzD;AAGD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/resource-handlers/index.js

@@ -0,0 +1,62 @@
+/**
+ * Resource Handler Registry
+ *
+ * Central registry for all resource handlers. Provides registration and lookup
+ * functionality for resource handlers used by the MCP server.
+ */
+import { createLogger } from '@codemcp/workflows-core';
+import { DevelopmentPlanResourceHandler } from './development-plan.js';
+import { ConversationStateResourceHandler } from './conversation-state.js';
+import { WorkflowResourceHandler } from './workflow-resource.js';
+import { SystemPromptResourceHandler } from './system-prompt.js';
+const logger = createLogger('ResourceRegistry');
+/**
+ * Default implementation of ResourceRegistry
+ */
+export class DefaultResourceRegistry {
+    handlers = new Map();
+    register(pattern, handler) {
+        logger.debug('Registering resource handler', {
+            pattern,
+            handlerType: handler.constructor.name,
+        });
+        this.handlers.set(pattern, handler);
+    }
+    resolve(uri) {
+        // Simple pattern matching - could be enhanced with regex patterns
+        for (const [pattern, handler] of this.handlers.entries()) {
+            if (uri.includes(pattern)) {
+                logger.debug('Resolved resource handler', { uri, pattern });
+                return handler;
+            }
+        }
+        logger.debug('No resource handler found for URI', { uri });
+        return undefined;
+    }
+}
+/**
+ * Create and configure the default resource registry with all standard handlers
+ */
+export function createResourceRegistry() {
+    const registry = new DefaultResourceRegistry();
+    // Register all standard resource handlers
+    registry.register('plan://current', new DevelopmentPlanResourceHandler());
+    registry.register('state://current', new ConversationStateResourceHandler());
+    registry.register('workflow://', new WorkflowResourceHandler());
+    registry.register('system-prompt://', new SystemPromptResourceHandler());
+    logger.info('Resource registry created with handlers', {
+        patterns: [
+            'plan://current',
+            'state://current',
+            'workflow://',
+            'system-prompt://',
+        ],
+    });
+    return registry;
+}
+// Export all handler types for external use
+export { DevelopmentPlanResourceHandler } from './development-plan.js';
+export { ConversationStateResourceHandler } from './conversation-state.js';
+export { WorkflowResourceHandler } from './workflow-resource.js';
+export { SystemPromptResourceHandler } from './system-prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/resource-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resource-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAGjE,MAAM,MAAM,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEtD,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;YAC3C,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,kEAAkE;QAClE,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5D,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE/C,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,8BAA8B,EAAE,CAAC,CAAC;IAC1E,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,gCAAgC,EAAE,CAAC,CAAC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,uBAAuB,EAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,IAAI,2BAA2B,EAAE,CAAC,CAAC;IAEzE,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;QACrD,QAAQ,EAAE;YACR,gBAAgB;YAChB,iBAAiB;YACjB,aAAa;YACb,kBAAkB;SACnB;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4CAA4C;AAC5C,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/resource-handlers/system-prompt.d.ts

@@ -0,0 +1,15 @@
+/**
+ * System Prompt Resource Handler
+ *
+ * Handles the system-prompt resource which provides access to the complete
+ * system prompt for LLM integration. This allows programmatic access to the
+ * system prompt through the MCP protocol. The system prompt is workflow-independent.
+ */
+import { ResourceHandler, ServerContext, HandlerResult, ResourceContent } from '../types.js';
+/**
+ * System Prompt resource handler implementation
+ */
+export declare class SystemPromptResourceHandler implements ResourceHandler {
+    handle(uri: URL, _context: ServerContext): Promise<HandlerResult<ResourceContent>>;
+}
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/resource-handlers/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/resource-handlers/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAOrB;;GAEG;AACH,qBAAa,2BAA4B,YAAW,eAAe;IAC3D,MAAM,CACV,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;CA0B3C"}

package/dist/resource-handlers/system-prompt.js

@@ -0,0 +1,40 @@
+/**
+ * System Prompt Resource Handler
+ *
+ * Handles the system-prompt resource which provides access to the complete
+ * system prompt for LLM integration. This allows programmatic access to the
+ * system prompt through the MCP protocol. The system prompt is workflow-independent.
+ */
+import { createLogger } from '@codemcp/workflows-core';
+import { safeExecute } from '../server-helpers.js';
+import { generateSystemPrompt } from '@codemcp/workflows-core';
+import { StateMachineLoader } from '@codemcp/workflows-core';
+const logger = createLogger('SystemPromptResourceHandler');
+/**
+ * System Prompt resource handler implementation
+ */
+export class SystemPromptResourceHandler {
+    async handle(uri, _context) {
+        logger.debug('Processing system prompt resource request', {
+            uri: uri.href,
+        });
+        return safeExecute(async () => {
+            // Use the default waterfall workflow for system prompt generation
+            // The system prompt is workflow-independent and uses a standard workflow
+            const loader = new StateMachineLoader();
+            const stateMachine = loader.loadStateMachine(process.cwd()); // Uses default waterfall workflow
+            // Generate the system prompt
+            const systemPrompt = generateSystemPrompt(stateMachine);
+            logger.debug('Generated system prompt for resource', {
+                promptLength: systemPrompt.length,
+                workflowName: stateMachine.name,
+            });
+            return {
+                uri: uri.href,
+                text: systemPrompt,
+                mimeType: 'text/plain',
+            };
+        }, 'Failed to retrieve system prompt resource');
+    }
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/resource-handlers/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/resource-handlers/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,MAAM,GAAG,YAAY,CAAC,6BAA6B,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,2BAA2B;IACtC,KAAK,CAAC,MAAM,CACV,GAAQ,EACR,QAAuB;QAEvB,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE;YACxD,GAAG,EAAE,GAAG,CAAC,IAAI;SACd,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,kEAAkE;YAClE,yEAAyE;YACzE,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACxC,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,kCAAkC;YAE/F,6BAA6B;YAC7B,MAAM,YAAY,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAExD,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,YAAY,EAAE,YAAY,CAAC,MAAM;gBACjC,YAAY,EAAE,YAAY,CAAC,IAAI;aAChC,CAAC,CAAC;YAEH,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,YAAY;aACvB,CAAC;QACJ,CAAC,EAAE,2CAA2C,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/resource-handlers/workflow-resource.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Workflow Resource Handler
+ *
+ * Handles MCP resources for individual workflows, returning the raw YAML content
+ * from workflow definition files.
+ */
+import { ResourceHandler, ServerContext, HandlerResult, ResourceContent } from '../types.js';
+/**
+ * Resource handler for workflow:// URIs
+ * Returns raw YAML content from workflow definition files
+ */
+export declare class WorkflowResourceHandler implements ResourceHandler {
+    handle(uri: URL, context: ServerContext): Promise<HandlerResult<ResourceContent>>;
+}
+//# sourceMappingURL=workflow-resource.d.ts.map

package/dist/resource-handlers/workflow-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-resource.d.ts","sourceRoot":"","sources":["../../src/resource-handlers/workflow-resource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAKrB;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IACvD,MAAM,CACV,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;CAgG3C"}

package/dist/resource-handlers/workflow-resource.js

@@ -0,0 +1,85 @@
+/**
+ * Workflow Resource Handler
+ *
+ * Handles MCP resources for individual workflows, returning the raw YAML content
+ * from workflow definition files.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createLogger } from '@codemcp/workflows-core';
+import { safeExecute } from '../server-helpers.js';
+const logger = createLogger('WorkflowResourceHandler');
+/**
+ * Resource handler for workflow:// URIs
+ * Returns raw YAML content from workflow definition files
+ */
+export class WorkflowResourceHandler {
+    async handle(uri, context) {
+        logger.debug('Processing workflow resource request', { uri: uri.href });
+        return safeExecute(async () => {
+            // Extract workflow name from URI (workflow://workflow-name)
+            const workflowName = uri.hostname;
+            if (!workflowName) {
+                throw new Error('Invalid workflow URI: missing workflow name. Expected: workflow://workflow-name');
+            }
+            logger.info('Loading workflow resource', { workflowName, uri: uri.href });
+            let yamlContent;
+            let filePath;
+            // Try to get workflow from workflow manager
+            const workflow = context.workflowManager.getWorkflow(workflowName);
+            if (!workflow) {
+                throw new Error(`Workflow '${workflowName}' not found`);
+            }
+            // Handle predefined workflows
+            // Get the workflows directory path - more reliable approach
+            const currentFileUrl = import.meta.url;
+            const currentFilePath = fileURLToPath(currentFileUrl);
+            // Navigate from the compiled location to the project root
+            // From dist/server/resource-handlers/workflow-resource.js -> project root
+            let projectRoot;
+            if (currentFilePath.includes('/dist/')) {
+                // Running from compiled code - dist is one level down from project root
+                projectRoot = path.resolve(path.dirname(currentFilePath), '../../../');
+            }
+            else {
+                // Running from source (development) - src is one level down from project root
+                projectRoot = path.resolve(path.dirname(currentFilePath), '../../../');
+            }
+            const workflowFile = path.join(projectRoot, 'resources', 'workflows', `${workflowName}.yaml`);
+            if (!fs.existsSync(workflowFile)) {
+                // Try .yml extension
+                const workflowFileYml = path.join(projectRoot, 'resources', 'workflows', `${workflowName}.yml`);
+                if (!fs.existsSync(workflowFileYml)) {
+                    // Log debug info to help troubleshoot
+                    logger.error('Workflow file not found', new Error(`Workflow '${workflowName}' not found`), {
+                        workflowName,
+                        currentFilePath,
+                        projectRoot,
+                        workflowFile,
+                        workflowFileYml,
+                        workflowsDir: path.join(projectRoot, 'resources', 'workflows'),
+                        workflowsDirExists: fs.existsSync(path.join(projectRoot, 'resources', 'workflows')),
+                    });
+                    throw new Error(`Workflow '${workflowName}' not found in resources/workflows/`);
+                }
+                filePath = workflowFileYml;
+            }
+            else {
+                filePath = workflowFile;
+            }
+            yamlContent = fs.readFileSync(filePath, 'utf-8');
+            logger.info('Successfully loaded workflow resource', {
+                workflowName,
+                filePath,
+                contentLength: yamlContent.length,
+            });
+            return {
+                uri: uri.href,
+                text: yamlContent,
+                mimeType: 'application/x-yaml',
+            };
+        }, `Failed to load workflow resource: ${uri.href}`);
+    }
+}
+//# sourceMappingURL=workflow-resource.js.map

package/dist/resource-handlers/workflow-resource.js.map

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

package/dist/response-renderer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Response Renderer
+ *
+ * Handles translation between domain handler results and MCP protocol responses.
+ * This provides clean separation between business logic and protocol concerns.
+ */
+import { ResponseRenderer, HandlerResult, ResourceContent, McpToolResponse, McpResourceResponse } from './types.js';
+/**
+ * Default implementation of ResponseRenderer
+ * Converts domain results to MCP protocol format
+ */
+export declare class DefaultResponseRenderer implements ResponseRenderer {
+    /**
+     * Render a tool handler result as an MCP tool response
+     */
+    renderToolResponse<T>(result: HandlerResult<T>): McpToolResponse;
+    /**
+     * Render a resource handler result as an MCP resource response
+     */
+    renderResourceResponse(result: HandlerResult<ResourceContent>): McpResourceResponse;
+    /**
+     * Render an error as an MCP tool response
+     */
+    renderError(error: Error | string): McpToolResponse;
+}
+/**
+ * Create a default response renderer instance
+ */
+export declare function createResponseRenderer(): ResponseRenderer;
+//# sourceMappingURL=response-renderer.d.ts.map

package/dist/response-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-renderer.d.ts","sourceRoot":"","sources":["../src/response-renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D;;OAEG;IACH,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe;IA0BhE;;OAEG;IACH,sBAAsB,CACpB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GACrC,mBAAmB;IAiCtB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,eAAe;CAepD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}