e2e-test - SKILL.md Agent Skill

name: e2e-test description: Run end-to-end tests that validate Vorpal services and client builds. Use when testing the full system (services + build pipeline), validating changes work end-to-end, or verifying services and clients communicate correctly. allowed-tools: Bash, Read, Glob, Grep

End-to-End Test Skill

Run end-to-end tests to validate that Vorpal services start correctly and can successfully build artifacts.

Test Flow

Build the project (if not already built)
Start backend services in background using run_in_background: true
Wait for services to be ready on port 23153
Run artifact build against the services
Stop all services on port 23153
Report results

Execution Instructions

Step 1: Start services in background

Use the Bash tool with run_in_background: true to start services:

make vorpal-start

The service logs will stream to the shell output for review.

Step 2: Wait for services

Wait for port 23153 to be available (up to 60 seconds):

for i in {1..60}; do nc -z localhost 23153 2>/dev/null && echo "Services ready after ${i}s" && break; [ $i -eq 60 ] && echo "ERROR: Services failed to start" && exit 1; sleep 1; done

Step 3: Run artifact build

Build the artifact against the running services. Default artifact is vorpal-shell:

make VORPAL_ARTIFACT="vorpal-shell" vorpal

To test with a different artifact:

make VORPAL_ARTIFACT="<artifact-name>" vorpal

Step 4: Stop services

After the build completes (success or failure), stop all services on port 23153:

lsof -ti:23153 | xargs kill 2>/dev/null || true

Step 5: Report results

If build succeeded, report "E2E TEST PASSED"
If build failed, review the service logs in the shell output and the build error messages

Arguments

The skill accepts an optional artifact name. Default is vorpal:

/e2e-test - Test with vorpal-shell artifact
/e2e-test vorpal - Test with vorpal artifact
/e2e-test <name> - Test with specified artifact

Troubleshooting

Port in use: lsof -ti:23153 | xargs kill
Build fails: Run make build first
Services crash: Review shell output for error messages