Controller Video Sync

Controller ↔ video sync

Pieces

1. ControllerRuntime — DualSense / Edge HID edges → bus
2. InputRing — ring of press/release/trigger/stick edges + analog hold
3. FrameHub — seq + clock_ns per published frame
4. IVC — join window + hold sustain → coupling_score

Enable: --controller (starts HID + InputRing pushes + IVC).

Coupling

Observation only:

window   = [t_video − lag_hi, t_video − lag_lo + lead]
energy   = edge_energy + hold_energy
coupling = 1 - exp(-energy / 2.5)   # clipped [0,1]; EMA at 30 Hz

Defaults: lag_lo=0, lag_hi=120, lead=24 ms. Held R2/stick still couple.

VCam: $env:QORESENCE_IVC_LAG_HI_MS = "200"

Sidecars

On Foundry export success → clips/<stem>.buttons.json when ring non-empty.

Full: CONTROLLER_VIDEO_SYNC.md