@codebakers/cli 3.3.2 → 3.3.3

package/dist/mcp/server.js

@@ -960,6 +960,20 @@ class CodeBakersServer {
                         },
                     },
                 },
+                {
+                    name: 'detect_intent',
+                    description: 'CALL THIS FIRST when user request is ambiguous or could match multiple MCP tools. Analyzes user input and returns which MCP tool(s) would be appropriate, with explanations. Show the result to the user and ask for confirmation before executing. This prevents accidental destructive actions.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            userMessage: {
+                                type: 'string',
+                                description: 'The user\'s message or request to analyze',
+                            },
+                        },
+                        required: ['userMessage'],
+                    },
+                },
             ],
         }));
         // Handle tool calls
@@ -1049,6 +1063,8 @@ class CodeBakersServer {
                     return this.handleCheckUpdateNotification();
                 case 'update_patterns':
                     return this.handleUpdatePatterns(args);
+                case 'detect_intent':
+                    return this.handleDetectIntent(args);
                 default:
                     throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
             }
@@ -4678,6 +4694,143 @@ ${handlers.join('\n')}
                 }],
         };
     }
+    /**
+     * Detect intent from user message and suggest appropriate MCP tools
+     * Shows what would happen before executing, for user confirmation
+     */
+    handleDetectIntent(args) {
+        const { userMessage } = args;
+        const msg = userMessage.toLowerCase();
+        // Define intent patterns with their MCP tools
+        const intentPatterns = [
+            {
+                keywords: ['upgrade codebakers', 'update patterns', 'sync patterns', 'download patterns', 'get latest patterns'],
+                tool: 'update_patterns',
+                description: 'Download latest CLAUDE.md and all .claude/ modules from the CodeBakers server',
+                action: 'WRITE - Will overwrite local pattern files with server versions',
+                isDestructive: true,
+            },
+            {
+                keywords: ['upgrade', 'improve code', 'make production ready', 'code quality'],
+                tool: 'upgrade',
+                description: 'Analyze your code for quality improvements (does NOT download patterns)',
+                action: 'READ-ONLY - Analyzes code and suggests improvements',
+                isDestructive: false,
+            },
+            {
+                keywords: ['build', 'create project', 'new project', 'scaffold', 'start fresh'],
+                tool: 'scaffold_project',
+                description: 'Create a new project from scratch with CodeBakers patterns',
+                action: 'WRITE - Will create new files and folders',
+                isDestructive: true,
+            },
+            {
+                keywords: ['add feature', 'implement', 'build feature', 'create feature'],
+                tool: 'optimize_and_build',
+                description: 'Optimize your feature request with AI and fetch relevant patterns',
+                action: 'READ + ASSIST - Fetches patterns and guides implementation',
+                isDestructive: false,
+            },
+            {
+                keywords: ['audit', 'review code', 'check code', 'code review'],
+                tool: 'run_audit',
+                description: 'Run comprehensive code quality audit',
+                action: 'READ-ONLY - Analyzes code and reports issues',
+                isDestructive: false,
+            },
+            {
+                keywords: ['heal', 'fix errors', 'auto-fix', 'fix bugs'],
+                tool: 'heal',
+                description: 'AI-powered error detection and automatic fixing',
+                action: 'WRITE - May modify files to fix errors',
+                isDestructive: true,
+            },
+            {
+                keywords: ['design', 'clone design', 'copy design', 'match design'],
+                tool: 'design',
+                description: 'Clone a design from mockups, screenshots, or websites',
+                action: 'WRITE - Will generate component files',
+                isDestructive: true,
+            },
+            {
+                keywords: ['status', 'progress', "what's built", 'where am i'],
+                tool: 'project_status',
+                description: 'Show current project build progress and stats',
+                action: 'READ-ONLY - Shows project state',
+                isDestructive: false,
+            },
+            {
+                keywords: ['run tests', 'test', 'check tests'],
+                tool: 'run_tests',
+                description: 'Execute the project test suite',
+                action: 'READ-ONLY - Runs tests and reports results',
+                isDestructive: false,
+            },
+            {
+                keywords: ['list patterns', 'show patterns', 'what patterns'],
+                tool: 'list_patterns',
+                description: 'List all available CodeBakers patterns',
+                action: 'READ-ONLY - Shows available patterns',
+                isDestructive: false,
+            },
+            {
+                keywords: ['init', 'initialize', 'add patterns to existing'],
+                tool: 'init_project',
+                description: 'Add CodeBakers patterns to an existing project',
+                action: 'WRITE - Will add CLAUDE.md and .claude/ folder',
+                isDestructive: true,
+            },
+        ];
+        // Find matching intents
+        const matches = intentPatterns.filter(pattern => pattern.keywords.some(keyword => msg.includes(keyword)));
+        let response = `# 🔍 Intent Detection\n\n`;
+        response += `**Your message:** "${userMessage}"\n\n`;
+        if (matches.length === 0) {
+            response += `## No specific MCP tool detected\n\n`;
+            response += `Your request doesn't clearly match any MCP tool. I'll proceed with general assistance.\n\n`;
+            response += `**Available tools you might want:**\n`;
+            response += `- \`update_patterns\` - Download latest patterns from server\n`;
+            response += `- \`optimize_and_build\` - Get AI help building a feature\n`;
+            response += `- \`run_audit\` - Review your code quality\n`;
+            response += `- \`project_status\` - Check build progress\n`;
+        }
+        else if (matches.length === 1) {
+            const match = matches[0];
+            response += `## Detected Intent\n\n`;
+            response += `| Property | Value |\n`;
+            response += `|----------|-------|\n`;
+            response += `| **Tool** | \`${match.tool}\` |\n`;
+            response += `| **Description** | ${match.description} |\n`;
+            response += `| **Action Type** | ${match.action} |\n`;
+            response += `| **Destructive?** | ${match.isDestructive ? '⚠️ YES - modifies files' : '✅ NO - read-only'} |\n\n`;
+            if (match.isDestructive) {
+                response += `### ⚠️ Confirmation Required\n\n`;
+                response += `This action will modify files. Do you want to proceed?\n\n`;
+                response += `**Reply "yes" or "proceed" to execute, or describe what you actually want.**\n`;
+            }
+            else {
+                response += `This is a read-only operation. Safe to proceed.\n\n`;
+                response += `**Reply "yes" to execute, or clarify your request.**\n`;
+            }
+        }
+        else {
+            response += `## Multiple Possible Intents\n\n`;
+            response += `Your request could match several tools:\n\n`;
+            matches.forEach((match, i) => {
+                response += `### Option ${i + 1}: \`${match.tool}\`\n`;
+                response += `- **What it does:** ${match.description}\n`;
+                response += `- **Action:** ${match.action}\n`;
+                response += `- **Destructive:** ${match.isDestructive ? '⚠️ Yes' : '✅ No'}\n\n`;
+            });
+            response += `**Which option do you want?** Reply with the tool name or option number.\n`;
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: response,
+                }],
+        };
+    }
     async run() {
         const transport = new stdio_js_1.StdioServerTransport();
         await this.server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codebakers/cli",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "description": "CodeBakers CLI - Production patterns for AI-assisted development",
   "main": "dist/index.js",
   "bin": {

package/src/mcp/server.ts

@@ -1047,6 +1047,21 @@ class CodeBakersServer {
             },
           },
         },
