Skip to main content

webizen_render/
telemetry.rs

1//! System Telemetry Data Contract.
2//!
3//! Re-exports the canonical 48-byte GPU telemetry contract from
4//! `etalon_render::webizen_core::telemetry`.
5
6pub use etalon_render::webizen_core::telemetry::*;
7
8#[cfg(test)]
9mod tests {
10    use super::*;
11
12    #[test]
13    fn test_system_telemetry_size() {
14        // Must be exactly 48 bytes for WGSL alignment
15        assert_eq!(std::mem::size_of::<SystemTelemetry>(), 48);
16    }
17
18    #[test]
19    fn test_system_telemetry_alignment() {
20        // Must be at least 4-byte aligned for f32
21        assert_eq!(std::mem::align_of::<SystemTelemetry>(), 4);
22    }
23
24    #[test]
25    fn test_new_creates_defaults() {
26        let telemetry = SystemTelemetry::new();
27        assert_eq!(telemetry.memory_pressure, 0.0);
28        assert_eq!(telemetry.network_ripple, 0.0);
29        assert_eq!(telemetry.baking_crystallization, 0.0);
30        assert_eq!(telemetry.logic_flashes, 0.0);
31        assert_eq!(telemetry.llm_heat, 0.0);
32        assert_eq!(telemetry.quantum_activity, 0.0);
33        assert_eq!(telemetry.spectral_shift, 0.0);
34        assert_eq!(telemetry.temporal_pulse, 0.0);
35        assert_eq!(telemetry.epistemic_density, 0.0);
36        assert_eq!(telemetry.manifold_pressure, 0.0);
37        assert_eq!(telemetry._padding, [0.0, 0.0]);
38    }
39
40    #[test]
41    fn test_update_memory_pressure_clamps() {
42        let mut telemetry = SystemTelemetry::new();
43        telemetry.update_memory_pressure(0.5);
44        assert_eq!(telemetry.memory_pressure, 0.5);
45
46        telemetry.update_memory_pressure(1.5);
47        assert_eq!(telemetry.memory_pressure, 1.0);
48
49        telemetry.update_memory_pressure(-0.5);
50        assert_eq!(telemetry.memory_pressure, 0.0);
51    }
52
53    #[test]
54    fn test_update_network_ripple_normalizes() {
55        let mut telemetry = SystemTelemetry::new();
56        telemetry.update_network_ripple(5_000_000.0);
57        assert_eq!(telemetry.network_ripple, 0.5);
58
59        telemetry.update_network_ripple(20_000_000.0);
60        assert_eq!(telemetry.network_ripple, 1.0);
61    }
62
63    #[test]
64    fn test_update_llm_heat_normalizes() {
65        let mut telemetry = SystemTelemetry::new();
66        telemetry.update_llm_heat(50.0);
67        assert_eq!(telemetry.llm_heat, 0.5);
68
69        telemetry.update_llm_heat(200.0);
70        assert_eq!(telemetry.llm_heat, 1.0);
71    }
72
73    #[test]
74    fn test_to_bytes_length() {
75        let telemetry = SystemTelemetry::new();
76        let bytes = telemetry.to_bytes();
77        assert_eq!(bytes.len(), 48);
78    }
79
80    #[test]
81    fn test_copy_semantics() {
82        let telemetry1 = SystemTelemetry::new();
83        let telemetry2 = telemetry1; // Should copy, not move
84        assert_eq!(telemetry1.memory_pressure, 0.0);
85        assert_eq!(telemetry2.memory_pressure, 0.0);
86    }
87
88    #[test]
89    fn ambient_helpers_are_derived_and_stable() {
90        let mut telemetry = SystemTelemetry::new();
91        telemetry.set_network_ripple(0.8);
92        telemetry.set_temporal_pulse(0.5);
93        telemetry.set_manifold_pressure(0.2);
94        assert!((telemetry.ambient_wind_strength() - 0.68).abs() < 1e-6);
95        assert_eq!(SystemTelemetry::ambient_world_frame(1.0), 60);
96        assert_eq!(SystemTelemetry::ambient_world_frame(f32::NAN), 0);
97    }
98}