claude-git-hooks 2.6.1 → 2.6.2

package/CHANGELOG.md

@@ -5,6 +5,28 @@ Todos los cambios notables en este proyecto se documentarán en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.2] - 2025-12-12
+
+### 🐛 Fixed
+
+- **Parallel analysis stdin error handling** - Added graceful error handling for EOF errors during parallel execution (#43)
+    - **What was broken**: Unhandled 'error' events on stdin stream when Claude CLI process terminates unexpectedly during parallel analysis
+    - **Root cause**: `stdin.write()` failures emit asynchronous 'error' events that weren't being caught, causing uncaught exceptions with large prompts (18+ files) in parallel mode
+    - **Fix**: Added explicit error handler on `stdin` stream before writing prompt
+    - **Files changed**:
+        - `lib/utils/claude-client.js:287-308` - Added stdin error handler with detailed diagnostics
+    - **Impact**:
+        - Provides clear error message: "Failed to write to Claude stdin - process terminated unexpectedly"
+        - Logs diagnostic info: prompt length, error code, duration
+        - Suggests actionable fix: "Try reducing batch size or number of files per commit"
+    - **Compatibility**: No breaking changes, improves error reporting for all platforms
+
+### 🎯 User Experience
+
+- **Before**: Cryptic unhandled 'write EOF' exceptions crashed commit process with no actionable information
+- **After**: Clear error message with diagnostic context and suggested remediation
+- **Debug**: Added structured logging with prompt length and timing when EOF errors occur
+
 ## [2.6.1] - 2025-12-04
 
 ### 🐛 Fixed

package/lib/utils/claude-client.js

@@ -280,13 +280,40 @@ const executeClaude = (prompt, { timeout = 120000, allowedTools = [] } = {}) =>
 
     // Write prompt to stdin
     // Why: Claude CLI reads prompt from stdin, not command arguments
+
+    // Handle stdin errors (e.g., EOF when process terminates unexpectedly)
+    // Why: write() failures can emit 'error' events asynchronously
+    // Common in parallel execution with large prompts
+    claude.stdin.on('error', (error) => {
+        logger.error(
+            'claude-client - executeClaude',
+            'stdin stream error (process may have terminated early)',
+            {
+                error: error.message,
+                code: error.code,
+                promptLength: prompt.length,
+                duration: Date.now() - startTime
+            }
+        );
+
+        reject(new ClaudeClientError('Failed to write to Claude stdin - process terminated unexpectedly', {
+            cause: error,
+            context: {
+                promptLength: prompt.length,
+                errorCode: error.code,
+                errorMessage: error.message,
+                suggestion: 'Try reducing batch size or number of files per commit'
+            }
+        }));
+    });
+
     try {
         claude.stdin.write(prompt);
         claude.stdin.end();
     } catch (error) {
         logger.error(
             'claude-client - executeClaude',
-            'Failed to write prompt to Claude CLI stdin',
+            'Failed to write prompt to Claude CLI stdin (synchronous error)',
             error
         );
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-git-hooks",
-    "version": "2.6.1",
+    "version": "2.6.2",
     "description": "Git hooks with Claude CLI for code analysis and automatic commit messages",
     "type": "module",
     "bin": {