claude-git-hooks 2.0.0 → 2.3.0

package/bin/claude-hooks

@@ -9,6 +9,9 @@ import https from 'https';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 import { executeClaude, extractJSON } 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';
 
 // Why: ES6 modules don't have __dirname, need to recreate it
 const __filename = fileURLToPath(import.meta.url);
@@ -126,31 +129,6 @@ function warning(message) {
   log(`⚠️  ${message}`, 'yellow');
 }
 
-// Function to read password securely
-function readPassword(prompt) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    // Disable echo
-    rl.stdoutMuted = true;
-    rl._writeToOutput = function _writeToOutput(stringToWrite) {
-      if (rl.stdoutMuted)
-        rl.output.write("*");
-      else
-        rl.output.write(stringToWrite);
-    };
-
-    rl.question(prompt, (password) => {
-      rl.close();
-      console.log(); // New line
-      resolve(password);
-    });
-  });
-}
-
 // Entertainment system
 class Entertainment {
   static jokes = [
@@ -332,6 +310,11 @@ async function install(args) {
   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 {
@@ -396,28 +379,79 @@ async function install(args) {
     success('.claude directory created');
   }
 
-  // Copy guidelines and prompts files to .claude
-  const claudeFiles = [
-    'CLAUDE_PRE_COMMIT_SONAR.md',
-    'CLAUDE_ANALYSIS_PROMPT_SONAR.md',
-    'CLAUDE_RESOLUTION_PROMPT.md'
-  ];
+  // Copy ALL template files (.md and .json) to .claude directory
+  const templateFiles = fs.readdirSync(templatesPath)
+    .filter(file => {
+      const filePath = path.join(templatesPath, file);
+      return fs.statSync(filePath).isFile() && (file.endsWith('.md') || file.endsWith('.json'));
+    });
 
-  claudeFiles.forEach(file => {
-    const destPath = path.join(claudeDir, file);
+  templateFiles.forEach(file => {
     const sourcePath = path.join(templatesPath, file);
+    const destPath = path.join(claudeDir, file);
 
     // 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 .claude/`);
-      } else {
-        warning(`Template file not found: ${file}`);
       }
+    } else {
+      info(`${file} already exists (skipped)`);
     }
   });
 
+  // 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: rename config.example.json → config.json
+  const configExamplePath = path.join(claudeDir, 'config.example.json');
+  const configPath = path.join(claudeDir, 'config.json');
+
+  if (fs.existsSync(configExamplePath) && !fs.existsSync(configPath)) {
+    fs.copyFileSync(configExamplePath, configPath);
+    success('config.json created from example (customize as needed)');
+  } else if (!fs.existsSync(configPath)) {
+    warning('config.json not found - using defaults');
+  }
+
   // Configure Git
   configureGit();
 
@@ -429,17 +463,16 @@ async function install(args) {
   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('\nExclude code from analysis:');
-  console.log('  // SKIP-ANALYSIS         # Exclude the next line');
-  console.log('  // SKIP_ANALYSIS_BLOCK  # Exclude block until finding another equal one');
-  console.log('  ...excluded code...');
-  console.log('  // SKIP_ANALYSIS_BLOCK');
-  console.log('\nNEW: Parallel analysis for faster multi-file commits:');
-  console.log('  export CLAUDE_USE_SUBAGENTS=true       # Enable subagents');
-  console.log('  export CLAUDE_SUBAGENT_MODEL=haiku     # haiku/sonnet/opus');
-  console.log('  export CLAUDE_SUBAGENT_BATCH_SIZE=3    # Parallel per batch (default: 3)');
-  console.log('  # Example: 4 files, BATCH_SIZE=1 → 4 sequential batches');
-  console.log('  # Example: 4 files, BATCH_SIZE=3 → 2 batches (3 parallel + 1)');
+  console.log('\n💡 Configuration:');
+  console.log('  📁 All templates installed in .claude/');
+  console.log('  📝 Edit .claude/config.json to customize settings');
+  console.log('  🎯 Use presets: backend, frontend, fullstack, database, ai, default');
+  console.log('  🚀 Enable parallel analysis: set subagents.enabled = true');
+  console.log('\n📖 Example config.json:');
+  console.log('  {');
+  console.log('    "preset": "backend",');
+  console.log('    "subagents": { "enabled": true, "model": "haiku", "batchSize": 3 }');
+  console.log('  }');
   console.log('\nFor more options: claude-hooks --help');
 }
 
@@ -597,9 +630,6 @@ function updateGitignore() {
   const claudeEntries = [
     '# Claude Git Hooks',
     '.claude/',
-    'debug-claude-response.json',
-    'claude_resolution_prompt.md',
-    '.claude-pr-analysis.json',
   ];
 
   let gitignoreContent = '';
@@ -760,6 +790,9 @@ async function analyzeDiff(args) {
     return;
   }
 
+  // Load configuration
+  const config = await getConfig();
+
   const currentBranch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();
 
   if (!currentBranch) {
@@ -863,9 +896,9 @@ async function analyzeDiff(args) {
   }
 
   // Check if subagents should be used
-  const useSubagents = process.env.CLAUDE_USE_SUBAGENTS === 'true';
-  const subagentModel = process.env.CLAUDE_SUBAGENT_MODEL || 'haiku';
-  let subagentBatchSize = parseInt(process.env.CLAUDE_SUBAGENT_BATCH_SIZE || '3');
+  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;
@@ -874,37 +907,19 @@ async function analyzeDiff(args) {
     ? `\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`
     : '';
 
-  const prompt = `Analyze the following changes. CONTEXT: ${contextDescription}
-${subagentInstruction}
-Please generate:
-1. A concise and descriptive PR title (maximum 72 characters)
-2. A detailed PR description that includes:
-   - Summary of changes
-   - Motivation/context
-   - Type of change (feature/fix/refactor/docs/etc)
-   - Recommended testing
-3. A suggested branch name following the format: type/short-description (example: feature/add-user-auth, fix/memory-leak)
-
-IMPORTANT: If these are local changes without push, the suggested branch name should be for creating a new branch from the current one.
-
-Respond EXCLUSIVELY with a valid JSON with this structure:
-{
-  "prTitle": "Interesting PR title",
-  "prDescription": "detailed PR description with markdown",
-  "suggestedBranchName": "type/suggested-branch-name",
-  "changeType": "feature|fix|refactor|docs|test|chore",
-  "breakingChanges": false,
-  "testingNotes": "notes on necessary testing or 'None'"
-}
-
-=== COMMITS ===
-${commits}
-
-=== CHANGED FILES ===
-${diffFiles}
-
-=== FULL DIFF ===
-${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated diff)' : ''}`;
+  // 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();
@@ -965,7 +980,13 @@ ${fullDiff.substring(0, 50000)} ${fullDiff.length > 50000 ? '\n... (truncated di
       }
     };
 
-    const outputFile = '.claude-pr-analysis.json';
+    // 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;
@@ -1036,20 +1057,13 @@ function status() {
   const gitignorePath = '.gitignore';
   if (fs.existsSync(gitignorePath)) {
     const gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
-    const claudeIgnores = ['.claude/', 'debug-claude-response.json', '.claude-pr-analysis.json'];
-    let allPresent = true;
+    const claudeIgnore = '.claude/';
 
-    claudeIgnores.forEach(entry => {
-      const regex = new RegExp(`^${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`, 'm');
-      if (regex.test(gitignoreContent)) {
-        success(`${entry}: included`);
-      } else {
-        warning(`${entry}: missing`);
-        allPresent = false;
-      }
-    });
-
-    if (!allPresent) {
+    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 {
@@ -1057,43 +1071,24 @@ function status() {
   }
 }
 
-// Comando set-mode
-function setMode(mode) {
-  if (!checkGitRepo()) {
-    error('You are not in a Git repository.');
-  }
-}
-
-// Función para comparar versiones usando el script compartido
+// 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) {
-  try {
-    // Usar el script compartido para mantener consistencia
-    const result = execSync(`bash -c 'source "${getTemplatesPath()}/check-version.sh" && compare_versions "${v1}" "${v2}"; echo $?'`, { encoding: 'utf8' }).trim();
-    const exitCode = parseInt(result);
-
-    // Convertir los códigos de retorno del script bash a valores JS
-    if (exitCode === 0) return 0;      // iguales
-    if (exitCode === 1) return 1;      // v1 > v2  
-    if (exitCode === 2) return -1;     // v1 < v2
-
-    // Fallback: comparación simple si el script falla
-    if (v1 === v2) return 0;
-    const sorted = [v1, v2].sort((a, b) => {
-      const aParts = a.split('.').map(Number);
-      const bParts = b.split('.').map(Number);
-      for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
-        const aPart = aParts[i] || 0;
-        const bPart = bParts[i] || 0;
-        if (aPart !== bPart) return aPart - bPart;
-      }
-      return 0;
-    });
-    return v1 === sorted[1] ? 1 : -1;
-  } catch (e) {
-    // Si falla todo, usar comparación simple
-    if (v1 === v2) return 0;
-    return v1 > v2 ? 1 : -1;
+  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
@@ -1145,6 +1140,13 @@ async function update() {
   }
 }
 
+// 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(`
@@ -1162,6 +1164,10 @@ Commands:
   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
+  presets              List all available presets
+  --set-preset <name>  Set the active preset
+  preset current       Show the current active preset
+  --version, -v        Show the current version
   help                 Show this help
 
 Available hooks:
@@ -1176,6 +1182,9 @@ Examples:
   claude-hooks enable               # Enable all hooks
   claude-hooks status               # View current status
   claude-hooks analyze-diff main    # Analyze differences with main
+  claude-hooks presets              # List available presets
+  claude-hooks --set-preset backend # Set backend preset
+  claude-hooks preset current       # Show current preset
 
 Commit use cases:
   git commit -m "message"           # Manual message + blocking analysis
@@ -1186,31 +1195,165 @@ Commit use cases:
 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..." 
+    → PR Description: "## Summary\n- Added JWT authentication..."
     → Suggested branch: "feature/user-authentication"
 
-Exclude code from analysis:
-  // SKIP-ANALYSIS                  # Exclude the next line from analysis
-  // SKIP_ANALYSIS_BLOCK           # Exclude block until finding another equal one
-  ...excluded code...
-  // SKIP_ANALYSIS_BLOCK
-
-Performance optimization (NEW in v1.5.5):
-  export CLAUDE_USE_SUBAGENTS=true        # Enable parallel analysis for 3+ files
-  export CLAUDE_SUBAGENT_MODEL=haiku      # Model: haiku (fast), sonnet, opus
-  export CLAUDE_SUBAGENT_BATCH_SIZE=3     # Parallel subagents per batch (default: 3)
-
-  # Batching examples:
-  # BATCH_SIZE=1 with 4 files → 4 sequential batches (1 subagent each)
-  # BATCH_SIZE=3 with 4 files → 2 batches (3 parallel, then 1)
-  # BATCH_SIZE=4 with 4 files → 1 batch (4 parallel subagents)
+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 }
+  }
 
-  # Benefits: Faster for multi-file commits, shows execution time
+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
+
+Customization:
+  Override prompts by copying to .claude/:
+    cp templates/COMMIT_MESSAGE.md .claude/
+    cp templates/ANALYZE_DIFF.md .claude/
+    cp templates/CLAUDE_PRE_COMMIT_SONAR.md .claude/
+    # Edit as needed - system uses .claude/ version if exists
 
 More information: https://github.com/pablorovito/claude-git-hooks
 `);
 }
 
+// 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
+ */
+async function setPreset(presetName) {
+  if (!presetName) {
+    error('Please specify a preset name: claude-hooks --set-preset <name>');
+    return;
+  }
+
+  try {
+    // Verify preset exists
+    const presets = await listPresets();
+    const preset = presets.find(p => p.name === presetName);
+
+    if (!preset) {
+      error(`Preset "${presetName}" not found`);
+      info('Available presets:');
+      presets.forEach(p => console.log(`  - ${p.name}`));
+      process.exit(1);
+    }
+
+    // Update .claude/config.json
+    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 preset
+    config.preset = presetName;
+
+    // Save config
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+    success(`Preset '${preset.displayName}' activated`);
+    info(`Configuration saved to ${configPath}`);
+  } catch (err) {
+    error(`Failed to set preset: ${err.message}`);
+  }
+}
+
+/**
+ * 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}`);
+  }
+}
+
 // Main
 async function main() {
   const args = process.argv.slice(2);
@@ -1238,6 +1381,25 @@ async function main() {
     case 'analyze-diff':
       await analyzeDiff(args.slice(1));
       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 '--version':
+    case '-v':
+    case 'version':
+      showVersion();
+      break;
     case 'help':
     case '--help':
     case '-h':