@haposoft/cafekit 0.9.7 → 0.10.0

package/bin/install.js

@@ -1,1297 +1,136 @@
 #!/usr/bin/env node
 
 /**
- * CafeKit Installer
- * Multi-platform installer for AI coding assistants
+ * CafeKit Installer (orchestrator)
  *
- * Supported platforms (each install is fully self-contained):
- * - claude: Claude Code → .claude/ (skills, rules, scripts, references, runtime.json)
- * - opencode: OpenCode → .opencode/ (same layout, content rewritten on copy)
+ * Thin coordinator that runs the install as a sequence of phase handlers. Each
+ * phase receives and returns the run context (`ctx`). Heavy logic lives in
+ * bin/phases/* and bin/lib/*. Terminal UX is rendered via ctx.ui (clack in an
+ * interactive TTY; plain logs when piped/CI/--yes).
  *
- * Selecting both creates both folders independently. There is no shared
- * runtime directory between platforms.
- *
- * To add a new platform:
- * 1. Add to PLATFORMS registry below
- * 2. Add platform-specific commands in src/[platform]/commands/
- * 3. Update detectPlatforms() if using different folder names
+ * Safety features:
+ *  - Process lock (lib/lock)       — refuses to run concurrently.
+ *  - Pre-run snapshot (lib/backup) — rolls back on a mid-install crash.
+ *  - Ownership manifest (lib/manifest) — selective update; preserves user edits.
+ *  - --dry-run                     — preview only, no filesystem changes.
  */
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const readline = require('readline');
-const { execSync } = require('child_process');
-const packageJson = require('../package.json');
-const { copyRecursive, isTextAsset, readJsonFile } = require('./lib/copy-utils');
-const {
-  normalizeOpenCodeBody,
-  getOpenCodeCopyOptions,
-  convertOpenCodeAgentContent,
-  convertOpenCodeCommandContent,
-  copyOpenCodeAgentsMdFile,
-  copyOpenCodeSharedRuntimeFiles,
-  copyOpenCodePlugins,
-  copyOpenCodeCommandTemplates,
-  mergeOpenCodeConfig,
-  setupOpenCodeModel
-} = require('./lib/opencode-install');
-const INSTALL_COMMAND = `npx ${packageJson.name}@${packageJson.version}`;
-
-function validateManifestV2(manifest) {
-  if (!manifest || manifest.version !== 2) return false;
-  if (!manifest.runtime?.files || !Array.isArray(manifest.runtime.files)) return false;
-  if (!manifest.settings?.template) return false;
-  return true;
-}
-
-function loadClaudeMigrationManifest() {
-  const manifestPath = path.join(__dirname, '../src/claude/migration-manifest.json');
-
-  if (!fs.existsSync(manifestPath)) {
-    return null;
-  }
-
-  try {
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-
-    if (!validateManifestV2(manifest)) {
-      console.error('✗ Invalid manifest v2 schema - missing required fields');
-      console.error('  Expected: version=2, runtime.files[], settings.template');
-      process.exit(1);
-    }
-
-    return manifest;
-  } catch (error) {
-    console.warn(`⚠ Failed to parse Claude migration manifest: ${error.message}`);
-    return null;
-  }
-}
-
-const CLAUDE_MIGRATION_MANIFEST = loadClaudeMigrationManifest();
-
-const DEPENDENCY_TEMPLATES = {
-  commands: {
-    claude: {},
-    opencode: {}
-  },
-  agents: {
-    claude: {},
-    opencode: {}
-  }
-};
-
-// ═══════════════════════════════════════════════════════════
-// PLATFORM REGISTRY - Add new platforms here
-// ═══════════════════════════════════════════════════════════
-const PLATFORMS = {
-  claude: {
-    id: 'claude',
-    name: 'Claude Code',
-    description: 'Anthropic\'s Claude Code CLI',
-    folder: '.claude',
-    commandsDir: '.claude/commands',
-    skillsDir: '.claude/skills',
-    agentsDir: '.claude/agents',
-    skillsRef: '.claude/skills',
-    commandPrefix: '/',
-    sourceDir: 'claude',       // Maps to src/claude/
-    sourceSubdir: 'commands'   // Source subfolder within src/claude/
-  },
-  opencode: {
-    id: 'opencode',
-    name: 'OpenCode',
-    description: 'OpenCode terminal AI coding agent',
-    folder: '.opencode',
-    detectFiles: ['.opencode', 'opencode.json', 'opencode.jsonc'],
-    commandsDir: '.opencode/commands',
-    skillsDir: '.opencode/skills',
-    agentsDir: '.opencode/agents',
-    skillsRef: '.opencode/skills',
-    commandPrefix: '/',
-    sourceDir: 'claude',
-    sourceSubdir: 'archive-command'
-  }
-  // Add new platforms here:
-  // cursor: {
-  //   id: 'cursor',
-  //   name: 'Cursor',
-  //   description: 'Cursor IDE',
-  //   folder: '.cursor',
-  //   commandsDir: '.cursor/commands',
-  //   sourceDir: 'cursor',
-  //   sourceSubdir: 'commands'
-  // }
-};
-
-// ═══════════════════════════════════════════════════════════
-// DETECTION
-// ═══════════════════════════════════════════════════════════
-
-function detectPlatforms() {
-  const detected = [];
-
-  for (const [key, config] of Object.entries(PLATFORMS)) {
-    const markers = Array.isArray(config.detectFiles) ? config.detectFiles : [config.folder];
-    if (markers.some(marker => fs.existsSync(marker))) {
-      detected.push(key);
-    }
-  }
-
-  return detected;
-}
-
-function formatPlatformList() {
-  return Object.entries(PLATFORMS)
-    .map(([key, config], index) => {
-      return `${index + 1}) ${config.name} (${config.folder}/)\n   ${config.description}`;
-    })
-    .join('\n');
-}
-
-function getPlatformKeys() {
-  return Object.keys(PLATFORMS);
-}
-
-// Warn opencode-only installs when a legacy .claude/ folder remains from
-// pre-0.9.0 installs (when OpenCode shared the .claude/ runtime). We do not
-// delete anything; user must remove it explicitly to opt in.
-function warnLegacyClaudeFolder(platforms) {
-  if (!platforms.includes('opencode')) return;
-  if (platforms.includes('claude')) return;
-  if (!fs.existsSync('.claude')) return;
-
-  console.log('');
-  console.log('⚠ Legacy .claude/ folder detected.');
-  console.log('  As of CafeKit 0.9.0, OpenCode installs are self-contained under .opencode/.');
-  console.log('  The .claude/ folder from older installs is no longer used by OpenCode.');
-  console.log('  After this install finishes you can remove it: rm -rf .claude');
-  console.log('');
-}
-
-function isClaudeCompatibleRuntime(platformKey) {
-  return platformKey === 'claude' || platformKey === 'opencode';
-}
-
-function getRuntimeSupportTargetDir(platformKey, subdir) {
-  return path.join(PLATFORMS[platformKey].folder, subdir);
-}
-
-function parseInstallerArgs(argv) {
-  const args = {
-    upgrade: false
-  };
-
-  for (let i = 2; i < argv.length; i++) {
-    const arg = argv[i];
-
-    if (arg === '--upgrade' || arg === '-u' || arg === '--force' || arg === '-f') {
-      args.upgrade = true;
-    }
-  }
-
-  return args;
-}
-
-function getCopyOptions(platformKey, baseOptions = {}) {
-  if (platformKey === 'opencode') {
-    return getOpenCodeCopyOptions(baseOptions);
-  }
-  return baseOptions;
-}
-
-// ═══════════════════════════════════════════════════════════
-// USER INTERACTION
-// ═══════════════════════════════════════════════════════════
-
-async function promptPlatformSelection() {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  const maxChoice = Object.keys(PLATFORMS).length + 1;
-
-  console.log('╔════════════════════════════════════════════════════════╗');
-  console.log('║      CafeKit - Platform Selection                      ║');
-  console.log('╚════════════════════════════════════════════════════════╝');
-  console.log();
-  console.log('No existing AI editor configuration detected.\n');
-  console.log('Select which platform(s) to install for:\n');
-  console.log(formatPlatformList());
-  console.log(`${maxChoice}) All platforms`);
-  console.log('0) Cancel');
-  console.log();
-
-  return new Promise((resolve) => {
-    rl.question(`Select (0-${maxChoice}): `, (answer) => {
-      rl.close();
-      const choice = parseInt(answer.trim(), 10);
-
-      if (choice === 0 || isNaN(choice)) {
-        resolve([]);
-      } else if (choice === maxChoice) {
-        resolve(getPlatformKeys());
-      } else if (choice >= 1 && choice <= Object.keys(PLATFORMS).length) {
-        resolve([getPlatformKeys()[choice - 1]]);
-      } else {
-        console.log('Invalid selection. Please run the installer again.');
-        resolve([]);
-      }
-    });
-  });
-}
-
-async function promptMultiPlatformConfirm(detected) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  const platformNames = detected.map(key => PLATFORMS[key].name).join(', ');
-
-  console.log(`\nDetected existing configurations: ${platformNames}`);
-  console.log();
-
-  return new Promise((resolve) => {
-    rl.question('Install for all detected platforms? (Y/n): ', (answer) => {
-      rl.close();
-      const response = answer.trim().toLowerCase();
-      resolve(response === '' || response === 'y' || response === 'yes');
-    });
-  });
-}
+const { buildContext, PLATFORMS, packageJson } = require('./lib/context');
+const lock = require('./lib/lock');
+const backup = require('./lib/backup');
+const manifestLib = require('./lib/manifest');
 
