memory-braid 0.7.1 → 0.8.2

package/README.md

@@ -2,9 +2,19 @@
 
 Memory Braid is an OpenClaw `kind: "memory"` plugin that augments local memory search (core/QMD) with Mem0.
 
+## Ownership model
+
+Memory Braid is intentionally hybrid, but not with shared ownership.
+
+- OpenClaw prompt context + compaction are the source of truth for the live session.
+- Core/QMD is the source of truth for written documents, notes, and canonical project knowledge.
+- Mem0 is the source of truth for learned cross-session memory such as preferences, recurring decisions, and procedural learnings.
+
+The goal is hybrid retrieval with single ownership per memory class. Memory Braid should not re-own markdown knowledge, and Mem0 should not be treated as the canonical store for documents.
+
 ## Features
 
-- Hybrid recall: local memory + Mem0, merged with weighted RRF.
+- Hybrid recall with split ownership: local memory + Mem0, merged with weighted RRF.
 - Layered Mem0 memory: episodic captures, semantic compendium memories, and procedural agent learnings.
 - Capture-first Mem0 memory: plugin writes only captured memories to Mem0 (no markdown/session indexing).
 - Capture pipeline modes: `local`, `hybrid`, `ml`.
@@ -99,7 +109,9 @@ Migration:
 
 - If you relied on bootstrap/reconcile mirroring, pin to `<0.4.0`.
 - For `0.4.0+`, remove `bootstrap` and `reconcile` from your plugin config.
-- Keep core/QMD as the source for markdown/sessions, and use Memory Braid for capture/mem0 recall/lifecycle.
+- Keep OpenClaw prompt context as the source of truth for the live session.
+- Keep core/QMD as the source of truth for markdown and canonical written knowledge.
+- Use Memory Braid + Mem0 for learned cross-session memory, consolidation, and lifecycle management.
 
 ## Install
 
@@ -110,7 +122,7 @@ On the target machine:
 1. Install from npm:
 
 ```bash
-openclaw plugins install memory-braid@0.7.1
+openclaw plugins install memory-braid@0.8.0
 ```
 
 2. Rebuild native dependencies inside the installed extension:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-braid",
-  "version": "0.7.1",
+  "version": "0.8.2",
   "description": "OpenClaw memory plugin that augments local memory with Mem0 capture and recall.",
   "type": "module",
   "main": "./src/index.ts",

package/src/index.ts

@@ -1672,11 +1672,8 @@ const memoryBraidPlugin = {
   register(api: OpenClawPluginApi) {
     const cfg = parseConfig(api.pluginConfig);
     const log = new MemoryBraidLogger(api.logger, cfg.debug);
-    const initialStateDir = api.runtime.state.resolveStateDir();
-    const mem0 = new Mem0Adapter(cfg, log, { stateDir: initialStateDir });
-    const entityExtraction = new EntityExtractionManager(cfg.entityExtraction, log, {
-      stateDir: initialStateDir,
-    });
+    const mem0 = new Mem0Adapter(cfg, log);
+    const entityExtraction = new EntityExtractionManager(cfg.entityExtraction, log);
     const recallSeenByScope = new Map<string, string>();
     const captureSeenByScope = new Map<string, string>();
     const pendingInboundTurns = new Map<string, PendingInboundTurn>();
@@ -2911,13 +2908,13 @@ const memoryBraidPlugin = {
       }
     });
 
-    api.on("before_agent_start", async (event, ctx) => {
+    api.on("before_prompt_build", async (event, ctx) => {
       const runId = log.newRunId();
       const scope = resolveRuntimeScopeFromHookContext(ctx);
       const persistentScope = resolvePersistentScopeFromHookContext(ctx);
       const legacyScope = resolveLegacySessionScopeFromHookContext(ctx);
       const baseResult = {
-        systemPrompt: REMEMBER_LEARNING_SYSTEM_PROMPT,
+        prependSystemContext: REMEMBER_LEARNING_SYSTEM_PROMPT,
       };
       if (isExcludedAutoMemorySession(ctx.sessionKey)) {
         log.debug("memory_braid.search.skip", {
@@ -3048,7 +3045,7 @@ const memoryBraidPlugin = {
       });
 
       return {
-        systemPrompt: REMEMBER_LEARNING_SYSTEM_PROMPT,
+        prependSystemContext: REMEMBER_LEARNING_SYSTEM_PROMPT,
         prependContext,
       };
     });