gameplay: port camera placement words

crates/urt-gameplay/src/bin/urt-transition.rs

@@ -0,0 +1,107 @@
+use urt_gameplay::transition::*;
+fn array(v: &[u32]) -> String {
+    format!(
+        "[{}]",
+        v.iter()
+            .map(|v| v.to_string())
+            .collect::<Vec<_>>()
+            .join(",")
+    )
+}
+fn object(keys: &[u32], values: &[u32]) -> String {
+    format!(
+        "{{{}}}",
+        keys.iter()
+            .zip(values)
+            .map(|(k, v)| format!("\"{k}\":{v}"))
+            .collect::<Vec<_>>()
+            .join(",")
+    )
+}
+fn run() -> Result<String, String> {
+    let a = std::env::args().skip(1).collect::<Vec<_>>();
+    let kind = a.first().ok_or("missing command")?;
+    let w = a[1..]
+        .iter()
+        .map(|s| s.parse::<u32>().map_err(|_| "invalid word".to_string()))
+        .collect::<Result<Vec<_>, _>>()?;
+    match kind.as_str() {
+        "camera" => {
+            if w.len() != 9 || w[2] > 1 {
+                return Err("invalid camera input".into());
+            }
+            let blank = CameraPlayer {
+                movement: 0xaabbccdd,
+                origin: [0xaabbccdd; 3],
+                velocity: [0xaabbccdd; 3],
+                field104: 0xaabbccdd,
+                angles: [0xaabbccdd; 3],
+                mode3108: 0xaabbccdd,
+                field4324: 0xaabbccdd,
+            };
+            let mut players = [blank.clone(), blank];
+            let slot = w[2] as usize;
+            players[slot].mode3108 = w[0];
+            players[slot].field4324 = w[1];
+            let mut entity = CameraEntity {
+                origin: [0x12345678; 3],
+                clear: [0x12345678; 6],
+            };
+            place_camera(
+                &mut entity,
+                &mut players[slot],
+                w[3..6].try_into().unwrap(),
+                w[6..9].try_into().unwrap(),
+            );
+            let e = object(
+                &[4, 8, 92, 96, 100, 156, 160, 180, 460],
+                &[
+                    entity.clear[0],
+                    entity.clear[1],
+                    entity.origin[0],
+                    entity.origin[1],
+                    entity.origin[2],
+                    entity.clear[2],
+                    entity.clear[3],
+                    entity.clear[4],
+                    entity.clear[5],
+                ],
+            );
+            let c = players
+                .iter()
+                .map(|p| {
+                    object(
+                        &[4, 20, 24, 28, 32, 36, 40, 104, 152, 156, 160, 3108, 4324],
+                        &[
+                            p.movement,
+                            p.origin[0],
+                            p.origin[1],
+                            p.origin[2],
+                            p.velocity[0],
+                            p.velocity[1],
+                            p.velocity[2],
+                            p.field104,
+                            p.angles[0],
+                            p.angles[1],
+                            p.angles[2],
+                            p.mode3108,
+                            p.field4324,
+                        ],
+                    )
+                })
+                .collect::<Vec<_>>()
+                .join(",");
+            Ok(format!("{{\"entity\":{e},\"clients\":[{c}]}}"))
+        }
+        _ => Err("unknown command".into()),
+    }
+}
+fn main() {
+    match run() {
+        Ok(s) => println!("{s}"),
+        Err(e) => {
+            eprintln!("{e}");
+            std::process::exit(2);
+        }
+    }
+}

crates/urt-gameplay/src/lib.rs

@@ -173,3 +173,5 @@ pub mod exit_prefix;
 pub mod exit_rules;
 
 pub mod intermission;
+
+pub mod transition;

crates/urt-gameplay/src/transition.rs

