mindkeeper-openclaw 0.2.28 → 0.2.30

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 context-vault contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -678,11 +678,13 @@ function generateTemplateMessage(changedFiles, options) {
 }
 
 // ../core/src/message/llm.ts
-async function generateLlmMessage(diffs, provider) {
+async function generateLlmMessage(diffs, provider, log) {
   if (!provider) return null;
   try {
     return await provider.generateCommitMessage(diffs);
-  } catch {
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log?.warn?.(`[mindkeeper] LLM commit message error: ${msg}`);
     return null;
   }
 }
@@ -698,6 +700,7 @@ var Tracker = class {
   workDir;
   gitDir;
   configOverrides;
+  log;
   constructor(options) {
     this.workDir = import_node_path3.default.resolve(options.workDir);
     this.gitDir = options.gitDir ? import_node_path3.default.resolve(options.gitDir) : import_node_path3.default.join(this.workDir, GITDIR_NAME);
@@ -705,6 +708,7 @@ var Tracker = class {
     this.configLoaded = options.config !== void 0;
     this.configOverrides = options.configOverrides;
     this.llmProvider = options.llmProvider;
+    this.log = options.log;
     this.store = new IsomorphicGitStore({
       workDir: this.workDir,
       gitDir: this.gitDir
@@ -756,8 +760,8 @@ var Tracker = class {
   }
   async diff(options) {
     const to = options.to ?? "HEAD";
-    const fromOid = options.from === "HEAD" ? await this.resolveHead() : options.from;
-    const toOid = to === "HEAD" ? await this.resolveHead() : to;
+    const fromOid = await this.resolveOid(options.from);
+    const toOid = await this.resolveOid(to);
     if (!fromOid || !toOid) {
       throw new Error("Could not resolve commit references");
     }
@@ -772,7 +776,11 @@ var Tracker = class {
     });
   }
   async rollback(options) {
-    await this.store.restoreFile(options.file, options.to);
+    const toOid = await this.resolveOid(options.to);
+    if (!toOid) {
+      throw new Error(`Could not resolve commit: ${options.to}`);
+    }
+    await this.store.restoreFile(options.file, toOid);
     await this.store.addFiles([options.file]);
     const shortHash = options.to.slice(0, 8);
     const message = generateTemplateMessage([options.file], {
@@ -810,20 +818,47 @@ var Tracker = class {
     const filesToCommit = changed.map((e) => e.filepath);
     await this.store.addFiles(filesToCommit);
     const diffs = [];
-    for (const file of filesToCommit) {
-      try {
-        const d = await this.diff({ file, from: "HEAD" });
-        if (d.additions > 0 || d.deletions > 0) {
-          diffs.push(d);
+    let headOid = null;
+    try {
+      headOid = await this.resolveHead();
+    } catch {
+    }
+    if (headOid) {
+      for (const file of filesToCommit) {
+        try {
+          const oldContent = await this.store.readFile(file, headOid) ?? "";
+          let newContent;
+          try {
+            newContent = await import_promises3.default.readFile(
+              import_node_path3.default.join(this.workDir, file),
+              "utf-8"
+            );
+          } catch {
+            newContent = "";
+          }
+          const d = computeDiff({
+            file,
+            fromVersion: headOid.slice(0, 8),
+            toVersion: "(staged)",
+            oldContent,
+            newContent
+          });
+          if (d.additions > 0 || d.deletions > 0) {
+            diffs.push(d);
+          }
+        } catch {
         }
-      } catch {
       }
     }
     let message = null;
     if (this.config.commitMessage.mode === "llm" && diffs.length > 0) {
-      message = await generateLlmMessage(diffs, this.llmProvider);
+      message = await generateLlmMessage(diffs, this.llmProvider, this.log);
     }
     if (!message) {
+      if (this.config.commitMessage.mode === "llm" && this.log?.warn) {
+        const reason = diffs.length === 0 ? "No diff available (first commit or no file changes), using template" : "LLM failed, falling back to template";
+        this.log.warn(`[mindkeeper] ${reason}`);
+      }
       message = generateTemplateMessage(filesToCommit);
     }
     const oid = await this.store.commit(message);
@@ -890,6 +925,27 @@ var Tracker = class {
       ref: "HEAD"
     });
   }
+  /**
+   * Resolves a ref (HEAD, short hash, or full oid) to a full commit oid.
+   * Uses expandOid for short hashes since isomorphic-git readBlob may not support them.
+   */
+  async resolveOid(ref) {
+    if (ref === "HEAD") {
+      return this.resolveHead();
+    }
+    const git2 = await import("isomorphic-git");
+    const fs2 = await import("node:fs");
+    try {
+      return await git2.default.expandOid({
+        fs: fs2.default,
+        dir: this.workDir,
+        gitdir: this.gitDir,
+        oid: ref
+      });
+    } catch {
+      return null;
+    }
+  }
   async ensureGitignore() {
     const gitignorePath = import_node_path3.default.join(this.workDir, ".gitignore");
     const entry = ".mindkeeper/";
@@ -1246,7 +1302,8 @@ function createWatcherService(api, trackerRef) {
       const tracker = new Tracker({
         workDir: workspaceDir,
         llmProvider: llmProvider ?? void 0,
-        configOverrides: api.pluginConfig
+        configOverrides: api.pluginConfig,
+        log
       });
       await tracker.init();
       trackerRef.current = tracker;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindkeeper-openclaw",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "description": "OpenClaw plugin for mindkeeper: auto-snapshot, diff, and rollback for agent context files",
   "keywords": [
     "openclaw",
@@ -29,14 +29,6 @@
     "scripts/postinstall-merge-config.cjs",
     "README.md"
   ],
-  "scripts": {
-    "build": "node build.mjs",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build",
-    "postinstall": "node scripts/postinstall-merge-config.cjs"
-  },
   "openclaw": {
     "extensions": [
       "./dist/index.js"
@@ -59,5 +51,12 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "postinstall": "node scripts/postinstall-merge-config.cjs"
   }
-}
+}

package/skills/mindkeeper/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: mindkeeper
 description: Time Machine for Your AI's Brain — version control for agent context files. Use when the user asks about changes in SOUL.md, AGENTS.md, MEMORY.md, or other agent context files; when they want to undo, rollback, or compare versions; or when they need a checkpoint before risky edits.
-version: 1.2.6
+version: 1.2.7
 homepage: https://github.com/seekcontext/mindkeeper
 repository: https://github.com/seekcontext/mindkeeper
 ---
@@ -102,6 +102,7 @@ mind_history({ file: "SOUL.md", limit: 20 })
 ### mind_diff
 Compares two versions of a file. `from` and `to` are short or full commit hashes from `mind_history`.
 - Omit `to` to compare `from` against the current version (HEAD).
+- **To see what changed in the latest commit**: use `from: entries[1].oid` (the parent) and `to: entries[0].oid` or omit `to` for HEAD. Do NOT use `from: entries[0].oid` with `to: HEAD` — that compares the same commit to itself and yields an empty diff.
 
 ```
 mind_diff({ file: "SOUL.md", from: "a1b2c3d4" })