Performance Watcher

Performance Watcher

scripts/perf_watch.py creates a deterministic Markdown corpus, exercises native CLI modes, and records machine and Git metadata. Generated reports stay under ignored benchmark-output/.

Windows:

python scripts/perf_watch.py --binary build/windows/rayomd.exe --platform windows --suite watch --label local

Linux/WSL:

python3 scripts/perf_watch.py --binary build/linux/rayomd --platform linux-wsl --suite watch --label local

Suites are quick, watch, and full. For a deterministic pass/fail check, use an explicit version record:

python3 scripts/perf_watch.py \
  --binary build/linux/rayomd \
  --platform linux-wsl \
  --suite watch \
  --baseline-record docs/benchmarks/versions/v1.1.5/linux-wsl-watch-modern-normal-local.json \
  --fail-on-slower-pct 10

Archive a release-quality record with its storage location:

python3 scripts/perf_watch.py \
  --binary build/linux/rayomd \
  --platform linux-wsl \
  --suite watch \
  --label release \
  --version-log-dir docs/benchmarks/versions \
  --storage-note "WSL ext4"

Remote image timing is deliberately excluded because network conditions are not a stable performance signal.