@codebakers/cli 3.3.1 → 3.3.3

package/dist/commands/doctor.js

@@ -12,6 +12,7 @@ const os_1 = require("os");
 const install_hook_js_1 = require("./install-hook.js");
 const config_js_1 = require("../config.js");
 const api_js_1 = require("../lib/api.js");
+const stats_js_1 = require("../lib/stats.js");
 /**
  * Run all health checks for CodeBakers setup
  */
@@ -118,20 +119,20 @@ function checkProject() {
         try {
             const files = (0, fs_1.readdirSync)(claudeDir).filter(f => f.endsWith('.md'));
             const moduleCount = files.length;
-            if (moduleCount >= 40) {
+            if (moduleCount >= 50) {
                 results.push({ ok: true, message: `${moduleCount} modules present (full set)` });
             }
             else if (moduleCount >= 10) {
                 results.push({
                     ok: true,
                     message: `${moduleCount} modules present (partial set)`,
-                    details: 'Run: codebakers upgrade to get all 47 modules'
+                    details: `Run: codebakers upgrade to get all ${stats_js_1.CODEBAKERS_STATS.moduleCount} modules`
                 });
             }
             else if (moduleCount > 0) {
                 results.push({
                     ok: false,
-                    message: `Only ${moduleCount} modules found (expected 47)`,
+                    message: `Only ${moduleCount} modules found (expected ${stats_js_1.CODEBAKERS_STATS.moduleCount})`,
                     details: 'Run: codebakers upgrade to get all modules'
                 });
             }

package/dist/commands/install.js

@@ -10,6 +10,7 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const config_js_1 = require("../config.js");
 const api_js_1 = require("../lib/api.js");
+const stats_js_1 = require("../lib/stats.js");
 async function install() {
     console.log(chalk_1.default.blue('\n  CodeBakers Install\n'));
     const apiKey = (0, config_js_1.getApiKey)();
@@ -79,7 +80,7 @@ async function install() {
         if (moduleCount > 0) {
             console.log(chalk_1.default.gray(`    - .claude/ (${moduleCount} pattern modules)`));
         }
-        console.log(chalk_1.default.blue('\n  Start building! Your AI now knows 114 production patterns.\n'));
+        console.log(chalk_1.default.blue(`\n  Start building! Your AI now knows ${stats_js_1.CODEBAKERS_STATS.moduleCount} production modules.\n`));
     }
     catch (error) {
         spinner.fail('Installation failed');

package/dist/lib/stats.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Central configuration for CodeBakers CLI stats.
+ * Keep in sync with server-side src/lib/stats.ts
+ */
+export declare const CODEBAKERS_STATS: {
+    readonly moduleCount: 59;
+    readonly totalLinesDisplay: "50K+";
+    readonly patternCount: 150;
+};

package/dist/lib/stats.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Central configuration for CodeBakers CLI stats.
+ * Keep in sync with server-side src/lib/stats.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEBAKERS_STATS = void 0;
+exports.CODEBAKERS_STATS = {
+    moduleCount: 59,
+    totalLinesDisplay: '50K+',
+    patternCount: 150,
+};

package/dist/mcp/server.js

@@ -947,6 +947,33 @@ class CodeBakersServer {
                         properties: {},
                     },
                 },
+                {
+                    name: 'update_patterns',
+                    description: 'Download and update CodeBakers pattern files from the server. Use when user says "upgrade codebakers", "update patterns", "download latest patterns", "sync codebakers", or when patterns are missing or outdated. This tool fetches the latest CLAUDE.md router and all .claude/ module files from the server and writes them to disk.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            force: {
+                                type: 'boolean',
+                                description: 'Force update even if already at latest version (default: false)',
+                            },
+                        },
+                    },
+                },
+                {
+                    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
@@ -1034,6 +1061,10 @@ class CodeBakersServer {
                     return this.handleAddApiRoute(args);
                 case 'check_update_notification':
                     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}`);
             }
@@ -4532,6 +4563,274 @@ export async function POST(request: NextRequest) {
 ${handlers.join('\n')}
 `;
     }
+    /**
+     * Download and update CodeBakers patterns from server
+     * This is the MCP equivalent of the `codebakers upgrade` CLI command
+     */
+    async handleUpdatePatterns(args) {
+        const { force = false } = args;
+        const cwd = process.cwd();
+        const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+        const claudeDir = path.join(cwd, '.claude');
+        const versionPath = path.join(claudeDir, '.version.json');
+        let response = `# 🔄 CodeBakers Pattern Update\n\n`;
+        try {
+            // Check current version
+            let currentVersion = null;
+            let currentModuleCount = 0;
+            if (fs.existsSync(versionPath)) {
+                try {
+                    const versionInfo = JSON.parse(fs.readFileSync(versionPath, 'utf-8'));
+                    currentVersion = versionInfo.version;
+                    currentModuleCount = versionInfo.moduleCount || 0;
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            }
+            // Count current modules
+            if (fs.existsSync(claudeDir)) {
+                try {
+                    const files = fs.readdirSync(claudeDir).filter(f => f.endsWith('.md'));
+                    currentModuleCount = files.length;
+                }
+                catch {
+                    // Ignore read errors
+                }
+            }
+            response += `## Current Status\n`;
+            response += `- Version: ${currentVersion || 'Unknown'}\n`;
+            response += `- Modules: ${currentModuleCount}\n\n`;
+            // Fetch latest version info first
+            const versionResponse = await fetch(`${this.apiUrl}/api/content/version`, {
+                headers: this.getAuthHeaders(),
+            });
+            if (!versionResponse.ok) {
+                throw new Error('Failed to check version from server');
+            }
+            const latestInfo = await versionResponse.json();
+            const latestVersion = latestInfo.version;
+            const latestModuleCount = latestInfo.moduleCount || 0;
+            response += `## Server Status\n`;
+            response += `- Latest Version: ${latestVersion}\n`;
+            response += `- Available Modules: ${latestModuleCount}\n\n`;
+            // Check if update needed
+            const needsUpdate = force || !currentVersion || currentVersion !== latestVersion || currentModuleCount < latestModuleCount;
+            if (!needsUpdate) {
+                response += `✅ **Already up to date!**\n\n`;
+                response += `Your patterns are current (v${latestVersion} with ${latestModuleCount} modules).\n`;
+                response += `Use \`force: true\` to re-download anyway.\n`;
+                return {
+                    content: [{
+                            type: 'text',
+                            text: response,
+                        }],
+                };
+            }
+            response += `## Downloading Updates...\n\n`;
+            // Fetch full content
+            const contentResponse = await fetch(`${this.apiUrl}/api/content`, {
+                headers: this.getAuthHeaders(),
+            });
+            if (!contentResponse.ok) {
+                const error = await contentResponse.json().catch(() => ({}));
+                throw new Error(error.error || error.message || 'Failed to fetch patterns');
+            }
+            const content = await contentResponse.json();
+            const moduleCount = content.modules ? Object.keys(content.modules).length : 0;
+            // Create .claude directory if needed
+            if (!fs.existsSync(claudeDir)) {
+                fs.mkdirSync(claudeDir, { recursive: true });
+                response += `✓ Created .claude/ directory\n`;
+            }
+            // Update CLAUDE.md router
+            if (content.router) {
+                fs.writeFileSync(claudeMdPath, content.router);
+                response += `✓ Updated CLAUDE.md (router)\n`;
+            }
+            // Update all modules
+            if (content.modules && moduleCount > 0) {
+                for (const [name, data] of Object.entries(content.modules)) {
+                    fs.writeFileSync(path.join(claudeDir, name), data);
+                }
+                response += `✓ Updated ${moduleCount} modules in .claude/\n`;
+            }
+            // Save version info
+            const newVersionInfo = {
+                version: content.version || latestVersion,
+                moduleCount,
+                installedAt: currentVersion ? undefined : new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                cliVersion: (0, api_js_1.getCliVersion)(),
+            };
+            fs.writeFileSync(versionPath, JSON.stringify(newVersionInfo, null, 2));
+            response += `✓ Saved version info\n`;
+            // Confirm download to server (non-blocking analytics)
+            this.confirmDownload(content.version || latestVersion, moduleCount).catch(() => { });
+            response += `\n## ✅ Update Complete!\n\n`;
+            response += `- **From:** v${currentVersion || 'none'} (${currentModuleCount} modules)\n`;
+            response += `- **To:** v${content.version || latestVersion} (${moduleCount} modules)\n\n`;
+            if (moduleCount > currentModuleCount) {
+                response += `🆕 **${moduleCount - currentModuleCount} new modules added!**\n\n`;
+            }
+            response += `Your patterns are now up to date. The new patterns will be used in your next response.\n`;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            response += `\n## ❌ Update Failed\n\n`;
+            response += `Error: ${message}\n\n`;
+            if (message.includes('401') || message.includes('Invalid') || message.includes('expired')) {
+                response += `Your API key may be invalid or expired.\n`;
+                response += `Run \`codebakers setup\` in terminal to reconfigure.\n`;
+            }
+            else {
+                response += `Please try again or run \`codebakers upgrade\` in terminal.\n`;
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: response,
+                }],
+        };
+    }
+    /**
+     * 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/nul

@@ -0,0 +1 @@
+vitest.config.ts

package/package.json

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

package/src/commands/doctor.ts

@@ -5,6 +5,7 @@ import { homedir } from 'os';
 import { isHookInstalled } from './install-hook.js';
 import { getApiKey } from '../config.js';
 import { checkApiKeyValidity, checkForUpdates, getCliVersion } from '../lib/api.js';
+import { CODEBAKERS_STATS } from '../lib/stats.js';
 
 interface CheckResult {
   ok: boolean;
@@ -134,18 +135,18 @@ function checkProject(): CheckResult[] {
       const files = readdirSync(claudeDir).filter(f => f.endsWith('.md'));
       const moduleCount = files.length;
 
-      if (moduleCount >= 40) {
+      if (moduleCount >= 50) {
         results.push({ ok: true, message: `${moduleCount} modules present (full set)` });
       } else if (moduleCount >= 10) {
         results.push({
           ok: true,
           message: `${moduleCount} modules present (partial set)`,
-          details: 'Run: codebakers upgrade to get all 47 modules'
+          details: `Run: codebakers upgrade to get all ${CODEBAKERS_STATS.moduleCount} modules`
         });
       } else if (moduleCount > 0) {
         results.push({
           ok: false,
-          message: `Only ${moduleCount} modules found (expected 47)`,
+          message: `Only ${moduleCount} modules found (expected ${CODEBAKERS_STATS.moduleCount})`,
           details: 'Run: codebakers upgrade to get all modules'
         });
       } else {

package/src/commands/install.ts

@@ -4,6 +4,7 @@ import { writeFileSync, mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
 import { getApiKey, getApiUrl } from '../config.js';
 import { getCliVersion } from '../lib/api.js';
+import { CODEBAKERS_STATS } from '../lib/stats.js';
 
 interface ContentResponse {
   version: string;
@@ -94,7 +95,7 @@ export async function install(): Promise<void> {
     if (moduleCount > 0) {
       console.log(chalk.gray(`    - .claude/ (${moduleCount} pattern modules)`));
     }
-    console.log(chalk.blue('\n  Start building! Your AI now knows 114 production patterns.\n'));
+    console.log(chalk.blue(`\n  Start building! Your AI now knows ${CODEBAKERS_STATS.moduleCount} production modules.\n`));
   } catch (error) {
     spinner.fail('Installation failed');
     const message = error instanceof Error ? error.message : 'Unknown error';

package/src/lib/stats.ts

@@ -0,0 +1,10 @@
+/**
+ * Central configuration for CodeBakers CLI stats.
+ * Keep in sync with server-side src/lib/stats.ts
+ */
+
+export const CODEBAKERS_STATS = {
+  moduleCount: 59,
+  totalLinesDisplay: '50K+',
+  patternCount: 150,
+} as const;

package/src/mcp/server.ts

@@ -1033,6 +1033,35 @@ class CodeBakersServer {
             properties: {},
           },
         },
