Struct CircuitBreaker 

pub struct CircuitBreaker { /* private fields */ }

Counts consecutive hard failures and trips open after a threshold.

G28-D (v1.0.68): caps enrich --retry-failed and ingest --retry-failed loops so persistent failures (e.g., LLM provider returning the same 4xx for hours) cannot run unbounded. After threshold consecutive AttemptOutcome::HardFailure outcomes, record returns true and the caller is expected to abort with AppError::CircuitBreakerOpen.

Rate-limited / transient errors are explicitly NOT counted, so a provider that throttles but eventually recovers will not trip the breaker.

Implementations

impl CircuitBreaker

pub fn new(threshold: u32, cooldown: Duration) -> Self

Creates a breaker that opens after threshold consecutive hard failures and stays open for cooldown after the last failure.

pub fn record(&mut self, outcome: AttemptOutcome) -> bool

Records one attempt outcome.

Returns true when the breaker is now open and the caller must abort the job. Returns false when the attempt should continue.

pub fn is_open(&self) -> bool

true when the breaker is currently open (and not yet cooled down).

pub fn reset(&mut self)

Resets the breaker to closed state.

Trait Implementations

impl Clone for CircuitBreaker

fn clone(&self) -> CircuitBreaker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CircuitBreaker

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

Formats the value using the given formatter.