@codebakers/cli 3.4.1 → 3.5.1

package/src/commands/go.ts

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import { execSync, spawn } from 'child_process';
-import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { writeFileSync, existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { createInterface } from 'readline';
 import {
@@ -31,12 +31,6 @@ function prompt(question: string): Promise<string> {
   });
 }
 
-interface ContentResponse {
-  version: string;
-  router: string;
-  modules: Record<string, string>;
-}
-
 interface GoOptions {
   verbose?: boolean;
 }
@@ -249,7 +243,7 @@ export async function go(options: GoOptions = {}): Promise<void> {
     spinner.succeed(`Trial started (${data.daysRemaining} days free)`);
     console.log('');
 
-    // Install patterns (CLAUDE.md and .claude/)
+    // Install v6.0 bootstrap files (CLAUDE.md and .cursorrules only)
     await installPatterns(data.trialId, options);
 
     // Configure MCP
@@ -395,149 +389,175 @@ async function showSuccessAndRestart(): Promise<void> {
   }
 }
 
-/**
- * Install pattern files for API key users (paid users)
- */
-async function installPatternsWithApiKey(apiKey: string, options: GoOptions = {}): Promise<void> {
-  log('Installing patterns with API key...', options);
-  const spinner = ora('Installing CodeBakers patterns...').start();
-  const cwd = process.cwd();
-  const apiUrl = getApiUrl();
+// v6.0 Bootstrap content - minimal files that point to MCP tools
+const V6_CLAUDE_MD = `# CodeBakers v6.0 - Server-Enforced Patterns
 
-  log(`Fetching from: ${apiUrl}/api/content`, options);
+**All patterns are server-side. No local pattern files needed.**
 
-  try {
-    const response = await fetch(`${apiUrl}/api/content`, {
-      method: 'GET',
-      headers: {
-        'Authorization': `Bearer ${apiKey}`,
-      },
-    });
+## Required MCP Tools
 
-    if (!response.ok) {
-      log(`Response not OK: ${response.status} ${response.statusText}`, options);
-      spinner.warn('Could not download patterns');
-      return;
-    }
+Before writing ANY code, you MUST use these CodeBakers MCP tools:
 
-    log('Response OK, parsing JSON...', options);
-    const content: ContentResponse = await response.json();
-    log(`Received version: ${content.version}, modules: ${Object.keys(content.modules || {}).length}`, options);
-    await writePatternFiles(cwd, content, spinner, options, { apiKey });
+### 1. discover_patterns (MANDATORY - START GATE)
+Call this BEFORE writing any code:
+\`\`\`
+Tool: discover_patterns
+Args: { task: "what you're about to do", files: ["files to modify"], keywords: ["relevant terms"] }
+\`\`\`
+This returns:
+- Relevant patterns from the server
+- A session token (required for validation)
+- Code examples to follow
 
-  } catch (error) {
-    log(`Error: ${error instanceof Error ? error.message : String(error)}`, options);
-    spinner.warn('Could not install patterns');
-    console.log(chalk.gray('  Check your internet connection.\n'));
-  }
+### 2. validate_complete (MANDATORY - END GATE)
+Call this BEFORE saying "done" or "complete":
+\`\`\`
+Tool: validate_complete
+Args: { feature: "what you built", files: ["files modified"] }
+\`\`\`
+This checks:
+- You called discover_patterns first (server verifies)
+- Tests exist and pass
+- TypeScript compiles
+- Returns pass/fail from server
+
+## Rules
+
+1. **You CANNOT skip discover_patterns** - Server tracks compliance
+2. **You CANNOT say "done" without validate_complete** - Server must approve
+3. **Follow patterns returned by server** - They are mandatory
+4. **Write tests** - Validation will fail without them
+5. **Fix TypeScript errors** - Validation will fail with errors
+
+## If Server is Unreachable
+
+The tools will show "OFFLINE MODE" if the server can't be reached. In this case:
+- Enforcement is limited to local checks only
+- You should still follow best practices
+- Try again when connection is restored
+
+## Getting Help
+
+- Run \`codebakers doctor\` to diagnose issues
+- Run \`codebakers upgrade\` to update patterns
+- Visit https://codebakers.ai/support for help
+
+---
+*CodeBakers v6.0 - Server-Enforced Patterns*
+`;
+
+const V6_CURSORRULES = `# CodeBakers v6.0 - Server-Enforced Patterns
+
+All patterns are server-side. No local pattern files needed.
+
+## Required MCP Tools
+
+Before writing ANY code, you MUST use these CodeBakers MCP tools:
+
+### 1. discover_patterns (MANDATORY - START GATE)
+Call this BEFORE writing any code:
+- Tool: discover_patterns
+- Args: { task: "what you're about to do", files: ["files to modify"], keywords: ["relevant terms"] }
+
+Returns:
+- Relevant patterns from the server
+- A session token (required for validation)
+- Code examples to follow
+
+### 2. validate_complete (MANDATORY - END GATE)
+Call this BEFORE saying "done" or "complete":
+- Tool: validate_complete
+- Args: { feature: "what you built", files: ["files modified"] }
+
+Checks:
+- You called discover_patterns first (server verifies)
+- Tests exist and pass
+- TypeScript compiles
+- Returns pass/fail from server
+
+## Rules
+
+1. You CANNOT skip discover_patterns - Server tracks compliance
+2. You CANNOT say "done" without validate_complete - Server must approve
+3. Follow patterns returned by server - They are mandatory
+4. Write tests - Validation will fail without them
+5. Fix TypeScript errors - Validation will fail with errors
+
+## If Server is Unreachable
+
+The tools will show "OFFLINE MODE" if the server can't be reached. In this case:
+- Enforcement is limited to local checks only
+- You should still follow best practices
+- Try again when connection is restored
+
+---
+CodeBakers v6.0 - Server-Enforced Patterns
+`;
+
+/**
+ * Install v6.0 bootstrap files for API key users (paid users)
+ * Only installs minimal CLAUDE.md and .cursorrules - no .claude/ folder
+ */
+async function installPatternsWithApiKey(apiKey: string, options: GoOptions = {}): Promise<void> {
+  log('Installing v6.0 bootstrap files (API key user)...', options);
+  await installBootstrapFiles(options, { apiKey });
 }
 
 /**
- * Install pattern files (CLAUDE.md and .claude/) for trial users
+ * Install v6.0 bootstrap files for trial users
+ * Only installs minimal CLAUDE.md and .cursorrules - no .claude/ folder
  */
 async function installPatterns(trialId: string, options: GoOptions = {}): Promise<void> {
-  log(`Installing patterns with trial ID: ${trialId.substring(0, 8)}...`, options);
-  const spinner = ora('Installing CodeBakers patterns...').start();
+  log(`Installing v6.0 bootstrap files (trial: ${trialId.substring(0, 8)}...)`, options);
+  await installBootstrapFiles(options, { trialId });
+}
+
+/**
+ * Install v6.0 minimal bootstrap files
+ * - CLAUDE.md: Instructions for Claude Code
+ * - .cursorrules: Instructions for Cursor
+ * - NO .claude/ folder - all patterns are server-side
+ */
+async function installBootstrapFiles(options: GoOptions = {}, auth?: AuthInfo): Promise<void> {
+  const spinner = ora('Installing CodeBakers v6.0...').start();
   const cwd = process.cwd();
-  const apiUrl = getApiUrl();
 
   try {
-    // Fetch patterns using trial ID
-    log(`Fetching from: ${apiUrl}/api/content`, options);
-    const response = await fetch(`${apiUrl}/api/content`, {
-      method: 'GET',
-      headers: {
-        'X-Trial-ID': trialId,
-      },
-    });
-
-    if (!response.ok) {
-      log(`Primary endpoint failed: ${response.status}, trying trial endpoint...`, options);
-      // Try without auth - some patterns may be available for trial
-      const publicResponse = await fetch(`${apiUrl}/api/content/trial`, {
-        method: 'GET',
-        headers: {
-          'X-Trial-ID': trialId,
-        },
-      });
-
-      if (!publicResponse.ok) {
-        log(`Trial endpoint also failed: ${publicResponse.status}`, options);
-        spinner.warn('Could not download patterns (will use MCP tools)');
+    const claudeMdPath = join(cwd, 'CLAUDE.md');
+    const cursorRulesPath = join(cwd, '.cursorrules');
+
+    // Check if already installed with v6
+    if (existsSync(claudeMdPath)) {
+      const content = readFileSync(claudeMdPath, 'utf-8');
+      if (content.includes('v6.0') && content.includes('discover_patterns')) {
+        spinner.succeed('CodeBakers v6.0 already installed');
         return;
       }
-
-      const content: ContentResponse = await publicResponse.json();
-      log(`Received version: ${content.version}, modules: ${Object.keys(content.modules || {}).length}`, options);
-      await writePatternFiles(cwd, content, spinner, options, { trialId });
-      return;
+      // Upgrade from v5
+      log('Upgrading from v5 to v6...', options);
     }
 
-    const content: ContentResponse = await response.json();
-    log(`Received version: ${content.version}, modules: ${Object.keys(content.modules || {}).length}`, options);
-    await writePatternFiles(cwd, content, spinner, options, { trialId });
+    // Write v6.0 bootstrap files
+    writeFileSync(claudeMdPath, V6_CLAUDE_MD);
+    writeFileSync(cursorRulesPath, V6_CURSORRULES);
+
+    spinner.succeed('CodeBakers v6.0 installed');
+    console.log(chalk.gray('  Patterns are server-enforced via MCP tools\n'));
+
+    // Confirm install to server (non-blocking)
+    if (auth) {
+      const apiUrl = getApiUrl();
+      confirmDownload(apiUrl, auth, {
+        version: '6.0',
+        moduleCount: 0, // No local modules in v6
+        cliVersion: getCliVersion(),
+        command: 'go',
+      }).catch(() => {}); // Silently ignore
+    }
 
   } catch (error) {
     log(`Error: ${error instanceof Error ? error.message : String(error)}`, options);
-    spinner.warn('Could not install patterns (will use MCP tools)');
-    console.log(chalk.gray('  Patterns will be available via MCP tools.\n'));
-  }
-}
-
-async function writePatternFiles(
-  cwd: string,
-  content: ContentResponse,
-  spinner: ReturnType<typeof ora>,
-  options: GoOptions = {},
-  auth?: AuthInfo
-): Promise<void> {
-  log(`Writing pattern files to ${cwd}...`, options);
-  // Check if patterns already exist
-  const claudeMdPath = join(cwd, 'CLAUDE.md');
-  if (existsSync(claudeMdPath)) {
-    spinner.succeed('CodeBakers patterns already installed');
-    return;
-  }
-
-  // Write CLAUDE.md (router file)
-  if (content.router) {
-    writeFileSync(claudeMdPath, content.router);
-  }
-
-  // Write pattern modules to .claude/
-  const moduleCount = Object.keys(content.modules || {}).length;
-  if (content.modules && moduleCount > 0) {
-    const modulesDir = join(cwd, '.claude');
-    if (!existsSync(modulesDir)) {
-      mkdirSync(modulesDir, { recursive: true });
-    }
-
-    for (const [name, data] of Object.entries(content.modules)) {
-      writeFileSync(join(modulesDir, name), data);
-    }
-  }
-
-  // Update .gitignore to exclude encoded patterns
-  const gitignorePath = join(cwd, '.gitignore');
-  if (existsSync(gitignorePath)) {
-    const { readFileSync } = await import('fs');
-    const gitignore = readFileSync(gitignorePath, 'utf-8');
-    if (!gitignore.includes('.claude/')) {
-      writeFileSync(gitignorePath, gitignore + '\n# CodeBakers patterns\n.claude/\n');
-    }
-  }
-
-  spinner.succeed(`CodeBakers patterns installed (v${content.version})`);
-  console.log(chalk.gray(`  ${moduleCount} pattern modules ready\n`));
-
-  // Confirm download to server (non-blocking)
-  if (auth) {
-    const apiUrl = getApiUrl();
-    confirmDownload(apiUrl, auth, {
-      version: content.version,
-      moduleCount,
-      cliVersion: getCliVersion(),
-      command: 'go',
-    }).catch(() => {}); // Silently ignore
+    spinner.warn('Could not install bootstrap files');
+    console.log(chalk.gray('  MCP tools will still work without local files.\n'));
   }
 }

package/src/commands/init.ts

@@ -33,9 +33,9 @@ If PROJECT-CONTEXT.md is empty or stale (>7 days), SCAN THE PROJECT FIRST:
 - Update PROJECT-CONTEXT.md
 
 ### PHASE 3: EXECUTE
-- State: \`📋 CodeBakers | [Type] | Modules: [list]\`
-- Load required modules from .claude/
-- Follow patterns EXACTLY
+- State: \`📋 CodeBakers | [Type] | v6.0 Server-Enforced\`
+- Call discover_patterns MCP tool first
+- Follow patterns from server EXACTLY
 
 ### PHASE 4: SELF-REVIEW (before saying "done")
 - [ ] TypeScript compiles? (npx tsc --noEmit)
@@ -405,9 +405,9 @@ When you make a decision that affects architecture, add an entry:
 ---
 
 ## ${date}: Project Initialized
-**Decision:** Using CodeBakers pattern system
+**Decision:** Using CodeBakers v6.0 pattern system
 **Reason:** Ensure consistent, production-quality code
-**Pattern:** See .claude/ folder for all patterns
+**Pattern:** Server-enforced via discover_patterns MCP tool
 
 ---
 
@@ -597,51 +597,64 @@ export async function init(): Promise<void> {
     }
   }
 
-  // Step 4: Install patterns from API
-  console.log(chalk.white('\n  Step 2: Installing patterns\n'));
+  // Step 4: Install v6.0 bootstrap files
+  console.log(chalk.white('\n  Step 2: Installing CodeBakers v6.0\n'));
 
-  const spinner = ora('  Downloading patterns...').start();
+  const spinner = ora('  Installing v6.0 bootstrap...').start();
 
-  try {
-    const apiUrl = getApiUrl();
-    const response = await fetch(`${apiUrl}/api/content`, {
-      method: 'GET',
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
-    });
+  // v6.0 bootstrap content - minimal files, patterns from server
+  const V6_CLAUDE_MD = `# CodeBakers v6.0
 
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.error || 'Failed to fetch content');
-    }
+**MANDATORY: Before writing ANY code, call the \`discover_patterns\` MCP tool.**
 
-    const content: ContentResponse = await response.json();
-    spinner.text = '  Installing patterns...';
+\`\`\`
+Tool: discover_patterns
+Args: { task: "description of what you're building" }
+\`\`\`
 
-    // Write router file (CLAUDE.md)
-    if (content.router) {
-      writeFileSync(join(cwd, 'CLAUDE.md'), content.router);
-    }
+The server will return:
+- All coding patterns and rules you must follow
+- Test requirements
+- Validation instructions
 
-    // Write modules to .claude/
-    if (content.modules && Object.keys(content.modules).length > 0) {
-      const modulesDir = join(cwd, '.claude');
-      if (!existsSync(modulesDir)) {
-        mkdirSync(modulesDir, { recursive: true });
-      }
+**You cannot write code without calling this tool first. The server tracks compliance.**
+
+---
+*CodeBakers v6.0 - Server-Enforced*
+`;
+
+  const V6_CURSORRULES = `# CodeBakers v6.0
+
+MANDATORY: Before writing ANY code, call the discover_patterns MCP tool.
 
-      for (const [name, data] of Object.entries(content.modules)) {
-        writeFileSync(join(modulesDir, name), data);
+Tool: discover_patterns
+Args: { task: "description of what you're building" }
+
+The server returns all patterns, rules, and test requirements.
+You cannot write code without calling this tool first.
+`;
+
+  try {
+    // Write v6.0 bootstrap files
+    writeFileSync(join(cwd, 'CLAUDE.md'), V6_CLAUDE_MD);
+    writeFileSync(join(cwd, '.cursorrules'), V6_CURSORRULES);
+
+    // Remove old .claude folder if it exists (v5 → v6 migration)
+    const claudeDir = join(cwd, '.claude');
+    if (existsSync(claudeDir)) {
+      const { rmSync } = await import('fs');
+      try {
+        rmSync(claudeDir, { recursive: true, force: true });
+      } catch {
+        // Ignore errors
       }
     }
 
-    spinner.succeed('Patterns installed!');
-    console.log(chalk.gray(`\n  Version: ${content.version}`));
-    console.log(chalk.gray(`  Modules: ${Object.keys(content.modules || {}).length} pattern files`));
+    spinner.succeed('CodeBakers v6.0 installed!');
+    console.log(chalk.gray('\n  Patterns are server-enforced via MCP tools'));
 
   } catch (error) {
-    spinner.fail('Pattern installation failed');
+    spinner.fail('Installation failed');
     const message = error instanceof Error ? error.message : 'Unknown error';
     console.log(chalk.red(`\n  Error: ${message}\n`));
     process.exit(1);
@@ -758,7 +771,7 @@ export async function init(): Promise<void> {
   if (existsSync(gitignorePath)) {
     const gitignore = readFileSync(gitignorePath, 'utf-8');
     if (!gitignore.includes('.cursorrules')) {
-      const additions = '\n# CodeBakers (encoded patterns)\n.cursorrules\n.claude/\n';
+      const additions = '\n# CodeBakers\n.cursorrules\n';
       writeFileSync(gitignorePath, gitignore + additions);
     }
   }
@@ -838,16 +851,15 @@ export async function init(): Promise<void> {
   `));
 
   console.log(chalk.white('  Files created:\n'));
-  console.log(chalk.cyan('    CLAUDE.md          ') + chalk.gray('→ AI router'));
+  console.log(chalk.cyan('    CLAUDE.md          ') + chalk.gray('→ v6.0 bootstrap (patterns via MCP)'));
+  console.log(chalk.cyan('    .cursorrules       ') + chalk.gray('→ v6.0 bootstrap (patterns via MCP)'));
   if (prdCreated) {
     console.log(chalk.cyan('    PRD.md             ') + chalk.gray('→ Product requirements (AI reads this!)'));
   }
   console.log(chalk.cyan('    PROJECT-CONTEXT.md ') + chalk.gray('→ Codebase knowledge (auto-updated)'));
   console.log(chalk.cyan('    PROJECT-STATE.md   ') + chalk.gray('→ Task tracking (auto-updated)'));
   console.log(chalk.cyan('    DECISIONS.md       ') + chalk.gray('→ Architecture log (auto-updated)'));
-  console.log(chalk.cyan('    .cursorrules       ') + chalk.gray('→ Cursor AI instructions'));
-  console.log(chalk.cyan('    .cursorignore      ') + chalk.gray('→ Context optimization'));
-  console.log(chalk.cyan('    .claude/           ') + chalk.gray('→ Pattern modules\n'));
+  console.log(chalk.cyan('    .cursorignore      ') + chalk.gray('→ Context optimization\n'));
 
   console.log(chalk.white('  What happens automatically:\n'));
   console.log(chalk.gray('    ✓ AI loads context before every response'));

package/src/commands/install-hook.ts

@@ -23,16 +23,16 @@ const HOOK_TEMPLATE = {
   }
 };
 
-// Instructions that get injected into the system prompt
+// Instructions that get injected into the system prompt (v6.0)
 const CODEBAKERS_INSTRUCTIONS = `
 <user-prompt-submit-hook>
-[CodeBakers] Active - Follow these steps for EVERY request:
+[CodeBakers v6.0] Active - Follow these steps for EVERY request:
 
-1. CONTEXT: Read CLAUDE.md, PROJECT-CONTEXT.md, PROJECT-STATE.md
-2. PRE-FLIGHT: Check existing code patterns before writing new code
-3. EXECUTE: Use patterns from .claude/ folder
+1. CONTEXT: Read CLAUDE.md
+2. DISCOVER: Call discover_patterns MCP tool before writing any code
+3. EXECUTE: Follow the patterns returned by the server
 4. SELF-REVIEW: Verify TypeScript compiles, imports resolve, error handling exists
-5. UPDATE: Mark tasks complete in PROJECT-STATE.md
+5. VALIDATE: Call validate_complete MCP tool when done
 
 Output format: "[CodeBakers] Building [feature] using [patterns]"
 </user-prompt-submit-hook>
@@ -102,9 +102,9 @@ export async function installHook(): Promise<void> {
 
     console.log(chalk.white('  What happens automatically:\n'));
     console.log(chalk.gray('    ✓ Loads project context before every response'));
-    console.log(chalk.gray('    ✓ Pre-flight checks before writing code'));
+    console.log(chalk.gray('    ✓ Calls discover_patterns MCP tool before coding'));
     console.log(chalk.gray('    ✓ Self-review reminders after code changes'));
-    console.log(chalk.gray('    ✓ Pattern-based development from .claude/ folder\n'));
+    console.log(chalk.gray('    ✓ Server-side patterns (always up-to-date)\n'));
 
     console.log(chalk.yellow.bold('  ⚠️  RESTART REQUIRED:\n'));
     console.log(chalk.gray('    1. Type ') + chalk.cyan('exit') + chalk.gray(' to close this terminal'));