Struct ProposedFact 

pub struct ProposedFact {
    pub key: ContextKey,
    pub id: String,
    pub content: String,
    pub confidence: f64,
    pub provenance: String,
}

A suggested fact from a non-authoritative source (e.g., LLM).

ProposedFact is compile-time separated from Fact to enforce that LLM outputs cannot accidentally become trusted facts. Promotion requires explicit validation via TryFrom.

Decision Reference

See DECISIONS.md §3: “If something is dangerous, make it impossible to misuse.”

Fields

key: ContextKey

The category this proposed fact would belong to.

id: String

Suggested identifier.

content: String

The proposed content.

confidence: f64

Confidence hint from the source (0.0 - 1.0).

provenance: String

Provenance information (e.g., model ID, prompt hash).

Trait Implementations

impl Clone for ProposedFact

fn clone(&self) -> ProposedFact

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProposedFact

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

Formats the value using the given formatter.

impl PartialEq for ProposedFact

fn eq(&self, other: &ProposedFact) -> 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 TryFrom<ProposedFact> for Fact

fn try_from(proposed: ProposedFact) -> Result<Self, Self::Error>

Converts a ProposedFact to a Fact after validation.

This is the ONLY way to promote a proposal to a fact. In production, this would include schema validation, constraint checks, and governance rules.

type Error = ValidationError

The type returned in the event of a conversion error.

impl StructuralPartialEq for ProposedFact