Struct MemCube 

pub struct MemCube {

    pub id: String,
    pub tier: MemoryTier,
    pub kind: CognitionKind,
    pub content: String,
    pub source: String,
    pub importance: f32,
    pub confidence: f32,
    pub decay_rate: f32,
    pub caused_by: Vec<String>,
    pub leads_to: Vec<String>,
    pub evidence_for: Vec<String>,
    pub created_at: u64,
    pub last_accessed: u64,
    pub access_count: u32,
    pub session_id: Option<String>,
}

A MemCube is the fundamental unit of cognitive memory.

Each MemCube carries natural-language content, cognition metadata, importance/confidence scores, causal links, and lifecycle state. MemCubes are storage-agnostic — they can be persisted in Lance, redb, or plain files.

Fields

id: String

Unique identifier (typically a ULID).

tier: MemoryTier

Memory tier classification.

kind: CognitionKind

Cognition phase that produced this memory.

content: String

Natural language content of the memory.

source: String

Source identifier (e.g., “filesystem”, “lance”, “session:XYZ”).

importance: f32

Importance score (0.0 to 1.0), updated by access patterns.

confidence: f32

Confidence score (0.0 to 1.0), how certain the information is.

decay_rate: f32

Decay rate — how fast relevance fades without access.

caused_by: Vec<String>

IDs of memories that caused this one.

leads_to: Vec<String>

IDs of memories this one led to.

evidence_for: Vec<String>

IDs of decisions this memory serves as evidence for.

created_at: u64

Creation timestamp (microseconds since epoch).

last_accessed: u64

Last access timestamp (microseconds since epoch).

access_count: u32

Number of times this memory has been accessed.

session_id: Option<String>

Session that created this memory (if applicable).

Implementations

impl MemCube

pub fn new( tier: MemoryTier, kind: CognitionKind, content: impl Into<String>, source: impl Into<String>, ) -> Self

Create a new MemCube with sensible defaults.

pub fn relevance(&self) -> f32

Compute current relevance factoring importance and time decay.

Returns a value in [0, 1] representing how relevant this memory is right now, combining its importance with exponential time decay.

pub fn touch(&mut self)

Record an access, updating last_accessed and access_count.

Trait Implementations

impl Clone for MemCube

fn clone(&self) -> MemCube

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemCube

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemCube

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemCube

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

where __S: Serializer,

Serialize this value into the given Serde serializer.