mindkeeper-openclaw 0.2.31 → 0.2.33

package/dist/index.js

@@ -718,11 +718,66 @@ var Tracker = class {
     await this.ensureConfigLoaded();
     await this.store.init();
     await this.ensureGitignore();
+    this.log?.info?.(
+      `[mindkeeper] init: commitMessage.mode=${this.config.commitMessage.mode}, llmProvider=${this.llmProvider ? "yes" : "no"}`
+    );
     const changed = await this.getTrackedChangedFiles();
     if (changed.length > 0) {
-      await this.store.addFiles(changed.map((e) => e.filepath));
-      const msg = generateTemplateMessage(changed.map((e) => e.filepath));
-      await this.store.commit(msg);
+      const filesToCommit = changed.map((e) => e.filepath);
+      await this.store.addFiles(filesToCommit);
+      let message = null;
+      if (this.config.commitMessage.mode === "llm" && this.llmProvider) {
+        let headOid = null;
+        try {
+          headOid = await this.resolveHead();
+        } catch {
+        }
+        if (headOid) {
+          const diffs = [];
+          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 {
+            }
+          }
+          if (diffs.length > 0) {
+            message = await generateLlmMessage(diffs, this.llmProvider, this.log);
+            if (message) {
+              this.log?.info?.(
+                `[mindkeeper] init: LLM-generated commit \u2014 "${message.slice(0, 50)}${message.length > 50 ? "\u2026" : ""}"`
+              );
+            }
+          } else {
+            this.log?.info?.("[mindkeeper] init: diffs empty (all files unchanged vs HEAD)");
+          }
+        } else {
+          this.log?.info?.("[mindkeeper] init: no HEAD yet (first commit), LLM skipped");
+        }
+      }
+      if (!message) {
+        message = generateTemplateMessage(filesToCommit);
+        this.log?.info?.(`[mindkeeper] init: using template \u2014 "${message}"`);
+      }
+      await this.store.commit(message);
+    } else {
+      this.log?.info?.("[mindkeeper] init: no changed files");
     }
     return { initialFiles: changed.map((e) => e.filepath) };
   }
@@ -823,6 +878,9 @@ var Tracker = class {
       headOid = await this.resolveHead();
     } catch {
     }
