Struct KnowledgeFact 

pub struct KnowledgeFact {

    pub origin: FactOrigin,
    pub category: String,
    pub key: String,
    pub value: String,
    pub source_session: String,
    pub confidence: f32,
    pub created_at: DateTime<Utc>,
    pub last_confirmed: DateTime<Utc>,
    pub retrieval_count: u32,
    pub last_retrieved: Option<DateTime<Utc>>,
    pub valid_from: Option<DateTime<Utc>>,
    pub valid_until: Option<DateTime<Utc>>,
    pub supersedes: Option<String>,
    pub confirmation_count: u32,
    pub feedback_up: u32,
    pub feedback_down: u32,
    pub last_feedback: Option<DateTime<Utc>>,
    pub privacy: FactPrivacy,
    pub sensitivity: SensitivityLevel,
    pub imported_from: Option<String>,
    pub archetype: KnowledgeArchetype,
    pub fidelity: Option<FidelityScore>,
    pub revision_count: u32,
    pub status: Option<FactStatus>,
    pub validity: Option<FactValidity>,
    pub anchors: Vec<CodeAnchor>,
    pub review: Option<FactReview>,
    pub capture: FactCapture,
}

Fields

origin: FactOrigin

category: String

key: String

value: String

source_session: String

confidence: f32

created_at: DateTime<Utc>

last_confirmed: DateTime<Utc>

retrieval_count: u32

last_retrieved: Option<DateTime<Utc>>

valid_from: Option<DateTime<Utc>>

valid_until: Option<DateTime<Utc>>

supersedes: Option<String>

confirmation_count: u32

feedback_up: u32

feedback_down: u32

last_feedback: Option<DateTime<Utc>>

privacy: FactPrivacy

sensitivity: SensitivityLevel

Per-item sensitivity classification (#212). Defaults to Public; set at creation from content and enforced by the policy floor at injection time.

imported_from: Option<String>

archetype: KnowledgeArchetype

fidelity: Option<FidelityScore>

revision_count: u32

status: Option<FactStatus>

The recorded status (V01). Absent on facts written before it existed and on facts nobody classified; KnowledgeFact::status then derives it from the origin. Omitted when absent (byte-compatible).

validity: Option<FactValidity>

Validity class (AP01 §4). Absent on facts written before it existed and on unclassified facts, which keep today’s behaviour. Omitted when absent (byte-compatible).

anchors: Vec<CodeAnchor>

Code anchors (J2, C0 1.9 CodeAnchorV1): the code this fact is about, so a change there makes it to verify. Omitted when empty (byte-compatible).

review: Option<FactReview>

Review state (C0 1.9 fact states): set when what the fact rests on moved under it — an anchor that no longer holds, a removed import source, a contradiction. Orthogonal to FactStatus (evidence): a verified fact can be to verify. Omitted when absent (byte-compatible).

capture: FactCapture

What the Hive capture gate reads (v4 V1): node type, procedure steps and commands, references, evidence. Every field is omitted when empty (byte-compatible).

Implementations

impl KnowledgeFact

pub fn is_current(&self) -> bool

pub fn is_synthesized_observation(&self) -> bool

A synthesized observation: an entity-summary written by the cognition loop’s synthesis step (#802), not a user-supplied finding. Recall surfaces these as orientation (a balanced boost, never absolute).

pub fn quality_score(&self) -> f32

Stable, intrinsic quality metric (0.0..1.0).

Based only on confidence, confirmation count, and feedback balance. Deliberately excludes volatile signals (retrieval count, recency) to keep recall output deterministic. For display ordering use salience_score() which adds recency and category weighting.

pub fn was_valid_at(&self, at: DateTime<Utc>) -> bool

pub fn compute_structural_fidelity(&self) -> f64

Compute structural fidelity score (0.0 - 1.0). Based on: has source, confirmations, confidence, freshness, feedback.

pub fn update_fidelity(&mut self)

impl KnowledgeFact

pub fn package_origin(&self) -> Option<&str>

The context package this fact was merged from (name@version, as the package loader tags it), or None for every other origin — the other importers tag with a word or a kind: prefix.

pub fn hive_origin(&self) -> Option<&str>

The import tag of a fact pulled from a Hive repo (other members’ knowledge), None for every other fact.

pub fn as_delivered(&self, value: String) -> String

value — this fact’s value as a renderer prepared it — as it enters model-visible output (V04). A fact from a context package is third-party text: it reaches the model as data, inside a fence its author cannot produce and under a header that says so, like provider content (K06). It grants nothing: every later check — the egress admission above all — judges it like any other text.

A fact pulled from a Hive repo was written by other members: it is foreign content (X5). Its value is stored in the Hive wrapper (sync_into_knowledge), so every renderer delivers it fenced; a value stored before that is wrapped here.

impl KnowledgeFact

pub fn status(&self) -> FactStatus

The fact’s status: as recorded, else verified only when its origin names a source, else assumption.

pub fn mark_review( &mut self, state: FactReviewState, reason: FactReviewReason, now: DateTime<Utc>, )

Mark the fact for review; an existing mark keeps its since.

pub fn clear_review(&mut self)

A person or a fresh write confirmed the fact again.

Trait Implementations

impl Clone for KnowledgeFact

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnowledgeFact

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KnowledgeFact

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KnowledgeFact

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

where __S: Serializer,

Serialize this value into the given Serde serializer.