Struct MemoryStore 

pub struct MemoryStore<P: Platform> { /* private fields */ }

Long-term and session memory store.

Wraps two markdown files (MEMORY.md and HISTORY.md) behind the platform filesystem abstraction. Reads are lock-free (each call reads the file); writes go through the platform’s append/write operations.

Directory resolution

The constructor resolves the memory directory using the fallback chain:

1. ~/.clawft/workspace/memory/
2. ~/.nanobot/workspace/memory/ (legacy fallback)

If neither exists, the .clawft path is used and created on first write.

Implementations

impl<P: Platform> MemoryStore<P>

pub fn new(platform: Arc<P>) -> Result<Self>

Create a new memory store.

Resolves the workspace memory directory from the platform home directory. Prefers ~/.clawft/workspace/memory/; falls back to ~/.nanobot/workspace/memory/ if the .clawft directory does not exist but .nanobot does.

Errors

Returns ClawftError::ConfigInvalid if no home directory can be determined from the platform.

pub async fn read_long_term(&self) -> Result<String>

Read long-term memory (MEMORY.md).

Returns an empty string if the file does not exist yet, matching the Python nanobot behavior. I/O errors other than “not found” are propagated.

pub async fn write_long_term(&self, content: &str) -> Result<()>

Write (overwrite) long-term memory.

Creates parent directories if they do not exist.

pub async fn append_long_term(&self, entry: &str) -> Result<()>

Append an entry to long-term memory.

Each entry is terminated with a double newline to form distinct paragraphs for later search.

pub async fn read_history(&self) -> Result<String>

Read the history file (HISTORY.md).

Returns an empty string if the file does not exist yet.

pub async fn append_history(&self, entry: &str) -> Result<()>

Append an entry to the history file.

Each entry is terminated with a double newline to match the Python append_history behavior.

pub async fn search(&self, query: &str, max_results: usize) -> Vec<String>

Substring search across both memory files.

Splits content by double-newline into paragraphs, then returns paragraphs containing query (case-insensitive). Results are returned in document order, capped at max_results.

pub fn memory_path(&self) -> &PathBuf

Path to the memory file (for diagnostics / context building).

pub fn history_path(&self) -> &PathBuf

Path to the history file (for diagnostics / context building).