perf

Overview ¶

perf — adopter-facing performance report generator.

Drives the bench stack through a sweep of synthetic load, captures host specs + client + server metrics, and emits a markdown report scoped to the run's machine. The report lives at docs/perf.md and answers the first question after the README: "can this work for my X machines doing Y RPS?".

Subcommands (more to come — sweep / report are the rest):

perf specs                      print the report header (host
                                specs as markdown) and exit.
                                Sanity-check for the detector
                                + a building block the sweep
                                driver embeds verbatim.

Surface lives behind `bin/bench perf` so adopters don't have to know about Go toolchain plumbing.