Struct Thresholds 

pub struct Thresholds {
    pub gates: Gates,
    pub diff: DiffGates,
    pub calibration: CalibrationConfig,
    pub new_code: Option<NewCodeGates>,
}

Fields

gates: Gates

diff: DiffGates

calibration: CalibrationConfig

new_code: Option<NewCodeGates>

The optional [new_code] section — a period-scoped two-band gate. None when the section is absent (byte-identical to no feature); Some enables it. See NewCodeGates.

Implementations

impl Thresholds

pub fn discover(repo_root: &Path) -> Result<Self>

Auto-discover .codelore-thresholds.toml at the repo root. Returns the default (no gates configured) when the file is absent — gates are opt-in.

Errors

CodeLoreError::Analysis on I/O or parse errors.

pub fn from_path(path: &Path) -> Result<Self>

Parse a thresholds file from disk and validate its values.

Errors

• CodeLoreError::RepoIo (exit 3) when the file cannot be read.
• CodeLoreError::Analysis (exit 4) when the TOML fails to parse.
• CodeLoreError::InvalidOptions (exit 2, the configuration-error bucket) when a threshold value is non-finite or out of range — the value-level sibling of the deny_unknown_fields typo guard.

pub fn from_text(raw: &str) -> Result<Self, String>

Parse from in-memory TOML text. Used by tests + from_path.

Errors

Returns a String description of the parse failure.

pub fn is_empty(&self) -> bool

True when no gate is configured. Callers can short-circuit the check entirely on empty config.

pub fn validate(&self) -> Result<(), String>

Validate every numeric threshold’s value. A bare toml::from_str accepts TOML’s nan/inf float literals and any out-of-range magnitude, and every gate comparison is a bare >/<: a nan floor can never fire, an inf ceiling vacuous-passes, and a negative or overshot bound is silently degenerate. This is the value-level sibling of the struct’s deny_unknown_fields typo guard.

Each field’s domain is derived from its own documented semantics: scores and percentages on [0, 100], ratios on [0, 1], health deltas on [-100, 100] (a [0, 100] score can move at most a full span either way), and the three open-topped ceilings (cognitive_max, hotspot_score_max, hotspot_anchored_max) require only finiteness and non-negativity. u32 counts (max_dependency_cycles, new_hotspot_max, max_findings_in_hot_files) cannot express a non-finite or negative value, so the type already guards them.

Every offending key is collected in one pass so a degenerate config surfaces all its problems at once rather than one re-run at a time.

Errors

Returns a String naming each offending key, its value, and the accepted domain. Ok(()) when every configured threshold is in range.

Trait Implementations

impl Clone for Thresholds

fn clone(&self) -> Thresholds

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Thresholds

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

Formats the value using the given formatter.

impl Default for Thresholds

fn default() -> Thresholds

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Thresholds

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.