Struct CalibrationHistory 

pub struct CalibrationHistory {
    pub schema_version: String,
    pub objective_metric: String,
    pub steps: Vec<StepReport>,
    pub best_loss_mean: Option<f64>,
    pub best_loss_std: Option<f64>,
    pub best_knob_values: BTreeMap<String, KnobValue>,
}

Persistable snapshot of a CalibrationLoop’s trajectory.

Fields

schema_version: String

Schema version of the file format. See HISTORY_SCHEMA_VERSION.

objective_metric: String

Objective the loop was minimising — recorded so resume can refuse to load history whose objective differs from the runtime’s (would yield meaningless comparisons).

steps: Vec<StepReport>

Per-step trajectory in order. Empty until the first loop.step() returns.

best_loss_mean: Option<f64>

Best loss mean seen so far. None if no step has produced a measurement yet.

best_loss_std: Option<f64>

Best loss std at the same time best_loss_mean was recorded.

best_knob_values: BTreeMap<String, KnobValue>

Knob values at the best-loss point. Maps config-tree path → value (stringified via KnobValue::to_yaml_string).

Implementations

impl CalibrationHistory

pub fn from_loop(loop_: &CalibrationLoop) -> Self

Build a history snapshot from the current state of a running CalibrationLoop. Cheap — clones the steps Vec

• best-tracker maps.

pub fn save(&self, path: &Path) -> Result<(), HistoryError>

Serialise to path as pretty-printed JSON. Atomic: writes to path.tmp first then renames, so an interruption mid- write doesn’t corrupt the existing file.

pub fn load(path: &Path) -> Result<Self, HistoryError>

Load from path. Rejects mismatched schema versions so a resume against an incompatible file fails loud rather than silent.

pub fn apply_to(&self, loop_: &mut CalibrationLoop) -> Result<(), HistoryError>

Apply this history to a fresh CalibrationLoop so the loop resumes from where it stopped.

Caller is responsible for ensuring the loop’s objective + knob set + config match what was used when the history was produced; we check the objective metric name as a soft guard but full structural equality on the knob vector is out of scope for the first cut (the design doc deferred strict resume safety to Piece 5).

Trait Implementations

impl Clone for CalibrationHistory

fn clone(&self) -> CalibrationHistory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CalibrationHistory

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CalibrationHistory

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CalibrationHistory

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

where __S: Serializer,

Serialize this value into the given Serde serializer.