create-universal-ai-context 2.5.0 → 2.6.0-final

package/lib/index.js

@@ -1,399 +1,399 @@
-/**
- * Main orchestrator for create-ai-context
- *
- * Universal AI Context Engineering - supports Claude, Copilot, Cline, Antigravity.
- *
- * Handles the full installation flow:
- * 1. Interactive prompts (or defaults)
- * 2. Directory structure creation
- * 3. Template copying
- * 4. Environment detection (Claude Code or standalone)
- * 5. Tech stack detection
- * 6. Deep codebase analysis
- * 7. Template population with real data
- * 8. Placeholder replacement
- * 9. AI orchestration (if in Claude Code)
- * 10. Validation
- * 11. Plugin installation (optional)
- * 12. Git initialization (optional)
- */
-
-const path = require('path');
-const fs = require('fs');
-const chalk = require('chalk');
-const { runPrompts, getDefaults, runDiscoveryPrompts } = require('./prompts');
-const { createSpinner } = require('./spinner');
-const {
-  createDirectoryStructure,
-  copyTemplates,
-  createAiContextMd,
-  AI_CONTEXT_DIR,
-  AI_CONTEXT_FILE
-} = require('./installer');
-const { detectTechStack } = require('./detector');
-const { replacePlaceholders } = require('./placeholder');
-const { validateInstallation } = require('./validate');
-
-// New modules for context engineering initialization
-const { detectEnvironment, forceMode, getEnvironmentDescription } = require('./environment-detector');
-const { analyzeCodebase } = require('./static-analyzer');
-const {
-  createInitializationRequest,
-  generateAgentInstructions,
-  isInitializationPending
-} = require('./ai-orchestrator');
-const { populateAllTemplates } = require('./template-populator');
-const { generateAll: generateAllContexts, getSupportedTools } = require('./ai-context-generator');
-
-// Documentation discovery for existing docs detection
-const {
-  discoverExistingDocs,
-  formatDiscoverySummary,
-  buildMergedValues
-} = require('./doc-discovery');
-
-/**
- * Main entry point
- */
-async function run(options = {}) {
-  const {
-    projectName,
-    skipPrompts = false,
-    installPlugin = true,
-    template,
-    initGit = true,
-    dryRun = false,
-    verbose = false,
-    // AI tool selection
-    aiTools = ['claude', 'copilot', 'cline', 'antigravity'],
-    // Mode options
-    forceAi = false,
-    forceStatic = false,
-    analyzeOnly = false,
-    // Monorepo options
-    monorepo = false,
-    federate = false,
-    // Merge options (new)
-    mode = 'merge',  // 'merge' | 'overwrite' | 'interactive'
-    preserveCustom = true,
-    updateRefs = false,
-    backup = false,
-    // Force flag
-    force = false,
-    // Placeholder validation
-    failOnUnreplaced = false
-  } = options;
-
-  // Determine target directory
-  const targetDir = projectName
-    ? path.resolve(process.cwd(), projectName)
-    : process.cwd();
-
-  const projectNameResolved = projectName || path.basename(targetDir);
-  const contextDir = path.join(targetDir, AI_CONTEXT_DIR);
-
-  const spinner = createSpinner();
-
-  // ========================================
-  // Phase 0: Documentation Discovery
-  // ========================================
-  spinner.start('Scanning for existing documentation...');
-  let discovery = null;
-  let mergeStrategy = mode;
-  let discoveredValues = {};
-
-  try {
-    discovery = await discoverExistingDocs(targetDir);
-
-    if (discovery.hasExistingDocs) {
-      spinner.succeed('Found existing documentation');
-
-      if (verbose) {
-        console.log(chalk.gray(formatDiscoverySummary(discovery)));
-      }
-
-      // Handle discovery based on mode and prompts
-      if (!skipPrompts && mode !== 'overwrite') {
-        // Run discovery prompts
-        const discoveryAnswers = await runDiscoveryPrompts(discovery);
-
-        if (discoveryAnswers.existingDocsStrategy === 'skip') {
-          console.log(chalk.yellow('\nInitialization cancelled by user.\n'));
-          return;
-        }
-
-        mergeStrategy = discoveryAnswers.existingDocsStrategy;
-        discoveredValues = buildMergedValues(
-          discovery,
-          mergeStrategy,
-          discoveryAnswers.conflictResolutions || {}
-        );
-      } else if (mode === 'merge') {
-        // Auto-merge without prompts
-        discoveredValues = buildMergedValues(discovery, 'merge', {});
-      }
-
-      // Show what we're doing
-      if (mergeStrategy === 'merge') {
-        const valueCount = Object.keys(discoveredValues).length;
-        console.log(chalk.cyan(`  Preserving ${valueCount} values from existing docs`));
-      } else if (mergeStrategy === 'overwrite') {
-        console.log(chalk.yellow('  Overwrite mode: existing docs will be replaced'));
-      }
-    } else {
-      spinner.succeed('No existing documentation found - starting fresh');
-    }
-  } catch (error) {
-    spinner.warn(`Discovery partial: ${error.message}`);
-    discovery = { hasExistingDocs: false };
-  }
-
-  // ========================================
-  // Phase 1: Configuration (prompts or defaults)
-  // ========================================
-  let config;
-  if (skipPrompts) {
-    config = await getDefaults(targetDir, template);
-  } else {
-    config = await runPrompts(targetDir, template, discovery);
-  }
-
-  config.projectName = projectNameResolved;
-  config.targetDir = targetDir;
-  config.installPlugin = installPlugin && config.installPlugin;
-  config.initGit = initGit;
-  config.dryRun = dryRun;
-  config.verbose = verbose;
-  config.aiTools = aiTools;
-  config.monorepo = monorepo;
-  // Add merge config
-  config.mergeStrategy = mergeStrategy;
-  config.preserveCustom = preserveCustom;
-  config.updateRefs = updateRefs;
-  config.backup = backup;
-  config.discoveredValues = discoveredValues;
-  config.discovery = discovery;
-
-  if (dryRun) {
-    console.log(chalk.yellow('\n--dry-run mode: No changes will be made\n'));
-    console.log('Configuration:', JSON.stringify(config, null, 2));
-    if (discovery?.hasExistingDocs) {
-      console.log('\nDiscovery:', JSON.stringify({
-        tools: discovery.tools,
-        extractedValues: discovery.extractedValues,
-        conflicts: discovery.conflicts
-      }, null, 2));
-    }
-    return;
-  }
-
-  // Phase 2: Create target directory if needed
-  if (projectName && !fs.existsSync(targetDir)) {
-    spinner.start('Creating project directory...');
-    fs.mkdirSync(targetDir, { recursive: true });
-    spinner.succeed(`Created project directory: ${projectNameResolved}`);
-  }
-
-  // Phase 2: Detect execution environment
-  spinner.start('Detecting execution environment...');
-  let env;
-  if (forceAi) {
-    env = forceMode('full-ai');
-  } else if (forceStatic) {
-    env = forceMode('standalone');
-  } else {
-    env = detectEnvironment();
-  }
-  spinner.succeed(`Environment: ${getEnvironmentDescription(env)}`);
-
-  // Phase 3: Create .ai-context directory structure
-  spinner.start(`Creating ${AI_CONTEXT_DIR} directory structure...`);
-  const dirsCreated = await createDirectoryStructure(targetDir, config);
-  spinner.succeed(`Created ${AI_CONTEXT_DIR} directory structure (${dirsCreated} directories)`);
-
-  // Phase 4: Copy template files
-  spinner.start('Copying template files...');
-  const filesCopied = await copyTemplates(targetDir, config);
-  spinner.succeed(`Copied ${filesCopied} template files`);
-
-  // Phase 5: Detect technology stack
-  spinner.start('Detecting technology stack...');
-  const techStack = await detectTechStack(targetDir);
-  config.techStack = techStack;
-  spinner.succeed(`Detected: ${techStack.summary || 'Generic project'}`);
-
-  // Phase 6: Deep codebase analysis
-  spinner.start('Analyzing codebase...');
-  let analysis;
-  try {
-    analysis = await analyzeCodebase(targetDir, { techStack });
-    const summary = analysis.summary || {};
-    spinner.succeed(
-      `Analyzed: ${summary.totalFiles || 0} files, ` +
-      `${summary.entryPointCount || 0} entry points, ` +
-      `${summary.workflowCount || 0} workflows`
-    );
-  } catch (error) {
-    spinner.warn(`Analysis partial: ${error.message}`);
-    analysis = { workflows: [], entryPoints: [], architecture: {}, techStack };
-  }
-
-  // Add tech stack to analysis
-  analysis.techStack = techStack;
-
-  // Phase 7: Create AI_CONTEXT.md at root (before population)
-  spinner.start(`Creating ${AI_CONTEXT_FILE}...`);
-  await createAiContextMd(targetDir, config, techStack);
-  spinner.succeed(`Created ${AI_CONTEXT_FILE} at project root`);
-
-  // Phase 8: Populate templates with real data
-  spinner.start('Populating templates with analysis results...');
-  let populationResults;
-  try {
-    populationResults = await populateAllTemplates(contextDir, analysis, config);
-    const counts = {
-      populated: populationResults.populated?.length || 0,
-      created: populationResults.created?.length || 0,
-      errors: populationResults.errors?.length || 0
-    };
-    if (counts.errors > 0) {
-      spinner.warn(`Populated ${counts.populated} files, created ${counts.created} workflows (${counts.errors} errors)`);
-    } else {
-      spinner.succeed(`Populated ${counts.populated} files, created ${counts.created} workflow docs`);
-    }
-  } catch (error) {
-    spinner.warn(`Population partial: ${error.message}`);
-    populationResults = { populated: [], created: [], errors: [error.message] };
-  }
-
-  // Phase 9: Replace remaining placeholders
-  spinner.start('Replacing remaining placeholders...');
-  const placeholdersReplaced = await replacePlaceholders(targetDir, {
-    ...config,
-    techStack,
-    analysis,
-    failOnUnreplaced: config.failOnUnreplaced,
-    verbose: config.verbose
-  });
-  spinner.succeed(`Replaced ${placeholdersReplaced.totalReplaced} placeholders`);
-
-  // Phase 10: AI Orchestration (if in Claude Code environment)
-  if (env.mode === 'full-ai' || env.mode === 'hybrid') {
-    spinner.start('Preparing AI initialization request...');
-    try {
-      createInitializationRequest(contextDir, config);
-      generateAgentInstructions(contextDir, analysis, config);
-      spinner.succeed('Created INIT_REQUEST.md for @context-engineer');
-    } catch (error) {
-      spinner.warn(`AI setup skipped: ${error.message}`);
-    }
-  }
-
-  // Phase 11: Generate AI tool-specific context files
-  spinner.start('Generating AI tool context files...');
-  let generationResults;
-  try {
-    generationResults = await generateAllContexts(analysis, config, targetDir, {
-      aiTools: config.aiTools,
-      verbose: config.verbose,
-      force: config.force || false
-    });
-    const toolsGenerated = generationResults.generated.map(g => g.adapter).join(', ');
-    if (generationResults.success) {
-      spinner.succeed(`Generated context for: ${toolsGenerated} (${generationResults.summary.files} files)`);
-    } else {
-      spinner.warn(`Generated ${generationResults.summary.successful}/${generationResults.summary.total} tools`);
-    }
-  } catch (error) {
-    spinner.warn(`Context generation partial: ${error.message}`);
-    generationResults = { generated: [], errors: [error.message] };
-  }
-
-  // Phase 12: Validate installation
-  spinner.start('Validating installation...');
-  const validation = await validateInstallation(targetDir);
-  if (validation.passed) {
-    spinner.succeed('All validations passed');
-  } else {
-    spinner.warn(`Validation completed with ${validation.warnings} warnings`);
-  }
-
-  // Phase 13: Install plugin (optional)
-  if (config.installPlugin) {
-    spinner.start('Plugin ready...');
-    spinner.succeed('Plugin ready (install with: /plugin install ai-context-engineering)');
-  }
-
-  // Phase 14: Initialize git (optional)
-  if (config.initGit && !fs.existsSync(path.join(targetDir, '.git'))) {
-    spinner.start('Initializing git repository...');
-    try {
-      const { execSync } = require('child_process');
-      execSync('git init', { cwd: targetDir, stdio: 'pipe' });
-      spinner.succeed('Initialized git repository');
-    } catch (e) {
-      spinner.warn('Could not initialize git (git may not be installed)');
-    }
-  }
-
-  // Success message (mode-aware)
-  showSuccess(config, techStack, env, analysis, populationResults, generationResults);
-}
-
-/**
- * Display success message with next steps
- */
-function showSuccess(config, techStack, env, analysis, populationResults, generationResults) {
-  const boxWidth = 59;
-  const isAiMode = env.mode === 'full-ai' || env.mode === 'hybrid';
-  const workflowCount = analysis?.workflows?.length || 0;
-  const entryPointCount = analysis?.entryPoints?.length || 0;
-  const aiTools = config.aiTools || [];
-  const generatedTools = generationResults?.generated || [];
-
-  console.log(`
-${chalk.green('╔' + '═'.repeat(boxWidth) + '╗')}
-${chalk.green('║')}  ${chalk.bold.white('✓ AI Context Engineering Initialized Successfully!')}     ${chalk.green('║')}
-${chalk.green('╚' + '═'.repeat(boxWidth) + '╝')}
-
-${chalk.bold('Analysis Results:')}
-  ${chalk.cyan('•')} Entry Points:    ${chalk.white(entryPointCount)} discovered
-  ${chalk.cyan('•')} Workflows:       ${chalk.white(workflowCount)} documented
-  ${chalk.cyan('•')} Mode:            ${chalk.white(env.mode)}
-
-${chalk.bold('Created:')}
-  ${chalk.cyan('•')} ${AI_CONTEXT_DIR}/        ${chalk.gray('(context engineering system)')}
-  ${chalk.cyan('•')} ${AI_CONTEXT_FILE}       ${chalk.gray('(AI navigation guide)')}
-${workflowCount > 0 ? `  ${chalk.cyan('•')} ${workflowCount} workflow docs  ${chalk.gray('(auto-generated)')}` : ''}
-
-${chalk.bold('AI Tools Generated:')}
-${generatedTools.find(g => g.adapter === 'claude') ? `  ${chalk.green('✓')} Claude Code      ${chalk.gray('(' + AI_CONTEXT_FILE + ')')}` : (aiTools.includes('claude') ? `  ${chalk.yellow('○')} Claude Code      ${chalk.gray('(pending)')}` : '')}
-${generatedTools.find(g => g.adapter === 'copilot') ? `  ${chalk.green('✓')} GitHub Copilot   ${chalk.gray('(.github/copilot-instructions.md)')}` : (aiTools.includes('copilot') ? `  ${chalk.yellow('○')} GitHub Copilot   ${chalk.gray('(pending)')}` : '')}
-${generatedTools.find(g => g.adapter === 'cline') ? `  ${chalk.green('✓')} Cline            ${chalk.gray('(.clinerules)')}` : (aiTools.includes('cline') ? `  ${chalk.yellow('○')} Cline            ${chalk.gray('(pending)')}` : '')}
-${generatedTools.find(g => g.adapter === 'antigravity') ? `  ${chalk.green('✓')} Antigravity      ${chalk.gray('(.agent/ ' + (generatedTools.find(g => g.adapter === 'antigravity')?.files?.length || 0) + ' files)')}` : (aiTools.includes('antigravity') ? `  ${chalk.yellow('○')} Antigravity      ${chalk.gray('(pending)')}` : '')}
-
-${chalk.bold('Available Commands:')}
-  ${chalk.cyan('•')} /rpi-research     ${chalk.gray('Research a feature')}
-  ${chalk.cyan('•')} /rpi-plan         ${chalk.gray('Create implementation plan')}
-  ${chalk.cyan('•')} /rpi-implement    ${chalk.gray('Execute with documentation')}
-  ${chalk.cyan('•')} /validate-all     ${chalk.gray('Run validation suite')}
-`);
-
-  if (isAiMode) {
-    console.log(`${chalk.bold.yellow('AI Initialization Pending:')}
-  ${chalk.white('Run this command in Claude Code to complete:')}
-  ${chalk.cyan('@context-engineer "Complete initialization using INIT_REQUEST.md"')}
-`);
-  } else {
-    console.log(`${chalk.bold('Next Steps:')}
-  ${chalk.white('1.')} Review ${chalk.cyan(AI_CONTEXT_FILE)} and customize for your project
-  ${chalk.white('2.')} Review generated workflow docs in ${chalk.cyan(AI_CONTEXT_DIR + '/context/workflows/')}
-  ${chalk.white('3.')} Run ${chalk.cyan('@context-engineer "Enhance documentation"')} for AI analysis
-`);
-  }
-
-  console.log(`${chalk.gray('Documentation: https://github.com/SireJeff/claude-context-engineering-template')}
-`);
-}
-
-module.exports = { run };
+/**
+ * Main orchestrator for create-ai-context
+ *
+ * Universal AI Context Engineering - supports Claude, Copilot, Cline, Antigravity.
+ *
+ * Handles the full installation flow:
+ * 1. Interactive prompts (or defaults)
+ * 2. Directory structure creation
+ * 3. Template copying
+ * 4. Environment detection (Claude Code or standalone)
+ * 5. Tech stack detection
+ * 6. Deep codebase analysis
+ * 7. Template population with real data
+ * 8. Placeholder replacement
+ * 9. AI orchestration (if in Claude Code)
+ * 10. Validation
+ * 11. Plugin installation (optional)
+ * 12. Git initialization (optional)
+ */
+
+const path = require('path');
+const fs = require('fs');
+const chalk = require('chalk');
+const { runPrompts, getDefaults, runDiscoveryPrompts } = require('./prompts');
+const { createSpinner } = require('./spinner');
+const {
+  createDirectoryStructure,
+  copyTemplates,
+  createAiContextMd,
+  AI_CONTEXT_DIR,
+  AI_CONTEXT_FILE
+} = require('./installer');
+const { detectTechStack } = require('./detector');
+const { replacePlaceholders } = require('./placeholder');
+const { validateInstallation } = require('./validate');
+
+// New modules for context engineering initialization
+const { detectEnvironment, forceMode, getEnvironmentDescription } = require('./environment-detector');
+const { analyzeCodebase } = require('./static-analyzer');
+const {
+  createInitializationRequest,
+  generateAgentInstructions,
+  isInitializationPending
+} = require('./ai-orchestrator');
+const { populateAllTemplates } = require('./template-populator');
+const { generateAll: generateAllContexts, getSupportedTools } = require('./ai-context-generator');
+
+// Documentation discovery for existing docs detection
+const {
+  discoverExistingDocs,
+  formatDiscoverySummary,
+  buildMergedValues
+} = require('./doc-discovery');
+
+/**
+ * Main entry point
+ */
+async function run(options = {}) {
+  const {
+    projectName,
+    skipPrompts = false,
+    installPlugin = true,
+    template,
+    initGit = true,
+    dryRun = false,
+    verbose = false,
+    // AI tool selection
+    aiTools = ['claude', 'copilot', 'cline', 'antigravity'],
+    // Mode options
+    forceAi = false,
+    forceStatic = false,
+    analyzeOnly = false,
+    // Monorepo options
+    monorepo = false,
+    federate = false,
+    // Merge options (new)
+    mode = 'merge',  // 'merge' | 'overwrite' | 'interactive'
+    preserveCustom = true,
+    updateRefs = false,
+    backup = false,
+    // Force flag
+    force = false,
+    // Placeholder validation
+    failOnUnreplaced = false
+  } = options;
+
+  // Determine target directory
+  const targetDir = projectName
+    ? path.resolve(process.cwd(), projectName)
+    : process.cwd();
+
+  const projectNameResolved = projectName || path.basename(targetDir);
+  const contextDir = path.join(targetDir, AI_CONTEXT_DIR);
+
+  const spinner = createSpinner();
+
+  // ========================================
+  // Phase 0: Documentation Discovery
+  // ========================================
+  spinner.start('Scanning for existing documentation...');
+  let discovery = null;
+  let mergeStrategy = mode;
+  let discoveredValues = {};
+
+  try {
+    discovery = await discoverExistingDocs(targetDir);
+
+    if (discovery.hasExistingDocs) {
+      spinner.succeed('Found existing documentation');
+
+      if (verbose) {
+        console.log(chalk.gray(formatDiscoverySummary(discovery)));
+      }
+
+      // Handle discovery based on mode and prompts
+      if (!skipPrompts && mode !== 'overwrite') {
+        // Run discovery prompts
+        const discoveryAnswers = await runDiscoveryPrompts(discovery);
+
+        if (discoveryAnswers.existingDocsStrategy === 'skip') {
+          console.log(chalk.yellow('\nInitialization cancelled by user.\n'));
+          return;
+        }
+
+        mergeStrategy = discoveryAnswers.existingDocsStrategy;
+        discoveredValues = buildMergedValues(
+          discovery,
+          mergeStrategy,
+          discoveryAnswers.conflictResolutions || {}
+        );
+      } else if (mode === 'merge') {
+        // Auto-merge without prompts
+        discoveredValues = buildMergedValues(discovery, 'merge', {});
+      }
+
+      // Show what we're doing
+      if (mergeStrategy === 'merge') {
+        const valueCount = Object.keys(discoveredValues).length;
+        console.log(chalk.cyan(`  Preserving ${valueCount} values from existing docs`));
+      } else if (mergeStrategy === 'overwrite') {
+        console.log(chalk.yellow('  Overwrite mode: existing docs will be replaced'));
+      }
+    } else {
+      spinner.succeed('No existing documentation found - starting fresh');
+    }
+  } catch (error) {
+    spinner.warn(`Discovery partial: ${error.message}`);
+    discovery = { hasExistingDocs: false };
+  }
+
+  // ========================================
+  // Phase 1: Configuration (prompts or defaults)
+  // ========================================
+  let config;
+  if (skipPrompts) {
+    config = await getDefaults(targetDir, template);
+  } else {
+    config = await runPrompts(targetDir, template, discovery);
+  }
+
+  config.projectName = projectNameResolved;
+  config.targetDir = targetDir;
+  config.installPlugin = installPlugin && config.installPlugin;
+  config.initGit = initGit;
+  config.dryRun = dryRun;
+  config.verbose = verbose;
+  config.aiTools = aiTools;
+  config.monorepo = monorepo;
+  // Add merge config
+  config.mergeStrategy = mergeStrategy;
+  config.preserveCustom = preserveCustom;
+  config.updateRefs = updateRefs;
+  config.backup = backup;
+  config.discoveredValues = discoveredValues;
+  config.discovery = discovery;
+
+  if (dryRun) {
+    console.log(chalk.yellow('\n--dry-run mode: No changes will be made\n'));
+    console.log('Configuration:', JSON.stringify(config, null, 2));
+    if (discovery?.hasExistingDocs) {
+      console.log('\nDiscovery:', JSON.stringify({
+        tools: discovery.tools,
+        extractedValues: discovery.extractedValues,
+        conflicts: discovery.conflicts
+      }, null, 2));
+    }
+    return;
+  }
+
+  // Phase 2: Create target directory if needed
+  if (projectName && !fs.existsSync(targetDir)) {
+    spinner.start('Creating project directory...');
+    fs.mkdirSync(targetDir, { recursive: true });
+    spinner.succeed(`Created project directory: ${projectNameResolved}`);
+  }
+
+  // Phase 2: Detect execution environment
+  spinner.start('Detecting execution environment...');
+  let env;
+  if (forceAi) {
+    env = forceMode('full-ai');
+  } else if (forceStatic) {
+    env = forceMode('standalone');
+  } else {
+    env = detectEnvironment();
+  }
+  spinner.succeed(`Environment: ${getEnvironmentDescription(env)}`);
+
+  // Phase 3: Create .ai-context directory structure
+  spinner.start(`Creating ${AI_CONTEXT_DIR} directory structure...`);
+  const dirsCreated = await createDirectoryStructure(targetDir, config);
+  spinner.succeed(`Created ${AI_CONTEXT_DIR} directory structure (${dirsCreated} directories)`);
+
+  // Phase 4: Copy template files
+  spinner.start('Copying template files...');
+  const filesCopied = await copyTemplates(targetDir, config);
+  spinner.succeed(`Copied ${filesCopied} template files`);
+
+  // Phase 5: Detect technology stack
+  spinner.start('Detecting technology stack...');
+  const techStack = await detectTechStack(targetDir);
+  config.techStack = techStack;
+  spinner.succeed(`Detected: ${techStack.summary || 'Generic project'}`);
+
+  // Phase 6: Deep codebase analysis
+  spinner.start('Analyzing codebase...');
+  let analysis;
+  try {
+    analysis = await analyzeCodebase(targetDir, { techStack });
+    const summary = analysis.summary || {};
+    spinner.succeed(
+      `Analyzed: ${summary.totalFiles || 0} files, ` +
+      `${summary.entryPointCount || 0} entry points, ` +
+      `${summary.workflowCount || 0} workflows`
+    );
+  } catch (error) {
+    spinner.warn(`Analysis partial: ${error.message}`);
+    analysis = { workflows: [], entryPoints: [], architecture: {}, techStack };
+  }
+
+  // Add tech stack to analysis
+  analysis.techStack = techStack;
+
+  // Phase 7: Create AI_CONTEXT.md at root (before population)
+  spinner.start(`Creating ${AI_CONTEXT_FILE}...`);
+  await createAiContextMd(targetDir, config, techStack);
+  spinner.succeed(`Created ${AI_CONTEXT_FILE} at project root`);
+
+  // Phase 8: Populate templates with real data
+  spinner.start('Populating templates with analysis results...');
+  let populationResults;
+  try {
+    populationResults = await populateAllTemplates(contextDir, analysis, config);
+    const counts = {
+      populated: populationResults.populated?.length || 0,
+      created: populationResults.created?.length || 0,
+      errors: populationResults.errors?.length || 0
+    };
+    if (counts.errors > 0) {
+      spinner.warn(`Populated ${counts.populated} files, created ${counts.created} workflows (${counts.errors} errors)`);
+    } else {
+      spinner.succeed(`Populated ${counts.populated} files, created ${counts.created} workflow docs`);
+    }
+  } catch (error) {
+    spinner.warn(`Population partial: ${error.message}`);
+    populationResults = { populated: [], created: [], errors: [error.message] };
+  }
+
+  // Phase 9: Replace remaining placeholders
+  spinner.start('Replacing remaining placeholders...');
+  const placeholdersReplaced = await replacePlaceholders(targetDir, {
+    ...config,
+    techStack,
+    analysis,
+    failOnUnreplaced: config.failOnUnreplaced,
+    verbose: config.verbose
+  });
+  spinner.succeed(`Replaced ${placeholdersReplaced.totalReplaced} placeholders`);
+
+  // Phase 10: AI Orchestration (if in Claude Code environment)
+  if (env.mode === 'full-ai' || env.mode === 'hybrid') {
+    spinner.start('Preparing AI initialization request...');
+    try {
+      createInitializationRequest(contextDir, config);
+      generateAgentInstructions(contextDir, analysis, config);
+      spinner.succeed('Created INIT_REQUEST.md for @context-engineer');
+    } catch (error) {
+      spinner.warn(`AI setup skipped: ${error.message}`);
+    }
+  }
+
+  // Phase 11: Generate AI tool-specific context files
+  spinner.start('Generating AI tool context files...');
+  let generationResults;
+  try {
+    generationResults = await generateAllContexts(analysis, config, targetDir, {
+      aiTools: config.aiTools,
+      verbose: config.verbose,
+      force: config.force || false
+    });
+    const toolsGenerated = generationResults.generated.map(g => g.adapter).join(', ');
+    if (generationResults.success) {
+      spinner.succeed(`Generated context for: ${toolsGenerated} (${generationResults.summary.files} files)`);
+    } else {
+      spinner.warn(`Generated ${generationResults.summary.successful}/${generationResults.summary.total} tools`);
+    }
+  } catch (error) {
+    spinner.warn(`Context generation partial: ${error.message}`);
+    generationResults = { generated: [], errors: [error.message] };
+  }
+
+  // Phase 12: Validate installation
+  spinner.start('Validating installation...');
+  const validation = await validateInstallation(targetDir);
+  if (validation.passed) {
+    spinner.succeed('All validations passed');
+  } else {
+    spinner.warn(`Validation completed with ${validation.warnings} warnings`);
+  }
+
+  // Phase 13: Install plugin (optional)
+  if (config.installPlugin) {
+    spinner.start('Plugin ready...');
+    spinner.succeed('Plugin ready (install with: /plugin install ai-context-engineering)');
+  }
+
+  // Phase 14: Initialize git (optional)
+  if (config.initGit && !fs.existsSync(path.join(targetDir, '.git'))) {
+    spinner.start('Initializing git repository...');
+    try {
+      const { execSync } = require('child_process');
+      execSync('git init', { cwd: targetDir, stdio: 'pipe' });
+      spinner.succeed('Initialized git repository');
+    } catch (e) {
+      spinner.warn('Could not initialize git (git may not be installed)');
+    }
+  }
+
+  // Success message (mode-aware)
+  showSuccess(config, techStack, env, analysis, populationResults, generationResults);
+}
+
+/**
+ * Display success message with next steps
+ */
+function showSuccess(config, techStack, env, analysis, populationResults, generationResults) {
+  const boxWidth = 59;
+  const isAiMode = env.mode === 'full-ai' || env.mode === 'hybrid';
+  const workflowCount = analysis?.workflows?.length || 0;
+  const entryPointCount = analysis?.entryPoints?.length || 0;
+  const aiTools = config.aiTools || [];
+  const generatedTools = generationResults?.generated || [];
+
+  console.log(`
+${chalk.green('╔' + '═'.repeat(boxWidth) + '╗')}
+${chalk.green('║')}  ${chalk.bold.white('✓ AI Context Engineering Initialized Successfully!')}     ${chalk.green('║')}
+${chalk.green('╚' + '═'.repeat(boxWidth) + '╝')}
+
+${chalk.bold('Analysis Results:')}
+  ${chalk.cyan('•')} Entry Points:    ${chalk.white(entryPointCount)} discovered
+  ${chalk.cyan('•')} Workflows:       ${chalk.white(workflowCount)} documented
+  ${chalk.cyan('•')} Mode:            ${chalk.white(env.mode)}
+
+${chalk.bold('Created:')}
+  ${chalk.cyan('•')} ${AI_CONTEXT_DIR}/        ${chalk.gray('(context engineering system)')}
+  ${chalk.cyan('•')} ${AI_CONTEXT_FILE}       ${chalk.gray('(AI navigation guide)')}
+${workflowCount > 0 ? `  ${chalk.cyan('•')} ${workflowCount} workflow docs  ${chalk.gray('(auto-generated)')}` : ''}
+
+${chalk.bold('AI Tools Generated:')}
+${generatedTools.find(g => g.adapter === 'claude') ? `  ${chalk.green('✓')} Claude Code      ${chalk.gray('(' + AI_CONTEXT_FILE + ')')}` : (aiTools.includes('claude') ? `  ${chalk.yellow('○')} Claude Code      ${chalk.gray('(pending)')}` : '')}
+${generatedTools.find(g => g.adapter === 'copilot') ? `  ${chalk.green('✓')} GitHub Copilot   ${chalk.gray('(.github/copilot-instructions.md)')}` : (aiTools.includes('copilot') ? `  ${chalk.yellow('○')} GitHub Copilot   ${chalk.gray('(pending)')}` : '')}
+${generatedTools.find(g => g.adapter === 'cline') ? `  ${chalk.green('✓')} Cline            ${chalk.gray('(.clinerules)')}` : (aiTools.includes('cline') ? `  ${chalk.yellow('○')} Cline            ${chalk.gray('(pending)')}` : '')}
+${generatedTools.find(g => g.adapter === 'antigravity') ? `  ${chalk.green('✓')} Antigravity      ${chalk.gray('(.agent/ ' + (generatedTools.find(g => g.adapter === 'antigravity')?.files?.length || 0) + ' files)')}` : (aiTools.includes('antigravity') ? `  ${chalk.yellow('○')} Antigravity      ${chalk.gray('(pending)')}` : '')}
+
+${chalk.bold('Available Commands:')}
+  ${chalk.cyan('•')} /rpi-research     ${chalk.gray('Research a feature')}
+  ${chalk.cyan('•')} /rpi-plan         ${chalk.gray('Create implementation plan')}
+  ${chalk.cyan('•')} /rpi-implement    ${chalk.gray('Execute with documentation')}
+  ${chalk.cyan('•')} /validate-all     ${chalk.gray('Run validation suite')}
+`);
+
+  if (isAiMode) {
+    console.log(`${chalk.bold.yellow('AI Initialization Pending:')}
+  ${chalk.white('Run this command in Claude Code to complete:')}
+  ${chalk.cyan('@context-engineer "Complete initialization using INIT_REQUEST.md"')}
+`);
+  } else {
+    console.log(`${chalk.bold('Next Steps:')}
+  ${chalk.white('1.')} Review ${chalk.cyan(AI_CONTEXT_FILE)} and customize for your project
+  ${chalk.white('2.')} Review generated workflow docs in ${chalk.cyan(AI_CONTEXT_DIR + '/context/workflows/')}
+  ${chalk.white('3.')} Run ${chalk.cyan('@context-engineer "Enhance documentation"')} for AI analysis
+`);
+  }
+
+  console.log(`${chalk.gray('Documentation: https://github.com/SireJeff/claude-context-engineering-template')}
+`);
+}
+
+module.exports = { run };