ke2e — test as source of truth

Kortix has one end-to-end test suite at suna/tests/ (the ke2e runner). It is black-box: it hits a real, deployed API over HTTP (staging-api.kortix.com, dev-api.kortix.com, local localhost:8008/v1, or prod) with live services (real Daytona, GitHub, Stripe test-mode, LLM) — no mocking, no in-process app. Every test maps 1:1 to a stable flow ID in tests/spec/end-to-end.md. A coverage gate makes that mapping enforceable, so the spec + tests stay the source of truth for what the API does.

WIP — NOT yet enforced. The suite is still being built out and does not gate PRs, promotes, or deploys yet. The workflow below is the intended end-state; follow it when convenient, but it is not mandatory until coverage is complete and the gates are turned back on (re-add the pull_request trigger in e2e.yml + the e2e_gate job in promote.yml). Until then, do not block your own work on it.

The intended workflow (once enforced)