Skip to content

AGENTS.md

Latest commit

 

History

History
23 lines (16 loc) · 1.36 KB

AGENTS.md

File metadata and controls

23 lines (16 loc) · 1.36 KB
Raw

Agent guide

Read README.md first. It defines the bridge; every change must preserve these invariants:

  • Opaque payloads. The bridge only ever handles client-encrypted ciphertext (iv + payload). Never inspect, transform, or log payload contents.
  • Single-use. Requests and responses are read with GETDEL — one retrieval, then gone.
  • No persistence. Everything lives in Redis with a uniform TTL (EXPIRE_AFTER_SECONDS in crates/server/src/utils.rs) and is auto-purged. Don't add durable storage or per-key lifetimes.

The bridge is a dumb relay. New functionality must stay agnostic to clients and environments — no client/app-specific branching, no environment-specific behavior. Two intentional, temporary exceptions already exist; don't extend them or add new ones like them:

  • app_overrides — a per-app_id rollout workaround for the World ID app (crates/server/src/routes/request/, crates/server/src/main.rs).
  • PUT /request/:id — enabled only when ENVIRONMENT == "staging" (crates/server/src/routes/request/).

Build, test, lint

Reproduce CI locally before pushing:

cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features # warnings denied via crate-level attributes
cargo build --workspace --locked
cargo test --workspace --all-features # in-process; needs only Redis — see README "Testing"