ultra-dex 1.7.3 → 2.2.0

package/bin/ultra-dex.js

@@ -1,426 +1,43 @@
 #!/usr/bin/env node
 
 import { Command } from 'commander';
-import inquirer from 'inquirer';
-import chalk from 'chalk';
-import ora from 'ora';
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
+import { Command } from 'commander';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+import { banner } from '../lib/commands/banner.js';
+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 { registerServeCommand } from '../lib/commands/serve.js';
+import { registerWorkflowCommand } from '../lib/commands/workflows.js';
+import { registerSuggestCommand } from '../lib/commands/suggest.js';
+import { registerValidateCommand } from '../lib/commands/validate.js';
+import { registerHooksCommand } from '../lib/commands/hooks.js';
+import { registerFetchCommand } from '../lib/commands/fetch.js';
+import { registerSyncCommand } from '../lib/commands/sync.js';
 
 const program = new Command();
-
-// ASCII Art Banner
-const banner = `
-╔═══════════════════════════════════════════════════════════╗
-║                                                           ║
-║   ██╗   ██╗██╗  ████████╗██████╗  █████╗                 ║
-║   ██║   ██║██║  ╚══██╔══╝██╔══██╗██╔══██╗                ║
-║   ██║   ██║██║     ██║   ██████╔╝███████║                ║
-║   ██║   ██║██║     ██║   ██╔══██╗██╔══██║                ║
-║   ╚██████╔╝███████╗██║   ██║  ██║██║  ██║                ║
-║    ╚═════╝ ╚══════╝╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝                ║
-║                                                           ║
-║   ██████╗ ███████╗██╗  ██╗                               ║
-║   ██╔══██╗██╔════╝╚██╗██╔╝                               ║
-║   ██║  ██║█████╗   ╚███╔╝                                ║
-║   ██║  ██║██╔══╝   ██╔██╗                                ║
-║   ██████╔╝███████╗██╔╝ ██╗                               ║
-║   ╚═════╝ ╚══════╝╚═╝  ╚═╝                               ║
-║                                                           ║
-║   From Idea to Production-Ready SaaS                      ║
-║                                                           ║
-╚═══════════════════════════════════════════════════════════╝
-`;
-
-// Template content (embedded)
-const QUICK_START_TEMPLATE = `# {{PROJECT_NAME}} - Quick Start
-
-## 1. Your Idea (2 sentences max)
-
-**What:** {{IDEA_WHAT}}
-**For whom:** {{IDEA_FOR}}
-
-## 2. The Problem (3 bullets)
-
-- {{PROBLEM_1}}
-- {{PROBLEM_2}}
-- {{PROBLEM_3}}
-
-## 3. Core Production Features (5 max)
-
-| Feature | Priority | Justification |
-|---------|----------|---------------|
-| {{FEATURE_1}} | P0 | |
-| | P0 | |
-| | P1 | |
-| | P1 | |
-| | P2 | |
-
-## 4. Tech Stack
-
-| Layer | Your Choice |
-|-------|-------------|
-| Frontend | {{FRONTEND}} |
-| Database | {{DATABASE}} |
-| Auth | {{AUTH}} |
-| Payments | {{PAYMENTS}} |
-| Hosting | {{HOSTING}} |
-
-## 5. First 3 Tasks
-
-1. [ ] Set up project with chosen stack
-2. [ ] Implement core feature #1
-3. [ ] Deploy to staging
-
----
-
-**Next:** Fill out the full implementation plan using the Ultra-Dex template.
-`;
-
-const CONTEXT_TEMPLATE = `# {{PROJECT_NAME}} - Context
-
-## Project Overview
-**Name:** {{PROJECT_NAME}}
-**Started:** {{DATE}}
-**Status:** Planning
-
-## Quick Summary
-{{IDEA_WHAT}} for {{IDEA_FOR}}.
-
-## Key Decisions
-- Frontend: {{FRONTEND}}
-- Database: {{DATABASE}}
-- Auth: {{AUTH}}
-- Payments: {{PAYMENTS}}
-- Hosting: {{HOSTING}}
-
-## Current Focus
-Setting up the implementation plan.
-
-## Resources
-- [Ultra-Dex Template](https://github.com/Srujan0798/Ultra-Dex)
-- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
-`;
+program.banner = banner;
 
 program
   .name('ultra-dex')
   .description('CLI for Ultra-Dex SaaS Implementation Framework')
