Enum ConfidenceSource 

pub enum ConfidenceSource {
    CallerProvided,
    AutoDerived,
    Calibrated,
    Decayed,
    CuratorDerived,
    Default,
}

v0.7.0 Form 5 (issue #758) — typed discriminator for the provenance of a memory’s confidence value.

Stored on memories.confidence_source TEXT NOT NULL DEFAULT 'caller_provided' (schema v39 sqlite / v38 postgres). The auto- derive engine in crate::confidence::derive writes AutoDerived when crate::confidence::derive computes a fresh value; the calibration sweep writes Calibrated when it replaces the live value with a per-source baseline; the decay updater writes Decayed after applying crate::confidence::decay::decayed on recall touch. The (overwhelming-majority) legacy + default bucket is CallerProvided, matching the SQL DEFAULT clause.

The discriminator lets recall ranking and the forensic bundle reason about the trust path of a confidence score without re-running the derivation. The calibration CLI scans the partial index idx_memories_confidence_source (which excludes caller_provided) to enumerate derived / calibrated / decayed rows cheaply.

Variants

CallerProvided

The legacy and default bucket — the caller’s value was accepted verbatim. Matches the SQL DEFAULT 'caller_provided' clause on the confidence_source column added in schema v39 (sqlite) / v38 (postgres).

AutoDerived

The Form 5 auto-derive engine (crate::confidence::derive) computed the value at write time from row signals (atom derivation, prior-corroboration count, source age, namespace baseline). Opt-in via AI_MEMORY_AUTO_CONFIDENCE=1.

Calibrated

The calibration sweep (ai-memory calibrate confidence --from-shadow) replaced the live value with a per-source baseline computed from observed shadow-mode samples.

Decayed

The freshness-decay updater (crate::confidence::decay) wrote a decayed copy of the previous value, bumping confidence_decayed_at. Fires when AI_MEMORY_CONFIDENCE_DECAY=1 or the namespace policy confidence_decay_half_life_days is set.

CuratorDerived

v0.7.0 issue #1242 — the curator engine (atomisation LlmCurator, persona generator) computed the value at row- mint time without an explicit caller-supplied number. Atom rows inherit confidence from their parent memory; persona rows pin confidence = 1.0 per the QW-2 brief. In both cases the value is engine-derived, not caller-supplied, and must be discoverable to the calibration sweep + the partial index idx_memories_confidence_source (which excludes caller_provided). Pre-#1242 these rows mis-labelled confidence_source = CallerProvided, hiding them from the derived-row enumeration and violating the audit-honesty invariant.

Default

v0.7.x issue #1591 — the caller OMITTED confidence and the store surface stamped the compiled DEFAULT_CONFIDENCE fallback. Pre-#1591 these rows mis-labelled confidence_source = 'caller_provided' — a false provenance claim that made an unexamined 1.0 indistinguishable from a caller’s deliberate full-confidence assertion. The Form-5 calibration / decay engines treat this bucket exactly like caller_provided (the value is not engine-derived), but auditors and recall ranking can now discount the compiled fallback honestly.

Implementations

impl ConfidenceSource

pub fn as_str(&self) -> &'static str

Column-wire string (matches the SQL DEFAULT 'caller_provided' value and the four documented discriminator values).

pub fn from_str(s: &str) -> Option<Self>

Parse the column-wire string. Returns None on unrecognised values so callers can fall back to CallerProvided (forward- compat with future variants that land in a newer DB on an older binary).

Trait Implementations

impl Clone for ConfidenceSource

fn clone(&self) -> ConfidenceSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ConfidenceSource

impl Debug for ConfidenceSource

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

Formats the value using the given formatter.

impl Default for ConfidenceSource

fn default() -> ConfidenceSource

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConfidenceSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ConfidenceSource

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

Formats the value using the given formatter.

impl Eq for ConfidenceSource

impl PartialEq for ConfidenceSource

fn eq(&self, other: &ConfidenceSource) -> 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 Serialize for ConfidenceSource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ConfidenceSource