@polymorphism-tech/morph-spec 4.7.1 → 4.8.1

package/src/commands/project/init.js

@@ -1,555 +1,398 @@
-import { join } from 'path';
-import fs from 'fs-extra';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import {
-  copyDirectory,
-  copyFile,
-  pathExists,
-  readJson,
-  writeJson,
-  ensureDir,
-  writeFile,
-  readFile,
-  updateGitignore
-} from '../../utils/file-copier.js';
-import { saveProjectMorphVersion, getInstalledCLIVersion } from '../../utils/version-checker.js';
-import { installClaudeHooks, installGlobalStatusline } from '../../utils/claude-settings-manager.js';
-import { installSkills } from '../../utils/skills-installer.js';
-import { installAgents, installDomainAgents } from '../../utils/agents-installer.js';
-import { AutoContextOrchestrator } from '../../core/orchestrator.js';
-import { detectClaudeCode } from '../../llm/environment-detector.js';
-import inquirer from 'inquirer';
-import { detectProject } from '../../lib/detectors/index.js';
-import { detectClaudeConfig, mapMcpsToPhases, formatConfigSummary } from '../../lib/detectors/claude-config-detector.js';
-import { generateSettings, saveIntegrations } from '../../lib/generators/settings-generator.js';
-import {
-  orchestrateMcpSetup,
-  installAutoMcps,
-  installMcpWithCredentials,
-  generateSetupInstructions,
-  formatMcpStatusTable
-} from '../../lib/installers/mcp-installer.js';
-
-export async function initCommand(options) {
-  const targetPath = options.path || process.cwd();
-  const claudeMdPath = join(import.meta.dirname, '..', '..', '..', 'framework', 'CLAUDE.md');
-
-  logger.header('MORPH-SPEC Framework Installation');
-  logger.dim(`Target: ${targetPath}`);
-  logger.blank();
-
-  // Check if already initialized
-  const morphPath = join(targetPath, '.morph');
-  if (await pathExists(morphPath)) {
-    if (!options.force) {
-      logger.warn('MORPH already initialized in this directory.');
-      logger.dim('Use --force to overwrite existing installation.');
-      process.exit(1);
-    }
-    logger.warn('Overwriting existing MORPH installation...');
-  }
-
-  const spinner = ora('Installing MORPH-SPEC...').start();
-
-  try {
-    // 1. Copy CLAUDE.md
-    spinner.text = 'Copying CLAUDE.md...';
-    const claudeMdDest = join(targetPath, 'CLAUDE.md');
-
-    // Backup existing CLAUDE.md if not from MORPH
-    if (await pathExists(claudeMdDest)) {
-      const existingContent = await readFile(claudeMdDest);
-      if (!existingContent.includes('MORPH-SPEC')) {
-        await copyFile(claudeMdDest, `${claudeMdDest}.backup`);
-        logger.dim('Backed up existing CLAUDE.md');
-      }
-    }
-    await copyFile(claudeMdPath, claudeMdDest);
-
-    // 2. Create .morph directory structure
-    spinner.text = 'Creating .morph structure...';
-    const configDir = join(morphPath, 'config');
-    const frameworkDestDir = join(morphPath, 'framework');
-    const contextDir = join(morphPath, 'context');
-    const featuresDir = join(morphPath, 'features');
-    await ensureDir(contextDir);
-    await ensureDir(featuresDir);
-    await ensureDir(configDir);
-    await ensureDir(frameworkDestDir);
-
-    // 3. Create config.json
-    spinner.text = 'Generating config.json...';
-    const configPath = join(configDir, 'config.json');
-    const dirName = targetPath.split(/[\\/]/).pop();
-
-    const config = {
-      framework: 'global',
-      frameworkVersion: getInstalledCLIVersion(),
-      project: {
-        name: dirName,
-        architecture: 'unknown'
-      }
-    };
-
-    await writeJson(configPath, config);
-
-    // 4. Create context/README.md
-    spinner.text = 'Creating context README...';
-    const contextReadme = join(contextDir, 'README.md');
-    const readmeContent = `# ${dirName} - Project Context
-
-## Overview
-
-This file will be auto-updated by MORPH-SPEC detection system.
-
-## Stack
-
-Run \`morph-spec detect\` to analyze your project.
-
-## Technologies
-
-(To be detected)
-
-## Architecture
-
-(To be detected)
-`;
-    await writeFile(contextReadme, readmeContent);
-
-    // 5. Copy framework templates (project-local overrides start from framework defaults)
-    const frameworkTemplatesSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'templates');
-    const templatesDest = join(frameworkDestDir, 'templates');
-    let templatesCopied = false;
-    if (await pathExists(frameworkTemplatesSrc)) {
-      await copyDirectory(frameworkTemplatesSrc, templatesDest);
-      templatesCopied = true;
-    } else {
-      await ensureDir(templatesDest);
-    }
-
-    // 6b. Copy framework standards hierarchy (universal standards)
-    spinner.text = 'Copying framework standards hierarchy...';
-    const frameworkStandardsSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'standards');
-    const frameworkStandardsDest = join(frameworkDestDir, 'standards');
-    if (await pathExists(frameworkStandardsSrc)) {
-      // Copy entire hierarchy (core/, backend/, frontend/, infrastructure/)
-      await copyDirectory(frameworkStandardsSrc, frameworkStandardsDest);
-      logger.dim('  ✓ Copied framework standards: core/, backend/, frontend/, infrastructure/');
-    }
-
-    // 7. Copy agents.json (sourced from framework/ — canonical single source of truth)
-    spinner.text = 'Copying agents configuration...';
-    const agentsSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'agents.json');
-    const agentsDest = join(frameworkDestDir, 'agents.json');
-    if (await pathExists(agentsSrc)) {
-      await copyFile(agentsSrc, agentsDest);
-    }
-
-    // 8. Copy .claude commands and install skills
-    // Source: framework/ (canonical for all stacks)
-    spinner.text = 'Setting up Claude Code integration...';
-    const frameworkDir = join(import.meta.dirname, '..', '..', '..', 'framework');
-    const claudeDest = join(targetPath, '.claude');
-
-    let commandsCopied = false;
-
-    // Copy commands directory (slash commands): framework/commands/ → .claude/commands/
-    const commandsSrc = join(frameworkDir, 'commands');
-    const commandsDest = join(claudeDest, 'commands');
-    if (await pathExists(commandsSrc)) {
-      await copyDirectory(commandsSrc, commandsDest);
-      commandsCopied = true;
-    } else {
-      logger.warn('  ⚠ framework/commands/ source missing — commands not installed');
-    }
-
-    // 9a. Install path-scoped rules to .claude/rules/ (native Claude Code pattern)
-    spinner.text = 'Installing path-scoped rules to .claude/rules/...';
-    const rulesSrc = join(frameworkDir, 'rules');
-    const rulesDest = join(claudeDest, 'rules');
-    let rulesCopied = false;
-    if (await pathExists(rulesSrc)) {
-      await copyDirectory(rulesSrc, rulesDest);
-      rulesCopied = true;
-    }
-
-    // 9b. Install morph skills to .claude/skills/ for native Claude Code discovery
-    spinner.text = 'Installing morph skills to .claude/skills/...';
-    await installSkills(targetPath);
-
-    // 9b2. Install tier-1/2 agents as native Claude Code subagents in .claude/agents/
-    spinner.text = 'Installing native subagents to .claude/agents/...';
-    const detectedStackForAgents = config.project.stack ?? null;
-    await installAgents(targetPath, frameworkDir, { projectStack: detectedStackForAgents });
-
-    // 9b2b. Install level-2 domain agents as native Claude Code subagents in .claude/agents/
-    await installDomainAgents(targetPath, frameworkDir);
-
-    // 9b3. Install runtime CLAUDE.md to .claude/CLAUDE.md (Claude Code runtime instructions)
-    spinner.text = 'Installing .claude/CLAUDE.md...';
-    const runtimeClaudeMdSrc = join(frameworkDir, 'CLAUDE.md');
-    const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
-    if (await pathExists(runtimeClaudeMdSrc)) {
-      await copyFile(runtimeClaudeMdSrc, runtimeClaudeMdDest);
-    }
-
-    // 9c. Install statusline globally to ~/.claude/ (applies to all Claude Code sessions)
-    spinner.text = 'Installing statusline globally to ~/.claude/...';
-    const HOOKS_SRC = join(import.meta.dirname, '..', '..', '..', 'framework', 'hooks', 'claude-code');
-    try {
-      await installGlobalStatusline(HOOKS_SRC);
-    } catch {
-      // Non-critical: global dir may not be writable in all environments
-      logger.dim('  ⚠ Could not install statusline globally (non-critical)');
-    }
-
-    // 9d. Install/update Claude Code hooks in .claude/settings.local.json
-    spinner.text = 'Installing Claude Code hooks...';
-    const hooksResult = await installClaudeHooks(targetPath);
-
-    // 10. Save version info
-    spinner.text = 'Saving version info...';
-    const cliVersion = getInstalledCLIVersion();
-    await saveProjectMorphVersion(targetPath, cliVersion);
-
-    // 11. Update .gitignore
-    spinner.text = 'Updating .gitignore...';
-    await updateGitignore(targetPath);
-
-    // 11b. Detect Claude Code environment (plugins, MCPs, skills)
-    spinner.text = 'Detecting Claude Code environment...';
-    let claudeConfigDetected = null;
-    let integrationsCreated = false;
-    try {
-      claudeConfigDetected = await detectClaudeConfig(targetPath);
-      const hasIntegrations = claudeConfigDetected.plugins.length > 0
-        || claudeConfigDetected.mcpServers.length > 0
-        || claudeConfigDetected.superpowers.installed;
-
-      if (hasIntegrations) {
-        spinner.stop();
-        logger.blank();
-        logger.header('Claude Code Environment Detected');
-
-        const summary = formatConfigSummary(claudeConfigDetected);
-        if (summary) {
-          logger.info(summary);
-        }
-
-        // Show MCP-to-phase mapping
-        if (claudeConfigDetected.mcpServers.length > 0) {
-          const phaseMap = mapMcpsToPhases(claudeConfigDetected.mcpServers);
-          logger.blank();
-          logger.dim('MCP usage by phase:');
-          for (const [phase, mcps] of Object.entries(phaseMap)) {
-            if (mcps.length > 0) {
-              logger.dim(`  ${phase}: ${mcps.map(m => m.name).join(', ')}`);
-            }
-          }
-        }
-
-        logger.blank();
-        const { saveIntegrationsChoice } = await inquirer.prompt([{
-          type: 'confirm',
-          name: 'saveIntegrationsChoice',
-          message: 'Save detected integrations and generate optimized settings?',
-          default: true
-        }]);
-
-        if (saveIntegrationsChoice) {
-          spinner.start('Saving integrations...');
-          await saveIntegrations(targetPath, claudeConfigDetected);
-          await generateSettings(targetPath, claudeConfigDetected, config);
-          integrationsCreated = true;
-          spinner.succeed('Integrations saved to .morph/config/integrations.json');
-        } else {
-          spinner.start('Continuing...');
-        }
-      }
-    } catch (error) {
-      // Non-fatal: continue without integrations
-      logger.dim(`  Claude config detection skipped: ${error.message}`);
-    }
-
-    // 11c. Stack detection (moved before MCP setup so we know the stack)
-    spinner.text = 'Detecting project stack...';
-    let detectedStack = 'unknown';
-    const hasProjectFiles = await pathExists(join(targetPath, 'package.json'))
-      || await pathExists(join(targetPath, 'src'))
-      || (await fs.readdir(targetPath)).some(f => f.endsWith('.csproj'));
-
-    if (hasProjectFiles) {
-      try {
-        const quickResults = await detectProject(targetPath, { conversation: false, generateStandards: false });
-        const structure = quickResults.structure;
-
-        if (structure?.stack && structure.stack !== 'unknown') {
-          detectedStack = structure.stack;
-
-          // Persist detected stack to config.json
-          if (structure?.stack && structure.stack !== 'unknown') {
-            config.project.stack = structure.stack;
-          }
-          if (structure?.architecture && structure.architecture !== 'unknown') {
-            config.project.architecture = structure.architecture;
-          }
-          if (structure?.uiLibrary) {
-            config.project.uiLibrary = structure.uiLibrary;
-          }
-          await writeJson(configPath, config);
-
-          spinner.stop();
-          logger.blank();
-          logger.header('Existing Project Detected');
-          logger.info(`Stack detected: ${structure.stack}`);
-          if (structure?.architecture) logger.dim(`Architecture: ${structure.architecture}`);
-          if (structure?.uiLibrary) logger.dim(`UI Library: ${structure.uiLibrary}`);
-
-          const { standardsChoice } = await inquirer.prompt([{
-            type: 'list',
-            name: 'standardsChoice',
-            message: 'How should morph-spec handle your project standards?',
-            choices: [
-              { name: 'Keep morph-spec defaults (recommended)', value: 'morph-spec' },
-              { name: 'Detect project-specific standards', value: 'detect' }
-            ]
-          }]);
-
-          if (standardsChoice === 'detect') {
-            spinner.start('Generating project-specific standards...');
-            const fullResults = await detectProject(targetPath, { conversation: false });
-            const inferredPath = join(contextDir, 'standards.md');
-            await writeFile(inferredPath, fullResults.inferred.markdown);
-            spinner.succeed('Generated .morph/context/standards.md');
-            logger.dim('Review and edit .morph/context/standards.md as needed.');
-          }
-
-          spinner.start('Continuing...');
-        }
-      } catch (error) {
-        logger.dim(`  Stack detection skipped: ${error.message}`);
-      }
-    }
-
-    // 11d. MCP Auto-Setup
-    let mcpSetupResult = null;
-    if (!options.skipMcp) {
-      try {
-        spinner.stop();
-        const existingMcps = claudeConfigDetected?.mcpServers || [];
-        const orchestration = orchestrateMcpSetup(targetPath, detectedStack, existingMcps);
-
-        const autoNames = Object.keys(orchestration.autoInstallable);
-        const manualNames = Object.keys(orchestration.needsManualSetup);
-        const hasAutoMcps = autoNames.length > 0;
-        const hasManualMcps = manualNames.length > 0;
-
-        if (hasAutoMcps || hasManualMcps) {
-          logger.blank();
-          logger.header('MCP Server Setup');
-
-          // Auto-install prompt
-          let autoInstalled = {};
-          if (hasAutoMcps) {
-            const { installAuto } = await inquirer.prompt([{
-              type: 'confirm',
-              name: 'installAuto',
-              message: `Install recommended MCP servers? (${autoNames.join(', ')})`,
-              default: true
-            }]);
-
-            if (installAuto) {
-              spinner.start('Installing MCP servers...');
-              const result = await installAutoMcps(targetPath, orchestration.autoInstallable);
-              spinner.succeed(`Installed ${result.added.length} MCP server(s)`);
-              for (const name of result.added) {
-                autoInstalled[name] = orchestration.autoInstallable[name];
-              }
-            }
-          }
-
-          // Credential MCPs — inline setup or instructions
-          const manualInstalled = {};
-          if (hasManualMcps) {
-            for (const [name, entry] of Object.entries(orchestration.needsManualSetup)) {
-              logger.blank();
-
-              // Show warnings
-              for (const warning of entry.install.warnings || []) {
-                logger.warn(`  ${warning}`);
-              }
-
-              const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
-              const { setupNow } = await inquirer.prompt([{
-                type: 'confirm',
-                name: 'setupNow',
-                message: `Set up ${capitalizedName} MCP now? (${entry.usage})`,
-                default: false
-              }]);
-
-              if (setupNow) {
-                // Collect credentials
-                const credentialValues = {};
-                for (const cred of entry.install.credentials) {
-                  const { value } = await inquirer.prompt([{
-                    type: cred.secret ? 'password' : 'input',
-                    name: 'value',
-                    message: `${cred.name}:`,
-                    mask: cred.secret ? '*' : undefined
-                  }]);
-                  credentialValues[cred.envVar] = value;
-                }
-
-                spinner.start(`Configuring ${name}...`);
-                await installMcpWithCredentials(targetPath, name, entry, credentialValues);
-                spinner.succeed(`${capitalizedName} MCP configured`);
-                manualInstalled[name] = entry;
-              } else {
-                // Show setup instructions
-                const instructions = generateSetupInstructions(name, entry);
-                logger.blank();
-                logger.dim('  Add to .claude/settings.local.json → mcpServers:');
-                logger.dim('  ' + '─'.repeat(55));
-                for (const line of instructions.configSnippet.split('\n')) {
-                  logger.dim(`  ${line}`);
-                }
-                logger.dim('  ' + '─'.repeat(55));
-
-                for (const cred of instructions.credentialUrls) {
-                  logger.dim(`  Get ${cred.name}: ${cred.helpUrl}`);
-                }
-                logger.dim(`  Or run later: ${instructions.cliCommand}`);
-              }
-            }
-          }
-
-          // Summary table
-          const justInstalled = { ...autoInstalled, ...manualInstalled };
-          const statusRows = formatMcpStatusTable(orchestration, justInstalled);
-
-          if (statusRows.length > 0) {
-            logger.blank();
-            logger.info('MCP Servers');
-            logger.dim('─'.repeat(60));
-
-            const STATUS_ICONS = {
-              installed: '✓',
-              available: '○',
-              already_configured: '✓',
-              needs_setup: '⚠',
-              prereq_missing: '✗',
-              not_relevant: '─'
-            };
-
-            for (const row of statusRows) {
-              const icon = STATUS_ICONS[row.status] || '?';
-              const statusLabel = row.status.replace(/_/g, ' ');
-              logger.dim(`  ${icon} ${row.name.padEnd(15)} ${statusLabel.padEnd(20)} ${row.detail}`);
-            }
-          }
-
-          mcpSetupResult = { autoInstalled, manualInstalled, orchestration };
-        }
-      } catch (error) {
-        logger.dim(`  MCP setup skipped: ${error.message}`);
-      }
-    } else {
-      logger.dim('\nSkipped MCP setup (--skip-mcp flag)');
-    }
-
-    spinner.succeed('MORPH-SPEC installed successfully!');
-
-    // Show next steps
-    logger.blank();
-    logger.success(`MORPH-SPEC v${cliVersion} installed successfully!`);
-    logger.blank();
-    logger.header('Next Steps');
-
-    logger.step(1, 'Run detection: morph-spec detect');
-    logger.step(2, 'Review .morph/config/config.json and .morph/context/standards.md');
-    logger.step(3, 'Open project in VS Code with Claude Code');
-    logger.step(4, 'Start your first feature:');
-    logger.blank();
-    logger.box([
-      'Ask Claude Code to implement a feature'
-    ]);
-    logger.blank();
-
-    logger.info('Files installed:');
-    logger.dim(`  ✓ CLAUDE.md`);
-    logger.dim(`  ✓ .morph/config/ (config.json)`);
-    logger.dim(`  ✓ .morph/framework/ (agents.json, standards/, templates/)`);
-    logger.dim(`  ✓ .morph/context/ (project context)`);
-    logger.dim(`  ✓ .morph/features/ (feature outputs)`);
-    if (commandsCopied) {
-      logger.dim(`  ✓ .claude/commands/ (slash commands)`);
-    }
-    if (rulesCopied) {
-      logger.dim(`  ✓ .claude/rules/ (5 path-scoped rules)`);
-    }
-    logger.dim(`  ✓ .claude/settings.local.json (${hooksResult.installed} hooks installed)`);
-    if (integrationsCreated) {
-      logger.dim(`  ✓ .morph/config/integrations.json (detected plugins & MCPs)`);
-    }
-    if (mcpSetupResult) {
-      const autoCount = Object.keys(mcpSetupResult.autoInstalled).length;
-      const manualCount = Object.keys(mcpSetupResult.manualInstalled).length;
-      if (autoCount + manualCount > 0) {
-        logger.dim(`  ✓ MCP servers (${autoCount + manualCount} configured)`);
-      }
-    }
-
-    logger.dim('  ✓ .claude/skills/ (installed as skill directories)');
-    logger.dim('  ✓ .claude/agents/ (native subagents installed)');
-
-    logger.blank();
-
-    // 13. LLM-based auto-detect project context (if Claude Code is available and not --skip-detection)
-    if (!options.skipDetection && detectClaudeCode()) {
-      logger.blank();
-      logger.header('Auto-Detecting Project Context');
-      logger.dim('Using Claude Code LLM to analyze your project...');
-      logger.blank();
-
-      try {
-        const orchestrator = new AutoContextOrchestrator();
-        const result = await orchestrator.execute(targetPath, {
-          skipReview: false,
-          fallbackOnError: true,
-          wizardMode: options.wizard || false
-        });
-
-        if (result.success) {
-          logger.success('Project context detected and saved to .morph/project.md');
-        } else {
-          logger.warn('Auto-detection incomplete. Run "morph-spec update" to retry.');
-        }
-      } catch (error) {
-        logger.warn(`Auto-detection failed: ${error.message}`);
-        logger.dim('You can run "morph-spec update" later to re-analyze your project.');
-      }
-    } else if (options.skipDetection) {
-      logger.dim('\nSkipped auto-detection (--skip-detection flag)');
-      logger.dim('Run "morph-spec update" later to analyze your project.');
-    } else {
-      logger.warn('\n⚠️  Claude Code not detected');
-      logger.dim('Auto-detection requires Claude Code CLI.');
-      logger.dim('Run "morph-spec update --wizard" to configure manually.');
-    }
-
-    // Suggest tutorial for first-time users
-    if (integrationsCreated) {
-      logger.blank();
-      logger.info('First time using morph-spec? Run `morph-spec tutorial` to get started.');
-    }
-
-    logger.blank();
-
-  } catch (error) {
-    spinner.fail('Installation failed');
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
+import { join } from 'path';
+import { homedir } from 'os';
+import fs from 'fs-extra';
+import ora from 'ora';
+import { logger } from '../../utils/logger.js';
+import {
+  pathExists,
+  readJson,
+  writeJson,
+  writeFile
+} from '../../utils/file-copier.js';
+import { getInstalledCLIVersion } from '../../utils/version-checker.js';
+import { installClaudeHooks } from '../../utils/claude-settings-manager.js';
+import inquirer from 'inquirer';
+import { detectProject } from '../../lib/detectors/index.js';
+import { detectClaudeConfig, mapMcpsToPhases, formatConfigSummary } from '../../lib/detectors/claude-config-detector.js';
+import { generateSettings, saveIntegrations } from '../../lib/generators/settings-generator.js';
+import {
+  orchestrateMcpSetup,
+  installAutoMcps,
+  installMcpWithCredentials,
+  generateSetupInstructions,
+  formatMcpStatusTable
+} from '../../lib/installers/mcp-installer.js';
+import { setupInfra } from '../../scripts/setup-infra.js';
+
+export async function initCommand(options) {
+  const targetPath = options.path || process.cwd();
+
+  logger.header('MORPH-SPEC Framework Installation');
+  logger.dim(`Target: ${targetPath}`);
+  logger.blank();
+
+  // Check if already initialized
+  const morphPath = join(targetPath, '.morph');
+  if (await pathExists(morphPath)) {
+    if (!options.force) {
+      logger.warn('MORPH already initialized in this directory.');
+      logger.dim('Use --force to overwrite existing installation.');
+      process.exit(1);
+    }
+    logger.warn('Overwriting existing MORPH installation...');
+  }
+
+  const spinner = ora('Installing MORPH-SPEC...').start();
+
+  try {
+
+    // Steps 1-10: Infrastructure (headless, no prompts)
+    spinner.stop();
+    const infraResult = await setupInfra(targetPath);
+    spinner.start('Continuing...');
+
+    // Derive display variables from what setupInfra installed
+    const cliVersion = getInstalledCLIVersion();
+    const commandsCopied = await pathExists(join(targetPath, '.claude', 'commands'));
+    const rulesCopied = await pathExists(join(targetPath, '.claude', 'rules'));
+    // Re-run installClaudeHooks to get the result object (idempotent — hooks already installed)
+    const hooksResult = await installClaudeHooks(targetPath);
+
+    // Re-derive config path for stack detection updates
+    const configDir = join(morphPath, 'config');
+    const configPath = join(configDir, 'config.json');
+    const contextDir = join(morphPath, 'context');
+
+    // Read config written by setupInfra so stack detection can update it
+    let config = (await pathExists(configPath)) ? await readJson(configPath) : { project: {} };
+    if (!config.project) config.project = {};
+
+    // 11b. Detect Claude Code environment (plugins, MCPs, skills)
+    spinner.text = 'Detecting Claude Code environment...';
+    let claudeConfigDetected = null;
+    let integrationsCreated = false;
+    try {
+      claudeConfigDetected = await detectClaudeConfig(targetPath);
+      const hasIntegrations = claudeConfigDetected.plugins.length > 0
+        || claudeConfigDetected.mcpServers.length > 0
+        || claudeConfigDetected.superpowers.installed;
+
+      if (hasIntegrations) {
+        spinner.stop();
+        logger.blank();
+        logger.header('Claude Code Environment Detected');
+
+        const summary = formatConfigSummary(claudeConfigDetected);
+        if (summary) {
+          logger.info(summary);
+        }
+
+        // Show MCP-to-phase mapping
+        if (claudeConfigDetected.mcpServers.length > 0) {
+          const phaseMap = mapMcpsToPhases(claudeConfigDetected.mcpServers);
+          logger.blank();
+          logger.dim('MCP usage by phase:');
+          for (const [phase, mcps] of Object.entries(phaseMap)) {
+            if (mcps.length > 0) {
+              logger.dim(`  ${phase}: ${mcps.map(m => m.name).join(', ')}`);
+            }
+          }
+        }
+
+        logger.blank();
+        const { saveIntegrationsChoice } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'saveIntegrationsChoice',
+          message: 'Save detected integrations and generate optimized settings?',
+          default: true
+        }]);
+
+        if (saveIntegrationsChoice) {
+          spinner.start('Saving integrations...');
+          await saveIntegrations(targetPath, claudeConfigDetected);
+          await generateSettings(targetPath, claudeConfigDetected, config);
+          integrationsCreated = true;
+          spinner.succeed('Integrations saved to .morph/config/integrations.json');
+        } else {
+          spinner.start('Continuing...');
+        }
+      }
+    } catch (error) {
+      // Non-fatal: continue without integrations
+      logger.dim(`  Claude config detection skipped: ${error.message}`);
+    }
+
+    // 11c. Stack detection (moved before MCP setup so we know the stack)
+    spinner.text = 'Detecting project stack...';
+    let detectedStack = 'unknown';
+    const hasProjectFiles = await pathExists(join(targetPath, 'package.json'))
+      || await pathExists(join(targetPath, 'src'))
+      || (await fs.readdir(targetPath)).some(f => f.endsWith('.csproj'));
+
+    if (hasProjectFiles) {
+      try {
+        const quickResults = await detectProject(targetPath, { conversation: false, generateStandards: false });
+        const structure = quickResults.structure;
+
+        if (structure?.stack && structure.stack !== 'unknown') {
+          detectedStack = structure.stack;
+
+          // Persist detected stack to config.json
+          if (structure?.stack && structure.stack !== 'unknown') {
+            config.project.stack = structure.stack;
+          }
+          if (structure?.architecture && structure.architecture !== 'unknown') {
+            config.project.architecture = structure.architecture;
+          }
+          if (structure?.uiLibrary) {
+            config.project.uiLibrary = structure.uiLibrary;
+          }
+          await writeJson(configPath, config);
+
+          spinner.stop();
+          logger.blank();
+          logger.header('Existing Project Detected');
+          logger.info(`Stack detected: ${structure.stack}`);
+          if (structure?.architecture) logger.dim(`Architecture: ${structure.architecture}`);
+          if (structure?.uiLibrary) logger.dim(`UI Library: ${structure.uiLibrary}`);
+
+          const { standardsChoice } = await inquirer.prompt([{
+            type: 'list',
+            name: 'standardsChoice',
+            message: 'How should morph-spec handle your project standards?',
+            choices: [
+              { name: 'Keep morph-spec defaults (recommended)', value: 'morph-spec' },
+              { name: 'Detect project-specific standards', value: 'detect' }
+            ]
+          }]);
+
+          if (standardsChoice === 'detect') {
+            spinner.start('Generating project-specific standards...');
+            const fullResults = await detectProject(targetPath, { conversation: false });
+            const inferredPath = join(contextDir, 'standards.md');
+            await writeFile(inferredPath, fullResults.inferred.markdown);
+            spinner.succeed('Generated .morph/context/standards.md');
+            logger.dim('Review and edit .morph/context/standards.md as needed.');
+          }
+
+          spinner.start('Continuing...');
+        }
+      } catch (error) {
+        logger.dim(`  Stack detection skipped: ${error.message}`);
+      }
+    }
+
+    // 11d. MCP Auto-Setup
+    let mcpSetupResult = null;
+    if (!options.skipMcp) {
+      try {
+        spinner.stop();
+        const existingMcps = claudeConfigDetected?.mcpServers || [];
+        const orchestration = orchestrateMcpSetup(targetPath, detectedStack, existingMcps);
+
+        const autoNames = Object.keys(orchestration.autoInstallable);
+        const manualNames = Object.keys(orchestration.needsManualSetup);
+        const hasAutoMcps = autoNames.length > 0;
+        const hasManualMcps = manualNames.length > 0;
+
+        if (hasAutoMcps || hasManualMcps) {
+          logger.blank();
+          logger.header('MCP Server Setup');
+
+          // Auto-install prompt
+          let autoInstalled = {};
+          if (hasAutoMcps) {
+            const { installAuto } = await inquirer.prompt([{
+              type: 'confirm',
+              name: 'installAuto',
+              message: `Install recommended MCP servers? (${autoNames.join(', ')})`,
+              default: true
+            }]);
+
+            if (installAuto) {
+              spinner.start('Installing MCP servers...');
+              const result = await installAutoMcps(targetPath, orchestration.autoInstallable);
+              spinner.succeed(`Installed ${result.added.length} MCP server(s)`);
+              for (const name of result.added) {
+                autoInstalled[name] = orchestration.autoInstallable[name];
+              }
+            }
+          }
+
+          // Credential MCPs — inline setup or instructions
+          const manualInstalled = {};
+          if (hasManualMcps) {
+            for (const [name, entry] of Object.entries(orchestration.needsManualSetup)) {
+              logger.blank();
+
+              // Show warnings
+              for (const warning of entry.install.warnings || []) {
+                logger.warn(`  ${warning}`);
+              }
+
+              const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
+              const { setupNow } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'setupNow',
+                message: `Set up ${capitalizedName} MCP now? (${entry.usage})`,
+                default: false
+              }]);
+
+              if (setupNow) {
+                // Collect credentials
+                const credentialValues = {};
+                for (const cred of entry.install.credentials) {
+                  const { value } = await inquirer.prompt([{
+                    type: cred.secret ? 'password' : 'input',
+                    name: 'value',
+                    message: `${cred.name}:`,
+                    mask: cred.secret ? '*' : undefined
+                  }]);
+                  credentialValues[cred.envVar] = value;
+                }
+
+                spinner.start(`Configuring ${name}...`);
+                await installMcpWithCredentials(targetPath, name, entry, credentialValues);
+                spinner.succeed(`${capitalizedName} MCP configured`);
+                manualInstalled[name] = entry;
+              } else {
+                // Show setup instructions
+                const instructions = generateSetupInstructions(name, entry);
+                logger.blank();
+                logger.dim('  Add to .claude/settings.local.json → mcpServers:');
+                logger.dim('  ' + '─'.repeat(55));
+                for (const line of instructions.configSnippet.split('\n')) {
+                  logger.dim(`  ${line}`);
+                }
+                logger.dim('  ' + '─'.repeat(55));
+
+                for (const cred of instructions.credentialUrls) {
+                  logger.dim(`  Get ${cred.name}: ${cred.helpUrl}`);
+                }
+                logger.dim(`  Or run later: ${instructions.cliCommand}`);
+              }
+            }
+          }
+
+          // Summary table
+          const justInstalled = { ...autoInstalled, ...manualInstalled };
+          const statusRows = formatMcpStatusTable(orchestration, justInstalled);
+
+          if (statusRows.length > 0) {
+            logger.blank();
+            logger.info('MCP Servers');
+            logger.dim('─'.repeat(60));
+
+            const STATUS_ICONS = {
+              installed: '✓',
+              available: '○',
+              already_configured: '✓',
+              needs_setup: '⚠',
+              prereq_missing: '✗',
+              not_relevant: '─'
+            };
+
+            for (const row of statusRows) {
+              const icon = STATUS_ICONS[row.status] || '?';
+              const statusLabel = row.status.replace(/_/g, ' ');
+              logger.dim(`  ${icon} ${row.name.padEnd(15)} ${statusLabel.padEnd(20)} ${row.detail}`);
+            }
+          }
+
+          mcpSetupResult = { autoInstalled, manualInstalled, orchestration };
+        }
+      } catch (error) {
+        logger.dim(`  MCP setup skipped: ${error.message}`);
+      }
+    } else {
+      logger.dim('\nSkipped MCP setup (--skip-mcp flag)');
+    }
+
+    spinner.succeed('MORPH-SPEC installed successfully!');
+
+    // Show next steps
+    logger.blank();
+    logger.success(`MORPH-SPEC v${cliVersion} installed successfully!`);
+    logger.blank();
+    logger.header('Next Steps');
+
+    logger.step(1, 'Review .morph/config/config.json');
+    logger.step(2, 'Open project in VS Code with Claude Code');
+    logger.step(3, 'Start your first feature:');
+    logger.blank();
+    logger.box([
+      'Ask Claude Code to implement a feature'
+    ]);
+    logger.blank();
+
+    logger.info('Files installed:');
+    logger.dim(`  ✓ CLAUDE.md`);
+    logger.dim(`  ✓ .morph/config/ (config.json)`);
+    logger.dim(`  ✓ .morph/framework/ (agents.json, standards/, templates/, hooks/)`);
+    logger.dim(`  ✓ .morph/context/ (project context)`);
+    logger.dim(`  ✓ .morph/features/ (feature outputs)`);
+    if (commandsCopied) {
+      logger.dim(`  ✓ .claude/commands/ (slash commands)`);
+    }
+    if (rulesCopied) {
+      logger.dim(`  ✓ .claude/rules/ (5 path-scoped rules)`);
+    }
+    logger.dim(`  ✓ .claude/settings.local.json (${hooksResult.installed} hooks installed)`);
+    if (integrationsCreated) {
+      logger.dim(`  ✓ .morph/config/integrations.json (detected plugins & MCPs)`);
+    }
+    if (mcpSetupResult) {
+      const autoCount = Object.keys(mcpSetupResult.autoInstalled).length;
+      const manualCount = Object.keys(mcpSetupResult.manualInstalled).length;
+      if (autoCount + manualCount > 0) {
+        logger.dim(`  ✓ MCP servers (${autoCount + manualCount} configured)`);
+      }
+    }
+
+    logger.dim('  ✓ .claude/skills/ (installed as skill directories)');
+
+    // Show agent team breakdown from setup-infra result
+    const agents = infraResult?.agents;
+    if (agents) {
+      const total = agents.tier1 + agents.tier2 + agents.specialists;
+      logger.dim(`  ✓ .claude/agents/ (${total} agents: ${agents.tier1} orchestrators, ${agents.tier2} domain leaders, ${agents.specialists} specialists)`);
+    } else {
+      logger.dim('  ✓ .claude/agents/ (native subagents installed)');
+    }
+
+    logger.dim('  ✓ ~/.claude/statusline.sh (global statusline installed)');
+
+    // Check CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in ~/.claude/settings.local.json
+    logger.blank();
+    const globalSettingsPath = join(homedir(), '.claude', 'settings.local.json');
+    let agentTeamsEnabled = false;
+    try {
+      const globalSettings = await readJson(globalSettingsPath);
+      agentTeamsEnabled = globalSettings?.env?.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === '1';
+    } catch {
+      // File missing or unreadable — treat as not enabled
+    }
+
+    if (agentTeamsEnabled) {
+      logger.success('Agent Teams: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS enabled ✓');
+    } else {
+      logger.warn('Agent Teams not enabled. To activate multi-agent workflows, add to ~/.claude/settings.local.json:');
+      logger.dim('  {"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}}');
+    }
+
+    logger.blank();
+
+    // Suggest tutorial for first-time users
+    if (integrationsCreated) {
+      logger.blank();
+      logger.info('First time using morph-spec? Run `morph-spec tutorial` to get started.');
+    }
+
+    logger.blank();
+
+  } catch (error) {
+    spinner.fail('Installation failed');
+    logger.error(error.message);
+    process.exit(1);
+  }
+}