Struct MemoryGraph 

pub struct MemoryGraph {
    pub term_index: Option<TermIndex>,
    pub doc_lengths: Option<DocLengths>,
    /* private fields */
}

The core in-memory graph structure holding cognitive events and their relationships.

Fields

term_index: Option<TermIndex>

BM25 inverted index (optional, may not be present in old files).

doc_lengths: Option<DocLengths>

Document lengths for BM25 normalization (optional).

Implementations

impl MemoryGraph

pub fn new(dimension: usize) -> Self

Create a new empty graph.

pub fn from_parts( nodes: Vec<CognitiveEvent>, edges: Vec<Edge>, dimension: usize, ) -> AmemResult<Self>

Create from pre-existing data (used by reader).

pub fn node_count(&self) -> usize

Number of nodes.

pub fn edge_count(&self) -> usize

Number of edges.

pub fn get_node(&self, id: u64) -> Option<&CognitiveEvent>

Get a node by ID (immutable).

pub fn get_node_mut(&mut self, id: u64) -> Option<&mut CognitiveEvent>

Get a node by ID (mutable).

pub fn ensure_adjacency(&mut self)

Ensure adjacency indexes are up to date. No-op in the current implementation (adjacency is always up to date).

pub fn edges_from(&self, source_id: u64) -> &[Edge]

Get all edges from a source node.

pub fn edges_to(&self, target_id: u64) -> Vec<&Edge>

Get all edges that point TO this node.

pub fn nodes(&self) -> &[CognitiveEvent]

Get all nodes (immutable slice).

pub fn edges(&self) -> &[Edge]

Get all edges (immutable slice).

pub fn dimension(&self) -> usize

The feature vector dimension for this graph.

pub fn add_node(&mut self, event: CognitiveEvent) -> AmemResult<u64>

Add a node, returns the assigned ID.

pub fn add_edge(&mut self, edge: Edge) -> AmemResult<()>

Add an edge between two existing nodes.

pub fn remove_node(&mut self, id: u64) -> AmemResult<CognitiveEvent>

Remove a node and all its edges.

pub fn remove_edge( &mut self, source_id: u64, target_id: u64, edge_type: EdgeType, ) -> AmemResult<()>

Remove a specific edge.

pub fn next_id(&self) -> u64

Get the next available node ID (for builder use).

pub fn type_index(&self) -> &TypeIndex

Get the type index.

pub fn temporal_index(&self) -> &TemporalIndex

Get the temporal index.

pub fn session_index(&self) -> &SessionIndex

Get the session index.

pub fn cluster_map(&self) -> &ClusterMap

Get the cluster map.

pub fn cluster_map_mut(&mut self) -> &mut ClusterMap

Get a mutable reference to the cluster map.

pub fn term_index(&self) -> Option<&TermIndex>

Get the term index (for BM25 search). None if not built.

pub fn doc_lengths(&self) -> Option<&DocLengths>

Get the doc lengths (for BM25 normalization). None if not built.

pub fn set_term_index(&mut self, index: TermIndex)

Set the term index.

pub fn set_doc_lengths(&mut self, lengths: DocLengths)

Set the doc lengths.