Struct OscillationDetector 

pub struct OscillationDetector {
    pub window: usize,
    pub min_alternations: usize,
}

Detect oscillation on a specific knob across recent steps.

“Oscillation” = the knob’s (after - before) delta has been sign-alternating across the configured window of the most recent steps that actually touched this knob. When that happens, the optimizer is bouncing between two values and the loop should reduce damping (or warn) rather than keep proposing the same step direction.

Fields

window: usize

How many recent same-knob steps to scan. Default 5.

min_alternations: usize

Minimum alternations needed within the window to flag oscillation. Default 3 (≥ 3 sign-changes in 5 steps).

Implementations

impl OscillationDetector

pub fn check(&self, history: &[StepReport], knob_path: &str) -> bool

Return true if knob_path is oscillating per the configured window + alternation threshold. Skips steps whose patch didn’t touch knob_path and steps that didn’t apply a patch at all. Returns false when fewer than window qualifying steps exist.

Trait Implementations

impl Default for OscillationDetector

fn default() -> Self

Returns the “default value” for a type.