aios-core 2.1.0

package/bin/aios-init.js

@@ -0,0 +1,736 @@
+#!/usr/bin/env node
+
+/**
+ * AIOS-FullStack Installation Wizard v5
+ * Based on the original beautiful visual design with ASCII art
+ * Version: 2.1.0
+ *
+ * Supported IDEs (8 total):
+ * - Claude Code, Cursor, Windsurf, Trae, Roo Code, Cline, Gemini CLI, GitHub Copilot
+ */
+
+const path = require('path');
+const fs = require('fs');
+const fse = require('fs-extra');
+const yaml = require('yaml');
+const { execSync } = require('child_process');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+// ASCII Art Banner (Clean blocky style like reference image)
+const BANNER = chalk.cyan(`
+  █████╗ ██╗ ██████╗ ███████╗      ███████╗██╗   ██╗██╗     ██╗     ███████╗████████╗ █████╗  ██████╗██╗  ██╗
+ ██╔══██╗██║██╔═══██╗██╔════╝      ██╔════╝██║   ██║██║     ██║     ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
+ ███████║██║██║   ██║███████╗█████╗█████╗  ██║   ██║██║     ██║     ███████╗   ██║   ███████║██║     █████╔╝
+ ██╔══██║██║██║   ██║╚════██║╚════╝██╔══╝  ██║   ██║██║     ██║     ╚════██║   ██║   ██╔══██║██║     ██╔═██╗
+ ██║  ██║██║╚██████╔╝███████║      ██║     ╚██████╔╝███████╗███████╗███████║   ██║   ██║  ██║╚██████╗██║  ██╗
+ ╚═╝  ╚═╝╚═╝ ╚═════╝ ╚══════╝      ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
+`);
+
+const SUBTITLE = chalk.magenta('🚀 Universal AI Agent Framework for Any Domain');
+// Read version from package.json dynamically
+const packageJsonVersion = require(path.join(__dirname, '..', 'package.json')).version;
+const VERSION = chalk.yellow(`✨ Installer v${packageJsonVersion}`);
+
+/**
+ * Smart path resolution for AIOS Core modules
+ */
+function resolveAiosCoreModule(modulePath) {
+  const aiosCoreModule = path.join(__dirname, '..', '.aios-core', modulePath);
+
+  const moduleExists = fs.existsSync(aiosCoreModule + '.js') ||
+                       fs.existsSync(aiosCoreModule + '/index.js') ||
+                       fs.existsSync(aiosCoreModule);
+
+  if (!moduleExists) {
+    throw new Error(
+      `Cannot find AIOS Core module: ${modulePath}\n` +
+      `Searched: ${aiosCoreModule}\n` +
+      'Please ensure aios-fullstack is installed correctly.',
+    );
+  }
+
+  return require(aiosCoreModule);
+}
+
+// Load AIOS Core modules
+const { detectRepositoryContext } = resolveAiosCoreModule('scripts/repository-detector');
+// PM adapters imported but not used directly (loaded dynamically)
+// const { ClickUpAdapter } = resolveAiosCoreModule('utils/pm-adapters/clickup-adapter');
+// const { GitHubProjectsAdapter } = resolveAiosCoreModule('utils/pm-adapters/github-adapter');
+// const { JiraAdapter } = resolveAiosCoreModule('utils/pm-adapters/jira-adapter');
+
+async function main() {
+  console.clear();
+
+  // Check for minimal mode flag
+  const isMinimalMode = process.argv.includes('--minimal');
+
+  // Display beautiful banner
+  console.log(BANNER);
+  console.log(SUBTITLE);
+  console.log(VERSION);
+  if (isMinimalMode) {
+    console.log(chalk.yellow('   🔹 Minimal Installation Mode'));
+  }
+  console.log('');
+  console.log(chalk.gray('═'.repeat(80)));
+  console.log('');
+
+  const projectRoot = process.cwd();
+  let context = detectRepositoryContext();
+
+  // Setup prerequisites if needed
+  if (!context) {
+    console.log(chalk.blue('⚙️  Setting up project prerequisites...\n'));
+
+    // Check for git repository
+    let hasGit = false;
+    try {
+      execSync('git rev-parse --git-dir', { cwd: projectRoot, stdio: 'ignore' });
+      hasGit = true;
+    } catch (_err) {
+      // Not a git repo
+    }
+
+    if (!hasGit) {
+      try {
+        execSync('git init', { cwd: projectRoot, stdio: 'ignore' });
+        console.log(chalk.green('✓') + ' Git repository initialized');
+      } catch (_err) {
+        console.error(chalk.red('✗') + ' Failed to initialize git repository');
+        process.exit(1);
+      }
+    }
+
+    // Check for package.json
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+      const dirName = path.basename(projectRoot);
+      const defaultPackage = {
+        name: dirName.toLowerCase().replace(/\s+/g, '-'),
+        version: '1.0.0',
+        description: 'AIOS-FullStack project',
+        main: 'index.js',
+        scripts: { test: 'echo "Error: no test specified" && exit 1' },
+        keywords: [],
+        author: '',
+        license: 'ISC',
+      };
+      fs.writeFileSync(packageJsonPath, JSON.stringify(defaultPackage, null, 2));
+      console.log(chalk.green('✓') + ' package.json created');
+    }
+
+    console.log(chalk.green('✓') + ' Prerequisites ready\n');
+
+    // Try to detect context again
+    context = detectRepositoryContext();
+
+    // If still no context, create minimal one
+    if (!context) {
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+      context = {
+        projectRoot,
+        packageName: packageJson.name,
+        packageVersion: packageJson.version,
+        repositoryUrl: 'local-repository',
+        frameworkLocation: path.join(__dirname, '..'),
+      };
+    }
+  }
+
+  console.log(chalk.cyan('📦 Package:') + ` ${context.packageName}`);
+  console.log('');
+
+  // Step 1: Installation Mode
+  console.log(chalk.gray('─'.repeat(80)));
+  const { installMode } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'installMode',
+      message: chalk.white('How are you using AIOS-FullStack?'),
+      choices: [
+        {
+          name: '  Using AIOS in a project ' + chalk.gray('(Framework files added to .gitignore)'),
+          value: 'project-development',
+        },
+        {
+          name: '  Developing AIOS framework itself ' + chalk.gray('(Framework files are source code)'),
+          value: 'framework-development',
+        },
+      ],
+    },
+  ]);
+
+  // Save installation config
+  const config = {
+    installation: {
+      mode: installMode,
+      detected_at: new Date().toISOString(),
+    },
+    repository: {
+      url: context.repositoryUrl,
+      auto_detect: true,
+    },
+    framework: {
+      source: installMode === 'framework-development' ? 'local' : 'npm',
+      version: context.packageVersion,
+      location: context.frameworkLocation,
+    },
+    git_ignore_rules: {
+      mode: installMode,
+      ignore_framework_files: installMode === 'project-development',
+    },
+  };
+
+  const configPath = path.join(context.projectRoot, '.aios-installation-config.yaml');
+  fs.writeFileSync(configPath, yaml.stringify(config));
+
+  // Update .gitignore
+  updateGitIgnore(installMode, context.projectRoot);
+
+  // Step 2: PM Tool
+  console.log('');
+  const { pmTool } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'pmTool',
+      message: chalk.white('Do you use a project management tool?'),
+      choices: [
+        { name: '  None (local YAML files only) ' + chalk.gray('- Recommended'), value: 'local' },
+        { name: '  ClickUp ' + chalk.gray('- Requires API token'), value: 'clickup' },
+        { name: '  GitHub Projects ' + chalk.gray('- Uses gh auth'), value: 'github-projects' },
+        { name: '  Jira ' + chalk.gray('- Requires API token'), value: 'jira' },
+      ],
+    },
+  ]);
+
+  // Save PM config
+  savePMConfig(pmTool, {}, context.projectRoot);
+
+  // Step 3: IDE Selection (CHECKBOX with instructions)
+  console.log('');
+  console.log(chalk.gray('─'.repeat(80)));
+  console.log(chalk.dim('  Press <space> to select, <a> to toggle all, <i> to invert selection, and <enter> to proceed'));
+  console.log('');
+
+  const { ides } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'ides',
+      message: chalk.white('Which IDE(s) will you use?'),
+      choices: [
+        { name: '  Claude Code ' + chalk.blue('(v2.1)') + chalk.gray(' - Recommended'), value: 'claude', checked: true },
+        { name: '  Cursor ' + chalk.blue('(v2.1)'), value: 'cursor' },
+        { name: '  Windsurf ' + chalk.blue('(v2.1)'), value: 'windsurf' },
+        { name: '  Trae ' + chalk.blue('(v2.1)'), value: 'trae' },
+        { name: '  Roo Code ' + chalk.blue('(v2.1)'), value: 'roo' },
+        { name: '  Cline ' + chalk.blue('(v2.1)'), value: 'cline' },
+        { name: '  Gemini CLI ' + chalk.blue('(v2.1)'), value: 'gemini' },
+        { name: '  GitHub Copilot ' + chalk.blue('(v2.1)'), value: 'github-copilot' },
+        { name: '  AntiGravity ' + chalk.blue('(v2.1)') + chalk.gray(' - Google AI IDE'), value: 'antigravity' },
+        new inquirer.Separator(chalk.gray('─'.repeat(40))),
+        { name: '  Skip IDE setup', value: 'none' },
+      ],
+      validate: function(answer) {
+        if (answer.length < 1) {
+          return 'You must choose at least one option.';
+        }
+        return true;
+      },
+    },
+  ]);
+
+  // Step 4: Copy AIOS Core files
+  console.log('');
+  console.log(chalk.blue('📦 Installing AIOS Core files...'));
+
+  const sourceCoreDir = path.join(context.frameworkLocation, '.aios-core');
+  const targetCoreDir = path.join(context.projectRoot, '.aios-core');
+
+  if (fs.existsSync(sourceCoreDir)) {
+    await fse.copy(sourceCoreDir, targetCoreDir);
+    console.log(chalk.green('✓') + ' AIOS Core files installed ' + chalk.gray('(11 agents, 68 tasks, 23 templates)'));
+  } else {
+    console.error(chalk.red('✗') + ' AIOS Core files not found');
+    process.exit(1);
+  }
+
+  // Copy IDE rules and commands if IDE was selected
+  if (!ides.includes('none')) {
+    console.log('');
+    console.log(chalk.blue('📝 Installing IDE configurations...'));
+
+    const ideRulesMap = {
+      'claude': { source: 'claude-rules.md', target: '.claude/CLAUDE.md' },
+      'cursor': { source: 'cursor-rules.md', target: '.cursor/rules.md' },
+      'windsurf': { source: 'windsurf-rules.md', target: '.windsurf/rules.md' },
+      'trae': { source: 'trae-rules.md', target: '.trae/rules.md' },
+      'roo': { source: 'roo-rules.md', target: '.roomodes' },
+      'cline': { source: 'cline-rules.md', target: '.cline/rules.md' },
+      'gemini': { source: 'gemini-rules.md', target: '.gemini/rules.md' },
+      'github-copilot': { source: 'copilot-rules.md', target: '.github/chatmodes/aios-agent.md' },
+      'antigravity': { source: 'antigravity-rules.md', target: '.antigravity/rules.md' },
+    };
+
+    // Step 1: Copy basic IDE rules files
+    for (const ide of ides) {
+      if (ide !== 'none' && ideRulesMap[ide]) {
+        const ideConfig = ideRulesMap[ide];
+        const sourceRules = path.join(targetCoreDir, 'templates', 'ide-rules', ideConfig.source);
+        const targetRules = path.join(context.projectRoot, ideConfig.target);
+
+        if (fs.existsSync(sourceRules)) {
+          await fse.ensureDir(path.dirname(targetRules));
+          await fse.copy(sourceRules, targetRules);
+          console.log(chalk.green('✓') + ` ${ide.charAt(0).toUpperCase() + ide.slice(1)} base rules installed`);
+        }
+      }
+    }
+
+    // Step 2: Install AIOS CORE agents and tasks for Claude Code
+    if (ides.includes('claude')) {
+      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const coreAgentsTarget = path.join(context.projectRoot, '.claude', 'commands', 'AIOS', 'agents');
+
+      const coreTasksSource = path.join(targetCoreDir, 'tasks');
+      const coreTasksTarget = path.join(context.projectRoot, '.claude', 'commands', 'AIOS', 'tasks');
+
+      if (fs.existsSync(coreAgentsSource)) {
+        await fse.copy(coreAgentsSource, coreAgentsTarget);
+        const agentCount = fs.readdirSync(coreAgentsSource).filter(f => f.endsWith('.md')).length;
+        console.log(chalk.green('✓') + ` Claude Code CORE agents installed (${agentCount} agents)`);
+      }
+
+      if (fs.existsSync(coreTasksSource)) {
+        await fse.copy(coreTasksSource, coreTasksTarget);
+        const taskCount = fs.readdirSync(coreTasksSource).filter(f => f.endsWith('.md')).length;
+        console.log(chalk.green('✓') + ` Claude Code CORE tasks installed (${taskCount} tasks)`);
+      }
+
+      // Create AIOS README for Claude Code
+      const aiossReadme = path.join(context.projectRoot, '.claude', 'commands', 'AIOS', 'README.md');
+      await fse.ensureDir(path.dirname(aiossReadme));
+      await fse.writeFile(aiossReadme, `# AIOS Core Commands
+
+This directory contains the core AIOS-FullStack agents and tasks.
+
+## Usage
+- Agents: Use slash commands like /dev, /architect, /qa, /pm, etc.
+- Tasks: Reference tasks in agent workflows
+
+## Documentation
+See .aios-core/user-guide.md for complete documentation.
+`);
+    }
+
+    // Step 3: Install AIOS CORE agents for Cursor
+    if (ides.includes('cursor')) {
+      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const cursorRulesTarget = path.join(context.projectRoot, '.cursor', 'rules', 'AIOS', 'agents');
+
+      if (fs.existsSync(coreAgentsSource)) {
+        await fse.ensureDir(cursorRulesTarget);
+
+        // Convert .md files to .mdc for Cursor
+        const agentFiles = fs.readdirSync(coreAgentsSource).filter(f => f.endsWith('.md'));
+        for (const agentFile of agentFiles) {
+          const sourcePath = path.join(coreAgentsSource, agentFile);
+          const targetFileName = agentFile.replace('.md', '.mdc');
+          const targetPath = path.join(cursorRulesTarget, targetFileName);
+          await fse.copy(sourcePath, targetPath);
+        }
+
+        console.log(chalk.green('✓') + ` Cursor CORE rules installed (${agentFiles.length} agents)`);
+      }
+
+      // Create AIOS README for Cursor
+      const cursorReadme = path.join(context.projectRoot, '.cursor', 'rules', 'AIOS', 'README.md');
+      await fse.ensureDir(path.dirname(cursorReadme));
+      await fse.writeFile(cursorReadme, `# AIOS Core Rules
+
+This directory contains the core AIOS-FullStack agent rules for Cursor.
+
+## Usage
+These rules are automatically loaded by Cursor to provide agent-specific context.
+
+## Documentation
+See .aios-core/user-guide.md for complete documentation.
+`);
+    }
+
+    // Step 4: Install AIOS CORE agents for other IDEs (Trae, Cline, Gemini, AntiGravity)
+    const otherIdeInstalls = ['trae', 'cline', 'gemini', 'antigravity'];
+    for (const ide of otherIdeInstalls) {
+      if (ides.includes(ide)) {
+        const coreAgentsSource = path.join(targetCoreDir, 'agents');
+        const ideRulesDir = ide === 'gemini' ? '.gemini' : `.${ide}`;
+        const ideRulesTarget = path.join(context.projectRoot, ideRulesDir, 'rules', 'AIOS', 'agents');
+
+        if (fs.existsSync(coreAgentsSource)) {
+          await fse.ensureDir(ideRulesTarget);
+
+          // Copy agent files
+          const agentFiles = fs.readdirSync(coreAgentsSource).filter(f => f.endsWith('.md'));
+          for (const agentFile of agentFiles) {
+            const sourcePath = path.join(coreAgentsSource, agentFile);
+            const targetPath = path.join(ideRulesTarget, agentFile);
+            await fse.copy(sourcePath, targetPath);
+          }
+
+          const ideName = ide.charAt(0).toUpperCase() + ide.slice(1);
+          console.log(chalk.green('✓') + ` ${ideName} CORE agents installed (${agentFiles.length} agents)`);
+        }
+      }
+    }
+
+    // Step 5: Install Roo Code modes
+    if (ides.includes('roo')) {
+      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const rooModesPath = path.join(context.projectRoot, '.roomodes');
+
+      if (fs.existsSync(coreAgentsSource)) {
+        const agentFiles = fs.readdirSync(coreAgentsSource).filter(f => f.endsWith('.md'));
+
+        // Create .roomodes JSON file
+        const roomodes = {
+          customModes: agentFiles.map(f => {
+            const agentName = f.replace('.md', '');
+            return {
+              slug: `bmad-${agentName}`,
+              name: `AIOS ${agentName.charAt(0).toUpperCase() + agentName.slice(1)}`,
+              roleDefinition: `AIOS-FullStack ${agentName} agent - see .aios-core/agents/${f}`,
+              groups: ['aios'],
+              source: 'project',
+            };
+          }),
+        };
+
+        await fse.writeFile(rooModesPath, JSON.stringify(roomodes, null, 2));
+        console.log(chalk.green('✓') + ` Roo Code modes installed (${agentFiles.length} modes)`);
+      }
+    }
+
+    // Step 6: Install GitHub Copilot chat modes
+    if (ides.includes('github-copilot')) {
+      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const copilotModesDir = path.join(context.projectRoot, '.github', 'chatmodes');
+
+      if (fs.existsSync(coreAgentsSource)) {
+        await fse.ensureDir(copilotModesDir);
+
+        const agentFiles = fs.readdirSync(coreAgentsSource).filter(f => f.endsWith('.md'));
+        for (const agentFile of agentFiles) {
+          const sourcePath = path.join(coreAgentsSource, agentFile);
+          const agentName = agentFile.replace('.md', '');
+          const targetPath = path.join(copilotModesDir, `aios-${agentName}.md`);
+          await fse.copy(sourcePath, targetPath);
+        }
+
+        console.log(chalk.green('✓') + ` GitHub Copilot chat modes installed (${agentFiles.length} modes)`);
+      }
+    }
+  }
+
+  // Step 7: Expansion Packs (CHECKBOX with visual)
+  // Try multiple locations for expansion-packs (npm package vs local development vs npx)
+  // __dirname is the 'bin/' directory of the package, so '..' gives us the package root
+  const packageRoot = path.resolve(__dirname, '..');
+
+  const possibleExpansionDirs = [
+    // Primary: relative to this script (works for npx and local)
+    path.join(packageRoot, 'expansion-packs'),
+    // Secondary: context-based framework location
+    path.join(context.frameworkLocation, 'expansion-packs'),
+    // Tertiary: installed in project's node_modules
+    path.join(context.projectRoot, 'node_modules', 'aios-fullstack', 'expansion-packs'),
+    path.join(context.projectRoot, 'node_modules', '@aios', 'fullstack', 'expansion-packs'),
+  ];
+
+  let sourceExpansionDir = null;
+  for (const dir of possibleExpansionDirs) {
+    if (fs.existsSync(dir)) {
+      sourceExpansionDir = dir;
+      break;
+    }
+  }
+
+  const availablePacks = [];
+  let expansionPacks = []; // Declare here to be accessible in summary
+
+  if (sourceExpansionDir && fs.existsSync(sourceExpansionDir)) {
+    let packs = fs.readdirSync(sourceExpansionDir).filter(f =>
+      fs.statSync(path.join(sourceExpansionDir, f)).isDirectory(),
+    );
+
+    // Filter for minimal mode - only show expansion-creator
+    if (isMinimalMode) {
+      packs = packs.filter(pack => pack === 'expansion-creator');
+    }
+
+    availablePacks.push(...packs);
+  }
+
+  if (availablePacks.length > 0) {
+    console.log('');
+    console.log(chalk.gray('─'.repeat(80)));
+    console.log(chalk.dim('  Press <space> to select, <a> to toggle all, <i> to invert selection, and <enter> to proceed'));
+    console.log('');
+
+    const result = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        name: 'expansionPacks',
+        message: chalk.white('Select expansion packs to install (optional)'),
+        choices: availablePacks.map(pack => ({
+          name: '  ' + pack,
+          value: pack,
+        })),
+      },
+    ]);
+
+    expansionPacks = result.expansionPacks; // Assign to outer scope variable
+
+    if (expansionPacks.length > 0) {
+      console.log('');
+      console.log(chalk.blue('📦 Installing expansion packs...'));
+
+      const targetExpansionDir = path.join(context.projectRoot, 'expansion-packs');
+
+      for (const pack of expansionPacks) {
+        const sourcePack = path.join(sourceExpansionDir, pack);
+        const targetPack = path.join(targetExpansionDir, pack);
+        await fse.copy(sourcePack, targetPack);
+        console.log(chalk.green('✓') + ` Expansion pack installed: ${pack}`);
+
+        // Install expansion pack agents/tasks for Claude Code
+        if (ides.includes('claude')) {
+          const packAgentsSource = path.join(targetPack, 'agents');
+          const packTasksSource = path.join(targetPack, 'tasks');
+          const packReadmeSource = path.join(targetPack, 'README.md');
+
+          const packClaudeTarget = path.join(context.projectRoot, '.claude', 'commands', pack);
+
+          // Copy agents
+          if (fs.existsSync(packAgentsSource)) {
+            const packAgentsTarget = path.join(packClaudeTarget, 'agents');
+            await fse.copy(packAgentsSource, packAgentsTarget);
+            const agentCount = fs.readdirSync(packAgentsSource).filter(f => f.endsWith('.md')).length;
+            console.log(chalk.green('  ✓') + ` Claude Code ${pack} agents (${agentCount} agents)`);
+          }
+
+          // Copy tasks
+          if (fs.existsSync(packTasksSource)) {
+            const packTasksTarget = path.join(packClaudeTarget, 'tasks');
+            await fse.copy(packTasksSource, packTasksTarget);
+            const taskCount = fs.readdirSync(packTasksSource).filter(f => f.endsWith('.md')).length;
+            console.log(chalk.green('  ✓') + ` Claude Code ${pack} tasks (${taskCount} tasks)`);
+          }
+
+          // Copy README
+          if (fs.existsSync(packReadmeSource)) {
+            await fse.copy(packReadmeSource, path.join(packClaudeTarget, 'README.md'));
+          }
+        }
+
+        // Install expansion pack agents for Cursor
+        if (ides.includes('cursor')) {
+          const packAgentsSource = path.join(targetPack, 'agents');
+          const packReadmeSource = path.join(targetPack, 'README.md');
+
+          if (fs.existsSync(packAgentsSource)) {
+            const cursorPackTarget = path.join(context.projectRoot, '.cursor', 'rules', pack, 'agents');
+            await fse.ensureDir(cursorPackTarget);
+
+            // Convert .md files to .mdc for Cursor
+            const agentFiles = fs.readdirSync(packAgentsSource).filter(f => f.endsWith('.md'));
+            for (const agentFile of agentFiles) {
+              const sourcePath = path.join(packAgentsSource, agentFile);
+              const targetFileName = agentFile.replace('.md', '.mdc');
+              const targetPath = path.join(cursorPackTarget, targetFileName);
+              await fse.copy(sourcePath, targetPath);
+            }
+
+            console.log(chalk.green('  ✓') + ` Cursor ${pack} rules (${agentFiles.length} agents)`);
+
+            // Copy README for Cursor
+            if (fs.existsSync(packReadmeSource)) {
+              await fse.copy(packReadmeSource, path.join(context.projectRoot, '.cursor', 'rules', pack, 'README.md'));
+            }
+          }
+        }
+      }
+    }
+  }
+
+  // Summary
+  console.log('');
+  console.log(chalk.gray('═'.repeat(80)));
+  console.log('');
+  console.log(chalk.green.bold('✓ AIOS-FullStack installation complete! 🎉'));
+  console.log('');
+  console.log(chalk.cyan('📋 Configuration Summary:'));
+  console.log('  ' + chalk.dim('Mode:           ') + installMode);
+  console.log('  ' + chalk.dim('Version:        ') + packageJsonVersion);
+  console.log('  ' + chalk.dim('Repository:     ') + context.repositoryUrl);
+  console.log('  ' + chalk.dim('IDE(s):         ') + (ides.includes('none') ? 'none' : ides.join(', ')));
+  console.log('  ' + chalk.dim('PM Tool:        ') + pmTool);
+
+  if (availablePacks.length > 0 && expansionPacks && expansionPacks.length > 0) {
+    console.log('  ' + chalk.dim('Expansion Packs:') + ' ' + expansionPacks.join(', '));
+  }
+
+  console.log('');
+  console.log(chalk.cyan('📁 Installed Structure:'));
+  console.log('  ' + chalk.dim('.aios-core/') + '           - Framework core files');
+
+  if (ides.includes('claude')) {
+    console.log('  ' + chalk.dim('.claude/'));
+    console.log('    ' + chalk.dim('├─ CLAUDE.md') + '        - Main configuration');
+    console.log('    ' + chalk.dim('└─ commands/'));
+    console.log('      ' + chalk.dim('  ├─ AIOS/') + '         - Core agents & tasks');
+    if (expansionPacks && expansionPacks.length > 0) {
+      expansionPacks.forEach(pack => {
+        console.log('      ' + chalk.dim(`  └─ ${pack}/`) + '     - Expansion pack commands');
+      });
+    }
+  }
+
+  if (ides.includes('cursor')) {
+    console.log('  ' + chalk.dim('.cursor/'));
+    console.log('    ' + chalk.dim('├─ rules.md') + '         - Main configuration');
+    console.log('    ' + chalk.dim('└─ rules/'));
+    console.log('      ' + chalk.dim('  ├─ AIOS/') + '         - Core agent rules');
+    if (expansionPacks && expansionPacks.length > 0) {
+      expansionPacks.forEach(pack => {
+        console.log('      ' + chalk.dim(`  └─ ${pack}/`) + '     - Expansion pack rules');
+      });
+    }
+  }
+
+  // Show other IDE installations
+  const otherInstalledIdes = ['windsurf', 'trae', 'cline', 'gemini', 'antigravity'].filter(ide => ides.includes(ide));
+  for (const ide of otherInstalledIdes) {
+    const ideDir = ide === 'gemini' ? '.gemini' : `.${ide}`;
+    console.log('  ' + chalk.dim(`${ideDir}/`) + '           - ' + ide.charAt(0).toUpperCase() + ide.slice(1) + ' configuration');
+  }
+
+  if (ides.includes('roo')) {
+    console.log('  ' + chalk.dim('.roomodes') + '            - Roo Code mode definitions');
+  }
+
+  if (ides.includes('github-copilot')) {
+    console.log('  ' + chalk.dim('.github/chatmodes/') + '   - GitHub Copilot agent modes');
+  }
+
+  console.log('');
+  console.log(chalk.cyan('📚 Next steps:'));
+
+  if (ides.includes('claude')) {
+    console.log('  ' + chalk.yellow('Claude Code:'));
+    console.log('    • Use slash commands: /dev, /architect, /qa, /pm, /github-devops');
+    console.log('    • Browse: .claude/commands/AIOS/agents/ for all available agents');
+  }
+
+  if (ides.includes('cursor')) {
+    console.log('  ' + chalk.yellow('Cursor:'));
+    console.log('    • Agent rules auto-loaded from .cursor/rules/');
+    console.log('    • Use @agent-name to activate agents in chat');
+  }
+
+  if (ides.includes('windsurf') || ides.includes('trae') || ides.includes('cline')) {
+    console.log('  ' + chalk.yellow('Windsurf/Trae/Cline:'));
+    console.log('    • Use @agent-name to activate agents in chat');
+  }
+
+  if (ides.includes('roo')) {
+    console.log('  ' + chalk.yellow('Roo Code:'));
+    console.log('    • Select agent mode from status bar mode selector');
+  }
+
+  if (ides.includes('gemini')) {
+    console.log('  ' + chalk.yellow('Gemini CLI:'));
+    console.log('    • Include agent context in your prompts');
+  }
+
+  if (ides.includes('github-copilot')) {
+    console.log('  ' + chalk.yellow('GitHub Copilot:'));
+    console.log('    • Open Chat view and select Agent mode');
+    console.log('    • Requires VS Code 1.101+ with chat.agent.enabled: true');
+  }
+
+  if (ides.includes('antigravity')) {
+    console.log('  ' + chalk.yellow('AntiGravity:'));
+    console.log('    • Use Workspace Rules to activate agents');
+    console.log('    • Browse: .antigravity/rules/AIOS/agents/ for all available agents');
+  }
+
+  console.log('  ' + chalk.yellow('General:'));
+  console.log('    • Run ' + chalk.yellow('"aios-fullstack doctor"') + ' to verify installation');
+  console.log('    • Check .aios-core/user-guide.md for complete documentation');
+  console.log('    • Explore expansion-packs/ for additional capabilities');
+  console.log('');
+  console.log(chalk.gray('═'.repeat(80)));
+  console.log('');
+}
+
+/**
+ * Updates .gitignore file based on installation mode
+ */
+function updateGitIgnore(mode, projectRoot) {
+  const gitignorePath = path.join(projectRoot, '.gitignore');
+
+  let gitignore = '';
+  if (fs.existsSync(gitignorePath)) {
+    gitignore = fs.readFileSync(gitignorePath, 'utf8');
+  }
+
+  if (mode === 'project-development') {
+    const frameworkRules = [
+      '',
+      '# AIOS-FullStack Framework Files (auto-managed - do not edit)',
+      '.aios-core/',
+      'node_modules/@aios/',
+      'outputs/minds/',
+      '.aios-installation-config.yaml',
+      '# End AIOS-FullStack auto-managed section',
+      '',
+    ];
+
+    const hasFrameworkSection = gitignore.includes('# AIOS-FullStack Framework Files');
+
+    if (!hasFrameworkSection) {
+      gitignore += frameworkRules.join('\n');
+      fs.writeFileSync(gitignorePath, gitignore);
+    }
+  }
+}
+
+/**
+ * Save PM configuration
+ */
+function savePMConfig(pmTool, config, projectRoot) {
+  const pmConfigData = {
+    pm_tool: {
+      type: pmTool,
+      configured_at: new Date().toISOString(),
+      config: config,
+    },
+    sync_behavior: {
+      auto_sync_on_status_change: true,
+      create_tasks_on_story_creation: false,
+      bidirectional_sync: false,
+    },
+  };
+
+  const configPath = path.join(projectRoot, '.aios-pm-config.yaml');
+  fs.writeFileSync(configPath, yaml.stringify(pmConfigData));
+}
+
+// Run installer with error handling
+main().catch((error) => {
+  console.error('');
+  console.error(chalk.red('✗ Installation failed: ') + error.message);
+  console.error('');
+  process.exit(1);
+});