Struct SemanticNode 

pub struct SemanticNode {
    pub fact: String,
    pub confidence: f32,
    pub source_turn_id: Uuid,
    pub topic_cluster: Option<String>,
    pub source_episode_id: String,
    pub contradiction_ids: Vec<String>,
    pub last_referenced_at: u64,
    pub reference_count: u32,
    pub decay_eligible: bool,
    pub tags: Vec<String>,
    pub recurrence_count: u32,
    pub last_ref_snapshot: u32,
}

Semantic / factual memory payload.

Fields

fact: String

confidence: f32

source_turn_id: Uuid

topic_cluster: Option<String>

source_episode_id: String

contradiction_ids: Vec<String>

last_referenced_at: u64

reference_count: u32

How many times this node has been retrieved from the store. Managed by the recall path only — never written by extractors.

decay_eligible: bool

tags: Vec<String>

Optional tag hints for analytics / persona (ainl-persona); omitted → empty.

recurrence_count: u32

How many times this exact fact has recurred across separate extraction events. Written by graph_extractor when the same fact is observed again.

Do not use reference_count as a substitute: that field tracks retrieval frequency, not extraction recurrence. They measure different things. graph_extractor (Prompt 2) must write recurrence_count directly; persona / domain extractors gate on this field only.

last_ref_snapshot: u32

reference_count snapshot from the last graph-extractor pass (JSON key _last_ref_snapshot).

Trait Implementations

impl Clone for SemanticNode

fn clone(&self) -> SemanticNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SemanticNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SemanticNode

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

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 SemanticNode