-  .version('1.7.1');
-
-program
-  .command('init')
-  .description('Initialize a new Ultra-Dex project')
-  .option('-n, --name <name>', 'Project name')
-  .option('-d, --dir <directory>', 'Output directory', '.')
-  .action(async (options) => {
-    console.log(chalk.cyan(banner));
-    console.log(chalk.bold('\nWelcome to Ultra-Dex! Let\'s plan your SaaS.\n'));
-
-    // Gather project info
-    const answers = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'projectName',
-        message: 'What\'s your project name?',
-        default: options.name || 'my-saas',
-        validate: (input) => input.length > 0 || 'Project name is required',
-      },
-      {
-        type: 'input',
-        name: 'ideaWhat',
-        message: 'What are you building? (1 sentence)',
-        validate: (input) => input.length > 0 || 'Please describe your idea',
-      },
-      {
-        type: 'input',
-        name: 'ideaFor',
-        message: 'Who is it for?',
-        validate: (input) => input.length > 0 || 'Please specify your target users',
-      },
-      {
-        type: 'input',
-        name: 'problem1',
-        message: 'Problem #1 you\'re solving:',
-        default: '',
-      },
-      {
-        type: 'input',
-        name: 'problem2',
-        message: 'Problem #2 you\'re solving:',
-        default: '',
-      },
-      {
-        type: 'input',
-        name: 'problem3',
-        message: 'Problem #3 you\'re solving:',
-        default: '',
-      },
-      {
-        type: 'input',
-        name: 'feature1',
-        message: 'Critical production feature:',
-        default: '',
-      },
-      {
-        type: 'list',
-        name: 'frontend',
-        message: 'Frontend framework:',
-        choices: ['Next.js', 'Remix', 'SvelteKit', 'Nuxt', 'Other'],
-      },
-      {
-        type: 'list',
-        name: 'database',
-        message: 'Database:',
-        choices: ['PostgreSQL', 'Supabase', 'MongoDB', 'PlanetScale', 'Other'],
-      },
-      {
-        type: 'list',
-        name: 'auth',
-        message: 'Authentication:',
-        choices: ['NextAuth', 'Clerk', 'Auth0', 'Supabase Auth', 'Other'],
-      },
-      {
-        type: 'list',
-        name: 'payments',
-        message: 'Payments:',
-        choices: ['Stripe', 'Lemonsqueezy', 'Paddle', 'None (free)', 'Other'],
-      },
-      {
-        type: 'list',
-        name: 'hosting',
-        message: 'Hosting:',
-        choices: ['Vercel', 'Railway', 'Fly.io', 'AWS', 'Other'],
-      },
-      {
-        type: 'confirm',
-        name: 'includeCursorRules',
-        message: 'Include cursor-rules for AI assistants? (Cursor, Copilot)',
-        default: true,
-      },
-      {
-        type: 'confirm',
-        name: 'includeFullTemplate',
-        message: 'Copy full 34-section template locally?',
-        default: false,
-      },
-      {
-        type: 'confirm',
-        name: 'includeDocs',
-        message: 'Copy VERIFICATION.md & AGENT-INSTRUCTIONS.md to docs/?',
-        default: true,
-      },
-      {
-        type: 'confirm',
-        name: 'includeAgents',
-        message: 'Include AI agent prompts? (.agents/ folder)',
-        default: true,
-      },
-    ]);
-
-    const spinner = ora('Creating project files...').start();
-
-    try {
-      const outputDir = path.resolve(options.dir, answers.projectName);
-
-      // Create directories
-      await fs.mkdir(outputDir, { recursive: true });
-      await fs.mkdir(path.join(outputDir, 'docs'), { recursive: true });
-
-      // Replace placeholders
-      const replacements = {
-        '{{PROJECT_NAME}}': answers.projectName,
-        '{{DATE}}': new Date().toISOString().split('T')[0],
-        '{{IDEA_WHAT}}': answers.ideaWhat,
-        '{{IDEA_FOR}}': answers.ideaFor,
-        '{{PROBLEM_1}}': answers.problem1 || 'Problem 1',
-        '{{PROBLEM_2}}': answers.problem2 || 'Problem 2',
-        '{{PROBLEM_3}}': answers.problem3 || 'Problem 3',
-        '{{FEATURE_1}}': answers.feature1 || 'Core feature',
-        '{{FRONTEND}}': answers.frontend,
-        '{{DATABASE}}': answers.database,
-        '{{AUTH}}': answers.auth,
-        '{{PAYMENTS}}': answers.payments,
-        '{{HOSTING}}': answers.hosting,
-      };
-
-      let quickStart = QUICK_START_TEMPLATE;
-      let context = CONTEXT_TEMPLATE;
-
-      for (const [key, value] of Object.entries(replacements)) {
-        quickStart = quickStart.replace(new RegExp(key, 'g'), value);
-        context = context.replace(new RegExp(key, 'g'), value);
-      }
-
-      // Write files
-      await fs.writeFile(path.join(outputDir, 'QUICK-START.md'), quickStart);
-      await fs.writeFile(path.join(outputDir, 'CONTEXT.md'), context);
-
-      // Create empty implementation plan
-      const planContent = `# ${answers.projectName} - Implementation Plan
-
-> Generated with Ultra-Dex CLI
-
-## Overview
-
-${answers.ideaWhat} for ${answers.ideaFor}.
-
----
-
-## Next Steps
-
-1. Open QUICK-START.md and complete the remaining sections
-2. Copy sections from the full Ultra-Dex template as needed
-3. Use the TaskFlow example as reference
-4. Start building!
-
-## Resources
-
-- [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md)
-- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
-- [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/03-METHODOLOGY.md)
-`;
-
-      await fs.writeFile(path.join(outputDir, 'IMPLEMENTATION-PLAN.md'), planContent);
-
-      // Copy cursor-rules if requested
-      if (answers.includeCursorRules) {
-        const rulesDir = path.join(outputDir, '.cursor', 'rules');
-        await fs.mkdir(rulesDir, { recursive: true });
-
-        const cursorRulesPath = path.resolve(__dirname, '../../cursor-rules');
-        try {
-          const ruleFiles = await fs.readdir(cursorRulesPath);
-          for (const file of ruleFiles.filter(f => f.endsWith('.mdc'))) {
-            await fs.copyFile(
-              path.join(cursorRulesPath, file),
-              path.join(rulesDir, file)
-            );
-          }
-        // Also generate .github/copilot-instructions.md for Copilot users
-          const coreRulePath = path.join(cursorRulesPath, '00-ultra-dex-core.mdc');
-          try {
-            const coreContent = await fs.readFile(coreRulePath, 'utf-8');
-            const dotGithub = path.join(outputDir, '.github');
-            await fs.mkdir(dotGithub, { recursive: true });
-            await fs.writeFile(path.join(dotGithub, 'copilot-instructions.md'), coreContent);
-          } catch (e) {
-            // Core rule not available - skip Copilot setup
-          }
-        } catch (err) {
-          // Cursor rules not bundled - intentional design choice for npm package size
-          console.log(chalk.gray('\n  📦 Cursor rules not bundled (keeps npm package <50KB)'));
-          console.log(chalk.cyan('  Quick setup: npx degit Srujan0798/Ultra-Dex/cursor-rules .cursor/rules'));
-          console.log(chalk.blue('  Or download: https://github.com/Srujan0798/Ultra-Dex/tree/main/cursor-rules'));
-        }
-      }
-
-      // Copy full template if requested
-      if (answers.includeFullTemplate) {
-        const templatePath = path.resolve(__dirname, '../../@ Ultra DeX/Saas plan/04-Imp-Template.md');
-        try {
-          await fs.copyFile(templatePath, path.join(outputDir, 'docs', 'MASTER-PLAN.md'));
-        } catch (err) {
-          // Template not bundled - keeps npm package lightweight
-          console.log(chalk.gray('\n  📦 Full template not bundled (5,500 lines - too large for npm)'));
-          console.log(chalk.cyan('  Quick fetch: curl -O https://raw.githubusercontent.com/Srujan0798/Ultra-Dex/main/%40%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md'));
-          console.log(chalk.blue('  Or view: https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md'));
-        }
-      }
-
-      // Copy docs if requested
-      if (answers.includeDocs) {
-        const verificationPath = path.resolve(__dirname, '../../docs/VERIFICATION.md');
-        const agentPath = path.resolve(__dirname, '../../agents/AGENT-INSTRUCTIONS.md');
-        try {
-          await fs.copyFile(verificationPath, path.join(outputDir, 'docs', 'CHECKLIST.md'));
-          await fs.copyFile(agentPath, path.join(outputDir, 'docs', 'AI-PROMPTS.md'));
-        } catch (err) {
-          // Docs not bundled - intentional for npm package size
-          console.log(chalk.gray('\n  📦 Verification & instructions not bundled (npm size optimization)'));
-          console.log(chalk.cyan('  Quick setup: npx degit Srujan0798/Ultra-Dex/docs docs'));
-          console.log(chalk.blue('  Or view: https://github.com/Srujan0798/Ultra-Dex/tree/main/docs'));
-        }
-      }
-
-      // Copy agents if requested
-      if (answers.includeAgents) {
-        const agentsDir = path.join(outputDir, '.agents');
-        await fs.mkdir(agentsDir, { recursive: true });
-
-        const agentsSourcePath = path.resolve(__dirname, '../../agents');
-        try {
-          // Copy tier directories and agent files
-          const tiers = ['1-leadership', '2-development', '3-security', '4-devops', '5-quality', '6-specialist'];
-          for (const tier of tiers) {
-            const tierDir = path.join(agentsDir, tier);
-            await fs.mkdir(tierDir, { recursive: true });
-
-            const tierPath = path.join(agentsSourcePath, tier);
-            const tierFiles = await fs.readdir(tierPath);
-            for (const file of tierFiles.filter(f => f.endsWith('.md'))) {
-              await fs.copyFile(
-                path.join(tierPath, file),
-                path.join(tierDir, file)
-              );
-            }
-          }
-
-          // Copy agent index and README
-          await fs.copyFile(
-            path.join(agentsSourcePath, '00-AGENT_INDEX.md'),
-            path.join(agentsDir, '00-AGENT_INDEX.md')
-          );
-          await fs.copyFile(
-            path.join(agentsSourcePath, 'README.md'),
-            path.join(agentsDir, 'README.md')
-          );
-        } catch (err) {
-          // Agents not bundled - intentional for npm package size
-          console.log(chalk.gray('\n  📦 Agent prompts not bundled (npm size optimization)'));
-          console.log(chalk.cyan('  Quick setup: npx degit Srujan0798/Ultra-Dex/agents .agents'));
-          console.log(chalk.blue('  Or view: https://github.com/Srujan0798/Ultra-Dex/tree/main/agents'));
-        }
-      }
-
-      spinner.succeed(chalk.green('Project created successfully!'));
-
-      console.log('\n' + chalk.bold('Files created:'));
-      console.log(chalk.gray(`  ${outputDir}/`));
-      console.log(chalk.gray('  ├── QUICK-START.md'));
-      console.log(chalk.gray('  ├── CONTEXT.md'));
-      console.log(chalk.gray('  ├── IMPLEMENTATION-PLAN.md'));
-      if (answers.includeFullTemplate) {
-        console.log(chalk.gray('  ├── docs/MASTER-PLAN.md (34 sections)'));
-      }
-      if (answers.includeDocs) {
-        console.log(chalk.gray('  ├── docs/CHECKLIST.md'));
-        console.log(chalk.gray('  ├── docs/AI-PROMPTS.md'));
-      }
-      if (answers.includeCursorRules) {
-        console.log(chalk.gray('  ├── .cursor/rules/ (11 AI rule files)'));
-      }
-      if (answers.includeAgents) {
-        console.log(chalk.gray('  └── .agents/ (15 AI agent prompts in 6 tiers)'));
-      }
-
-      console.log('\n' + chalk.bold('Next steps:'));
-      console.log(chalk.cyan(`  1. cd ${answers.projectName}`));
-      console.log(chalk.cyan('  2. Open QUICK-START.md and complete it'));
-      console.log(chalk.cyan('  3. Start building! 🚀'));
-
-      console.log('\n' + chalk.gray('Full Ultra-Dex repo:'));
-      console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex'));
-
-    } catch (error) {
-      spinner.fail(chalk.red('Failed to create project'));
-      console.error(error);
-      process.exit(1);
-    }
-  });
+  .version('2.0.1');
+
+registerInitCommand(program);
+registerAuditCommand(program);
+registerExamplesCommand(program);
+registerAgentsCommand(program);
+registerPlaceholderCommands(program);
+registerServeCommand(program);
+registerPackCommand(program);
+registerWorkflowCommand(program);
+registerSuggestCommand(program);
+registerValidateCommand(program);
+registerHooksCommand(program);
+registerFetchCommand(program);
+registerSyncCommand(program);
 
 program
   .command('audit')
