gameplay: port client command byte rewriting

crates/urt-gameplay/src/bin/urt-client-processing.rs

@@ -59,6 +59,32 @@ fn main() {
                 out.route == ClientRoute::Continue
             );
         }
+        "command" => {
+            assert_eq!(w.len(), 13);
+            let mut state = CommandState {
+                angles: w[4..7].try_into().unwrap(),
+                saved: w[7..10].try_into().unwrap(),
+                buttons: w[10],
+                move_word: w[11],
+            };
+            rewrite_client_command(
+                &mut state,
+                CommandControl {
+                    pause: w[0],
+                    mode: w[1],
+                    flags: w[2],
+                    block: w[3],
+                },
+            );
+            println!(
+                r#"{{"angles":{},"saved":{},"buttons":{},"move_word":{},"command_time":{}}}"#,
+                list(&state.angles),
+                list(&state.saved),
+                state.buttons,
+                state.move_word,
+                w[12]
+            );
+        }
         _ => panic!("unknown policy"),
     }
 }

crates/urt-gameplay/src/client_processing.rs

@@ -127,3 +127,91 @@ mod routing_tests {
         );
     }
 }
+
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
+pub struct CommandState {
+    pub angles: [u32; 3],
+    pub saved: [u32; 3],
+    pub buttons: u32,
+    pub move_word: u32,
+}
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
+pub struct CommandControl {
+    pub pause: u32,
+    pub mode: u32,
+    pub flags: u32,
+    pub block: u32,
+}
+/// Original154256: lock restores saved angles; otherwise refresh the saved copy.
+/// Byte stores clear movement while preserving the adjacent low command byte.
+pub fn rewrite_client_command(state: &mut CommandState, control: CommandControl) {
+    let locked = control.pause & 1 != 0 || control.mode == 10 && control.flags & 16 != 0;
+    if locked {
+        state.angles = state.saved;
+    } else {
+        state.saved = state.angles;
+    }
+    if locked || control.block != 0 {
+        state.buttons = 0;
+        state.move_word &= 255;
+    }
+}
+#[cfg(test)]
+mod command_tests {
+    use super::*;
+    fn state() -> CommandState {
+        CommandState {
+            angles: [1, 2, 3],
+            saved: [4, 5, 6],
+            buttons: 7,
+            move_word: 0x807fff42,
+        }
+    }
+    #[test]
+    fn pause_bit_selection_and_angle_direction_are_preserved() {
+        let mut s = state();
+        rewrite_client_command(
+            &mut s,
+            CommandControl {
+                pause: 2,
+                mode: 0,
+                flags: 16,
+                block: 0,
+            },
+        );
+        assert_eq!(s.saved, [1, 2, 3]);
+        assert_eq!(s.move_word, 0x807fff42);
+        let mut s = state();
+        rewrite_client_command(
+            &mut s,
+            CommandControl {
+                pause: 1,
+                mode: 0,
+                flags: 0,
+                block: 0,
+            },
+        );
+        assert_eq!(s.angles, [4, 5, 6]);
+        assert_eq!(s.saved, [4, 5, 6]);
+        assert_eq!(s.move_word, 0x42);
+        assert_eq!(s.buttons, 0);
+    }
+    #[test]
+    fn server_override_masks_bytes_after_saving_angles() {
+        let mut s = state();
+        s.move_word = 0x010203ff;
+        rewrite_client_command(
+            &mut s,
+            CommandControl {
+                pause: 0,
+                mode: 0,
+                flags: 0,
+                block: 1,
+            },
+        );
+        assert_eq!(s.saved, [1, 2, 3]);
+        assert_eq!(s.angles, [1, 2, 3]);
+        assert_eq!(s.move_word, 255);
+        assert_eq!(s.buttons, 0);
+    }
+}

docs/FINDINGS.md

@@ -1885,3 +1885,5 @@ RE-974: Sixteen source154210-prefix paths recover intermission precedence, team3
 RE-975: Rust matches16 source routing cases, preserving intermission precedence and spectator callback suppression. Typed effects carry source slot/command-time inputs and keep actual callback bodies outside this contract. Unit tests cover outer-gate precedence and spectator-word suppression without conflating normal clients with routed ones. [Evidence](research/RUST_CLIENT_ROUTING.md).
 
 RE-976: Forty-eight source command-rewrite cases recover pause-mask1 and mode10/client-mask16 locking, saved-angle restore versus update, and independent server override. Clearing bytes493..495 preserves the low byte492 and command timestamp; buttons clear separately. Other pause bits alone do not trigger this lock. Native later movement execution remains outside this fragment. [Evidence](research/QVM_CLIENT_COMMAND_REWRITE.md).
