docs/research/QVM_REWIND_RESTORE.md

Complete rewind record restoration and byte widening

RE-633. Reproduce with python3 scripts/analyze_qvm_rewind_restore.py; check with python3 scripts/test_qvm_rewind_restore.py. The machine report retains source identity and bounded fixtures.

Actual144166–144410 returns without effects when client4408==0. Otherwise it clears4408, copies saved vectors back into entity24/60/488/36, restores entity200/196 from bytes4448/4449 and restores six selected client words. Native−31 is requested only after all those writes. The report composes the recovered snapshot with explicitly supplied rewound live values, not actual history interpolation. Independent full-state checks verify the reverse map and expected animation truncation: original high bits are not recovered from byte snapshots. A second actual call performs no link or state change. Null-client legality and full143100 interpolation remain outside this helper contract; no native relink effect executes.

No original executable/full QVM/native collision/physics/rendering executes. Native responses and legal input domains are supplied or unverified where stated; full runtime/macOS/Linux Rust/Bevy/Solari gameplay remains open.