claude-git-hooks 2.9.1 → 2.10.0

package/bin/claude-hooks

@@ -1,2324 +1,111 @@
 #!/usr/bin/env node
 
-import { execSync, spawn } from 'child_process';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import readline from 'readline';
-import https from 'https';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
-import { executeClaude, executeClaudeWithRetry, extractJSON, analyzeCode } from '../lib/utils/claude-client.js';
-import { loadPrompt } from '../lib/utils/prompt-builder.js';
-import { listPresets } from '../lib/utils/preset-loader.js';
-import { getConfig } from '../lib/config.js';
-import { getOrPromptTaskId, formatWithTaskId } from '../lib/utils/task-id.js';
-import { createPullRequest, getReviewersForFiles, parseGitHubRepo, setupGitHubMcp, getGitHubMcpStatus } from '../lib/utils/github-client.js';
-import { showPRPreview, promptConfirmation, promptMenu, showSuccess, showError, showInfo, showWarning, showSpinner, promptEditField } from '../lib/utils/interactive-ui.js';
-import { setupGitHubMCP } from '../lib/utils/mcp-setup.js';
-import { displayStatistics as showTelemetryStats, clearTelemetry as clearTelemetryData } from '../lib/utils/telemetry.js';
-import logger from '../lib/utils/logger.js';
-
-// Why: ES6 modules don't have __dirname, need to recreate it
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Helper to read package.json
-// Why: ES6 modules can't use require() for JSON files
-const getPackageJson = () => {
-  const packagePath = path.join(__dirname, '..', 'package.json');
-  return JSON.parse(fs.readFileSync(packagePath, 'utf8'));
-};
-
-// Function to get the latest version from NPM
-function getLatestVersion(packageName) {
-  return new Promise((resolve, reject) => {
-    // Use the main NPM API, not /latest
-    https.get(`https://registry.npmjs.org/${packageName}`, (res) => {
-      let data = '';
-      res.on('data', chunk => data += chunk);
-      res.on('end', () => {
-        try {
-          const json = JSON.parse(data);
-          // Get the version from the 'latest' tag
-          if (json['dist-tags'] && json['dist-tags'].latest) {
-            resolve(json['dist-tags'].latest);
-          } else {
-            reject(new Error('Could not get the version'));
-          }
-        } catch (e) {
-          // If it fails, try with npm view
-          try {
-            const version = execSync(`npm view ${packageName} version`, { encoding: 'utf8' }).trim();
-            resolve(version);
-          } catch (npmError) {
-            reject(e);
-          }
-        }
-      });
-    }).on('error', reject);
-  });
-}
-
-// Function to check version (used by hooks)
-async function checkVersionAndPromptUpdate() {
-  try {
-    const currentVersion = getPackageJson().version;
-    const latestVersion = await getLatestVersion('claude-git-hooks');
-
-    if (currentVersion === latestVersion) {
-      return true; // Already updated
-    }
-
-    console.log('');
-    warning(`New version available: ${latestVersion} (current: ${currentVersion})`);
-
-    // Interactive prompt compatible with all consoles
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    return new Promise((resolve) => {
-      rl.question('Do you want to update now? (y/n): ', (answer) => {
-        rl.close();
-
-        if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
-          info('Updating claude-git-hooks...');
-          try {
-            execSync('npm install -g claude-git-hooks@latest', { stdio: 'inherit' });
-            success('Update completed. Please run your command again.');
-            process.exit(0); // Exit so user restarts the process
-          } catch (e) {
-            error('Error updating: ' + e.message);
-            resolve(false);
-          }
-        } else {
-          info('Update postponed. You can update later with: claude-hooks update');
-          resolve(true); // Continue without updating
-        }
-      });
-    });
-  } catch (e) {
-    // If there's an error checking version, continue without blocking
-    return true;
-  }
-}
-
-// Colors for output
-const colors = {
-  reset: '\x1b[0m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m'
-};
-
-function log(message, color = 'reset') {
-  console.log(`${colors[color]}${message}${colors.reset}`);
-}
-
-function error(message) {
-  console.error(`${colors.red}❌ ${message}${colors.reset}`);
-  process.exit(1);
-}
-
-function success(message) {
-  log(`✅ ${message}`, 'green');
-}
-
-function info(message) {
-  log(`ℹ️  ${message}`, 'blue');
-}
-
-function warning(message) {
-  log(`⚠️  ${message}`, 'yellow');
-}
-
-// Entertainment system
-class Entertainment {
-  static jokes = [
-    "Why do programmers prefer dark mode? Because light attracts bugs!",
-    "A QA engineer walks into a bar. Orders 1 beer. Orders 0 beers. Orders -1 beers.",
-    "What's a pirate's favorite programming language? R!",
-    "There are 10 types of people: those who understand binary and those who don't.",
-    "Why do programmers confuse Halloween with Christmas? Because Oct 31 = Dec 25",
-    "What does one bit say to another? See you on the bus!",
-    "Why don't Java and C++ get along? Because they have different views on pointers.",
-    "My code doesn't have bugs, just undocumented features."
-  ];
-
-  static async getJoke() {
-    return new Promise((resolve) => {
-      // Try to get joke from API
-      const req = https.get('https://icanhazdadjoke.com/', {
-        headers: { 'Accept': 'text/plain' },
-        timeout: 3000
-      }, (res) => {
-        let data = '';
-        res.on('data', chunk => data += chunk);
-        res.on('end', () => resolve(data.trim()));
-      });
-
-      req.on('error', () => {
-        // If it fails, use local joke
-        const randomJoke = this.jokes[Math.floor(Math.random() * this.jokes.length)];
-        resolve(randomJoke);
-      });
-
-      req.on('timeout', () => {
-        req.abort();
-        const randomJoke = this.jokes[Math.floor(Math.random() * this.jokes.length)];
-        resolve(randomJoke);
-      });
-    });
-  }
-
-  static async showSpinner(promise, message = 'Processing') {
-    const spinners = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-    let spinnerIndex = 0;
-    let jokeCountdown = 10;
-    let currentJoke = this.jokes[Math.floor(Math.random() * this.jokes.length)];
-    let isFinished = false;
-    let isFirstRender = true;
-
-    // Get first joke from API without blocking
-    this.getJoke().then(joke => {
-      if (!isFinished) currentJoke = joke;
-    }).catch(() => { }); // If it fails, keep the local one
-
-    // Hide cursor
-    process.stdout.write('\x1B[?25l');
-
-    // Reserve space for the 3 lines
-    process.stdout.write('\n\n\n');
-
-    const interval = setInterval(() => {
-      if (isFinished) {
-        clearInterval(interval);
-        return;
-      }
-
-      spinnerIndex++;
-
-      // Update countdown every second (10 iterations of 100ms)
-      if (spinnerIndex % 10 === 0) {
-        jokeCountdown--;
-
-        // Refresh joke every 10 seconds
-        if (jokeCountdown <= 0) {
-          this.getJoke().then(joke => {
-            if (!isFinished) currentJoke = joke;
-          }).catch(() => {
-            if (!isFinished) {
-              currentJoke = this.jokes[Math.floor(Math.random() * this.jokes.length)];
-            }
-          });
-          jokeCountdown = 10;
-        }
-      }
-
-      // Always go back exactly 3 lines up
-      process.stdout.write('\x1B[3A');
-
-      // Render the 3 lines from the beginning
-      const spinner = spinners[spinnerIndex % spinners.length];
-
-      // Line 1: Spinner
-      process.stdout.write('\r\x1B[2K' + `${colors.yellow}${spinner} ${message}${colors.reset}\n`);
-
-      // Line 2: Joke  
-      process.stdout.write('\r\x1B[2K' + `${colors.green}🎭 ${currentJoke}${colors.reset}\n`);
-
-      // Line 3: Countdown
-      process.stdout.write('\r\x1B[2K' + `${colors.yellow}⏱️  Next joke in: ${jokeCountdown}s${colors.reset}\n`);
-    }, 100);
-
-    try {
-      const result = await promise;
-      isFinished = true;
-      clearInterval(interval);
-
-      // Clean exactly 3 lines completely
-      process.stdout.write('\x1B[3A'); // Go up 3 lines
-      process.stdout.write('\r\x1B[2K'); // Clean line 1
-      process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 2
-      process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 3
-      process.stdout.write('\x1B[2A'); // Go up 2 lines to end up on the first
-      process.stdout.write('\r'); // Go to beginning of line
-
-      // Show cursor
-      process.stdout.write('\x1B[?25h');
-
-      return result;
-    } catch (error) {
-      isFinished = true;
-      clearInterval(interval);
-
-      // Clean exactly 3 lines completely
-      process.stdout.write('\x1B[3A'); // Go up 3 lines
-      process.stdout.write('\r\x1B[2K'); // Clean line 1
-      process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 2
-      process.stdout.write('\n\r\x1B[2K'); // Go down and clean line 3
-      process.stdout.write('\x1B[2A'); // Go up 2 lines to end up on the first
-      process.stdout.write('\r'); // Go to beginning of line
-
-      // Show cursor
-      process.stdout.write('\x1B[?25h');
-
-      throw error;
-    }
-  }
-}
-
-// Check if we are in a git repository (including worktrees created in PowerShell)
-function checkGitRepo() {
-  try {
-    execSync('git rev-parse --git-dir', { stdio: 'ignore' });
-    return true;
-  } catch (e) {
-    // Try to detect worktree created in PowerShell
-    try {
-      if (fs.existsSync('.git')) {
-        const gitContent = fs.readFileSync('.git', 'utf8').trim();
-        // Check if it's a worktree pointer (gitdir: ...)
-        if (gitContent.startsWith('gitdir:')) {
-          let gitdir = gitContent.substring(8).trim();
-          // Convert Windows path to WSL if needed (C:\ -> /mnt/c/)
-          if (/^[A-Za-z]:/.test(gitdir)) {
-            gitdir = gitdir.replace(/^([A-Za-z]):/, (_, drive) => `/mnt/${drive.toLowerCase()}`);
-            gitdir = gitdir.replace(/\\/g, '/');
-          }
-          // Verify the gitdir exists
-          if (fs.existsSync(gitdir)) {
-            return true;
-          }
-        }
-      }
-    } catch (worktreeError) {
-      // Ignore worktree detection errors
-    }
-    return false;
-  }
-}
-
-// Get the templates path
-function getTemplatesPath() {
-  return path.join(__dirname, '..', 'templates');
-}
-
-// Install command
-async function install(args) {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository. Please run this command from the root of a repository.');
-  }
-
-  const isForce = args.includes('--force');
-  const skipAuth = args.includes('--skip-auth');
-
-  // Check for updates (unless --skip-auth flag)
-  if (!skipAuth && !isForce) {
-    await checkVersionAndPromptUpdate();
-  }
-
-  if (isForce) {
-    info('Installing Claude Git Hooks (force mode)...');
-  } else {
-    info('Installing Claude Git Hooks...');
-  }
-
-  // v2.0.0+: No sudo needed (pure Node.js, no system packages required)
-  // Check dependencies
-  await checkAndInstallDependencies(null, skipAuth);
-
-  const templatesPath = getTemplatesPath();
-  const hooksPath = '.git/hooks';
-
-  // Create hooks directory if it doesn't exist
-  if (!fs.existsSync(hooksPath)) {
-    fs.mkdirSync(hooksPath, { recursive: true });
-  }
-
-  // Helper function to copy file with LF line endings
-  // Why: Bash scripts must have LF (Unix) line endings, not CRLF (Windows)
-  const copyWithLF = (sourcePath, destPath) => {
-    let content = fs.readFileSync(sourcePath, 'utf8');
-    // Convert CRLF to LF
-    content = content.replace(/\r\n/g, '\n');
-    fs.writeFileSync(destPath, content, 'utf8');
-  };
-
-  // Hooks to install
-  const hooks = ['pre-commit', 'prepare-commit-msg'];
-
-  hooks.forEach(hook => {
-    const sourcePath = path.join(templatesPath, hook);
-    const destPath = path.join(hooksPath, hook);
-
-    // Make backup if it exists
-    if (fs.existsSync(destPath)) {
-      const backupPath = `${destPath}.backup.${Date.now()}`;
-      fs.copyFileSync(destPath, backupPath);
-      info(`Backup created: ${backupPath}`);
-    }
-
-    // Copy hook with LF line endings (critical for bash)
-    copyWithLF(sourcePath, destPath);
-    fs.chmodSync(destPath, '755');
-    success(`${hook} installed`);
-  });
-
-  // Copy version verification script with LF line endings
-  const checkVersionSource = path.join(templatesPath, 'check-version.sh');
-  const checkVersionDest = path.join(hooksPath, 'check-version.sh');
-
-  if (fs.existsSync(checkVersionSource)) {
-    copyWithLF(checkVersionSource, checkVersionDest);
-    fs.chmodSync(checkVersionDest, '755');
-    success('Version verification script installed');
-  }
-
-  // Create .claude directory if it doesn't exist
-  const claudeDir = '.claude';
-  if (!fs.existsSync(claudeDir)) {
-    fs.mkdirSync(claudeDir, { recursive: true });
-    success('.claude directory created');
-  }
-
-  // Remove old SONAR template files if they exist (migration from v2.6.x to v2.7.0+)
-  const oldSonarFiles = [
-    'CLAUDE_PRE_COMMIT_SONAR.md',
-    'CLAUDE_ANALYSIS_PROMPT_SONAR.md'
-  ];
-
-  oldSonarFiles.forEach(oldFile => {
-    const oldPath = path.join(claudeDir, oldFile);
-    if (fs.existsSync(oldPath)) {
-      fs.unlinkSync(oldPath);
-      info(`Removed old template: ${oldFile}`);
-    }
-  });
-
-  // Create .claude/prompts directory for markdown templates
-  const promptsDir = path.join(claudeDir, 'prompts');
-  if (!fs.existsSync(promptsDir)) {
-    fs.mkdirSync(promptsDir, { recursive: true });
-    success('.claude/prompts directory created');
-  }
-
-  // Copy template files (.md and .json) to appropriate locations
-  const templateFiles = fs.readdirSync(templatesPath)
-    .filter(file => {
-      const filePath = path.join(templatesPath, file);
-      // Exclude example.json files and only include .md and .json files
-      return fs.statSync(filePath).isFile() &&
-             (file.endsWith('.md') || file.endsWith('.json')) &&
-             !file.includes('example.json');
-    });
-
-  templateFiles.forEach(file => {
-    const sourcePath = path.join(templatesPath, file);
-    let destPath;
-    let destLocation;
-
-    // .md files go to .claude/prompts/, .json files go to .claude/
-    if (file.endsWith('.md')) {
-      destPath = path.join(promptsDir, file);
-      destLocation = '.claude/prompts/';
-    } else {
-      destPath = path.join(claudeDir, file);
-      destLocation = '.claude/';
-    }
-
-    // In force mode or if it doesn't exist, copy the file
-    if (isForce || !fs.existsSync(destPath)) {
-      if (fs.existsSync(sourcePath)) {
-        fs.copyFileSync(sourcePath, destPath);
-        success(`${file} installed in ${destLocation}`);
-      }
-    } else {
-      info(`${file} already exists (skipped)`);
-    }
-  });
-
-  // Clean up old .md files from .claude/ root (v2.8.0 migration)
-  // .md files should now be in .claude/prompts/, not .claude/
-  const oldMdFiles = fs.readdirSync(claudeDir)
-    .filter(file => {
-      const filePath = path.join(claudeDir, file);
-      return fs.statSync(filePath).isFile() && file.endsWith('.md');
-    });
-
-  if (oldMdFiles.length > 0) {
-    oldMdFiles.forEach(file => {
-      const oldPath = path.join(claudeDir, file);
-      fs.unlinkSync(oldPath);
-      info(`Removed old template from .claude/: ${file} (now in prompts/)`);
-    });
-  }
-
-  // Copy presets directory structure
-  const presetsSourcePath = path.join(templatesPath, 'presets');
-  const presetsDestPath = path.join(claudeDir, 'presets');
-
-  if (fs.existsSync(presetsSourcePath)) {
-    // Create presets directory in .claude
-    if (!fs.existsSync(presetsDestPath)) {
-      fs.mkdirSync(presetsDestPath, { recursive: true });
-    }
-
-    // Copy each preset directory
-    const presetDirs = fs.readdirSync(presetsSourcePath)
-      .filter(item => fs.statSync(path.join(presetsSourcePath, item)).isDirectory());
-
-    presetDirs.forEach(presetName => {
-      const presetSource = path.join(presetsSourcePath, presetName);
-      const presetDest = path.join(presetsDestPath, presetName);
-
-      // Create preset directory
-      if (!fs.existsSync(presetDest)) {
-        fs.mkdirSync(presetDest, { recursive: true });
-      }
-
-      // Copy all files in preset directory
-      const presetFiles = fs.readdirSync(presetSource);
-      presetFiles.forEach(file => {
-        const sourceFile = path.join(presetSource, file);
-        const destFile = path.join(presetDest, file);
-
-        if (fs.statSync(sourceFile).isFile()) {
-          if (isForce || !fs.existsSync(destFile)) {
-            fs.copyFileSync(sourceFile, destFile);
-          }
-        }
-      });
-    });
-
-    success(`${presetDirs.length} presets installed in .claude/presets/`);
-  }
-
-  // Special handling for config.json (v2.8.0+): backup old, create new simplified
-  const configPath = path.join(claudeDir, 'config.json');
-  const configOldDir = path.join(claudeDir, 'config_old');
-  const configExampleDir = path.join(claudeDir, 'config_example');
-
-  // Create config_old directory if needed
-  if (!fs.existsSync(configOldDir)) {
-    fs.mkdirSync(configOldDir, { recursive: true });
-  }
-
-  // Create config_example directory
-  if (!fs.existsSync(configExampleDir)) {
-    fs.mkdirSync(configExampleDir, { recursive: true });
-  }
-
-  // Copy example configs to config_example/ directly from templates/
-  const exampleConfigs = ['config.example.json', 'config.advanced.example.json'];
-  exampleConfigs.forEach(exampleFile => {
-    const sourcePath = path.join(templatesPath, exampleFile);
-    const destPath = path.join(configExampleDir, exampleFile);
-    if (fs.existsSync(sourcePath)) {
-      fs.copyFileSync(sourcePath, destPath);
-    }
-  });
-  success('Example configs installed in .claude/config_example/');
-
-  // Backup existing config if it exists (legacy format migration)
-  let needsMigration = false;
-  if (fs.existsSync(configPath)) {
-    const backupPath = path.join(configOldDir, `config.json.${Date.now()}`);
-    fs.copyFileSync(configPath, backupPath);
-    info(`Existing config backed up: ${backupPath}`);
-
-    // Read old config to check if it's legacy format
-    const oldConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    if (!oldConfig.version || oldConfig.version !== '2.8.0') {
-      warning('Legacy config detected - will be replaced with v2.8.0 format');
-      needsMigration = true;
-
-      // Delete old config to force new format
-      fs.unlinkSync(configPath);
-    } else {
-      info('Config already in v2.8.0 format - keeping existing file');
-    }
-  }
-
-  // Create new config.json from minimal example if it doesn't exist
-  if (!fs.existsSync(configPath)) {
-    // Read example and extract minimal config
-    const examplePath = path.join(configExampleDir, 'config.example.json');
-    const exampleContent = fs.readFileSync(examplePath, 'utf8');
-    const exampleJson = JSON.parse(exampleContent);
-
-    // Create minimal config: just version and preset
-    const minimalConfig = {
-      version: exampleJson.version,
-      preset: exampleJson.preset
-    };
-
-    fs.writeFileSync(configPath, JSON.stringify(minimalConfig, null, 4));
-    success('config.json created with minimal v2.8.0 format');
-    info('📝 Customize: .claude/config.json (see config_example/ for examples)');
-
-    // Auto-run migration if needed to preserve settings
-    if (needsMigration) {
-      info('🔄 Auto-migrating settings from backup...');
-      await autoMigrateConfig(configPath, path.join(configOldDir, fs.readdirSync(configOldDir).sort().pop()));
-    }
-  }
-
-  // Create settings.local.json for sensitive data (gitignored)
-  const settingsLocalPath = path.join(claudeDir, 'settings.local.json');
-  if (!fs.existsSync(settingsLocalPath)) {
-    const settingsLocalContent = {
-      "_comment": "Local settings - DO NOT COMMIT. This file is gitignored.",
-      "githubToken": ""
-    };
-    fs.writeFileSync(settingsLocalPath, JSON.stringify(settingsLocalContent, null, 2));
-    info('settings.local.json created (add your GitHub token here)');
-  }
-
-  // Configure Git
-  configureGit();
-
-  // Update .gitignore
-  updateGitignore();
-
-  success('Claude Git Hooks installed successfully! 🎉');
-  console.log('\nUsage:');
-  console.log('  git commit -m "auto"     # Generate message automatically');
-  console.log('  git commit -m "message"  # Analyze code before commit');
-  console.log('  git commit --no-verify   # Skip analysis completely');
-  console.log('\n💡 Configuration (v2.8.0):');
-  console.log('  📁 All templates installed in .claude/');
-  console.log('  📝 Edit .claude/config.json (minimal by default)');
-  console.log('  📂 Examples: .claude/config_example/');
-  console.log('  📦 Backups: .claude/config_old/');
-  console.log('  🎯 Presets: backend, frontend, fullstack, database, ai, default');
-  console.log('  🚀 Parallel analysis enabled by default (hardcoded)');
-  console.log('  🐛 Debug mode: claude-hooks --debug true');
-  console.log('\n🔗 GitHub PR Creation (v2.5.0+):');
-  console.log('  claude-hooks setup-github    # Configure GitHub token');
-  console.log('  claude-hooks create-pr main  # Create PR with auto-metadata');
-  console.log('\n📖 Minimal config.json (v2.8.0):');
-  console.log('  {');
-  console.log('    "version": "2.8.0",');
-  console.log('    "preset": "backend"');
-  console.log('  }');
-  console.log('\n📖 With GitHub customization:');
-  console.log('  {');
-  console.log('    "version": "2.8.0",');
-  console.log('    "preset": "backend",');
-  console.log('    "overrides": {');
-  console.log('      "github": { "pr": { "reviewers": ["your-username"] } }');
-  console.log('    }');
-  console.log('  }');
-  console.log('\n🔧 Advanced: see .claude/config_example/config.advanced.example.json');
-  console.log('\nFor more options: claude-hooks --help');
-}
-
-// Check complete dependencies (like setup-wsl.sh)
-async function checkAndInstallDependencies(sudoPassword = null, skipAuth = false) {
-  info('Checking system dependencies...');
-
-  // Check Node.js
-  try {
-    const nodeVersion = execSync('node --version', { encoding: 'utf8' }).trim();
-    success(`Node.js ${nodeVersion}`);
-  } catch (e) {
-    error('Node.js is not installed. Install Node.js and try again.');
-  }
-
-  // Check npm
-  try {
-    const npmVersion = execSync('npm --version', { encoding: 'utf8' }).trim();
-    success(`npm ${npmVersion}`);
-  } catch (e) {
-    error('npm is not installed.');
-  }
-
-  // v2.0.0+: jq and curl are no longer needed (pure Node.js implementation)
-
-  // Check Git
-  try {
-    const gitVersion = execSync('git --version', { encoding: 'utf8' }).trim();
-    success(`${gitVersion}`);
-  } catch (e) {
-    error('Git is not installed. Install Git and try again.');
-  }
-
-  // v2.0.0+: Unix tools (sed, awk, grep, etc.) no longer needed (pure Node.js implementation)
-
-  // Check and install Claude CLI (skip if --skip-auth)
-  if (!skipAuth) {
-    await checkAndInstallClaude();
-    await checkClaudeAuth();
-  } else {
-    warning('Skipping Claude CLI verification and authentication (--skip-auth)');
-  }
-
-  // Clear password from memory
-  sudoPassword = null;
-}
-
-// Detect if running on Windows
-// Why: Need to use 'wsl claude' instead of 'claude' on Windows
-function isWindows() {
-  return os.platform() === 'win32' || process.env.OS === 'Windows_NT';
-}
-
-// Get Claude command based on platform
-// Why: On Windows, try native Claude first, then WSL as fallback
-function getClaudeCommand() {
-  if (isWindows()) {
-    // Try native Windows Claude first
-    try {
-      execSync('claude --version', { stdio: 'ignore', timeout: 3000 });
-      return 'claude';
-    } catch (e) {
-      // Fallback to WSL
-      return 'wsl claude';
-    }
-  }
-  return 'claude';
-}
-
-// Check if we need to install dependencies
-async function checkIfInstallationNeeded() {
-  // v2.0.0+: Only check Claude CLI (jq and curl no longer needed)
-  const claudeCmd = getClaudeCommand();
-
-  try {
-    execSync(`${claudeCmd} --version`, { stdio: 'ignore' });
-  } catch (e) {
-    return true; // Needs Claude installation
-  }
-
-  return false;
-}
-
-// Check Claude CLI availability
-async function checkAndInstallClaude() {
-  const claudeCmd = getClaudeCommand();
-  const platform = isWindows() ? 'Windows (via WSL)' : os.platform();
-
-  try {
-    execSync(`${claudeCmd} --version`, { stdio: 'ignore' });
-    success(`Claude CLI detected (${platform})`);
-  } catch (e) {
-    error(`Claude CLI not detected on ${platform}`);
-
-    if (isWindows()) {
-      console.log('\n⚠️  On Windows, Claude CLI must be installed in WSL:');
-      console.log('1. Open WSL terminal (wsl or Ubuntu from Start Menu)');
-      console.log('2. Follow installation at: https://docs.anthropic.com/claude/docs/claude-cli');
-      console.log('3. Verify with: wsl claude --version');
-    } else {
-      console.log('\nClaude CLI installation: https://docs.anthropic.com/claude/docs/claude-cli');
-    }
-
-    console.log('\nAfter installation, run: claude-hooks install --force');
-    process.exit(1);
-  }
-}
-
-// Check Claude authentication with entertainment
-async function checkClaudeAuth() {
-  info('Checking Claude authentication...');
-
-  // Get correct Claude command for platform
-  const claudeCmd = getClaudeCommand();
-  const cmdParts = claudeCmd.split(' ');
-  const command = cmdParts[0];
-  const args = [...cmdParts.slice(1), 'auth', 'status'];
-
-  // Use spawn to not block, but with stdio: 'ignore' like the original
-  const authPromise = new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      stdio: 'ignore',  // Igual que el original
-      detached: false,
-      windowsHide: true
-    });
-
-    // Manual timeout since spawn doesn't have native timeout
-    const timeout = setTimeout(() => {
-      child.kill();
-      reject(new Error('timeout'));
-    }, 120000); // 2 minutos
-
-    child.on('exit', (code) => {
-      clearTimeout(timeout);
-      if (code === 0) {
-        resolve('success');
-      } else {
-        reject(new Error('not_authenticated'));
-      }
-    });
-
-    child.on('error', (err) => {
-      clearTimeout(timeout);
-      reject(err);
-    });
-  });
-
-  try {
-    await Entertainment.showSpinner(authPromise, 'Checking Claude authentication');
-    success('Authenticated in Claude');
-  } catch (e) {
-    warning('You are not authenticated in Claude');
-    console.log('Run: claude auth login');
-    console.log('Then run this command again');
-  }
-}
-
-// Update .gitignore with Claude entries
-function updateGitignore() {
-  info('Updating .gitignore...');
-
-  const gitignorePath = '.gitignore';
-  const claudeEntries = [
-    '# Claude Git Hooks (includes .claude/settings.local.json for tokens)',
-    '.claude/',
-  ];
-
-  let gitignoreContent = '';
-  let fileExists = false;
-
-  // Read existing .gitignore if it exists
-  if (fs.existsSync(gitignorePath)) {
-    gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
-    fileExists = true;
-  }
-
-  // Check which entries are missing
-  const missingEntries = [];
-  claudeEntries.forEach(entry => {
-    if (entry.startsWith('#')) {
-      // For comments, check if any Claude comment already exists
-      if (!gitignoreContent.includes('# Claude')) {
-        missingEntries.push(entry);
-      }
-    } else {
-      // For normal entries, check if they are already present
-      const regex = new RegExp(`^${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`, 'm');
-      if (!regex.test(gitignoreContent)) {
-        missingEntries.push(entry);
-      }
-    }
-  });
-
-  // If there are missing entries, add them
-  if (missingEntries.length > 0) {
-    // Ensure there's a newline at the end if the file exists and is not empty
-    if (fileExists && gitignoreContent.length > 0 && !gitignoreContent.endsWith('\n')) {
-      gitignoreContent += '\n';
-    }
-
-    // If the file is not empty, add a blank line before
-    if (gitignoreContent.length > 0) {
-      gitignoreContent += '\n';
-    }
-
-    // Add the missing entries
-    gitignoreContent += missingEntries.join('\n') + '\n';
-
-    // Write the updated file
-    fs.writeFileSync(gitignorePath, gitignoreContent);
-
-    if (fileExists) {
-      success('.gitignore updated with Claude entries');
-    } else {
-      success('.gitignore created with Claude entries');
-    }
-
-    // Show what was added
-    missingEntries.forEach(entry => {
-      if (!entry.startsWith('#')) {
-        info(`  + ${entry}`);
-      }
-    });
-  } else {
-    info('.gitignore already contains all necessary entries');
-  }
-}
-
-// Configure Git (line endings, etc.)
-function configureGit() {
-  info('Configuring Git...');
-
-  try {
-    // Configure line endings based on platform
-    // Why: CRLF/LF handling differs between Windows and Unix
-    if (isWindows()) {
-      // On Windows: Keep CRLF in working directory, convert to LF in repo
-      execSync('git config core.autocrlf true', { stdio: 'ignore' });
-      success('Line endings configured for Windows (core.autocrlf = true)');
-    } else {
-      // On Unix: Keep LF everywhere, convert CRLF to LF on commit
-      execSync('git config core.autocrlf input', { stdio: 'ignore' });
-      success('Line endings configured for Unix (core.autocrlf = input)');
-    }
-
-  } catch (e) {
-    warning('Error configuring Git: ' + e.message);
-  }
-}
-
-// Uninstall command
-function uninstall() {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-  }
-
-  info('Uninstalling Claude Git Hooks...');
-
-  const hooksPath = '.git/hooks';
-  const hooks = ['pre-commit', 'prepare-commit-msg'];
-
-  hooks.forEach(hook => {
-    const hookPath = path.join(hooksPath, hook);
-    if (fs.existsSync(hookPath)) {
-      fs.unlinkSync(hookPath);
-      success(`${hook} removed`);
-    }
-  });
-
-  success('Claude Git Hooks uninstalled');
-}
-
-// Enable command
-function enable(hookName) {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-  }
-
-  const hooks = hookName ? [hookName] : ['pre-commit', 'prepare-commit-msg'];
-
-  hooks.forEach(hook => {
-    const disabledPath = `.git/hooks/${hook}.disabled`;
-    const enabledPath = `.git/hooks/${hook}`;
-
-    if (fs.existsSync(disabledPath)) {
-      fs.renameSync(disabledPath, enabledPath);
-      success(`${hook} enabled`);
-    } else if (fs.existsSync(enabledPath)) {
-      info(`${hook} is already enabled`);
-    } else {
-      warning(`${hook} not found`);
-    }
-  });
-}
-
-// Disable command
-function disable(hookName) {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-  }
-
-  const hooks = hookName ? [hookName] : ['pre-commit', 'prepare-commit-msg'];
-
-  hooks.forEach(hook => {
-    const enabledPath = `.git/hooks/${hook}`;
-    const disabledPath = `.git/hooks/${hook}.disabled`;
-
-    if (fs.existsSync(enabledPath)) {
-      fs.renameSync(enabledPath, disabledPath);
-      success(`${hook} disabled`);
-    } else if (fs.existsSync(disabledPath)) {
-      info(`${hook} is already disabled`);
-    } else {
-      warning(`${hook} not found`);
-    }
-  });
-}
-
-// Analyze-diff command
-async function analyzeDiff(args) {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-    return;
-  }
-
-  // Load configuration
-  const config = await getConfig();
-
-  const currentBranch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();
-
-  if (!currentBranch) {
-    error('You are not in a valid branch.');
-    return;
-  }
-
-  // Update remote references
-  execSync('git fetch', { stdio: 'ignore' });
-
-  let baseBranch, compareWith, contextDescription;
-
-  if (args[0]) {
-    // Case with argument: compare current branch vs origin/specified-branch
-    const targetBranch = args[0];
-    baseBranch = `origin/${targetBranch}`;
-    compareWith = `${baseBranch}...HEAD`;
-    contextDescription = `${currentBranch} vs ${baseBranch}`;
-
-    // Check that the origin branch exists
-    try {
-      execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
-    } catch (e) {
-      error(`Branch ${baseBranch} does not exist.`);
-      return;
-    }
-  } else {
-    // Case without argument: compare current branch vs origin/current-branch
-    baseBranch = `origin/${currentBranch}`;
-    compareWith = `${baseBranch}...HEAD`;
-    contextDescription = `${currentBranch} vs ${baseBranch}`;
-
-    // Check that the origin branch exists
-    try {
-      execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
-    } catch (e) {
-      // Try fallback to origin/develop
-      baseBranch = 'origin/develop';
-      compareWith = `${baseBranch}...HEAD`;
-      contextDescription = `${currentBranch} vs ${baseBranch} (fallback)`;
-
-      try {
-        execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
-        warning(`Branch origin/${currentBranch} does not exist. Using ${baseBranch} as fallback.`);
-      } catch (e2) {
-        // Try fallback to origin/main
-        baseBranch = 'origin/main';
-        compareWith = `${baseBranch}...HEAD`;
-        contextDescription = `${currentBranch} vs ${baseBranch} (fallback)`;
-
-        try {
-          execSync(`git rev-parse --verify ${baseBranch}`, { stdio: 'ignore' });
-          warning(`No origin/develop branch. Using ${baseBranch} as fallback.`);
-        } catch (e3) {
-          error('Could not find a valid comparison branch (tried origin/current, origin/develop, origin/main).');
-          return;
-        }
-      }
-    }
-  }
-
-  info(`Analyzing: ${contextDescription}...`);
-
-  // Get modified files
-  let diffFiles;
-  try {
-    diffFiles = execSync(`git diff ${compareWith} --name-only`, { encoding: 'utf8' }).trim();
-
-    if (!diffFiles) {
-      // Check if there are staged or unstaged changes
-      const stagedFiles = execSync('git diff --cached --name-only', { encoding: 'utf8' }).trim();
-      const unstagedFiles = execSync('git diff --name-only', { encoding: 'utf8' }).trim();
-
-      if (stagedFiles || unstagedFiles) {
-        warning('No differences with remote, but you have uncommitted local changes.');
-        console.log('Staged changes:', stagedFiles || 'none');
-        console.log('Unstaged changes:', unstagedFiles || 'none');
-      } else {
-        success('✅ No differences. Your branch is synchronized.');
-      }
-      return;
-    }
-  } catch (e) {
-    error('Error getting differences: ' + e.message);
-    return;
-  }
-
-  // Get the complete diff
-  let fullDiff, commits;
-  try {
-    if (!args[0] && compareWith.includes('HEAD..')) {
-      fullDiff = execSync(`git diff ${compareWith}`, { encoding: 'utf8' });
-      commits = execSync(`git log ${baseBranch}..HEAD --oneline`, { encoding: 'utf8' }).trim();
-    } else {
-      fullDiff = execSync(`git diff ${compareWith}`, { encoding: 'utf8' });
-      commits = execSync(`git log ${baseBranch}..HEAD --oneline`, { encoding: 'utf8' }).trim();
-    }
-  } catch (e) {
-    error('Error getting diff or commits: ' + e.message);
-    return;
-  }
-
-  // Check if subagents should be used
-  const useSubagents = config.subagents.enabled;
-  const subagentModel = config.subagents.model;
-  let subagentBatchSize = config.subagents.batchSize;
-  // Validate batch size (must be >= 1)
-  if (subagentBatchSize < 1) {
-    subagentBatchSize = 1;
-  }
-  const subagentInstruction = useSubagents
-    ? `\n\nIMPORTANT PARALLEL PROCESSING: If analyzing 3+ files, process them in batches of ${subagentBatchSize}. For EACH batch, create that many subagents in parallel using Task tool (send single message with multiple Task calls). Each subagent analyzes one file and provides insights. After ALL batches complete, consolidate into SINGLE JSON with ONE cohesive PR title/description. Model: ${subagentModel}. Example: 4 files with BATCH_SIZE=1 → 4 sequential batches of 1 subagent each. Example: 4 files with BATCH_SIZE=3 → batch 1 has 3 parallel subagents (files 1-3), batch 2 has 1 subagent (file 4).\n`
-    : '';
-
-  // Truncate full diff if too large
-  const truncatedDiff = fullDiff.length > 50000
-    ? fullDiff.substring(0, 50000) + '\n... (truncated diff)'
-    : fullDiff;
-
-  // Load prompt from template
-  const prompt = await loadPrompt('ANALYZE_DIFF.md', {
-    CONTEXT_DESCRIPTION: contextDescription,
-    SUBAGENT_INSTRUCTION: subagentInstruction,
-    COMMITS: commits,
-    DIFF_FILES: diffFiles,
-    FULL_DIFF: truncatedDiff
-  });
-
-  info('Sending to Claude for analysis...');
-  const startTime = Date.now();
-
-  // Prepare telemetry context
-  const filesChanged = diffFiles.split('\n').length;
-  const telemetryContext = {
-    fileCount: filesChanged,
-    batchSize: filesChanged,
-    totalBatches: 1,
-    model: subagentModel || 'sonnet',
-    hook: 'analyze-diff'
-  };
-
-  try {
-    // Use cross-platform executeClaudeWithRetry from claude-client.js with telemetry
-    const response = await executeClaudeWithRetry(prompt, {
-      timeout: 180000, // 3 minutes for diff analysis
-      telemetryContext
-    });
-
-    // Extract JSON from response using claude-client utility
-    const result = extractJSON(response);
-
-    // Show the results
-    console.log('');
-    console.log('════════════════════════════════════════════════════════════════');
-    console.log('                      DIFFERENCES ANALYSIS                      ');
-    console.log('════════════════════════════════════════════════════════════════');
-    console.log('');
-
-    console.log(`🔍 ${colors.blue}Context:${colors.reset} ${contextDescription}`);
-    console.log(`📊 ${colors.blue}Changed Files:${colors.reset} ${diffFiles.split('\n').length}`);
-    console.log('');
-
-    console.log(`📝 ${colors.green}Pull Request Title:${colors.reset}`);
-    console.log(`   ${result.prTitle}`);
-    console.log('');
-
-    console.log(`🌿 ${colors.green}Suggested branch name:${colors.reset}`);
-    console.log(`   ${result.suggestedBranchName}`);
-    console.log('');
-
-    console.log(`📋 ${colors.green}Type of change:${colors.reset} ${result.changeType}`);
-
-    if (result.breakingChanges) {
-      console.log(`⚠️  ${colors.yellow}Breaking Changes: SÍ${colors.reset}`);
-    }
-
-    console.log('');
-    console.log(`📄 ${colors.green}Pull Request Description:${colors.reset}`);
-    console.log('───────────────────────────────────────────────────────────────');
-    console.log(result.prDescription);
-    console.log('───────────────────────────────────────────────────────────────');
-
-    if (result.testingNotes) {
-      console.log('');
-      console.log(`🧪 ${colors.green}Testing notes:${colors.reset}`);
-      console.log(result.testingNotes);
-    }
-
-    // Guardar los resultados en un archivo con contexto
-    const outputData = {
-      ...result,
-      context: {
-        currentBranch,
-        baseBranch,
-        contextDescription,
-        filesChanged: diffFiles.split('\n').length,
-        timestamp: new Date().toISOString()
-      }
-    };
-
-    // Ensure .claude/out directory exists
-    const outputDir = '.claude/out';
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true });
-    }
-
-    const outputFile = '.claude/out/pr-analysis.json';
-    fs.writeFileSync(outputFile, JSON.stringify(outputData, null, 2));
-
-    const elapsed = Date.now() - startTime;
-    const seconds = Math.floor(elapsed / 1000);
-    const ms = elapsed % 1000;
-    console.log('');
-    console.log(`${colors.blue}⏱️  Analysis completed in ${seconds}.${ms}s${colors.reset}`);
-    info(`Results saved in ${outputFile}`);
-
-    // Sugerencias contextuales
-    console.log('');
-    if (!args[0] && contextDescription.includes('local changes without push')) {
-      // Case of local changes without push
-      console.log(`💡 ${colors.yellow}To create new branch with these changes:${colors.reset}`);
-      console.log(`   git checkout -b ${result.suggestedBranchName}`);
-      console.log(`   git push -u origin ${result.suggestedBranchName}`);
-    } else if (currentBranch !== result.suggestedBranchName) {
-      // Caso normal de comparación entre ramas  
-      console.log(`💡 ${colors.yellow}For renaming your current branch:${colors.reset}`);
-      console.log(`   git branch -m ${result.suggestedBranchName}`);
-    }
-
-    console.log(`💡 ${colors.yellow}Tip:${colors.reset} Use this information to create your PR on GitHub.`);
-
-  } catch (e) {
-    error('Error executing Claude: ' + e.message);
-  }
-}
-
-// Create PR command (v2.5.0+ - Octokit-based)
-async function createPr(args) {
-  logger.debug('create-pr', 'Starting create-pr command', { args });
-
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-    logger.debug('create-pr', 'Not in a git repository, exiting');
-    return;
-  }
-
-  try {
-    // Load configuration
-    logger.debug('create-pr', 'Loading configuration');
-    const config = await getConfig();
-    logger.debug('create-pr', 'Configuration loaded', {
-      preset: config.preset,
-      githubEnabled: config.github?.enabled,
-      defaultBase: config.github?.pr?.defaultBase
-    });
-
-    // Import GitHub API module
-    logger.debug('create-pr', 'Importing GitHub API modules');
-    const { createPullRequest, GitHubAPIError, validateToken, findExistingPR } = await import('../lib/utils/github-api.js');
-    const { parseGitHubRepo } = await import('../lib/utils/github-client.js');
-
-    showInfo('🚀 Creating Pull Request...');
-    console.log('');
-
-    // Step 1: Validate GitHub token
-    logger.debug('create-pr', 'Step 1: Validating GitHub token');
-    const tokenValidation = await validateToken();
-    if (!tokenValidation.valid) {
-      logger.error('create-pr', 'GitHub authentication failed', { error: tokenValidation.error });
-      showError('GitHub authentication failed');
-      console.log('');
-      console.log('Please configure your GitHub token:');
-      console.log('  Option 1: Set GITHUB_TOKEN environment variable');
-      console.log('  Option 2: Add token to .claude/settings.local.json:');
-      console.log('            { "githubToken": "ghp_your_token_here" }');
-      console.log('  Option 3: Run: claude-hooks setup-github');
-      console.log('');
-      process.exit(1);
-    }
-
-    logger.debug('create-pr', 'Token validation successful', {
-      user: tokenValidation.user,
-      hasRepoScope: tokenValidation.hasRepoScope,
-      scopes: tokenValidation.scopes
-    });
-
-    showSuccess(`Authenticated as: ${tokenValidation.user}`);
-    if (!tokenValidation.hasRepoScope) {
-      showWarning('Token may lack "repo" scope - PR creation might fail');
-    }
-
-    // Step 2: Get or prompt for task-id (with config for pattern)
-    logger.debug('create-pr', 'Step 2: Getting or prompting for task-id');
-    const taskId = await getOrPromptTaskId({
-        prompt: true,      // DO prompt for PRs (unlike commit messages)
-        required: false,   // Allow skipping
-        config: config     // Pass config for custom pattern
-    });
-    logger.debug('create-pr', 'Task ID determined', { taskId });
-
-    // Step 3: Parse arguments and determine base branch
-    logger.debug('create-pr', 'Step 3: Parsing arguments and determining base branch', { args });
-    let baseBranchArg = args[0];
-    if (baseBranchArg && /^[A-Z]{2,10}-\d+$/i.test(baseBranchArg)) {
-      baseBranchArg = args[1];
-    }
-    const baseBranch = baseBranchArg || config.github?.pr?.defaultBase || 'develop';
-    logger.debug('create-pr', 'Base branch determined', { baseBranch, fromConfig: !baseBranchArg });
-
-    // Step 4: Get current branch and repo info
-    logger.debug('create-pr', 'Step 4: Getting current branch and repo info');
-    const currentBranch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();
-    if (!currentBranch) {
-      logger.error('create-pr', 'Could not determine current branch');
-      error('Could not determine current branch');
-      return;
-    }
-
-    const repoInfo = parseGitHubRepo();
-    logger.debug('create-pr', 'Repository and branch info', {
-      owner: repoInfo.owner,
-      repo: repoInfo.repo,
-      currentBranch,
-      baseBranch
-    });
-
-    showInfo(`Repository: ${repoInfo.fullName}`);
-    showInfo(`Branch: ${currentBranch} → ${baseBranch}`);
-
-    // Step 5: Check for existing PR
-    logger.debug('create-pr', 'Step 5: Checking for existing PR');
-    const existingPR = await findExistingPR({
-      owner: repoInfo.owner,
-      repo: repoInfo.repo,
-      head: currentBranch,
-      base: baseBranch
-    });
-
-    if (existingPR) {
-      logger.debug('create-pr', 'Existing PR found, exiting', {
-        prNumber: existingPR.number,
-        prUrl: existingPR.html_url
-      });
-      showWarning(`A PR already exists for this branch: #${existingPR.number}`);
-      console.log(`  ${existingPR.html_url}`);
-      console.log('');
-      return;
-    }
-
-    logger.debug('create-pr', 'No existing PR found, continuing');
-
-    // Step 6: Update remote and check for differences
-    logger.debug('create-pr', 'Step 6: Fetching latest changes from remote');
-    execSync('git fetch', { stdio: 'ignore' });
-    const compareWith = `origin/${baseBranch}...HEAD`;
-
-    try {
-      execSync(`git rev-parse --verify origin/${baseBranch}`, { stdio: 'ignore' });
-    } catch (e) {
-      error(`Base branch origin/${baseBranch} does not exist`);
-      return;
-    }
-
-    let diffFiles;
-    try {
-      diffFiles = execSync(`git diff ${compareWith} --name-only`, { encoding: 'utf8' }).trim();
-      if (!diffFiles) {
-        showWarning('No differences with remote branch. Nothing to create a PR for.');
-        return;
-      }
-    } catch (e) {
-      error('Error getting differences: ' + e.message);
-      return;
-    }
-
-    const filesArray = diffFiles.split('\n').filter(f => f.trim());
-    logger.debug('create-pr', 'Modified files detected', {
-      fileCount: filesArray.length,
-      files: filesArray
-    });
-    showInfo(`Found ${filesArray.length} modified file(s)`);
-
-    // Step 7: Generate PR metadata with Claude (reuse analyze-diff logic)
-    logger.debug('create-pr', 'Step 7: Generating PR metadata with Claude');
-    let fullDiff, commits;
-    try {
-      fullDiff = execSync(`git diff ${compareWith}`, { encoding: 'utf8' });
-      commits = execSync(`git log origin/${baseBranch}..HEAD --oneline`, { encoding: 'utf8' }).trim();
-    } catch (e) {
-      error('Error getting diff or commits: ' + e.message);
-      return;
-    }
-
-    const truncatedDiff = fullDiff.length > 50000
-      ? fullDiff.substring(0, 50000) + '\n... (truncated)'
-      : fullDiff;
-
-    const contextDescription = `${currentBranch} vs origin/${baseBranch}`;
-    const prompt = await loadPrompt('ANALYZE_DIFF.md', {
-      CONTEXT_DESCRIPTION: contextDescription,
-      SUBAGENT_INSTRUCTION: '',
-      COMMITS: commits,
-      DIFF_FILES: diffFiles,
-      FULL_DIFF: truncatedDiff
-    });
-
-    showInfo('Generating PR metadata with Claude...');
-    logger.debug('create-pr', 'Calling Claude with prompt', { promptLength: prompt.length });
-
-    // Prepare telemetry context for create-pr
-    const telemetryContext = {
-      fileCount: filesArray.length,
-      batchSize: filesArray.length,
-      totalBatches: 1,
-      model: 'sonnet', // create-pr always uses main model
-      hook: 'create-pr'
-    };
-
-    const response = await executeClaudeWithRetry(prompt, {
-      timeout: 180000,
-      telemetryContext
-    });
-    logger.debug('create-pr', 'Claude response received', { responseLength: response.length });
-
-    const analysisResult = extractJSON(response);
-    logger.debug('create-pr', 'Analysis result extracted', {
-      hasResult: !!analysisResult,
-      hasPrTitle: !!analysisResult?.prTitle
-    });
-
-    if (!analysisResult || !analysisResult.prTitle) {
-      logger.error('create-pr', 'Failed to generate PR metadata from analysis', { analysisResult });
-      error('Failed to generate PR metadata from analysis');
-      return;
-    }
-
-    // Step 8: Prepare PR data
-    logger.debug('create-pr', 'Step 8: Preparing PR data');
-    let prTitle = analysisResult.prTitle;
-    if (taskId) {
-      prTitle = formatWithTaskId(prTitle, taskId);
-      logger.debug('create-pr', 'Task ID added to title', { prTitle });
-    }
-
-    const prBody = analysisResult.prDescription || analysisResult.description || '';
-    logger.debug('create-pr', 'PR title and body prepared', {
-      titleLength: prTitle.length,
-      bodyLength: prBody.length
-    });
-
-    // Step 9: Get labels from preset
-    logger.debug('create-pr', 'Step 9: Getting labels from preset');
-    let labels = [];
-    if (config.preset && config.github?.pr?.labelRules) {
-      labels = config.github.pr.labelRules[config.preset] || [];
-    }
-    if (analysisResult.breakingChanges) {
-      labels.push('breaking-change');
-    }
-    logger.debug('create-pr', 'Labels determined', { labels, preset: config.preset });
-
-    // Step 10: Get reviewers from CODEOWNERS and config
-    logger.debug('create-pr', 'Step 10: Getting reviewers from CODEOWNERS and config');
-    const reviewers = await getReviewersForFiles(filesArray, config.github?.pr);
-    logger.debug('create-pr', 'Reviewers determined', { reviewers, sources: 'CODEOWNERS + config' });
-
-    // Step 11: Show PR preview
-    const prData = {
-      title: prTitle,
-      body: prBody,
-      head: currentBranch,
-      base: baseBranch,
-      labels,
-      reviewers
-    };
-
-    showPRPreview(prData);
-
-    // Step 12: Prompt for confirmation
-    const action = await promptMenu(
-      'What would you like to do?',
-      [
-        { key: 'c', label: 'Create PR' },
-        { key: 'x', label: 'Cancel' }
-      ],
-      'c'
-    );
-
-    if (action === 'x') {
-      showInfo('PR creation cancelled');
-
-      // Save metadata for later use
-      const outputDir = '.claude/out';
-      if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true });
-      }
-      const outputFile = path.join(outputDir, 'pr-metadata.json');
-      fs.writeFileSync(outputFile, JSON.stringify(prData, null, 2));
-      showInfo(`PR metadata saved to ${outputFile}`);
-      return;
-    }
-
-    // Step 13: Create PR via Octokit
-    logger.debug('create-pr', 'Step 13: Creating PR via Octokit');
-    showInfo('Creating pull request on GitHub...');
-
-    try {
-      logger.debug('create-pr', 'Calling createPullRequest API', {
-        owner: repoInfo.owner,
-        repo: repoInfo.repo,
-        head: prData.head,
-        base: prData.base
-      });
-
-      const result = await createPullRequest({
-        owner: repoInfo.owner,
-        repo: repoInfo.repo,
-        title: prData.title,
-        body: prData.body,
-        head: prData.head,
-        base: prData.base,
-        draft: false,
-        labels: prData.labels,
-        reviewers: prData.reviewers
-      });
-
-      logger.debug('create-pr', 'PR created successfully', {
-        prNumber: result.number,
-        prUrl: result.html_url
-      });
-
-      console.log('');
-      showSuccess('Pull request created successfully!');
-      console.log('');
-      console.log(`  PR #${result.number}: ${result.html_url}`);
-      console.log('');
-
-      if (result.reviewers.length > 0) {
-        showInfo(`Reviewers requested: ${result.reviewers.join(', ')}`);
-      }
-      if (result.labels.length > 0) {
-        showInfo(`Labels added: ${result.labels.join(', ')}`);
-      }
-
-    } catch (apiError) {
-      logger.error('create-pr', 'Failed to create pull request', apiError);
-      showError('Failed to create pull request');
-      console.error('');
-      console.error(`  ${apiError.message}`);
-
-      if (apiError.context?.suggestion) {
-        console.error('');
-        console.error(`  💡 ${apiError.context.suggestion}`);
-      }
-      console.error('');
-
-      // Save PR metadata for manual creation or retry
-      const outputDir = '.claude/out';
-      if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true });
-      }
-      const outputFile = path.join(outputDir, 'pr-metadata.json');
-      fs.writeFileSync(outputFile, JSON.stringify({
-        ...prData,
-        error: apiError.message,
-        timestamp: new Date().toISOString()
-      }, null, 2));
-
-      logger.debug('create-pr', 'PR metadata saved', { outputFile });
-      showInfo(`PR metadata saved to ${outputFile}`);
-      showInfo('You can create the PR manually using this data');
-
-      process.exit(1);
-    }
-
-  } catch (err) {
-    logger.error('create-pr', 'Error creating PR', err);
-    showError('Error creating PR: ' + err.message);
-
-    if (err.context) {
-      logger.debug('create-pr', 'Error context', err.context);
-      console.error('Context:', JSON.stringify(err.context, null, 2));
-    }
-
-    process.exit(1);
-  }
-}
-
-// Setup GitHub authentication
-async function setupGitHub() {
-  const { validateToken } = await import('../lib/utils/github-api.js');
-
-  console.log('');
-  info('GitHub Authentication Setup');
-  console.log('');
-
-  // Check existing token
-  try {
-    const validation = await validateToken();
-    if (validation.valid) {
-      success(`Already authenticated as: ${validation.user}`);
-      console.log(`  Scopes: ${validation.scopes.join(', ')}`);
-
-      if (!validation.hasRepoScope) {
-        warning('Token lacks "repo" scope - PR creation may fail');
-      }
-
-      console.log('');
-      info('To use a different token, edit .claude/settings.local.json');
-      return;
-    }
-  } catch (e) {
-    // No token configured, continue with setup
-  }
-
-  console.log('No GitHub token found. You have several options:');
-  console.log('');
-  console.log('Option 1: Create .claude/settings.local.json');
-  console.log('  {');
-  console.log('    "githubToken": "ghp_your_token_here"');
-  console.log('  }');
-  console.log('');
-  console.log('Option 2: Set environment variable');
-  console.log('  export GITHUB_TOKEN="ghp_your_token_here"');
-  console.log('');
-  console.log('Option 3: Run setup-mcp (if you also want MCP features)');
-  console.log('  claude-hooks setup-mcp');
-  console.log('');
-  console.log('To create a token:');
-  console.log('  1. Go to https://github.com/settings/tokens/new');
-  console.log('  2. Select scopes: repo, read:org');
-  console.log('  3. Generate and copy the token');
-  console.log('');
-}
-
-// Comando status
-function status() {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-  }
-
-  info('Claude Git Hooks status:\n');
-
-  const hooks = ['pre-commit', 'prepare-commit-msg'];
-  hooks.forEach(hook => {
-    const enabledPath = `.git/hooks/${hook}`;
-    const disabledPath = `.git/hooks/${hook}.disabled`;
-
-    if (fs.existsSync(enabledPath)) {
-      success(`${hook}: enabled`);
-    } else if (fs.existsSync(disabledPath)) {
-      warning(`${hook}: disabled`);
-    } else {
-      error(`${hook}: not installed`);
-    }
-  });
-
-  // Check guidelines files
-  console.log('\nGuidelines files:');
-  const guidelines = ['CLAUDE_PRE_COMMIT.md'];
-  guidelines.forEach(guideline => {
-    const claudePath = path.join('.claude', guideline);
-    if (fs.existsSync(claudePath)) {
-      success(`${guideline}: present in .claude/`);
-    } else if (fs.existsSync(guideline)) {
-      warning(`${guideline}: present in root (should be in .claude/)`);
-    } else {
-      warning(`${guideline}: missing`);
-    }
-  });
-
-  // Verificar entradas en .gitignore
-  console.log('\n.gitignore:');
-  const gitignorePath = '.gitignore';
-  if (fs.existsSync(gitignorePath)) {
-    const gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
-    const claudeIgnore = '.claude/';
-
-    const regex = new RegExp(`^${claudeIgnore.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`, 'm');
-    if (regex.test(gitignoreContent)) {
-      success(`${claudeIgnore}: included (protects all Claude files)`);
-    } else {
-      warning(`${claudeIgnore}: missing`);
-      info('\nRun "claude-hooks install" to update .gitignore');
-    }
-  } else {
-    warning('.gitignore doesn´t exist');
-  }
-}
-
-// Cross-platform version comparison (semver)
-// Why: Pure JavaScript, no bash dependency
-// Returns: 0 if equal, 1 if v1 > v2, -1 if v1 < v2
-function compareVersions(v1, v2) {
-  if (v1 === v2) return 0;
-
-  const v1Parts = v1.split('.').map(Number);
-  const v2Parts = v2.split('.').map(Number);
-
-  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    const v1Part = v1Parts[i] || 0;
-    const v2Part = v2Parts[i] || 0;
-
-    if (v1Part > v2Part) return 1;
-    if (v1Part < v2Part) return -1;
-  }
-
-  return 0;
-}
-
-// Update command - update to the latest version
-async function update() {
-  info('Checking latest available version...');
-
-  try {
-    const currentVersion = getPackageJson().version;
-    const latestVersion = await getLatestVersion('claude-git-hooks');
-
-    const comparison = compareVersions(currentVersion, latestVersion);
-
-    if (comparison === 0) {
-      success(`You already have the latest version installed (${currentVersion})`);
-      return;
-    } else if (comparison > 0) {
-      info(`You are using a development version (${currentVersion})`);
-      info(`Latest published version: ${latestVersion}`);
-      success(`You already have the latest version installed (${currentVersion})`);
-      return;
-    }
-
-    info(`Current version: ${currentVersion}`);
-    info(`Available version: ${latestVersion}`);
-
-    // Actualizar el paquete
-    info('Updating claude-git-hooks...');
-    try {
-      execSync('npm install -g claude-git-hooks@latest', { stdio: 'inherit' });
-      success(`Successfully updated to version ${latestVersion}`);
-
-      // Reinstall hooks with the new version
-      info('Reinstalling hooks with the new version...');
-      await install(['--force']);
-
-    } catch (updateError) {
-      error('Error updating. Try running: npm install -g claude-git-hooks@latest');
-    }
-  } catch (e) {
-    warning('Could not check the latest available version');
-    warning('Trying to update anyway...');
-    try {
-      execSync('npm install -g claude-git-hooks@latest', { stdio: 'inherit' });
-      success('Update completed');
-      await install(['--force']);
-    } catch (updateError) {
-      error('Error updating: ' + updateError.message);
-    }
-  }
-}
-
-// Show version command
-// Why: Reusable function to display current version from package.json
-function showVersion() {
-  const pkg = getPackageJson();
-  console.log(`${pkg.name} v${pkg.version}`);
-}
-
-// Comando help
-function showHelp() {
-  console.log(`
-Claude Git Hooks - Code analysis and automatic messages with Claude CLI
-
-Usage: claude-hooks <command> [options]
-
-Commands:
-  install [options]    Install hooks in the current repository
-    --force           Reinstall even if they already exist
-    --skip-auth       Skip Claude authentication verification
-  update               Update to the latest available version
-  uninstall            Uninstall hooks from the repository
-  enable [hook]        Enable hooks (all or one specific)
-  disable [hook]       Disable hooks (all or one specific)
-  status               Show the status of hooks
-  analyze-diff [base]  Analyze differences between branches and generate PR info
-  create-pr [base]     Create pull request with auto-generated metadata and reviewers
-  setup-github         Setup GitHub login (required for create-pr)
-  presets              List all available presets
-  --set-preset <name>  Set the active preset
-  preset current       Show the current active preset
-  telemetry [action]   Telemetry management (show or clear)
-  --debug <value>      Set debug mode (true, false, or status)
-  --version, -v        Show the current version
-  help                 Show this help
-
-Available hooks:
-  pre-commit           Code analysis before commit
-  prepare-commit-msg   Automatic message generation
-
-Examples:
-  claude-hooks install              # Install all hooks
-  claude-hooks install --skip-auth  # Install without verifying authentication
-  claude-hooks update               # Update to the latest version
-  claude-hooks disable pre-commit   # Disable only pre-commit
-  claude-hooks enable               # Enable all hooks
-  claude-hooks status               # View current status
-  claude-hooks analyze-diff main    # Analyze differences with main
-  claude-hooks setup-github         # Configure GitHub authentication for PR creation
-  claude-hooks setup-mcp            # Setup GitHub MCP (one-time setup)
-  claude-hooks create-pr develop    # Create PR targeting develop branch
-  claude-hooks presets              # List available presets
-  claude-hooks --set-preset backend # Set backend preset
-  claude-hooks preset current       # Show current preset
-  claude-hooks telemetry show       # Show telemetry statistics
-  claude-hooks telemetry clear      # Clear telemetry data
-  claude-hooks --debug true         # Enable debug mode
-  claude-hooks --debug status       # Check debug status
-
-Commit use cases:
-  git commit -m "message"           # Manual message + blocking analysis
-  git commit -m "auto"              # Automatic message + blocking analysis
-  git commit --no-verify -m "auto"  # Automatic message without analysis
-  git commit --no-verify -m "msg"   # Manual message without analysis
-
-Analyze-diff use case:
-  claude-hooks analyze-diff main    # Analyze changes vs main and generate:
-    → PR Title: "feat: add user authentication module"
-    → PR Description: "## Summary\n- Added JWT authentication..."
-    → Suggested branch: "feature/user-authentication"
-
-Create-pr use case (v2.5.0+):
-  claude-hooks create-pr develop    # Create PR targeting develop:
-    → Validates GitHub token
-    → Extracts task-id from branch (IX-123, #456, LIN-123)
-    → Analyzes diff and generates PR metadata with Claude
-    → Creates PR directly via GitHub API (Octokit)
-    → Adds labels based on preset
-    → Returns PR URL
-
-  Token configuration:
-    → .claude/settings.local.json (recommended, gitignored)
-    → GITHUB_TOKEN environment variable
-    → Claude Desktop config (auto-detected)
-
-Presets (v2.3.0+):
-  Built-in tech-stack specific configurations:
-  - backend: Spring Boot + SQL Server (.java, .xml, .yml)
-  - frontend: React + Material-UI (.js, .jsx, .ts, .tsx, .css)
-  - fullstack: Backend + Frontend with API consistency checks
-  - database: SQL Server migrations and procedures (.sql)
-  - ai: Node.js + Claude CLI integration (.js, .json, .md)
-  - default: General-purpose mixed languages
-
-Configuration (v2.2.0+):
-  Create .claude/config.json in your project to customize:
-  - Preset selection
-  - Analysis settings (maxFileSize, maxFiles, timeout)
-  - Commit message generation (autoKeyword, timeout)
-  - Parallel execution (enabled, model, batchSize)
-  - Template paths and output files
-  - Debug mode
-
-  Example: .claude/config.json
-  {
-    "preset": "backend",
-    "analysis": { "maxFiles": 30, "timeout": 180000 },
-    "subagents": {
-      "enabled": true,      # Enable parallel execution
-      "model": "haiku",     # haiku (fast) | sonnet | opus
-      "batchSize": 2        # Files per batch (1=fastest)
-    },
-    "system": { "debug": true }
-  }
-
-Parallel Analysis (v2.2.0+):
-  When analyzing 3+ files, parallel execution runs multiple Claude CLI
-  processes simultaneously for faster analysis:
-  - batchSize: 1 → Maximum speed (1 file per process)
-  - batchSize: 2 → Balanced (2 files per process)
-  - batchSize: 4+ → Fewer API calls but slower
-  - Speed improvement: up to 4x faster with batchSize: 1
-
-Debug Mode:
-  Enable detailed logging for troubleshooting:
-  - CLI: claude-hooks --debug true
-  - Config: "system": { "debug": true } in .claude/config.json
-  - Check status: claude-hooks --debug status
-
-Customization:
-  Override prompts by copying to .claude/:
-    cp templates/COMMIT_MESSAGE.md .claude/
-    cp templates/ANALYZE_DIFF.md .claude/
-    cp templates/CLAUDE_PRE_COMMIT.md .claude/
-    # Edit as needed - system uses .claude/ version if exists
-
-More information: https://github.com/pablorovito/claude-git-hooks
-`);
-}
-
-// Configuration Management Functions
-
-/**
- * Updates a configuration value in .claude/config.json
- * Why: Centralized config update logic for all CLI commands
- *
- * @param {string} propertyPath - Dot notation path (e.g., 'preset', 'system.debug')
- * @param {any} value - Value to set
- * @param {Object} options - Optional settings
- * @param {Function} options.validator - Custom validation function, receives value, throws on invalid
- * @param {Function} options.successMessage - Function that receives value and returns success message
- */
-async function updateConfig(propertyPath, value, options = {}) {
-  const { validator, successMessage } = options;
-
-  try {
-    // Validate value if validator provided
-    if (validator) {
-      await validator(value);
-    }
-
-    // Get repo root
-    const repoRoot = execSync('git rev-parse --show-toplevel', { encoding: 'utf8' }).trim();
-    const configDir = path.join(repoRoot, '.claude');
-    const configPath = path.join(configDir, 'config.json');
-
-    // Ensure .claude directory exists
-    if (!fs.existsSync(configDir)) {
-      fs.mkdirSync(configDir, { recursive: true });
-    }
-
-    // Load existing config or create new
-    let config = {};
-    if (fs.existsSync(configPath)) {
-      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    }
-
-    // Set value at propertyPath (support dot notation like 'system.debug')
-    const pathParts = propertyPath.split('.');
-    let current = config;
-    for (let i = 0; i < pathParts.length - 1; i++) {
-      const part = pathParts[i];
-      if (!current[part] || typeof current[part] !== 'object') {
-        current[part] = {};
-      }
-      current = current[part];
-    }
-    current[pathParts[pathParts.length - 1]] = value;
-
-    // Save config
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-    // Show success message
-    const message = successMessage ? await successMessage(value) : 'Configuration updated';
-    success(message);
-    info(`Configuration saved to ${configPath}`);
-  } catch (err) {
-    error(`Failed to update configuration: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-// Preset Management Functions
-
-/**
- * Shows all available presets
- */
-async function showPresets() {
-  try {
-    const presets = await listPresets();
-
-    if (presets.length === 0) {
-      warning('No presets found');
-      return;
-    }
-
-    console.log('');
-    info('Available presets:');
-    console.log('');
-
-    presets.forEach(preset => {
-      console.log(`  ${colors.green}${preset.name}${colors.reset}`);
-      console.log(`    ${preset.displayName}`);
-      console.log(`    ${colors.blue}${preset.description}${colors.reset}`);
-      console.log('');
-    });
-
-    info('To set a preset: claude-hooks --set-preset <name>');
-    info('To see current preset: claude-hooks preset current');
-    console.log('');
-  } catch (err) {
-    error(`Failed to list presets: ${err.message}`);
-  }
-}
-
-/**
- * Sets the active preset
- * Why: Configures tech-stack specific analysis settings
- */
-async function setPreset(presetName) {
-  if (!presetName) {
-    error('Please specify a preset name: claude-hooks --set-preset <name>');
-    return;
-  }
-
-  await updateConfig('preset', presetName, {
-    validator: async (name) => {
-      const presets = await listPresets();
-      const preset = presets.find(p => p.name === name);
-      if (!preset) {
-        error(`Preset "${name}" not found`);
-        info('Available presets:');
-        presets.forEach(p => console.log(`  - ${p.name}`));
-        throw new Error(`Invalid preset: ${name}`);
-      }
-      return preset;
-    },
-    successMessage: async (name) => {
-      const presets = await listPresets();
-      const preset = presets.find(p => p.name === name);
-      return `Preset '${preset.displayName}' activated`;
-    }
-  });
-}
-
-/**
- * Shows the current active preset
- */
-async function currentPreset() {
-  try {
-    const config = await getConfig();
-    const presetName = config.preset || 'default';
-
-    const presets = await listPresets();
-    const preset = presets.find(p => p.name === presetName);
-
-    if (preset) {
-      console.log('');
-      success(`Current preset: ${preset.displayName} (${preset.name})`);
-      console.log(`  ${colors.blue}${preset.description}${colors.reset}`);
-      console.log('');
-    } else {
-      warning(`Current preset "${presetName}" not found`);
-    }
-  } catch (err) {
-    error(`Failed to get current preset: ${err.message}`);
-  }
-}
-
-// ============================================================================
-// DEPRECATED CODE SECTION - Will be removed in v3.0.0
-// ============================================================================
-// This section contains migration code for legacy configs (pre-v2.8.0)
-// Auto-executed during install when legacy config detected
-// Manual command: claude-hooks migrate-config
-// ============================================================================
-
-/**
- * Extracts allowed settings from legacy config format
- * Shared by both autoMigrateConfig and migrateConfig
- *
- * @param {Object} rawConfig - Legacy format config
- * @returns {Object} Allowed overrides only
- */
-function extractLegacySettings(rawConfig) {
-  const allowedOverrides = {};
-
-  // GitHub PR config (fully allowed)
-  if (rawConfig.github?.pr) {
-    allowedOverrides.github = { pr: {} };
-    if (rawConfig.github.pr.defaultBase !== undefined) {
-      allowedOverrides.github.pr.defaultBase = rawConfig.github.pr.defaultBase;
-    }
-    if (rawConfig.github.pr.reviewers !== undefined) {
-      allowedOverrides.github.pr.reviewers = rawConfig.github.pr.reviewers;
-    }
-    if (rawConfig.github.pr.labelRules !== undefined) {
-      allowedOverrides.github.pr.labelRules = rawConfig.github.pr.labelRules;
-    }
-  }
-
-  // Subagent batchSize (allowed)
-  if (rawConfig.subagents?.batchSize !== undefined) {
-    allowedOverrides.subagents = { batchSize: rawConfig.subagents.batchSize };
-  }
-
-  // Advanced params (preserved with warning in manual migration)
-  if (rawConfig.analysis?.ignoreExtensions !== undefined) {
-    if (!allowedOverrides.analysis) allowedOverrides.analysis = {};
-    allowedOverrides.analysis.ignoreExtensions = rawConfig.analysis.ignoreExtensions;
-  }
-
-  if (rawConfig.commitMessage?.taskIdPattern !== undefined) {
-    if (!allowedOverrides.commitMessage) allowedOverrides.commitMessage = {};
-    allowedOverrides.commitMessage.taskIdPattern = rawConfig.commitMessage.taskIdPattern;
-  }
-
-  if (rawConfig.subagents?.model !== undefined) {
-    if (!allowedOverrides.subagents) allowedOverrides.subagents = {};
-    allowedOverrides.subagents.model = rawConfig.subagents.model;
-  }
-
-  return allowedOverrides;
-}
-
 /**
- * Auto-migrates legacy config during installation
- * Called automatically by installer when legacy format detected
+ * File: claude-hooks
+ * Purpose: Main CLI entry point - thin router to command modules
  *
- * @param {string} newConfigPath - Path to new config.json
- * @param {string} backupConfigPath - Path to backup of old config
+ * All command implementations are in lib/commands/
+ * This file only handles argument parsing and routing.
  */
-async function autoMigrateConfig(newConfigPath, backupConfigPath) {
-  try {
-    const rawConfig = JSON.parse(fs.readFileSync(backupConfigPath, 'utf8'));
-    const allowedOverrides = extractLegacySettings(rawConfig);
 
-    // Read the newly created minimal config
-    const newConfig = JSON.parse(fs.readFileSync(newConfigPath, 'utf8'));
-
-    // Add overrides if any
-    if (Object.keys(allowedOverrides).length > 0) {
-      newConfig.overrides = allowedOverrides;
-      fs.writeFileSync(newConfigPath, JSON.stringify(newConfig, null, 4));
-      success('✅ Settings migrated from legacy config');
-      info(`📋 Preserved ${Object.keys(allowedOverrides).length} custom settings`);
-    }
-  } catch (err) {
-    warning(`⚠️  Could not auto-migrate settings: ${err.message}`);
-    info('💡 Run "claude-hooks migrate-config" manually if needed');
-  }
-}
+import { error } from '../lib/commands/helpers.js';
+
+// Import commands
+import { runInstall } from '../lib/commands/install.js';
+import { runEnable, runDisable, runStatus, runUninstall } from '../lib/commands/hooks.js';
+import { runAnalyzeDiff } from '../lib/commands/analyze-diff.js';
+import { runCreatePr } from '../lib/commands/create-pr.js';
+import { runSetupGitHub } from '../lib/commands/setup-github.js';
+import { runShowPresets, runSetPreset, runCurrentPreset } from '../lib/commands/presets.js';
+import { runUpdate } from '../lib/commands/update.js';
+import { runMigrateConfig } from '../lib/commands/migrate-config.js';
+import { runSetDebug } from '../lib/commands/debug.js';
+import { runShowTelemetry, runClearTelemetry } from '../lib/commands/telemetry-cmd.js';
+import { runShowHelp, runShowVersion } from '../lib/commands/help.js';
 
 /**
- * Migrates legacy config.json to v2.8.0 format (Manual command)
- * Why: Simplifies configuration, reduces redundancy
- *
- * DEPRECATED: Will be removed in v3.0.0 (most users will have migrated by then)
+ * Main CLI router
  */
-async function migrateConfig() {
-  const claudeDir = '.claude';
-  const configPath = path.join(claudeDir, 'config.json');
-
-  if (!fs.existsSync(configPath)) {
-    info('ℹ️  No config file found. Nothing to migrate.');
-    console.log('\n💡 To create a new config:');
-    console.log('  1. Run: claude-hooks install --force');
-    console.log('  2. Or copy from: .claude/config_example/config.example.json');
-    return;
-  }
-
-  try {
-    const rawConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-
-    // Check if already in v2.8.0 format
-    if (rawConfig.version === '2.8.0') {
-      success('✅ Config is already in v2.8.0 format.');
-      return;
-    }
-
-    info('📦 Starting config migration to v2.8.0...');
-
-    // Create backup in config_old/
-    const configOldDir = path.join(claudeDir, 'config_old');
-    if (!fs.existsSync(configOldDir)) {
-      fs.mkdirSync(configOldDir, { recursive: true });
-    }
-    const backupPath = path.join(configOldDir, `config.json.${Date.now()}`);
-    fs.copyFileSync(configPath, backupPath);
-    success(`Backup created: ${backupPath}`);
-
-    // Extract only allowed parameters
-    const allowedOverrides = extractLegacySettings(rawConfig);
-
-    // Check for advanced params
-    const hasAdvancedParams = allowedOverrides.analysis?.ignoreExtensions ||
-                              allowedOverrides.commitMessage?.taskIdPattern ||
-                              allowedOverrides.subagents?.model;
-
-    // Build new config
-    const newConfig = {
-      version: '2.8.0',
-      preset: rawConfig.preset || 'default'
-    };
-
-    // Only add overrides if there are any
-    if (Object.keys(allowedOverrides).length > 0) {
-      newConfig.overrides = allowedOverrides;
-    }
-
-    // Show diff
-    console.log('\n📝 Migration preview:');
-    console.log(`  Old format: ${Object.keys(rawConfig).length} top-level keys`);
-    console.log(`  New format: ${Object.keys(newConfig).length} top-level keys`);
-    if (Object.keys(allowedOverrides).length > 0) {
-      console.log(`  Preserved: ${Object.keys(allowedOverrides).length} override sections`);
-    }
-
-    // Write new config
-    fs.writeFileSync(configPath, JSON.stringify(newConfig, null, 4));
-    success('✅ Config migrated to v2.8.0 successfully!');
-
-    if (hasAdvancedParams) {
-      warning('⚠️  Advanced parameters detected and preserved');
-      info('📖 See .claude/config.advanced.example.json for documentation');
-    }
-
-    console.log(`\n✨ New config:`);
-    console.log(JSON.stringify(newConfig, null, 2));
-    console.log(`\n💾 Old config backed up to: ${backupPath}`);
-    console.log('\n💡 Many parameters are now hardcoded with sensible defaults');
-    console.log('   See CHANGELOG.md for full list of changes');
-
-  } catch (error) {
-    error(`Failed to migrate config: ${error.message}`);
-    console.log('\n💡 Manual migration:');
-    console.log('  1. Backup your current config');
-    console.log('  2. See .claude/config.example.json for new format');
-    console.log('  3. Copy minimal example and customize');
-  }
-}
-
-/**
- * Sets debug mode
- * Why: Enables detailed logging for troubleshooting
- */
-async function setDebug(value) {
-  if (!value) {
-    error('Please specify a value: claude-hooks --debug <true|false|status>');
-    return;
-  }
-
-  const normalizedValue = value.toLowerCase();
-
-  // Handle status check
-  if (normalizedValue === 'status') {
-    try {
-      const config = await getConfig();
-      const isEnabled = config.system.debug || false;
-      console.log('');
-      info(`Debug mode: ${isEnabled ? colors.green + 'enabled' + colors.reset : colors.red + 'disabled' + colors.reset}`);
-      console.log('');
-    } catch (err) {
-      error(`Failed to check debug status: ${err.message}`);
-    }
-    return;
-  }
-
-  // Validate and convert to boolean
-  if (normalizedValue !== 'true' && normalizedValue !== 'false') {
-    error('Invalid value. Use: true, false, or status');
-    return;
-  }
-
-  const debugValue = normalizedValue === 'true';
-
-  await updateConfig('system.debug', debugValue, {
-    successMessage: (val) => `Debug mode ${val ? 'enabled' : 'disabled'}`
-  });
-}
-
-// Main
-/**
- * Show telemetry statistics
- * Why: Help users understand JSON parsing patterns and batch performance
- */
-async function showTelemetry() {
-  await showTelemetryStats();
-}
-
-/**
- * Clear telemetry data
- * Why: Allow users to reset telemetry
- */
-async function clearTelemetry() {
-  const config = await getConfig();
-
-  if (!config.system?.telemetry && config.system?.telemetry !== undefined) {
-    console.log('\n⚠️  Telemetry is currently disabled.\n');
-    console.log('To re-enable (default), remove or set to true in .claude/config.json:');
-    console.log('{');
-    console.log('  "system": {');
-    console.log('    "telemetry": true');
-    console.log('  }');
-    console.log('}\n');
-    return;
-  }
-
-  const confirmed = await promptConfirmation('Are you sure you want to clear all telemetry data?');
-  if (confirmed) {
-    await clearTelemetryData();
-    success('Telemetry data cleared successfully');
-  } else {
-    info('Telemetry data was not cleared');
-  }
-}
-
 async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0];
-
-  switch (command) {
-    case 'install':
-      await install(args.slice(1));
-      break;
-    case 'update':
-      await update();
-      break;
-    case 'uninstall':
-      uninstall();
-      break;
-    case 'enable':
-      enable(args[1]);
-      break;
-    case 'disable':
-      disable(args[1]);
-      break;
-    case 'status':
-      status();
-      break;
-    case 'analyze-diff':
-      await analyzeDiff(args.slice(1));
-      break;
-    case 'create-pr':
-      await createPr(args.slice(1));
-      break;
-    case 'setup-mcp':
-      await setupGitHubMCP();
-      break;
-    case 'setup-github':
-      await setupGitHub();
-      break;
-    case 'presets':
-      await showPresets();
-      break;
-    case '--set-preset':
-      await setPreset(args[1]);
-      break;
-    case 'preset':
-      // Handle subcommands: preset current
-      if (args[1] === 'current') {
-        await currentPreset();
-      } else {
-        error(`Unknown preset subcommand: ${args[1]}`);
-      }
-      break;
-    case 'migrate-config':
-      await migrateConfig();
-      break;
-    case 'telemetry':
-      // Handle subcommands: telemetry show, telemetry clear
-      if (args[1] === 'show' || args[1] === undefined) {
-        await showTelemetry();
-      } else if (args[1] === 'clear') {
-        await clearTelemetry();
-      } else {
-        error(`Unknown telemetry subcommand: ${args[1]}`);
-      }
-      break;
-    case '--debug':
-      await setDebug(args[1]);
-      break;
-    case '--version':
-    case '-v':
-    case 'version':
-      showVersion();
-      break;
-    case 'help':
-    case '--help':
-    case '-h':
-    case undefined:
-      showHelp();
-      break;
-    default:
-      error(`Unknown command: ${command}`);
-      showHelp();
-  }
+    const args = process.argv.slice(2);
+    const command = args[0];
+
+    switch (command) {
+        case 'install':
+            await runInstall(args.slice(1));
+            break;
+        case 'update':
+            await runUpdate();
+            break;
+        case 'uninstall':
+            runUninstall();
+            break;
+        case 'enable':
+            runEnable(args[1]);
+            break;
+        case 'disable':
+            runDisable(args[1]);
+            break;
+        case 'status':
+            runStatus();
+            break;
+        case 'analyze-diff':
+            await runAnalyzeDiff(args.slice(1));
+            break;
+        case 'create-pr':
+            await runCreatePr(args.slice(1));
+            break;
+        case 'setup-github':
+            await runSetupGitHub();
+            break;
+        case 'presets':
+            await runShowPresets();
+            break;
+        case '--set-preset':
+            await runSetPreset(args[1]);
+            break;
+        case 'preset':
+            // Handle subcommands: preset current
+            if (args[1] === 'current') {
+                await runCurrentPreset();
+            } else {
+                error(`Unknown preset subcommand: ${args[1]}`);
+            }
+            break;
+        case 'migrate-config':
+            await runMigrateConfig();
+            break;
+        case 'telemetry':
+            // Handle subcommands: telemetry show, telemetry clear
+            if (args[1] === 'show' || args[1] === undefined) {
+                await runShowTelemetry();
+            } else if (args[1] === 'clear') {
+                await runClearTelemetry();
+            } else {
+                error(`Unknown telemetry subcommand: ${args[1]}`);
+            }
+            break;
+        case '--debug':
+            await runSetDebug(args[1]);
+            break;
+        case '--version':
+        case '-v':
+        case 'version':
+            runShowVersion();
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            runShowHelp();
+            break;
+        default:
+            error(`Unknown command: ${command}`);
+            runShowHelp();
+    }
 }
 
 // Execute main
 main().catch(err => {
-  error(`Unexpected error: ${err.message}`);
-});
+    error(`Unexpected error: ${err.message}`);
+});