← ClaudeAtlas

build-e2e-platformlisted

Builds and rebuilds the containerized AgentCompass platform (Docker Compose) for end-to-end testing, configuring GITHUB_TOKEN to avoid GitHub's 60 req/hour anonymous rate limit. Use this skill when running e2e tests, testing the live /api/analyze endpoint, or rebuilding the container. Trigger when GitHub rate limits appear during manual testing.
YoavLax/agent-compass · ★ 39 · Testing & QA · score 61
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