docs/research/QVM_CONTACT_IMPACT.md

Complete impact-only contact branch

RE-720. Reproduce with python3 scripts/analyze_qvm_contact_impact.py; check with python3 scripts/test_qvm_contact_impact.py. The machine report retains source identity and bounded fixtures.

Actual293630–293729 handles the nondamageable/nonspecial contact branch. Caller flag148 must be nonzero and trace48 bit32 clear. The branch constructs event109 for weapon30, event63 otherwise, using actual277695/278138 with supplied allocation/native link boundary. Actual60317 encodes trace24 normal to event184. Event192 stores weapon,88 stores trace44,140 stores attacker ID and204 stores1. Weapon27 copies exact global muzzle bytes to104. Every path returns numeric0; damage factor, feedback and211239 are not invoked. Independent constructor/codec/payload expectations verify the complete880-byte record.

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.