claude-evolve 1.8.19 → 1.8.21

package/bin/claude-evolve-ideate

@@ -36,6 +36,24 @@ if [[ -n "${FULL_EVOLUTION_DIR:-}" ]]; then
   echo "[IDEATE-$$] Logging to: $LOG_FILE"
 fi
 
+# AIDEV-NOTE: Directory restoration helper to prevent working directory corruption
+# Critical for preventing the bug where Ctrl+C during ideation leaves the shell in wrong directory
+# Helper to safely change directory with automatic restoration
+safe_pushd() {
+  SAFE_PUSHD_ORIGINAL_PWD=$(pwd)
+  cd "$1" || return 1
+  # Set trap to restore directory on any exit, error, or interrupt
+  trap 'cd "$SAFE_PUSHD_ORIGINAL_PWD" 2>/dev/null || true' EXIT INT TERM ERR
+}
+
+safe_popd() {
+  if [[ -n "${SAFE_PUSHD_ORIGINAL_PWD:-}" ]]; then
+    cd "$SAFE_PUSHD_ORIGINAL_PWD" || true
+    # Clear the trap since we're explicitly returning
+    trap - EXIT INT TERM ERR
+  fi
+}
+
 # Helper function to call AI with limit check
 call_ai_with_limit_check() {
   local prompt="$1"
@@ -1104,12 +1122,15 @@ CRITICAL: Do NOT use any git commands (git add, git commit, git reset, etc.). On
 
   # Debug prompt size and context (removed - no longer needed)
 
-  # Change to evolution directory so AI can access files
-  local original_pwd=$(pwd)
-  cd "$FULL_EVOLUTION_DIR"
-  
+  # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+  safe_pushd "$FULL_EVOLUTION_DIR" || {
+    echo "[ERROR] Failed to change to evolution directory" >&2
+    rm -f "$temp_csv"
+    return 1
+  }
+
   # Debug: Show files in evolution directory
-  
+
   # Get AI to directly edit the CSV file
   local ai_response
   local stderr_file="stderr-$$.txt"
@@ -1117,14 +1138,14 @@ CRITICAL: Do NOT use any git commands (git add, git commit, git reset, etc.). On
   if ! ai_response=$(call_ai_for_ideation "$prompt" "$CURRENT_GENERATION" "$count" "$temp_csv_basename"); then
     echo "[ERROR] All AI models failed to generate novel ideas" >&2
     cat "$stderr_file" >&2
-    cd "$original_pwd"
+    safe_popd
     rm -f "$temp_csv" "$stderr_file"
     return 1
   fi
   rm -f "$stderr_file"
-  
+
   # Restore working directory
-  cd "$original_pwd"
+  safe_popd
 
   # Validate that the CSV file was actually modified with correct IDs
   # Pass original_csv_lines to prevent race conditions
@@ -1255,10 +1276,13 @@ CRITICAL INSTRUCTIONS:
 8. CRITICAL: When editing, preserve the CSV formatting with proper quoting
 9. DO NOT use any git commands (git add, git commit, git reset, etc.). Only modify the file directly."
 
-  # Change to evolution directory so AI can access files
-  local original_pwd=$(pwd)
-  cd "$FULL_EVOLUTION_DIR"
-  
+  # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+  safe_pushd "$FULL_EVOLUTION_DIR" || {
+    echo "[ERROR] Failed to change to evolution directory" >&2
+    rm -f "$temp_csv"
+    return 1
+  }
+
   # Get AI to directly edit the CSV file
   local ai_response
   local stderr_file="stderr-$$.txt"
@@ -1266,14 +1290,14 @@ CRITICAL INSTRUCTIONS:
   if ! ai_response=$(call_ai_for_ideation "$prompt" "$CURRENT_GENERATION" "$count" "$temp_csv_basename"); then
     echo "[ERROR] All AI models failed to generate hill climbing ideas" >&2
     cat "$stderr_file" >&2
-    cd "$original_pwd"
+    safe_popd
     rm -f "$temp_csv" "$stderr_file"
     return 1
   fi
   rm -f "$stderr_file"
-  
+
   # Restore working directory
-  cd "$original_pwd"
+  safe_popd
 
   # Validate that the CSV file was actually modified with correct IDs
   # Pass original_csv_lines to prevent race conditions
@@ -1394,10 +1418,13 @@ CRITICAL INSTRUCTIONS:
 8. CRITICAL: When editing, preserve the CSV formatting with proper quoting
 9. DO NOT use any git commands (git add, git commit, git reset, etc.). Only modify the file directly."
 
-  # Change to evolution directory so AI can access files
-  local original_pwd=$(pwd)
-  cd "$FULL_EVOLUTION_DIR"
-  
+  # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+  safe_pushd "$FULL_EVOLUTION_DIR" || {
+    echo "[ERROR] Failed to change to evolution directory" >&2
+    rm -f "$temp_csv"
+    return 1
+  }
+
   # Get AI to directly edit the CSV file
   local ai_response
   local stderr_file="stderr-$$.txt"
