qvm: recover refreshed rotation callbacks

docs/FINDINGS.md

@@ -1601,3 +1601,6 @@ RE-813–822 replaces the scoreboard decimal assumption with actual37914 executi
 
 
 **RE-867:** Rust matches128 continuous source camera/fallback/placement cases with shared RNG state and checked native-math transcripts. The supplied fallback view has been replaced by recovered spawn ranking and +9 Z. Telefrag answers stay caller-owned; no-spawn errors preserve placement state. Native collision/math and runtime integration remain open. [Evidence](research/RUST_CAMERA_SPAWN.md).
+
+
+**RE-868:** 192 original122230 cases execute actual strlen and recover signed counter wrapping, threshold priority and refresh→optional filename callback/clear→reset order. Engine-5 refresh writes are supplied explicitly, including empty, NUL and high-byte filenames. Actual122143/121987 callbacks and native runtime ownership remain open. [Evidence](research/QVM_ROTATION_ADVANCE.md).

docs/PROVISIONAL_TODO.md

@@ -1626,3 +1626,6 @@ RE-866: 128 coherent setup→placement cases replace supplied fallback view writ
 
 
 RE-867: Rust matches128 continuous source camera/fallback/placement cases with shared RNG state and checked native-math transcripts. The supplied fallback view has been replaced by recovered spawn ranking and +9 Z. Telefrag answers stay caller-owned; no-spawn errors preserve placement state. Native collision/math and runtime integration remain open. Full runtime completion remains open. [Evidence](research/RUST_CAMERA_SPAWN.md).
+
+
+RE-868: 192 original122230 cases execute actual strlen and recover signed counter wrapping, threshold priority and refresh→optional filename callback/clear→reset order. Engine-5 refresh writes are supplied explicitly, including empty, NUL and high-byte filenames. Actual122143/121987 callbacks and native runtime ownership remain open. Full runtime completion remains open. [Evidence](research/QVM_ROTATION_ADVANCE.md).

docs/RESEARCH_LEDGER.md

@@ -2036,3 +2036,8 @@ RE-866 review: expanded the standalone source fallback grid to80 entities so fil
 ## 2026-10-27 — RE-867 Rust camera composition with recovered fallback
 
 Rust matches128 continuous source camera/fallback/placement cases with shared RNG state and checked native-math transcripts. The supplied fallback view has been replaced by recovered spawn ranking and +9 Z. Telefrag answers stay caller-owned; no-spawn errors preserve placement state. Native collision/math and runtime integration remain open. Focused `cargo xtask test-group rust-camera-spawn` passes (9 Python tests); selected reports regenerate twice deterministically, with storage, documentation links and whitespace guards. Full suite deferred to task ten. Original assets unchanged; source fixtures do not establish complete native/runtime parity.
+
+
+## 2026-10-27 — RE-868 Original rotation cursor and refreshed filename callback policy
+
+192 original122230 cases execute actual strlen and recover signed counter wrapping, threshold priority and refresh→optional filename callback/clear→reset order. Engine-5 refresh writes are supplied explicitly, including empty, NUL and high-byte filenames. Actual122143/121987 callbacks and native runtime ownership remain open. Focused `cargo xtask test-group rotation-advance` passes (5 Python tests); selected reports regenerate twice deterministically, with storage, documentation links and whitespace guards. Full suite deferred to task ten. Original assets unchanged; source fixtures do not establish complete native/runtime parity.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1663,3 +1663,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-867 Rust camera composition with recovered fallback ([evidence](research/RUST_CAMERA_SPAWN.md)).
+
+
+- [x] RE-868 Original rotation cursor and refreshed filename callback policy ([evidence](research/QVM_ROTATION_ADVANCE.md)).

docs/research/QVM_ROTATION_ADVANCE.md

@@ -0,0 +1,7 @@
+# Original rotation cursor and refreshed filename callback policy
+
+RE-868. Reproduce with `python3 scripts/analyze_qvm_rotation_advance.py`; focused validation: `cargo xtask test-group rotation-advance`. [Machine report](qvm-rotation-advance.json).
+
+192 original122230 cases execute actual strlen and recover signed counter wrapping, threshold priority and refresh→optional filename callback/clear→reset order. Engine-5 refresh writes are supplied explicitly, including empty, NUL and high-byte filenames. Actual122143/121987 callbacks and native runtime ownership remain open.
+
+Original executable/native runtime and complete Linux/macOS Rust/Bevy/Solari acceptance remain unverified.

docs/research/README.md

@@ -1199,3 +1199,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-867: Rust camera composition with recovered fallback](RUST_CAMERA_SPAWN.md).
+
+
+[RE-868: Original rotation cursor and refreshed filename callback policy](QVM_ROTATION_ADVANCE.md).

