Struct CpuReading 

pub struct CpuReading {
    pub mean: f64,
    pub max_core: f64,
    pub top_core: usize,
    pub p25: f64,
    pub p50: f64,
    pub p75: f64,
    pub cores: usize,
}

Per-category CPU readings: the mean, the hottest core, and the SHAPE of the per-core distribution.

The hottest core alone cannot answer “is there headroom”: one pegged core on an otherwise idle box reads identically to a box that is genuinely out of CPU. Measured 2026-08-21 on a live stcs_adaptive run — max_core p90 = 1.000 while mean sat at 0.183 — so any guard keyed on the max would throttle at 18% host utilization. The quartiles separate the two cases: p50 low with max_core pegged is a single hot thread (headroom remains); p50 high is real saturation.

max_core is kept, not replaced — it remains the right signal for spotting a single-threaded bottleneck, which is a different question from headroom.

Fields

mean: f64

max_core: f64

top_core: usize

p25: f64

Per-core utilization quartiles across all online cores.

p50: f64

p75: f64

cores: usize

How many cores the quartiles were computed over — the sample size behind the shape, so a reader can tell a 2-core box’s “quartiles” from a 96-core box’s.

Trait Implementations

impl Clone for CpuReading

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CpuReading

impl Debug for CpuReading

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

Formats the value using the given formatter.

impl Default for CpuReading

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for CpuReading

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CpuReading