ultra-dex 2.2.0 → 3.1.0

package/lib/commands/generate.js

@@ -10,6 +10,9 @@ 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';
 
 export function registerGenerateCommand(program) {
   program
@@ -24,6 +27,12 @@ export function registerGenerateCommand(program) {
     .action(async (idea, options) => {
       console.log(chalk.cyan('\n🚀 Ultra-Dex Plan Generator\n'));
 
+      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;
@@ -119,99 +128,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
 
 `;
-        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
+- @Planner: Break down tasks
+- @CTO: Architecture decisions
+- @Backend: API logic
+- @Frontend: UI components
+- @Testing: 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('Plan generated successfully!');
+
+        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. Use AI agents for specialized 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('Failed to generate plan');
+        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
+`;
 }

package/lib/commands/init.js

@@ -7,9 +7,16 @@ import path from 'path';
 import { QUICK_START_TEMPLATE } from '../templates/quick-start.js';
 import { CONTEXT_TEMPLATE } from '../templates/context.js';
 import { validateProjectName, validateSafePath } from '../utils/validation.js';
-import { ASSETS_ROOT, ROOT_FALLBACK } from '../config/paths.js';
+import { ASSETS_ROOT, ROOT_FALLBACK, LIVE_TEMPLATES_ROOT } from '../config/paths.js';
 import { githubBlobUrl, githubWebUrl } from '../config/urls.js';
 import { copyWithFallback, listWithFallback, readWithFallback } from '../utils/fallback.js';
+import { copyDirectory, pathExists } from '../utils/files.js';
+
+const LIVE_STACKS = {
+  'next15-prisma-clerk': 'Next.js 15 + Prisma + Clerk',
+  'remix-supabase': 'Remix + Supabase',
+  'sveltekit-drizzle': 'SvelteKit + Drizzle',
+};
 
 export function registerInitCommand(program) {
   program
@@ -18,6 +25,8 @@ export function registerInitCommand(program) {
     .option('-n, --name <name>', 'Project name')
     .option('-d, --dir <directory>', 'Output directory', '.')
     .option('--preview', 'Preview files without creating them')
+    .option('--live', 'Generate a runnable scaffold')
+    .option('--stack <preset>', 'Preset: next15-prisma-clerk, remix-supabase, sveltekit-drizzle')
     .action(async (options) => {
       console.log(chalk.cyan(program.banner));
       console.log(chalk.bold('\nWelcome to Ultra-Dex! Let\'s plan your SaaS.\n'));
@@ -39,6 +48,49 @@ export function registerInitCommand(program) {
         process.exit(1);
       }
 
+      if (options.live) {
+        const preset = options.stack || 'next15-prisma-clerk';
+        if (!LIVE_STACKS[preset]) {
+          console.log(chalk.red(`Unknown preset: ${preset}`));
+          console.log(chalk.gray(`Available presets: ${Object.keys(LIVE_STACKS).join(', ')}`));
+          process.exit(1);
+        }
+
+        const outputDir = path.resolve(options.dir);
+        if (await pathExists(outputDir, 'dir')) {
+          const existing = await fs.readdir(outputDir);
+          if (existing.length > 0) {
+            console.log(chalk.red('Target directory is not empty.'));
+            process.exit(1);
+          }
+        }
+
+        const liveSourcePath = path.join(LIVE_TEMPLATES_ROOT, preset);
+        const fallbackLivePath = path.join(ROOT_FALLBACK, 'cli', 'assets', 'live-templates', preset);
+        let sourcePath = liveSourcePath;
+        try {
+          await fs.access(liveSourcePath);
+        } catch {
+          sourcePath = fallbackLivePath;
+        }
+
+        const spinner = ora(`Generating ${LIVE_STACKS[preset]} scaffold...`).start();
+        try {
+          await copyDirectory(sourcePath, outputDir);
+          spinner.succeed(chalk.green('Live scaffold created successfully!'));
+          console.log(chalk.gray(`\nPreset: ${preset}`));
+          console.log(chalk.gray(`Next steps:`));
+          console.log(chalk.cyan(`  1. cd ${outputDir}`));
+          console.log(chalk.cyan('  2. npm install'));
+          console.log(chalk.cyan('  3. npm run dev\n'));
+        } catch (error) {
+          spinner.fail(chalk.red('Failed to create live scaffold'));
+          console.error(`[init] ${error?.message ?? error}`);
+          process.exit(1);
+        }
+        return;
+      }
+
       const answers = await inquirer.prompt([
         {
           type: 'input',
@@ -207,12 +259,10 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
           const cursorRulesPath = path.join(ASSETS_ROOT, 'cursor-rules');
           const fallbackRulesPath = path.join(ROOT_FALLBACK, 'cursor-rules');
           try {
-            const ruleFiles = await listWithFallback(cursorRulesPath, fallbackRulesPath);
-            const sourcePath = ruleFiles ? cursorRulesPath : fallbackRulesPath;
+            const { files: ruleFiles, sourcePath } = await listWithFallback(cursorRulesPath, fallbackRulesPath);
             for (const file of ruleFiles.filter(f => f.endsWith('.mdc'))) {
-              await copyWithFallback(
+              await fs.copyFile(
                 path.join(sourcePath, file),
-                null,
                 path.join(rulesDir, file)
               );
             }
@@ -330,7 +380,7 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
         console.log(chalk.blue(`  ${githubWebUrl()}`));
       } catch (error) {
         spinner.fail(chalk.red('Failed to create project'));
-        console.error(error);
+        console.error(`[init] ${error?.message ?? error}`);
         process.exit(1);
       }
     });