@joshuaswarren/openclaw-engram 8.3.47 → 8.3.48

package/dist/index.js

@@ -9893,19 +9893,19 @@ var TmtBuilder = class {
    * then rolls up to day → week → persona if needed.
    * All errors are caught and logged; never throws.
    */
-  async maybeRebuildNodes(memories, summarize) {
+  async maybeRebuildNodes(memories, summarize2) {
     if (!this.cfg.temporalMemoryTreeEnabled || memories.length === 0) return;
     try {
       await mkdir12(tmtDir(this.baseDir), { recursive: true });
-      await this.buildHourNodes(memories, summarize);
-      await this.buildDayNodes(memories, summarize);
-      await this.buildWeekNodes(memories, summarize);
-      await this.buildPersonaNode(summarize);
+      await this.buildHourNodes(memories, summarize2);
+      await this.buildDayNodes(memories, summarize2);
+      await this.buildWeekNodes(memories, summarize2);
+      await this.buildPersonaNode(summarize2);
     } catch (err) {
       console.warn(`[engram] tmt: rebuild failed (ignored): ${err}`);
     }
   }
-  async buildHourNodes(memories, summarize) {
+  async buildHourNodes(memories, summarize2) {
     const byHour = /* @__PURE__ */ new Map();
     for (const m of memories) {
       const date = parseIsoDate(m.created);
@@ -9933,7 +9933,7 @@ var TmtBuilder = class {
       if (!shouldBuild) continue;
       let summary;
       try {
-        summary = await summarize(capTmtSummaryInputs(entries.map((e) => e.content), "hour"), "hour");
+        summary = await summarize2(capTmtSummaryInputs(entries.map((e) => e.content), "hour"), "hour");
       } catch (err) {
         console.warn(`[engram] tmt: hour node summarize failed for ${key} (ignored): ${err}`);
         continue;
@@ -9951,7 +9951,7 @@ var TmtBuilder = class {
       await writeFile12(nodePath, serialiseTmtNode(fm, summary), "utf8");
     }
   }
-  async buildDayNodes(memories, summarize) {
+  async buildDayNodes(memories, summarize2) {
     const byDate = /* @__PURE__ */ new Map();
     for (const m of memories) {
       const date = parseIsoDate(m.created);
@@ -9998,7 +9998,7 @@ var TmtBuilder = class {
       if (inputs.length === 0) inputs.push(...entries.map((e) => e.content));
       let summary;
       try {
-        summary = await summarize(capTmtSummaryInputs(inputs, "day"), "day");
+        summary = await summarize2(capTmtSummaryInputs(inputs, "day"), "day");
       } catch (err) {
         console.warn(`[engram] tmt: day node summarize failed for ${date} (ignored): ${err}`);
         continue;
@@ -10022,7 +10022,7 @@ var TmtBuilder = class {
    * (or stale) week node, reads day node summaries and builds a week node.
    * Fail-open: errors per week are caught and skipped.
    */
-  async buildWeekNodes(memories, summarize) {
+  async buildWeekNodes(memories, summarize2) {
     const weekToEntries = /* @__PURE__ */ new Map();
     for (const m of memories) {
       const week = isoWeekKey(new Date(m.created));
@@ -10068,7 +10068,7 @@ var TmtBuilder = class {
           }
         }
         const inputs = daySummaries.length > 0 ? daySummaries : entries.map((e) => e.content);
-        const summary = await summarize(capTmtSummaryInputs(inputs, "week"), "week");
+        const summary = await summarize2(capTmtSummaryInputs(inputs, "week"), "week");
         const sortedCreated = entries.map((e) => e.created).sort();
         const fm = {
           level: "week",
@@ -10090,7 +10090,7 @@ var TmtBuilder = class {
    * Reads up to 4 recent week nodes and synthesizes a persona-level narrative.
    * Fail-open: skips silently if no week nodes exist or summarize fails.
    */
-  async buildPersonaNode(summarize) {
+  async buildPersonaNode(summarize2) {
     try {
       const dir = tmtDir(this.baseDir);
       let allFiles = [];
@@ -10138,7 +10138,7 @@ var TmtBuilder = class {
         }
       }
       if (!shouldBuild) return;
-      const summary = await summarize(capTmtSummaryInputs(weekSummaries, "persona"), "persona");
+      const summary = await summarize2(capTmtSummaryInputs(weekSummaries, "persona"), "persona");
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const fm = {
         level: "persona",
@@ -10255,12 +10255,12 @@ function computeHeat(memory, now, signals) {
   if (frontmatter.status === "archived") return 0;
   const nowMs = now.getTime();
   const confidence = confidenceTierWeight(frontmatter);
-  const access3 = accessWeight(frontmatter.accessCount);
+  const access4 = accessWeight(frontmatter.accessCount);
   const recency = recencyWeight(frontmatter, nowMs);
   const importance = clamp01(frontmatter.importance?.score ?? 0.5);
   const feedback = feedbackWeight(signals);
   const disputedPenalty = frontmatter.verificationState === "disputed" ? 0.2 : 0;
-  const score = confidence * 0.25 + access3 * 0.3 + recency * 0.2 + importance * 0.15 + feedback * 0.1 - disputedPenalty;
+  const score = confidence * 0.25 + access4 * 0.3 + recency * 0.2 + importance * 0.15 + feedback * 0.1 - disputedPenalty;
   return clamp01(score);
 }
 function computeDecay(memory, now, signals) {
@@ -17772,8 +17772,8 @@ mistakes: ${res.mistakesCount} patterns`
 }
 
 // src/cli.ts
-import path41 from "path";
-import { access as access2, readFile as readFile29, readdir as readdir18, unlink as unlink5 } from "fs/promises";
+import path42 from "path";
+import { access as access3, readFile as readFile30, readdir as readdir18, unlink as unlink5 } from "fs/promises";
 
 // src/transfer/export-json.ts
 import path28 from "path";
@@ -18652,8 +18652,8 @@ function gatherCandidates(input, warnings) {
       const record = rec;
       const content = typeof record.content === "string" ? record.content : null;
       if (!content) continue;
-      const path43 = typeof record.path === "string" ? record.path : "";
-      if (!path43.startsWith("transcripts/") && !path43.includes("/transcripts/")) continue;
+      const path44 = typeof record.path === "string" ? record.path : "";
+      if (!path44.startsWith("transcripts/") && !path44.includes("/transcripts/")) continue;
       rows.push(...parseJsonl(content, warnings));
     }
     return rows;
@@ -19537,6 +19537,377 @@ function toEncodedHref(pathname) {
   return pathname.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 }
 
+// src/compat/checks.ts
+import { access as access2, readFile as readFile29 } from "fs/promises";
+import path41 from "path";
+import { spawn as spawn3 } from "child_process";
+var REQUIRED_HOOKS = ["before_agent_start", "agent_end"];
+function isSafeCommandToken(command) {
+  return /^[a-zA-Z0-9._-]+$/.test(command);
+}
+var defaultRunner = {
+  async commandExists(command) {
+    if (!isSafeCommandToken(command)) return false;
+    const binary = process.platform === "win32" ? "where" : "which";
+    const args = [command];
+    return new Promise((resolve) => {
+      const child = spawn3(binary, args, { stdio: "ignore" });
+      child.on("error", () => resolve(false));
+      child.on("close", (code) => resolve(code === 0));
+    });
+  }
+};
+function summarize(checks) {
+  const out = { ok: 0, warn: 0, error: 0 };
+  for (const check of checks) {
+    out[check.level] += 1;
+  }
+  return out;
+}
+function stripCommentsAndStrings(source) {
+  const out = [];
+  let i = 0;
+  while (i < source.length) {
+    const ch = source[i];
+    const next = source[i + 1];
+    if (ch === "/" && next === "/") {
+      out.push(" ", " ");
+      i += 2;
+      while (i < source.length && source[i] !== "\n") {
+        out.push(" ");
+        i += 1;
+      }
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      out.push(" ", " ");
+      i += 2;
+      while (i < source.length) {
+        const c = source[i];
+        const n = source[i + 1];
+        out.push(c === "\n" ? "\n" : " ");
+        i += 1;
+        if (c === "*" && n === "/") {
+          out.push(" ");
+          i += 1;
+          break;
+        }
+      }
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      const quote = ch;
+      out.push(" ");
+      i += 1;
+      while (i < source.length) {
+        const c = source[i];
+        if (c === "\\") {
+          out.push(" ");
+          i += 1;
+          if (i < source.length) {
+            out.push(source[i] === "\n" ? "\n" : " ");
+            i += 1;
+          }
+          continue;
+        }
+        out.push(c === "\n" ? "\n" : " ");
+        i += 1;
+        if (c === quote) break;
+      }
+      continue;
+    }
+    out.push(ch);
+    i += 1;
+  }
+  return out.join("");
+}
+function parseHookRegistrations(source) {
+  const hooks = /* @__PURE__ */ new Set();
+  let i = 0;
+  while (i < source.length) {
+    const ch = source[i];
+    const next = source[i + 1];
+    if (ch === "/" && next === "/") {
+      i += 2;
+      while (i < source.length && source[i] !== "\n") i += 1;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      i += 2;
+      while (i + 1 < source.length) {
+        if (source[i] === "*" && source[i + 1] === "/") {
+          i += 2;
+          break;
+        }
+        i += 1;
+      }
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      const quote = ch;
+      i += 1;
+      while (i < source.length) {
+        if (source[i] === "\\") {
+          i += 2;
+          continue;
+        }
+        if (source[i] === quote) {
+          i += 1;
+          break;
+        }
+        i += 1;
+      }
+      continue;
+    }
+    if (source.startsWith("api.on", i) && (i === 0 || !/[a-zA-Z0-9_$\.]/.test(source[i - 1]))) {
+      let j = i + "api.on".length;
+      while (j < source.length && /\s/.test(source[j])) j += 1;
+      if (source[j] !== "(") {
+        i += 1;
+        continue;
+      }
+      j += 1;
+      while (j < source.length && /\s/.test(source[j])) j += 1;
+      const quote = source[j];
+      if (quote !== '"' && quote !== "'") {
+        i += 1;
+        continue;
+      }
+      j += 1;
+      const start = j;
+      while (j < source.length && source[j] !== quote) {
+        if (source[j] === "\\") {
+          j += 2;
+        } else {
+          j += 1;
+        }
+      }
+      if (j < source.length) {
+        const hook = source.slice(start, j);
+        if (/^[a-z_]+$/.test(hook)) hooks.add(hook);
+        i = j + 1;
+        continue;
+      }
+    }
+    i += 1;
+  }
+  return hooks;
+}
+function hasServiceStartRegistration(source) {
+  return /api\.registerService\s*\(\s*\{[\s\S]*?\bstart\s*(?::|\()/m.test(source);
+}
+function hasCliRegistration(source) {
+  return /registerCli\s*\([^)]*\borchestrator\b[^)]*\)/m.test(source);
+}
+function parseNodeMinVersion(raw) {
+  if (!raw) return null;
+  const match = raw.match(/(\d+)\.(\d+)\.(\d+)/);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function parseCurrentNodeVersion(raw) {
+  const normalized = raw.startsWith("v") ? raw.slice(1) : raw;
+  const match = normalized.match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareVersions(a, b) {
+  for (let i = 0; i < 3; i += 1) {
+    if (a[i] > b[i]) return 1;
+    if (a[i] < b[i]) return -1;
+  }
+  return 0;
+}
+async function runCompatChecks(options) {
+  const checks = [];
+  const runner = options.runner ?? defaultRunner;
+  const pluginJsonPath = path41.join(options.repoRoot, "openclaw.plugin.json");
+  const packageJsonPath = path41.join(options.repoRoot, "package.json");
+  const indexPath = path41.join(options.repoRoot, "src", "index.ts");
+  let pluginRaw = "";
+  let pluginManifestPresent = false;
+  try {
+    pluginRaw = await readFile29(pluginJsonPath, "utf-8");
+    pluginManifestPresent = true;
+    checks.push({
+      id: "plugin-manifest-present",
+      title: "Plugin manifest present",
+      level: "ok",
+      message: "Found openclaw.plugin.json"
+    });
+  } catch {
+    checks.push({
+      id: "plugin-manifest-present",
+      title: "Plugin manifest present",
+      level: "error",
+      message: "openclaw.plugin.json is missing",
+      remediation: "Restore openclaw.plugin.json at repo root with plugin metadata."
+    });
+  }
+  if (pluginManifestPresent) {
+    try {
+      const plugin = JSON.parse(pluginRaw);
+      if (plugin.id === "openclaw-engram" && plugin.kind === "memory") {
+        checks.push({
+          id: "plugin-manifest-shape",
+          title: "Plugin manifest ID and kind",
+          level: "ok",
+          message: "Plugin manifest id/kind match expected values."
+        });
+      } else {
+        checks.push({
+          id: "plugin-manifest-shape",
+          title: "Plugin manifest ID and kind",
+          level: "error",
+          message: `Unexpected manifest values (id=${String(plugin.id)}, kind=${String(plugin.kind)})`,
+          remediation: "Set manifest id=openclaw-engram and kind=memory."
+        });
+      }
+    } catch {
+      checks.push({
+        id: "plugin-manifest-shape",
+        title: "Plugin manifest ID and kind",
+        level: "error",
+        message: "openclaw.plugin.json is not valid JSON",
+        remediation: "Fix JSON syntax in openclaw.plugin.json."
+      });
+    }
+  }
+  let packageRaw = "";
+  let packageJsonPresent = false;
+  try {
+    packageRaw = await readFile29(packageJsonPath, "utf-8");
+    packageJsonPresent = true;
+  } catch {
+    checks.push({
+      id: "package-json-present",
+      title: "package.json present",
+      level: "error",
+      message: "package.json is missing",
+      remediation: "Restore package.json at repo root."
+    });
+  }
+  if (packageJsonPresent) {
+    try {
+      const pkg = JSON.parse(packageRaw);
+      const pluginPathOk = pkg.openclaw?.plugin === "./openclaw.plugin.json";
+      const extOk = Array.isArray(pkg.openclaw?.extensions) && pkg.openclaw?.extensions.includes("./dist/index.js");
+      if (pluginPathOk && extOk) {
+        checks.push({
+          id: "package-openclaw-exports",
+          title: "package.json OpenClaw export wiring",
+          level: "ok",
+          message: "package.json openclaw.plugin/extensions wiring looks valid."
+        });
+      } else {
+        checks.push({
+          id: "package-openclaw-exports",
+          title: "package.json OpenClaw export wiring",
+          level: "error",
+          message: "package.json openclaw plugin/extension wiring is missing or invalid.",
+          remediation: "Set openclaw.plugin to ./openclaw.plugin.json and include ./dist/index.js in openclaw.extensions."
+        });
+      }
+      const minVersion = parseNodeMinVersion(pkg.engines?.node);
+      const currentVersion = parseCurrentNodeVersion(process.version);
+      if (!minVersion || !currentVersion) {
+        checks.push({
+          id: "node-version-compat",
+          title: "Node runtime compatibility",
+          level: "warn",
+          message: "Unable to parse node engine/current version.",
+          remediation: "Confirm Node version meets package.json engines.node requirement.",
+          metadata: { enginesNode: pkg.engines?.node, currentNode: process.version }
+        });
+      } else if (compareVersions(currentVersion, minVersion) >= 0) {
+        checks.push({
+          id: "node-version-compat",
+          title: "Node runtime compatibility",
+          level: "ok",
+          message: `Current Node ${process.version} satisfies engines requirement ${pkg.engines?.node}.`
+        });
+      } else {
+        checks.push({
+          id: "node-version-compat",
+          title: "Node runtime compatibility",
+          level: "error",
+          message: `Current Node ${process.version} is below required ${pkg.engines?.node}.`,
+          remediation: "Upgrade Node runtime to meet package.json engines.node minimum."
+        });
+      }
+    } catch {
+      checks.push({
+        id: "package-json-parse",
+        title: "package.json parse",
+        level: "error",
+        message: "package.json is not valid JSON",
+        remediation: "Fix JSON syntax in package.json."
+      });
+    }
+  }
+  try {
+    await access2(indexPath);
+    const indexRaw = await readFile29(indexPath, "utf-8");
+    const structuralSource = stripCommentsAndStrings(indexRaw);
+    const hooks = parseHookRegistrations(indexRaw);
+    const missingHooks = REQUIRED_HOOKS.filter((hook) => !hooks.has(hook));
+    const hasGatewayStartHook = hooks.has("gateway_start");
+    const hasServiceStart = hasServiceStartRegistration(structuralSource);
+    if (missingHooks.length === 0 && (hasGatewayStartHook || hasServiceStart)) {
+      checks.push({
+        id: "hook-registration-core",
+        title: "Core hook registration",
+        level: "ok",
+        message: "Core recall/extraction hooks and startup wiring are registered in src/index.ts."
+      });
+    } else {
+      const missingParts = [];
+      if (missingHooks.length > 0) {
+        missingParts.push(`hooks: ${missingHooks.join(", ")}`);
+      }
+      if (!hasGatewayStartHook && !hasServiceStart) {
+        missingParts.push("startup wiring: gateway_start hook or api.registerService({ start })");
+      }
+      checks.push({
+        id: "hook-registration-core",
+        title: "Core hook registration",
+        level: "error",
+        message: `Missing expected registration(s): ${missingParts.join("; ")}`,
+        remediation: "Ensure src/index.ts registers before_agent_start and agent_end, plus either gateway_start or api.registerService({ start })."
+      });
+    }
+    const cliWired = hasCliRegistration(structuralSource);
+    checks.push({
+      id: "cli-registration",
+      title: "CLI registration wiring",
+      level: cliWired ? "ok" : "warn",
+      message: cliWired ? "CLI registration is wired in plugin bootstrap." : "CLI registration call not found in src/index.ts.",
+      remediation: cliWired ? void 0 : "Call registerCli(api, orchestrator) during plugin registration."
+    });
+  } catch {
+    checks.push({
+      id: "hook-registration-core",
+      title: "Core hook registration",
+      level: "error",
+      message: "src/index.ts is missing; cannot validate hook wiring.",
+      remediation: "Restore src/index.ts and register required hooks."
+    });
+  }
+  const qmdAvailable = await runner.commandExists("qmd");
+  checks.push({
+    id: "qmd-binary-availability",
+    title: "QMD binary availability",
+    level: qmdAvailable ? "ok" : "warn",
+    message: qmdAvailable ? "qmd binary is available in PATH." : "qmd binary is not available in PATH.",
+    remediation: qmdAvailable ? void 0 : "Install qmd or configure qmdPath in plugin config."
+  });
+  return {
+    generatedAt: (options.now ?? /* @__PURE__ */ new Date()).toISOString(),
+    checks,
+    summary: summarize(checks)
+  };
+}
+
 // src/cli.ts
 function rankCandidateForKeep(a, b) {
   const aConfidence = typeof a.frontmatter.confidence === "number" ? a.frontmatter.confidence : 0;
@@ -19738,6 +20109,16 @@ async function runWebDavStopCliCommand() {
     return { stopped: true };
   });
 }
+async function runCompatCliCommand(options = {}) {
+  const report = await runCompatChecks({
+    repoRoot: options.repoRoot ?? process.cwd(),
+    runner: options.runner,
+    now: options.now
+  });
+  const hasWarnOrError = report.summary.warn > 0 || report.summary.error > 0;
+  const exitCode = options.strict === true && hasWarnOrError ? 1 : 0;
+  return { report, exitCode };
+}
 async function runRouteCliCommand(options) {
   const store = new RoutingRulesStore(options.memoryDir, options.stateFile);
   if (options.action === "list") {
@@ -19918,7 +20299,7 @@ async function withTimeout(promise, timeoutMs, timeoutMessage) {
 }
 async function runReplayCliCommand(orchestrator, options) {
   const extractionIdleTimeoutMs = Number.isFinite(options.extractionIdleTimeoutMs) ? Math.max(1e3, Math.floor(options.extractionIdleTimeoutMs)) : 15 * 6e4;
-  const inputRaw = await readFile29(options.inputPath, "utf-8");
+  const inputRaw = await readFile30(options.inputPath, "utf-8");
   const registry = buildReplayNormalizerRegistry([
     openclawReplayNormalizer,
     claudeReplayNormalizer,
@@ -19983,7 +20364,7 @@ async function runReplayCliCommand(orchestrator, options) {
 async function getPluginVersion() {
   try {
     const pkgPath = new URL("../package.json", import.meta.url);
-    const raw = await readFile29(pkgPath, "utf-8");
+    const raw = await readFile30(pkgPath, "utf-8");
     const parsed = JSON.parse(raw);
     return parsed.version ?? "unknown";
   } catch {
@@ -19992,7 +20373,7 @@ async function getPluginVersion() {
 }
 async function exists2(p) {
   try {
-    await access2(p);
+    await access3(p);
     return true;
   } catch {
     return false;
@@ -20002,14 +20383,14 @@ async function resolveMemoryDirForNamespace(orchestrator, namespace) {
   const ns = (namespace ?? "").trim();
   if (!ns) return orchestrator.config.memoryDir;
   if (!orchestrator.config.namespacesEnabled) return orchestrator.config.memoryDir;
-  const candidate = path41.join(orchestrator.config.memoryDir, "namespaces", ns);
+  const candidate = path42.join(orchestrator.config.memoryDir, "namespaces", ns);
   if (ns === orchestrator.config.defaultNamespace) {
     return await exists2(candidate) ? candidate : orchestrator.config.memoryDir;
   }
   return candidate;
 }
 async function readAllMemoryFiles(memoryDir) {
-  const roots = [path41.join(memoryDir, "facts"), path41.join(memoryDir, "corrections")];
+  const roots = [path42.join(memoryDir, "facts"), path42.join(memoryDir, "corrections")];
   const out = [];
   const walk = async (dir) => {
     let entries;
@@ -20020,14 +20401,14 @@ async function readAllMemoryFiles(memoryDir) {
     }
     for (const entry of entries) {
       const entryName = typeof entry.name === "string" ? entry.name : entry.name.toString("utf-8");
-      const fullPath = path41.join(dir, entryName);
+      const fullPath = path42.join(dir, entryName);
       if (entry.isDirectory()) {
         await walk(fullPath);
         continue;
       }
       if (!entry.isFile() || !entryName.endsWith(".md")) continue;
       try {
-        const raw = await readFile29(fullPath, "utf-8");
+        const raw = await readFile30(fullPath, "utf-8");
         const parsed = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
         if (!parsed) continue;
         const fmRaw = parsed[1];
@@ -20210,6 +20591,30 @@ function registerCli(api, orchestrator) {
         });
         console.log("OK");
       });
+      cmd.command("compat").description("Run local compatibility diagnostics for Engram plugin wiring").option("--json", "Emit JSON output for automation").option("--strict", "Exit non-zero when warnings or errors are present").option("--repo-root <path>", "Repository root to inspect", process.cwd()).action(async (...args) => {
+        const options = args[0] ?? {};
+        const strict = options.strict === true;
+        const jsonOutput = options.json === true;
+        const repoRoot = typeof options.repoRoot === "string" && options.repoRoot.trim().length > 0 ? options.repoRoot.trim() : process.cwd();
+        const result = await runCompatCliCommand({ repoRoot, strict });
+        if (jsonOutput) {
+          console.log(JSON.stringify({ strict, exitCode: result.exitCode, report: result.report }, null, 2));
+        } else {
+          console.log("=== Engram Compatibility Report ===");
+          for (const check of result.report.checks) {
+            console.log(`- [${check.level.toUpperCase()}] ${check.title}: ${check.message}`);
+            if (check.remediation) {
+              console.log(`    remediation: ${check.remediation}`);
+            }
+          }
+          console.log(
+            `Summary: ok=${result.report.summary.ok} warn=${result.report.summary.warn} error=${result.report.summary.error}`
+          );
+        }
+        if (result.exitCode !== 0) {
+          process.exitCode = result.exitCode;
+        }
+      });
       cmd.command("replay").description("Import replay transcripts from external exports").option("--source <source>", "Replay source: openclaw|claude|chatgpt").option("--input <path>", "Path to replay export file").option("--from <iso>", "Inclusive lower bound timestamp (ISO UTC)").option("--to <iso>", "Inclusive upper bound timestamp (ISO UTC)").option("--dry-run", "Parse and validate only; do not enqueue extraction").option("--start-offset <n>", "Start replay at offset", "0").option("--max-turns <n>", "Maximum turns to process", "0").option("--batch-size <n>", "Replay ingestion batch size", "100").option("--default-session-key <key>", "Fallback session key when source session identifiers are missing").option("--strict", "Fail on invalid source rows").option("--run-consolidation", "Run consolidation after replay ingestion completes").option("--idle-timeout-ms <n>", "Extraction idle timeout per replay batch/final drain in milliseconds", "900000").action(async (...args) => {
         const options = args[0] ?? {};
         const sourceRaw = typeof options.source === "string" ? options.source.trim().toLowerCase() : "";
@@ -20768,7 +21173,7 @@ function registerCli(api, orchestrator) {
         }
       });
       cmd.command("identity").description("Show agent identity reflections").action(async () => {
-        const workspaceDir = path41.join(process.env.HOME ?? "~", ".openclaw", "workspace");
+        const workspaceDir = path42.join(process.env.HOME ?? "~", ".openclaw", "workspace");
         const identity = await orchestrator.storage.readIdentity(workspaceDir);
         if (!identity) {
           console.log("No identity file found.");
@@ -20991,8 +21396,8 @@ function registerCli(api, orchestrator) {
         const options = args[0] ?? {};
         const threadId = options.thread;
         const top = parseInt(options.top ?? "10", 10);
-        const memoryDir = path41.join(process.env.HOME ?? "~", ".openclaw", "workspace", "memory", "local");
-        const threading = new ThreadingManager(path41.join(memoryDir, "threads"));
+        const memoryDir = path42.join(process.env.HOME ?? "~", ".openclaw", "workspace", "memory", "local");
+        const threading = new ThreadingManager(path42.join(memoryDir, "threads"));
         if (threadId) {
           const thread = await threading.loadThread(threadId);
           if (!thread) {
@@ -21165,16 +21570,16 @@ function parseDuration(duration) {
 }
 
 // src/index.ts
-import { readFile as readFile30, writeFile as writeFile26 } from "fs/promises";
+import { readFile as readFile31, writeFile as writeFile26 } from "fs/promises";
 import { readFileSync as readFileSync4 } from "fs";
-import path42 from "path";
+import path43 from "path";
 import os5 from "os";
 var ENGRAM_REGISTERED_GUARD = "__openclawEngramRegistered";
 function loadPluginConfigFromFile() {
   try {
     const explicitConfigPath = process.env.OPENCLAW_ENGRAM_CONFIG_PATH || process.env.OPENCLAW_CONFIG_PATH;
     const homeDir = process.env.HOME ?? os5.homedir();
-    const configPath = explicitConfigPath && explicitConfigPath.length > 0 ? explicitConfigPath : path42.join(homeDir, ".openclaw", "openclaw.json");
+    const configPath = explicitConfigPath && explicitConfigPath.length > 0 ? explicitConfigPath : path43.join(homeDir, ".openclaw", "openclaw.json");
     const content = readFileSync4(configPath, "utf-8");
     const config = JSON.parse(content);
     const pluginEntry = config?.plugins?.entries?.["openclaw-engram"];
@@ -21382,11 +21787,11 @@ Use this context naturally when relevant. Never quote or expose this memory cont
     );
     async function ensureHourlySummaryCron(api2) {
       const jobId = "engram-hourly-summary";
-      const cronFilePath = path42.join(os5.homedir(), ".openclaw", "cron", "jobs.json");
+      const cronFilePath = path43.join(os5.homedir(), ".openclaw", "cron", "jobs.json");
       try {
         let jobsData = { version: 1, jobs: [] };
         try {
-          const content = await readFile30(cronFilePath, "utf-8");
+          const content = await readFile31(cronFilePath, "utf-8");
           jobsData = JSON.parse(content);
         } catch {
         }