Struct HarmonyVector 

pub struct HarmonyVector {
    pub cpu_load: f32,
    pub memory_pressure: f32,
    pub swap_usage: f32,
    pub thermal_state: ThermalState,
    pub temperature_c: Option<f32>,
    pub battery_state: BatteryState,
    pub battery_percent: f32,
    pub disk_io_rate: f32,
    pub active: bool,
    pub guna: GunaTag,
    pub timestamp: DateTime<Utc>,
}

Harmony Vector — real-time hardware state snapshot.

Superset of Homeostasis with additional signals: swap, thermal, battery, and disk I/O. Feeds into DharmaGate via the From<HarmonyVector> for Homeostasis conversion.

This is the Lakshmi (Harmony Monitor) of the Mandala OS — it observes the Annamaya Kosha (Hardware Layer) and reports the system’s physical state to the governance and consciousness layers.

Fields

cpu_load: f32

CPU load fraction (0.0 = idle, 1.0 = saturated).

memory_pressure: f32

Memory pressure fraction (0.0 = plenty, 1.0 = critical).

swap_usage: f32

Swap usage fraction (0.0 = none, 1.0 = full).

thermal_state: ThermalState

Thermal state classification.

temperature_c: Option<f32>

Temperature in Celsius (if available).

battery_state: BatteryState

Battery state classification.

battery_percent: f32

Battery charge fraction (0.0 = empty, 1.0 = full).

disk_io_rate: f32

Disk I/O rate fraction (0.0 = idle, 1.0 = saturated).

active: bool

Whether the system is actively processing.

guna: GunaTag

Guna classification of overall resource behavior.

timestamp: DateTime<Utc>

When this sample was taken.

Implementations

impl HarmonyVector

pub fn health_score(&self) -> f32

Compute a comprehensive health score (0.0 = critical, 1.0 = perfect).

Weighted average of CPU (30%), memory (30%), swap (20%), and thermal (20%) health factors.

pub fn is_stressed(&self) -> bool

Whether the system is under stress (health < 0.3).

pub fn to_json(&self) -> Value

Convert to a JSON-serializable map for MCP tool responses.

pub fn sanitized(self) -> Self

Sanitize all fraction fields to [0.0, 1.0], replacing NaN/Infinity with 0.0.

This prevents metric poisoning where impossible values (negative CPU, f32::MAX, NaN) could skew z-scores and health scores.

Trait Implementations

impl Clone for HarmonyVector

fn clone(&self) -> HarmonyVector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HarmonyVector

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HarmonyVector

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HarmonyVector

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HarmonyVector

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.