Struct MemoryEntry 

pub struct MemoryEntry {

    pub id: String,
    pub content: String,
    pub category: MemoryCategory,
    pub confidence: f32,
    pub active: bool,
    pub tags: Vec<String>,
    pub source: String,
    pub trust: TrustLevel,
    pub linked_ids: Vec<String>,
    pub superseded_by: Option<String>,
    pub created_at: DateTime<Utc>,
    pub accessed_at: DateTime<Utc>,
    pub access_count: u32,
    pub reinforcement_history: Vec<Reinforcement>,
    pub expires_at: Option<DateTime<Utc>>,
    pub key: Option<String>,
}

A scored memory record with confidence, trust, and graph links.

Fields

id: String

content: String

category: MemoryCategory

confidence: f32

active: bool

tags: Vec<String>

source: String

trust: TrustLevel

linked_ids: Vec<String>

superseded_by: Option<String>

created_at: DateTime<Utc>

accessed_at: DateTime<Utc>

access_count: u32

reinforcement_history: Vec<Reinforcement>

expires_at: Option<DateTime<Utc>>

Optional hard expiry. None = never expires. Backward-compatible: pre-existing stored entries deserialize to None.

key: Option<String>

Optional subject key (e.g. pref:reply_language) for deterministic latest-wins: writing a new entry with the same key supersedes older active ones. None = unkeyed (no auto-supersession). Backward-compatible.

Implementations

impl MemoryEntry

pub fn new( id: impl Into<String>, content: impl Into<String>, category: MemoryCategory, source: impl Into<String>, ) -> Self

Create a new memory entry with default confidence (0.8) and user trust.

pub fn with_key(self, key: impl Into<String>) -> Self

Builder: set the subject key for deterministic latest-wins supersession.

pub fn with_category(self, category: MemoryCategory) -> Self

Builder: set the memory category (schema kind).

pub fn with_trust(self, trust: TrustLevel) -> Self

Builder: set the trust level (e.g. User for explicitly pinned memories).

pub fn with_ttl(self, ttl: Duration) -> Self

Builder: set a time-to-live measured from now.

pub fn is_expired(&self) -> bool

Whether this entry has passed its hard expiry (if any).

pub fn effective_confidence(&self) -> f32

Compute effective confidence with access bonus and age decay.

pub fn reinforce(&mut self, score: f32, context: &str)

Append a reinforcement event and adjust base confidence.

pub fn decay_confidence(&mut self, amount: f32)

Decrement base confidence; deactivates the entry if it drops below 0.1.

pub fn supersede(&mut self, new_id: &str)

Mark this entry as superseded by new_id and deactivate it.

pub fn touch(&mut self)

Record an access event, incrementing the access count and updating the timestamp.

Trait Implementations

impl Clone for MemoryEntry

fn clone(&self) -> MemoryEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoryEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.