ultra-dex 2.2.1 → 3.2.0

package/lib/commands/generate.js

@@ -10,11 +10,15 @@ import fs from 'fs/promises';
 import path from 'path';
 import { createProvider, getDefaultProvider, checkConfiguredProviders } from '../providers/index.js';
 import { SYSTEM_PROMPT, generateUserPrompt } from '../templates/prompts/generate-plan.js';
+import { validateSafePath } from '../utils/validation.js';
+import { githubTreeUrl, githubWebUrl } from '../config/urls.js';
+import { saveState } from './plan.js';
+import { getRandomMessage } from '../utils/messages.js';
 
 export function registerGenerateCommand(program) {
   program
     .command('generate [idea]')
-    .description('Generate a full implementation plan from an idea using AI')
+    .description('Create the plan (Thanos style) - AI Generates Full Plan')
     .option('-p, --provider <provider>', 'AI provider (claude, openai, gemini)')
     .option('-m, --model <model>', 'Specific model to use')
     .option('-o, --output <directory>', 'Output directory', '.')
@@ -22,14 +26,22 @@ export function registerGenerateCommand(program) {
     .option('--stream', 'Stream output in real-time', true)
     .option('--no-stream', 'Disable streaming')
     .action(async (idea, options) => {
-      console.log(chalk.cyan('\n🚀 Ultra-Dex Plan Generator\n'));
+      console.log(chalk.cyan('\n🚀 Ultra-Dex Plan Generator (Reality Stone Mode)\n'));
+      console.log(chalk.hex('#7c3aed').italic(`"${getRandomMessage('start')}"`));
+      console.log('');
+
+      const dirValidation = validateSafePath(options.output, 'Output directory');
+      if (dirValidation !== true) {
+        console.log(chalk.red(dirValidation));
+        process.exit(1);
+      }
 
       // Check configured providers
       const configured = checkConfiguredProviders();
       const hasProvider = configured.some(p => p.configured) || options.key;
 
       if (!hasProvider) {
-        console.log(chalk.yellow('⚠️  No AI provider configured.\n'));
+        console.log(chalk.yellow('⚠️  No Infinity Stones (AI Keys) configured.\n'));
         console.log(chalk.white('Set one of these environment variables:'));
         configured.forEach(p => {
           console.log(chalk.gray(`  export ${p.envKey}=your-key-here`));
@@ -45,7 +57,7 @@ export function registerGenerateCommand(program) {
           {
             type: 'input',
             name: 'idea',
-            message: 'Describe your SaaS idea:',
+            message: 'Describe the reality you wish to create:',
             validate: input => input.trim().length > 10 || 'Please provide a more detailed description',
           },
         ]);
@@ -76,7 +88,7 @@ export function registerGenerateCommand(program) {
       }
 
       // Generate the plan
-      const spinner = ora('Generating your implementation plan...').start();
+      const spinner = ora('Reshaping reality (Generating Plan)...').start();
       const startTime = Date.now();
 
       try {
@@ -85,7 +97,7 @@ export function registerGenerateCommand(program) {
 
         if (options.stream) {
           spinner.stop();
-          console.log(chalk.cyan('📝 Generating plan:\n'));
+          console.log(chalk.cyan('📝 Manifesting Reality:\n'));
           console.log(chalk.gray('─'.repeat(60)));
 
           result = await provider.generateStream(
@@ -119,99 +131,114 @@ export function registerGenerateCommand(program) {
         // Add header to plan
         const header = `# Implementation Plan
 
-> Generated by Ultra-Dex on ${new Date().toISOString().split('T')[0]}
-> Idea: "${idea}"
-
----
+> Generated by Ultra-Dex AI Plan Generator (Doomsday Edition)
 
 `;
-        await fs.writeFile(planPath, header + planContent);
+        if (!planContent.startsWith('#')) {
+          planContent = header + planContent;
+        }
+
+        await fs.writeFile(planPath, planContent);
+
+        // --- NEW: Generate state.json (ACTIVE SCALFOLDING) ---
+        const projectName = idea.split(' ').slice(0, 3).join('-').toLowerCase().replace(/[^a-z0-9-]/g, '');
+        
+        const state = {
+          project: {
+            name: projectName,
+            version: '0.1.0',
+            mode: 'AI-First',
+            idea: idea
+          },
+          phases: [
+            {
+              id: '1',
+              name: 'Phase 1: Foundation',
+              status: 'in_progress',
+              steps: [
+                { id: '1.1', task: 'Setup project boilerplate', status: 'pending' },
+                { id: '1.2', task: 'Database schema design', status: 'pending' },
+                { id: '1.3', task: 'Authentication implementation', status: 'pending' }
+              ]
+            },
+            {
+              id: '2',
+              name: 'Phase 2: Core Features',
+              status: 'pending',
+              steps: [
+                { id: '2.1', task: 'Implement primary feature loop', status: 'pending' },
+                { id: '2.2', task: 'API endpoint development', status: 'pending' }
+              ]
+            }
+          ],
+          agents: {
+            active: ['planner', 'cto'],
+            registry: ['planner', 'cto', 'backend', 'frontend', 'database', 'testing', 'reviewer']
+          }
+        };
+
+        await saveState(state);
 
         // Generate CONTEXT.md
         const contextContent = `# Project Context
 
-## Overview
+## Project Info
+**Created:** ${new Date().toLocaleDateString()}
+**Idea:** ${idea}
+**Status:** Planning
+
+## Summary
 ${idea}
 
-## Generated
-- Date: ${new Date().toISOString().split('T')[0]}
-- Provider: ${provider.getName()}
-- Model: ${provider.model}
-
-## Files
-- IMPLEMENTATION-PLAN.md - Full 34-section plan
-- QUICK-START.md - Quick reference
-- CONTEXT.md - This file
-
-## Usage
-Provide this context to any AI agent:
-\`\`\`
-Act as @Backend. Read CONTEXT.md and IMPLEMENTATION-PLAN.md first.
-Task: [your task]
-\`\`\`
+## Current Focus
+Review implementation plan and begin development.
+
+## Ultra-Dex Resources
+- Official Template: ${githubWebUrl()}
+- Documentation: ${githubTreeUrl('docs')}
 `;
+
         await fs.writeFile(contextPath, contextContent);
 
         // Generate QUICK-START.md
         const quickStartContent = `# Quick Start
 
-## Your Idea
+## Project Idea
 ${idea}
 
 ## Next Steps
-
-1. **Review the plan**: Open IMPLEMENTATION-PLAN.md
-2. **Load into AI**: Copy CONTEXT.md to your AI tool
-3. **Start building**: Use \`npx ultra-dex build\` or paste prompts
-
-## Useful Commands
-
-\`\`\`bash
-npx ultra-dex build              # Start AI-assisted build
-npx ultra-dex review             # Check code against plan
-npx ultra-dex serve              # Serve context via HTTP
-npx ultra-dex agents             # List available agents
-\`\`\`
-
-## Agent Quick Start
-
-\`\`\`
-@Planner - Break down tasks
-@Backend - API endpoints
-@Frontend - UI components
-@Database - Schema design
-@Auth - Authentication
-@Testing - Write tests
-\`\`\`
+1. Review IMPLEMENTATION-PLAN.md
+2. Start with the first feature
+3. Use Ultra-Dex agents for guidance
+
+## AI Agents (The Avengers)
+- @Planner (Nick Fury): Break down tasks
+- @CTO (Iron Man): Architecture decisions
+- @Backend (Thor): API logic
+- @Frontend (Spider-Man): UI components
+- @Testing (Ant-Man): QA and tests
 `;
-        await fs.writeFile(quickStartPath, quickStartContent);
-
-        // Print summary
-        console.log(chalk.green('\n✅ Plan generated successfully!\n'));
-        console.log(chalk.white('Files created:'));
-        console.log(chalk.gray(`  📄 ${planPath}`));
-        console.log(chalk.gray(`  📄 ${contextPath}`));
-        console.log(chalk.gray(`  📄 ${quickStartPath}`));
-
-        console.log(chalk.white('\nStats:'));
-        console.log(chalk.gray(`  ⏱️  Time: ${elapsed}s`));
-        console.log(chalk.gray(`  📊 Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out`));
-        console.log(chalk.gray(`  💰 Cost: ~$${cost.total.toFixed(4)}`));
 
-        console.log(chalk.cyan('\n📋 Next steps:'));
-        console.log(chalk.white('  1. Review IMPLEMENTATION-PLAN.md'));
-        console.log(chalk.white('  2. Run: npx ultra-dex build'));
-        console.log(chalk.white('  3. Start coding with AI agents\n'));
+        await fs.writeFile(quickStartPath, quickStartContent);
 
+        spinner.succeed(chalk.green('Reality successfully rewritten!'));
+
+        console.log(chalk.green('\n✅ Files created:'));
+        console.log(chalk.gray(`  ${planPath}`));
+        console.log(chalk.gray(`  ${contextPath}`));
+        console.log(chalk.gray(`  ${quickStartPath}`));
+        console.log(chalk.gray(`  .ultra/state.json (GOD MODE ACTIVE)`));
+        console.log(chalk.gray(`\n⏱️  Time: ${elapsed}s`));
+        console.log(chalk.gray(`💰 Est. cost: ${cost}`));
+
+        console.log(chalk.bold('\nNext steps:'));
+        console.log(chalk.cyan('  1. Review IMPLEMENTATION-PLAN.md'));
+        console.log(chalk.cyan('  2. Run `ultra-dex dashboard` to visualize your progress'));
+        console.log(chalk.cyan('  3. Run `ultra-dex build` to let Auto-Pilot take the first task'));
+        console.log(chalk.cyan('  4. Summon Avengers (AI agents) for guidance\n'));
       } catch (err) {
-        spinner.fail('Generation failed');
-        console.log(chalk.red(`\nError: ${err.message}`));
-
-        if (err.message.includes('API')) {
-          console.log(chalk.yellow('\nTip: Check your API key and try again.'));
-        }
+        spinner.fail(chalk.red('Failed to manifest reality'));
+        console.error(chalk.red('Error:'), err.message);
       }
     });
 }
-
-export default { registerGenerateCommand };

package/lib/commands/hooks.js

@@ -1,105 +1,280 @@
 import chalk from 'chalk';
 import fs from 'fs/promises';
 import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 export function registerHooksCommand(program) {
-  program
+  const hooks = program
     .command('hooks')
-    .description('Set up git hooks for automated verification')
-    .option('--remove', 'Remove Ultra-Dex git hooks')
+    .description('Manage Ultra-Dex git hooks for automated verification');
+
+  // Install subcommand
+  hooks
+    .command('install')
+    .description('Install Ultra-Dex pre-commit hook to .git/hooks/')
+    .option('--force', 'Overwrite existing hooks')
+    .option('--min-score <score>', 'Minimum alignment score (default: 70)', '70')
     .action(async (options) => {
-      console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Setup\n'));
+      console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Installation\n'));
+      await installHook(options);
+    });
 
-      const gitDir = path.join(process.cwd(), '.git');
-      const hooksDir = path.join(gitDir, 'hooks');
+  // Remove subcommand
+  hooks
+    .command('remove')
+    .alias('uninstall')
+    .description('Remove Ultra-Dex git hooks')
+    .action(async () => {
+      console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Removal\n'));
+      await removeHook();
+    });
 
-      try {
-        await fs.access(gitDir);
-      } catch {
-        console.log(chalk.red('❌ Not a git repository. Run "git init" first.\n'));
-        process.exit(1);
+  // Status subcommand
+  hooks
+    .command('status')
+    .description('Check if Ultra-Dex hooks are installed')
+    .action(async () => {
+      console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Status\n'));
+      await checkHookStatus();
+    });
+
+  // Default action (legacy support)
+  hooks
+    .option('--remove', 'Remove Ultra-Dex git hooks (deprecated: use "hooks remove")')
+    .action(async (options) => {
+      if (options.remove) {
+        console.log(chalk.cyan('\n🪝 Ultra-Dex Git Hooks Removal\n'));
+        await removeHook();
+      } else {
+        // Show help if no subcommand
+        hooks.outputHelp();
       }
+    });
+}
 
-      await fs.mkdir(hooksDir, { recursive: true });
+async function getGitHooksDir() {
+  const gitDir = path.join(process.cwd(), '.git');
+  const hooksDir = path.join(gitDir, 'hooks');
 
-      const preCommitPath = path.join(hooksDir, 'pre-commit');
+  try {
+    await fs.access(gitDir);
+  } catch {
+    console.log(chalk.red('❌ Not a git repository. Run "git init" first.\n'));
+    process.exit(1);
+  }
 
-      if (options.remove) {
-        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'));
-        }
+  await fs.mkdir(hooksDir, { recursive: true });
+  return hooksDir;
+}
+
+async function getPreCommitHookPath() {
+  // Try to find the bundled hook first
+  const possiblePaths = [
+    path.join(__dirname, '..', '..', 'assets', 'hooks', 'pre-commit'),
+    path.join(__dirname, '..', '..', '..', 'assets', 'hooks', 'pre-commit'),
+  ];
+
+  for (const hookPath of possiblePaths) {
+    try {
+      await fs.access(hookPath);
+      return hookPath;
+    } catch {
+      // Continue to next path
+    }
+  }
+
+  return null;
+}
+
+async function installHook(options) {
+  const hooksDir = await getGitHooksDir();
+  const preCommitPath = path.join(hooksDir, 'pre-commit');
+  const minScore = parseInt(options.minScore, 10) || 70;
+
+  // Try to use bundled hook
+  const bundledHookPath = await getPreCommitHookPath();
+  let hookScript;
+
+  if (bundledHookPath) {
+    hookScript = await fs.readFile(bundledHookPath, 'utf-8');
+    // Update minimum score if specified
+    hookScript = hookScript.replace(/MIN_ALIGNMENT_SCORE=\d+/, `MIN_ALIGNMENT_SCORE=${minScore}`);
+    console.log(chalk.gray(`  Using bundled hook from: ${bundledHookPath}`));
+  } else {
+    // Fallback to embedded script
+    hookScript = generatePreCommitScript(minScore);
+    console.log(chalk.gray('  Using embedded hook script'));
+  }
+
+  try {
+    const existing = await fs.readFile(preCommitPath, 'utf-8');
+    if (existing.includes('ultra-dex') || existing.includes('Ultra-Dex')) {
+      if (options.force) {
+        await fs.writeFile(preCommitPath, hookScript);
+        await fs.chmod(preCommitPath, '755');
+        console.log(chalk.green('✅ Ultra-Dex pre-commit hook updated (--force).\n'));
+      } else {
+        console.log(chalk.yellow('⚠️  Ultra-Dex pre-commit hook already exists.\n'));
+        console.log(chalk.gray('  Use --force to overwrite, or "hooks remove" first.\n'));
         return;
       }
+    } else {
+      // Append to existing hook
+      const combined = existing + '\n\n' + hookScript;
+      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 one
+    await fs.writeFile(preCommitPath, hookScript);
+    await fs.chmod(preCommitPath, '755');
+    console.log(chalk.green('✅ Pre-commit hook installed.\n'));
+  }
+
+  printHookInfo(minScore);
+}
 
-      const preCommitScript = `#!/bin/sh
-# Ultra-Dex Pre-Commit Hook
-# Validates project structure before allowing commits
-# Remove with: npx ultra-dex hooks --remove
+async function removeHook() {
+  const hooksDir = await getGitHooksDir();
+  const preCommitPath = path.join(hooksDir, 'pre-commit');
 
-echo "🔍 Ultra-Dex: Validating project structure..."
+  try {
+    const content = await fs.readFile(preCommitPath, 'utf-8');
+    if (content.includes('ultra-dex') || 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'));
+  }
+}
 
-# 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
+async function checkHookStatus() {
+  const hooksDir = await getGitHooksDir();
+  const preCommitPath = path.join(hooksDir, 'pre-commit');
+
+  try {
+    const content = await fs.readFile(preCommitPath, 'utf-8');
+    if (content.includes('ultra-dex') || content.includes('Ultra-Dex')) {
+      console.log(chalk.green('✅ Ultra-Dex pre-commit hook is installed.\n'));
+      
+      // Extract min score if present
+      const scoreMatch = content.match(/MIN_ALIGNMENT_SCORE=(\d+)/);
+      if (scoreMatch) {
+        console.log(chalk.gray(`  Minimum alignment score: ${scoreMatch[1]}%\n`));
+      }
+    } else {
+      console.log(chalk.yellow('⚠️  Pre-commit hook exists but is not from Ultra-Dex.\n'));
+    }
+  } catch {
+    console.log(chalk.gray('❌ No pre-commit hook installed.\n'));
+    console.log(chalk.cyan('  Install with: npx ultra-dex hooks install\n'));
+  }
+}
+
+function printHookInfo(minScore) {
+  console.log(chalk.bold('What this does:\n'));
+  console.log(chalk.gray(`  • Checks alignment score (minimum: ${minScore}%)`));
+  console.log(chalk.gray('  • Runs "ultra-dex validate" before each commit'));
+  console.log(chalk.gray('  • Blocks commits if validation fails'));
+  console.log(chalk.gray('  • Warns about missing documentation\n'));
+
+  console.log(chalk.bold('To bypass (not recommended):\n'));
+  console.log(chalk.cyan('  git commit --no-verify\n'));
+
+  console.log(chalk.bold('To check status:\n'));
+  console.log(chalk.cyan('  npx ultra-dex hooks status\n'));
+
+  console.log(chalk.bold('To remove:\n'));
+  console.log(chalk.cyan('  npx ultra-dex hooks remove\n'));
+}
+
+function generatePreCommitScript(minScore = 70) {
+  return `#!/bin/sh
+# Ultra-Dex Pre-Commit Hook v3.0
+# Validates project alignment and structure before allowing commits
+# Install with: npx ultra-dex hooks install
+# Remove with: npx ultra-dex hooks remove
+
+set -e
+
+echo ""
+echo "🎯 Ultra-Dex: Running pre-commit validation..."
+echo ""
+
+# Configuration
+MIN_ALIGNMENT_SCORE=${minScore}
+VALIDATION_LOG="/tmp/ultra-dex-validate.log"
+ALIGN_LOG="/tmp/ultra-dex-align.log"
+
+# Check if ultra-dex is available
+if ! command -v ultra-dex &> /dev/null && ! npx ultra-dex --version &> /dev/null 2>&1; then
+    echo "⚠️  Ultra-Dex not found. Skipping validation."
+    echo "   Install with: npm install -g ultra-dex"
+    exit 0
 fi
 
-# Check for required files
-if [ ! -f "QUICK-START.md" ]; then
-  echo "⚠️  Warning: QUICK-START.md not found"
+# Run alignment check and capture score
+echo "📊 Checking alignment score..."
+npx ultra-dex align --dir . > "$ALIGN_LOG" 2>&1 || true
+
+# Extract score from output
+SCORE=$(grep -oE '[0-9]+%' "$ALIGN_LOG" | head -1 | tr -d '%' || echo "0")
+
+if [ -z "$SCORE" ] || [ "$SCORE" = "0" ]; then
+    SCORE=$(grep -oE 'Score: [0-9]+' "$ALIGN_LOG" | grep -oE '[0-9]+' | head -1 || echo "85")
 fi
 
-if [ ! -f "IMPLEMENTATION-PLAN.md" ]; then
-  echo "⚠️  Warning: IMPLEMENTATION-PLAN.md not found"
+echo "   Current alignment score: \${SCORE}%"
+
+# Check minimum score threshold
+if [ "$SCORE" -lt "$MIN_ALIGNMENT_SCORE" ]; then
+    echo ""
+    echo "❌ COMMIT BLOCKED: Alignment score (\$SCORE%) is below minimum ($MIN_ALIGNMENT_SCORE%)"
+    echo ""
+    echo "📋 To fix this:"
+    echo "   1. Run: npx ultra-dex validate"
+    echo "   2. Run: npx ultra-dex fix (to auto-fix issues)"
+    echo "   3. Review and commit again"
+    echo ""
+    echo "🔓 To bypass (not recommended):"
+    echo "   git commit --no-verify"
+    echo ""
+    exit 1
 fi
 
-echo "✅ Ultra-Dex validation passed."
-exit 0
-`;
+# Run validation
+echo "🔍 Running validation checks..."
+npx ultra-dex validate --dir . --scan > "$VALIDATION_LOG" 2>&1
+VALIDATE_RESULT=$?
 
-      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 {
-          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 {
-        await fs.writeFile(preCommitPath, preCommitScript);
-        await fs.chmod(preCommitPath, '755');
-        console.log(chalk.green('✅ Pre-commit hook installed.\n'));
-      }
+if [ $VALIDATE_RESULT -ne 0 ]; then
+    echo ""
+    echo "❌ COMMIT BLOCKED: Validation failed"
+    echo ""
+    cat "$VALIDATION_LOG"
+    echo ""
+    echo "📋 Run 'npx ultra-dex validate' for details"
+    echo "🔓 To bypass: git commit --no-verify"
+    echo ""
+    exit 1
+fi
 
-      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'));
+# Success
+echo ""
+echo "✅ Ultra-Dex validation passed!"
+echo "   Score: \${SCORE}% (minimum: $MIN_ALIGNMENT_SCORE%)"
+echo ""
 
-      console.log(chalk.bold('To bypass (not recommended):\n'));
-      console.log(chalk.cyan('  git commit --no-verify\n'));
+# Cleanup
+rm -f "$VALIDATION_LOG" "$ALIGN_LOG" 2>/dev/null || true
 
-      console.log(chalk.bold('To remove:\n'));
-      console.log(chalk.cyan('  npx ultra-dex hooks --remove\n'));
-    });
+exit 0
+`;
 }