Struct MemoryManager 

pub struct MemoryManager { /* private fields */ }

Unified memory manager composing all layers.

Implementations

impl MemoryManager

pub fn new(project_root: &Path) -> Self

Create a new memory manager for a project.

pub fn with_graph(self, path: &Path) -> Result<Self>

Enable graph memory at a given path. Requires the graph feature.

pub fn with_graph_in_memory(self) -> Result<Self>

Enable in-memory graph (no persistence). Requires the graph feature.

pub fn with_memory_dir(self, dir: PathBuf) -> Self

Set a custom memory directory.

pub fn with_sessions_dir(self, dir: PathBuf) -> Self

Set a custom sessions directory.

pub fn build_context(&self) -> String

Build the complete memory context for the system prompt. Includes MEMORY.md index + CLAUDE.md hierarchy.

pub fn scan(&self) -> Vec<MemoryFileMeta>

Scan memory directory for all memory file metadata.

pub fn load_file(&self, path: &Path) -> Option<MemoryFile>

Load a specific memory file by path.

pub fn store_memory( &self, content: &str, mem_type: MemoryType, confidence: f32, ) -> Option<String>

Store a memory (writes to graph if available, always returns success).

pub fn recall(&self, query: &str, limit: usize) -> Vec<String>

Recall memories matching a query. Uses graph if available, falls back to memdir scan + text matching.

pub fn by_type(&self, mem_type: MemoryType) -> Vec<String>

Get memories by type (graph only, returns empty without graph).

pub fn by_topic(&self, topic: &str) -> Vec<String>

Get memories by topic (graph only).

pub fn session_path(&self, session_id: &str) -> PathBuf

Get the transcript path for a session.

pub fn write_user_message( &self, session_id: &str, message: Message, ) -> Result<String>

Write a user message to the session transcript.

pub fn write_assistant_message( &self, session_id: &str, message: Message, parent_uuid: Option<&str>, ) -> Result<String>

Write an assistant message to the session transcript.

pub fn load_session_messages(&self, session_id: &str) -> Result<Vec<Message>>

Load a session’s messages.

pub fn list_sessions(&self) -> Vec<SessionInfo>

List all session files.

pub fn has_graph(&self) -> bool

Check if graph memory is available.

pub fn graph_stats(&self) -> GraphStats

Get graph statistics (returns default if no graph).

pub fn tag_memory(&self, memory_id: &str, topic: &str)

Tag a memory in the graph (no-op without graph).

pub fn link_memories(&self, from_id: &str, to_id: &str, relationship: &str)

Link two memories in the graph (no-op without graph).

pub fn memory_dir(&self) -> &Path

Access paths.

pub fn sessions_dir(&self) -> &Path

pub fn project_root(&self) -> &Path