VOX preset tuned against game word assets; add vox_compare tool

README.md

@@ -93,9 +93,11 @@ A short low-level leading hum (80 ms, 75 Hz, -48 dBFS) primes Discord's audio pi
 so the first word is not gated; tune with `VESKSLOP_TTS_HUM_MS` (0 = off),
 `VESKSLOP_TTS_HUM_HZ`, and `VESKSLOP_TTS_HUM_DB`.
 
-**Half-Life presets** (Keith Bell): `VESKSLOP_TTS_PRESET=vox` applies the approximated
-Valve VOX profile and enables VOX prosody; `VESKSLOP_TTS_PRESET=hev` is a starting point
-for the HEV suit voice. Values are in `docs/TTS-DESIGN.md`.
+**Half-Life presets** (Keith Bell): `VESKSLOP_TTS_PRESET=vox` applies the Valve VOX
+profile (pitch 0, rate 15, head size 34, lowering 50) and enables VOX prosody;
+`VESKSLOP_TTS_PRESET=hev` is a starting point for the HEV suit voice. The VOX values were
+tuned against the game's word assets with `tools/vox_compare.py`; details in
+`docs/TTS-DESIGN.md`.
 
 ## Layout
 
@@ -108,6 +110,7 @@ for the HEV suit voice. Values are in `docs/TTS-DESIGN.md`.
 - `setup/run.sh` — run helper (prefix + Xvfb)
 - `setup/veskslop-tts.sh` — Veskslop command-provider wrapper (post-processing included)
 - `setup/vox_parser.py` — NetTTS-style VOX prosody encoder (Flextalk voices)
+- `tools/vox_compare.py` — reference-vs-synthesis metrics for preset tuning
 - `docs/NOTES.md` — registry/CLSID facts, runtime RE notes, gotchas
 - `docs/TTS-DESIGN.md` — integration contract with Veskslop plus engine clarifications