+
+RE-977: Rust matches48 source command rewrites, retaining pause-mask1 selection, mode10/client-mask16 locking, saved-angle direction and independent server masking. The low adjacent command byte survives clearing movement bytes, and command time is not modified by this API. Unit tests cover non-locking pause bits, angle restore/save order and low-byte preservation. [Evidence](research/RUST_CLIENT_COMMAND_REWRITE.md).

docs/PROVISIONAL_TODO.md

@@ -1939,3 +1939,5 @@ RE-964–973 completed timer deadline/phase/recovery contracts, whole-body compo
 - [x] RE-975 Rust early client routing with captured callbacks ([evidence](research/RUST_CLIENT_ROUTING.md)).
 
 - [x] RE-976 Original command angle preservation and movement-byte masking ([evidence](research/QVM_CLIENT_COMMAND_REWRITE.md)).
+
+- [x] RE-977 Rust client command rewriting and byte preservation ([evidence](research/RUST_CLIENT_COMMAND_REWRITE.md)).

docs/RESEARCH_LEDGER.md

@@ -2577,3 +2577,7 @@ Rust matches16 source routing cases, preserving intermission precedence and spec
 ## 2026-10-28 — RE-976 Original command angle preservation and movement-byte masking
 
 Forty-eight source command-rewrite cases recover pause-mask1 and mode10/client-mask16 locking, saved-angle restore versus update, and independent server override. Clearing bytes493..495 preserves the low byte492 and command timestamp; buttons clear separately. Other pause bits alone do not trigger this lock. Native later movement execution remains outside this fragment. Focused `cargo xtask test-group qvm-client-command-rewrite` passes with deterministic report regeneration, relevant regressions and storage/documentation/whitespace checks. Full suite deferred to the tenth-commit boundary. Original assets unchanged; native IO effects remain captured.
+
+## 2026-10-28 — RE-977 Rust client command rewriting and byte preservation
+
+Rust matches48 source command rewrites, retaining pause-mask1 selection, mode10/client-mask16 locking, saved-angle direction and independent server masking. The low adjacent command byte survives clearing movement bytes, and command time is not modified by this API. Unit tests cover non-locking pause bits, angle restore/save order and low-byte preservation. Focused `cargo xtask test-group rust-client-command-rewrite` passes with deterministic report regeneration, relevant regressions and storage/documentation/whitespace checks. Full suite deferred to the tenth-commit boundary. Original assets unchanged; native IO effects remain captured.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1976,3 +1976,5 @@ RE-964–973 recover the complete bounded timer body and its caller timing prefi
 - [x] RE-975 Rust early client routing with captured callbacks ([evidence](research/RUST_CLIENT_ROUTING.md)).
 
 - [x] RE-976 Original command angle preservation and movement-byte masking ([evidence](research/QVM_CLIENT_COMMAND_REWRITE.md)).
+
+- [x] RE-977 Rust client command rewriting and byte preservation ([evidence](research/RUST_CLIENT_COMMAND_REWRITE.md)).

docs/research/README.md

@@ -1511,3 +1511,5 @@ The extension collector adds five focused tests for native tail calls, command-r
 - [RE-975: Rust early client routing with captured callbacks](RUST_CLIENT_ROUTING.md).
 
 - [RE-976: Original command angle preservation and movement-byte masking](QVM_CLIENT_COMMAND_REWRITE.md).
+
+- [RE-977: Rust client command rewriting and byte preservation](RUST_CLIENT_COMMAND_REWRITE.md).

docs/research/RUST_CLIENT_COMMAND_REWRITE.md

@@ -0,0 +1,5 @@
+# Rust client command rewriting and byte preservation
+
+RE-977. Focused validation: `cargo xtask test-group rust-client-command-rewrite`. [Machine report](rust-client-command-rewrite.json).
+
+Rust matches48 source command rewrites, retaining pause-mask1 selection, mode10/client-mask16 locking, saved-angle direction and independent server masking. The low adjacent command byte survives clearing movement bytes, and command time is not modified by this API. Unit tests cover non-locking pause bits, angle restore/save order and low-byte preservation.

docs/research/rust-client-command-rewrite.json