@@ -1405,14 +1432,14 @@ CRITICAL INSTRUCTIONS:
   if ! ai_response=$(call_ai_for_ideation "$prompt" "$CURRENT_GENERATION" "$count" "$temp_csv_basename"); then
     echo "[ERROR] All AI models failed to generate structural mutation ideas" >&2
     cat "$stderr_file" >&2
-    cd "$original_pwd"
+    safe_popd
     rm -f "$temp_csv" "$stderr_file"
     return 1
   fi
   rm -f "$stderr_file"
-  
+
   # Restore working directory
-  cd "$original_pwd"
+  safe_popd
 
   # Validate that the CSV file was actually modified with correct IDs
   # Pass original_csv_lines to prevent race conditions
@@ -1533,10 +1560,13 @@ CRITICAL INSTRUCTIONS:
 8. CRITICAL: When editing, preserve the CSV formatting with proper quoting
 9. DO NOT use any git commands (git add, git commit, git reset, etc.). Only modify the file directly."
 
-  # Change to evolution directory so AI can access files
-  local original_pwd=$(pwd)
-  cd "$FULL_EVOLUTION_DIR"
-  
+  # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+  safe_pushd "$FULL_EVOLUTION_DIR" || {
+    echo "[ERROR] Failed to change to evolution directory" >&2
+    rm -f "$temp_csv"
+    return 1
+  }
+
   # Get AI to directly edit the CSV file
   local ai_response
   local stderr_file="stderr-$$.txt"
@@ -1544,14 +1574,14 @@ CRITICAL INSTRUCTIONS:
   if ! ai_response=$(call_ai_for_ideation "$prompt" "$CURRENT_GENERATION" "$count" "$temp_csv_basename"); then
     echo "[ERROR] All AI models failed to generate crossover hybrid ideas" >&2
     cat "$stderr_file" >&2
-    cd "$original_pwd"
+    safe_popd
     rm -f "$temp_csv" "$stderr_file"
     return 1
   fi
   rm -f "$stderr_file"
-  
+
   # Restore working directory
-  cd "$original_pwd"
+  safe_popd
 
   # Validate that the CSV file was actually modified with correct IDs
   # Pass original_csv_lines to prevent race conditions
@@ -1650,24 +1680,27 @@ IMPORTANT: You must APPEND new rows to the existing CSV file. DO NOT replace the
 CRITICAL: You must use your file editing tools (Edit/MultiEdit) to modify the CSV file. DO NOT return CSV text - use your tools to edit the file directly.
 CRITICAL: Do NOT use any git commands (git add, git commit, git reset, etc.). Only modify the file directly."
 
-  # Change to evolution directory so AI can access files
-  local original_pwd=$(pwd)
-  cd "$FULL_EVOLUTION_DIR"
-  
+  # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+  safe_pushd "$FULL_EVOLUTION_DIR" || {
+    echo "[ERROR] Failed to change to evolution directory" >&2
+    rm -f "$temp_csv"
+    return 1
+  }
+
   # Get AI to directly edit the CSV file
   local ai_response
   local stderr_file="stderr-$$.txt"
   if ! ai_response=$(call_ai_for_ideation "$prompt" "$CURRENT_GENERATION" "$TOTAL_IDEAS" "$temp_csv_basename" 2>"$stderr_file"); then
     echo "[ERROR] All AI models failed to generate ideas" >&2
     cat "$stderr_file" >&2
-    cd "$original_pwd"
+    safe_popd
     rm -f "$temp_csv" "$stderr_file"
     return 1
   fi
   rm -f "$stderr_file"
-  
+
   # Restore working directory
-  cd "$original_pwd"
+  safe_popd
 
   # Validate that the CSV file was actually modified
   # Pass original_csv_lines to prevent race conditions

package/bin/claude-evolve-run

@@ -646,8 +646,8 @@ except Exception as e:
   if [[ $pending_count -eq 0 && $active_workers -eq 0 ]]; then
     echo "[DISPATCHER] No pending candidates found."
 
