harness-evolver 3.1.1 → 3.2.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "harness-evolver",
+  "description": "LangSmith-native autonomous agent optimization — evolves LLM agent code using multi-agent proposers, LangSmith experiments, and git worktrees",
+  "version": "3.2.0",
+  "author": {
+    "name": "Raphael Valdetaro"
+  },
+  "homepage": "https://github.com/raphaelchristi/harness-evolver",
+  "repository": "https://github.com/raphaelchristi/harness-evolver",
+  "license": "MIT",
+  "keywords": [
+    "langsmith",
+    "optimization",
+    "evolution",
+    "llm",
+    "agent",
+    "evaluator",
+    "langsmith-cli"
+  ]
+}

package/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "description": "Harness Evolver — ensures Python deps and env vars are available each session",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# Harness Evolver — SessionStart hook
+# Ensures Python venv, langsmith, langsmith-cli, and env vars are ready.
+# Runs silently on every session start. Installs deps only if missing.
+
+set -euo pipefail
+
+# Resolve paths — plugin root is set by Claude Code
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-}"
+PLUGIN_DATA="${CLAUDE_PLUGIN_DATA:-}"
+
+# Fallback: if running outside plugin system (npx install), use legacy paths
+if [ -z "$PLUGIN_ROOT" ]; then
+    PLUGIN_ROOT="$HOME/.evolver"
+    PLUGIN_DATA="$HOME/.evolver"
+fi
+
+TOOLS_DIR="$PLUGIN_ROOT/tools"
+VENV_DIR="$PLUGIN_DATA/venv"
+VENV_PY="$VENV_DIR/bin/python"
+
+# --- 1. Create venv if missing ---
+if [ ! -f "$VENV_PY" ]; then
+    if command -v uv >/dev/null 2>&1; then
+        uv venv "$VENV_DIR" >/dev/null 2>&1
+    else
+        python3 -m venv "$VENV_DIR" >/dev/null 2>&1
+    fi
+fi
+
+# --- 2. Install langsmith if missing ---
+if [ -f "$VENV_PY" ]; then
+    "$VENV_PY" -c "import langsmith" 2>/dev/null || {
+        if command -v uv >/dev/null 2>&1; then
+            uv pip install --python "$VENV_PY" langsmith >/dev/null 2>&1
+        else
+            "$VENV_DIR/bin/pip" install --upgrade langsmith >/dev/null 2>&1 || \
+            "$VENV_PY" -m pip install --upgrade langsmith >/dev/null 2>&1
+        fi
+    }
+fi
+
+# --- 3. Install langsmith-cli if missing ---
+command -v langsmith-cli >/dev/null 2>&1 || {
+    if command -v uv >/dev/null 2>&1; then
+        uv tool install langsmith-cli >/dev/null 2>&1
+    else
+        pip install langsmith-cli >/dev/null 2>&1 || pip3 install langsmith-cli >/dev/null 2>&1
+    fi
+} || true
+
+# --- 4. Load API key from credentials file if not in env ---
+if [ -z "${LANGSMITH_API_KEY:-}" ]; then
+    if [ "$(uname)" = "Darwin" ]; then
+        CREDS="$HOME/Library/Application Support/langsmith-cli/credentials"
+    else
+        CREDS="$HOME/.config/langsmith-cli/credentials"
+    fi
+    if [ -f "$CREDS" ]; then
+        KEY=$(grep '^LANGSMITH_API_KEY=' "$CREDS" 2>/dev/null | head -1 | cut -d= -f2-)
+        if [ -n "$KEY" ]; then
+            echo "export LANGSMITH_API_KEY=\"$KEY\"" >> "$CLAUDE_ENV_FILE"
+        fi
+    fi
+fi
+
+# --- 5. Export env vars for skills ---
+if [ -n "${CLAUDE_ENV_FILE:-}" ]; then
+    echo "export EVOLVER_TOOLS=\"$TOOLS_DIR\"" >> "$CLAUDE_ENV_FILE"
+    echo "export EVOLVER_PY=\"$VENV_PY\"" >> "$CLAUDE_ENV_FILE"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harness-evolver",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "LangSmith-native autonomous agent optimization for Claude Code",
   "author": "Raphael Valdetaro",
   "license": "MIT",
@@ -24,6 +24,8 @@
     "bin/",
     "skills/",
     "agents/",
-    "tools/"
+    "tools/",
+    "hooks/",
+    ".claude-plugin/"
   ]
 }

package/skills/evolve/SKILL.md

@@ -16,8 +16,9 @@ Run the autonomous propose-evaluate-iterate loop using LangSmith as the evaluati
 ## Resolve Tool Path and Python
 
 ```bash
-TOOLS=$([ -d ".evolver/tools" ] && echo ".evolver/tools" || echo "$HOME/.evolver/tools")
-EVOLVER_PY=$([ -f "$HOME/.evolver/venv/bin/python" ] && echo "$HOME/.evolver/venv/bin/python" || echo "python3")
+# Prefer env vars set by plugin hook; fallback to legacy npx paths
+TOOLS="${EVOLVER_TOOLS:-$([ -d ".evolver/tools" ] && echo ".evolver/tools" || echo "$HOME/.evolver/tools")}"
+EVOLVER_PY="${EVOLVER_PY:-$([ -f "$HOME/.evolver/venv/bin/python" ] && echo "$HOME/.evolver/venv/bin/python" || echo "python3")}"
 ```
 
 Use `$EVOLVER_PY` instead of `python3` for ALL tool invocations.

package/skills/setup/SKILL.md

@@ -38,8 +38,9 @@ The tools auto-load the key from the credentials file, but the env var takes pre
 ## Resolve Tool Path and Python
 
 ```bash
-TOOLS=$([ -d ".evolver/tools" ] && echo ".evolver/tools" || echo "$HOME/.evolver/tools")
-EVOLVER_PY=$([ -f "$HOME/.evolver/venv/bin/python" ] && echo "$HOME/.evolver/venv/bin/python" || echo "python3")
+# Prefer env vars set by plugin hook; fallback to legacy npx paths
+TOOLS="${EVOLVER_TOOLS:-$([ -d ".evolver/tools" ] && echo ".evolver/tools" || echo "$HOME/.evolver/tools")}"
+EVOLVER_PY="${EVOLVER_PY:-$([ -f "$HOME/.evolver/venv/bin/python" ] && echo "$HOME/.evolver/venv/bin/python" || echo "python3")}"
 ```
 
 Use `$EVOLVER_PY` instead of `python3` for ALL tool invocations. This ensures the venv with langsmith is used.