Improve e2e-cli setup: java/mvn resolution and devbox docs

- Resolve java and mvn from PATH or devbox nix profile fallback
- Pass resolved $JAVA binary to run-tests.sh so it works outside devbox shell
- Add devbox setup as recommended path in README, document auto-fallback behavior

Author: MichaelGHSeg

e2e-cli/README.md

@@ -4,15 +4,41 @@ E2E test CLI for the [analytics-java](https://github.com/segmentio/analytics-jav
 
 Built with Kotlin (JVM) and packaged as a fat jar via Maven.
 
-## Setup
+## Running E2E tests
+
+### With devbox (recommended)
 
 ```bash
-mvn package -pl e2e-cli -am
+# From repo root — activates Java 11 and Maven automatically
+devbox shell
+
+# Then from e2e-cli dir:
+./run-e2e.sh
 ```
 
-## Usage
+### Without devbox
+
+Requires Java 11+, Maven, and Node.js 18+.
 
 ```bash
+./run-e2e.sh
+```
+
+The script auto-detects `java` and `mvn` on PATH. If they're not on PATH but devbox has been initialized, it falls back to the devbox nix profile binaries automatically.
+
+### Override sdk-e2e-tests location
+
+```bash
+E2E_TESTS_DIR=../my-e2e-tests ./run-e2e.sh
+```
+
+## Manual CLI usage
+
+```bash
+# Build first (from repo root)
+mvn package -pl e2e-cli -am -DskipTests
+
+# Run
 java -jar e2e-cli/target/e2e-cli-*-jar-with-dependencies.jar --input '{"writeKey":"...", ...}'
 ```
 

e2e-cli/run-e2e.sh

@@ -2,7 +2,9 @@
 #
 # Run E2E tests for analytics-java
 #
-# Prerequisites: Java 11+, Maven, Node.js 18+
+# Prerequisites: Node.js 18+ and one of:
+#   - devbox (recommended): run `devbox shell` first, then ./run-e2e.sh
+#   - Java 11+ and Maven on PATH
 #
 # Usage:
 #   ./run-e2e.sh [extra args passed to run-tests.sh]
@@ -17,11 +19,36 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 SDK_ROOT="$SCRIPT_DIR/.."
 E2E_DIR="${E2E_TESTS_DIR:-$SDK_ROOT/../sdk-e2e-tests}"
 
+# Resolve java and mvn — prefer JAVA_HOME/devbox nix profile, fall back to PATH
+if [[ -z "$JAVA" ]]; then
+    if command -v java &>/dev/null; then
+        JAVA="java"
+    elif [[ -f "$SDK_ROOT/.devbox/nix/profile/default/bin/java" ]]; then
+        JAVA="$SDK_ROOT/.devbox/nix/profile/default/bin/java"
+    else
+        echo "Error: java not found. Run 'devbox shell' first or install Java 11+."
+        exit 1
+    fi
+fi
+
+if [[ -z "$MVN" ]]; then
+    if command -v mvn &>/dev/null; then
+        MVN="mvn"
+    elif [[ -f "$SDK_ROOT/.devbox/nix/profile/default/bin/mvn" ]]; then
+        MVN="$SDK_ROOT/.devbox/nix/profile/default/bin/mvn"
+    else
+        echo "Error: mvn not found. Run 'devbox shell' first or install Maven."
+        exit 1
+    fi
+fi
+
 echo "=== Building analytics-java e2e-cli ==="
+echo "Using Java: $($JAVA -version 2>&1 | head -1)"
+echo "Using Maven: $($MVN -version 2>&1 | head -1)"
 
 # Build SDK and e2e-cli
 cd "$SDK_ROOT"
-mvn package -pl e2e-cli -am -DskipTests
+$MVN package -pl e2e-cli -am -DskipTests
 
 # Find the built jar
 CLI_JAR=$(find "$SDK_ROOT/e2e-cli/target" -name "e2e-cli-*-jar-with-dependencies.jar" | head -1)
@@ -37,5 +64,5 @@ echo ""
 cd "$E2E_DIR"
 ./scripts/run-tests.sh \
     --sdk-dir "$SCRIPT_DIR" \
-    --cli "java -jar $CLI_JAR" \
+    --cli "$JAVA -jar $CLI_JAR" \
     "$@"