@@ -0,0 +1,1543 @@
+{
+  "limits": "Finite source/Rust contract parity; native time/file/network replies remain supplied or captured.",
+  "probes": [
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 2155872066,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 305419896,
+        "command_time": 12345,
+        "move_word": 16909311,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      },
+      "source": {
+        "angles": [
+          2864434397,
+          2147483647,
+          7
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          2864434397,
+          2147483647,
+          7
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 66,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    },
+    {
+      "rust": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      },
+      "source": {
+        "angles": [
+          287454020,
+          2147483648,
+          4294967295
+        ],
+        "buttons": 0,
+        "command_time": 12345,
+        "move_word": 255,
+        "saved": [
+          287454020,
+          2147483648,
+          4294967295
+        ]
+      }
+    }
+  ],
+  "source_report": "docs/research/qvm-client-command-rewrite.json",
+  "source_report_sha256": "c202d4d3374af1f7c83f1948d7dc643504d81fcbdd3c4c8628f8af220f5ff691"
+}

docs/research/rust-health-impulse.json

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

scripts/analyze_rust_client_command_rewrite.py

@@ -0,0 +1,16 @@
+"""Compare recovered Rust policy with original QVM fixtures."""
+import hashlib,json,os,subprocess
+from pathlib import Path
+from analyze_qvm import write_json
+from rust_lifecycle_support import result
+
+def main():
+ subprocess.run(['cargo','build','--offline','--package','urt-gameplay','--bin','urt-client-processing'],check=True,capture_output=True)
+ binary=Path(os.environ.get('CARGO_TARGET_DIR','target'))/'debug'/'urt-client-processing'
+ path=Path('docs/research/qvm-client-command-rewrite.json');data=path.read_bytes();probes=[]
+ for p in json.loads(data)['probes']:
+  probes.append(dict(source={k:p[k] for k in ['angles', 'saved', 'buttons', 'move_word', 'command_time']},rust=result(binary,'command',encode(p['input']))))
+ write_json(Path('docs/research/rust-client-command-rewrite.json'),dict(source_report=str(path),source_report_sha256=hashlib.sha256(data).hexdigest(),probes=probes,limits='Finite source/Rust contract parity; native time/file/network replies remain supplied or captured.'))
+
+def encode(a):return [a['pause'],a['mode'],a['flags'],a['block'],*a['angles'],*a['saved'],a['buttons'],a['move_word'],a['command_time']]
+if __name__=='__main__':main()

scripts/test_rust_client_command_rewrite.py

@@ -0,0 +1,9 @@
+import hashlib,json,unittest
+from pathlib import Path
+class PortTests(unittest.TestCase):
+ def test_original_parity(self):
+  r=json.loads(Path('docs/research/rust-client-command-rewrite.json').read_text());self.assertGreaterEqual(len(r['probes']),12)
+  for p in r['probes']:self.assertEqual(p['source'],p['rust'])
+ def test_identity(self):
+  r=json.loads(Path('docs/research/rust-client-command-rewrite.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

@@ -3570,3 +3570,25 @@ report	scripts/analyze_qvm_client_command_rewrite.py	docs/research/qvm-client-co
 edge	docs/research/qvm-client-command-rewrite.json	scripts/test_qvm_client_command_rewrite.py
 group	qvm-client-command-rewrite	scripts/analyze_qvm_client_command_rewrite.py
 edge	scripts/analyze_qvm_client_command_rewrite.py	scripts/analyze_qvm_resumer_audit.py
+report	scripts/analyze_rust_client_command_rewrite.py	docs/research/rust-client-command-rewrite.json
+edge	docs/research/rust-client-command-rewrite.json	scripts/test_rust_client_command_rewrite.py
+group	rust-client-command-rewrite	scripts/analyze_rust_client_command_rewrite.py
+edge	scripts/analyze_rust_client_command_rewrite.py	scripts/analyze_qvm_resumer_audit.py
+edge	Cargo.toml	scripts/analyze_rust_client_command_rewrite.py
+edge	Cargo.lock	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/Cargo.toml	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/lib.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/filter_loading.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/filter_lifecycle.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/native_policy.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/bin/urt-filter-loading.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/qvm_format.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	docs/research/qvm-client-command-rewrite.json	scripts/analyze_rust_client_command_rewrite.py
+group	rust-client-command-rewrite	scripts/analyze_rust_health_impulse.py
+group	gameplay	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/filter_commands.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/bin/urt-filter-commands.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/client_timer.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/bin/urt-client-timer.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/client_processing.rs	scripts/analyze_rust_client_command_rewrite.py
+edge	crates/urt-gameplay/src/bin/urt-client-processing.rs	scripts/analyze_rust_client_command_rewrite.py