scripts/analyze_qvm_rotation_advance.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+import itertools
+from pathlib import Path
+from qvm_research_support import source
+from qvm_map_commands_support import rotation,put_string,CURSOR,ENABLED,LIMIT,WRITE
+from qvm_string_memory_support import cstring
+from analyze_qvm import write_json
+
+def main():
+ q,raw,h,ins=source();rows=[]
+ for enabled,cursor,limit,updated in itertools.product([-1,0,1],[-1,0,1,2147483647],[-1,0,1,2],[b'',b'bot.cfg',b'a\0tail',b'\xff']):
+  m={CURSOR:cursor,ENABLED:enabled,LIMIT:limit};b={};put_string(m,b,WRITE,b'previous.cfg',128);m,p,b=rotation(ins,m,b,updated);p.update(input=dict(enabled=enabled,cursor=cursor,limit=limit,updated=updated.hex()),cursor=m[CURSOR]&0xffffffff,filename=cstring(m,b,WRITE).hex());rows.append(p)
+ write_json(Path('docs/research/qvm-rotation-advance.json'),{'source':q['source'],'sha256':q['sha256'],'probes':rows,'limits':'Actual122230 and actual36038 over192 cases. Signed wrapped increment/threshold, engine-5 cvar refresh, optional122143 filename callback, clear cvar and121987 order. Engine refresh bytes supplied, downstream callbacks captured; no native bot/config/runtime claim.'})
+if __name__=='__main__':main()

scripts/qvm_map_commands_support.py

@@ -0,0 +1,30 @@
+"""Actual map/rotation byte routines; engine cvar and command effects are captured."""
+from qvm_camera_world_support import B,run
+from qvm_string_memory_support import cstring,copy_bounded
+from qvm_byte_memory_support import write_bytes
+from qvm_formatter_support import formatter_env,formatter,image_bytes
+from qvm_scoreboard_wire_support import final_format
+D=B+0x14000
+CURSOR=35145308
+ENABLED=35145312
+LIMIT=35142328
+WRITE=35142060
+MIRROR=34067112
+
+def put_string(m,b,address,data,capacity=0):
+    data=bytes(data)+b'\0';data=data.ljust(max(capacity,len(data)+8),b'\0');write_bytes(m,b,{address+j:v for j,v in enumerate(data)})
+def strlen(ins,m,a,b):
+    m,v,p,b=run(ins,m,36038,36121,20,a,b,base=D+0x1000);return m,v,{'actual_source_child':36038}
+def rotation(ins,m,b,updated):
+    requests=[];operations=[]
+    def refresh(i,m,a,bs):
+        requests.append({'target':-5,'arguments':a});data=(updated+b'\0').ljust(128,b'\0');cells={WRITE+j:v for j,v in enumerate(data)};operations.append({'op':'refresh'});return m,0,{'engine_update_supplied':True,'child_memory_bytes':cells}
+    def capture(t):
+        def call(i,m,a,bs):
+            requests.append({'target':t,'arguments':a})
+            if t==122143:operations.append({'op':'write','text':cstring(m,bs,a[8]).hex()})
+            if t==-6:operations.append({'op':'clear'})
+            if t==121987:operations.append({'op':'reset'})
+            return m,0,{'external_effect_captured':True}
+        return call
+    m,v,p,b=run(ins,m,122230,122286,24,b=b,handlers={-5:refresh,36038:strlen,122143:capture(122143),-6:capture(-6),121987:capture(121987)},base=D);p.update(requests=requests,operations=operations);return m,p,b

scripts/test_qvm_rotation_advance.py

@@ -0,0 +1,19 @@
+import json,unittest
+from pathlib import Path
+from test_qvm_exit_complete import signed
+class RotationTests(unittest.TestCase):
+ def test_counter_wrap_and_refreshed_cstring_gates(self):
+  rows=json.loads(Path('docs/research/qvm-rotation-advance.json').read_text())['probes'];self.assertEqual(len(rows),192)
+  for p in rows:
+   a=p['input'];cursor=signed(a['cursor']+1) if a['enabled'] else a['cursor'];wrapped=bool(a['enabled']) and cursor>=a['limit'];name=bytes.fromhex(a['updated']).split(b'\0')[0] if wrapped else b'previous.cfg';ops=[]
+   if wrapped:cursor=0;ops=[{'op':'refresh'}]+([{'op':'write','text':name.hex()},{'op':'clear'}] if name else [])+[{'op':'reset'}]
+   self.assertEqual(p['cursor'],cursor&0xffffffff);self.assertEqual(p['filename'],name.hex());self.assertEqual(p['operations'],ops)
+ def test_exact_cvar_callback_abi(self):
+  for p in json.loads(Path('docs/research/qvm-rotation-advance.json').read_text())['probes']:
+   wanted=[]
+   if p['operations']:
+    wanted=[(-5,{'8':35142044})]
+    if any(o['op']=='write' for o in p['operations']):wanted.extend([(122143,{'8':35142060}),(-6,{'8':60401,'12':60400})])
+    wanted.append((121987,{}))
+   self.assertEqual([(r['target'],r['arguments']) for r in p['requests']],wanted)
+if __name__=='__main__':unittest.main()

xtask/checks.tsv

@@ -2460,3 +2460,8 @@ report	scripts/analyze_rust_camera_spawn.py	docs/research/rust-camera-spawn.json
 edge	docs/research/rust-camera-spawn.json	scripts/test_rust_camera_spawn.py
 group	rust-camera-spawn	scripts/analyze_rust_camera_spawn.py
 edge	scripts/analyze_rust_camera_spawn.py	scripts/analyze_qvm_resumer_audit.py
+report	scripts/analyze_qvm_rotation_advance.py	docs/research/qvm-rotation-advance.json
+edge	docs/research/qvm-rotation-advance.json	scripts/test_qvm_rotation_advance.py
+group	rotation-advance	scripts/analyze_qvm_rotation_advance.py
+edge	scripts/analyze_qvm_rotation_advance.py	scripts/analyze_qvm_resumer_audit.py
+edge	scripts/qvm_map_commands_support.py	scripts/analyze_qvm_resumer_audit.py