mindkeeper-openclaw 0.2.8 → 0.2.9

package/dist/index.js

@@ -18416,6 +18416,212 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
   }
 });
 
+// src/tools.ts
+function getTracker(ref) {
+  if (!ref.current) {
+    throw new Error("mindkeeper: tracker not ready \u2014 workspace not initialized yet.");
+  }
+  return ref.current;
+}
+function registerTrackerTools(api, trackerRef) {
+  if (!api.registerTool) return;
+  api.registerTool({
+    name: "mind_history",
+    description: "View version history of agent context files. Optionally filter by a specific file. Returns commit hashes, dates, and messages.",
+    parameters: {
+      type: "object",
+      properties: {
+        file: {
+          type: "string",
+          description: "File path to filter history (e.g. 'SOUL.md'). Omit for all files."
+        },
+        limit: {
+          type: "number",
+          description: "Maximum number of entries to return (default: 10)."
+        }
+      }
+    },
+    handler: async (args) => {
+      const commits = await getTracker(trackerRef).history({
+        file: args.file,
+        limit: args.limit ?? 10
+      });
+      return formatHistoryResult(commits);
+    }
+  });
+  api.registerTool({
+    name: "mind_diff",
+    description: "Compare two versions of an agent context file. Shows additions, deletions, and a unified diff.",
+    parameters: {
+      type: "object",
+      properties: {
+        file: { type: "string", description: "File path to compare (e.g. 'SOUL.md')." },
+        from: { type: "string", description: "Source commit hash." },
+        to: { type: "string", description: "Target commit hash (defaults to HEAD)." }
+      },
+      required: ["file", "from"]
+    },
+    handler: async (args) => {
+      const result = await getTracker(trackerRef).diff({
+        file: args.file,
+        from: args.from,
+        to: args.to
+      });
+      return formatDiffResult(result);
+    }
+  });
+  api.registerTool({
+    name: "mind_rollback",
+    description: "Rollback an agent context file to a previous version. First call with preview=true to see the diff, then call again without preview to execute.",
+    parameters: {
+      type: "object",
+      properties: {
+        file: { type: "string", description: "File path to rollback (e.g. 'SOUL.md')." },
+        to: { type: "string", description: "Commit hash to rollback to." },
+        preview: {
+          type: "boolean",
+          description: "If true, show diff preview without executing rollback. Default: true."
+        }
+      },
+      required: ["file", "to"]
+    },
+    handler: async (args) => {
+      const file = args.file;
+      const to = args.to;
+      const preview = args.preview ?? true;
+      const tracker = getTracker(trackerRef);
+      if (preview) {
+        const diff2 = await tracker.diff({ file, from: to, to: "HEAD" });
+        return {
+          preview: true,
+          diff: formatDiffResult(diff2),
+          instruction: "Show this diff to the user. If they confirm, call mind_rollback again with preview=false."
+        };
+      }
+      const commit = await tracker.rollback({ file, to });
+      return {
+        preview: false,
+        success: true,
+        commit: { oid: commit.oid.slice(0, 8), message: commit.message },
+        note: "Tell the user to run /new to apply the changes to the current session."
+      };
+    }
+  });
+  api.registerTool({
+    name: "mind_snapshot",
+    description: "Create a named checkpoint of the current state of all agent context files. Useful before making significant changes.",
+    parameters: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Snapshot name (e.g. 'personality-v2')." },
+        message: { type: "string", description: "Optional description of this snapshot." }
+      },
+      required: ["name"]
+    },
+    handler: async (args) => {
+      const commit = await getTracker(trackerRef).snapshot({
+        name: args.name,
+        message: args.message
+      });
+      return {
+        success: true,
+        snapshot: args.name,
+        commit: { oid: commit.oid.slice(0, 8), message: commit.message }
+      };
+    }
+  });
+  api.registerTool({
+    name: "mind_status",
+    description: "Show the current tracking status: tracked files, pending changes, and named snapshots.",
+    parameters: { type: "object", properties: {} },
+    handler: async () => {
+      const status = await getTracker(trackerRef).status();
+      return formatStatusResult(status);
+    }
+  });
+}
+function formatHistoryResult(commits) {
+  return {
+    count: commits.length,
+    entries: commits.map((c) => ({
+      oid: c.oid.slice(0, 8),
+      date: c.date.toISOString().replace("T", " ").slice(0, 19),
+      message: c.message
+    }))
+  };
+}
+function formatDiffResult(result) {
+  return {
+    file: result.file,
+    from: result.fromVersion,
+    to: result.toVersion,
+    additions: result.additions,
+    deletions: result.deletions,
+    unified: result.unified
+  };
+}
+function formatStatusResult(status) {
+  return {
+    initialized: status.initialized,
+    workDir: status.workDir,
+    pendingChanges: status.pendingChanges.map((e) => ({
+      file: e.filepath,
+      status: e.status
+    })),
+    snapshots: status.snapshots.map((s) => ({
+      name: s.name,
+      oid: s.oid.slice(0, 8)
+    }))
+  };
+}
+
+// src/cli.ts
+function getTracker2(ref) {
+  if (!ref.current) {
+    throw new Error("mindkeeper: tracker not ready \u2014 workspace not initialized yet.");
+  }
+  return ref.current;
+}
+function registerTrackerCli(api, trackerRef) {
+  if (!api.registerCli) return;
+  api.registerCli((program) => {
+    const cmd = program;
+    const mindCmd = cmd.command("mind");
+    addSubcommand(mindCmd, "status", "Show tracking status", async () => {
+      const status = await getTracker2(trackerRef).status();
+      console.log(`Workspace: ${status.workDir}`);
+      console.log(`Pending changes: ${status.pendingChanges.length}`);
+      console.log(`Named snapshots: ${status.snapshots.length}`);
+    });
+    addSubcommand(mindCmd, "history [file]", "View change history", async (...args) => {
+      const file = args[0];
+      const commits = await getTracker2(trackerRef).history({ file, limit: 20 });
+      if (commits.length === 0) {
+        console.log("No history found.");
+        return;
+      }
+      for (const c of commits) {
+        const date = c.date.toISOString().replace("T", " ").slice(0, 19);
+        console.log(`${c.oid.slice(0, 8)}  ${date}  ${c.message}`);
+      }
+    });
+    addSubcommand(
+      mindCmd,
+      "snapshot [name]",
+      "Create a named snapshot",
+      async (...args) => {
+        const name = args[0];
+        const commit = await getTracker2(trackerRef).snapshot({ name });
+        console.log(`Snapshot created: ${commit.oid.slice(0, 8)} ${commit.message}`);
+        if (name) console.log(`Tagged as: ${name}`);
+      }
+    );
+  });
+}
+function addSubcommand(parent, name, description, handler) {
+  parent.command(name).description(description).action(handler);
+}
+
 // ../core/dist/tracker.js
 import fsPromises3 from "node:fs/promises";
 import path4 from "node:path";
