mindkeeper-openclaw 0.2.27 → 0.2.29

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/README.md

@@ -24,7 +24,7 @@ openclaw plugins install mindkeeper-openclaw
 
 Then restart your Gateway once.
 
-On startup, the plugin also mirrors its built-in `mindkeeper` skill into the workspace so new sessions can still find the bootstrap instructions even if no separate ClawHub skill was installed.
+On startup, the plugin mirrors its built-in `mindkeeper` skill into `<workspace>/skills/mindkeeper/` (OpenClaw's standard workspace skills path) so new sessions can find the bootstrap instructions even if no separate ClawHub skill was installed.
 
 ### Option 2 — Install the skill and let the AI guide setup
 

package/dist/index.js

@@ -756,8 +756,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 +772,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,13 +814,36 @@ 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;
@@ -890,6 +917,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/";
@@ -1187,7 +1235,7 @@ var SKILL_FILES = ["SKILL.md", "README.md", "clawhub.json"];
 function ensureWorkspaceSkillMirror(workspaceDir, options = {}) {
   if (!workspaceDir) return;
   const sourceDir = options.sourceDir ?? resolveBundledSkillDir();
-  const targetDir = import_node_path6.default.join(workspaceDir, SKILL_DIR_NAME);
+  const targetDir = import_node_path6.default.join(workspaceDir, "skills", SKILL_DIR_NAME);
   if (!(0, import_node_fs2.existsSync)(sourceDir)) {
     options.log?.warn?.(`[mindkeeper] Built-in skill directory not found: ${sourceDir}`);
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindkeeper-openclaw",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "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.5
+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" })

package/skills/mindkeeper/clawhub.json

@@ -4,7 +4,7 @@
   "description": "Time Machine for Your AI's Brain — install this skill if you want your AI to inspect history, show diffs, create checkpoints, and guide rollback in natural language across agent context files.\n\nSetup: add this skill alone. On first use, the AI checks whether the mindkeeper-openclaw plugin is available. If it is not, the AI asks for explicit confirmation before installing the plugin and before restarting Gateway. User consent is required for plugin install and Gateway restart.\n\nUse this skill when the user asks about changes, history, or versions of their agent context files. The skill teaches the AI how to bootstrap and use the mind_status, mind_history, mind_diff, mind_rollback, and mind_snapshot tools safely.",
   "category": "productivity",
   "tags": ["version-control", "agent", "history", "rollback", "snapshot", "diff", "openclaw"],
-  "version": "1.2.5",
+  "version": "1.2.6",
   "license": "MIT",
   "pricing": "free",
   "homepage": "https://github.com/seekcontext/mindkeeper",