@@ -0,0 +1,78 @@
+//! Bounded original camera, map transition and temporary event contracts.
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct CameraEntity {
+    pub origin: [u32; 3],
+    pub clear: [u32; 6],
+}
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct CameraPlayer {
+    pub movement: u32,
+    pub origin: [u32; 3],
+    pub velocity: [u32; 3],
+    pub field104: u32,
+    pub angles: [u32; 3],
+    pub mode3108: u32,
+    pub field4324: u32,
+}
+pub fn place_camera(
+    entity: &mut CameraEntity,
+    player: &mut CameraPlayer,
+    origin: [u32; 3],
+    angles: [u32; 3],
+) {
+    entity.origin = origin;
+    entity.clear = [0; 6];
+    player.origin = origin;
+    player.angles = angles;
+    player.velocity = [0; 3];
+    player.movement = 5;
+    player.field104 = 0;
+}
+#[cfg(test)]
+mod camera_tests {
+    use super::*;
+    #[test]
+    fn exact_raw_words_and_clears() {
+        let mut e = CameraEntity {
+            origin: [1; 3],
+            clear: [1; 6],
+        };
+        let mut p = CameraPlayer {
+            movement: 1,
+            origin: [1; 3],
+            velocity: [1; 3],
+            field104: 1,
+            angles: [1; 3],
+            mode3108: 2,
+            field4324: 7,
+        };
+        let v = [0x7fc01234, 0x80000000, 0x7f800000];
+        place_camera(&mut e, &mut p, v, v);
+        assert_eq!(e.origin, v);
+        assert_eq!(p.angles, v);
+        assert_eq!((p.mode3108, p.field4324), (2, 7));
+        assert_eq!(
+            (e.clear, p.velocity, p.movement, p.field104),
+            ([0; 6], [0; 3], 5, 0)
+        );
+    }
+    #[test]
+    fn repeated_placement_replaces_view() {
+        let mut e = CameraEntity {
+            origin: [1; 3],
+            clear: [1; 6],
+        };
+        let mut p = CameraPlayer {
+            movement: 1,
+            origin: [1; 3],
+            velocity: [1; 3],
+            field104: 1,
+            angles: [1; 3],
+            mode3108: 0,
+            field4324: 0,
+        };
+        place_camera(&mut e, &mut p, [2; 3], [3; 3]);
+        place_camera(&mut e, &mut p, [4; 3], [5; 3]);
+        assert_eq!((e.origin, p.origin, p.angles), ([4; 3], [4; 3], [5; 3]));
+    }
+}

docs/FINDINGS.md

@@ -1532,3 +1532,6 @@ RE-813–822 replaces the scoreboard decimal assumption with actual37914 executi
 
 
 **RE-844:** 72 original 6575 fixtures recover entity/player origin and view-angle copies, velocity clear, movement type5 and cleared entity/client fields. Coherent byte copies preserve arbitrary float words, including NaN payloads; two entity-to-client targets prove indirection. Mode/field4324 gates converge without extra effects. Native renderer/camera integration remains open. [Evidence](research/QVM_CAMERA_PLACE.md).
+
+
+**RE-845:** Rust matches all 72 original camera fixtures, copying raw float words exactly and clearing the verified fields. The parity adapter resolves either entity-to-client target; the library accepts an already-resolved mutable client. Native camera/rendering and unrestricted pointer alias behavior remain open. [Evidence](research/RUST_CAMERA_PLACE.md).

docs/PROVISIONAL_TODO.md

@@ -1551,3 +1551,6 @@ RE-843: Rust composes recovered tie, readiness, begin and exit-log policies with
 
 
 RE-844: 72 original 6575 fixtures recover entity/player origin and view-angle copies, velocity clear, movement type5 and cleared entity/client fields. Coherent byte copies preserve arbitrary float words, including NaN payloads; two entity-to-client targets prove indirection. Mode/field4324 gates converge without extra effects. Native renderer/camera integration remains open. Full runtime completion remains open. [Evidence](research/QVM_CAMERA_PLACE.md).
+
+
+RE-845: Rust matches all 72 original camera fixtures, copying raw float words exactly and clearing the verified fields. The parity adapter resolves either entity-to-client target; the library accepts an already-resolved mutable client. Native camera/rendering and unrestricted pointer alias behavior remain open. Full runtime completion remains open. [Evidence](research/RUST_CAMERA_PLACE.md).

docs/RESEARCH_LEDGER.md

@@ -1898,3 +1898,8 @@ Batch RE-834–843 boundary: the single `cargo xtask test-full --since 5f7b2df8`
 ## 2026-10-27 — RE-844 Original intermission camera placement and client indirection
 
 72 original 6575 fixtures recover entity/player origin and view-angle copies, velocity clear, movement type5 and cleared entity/client fields. Coherent byte copies preserve arbitrary float words, including NaN payloads; two entity-to-client targets prove indirection. Mode/field4324 gates converge without extra effects. Native renderer/camera integration remains open. Focused `cargo xtask test-group camera-place` 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-845 Rust intermission camera placement
+
+Rust matches all 72 original camera fixtures, copying raw float words exactly and clearing the verified fields. The parity adapter resolves either entity-to-client target; the library accepts an already-resolved mutable client. Native camera/rendering and unrestricted pointer alias behavior remain open. Focused `cargo xtask test-group rust-camera-place` 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

@@ -1588,3 +1588,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-844 Original intermission camera placement and client indirection ([evidence](research/QVM_CAMERA_PLACE.md)).
+
+
+- [x] RE-845 Rust intermission camera placement ([evidence](research/RUST_CAMERA_PLACE.md)).

