build-e2e-platformlisted
Install: claude install-skill YoavLax/agent-compass
# Build the AgentCompass platform locally for e2e testing
## When to use
- Before/after changing `src/airx/**` or `src/airx_server/**` and you need to verify against the real, containerized service (not just `pytest`).
- Running the fixture-based e2e suite (`tests/test_e2e_fixtures.py`) plus a live smoke test against a real GitHub repo.
- Testing GitHub-rate-limit-sensitive code paths (`src/airx/ingest.py`), which need `GITHUB_TOKEN` to get 5000 req/h instead of 60.
## Prerequisites
- Docker Desktop running.
- A GitHub token with at least `public_repo` scope (or default read scope) — do NOT hardcode it in any file. Get it from the environment or the `gh` CLI, never print it.
## Procedure
### 1. Get a GitHub token into the shell session (never write it to disk)
Prefer reusing an already-authenticated `gh` CLI session over asking the user to paste a token:
```powershell
$env:GITHUB_TOKEN = gh auth token
```
If `gh auth token` fails (not logged in), ask the user to run `gh auth login` first, or to set `$env:GITHUB_TOKEN` themselves in the terminal — never request the token value via chat/askQuestions (it's a secret).
### 2. Run the pure-Python e2e/unit suite first (fast, no Docker needed)
```powershell
.venv\Scripts\python.exe -m pytest -q
```
This covers `tests/test_e2e_fixtures.py` (fs.scan → build_index → score pipeline over `tests/fixtures/*`) and everything else. Fix failures here before touching Docker.
### 3. Build and start the local platform
```powershell
docker