Struct OscillationDetector 

pub struct OscillationDetector { /* private fields */ }

Per-surface oscillation detector. Records recent patch_hash values from Decision::Patch outcomes and reports whether a fresh proposal would repeat one we’ve seen recently — that’s the A→B→A pattern the loop must not commit to.

Thread-safety: backed by DashMap so the handler can hold it behind Arc and call check_and_record from any async context without taking a tokio Mutex first.

Implementations

impl OscillationDetector

pub fn new() -> Self

pub fn check_and_record(&self, surface_id: &str, patch_hash: u64) -> bool

Test whether patch_hash would oscillate against the surface’s recent history, and either record it (no oscillation, proceed) or leave history untouched (oscillation, caller suppresses the apply).

Returns true when the caller should APPLY the patch. Returns false when the patch repeats one in the recent window — caller logs and skips.

pub fn reset(&self, surface_id: &str)

Clear history for a surface — use when the surface is recreated (sequence counter resets, prior history is stale).

Trait Implementations

impl Default for OscillationDetector

fn default() -> OscillationDetector

Returns the “default value” for a type.