+        {
+          name: 'detect_intent',
+          description:
+            'CALL THIS FIRST when user request is ambiguous or could match multiple MCP tools. Analyzes user input and returns which MCP tool(s) would be appropriate, with explanations. Show the result to the user and ask for confirmation before executing. This prevents accidental destructive actions.',
+          inputSchema: {
+            type: 'object' as const,
+            properties: {
+              userMessage: {
+                type: 'string',
+                description: 'The user\'s message or request to analyze',
+              },
+            },
+            required: ['userMessage'],
+          },
+        },
       ],
     }));
 
@@ -1180,6 +1195,9 @@ class CodeBakersServer {
         case 'update_patterns':
           return this.handleUpdatePatterns(args as { force?: boolean });
 
+        case 'detect_intent':
+          return this.handleDetectIntent(args as { userMessage: string });
+
         default:
           throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
       }
@@ -5303,6 +5321,151 @@ ${handlers.join('\n')}
     };
   }
 
+  /**
+   * Detect intent from user message and suggest appropriate MCP tools
+   * Shows what would happen before executing, for user confirmation
+   */
+  private handleDetectIntent(args: { userMessage: string }) {
+    const { userMessage } = args;
+    const msg = userMessage.toLowerCase();
+
+    // Define intent patterns with their MCP tools
+    const intentPatterns = [
+      {
+        keywords: ['upgrade codebakers', 'update patterns', 'sync patterns', 'download patterns', 'get latest patterns'],
+        tool: 'update_patterns',
+        description: 'Download latest CLAUDE.md and all .claude/ modules from the CodeBakers server',
+        action: 'WRITE - Will overwrite local pattern files with server versions',
+        isDestructive: true,
+      },
+      {
+        keywords: ['upgrade', 'improve code', 'make production ready', 'code quality'],
+        tool: 'upgrade',
+        description: 'Analyze your code for quality improvements (does NOT download patterns)',
+        action: 'READ-ONLY - Analyzes code and suggests improvements',
+        isDestructive: false,
+      },
+      {
+        keywords: ['build', 'create project', 'new project', 'scaffold', 'start fresh'],
+        tool: 'scaffold_project',
+        description: 'Create a new project from scratch with CodeBakers patterns',
+        action: 'WRITE - Will create new files and folders',
+        isDestructive: true,
+      },
+      {
+        keywords: ['add feature', 'implement', 'build feature', 'create feature'],
+        tool: 'optimize_and_build',
+        description: 'Optimize your feature request with AI and fetch relevant patterns',
+        action: 'READ + ASSIST - Fetches patterns and guides implementation',
+        isDestructive: false,
+      },
+      {
+        keywords: ['audit', 'review code', 'check code', 'code review'],
+        tool: 'run_audit',
+        description: 'Run comprehensive code quality audit',
+        action: 'READ-ONLY - Analyzes code and reports issues',
+        isDestructive: false,
+      },
+      {
+        keywords: ['heal', 'fix errors', 'auto-fix', 'fix bugs'],
+        tool: 'heal',
+        description: 'AI-powered error detection and automatic fixing',
+        action: 'WRITE - May modify files to fix errors',
+        isDestructive: true,
+      },
+      {
+        keywords: ['design', 'clone design', 'copy design', 'match design'],
+        tool: 'design',
+        description: 'Clone a design from mockups, screenshots, or websites',
+        action: 'WRITE - Will generate component files',
+        isDestructive: true,
+      },
+      {
+        keywords: ['status', 'progress', "what's built", 'where am i'],
+        tool: 'project_status',
+        description: 'Show current project build progress and stats',
+        action: 'READ-ONLY - Shows project state',
+        isDestructive: false,
+      },
+      {
+        keywords: ['run tests', 'test', 'check tests'],
+        tool: 'run_tests',
+        description: 'Execute the project test suite',
+        action: 'READ-ONLY - Runs tests and reports results',
+        isDestructive: false,
+      },
+      {
+        keywords: ['list patterns', 'show patterns', 'what patterns'],
+        tool: 'list_patterns',
+        description: 'List all available CodeBakers patterns',
+        action: 'READ-ONLY - Shows available patterns',
+        isDestructive: false,
+      },
+      {
+        keywords: ['init', 'initialize', 'add patterns to existing'],
+        tool: 'init_project',
+        description: 'Add CodeBakers patterns to an existing project',
+        action: 'WRITE - Will add CLAUDE.md and .claude/ folder',
+        isDestructive: true,
+      },
+    ];
+
+    // Find matching intents
+    const matches = intentPatterns.filter(pattern =>
+      pattern.keywords.some(keyword => msg.includes(keyword))
+    );
+
+    let response = `# 🔍 Intent Detection\n\n`;
+    response += `**Your message:** "${userMessage}"\n\n`;
+
+    if (matches.length === 0) {
+      response += `## No specific MCP tool detected\n\n`;
+      response += `Your request doesn't clearly match any MCP tool. I'll proceed with general assistance.\n\n`;
+      response += `**Available tools you might want:**\n`;
+      response += `- \`update_patterns\` - Download latest patterns from server\n`;
+      response += `- \`optimize_and_build\` - Get AI help building a feature\n`;
+      response += `- \`run_audit\` - Review your code quality\n`;
+      response += `- \`project_status\` - Check build progress\n`;
+    } else if (matches.length === 1) {
+      const match = matches[0];
+      response += `## Detected Intent\n\n`;
+      response += `| Property | Value |\n`;
+      response += `|----------|-------|\n`;
+      response += `| **Tool** | \`${match.tool}\` |\n`;
+      response += `| **Description** | ${match.description} |\n`;
+      response += `| **Action Type** | ${match.action} |\n`;
+      response += `| **Destructive?** | ${match.isDestructive ? '⚠️ YES - modifies files' : '✅ NO - read-only'} |\n\n`;
+
+      if (match.isDestructive) {
+        response += `### ⚠️ Confirmation Required\n\n`;
+        response += `This action will modify files. Do you want to proceed?\n\n`;
+        response += `**Reply "yes" or "proceed" to execute, or describe what you actually want.**\n`;
+      } else {
+        response += `This is a read-only operation. Safe to proceed.\n\n`;
+        response += `**Reply "yes" to execute, or clarify your request.**\n`;
+      }
+    } else {
+      response += `## Multiple Possible Intents\n\n`;
+      response += `Your request could match several tools:\n\n`;
+
+      matches.forEach((match, i) => {
+        response += `### Option ${i + 1}: \`${match.tool}\`\n`;
+        response += `- **What it does:** ${match.description}\n`;
+        response += `- **Action:** ${match.action}\n`;
+        response += `- **Destructive:** ${match.isDestructive ? '⚠️ Yes' : '✅ No'}\n\n`;
+      });
+
+      response += `**Which option do you want?** Reply with the tool name or option number.\n`;
+    }
+
+    return {
+      content: [{
+        type: 'text' as const,
+        text: response,
+      }],
+    };
+  }
+
   async run(): Promise<void> {
     const transport = new StdioServerTransport();
     await this.server.connect(transport);