opencode-mempalace-persistence 2.6.0 → 2.7.1

package/README.md

@@ -219,6 +219,13 @@ OPENCODE_MEMPALACE_BACKFILL=1 opencode
 
 The plugin exports everything in the opencode database on the next sync, then resumes incremental mode. Mining is idempotent — re-running is safe.
 
+### Durability notes (drawers vs KG)
+
+- **Drawers** (transcripts) are append-mostly: a crash mid-mine can only leave already-filed content behind, never corrupt what's stored. Re-running the mine is always safe.
+- **KG facts** live a different life: `kg_supersede` replaces a fact atomically at a shared boundary (single transaction) — a mid-write crash rolls back to the *old* fact: stale but present, never half-written.
+- **Reads are validity-window only**: there is no liveness check on read, so a stale fact reads as current until the model revisits it (via checkpoint, diary review, or a new decision on the same subject).
+- **Backfill mines transcripts into drawers only** — it never touches the KG. KG facts come exclusively from live MCP calls (conversation, checkpoints, diary). A crashed supersede therefore waits for the next model touch, not the next backfill.
+
 ---
 
 ## Architecture

package/dist/index.js

@@ -925,6 +925,9 @@ export default (async ({ client }) => {
                 const summary = summarizeToolCall(name, input?.args, output?.output || "");
                 log(`tool: ${summary}`);
                 toast("info", "MemPalace", summary);
+                // Diagnostic: MCP results may live outside `output` — record the
+                // real shape once so extraction can be fixed (see answered-empty).
+                const outAny = output || {};
                 ilog("tool", {
                     tool: String(name).replace(/^mcp_+/, "").replace(/^mempalace_mempalace_/, "").replace(/^mempalace_/, ""),
                     asked: (() => { try {
@@ -933,7 +936,13 @@ export default (async ({ client }) => {
                     catch {
                         return "";
                     } })(),
-                    answered: String(output?.output || "").replace(/\s+/g, " ").slice(0, 300),
+                    answered: String(outAny.output || "").replace(/\s+/g, " ").slice(0, 300),
+                    shape: {
+                        keys: Object.keys(outAny),
+                        title: outAny.title,
+                        metaKeys: outAny.metadata && typeof outAny.metadata === "object" ? Object.keys(outAny.metadata) : typeof outAny.metadata,
+                        raw: JSON.stringify(outAny).slice(0, 300),
+                    },
                 });
             }
             catch { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mempalace-persistence",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "OpenCode plugin — auto-sync conversations to MemPalace memory in real-time. No forced wings, KG extraction via MCP tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",