opencode-mempalace-persistence 2.5.3 → 2.7.0

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.d.ts

@@ -1,11 +1,4 @@
 declare const _default: ({ client }: any) => Promise<{
-    tool: {
-        mempalace_sync: {
-            description: string;
-            args: {};
-            execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
-        };
-    };
     "chat.message": (input: {
         sessionID: string;
         agent?: string;

package/dist/index.js

@@ -4,7 +4,6 @@ import { homedir } from "os";
 import { join, dirname } from "path";
 import { createHash } from "crypto";
 import { fileURLToPath } from "url";
-import { tool } from "@opencode-ai/plugin";
 const HOME = homedir();
 const MEMPALACE_BIN = join(HOME, ".local/bin/mempalace");
 const OPENCODE_DB = join(HOME, ".local/share/opencode/opencode.db");
@@ -162,52 +161,7 @@ function countPendingSuffix() {
     const pending = countPendingFiles();
     return pending > 0 ? `, ${pending} file(s) waiting to mine` : ", queue empty";
 }
-// On-demand sync snapshot for the /memory-toast command: same facts as
-// the startup toast, plus live-mine detection. Fires a toast AND returns
-// the text (visible in transcript too).
-function liveMiners() {
-    const found = [];
-    let dir = [];
-    try {
-        dir = readdirSync(join(HOME, ".mempalace/locks"));
-    }
-    catch {
-        return found;
-    }
-    for (const f of dir) {
-        if (!f.endsWith(".lock"))
-            continue;
-        try {
-            const content = readFileSync(join(HOME, ".mempalace/locks", f), "utf-8");
-            const pid = parseInt((content.match(/(\d+)/) || [])[1] || "", 10);
-            if (!pid)
-                continue;
-            try {
-                process.kill(pid, 0);
-                found.push(`PID ${pid} (${f.replace("mine_palace_", "").replace(".lock", "").slice(0, 8)}…)`);
-            }
-            catch { }
-        }
-        catch { }
-    }
-    return found;
-}
-function syncSnapshot() {
-    const st = readSyncState();
-    const pending = countPendingFiles();
-    const miners = liveMiners();
-    const agoMin = st.last_sync_ms > 0 ? Math.round((Date.now() - st.last_sync_ms) / 60000) : -1;
-    const syncAge = agoMin < 0 ? "never" : agoMin === 0 ? "<1 min ago" : `${agoMin} min ago`;
-    const mining = miners.length > 0 ? `mining NOW (${miners.join(", ")})` : "no mine running";
-    const text = `MemPalace sync — plugin v${pluginVersion()}\n` +
-        `Last sync: ${syncAge}\n` +
-        `Backlog: ${pending} file(s) waiting\n` +
-        `Status: ${mining}`;
-    const toastMsg = miners.length > 0
-        ? `mining now (${miners.length}), ${pending} file(s) waiting, last sync ${syncAge}`
-        : `idle, ${pending} file(s) waiting, last sync ${syncAge}`;
-    return { text, toastMsg };
-}
+// TUI toast client (set by the factory). Fire-and-forget: headless runs
 // (`opencode run`, no TUI attached) must never break on this.
 let tuiClient = null;
 // Throttle for routine skip notices (busy palace): at most one toast
@@ -861,18 +815,6 @@ export default (async ({ client }) => {
     process.once("SIGHUP", onExit);
     process.once("exit", onExit);
     return {
-        tool: {
-            mempalace_sync: tool({
-                description: "Show live MemPalace sync state (backlog, last sync, running mines) as a TUI toast and text. Use when the user asks how mining is going.",
-                args: {},
-                async execute() {
-                    const snap = syncSnapshot();
-                    toast("info", "MemPalace", snap.toastMsg);
-                    ilog("status", { via: "tool" });
-                    return snap.text;
-                },
-            }),
-        },
         "chat.message": async (input, output) => {
             const role = output.message.role;
             if (role !== "user")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mempalace-persistence",
-  "version": "2.5.3",
+  "version": "2.7.0",
   "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",