vango-bench

README

vango-bench

Canonical benchmark CLI for Vango. Produces a versioned JSON report and an optional Markdown report.

For full details (what we measure, scenarios, baselines, CI), see BENCHMARKS.md at the repo root.

Run

go run ./cmd/vango-bench -profile ci -mode all -scenario all -dom-rate-limit off -json out.json

By default, the Markdown report path is derived from -json (e.g. out.md for out.json). Disable with -md '' or override with -md path.md.

Macro harness (Latitude alloc/ns)

For clean server-only alloc_bytes/event, allocs/event, and ns/event on hosting hardware (e.g. Latitude), run macro with the server subprocess harness:

go run ./cmd/vango-bench -profile standard -mode macro -scenario all -macro-harness server -dom-rate-limit off -json out.json

Optional: browser DOM apply/paint

go run ./cmd/vango-bench -profile fast -mode macro -scenario update_one -dom-rate-limit off -browser-metrics -json out.json

Compare to baseline (regression gate)

go run ./cmd/vango-bench compare -baseline benchmarks/baseline.json -current out.json

Saturation sweep (max concurrency)

go run ./cmd/vango-bench saturation -scenario update_one -start-clients 100 -max-clients 10000 -mult 2 -duration 5s -rps 2 -list 50 -payload-bytes 24 -json out.json -md out.md