forgedev 1.2.0 → 1.3.0

package/src/doctor-prompts.js

@@ -1,7 +1,7 @@
 const PROMPT_TEMPLATES = {
   CLAUDE_MD_TOO_LONG: (issue) => {
     const lines = issue.title.match(/(\d+) lines/)?.[1] || '?';
-    return `Read CLAUDE.md. It's ${lines} lines — too long for Claude Code to follow reliably (target: <150).
+    return `Read CLAUDE.md. It's ${lines} lines, too long for Claude Code to follow reliably (target: <150).
 
 Propose a split:
 - What stays in CLAUDE.md (universal rules, commands, pitfalls)
@@ -25,7 +25,7 @@ Write a test for each endpoint confirming 401 without auth.`;
 
   FLAKY_TESTS: (issue) => {
     const fileList = (issue.files || []).map(f => `- ${f}`).join('\n');
-    return `These tests use waitForTimeout() or hardcoded delays — they will fail randomly:
+    return `These tests use waitForTimeout() or hardcoded delays. They will fail randomly:
 ${fileList}
 
 For each:
@@ -55,10 +55,10 @@ ${fileList}
 For each: replace with a specific exception type.
 - If catching expected errors: except ValueError, except KeyError, etc.
 - If catching any exception for logging: except Exception as e: with logging
-- Never use bare except: — it hides bugs`;
+- Never use bare except: because it hides bugs`;
   },
 
-  MISSING_HEALTH: (issue) => {
+  MISSING_HEALTH: (_issue) => {
     return `Add a health check endpoint to the application.
 
 For FastAPI: Add a /health endpoint that returns {"status": "ok"} and optionally checks database connectivity.
@@ -68,7 +68,7 @@ For both: Include database connectivity check if a database is configured.
 This endpoint is used by load balancers and monitoring to verify the app is running.`;
   },
 
-  MISSING_SHUTDOWN: (issue) => {
+  MISSING_SHUTDOWN: (_issue) => {
     return `Add graceful shutdown handling to the application.
 
 For FastAPI: Use the lifespan context manager to handle startup/shutdown events.
@@ -114,7 +114,7 @@ For each:
 3. Update imports
 4. Run tests after each extraction
 
-Don't refactor all at once — one file per session.`;
+Don't refactor all at once. Do one file per session.`;
   },
 
   MISSING_SCOPED_CLAUDE_MD: (issue) => {
@@ -177,7 +177,7 @@ ${fileList}
 Extract all prompts into a dedicated prompts file (e.g., src/lib/prompts.ts or prompts/). This makes prompts easier to version, A/B test, and iterate on without changing application code.`;
   },
 
-  DEVFORGE_UPDATE: (issue) => {
+  DEVFORGE_UPDATE: (_issue) => {
     return `A newer version of DevForge is available.
 
 Run: npm install -g forgedev@latest
@@ -221,7 +221,7 @@ ${prompt}
     sessionNum++;
   }
 
-  return `# Fix Prompts — Run These in Claude Code (In Order)
+  return `# Fix Prompts - Run These in Claude Code (In Order)
 
 ${sections.join('\n')}
 Run each as a separate Claude Code session. /clear between sessions.
@@ -232,7 +232,7 @@ export function generateReport(issues, projectName) {
   const critical = issues.filter(i => i.severity === 'critical');
   const warnings = issues.filter(i => i.severity === 'warning');
   const info = issues.filter(i => i.severity === 'info');
-  let report = `# DevForge Doctor Report — ${projectName}
+  let report = `# DevForge Doctor Report - ${projectName}
 Generated: ${new Date().toISOString().split('T')[0]}
 
 ## Summary

package/src/doctor.js

@@ -9,7 +9,7 @@ import { askDoctorAction } from './prompts.js';
 
 export async function runDoctor(projectDir) {
   console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge Doctor') + chalk.dim(' — Project Health Check'));
+  console.log(chalk.bold.cyan('  🔨 DevForge Doctor') + chalk.dim('  Project Health Check'));
   console.log('');
   console.log('  Scanning...');
   console.log('');
@@ -45,7 +45,7 @@ export async function runDoctor(projectDir) {
       });
     }
   } catch {
-    // Silently ignore — network issues shouldn't block doctor
+    // Silently ignore. Network issues shouldn't block doctor
   }
 
   if (issues.length === 0) {
@@ -247,8 +247,7 @@ async function autoFixSafe(issues, projectDir) {
           fs.chmodSync(hookPath, '755');
           console.log(chalk.green(`  ✓ Fixed ${path.join('.claude/hooks', hookFile)} permissions (chmod +x)`));
           fixed++;
-        } catch {
-          // Skip
+        } catch { // Permission change failed on this hook, continue
         }
       }
     }
