roampal-core

Search persistent memory (current profile) across collections. Returns ranked results with metadata. WHEN TO USE • User references past conversations ("remember", "I told you", "we discussed") → query=<their words>. • Need detail beyond auto-injected context → query=<topic>. • Verify or fetch a spe…

Permanent fact for cross-session memory: identity, preferences, goals, project context. WHEN TO USE • Identity (name, role) → tags=["identity"] • Standing preference/rule → tags=["preference"] • Persistent project fact → tags=["project"] • Effectiveness tip for this user → tags=["system_mastery"] …

Replace an existing memory_bank fact with updated content. Requires the exact doc_id from a prior search_memory result. WHEN TO USE • A stored fact is outdated (e.g., version number changed, project status updated) → update_memory • A fact needs correction or more detail → search_memory first, then…

Remove a memory_bank entry. Stops appearing in search and dedup. No undo via MCP — call only when you're sure. WHEN TO USE • Fact wrong, stale, or causing bad responses → delete_memory. • Redundant entry superseded by a newer fact → delete_memory. WHEN NOT TO USE • Topic still relevant, only detai…

Record outcomes after a turn boundary: scores the memories that were injected, plus stores the turn's takeaway summary and any atomic facts. Fires in response to a scoring hook — a system-reminder that lists doc_ids to score and asks for an exchange_summary + exchange_outcome. Don't call without th…

Store a key takeaway when the transcript alone won't capture important learning. WHEN TO USE (optional — most exchanges don't need this) • Major decisions made • Complex solutions that worked • User corrections (what you got wrong and why) • Important context that would be lost WHEN NOT TO USE • R…