claude-evolve 1.3.4 → 1.3.6

package/README.md

@@ -196,6 +196,27 @@ your-project/
 └── (your main project files)
 ```
 
+## Environment Variables for Evaluators
+
+When your evaluator.py runs, it has access to the `EXPERIMENT_ID` environment variable containing the current experiment's ID (e.g., `gen07-001`). This allows evaluators to:
+
+- Save experiment-specific output files
+- Log metrics with experiment identifiers
+- Implement experiment-aware logic
+- Track which algorithm variant is being evaluated
+
+Example usage in evaluator.py:
+```python
+import os
+
+# Get the current experiment ID
+experiment_id = os.environ.get('EXPERIMENT_ID', 'unknown')
+
+# Use it for logging or file naming
+output_file = f"results_{experiment_id}.json"
+print(f"Evaluating experiment: {experiment_id}")
+```
+
 ## Configuration
 
 Edit `evolution/config.yaml` to customize:

package/bin/claude-evolve-analyze

@@ -6,7 +6,13 @@ set -e
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=../lib/config.sh
 source "$SCRIPT_DIR/../lib/config.sh"
-load_config
+
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 # Parse arguments
 open_chart=false

package/bin/claude-evolve-config

@@ -61,7 +61,12 @@ while [[ $# -gt 0 ]]; do
 done
 
 # Load current config
-load_config
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 case $action in
 show)

package/bin/claude-evolve-ideate

@@ -6,7 +6,13 @@ set -e
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=../lib/config.sh
 source "$SCRIPT_DIR/../lib/config.sh"
-load_config
+
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 # Helper function to call Claude with usage limit detection
 call_claude_with_limit_check() {

package/bin/claude-evolve-main

@@ -47,7 +47,7 @@ show_help() {
 claude-evolve - AI-powered algorithm evolution tool
 
 USAGE:
-    claude-evolve [COMMAND] [OPTIONS]
+    claude-evolve [--config=PATH] [COMMAND] [OPTIONS]
 
 COMMANDS:
     setup       Initialize evolution workspace
@@ -56,7 +56,8 @@ COMMANDS:
     analyze     Analyze evolution results
     help        Show this help message
 
-OPTIONS:
+GLOBAL OPTIONS:
+    --config=PATH  Use alternate config file (default: evolution/config.yaml)
     -h, --help     Show help message
     -v, --version  Show version
 
@@ -65,6 +66,7 @@ EXAMPLES:
     claude-evolve ideate 5
     claude-evolve run --timeout 300
     claude-evolve analyze --open
+    claude-evolve --config=evolution-abc/config.yaml run
 
 For more information, visit: https://github.com/anthropics/claude-evolve
 EOF
@@ -94,6 +96,33 @@ show_menu() {
   echo
 }
 
+# Parse global options
+CONFIG_FILE=""
+while [[ $# -gt 0 ]] && [[ "$1" =~ ^-- ]]; do
+  case "$1" in
+  --config)
+    if [[ -z ${2:-} ]]; then
+      echo -e "${RED}[ERROR] --config requires a file path${NC}" >&2
+      exit 1
+    fi
+    CONFIG_FILE="$2"
+    shift 2
+    ;;
+  --config=*)
+    CONFIG_FILE="${1#*=}"
+    shift
+    ;;
+  *)
+    break
+    ;;
+  esac
+done
+
+# Export CONFIG_FILE for subcommands
+if [[ -n $CONFIG_FILE ]]; then
+  export CLAUDE_EVOLVE_CONFIG="$CONFIG_FILE"
+fi
+
 # Check for updates (quick, non-blocking)
 check_for_updates
 

package/bin/claude-evolve-run

@@ -6,7 +6,13 @@ set -e
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=../lib/config.sh
 source "$SCRIPT_DIR/../lib/config.sh"
-load_config
+
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 # Parse arguments
 timeout_seconds=""
@@ -434,13 +440,13 @@ echo "[INFO] Algorithm ready at: $output_file"
 
 # Run evaluator
 echo "[INFO] Running evaluation..."
-echo "[INFO] Executing: $PYTHON_CMD $FULL_EVALUATOR_PATH $output_file"
+echo "[INFO] Executing: EXPERIMENT_ID=$id $PYTHON_CMD $FULL_EVALUATOR_PATH $output_file"
 eval_output=""
 eval_exit_code=0
 
 if [[ -n $timeout_seconds ]]; then
   echo "[INFO] Evaluation timeout: ${timeout_seconds}s"
-  if eval_output=$(timeout "$timeout_seconds" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
+  if eval_output=$(EXPERIMENT_ID="$id" timeout "$timeout_seconds" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
     eval_exit_code=0
   else
     eval_exit_code=$?
@@ -455,7 +461,7 @@ if [[ -n $timeout_seconds ]]; then
     fi
   fi
 else
-  if eval_output=$("$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
+  if eval_output=$(EXPERIMENT_ID="$id" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
     eval_exit_code=0
   else
     eval_exit_code=$?
@@ -473,7 +479,7 @@ echo "----------------------------------------"
   echo "=== EVALUATOR EXECUTION ==="
   echo "ID: $id"
   echo "Algorithm: $output_file"
-  echo "Command: $PYTHON_CMD $FULL_EVALUATOR_PATH $output_file"
+  echo "Command: EXPERIMENT_ID=$id $PYTHON_CMD $FULL_EVALUATOR_PATH $output_file"
   echo "Exit code: $eval_exit_code"
   echo "Timestamp: $(date)"
   echo
@@ -554,7 +560,7 @@ else
       recovery_attempted=true
       # Retry the evaluation
       echo "[INFO] Retrying evaluation after recovery attempt..."
-      if eval_output=$("$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
+      if eval_output=$(EXPERIMENT_ID="$id" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file" 2>&1); then
         # Re-process the successful result
         if score=$(echo "$eval_output" | grep -o '"score"[[:space:]]*:[[:space:]]*[0-9.]*' | cut -d: -f2 | tr -d ' '); then
           if [[ -n $score ]]; then

package/bin/claude-evolve-run-parallel

@@ -9,7 +9,13 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/../lib/config.sh"
 # shellcheck source=../lib/csv-lock.sh
 source "$SCRIPT_DIR/../lib/csv-lock.sh"
-load_config
+
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 # Parse arguments
 timeout_seconds=""

package/bin/claude-evolve-worker

@@ -10,7 +10,13 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/../lib/config.sh"
 # shellcheck source=../lib/csv-lock.sh
 source "$SCRIPT_DIR/../lib/csv-lock.sh"
-load_config
+
+# Use CLAUDE_EVOLVE_CONFIG if set, otherwise default
+if [[ -n ${CLAUDE_EVOLVE_CONFIG:-} ]]; then
+  load_config "$CLAUDE_EVOLVE_CONFIG"
+else
+  load_config
+fi
 
 # Parse arguments
 timeout_seconds=""
@@ -188,7 +194,7 @@ eval_exit_code=0
 if [[ -n $timeout_seconds ]]; then
   echo "[WORKER-$$] Evaluation timeout: ${timeout_seconds}s"
   # For Modal compatibility, don't capture stderr
-  if eval_output=$(timeout "$timeout_seconds" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file"); then
+  if eval_output=$(EXPERIMENT_ID="$id" timeout "$timeout_seconds" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file"); then
     eval_exit_code=0
   else
     eval_exit_code=$?
@@ -200,7 +206,7 @@ if [[ -n $timeout_seconds ]]; then
   fi
 else
   # For Modal compatibility, don't capture stderr
-  if eval_output=$("$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file"); then
+  if eval_output=$(EXPERIMENT_ID="$id" "$PYTHON_CMD" "$FULL_EVALUATOR_PATH" "$output_file"); then
     eval_exit_code=0
   else
     eval_exit_code=$?

package/lib/config.sh

@@ -26,6 +26,9 @@ DEFAULT_LOCK_TIMEOUT=30
 
 # Load configuration from config file
 load_config() {
+  # Accept config file path as parameter
+  local config_file="${1:-evolution/config.yaml}"
+  
   # Set defaults first
   EVOLUTION_DIR="$DEFAULT_EVOLUTION_DIR"
   ALGORITHM_FILE="$DEFAULT_ALGORITHM_FILE"
@@ -48,9 +51,6 @@ load_config() {
   PARALLEL_ENABLED="$DEFAULT_PARALLEL_ENABLED"
   MAX_WORKERS="$DEFAULT_MAX_WORKERS"
   LOCK_TIMEOUT="$DEFAULT_LOCK_TIMEOUT"
-
-  # Single config file location: evolution/config.yaml
-  local config_file="evolution/config.yaml"
   
   # Load config if found
   if [[ -f "$config_file" ]]; then
@@ -132,6 +132,16 @@ load_config() {
     done < "$config_file"
   fi
 
+  # If config file is in a different directory, use that as the evolution dir
+  if [[ "$config_file" != "evolution/config.yaml" ]]; then
+    # Extract directory from config file path
+    local config_dir=$(dirname "$config_file")
+    if [[ "$config_dir" != "." && "$config_dir" != "" ]]; then
+      EVOLUTION_DIR="$config_dir"
+      echo "[INFO] Using evolution directory from config path: $EVOLUTION_DIR"
+    fi
+  fi
+  
   # Create full paths - ALL paths are relative to evolution_dir
   FULL_EVOLUTION_DIR="$EVOLUTION_DIR"
   FULL_ALGORITHM_PATH="$EVOLUTION_DIR/$ALGORITHM_FILE"

package/package.json

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