gameplay: port override command ownership

crates/urt-gameplay/src/bin/urt-camera-world.rs

@@ -312,7 +312,7 @@ fn run() -> Result<String, String> {
             let mut state = w[0];
             let slot = w[1] as usize;
             let n = w[2] as usize;
-            let fallback = urt_gameplay::transition::View {
+            let _fallback = urt_gameplay::transition::View {
                 origin: w[3..6].try_into().unwrap(),
                 angles: w[6..9].try_into().unwrap(),
             };

crates/urt-gameplay/src/bin/urt-map-commands.rs

@@ -60,6 +60,25 @@ fn run() -> Result<String, String> {
                 rotation_json(&effects)
             ))
         }
+        "map" => {
+            let mut p = 0;
+            let mirror = bytes(&w, &mut p)?;
+            let current = bytes(&w, &mut p)?;
+            if p + 1 != w.len() {
+                return Err("invalid map response input".into());
+            }
+            let r = select_map(&mirror, &current).map_err(|e| format!("{e:?}"))?;
+            let cmd = r
+                .command
+                .as_ref()
+                .map(|v| format!("\"{}\"", hex(v)))
+                .unwrap_or("null".into());
+            Ok(format!(
+                "{{\"mirror\":\"{}\",\"command\":{cmd},\"operations\":{}}}",
+                hex(&r.mirror),
+                map_effects_json(&r.effects)
+            ))
+        }
         _ => Err("unknown command".into()),
     }
 }
@@ -72,3 +91,23 @@ fn main() {
         }
     }
 }
+
+fn map_effects_json(e: &[MapEffect]) -> String {
+    format!(
+        "[{}]",
+        e.iter()
+            .map(|e| match e {
+                MapEffect::ReadMap(v) => format!("{{\"op\":\"read-map\",\"text\":\"{}\"}}", hex(v)),
+                MapEffect::SetCycle(v) =>
+                    format!("{{\"op\":\"set-cycle\",\"value\":\"{}\"}}", hex(v)),
+                MapEffect::ClearNext => "{\"op\":\"clear-next\"}".into(),
+                MapEffect::Command { mode, text } => format!(
+                    "{{\"op\":\"command\",\"mode\":{mode},\"text\":\"{}\"}}",
+                    hex(text)
+                ),
+                MapEffect::Fallback => "{\"op\":\"fallback\"}".into(),
+            })
+            .collect::<Vec<String>>()
+            .join(",")
+    )
+}

crates/urt-gameplay/src/map_commands.rs

@@ -94,3 +94,70 @@ mod rotation_tests {
         assert_eq!(s, old);
     }
 }
+
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub enum MapEffect {
+    ReadMap(Vec<u8>),
+    SetCycle(Vec<u8>),
+    ClearNext,
+    Command { mode: u32, text: Vec<u8> },
+    Fallback,
+}
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct MapSelection {
+    pub mirror: Vec<u8>,
+    pub command: Option<Vec<u8>>,
+    pub effects: Vec<MapEffect>,
+}
+pub fn select_map(mirror: &[u8], current: &[u8]) -> Result<MapSelection, Error> {
+    let old = logical(mirror)?;
+    if old.is_empty() {
+        return Ok(MapSelection {
+            mirror: old,
+            command: None,
+            effects: vec![MapEffect::Fallback],
+        });
+    }
+    let mut name = logical(current)?;
+    name.truncate(127);
+    let mut command = b"map ".to_vec();
+    command.extend_from_slice(&old[..old.len().min(127)]);
+    command.push(b'\n');
+    let effects = vec![
+        MapEffect::ReadMap(name.clone()),
+        MapEffect::SetCycle(name.clone()),
+        MapEffect::ClearNext,
+        MapEffect::Command {
+            mode: 2,
+            text: command.clone(),
+        },
+    ];
+    Ok(MapSelection {
+        mirror: old,
+        command: Some(command),
+        effects,
+    })
+}
+#[cfg(test)]
+mod select_tests {
+    use super::*;
+    #[test]
+    fn mirror_gate_truncation_and_raw_command() {
+        let r = select_map(&[255; 128], b"current").unwrap();
+        assert_eq!(r.mirror, vec![255; 128]);
+        let mut cmd = b"map ".to_vec();
+        cmd.extend_from_slice(&[255; 127]);
+        cmd.push(b'\n');
+        assert_eq!(r.command, Some(cmd));
+        assert!(matches!(r.effects[2], MapEffect::ClearNext));
+        assert!(matches!(r.effects[3], MapEffect::Command { mode: 2, .. }));
+    }
+    #[test]
+    fn empty_gate_and_logical_nul() {
+        let r = select_map(b"\0tail", &[7; 4097]).unwrap();
+        assert_eq!(r.effects, vec![MapEffect::Fallback]);
+        assert_eq!(r.command, None);
+        assert_eq!(select_map(b"cycle", b"x\0tail").unwrap().mirror, b"cycle");
+        assert_eq!(select_map(&[1; 4097], b"x"), Err(Error::BytesTooLong));
+    }
+}