@@ -23447,228 +23653,46 @@ function isProcessRunning(pid) {
   }
 }
 
-// src/tools.ts
-function registerTrackerTools(api, tracker) {
-  if (!api.registerTool) return;
-  api.registerTool({
-    name: "mind_history",
-    description: "View version history of agent context files. Optionally filter by a specific file. Returns commit hashes, dates, and messages.",
-    parameters: {
-      type: "object",
-      properties: {
-        file: {
-          type: "string",
-          description: "File path to filter history (e.g. 'SOUL.md'). Omit for all files."
-        },
-        limit: {
-          type: "number",
-          description: "Maximum number of entries to return (default: 10)."
-        }
-      }
-    },
-    handler: async (args) => {
-      const commits = await tracker.history({
-        file: args.file,
-        limit: args.limit ?? 10
-      });
-      return formatHistoryResult(commits);
-    }
-  });
-  api.registerTool({
-    name: "mind_diff",
-    description: "Compare two versions of an agent context file. Shows additions, deletions, and a unified diff.",
-    parameters: {
-      type: "object",
-      properties: {
-        file: { type: "string", description: "File path to compare (e.g. 'SOUL.md')." },
-        from: { type: "string", description: "Source commit hash." },
-        to: { type: "string", description: "Target commit hash (defaults to HEAD)." }
-      },
-      required: ["file", "from"]
-    },
-    handler: async (args) => {
-      const result = await tracker.diff({
-        file: args.file,
-        from: args.from,
-        to: args.to
-      });
-      return formatDiffResult(result);
-    }
-  });
-  api.registerTool({
-    name: "mind_rollback",
-    description: "Rollback an agent context file to a previous version. First call with preview=true to see the diff, then call again without preview to execute.",
-    parameters: {
-      type: "object",
-      properties: {
-        file: { type: "string", description: "File path to rollback (e.g. 'SOUL.md')." },
-        to: { type: "string", description: "Commit hash to rollback to." },
-        preview: {
-          type: "boolean",
-          description: "If true, show diff preview without executing rollback. Default: true."
-        }
-      },
-      required: ["file", "to"]
-    },
-    handler: async (args) => {
-      const file = args.file;
-      const to = args.to;
-      const preview = args.preview ?? true;
-      if (preview) {
-        const diff2 = await tracker.diff({ file, from: to, to: "HEAD" });
-        return {
-          preview: true,
-          diff: formatDiffResult(diff2),
-          instruction: "Show this diff to the user. If they confirm, call mind_rollback again with preview=false."
-        };
-      }
-      const commit = await tracker.rollback({ file, to });
-      return {
-        preview: false,
-        success: true,
-        commit: { oid: commit.oid.slice(0, 8), message: commit.message },
-        note: "Tell the user to run /new to apply the changes to the current session."
-      };
-    }
-  });
-  api.registerTool({
-    name: "mind_snapshot",
-    description: "Create a named checkpoint of the current state of all agent context files. Useful before making significant changes.",
-    parameters: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "Snapshot name (e.g. 'personality-v2')." },
-        message: { type: "string", description: "Optional description of this snapshot." }
-      },
-      required: ["name"]
-    },
-    handler: async (args) => {
-      const commit = await tracker.snapshot({
-        name: args.name,
-        message: args.message
-      });
-      return {
-        success: true,
-        snapshot: args.name,
-        commit: { oid: commit.oid.slice(0, 8), message: commit.message }
-      };
-    }
-  });
-  api.registerTool({
-    name: "mind_status",
-    description: "Show the current tracking status: tracked files, pending changes, and named snapshots.",
-    parameters: { type: "object", properties: {} },
-    handler: async () => {
-      const status = await tracker.status();
-      return formatStatusResult(status);
-    }
-  });
-}
-function formatHistoryResult(commits) {
-  return {
-    count: commits.length,
-    entries: commits.map((c) => ({
-      oid: c.oid.slice(0, 8),
-      date: c.date.toISOString().replace("T", " ").slice(0, 19),
-      message: c.message
-    }))
-  };
-}
-function formatDiffResult(result) {
-  return {
-    file: result.file,
-    from: result.fromVersion,
-    to: result.toVersion,
-    additions: result.additions,
-    deletions: result.deletions,
-    unified: result.unified
-  };
-}
-function formatStatusResult(status) {
-  return {
-    initialized: status.initialized,
-    workDir: status.workDir,
-    pendingChanges: status.pendingChanges.map((e) => ({
-      file: e.filepath,
-      status: e.status
-    })),
-    snapshots: status.snapshots.map((s) => ({
-      name: s.name,
-      oid: s.oid.slice(0, 8)
-    }))
-  };
-}
-
-// src/cli.ts
-function registerTrackerCli(api, tracker) {
-  if (!api.registerCli) return;
-  api.registerCli((program) => {
-    const cmd = program;
-    const mindCmd = cmd.command("mind");
-    addSubcommand(mindCmd, "status", "Show tracking status", async () => {
-      const status = await tracker.status();
-      console.log(`Workspace: ${status.workDir}`);
-      console.log(`Pending changes: ${status.pendingChanges.length}`);
-      console.log(`Named snapshots: ${status.snapshots.length}`);
-    });
-    addSubcommand(mindCmd, "history [file]", "View change history", async (...args) => {
-      const file = args[0];
-      const commits = await tracker.history({ file, limit: 20 });
-      if (commits.length === 0) {
-        console.log("No history found.");
-        return;
-      }
-      for (const c of commits) {
-        const date = c.date.toISOString().replace("T", " ").slice(0, 19);
-        console.log(`${c.oid.slice(0, 8)}  ${date}  ${c.message}`);
-      }
-    });
-    addSubcommand(
-      mindCmd,
-      "snapshot [name]",
-      "Create a named snapshot",
-      async (...args) => {
-        const name = args[0];
-        const commit = await tracker.snapshot({ name });
-        console.log(`Snapshot created: ${commit.oid.slice(0, 8)} ${commit.message}`);
-        if (name) console.log(`Tagged as: ${name}`);
-      }
-    );
-  });
-}
-function addSubcommand(parent, name, description, handler) {
-  parent.command(name).description(description).action(handler);
-}
-
 // src/service.ts
