qvm: recover mode10 animations

docs/ASSET_PIPELINE_TODO.md

@@ -876,4 +876,7 @@ RE-725–734 batch: [health, contact and Rust impulse findings](research/QVM_HEA
 Research progress: RE-736 [report](research/QVM_PROTECTED_UPDATE.md); original assets unchanged.
 
 
-Research progress: RE-737 [report](research/QVM_MODE10_ENTRY.md); original assets unchanged.
+Research progress: RE-737 [report](research/QVM_MODE10_ENTRY.md); original assets unchanged.
+
+
+Research progress: RE-738 [report](research/QVM_MODE10_ANIMATION.md); original assets unchanged.

docs/FINDINGS.md

@@ -1222,4 +1222,7 @@ RE-725–734 batch: [health, contact and Rust impulse findings](research/QVM_HEA
 **RE-736 — Complete protected accumulator and completion callbacks:** 152386 consumes float32 accumulated heat, clamps negative progress, completes at32000 and copies resulting progress to a nonnull attacker. [Evidence](research/QVM_PROTECTED_UPDATE.md).
 
 
-**RE-737 — Mode10 interception gates and protected state publication:** 206128 exits outside mode10, state3 or blocked rounds; active entry publishes health50, meter15000 and protected bits with event106. [Evidence](research/QVM_MODE10_ENTRY.md).
+**RE-737 — Mode10 interception gates and protected state publication:** 206128 exits outside mode10, state3 or blocked rounds; active entry publishes health50, meter15000 and protected bits with event106. [Evidence](research/QVM_MODE10_ENTRY.md).
+
+
+**RE-738 — Mode10 descriptor and stance animation dispatch:** Original weapon descriptor classes select animation65/66/67/72/78; class4 method22 special-cases66 and stance bit1 selects41/42. [Evidence](research/QVM_MODE10_ANIMATION.md).

docs/PROVISIONAL_TODO.md

@@ -1211,4 +1211,7 @@ RE-725–734 batch: [health, contact and Rust impulse findings](research/QVM_HEA
 Research progress: RE-736 [report](research/QVM_PROTECTED_UPDATE.md); full native/platform/game scope remains open.
 
 
-Research progress: RE-737 [report](research/QVM_MODE10_ENTRY.md); full native/platform/game scope remains open.
+Research progress: RE-737 [report](research/QVM_MODE10_ENTRY.md); full native/platform/game scope remains open.
+
+
+Research progress: RE-738 [report](research/QVM_MODE10_ANIMATION.md); full native/platform/game scope remains open.

docs/RESEARCH_LEDGER.md

@@ -1331,3 +1331,8 @@ Exactly ten task commits follow1550ce07. Each task passed focused cargo xtask ch
 ## 2026-10-21 — RE-737 Mode10 interception gates and protected state publication
 
 206128 exits outside mode10, state3 or blocked rounds; active entry publishes health50, meter15000 and protected bits with event106. Focused `cargo xtask test-group mode10-entry` passes (3 Python tests); selected reports regenerate twice byte-identically, with storage, links and whitespace guards. New report: 86046 bytes. Full-suite validation is deferred to the tenth batch commit. No original assets, Rust runtime or shared VM evaluator changed.
+
+
+## 2026-10-21 — RE-738 Mode10 descriptor and stance animation dispatch
+
+Original weapon descriptor classes select animation65/66/67/72/78; class4 method22 special-cases66 and stance bit1 selects41/42. Focused `cargo xtask test-group mode10-animation` passes (3 Python tests); selected reports regenerate twice byte-identically, with storage, links and whitespace guards. New report: 314561 bytes. Full-suite validation is deferred to the tenth batch commit. No original assets, Rust runtime or shared VM evaluator changed.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1254,4 +1254,7 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 - [x] RE-736 Complete protected accumulator and completion callbacks ([report](research/QVM_PROTECTED_UPDATE.md)).
 
 
-- [x] RE-737 Mode10 interception gates and protected state publication ([report](research/QVM_MODE10_ENTRY.md)).
+- [x] RE-737 Mode10 interception gates and protected state publication ([report](research/QVM_MODE10_ENTRY.md)).
+
+
+- [x] RE-738 Mode10 descriptor and stance animation dispatch ([report](research/QVM_MODE10_ANIMATION.md)).

docs/research/QVM_MODE10_ANIMATION.md

@@ -0,0 +1,7 @@
+# Mode10 descriptor and stance animation dispatch
+
+RE-738. Reproduce with `python3 scripts/analyze_qvm_mode10_animation.py`; validate with `cargo xtask test-group mode10-animation`. See the [machine report](qvm-mode10-animation.json).
+
+Recovered206415..206582 using31 original descriptor slots plus explicit absent/invalid-class overrides, covering every jump-table target. Weapon index comes from the selected client312 slot masked to255. Semantic animation names and mapping to model frame clips remain unverified; numeric dispatch and untouched state are checked independently.
+
+No original executable/full VM/native world collision or rendering runs. Supplied callback/native responses and fixture domains remain explicit; complete macOS/Linux Rust/Bevy/Solari gameplay remains open.

docs/research/README.md

@@ -812,4 +812,7 @@ The extension collector adds five focused tests for native tail calls, command-r
 [RE-736: Complete protected accumulator and completion callbacks](QVM_PROTECTED_UPDATE.md).
 
 
-[RE-737: Mode10 interception gates and protected state publication](QVM_MODE10_ENTRY.md).
+[RE-737: Mode10 interception gates and protected state publication](QVM_MODE10_ENTRY.md).
+
+
+[RE-738: Mode10 descriptor and stance animation dispatch](QVM_MODE10_ANIMATION.md).

scripts/analyze_qvm_mode10_animation.py

@@ -0,0 +1,18 @@
+#!/usr/bin/env python3
+"""206415 animation dispatch from original descriptors plus explicit edge fixtures."""
+from pathlib import Path
+from qvm_research_support import source
+from qvm_lifecycle_support import seed,probe
+from analyze_qvm import write_json
+
+def main():
+    q,raw,h,ins=source();rows=[]
+    cases=[dict(weapon=w,flags12=f) for w in range(31) for f in [0,1,8,9]]
+    cases += [dict(weapon=1,flags12=f,descriptor=c,descriptor_method=d) for c in [-1,3,5,7] for d in [1,22] for f in [0,1]]
+    for a in cases:
+        m=seed(raw,h,**a);w=a['weapon']
+        if 'descriptor' in a:m[4032+432*w]=a['descriptor'];m[4196+432*w]=a['descriptor_method']
+        descriptor={'class':m[4032+432*w],'method':m[4196+432*w]}
+        _,p=probe(ins,m,206415,206583);p.update(input=a,descriptor=descriptor);rows.append(p)
+    write_json(Path('docs/research/qvm-mode10-animation.json'),{'source':q['source'],'sha256':q['sha256'],'probes':rows,'limits':'206415..206582 original31 descriptor slots and explicit dispatch edge overrides. Numeric animations not assigned semantic names; no renderer/animation player runs.'})
+if __name__=='__main__':main()

scripts/test_qvm_mode10_animation.py

@@ -0,0 +1,17 @@
+import json,unittest
+from pathlib import Path
+
+def animation(c,d):return {2:66,3:78,4:66 if d==22 else 72,6:65}.get(c,67)
+class Mode10AnimationTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):cls.ps=json.loads(Path('docs/research/qvm-mode10-animation.json').read_text())['probes']
+    def test_independent_descriptor_dispatch_and_stance(self):
+        for p in self.ps:
+            c=dict(p['initial']['client']);c['84']=animation(p['descriptor']['class'],p['descriptor']['method']);c['76']=42 if p['input']['flags12']&1 else 41
+            self.assertEqual(p['final'],{**p['initial'],'client':c})
+    def test_original_and_explicit_edge_domains(self):
+        self.assertEqual(len(self.ps),140);self.assertEqual({p['descriptor']['class'] for p in self.ps},set(range(-1,8)))
+        self.assertEqual({p['final']['client']['84'] for p in self.ps},{65,66,67,72,78})
+    def test_no_children_and_exact_boundary(self):
+        for p in self.ps:self.assertEqual(p['execution']['stop'],206583);self.assertEqual(p['execution']['calls'],[])
+if __name__=='__main__':unittest.main()

xtask/checks.tsv

@@ -1176,3 +1176,6 @@ group	lifecycle	scripts/analyze_qvm_protected_update.py
 report	scripts/analyze_qvm_mode10_entry.py	docs/research/qvm-mode10-entry.json
 edge	docs/research/qvm-mode10-entry.json	scripts/test_qvm_mode10_entry.py
 group	mode10-entry	scripts/analyze_qvm_mode10_entry.py
+report	scripts/analyze_qvm_mode10_animation.py	docs/research/qvm-mode10-animation.json
+edge	docs/research/qvm-mode10-animation.json	scripts/test_qvm_mode10_animation.py
+group	mode10-animation	scripts/analyze_qvm_mode10_animation.py