docs/research/README.md

@@ -1126,3 +1126,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-844: Original intermission camera placement and client indirection](QVM_CAMERA_PLACE.md).
+
+
+[RE-845: Rust intermission camera placement](RUST_CAMERA_PLACE.md).

docs/research/RUST_CAMERA_PLACE.md

@@ -0,0 +1,7 @@
+# Rust intermission camera placement
+
+RE-845. Reproduce with `python3 scripts/analyze_rust_camera_place.py`; focused validation: `cargo xtask test-group rust-camera-place`. [Machine report](rust-camera-place.json).
+
+Rust matches all 72 original camera fixtures, copying raw float words exactly and clearing the verified fields. The parity adapter resolves either entity-to-client target; the library accepts an already-resolved mutable client. Native camera/rendering and unrestricted pointer alias behavior remain open.
+
+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": 99,
+  "rust_unit_tests": 101,
   "source_report": "docs/research/qvm-health-impulse.json",
   "source_report_sha256": "625fd8064004ea6dbdf398d51d0af844d9c635ff04c0a0790886dddb6ab81e71"
 }

scripts/analyze_rust_camera_place.py

@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+import hashlib,json
+from pathlib import Path
+from rust_transition_support import binary,result,invoke
+from analyze_qvm import write_json
+def encode(s):
+ a=s['input'];return [a['mode'],a['special'],a['slot'],*a['origin'],*a['angles']]
+def project(s):return {k:s[k] for k in ['entity','clients']}
+def main():
+ b=binary();p=Path('docs/research/qvm-camera-place.json');data=p.read_bytes();rows=[]
+ for s in json.loads(data)['probes']:rows.append({'source':project(s),'rust':result(b,'camera',encode(s))})
+ write_json(Path('docs/research/rust-camera-place.json'),{'source_report':str(p),'source_report_sha256':hashlib.sha256(data).hexdigest(),'probes':rows,'limits':'Rust matches all 72 original camera fixtures, copying raw float words exactly and clearing the verified fields. The parity adapter resolves either entity-to-client target; the library accepts an already-resolved mutable client. Native camera/rendering and unrestricted pointer alias behavior remain open.'})
+if __name__=='__main__':main()

scripts/rust_transition_support.py

@@ -0,0 +1,7 @@
+"""Build and invoke the scoped transition parity adapter."""
+import os,subprocess
+from pathlib import Path
+from rust_lifecycle_support import result,invoke
+def binary():
+ subprocess.run(['cargo','build','--offline','--package','urt-gameplay','--bin','urt-transition'],capture_output=True,text=True,check=True)
+ return Path(os.environ.get('CARGO_TARGET_DIR','target'))/'debug'/'urt-transition'

scripts/test_rust_camera_place.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-camera-place.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-camera-place.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

@@ -2249,3 +2249,18 @@ edge	docs/research/qvm-camera-place.json	scripts/test_qvm_camera_place.py
 group	camera-place	scripts/analyze_qvm_camera_place.py
 edge	scripts/analyze_qvm_camera_place.py	scripts/analyze_qvm_resumer_audit.py
 edge	scripts/qvm_transition_support.py	scripts/analyze_qvm_resumer_audit.py
+edge	Cargo.toml	scripts/analyze_rust_camera_place.py
+edge	Cargo.lock	scripts/analyze_rust_camera_place.py
+edge	crates/urt-gameplay/Cargo.toml	scripts/analyze_rust_camera_place.py
+edge	crates/urt-gameplay/src/lib.rs	scripts/analyze_rust_camera_place.py
+edge	crates/urt-gameplay/src/transition.rs	scripts/analyze_rust_camera_place.py
+edge	crates/urt-gameplay/src/bin/urt-transition.rs	scripts/analyze_rust_camera_place.py
+edge	docs/research/qvm-camera-place.json	scripts/analyze_rust_camera_place.py
+edge	crates/urt-gameplay/src/transition.rs	scripts/analyze_rust_health_impulse.py
+group	rust-camera-place	scripts/analyze_rust_health_impulse.py
+group	gameplay	scripts/analyze_rust_camera_place.py
+report	scripts/analyze_rust_camera_place.py	docs/research/rust-camera-place.json
+edge	docs/research/rust-camera-place.json	scripts/test_rust_camera_place.py
+group	rust-camera-place	scripts/analyze_rust_camera_place.py
+edge	scripts/analyze_rust_camera_place.py	scripts/analyze_qvm_resumer_audit.py
+edge	scripts/rust_transition_support.py	scripts/analyze_qvm_resumer_audit.py