docs: update README and docs for v0.6.0 architecture and deployment, preserve current server/shared/wasm updates

wasm/Cargo.toml

@@ -18,3 +18,4 @@ getrandom = { version = "0.2", features = ["js"] }
 hex = "0.4"
 base64 = "0.22"
 serde-wasm-bindgen = "0.6"
+tracing = "0.1"

wasm/src/vm_extensions.rs

@@ -1,4 +1,5 @@
 use std::cell::RefCell;
+use std::time::Instant;
 use wasm_bindgen::prelude::*;
 
 thread_local! {
@@ -17,24 +18,27 @@ pub fn init_gene_state(gene_size: u32) -> bool {
 }
 
 #[wasm_bindgen]
-pub fn preview_gene_commitment(order_b64: &str) -> String {
-    let order = match shared::vm_extensions::decode_order_b64(0, order_b64) {
+pub fn preview_gene_commitment(order_b64: &str, session_id: &str, mutation_step: u64, rounds: u8) -> String {
+    let order = match shared::vm_extensions::decode_order_b64(mutation_step, order_b64) {
         Ok(order) => order,
         Err(_) => return String::new(),
     };
 
+    let start = Instant::now();
     let candidate = GENE_STATE.with(|slot| {
         let state = slot.borrow();
         let Some(current) = state.as_ref() else {
             return None;
         };
-        shared::vm_extensions::apply_program_clone(current, &order.program).ok()
+        shared::vm_extensions::apply_program_clone_with_rounds(current, &order.program, if rounds == 0 { shared::constants::DEFAULT_MUTATION_ROUNDS } else { rounds }).ok()
     });
+    let elapsed = start.elapsed();
+    tracing::debug!(session_id = %session_id, mutation_step = mutation_step, elapsed_ms = elapsed.as_millis(), "wasm mutation preview execution");
 
     let Some(candidate) = candidate else {
         return String::new();
     };
-    let commitment = shared::gene::commitment_hex(&candidate);
+    let commitment = shared::gene::commitment_hex_with_context(&candidate, session_id, mutation_step);
     PREVIEW_STATE.with(|slot| *slot.borrow_mut() = Some(candidate));
     commitment
 }
@@ -55,11 +59,11 @@ pub fn discard_gene_preview() {
 }
 
 #[wasm_bindgen]
-pub fn current_gene_commitment() -> String {
+pub fn current_gene_commitment(session_id: &str, mutation_step: u64) -> String {
     GENE_STATE.with(|slot| {
         slot.borrow()
             .as_ref()
-            .map(shared::gene::commitment_hex)
+            .map(|state| shared::gene::commitment_hex_with_context(state, session_id, mutation_step))
             .unwrap_or_default()
     })
 }
@@ -77,7 +81,7 @@ mod tests {
     #[test]
     fn test_init_gene_state_success() {
         assert!(init_gene_state(64));
-        let commitment = current_gene_commitment();
+        let commitment = current_gene_commitment("deadbeef", 1);
         assert_eq!(commitment.len(), 64);
     }
 
@@ -90,43 +94,48 @@ mod tests {
     fn test_preview_requires_initialized_state() {
         discard_gene_preview();
         GENE_STATE.with(|slot| *slot.borrow_mut() = None);
-        let c = preview_gene_commitment(&order_b64(vec![
-            shared::vm_extensions::OP_MUTATE_POINT,
-            0,
-            0,
+        let c = preview_gene_commitment(
+            &order_b64(vec![
+                shared::vm_extensions::OP_MUTATE_POINT,
+                0,
+                0,
+                1,
+            ]),
+            "deadbeef",
             1,
-        ]));
+            0,
+        );
         assert!(c.is_empty());
     }
 
     #[test]
     fn test_preview_rejects_invalid_order() {
         init_gene_state(16);
-        let c = preview_gene_commitment("***bad-base64***");
+        let c = preview_gene_commitment("***bad-base64***", "deadbeef", 1, 0);
         assert!(c.is_empty());
     }
 
     #[test]
     fn test_commit_applies_preview() {
         init_gene_state(16);
-        let before = current_gene_commitment();
+        let before = current_gene_commitment("deadbeef", 1);
         let order = order_b64(vec![shared::vm_extensions::OP_MUTATE_POINT, 0, 0, 1]);
-        let preview = preview_gene_commitment(&order);
+        let preview = preview_gene_commitment(&order, "deadbeef", 1, 0);
         assert_ne!(preview, before);
         assert!(commit_gene_preview());
-        let after = current_gene_commitment();
+        let after = current_gene_commitment("deadbeef", 1);
         assert_eq!(preview, after);
     }
 
     #[test]
     fn test_discard_preview_keeps_committed_state() {
         init_gene_state(16);
-        let before = current_gene_commitment();
+        let before = current_gene_commitment("deadbeef", 1);
         let order = order_b64(vec![shared::vm_extensions::OP_MUTATE_POINT, 0, 0, 0xFF]);
-        let preview = preview_gene_commitment(&order);
+        let preview = preview_gene_commitment(&order, "deadbeef", 1, 0);
         assert_ne!(preview, before);
         discard_gene_preview();
-        let after = current_gene_commitment();
+        let after = current_gene_commitment("deadbeef", 1);
         assert_eq!(before, after);
     }
 
@@ -161,11 +170,11 @@ mod tests {
         };
         let b64 = shared::vm_extensions::encode_order_b64(&order);
 
-        let preview = preview_gene_commitment(&b64);
+        let preview = preview_gene_commitment(&b64, "deadbeef", 3, 0);
 
         let mut expected = shared::gene::new_state(16).unwrap();
-        shared::vm_extensions::apply_program(&mut expected, &order.program).unwrap();
-        assert_eq!(preview, shared::gene::commitment_hex(&expected));
+        shared::vm_extensions::apply_program_with_rounds(&mut expected, &order.program, shared::constants::DEFAULT_MUTATION_ROUNDS).unwrap();
+        assert_eq!(preview, shared::gene::commitment_hex_with_context(&expected, "deadbeef", 3));
     }
 
     #[test]
@@ -178,13 +187,18 @@ mod tests {
             let order = shared::vm_extensions::generate_order_with_rng(&mut rng, step + 1, 64);
             let b64 = shared::vm_extensions::encode_order_b64(&order);
 
-            let preview = preview_gene_commitment(&b64);
-            shared::vm_extensions::apply_program(&mut expected, &order.program).unwrap();
-            let expected_commitment = shared::gene::commitment_hex(&expected);
+            let preview = preview_gene_commitment(&b64, "deadbeef", step + 1, 0);
+            shared::vm_extensions::apply_program_with_rounds(
+                &mut expected,
+                &order.program,
+                shared::constants::DEFAULT_MUTATION_ROUNDS,
+            )
+            .unwrap();
+            let expected_commitment = shared::gene::commitment_hex_with_context(&expected, "deadbeef", step + 1);
 
             assert_eq!(preview, expected_commitment);
             assert!(commit_gene_preview());
-            assert_eq!(current_gene_commitment(), expected_commitment);
+            assert_eq!(current_gene_commitment("deadbeef", step + 1), expected_commitment);
         }
     }
 }