docs/FINDINGS.md

@@ -1610,3 +1610,6 @@ RE-813–822 replaces the scoreboard decimal assumption with actual37914 executi
 
 
 **RE-870:** 90 original7188 cases compose actual strlen, bounded-copy wrapper and original formatter. A nonempty override mirror records current engine mapname in g_nextCycleMap, copies the override into a127-byte local command buffer, requests engine g_NextMap clear and emits mode2 map command. VM mirror bytes remain unchanged; engine/native-copy and lower effects remain supplied/captured. [Evidence](research/QVM_MAP_SELECT.md).
+
+
+**RE-871:** Rust matches90 original map-selection cases with empty/NUL mirror gates,127-byte engine-mapname truncation, raw non-UTF8 bytes, unchanged VM mirror and exact truncated-override mode2 map command text. The typed effect order matches source cvar/read/command requests. Engine callbacks, native copy and actual command dispatch remain outside the port. [Evidence](research/RUST_MAP_SELECT.md).

docs/PROVISIONAL_TODO.md

@@ -1635,3 +1635,6 @@ RE-869: Rust matches192 original rotation cases, preserving signed cursor wrap,
 
 
 RE-870: 90 original7188 cases compose actual strlen, bounded-copy wrapper and original formatter. A nonempty override mirror records current engine mapname in g_nextCycleMap, copies the override into a127-byte local command buffer, requests engine g_NextMap clear and emits mode2 map command. VM mirror bytes remain unchanged; engine/native-copy and lower effects remain supplied/captured. Full runtime completion remains open. [Evidence](research/QVM_MAP_SELECT.md).
+
+
+RE-871: Rust matches90 original map-selection cases with empty/NUL mirror gates,127-byte engine-mapname truncation, raw non-UTF8 bytes, unchanged VM mirror and exact truncated-override mode2 map command text. The typed effect order matches source cvar/read/command requests. Engine callbacks, native copy and actual command dispatch remain outside the port. Full runtime completion remains open. [Evidence](research/RUST_MAP_SELECT.md).

docs/RESEARCH_LEDGER.md

@@ -2051,3 +2051,8 @@ Rust matches192 original rotation cases, preserving signed cursor wrap, enable/t
 ## 2026-10-27 — RE-870 Original map command branch with recovered copy and formatter
 
 90 original7188 cases compose actual strlen, bounded-copy wrapper and original formatter. A nonempty override mirror records current engine mapname in g_nextCycleMap, copies the override into a127-byte local command buffer, requests engine g_NextMap clear and emits mode2 map command. VM mirror bytes remain unchanged; engine/native-copy and lower effects remain supplied/captured. Focused `cargo xtask test-group map-select` 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.
+
+
+## 2026-10-27 — RE-871 Rust cycle-mirror map command policy
+
+Rust matches90 original map-selection cases with empty/NUL mirror gates,127-byte engine-mapname truncation, raw non-UTF8 bytes, unchanged VM mirror and exact truncated-override mode2 map command text. The typed effect order matches source cvar/read/command requests. Engine callbacks, native copy and actual command dispatch remain outside the port. Focused `cargo xtask test-group rust-map-select` 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.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1672,3 +1672,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-870 Original map command branch with recovered copy and formatter ([evidence](research/QVM_MAP_SELECT.md)).
+
+
+- [x] RE-871 Rust cycle-mirror map command policy ([evidence](research/RUST_MAP_SELECT.md)).

docs/research/README.md

@@ -1208,3 +1208,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-870: Original map command branch with recovered copy and formatter](QVM_MAP_SELECT.md).
+
+
+[RE-871: Rust cycle-mirror map command policy](RUST_MAP_SELECT.md).

docs/research/RUST_MAP_SELECT.md

