# E2e Test

> 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. Use when this capability is needed.

- Skill: `tomevault-io/e2e-test-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/e2e-test-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/e2e-test-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/e2e-test-2

---


# End-to-End Test Skill

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

## Test Flow

1. **Build the project** (if not already built)
2. **Start backend services** in background using `run_in_background: true`
3. **Wait for services** to be ready on port 23153
4. **Run artifact build** against the services
5. **Stop all services** on port 23153
6. **Report results**

## Execution Instructions

### Step 1: Start services in background

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

```bash
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):

```bash
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`:

```bash
make VORPAL_ARTIFACT="vorpal-shell" vorpal
```

To test with a different artifact:

```bash
make VORPAL_ARTIFACT="<artifact-name>" vorpal
```

### Step 4: Stop services

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

```bash
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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/alt-f4-llc) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->