fix: Evolution pipeline UUPS upgrade + Foundry PATH (#593)

- Add virtual to Optimizer.calculateParams() for UUPS override
- Create OptimizerV3.sol: UUPS-upgradeable optimizer with transpiled Push3 logic
- Update deploy-optimizer.sh to deploy OptimizerV3 instead of Optimizer
- Add ~/.foundry/bin to PATH in evolve.sh, fitness.sh, deploy-optimizer.sh

tools/deploy-optimizer.sh

@@ -19,6 +19,9 @@
 
 set -euo pipefail
 
+# Foundry tools (forge, cast, anvil)
+export PATH="${HOME}/.foundry/bin:${PATH}"
+
 # ---------------------------------------------------------------------------
 # Paths
 # ---------------------------------------------------------------------------
@@ -269,7 +272,7 @@ step "Deploying new Optimizer implementation for diff preview"
 
 (
     cd "$ONCHAIN_DIR"
-    forge create src/Optimizer.sol:Optimizer \
+    forge create src/OptimizerV3.sol:OptimizerV3 \
         --rpc-url "$RPC_URL" \
         --private-key "$DEPLOYER_KEY" \
         --json 2>/dev/null \
@@ -278,7 +281,7 @@ step "Deploying new Optimizer implementation for diff preview"
 )
 
 NEW_IMPL="$(cat /tmp/new-optimizer-impl.txt 2>/dev/null || echo "")"
-[ -z "$NEW_IMPL" ] && fail "Failed to deploy new Optimizer implementation"
+[ -z "$NEW_IMPL" ] && fail "Failed to deploy new OptimizerV3 implementation"
 info "New implementation deployed at: $NEW_IMPL"
 
 # calculateSentiment is pure — callable on bare (uninitialized) implementation

tools/push3-evolution/evolve.sh

@@ -39,6 +39,9 @@
 
 set -euo pipefail
 
+# Foundry tools (forge, cast, anvil)
+export PATH="${HOME}/.foundry/bin:${PATH}"
+
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 FITNESS_SH="$SCRIPT_DIR/fitness.sh"
 MUTATE_CLI="$SCRIPT_DIR/mutate-cli.ts"

tools/push3-evolution/fitness.sh

@@ -24,6 +24,9 @@
 
 set -euo pipefail
 
+# Foundry tools (forge, cast, anvil)
+export PATH="${HOME}/.foundry/bin:${PATH}"
+
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 ONCHAIN_DIR="$REPO_ROOT/onchain"