Struct MarkdownMemoryStore 

pub struct MarkdownMemoryStore { /* private fields */ }

A store for managing memories in markdown format.

This store uses a single markdown file (.ralph/agent/memories.md) to persist memories. The file format is human-readable and version-control friendly.

Multi-loop Safety

All read operations use shared locks, and all write operations use exclusive locks. This ensures safe concurrent access from multiple Ralph loops running in worktrees.

Implementations

impl MarkdownMemoryStore

pub fn new(path: impl AsRef<Path>) -> Self

Creates a new store at the given path.

The path should point to a .md file (typically .ralph/agent/memories.md). The file does not need to exist - it will be created when first written to.

pub fn with_default_path(root: impl AsRef<Path>) -> Self

Creates a store with the default path (.ralph/agent/memories.md) under the given root.

pub fn path(&self) -> &Path

Returns the path to the memories file.

pub fn exists(&self) -> bool

Returns true if the memories file exists.

pub fn init(&self, force: bool) -> Result<()>

Initializes the memories file with an empty template.

If force is false and the file already exists, this returns an error. Uses an exclusive lock to prevent concurrent writes.

pub fn load(&self) -> Result<Vec<Memory>>

Reads all memories from the file.

Returns an empty vector if the file doesn’t exist. Uses a shared lock to allow concurrent reads from multiple loops.

pub fn append(&self, memory: &Memory) -> Result<()>

Appends a new memory to the file.

The memory is inserted into its appropriate section (based on type). If the file doesn’t exist, it’s created with the template first. Uses an exclusive lock to prevent concurrent writes.

pub fn delete(&self, id: &str) -> Result<bool>

Deletes a memory by ID.

Returns Ok(true) if the memory was found and deleted, Ok(false) if the memory was not found. Uses an exclusive lock to prevent concurrent writes.

pub fn get(&self, id: &str) -> Result<Option<Memory>>

Returns the memory with the given ID, if it exists.

pub fn search(&self, query: &str) -> Result<Vec<Memory>>

Searches memories by query string.

Matches against content and tags (case-insensitive).

pub fn filter_by_type(&self, memory_type: MemoryType) -> Result<Vec<Memory>>

Filters memories by type.

pub fn filter_by_tags(&self, tags: &[String]) -> Result<Vec<Memory>>

Filters memories by tags (OR logic - matches if any tag matches).

Trait Implementations

impl Clone for MarkdownMemoryStore

fn clone(&self) -> MarkdownMemoryStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MarkdownMemoryStore

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

Formats the value using the given formatter.