ultra-dex 2.2.0 → 3.1.0

package/bin/ultra-dex.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 
-import { Command } from 'commander';
 import { Command } from 'commander';
 
 import { banner } from '../lib/commands/banner.js';
@@ -8,14 +7,38 @@ import { registerInitCommand } from '../lib/commands/init.js';
 import { registerAuditCommand } from '../lib/commands/audit.js';
 import { registerExamplesCommand } from '../lib/commands/examples.js';
 import { registerAgentsCommand, registerPackCommand } from '../lib/commands/agents.js';
-import { registerPlaceholderCommands } from '../lib/commands/placeholders.js';
+import { registerAgentBuilderCommand } from '../lib/commands/agent-builder.js';
+import { registerGenerateCommand } from '../lib/commands/generate.js';
+import { registerBuildCommand } from '../lib/commands/build.js';
+import { registerReviewCommand } from '../lib/commands/review.js';
+import { registerRunCommand, registerSwarmCommand } from '../lib/commands/run.js';
+import { registerAutoImplementCommand } from '../lib/commands/auto-implement.js';
+import { registerCiMonitorCommand } from '../lib/commands/ci-monitor.js';
+import { registerAlignCommand, registerStatusCommand, registerPreCommitCommand, registerStateCommand } from '../lib/commands/state.js';
+import { registerDoctorCommand } from '../lib/commands/doctor.js';
+import { registerDashboardCommand } from '../lib/commands/dashboard.js';
+import { registerCheckCommand } from '../lib/commands/advanced.js';
 import { registerServeCommand } from '../lib/commands/serve.js';
+import { registerVerifyCommand } from '../lib/commands/verify.js';
+
+// v3.0 Commands
+import { swarmCommand } from '../lib/commands/swarm.js';
+import { watchCommand } from '../lib/commands/watch.js';
+import { diffCommand } from '../lib/commands/diff.js';
+import { exportCommand } from '../lib/commands/export.js';
+import { upgradeCommand } from '../lib/commands/upgrade.js';
+import { configCommand } from '../lib/commands/config.js';
+
 import { registerWorkflowCommand } from '../lib/commands/workflows.js';
+import { registerPlanCommand } from '../lib/commands/plan.js';
 import { registerSuggestCommand } from '../lib/commands/suggest.js';
 import { registerValidateCommand } from '../lib/commands/validate.js';
+import { registerFixCommand } from '../lib/commands/fix.js';
 import { registerHooksCommand } from '../lib/commands/hooks.js';
 import { registerFetchCommand } from '../lib/commands/fetch.js';
 import { registerSyncCommand } from '../lib/commands/sync.js';
+import { registerTeamCommand } from '../lib/commands/team.js';
+import { registerMemoryCommand } from '../lib/commands/memory.js';
 
 const program = new Command();
 program.banner = banner;
@@ -23,2111 +46,85 @@ program.banner = banner;
 program
   .name('ultra-dex')
   .description('CLI for Ultra-Dex SaaS Implementation Framework')
-  .version('2.0.1');
+  .version('3.1.0');
 
 registerInitCommand(program);
 registerAuditCommand(program);
 registerExamplesCommand(program);
 registerAgentsCommand(program);
-registerPlaceholderCommands(program);
+registerGenerateCommand(program);
+registerBuildCommand(program);
+registerReviewCommand(program);
+registerRunCommand(program);
+
+// v3.0 Commands
+program
+  .command('swarm <task>')
+  .description('Run autonomous agent pipeline')
+  .option('--dry-run', 'Show pipeline without executing')
+  .option('--parallel', 'Run implementation tier agents in parallel')
+  .action(swarmCommand);
+
+program
+  .command('watch')
+  .description('Auto-update state on file changes')
+  .option('--interval <ms>', 'Debounce interval in milliseconds', '500')
+  .action(watchCommand);
+
+program
+  .command('diff')
+  .description('Compare plan vs implemented code')
+  .option('--json', 'Output as JSON')
+  .action(diffCommand);
+
+program
+  .command('export')
+  .description('Export project context')
+  .option('--format <type>', 'Output format: json, html, markdown, pdf', 'json')
+  .option('--output <path>', 'Output file path')
+  .option('--include-agents', 'Bundle all agent prompts')
+  .action(exportCommand);
+
+program
+  .command('upgrade')
+  .description('Check for CLI updates')
+  .option('--check', 'Check only, do not show install instructions')
+  .option('--install', 'Automatically install latest version')
+  .action(upgradeCommand);
+
+program
+  .command('config')
+  .description('Show or generate configuration')
+  .option('--mcp', 'Generate MCP config for Claude Desktop')
+  .option('--cursor', 'Generate Cursor IDE rules')
+  .option('--vscode', 'Generate VS Code settings.json')
+  .option('--show', 'Display current Ultra-Dex config')
+  .option('--set <key=value>', 'Set a config value')
+  .option('--get <key>', 'Get a specific config value')
+  .action(configCommand);
+
+registerAutoImplementCommand(program);
+registerCiMonitorCommand(program);
+registerAlignCommand(program);
+registerStatusCommand(program);
+registerPreCommitCommand(program);
+registerStateCommand(program);
+registerDoctorCommand(program);
+registerDashboardCommand(program);
+registerCheckCommand(program);
 registerServeCommand(program);
+registerVerifyCommand(program);
 registerPackCommand(program);
 registerWorkflowCommand(program);
+registerPlanCommand(program);
 registerSuggestCommand(program);
 registerValidateCommand(program);
+registerFixCommand(program);
 registerHooksCommand(program);
 registerFetchCommand(program);
 registerSyncCommand(program);
+registerAgentBuilderCommand(program);
+registerTeamCommand(program);
+registerMemoryCommand(program);
 
