Struct Confidence 

pub struct Confidence(/* private fields */);

A memory’s confidence as a 0-100 percentage.

A newtype over i8 whose only constructor clamps into [0, 100], so an out-of-range value is unrepresentable. This is the single home for the scale-and-clamp logic: the extraction LLM emits an f32 (occasionally > 1.0), which Confidence::from_unit_scale scales by 100 and clamps.

Examples

use memoir_core::memory::Confidence;

assert_eq!(Confidence::new(73).get(), 73);
assert_eq!(Confidence::new(120).get(), 100); // clamped
assert_eq!(Confidence::from_unit_scale(0.42).get(), 42);
assert_eq!(Confidence::from_unit_scale(1.7).get(), 100); // clamped

Implementations

impl Confidence

pub const MAX: Confidence

Largest valid confidence: fully certain.

pub const MIN: Confidence

Smallest valid confidence: no certainty.

pub fn new(percent: i8) -> Self

Creates a confidence from a percentage, clamping into [0, 100].

Clamping is the defined behavior, not an error: callers (and the extraction LLM) occasionally produce out-of-range values, and the intent is always “as confident as possible / not at all,” never a failure. Hence this is infallible.

pub fn from_unit_scale(score: f32) -> Self

Creates a confidence from a unit-scale score, scaling ×100 and clamping.

The extraction LLM emits a per-fact score in [0.0, 1.0] (but may exceed 1.0). This scales to a percentage and clamps into [0, 100]. NaN maps to Confidence::MIN.

pub fn get(self) -> i8

Returns the percentage value in [0, 100].

Trait Implementations

impl Clone for Confidence

fn clone(&self) -> Confidence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Confidence

impl Debug for Confidence

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

Formats the value using the given formatter.

impl Default for Confidence

fn default() -> Self

Defaults to fully certain (100), matching the memories.confidence column default — episodic writes are certain by construction.

impl Display for Confidence

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

Formats the value using the given formatter.

impl Eq for Confidence

impl Hash for Confidence

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Confidence

fn cmp(&self, other: &Confidence) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Confidence

fn eq(&self, other: &Confidence) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Confidence

fn partial_cmp(&self, other: &Confidence) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Confidence