-    # Before blocking, do final check for stuck work (immediate, not periodic)
-    echo "[DISPATCHER] Performing final verification for stuck candidates..."
+    # Before triggering ideation, do final check AND RESET stuck work (immediate, not periodic)
+    echo "[DISPATCHER] Performing final verification and cleanup for stuck candidates..."
     stuck_work_count=$("$PYTHON_CMD" -c "
 import sys
 sys.path.insert(0, '$SCRIPT_DIR/..')
@@ -655,18 +655,25 @@ from lib.evolution_csv import EvolutionCSV
 
 try:
     with EvolutionCSV('$FULL_CSV_PATH') as csv:
+        # First count stuck candidates
         stuck = csv.count_stuck_candidates()
+
+        # If any found, reset them immediately
+        if stuck > 0:
+            print(f'[DISPATCHER] Found {stuck} stuck candidates, resetting to pending...', file=sys.stderr)
+            reset_count = csv.reset_stuck_candidates()
+            print(f'[DISPATCHER] Reset {reset_count} stuck candidates to pending', file=sys.stderr)
+
         print(stuck)
 except Exception as e:
-    print(f'[ERROR] Failed to count stuck candidates: {e}', file=sys.stderr)
+    print(f'[ERROR] Failed to check/reset stuck candidates: {e}', file=sys.stderr)
     print('0')  # Default to 0 on error
 " 2>/dev/null || echo "0")
 
     if [[ $stuck_work_count -gt 0 ]]; then
-      echo "[DISPATCHER] Found $stuck_work_count stuck candidates - running cleanup cycle..."
-      # Force immediate cleanup
-      loop_iteration=$((last_stuck_check + 5))
-      continue  # Go back to top of loop to trigger cleanup
+      echo "[DISPATCHER] Reset $stuck_work_count stuck candidates to pending"
+      # Don't trigger ideation - go back to check pending count again
+      continue  # Go back to top of loop to re-count pending
     fi
 
     # Check if auto ideation is enabled

package/bin/claude-evolve-worker

@@ -18,6 +18,24 @@ if [[ -n "${FULL_EVOLUTION_DIR:-}" ]]; then
   echo "[WORKER-$$] Logging to: $LOG_FILE"
 fi
 
+# AIDEV-NOTE: Directory restoration helper to prevent working directory corruption
+# Critical for preventing the bug where Ctrl+C during worker leaves the shell in wrong directory
+# Helper to safely change directory with automatic restoration
+safe_pushd() {
+  SAFE_PUSHD_ORIGINAL_PWD=$(pwd)
+  cd "$1" || return 1
+  # Set trap to restore directory on any exit, error, or interrupt
+  trap 'cd "$SAFE_PUSHD_ORIGINAL_PWD" 2>/dev/null || true' EXIT INT TERM ERR
+}
+
+safe_popd() {
+  if [[ -n "${SAFE_PUSHD_ORIGINAL_PWD:-}" ]]; then
+    cd "$SAFE_PUSHD_ORIGINAL_PWD" || true
+    # Clear the trap since we're explicitly returning
+    trap - EXIT INT TERM ERR
+  fi
+}
+
 # Track current candidate for cleanup
 CURRENT_CANDIDATE_ID=""
 TERMINATION_SIGNAL=""
@@ -343,23 +361,26 @@ This is especially important for models with smaller context windows (like GLM).
 CRITICAL: If you do not know how to implement what was asked for, or if the requested change is unclear or not feasible, you MUST refuse to make any changes. DO NOT modify the code if you are uncertain about the implementation. Simply respond that you cannot implement the requested change and explain why. It is better to refuse than to make incorrect or random changes.
 
 CRITICAL: Do NOT use any git commands (git add, git commit, git reset, etc.). Only modify the file directly."
-    
+
     if [[ "$is_baseline" != "true" ]]; then
-      # Change to evolution directory so AI can access files
-      local original_pwd=$(pwd)
-      cd "$FULL_EVOLUTION_DIR"
-      
+      # Change to evolution directory so AI can access files (with safe restoration on interrupt)
+      safe_pushd "$FULL_EVOLUTION_DIR" || {
+        echo "[WORKER-$$] ERROR: Failed to change to evolution directory" >&2
+        rm -f "$target_file"
+        return 1
+      }
+
       # Try AI models with round-robin based on candidate ID
       if ! call_ai_for_evolution "$evolution_prompt" "$candidate_id"; then
         echo "[WORKER-$$] ERROR: All AI models failed to generate code - leaving as pending for retry" >&2
-        cd "$original_pwd"
+        safe_popd
         rm -f "$target_file"  # Clean up on failure
         # Return with special code to indicate AI failure (should remain pending)
         return 77
       fi
-      
+
       # Restore working directory
-      cd "$original_pwd"
+      safe_popd
       
       echo "[WORKER-$$] Evolution applied successfully"
       

package/lib/ai-cli.sh

@@ -1,5 +1,13 @@
 #!/bin/bash
 # Centralized AI CLI invocation library for claude-evolve
+#
+# AIDEV-NOTE: All timeout commands use -k flag to ensure process termination
+# The -k flag sends SIGKILL if the process doesn't respond to SIGTERM within
+# the grace period (30 seconds). This prevents AI CLI processes from hanging
+# indefinitely when they ignore the initial SIGTERM signal.
+# Example: timeout -k 30 600 means:
+#   - Wait 600 seconds, then send SIGTERM
+#   - If still running after 30 more seconds, send SIGKILL (force kill)
 
 # Source config to get LLM_CLI array and model lists
 # This will be sourced after config.sh in the main scripts
@@ -19,12 +27,12 @@ call_ai_model_configured() {
   case "$model_name" in
     opus)
       local ai_output
-      ai_output=$(timeout 300 claude --dangerously-skip-permissions --mcp-config '' --model opus -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 300 claude --dangerously-skip-permissions --mcp-config '' --model opus -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     sonnet)
       local ai_output
-      ai_output=$(timeout 300 claude --dangerously-skip-permissions --mcp-config '' --model sonnet -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 300 claude --dangerously-skip-permissions --mcp-config '' --model sonnet -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     sonnet-think)
@@ -33,7 +41,7 @@ call_ai_model_configured() {
       local think_prompt="ultrathink
 
 $prompt"
-      ai_output=$(timeout 600 claude --dangerously-skip-permissions --mcp-config '' --model sonnet -p "$think_prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 claude --dangerously-skip-permissions --mcp-config '' --model sonnet -p "$think_prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     opus-think)
@@ -42,97 +50,103 @@ $prompt"
       local think_prompt="ultrathink
 
 $prompt"
-      ai_output=$(timeout 600 claude --dangerously-skip-permissions --mcp-config '' --model opus -p "$think_prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 claude --dangerously-skip-permissions --mcp-config '' --model opus -p "$think_prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     haiku)
       local ai_output
-      ai_output=$(timeout 300 claude --dangerously-skip-permissions --mcp-config '' --model haiku -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 300 claude --dangerously-skip-permissions --mcp-config '' --model haiku -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     gpt5high)
       local ai_output
-      ai_output=$(timeout 600 codex exec -m gpt-5 -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 codex exec -m gpt-5 -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     gpt5)
       local ai_output
-      ai_output=$(timeout 600 codex exec -m gpt-5 --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 codex exec -m gpt-5 --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     o3high)
       local ai_output
-      ai_output=$(timeout 600 codex exec -m o3-mini -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 codex exec -m o3-mini -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     gemini-pro)
       local ai_output
       # Gemini needs longer timeout as it streams output while working (20 minutes)
-      ai_output=$(timeout 1800 gemini -y -m gemini-2.5-pro -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 1800 gemini -y -m gemini-2.5-pro -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     gemini-flash)
       local ai_output
       # Gemini needs longer timeout as it streams output while working (20 minutes)
-      ai_output=$(timeout 1200 gemini -y -m gemini-2.5-flash -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 1200 gemini -y -m gemini-2.5-flash -p "$prompt" 2>&1)
+      local ai_exit_code=$?
+      ;;
+    gemini-3-pro-preview)
+      local ai_output
+      # Gemini v3 Pro Preview via OpenRouter (30 minute timeout)
+      ai_output=$(timeout -k 30 1800 opencode -m openrouter/google/gemini-3-pro-preview run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     cursor-sonnet)
       local ai_output
-      ai_output=$(timeout 600 cursor-agent sonnet-4.5 -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 cursor-agent sonnet-4.5 -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     cursor-opus)
       local ai_output
-      ai_output=$(timeout 600 cursor-agent opus -p "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 cursor-agent opus -p "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     glm-openrouter)
       local ai_output
-      ai_output=$(timeout 600 opencode -m openrouter/z-ai/glm-4.6 run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m openrouter/z-ai/glm-4.6 run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     glm-zai)
       # GLM -- can be slow sometimes
       local ai_output
-      ai_output=$(timeout 1800 opencode -m zai-coding-plan/glm-4.6 run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 1800 opencode -m zai-coding-plan/glm-4.6 run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     deepseek-openrouter)
       local ai_output
-      ai_output=$(timeout 600 opencode -m openrouter/deepseek/deepseek-v3.1-terminus run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m openrouter/deepseek/deepseek-v3.1-terminus run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     grok-code-fast-openrouter)
       local ai_output
-      ai_output=$(timeout 600 opencode -m openrouter/x-ai/grok-code-fast-1 run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m openrouter/x-ai/grok-code-fast-1 run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     grok-4-openrouter)
       local ai_output
-      ai_output=$(timeout 600 opencode -m openrouter/x-ai/grok-4 run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m openrouter/x-ai/grok-4 run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     opus-openrouter)
       local ai_output
-      ai_output=$(timeout 600 opencode -m openrouter/anthropic/claude-opus-4.1 run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m openrouter/anthropic/claude-opus-4.1 run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     kimi-k2-think-moonshot)
       local ai_output
-      ai_output=$(timeout 600 opencode -m moonshotai/kimi-k2-thinking run "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 opencode -m moonshotai/kimi-k2-thinking run "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     codex-oss-local)
       # Codex-OSS via Codex CLI with Ollama backend
       local ai_output
-      ai_output=$(timeout 2400 codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 2400 codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
     deepseek-v3-llamacloud)
       # Deepseek via Codex CLI with Ollama cloud backend
       local ai_output
-      ai_output=$(timeout 600 codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss -m deepseek-v3.1:671b-cloud "$prompt" 2>&1)
+      ai_output=$(timeout -k 30 600 codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss -m deepseek-v3.1:671b-cloud "$prompt" 2>&1)
       local ai_exit_code=$?
       ;;
   esac

package/lib/config.sh

@@ -58,9 +58,9 @@ DEFAULT_MEMORY_LIMIT_MB=12288
 DEFAULT_WORKER_MAX_CANDIDATES=3
 
 # Default LLM CLI configuration
-DEFAULT_LLM_RUN="glm-zai glm-zai glm-zai glm-zai glm-zai codex-oss-local gemini-flash haiku"
+DEFAULT_LLM_RUN="glm-zai glm-zai glm-zai glm-zai glm-zai codex-oss-local haiku"
 # Ideate: Commercial models for idea generation + local fallback
-DEFAULT_LLM_IDEATE="opus-openrouter kimi-k2-think-moonshot gemini-pro sonnet-think gpt5high grok-4-openrouter deepseek-openrouter glm-zai"
+DEFAULT_LLM_IDEATE="opus-openrouter kimi-k2-think-moonshot gemini-3-pro-preview sonnet-think gpt5high grok-4-openrouter deepseek-openrouter glm-zai"
 
 # Load configuration from a YAML file and update variables
 _load_yaml_config() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-evolve",
-  "version": "1.8.19",
+  "version": "1.8.21",
   "bin": {
     "claude-evolve": "./bin/claude-evolve",
     "claude-evolve-main": "./bin/claude-evolve-main",

package/lib/config.sh.backup

@@ -1,337 +0,0 @@
-#!/bin/bash
-# Configuration loader for claude-evolve
-
-# Default configuration values
-DEFAULT_EVOLUTION_DIR="evolution"
-DEFAULT_ALGORITHM_FILE="algorithm.py"
-DEFAULT_EVALUATOR_FILE="evaluator.py"
-DEFAULT_BRIEF_FILE="BRIEF.md"
-DEFAULT_EVOLUTION_CSV="evolution.csv"
-DEFAULT_OUTPUT_DIR=""
-DEFAULT_PARENT_SELECTION="best"
-# Detect Python command based on platform
-detect_python_cmd() {
-  # Try python3 first (macOS, Linux)
-  if command -v python3 >/dev/null 2>&1; then
-    echo "python3"
-  # Try python (Windows, some Linux)
-  elif command -v python >/dev/null 2>&1; then
-    # Verify it's Python 3
-    if python -c "import sys; sys.exit(0 if sys.version_info[0] >= 3 else 1)" 2>/dev/null; then
-      echo "python"
-    else
-      echo "python3"  # Fallback
-    fi
-  else
-    echo "python3"  # Default fallback
-  fi
-}
-
-DEFAULT_PYTHON_CMD="$(detect_python_cmd)"
-
-# Default ideation strategy values
-DEFAULT_TOTAL_IDEAS=15
-DEFAULT_NOVEL_EXPLORATION=3
-DEFAULT_HILL_CLIMBING=5
-DEFAULT_STRUCTURAL_MUTATION=3
-DEFAULT_CROSSOVER_HYBRID=4
-DEFAULT_NUM_ELITES=3
-DEFAULT_NUM_REVOLUTION=2  # Number of top novel candidates to include
-
-# Default parallel execution values
-DEFAULT_PARALLEL_ENABLED=false
-DEFAULT_MAX_WORKERS=4
-DEFAULT_LOCK_TIMEOUT=10
-
-# Default auto ideation value
-DEFAULT_AUTO_IDEATE=true
-
-# Default retry value
-DEFAULT_MAX_RETRIES=3
-
-# Default memory limit (in MB, 0 means no limit)
-# Set to reasonable limit for ML workloads - about half of available system RAM
-DEFAULT_MEMORY_LIMIT_MB=12288
-
-# Default LLM CLI configuration - use simple variables instead of arrays
-# Run: 100% local with qwen3 via Codex+Ollama (more reliable than aider)
-DEFAULT_LLM_RUN="codex-qwen3 codex-oss gemini-flash"
-# Ideate: Commercial models for idea generation + local fallback
-DEFAULT_LLM_IDEATE="gemini sonnet-think gpt5high glm grok-4 codex-qwen3 codex-oss"
-
-# Load configuration from a YAML file and update variables
-_load_yaml_config() {
-  local config_file="$1"
-  if [[ ! -f "$config_file" ]]; then
-    return 0 # File does not exist, nothing to load
-  fi
-
-  echo "[DEBUG] Loading configuration from: $config_file" >&2
-
-  local in_ideation_section=false
-  local in_parallel_section=false
-  local in_llm_cli_section=false
-  local llm_cli_subsection=""
-
-  while IFS='' read -r line; do
-    [[ $line =~ ^[[:space:]]*# ]] || [[ -z $line ]] && continue
-
-    if [[ ! $line =~ ^([^:]+):(.*)$ ]]; then
-      continue
-    fi
-    local key="${BASH_REMATCH[1]}"
-    local value="${BASH_REMATCH[2]}"
-
-    local is_indented=false
-    [[ $key =~ ^[[:space:]]+ ]] && is_indented=true
-
-    key=$(echo "$key" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-    value=$(echo "$value" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-    if [[ "${DEBUG_CONFIG:-}" == "true" ]]; then
-      echo "[CONFIG DEBUG] Before comment removal: key='$key' value='$value'" >&2
-    fi
-
-    value=$(echo "$value" | sed 's/[[:space:]]*#.*$//')
-    value=$(echo "$value" | sed 's/^"//;s/"$//')
-
-    if [[ $key == "ideation_strategies" ]]; then
-      in_ideation_section=true
-      in_parallel_section=false
-      in_llm_cli_section=false
-      continue
-    elif [[ $key == "parallel" ]]; then
-      in_parallel_section=true
-      in_ideation_section=false
-      in_llm_cli_section=false
-      continue
-    elif [[ $key == "llm_cli" ]]; then
-      in_llm_cli_section=true
-      in_ideation_section=false
-      in_parallel_section=false
-      llm_cli_subsection=""
-      continue
-    elif [[ $is_indented == false ]] && [[ $in_ideation_section == true || $in_parallel_section == true || $in_llm_cli_section == true ]]; then
-      in_ideation_section=false
-      in_parallel_section=false
-      in_llm_cli_section=false
-      llm_cli_subsection=""
-    fi
-
-    if [[ $in_ideation_section == true ]]; then
-      case $key in
-        total_ideas) TOTAL_IDEAS="$value" ;;
-        novel_exploration) NOVEL_EXPLORATION="$value" ;;
-        hill_climbing) HILL_CLIMBING="$value" ;;
-        structural_mutation) STRUCTURAL_MUTATION="$value" ;;
-        crossover_hybrid) CROSSOVER_HYBRID="$value" ;;
-        num_elites) NUM_ELITES="$value" ;;
-        num_revolution) NUM_REVOLUTION="$value" ;;
-      esac
-    elif [[ $in_parallel_section == true ]]; then
-      case $key in
-        enabled) PARALLEL_ENABLED="$value" ;;
-        max_workers) MAX_WORKERS="$value" ;;
-        lock_timeout) LOCK_TIMEOUT="$value" ;;
-      esac
-    elif [[ $in_llm_cli_section == true ]]; then
-      if [[ $key == "run" || $key == "ideate" ]]; then
-        case $key in
-          run) LLM_RUN="$value" ;;
-          ideate) LLM_IDEATE="$value" ;;
-        esac
-      else
-        value=$(echo "$value" | sed "s/^'//;s/'$//")
-        local var_key=$(echo "$key" | sed 's/-/_/g')
-        if [[ "${DEBUG_CONFIG:-}" == "true" ]]; then
-          echo "[CONFIG DEBUG] Setting LLM_CLI_${var_key} = '$value'" >&2
-        fi
-        eval "LLM_CLI_${var_key}=\"$value\""
-      fi
-    else
-      case $key in
-        algorithm_file) ALGORITHM_FILE="$value" ;;
-        evaluator_file) EVALUATOR_FILE="$value" ;;
-        brief_file) BRIEF_FILE="$value" ;;
-        evolution_csv) EVOLUTION_CSV="$value" ;;
-        output_dir) OUTPUT_DIR="$value" ;;
-        parent_selection) PARENT_SELECTION="$value" ;;
-        python_cmd) PYTHON_CMD="$value" ;;
-        auto_ideate) AUTO_IDEATE="$value" ;;
-        max_retries) MAX_RETRIES="$value" ;;
-        memory_limit_mb) MEMORY_LIMIT_MB="$value" ;;
-        evolution_dir):
-          echo "[WARN] evolution_dir in config is ignored - automatically inferred from config file location" >&2
-          ;;
-      esac
-    fi
-  done < "$config_file"
-  # Keep track of the last config file loaded to infer evolution_dir
-  LAST_CONFIG_FILE_LOADED="$config_file"
-}
-
-load_config() {
-  echo "[DEBUG] $1 at start of load_config: '$1'" >&2
-  echo "[DEBUG] DEFAULT_EVOLUTION_DIR: $DEFAULT_EVOLUTION_DIR" >&2
-  # Set defaults first
-  EVOLUTION_DIR="$DEFAULT_EVOLUTION_DIR" # Initialize with default
-  ALGORITHM_FILE="$DEFAULT_ALGORITHM_FILE"
-  EVALUATOR_FILE="$DEFAULT_EVALUATOR_FILE"
-  BRIEF_FILE="$DEFAULT_BRIEF_FILE"
-  EVOLUTION_CSV="$DEFAULT_EVOLUTION_CSV"
-  OUTPUT_DIR="$DEFAULT_OUTPUT_DIR"
-  PARENT_SELECTION="$DEFAULT_PARENT_SELECTION"
-  PYTHON_CMD="$DEFAULT_PYTHON_CMD"
-
-  # Determine EVOLUTION_DIR based on specified logic, overriding default if found
-  if [[ -n "$CLAUDE_EVOLVE_WORKING_DIR" ]]; then
-    echo "[DEBUG] EVOLUTION_DIR set by CLAUDE_EVOLVE_WORKING_DIR: $CLAUDE_EVOLVE_WORKING_DIR" >&2
-    EVOLUTION_DIR="$CLAUDE_EVOLVE_WORKING_DIR"
-  elif [[ -f "evolution/evolution.csv" ]]; then
-    echo "[DEBUG] EVOLUTION_DIR set by evolution/evolution.csv: evolution" >&2
-    EVOLUTION_DIR="evolution"
-  elif [[ -f "./evolution.csv" ]]; then
-    echo "[DEBUG] EVOLUTION_DIR set by ./evolution.csv: ." >&2
-    EVOLUTION_DIR="."
-  else
-    echo "[DEBUG] EVOLUTION_DIR defaulting to: $DEFAULT_EVOLUTION_DIR" >&2
-  fi
-  echo "[DEBUG] EVOLUTION_DIR after initial determination: $EVOLUTION_DIR" >&2
-
-  TOTAL_IDEAS="$DEFAULT_TOTAL_IDEAS"
-  NOVEL_EXPLORATION="$DEFAULT_NOVEL_EXPLORATION"
-  HILL_CLIMBING="$DEFAULT_HILL_CLIMBING"
-  STRUCTURAL_MUTATION="$DEFAULT_STRUCTURAL_MUTATION"
-  CROSSOVER_HYBRID="$DEFAULT_CROSSOVER_HYBRID"
-  NUM_ELITES="$DEFAULT_NUM_ELITES"
-  NUM_REVOLUTION="$DEFAULT_NUM_REVOLUTION"
-  
-  PARALLEL_ENABLED="$DEFAULT_PARALLEL_ENABLED"
-  MAX_WORKERS="$DEFAULT_MAX_WORKERS"
-  LOCK_TIMEOUT="$DEFAULT_LOCK_TIMEOUT"
-  
-  AUTO_IDEATE="$DEFAULT_AUTO_IDEATE"
-  MAX_RETRIES="$DEFAULT_MAX_RETRIES"
-  MEMORY_LIMIT_MB="$DEFAULT_MEMORY_LIMIT_MB"
-  
-  LLM_CLI_gpt5high='codex exec --profile gpt5high --dangerously-bypass-approvals-and-sandbox "{{PROMPT}}"'
-  LLM_CLI_o3high='codex exec --profile o3high --dangerously-bypass-approvals-and-sandbox "{{PROMPT}}"'
-  LLM_CLI_codex='codex exec --dangerously-bypass-approvals-and-sandbox "{{PROMPT}}"'
-  LLM_CLI_gemini='gemini -y -p "{{PROMPT}}"'
-  LLM_CLI_gemini_flash='gemini -y -p "{{PROMPT}}" --model gemini-2.5-flash'
-  LLM_CLI_opus='claude --dangerously-skip-permissions --mcp-config "" --model opus -p "{{PROMPT}}"'
-  LLM_CLI_opus_think='claude --dangerously-skip-permissions --mcp-config "" --model opus -p "ultrathink\n\n{{PROMPT}}"'
-  LLM_CLI_sonnet='claude --dangerously-skip-permissions --mcp-config "" --model sonnet -p "{{PROMPT}}"'
-  LLM_CLI_sonnet_think='claude --dangerously-skip-permissions --mcp-config "" --model sonnet -p "ultrathink\n\n{{PROMPT}}"'
-  LLM_CLI_cursor_sonnet='cursor-agent sonnet -p "{{PROMPT}}"'
-  LLM_CLI_cursor_opus='cursor-agent opus -p "{{PROMPT}}"'
-  LLM_CLI_glm='opencode -m openrouter/z-ai/glm-4.6 run "{{PROMPT}}"'
-  LLM_CLI_deepseek='opencode -m openrouter/deepseek/deepseek-v3.1-terminus run "{{PROMPT}}"'
-  LLM_CLI_ollama-cloud-gpt-oss='codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss --model gpt-oss:20b-cloud "{{PROMPT}}"'  LLM_CLI_ollama-cloud-kimi-k2='codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check --oss --model kimi-k2:1t-cloud "{{PROMPT}}"'  LLM_RUN="$DEFAULT_LLM_RUN"
-  LLM_IDEATE="$DEFAULT_LLM_IDEATE"
-
-  # Determine local config file path relative to EVOLUTION_DIR
-  local local_config_file="$EVOLUTION_DIR/config.yaml"
-
-  # Load local config
-  _load_yaml_config "$local_config_file"
-
-  # Load global config (overrides local config)
-  local global_config_file="$HOME/.config/claude-evolve/config.yaml"
-  _load_yaml_config "$global_config_file"
-  
-  echo "[DEBUG] EVOLUTION_DIR before FULL_EVOLUTION_DIR calculation: $EVOLUTION_DIR" >&2
-  
-  # Create full paths - ALL paths are relative to EVOLUTION_DIR
-  # Make EVOLUTION_DIR absolute if it\'s relative
-  if [[ "$EVOLUTION_DIR" = /* ]]; then
-    FULL_EVOLUTION_DIR="$EVOLUTION_DIR"
-  else
-    FULL_EVOLUTION_DIR="$(cd "$EVOLUTION_DIR" 2>/dev/null && pwd)" || FULL_EVOLUTION_DIR="$EVOLUTION_DIR"
-  fi
-  
-  FULL_ALGORITHM_PATH="$FULL_EVOLUTION_DIR/$ALGORITHM_FILE"
-  FULL_EVALUATOR_PATH="$FULL_EVOLUTION_DIR/$EVALUATOR_FILE"
-  FULL_BRIEF_PATH="$FULL_EVOLUTION_DIR/$BRIEF_FILE"
-  FULL_CSV_PATH="$FULL_EVOLUTION_DIR/$EVOLUTION_CSV"
-  
-  if [[ -n $OUTPUT_DIR ]]; then
-    FULL_OUTPUT_DIR="$FULL_EVOLUTION_DIR/$OUTPUT_DIR"
-  else
-    FULL_OUTPUT_DIR="$FULL_EVOLUTION_DIR"
-  fi
-  echo "[DEBUG] FULL_EVOLUTION_DIR at end of load_config: $FULL_EVOLUTION_DIR" >&2
-}
-
-# Validate configuration
-validate_config() {
-  local errors=0
-
-  if [[ ! -d "$FULL_EVOLUTION_DIR" ]]; then
-    echo "[ERROR] Evolution directory not found: $FULL_EVOLUTION_DIR" >&2
-    ((errors++))
-  fi
-
-  if [[ ! -f "$FULL_ALGORITHM_PATH" ]]; then
-    echo "[ERROR] Algorithm file not found: $FULL_ALGORITHM_PATH" >&2
-    ((errors++))
-  fi
-
-  if [[ ! -f "$FULL_EVALUATOR_PATH" ]]; then
-    echo "[ERROR] Evaluator file not found: $FULL_EVALUATOR_PATH" >&2
-    ((errors++))
-  fi
-
-  if [[ ! -f "$FULL_BRIEF_PATH" ]]; then
-    echo "[ERROR] Brief file not found: $FULL_BRIEF_PATH" >&2
-    ((errors++))
-  fi
-
-  if ! command -v "$PYTHON_CMD" >/dev/null 2>&1; then
-    echo "[ERROR] Python command not found: $PYTHON_CMD" >&2
-    echo "[ERROR] Please install Python 3.x or set python_cmd in config.yaml" >&2
-    echo "[ERROR] Examples: python_cmd: \"python\" or python_cmd: \"C:\\Python39\\python.exe\"" >&2
-    ((errors++))
-  else
-    # Verify Python version is 3.x
-    if ! "$PYTHON_CMD" -c "import sys; sys.exit(0 if sys.version_info[0] >= 3 else 1)" 2>/dev/null; then
-      echo "[ERROR] Python 3.x required, but $PYTHON_CMD appears to be Python 2" >&2
-      echo "[ERROR] Please set python_cmd in config.yaml to point to Python 3" >&2
-      ((errors++))
-    fi
-  fi
-
-  return $errors
-}
-
-# Show current configuration
-show_config() {
-  echo "Current claude-evolve configuration:"
-  echo "  Evolution directory: $FULL_EVOLUTION_DIR"
-  echo "  Algorithm file: $FULL_ALGORITHM_PATH"
-  echo "  Evaluator file: $FULL_EVALUATOR_PATH"
-  echo "  Brief file: $FULL_BRIEF_PATH"
-  echo "  CSV file: $FULL_CSV_PATH"
-  echo "  Output directory: $FULL_OUTPUT_DIR"
-  echo "  Parent selection: $PARENT_SELECTION"
-  echo "  Python command: $PYTHON_CMD"
-  echo "  Parallel enabled: $PARALLEL_ENABLED"
-  echo "  Max workers: $MAX_WORKERS"
-  echo "  Lock timeout: $LOCK_TIMEOUT"
-  echo "  Auto ideate: $AUTO_IDEATE"
-  echo "  Max retries: $MAX_RETRIES"
-  echo "  Memory limit: ${MEMORY_LIMIT_MB}MB"
-  echo "  LLM configuration:"
-  # Show LLM configurations using dynamic variable names
-  for model in gpt5high o3high codex gemini opus opus_think sonnet sonnet_think cursor_sonnet cursor_opus glm deepseek; do
-    var_name="LLM_CLI_${model}"
-    var_value=$(eval echo "\$$var_name")
-    if [[ -n "$var_value" ]]; then
-      # Convert underscore back to dash for display
-      display_name=$(echo "$model" | sed 's/_/-/g')
-      echo "    $display_name: $var_value"
-    fi
-  done
-  echo "  LLM for run: $LLM_RUN"
-  echo "  LLM for ideate: $LLM_IDEATE"
-}