-program
-  .command('audit')
-  .description('Audit your Ultra-Dex project for completeness')
-  .option('-d, --dir <directory>', 'Project directory to audit', '.')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n🔍 Ultra-Dex Project Audit\n'));
-
-    const projectDir = path.resolve(options.dir);
-    let score = 0;
-    let maxScore = 0;
-    const results = [];
-
-    // Helper function to check file exists and has content
-    async function checkFile(filePath, description, points) {
-      maxScore += points;
-      try {
-        const content = await fs.readFile(path.join(projectDir, filePath), 'utf-8');
-        if (content.length > 50) {
-          score += points;
-          results.push({ status: '✅', item: description, points: `+${points}` });
-          return content;
-        } else {
-          results.push({ status: '⚠️', item: `${description} (empty/too short)`, points: '0' });
-          return null;
-        }
-      } catch {
-        results.push({ status: '❌', item: `${description} (missing)`, points: '0' });
-        return null;
-      }
-    }
-
-    // Helper to check content has section
-    function hasSection(content, sectionName, points) {
-      maxScore += points;
-      if (content && content.toLowerCase().includes(sectionName.toLowerCase())) {
-        score += points;
-        results.push({ status: '✅', item: `Has ${sectionName}`, points: `+${points}` });
-        return true;
-      } else {
-        results.push({ status: '❌', item: `Missing ${sectionName}`, points: '0' });
-        return false;
-      }
-    }
-
-    // Check core files
-    console.log(chalk.bold('Checking project files...\n'));
-
-    const quickStart = await checkFile('QUICK-START.md', 'QUICK-START.md', 10);
-    const context = await checkFile('CONTEXT.md', 'CONTEXT.md', 5);
-    const implPlan = await checkFile('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md', 5);
-    const fullTemplate = await checkFile('04-Imp-Template.md', '04-Imp-Template.md', 10);
-
-    // Check for alternative file names
-    const readme = await checkFile('README.md', 'README.md', 5);
-
-    // Check content quality if QUICK-START exists
-    if (quickStart) {
-      hasSection(quickStart, 'idea', 5);
-      hasSection(quickStart, 'problem', 5);
-      hasSection(quickStart, 'mvp', 5);
-      hasSection(quickStart, 'tech stack', 10);
-      hasSection(quickStart, 'feature', 5);
-    }
-
-    // Check for implementation details
-    if (implPlan) {
-      hasSection(implPlan, 'database', 5);
-      hasSection(implPlan, 'api', 5);
-      hasSection(implPlan, 'auth', 5);
-    }
-
-    // Check for docs folder
-    try {
-      await fs.access(path.join(projectDir, 'docs'));
-      score += 5;
-      maxScore += 5;
-      results.push({ status: '✅', item: 'docs/ folder exists', points: '+5' });
-    } catch {
-      maxScore += 5;
-      results.push({ status: '⚠️', item: 'docs/ folder (optional)', points: '0' });
-    }
-
-    // Print results
-    console.log(chalk.bold('Audit Results:\n'));
-    results.forEach(r => {
-      const statusColor = r.status === '✅' ? chalk.green : r.status === '❌' ? chalk.red : chalk.yellow;
-      console.log(`  ${statusColor(r.status)} ${r.item} ${chalk.gray(r.points)}`);
-    });
-
-    // Calculate percentage
-    const percentage = Math.round((score / maxScore) * 100);
-
-    console.log('\n' + chalk.bold('─'.repeat(50)));
-    console.log(chalk.bold(`\nScore: ${score}/${maxScore} (${percentage}%)\n`));
-
-    // Grade
-    let grade, gradeColor, message;
-    if (percentage >= 90) {
-      grade = 'A';
-      gradeColor = chalk.green;
-      message = 'Excellent! Your project is well-documented.';
-    } else if (percentage >= 75) {
-      grade = 'B';
-      gradeColor = chalk.green;
-      message = 'Good! A few more sections would help.';
-    } else if (percentage >= 60) {
-      grade = 'C';
-      gradeColor = chalk.yellow;
-      message = 'Fair. Consider filling more sections before coding.';
-    } else if (percentage >= 40) {
-      grade = 'D';
-      gradeColor = chalk.yellow;
-      message = 'Needs work. Use QUICK-START.md to define your project.';
-    } else {
-      grade = 'F';
-      gradeColor = chalk.red;
-      message = 'Run "npx ultra-dex init" to get started properly.';
-    }
-
-    console.log(gradeColor(`Grade: ${grade}`));
-    console.log(chalk.gray(message));
-
-    // Suggestions
-    const missing = results.filter(r => r.status === '❌');
-    if (missing.length > 0) {
-      console.log(chalk.bold('\n📋 To improve your score:\n'));
-      missing.slice(0, 5).forEach(m => {
-        console.log(chalk.cyan(`  → Add ${m.item.replace(' (missing)', '')}`));
-      });
-    }
-
-    console.log('\n' + chalk.gray('Learn more: https://github.com/Srujan0798/Ultra-Dex\n'));
-  });
-
-program
-  .command('examples')
-  .description('List available examples')
-  .action(() => {
-    console.log(chalk.bold('\nAvailable Ultra-Dex Examples:\n'));
-
-    const examples = [
-      {
-        name: 'TaskFlow',
-        type: 'Task Management',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md',
-      },
-      {
-        name: 'InvoiceFlow',
-        type: 'Invoicing',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/InvoiceFlow-Complete.md',
-      },
-      {
-        name: 'HabitStack',
-        type: 'Habit Tracking',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/HabitStack-Complete.md',
-      },
-    ];
-
-    examples.forEach((ex, i) => {
-      console.log(chalk.cyan(`${i + 1}. ${ex.name}`) + chalk.gray(` (${ex.type})`));
-      console.log(chalk.gray(`   ${ex.url}\n`));
-    });
-  });
-
-// Agent definitions (organized by tier)
-const AGENTS = [
-  // Leadership Tier
-  { name: 'cto', description: 'Architecture & tech decisions', file: '1-leadership/cto.md', tier: 'Leadership' },
-  { name: 'planner', description: 'Task breakdown & planning', file: '1-leadership/planner.md', tier: 'Leadership' },
-  { name: 'research', description: 'Technology evaluation & comparison', file: '1-leadership/research.md', tier: 'Leadership' },
-  // Development Tier
-  { name: 'backend', description: 'API & server logic', file: '2-development/backend.md', tier: 'Development' },
-  { name: 'database', description: 'Schema design & queries', file: '2-development/database.md', tier: 'Development' },
-  { name: 'frontend', description: 'UI & components', file: '2-development/frontend.md', tier: 'Development' },
-  // Security Tier
-  { name: 'auth', description: 'Authentication & authorization', file: '3-security/auth.md', tier: 'Security' },
-  { name: 'security', description: 'Security audits & vulnerability fixes', file: '3-security/security.md', tier: 'Security' },
-  // DevOps Tier
-  { name: 'devops', description: 'Deployment & infrastructure', file: '4-devops/devops.md', tier: 'DevOps' },
-  // Quality Tier
-  { name: 'debugger', description: 'Bug fixing & troubleshooting', file: '5-quality/debugger.md', tier: 'Quality' },
-  { name: 'documentation', description: 'Technical writing & docs maintenance', file: '5-quality/documentation.md', tier: 'Quality' },
-  { name: 'reviewer', description: 'Code review & quality check', file: '5-quality/reviewer.md', tier: 'Quality' },
-  { name: 'testing', description: 'QA & test automation', file: '5-quality/testing.md', tier: 'Quality' },
-  // Specialist Tier
-  { name: 'performance', description: 'Performance optimization', file: '6-specialist/performance.md', tier: 'Specialist' },
-  { name: 'refactoring', description: 'Code quality & design patterns', file: '6-specialist/refactoring.md', tier: 'Specialist' },
-];
-
-program
-  .command('agents')
-  .description('List available AI agent prompts')
-  .action(() => {
-    console.log(chalk.bold('\n🤖 Ultra-Dex AI Agents (15 Total)\n'));
-    console.log(chalk.gray('Organized by tier for production pipeline\n'));
-
-    let currentTier = '';
-    AGENTS.forEach((agent) => {
-      if (agent.tier !== currentTier) {
-        currentTier = agent.tier;
-        console.log(chalk.bold(`\n  ${currentTier} Tier:`));
-      }
-      console.log(chalk.cyan(`    ${agent.name}`) + chalk.gray(` - ${agent.description}`));
-    });
-
-    console.log('\n' + chalk.bold('Usage:'));
-    console.log(chalk.gray('  ultra-dex agent <name>   Show agent prompt'));
-    console.log(chalk.gray('  ultra-dex agent backend  Example: show backend agent'));
-
-    console.log('\n' + chalk.gray('Agent Index: https://github.com/Srujan0798/Ultra-Dex/blob/main/agents/00-AGENT_INDEX.md\n'));
-  });
-
-// ========================================
-// GENERATE COMMAND - AI-Powered Plan Generation (v2.0)
-// ========================================
-const GENERATE_PROVIDERS = {
-  claude: {
-    name: 'Claude (Anthropic)',
-    envKey: 'ANTHROPIC_API_KEY',
-    model: 'claude-sonnet-4-20250514',
-    endpoint: 'https://api.anthropic.com/v1/messages'
-  },
-  openai: {
-    name: 'GPT-4 (OpenAI)',
-    envKey: 'OPENAI_API_KEY', 
-    model: 'gpt-4o',
-    endpoint: 'https://api.openai.com/v1/chat/completions'
-  },
-  gemini: {
-    name: 'Gemini (Google)',
-    envKey: 'GOOGLE_AI_KEY',
-    model: 'gemini-2.0-flash',
-    endpoint: 'https://generativelanguage.googleapis.com/v1beta/models'
-  }
-};
-
-const GENERATE_SECTIONS = [
-  '1. Project Identity', '2. Vision & Problem', '3. Target Users', '4. Core Value Proposition',
-  '5. Feature Set (MVP)', '6. Feature Set (Future)', '7. User Journeys', '8. Tech Stack',
-  '9. System Architecture', '10. Database Schema', '11. API Design', '12. Authentication',
-  '13. Security Requirements', '14. Performance Requirements', '15. UI/UX Guidelines',
-  '16. Component Library', '17. State Management', '18. Error Handling', '19. Testing Strategy',
-  '20. CI/CD Pipeline', '21. Deployment Strategy', '22. Monitoring & Logging', '23. Cost Estimation',
-  '24. Timeline & Milestones', '25. Team Structure', '26. Risk Assessment', '27. Compliance',
-  '28. Documentation Plan', '29. Launch Checklist', '30. Success Metrics', '31. Scaling Plan',
-  '32. Support Strategy', '33. Iteration Roadmap', '34. Project Metadata'
-];
-
-const GENERATE_SYSTEM_PROMPT = `You are an expert SaaS architect. Generate a comprehensive implementation plan.
-
-For the given idea, create detailed content for ALL 34 sections:
-${GENERATE_SECTIONS.map(s => `- ${s}`).join('\n')}
-
-Output format - use EXACTLY this markdown structure:
-## 1. Project Identity
-[content]
-
-## 2. Vision & Problem
-[content]
-
-... continue for all 34 sections ...
-
-Be specific, actionable, and production-ready. Include real code examples, database schemas, API endpoints.`;
-
-async function generateWithClaude(idea, apiKey, model) {
-  const response = await fetch('https://api.anthropic.com/v1/messages', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'x-api-key': apiKey,
-      'anthropic-version': '2023-06-01'
-    },
-    body: JSON.stringify({
-      model: model,
-      max_tokens: 8192,
-      messages: [{ role: 'user', content: `${GENERATE_SYSTEM_PROMPT}\n\nIdea: ${idea}` }]
-    })
-  });
-  if (!response.ok) throw new Error(`Claude API error: ${response.status}`);
-  const data = await response.json();
-  return data.content[0].text;
-}
-
-async function generateWithOpenAI(idea, apiKey, model) {
-  const response = await fetch('https://api.openai.com/v1/chat/completions', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      'Authorization': `Bearer ${apiKey}`
-    },
-    body: JSON.stringify({
-      model: model,
-      messages: [
-        { role: 'system', content: GENERATE_SYSTEM_PROMPT },
-        { role: 'user', content: `Idea: ${idea}` }
-      ],
-      max_tokens: 8192
-    })
-  });
-  if (!response.ok) throw new Error(`OpenAI API error: ${response.status}`);
-  const data = await response.json();
-  return data.choices[0].message.content;
-}
-
-async function generateWithGemini(idea, apiKey, model) {
-  const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
-  const response = await fetch(url, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      contents: [{ parts: [{ text: `${GENERATE_SYSTEM_PROMPT}\n\nIdea: ${idea}` }] }],
-      generationConfig: { maxOutputTokens: 8192 }
-    })
-  });
-  if (!response.ok) throw new Error(`Gemini API error: ${response.status}`);
-  const data = await response.json();
-  return data.candidates[0].content.parts[0].text;
-}
-
-program
-  .command('generate')
-  .description('Generate a full implementation plan from an idea using AI')
-  .argument('[idea]', 'Your SaaS idea in one sentence')
-  .option('-p, --provider <provider>', 'AI provider: claude, openai, gemini', 'claude')
-  .option('-m, --model <model>', 'Specific model to use')
-  .option('-o, --output <dir>', 'Output directory', '.')
-  .option('-k, --key <key>', 'API key (or use environment variable)')
-  .option('--dry-run', 'Show what would be generated without calling AI')
-  .action(async (idea, options) => {
-    console.log(chalk.cyan('\n' + banner));
-    console.log(chalk.bold.green('✨ Ultra-Dex Generate - AI-Powered Plan Creation\n'));
-
-    // Get idea if not provided
-    if (!idea) {
-      const response = await inquirer.prompt([{
-        type: 'input',
-        name: 'idea',
-        message: 'Describe your SaaS idea in one sentence:',
-        validate: (input) => input.length > 10 || 'Please provide more detail'
-      }]);
-      idea = response.idea;
-    }
-
-    console.log(chalk.gray(`\nIdea: "${idea}"\n`));
-
-    // Validate provider
-    const provider = options.provider.toLowerCase();
-    if (!GENERATE_PROVIDERS[provider]) {
-      console.log(chalk.red(`Unknown provider: ${provider}`));
-      console.log(chalk.gray(`Available: ${Object.keys(GENERATE_PROVIDERS).join(', ')}`));
-      return;
-    }
-
-    const providerConfig = GENERATE_PROVIDERS[provider];
-    const apiKey = options.key || process.env[providerConfig.envKey];
-    const model = options.model || providerConfig.model;
-
-    if (!apiKey && !options.dryRun) {
-      console.log(chalk.red(`\n❌ No API key found for ${providerConfig.name}`));
-      console.log(chalk.gray(`Set ${providerConfig.envKey} environment variable or use --key flag`));
-      return;
-    }
-
-    console.log(chalk.cyan(`Provider: ${providerConfig.name}`));
-    console.log(chalk.cyan(`Model: ${model}`));
-    console.log(chalk.cyan(`Output: ${options.output}\n`));
-
-    if (options.dryRun) {
-      console.log(chalk.yellow('🔍 Dry run mode - showing plan structure:\n'));
-      GENERATE_SECTIONS.forEach((section, i) => {
-        console.log(chalk.gray(`  ${section}`));
-      });
-      console.log(chalk.green('\n✓ Would generate IMPLEMENTATION-PLAN.md with all 34 sections'));
-      return;
-    }
-
-    const spinner = ora('Generating implementation plan...').start();
-
-    try {
-      let result;
-      spinner.text = `Calling ${providerConfig.name} API...`;
-
-      if (provider === 'claude') {
-        result = await generateWithClaude(idea, apiKey, model);
-      } else if (provider === 'openai') {
-        result = await generateWithOpenAI(idea, apiKey, model);
-      } else if (provider === 'gemini') {
-        result = await generateWithGemini(idea, apiKey, model);
-      }
-
-      spinner.succeed('AI generation complete!');
-
-      // Create output files
-      const outputDir = path.resolve(options.output);
-      await fs.mkdir(outputDir, { recursive: true });
-
-      // Write IMPLEMENTATION-PLAN.md
-      const planPath = path.join(outputDir, 'IMPLEMENTATION-PLAN.md');
-      const planContent = `# Implementation Plan
-
-> Generated by Ultra-Dex AI • ${new Date().toISOString().split('T')[0]}
-> Idea: "${idea}"
-
----
-
-${result}
-`;
-      await fs.writeFile(planPath, planContent);
-      console.log(chalk.green(`\n✓ Created: ${planPath}`));
-
-      // Write QUICK-START.md  
-      const quickStartPath = path.join(outputDir, 'QUICK-START.md');
-      const quickStartContent = `# Quick Start Guide
-
-> Generated from: ${idea}
-
-## Getting Started
-
-1. Review \`IMPLEMENTATION-PLAN.md\` for full architecture
-2. Run \`ultra-dex build\` to start development with AI assistance
-3. Use \`ultra-dex review\` to check implementation against plan
-
-## Next Steps
-
-\`\`\`bash
-# Start building with AI assistance
-ultra-dex build --agent planner
-
-# Review your progress
-ultra-dex review
-\`\`\`
-
----
-*Generated by Ultra-Dex v2.1.0*
-`;
-      await fs.writeFile(quickStartPath, quickStartContent);
-      console.log(chalk.green(`✓ Created: ${quickStartPath}`));
-
-      console.log(chalk.bold.green('\n🎉 Plan generation complete!'));
-      console.log(chalk.gray('Next: Review the plan and run `ultra-dex build` to start development\n'));
-
-    } catch (error) {
-      spinner.fail('Generation failed');
-      console.log(chalk.red(`\nError: ${error.message}`));
-      if (error.message.includes('401')) {
-        console.log(chalk.yellow('Check your API key is valid'));
-      }
-    }
-  });
-
-// ========================================
-// BUILD COMMAND - AI-Assisted Development (v2.1)
-// ========================================
-const BUILD_AGENTS = {
-  planner: { name: '@Planner', tier: 'Leadership', task: 'Break down features into atomic tasks' },
-  cto: { name: '@CTO', tier: 'Leadership', task: 'Architecture decisions' },
-  backend: { name: '@Backend', tier: 'Development', task: 'API endpoints and business logic' },
-  frontend: { name: '@Frontend', tier: 'Development', task: 'UI components and pages' },
-  database: { name: '@Database', tier: 'Development', task: 'Schema design and migrations' },
-  auth: { name: '@Auth', tier: 'Security', task: 'Authentication and authorization' },
-  security: { name: '@Security', tier: 'Security', task: 'Security audit' },
-  testing: { name: '@Testing', tier: 'Quality', task: 'Write and run tests' },
-  reviewer: { name: '@Reviewer', tier: 'Quality', task: 'Code review' },
-  devops: { name: '@DevOps', tier: 'DevOps', task: 'Deployment and CI/CD' },
-};
-
-program
-  .command('build')
-  .description('Start AI-assisted development with auto-loaded context')
-  .option('-a, --agent <agent>', 'Agent to use (planner, backend, frontend, etc.)')
-  .option('-t, --task <task>', 'Specific task to work on')
-  .option('--copy', 'Copy prompt to clipboard instead of displaying')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n🔧 Ultra-Dex Build Mode\n'));
-
-    async function fileExists(fp) {
-      try { await fs.access(fp); return true; } catch { return false; }
-    }
-    async function readFileSafe(fp) {
-      try { return await fs.readFile(fp, 'utf-8'); } catch { return null; }
-    }
-
-    const hasContext = await fileExists('CONTEXT.md');
-    const hasPlan = await fileExists('IMPLEMENTATION-PLAN.md');
-
-    if (!hasContext && !hasPlan) {
-      console.log(chalk.yellow('⚠️  No Ultra-Dex project found in current directory.\n'));
-      console.log(chalk.white('Run one of these first:'));
-      console.log(chalk.gray('  npx ultra-dex init      # Create from template'));
-      console.log(chalk.gray('  npx ultra-dex generate  # Generate from idea\n'));
-      return;
-    }
-
-    const context = await readFileSafe('CONTEXT.md');
-    const plan = await readFileSafe('IMPLEMENTATION-PLAN.md');
-
-    console.log(chalk.green('✓ Context loaded'));
-
-    let agent = options.agent;
-    if (!agent) {
-      const { selectedAgent } = await inquirer.prompt([{
-        type: 'list',
-        name: 'selectedAgent',
-        message: 'Select an agent:',
-        choices: [
-          new inquirer.Separator('── Leadership ──'),
-          { name: '📋 @Planner - Break down tasks', value: 'planner' },
-          { name: '🏗️  @CTO - Architecture decisions', value: 'cto' },
-          new inquirer.Separator('── Development ──'),
-          { name: '⚙️  @Backend - API endpoints', value: 'backend' },
-          { name: '🎨 @Frontend - UI components', value: 'frontend' },
-          { name: '🗄️  @Database - Schema design', value: 'database' },
-          new inquirer.Separator('── Security ──'),
-          { name: '🔐 @Auth - Authentication', value: 'auth' },
-          { name: '🛡️  @Security - Security audit', value: 'security' },
-          new inquirer.Separator('── Quality ──'),
-          { name: '🧪 @Testing - Write tests', value: 'testing' },
-          { name: '👁️  @Reviewer - Code review', value: 'reviewer' },
-          new inquirer.Separator('── DevOps ──'),
-          { name: '🚀 @DevOps - Deployment', value: 'devops' },
-        ],
-      }]);
-      agent = selectedAgent;
-    }
-
-    const agentConfig = BUILD_AGENTS[agent];
-    if (!agentConfig) {
-      console.log(chalk.red(`Unknown agent: ${agent}`));
-      console.log(chalk.gray(`Available: ${Object.keys(BUILD_AGENTS).join(', ')}`));
-      return;
-    }
-
-    let task = options.task;
-    if (!task) {
-      const { taskInput } = await inquirer.prompt([{
-        type: 'input',
-        name: 'taskInput',
-        message: `What should ${agentConfig.name} do?`,
-        default: agentConfig.task,
-      }]);
-      task = taskInput;
-    }
-
-    const contextSection = context ? `## Project Context\n${context}\n` : '';
-    const planSection = plan ? `## Implementation Plan (Summary)\n${plan.slice(0, 8000)}...\n[Full plan in IMPLEMENTATION-PLAN.md]\n` : '';
-
-    const prompt = `# ${agentConfig.name} Agent Session
-
-You are acting as ${agentConfig.name} for this project.
-
-${contextSection}
-${planSection}
-
-## Your Task
-${task}
-
-## Instructions
-1. Read the context and plan carefully
-2. Focus ONLY on your assigned task
-3. Follow Ultra-Dex 21-step verification for any code changes
-4. Document your work in a way the next agent can continue
-
-## Output Format
-- For code: Include full file paths and production-ready code
-- For plans: Use atomic tasks (4-9 hours each)
-- For reviews: Use severity levels (critical, warning, info)
-
-Begin working on: ${task}
-`;
-
-    console.log(chalk.green(`\n✅ ${agentConfig.name} prompt ready\n`));
-
-    if (options.copy) {
-      try {
-        const { exec } = await import('child_process');
-        const { promisify } = await import('util');
-        const execAsync = promisify(exec);
-        const platform = process.platform;
-        if (platform === 'darwin') {
-          await execAsync(`echo ${JSON.stringify(prompt)} | pbcopy`);
-          console.log(chalk.cyan('📋 Prompt copied to clipboard!'));
-        } else {
-          console.log(chalk.yellow('Clipboard not supported. Displaying instead:'));
-          console.log(chalk.gray('─'.repeat(60)));
-          console.log(prompt);
-          console.log(chalk.gray('─'.repeat(60)));
-        }
-      } catch {
-        console.log(chalk.gray('─'.repeat(60)));
-        console.log(prompt);
-        console.log(chalk.gray('─'.repeat(60)));
-      }
-    } else {
-      console.log(chalk.gray('─'.repeat(60)));
-      console.log(prompt);
-      console.log(chalk.gray('─'.repeat(60)));
-      console.log(chalk.cyan('\n📋 Copy this prompt into your AI tool'));
-      console.log(chalk.gray('Or use --copy to copy to clipboard\n'));
-    }
-  });
-
-// ========================================
-// REVIEW COMMAND - Code vs Plan Alignment (v2.2)
-// ========================================
-program
-  .command('review')
-  .description('Review code against the implementation plan')
-  .option('-d, --dir <directory>', 'Directory to review', '.')
-  .option('--quick', 'Quick review without AI (checks file structure only)')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n🔍 Ultra-Dex Code Review\n'));
-
-    const reviewDir = path.resolve(options.dir);
-
-    async function readFileSafe(fp) {
-      try { return await fs.readFile(fp, 'utf-8'); } catch { return null; }
-    }
-    async function fileExists(fp) {
-      try { await fs.access(fp); return true; } catch { return false; }
-    }
-
-    const planPath = path.join(reviewDir, 'IMPLEMENTATION-PLAN.md');
-    const plan = await readFileSafe(planPath);
-
-    if (!plan) {
-      console.log(chalk.yellow('⚠️  No IMPLEMENTATION-PLAN.md found.\n'));
-      console.log(chalk.white('Run one of these first:'));
-      console.log(chalk.gray('  npx ultra-dex init'));
-      console.log(chalk.gray('  npx ultra-dex generate\n'));
-      return;
-    }
-
-    async function getDirectoryStructure(dir, depth = 3, prefix = '') {
-      let structure = '';
-      try {
-        const entries = await fs.readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-          if (['node_modules', '.git', '.next', 'dist', 'build'].includes(entry.name)) continue;
-          const entryPath = path.join(dir, entry.name);
-          if (entry.isDirectory()) {
-            structure += `${prefix}📁 ${entry.name}/\n`;
-            if (depth > 1) structure += await getDirectoryStructure(entryPath, depth - 1, prefix + '  ');
-          } else {
-            structure += `${prefix}📄 ${entry.name}\n`;
-          }
-        }
-      } catch { /* ignore errors */ }
-      return structure;
-    }
-
-    const spinner = ora('Scanning codebase...').start();
-    const structure = await getDirectoryStructure(reviewDir);
-    spinner.succeed('Codebase scanned');
-
-    console.log(chalk.white('\n📁 Project Structure:\n'));
-    console.log(chalk.gray(structure));
-
-    const checks = [
-      { name: 'IMPLEMENTATION-PLAN.md', path: 'IMPLEMENTATION-PLAN.md' },
-      { name: 'CONTEXT.md', path: 'CONTEXT.md' },
-      { name: 'package.json', path: 'package.json' },
-      { name: 'Database schema', path: 'prisma/schema.prisma' },
-      { name: 'Tests', path: 'tests' },
-    ];
-
-    console.log(chalk.white('📋 Structure Checks:\n'));
-    for (const check of checks) {
-      const exists = await fileExists(path.join(reviewDir, check.path));
-      const icon = exists ? chalk.green('✅') : chalk.red('❌');
-      console.log(`  ${icon} ${check.name}`);
-    }
-
-    // Check for key sections in plan
-    console.log(chalk.white('\n📋 Plan Completeness:\n'));
-    const planChecks = [
-      { name: 'Database schema (Section 10)', pattern: /section 10|data model/i },
-      { name: 'API endpoints (Section 11)', pattern: /section 11|api blueprint/i },
-      { name: 'Tech stack (Section 15)', pattern: /section 15|tech stack/i },
-      { name: 'Implementation tasks (Section 16)', pattern: /section 16|implementation plan/i },
-    ];
-    for (const check of planChecks) {
-      const found = check.pattern.test(plan);
-      const icon = found ? chalk.green('✅') : chalk.yellow('⚠️');
-      console.log(`  ${icon} ${check.name}`);
-    }
-
-    console.log(chalk.cyan('\n💡 Tips:'));
-    console.log(chalk.gray('  • Use "npx ultra-dex audit" for a detailed score'));
-    console.log(chalk.gray('  • Use "npx ultra-dex build" to start AI-assisted development\n'));
-  });
-
-// ========================================
-// MCP SERVER (Enhanced Context over HTTP)
-// ========================================
-program
-  .command('serve')
-  .description('Serve Ultra-Dex context over HTTP (MCP-compatible)')
-  .option('-p, --port <port>', 'Port to listen on', '3001')
-  .option('-w, --watch', 'Watch for file changes and notify clients')
-  .action(async (options) => {
-    const port = Number.parseInt(options.port, 10);
-    if (Number.isNaN(port)) {
-      console.log(chalk.red('Invalid port. Use a numeric value.'));
-      process.exit(1);
-    }
-
-    async function readFileSafe(filePath, label) {
-      try {
-        const content = await fs.readFile(filePath, 'utf-8');
-        return { label, content, exists: true };
-      } catch {
-        return { label, content: '', exists: false };
-      }
-    }
-
-    async function getProjectState() {
-      const [context, plan, quickStart] = await Promise.all([
-        readFileSafe('CONTEXT.md', 'CONTEXT.md'),
-        readFileSafe('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md'),
-        readFileSafe('QUICK-START.md', 'QUICK-START.md'),
-      ]);
-
-      // Calculate quick stats
-      let planSections = 0;
-      if (plan.content) {
-        const matches = plan.content.match(/## (SECTION \d+|Section \d+)/gi);
-        planSections = matches ? matches.length : 0;
-      }
-
-      return {
-        meta: {
-          protocol: 'ultra-dex-mcp',
-          version: '2.1.0',
-          timestamp: new Date().toISOString(),
-        },
-        stats: {
-          hasContext: context.exists,
-          hasPlan: plan.exists,
-          hasQuickStart: quickStart.exists,
-          planSections,
-        },
-        files: [context, plan, quickStart].filter(f => f.exists),
-      };
-    }
-
-    // Available agents for quick reference
-    const agentsList = Object.entries(BUILD_AGENTS).map(([id, cfg]) => ({
-      id,
-      name: cfg.name,
-      tier: cfg.tier,
-      task: cfg.task,
-    }));
-
-    const server = http.createServer(async (req, res) => {
-      // CORS headers for browser access
-      res.setHeader('Access-Control-Allow-Origin', '*');
-      res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
-      res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-      if (req.method === 'OPTIONS') {
-        res.writeHead(204);
-        res.end();
-        return;
-      }
-
-      const url = new URL(req.url, `http://localhost:${port}`);
-
-      // Health check
-      if (url.pathname === '/' || url.pathname === '/health') {
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({
-          status: 'ok',
-          service: 'ultra-dex-mcp',
-          version: '2.1.0',
-          endpoints: ['/context', '/agents', '/plan', '/state'],
-        }));
-        return;
-      }
-
-      // Full context (all files)
-      if (url.pathname === '/context') {
-        const state = await getProjectState();
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify(state));
-        return;
-      }
-
-      // Just the plan
-      if (url.pathname === '/plan') {
-        const plan = await readFileSafe('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md');
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ plan: plan.content, exists: plan.exists }));
-        return;
-      }
-
-      // Project state (quick check)
-      if (url.pathname === '/state') {
-        const state = await getProjectState();
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ meta: state.meta, stats: state.stats }));
-        return;
-      }
-
-      // List agents
-      if (url.pathname === '/agents') {
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ agents: agentsList }));
-        return;
-      }
-
-      // Get specific agent prompt
-      if (url.pathname.startsWith('/agents/')) {
-        const agentId = url.pathname.split('/')[2];
-        const agentConfig = BUILD_AGENTS[agentId];
-        if (!agentConfig) {
-          res.writeHead(404, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ error: 'Agent not found', available: Object.keys(BUILD_AGENTS) }));
-          return;
-        }
-
-        // Build prompt with context
-        const context = await readFileSafe('CONTEXT.md', 'CONTEXT.md');
-        const plan = await readFileSafe('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md');
-        
-        const prompt = `# ${agentConfig.name} Agent Session
-
-You are acting as ${agentConfig.name} for this project.
-
-${context.content ? `## Project Context\n${context.content}\n` : ''}
-${plan.content ? `## Implementation Plan\n${plan.content.slice(0, 10000)}\n` : ''}
-
-## Default Task
-${agentConfig.task}
-
-## Instructions
-1. Read the context and plan carefully
-2. Focus ONLY on your assigned task
-3. Follow Ultra-Dex 21-step verification for code changes
-`;
-
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ 
-          agent: agentConfig,
-          prompt,
-          contextLength: context.content.length,
-          planLength: plan.content.length,
-        }));
-        return;
-      }
-
-      res.writeHead(404, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ error: 'Not found' }));
-    });
-
-    server.listen(port, () => {
-      console.log(chalk.green(`\n✅ Ultra-Dex MCP Server v2.1.0`));
-      console.log(chalk.cyan(`   Running on http://localhost:${port}\n`));
-      console.log(chalk.white('   Endpoints:'));
-      console.log(chalk.gray('     GET /          - Health check + endpoint list'));
-      console.log(chalk.gray('     GET /context   - Full context (all files)'));
-      console.log(chalk.gray('     GET /plan      - Just IMPLEMENTATION-PLAN.md'));
-      console.log(chalk.gray('     GET /state     - Quick project state'));
-      console.log(chalk.gray('     GET /agents    - List all agents'));
-      console.log(chalk.gray('     GET /agents/:id - Get agent prompt with context\n'));
-      console.log(chalk.yellow('   Example: curl http://localhost:' + port + '/agents/backend\n'));
-    });
-  });
-
-program
-  .command('agent <name>')
-  .description('Show a specific agent prompt')
-  .action(async (name) => {
-    const agent = AGENTS.find(a => a.name.toLowerCase() === name.toLowerCase());
-
-    if (!agent) {
-      console.log(chalk.red(`\n❌ Agent "${name}" not found.\n`));
-      console.log(chalk.gray('Available agents:'));
-      AGENTS.forEach(a => console.log(chalk.cyan(`  - ${a.name}`)));
-      console.log('\n' + chalk.gray('Run "ultra-dex agents" to see all agents.\n'));
-      process.exit(1);
-    }
-
-    // Try to read agent file
-    const agentPath = path.join(ASSETS_ROOT, 'agents', agent.file);
-    try {
-      const content = await fs.readFile(agentPath, 'utf-8');
-      console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
-      console.log(chalk.gray('─'.repeat(60)));
-      console.log(content);
-      console.log(chalk.gray('─'.repeat(60)));
-      console.log(chalk.bold('\n📋 Copy the above prompt and paste into your AI tool.\n'));
-    } catch (err) {
-      const fallbackPath = path.join(ROOT_FALLBACK, 'agents', agent.file);
-      try {
-        const content = await fs.readFile(fallbackPath, 'utf-8');
-        console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
-        console.log(chalk.gray('─'.repeat(60)));
-        console.log(content);
-        console.log(chalk.gray('─'.repeat(60)));
-        console.log(chalk.bold('\n📋 Copy the above prompt and paste into your AI tool.\n'));
-      } catch (fallbackErr) {
-        console.log(chalk.bold(`\n🤖 ${agent.name.toUpperCase()} Agent\n`));
-        console.log(chalk.gray('View full prompt on GitHub:'));
-        console.log(chalk.blue(`  https://github.com/Srujan0798/Ultra-Dex/blob/main/agents/${agent.file}\n`));
-      }
-    }
-  });
-
-// Pack command - assemble context for any AI tool
-program
-  .command('pack <agent>')
-  .description('Package project context + agent prompt for any AI tool')
-  .option('-c, --clipboard', 'Copy to clipboard (requires pbcopy/xclip)')
-  .action(async (agentName, options) => {
-    // Find agent
-    const agent = AGENTS.find(a => a.name.toLowerCase() === agentName.toLowerCase());
-    if (!agent) {
-      console.log(chalk.red(`\n❌ Agent "${agentName}" not found.\n`));
-      console.log(chalk.gray('Available agents:'));
-      AGENTS.forEach(a => console.log(chalk.cyan(`  - ${a.name}`)));
-      process.exit(1);
-    }
-
-    let output = '';
-
-    // 1. Read Agent Prompt
-    const agentPath = path.join(ASSETS_ROOT, 'agents', agent.file);
-    try {
-      const agentPrompt = await fs.readFile(agentPath, 'utf-8');
-      output += agentPrompt + '\n\n';
-    } catch (err) {
-      const fallbackPath = path.join(ROOT_FALLBACK, 'agents', agent.file);
-      try {
-        const agentPrompt = await fs.readFile(fallbackPath, 'utf-8');
-        output += agentPrompt + '\n\n';
-      } catch (fallbackErr) {
-        output += `# ${agent.name.toUpperCase()} Agent\n\nSee: https://github.com/Srujan0798/Ultra-Dex/blob/main/agents/${agent.file}\n\n`;
-      }
-    }
-
-    output += '---\n\n';
-
-    // 2. Read CONTEXT.md
-    try {
-      const context = await fs.readFile('CONTEXT.md', 'utf-8');
-      output += '# PROJECT CONTEXT\n\n' + context + '\n\n';
-    } catch (err) {
-      output += '# PROJECT CONTEXT\n\n*No CONTEXT.md found. Run `ultra-dex init` first.*\n\n';
-    }
-
-    output += '---\n\n';
-
-    // 3. Read IMPLEMENTATION-PLAN.md
-    try {
-      const plan = await fs.readFile('IMPLEMENTATION-PLAN.md', 'utf-8');
-      output += '# IMPLEMENTATION PLAN\n\n' + plan + '\n';
-    } catch (err) {
-      output += '# IMPLEMENTATION PLAN\n\n*No IMPLEMENTATION-PLAN.md found. Run `ultra-dex init` first.*\n';
-    }
-
-    // Output
-    console.log(chalk.bold(`\n📦 Packed context for @${agent.name}\n`));
-    console.log(chalk.gray('─'.repeat(60)));
-    console.log(output);
-    console.log(chalk.gray('─'.repeat(60)));
-
-    // Try to copy to clipboard if requested
-    if (options.clipboard) {
-      try {
-        const { execSync } = require('child_process');
-        const platform = process.platform;
-        if (platform === 'darwin') {
-          execSync('pbcopy', { input: output });
-          console.log(chalk.green('\n✅ Copied to clipboard!\n'));
-        } else if (platform === 'linux') {
-          execSync('xclip -selection clipboard', { input: output });
-          console.log(chalk.green('\n✅ Copied to clipboard!\n'));
-        } else {
-          console.log(chalk.yellow('\n⚠️  Clipboard not supported on this platform. Copy manually.\n'));
-        }
-      } catch (err) {
-        console.log(chalk.yellow('\n⚠️  Could not copy to clipboard. Copy manually.\n'));
-      }
-    } else {
-      console.log(chalk.cyan('\n💡 Tip: Use --clipboard flag to copy directly\n'));
-    }
-  });
-
-// Workflow examples map
-const WORKFLOWS = {
-  auth: {
-    name: 'Authentication',
-    agents: ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@Frontend', '@Security', '@DevOps'],
-    description: 'Complete authentication with email/password and OAuth',
-    example: 'supabase',
-  },
-  supabase: {
-    name: 'Supabase Authentication Setup',
-    agents: ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@Frontend', '@Security', '@DevOps'],
-    description: 'Set up Supabase auth with RLS policies',
-    steps: [
-      '1. Create Supabase project and get API keys',
-      '2. Set up database schema with RLS policies',
-      '3. Configure authentication providers (email + Google OAuth)',
-      '4. Implement backend auth middleware',
-      '5. Build frontend auth UI components',
-      '6. Test authentication flow',
-    ],
-  },
-  payments: {
-    name: 'Payment Integration (Stripe)',
-    agents: ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@Frontend', '@Testing', '@Security', '@DevOps'],
-    description: 'Integrate Stripe for subscriptions and one-time payments',
-    steps: [
-      '1. Create Stripe account and get API keys',
-      '2. Design subscription/payment schema',
-      '3. Implement Stripe Checkout API',
-      '4. Handle webhooks for payment events',
-      '5. Build payment UI with checkout flow',
-      '6. Test with Stripe test cards',
-    ],
-  },
-  deployment: {
-    name: 'Deployment Pipeline',
-    agents: ['@Planner', '@CTO', '@Frontend', '@DevOps'],
-    description: 'Deploy to Vercel with staging and production environments',
-    example: 'vercel',
-  },
-  vercel: {
-    name: 'Vercel Deployment Pipeline',
-    agents: ['@Planner', '@CTO', '@Frontend', '@DevOps'],
-    description: 'Deploy Next.js app to Vercel',
-    steps: [
-      '1. Set up Vercel project and link Git repository',
-      '2. Configure environment variables for staging/production',
-      '3. Set up custom domain',
-      '4. Configure preview deployments for PRs',
-      '5. Set up deployment protection rules',
-      '6. Test deployment pipeline',
-    ],
-  },
-  cicd: {
-    name: 'GitHub Actions CI/CD',
-    agents: ['@Planner', '@CTO', '@Testing', '@DevOps'],
-    description: 'Automated testing and deployment with GitHub Actions',
-    steps: [
-      '1. Create workflow file for CI (tests + lint)',
-      '2. Add build verification job',
-      '3. Add deployment job for production',
-      '4. Configure secrets for deployment',
-      '5. Add status badges to README',
-      '6. Test workflow on PR',
-    ],
-  },
-  database: {
-    name: 'Database Migration',
-    agents: ['@Planner', '@CTO', '@Database', '@Backend', '@Testing'],
-    description: 'Database schema migration and data sync',
-    steps: [
-      '1. Design new schema changes',
-      '2. Write migration scripts',
-      '3. Test migrations in staging',
-      '4. Back up production database',
-      '5. Run migrations in production',
-      '6. Verify data integrity',
-    ],
-  },
-  email: {
-    name: 'Email Notification System',
-    agents: ['@Planner', '@Research', '@CTO', '@Backend', '@Frontend', '@Testing'],
-    description: 'Transactional emails with templates',
-    steps: [
-      '1. Choose email service (Resend, SendGrid)',
-      '2. Set up email templates',
-      '3. Implement email API endpoints',
-      '4. Add email queue for async sending',
-      '5. Test email delivery',
-      '6. Monitor deliverability',
-    ],
-  },
-  realtime: {
-    name: 'Real-Time Features',
-    agents: ['@Planner', '@CTO', '@Backend', '@Frontend', '@Testing'],
-    description: 'Live notifications with WebSockets',
-    steps: [
-      '1. Choose WebSocket library (Socket.io, Pusher)',
-      '2. Set up WebSocket server',
-      '3. Implement event broadcasting',
-      '4. Build frontend listeners',
-      '5. Test real-time updates',
-      '6. Handle reconnection logic',
-    ],
-  },
-  sentry: {
-    name: 'Sentry Error Tracking',
-    agents: ['@Planner', '@Research', '@CTO', '@Backend', '@Frontend', '@DevOps'],
-    description: 'Error monitoring with Sentry',
-    steps: [
-      '1. Create Sentry account and project',
-      '2. Install Sentry SDKs for frontend and backend',
-      '3. Configure error boundaries for React',
-      '4. Set up source maps for debugging',
-      '5. Configure alerts and notifications',
-      '6. Test error capture in development',
-    ],
-  },
-  shopify: {
-    name: 'Shopify Product Integration',
-    agents: ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@DevOps'],
-    description: 'Sync products from Shopify store',
-    steps: [
-      '1. Create Shopify Partner account and development store',
-      '2. Set up Shopify app with Admin API access',
-      '3. Design database schema for products',
-      '4. Build product sync endpoint',
-      '5. Implement webhook handlers for product updates',
-      '6. Schedule full product sync (cron job)',
-    ],
-  },
-  analytics: {
-    name: 'PostHog Analytics Integration',
-    agents: ['@Planner', '@Research', '@CTO', '@Backend', '@Frontend', '@DevOps'],
-    description: 'Track user behavior with PostHog',
-    steps: [
-      '1. Create PostHog account and project',
-      '2. Install PostHog SDKs for frontend and backend',
-      '3. Set up core event tracking (signup, login, feature usage)',
-      '4. Create conversion funnel dashboard',
-      '5. Set up feature flags (optional)',
-      '6. Configure user identification',
-    ],
-  },
-};
-
-program
-  .command('workflow <feature>')
-  .description('Show workflow for common features (auth, payments, deployment, etc.)')
-  .action((feature) => {
-    const workflow = WORKFLOWS[feature.toLowerCase()];
-
-    if (!workflow) {
-      console.log(chalk.red(`\n❌ Workflow "${feature}" not found.\n`));
-      console.log(chalk.gray('Available workflows:'));
-      Object.keys(WORKFLOWS).forEach(key => {
-        console.log(chalk.cyan(`  - ${key}`) + chalk.gray(` (${WORKFLOWS[key].name})`));
-      });
-      console.log('\n' + chalk.gray('Usage: ultra-dex workflow <feature>\n'));
-      process.exit(1);
-    }
-
-    console.log(chalk.bold(`\n📋 ${workflow.name} Workflow\n`));
-    console.log(chalk.gray(workflow.description));
-
-    console.log(chalk.bold('\n🤖 Agents Involved:\n'));
-    workflow.agents.forEach((agent, i) => {
-      console.log(chalk.cyan(`  ${i + 1}. ${agent}`));
-    });
-
-    if (workflow.steps) {
-      console.log(chalk.bold('\n📝 Implementation Steps:\n'));
-      workflow.steps.forEach(step => {
-        console.log(chalk.gray(`  ${step}`));
-      });
-    }
-
-    console.log(chalk.bold('\n📚 Full Example:\n'));
-    console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex/blob/main/guides/ADVANCED-WORKFLOWS.md'));
-    console.log(chalk.gray(`  (Search for "Example: ${workflow.name}")\n`));
-  });
-
-program
-  .command('suggest')
-  .description('Get AI agent suggestions for your task')
-  .action(async () => {
-    console.log(chalk.cyan('\n🤖 Ultra-Dex Agent Suggester\n'));
-
-    const answers = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'taskType',
-        message: 'What are you trying to build?',
-        choices: [
-          'New feature from scratch',
-          'Authentication system',
-          'Payment integration',
-          'Database changes',
-          'Bug fix',
-          'Performance optimization',
-          'Deployment/DevOps',
-          'API endpoint',
-          'UI component',
-          'Testing',
-        ],
-      },
-      {
-        type: 'input',
-        name: 'description',
-        message: 'Briefly describe your task:',
-        default: '',
-      },
-    ]);
-
-    console.log(chalk.bold('\n💡 Suggested Agent Workflow:\n'));
-
-    // Agent suggestions based on task type
-    let suggestedAgents = [];
-    let reasoning = '';
-
-    switch (answers.taskType) {
-      case 'New feature from scratch':
-        suggestedAgents = ['@Planner', '@CTO', '@Database', '@Backend', '@Frontend', '@Testing', '@Reviewer', '@DevOps'];
-        reasoning = 'Complete feature requires planning, architecture, implementation, testing, and deployment';
-        break;
-
-      case 'Authentication system':
-        suggestedAgents = ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@Frontend', '@Security', '@DevOps'];
-        reasoning = 'Auth requires research (providers), security review, and full-stack implementation';
-        break;
-
-      case 'Payment integration':
-        suggestedAgents = ['@Planner', '@Research', '@CTO', '@Database', '@Backend', '@Frontend', '@Testing', '@Security', '@DevOps'];
-        reasoning = 'Payments need provider research, webhook handling, testing, and security audit';
-        break;
-
-      case 'Database changes':
-        suggestedAgents = ['@Planner', '@CTO', '@Database', '@Backend', '@Testing'];
-        reasoning = 'Schema changes need planning, architecture review, migration, and testing';
-        break;
-
-      case 'Bug fix':
-        suggestedAgents = ['@Debugger', '@Testing', '@Reviewer'];
-        reasoning = 'Debug issue, add test to prevent regression, review fix';
-        break;
-
-      case 'Performance optimization':
-        suggestedAgents = ['@Performance', '@Backend', '@Frontend', '@Database', '@Testing'];
-        reasoning = 'Identify bottlenecks, optimize code/queries, verify improvements';
-        break;
-
-      case 'Deployment/DevOps':
-        suggestedAgents = ['@DevOps', '@CTO', '@Security'];
-        reasoning = 'Infrastructure setup with security review';
-        break;
-
-      case 'API endpoint':
-        suggestedAgents = ['@Backend', '@Database', '@Testing', '@Reviewer'];
-        reasoning = 'Implement endpoint, add tests, review code quality';
-        break;
-
-      case 'UI component':
-        suggestedAgents = ['@Frontend', '@Reviewer'];
-        reasoning = 'Build component, review for quality and accessibility';
-        break;
-
-      case 'Testing':
-        suggestedAgents = ['@Testing', '@Reviewer'];
-        reasoning = 'Write tests, review coverage';
-        break;
-
-      default:
-        suggestedAgents = ['@Planner', '@CTO'];
-        reasoning = 'Start with planning and architecture review';
-    }
-
-    console.log(chalk.gray(reasoning + '\n'));
-
-    suggestedAgents.forEach((agent, i) => {
-      const agentName = agent.replace('@', '').toLowerCase();
-      const agentInfo = AGENTS.find(a => a.name === agentName);
-      const arrow = i < suggestedAgents.length - 1 ? '  →' : '';
-      console.log(chalk.cyan(`  ${i + 1}. ${agent}`) + chalk.gray(` - ${agentInfo?.description || ''}`) + arrow);
-    });
-
-    console.log(chalk.bold('\n📚 Next Steps:\n'));
-    console.log(chalk.gray(`  1. Start with ${suggestedAgents[0]} to plan the task`));
-    console.log(chalk.gray(`  2. Hand off to each agent in sequence`));
-    console.log(chalk.gray('  3. Use "ultra-dex agent <name>" to see full prompts\n'));
-
-    console.log(chalk.bold('🔗 Related Workflows:\n'));
-    if (answers.taskType === 'Authentication system') {
-      console.log(chalk.blue('  ultra-dex workflow auth'));
-      console.log(chalk.blue('  ultra-dex workflow supabase\n'));
-    } else if (answers.taskType === 'Payment integration') {
-      console.log(chalk.blue('  ultra-dex workflow payments\n'));
-    } else if (answers.taskType === 'Deployment/DevOps') {
-      console.log(chalk.blue('  ultra-dex workflow vercel'));
-      console.log(chalk.blue('  ultra-dex workflow cicd\n'));
-    } else {
-      console.log(chalk.gray('  Use "ultra-dex workflow <feature>" to see examples\n'));
-    }
-  });
-
-program
-  .command('validate')
-  .description('Validate project structure against Ultra-Dex standards')
-  .option('-d, --dir <directory>', 'Project directory to validate', '.')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n✅ Ultra-Dex Structure Validator\n'));
-
-    const projectDir = path.resolve(options.dir);
-    let passed = 0;
-    let failed = 0;
-    const warnings = [];
-
-    // Helper to check file/directory exists
-    async function checkExists(itemPath, type = 'file') {
-      try {
-        const stats = await fs.stat(path.join(projectDir, itemPath));
-        if (type === 'file' && stats.isFile()) return true;
-        if (type === 'dir' && stats.isDirectory()) return true;
-        return false;
-      } catch {
-        return false;
-      }
-    }
-
-    console.log(chalk.bold('Checking required files...\n'));
-
-    // Check core planning files
-    const coreFiles = [
-      { path: 'QUICK-START.md', required: true },
-      { path: 'IMPLEMENTATION-PLAN.md', required: true },
-      { path: 'CONTEXT.md', required: false },
-      { path: 'README.md', required: false },
-    ];
-
-    for (const file of coreFiles) {
-      const exists = await checkExists(file.path);
-      if (exists) {
-        passed++;
-        console.log(chalk.green(`  ✅ ${file.path}`));
-      } else if (file.required) {
-        failed++;
-        console.log(chalk.red(`  ❌ ${file.path} (required)`));
-      } else {
-        warnings.push(file.path);
-        console.log(chalk.yellow(`  ⚠️  ${file.path} (recommended)`));
-      }
-    }
-
-    console.log(chalk.bold('\nChecking directory structure...\n'));
-
-    const directories = [
-      { path: 'docs', required: false },
-      { path: '.agents', required: false },
-      { path: '.cursor/rules', required: false },
-    ];
-
-    for (const dir of directories) {
-      const exists = await checkExists(dir.path, 'dir');
-      if (exists) {
-        passed++;
-        console.log(chalk.green(`  ✅ ${dir.path}/`));
-      } else {
-        warnings.push(dir.path);
-        console.log(chalk.yellow(`  ⚠️  ${dir.path}/ (optional)`));
-      }
-    }
-
-    console.log(chalk.bold('\nValidating content quality...\n'));
-
-    // Check if QUICK-START has key sections
-    try {
-      const quickStart = await fs.readFile(path.join(projectDir, 'QUICK-START.md'), 'utf-8');
-
-      const sections = ['idea', 'problem', 'feature', 'tech stack', 'tasks'];
-      let sectionsFound = 0;
-
-      sections.forEach(section => {
-        if (quickStart.toLowerCase().includes(section)) {
-          sectionsFound++;
-        }
-      });
-
-      if (sectionsFound >= 4) {
-        passed++;
-        console.log(chalk.green(`  ✅ QUICK-START.md has ${sectionsFound}/${sections.length} key sections`));
-      } else {
-        failed++;
-        console.log(chalk.red(`  ❌ QUICK-START.md missing key sections (${sectionsFound}/${sections.length})`));
-      }
-    } catch {
-      console.log(chalk.gray('  ⊘  Could not validate QUICK-START.md content'));
-    }
-
-    // Check if implementation plan has content
-    try {
-      const implPlan = await fs.readFile(path.join(projectDir, 'IMPLEMENTATION-PLAN.md'), 'utf-8');
-
-      if (implPlan.length > 500) {
-        passed++;
-        console.log(chalk.green(`  ✅ IMPLEMENTATION-PLAN.md has substantial content`));
-      } else {
-        warnings.push('IMPLEMENTATION-PLAN.md needs more detail');
-        console.log(chalk.yellow(`  ⚠️  IMPLEMENTATION-PLAN.md is sparse (${implPlan.length} chars)`));
-      }
-    } catch {
-      console.log(chalk.gray('  ⊘  Could not validate IMPLEMENTATION-PLAN.md content'));
-    }
-
-    // Summary
-    console.log('\n' + chalk.bold('─'.repeat(50)));
-    console.log(chalk.bold('\nValidation Summary:\n'));
-    console.log(chalk.green(`  ✅ Passed: ${passed}`));
-    console.log(chalk.red(`  ❌ Failed: ${failed}`));
-    console.log(chalk.yellow(`  ⚠️  Warnings: ${warnings.length}`));
-
-    // Overall status
-    if (failed === 0) {
-      console.log(chalk.bold.green('\n✅ VALIDATION PASSED\n'));
-      console.log(chalk.gray('Your project structure follows Ultra-Dex standards.'));
-    } else {
-      console.log(chalk.bold.yellow('\n⚠️  VALIDATION INCOMPLETE\n'));
-      console.log(chalk.gray('Fix required files to meet Ultra-Dex standards.'));
-    }
-
-    // Recommendations
-    if (warnings.length > 0) {
-      console.log(chalk.bold('\n💡 Recommendations:\n'));
-      warnings.slice(0, 3).forEach(w => {
-        console.log(chalk.cyan(`  → Consider adding ${w}`));
-      });
-    }
-
-    console.log('\n' + chalk.gray('Run "ultra-dex init" to set up a proper Ultra-Dex project.\n'));
-  });
-
-// ========================================
-// HOOKS COMMAND - Automated Verification
-// ========================================
-program
-  .command('hooks')
-  .description('Set up git hooks for automated verification')
-  .option('--remove', 'Remove Ultra-Dex git hooks')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Setup\n'));
-
-    const gitDir = path.join(process.cwd(), '.git');
-    const hooksDir = path.join(gitDir, 'hooks');
-
-    // Check if git repo exists
-    try {
-      await fs.access(gitDir);
-    } catch {
-      console.log(chalk.red('❌ Not a git repository. Run "git init" first.\n'));
-      process.exit(1);
-    }
-
-    // Create hooks directory if it doesn't exist
-    await fs.mkdir(hooksDir, { recursive: true });
-
-    const preCommitPath = path.join(hooksDir, 'pre-commit');
-
-    if (options.remove) {
-      // Remove hooks
-      try {
-        const content = await fs.readFile(preCommitPath, 'utf-8');
-        if (content.includes('ultra-dex')) {
-          await fs.unlink(preCommitPath);
-          console.log(chalk.green('✅ Ultra-Dex pre-commit hook removed.\n'));
-        } else {
-          console.log(chalk.yellow('⚠️  Pre-commit hook exists but is not from Ultra-Dex.\n'));
-        }
-      } catch {
-        console.log(chalk.gray('No Ultra-Dex hooks found.\n'));
-      }
-      return;
-    }
-
-    // Generate pre-commit hook
-    const preCommitScript = `#!/bin/sh
-# Ultra-Dex Pre-Commit Hook
-# Validates project structure before allowing commits
-# Remove with: npx ultra-dex hooks --remove
-
-echo "🔍 Ultra-Dex: Validating project structure..."
-
-# Run validation
-npx ultra-dex validate --dir . > /tmp/ultra-dex-validate.log 2>&1
-RESULT=$?
-
-if [ $RESULT -ne 0 ]; then
-  echo ""
-  echo "❌ Ultra-Dex validation failed. Commit blocked."
-  echo ""
-  echo "Run 'npx ultra-dex validate' to see details."
-  echo "Fix issues or bypass with: git commit --no-verify"
-  echo ""
-  exit 1
-fi
-
-# Check for required files
-if [ ! -f "QUICK-START.md" ]; then
-  echo "⚠️  Warning: QUICK-START.md not found"
-fi
-
-if [ ! -f "IMPLEMENTATION-PLAN.md" ]; then
-  echo "⚠️  Warning: IMPLEMENTATION-PLAN.md not found"
-fi
-
-echo "✅ Ultra-Dex validation passed."
-exit 0
-`;
-
-    // Check if pre-commit already exists
-    try {
-      const existing = await fs.readFile(preCommitPath, 'utf-8');
-      if (existing.includes('ultra-dex')) {
-        console.log(chalk.yellow('⚠️  Ultra-Dex pre-commit hook already exists.\n'));
-        console.log(chalk.gray('  Use --remove to remove it first.\n'));
-        return;
-      } else {
-        // Append to existing hook
-        const combined = existing + '\n\n' + preCommitScript;
-        await fs.writeFile(preCommitPath, combined);
-        await fs.chmod(preCommitPath, '755');
-        console.log(chalk.green('✅ Ultra-Dex hook appended to existing pre-commit.\n'));
-      }
-    } catch {
-      // No existing hook, create new
-      await fs.writeFile(preCommitPath, preCommitScript);
-      await fs.chmod(preCommitPath, '755');
-      console.log(chalk.green('✅ Pre-commit hook installed.\n'));
-    }
-
-    console.log(chalk.bold('What this does:\n'));
-    console.log(chalk.gray('  • Runs "ultra-dex validate" before each commit'));
-    console.log(chalk.gray('  • Blocks commits if required files are missing'));
-    console.log(chalk.gray('  • Warns about incomplete sections\n'));
-
-    console.log(chalk.bold('To bypass (not recommended):\n'));
-    console.log(chalk.cyan('  git commit --no-verify\n'));
-
-    console.log(chalk.bold('To remove:\n'));
-    console.log(chalk.cyan('  npx ultra-dex hooks --remove\n'));
-  });
-
-// ========================================
-// FETCH COMMAND - Offline Mode Support
-// ========================================
-program
-  .command('fetch')
-  .description('Download all Ultra-Dex assets for offline use')
-  .option('-d, --dir <directory>', 'Target directory', '.ultra-dex')
-  .option('--agents', 'Fetch only agent prompts')
-  .option('--rules', 'Fetch only cursor rules')
-  .option('--docs', 'Fetch only documentation')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n📦 Ultra-Dex Asset Fetcher\n'));
-
-    const targetDir = path.resolve(options.dir);
-    const fetchAll = !options.agents && !options.rules && !options.docs;
-
-    // GitHub raw URLs
-    const GITHUB_RAW = 'https://raw.githubusercontent.com/Srujan0798/Ultra-Dex/main';
-
-    // Helper to download a file
-    async function downloadFile(url, destPath) {
-      try {
-        const response = await fetch(url);
-        if (!response.ok) throw new Error(`HTTP ${response.status}`);
-        const content = await response.text();
-        await fs.mkdir(path.dirname(destPath), { recursive: true });
-        await fs.writeFile(destPath, content);
-        return true;
-      } catch (err) {
-        return false;
-      }
-    }
-
-    const spinner = ora('Preparing to fetch assets...').start();
-
-    // Create target directory
-    await fs.mkdir(targetDir, { recursive: true });
-
-    let downloaded = 0;
-    let failed = 0;
-
-    // Fetch cursor rules
-    if (fetchAll || options.rules) {
-      spinner.text = 'Fetching cursor rules...';
-      const rulesDir = path.join(targetDir, 'cursor-rules');
-      await fs.mkdir(rulesDir, { recursive: true });
-
-      const ruleFiles = [
-        '00-ultra-dex-core.mdc',
-        '01-database.mdc',
-        '02-api.mdc',
-        '03-auth.mdc',
-        '04-frontend.mdc',
-        '05-payments.mdc',
-        '06-testing.mdc',
-        '07-security.mdc',
-        '08-deployment.mdc',
-        '09-error-handling.mdc',
-        '10-performance.mdc',
-        '11-nextjs-v15.mdc',
-        '12-multi-tenancy.mdc',
-      ];
-
-      for (const file of ruleFiles) {
-        const url = `${GITHUB_RAW}/cursor-rules/${file}`;
-        const dest = path.join(rulesDir, file);
-        if (await downloadFile(url, dest)) {
-          downloaded++;
-        } else {
-          failed++;
-        }
-      }
-
-      // Also fetch load.sh
-      await downloadFile(`${GITHUB_RAW}/cursor-rules/load.sh`, path.join(rulesDir, 'load.sh'));
-      try {
-        await fs.chmod(path.join(rulesDir, 'load.sh'), '755');
-      } catch {}
-    }
-
-    // Fetch agent prompts
-    if (fetchAll || options.agents) {
-      spinner.text = 'Fetching agent prompts...';
-      const agentsDir = path.join(targetDir, 'agents');
-
-    const agentPaths = [
-        '00-AGENT_INDEX.md',
-        'README.md',
-        'AGENT-INSTRUCTIONS.md',
-        '1-leadership/cto.md',
-        '1-leadership/planner.md',
-        '1-leadership/research.md',
-        '2-development/backend.md',
-        '2-development/frontend.md',
-        '2-development/database.md',
-        '3-security/security.md',
-        '4-devops/devops.md',
-        '5-quality/reviewer.md',
-        '5-quality/testing.md',
-        '5-quality/debugger.md',
-        '6-specialist/performance.md',
-        '6-specialist/refactoring.md',
-        '6-specialist/documentation.md',
-      ];
-
-      for (const agentPath of agentPaths) {
-        const url = `${GITHUB_RAW}/agents/${agentPath}`;
-        const dest = path.join(agentsDir, agentPath);
-        if (await downloadFile(url, dest)) {
-          downloaded++;
-        } else {
-          failed++;
-        }
-      }
-    }
-
-    // Fetch documentation
-    if (fetchAll || options.docs) {
-      spinner.text = 'Fetching documentation...';
-      const docsDir = path.join(targetDir, 'docs');
-
-      const docFiles = [
-        'VERIFICATION.md',
-        'BUILD-AUTH-30M.md',
-        'QUICK-REFERENCE.md',
-        'TROUBLESHOOTING.md',
-      ];
-
-      for (const file of docFiles) {
-        const url = `${GITHUB_RAW}/docs/${file}`;
-        const dest = path.join(docsDir, file);
-        if (await downloadFile(url, dest)) {
-          downloaded++;
-        } else {
-          failed++;
-        }
-      }
-
-      // Fetch guides
-      const guidesDir = path.join(targetDir, 'guides');
-      const guideFiles = [
-        'PROJECT-ORCHESTRATION.md',
-        'ADVANCED-WORKFLOWS.md',
-        'DATABASE-DECISION-FRAMEWORK.md',
-        'ARCHITECTURE-PATTERNS.md',
-      ];
-
-      for (const file of guideFiles) {
-        const url = `${GITHUB_RAW}/guides/${file}`;
-        const dest = path.join(guidesDir, file);
-        if (await downloadFile(url, dest)) {
-          downloaded++;
-        } else {
-          failed++;
-        }
-      }
-    }
-
-    if (failed === 0) {
-      spinner.succeed(chalk.green(`Downloaded ${downloaded} files to ${targetDir}`));
-    } else {
-      spinner.warn(chalk.yellow(`Downloaded ${downloaded} files, ${failed} failed`));
-    }
-
-    console.log(chalk.bold('\n📁 Assets downloaded to:\n'));
-    if (fetchAll || options.rules) {
-      console.log(chalk.gray(`  ${targetDir}/cursor-rules/  (12 .mdc files)`));
-    }
-    if (fetchAll || options.agents) {
-      console.log(chalk.gray(`  ${targetDir}/agents/        (16 agent prompts)`));
-    }
-    if (fetchAll || options.docs) {
-      console.log(chalk.gray(`  ${targetDir}/docs/          (documentation)`));
-      console.log(chalk.gray(`  ${targetDir}/guides/        (guides)`));
-    }
-
-    console.log(chalk.bold('\n💡 Usage:\n'));
-    console.log(chalk.cyan('  # Copy cursor rules to project'));
-    console.log(chalk.gray(`  cp -r ${targetDir}/cursor-rules .cursor/rules`));
-    console.log(chalk.cyan('\n  # Copy agents to project'));
-    console.log(chalk.gray(`  cp -r ${targetDir}/agents .agents`));
-    console.log(chalk.cyan('\n  # Works offline now!'));
-    console.log(chalk.gray('  No GitHub access needed after fetch.\n'));
-  });
-
-// ========================================
-// ALIGN COMMAND - Quick Alignment Score (v2.2)
-// ========================================
-program
-  .command('align')
-  .description('Quick alignment score - check how well code matches plan')
-  .option('-d, --dir <directory>', 'Directory to check', '.')
-  .option('--json', 'Output as JSON')
-  .action(async (options) => {
-    const checkDir = path.resolve(options.dir);
-
-    async function readFileSafe(fp) {
-      try { return await fs.readFile(fp, 'utf-8'); } catch { return null; }
-    }
-    async function fileExists(fp) {
-      try { await fs.access(fp); return true; } catch { return false; }
-    }
-    async function countFiles(dir, ext) {
-      try {
-        const entries = await fs.readdir(dir, { withFileTypes: true, recursive: true });
-        return entries.filter(e => e.isFile() && e.name.endsWith(ext)).length;
-      } catch { return 0; }
-    }
-
-    const plan = await readFileSafe(path.join(checkDir, 'IMPLEMENTATION-PLAN.md'));
-    if (!plan) {
-      if (options.json) {
-        console.log(JSON.stringify({ error: 'No IMPLEMENTATION-PLAN.md found', score: 0 }));
-      } else {
-        console.log(chalk.red('\n❌ No IMPLEMENTATION-PLAN.md found'));
-        console.log(chalk.gray('Run `ultra-dex generate` or `ultra-dex init` first\n'));
-      }
-      return;
-    }
-
-    const spinner = ora('Calculating alignment...').start();
-
-    // Score components
-    let score = 0;
-    const checks = [];
-
-    // 1. Core files exist (30 points)
-    const coreFiles = [
-      { file: 'IMPLEMENTATION-PLAN.md', points: 10, name: 'Implementation Plan' },
-      { file: 'CONTEXT.md', points: 5, name: 'Context File' },
-      { file: 'package.json', points: 5, name: 'Package Config' },
-      { file: 'README.md', points: 5, name: 'Documentation' },
-      { file: '.gitignore', points: 5, name: 'Git Config' },
-    ];
-    for (const cf of coreFiles) {
-      const exists = await fileExists(path.join(checkDir, cf.file));
-      if (exists) score += cf.points;
-      checks.push({ name: cf.name, status: exists ? 'pass' : 'fail', points: exists ? cf.points : 0 });
-    }
-
-    // 2. Plan completeness - check for key sections (30 points)
-    const sections = [
-      { pattern: /## 1\.|project identity/i, name: 'Project Identity', points: 3 },
-      { pattern: /## 5\.|feature set|mvp/i, name: 'Feature Set', points: 5 },
-      { pattern: /## 8\.|tech stack/i, name: 'Tech Stack', points: 3 },
-      { pattern: /## 10\.|database schema/i, name: 'Database Schema', points: 5 },
-      { pattern: /## 11\.|api design/i, name: 'API Design', points: 5 },
-      { pattern: /## 12\.|authentication/i, name: 'Authentication', points: 4 },
-      { pattern: /## 19\.|testing/i, name: 'Testing Strategy', points: 5 },
-    ];
-    for (const sec of sections) {
-      const found = sec.pattern.test(plan);
-      if (found) score += sec.points;
-      checks.push({ name: sec.name, status: found ? 'pass' : 'missing', points: found ? sec.points : 0 });
-    }
-
-    // 3. Code structure (20 points)
-    const codeStructure = [
-      { path: 'src', points: 5, name: 'Source Directory' },
-      { path: 'tests', points: 5, name: 'Tests Directory' },
-      { path: 'prisma/schema.prisma', points: 5, name: 'Database Schema' },
-      { path: '.env.example', points: 5, name: 'Environment Template' },
-    ];
-    for (const cs of codeStructure) {
-      const exists = await fileExists(path.join(checkDir, cs.path));
-      if (exists) score += cs.points;
-      checks.push({ name: cs.name, status: exists ? 'pass' : 'missing', points: exists ? cs.points : 0 });
-    }
-
-    // 4. Code presence (20 points)
-    const jsFiles = await countFiles(checkDir, '.js') + await countFiles(checkDir, '.ts');
-    const testFiles = await countFiles(path.join(checkDir, 'tests'), '.js') + 
-                      await countFiles(path.join(checkDir, 'tests'), '.ts') +
-                      await countFiles(path.join(checkDir, '__tests__'), '.js');
-    
-    if (jsFiles > 0) { score += 10; checks.push({ name: 'Source Code', status: 'pass', points: 10 }); }
-    else { checks.push({ name: 'Source Code', status: 'missing', points: 0 }); }
-    
-    if (testFiles > 0) { score += 10; checks.push({ name: 'Test Files', status: 'pass', points: 10 }); }
-    else { checks.push({ name: 'Test Files', status: 'missing', points: 0 }); }
-
-    spinner.succeed('Alignment calculated');
-
-    // Determine grade
-    let grade, color;
-    if (score >= 90) { grade = 'A'; color = chalk.green; }
-    else if (score >= 80) { grade = 'B'; color = chalk.green; }
-    else if (score >= 70) { grade = 'C'; color = chalk.yellow; }
-    else if (score >= 60) { grade = 'D'; color = chalk.yellow; }
-    else { grade = 'F'; color = chalk.red; }
-
-    if (options.json) {
-      console.log(JSON.stringify({ score, grade, checks }, null, 2));
-      return;
-    }
-
-    console.log(chalk.cyan('\n╔═════════════════════════════════════╗'));
-    console.log(chalk.cyan('║') + chalk.bold('     Ultra-Dex Alignment Score      ') + chalk.cyan('║'));
-    console.log(chalk.cyan('╚═════════════════════════════════════╝\n'));
-
-    console.log(color.bold(`   Score: ${score}/100 (${grade})\n`));
-
-    // Group by status
-    const passed = checks.filter(c => c.status === 'pass');
-    const failed = checks.filter(c => c.status !== 'pass');
-
-    if (passed.length > 0) {
-      console.log(chalk.green('   ✅ Implemented:'));
-      passed.forEach(c => console.log(chalk.gray(`      • ${c.name} (+${c.points})`)));
-    }
-
-    if (failed.length > 0) {
-      console.log(chalk.yellow('\n   ⚠️  Missing:'));
-      failed.forEach(c => console.log(chalk.gray(`      • ${c.name}`)));
-    }
-
-    console.log(chalk.gray('\n   ─────────────────────────────────'));
-    console.log(chalk.cyan('   💡 Run `ultra-dex review` for detailed analysis'));
-    console.log(chalk.cyan('   💡 Run `ultra-dex build` to continue development\n'));
-  });
-
-// ========================================
-// WATCH COMMAND - Live Context Sync
-// ========================================
-program
-  .command('watch')
-  .description('Watch for file changes and keep context up to date')
-  .option('-d, --dir <directory>', 'Directory to watch', '.')
-  .option('--serve', 'Also start the MCP server')
-  .option('-p, --port <port>', 'Port for MCP server', '3001')
-  .action(async (options) => {
-    console.log(chalk.cyan('\n👁️  Ultra-Dex Watch Mode\n'));
-
-    const watchDir = path.resolve(options.dir);
-    
-    async function readFileSafe(fp) {
-      try { return await fs.readFile(fp, 'utf-8'); } catch { return null; }
-    }
-
-    async function getStats() {
-      const plan = await readFileSafe(path.join(watchDir, 'IMPLEMENTATION-PLAN.md'));
-      const context = await readFileSafe(path.join(watchDir, 'CONTEXT.md'));
-      
-      let stats = {
-        hasPlan: !!plan,
-        hasContext: !!context,
-        planSections: 0,
-        lastUpdate: new Date().toISOString(),
-      };
-
-      if (plan) {
-        const matches = plan.match(/## (SECTION|Section) \d+/gi);
-        stats.planSections = matches ? matches.length : 0;
-      }
-
-      return stats;
-    }
-
-    // Initial state
-    let lastStats = await getStats();
-    console.log(chalk.green('✓ Watching for changes...'));
-    console.log(chalk.gray(`  Directory: ${watchDir}`));
-    console.log(chalk.gray(`  Plan sections: ${lastStats.planSections}`));
-    console.log(chalk.gray(`  Press Ctrl+C to stop\n`));
-
-    // Track changes
-    let debounceTimer = null;
-    
-    fsWatch(watchDir, { recursive: true }, async (eventType, filename) => {
-      // Ignore certain files
-      if (!filename || 
-          filename.includes('node_modules') || 
-          filename.includes('.git') ||
-          filename.startsWith('.')) {
-        return;
-      }
-
-      // Debounce
-      if (debounceTimer) clearTimeout(debounceTimer);
-      debounceTimer = setTimeout(async () => {
-        const newStats = await getStats();
-        
-        // Check what changed
-        const changes = [];
-        if (newStats.hasPlan !== lastStats.hasPlan) {
-          changes.push(newStats.hasPlan ? '📄 Plan created' : '❌ Plan removed');
-        }
-        if (newStats.planSections !== lastStats.planSections) {
-          const diff = newStats.planSections - lastStats.planSections;
-          changes.push(`📊 Sections: ${lastStats.planSections} → ${newStats.planSections} (${diff > 0 ? '+' : ''}${diff})`);
-        }
-
-        if (changes.length > 0 || filename.endsWith('.md')) {
-          const time = new Date().toLocaleTimeString();
-          console.log(chalk.cyan(`[${time}]`) + chalk.gray(` ${filename}`));
-          changes.forEach(c => console.log(chalk.yellow(`  ${c}`)));
-        }
-
-        lastStats = newStats;
-      }, 500);
-    });
-
-    // Keep process alive
-    process.on('SIGINT', () => {
-      console.log(chalk.yellow('\n\n👋 Watch mode stopped.\n'));
-      process.exit(0);
-    });
-
-    // If --serve flag, also start MCP server
-    if (options.serve) {
-      const port = Number.parseInt(options.port, 10);
-      console.log(chalk.green(`\n🌐 Also starting MCP server on port ${port}...`));
-      console.log(chalk.gray(`   Access context at: http://localhost:${port}/context\n`));
-      
-      const server = http.createServer(async (req, res) => {
-        res.setHeader('Access-Control-Allow-Origin', '*');
-        
-        if (req.url === '/') {
-          res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ status: 'ok', mode: 'watch', stats: await getStats() }));
-          return;
-        }
-        
-        if (req.url === '/context') {
-          const [context, plan, quickStart] = await Promise.all([
-            readFileSafe(path.join(watchDir, 'CONTEXT.md')),
-            readFileSafe(path.join(watchDir, 'IMPLEMENTATION-PLAN.md')),
-            readFileSafe(path.join(watchDir, 'QUICK-START.md')),
-          ]);
-          res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({
-            meta: { timestamp: new Date().toISOString(), mode: 'watch' },
-            files: [
-              { label: 'CONTEXT.md', content: context || '' },
-              { label: 'IMPLEMENTATION-PLAN.md', content: plan || '' },
-              { label: 'QUICK-START.md', content: quickStart || '' },
-            ],
-          }));
-          return;
-        }
-        
-        res.writeHead(404);
-        res.end(JSON.stringify({ error: 'Not found' }));
-      });
-      
-      server.listen(port);
-    }
-
-    // Keep process running
-    await new Promise(() => {});
-  });
-
-// ========================================
-// STATE COMMAND - Machine-Readable State
-// ========================================
-program
-  .command('state')
-  .description('Output machine-readable project state (.ultra/state.json)')
-  .option('-d, --dir <directory>', 'Project directory', '.')
-  .option('--update', 'Update .ultra/state.json')
-  .option('--json', 'Output state to stdout')
-  .action(async (options) => {
-    const projectDir = path.resolve(options.dir);
-    const ultraDir = path.join(projectDir, '.ultra');
-    const statePath = path.join(ultraDir, 'state.json');
-
-    async function readFileSafe(fp) {
-      try { return await fs.readFile(fp, 'utf-8'); } catch { return null; }
-    }
-    async function fileExists(fp) {
-      try { await fs.access(fp); return true; } catch { return false; }
-    }
-
-    // Gather state
-    const plan = await readFileSafe(path.join(projectDir, 'IMPLEMENTATION-PLAN.md'));
-    const context = await readFileSafe(path.join(projectDir, 'CONTEXT.md'));
-    const pkg = await readFileSafe(path.join(projectDir, 'package.json'));
-
-    // Parse plan sections
-    let sections = [];
-    if (plan) {
-      const sectionMatches = plan.matchAll(/## (SECTION \d+|Section \d+)[:\s]*([^\n]*)/gi);
-      for (const match of sectionMatches) {
-        sections.push({ number: match[1], title: match[2].trim() });
-      }
-    }
-
-    // Parse package.json
-    let projectInfo = { name: 'unknown', version: '0.0.0' };
-    if (pkg) {
-      try {
-        const parsed = JSON.parse(pkg);
-        projectInfo = { name: parsed.name, version: parsed.version };
-      } catch {}
-    }
-
-    const state = {
-      version: '2.1.0',
-      timestamp: new Date().toISOString(),
-      project: projectInfo,
-      files: {
-        plan: { exists: !!plan, sections: sections.length },
-        context: { exists: !!context },
-        package: { exists: !!pkg },
-        tests: { exists: await fileExists(path.join(projectDir, 'tests')) },
-        prisma: { exists: await fileExists(path.join(projectDir, 'prisma/schema.prisma')) },
-      },
-      sections,
-      score: {
-        total: sections.length,
-        target: 34,
-        percentage: Math.round((sections.length / 34) * 100),
-      },
-    };
-
-    if (options.json) {
-      console.log(JSON.stringify(state, null, 2));
-      return;
-    }
-
-    if (options.update) {
-      await fs.mkdir(ultraDir, { recursive: true });
-      await fs.writeFile(statePath, JSON.stringify(state, null, 2));
-      console.log(chalk.green(`\n✅ Updated ${statePath}`));
-      console.log(chalk.gray(`   Sections: ${state.sections.length}/34`));
-      console.log(chalk.gray(`   Score: ${state.score.percentage}%\n`));
-      return;
-    }
-
-    // Display state
-    console.log(chalk.cyan('\n📊 Ultra-Dex Project State\n'));
-    console.log(chalk.white(`   Project: ${state.project.name} v${state.project.version}`));
-    console.log(chalk.white(`   Sections: ${state.sections.length}/34 (${state.score.percentage}%)`));
-    
-    console.log(chalk.white('\n   Files:'));
-    for (const [name, info] of Object.entries(state.files)) {
-      const icon = info.exists ? chalk.green('✅') : chalk.red('❌');
-      console.log(`     ${icon} ${name}`);
-    }
-
-    if (state.sections.length > 0) {
-      console.log(chalk.white('\n   Completed Sections:'));
-      state.sections.slice(0, 5).forEach(s => {
-        console.log(chalk.gray(`     • ${s.number}: ${s.title}`));
-      });
-      if (state.sections.length > 5) {
-        console.log(chalk.gray(`     ... and ${state.sections.length - 5} more`));
-      }
-    }
-
-    console.log(chalk.cyan('\n   💡 Run with --update to save to .ultra/state.json'));
-    console.log(chalk.cyan('   💡 Run with --json for machine output\n'));
-  });
-
-program.parse();
+program.parse();