-function createWatcherService(tracker, api) {
+function createWatcherService(api, trackerRef, llmProvider) {
   let watcher = null;
+  const log = {
+    info: (msg) => api.log?.info?.(msg),
+    warn: (msg) => api.log?.warn?.(msg),
+    error: (msg) => api.log?.error?.(msg)
+  };
   return {
     id: "mindkeeper-watcher",
-    async start() {
+    async start(ctx) {
+      const workspaceDir = ctx.workspaceDir ?? process.env.OPENCLAW_WORKSPACE;
+      if (!workspaceDir) {
+        log.warn("[mindkeeper] No workspace directory in service context. Watcher disabled.");
+        return;
+      }
+      const tracker = new Tracker({ workDir: workspaceDir, llmProvider });
       await tracker.init();
+      trackerRef.current = tracker;
       watcher = new Watcher({
         tracker,
         onSnapshot: (commit) => {
-          api.log?.info?.(
-            `[mindkeeper] Auto-snapshot ${commit.oid.slice(0, 8)}: ${commit.message}`
-          );
+          log.info(`[mindkeeper] Auto-snapshot ${commit.oid.slice(0, 8)}: ${commit.message}`);
         },
         onError: (err) => {
-          api.log?.error?.(`[mindkeeper] Watcher error: ${err.message}`);
+          log.error(`[mindkeeper] Watcher error: ${err.message}`);
         }
       });
       await watcher.start();
-      api.log?.info?.(
-        `[mindkeeper] Watching ${tracker.workDir} (debounce: ${tracker.getConfig().snapshot.debounceMs}ms)`
+      log.info(
+        `[mindkeeper] Watching ${workspaceDir} (debounce: ${tracker.getConfig().snapshot.debounceMs}ms)`
       );
     },
     async stop() {
       if (watcher) {
         await watcher.stop();
         watcher = null;
-        api.log?.info?.("[mindkeeper] Watcher stopped.");
+        log.info("[mindkeeper] Watcher stopped.");
       }
+      trackerRef.current = null;
     }
   };
 }
@@ -23829,23 +23853,15 @@ function resolveModelFromConfig(config) {
 
 // src/index.ts
 async function mindkeeperPlugin(api) {
-  const workspaceDir = api.getWorkspaceDir?.() ?? process.env.OPENCLAW_WORKSPACE;
-  if (!workspaceDir) {
-    api.log?.warn?.("[mindkeeper] No workspace directory found. Plugin disabled.");
-    return;
-  }
   const llmProvider = await createOpenClawLlmProvider({
     config: api.config,
     pluginConfig: api.pluginConfig,
     log: api.log
   });
-  const tracker = new Tracker({
-    workDir: workspaceDir,
-    llmProvider: llmProvider ?? void 0
-  });
-  registerTrackerTools(api, tracker);
-  registerTrackerCli(api, tracker);
-  const watcherService = createWatcherService(tracker, api);
+  const trackerRef = { current: null };
+  registerTrackerTools(api, trackerRef);
+  registerTrackerCli(api, trackerRef);
+  const watcherService = createWatcherService(api, trackerRef, llmProvider ?? void 0);
   api.registerService?.(watcherService);
   api.log?.info?.("[mindkeeper] Plugin loaded.");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindkeeper-openclaw",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "OpenClaw plugin for mindkeeper: auto-snapshot, diff, and rollback for agent context files",
   "keywords": [
     "openclaw",