@xdarkicex/openclaw-memory-libravdb 1.4.66 → 1.4.68

package/dist/context-engine.js

@@ -605,11 +605,12 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
         info: { id: "libravdb-memory", name: "LibraVDB Memory", ownsCompaction: true },
         ownsCompaction: true,
         async bootstrap(args) {
+            const sessionId = requireSessionId(args.sessionId, "bootstrap");
             const userId = resolveUserId({
                 userIdOverride: args.userId,
                 sessionKey: args.sessionKey,
             });
-            logger.info?.(`LibraVDB bootstrap sessionId=${args.sessionId} userId=${userId} ` +
+            logger.info?.(`LibraVDB bootstrap sessionId=${sessionId} userId=${userId} ` +
                 `sessionKey=${args.sessionKey ?? "(none)"}`);
             const kernel = await getKernelOrNull("bootstrap");
             if (kernel) {
@@ -623,7 +624,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     // Proceed even if initialize session fails or doesn't return nonce if secret optional
                 }
                 return await kernel.bootstrapSession({
-                    sessionId: args.sessionId,
+                    sessionId,
                     sessionKey: args.sessionKey,
                     userId,
                 });
@@ -631,23 +632,25 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             const rpc = await runtime.getRpc();
             return await rpc.call("bootstrap_session_kernel", {
                 ...args,
+                sessionId,
                 userId,
             });
         },
         async ingest(args) {
+            const sessionId = requireSessionId(args.sessionId, "ingest");
             const userId = resolveUserId({
                 userIdOverride: args.userId,
                 sessionKey: args.sessionKey,
             });
             const message = normalizeKernelMessage(args.message);
-            logger.info?.(`LibraVDB ingest sessionId=${args.sessionId} userId=${userId} ` +
+            logger.info?.(`LibraVDB ingest sessionId=${sessionId} userId=${userId} ` +
                 `role=${message.role} heartbeat=${args.isHeartbeat ?? false} ` +
                 `contentLen=${message.content.length}`);
             try {
                 const kernel = await getKernelOrNull("ingest");
                 if (kernel) {
                     return await kernel.ingestMessage({
-                        sessionId: args.sessionId,
+                        sessionId,
                         sessionKey: args.sessionKey,
                         userId,
                         message,
@@ -657,17 +660,19 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 const rpc = await runtime.getRpc();
                 return await rpc.call("ingest_message_kernel", {
                     ...args,
+                    sessionId,
                     userId,
                     message,
                 });
             }
             catch (error) {
-                logger.warn?.(`LibraVDB ingest failed sessionId=${args.sessionId}: ` +
+                logger.warn?.(`LibraVDB ingest failed sessionId=${sessionId}: ` +
                     `${error instanceof Error ? error.message : String(error)}`);
                 throw error;
             }
         },
         async assemble(args) {
+            const sessionId = requireSessionId(args.sessionId, "assemble");
             const userId = resolveUserId({
                 userIdOverride: args.userId,
                 sessionKey: args.sessionKey,
@@ -687,14 +692,14 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 logPredictiveCompactionAttempt({
                     logger,
                     phase: "assemble",
-                    sessionId: args.sessionId,
+                    sessionId,
                     currentTokenCount: currentContextTokens,
                     threshold: dynamicCompactThreshold,
                     targetSize: predictiveTargetSize,
                     tokenBudget: args.tokenBudget,
                 });
                 const compactionResult = await runCompaction({
-                    sessionId: args.sessionId,
+                    sessionId,
                     targetSize: predictiveTargetSize,
                     tokenBudget: args.tokenBudget,
                     force: true,
@@ -703,7 +708,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 logPredictiveCompactionOutcome({
                     logger,
                     phase: "assemble",
-                    sessionId: args.sessionId,
+                    sessionId,
                     currentTokenCount: currentContextTokens,
                     threshold: dynamicCompactThreshold,
                     targetSize: predictiveTargetSize,
@@ -721,7 +726,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             if (kernel) {
                 try {
                     const assembled = normalizeAssembleResult(await kernel.assembleContext({
-                        sessionId: args.sessionId,
+                        sessionId,
                         sessionKey: args.sessionKey,
                         userId,
                         queryText: args.prompt ?? "",
@@ -733,7 +738,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     return enforceTokenBudgetInvariant(await augmentWithExactRecall(assembled, {
                         queryText: args.prompt ?? messages[messages.length - 1]?.content ?? "",
                         userId,
-                        sessionId: args.sessionId,
+                        sessionId,
                         tokenBudget: args.tokenBudget,
                     }), args.tokenBudget);
                 }
@@ -745,7 +750,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             const rpc = await runtime.getRpc();
             try {
                 const resp = await rpc.call("assemble_context_internal", {
-                    sessionId: args.sessionId,
+                    sessionId,
                     sessionKey: args.sessionKey,
                     userId,
                     messages,
@@ -758,7 +763,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 return enforceTokenBudgetInvariant(await augmentWithExactRecall(assembled, {
                     queryText: args.prompt ?? messages[messages.length - 1]?.content ?? "",
                     userId,
-                    sessionId: args.sessionId,
+                    sessionId,
                     tokenBudget: args.tokenBudget,
                 }), args.tokenBudget);
             }
@@ -771,6 +776,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             return await runCompaction(args);
         },
         async afterTurn(args) {
+            const sessionId = requireSessionId(args.sessionId, "afterTurn");
             const userId = resolveUserId({
                 userIdOverride: args.userId,
                 sessionKey: args.sessionKey,
@@ -778,7 +784,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             const afterTurnMessages = selectAfterTurnMessages(args.messages, args.prePromptMessageCount, logger);
             const messages = normalizeKernelMessages(afterTurnMessages);
             const msgCount = messages.length;
-            logger.info?.(`LibraVDB afterTurn sessionId=${args.sessionId} userId=${userId} ` +
+            logger.info?.(`LibraVDB afterTurn sessionId=${sessionId} userId=${userId} ` +
                 `messageCount=${msgCount} totalMessages=${args.messages.length} ` +
                 `prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} ` +
                 `heartbeat=${args.isHeartbeat ?? false}`);
@@ -789,14 +795,14 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     : undefined);
                 if (kernel) {
                     const result = await kernel.afterTurn({
-                        sessionId: args.sessionId,
+                        sessionId,
                         sessionKey: args.sessionKey,
                         userId,
                         messages,
                         isHeartbeat: args.isHeartbeat,
                     });
                     await performAfterTurnPredictiveCompaction({
-                        sessionId: args.sessionId,
+                        sessionId,
                         tokenBudget: args.tokenBudget,
                         currentTokenCount,
                     });
@@ -804,21 +810,21 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 }
                 const rpc = await runtime.getRpc();
                 const result = await rpc.call("after_turn_kernel", {
-                    sessionId: args.sessionId,
+                    sessionId,
                     sessionKey: args.sessionKey,
                     userId,
                     messages,
                     isHeartbeat: args.isHeartbeat,
                 });
                 await performAfterTurnPredictiveCompaction({
-                    sessionId: args.sessionId,
+                    sessionId,
                     tokenBudget: args.tokenBudget,
                     currentTokenCount,
                 });
                 return result;
             }
             catch (error) {
-                logger.warn?.(`LibraVDB afterTurn failed sessionId=${args.sessionId}: ` +
+                logger.warn?.(`LibraVDB afterTurn failed sessionId=${sessionId}: ` +
                     `${error instanceof Error ? error.message : String(error)}`);
                 throw error;
             }

package/dist/index.js

@@ -9467,7 +9467,7 @@ var require_service_config = __commonJS({
     exports2.validateRetryThrottling = validateRetryThrottling;
     exports2.validateServiceConfig = validateServiceConfig;
     exports2.extractAndSelectServiceConfig = extractAndSelectServiceConfig;
-    var os3 = __require("os");
+    var os4 = __require("os");
     var constants_1 = require_constants();
     var DURATION_REGEX = /^\d+(\.\d{1,9})?s$/;
     var CLIENT_LANGUAGE_STRING = "node";
@@ -9766,7 +9766,7 @@ var require_service_config = __commonJS({
         if (Array.isArray(validatedConfig.clientHostname)) {
           let hostnameMatched = false;
           for (const hostname2 of validatedConfig.clientHostname) {
-            if (hostname2 === os3.hostname()) {
+            if (hostname2 === os4.hostname()) {
               hostnameMatched = true;
             }
           }
@@ -24066,7 +24066,7 @@ var require_subchannel_call = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.Http2SubchannelCall = void 0;
     var http2 = __require("http2");
-    var os3 = __require("os");
+    var os4 = __require("os");
     var constants_1 = require_constants();
     var metadata_1 = require_metadata();
     var stream_decoder_1 = require_stream_decoder();
@@ -24074,7 +24074,7 @@ var require_subchannel_call = __commonJS({
     var constants_2 = require_constants();
     var TRACER_NAME = "subchannel_call";
     function getSystemErrorName(errno) {
-      for (const [name, num] of Object.entries(os3.constants.errno)) {
+      for (const [name, num] of Object.entries(os4.constants.errno)) {
         if (num === errno) {
           return name;
         }
@@ -34223,12 +34223,13 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
     info: { id: "libravdb-memory", name: "LibraVDB Memory", ownsCompaction: true },
     ownsCompaction: true,
     async bootstrap(args) {
+      const sessionId = requireSessionId(args.sessionId, "bootstrap");
       const userId = resolveUserId({
         userIdOverride: args.userId,
         sessionKey: args.sessionKey
       });
       logger.info?.(
-        `LibraVDB bootstrap sessionId=${args.sessionId} userId=${userId} sessionKey=${args.sessionKey ?? "(none)"}`
+        `LibraVDB bootstrap sessionId=${sessionId} userId=${userId} sessionKey=${args.sessionKey ?? "(none)"}`
       );
       const kernel = await getKernelOrNull("bootstrap");
       if (kernel) {
@@ -34240,7 +34241,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         } catch (error) {
         }
         return await kernel.bootstrapSession({
-          sessionId: args.sessionId,
+          sessionId,
           sessionKey: args.sessionKey,
           userId
         });
@@ -34248,23 +34249,25 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       const rpc = await runtime.getRpc();
       return await rpc.call("bootstrap_session_kernel", {
         ...args,
+        sessionId,
         userId
       });
     },
     async ingest(args) {
+      const sessionId = requireSessionId(args.sessionId, "ingest");
       const userId = resolveUserId({
         userIdOverride: args.userId,
         sessionKey: args.sessionKey
       });
       const message = normalizeKernelMessage(args.message);
       logger.info?.(
-        `LibraVDB ingest sessionId=${args.sessionId} userId=${userId} role=${message.role} heartbeat=${args.isHeartbeat ?? false} contentLen=${message.content.length}`
+        `LibraVDB ingest sessionId=${sessionId} userId=${userId} role=${message.role} heartbeat=${args.isHeartbeat ?? false} contentLen=${message.content.length}`
       );
       try {
         const kernel = await getKernelOrNull("ingest");
         if (kernel) {
           return await kernel.ingestMessage({
-            sessionId: args.sessionId,
+            sessionId,
             sessionKey: args.sessionKey,
             userId,
             message,
@@ -34274,17 +34277,19 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         const rpc = await runtime.getRpc();
         return await rpc.call("ingest_message_kernel", {
           ...args,
+          sessionId,
           userId,
           message
         });
       } catch (error) {
         logger.warn?.(
-          `LibraVDB ingest failed sessionId=${args.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+          `LibraVDB ingest failed sessionId=${sessionId}: ${error instanceof Error ? error.message : String(error)}`
         );
         throw error;
       }
     },
     async assemble(args) {
+      const sessionId = requireSessionId(args.sessionId, "assemble");
       const userId = resolveUserId({
         userIdOverride: args.userId,
         sessionKey: args.sessionKey
@@ -34304,14 +34309,14 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         logPredictiveCompactionAttempt({
           logger,
           phase: "assemble",
-          sessionId: args.sessionId,
+          sessionId,
           currentTokenCount: currentContextTokens,
           threshold: dynamicCompactThreshold,
           targetSize: predictiveTargetSize,
           tokenBudget: args.tokenBudget
         });
         const compactionResult = await runCompaction({
-          sessionId: args.sessionId,
+          sessionId,
           targetSize: predictiveTargetSize,
           tokenBudget: args.tokenBudget,
           force: true,
@@ -34320,7 +34325,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         logPredictiveCompactionOutcome({
           logger,
           phase: "assemble",
-          sessionId: args.sessionId,
+          sessionId,
           currentTokenCount: currentContextTokens,
           threshold: dynamicCompactThreshold,
           targetSize: predictiveTargetSize,
@@ -34339,7 +34344,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       if (kernel) {
         try {
           const assembled = normalizeAssembleResult(await kernel.assembleContext({
-            sessionId: args.sessionId,
+            sessionId,
             sessionKey: args.sessionKey,
             userId,
             queryText: args.prompt ?? "",
@@ -34352,7 +34357,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
             await augmentWithExactRecall(assembled, {
               queryText: args.prompt ?? messages[messages.length - 1]?.content ?? "",
               userId,
-              sessionId: args.sessionId,
+              sessionId,
               tokenBudget: args.tokenBudget
             }),
             args.tokenBudget
@@ -34367,7 +34372,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       const rpc = await runtime.getRpc();
       try {
         const resp = await rpc.call("assemble_context_internal", {
-          sessionId: args.sessionId,
+          sessionId,
           sessionKey: args.sessionKey,
           userId,
           messages,
@@ -34381,7 +34386,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
           await augmentWithExactRecall(assembled, {
             queryText: args.prompt ?? messages[messages.length - 1]?.content ?? "",
             userId,
-            sessionId: args.sessionId,
+            sessionId,
             tokenBudget: args.tokenBudget
           }),
           args.tokenBudget
@@ -34397,6 +34402,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       return await runCompaction(args);
     },
     async afterTurn(args) {
+      const sessionId = requireSessionId(args.sessionId, "afterTurn");
       const userId = resolveUserId({
         userIdOverride: args.userId,
         sessionKey: args.sessionKey
@@ -34405,7 +34411,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       const messages = normalizeKernelMessages(afterTurnMessages);
       const msgCount = messages.length;
       logger.info?.(
-        `LibraVDB afterTurn sessionId=${args.sessionId} userId=${userId} messageCount=${msgCount} totalMessages=${args.messages.length} prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} heartbeat=${args.isHeartbeat ?? false}`
+        `LibraVDB afterTurn sessionId=${sessionId} userId=${userId} messageCount=${msgCount} totalMessages=${args.messages.length} prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} heartbeat=${args.isHeartbeat ?? false}`
       );
       try {
         const kernel = await getKernelOrNull("afterTurn");
@@ -34414,14 +34420,14 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         );
         if (kernel) {
           const result2 = await kernel.afterTurn({
-            sessionId: args.sessionId,
+            sessionId,
             sessionKey: args.sessionKey,
             userId,
             messages,
             isHeartbeat: args.isHeartbeat
           });
           await performAfterTurnPredictiveCompaction({
-            sessionId: args.sessionId,
+            sessionId,
             tokenBudget: args.tokenBudget,
             currentTokenCount
           });
@@ -34429,21 +34435,21 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         }
         const rpc = await runtime.getRpc();
         const result = await rpc.call("after_turn_kernel", {
-          sessionId: args.sessionId,
+          sessionId,
           sessionKey: args.sessionKey,
           userId,
           messages,
           isHeartbeat: args.isHeartbeat
         });
         await performAfterTurnPredictiveCompaction({
-          sessionId: args.sessionId,
+          sessionId,
           tokenBudget: args.tokenBudget,
           currentTokenCount
         });
         return result;
       } catch (error) {
         logger.warn?.(
-          `LibraVDB afterTurn failed sessionId=${args.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+          `LibraVDB afterTurn failed sessionId=${sessionId}: ${error instanceof Error ? error.message : String(error)}`
         );
         throw error;
       }
@@ -34517,6 +34523,7 @@ function isRecord(value) {
 // src/markdown-ingest.ts
 import fs2 from "node:fs";
 import fsp2 from "node:fs/promises";
+import os2 from "node:os";
 import path2 from "node:path";
 
 // node_modules/.pnpm/@bufbuild+protobuf@1.7.2/node_modules/@bufbuild/protobuf/dist/proxy/index.js
@@ -38478,7 +38485,8 @@ function createMarkdownIngestionHandle(cfg, getRpc, logger = console, fsApi = cr
           roots: genericRoots,
           include: cfg.markdownIngestionInclude,
           exclude: cfg.markdownIngestionExclude,
-          debounceMs: cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS2
+          debounceMs: cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS2,
+          snapshotPath: resolveMarkdownSnapshotPath("generic", cfg.markdownIngestionSnapshotPath)
         },
         getRpc,
         logger,
@@ -38487,7 +38495,7 @@ function createMarkdownIngestionHandle(cfg, getRpc, logger = console, fsApi = cr
     );
   }
   const obsidianRoots = normalizeMarkdownRoots(cfg.markdownIngestionObsidianRoots);
-  if (cfg.markdownIngestionObsidianEnabled !== false && obsidianRoots.length > 0) {
+  if (cfg.markdownIngestionObsidianEnabled === true && obsidianRoots.length > 0) {
     adapters.push(
       new DirectoryMarkdownSourceAdapter(
         "obsidian",
@@ -38495,7 +38503,8 @@ function createMarkdownIngestionHandle(cfg, getRpc, logger = console, fsApi = cr
           roots: obsidianRoots,
           include: cfg.markdownIngestionObsidianInclude,
           exclude: cfg.markdownIngestionObsidianExclude,
-          debounceMs: cfg.markdownIngestionObsidianDebounceMs ?? cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS2
+          debounceMs: cfg.markdownIngestionObsidianDebounceMs ?? cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS2,
+          snapshotPath: resolveMarkdownSnapshotPath("obsidian", cfg.markdownIngestionObsidianSnapshotPath)
         },
         getRpc,
         logger,
@@ -38551,6 +38560,7 @@ var DirectoryMarkdownSourceAdapter = class {
   fsApi;
   getRpc;
   logger;
+  snapshotPath;
   states = /* @__PURE__ */ new Map();
   fileStates = /* @__PURE__ */ new Map();
   activeScans = /* @__PURE__ */ new Set();
@@ -38559,6 +38569,8 @@ var DirectoryMarkdownSourceAdapter = class {
   started = false;
   ingestQueue = null;
   stopping = false;
+  snapshotLoaded = false;
+  snapshotDirty = false;
   constructor(kind, config, getRpc, logger, fsApi) {
     this.kind = kind;
     this.roots = config.roots;
@@ -38568,6 +38580,7 @@ var DirectoryMarkdownSourceAdapter = class {
     this.fsApi = fsApi;
     this.getRpc = getRpc;
     this.logger = logger;
+    this.snapshotPath = config.snapshotPath ?? resolveMarkdownSnapshotPath(kind);
     this.tokenizerId = DEFAULT_TOKENIZER_ID;
     this.coreDoc = true;
   }
@@ -38575,6 +38588,7 @@ var DirectoryMarkdownSourceAdapter = class {
     if (this.started) {
       return;
     }
+    await this.loadSnapshot();
     this.started = true;
     this.stopping = false;
     await this.refresh();
@@ -38602,8 +38616,10 @@ var DirectoryMarkdownSourceAdapter = class {
     if (this.activeScans.size > 0) {
       await Promise.allSettled([...this.activeScans]);
     }
+    await this.saveSnapshotIfDirty();
     this.states.clear();
     this.fileStates.clear();
+    this.snapshotLoaded = false;
     this.started = false;
   }
   getRootState(root) {
@@ -38619,7 +38635,7 @@ var DirectoryMarkdownSourceAdapter = class {
         dirty: false,
         timer: null
       },
-      knownFiles: /* @__PURE__ */ new Set(),
+      knownFiles: this.snapshotFilesForRoot(resolved),
       directoryWatchers: /* @__PURE__ */ new Map()
     };
     this.states.set(resolved, created);
@@ -38636,12 +38652,16 @@ var DirectoryMarkdownSourceAdapter = class {
     }
     rootState.scanState.scanning = true;
     const scan = (async () => {
+      const stats = createScanStats();
+      const startedAt = Date.now();
       try {
         const currentFiles = /* @__PURE__ */ new Set();
-        await this.walkDirectory(rootState, rootState.root, currentFiles);
+        await this.walkDirectory(rootState, rootState.root, currentFiles, stats);
         if (!this.stopping) {
-          await this.pruneDeletedFiles(rootState, currentFiles);
+          await this.pruneDeletedFiles(rootState, currentFiles, stats);
           rootState.knownFiles = currentFiles;
+          await this.saveSnapshotIfDirty();
+          this.logScanStats(rootState.root, stats, Date.now() - startedAt);
         }
       } finally {
         rootState.scanState.scanning = false;
@@ -38678,7 +38698,12 @@ var DirectoryMarkdownSourceAdapter = class {
       });
     }, this.debounceMs);
   }
-  async walkDirectory(rootState, dir, currentFiles) {
+  async walkDirectory(rootState, dir, currentFiles, stats) {
+    if (this.shouldPruneDirectory(rootState.root, dir)) {
+      stats.directoriesPruned++;
+      return;
+    }
+    stats.directoriesScanned++;
     await this.ensureDirectoryWatcher(rootState, dir);
     let entries;
     try {
@@ -38696,25 +38721,42 @@ var DirectoryMarkdownSourceAdapter = class {
       }
       const child = path2.join(dir, entry.name);
       if (entry.isDirectory()) {
-        await this.walkDirectory(rootState, child, currentFiles);
+        await this.walkDirectory(rootState, child, currentFiles, stats);
         continue;
       }
       if (!entry.isFile() || !isMarkdownFile(entry.name)) {
         continue;
       }
+      stats.markdownFilesSeen++;
       if (!this.shouldIncludeFile(rootState.root, child)) {
+        stats.filesSkipped++;
         continue;
       }
+      stats.filesIncluded++;
       currentFiles.add(child);
       try {
-        await this.syncMarkdownFile(rootState, child);
+        const result = await this.syncMarkdownFile(rootState, child);
+        recordSyncResult(stats, result);
       } catch (error) {
+        stats.syncErrors++;
         if (!this.stopping) {
           this.logger.warn?.(`[markdown-ingest] sync failed for ${child}: ${formatError(error)}`);
         }
       }
     }
   }
+  shouldPruneDirectory(root, dir) {
+    const relative = toPosixPath(path2.relative(root, dir));
+    if (!relative || relative === "." || relative.startsWith("..")) {
+      return false;
+    }
+    for (const pattern of this.excludePatterns) {
+      if (matchesExcludedDirectory(relative, pattern)) {
+        return true;
+      }
+    }
+    return false;
+  }
   async ensureDirectoryWatcher(rootState, dir) {
     if (rootState.directoryWatchers.has(dir)) {
       return;
@@ -38755,7 +38797,7 @@ var DirectoryMarkdownSourceAdapter = class {
     }
     return true;
   }
-  async pruneDeletedFiles(rootState, currentFiles) {
+  async pruneDeletedFiles(rootState, currentFiles, stats) {
     const removed = [];
     for (const previous of rootState.knownFiles) {
       if (!currentFiles.has(previous)) {
@@ -38768,6 +38810,8 @@ var DirectoryMarkdownSourceAdapter = class {
     for (const filePath of removed) {
       await this.deleteSourceDocument(filePath);
       this.fileStates.delete(filePath);
+      this.snapshotDirty = true;
+      stats.filesDeleted++;
     }
   }
   async syncMarkdownFile(rootState, filePath) {
@@ -38777,21 +38821,23 @@ var DirectoryMarkdownSourceAdapter = class {
     if (!stat) {
       await this.deleteSourceDocument(sourceDoc);
       this.fileStates.delete(sourceDoc);
-      return;
+      this.snapshotDirty = true;
+      return "deleted";
     }
     const cached = this.fileStates.get(sourceDoc);
     if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) {
-      return;
+      return "unchanged";
     }
     const bytes = await this.safeReadFile(filePath);
     if (!bytes) {
       await this.deleteSourceDocument(sourceDoc);
       this.fileStates.delete(sourceDoc);
-      return;
+      this.snapshotDirty = true;
+      return "deleted";
     }
     const fileHash = hashBytes(bytes);
     if (cached && cached.fileHash === fileHash) {
-      this.fileStates.set(sourceDoc, {
+      this.setFileState(sourceDoc, {
         root: rootState.root,
         sourceDoc,
         relativePath,
@@ -38799,16 +38845,17 @@ var DirectoryMarkdownSourceAdapter = class {
         size: stat.size,
         mtimeMs: stat.mtimeMs
       });
-      return;
+      return "unchanged";
     }
     const text = textDecoder2.decode(bytes);
     if (this.kind === "obsidian" && this.includePatterns.length === 0 && !looksLikeObsidianNote(filePath, text)) {
       await this.deleteSourceDocument(sourceDoc);
       this.fileStates.delete(sourceDoc);
-      return;
+      this.snapshotDirty = true;
+      return "skipped";
     }
     await this.ingestMarkdownDocument(sourceDoc, text, rootState.root, relativePath, fileHash, stat.size, stat.mtimeMs);
-    this.fileStates.set(sourceDoc, {
+    this.setFileState(sourceDoc, {
       root: rootState.root,
       sourceDoc,
       relativePath,
@@ -38816,6 +38863,11 @@ var DirectoryMarkdownSourceAdapter = class {
       size: stat.size,
       mtimeMs: stat.mtimeMs
     });
+    return "ingested";
+  }
+  setFileState(sourceDoc, state) {
+    this.fileStates.set(sourceDoc, state);
+    this.snapshotDirty = true;
   }
   async ingestMarkdownDocument(sourceDoc, text, sourceRoot, sourcePath, fileHash, sourceSize, sourceMtimeMs) {
     const queue = await this.getIngestQueue();
@@ -38863,7 +38915,96 @@ var DirectoryMarkdownSourceAdapter = class {
       return null;
     }
   }
+  snapshotFilesForRoot(root) {
+    const files = /* @__PURE__ */ new Set();
+    for (const state of this.fileStates.values()) {
+      if (state.root === root) {
+        files.add(state.sourceDoc);
+      }
+    }
+    return files;
+  }
+  async loadSnapshot() {
+    if (this.snapshotLoaded) {
+      return;
+    }
+    this.snapshotLoaded = true;
+    let raw;
+    try {
+      raw = await fsp2.readFile(this.snapshotPath, "utf8");
+    } catch (error) {
+      if (!formatError(error).includes("ENOENT")) {
+        this.logger.warn?.(`[markdown-ingest] failed to read snapshot ${this.snapshotPath}: ${formatError(error)}`);
+      }
+      return;
+    }
+    try {
+      const parsed = JSON.parse(raw);
+      if (parsed.ingestVersion !== MARKDOWN_INGEST_VERSION || parsed.hashBackend !== HASH_BACKEND || !parsed.files) {
+        return;
+      }
+      const configuredRoots = new Set(this.roots.map((root) => path2.resolve(root)));
+      for (const [sourceDoc, state] of Object.entries(parsed.files)) {
+        if (isValidSnapshotState(sourceDoc, state) && configuredRoots.has(path2.resolve(state.root))) {
+          this.fileStates.set(sourceDoc, state);
+        }
+      }
+      this.logger.info?.(`[markdown-ingest] loaded ${this.fileStates.size} ${this.kind} file snapshots from ${this.snapshotPath}`);
+    } catch (error) {
+      this.logger.warn?.(`[markdown-ingest] failed to parse snapshot ${this.snapshotPath}: ${formatError(error)}`);
+    }
+  }
+  async saveSnapshotIfDirty() {
+    if (!this.snapshotDirty) {
+      return;
+    }
+    const payload = {
+      version: 1,
+      ingestVersion: MARKDOWN_INGEST_VERSION,
+      hashBackend: HASH_BACKEND,
+      files: Object.fromEntries([...this.fileStates.entries()].sort(([left], [right]) => left.localeCompare(right)))
+    };
+    try {
+      await fsp2.mkdir(path2.dirname(this.snapshotPath), { recursive: true });
+      const tmp = `${this.snapshotPath}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
+      await fsp2.writeFile(tmp, `${JSON.stringify(payload, null, 2)}
+`);
+      await fsp2.rename(tmp, this.snapshotPath);
+      this.snapshotDirty = false;
+    } catch (error) {
+      this.logger.warn?.(`[markdown-ingest] failed to write snapshot ${this.snapshotPath}: ${formatError(error)}`);
+    }
+  }
+  logScanStats(root, stats, durationMs) {
+    this.logger.info?.(
+      `[markdown-ingest] ${this.kind} scan complete root=${root} dirs=${stats.directoriesScanned} prunedDirs=${stats.directoriesPruned} markdown=${stats.markdownFilesSeen} included=${stats.filesIncluded} skipped=${stats.filesSkipped} unchanged=${stats.filesUnchanged} ingested=${stats.filesIngested} deleted=${stats.filesDeleted} errors=${stats.syncErrors} durationMs=${durationMs}`
+    );
+  }
 };
+function createScanStats() {
+  return {
+    directoriesScanned: 0,
+    directoriesPruned: 0,
+    markdownFilesSeen: 0,
+    filesIncluded: 0,
+    filesSkipped: 0,
+    filesUnchanged: 0,
+    filesIngested: 0,
+    filesDeleted: 0,
+    syncErrors: 0
+  };
+}
+function recordSyncResult(stats, result) {
+  if (result === "ingested") {
+    stats.filesIngested++;
+  } else if (result === "unchanged") {
+    stats.filesUnchanged++;
+  } else if (result === "deleted") {
+    stats.filesDeleted++;
+  } else {
+    stats.filesSkipped++;
+  }
+}
 function toPosixPath(value) {
   return value.split(path2.sep).join("/");
 }
@@ -38882,11 +39023,16 @@ function normalizeMarkdownRoots(roots) {
   }
   return [...resolved];
 }
-function isMarkdownIngestionEnabled(cfg, roots) {
-  if (cfg.markdownIngestionEnabled === false) {
-    return false;
+function resolveMarkdownSnapshotPath(kind, configuredPath) {
+  const trimmed = configuredPath?.trim();
+  if (trimmed) {
+    return path2.resolve(trimmed);
   }
-  return roots.length > 0;
+  const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || path2.join(os2.homedir(), ".openclaw");
+  return path2.join(stateDir, `libravdb-markdown-ingest-${kind}.json`);
+}
+function isMarkdownIngestionEnabled(cfg, roots) {
+  return cfg.markdownIngestionEnabled === true && roots.length > 0;
 }
 function createRealFsApi2() {
   return {
@@ -38907,6 +39053,17 @@ function matchesGlob(value, pattern) {
   const escaped = pattern.split("*").map((part) => part.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join(".*");
   return new RegExp(`^${escaped}$`).test(value);
 }
+function matchesExcludedDirectory(relativeDir, pattern) {
+  const normalized = relativeDir.replace(/\/+$/, "");
+  return matchesGlob(normalized, pattern) || matchesGlob(`${normalized}/`, pattern) || matchesGlob(`${normalized}/.probe`, pattern);
+}
+function isValidSnapshotState(sourceDoc, value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const state = value;
+  return state.sourceDoc === sourceDoc && typeof state.root === "string" && typeof state.relativePath === "string" && typeof state.fileHash === "string" && typeof state.size === "number" && Number.isFinite(state.size) && typeof state.mtimeMs === "number" && Number.isFinite(state.mtimeMs);
+}
 function looksLikeObsidianNote(filePath, text) {
   const frontmatterStart = parseFrontmatterStart(text);
   if (frontmatterStart == null) {
@@ -39433,7 +39590,7 @@ var GrpcKernelClient = class {
 // src/sidecar.ts
 import fs3 from "node:fs";
 import net from "node:net";
-import os2 from "node:os";
+import os3 from "node:os";
 import path4 from "node:path";
 var STARTUP_CONNECT_MAX_RETRIES = 5;
 var STARTUP_CONNECT_BASE_DELAY_MS = 100;
@@ -39704,7 +39861,7 @@ function resolveConfiguredEndpoint(cfg) {
 function daemonProvisioningHint() {
   return "If you installed the npm package, install and start libravdbd separately; the package does not provision the daemon binary, ONNX Runtime, or model assets.";
 }
-function defaultEndpoint(platform = process.platform, homeDir = os2.homedir(), pathExists = fs3.existsSync) {
+function defaultEndpoint(platform = process.platform, homeDir = os3.homedir(), pathExists = fs3.existsSync) {
   const envEndpoint = normalizeConfiguredEndpoint(process.env.LIBRAVDB_RPC_ENDPOINT);
   if (envEndpoint) {
     return envEndpoint;

package/dist/markdown-ingest.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import fsp from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 import { hashBytes } from "./markdown-hash.js";
 import { formatError } from "./format-error.js";
@@ -17,15 +18,17 @@ export function createMarkdownIngestionHandle(cfg, getRpc, logger = console, fsA
             include: cfg.markdownIngestionInclude,
             exclude: cfg.markdownIngestionExclude,
             debounceMs: cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS,
+            snapshotPath: resolveMarkdownSnapshotPath("generic", cfg.markdownIngestionSnapshotPath),
         }, getRpc, logger, fsApi));
     }
     const obsidianRoots = normalizeMarkdownRoots(cfg.markdownIngestionObsidianRoots);
-    if (cfg.markdownIngestionObsidianEnabled !== false && obsidianRoots.length > 0) {
+    if (cfg.markdownIngestionObsidianEnabled === true && obsidianRoots.length > 0) {
         adapters.push(new DirectoryMarkdownSourceAdapter("obsidian", {
             roots: obsidianRoots,
             include: cfg.markdownIngestionObsidianInclude,
             exclude: cfg.markdownIngestionObsidianExclude,
             debounceMs: cfg.markdownIngestionObsidianDebounceMs ?? cfg.markdownIngestionDebounceMs ?? DEFAULT_DEBOUNCE_MS,
+            snapshotPath: resolveMarkdownSnapshotPath("obsidian", cfg.markdownIngestionObsidianSnapshotPath),
         }, getRpc, logger, fsApi));
     }
     if (adapters.length === 0) {
@@ -73,6 +76,7 @@ class DirectoryMarkdownSourceAdapter {
     fsApi;
     getRpc;
     logger;
+    snapshotPath;
     states = new Map();
     fileStates = new Map();
     activeScans = new Set();
@@ -81,6 +85,8 @@ class DirectoryMarkdownSourceAdapter {
     started = false;
     ingestQueue = null;
     stopping = false;
+    snapshotLoaded = false;
+    snapshotDirty = false;
     constructor(kind, config, getRpc, logger, fsApi) {
         this.kind = kind;
         this.roots = config.roots;
@@ -90,6 +96,7 @@ class DirectoryMarkdownSourceAdapter {
         this.fsApi = fsApi;
         this.getRpc = getRpc;
         this.logger = logger;
+        this.snapshotPath = config.snapshotPath ?? resolveMarkdownSnapshotPath(kind);
         this.tokenizerId = DEFAULT_TOKENIZER_ID;
         this.coreDoc = true;
     }
@@ -97,6 +104,7 @@ class DirectoryMarkdownSourceAdapter {
         if (this.started) {
             return;
         }
+        await this.loadSnapshot();
         this.started = true;
         this.stopping = false;
         await this.refresh();
@@ -124,8 +132,10 @@ class DirectoryMarkdownSourceAdapter {
         if (this.activeScans.size > 0) {
             await Promise.allSettled([...this.activeScans]);
         }
+        await this.saveSnapshotIfDirty();
         this.states.clear();
         this.fileStates.clear();
+        this.snapshotLoaded = false;
         this.started = false;
     }
     getRootState(root) {
@@ -141,7 +151,7 @@ class DirectoryMarkdownSourceAdapter {
                 dirty: false,
                 timer: null,
             },
-            knownFiles: new Set(),
+            knownFiles: this.snapshotFilesForRoot(resolved),
             directoryWatchers: new Map(),
         };
         this.states.set(resolved, created);
@@ -158,12 +168,16 @@ class DirectoryMarkdownSourceAdapter {
         }
         rootState.scanState.scanning = true;
         const scan = (async () => {
+            const stats = createScanStats();
+            const startedAt = Date.now();
             try {
                 const currentFiles = new Set();
-                await this.walkDirectory(rootState, rootState.root, currentFiles);
+                await this.walkDirectory(rootState, rootState.root, currentFiles, stats);
                 if (!this.stopping) {
-                    await this.pruneDeletedFiles(rootState, currentFiles);
+                    await this.pruneDeletedFiles(rootState, currentFiles, stats);
                     rootState.knownFiles = currentFiles;
+                    await this.saveSnapshotIfDirty();
+                    this.logScanStats(rootState.root, stats, Date.now() - startedAt);
                 }
             }
             finally {
@@ -202,7 +216,12 @@ class DirectoryMarkdownSourceAdapter {
             });
         }, this.debounceMs);
     }
-    async walkDirectory(rootState, dir, currentFiles) {
+    async walkDirectory(rootState, dir, currentFiles, stats) {
+        if (this.shouldPruneDirectory(rootState.root, dir)) {
+            stats.directoriesPruned++;
+            return;
+        }
+        stats.directoriesScanned++;
         await this.ensureDirectoryWatcher(rootState, dir);
         let entries;
         try {
@@ -221,26 +240,43 @@ class DirectoryMarkdownSourceAdapter {
             }
             const child = path.join(dir, entry.name);
             if (entry.isDirectory()) {
-                await this.walkDirectory(rootState, child, currentFiles);
+                await this.walkDirectory(rootState, child, currentFiles, stats);
                 continue;
             }
             if (!entry.isFile() || !isMarkdownFile(entry.name)) {
                 continue;
             }
+            stats.markdownFilesSeen++;
             if (!this.shouldIncludeFile(rootState.root, child)) {
+                stats.filesSkipped++;
                 continue;
             }
+            stats.filesIncluded++;
             currentFiles.add(child);
             try {
-                await this.syncMarkdownFile(rootState, child);
+                const result = await this.syncMarkdownFile(rootState, child);
+                recordSyncResult(stats, result);
             }
             catch (error) {
+                stats.syncErrors++;
                 if (!this.stopping) {
                     this.logger.warn?.(`[markdown-ingest] sync failed for ${child}: ${formatError(error)}`);
                 }
             }
         }
     }
+    shouldPruneDirectory(root, dir) {
+        const relative = toPosixPath(path.relative(root, dir));
+        if (!relative || relative === "." || relative.startsWith("..")) {
+            return false;
+        }
+        for (const pattern of this.excludePatterns) {
+            if (matchesExcludedDirectory(relative, pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
     async ensureDirectoryWatcher(rootState, dir) {
         if (rootState.directoryWatchers.has(dir)) {
             return;
@@ -282,7 +318,7 @@ class DirectoryMarkdownSourceAdapter {
         }
         return true;
     }
-    async pruneDeletedFiles(rootState, currentFiles) {
+    async pruneDeletedFiles(rootState, currentFiles, stats) {
         const removed = [];
         for (const previous of rootState.knownFiles) {
             if (!currentFiles.has(previous)) {
@@ -295,6 +331,8 @@ class DirectoryMarkdownSourceAdapter {
         for (const filePath of removed) {
             await this.deleteSourceDocument(filePath);
             this.fileStates.delete(filePath);
+            this.snapshotDirty = true;
+            stats.filesDeleted++;
         }
     }
     async syncMarkdownFile(rootState, filePath) {
@@ -304,21 +342,23 @@ class DirectoryMarkdownSourceAdapter {
         if (!stat) {
             await this.deleteSourceDocument(sourceDoc);
             this.fileStates.delete(sourceDoc);
-            return;
+            this.snapshotDirty = true;
+            return "deleted";
         }
         const cached = this.fileStates.get(sourceDoc);
         if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) {
-            return;
+            return "unchanged";
         }
         const bytes = await this.safeReadFile(filePath);
         if (!bytes) {
             await this.deleteSourceDocument(sourceDoc);
             this.fileStates.delete(sourceDoc);
-            return;
+            this.snapshotDirty = true;
+            return "deleted";
         }
         const fileHash = hashBytes(bytes);
         if (cached && cached.fileHash === fileHash) {
-            this.fileStates.set(sourceDoc, {
+            this.setFileState(sourceDoc, {
                 root: rootState.root,
                 sourceDoc,
                 relativePath,
@@ -326,16 +366,17 @@ class DirectoryMarkdownSourceAdapter {
                 size: stat.size,
                 mtimeMs: stat.mtimeMs,
             });
-            return;
+            return "unchanged";
         }
         const text = textDecoder.decode(bytes);
         if (this.kind === "obsidian" && this.includePatterns.length === 0 && !looksLikeObsidianNote(filePath, text)) {
             await this.deleteSourceDocument(sourceDoc);
             this.fileStates.delete(sourceDoc);
-            return;
+            this.snapshotDirty = true;
+            return "skipped";
         }
         await this.ingestMarkdownDocument(sourceDoc, text, rootState.root, relativePath, fileHash, stat.size, stat.mtimeMs);
-        this.fileStates.set(sourceDoc, {
+        this.setFileState(sourceDoc, {
             root: rootState.root,
             sourceDoc,
             relativePath,
@@ -343,6 +384,11 @@ class DirectoryMarkdownSourceAdapter {
             size: stat.size,
             mtimeMs: stat.mtimeMs,
         });
+        return "ingested";
+    }
+    setFileState(sourceDoc, state) {
+        this.fileStates.set(sourceDoc, state);
+        this.snapshotDirty = true;
     }
     async ingestMarkdownDocument(sourceDoc, text, sourceRoot, sourcePath, fileHash, sourceSize, sourceMtimeMs) {
         const queue = await this.getIngestQueue();
@@ -388,6 +434,98 @@ class DirectoryMarkdownSourceAdapter {
             return null;
         }
     }
+    snapshotFilesForRoot(root) {
+        const files = new Set();
+        for (const state of this.fileStates.values()) {
+            if (state.root === root) {
+                files.add(state.sourceDoc);
+            }
+        }
+        return files;
+    }
+    async loadSnapshot() {
+        if (this.snapshotLoaded) {
+            return;
+        }
+        this.snapshotLoaded = true;
+        let raw;
+        try {
+            raw = await fsp.readFile(this.snapshotPath, "utf8");
+        }
+        catch (error) {
+            if (!formatError(error).includes("ENOENT")) {
+                this.logger.warn?.(`[markdown-ingest] failed to read snapshot ${this.snapshotPath}: ${formatError(error)}`);
+            }
+            return;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed.ingestVersion !== MARKDOWN_INGEST_VERSION || parsed.hashBackend !== HASH_BACKEND || !parsed.files) {
+                return;
+            }
+            const configuredRoots = new Set(this.roots.map((root) => path.resolve(root)));
+            for (const [sourceDoc, state] of Object.entries(parsed.files)) {
+                if (isValidSnapshotState(sourceDoc, state) && configuredRoots.has(path.resolve(state.root))) {
+                    this.fileStates.set(sourceDoc, state);
+                }
+            }
+            this.logger.info?.(`[markdown-ingest] loaded ${this.fileStates.size} ${this.kind} file snapshots from ${this.snapshotPath}`);
+        }
+        catch (error) {
+            this.logger.warn?.(`[markdown-ingest] failed to parse snapshot ${this.snapshotPath}: ${formatError(error)}`);
+        }
+    }
+    async saveSnapshotIfDirty() {
+        if (!this.snapshotDirty) {
+            return;
+        }
+        const payload = {
+            version: 1,
+            ingestVersion: MARKDOWN_INGEST_VERSION,
+            hashBackend: HASH_BACKEND,
+            files: Object.fromEntries([...this.fileStates.entries()].sort(([left], [right]) => left.localeCompare(right))),
+        };
+        try {
+            await fsp.mkdir(path.dirname(this.snapshotPath), { recursive: true });
+            const tmp = `${this.snapshotPath}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
+            await fsp.writeFile(tmp, `${JSON.stringify(payload, null, 2)}\n`);
+            await fsp.rename(tmp, this.snapshotPath);
+            this.snapshotDirty = false;
+        }
+        catch (error) {
+            this.logger.warn?.(`[markdown-ingest] failed to write snapshot ${this.snapshotPath}: ${formatError(error)}`);
+        }
+    }
+    logScanStats(root, stats, durationMs) {
+        this.logger.info?.(`[markdown-ingest] ${this.kind} scan complete root=${root} dirs=${stats.directoriesScanned} prunedDirs=${stats.directoriesPruned} markdown=${stats.markdownFilesSeen} included=${stats.filesIncluded} skipped=${stats.filesSkipped} unchanged=${stats.filesUnchanged} ingested=${stats.filesIngested} deleted=${stats.filesDeleted} errors=${stats.syncErrors} durationMs=${durationMs}`);
+    }
+}
+function createScanStats() {
+    return {
+        directoriesScanned: 0,
+        directoriesPruned: 0,
+        markdownFilesSeen: 0,
+        filesIncluded: 0,
+        filesSkipped: 0,
+        filesUnchanged: 0,
+        filesIngested: 0,
+        filesDeleted: 0,
+        syncErrors: 0,
+    };
+}
+function recordSyncResult(stats, result) {
+    if (result === "ingested") {
+        stats.filesIngested++;
+    }
+    else if (result === "unchanged") {
+        stats.filesUnchanged++;
+    }
+    else if (result === "deleted") {
+        stats.filesDeleted++;
+    }
+    else {
+        stats.filesSkipped++;
+    }
 }
 function toPosixPath(value) {
     return value.split(path.sep).join("/");
@@ -407,11 +545,16 @@ function normalizeMarkdownRoots(roots) {
     }
     return [...resolved];
 }
-function isMarkdownIngestionEnabled(cfg, roots) {
-    if (cfg.markdownIngestionEnabled === false) {
-        return false;
+function resolveMarkdownSnapshotPath(kind, configuredPath) {
+    const trimmed = configuredPath?.trim();
+    if (trimmed) {
+        return path.resolve(trimmed);
     }
-    return roots.length > 0;
+    const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || path.join(os.homedir(), ".openclaw");
+    return path.join(stateDir, `libravdb-markdown-ingest-${kind}.json`);
+}
+function isMarkdownIngestionEnabled(cfg, roots) {
+    return cfg.markdownIngestionEnabled === true && roots.length > 0;
 }
 function createRealFsApi() {
     return {
@@ -435,6 +578,24 @@ function matchesGlob(value, pattern) {
         .join(".*");
     return new RegExp(`^${escaped}$`).test(value);
 }
+function matchesExcludedDirectory(relativeDir, pattern) {
+    const normalized = relativeDir.replace(/\/+$/, "");
+    return matchesGlob(normalized, pattern) || matchesGlob(`${normalized}/`, pattern) || matchesGlob(`${normalized}/.probe`, pattern);
+}
+function isValidSnapshotState(sourceDoc, value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const state = value;
+    return (state.sourceDoc === sourceDoc &&
+        typeof state.root === "string" &&
+        typeof state.relativePath === "string" &&
+        typeof state.fileHash === "string" &&
+        typeof state.size === "number" &&
+        Number.isFinite(state.size) &&
+        typeof state.mtimeMs === "number" &&
+        Number.isFinite(state.mtimeMs));
+}
 function looksLikeObsidianNote(filePath, text) {
     const frontmatterStart = parseFrontmatterStart(text);
     if (frontmatterStart == null) {

package/dist/types.d.ts

@@ -48,6 +48,8 @@ export interface PluginConfig {
     markdownIngestionInclude?: string[];
     markdownIngestionExclude?: string[];
     markdownIngestionDebounceMs?: number;
+    markdownIngestionSnapshotPath?: string;
+    markdownIngestionObsidianSnapshotPath?: string;
     dreamPromotionEnabled?: boolean;
     dreamPromotionDiaryPath?: string;
     dreamPromotionUserId?: string;

package/docs/configuration.md

@@ -98,6 +98,10 @@ The plugin exposes `ingestionGateThreshold` for host-side gating decisions:
 | `markdownIngestionObsidianExclude` | string[] | — | Obsidian glob exclude patterns |
 | `markdownIngestionObsidianDebounceMs` | number | `150` | Obsidian debounce window |
 
+Configured markdown roots are ignored unless the matching enable flag is set to
+`true`. Set `markdownIngestionEnabled: true` for generic roots and
+`markdownIngestionObsidianEnabled: true` for Obsidian vault roots.
+
 ## Dream promotion
 
 | Key | Type | Default | Notes |

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
   "description": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.4.66",
+  "version": "1.4.68",
   "kind": [
     "memory",
     "context-engine"
@@ -206,6 +206,12 @@
         "type": "number",
         "default": 150
       },
+      "markdownIngestionSnapshotPath": {
+        "type": "string"
+      },
+      "markdownIngestionObsidianSnapshotPath": {
+        "type": "string"
+      },
       "dreamPromotionEnabled": {
         "type": "boolean",
         "default": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.4.66",
+  "version": "1.4.68",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",