"Contributing — Populi control plane"

Contributing — Populi / mens HTTP

Read first

Key paths

PathRole
crates/vox-populi/src/transport/router.rsAxum router, auth, body limits
crates/vox-populi/src/transport/handlers.rsJoin, heartbeat, A2A, bootstrap
crates/vox-populi/tests/http_control_plane.rsIntegration tests (transport feature)

Commands

cargo test -p vox-populi --features transport --test http_control_plane
cargo test -p vox-populi --features transport openapi_paths

Security defaults

  • GET /health stays unauthenticated even when VOX_MESH_TOKEN is set.
  • Never log bearer tokens or bootstrap secrets.
  • Prefer machine-readable probes (vox doctor --probe) in OCI HEALTHCHECK.