-// ═══════════════════════════════════════════════════════════
-// FILE OPERATIONS
-// ═══════════════════════════════════════════════════════════
-
-function ensureDependencyFile(targetPath, content, results, label, options = {}) {
-  const destinationExists = fs.existsSync(targetPath);
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-
-  if (destinationExists && !shouldOverwriteManagedFiles) {
-    console.log(`  → Dependency exists: ${label}`);
-    results.dependencyChecks++;
-    return;
-  }
-
-  if (!content) {
-    console.log(`  ⚠ Missing dependency template: ${label}`);
-    results.dependencyChecks++;
-    results.missingDependencies++;
-    return;
-  }
-
-  fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-  fs.writeFileSync(targetPath, content, 'utf8');
-
-  if (destinationExists && shouldOverwriteManagedFiles) {
-    console.log(`  ↻ Dependency updated: ${label}`);
-    results.updated++;
-  } else {
-    console.log(`  ✓ Dependency installed: ${label}`);
-  }
-
-  results.dependencyChecks++;
-  results.installedDependencies++;
-}
-
-function ensureWorkflowDependencies(platformKey, platform, results, options = {}) {
-  const commandTemplates = DEPENDENCY_TEMPLATES.commands[platformKey] || {};
-  Object.entries(commandTemplates).forEach(([fileName, content]) => {
-    const targetPath = path.join(platform.commandsDir, fileName);
-    ensureDependencyFile(targetPath, content, results, path.join(platform.commandsDir, fileName), options);
-  });
-
-  const agentTemplates = DEPENDENCY_TEMPLATES.agents[platformKey] || {};
-  Object.entries(agentTemplates).forEach(([fileName, content]) => {
-    const targetPath = path.join(platform.agentsDir, fileName);
-    ensureDependencyFile(targetPath, content, results, path.join(platform.agentsDir, fileName), options);
-  });
-}
-
-function writePlatformVersionMetadata(platformKey, results) {
+const { resolvePlatforms } = require('./phases/select-platform');
+const { copyPlatformFiles } = require('./phases/copy-payload');
+const {
+  copyRoutingFile,
+  copyClaudeRuntimeFiles,
+  removeObsoleteClaudeRuntimeFiles,
+  copyClaudeMdFile,
+  copyRulesDirectory
+} = require('./phases/claude-runtime');
+const { mergeClaudeSettings } = require('./phases/claude-settings');
+const { installOpenCodeRuntime } = require('./phases/opencode-runtime');
+const { writePlatformVersionMetadata } = require('./phases/write-metadata');
+const { ensureGitignore } = require('./phases/root-config');
+const { runPostInstall } = require('./phases/post-install');
+const { printSummary } = require('./phases/summary');
+
+/** Install a single platform: payload + runtime + metadata, under one spinner. */
+function installPlatform(ctx, platformKey) {
   const platform = PLATFORMS[platformKey];
-  const targetPath = path.join(platform.folder, 'cafekit.json');
-  const targetExists = fs.existsSync(targetPath);
-  const existingMetadata = readJsonFile(targetPath);
-  const now = new Date().toISOString();
-  const previousVersion = typeof existingMetadata.version === 'string'
-    ? existingMetadata.version
-    : null;
 
-  const metadata = {
-    schemaVersion: 1,
-    packageName: packageJson.name,
-    version: packageJson.version,
-    platform: platform.id,
-    platformName: platform.name,
-    installedAt: existingMetadata.installedAt || now,
-    lastInstalledAt: now,
-    installCommand: INSTALL_COMMAND
-  };
+  // Read ownership baseline + start a fresh tracker for this platform.
+  ctx.ownership[platform.folder] = manifestLib.read(platform.folder);
+  ctx.trackers[platformKey] = manifestLib.createTracker(platform.folder, packageJson.version);
 
-  if (previousVersion && previousVersion !== packageJson.version) {
-    metadata.previousVersion = previousVersion;
-  }
+  const before = { copied: ctx.results.copied, updated: ctx.results.updated, skills: ctx.results.installedSkills };
+  ctx.ui.startSpinner(`Installing ${platform.name} (${platform.folder}/)`);
 
-  fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-  fs.writeFileSync(targetPath, `${JSON.stringify(metadata, null, 2)}\n`, 'utf8');
+  copyPlatformFiles(ctx, platformKey);
 
-  if (targetExists) {
-    console.log(`  ↻ Version metadata updated: ${targetPath}`);
-    results.updated++;
-  } else {
-    console.log(`  ✓ Version metadata installed: ${targetPath}`);
-    results.copied++;
-  }
-}
-
-function getPlatformSpecFiles(platformKey) {
   if (platformKey === 'claude') {
-    const manifestCommands = CLAUDE_MIGRATION_MANIFEST?.commands?.core;
-    if (Array.isArray(manifestCommands)) {
-      return manifestCommands;
-    }
-
-    return [
-      'spec-init.md',
-      'spec-requirements.md',
-      'spec-design.md',
-      'spec-validate.md',
-      'spec-tasks.md',
-      'spec-status.md',
-      'code.md',
-      'test.md',
-      'docs.md'
-    ];
+    copyRoutingFile(ctx, platformKey);
+    copyClaudeRuntimeFiles(ctx, platformKey);
+    removeObsoleteClaudeRuntimeFiles(ctx, platformKey);
+    mergeClaudeSettings(ctx, platformKey);
+    copyClaudeMdFile(ctx, platformKey);
+    copyRulesDirectory(ctx, platformKey);
   }
 
   if (platformKey === 'opencode') {
-    return [];
+    installOpenCodeRuntime(ctx, platformKey);
   }
 
-  return [];
-}
-
-function copyPlatformFiles(platformKey, results, options = {}) {
-  const platform = PLATFORMS[platformKey];
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-  const recordWriteResult = (didOverwrite) => {
-    if (didOverwrite) {
-      results.updated++;
-    } else {
-      results.copied++;
-    }
-  };
-
-  // Source directories - support different subfolder names per platform
-  const sourceSubdir = platform.sourceSubdir || 'commands';
-  const commandsSourceDir = path.join(__dirname, `../src/${platform.sourceDir}/${sourceSubdir}`);
-  const skillsSourceDir = path.join(__dirname, '../src/claude/skills');
-  const agentsSourceDir = path.join(__dirname, `../src/${platform.sourceDir}/agents`);
-
-  // Create directories
-  // commandsDir is created on-demand per platform: Claude only mkdirs when
-  // getPlatformSpecFiles returns files; OpenCode mkdirs inside
-  // copyOpenCodeCommandTemplates. Skip the unconditional mkdir to avoid
-  // leaving empty commands/ folders behind.
-  if (!fs.existsSync(platform.skillsDir)) {
-    fs.mkdirSync(platform.skillsDir, { recursive: true });
-  }
-  if (!fs.existsSync(platform.agentsDir)) {
-    fs.mkdirSync(platform.agentsDir, { recursive: true });
-  }
-
-  // Copy skills (shared across all platforms)
-  if (fs.existsSync(skillsSourceDir)) {
-    const specSkillSource = path.join(skillsSourceDir, 'specs');
-    const specSkillDest = path.join(platform.skillsDir, 'specs');
-
-    if (fs.existsSync(specSkillSource)) {
-      const skillExisted = fs.existsSync(specSkillDest);
-      copyRecursive(specSkillSource, specSkillDest, getCopyOptions(platformKey, options));
-      results.installedSkills++;
-
-      if (shouldOverwriteManagedFiles && skillExisted) {
-        console.log(`  ↻ Skill updated: specs`);
-        results.updated++;
-      } else {
-        console.log(`  ✓ Skill installed: specs`);
-      }
-    }
-
-    // Keep templates in sync for claude command runtime copies under .claude/skills/specs
-    if (platformKey === 'claude') {
-      const legacyInitTemplate = path.join(platform.skillsDir, 'specs', 'templates', 'init.json');
-      if (fs.existsSync(legacyInitTemplate)) {
-        fs.rmSync(legacyInitTemplate, { force: true });
-        console.log(`  ↻ Removed legacy template: ${legacyInitTemplate}`);
-        results.updated++;
-      }
-
-      const specTemplates = [
-        'spec-state.json',
-        'requirements-init.md',
-        'requirements.md',
-        'design.md',
-        'research.md',
-        'task.md'
-      ];
-
-      specTemplates.forEach((fileName) => {
-        const source = path.join(specSkillSource, 'templates', fileName);
-        const dest = path.join(platform.skillsDir, 'specs', 'templates', fileName);
-
-        if (!fs.existsSync(source)) {
-          console.log(`  ⚠ Missing dependency template: ${path.join(platform.skillsDir, 'specs', 'templates', fileName)}`);
-          results.missingDependencies++;
-          results.dependencyChecks++;
-          return;
-        }
-
-        const destinationExists = fs.existsSync(dest);
-
-        if (destinationExists && !shouldOverwriteManagedFiles) {
-          console.log(`  → Dependency exists: ${path.join(platform.skillsDir, 'specs', 'templates', fileName)}`);
-          results.dependencyChecks++;
-          return;
-        }
+  writePlatformVersionMetadata(ctx, platformKey);
 
-        fs.mkdirSync(path.dirname(dest), { recursive: true });
-        fs.copyFileSync(source, dest);
-        results.dependencyChecks++;
-        results.installedDependencies++;
-
-        if (destinationExists && shouldOverwriteManagedFiles) {
-          console.log(`  ↻ Dependency updated: ${path.join(platform.skillsDir, 'specs', 'templates', fileName)}`);
-          results.updated++;
-        } else {
-          console.log(`  ✓ Dependency installed: ${path.join(platform.skillsDir, 'specs', 'templates', fileName)}`);
-        }
-      });
-    }
-
-    // Copy additional required skills based on platform
-    let requiredSkills = [];
-    if (isClaudeCompatibleRuntime(platformKey)) {
-      requiredSkills = CLAUDE_MIGRATION_MANIFEST?.skills?.required || [];
-    }
-
-    requiredSkills
-      .filter((skillName) => skillName !== 'specs')
-      .forEach((skillName) => {
-        const skillSource = path.join(skillsSourceDir, skillName);
-        const skillDest = path.join(platform.skillsDir, skillName);
-
-        if (fs.existsSync(skillSource)) {
-          const skillExisted = fs.existsSync(skillDest);
-          copyRecursive(skillSource, skillDest, getCopyOptions(platformKey, options));
-          results.installedSkills++;
-
-          if (shouldOverwriteManagedFiles && skillExisted) {
-            console.log(`  ↻ Skill updated: ${skillName}`);
-            results.updated++;
-          } else {
-            console.log(`  ✓ Skill installed: ${skillName}`);
-          }
-        } else {
-          results.missingDependencies++;
-          console.log(`  ⚠ Missing dependency template: ${path.join(platform.skillsDir, skillName)}`);
-        }
-      });
-  }
-
-  // Copy agents
-  if (isClaudeCompatibleRuntime(platformKey)) {
-    if (fs.existsSync(agentsSourceDir)) {
-      const requiredAgents = CLAUDE_MIGRATION_MANIFEST?.agents?.required || [
-        'tester.md',
-        'code-reviewer.md',
-        'fullstack-developer.md',
-        'debugger.md'
-      ];
-
-      requiredAgents.forEach((fileName) => {
-        const source = path.join(agentsSourceDir, fileName);
-        const dest = path.join(platform.agentsDir, fileName);
-
-        if (!fs.existsSync(source)) {
-          console.log(`  ⚠ Missing dependency template: ${path.join(platform.agentsDir, fileName)}`);
-          results.missingDependencies++;
-          results.dependencyChecks++;
-          return;
-        }
-
-        const destinationExists = fs.existsSync(dest);
-
-        if (destinationExists && !shouldOverwriteManagedFiles) {
-          console.log(`  → Dependency exists: ${path.join(platform.agentsDir, fileName)}`);
-          results.dependencyChecks++;
-          return;
-        }
-
-        fs.mkdirSync(path.dirname(dest), { recursive: true });
-        if (platformKey === 'opencode') {
-          const content = fs.readFileSync(source, 'utf8');
-          fs.writeFileSync(dest, convertOpenCodeAgentContent(content, fileName), 'utf8');
-        } else {
-          fs.copyFileSync(source, dest);
-        }
-        results.dependencyChecks++;
-        results.installedDependencies++;
-
-        if (destinationExists && shouldOverwriteManagedFiles) {
-          console.log(`  ↻ Dependency updated: ${path.join(platform.agentsDir, fileName)}`);
-          results.updated++;
-        } else {
-          console.log(`  ✓ Dependency installed: ${path.join(platform.agentsDir, fileName)}`);
-        }
-      });
-
-      // Copy agent reference manuals (debugger manuals, etc.) recursively
-      const refsSource = path.join(__dirname, '../src', platform.sourceDir, 'references');
-      if (fs.existsSync(refsSource)) {
-        const refsDest = getRuntimeSupportTargetDir(platformKey, 'references');
-        const refsExisted = fs.existsSync(refsDest);
-        copyRecursive(refsSource, refsDest, getCopyOptions(platformKey, options));
-
-        if (shouldOverwriteManagedFiles && refsExisted) {
-          console.log(`  ↻ Agent reference manuals updated`);
-          results.updated++;
-        } else {
-          console.log(`  ✓ Agent reference manuals installed`);
-          results.copied++;
-        }
-      }
-
-    } else {
-      results.missingDependencies++;
-      console.log(`  ⚠ Missing dependency template: ${platform.agentsDir}`);
-    }
+  const wrote = (ctx.results.copied - before.copied) + (ctx.results.updated - before.updated);
+  const verb = ctx.dryRun ? 'would install' : 'installed';
+  ctx.ui.stopSpinner(`${platform.name} ${verb} — ${wrote} file(s), ${ctx.results.installedSkills - before.skills} skill(s)`);
 
-    // Copy native scripts (browser-tool, docs-fetch, validate-docs)
-    const scriptsSourceDir = path.join(__dirname, '../src/claude/scripts');
-    if (fs.existsSync(scriptsSourceDir)) {
-      const scriptsDest = getRuntimeSupportTargetDir(platformKey, 'scripts');
-      const scriptsExisted = fs.existsSync(scriptsDest);
-      copyRecursive(scriptsSourceDir, scriptsDest, getCopyOptions(platformKey, options));
-
-      if (shouldOverwriteManagedFiles && scriptsExisted) {
-        console.log(`  ↻ Native scripts updated`);
-        results.updated++;
-      } else {
-        console.log(`  ✓ Native scripts installed`);
-        results.copied++;
-      }
-    }
-
-  }
-
-  ensureWorkflowDependencies(platformKey, platform, results, options);
-
-  // Copy commands/workflows
-  const specFiles = getPlatformSpecFiles(platformKey);
-
-  specFiles.forEach(file => {
-    const source = path.join(commandsSourceDir, file);
-    const dest = path.join(platform.commandsDir, file);
-    const destinationExists = fs.existsSync(dest);
-
-    if (!fs.existsSync(source)) {
-      console.error(`  ✗ Error: Source file not found: ${file}`);
-      results.errors++;
-      return;
-    }
-
-    if (destinationExists && !shouldOverwriteManagedFiles) {
-      console.log(`  → Skipped: ${file} (already exists)`);
-      results.skipped++;
-      return;
-    }
-
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    let content = fs.readFileSync(source, 'utf8');
-    content = content.replace(/\{\{SKILLS_DIR\}\}/g, platform.skillsRef);
-    if (platformKey === 'opencode') {
-      content = convertOpenCodeCommandContent(content, file);
-    }
-    fs.writeFileSync(dest, content);
-
-    if (destinationExists && shouldOverwriteManagedFiles) {
-      console.log(`  ↻ Updated: ${file}`);
-      recordWriteResult(true);
-    } else {
-      console.log(`  ✓ Copied: ${file}`);
-      recordWriteResult(false);
-    }
-  });
-}
-
-// Copy ROUTING.md to .claude/
-function copyRoutingFile(platformKey, results, options = {}) {
-  const platform = PLATFORMS[platformKey];
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-  const source = path.join(__dirname, `../src/${platform.sourceDir}/ROUTING.md`);
-  const dest = path.join(platform.folder, 'ROUTING.md');
-
-  if (fs.existsSync(source)) {
-    const destinationExists = fs.existsSync(dest);
-
-    if (destinationExists && !shouldOverwriteManagedFiles) {
-      console.log(`  → Skipped: ROUTING.md (already exists)`);
-      results.skipped++;
-      return;
-    }
-
-    let content = fs.readFileSync(source, 'utf8');
-    content = content.replace(/\{\{SKILLS_DIR\}\}/g, platform.skillsRef);
-    if (platformKey === 'opencode') {
-      content = normalizeOpenCodeBody(content);
-    }
-    fs.writeFileSync(dest, content);
-
-    if (destinationExists && shouldOverwriteManagedFiles) {
-      console.log(`  ↻ Updated: ROUTING.md`);
-      results.updated++;
-    } else {
-      console.log(`  ✓ Copied: ROUTING.md`);
-      results.copied++;
-    }
-  }
-}
-
-// Copy Claude runtime files (statusline bundle)
-function copyClaudeRuntimeFiles(platformKey, results, options = {}) {
-  if (platformKey !== 'claude') return;
-
-  const manifest = CLAUDE_MIGRATION_MANIFEST;
-  if (!manifest?.runtime?.files) return;
-
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-  const srcBase = path.join(__dirname, '../src/claude');
-  const targetBase = path.join(PLATFORMS.claude.folder);
-
-  manifest.runtime.files.forEach(relPath => {
-    const srcPath = path.join(srcBase, relPath);
-    const targetRelPath = relPath === 'gitignore' ? '.gitignore' : relPath;
-    const targetPath = path.join(targetBase, targetRelPath);
-
-    if (!fs.existsSync(srcPath)) {
-      console.log(`  ⚠ Runtime file not found: ${relPath}`);
-      results.missingDependencies++;
-      return;
-    }
-
-    const targetExists = fs.existsSync(targetPath);
-    const shouldCopy = shouldOverwriteManagedFiles || !targetExists;
-
-    if (shouldCopy) {
-      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-      fs.copyFileSync(srcPath, targetPath);
-
-      if (targetExists) {
-        console.log(`  ↻ Runtime updated: ${targetRelPath}`);
-        results.updated++;
-      } else {
-        console.log(`  ✓ Runtime installed: ${targetRelPath}`);
-        results.copied++;
-      }
-    } else {
-      results.skipped++;
-    }
-  });
+  ctx.results.targets.push(platform.commandsDir);
 }
 
-function removeObsoleteClaudeRuntimeFiles(platformKey, results) {
-  if (platformKey !== 'claude') return;
-
-  const obsoleteFiles = CLAUDE_MIGRATION_MANIFEST?.obsolete?.runtimeFiles || [];
-  const targetBase = path.join(PLATFORMS.claude.folder);
-
-  obsoleteFiles.forEach(relPath => {
-    const targetPath = path.join(targetBase, relPath);
-
-    if (!fs.existsSync(targetPath)) {
-      return;
-    }
-
-    fs.rmSync(targetPath, { force: true });
-    console.log(`  ↻ Removed obsolete runtime: ${relPath}`);
-    results.updated++;
-  });
-}
-
-function pruneObsoleteSettingsHooks(settings, results) {
-  const obsoleteSubstrings = CLAUDE_MIGRATION_MANIFEST?.obsolete?.settingsHookCommandSubstrings || [];
-
-  if (!settings.hooks || obsoleteSubstrings.length === 0) {
-    return settings;
-  }
-
-  let removedCount = 0;
-  const prunedHooks = {};
-
-  Object.entries(settings.hooks).forEach(([eventName, matcherEntries]) => {
-    if (!Array.isArray(matcherEntries)) {
-      prunedHooks[eventName] = matcherEntries;
-      return;
-    }
-
-    const prunedEntries = [];
-
-    matcherEntries.forEach(entry => {
-      if (!Array.isArray(entry?.hooks)) {
-        prunedEntries.push(entry);
-        return;
-      }
-
-      const remainingHooks = entry.hooks.filter(hook => {
-        const command = hook?.command || '';
-        const isObsolete = obsoleteSubstrings.some(substring => command.includes(substring));
-
-        if (isObsolete) {
-          removedCount++;
-        }
-
-        return !isObsolete;
-      });
-
-      if (remainingHooks.length > 0) {
-        prunedEntries.push({ ...entry, hooks: remainingHooks });
-      }
-    });
-
-    if (prunedEntries.length > 0) {
-      prunedHooks[eventName] = prunedEntries;
-    }
-  });
-
-  if (removedCount > 0) {
-    console.log(`  ↻ Settings: removed ${removedCount} obsolete hook(s)`);
-    results.updated++;
-    return { ...settings, hooks: prunedHooks };
-  }
-
-  return settings;
-}
-
-// Merge Claude settings.json
-function mergeClaudeSettings(platformKey, results, options = {}) {
-  if (platformKey !== 'claude') return;
-
-  const manifest = CLAUDE_MIGRATION_MANIFEST;
-  if (!manifest?.settings?.template) return;
-
-  const templatePath = path.join(__dirname, '../src/claude', manifest.settings.template);
-  const targetPath = path.join(PLATFORMS.claude.folder, 'settings.json');
-
-  if (!fs.existsSync(templatePath)) {
-    console.log(`  ⚠ Settings template not found: ${manifest.settings.template}`);
-    return;
-  }
-
-  const managedSettings = JSON.parse(fs.readFileSync(templatePath, 'utf8'));
-  let existingSettings = {};
-
-  if (fs.existsSync(targetPath)) {
-    existingSettings = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
-  }
-
-  const mergedSettings = pruneObsoleteSettingsHooks({ ...existingSettings }, results);
-
-  // Merge statusLine
-  if (managedSettings.statusLine) {
-    const existingCommand = existingSettings.statusLine?.command || '';
-    const isCafeKitOwned = existingCommand.includes('status.cjs') || existingCommand.includes('statusline.cjs');
-
-    if (options.upgrade || !existingSettings.statusLine || isCafeKitOwned) {
-      mergedSettings.statusLine = managedSettings.statusLine;
-      console.log(`  ✓ Settings: statusLine merged`);
-    }
-  }
-
-  // Merge hooks
-  if (managedSettings.hooks) {
-    mergedSettings.hooks = mergedSettings.hooks || {};
-
-    Object.keys(managedSettings.hooks).forEach(eventName => {
-      const managedHooks = managedSettings.hooks[eventName];
-      const existingHooks = mergedSettings.hooks[eventName] || [];
-      const mergedHooks = [...existingHooks];
-
-      managedHooks.forEach(managedHook => {
-        const managedCommand = managedHook.hooks?.[0]?.command || '';
-        const isDuplicate = mergedHooks.some(existingHook => {
-          return existingHook.hooks?.some(h => h.command === managedCommand);
-        });
-
-        if (!isDuplicate) {
-          mergedHooks.push(managedHook);
-          console.log(`  ✓ Settings: hook ${eventName} merged`);
-        }
-      });
-
-      mergedSettings.hooks[eventName] = mergedHooks;
-    });
-  }
-
-  fs.writeFileSync(targetPath, JSON.stringify(mergedSettings, null, 2), 'utf8');
-}
-
-// Copy CLAUDE.md template (always overwrite at Project Root)
-function copyClaudeMdFile(platformKey, results, options = {}) {
-  if (platformKey !== 'claude') return;
-
-  const source = path.join(__dirname, '../src/claude/CLAUDE.md');
-  const dest = 'CLAUDE.md'; // Xuất thẳng ra thư mục ROOT thay vì nhét vào trong .claude/
-
-  if (fs.existsSync(source)) {
-    const destinationExists = fs.existsSync(dest);
-
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(source, dest);
-
-    if (destinationExists) {
-      console.log(`  ↻ CLAUDE.md overwritten`);
-      results.updated++;
-    } else {
-      console.log(`  ✓ CLAUDE.md installed`);
-      results.copied++;
-    }
-  } else {
-    console.log(`  ⚠ CLAUDE.md template not found`);
-    results.missingDependencies++;
-  }
-}
-
-// Copy rules directory (always overwrite)
-function copyRulesDirectory(platformKey, results, options = {}) {
-  if (!isClaudeCompatibleRuntime(platformKey)) return;
-
-  const source = path.join(__dirname, '../src/claude/rules');
-  const dest = getRuntimeSupportTargetDir(platformKey, 'rules');
-
-  if (fs.existsSync(source)) {
-    copyRecursive(source, dest, getCopyOptions(platformKey, { upgrade: true }));
-    console.log(`  ↻ rules/ directory overwritten`);
-    results.updated++;
-  } else {
-    console.log(`  ⚠ rules/ directory not found`);
-    results.missingDependencies++;
-  }
-}
-
-// Ensure .gitignore configured at root
-function ensureGitignore(results, options = {}) {
-  const gitignorePath = path.join(process.cwd(), '.gitignore');
-  const header = '# CafeKit / Ecosystem';
-  const patterns = [
-    'specs/_shared/',
-    'plans/',
-    '!plans/templates/'
-  ];
-
-  if (!fs.existsSync(gitignorePath)) {
-    const content = ['# Git Ignore', '', header, ...patterns, ''].join('\n');
-    fs.writeFileSync(gitignorePath, content, 'utf8');
-    console.log('  ✓ .gitignore created at root');
-    results.copied++;
-    return;
-  }
-
-  const content = fs.readFileSync(gitignorePath, 'utf8');
-  const lines = content.split('\n').map(l => l.trim());
-  const missing = patterns.filter(p => !lines.includes(p));
-
-  if (missing.length > 0) {
-    let newContent = content;
-    if (!newContent.endsWith('\n')) newContent += '\n';
-    if (!content.includes(header)) newContent += `\n${header}\n`;
-
-    newContent += missing.join('\n') + '\n';
-    fs.writeFileSync(gitignorePath, newContent, 'utf8');
-    console.log(`  ↻ .gitignore updated: added ${missing.join(', ')}`);
-    results.updated++;
-  } else {
-    console.log('  → .gitignore already up to date');
-    results.skipped++;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════
-// GEMINI CLI SETUP
-// ═══════════════════════════════════════════════════════════
-
-function checkGeminiCLI() {
-  try {
-    execSync('which gemini', { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function installGeminiCLI() {
-  console.log('\n⚙ Installing gemini-cli...');
-  try {
-    execSync('npm install -g @google/gemini-cli', { stdio: 'inherit' });
-    console.log('  ✓ gemini-cli installed successfully');
-    return true;
-  } catch (error) {
-    console.log('  ✗ Failed to install gemini-cli automatically');
-    console.log('  Please run manually: npm install -g @google/gemini-cli');
-    return false;
-  }
-}
-
-async function promptInstallGemini() {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  console.log('\n📦 Optional: Gemini CLI Installation');
-  console.log('  hapo:inspect with ext mode requires gemini-cli');
-  console.log('  • Install now: Auto-install and configure API key');
-  console.log('  • Skip: You can still use hapo:inspect in internal mode');
-  console.log();
-
-  return new Promise((resolve) => {
-    rl.question('Install gemini-cli? (Y/n): ', (answer) => {
-      rl.close();
-      const response = answer.trim().toLowerCase();
-      resolve(response === '' || response === 'y' || response === 'yes');
-    });
-  });
-}
-
-async function promptGeminiAPIKey() {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  console.log('\n📝 Gemini API Key Configuration');
-  console.log('  Get your API key: https://aistudio.google.com/apikey');
-  console.log();
-
-  return new Promise((resolve) => {
-    rl.question('Enter your Gemini API key (or press Enter to skip): ', (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-function configureGeminiKey(apiKey, platforms = ['claude']) {
-  const envBody = `GEMINI_API_KEY=${apiKey}\nVISUAL_MODEL=gemma-4-31b-it\nSEARCH_MODEL=gemini-2.5-pro\n`;
-  const targets = platforms
-    .filter(key => PLATFORMS[key])
-    .map(key => PLATFORMS[key].folder);
-
-  if (targets.length === 0) {
-    targets.push('.claude');
-  }
-
-  let success = true;
-  for (const folder of targets) {
-    try {
-      const targetDir = path.join(process.cwd(), folder);
-      const localEnvFile = path.join(targetDir, '.env');
-
-      if (!fs.existsSync(targetDir)) {
-        fs.mkdirSync(targetDir, { recursive: true });
-      }
-
-      fs.writeFileSync(localEnvFile, envBody, { mode: 0o600 });
-      console.log(`  ✓ Gemini API key configured securely in project (${folder}/.env)`);
-    } catch (error) {
-      success = false;
-      console.log('  ✗ Failed to configure Gemini API key');
-      console.log(`  Error: ${error.message}`);
-      console.log('  You can manually set: export GEMINI_API_KEY="your-key"');
-    }
-  }
-
-  return success;
-}
-
-async function promptAddressingConfig() {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  return new Promise((resolve) => {
-    rl.question('\nHow should the AI address you? (e.g. boss, sir, master - Enter to skip): ', (answer) => {
-      rl.close();
-      const userAddress = answer.trim();
-
-      // Blank = skip, no addressing configured
-      if (!userAddress || userAddress.length === 0) {
-        resolve({ enabled: false, userAddress: '' });
-        return;
-      }
-
-      // Validate: letters and spaces only
-      if (/[^a-zA-ZÀ-ỹ\s]/.test(userAddress)) {
-        console.log('  ⚠ Invalid input (letters only), skipping addressing setup');
-        resolve({ enabled: false, userAddress: '' });
-        return;
-      }
-
-      resolve({ enabled: true, userAddress: userAddress });
-    });
-  });
-}
-
-function configureAddressing(addressingConfig, platforms = ['claude']) {
-  // CLAUDE.md is installed at the project root (see copyClaudeMdFile),
-  // and only the Claude platform ships it. Skip if Claude isn't installed.
-  if (!platforms.includes('claude')) {
-    return;
-  }
-
-  // Skip if addressing not enabled (user left blank or invalid input)
-  if (!addressingConfig.enabled || !addressingConfig.userAddress) {
-    console.log('  → Bỏ qua thiết lập xưng hô');
-    return;
+async function main() {
+  // ── Concurrency guard (before context; plain output) ────
+  const got = lock.acquire();
+  if (!got.acquired) {
+    console.error(`✗ Another CafeKit install is in progress (pid ${got.pid}, since ${got.since}).`);
+    console.error('  If that process is gone, delete .cafekit.lock and retry.');
+    process.exit(1);
   }
 
-  const userAddress = addressingConfig.userAddress;
+  let ctx;
+  let exitCode = 0;
 
   try {
-    const claudeMdFile = path.join(process.cwd(), 'CLAUDE.md');
+    ctx = buildContext(process.argv, `${Date.now()}`);
+    ctx.ui.intro(`${ctx.ui.pc.bgCyan(ctx.ui.pc.black(' CafeKit '))} Installer v${packageJson.version} · Multi-platform SDD`);
+    if (got.reclaimed) ctx.ui.info('Reclaimed a stale install lock from a dead process.');
 
-    if (!fs.existsSync(claudeMdFile)) {
-      console.log('  ⚠ CLAUDE.md not found at project root');
-      return;
+    await resolvePlatforms(ctx);
+    if (ctx.cancelled) {
+      lock.release();
+      process.exit(0);
     }
 
-    let content = fs.readFileSync(claudeMdFile, 'utf8');
-
-    // Build the addressing section (short instruction + user-chosen term)
-    const addressingSection = `## Addressing (Context Overflow Indicator)
-
-The AI always addresses the user as "${userAddress}" throughout the conversation. If the AI stops doing so, it is a sign the context has been compacted/truncated — tell the user to consider \`/clear\`.`;
-
-    // Match the addressing section by its shared marker ("Context Overflow
-    // Indicator"), covering both the older Vietnamese heading and the new one,
-    // up to the next ## header or end of file. Keeps reinstall idempotent.
-    const regex = /##[^\n]*Context Overflow Indicator[^\n]*[\s\S]*?(?=\n##|\n*$)/;
-
-    if (regex.test(content)) {
-      // Replace existing section
-      content = content.replace(regex, addressingSection);
-    } else {
-      // Append at the end
-      if (!content.endsWith('\n')) {
-        content += '\n';
-      }
-      content += '\n' + addressingSection + '\n';
+    // ── Pre-run snapshot for rollback ─────────────────────
+    // Capture platform folders AND the root files the pipeline mutates
+    // (CLAUDE.md, .gitignore) so a mid-run failure rolls back cleanly.
+    if (!ctx.dryRun) {
+      const folders = ctx.platforms.map((key) => PLATFORMS[key].folder);
+      ctx.backupDir = backup.snapshot([...folders, 'CLAUDE.md', '.gitignore'], ctx.runId);
     }
 
-    fs.writeFileSync(claudeMdFile, content, 'utf8');
-    console.log(`  ✓ Addressing configured in CLAUDE.md: AI calls the user "${userAddress}"`);
-  } catch (error) {
-    console.error('  ✗ Failed to configure addressing in CLAUDE.md');
-    console.error(`     Error: ${error.message}`);
-    if (process.env.DEBUG) {
-      console.error(error.stack);
+    for (const platformKey of ctx.platforms) {
+      installPlatform(ctx, platformKey);
     }
-  }
-}
 
-async function setupGeminiCLI(platforms) {
-  const hasGemini = checkGeminiCLI();
+    ensureGitignore(ctx);
+    await runPostInstall(ctx);
+    printSummary(ctx);
 
-  if (hasGemini) {
-    console.log('  ✓ gemini-cli already installed');
-  } else {
-    const shouldInstall = await promptInstallGemini();
-    if (shouldInstall) {
-      installGeminiCLI();
-    } else {
-      console.log('\n  ℹ Skipped gemini-cli installation');
-      console.log('  • hapo:inspect will work in internal mode (default)');
-      console.log('  • To install later: npm install -g @google/gemini-cli');
-    }
-  }
+    if (!ctx.dryRun) backup.prune(3);
 
-  // Always prompt for API config since we need it for hapo:test Multimodal
-  const apiKey = await promptGeminiAPIKey();
-  if (apiKey) {
-    configureGeminiKey(apiKey, platforms);
-  } else {
-    console.log('\n  ℹ Skipped API key configuration');
-    console.log('  Set later: export GEMINI_API_KEY="your-key"');
-  }
-}
-
-// ═══════════════════════════════════════════════════════════
-// MAIN
-// ═══════════════════════════════════════════════════════════
-
-async function main() {
-  const installerOptions = parseInstallerArgs(process.argv);
-
-  console.log();
-  console.log('╔════════════════════════════════════════════════════════╗');
-  console.log(`║         CafeKit Installer v${String(packageJson.version).padEnd(5, ' ')}                    ║`);
-  console.log('║         Multi-platform SDD Workflow                    ║');
-  console.log('╚════════════════════════════════════════════════════════╝');
-  console.log();
-
-  let platforms = detectPlatforms();
-
-  if (platforms.length === 0) {
-    // No platforms detected - prompt user
-    platforms = await promptPlatformSelection();
-
-    if (platforms.length === 0) {
-      console.log('\nInstallation cancelled.');
-      process.exit(0);
-    }
-  } else if (platforms.length > 1) {
-    // Multiple platforms detected - confirm with user
-    const proceed = await promptMultiPlatformConfirm(platforms);
-    if (!proceed) {
-      platforms = await promptPlatformSelection();
-      if (platforms.length === 0) {
-        console.log('\nInstallation cancelled.');
-        process.exit(0);
+    exitCode = ctx.results.errors > 0 ? 1 : 0;
+  } catch (error) {
+    const log = ctx && ctx.ui ? ctx.ui : { error: (m) => console.error(m) };
+    log.error(`Installation failed: ${error.message}`);
+    if (ctx && ctx.backupDir && !ctx.dryRun) {
+      try {
+        backup.restore(ctx.backupDir);
+        log.error('Rolled back to the pre-install state from snapshot.');
+      } catch (restoreError) {
+        log.error(`Rollback failed: ${restoreError.message}`);
+        log.error(`Manual restore available at: ${ctx.backupDir}`);
       }
     }
+    exitCode = 1;
+  } finally {
+    lock.release();
   }
 
-  // Show detected/selected platforms
-  const platformNames = platforms.map(key => PLATFORMS[key].name).join(', ');
-  console.log(`\nInstalling for: ${platformNames}`);
-
-  warnLegacyClaudeFolder(platforms);
-
-  if (installerOptions.upgrade) {
-    console.log('Mode: upgrade (overwrite managed files)\n');
-  } else {
-    console.log('Mode: install (skip existing files)\n');
-  }
-
-  const results = {
-    copied: 0,
-    updated: 0,
-    skipped: 0,
-    installedSkills: 0,
-    dependencyChecks: 0,
-    installedDependencies: 0,
-    missingDependencies: 0,
-    errors: 0,
-    targets: []
-  };
-
-  try {
-    for (const platformKey of platforms) {
-      const platform = PLATFORMS[platformKey];
-      console.log(`${platform.name} (${platform.folder}/)`);
-      console.log('-'.repeat(40));
-
-      copyPlatformFiles(platformKey, results, installerOptions);
-
-      // Copy ROUTING.md for Claude Code platform
-      if (platformKey === 'claude') {
-        copyRoutingFile(platformKey, results, installerOptions);
-        copyClaudeRuntimeFiles(platformKey, results, installerOptions);
-        removeObsoleteClaudeRuntimeFiles(platformKey, results);
-        mergeClaudeSettings(platformKey, results, installerOptions);
-        copyClaudeMdFile(platformKey, results, installerOptions);
-        copyRulesDirectory(platformKey, results, installerOptions);
-      }
-
-      if (platformKey === 'opencode') {
-        copyOpenCodeSharedRuntimeFiles(platformKey, results, installerOptions);
-        copyOpenCodePlugins(platformKey, results, installerOptions);
-        copyOpenCodeCommandTemplates(platformKey, results, installerOptions);
-        copyOpenCodeAgentsMdFile(platformKey, results, installerOptions);
-        copyRulesDirectory(platformKey, results, installerOptions);
-        mergeOpenCodeConfig(platformKey, results);
-      }
-
-      writePlatformVersionMetadata(platformKey, results);
-
-      results.targets.push(platform.commandsDir);
-      console.log();
-    }
-
-    // Ensure root .gitignore is configured correctly
-    console.log('Root Configuration');
-    console.log('-'.repeat(40));
-    ensureGitignore(results, installerOptions);
-    console.log();
-
-    // Setup runtime-specific optional model/API configuration
-    await setupOpenCodeModel(platforms, results);
-    await setupGeminiCLI(platforms);
-
-    // Setup addressing configuration
-    const addressingConfig = await promptAddressingConfig();
-    configureAddressing(addressingConfig, platforms);
-
-    // Summary
-    console.log('╔════════════════════════════════════════════════════════╗');
-    console.log('║         Installation Complete!                         ║');
-    console.log('╚════════════════════════════════════════════════════════╝');
-    console.log();
-    console.log(`  Copied Files:       ${results.copied}`);
-    console.log(`  Updated Files:      ${results.updated}`);
-    console.log(`  CafeKit Version:    ${packageJson.version}`);
-    console.log(`  Skipped Files:      ${results.skipped}`);
-    console.log(`  Installed Skills:   ${results.installedSkills > 0 ? 'Yes ✓' : 'No'}`);
-    console.log(`  Dependency Checks:  ${results.dependencyChecks}`);
-    console.log(`  Installed Deps:     ${results.installedDependencies}`);
-    console.log(`  Missing Deps:       ${results.missingDependencies}`);
-    console.log(`  Target Directories: ${results.targets.join(', ')}`);
-    if (results.errors > 0) {
-      console.log(`  Errors:             ${results.errors} ⚠`);
-    }
-    console.log();
-    console.log('Next steps:');
-    const nextEditorLabel = platforms.length === 1 ? PLATFORMS[platforms[0]].name : 'your AI editor';
-    console.log(`  1. Start ${nextEditorLabel}`);
-
-    // Show platform-specific hints
-    for (const platformKey of platforms) {
-      const platform = PLATFORMS[platformKey];
-      console.log(`\n  For ${platform.name}:`);
-      if (platformKey === 'claude') {
-        console.log('     Use skill: /hapo:specs <feature-description>');
-      } else {
-        console.log(`     Instruct the agent to start a new feature or brainstorm`);
-      }
-    }
-
-    if (platforms.includes('claude')) {
-      console.log('\n  2. Claude Code will automatically sync docs/ (Continuous Documentation)');
-    } else {
-      console.log('\n  2. CafeKit skills and AGENTS.md are installed for the selected runtime');
-    }
-    const envHosts = platforms.map(key => `${PLATFORMS[key].folder}/.env`).join(' and ');
-    console.log(`  3. Project API Keys are now securely isolated in ${envHosts}`);
-    if (!installerOptions.upgrade) {
-      console.log('  4. To refresh managed templates later, run installer with --upgrade');
-    }
-    console.log();
-    console.log('Documentation: https://github.com/haposoft/cafekit');
-    if (results.missingDependencies > 0) {
-      console.log('Note: some dependency templates could not be installed. Please check command/agent directories.');
-    }
-    console.log();
-
-    process.exit(results.errors > 0 ? 1 : 0);
-  } catch (error) {
-    console.error(`\n✗ Installation failed: ${error.message}`);
-    process.exit(1);
-  }
+  process.exit(exitCode);
 }
 
 main();