+        {
+          name: 'update_patterns',
+          description:
+            'Download and update CodeBakers pattern files from the server. Use when user says "upgrade codebakers", "update patterns", "download latest patterns", "sync codebakers", or when patterns are missing or outdated. This tool fetches the latest CLAUDE.md router and all .claude/ module files from the server and writes them to disk.',
+          inputSchema: {
+            type: 'object' as const,
+            properties: {
+              force: {
+                type: 'boolean',
+                description: 'Force update even if already at latest version (default: false)',
+              },
+            },
+          },
+        },
+        {
+          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'],
+          },
+        },
       ],
     }));
 
@@ -1163,6 +1192,12 @@ class CodeBakersServer {
         case 'check_update_notification':
           return this.handleCheckUpdateNotification();
 
+        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}`);
       }
@@ -5131,6 +5166,306 @@ ${handlers.join('\n')}
 `;
   }
 
+  /**
+   * Download and update CodeBakers patterns from server
+   * This is the MCP equivalent of the `codebakers upgrade` CLI command
+   */
+  private async handleUpdatePatterns(args: { force?: boolean }) {
+    const { force = false } = args;
+    const cwd = process.cwd();
+    const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+    const claudeDir = path.join(cwd, '.claude');
+    const versionPath = path.join(claudeDir, '.version.json');
+
+    let response = `# 🔄 CodeBakers Pattern Update\n\n`;
+
+    try {
+      // Check current version
+      let currentVersion: string | null = null;
+      let currentModuleCount = 0;
+
+      if (fs.existsSync(versionPath)) {
+        try {
+          const versionInfo = JSON.parse(fs.readFileSync(versionPath, 'utf-8'));
+          currentVersion = versionInfo.version;
+          currentModuleCount = versionInfo.moduleCount || 0;
+        } catch {
+          // Ignore parse errors
+        }
+      }
+
+      // Count current modules
+      if (fs.existsSync(claudeDir)) {
+        try {
+          const files = fs.readdirSync(claudeDir).filter(f => f.endsWith('.md'));
+          currentModuleCount = files.length;
+        } catch {
+          // Ignore read errors
+        }
+      }
+
+      response += `## Current Status\n`;
+      response += `- Version: ${currentVersion || 'Unknown'}\n`;
+      response += `- Modules: ${currentModuleCount}\n\n`;
+
+      // Fetch latest version info first
+      const versionResponse = await fetch(`${this.apiUrl}/api/content/version`, {
+        headers: this.getAuthHeaders(),
+      });
+
+      if (!versionResponse.ok) {
+        throw new Error('Failed to check version from server');
+      }
+
+      const latestInfo = await versionResponse.json();
+      const latestVersion = latestInfo.version;
+      const latestModuleCount = latestInfo.moduleCount || 0;
+
+      response += `## Server Status\n`;
+      response += `- Latest Version: ${latestVersion}\n`;
+      response += `- Available Modules: ${latestModuleCount}\n\n`;
+
+      // Check if update needed
+      const needsUpdate = force || !currentVersion || currentVersion !== latestVersion || currentModuleCount < latestModuleCount;
+
+      if (!needsUpdate) {
+        response += `✅ **Already up to date!**\n\n`;
+        response += `Your patterns are current (v${latestVersion} with ${latestModuleCount} modules).\n`;
+        response += `Use \`force: true\` to re-download anyway.\n`;
+
+        return {
+          content: [{
+            type: 'text' as const,
+            text: response,
+          }],
+        };
+      }
+
+      response += `## Downloading Updates...\n\n`;
+
+      // Fetch full content
+      const contentResponse = await fetch(`${this.apiUrl}/api/content`, {
+        headers: this.getAuthHeaders(),
+      });
+
+      if (!contentResponse.ok) {
+        const error = await contentResponse.json().catch(() => ({}));
+        throw new Error(error.error || error.message || 'Failed to fetch patterns');
+      }
+
+      const content = await contentResponse.json();
+      const moduleCount = content.modules ? Object.keys(content.modules).length : 0;
+
+      // Create .claude directory if needed
+      if (!fs.existsSync(claudeDir)) {
+        fs.mkdirSync(claudeDir, { recursive: true });
+        response += `✓ Created .claude/ directory\n`;
+      }
+
+      // Update CLAUDE.md router
+      if (content.router) {
+        fs.writeFileSync(claudeMdPath, content.router);
+        response += `✓ Updated CLAUDE.md (router)\n`;
+      }
+
+      // Update all modules
+      if (content.modules && moduleCount > 0) {
+        for (const [name, data] of Object.entries(content.modules)) {
+          fs.writeFileSync(path.join(claudeDir, name), data as string);
+        }
+        response += `✓ Updated ${moduleCount} modules in .claude/\n`;
+      }
+
+      // Save version info
+      const newVersionInfo = {
+        version: content.version || latestVersion,
+        moduleCount,
+        installedAt: currentVersion ? undefined : new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        cliVersion: getCliVersion(),
+      };
+      fs.writeFileSync(versionPath, JSON.stringify(newVersionInfo, null, 2));
+      response += `✓ Saved version info\n`;
+
+      // Confirm download to server (non-blocking analytics)
+      this.confirmDownload(content.version || latestVersion, moduleCount).catch(() => {});
+
+      response += `\n## ✅ Update Complete!\n\n`;
+      response += `- **From:** v${currentVersion || 'none'} (${currentModuleCount} modules)\n`;
+      response += `- **To:** v${content.version || latestVersion} (${moduleCount} modules)\n\n`;
+
+      if (moduleCount > currentModuleCount) {
+        response += `🆕 **${moduleCount - currentModuleCount} new modules added!**\n\n`;
+      }
+
+      response += `Your patterns are now up to date. The new patterns will be used in your next response.\n`;
+
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Unknown error';
+      response += `\n## ❌ Update Failed\n\n`;
+      response += `Error: ${message}\n\n`;
+
+      if (message.includes('401') || message.includes('Invalid') || message.includes('expired')) {
+        response += `Your API key may be invalid or expired.\n`;
+        response += `Run \`codebakers setup\` in terminal to reconfigure.\n`;
+      } else {
+        response += `Please try again or run \`codebakers upgrade\` in terminal.\n`;
+      }
+    }
+
+    return {
+      content: [{
+        type: 'text' as const,
+        text: response,
+      }],
+    };
+  }
+
+  /**
+   * 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);