mindkeeper-openclaw 0.2.20 → 0.2.22

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindkeeper-openclaw",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "OpenClaw plugin for mindkeeper: auto-snapshot, diff, and rollback for agent context files",
   "keywords": [
     "openclaw",
@@ -29,13 +29,6 @@
     "scripts/postinstall-merge-config.cjs",
     "README.md"
   ],
-  "scripts": {
-    "build": "node build.mjs",
-    "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"
@@ -57,5 +50,11 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "postinstall": "node scripts/postinstall-merge-config.cjs"
   }
-}
+}

package/skills/mindkeeper/README.md

@@ -2,7 +2,7 @@
 
 Time Machine for Your AI's Brain — version control for agent context files. This skill teaches your AI to use mindkeeper tools for history, diff, rollback, and snapshots.
 
-**Drop-in setup:** Add this skill alone — the AI will automatically install the mindkeeper-openclaw plugin and restart the Gateway when you first ask for mindkeeper capability. No manual steps required.
+**Setup:** Add this skill alone. When you first ask for mindkeeper capability, the AI will ask for your confirmation before installing the mindkeeper-openclaw plugin and restarting the Gateway. You can also install the plugin manually (see Requirements).
 
 ## What It Does
 
@@ -16,12 +16,26 @@ Time Machine for Your AI's Brain — version control for agent context files. Th
 - Node.js ≥ 22
 - OpenClaw with Gateway running
 
-The mindkeeper-openclaw plugin is installed automatically by the AI when you first use mindkeeper (see Bootstrap in SKILL.md).
+The mindkeeper-openclaw plugin provides the mind_* tools. The AI will ask for your confirmation before running `openclaw plugins install mindkeeper-openclaw` and restarting the Gateway on first use. Alternatively, install it yourself:
+
+```bash
+openclaw plugins install mindkeeper-openclaw
+# Then restart your Gateway
+```
+
+## Permissions & Why They Are Needed
+
+| Action | Purpose |
+|--------|---------|
+| `openclaw plugins install mindkeeper-openclaw` | Fetches the official plugin from npm to add mind_status, mind_history, mind_diff, mind_rollback, mind_snapshot tools |
+| Gateway restart | Loads the newly installed plugin into the running Gateway |
+
+**User consent:** The AI will not run these commands until you explicitly confirm. This ensures you control when plugins are installed and when the Gateway restarts.
 
 ## How to Use
 
 1. Install this skill: `clawhub install mindkeeper`
-2. Ask your AI in natural language (plugin install + restart happen automatically on first use):
+2. Ask your AI in natural language. On first use, the AI will ask for confirmation before installing the plugin and restarting the Gateway:
    - "What changed in SOUL.md recently?"
    - "Compare my current AGENTS.md to last week's version"
    - "Roll back SOUL.md to yesterday"

package/skills/mindkeeper/SKILL.md

@@ -1,7 +1,9 @@
 ---
 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.1.0
+version: 1.2.1
+homepage: https://github.com/seekcontext/mindkeeper
+repository: https://github.com/seekcontext/mindkeeper
 ---
 
 # Mindkeeper — Time Machine for Your AI's Brain
@@ -10,14 +12,19 @@ Use mindkeeper tools when the user asks about changes, history, or versions of t
 
 ## Bootstrap (One-time setup)
 
-**When the user enables mindkeeper or asks for mindkeeper capability**, first try `mind_status`. If it fails (tool not found or similar), run this flow **automatically without asking**:
+**When the user enables mindkeeper or asks for mindkeeper capability**, first try `mind_status`. If it fails (tool not found or similar):
 
-1. **Install the plugin** — Run via bash:
-   ```bash
-   openclaw plugins install mindkeeper-openclaw
-   ```
-2. **Restart the gateway** — Use the `gateway` tool with `action: "restart"` and `note: "Restarting to load mindkeeper plugin"`. If gateway restart is disabled or fails, tell the user: "Plugin installed. Restart your Gateway manually to apply."
-3. **Confirm** — Tell the user: "Mindkeeper is ready. Restart complete — you can now ask about history, diffs, rollbacks, or snapshots."
+1. **Ask for confirmation** — Tell the user: "Mindkeeper needs the mindkeeper-openclaw plugin to work. I'll need to run `openclaw plugins install mindkeeper-openclaw` and restart the Gateway. May I proceed?" **Do not install or restart until the user explicitly confirms.**
+
+2. **After user confirms** — Run this flow:
+   - **Install the plugin** — Run via bash:
+     ```bash
+     openclaw plugins install mindkeeper-openclaw
+     ```
+   - **Restart the gateway** — Use the `gateway` tool with `action: "restart"` and `note: "Restarting to load mindkeeper plugin"`. If gateway restart is disabled or fails, tell the user: "Plugin installed. Restart your Gateway manually to apply."
+   - **Confirm** — Tell the user: "Mindkeeper is ready. Restart complete — you can now ask about history, diffs, rollbacks, or snapshots."
+
+3. **Alternative** — If the user prefers to install manually, tell them: "Run `openclaw plugins install mindkeeper-openclaw` in your terminal, then restart your Gateway. After that, mindkeeper will be ready."
 
 If `mind_status` succeeds, the plugin is already installed; skip the bootstrap and proceed with the user's request.
 

package/skills/mindkeeper/clawhub.json

@@ -1,12 +1,13 @@
 {
   "name": "Mindkeeper",
   "tagline": "Time Machine for Your AI's Brain",
-  "description": "Time Machine for Your AI's Brain — version control for agent context files. Every change to AGENTS.md, SOUL.md, MEMORY.md, skills, and other context files is automatically tracked. Your AI can browse history, compare versions with diff, create named checkpoints, and roll back any file to any previous state.\n\nDrop-in setup: add this skill alone — when the user first asks for mindkeeper, the AI automatically installs the mindkeeper-openclaw plugin and restarts the Gateway. No manual install or restart required.\n\nUse this skill when the user asks about changes, history, or versions of their agent context files. The AI learns to use mind_status, mind_history, mind_diff, mind_rollback, and mind_snapshot tools.",
+  "description": "Time Machine for Your AI's Brain — version control for agent context files. Every change to AGENTS.md, SOUL.md, MEMORY.md, skills, and other context files is automatically tracked. Your AI can browse history, compare versions with diff, create named checkpoints, and roll back any file to any previous state.\n\nSetup: add this skill alone. When the user first asks for mindkeeper, the AI will ask for explicit confirmation before installing the mindkeeper-openclaw plugin and restarting the 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 AI learns to use mind_status, mind_history, mind_diff, mind_rollback, and mind_snapshot tools.",
   "category": "productivity",
   "tags": ["version-control", "agent", "history", "rollback", "snapshot", "diff", "openclaw"],
-  "version": "1.1.0",
+  "version": "1.2.1",
   "license": "MIT",
   "pricing": "free",
-  "support_url": "https://github.com/seekcontext/mindkeeper/issues",
-  "homepage": "https://github.com/seekcontext/mindkeeper"
+  "homepage": "https://github.com/seekcontext/mindkeeper",
+  "repository": "https://github.com/seekcontext/mindkeeper",
+  "support_url": "https://github.com/seekcontext/mindkeeper/issues"
 }