Repository-specific notes for Codex-style contributors.
- Read impacted files first.
- Make focused changes.
- Run relevant tests/checks.
- Update docs if behavior changed.
- Commit and push.
go/relay: edge policy, routing, tunnel session behavior.go/agent: CLI ergonomics, reconnect/resilience flows.services/api: auth, tunnels, domains, billing/admin endpoints.services/worker-*: retries, replay safety, reconciliation loops.docs/+plan.md: source of truth for operation and roadmap status.
- Keep security posture explicit (auth, IP controls, TLS modes).
- Prefer backward-compatible API changes.
- Use clear commit messages with scope.
- Avoid hidden side effects; make failure states observable.