# zlay

AT Protocol relay in zig 0.16. reader thread per PDS + shared frame
processing pool. ReleaseSafe in production. Io.Threaded backend (Evented
attempt shelved — see docs/evented-attempt.md).

## before pushing

- `zig fmt --check .` and `zig build test`
- MUST use `-Dtarget=x86_64-linux-gnu` for production (musl breaks RocksDB)
- ReleaseFast has a known double-free — do not use

## deploy

configs at `../@zzstoatzz.io/relay/` — `just zlay publish-remote ReleaseSafe`

KUBECONFIG is set automatically by the zlay module (`zlay/kubeconfig.yaml`).

## docs

- [docs/design.md](docs/design.md) — architecture, threading, memory model
- [docs/deployment.md](docs/deployment.md) — build flags, infra, resource usage
- [docs/gotchas.md](docs/gotchas.md) — zig/pg.zig/rocksdb-zig/deploy traps
- [docs/incident-2026-03-04.md](docs/incident-2026-03-04.md) — ReleaseSafe RSS analysis
- [docs/evented-attempt.md](docs/evented-attempt.md) — Evented backend attempt and why we reverted