@@ -634,6 +251,662 @@ program
     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')
@@ -649,7 +922,7 @@ program
     }
 
     // Try to read agent file
-    const agentPath = path.resolve(__dirname, '../../agents', 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`));
@@ -658,10 +931,19 @@ program
       console.log(chalk.gray('─'.repeat(60)));
       console.log(chalk.bold('\n📋 Copy the above prompt and paste into your AI tool.\n'));
     } catch (err) {
-      // Agent file not bundled (npm package) - show URL instead
-      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`));
+      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`));
+      }
     }
   });
 
@@ -683,12 +965,18 @@ program
     let output = '';
 
     // 1. Read Agent Prompt
-    const agentPath = path.resolve(__dirname, '../../agents', agent.file);
+    const agentPath = path.join(ASSETS_ROOT, 'agents', agent.file);
     try {
       const agentPrompt = await fs.readFile(agentPath, 'utf-8');
       output += agentPrompt + '\n\n';
     } catch (err) {
-      output += `# ${agent.name.toUpperCase()} Agent\n\nSee: https://github.com/Srujan0798/Ultra-Dex/blob/main/agents/${agent.file}\n\n`;
+      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';
@@ -1373,11 +1661,10 @@ program
       spinner.text = 'Fetching agent prompts...';
       const agentsDir = path.join(targetDir, 'agents');
 
-      const agentPaths = [
+    const agentPaths = [
         '00-AGENT_INDEX.md',
         'README.md',
         'AGENT-INSTRUCTIONS.md',
-        '0-orchestration/orchestrator.md',
         '1-leadership/cto.md',
         '1-leadership/planner.md',
         '1-leadership/research.md',
@@ -1474,4 +1761,373 @@ program
     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();