+    this.log?.info?.(
+      `[mindkeeper] autoSnapshot: files=${filesToCommit.length}, headOid=${headOid ? headOid.slice(0, 8) : "none"}, mode=${this.config.commitMessage.mode}, llmProvider=${this.llmProvider ? "yes" : "no"}`
+    );
     if (headOid) {
       for (const file of filesToCommit) {
         try {
@@ -846,10 +904,14 @@ var Tracker = class {
           if (d.additions > 0 || d.deletions > 0) {
             diffs.push(d);
           }
-        } catch {
+        } catch (err) {
+          this.log?.warn?.(
+            `[mindkeeper] autoSnapshot: diff failed for ${file}: ${err instanceof Error ? err.message : String(err)}`
+          );
         }
       }
     }
+    this.log?.info?.(`[mindkeeper] autoSnapshot: computed ${diffs.length} non-empty diff(s)`);
     let message = null;
     let usedLlm = false;
     let templateReason = null;
@@ -857,28 +919,26 @@ var Tracker = class {
       if (this.llmProvider) {
         message = await generateLlmMessage(diffs, this.llmProvider, this.log);
         if (message) usedLlm = true;
-        else templateReason = "LLM API call failed (check logs above for error)";
+        else templateReason = "LLM API call failed (check logs above for error details)";
       } else {
-        templateReason = "LLM provider not configured (no default model or API key in OpenClaw)";
+        templateReason = "llmProvider is null (createOpenClawLlmProvider returned null \u2014 check startup logs)";
       }
     } else if (this.config.commitMessage.mode === "llm" && diffs.length === 0) {
-      templateReason = "first commit or no diff (no previous version to compare, diffs.length=0)";
+      templateReason = headOid ? `diffs empty (${filesToCommit.length} file(s) changed but no textual diff vs HEAD)` : "no HEAD commit yet (first commit), cannot compute diff";
     } else {
-      templateReason = "config: commitMessage.mode is 'template'";
+      templateReason = `commitMessage.mode="${this.config.commitMessage.mode}" (not "llm")`;
     }
     if (!message) {
       message = generateTemplateMessage(filesToCommit);
     }
-    if (this.log) {
-      if (usedLlm) {
-        this.log.info?.(
-          `[mindkeeper] Commit message: LLM-generated \u2014 "${message.slice(0, 50)}${message.length > 50 ? "\u2026" : ""}"`
-        );
-      } else {
-        this.log.warn?.(
-          `[mindkeeper] Commit message: template \u2014 reason: ${templateReason}`
-        );
-      }
+    if (usedLlm) {
+      this.log?.info?.(
+        `[mindkeeper] Commit message: LLM \u2713 \u2014 "${message.slice(0, 60)}${message.length > 60 ? "\u2026" : ""}"`
+      );
+    } else {
+      this.log?.warn?.(
+        `[mindkeeper] Commit message: TEMPLATE \u2014 reason: ${templateReason}`
+      );
     }
     const oid = await this.store.commit(message);
     return {
@@ -1191,7 +1251,7 @@ function readEnvApiKey(provider) {
 // src/llm-provider.ts
 var MAX_DIFF_CHARS = 4e3;
 async function createOpenClawLlmProvider(api) {
-  const modelSpec = resolveModelFromConfig(api.config);
+  const modelSpec = resolveModelFromConfig(api.config, api.log);
   if (!modelSpec) {
     api.log?.warn?.(
       "[mindkeeper] No default model configured in OpenClaw \u2014 LLM commit messages disabled."
@@ -1207,25 +1267,32 @@ async function createOpenClawLlmProvider(api) {
   const apiKey = await resolveApiKey(modelSpec.provider);
   if (!apiKey) {
     api.log?.warn?.(
-      `[mindkeeper] No API key found for provider "${modelSpec.provider}" \u2014 LLM commit messages disabled.`
+      `[mindkeeper] No API key found for provider "${modelSpec.provider}" \u2014 LLM commit messages disabled. Checked: auth-profiles.json + env vars.`
     );
     return null;
   }
   api.log?.info?.(
-    `[mindkeeper] LLM commit messages enabled (${modelSpec.provider}/${modelSpec.model}).`
+    `[mindkeeper] LLM commit messages enabled (${modelSpec.provider}/${modelSpec.model}${modelSpec.baseUrl ? `, baseUrl=${modelSpec.baseUrl}` : ""}).`
   );
   return {
     async generateCommitMessage(diffs) {
       const diffText = diffs.map((d) => `--- ${d.file} ---
 ${d.unified}`).join("\n").slice(0, MAX_DIFF_CHARS);
+      api.log?.info?.(
+        `[mindkeeper] Calling LLM for commit message (${diffs.length} diff(s), ${diffText.length} chars)\u2026`
+      );
       const { callLlm } = await import("./llm-client.cjs");
-      return callLlm({
+      const result = await callLlm({
         provider: modelSpec.provider,
         model: modelSpec.model,
         apiKey,
         userPrompt: diffText,
         baseUrl: modelSpec.baseUrl
       });
+      api.log?.info?.(
+        `[mindkeeper] LLM returned: "${(result ?? "").slice(0, 60)}${(result ?? "").length > 60 ? "\u2026" : ""}"`
+      );
+      return result;
     }
   };
 }
@@ -1233,10 +1300,13 @@ function isOAuthProvider(provider) {
   const normalized = normalizeProvider(provider);
   return normalized.includes("portal") || normalized.includes("oauth");
 }
-function resolveModelFromConfig(config) {
+function resolveModelFromConfig(config, log) {
   const agents = config?.agents;
   const defaults = agents?.defaults;
   const raw = defaults?.model;
+  log?.info?.(
+    `[mindkeeper] resolveModel: config.agents=${agents ? "present" : "missing"}, config.agents.defaults=${defaults ? "present" : "missing"}, config.agents.defaults.model=${raw === void 0 ? "undefined" : typeof raw === "string" ? `"${raw}"` : JSON.stringify(raw)}`
+  );
   let spec;
   if (typeof raw === "string") {
     spec = raw.trim();
@@ -1244,7 +1314,12 @@ function resolveModelFromConfig(config) {
     const primary = raw.primary;
     if (typeof primary === "string") spec = primary.trim();
   }
-  if (!spec?.includes("/")) return null;
+  if (!spec?.includes("/")) {
+    log?.warn?.(
+      `[mindkeeper] resolveModel: no valid "provider/model" spec found (got: ${spec === void 0 ? "undefined" : `"${spec}"`})`
+    );
+    return null;
+  }
   const slashIdx = spec.indexOf("/");
   const provider = spec.slice(0, slashIdx);
   const model = spec.slice(slashIdx + 1);
@@ -1301,9 +1376,9 @@ function resolveBundledSkillDir() {
 function createWatcherService(api, trackerRef) {
   let watcher = null;
   const log = {
-    info: (msg) => api.log?.info?.(msg),
-    warn: (msg) => api.log?.warn?.(msg),
-    error: (msg) => api.log?.error?.(msg)
+    info: (msg) => api.logger?.info?.(msg),
+    warn: (msg) => api.logger?.warn?.(msg),
+    error: (msg) => api.logger?.error?.(msg)
   };
   return {
     id: "mindkeeper-watcher",
@@ -1313,11 +1388,17 @@ function createWatcherService(api, trackerRef) {
         log.warn("[mindkeeper] No workspace directory in service context. Watcher disabled.");
         return;
       }
-      ensureWorkspaceSkillMirror(workspaceDir, { log: api.log });
+      ensureWorkspaceSkillMirror(workspaceDir, { log: api.logger });
+      log.info(
+        `[mindkeeper] Service starting: ctx.config=${ctx.config ? "present" : "missing"}, pluginConfig=${api.pluginConfig ? JSON.stringify(api.pluginConfig) : "none"}`
+      );
       const llmProvider = await createOpenClawLlmProvider({
         config: ctx.config,
         log
       });
+      log.info(
+        `[mindkeeper] LLM provider: ${llmProvider ? "created successfully" : "null (will use template)"}`
+      );
       const tracker = new Tracker({
         workDir: workspaceDir,
         llmProvider: llmProvider ?? void 0,
@@ -1326,6 +1407,9 @@ function createWatcherService(api, trackerRef) {
       });
       await tracker.init();
       trackerRef.current = tracker;
+      log.info(
+        `[mindkeeper] Tracker config: commitMessage.mode=${tracker.getConfig().commitMessage.mode}`
+      );
       watcher = new Watcher({
         tracker,
         onSnapshot: (commit) => {
@@ -1363,11 +1447,11 @@ function mindkeeperPlugin(api) {
   const trackerRef = { current: null };
   registerTrackerTools(api, trackerRef);
   registerTrackerCli(api, trackerRef);
-  ensureWorkspaceSkillMirror(api.getWorkspaceDir?.(), { log: api.log });
+  ensureWorkspaceSkillMirror(api.getWorkspaceDir?.(), { log: api.logger });
   const watcherService = createWatcherService(api, trackerRef);
   api.registerService?.(watcherService);
   ensureToolsInConfig(api);
-  api.log?.info?.("[mindkeeper] Plugin loaded.");
+  api.logger?.info?.("[mindkeeper] Plugin loaded.");
 }
 function ensureToolsInConfig(api) {
   const cfg = api.config;
@@ -1388,5 +1472,5 @@ function ensureToolsInConfig(api) {
   void writeConfigFile({
     ...cfg,
     tools: { ...cfg.tools, [key]: merged }
-  }).catch((err) => api.log?.warn?.(`[mindkeeper] Failed to auto-update tools.${key}:`, String(err)));
+  }).catch((err) => api.logger?.warn?.(`[mindkeeper] Failed to auto-update tools.${key}:`, String(err)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindkeeper-openclaw",
-  "version": "0.2.31",
+  "version": "0.2.33",
   "description": "OpenClaw plugin for mindkeeper: auto-snapshot, diff, and rollback for agent context files",
   "keywords": [
     "openclaw",
@@ -29,6 +29,14 @@
     "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"
@@ -51,12 +59,5 @@
   },
   "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/LICENSE

@@ -1,21 +0,0 @@
-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.