@link-assistant/hive-mind 1.11.0 → 1.11.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @link-assistant/hive-mind
 
+## 1.11.2
+
+### Patch Changes
+
+- 8ee116a: fix: detect "command not found" errors to prevent false success
+
+  When the `claude` CLI command is not found (not installed or not in PATH), the tool was incorrectly reporting "Claude command completed" instead of detecting the failure. This fix adds "not found" to the stderr error detection pattern to properly detect when commands fail to start.
+
+## 1.11.1
+
+### Patch Changes
+
+- de2cc28: Use .gitkeep by default for --tool agent/opencode/codex instead of CLAUDE.md
+
+  When using non-Claude tools (agent, opencode, codex), the system now defaults to creating a `.gitkeep` file for task details instead of `CLAUDE.md`. This prevents pollution of CLAUDE.md, which has special meaning for Claude Code as a project-level instruction file.
+
+  **Tool-Specific Defaults:**
+  - `--tool claude`: defaults to `--claude-file` (existing behavior)
+  - `--tool agent/opencode/codex`: defaults to `--gitkeep-file`
+
+  Users can still explicitly override defaults with `--claude-file` or `--gitkeep-file` flags regardless of the selected tool.
+
 ## 1.11.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/claude.lib.mjs

@@ -1095,7 +1095,9 @@ export const executeClaudeCommand = async params => {
             // Example: "⚠️  [BashTool] Pre-flight check is taking longer than expected. Run with ANTHROPIC_LOG=debug to check for failed or slow API requests."
             // Even though this contains the word "failed", it's a warning, not an error
             const isWarning = trimmed.startsWith('⚠️') || trimmed.startsWith('⚠');
-            if (trimmed && !isWarning && (trimmed.includes('Error:') || trimmed.includes('error') || trimmed.includes('failed'))) {
+            // Issue #1165: Also detect "command not found" errors (e.g., "/bin/sh: 1: claude: not found")
+            // These indicate the Claude CLI is not installed or not in PATH
+            if (trimmed && !isWarning && (trimmed.includes('Error:') || trimmed.includes('error') || trimmed.includes('failed') || trimmed.includes('not found'))) {
               stderrErrors.push(trimmed);
             }
           }
@@ -1108,6 +1110,23 @@ export const executeClaudeCommand = async params => {
         }
       }
 
+      // Issue #1165: Check actual exit code from command result for more reliable detection
+      // The .stream() method may not emit 'exit' chunks, but the command object still tracks the exit code
+      // Exit code 127 is the standard Unix convention for "command not found"
+      if (execCommand.result && typeof execCommand.result.code === 'number') {
+        const resultExitCode = execCommand.result.code;
+        if (exitCode === 0 && resultExitCode !== 0) {
+          exitCode = resultExitCode;
+          await log(`⚠️ Updated exit code from command result: ${resultExitCode}`, { verbose: true });
+        }
+        // Specifically detect "command not found" via exit code 127
+        if (resultExitCode === 127 && !commandFailed) {
+          commandFailed = true;
+          await log(`\n❌ Command not found (exit code 127) - "${claudePath}" is not installed or not in PATH`, { level: 'error' });
+          await log('   Please ensure Claude CLI is installed: npm install -g @anthropic-ai/claude-code', { level: 'error' });
+        }
+      }
+
       // Flush any remaining queued comments from interactive mode
       if (interactiveHandler) {
         try {

package/src/solve.config.lib.mjs

@@ -130,12 +130,12 @@ export const createYargsConfig = yargsInstance => {
       })
       .option('claude-file', {
         type: 'boolean',
-        description: 'Create CLAUDE.md file for task details (default, mutually exclusive with --gitkeep-file)',
+        description: 'Create CLAUDE.md file for task details (default for --tool claude, mutually exclusive with --gitkeep-file)',
         default: true,
       })
       .option('gitkeep-file', {
         type: 'boolean',
-        description: 'Create .gitkeep file instead of CLAUDE.md (mutually exclusive with --claude-file)',
+        description: 'Create .gitkeep file instead of CLAUDE.md (default for --tool agent/opencode/codex, mutually exclusive with --claude-file)',
         default: false,
       })
       .option('auto-gitkeep-file', {
@@ -477,6 +477,20 @@ export const parseArguments = async (yargs, hideBin) => {
     argv.model = 'grok-code';
   }
 
+  // Tool-specific defaults for --claude-file and --gitkeep-file
+  // For non-Claude tools, use .gitkeep by default to avoid polluting CLAUDE.md
+  // (CLAUDE.md has special meaning for Claude Code as a project-level instruction file)
+  // See: https://github.com/link-assistant/hive-mind/issues/1158
+  const claudeFileExplicitlyProvided = rawArgs.includes('--claude-file') || rawArgs.includes('--no-claude-file');
+  const gitkeepFileExplicitlyProvided = rawArgs.includes('--gitkeep-file') || rawArgs.includes('--no-gitkeep-file');
+
+  if (argv.tool !== 'claude' && !claudeFileExplicitlyProvided && !gitkeepFileExplicitlyProvided) {
+    // User did not explicitly provide either option, so use the correct defaults for non-Claude tools
+    // Non-Claude tools (agent, opencode, codex) should use .gitkeep by default
+    argv.claudeFile = false;
+    argv.gitkeepFile = true;
+  }
+
   // Validate mutual exclusivity of --claude-file and --gitkeep-file
   // Check if both are explicitly enabled (user passed both --claude-file and --gitkeep-file)
   if (argv.claudeFile && argv.gitkeepFile) {