@@ -262,6 +261,8 @@ async function autoFixSafe(issues, projectDir) {
 
     if (!content.includes('.claude/todos')) entriesToAdd.push('.claude/todos');
     if (!content.includes('.claude/plans')) entriesToAdd.push('.claude/plans');
+    if (!content.includes('.env.local')) entriesToAdd.push('.env.local');
+    if (!content.includes('.env.*.local')) entriesToAdd.push('.env.*.local');
 
     if (entriesToAdd.length > 0) {
       const addition = '\n# Claude Code temp files\n' + entriesToAdd.join('\n') + '\n';
@@ -271,6 +272,38 @@ async function autoFixSafe(issues, projectDir) {
     }
   }
 
+  // Create missing .env.example if .env exists but no example
+  const envPath = path.join(projectDir, '.env');
+  const envExamplePath = path.join(projectDir, '.env.example');
+  if (fs.existsSync(envPath) && !fs.existsSync(envExamplePath)) {
+    const envContent = fs.readFileSync(envPath, 'utf-8');
+    const exampleContent = envContent
+      .split('\n')
+      .map(line => {
+        if (!line.includes('=') || line.startsWith('#')) return line;
+        const key = line.split('=')[0];
+        return `${key}=`;
+      })
+      .join('\n');
+    fs.writeFileSync(envExamplePath, exampleContent, 'utf-8');
+    console.log(chalk.green('  ✓ Created .env.example from .env (values stripped)'));
+    fixed++;
+  }
+
+  // Create missing CLAUDE.md for subdirectories in polyglot projects
+  const frontendDir = path.join(projectDir, 'frontend');
+  const backendDir = path.join(projectDir, 'backend');
+  if (fs.existsSync(frontendDir) && fs.existsSync(backendDir)) {
+    for (const subdir of ['frontend', 'backend']) {
+      const subdirClaudeMd = path.join(projectDir, subdir, 'CLAUDE.md');
+      if (!fs.existsSync(subdirClaudeMd)) {
+        fs.writeFileSync(subdirClaudeMd, `# ${subdir}\n\nSee root CLAUDE.md for project-level rules. This file contains ${subdir}-specific overrides.\n`, 'utf-8');
+        console.log(chalk.green(`  ✓ Created ${subdir}/CLAUDE.md (scoped)`));
+        fixed++;
+      }
+    }
+  }
+
   const skipped = issues.filter(i => !i.autoFixable).length;
 
   if (fixed === 0) {

package/src/guided.js

@@ -91,7 +91,7 @@ export function analyzeDescription(text) {
     suggestedServiceType = 'web_app';
   }
 
-  // AI service override — if AI is the primary focus
+  // AI service override: if AI is the primary focus
   if (features.includes('ai') && !features.includes('dashboard') && !features.includes('payments')) {
     suggestedServiceType = 'ai_service';
   }
@@ -114,7 +114,7 @@ export function mapFeaturesToStack(analysis) {
   return stackConfig;
 }
 
-export function buildGuidedPreview(analysis, stackConfig) {
+export function buildGuidedPreview(analysis, _stackConfig) {
   const lines = [];
 
   lines.push(chalk.bold('  What you\'ll get:'));
@@ -208,7 +208,7 @@ npm run dev`;
 
 DevForge created a starter version of your app with all the basic
 building blocks in place. Think of it like getting a house with the
-foundation, walls, and plumbing already done — you just need to
+foundation, walls, and plumbing already done. You just need to
 furnish and decorate it.
 
 ## Your Project Structure (Plain English)

package/src/index.js

@@ -2,7 +2,7 @@ import path from 'node:path';
 import fs from 'node:fs';
 import { execSync } from 'node:child_process';
 import chalk from 'chalk';
-import { log, toKebabCase } from './utils.js';
+import { log, toKebabCase, copyEnvCmd } from './utils.js';
 import { askServiceType, askRefinements, askNewMode, confirmStack } from './prompts.js';
 import { recommend } from './recommender.js';
 import { compose } from './composer.js';
@@ -12,9 +12,9 @@ import { generateUAT } from './uat-generator.js';
 export async function runNew(projectName) {
   const safeName = toKebabCase(projectName);
 
-  // Validate project name — must be a clean kebab-case identifier
-  if (!/^[a-z0-9][a-z0-9-]*$/.test(safeName)) {
-    log.error('Project name must start with a letter or number and contain only lowercase letters, numbers, and hyphens.');
+  // Validate project name. Must be a clean kebab-case identifier
+  if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(safeName)) {
+    log.error('Project name must start with a letter, contain only lowercase letters, numbers, and hyphens, and not have consecutive or trailing hyphens.');
     process.exit(1);
   }
 
@@ -26,7 +26,7 @@ export async function runNew(projectName) {
   }
 
   console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Let\'s build something.'));
+  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim('  Let\'s build something.'));
   console.log('');
 
   const mode = await askNewMode();
@@ -62,7 +62,7 @@ async function runDeveloperFlow(safeName, outputDir) {
 
 export async function scaffold(outputDir, stackConfig) {
   console.log('');
-  const totalSteps = stackConfig.claudeCode ? 4 : 3;
+  const totalSteps = stackConfig.claudeCode ? 5 : 4;
   let step = 0;
 
   step++;
@@ -79,6 +79,11 @@ export async function scaffold(outputDir, stackConfig) {
   log.step(step, totalSteps, 'Generating UAT templates...');
   await generateUAT(outputDir, stackConfig);
 
+  step++;
+  log.step(step, totalSteps, 'Initializing ChainProof trust chain...');
+  const { initChainproof } = await import('./chainproof-bridge.js');
+  initChainproof(outputDir);
+
   step++;
   log.step(step, totalSteps, 'Initializing git repository...');
   initGit(outputDir);
@@ -93,7 +98,7 @@ function initGit(outputDir) {
   try {
     execSync('git init', { cwd: outputDir, stdio: 'ignore' });
   } catch {
-    // git not available — skip silently
+    log.dim('  git not available, skipping repository initialization');
   }
 }
 
@@ -109,7 +114,7 @@ export function printNextSteps(projectName, config, isGuided = false) {
     console.log(chalk.bold('  📖 New to coding? Here\'s what to do next:'));
     console.log('    1. Open this folder in VS Code (or any code editor)');
     console.log('    2. If you have Claude Code installed, type /workflows');
-    console.log('       — it will guide you step by step');
+    console.log('       It will guide you step by step');
     console.log('    3. Or read docs/getting-started.md for a beginner-friendly walkthrough');
     console.log('');
     return;
@@ -120,7 +125,7 @@ export function printNextSteps(projectName, config, isGuided = false) {
 
   if (config.stackId === 'nextjs-fullstack') {
     console.log('    npm install');
-    console.log('    cp .env.example .env');
+    console.log(`    ${copyEnvCmd()}`);
     console.log('    npx prisma db push');
     console.log('    npm run dev');
   } else if (config.stackId === 'fastapi-backend') {
@@ -128,7 +133,7 @@ export function printNextSteps(projectName, config, isGuided = false) {
     console.log('    python -m venv venv');
     console.log('    source venv/bin/activate  # or venv\\Scripts\\activate on Windows');
     console.log('    pip install -r requirements.txt');
-    console.log('    cp .env.example .env');
+    console.log(`    ${copyEnvCmd()}`);
     console.log('    uvicorn app.main:app --reload');
   } else if (config.stackId === 'polyglot-fullstack') {
     console.log('    docker compose up -d postgres');
@@ -136,6 +141,21 @@ export function printNextSteps(projectName, config, isGuided = false) {
     console.log('    cd frontend && npm install && npm run dev');
     console.log('    # Backend:');
     console.log('    cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload');
+  } else if (config.stackId === 'react-express') {
+    console.log('    # Frontend:');
+    console.log('    cd frontend && npm install && npm run dev');
+    console.log('    # Backend (in a separate terminal):');
+    console.log(`    cd backend && npm install && ${copyEnvCmd()} && npx prisma db push && npm run dev`);
+  } else if (config.stackId === 'remix-fullstack') {
+    console.log('    npm install');
+    console.log(`    ${copyEnvCmd()}`);
+    console.log('    npx prisma db push');
+    console.log('    npm run dev');
+  } else if (config.stackId === 'hono-api') {
+    console.log('    npm install');
+    console.log(`    ${copyEnvCmd()}`);
+    console.log('    npx prisma db push');
+    console.log('    npm run dev');
   }
 
   if (config.claudeCode) {
@@ -149,6 +169,7 @@ export function printNextSteps(projectName, config, isGuided = false) {
     console.log(chalk.dim('    - .claude/commands/  (audit, verify, pre-pr)'));
     console.log(chalk.dim('    - docs/prompt-library.md'));
     console.log(chalk.dim('    - docs/uat/          (acceptance testing)'));
+    console.log(chalk.dim('    - .chainproof/       (trust chain tracking)'));
   }
 
   console.log('');

package/src/init-mode.js

@@ -1,13 +1,15 @@
 import path from 'node:path';
+import fs from 'node:fs';
 import chalk from 'chalk';
-import { log } from './utils.js';
+import { log, ROOT_DIR, ensureDir } from './utils.js';
 import { scanProject } from './scanner.js';
 import { generateClaudeConfig } from './claude-configurator.js';
 import { generateUAT } from './uat-generator.js';
+import { initChainproof } from './chainproof-bridge.js';
 
 export async function runInit(projectDir) {
   console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Adding dev guardrails'));
+  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim('  Adding dev guardrails'));
   console.log('');
   console.log('  Scanning...');
   console.log('');
@@ -54,35 +56,47 @@ export async function runInit(projectDir) {
   await generateClaudeConfig(projectDir, stackConfig, { skipClaudeMd, mergeSettings });
 
   if (!skipClaudeMd) {
-    console.log(chalk.green('  ✓ ') + 'CLAUDE.md — project context + rules');
+    console.log(chalk.green('  ✓ ') + 'CLAUDE.md (project context + rules)');
   } else {
-    console.log(chalk.yellow('  ⊘ ') + `CLAUDE.md — exists (tip: run ${chalk.cyan('/optimize-claude-md')} to slim it)`);
+    console.log(chalk.yellow('  ⊘ ') + `CLAUDE.md already exists (tip: run ${chalk.cyan('/optimize-claude-md')} to slim it)`);
   }
 
   if (!scan.infrastructure.hasHooks) {
-    console.log(chalk.green('  ✓ ') + '.claude/hooks/ — auto-lint, quality gate, file protection');
+    console.log(chalk.green('  ✓ ') + '.claude/hooks/ (auto-lint, quality gate, file protection)');
   } else {
-    console.log(chalk.yellow('  ⊘ ') + '.claude/hooks/ — already configured');
+    console.log(chalk.yellow('  ⊘ ') + '.claude/hooks/ already configured');
   }
 
   if (!scan.infrastructure.hasAgents) {
-    console.log(chalk.green('  ✓ ') + '.claude/agents/ — code quality, security, spec validator');
+    console.log(chalk.green('  ✓ ') + '.claude/agents/ (code quality, security, spec validator)');
   }
   if (!scan.infrastructure.hasCommands) {
-    console.log(chalk.green('  ✓ ') + '.claude/commands/ — help, status, next, done, audit, pre-pr');
+    console.log(chalk.green('  ✓ ') + '.claude/commands/ (help, status, next, done, audit, pre-pr)');
   }
   if (!scan.infrastructure.hasSkills) {
-    console.log(chalk.green('  ✓ ') + '.claude/skills/ — framework-specific knowledge');
+    console.log(chalk.green('  ✓ ') + '.claude/skills/ (framework-specific knowledge)');
   }
 
   // Generate UAT templates
   if (!scan.infrastructure.hasUAT) {
     await generateUAT(projectDir, stackConfig);
-    console.log(chalk.green('  ✓ ') + 'docs/uat/ — acceptance test templates');
+    console.log(chalk.green('  ✓ ') + 'docs/uat/ (acceptance test templates)');
   } else {
-    console.log(chalk.yellow('  ⊘ ') + 'docs/uat/ — already exists');
+    console.log(chalk.yellow('  ⊘ ') + 'docs/uat/ already exists');
   }
 
+  // Initialize ChainProof trust chain
+  const chainproofDir = path.join(projectDir, '.chainproof');
+  if (!fs.existsSync(chainproofDir)) {
+    initChainproof(projectDir);
+    console.log(chalk.green('  ✓ ') + '.chainproof/ (trust chain initialized)');
+  } else {
+    console.log(chalk.yellow('  ⊘ ') + '.chainproof/ already exists');
+  }
+
+  // Install ChainProof MCP server and configure .mcp.json
+  setupChainproofMcp(projectDir);
+
   console.log('');
   log.success('  Done. Your project is now configured for Claude Code.');
   console.log('');
@@ -136,3 +150,42 @@ export function buildConfigFromScan(scan) {
 
   return config;
 }
+
+export function setupChainproofMcp(projectDir) {
+  // Copy MCP server script into .chainproof/
+  const serverSrc = path.join(ROOT_DIR, 'templates', 'chainproof', 'base', '.chainproof', 'mcp-server.mjs');
+  const serverDest = path.join(projectDir, '.chainproof', 'mcp-server.mjs');
+  if (fs.existsSync(serverSrc) && !fs.existsSync(serverDest)) {
+    ensureDir(path.dirname(serverDest));
+    fs.copyFileSync(serverSrc, serverDest);
+  }
+
+  // Configure .mcp.json (merge if exists)
+  const mcpPath = path.join(projectDir, '.mcp.json');
+  const chainproofMcpEntry = {
+    command: 'node',
+    args: ['.chainproof/mcp-server.mjs'],
+    env: {},
+  };
+
+  if (fs.existsSync(mcpPath)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(mcpPath, 'utf-8'));
+      existing.mcpServers = existing.mcpServers || {};
+      if (!existing.mcpServers.chainproof) {
+        existing.mcpServers.chainproof = chainproofMcpEntry;
+        fs.writeFileSync(mcpPath, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+        console.log(chalk.green('  ✓ ') + '.mcp.json (added ChainProof server)');
+      } else {
+        console.log(chalk.yellow('  ⊘ ') + '.mcp.json already has ChainProof configured');
+      }
+    } catch {
+      // Corrupted .mcp.json, don't touch it
+      console.log(chalk.yellow('  ⊘ ') + '.mcp.json exists but could not be parsed');
+    }
+  } else {
+    const mcpConfig = { mcpServers: { chainproof: chainproofMcpEntry } };
+    fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf-8');
+    console.log(chalk.green('  ✓ ') + '.mcp.json (ChainProof MCP auto-configured)');
+  }
+}

package/src/menu.js

@@ -0,0 +1,178 @@
+import { select, input, Separator } from '@inquirer/prompts';
+import chalk from 'chalk';
+import fs from 'node:fs';
+
+const COMMAND_GROUPS = [
+  {
+    name: 'Getting Started',
+    commands: [
+      { value: 'new', label: 'Create a new project', description: 'Scaffold a full project with AI-powered stack selection' },
+      { value: 'init', label: 'Add guardrails to existing project', description: 'Install hooks, agents, and commands into your current codebase' },
+    ],
+  },
+  {
+    name: 'Daily Workflow',
+    commands: [
+      { value: 'status', label: '/status', description: 'Run all checks and show a project dashboard' },
+      { value: 'next', label: '/next', description: 'Figure out what to work on next' },
+      { value: 'done', label: '/done', description: 'Verify current task is actually complete before moving on' },
+      { value: 'help', label: '/help', description: 'Not sure what to do? Get guided to the right workflow' },
+    ],
+  },
+  {
+    name: 'Development',
+    commands: [
+      { value: 'plan', label: '/plan', description: 'Create a comprehensive implementation plan before writing code' },
+      { value: 'tdd', label: '/tdd', description: 'Write failing tests first, then implement (test-driven)' },
+      { value: 'build-fix', label: '/build-fix', description: 'Fix build, lint, and type errors with minimal changes' },
+      { value: 'build-ui', label: '/build-ui', description: 'Build frontend UI components with AI-powered generation' },
+      { value: 'code-review', label: '/code-review', description: 'Review uncommitted changes for issues and quality' },
+      { value: 'simplify', label: '/simplify', description: 'Find duplicate code, long files, and extract shared utilities' },
+    ],
+  },
+  {
+    name: 'Verification',
+    commands: [
+      { value: 'verify-all', label: '/verify-all', description: 'Run the full verification chain on current changes' },
+      { value: 'full-audit', label: '/full-audit', description: 'Run every audit and review agent in a single pass' },
+      { value: 'audit-spec', label: '/audit-spec', description: 'Validate code against the specification' },
+      { value: 'audit-wiring', label: '/audit-wiring', description: 'Verify API endpoints are wired between frontend and backend' },
+      { value: 'audit-security', label: '/audit-security', description: 'Run a focused security audit on changed files' },
+      { value: 'verify-intent', label: '/verify-intent', description: 'Check Intent Verification Protocol compliance' },
+    ],
+  },
+  {
+    name: 'Release',
+    commands: [
+      { value: 'pre-pr', label: '/pre-pr', description: 'Run the complete pre-PR checklist before creating a pull request' },
+      { value: 'run-uat', label: '/run-uat', description: 'Execute UAT verification against test scenarios' },
+      { value: 'live-uat', label: '/live-uat', description: 'Run live UAT by interacting with the running application' },
+    ],
+  },
+  {
+    name: 'Generation',
+    commands: [
+      { value: 'generate-prd', label: '/generate-prd', description: 'Generate a Product Requirements Document' },
+      { value: 'generate-sdd', label: '/generate-sdd', description: 'Generate a Software Design Document from the codebase' },
+      { value: 'generate-uat', label: '/generate-uat', description: 'Generate UAT test scenarios for the project' },
+      { value: 'optimize-claude-md', label: '/optimize-claude-md', description: 'Analyze and optimize the CLAUDE.md file' },
+    ],
+  },
+  {
+    name: 'Session',
+    commands: [
+      { value: 'save-session', label: '/save-session', description: 'Save current session state for later' },
+      { value: 'resume-session', label: '/resume-session', description: 'Load a saved session and pick up where you left off' },
+    ],
+  },
+  {
+    name: 'Project Tools',
+    commands: [
+      { value: 'doctor', label: 'Diagnose project', description: 'Find and fix issues like dead code, flaky tests, oversized files' },
+      { value: 'ci', label: 'CI health check', description: 'Non-interactive health checks for CI/CD pipelines' },
+      { value: 'update', label: 'Check for updates', description: 'See if a newer version of DevForge is available' },
+    ],
+  },
+];
+
+// Commands that are Claude Code slash commands (run inside Claude Code, not the terminal)
+const CLAUDE_COMMANDS = new Set([
+  'status', 'next', 'done', 'help', 'plan', 'tdd', 'build-fix', 'build-ui',
+  'code-review', 'simplify', 'verify-all', 'full-audit', 'audit-spec', 'generate-sdd',
+  'audit-wiring', 'audit-security', 'verify-intent', 'pre-pr', 'run-uat',
+  'live-uat', 'generate-prd', 'generate-uat', 'optimize-claude-md',
+  'save-session', 'resume-session',
+]);
+
+export async function showInteractiveMenu() {
+  console.log('');
+  console.log(`  ${chalk.bold.cyan('DevForge')}  ${chalk.dim('AI-first project scaffolding')}`);
+  console.log('');
+
+  // Build choices with separators for groups
+  const choices = [];
+  let recommendation = null;
+
+  // Detect recommendation based on project state
+  try {
+    if (!fs.existsSync('package.json') && !fs.existsSync('pyproject.toml')) {
+      recommendation = 'new';
+    } else if (!fs.existsSync('.claude')) {
+      recommendation = 'init';
+    }
+  } catch { /* ignore */ }
+
+  for (const group of COMMAND_GROUPS) {
+    choices.push(new Separator(chalk.dim(`  ${group.name}`)));
+    for (const cmd of group.commands) {
+      const isRecommended = cmd.value === recommendation;
+      const badge = isRecommended ? chalk.green(' recommended') : '';
+      const label = CLAUDE_COMMANDS.has(cmd.value)
+        ? chalk.cyan(cmd.label)
+        : chalk.bold(cmd.label);
+
+      choices.push({
+        value: cmd.value,
+        name: `${label}${badge}  ${chalk.dim(cmd.description)}`,
+      });
+    }
+  }
+
+  const selected = await select({
+    message: 'What would you like to do?',
+    choices,
+    pageSize: 15,
+    loop: false,
+  });
+
+  return selected;
+}
+
+export async function handleMenuSelection(selected) {
+  // CLI commands — execute directly
+  if (selected === 'new') {
+    const name = await input({ message: 'Project name:' });
+    if (!name) return;
+    const { runNew } = await import('./index.js');
+    await runNew(name);
+    return;
+  }
+
+  if (selected === 'init') {
+    const { runInit } = await import('./init-mode.js');
+    await runInit(process.cwd());
+    return;
+  }
+
+  if (selected === 'doctor') {
+    const { runDoctor } = await import('./doctor.js');
+    await runDoctor(process.cwd());
+    return;
+  }
+
+  if (selected === 'ci') {
+    const { runCI } = await import('./ci-mode.js');
+    await runCI(process.cwd());
+    return;
+  }
+
+  if (selected === 'update') {
+    const { runUpdate } = await import('./update.js');
+    await runUpdate();
+    return;
+  }
+
+  // Claude Code commands — show how to run them
+  if (CLAUDE_COMMANDS.has(selected)) {
+    console.log('');
+    console.log(`  ${chalk.cyan('/')}${chalk.bold.cyan(selected)} is a Claude Code command.`);
+    console.log('');
+    console.log(`  To use it, open ${chalk.bold('Claude Code')} in your project and type:`);
+    console.log(`  ${chalk.green(`/${selected}`)}`);
+    console.log('');
+    console.log(`  ${chalk.dim('These commands work inside Claude Code (the AI assistant).')}`);
+    console.log(`  ${chalk.dim('They run agents that analyze, review, and modify your code.')}`);
+    console.log('');
+    return;
+  }
+}

package/src/prompts.js

@@ -21,19 +21,12 @@ const LANGUAGE_CHOICES = [
   { value: 'rust', name: 'Rust' },
 ];
 
-const DEPLOYMENT_CHOICES = [
-  { value: 'docker', name: 'Docker / Docker Compose' },
-  { value: 'vercel', name: 'Vercel' },
-  { value: 'aws', name: 'AWS' },
-  { value: 'gcp', name: 'Google Cloud' },
-];
-
 export async function askNewMode() {
   const mode = await select({
     message: 'How would you like to start?',
     choices: [
       { value: 'guided', name: '💬 Describe what you want to build (recommended for beginners)' },
-      { value: 'developer', name: '⚡ I know my stack — let me pick (for developers)' },
+      { value: 'developer', name: '⚡ I know my stack, let me pick (for developers)' },
     ],
   });
   return mode;
@@ -41,7 +34,7 @@ export async function askNewMode() {
 
 export async function askDescription() {
   const description = await input({
-    message: 'Tell me about what you want to build.\n  Don\'t worry about technical details — just describe it like you\'re explaining it to a friend.\n\n ',
+    message: 'Tell me about what you want to build.\n  Don\'t worry about technical details. Just describe it like you\'re explaining it to a friend.\n\n ',
   });
   return description;
 }
@@ -57,8 +50,8 @@ export async function askGuidedConfirm() {
   const choice = await select({
     message: 'Sound right?',
     choices: [
-      { value: 'yes', name: 'Yes — create it!' },
-      { value: 'adjust', name: 'No — let me adjust' },
+      { value: 'yes', name: 'Yes, create it!' },
+      { value: 'adjust', name: 'No, let me adjust' },
     ],
   });
   return choice;
@@ -88,7 +81,7 @@ export async function askServiceType() {
 export async function askRefinements(serviceType) {
   const refinements = {};
 
-  // Q1: Language preference — adapt choices based on service type
+  // Q1: Language preference. Adapt choices based on service type
   if (['api_service', 'cli_tool', 'microservice'].includes(serviceType)) {
     refinements.language = await select({
       message: 'Language preference?',