@@ -0,0 +1,7 @@
+# Rust cycle-mirror map command policy
+
+RE-871. Reproduce with `python3 scripts/analyze_rust_map_select.py`; focused validation: `cargo xtask test-group rust-map-select`. [Machine report](rust-map-select.json).
+
+Rust matches90 original map-selection cases with empty/NUL mirror gates,127-byte engine-mapname truncation, raw non-UTF8 bytes, unchanged VM mirror and exact truncated-override mode2 map command text. The typed effect order matches source cvar/read/command requests. Engine callbacks, native copy and actual command dispatch remain outside the port.
+
+Original executable/native runtime and complete Linux/macOS Rust/Bevy/Solari acceptance remain unverified.

docs/research/rust-health-impulse.json

@@ -2985,7 +2985,7 @@
       "exit_code": 2
     }
   ],
-  "rust_unit_tests": 125,
+  "rust_unit_tests": 127,
   "source_report": "docs/research/qvm-health-impulse.json",
   "source_report_sha256": "625fd8064004ea6dbdf398d51d0af844d9c635ff04c0a0790886dddb6ab81e71"
 }

scripts/analyze_rust_map_select.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+import hashlib,json
+from pathlib import Path
+from rust_map_commands_support import binary,result,invoke
+from analyze_qvm import write_json
+from rust_map_commands_support import blob
+def encode(s):
+ a=s['input'];return [*blob(a['mirror']),*blob(a['current']),a['fallback']]
+def project(s):return {k:s[k] for k in ['mirror','command','operations']}
+def main():
+ b=binary();p=Path('docs/research/qvm-map-select.json');data=p.read_bytes();rows=[]
+ for s in json.loads(data)['probes']:rows.append({'source':project(s),'rust':result(b,'map',encode(s))})
+ write_json(Path('docs/research/rust-map-select.json'),{'source_report':str(p),'source_report_sha256':hashlib.sha256(data).hexdigest(),'probes':rows,'limits':'Rust matches90 original map-selection cases with empty/NUL mirror gates,127-byte engine-mapname truncation, raw non-UTF8 bytes, unchanged VM mirror and exact truncated-override mode2 map command text. The typed effect order matches source cvar/read/command requests. Engine callbacks, native copy and actual command dispatch remain outside the port.'})
+if __name__=='__main__':main()

scripts/test_rust_map_select.py

@@ -0,0 +1,9 @@
+import hashlib,json,unittest
+from pathlib import Path
+class PortTests(unittest.TestCase):
+ def test_all_original_cases(self):
+  r=json.loads(Path('docs/research/rust-map-select.json').read_text());src=json.loads(Path(r['source_report']).read_text());self.assertEqual(len(r['probes']),len(src['probes']));self.assertGreater(len(r['probes']),20)
+  for p in r['probes']:self.assertEqual(p['rust'],p['source'])
+ def test_source_identity(self):
+  r=json.loads(Path('docs/research/rust-map-select.json').read_text());self.assertEqual(hashlib.sha256(Path(r['source_report']).read_bytes()).hexdigest(),r['source_report_sha256'])
+if __name__=='__main__':unittest.main()

xtask/checks.tsv

@@ -2484,3 +2484,16 @@ report	scripts/analyze_qvm_map_select.py	docs/research/qvm-map-select.json
 edge	docs/research/qvm-map-select.json	scripts/test_qvm_map_select.py
 group	map-select	scripts/analyze_qvm_map_select.py
 edge	scripts/analyze_qvm_map_select.py	scripts/analyze_qvm_resumer_audit.py
+edge	Cargo.toml	scripts/analyze_rust_map_select.py
+edge	Cargo.lock	scripts/analyze_rust_map_select.py
+edge	crates/urt-gameplay/Cargo.toml	scripts/analyze_rust_map_select.py
+edge	crates/urt-gameplay/src/lib.rs	scripts/analyze_rust_map_select.py
+edge	crates/urt-gameplay/src/map_commands.rs	scripts/analyze_rust_map_select.py
+edge	crates/urt-gameplay/src/bin/urt-map-commands.rs	scripts/analyze_rust_map_select.py
+edge	docs/research/qvm-map-select.json	scripts/analyze_rust_map_select.py
+group	rust-map-select	scripts/analyze_rust_health_impulse.py
+group	gameplay	scripts/analyze_rust_map_select.py
+report	scripts/analyze_rust_map_select.py	docs/research/rust-map-select.json
+edge	docs/research/rust-map-select.json	scripts/test_rust_map_select.py
+group	rust-map-select	scripts/analyze_rust_map_select.py
+edge	scripts/analyze_rust_map_select.py	scripts/analyze_qvm_resumer_audit.py