# Development

Requirements: Rust 1.80+, Go 1.22+ (the container build uses 1.24), Node 22+,
Docker with Compose v2, and PostgreSQL 16 for backend integration.

```bash
cargo test --manifest-path agent/Cargo.toml
cd control-plane/backend && go test ./...
cd ../frontend && npm ci && npm test -- --run && npm run build
docker compose -f ../docker-compose.yml config
```

Copy example configuration; never commit live tokens. Parser tests use fixtures
and ordinary suites must work on macOS/Linux without root. Host integration is a
separate manual pass on a disposable supported VM.

When adding an endpoint, update the agent route, control-plane proxy allow-list,
RBAC policy, audit behavior (for writes), docs, and tests together. Prefer small
dependencies and measure agent RSS before accepting runtime-heavy crates.