openclaw-hybrid-memory 2026.5.310 → 2026.6.10

package/dist/utils/wal-replay.js.map

@@ -1 +1 @@
-{"version":3,"file":"wal-replay.js","names":[],"sources":["../../utils/wal-replay.ts"],"sourcesContent":["/**\n * WAL Replay Utilities\n *\n * Shared logic for replaying Write-Ahead Log entries to SQLite and LanceDB.\n * Used by both the ContextEngine compact() method and the before_compaction hook.\n */\n\nimport type { FactsDB } from \"../backends/facts-db.js\";\nimport type { VectorDB } from \"../backends/vector-db.js\";\nimport type { WriteAheadLog } from \"../backends/wal.js\";\nimport type { EmbeddingProvider } from \"../services/embeddings.js\";\nimport { capturePluginError } from \"../services/error-reporter.js\";\n\nexport interface WalReplayResult {\n  committed: number;\n  skipped: number;\n}\n\nfunction safeString(v: unknown): string | null {\n  if (typeof v !== \"string\") return null;\n  const t = v.trim();\n  return t.length > 0 ? t : null;\n}\n\nfunction safeNumber(v: unknown): number | null {\n  if (typeof v !== \"number\" || !Number.isFinite(v)) return null;\n  return v;\n}\n\nfunction safeStringArray(v: unknown): string[] | null {\n  if (!Array.isArray(v)) return null;\n  const out = v.map((x) => (typeof x === \"string\" ? x.trim() : \"\")).filter((x) => x.length > 0);\n  return out.length > 0 ? out : null;\n}\n\nconst VALID_WAL_SCOPES = new Set([\"global\", \"user\", \"agent\", \"session\"]);\n\nfunction safeScope(v: unknown): \"global\" | \"user\" | \"agent\" | \"session\" | null {\n  const scope = safeString(v);\n  if (!scope || !VALID_WAL_SCOPES.has(scope)) return null;\n  return scope as \"global\" | \"user\" | \"agent\" | \"session\";\n}\n\nfunction isSafeWalText(v: unknown): v is string {\n  return safeString(v) !== null;\n}\n\n/**\n * Returns a diagnostic message if a WAL entry has a non-global scope but no scopeTarget,\n * or null if the entry is valid and safe to replay.\n *\n * A non-global scope without a scopeTarget cannot be replayed safely because FactsDB.store()\n * requires scopeTarget for scoped facts. Storing without one would silently fall back to\n * global scope, which is the bug described in issue #1574.\n */\nfunction invalidScopeMessage(\n  entryId: string,\n  operation: string,\n  scope: \"global\" | \"user\" | \"agent\" | \"session\" | null,\n  scopeTarget: string | null,\n): string | null {\n  if (scope && scope !== \"global\" && !scopeTarget) {\n    return `WAL replay skipped \"${operation}\" entry ${entryId}: scope=\"${scope}\" but scopeTarget is missing; refusing to globalize a scoped fact.`;\n  }\n  return null;\n}\n\nfunction findExistingFactIdForWal(factsDb: FactsDB, text: string, source: string | null): string | null {\n  try {\n    const src = source?.trim() || \"conversation\";\n    const row = factsDb\n      .getRawDb()\n      .prepare(\n        \"SELECT id FROM facts WHERE text = ? AND source = ? AND superseded_at IS NULL ORDER BY created_at DESC LIMIT 1\",\n      )\n      .get(text, src) as { id: string } | undefined;\n    return row?.id ?? null;\n  } catch {\n    return null;\n  }\n}\n\nfunction hasReplayDuplicateForWal(factsDb: FactsDB, text: string, source: string | null): boolean {\n  try {\n    return factsDb.hasDuplicate(text, source?.trim() || \"conversation\");\n  } catch {\n    return false;\n  }\n}\n\nasync function ensureVectorAndEmbeddingMeta(opts: {\n  factId: string;\n  text: string;\n  category: string;\n  importance: number;\n  vector: number[] | null;\n  embeddingModelName?: string | null;\n  vectorDb?: VectorDB;\n  embeddings?: EmbeddingProvider | null;\n  factsDb: FactsDB;\n}): Promise<void> {\n  const { factId, text, category, importance, vector, embeddingModelName, vectorDb, embeddings, factsDb } = opts;\n  if (!vectorDb) return;\n\n  const embedAndStore = async (): Promise<number[] | null> => {\n    if (!embeddings) return null;\n    try {\n      const v = await embeddings.embed(text);\n      await vectorDb.store({\n        id: factId,\n        text,\n        vector: Array.from(v),\n        importance,\n        category,\n      });\n      if (embeddings.modelName) {\n        factsDb.setEmbeddingModel(factId, embeddings.modelName);\n        factsDb.storeEmbedding(factId, embeddings.modelName, \"canonical\", new Float32Array(v), v.length);\n      }\n      return Array.from(v);\n    } catch {\n      return null;\n    }\n  };\n\n  try {\n    if (vector && vector.length > 0) {\n      await vectorDb.store({\n        id: factId,\n        text,\n        vector,\n        importance,\n        category,\n      });\n      const effectiveModel = embeddingModelName ?? embeddings?.modelName;\n      if (effectiveModel) {\n        try {\n          factsDb.setEmbeddingModel(factId, effectiveModel);\n          factsDb.storeEmbedding(factId, effectiveModel, \"canonical\", new Float32Array(vector), vector.length);\n        } catch (err) {\n          capturePluginError(err instanceof Error ? err : new Error(String(err)), {\n            subsystem: \"wal-replay\",\n            operation: \"store-embedding-metadata\",\n            factId,\n          });\n        }\n      }\n      return;\n    }\n  } catch {\n    // Non-fatal: fall back to re-embed if possible.\n  }\n\n  await embedAndStore();\n}\n\n/**\n * Replay all pending WAL entries to the facts database and optionally to the vector database.\n *\n * @param wal - Write-Ahead Log instance\n * @param factsDb - Facts database for storing entries\n * @param vectorDb - Optional vector database for storing embeddings\n * @param embeddings - Optional embedding provider for generating vectors\n * @param logger - Optional logger for operator-visible diagnostics (e.g. skipped WAL entries)\n * @returns Object with committed and skipped counts\n */\nexport async function replayWalEntries(\n  wal: WriteAheadLog,\n  factsDb: FactsDB,\n  vectorDb?: VectorDB,\n  embeddings?: EmbeddingProvider | null,\n  logger?: { warn?: (msg: string) => void },\n): Promise<WalReplayResult> {\n  let committed = 0;\n  let skipped = 0;\n\n  // Only replay entries within the WAL's maxAge window.\n  // Older entries are handled by WAL prune routines and should not be resurrected.\n  const walEntries = await wal.getValidEntries();\n  const nowSec = Math.floor(Date.now() / 1000);\n\n  for (const entry of walEntries) {\n    try {\n      // Skip diagnostic probe entries (e.g., doctor command durability tests).\n      if (entry.data?.probe) {\n        skipped++;\n        await wal.remove(entry.id);\n        continue;\n      }\n      if (entry.operation === \"store\" && isSafeWalText(entry.data?.text)) {\n        const text = safeString(entry.data.text);\n        if (!text) continue;\n        const source = safeString(entry.data.source) ?? \"conversation\";\n        const category = (safeString(entry.data.category) ?? \"other\") as import(\"../config.js\").MemoryCategory;\n        const importance = safeNumber(entry.data.importance) ?? 0.5;\n        const why = safeString(entry.data.why);\n        const scope = safeScope(entry.data.scope);\n        const scopeTarget = safeString(entry.data.scopeTarget);\n        const summary = safeString(entry.data.summary);\n        const tags = safeStringArray(entry.data.tags) ?? undefined;\n        const decayFreezeUntil = safeNumber(entry.data.decayFreezeUntil);\n        const preserveUntil = safeNumber(entry.data.preserveUntil);\n        const preserveTags = safeStringArray(entry.data.preserveTags);\n        const provenanceSession = safeString(entry.data.provenanceSession);\n        const sourceTurn = safeNumber(entry.data.sourceTurn);\n        const extractionMethod = safeString(entry.data.extractionMethod);\n        const extractionConfidence = safeNumber(entry.data.extractionConfidence);\n        const provenanceJson = safeString(entry.data.provenanceJson);\n        const sourceSessions = safeString(entry.data.sourceSessions);\n\n        const precomputedVector = Array.isArray(entry.data.vector)\n          ? (entry.data.vector as number[]).filter((n) => typeof n === \"number\" && Number.isFinite(n))\n          : null;\n        const embeddingModelName = safeString(entry.data.embeddingModelName);\n\n        // Guard: a non-global scope without a scopeTarget cannot be safely replayed — storing it\n        // would silently change the intended scope to global (issue #1574). Skip with a diagnostic\n        // so that scoped facts are never accidentally promoted to global during crash recovery.\n        const storeInvalidMsg = invalidScopeMessage(entry.id, \"store\", scope, scopeTarget);\n        if (storeInvalidMsg) {\n          capturePluginError(new Error(storeInvalidMsg), {\n            subsystem: \"wal-replay\",\n            operation: \"replay-store\",\n            severity: \"warning\",\n            entryId: entry.id,\n            scope,\n          });\n          logger?.warn?.(`memory-hybrid: ${storeInvalidMsg}`);\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Idempotent replay: if the fact already exists, still ensure vector/embedding metadata.\n        const existingId = findExistingFactIdForWal(factsDb, text, source);\n        if (existingId) {\n          await ensureVectorAndEmbeddingMeta({\n            factId: existingId,\n            text,\n            category,\n            importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Store-side dedupe can resolve this WAL write via hash/lexical/vector policy\n        // without creating an exact text+source row. If that already happened before\n        // a crash but before WAL removal, replay must not call store() again: boost\n        // and merge dedupe actions are not idempotent.\n        if (hasReplayDuplicateForWal(factsDb, text, source)) {\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const stored = factsDb.store({\n          text,\n          why,\n          category,\n          importance,\n          entity: safeString(entry.data.entity) ?? null,\n          key: safeString(entry.data.key) ?? null,\n          value: safeString(entry.data.value) ?? null,\n          source,\n          decayClass: safeString(entry.data.decayClass) as import(\"../config.js\").DecayClass | undefined,\n          summary,\n          tags,\n          scope: (scope ?? undefined) as \"global\" | \"user\" | \"agent\" | \"session\" | undefined,\n          scopeTarget: scope ? scopeTarget : null,\n          sourceSessions: sourceSessions ?? undefined,\n          provenanceSession: provenanceSession ?? undefined,\n          sourceTurn: sourceTurn ?? undefined,\n          extractionMethod: extractionMethod ?? undefined,\n          extractionConfidence: extractionConfidence ?? undefined,\n          decayFreezeUntil: decayFreezeUntil ?? undefined,\n          preserveUntil: preserveUntil ?? undefined,\n          preserveTags: preserveTags ?? undefined,\n          provenanceJson: provenanceJson ?? undefined,\n        });\n\n        // Skip vector operations if the store was rejected (artifact text)\n        if (stored.id !== \"\") {\n          await ensureVectorAndEmbeddingMeta({\n            factId: stored.id,\n            text: stored.text,\n            category: stored.category,\n            importance: stored.importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n          committed++;\n        } else {\n          skipped++;\n        }\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"update\" && entry.targetId && isSafeWalText(entry.data?.text)) {\n        const targetId = entry.targetId;\n        const text = safeString(entry.data.text);\n        if (!text) continue;\n        const source = safeString(entry.data.source) ?? \"conversation\";\n        const category = (safeString(entry.data.category) ?? \"other\") as import(\"../config.js\").MemoryCategory;\n        const importance = safeNumber(entry.data.importance) ?? 0.5;\n        const why = safeString(entry.data.why);\n        const scope = safeScope(entry.data.scope);\n        const scopeTarget = safeString(entry.data.scopeTarget);\n        const summary = safeString(entry.data.summary);\n        const tags = safeStringArray(entry.data.tags) ?? undefined;\n        const decayFreezeUntil = safeNumber(entry.data.decayFreezeUntil);\n        const preserveUntil = safeNumber(entry.data.preserveUntil);\n        const preserveTags = safeStringArray(entry.data.preserveTags);\n        const provenanceSession = safeString(entry.data.provenanceSession);\n        const sourceTurn = safeNumber(entry.data.sourceTurn);\n        const extractionMethod = safeString(entry.data.extractionMethod);\n        const extractionConfidence = safeNumber(entry.data.extractionConfidence);\n        const provenanceJson = safeString(entry.data.provenanceJson);\n        const sourceSessions = safeString(entry.data.sourceSessions);\n\n        const precomputedVector = Array.isArray(entry.data.vector)\n          ? (entry.data.vector as number[]).filter((n) => typeof n === \"number\" && Number.isFinite(n))\n          : null;\n        const embeddingModelName = safeString(entry.data.embeddingModelName);\n\n        // Guard: same as \"store\" path — do not replay a non-global scoped update without a scopeTarget.\n        const updateInvalidMsg = invalidScopeMessage(entry.id, \"update\", scope, scopeTarget);\n        if (updateInvalidMsg) {\n          capturePluginError(new Error(updateInvalidMsg), {\n            subsystem: \"wal-replay\",\n            operation: \"replay-update\",\n            severity: \"warning\",\n            entryId: entry.id,\n            scope,\n          });\n          logger?.warn?.(`memory-hybrid: ${updateInvalidMsg}`);\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const target = factsDb.getById(targetId);\n        if (!target) {\n          // Target fact already gone — nothing safe to replay.\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Idempotent replay: if the exact intended replacement already exists, ensure vector metadata.\n        const existingId = findExistingFactIdForWal(factsDb, text, source);\n        if (existingId && existingId !== targetId) {\n          const existing = factsDb.getById(existingId);\n          if (existing?.supersedesId === targetId) {\n            factsDb.supersede(targetId, existingId);\n            await ensureVectorAndEmbeddingMeta({\n              factId: existingId,\n              text,\n              category,\n              importance,\n              vector: precomputedVector,\n              embeddingModelName,\n              vectorDb,\n              embeddings,\n              factsDb,\n            });\n            skipped++;\n            await wal.remove(entry.id);\n            continue;\n          }\n        }\n\n        if (factsDb.hasDuplicate(text)) {\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const stored = factsDb.store({\n          text,\n          why,\n          category,\n          importance,\n          entity: safeString(entry.data.entity) ?? null,\n          key: safeString(entry.data.key) ?? null,\n          value: safeString(entry.data.value) ?? null,\n          source,\n          decayClass: safeString(entry.data.decayClass) as import(\"../config.js\").DecayClass | undefined,\n          summary,\n          tags,\n          validFrom: nowSec,\n          supersedesId: targetId,\n          scope: (scope ?? undefined) as \"global\" | \"user\" | \"agent\" | \"session\" | undefined,\n          scopeTarget: scope ? scopeTarget : null,\n          sourceSessions: sourceSessions ?? undefined,\n          provenanceSession: provenanceSession ?? undefined,\n          sourceTurn: sourceTurn ?? undefined,\n          extractionMethod: extractionMethod ?? undefined,\n          extractionConfidence: extractionConfidence ?? undefined,\n          decayFreezeUntil: decayFreezeUntil ?? undefined,\n          preserveUntil: preserveUntil ?? undefined,\n          preserveTags: preserveTags ?? undefined,\n          provenanceJson: provenanceJson ?? undefined,\n        });\n\n        // Skip supersede and vector operations if store was rejected (artifact text)\n        if (stored.id !== \"\") {\n          factsDb.supersede(targetId, stored.id);\n\n          await ensureVectorAndEmbeddingMeta({\n            factId: stored.id,\n            text: stored.text,\n            category: stored.category,\n            importance: stored.importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n\n          committed++;\n        } else {\n          skipped++;\n        }\n        await wal.remove(entry.id);\n      } else if ((entry.operation === \"store\" || entry.operation === \"update\") && !isSafeWalText(entry.data?.text)) {\n        // Empty or whitespace-only text cannot ever be replayed into FactsDB.\n        skipped++;\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"update\") {\n        // Legacy UPDATE lines without targetId cannot be replayed safely.\n        skipped++;\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"delete\") {\n        // Delete WAL entries cannot be reliably replayed: the WAL data structure stores\n        // text content in data.text, not the target fact UUID. Replaying would pass the\n        // memory text as a UUID, causing an \"Invalid UUID format\" error (see issue #334).\n        // Skip and remove to prevent unbounded WAL growth.\n        skipped++;\n        await wal.remove(entry.id);\n      }\n    } catch (err) {\n      // Non-fatal: log the failure (with entry id + operation for diagnostics) and continue\n      capturePluginError(err instanceof Error ? err : new Error(String(err)), {\n        subsystem: \"wal-replay\",\n        operation: `replay-${entry.operation ?? \"unknown\"}`,\n        entryId: entry.id,\n      });\n      // Leave the entry in the WAL so it can be retried (or pruned as stale).\n    }\n  }\n\n  return { committed, skipped };\n}\n"],"mappings":"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"}
+{"version":3,"file":"wal-replay.js","names":[],"sources":["../../utils/wal-replay.ts"],"sourcesContent":["/**\n * WAL Replay Utilities\n *\n * Shared logic for replaying Write-Ahead Log entries to SQLite and LanceDB.\n * Used by both the ContextEngine compact() method and the before_compaction hook.\n */\n\nimport type { FactsDB } from \"../backends/facts-db.js\";\nimport type { VectorDB } from \"../backends/vector-db.js\";\nimport type { WriteAheadLog } from \"../backends/wal.js\";\nimport type { EmbeddingProvider } from \"../services/embeddings.js\";\nimport { capturePluginError } from \"../services/error-reporter.js\";\n\nexport interface WalReplayResult {\n  committed: number;\n  skipped: number;\n}\n\nfunction safeString(v: unknown): string | null {\n  if (typeof v !== \"string\") return null;\n  const t = v.trim();\n  return t.length > 0 ? t : null;\n}\n\nfunction safeNumber(v: unknown): number | null {\n  if (typeof v !== \"number\" || !Number.isFinite(v)) return null;\n  return v;\n}\n\nfunction safeStringArray(v: unknown): string[] | null {\n  if (!Array.isArray(v)) return null;\n  const out = v.map((x) => (typeof x === \"string\" ? x.trim() : \"\")).filter((x) => x.length > 0);\n  return out.length > 0 ? out : null;\n}\n\nconst VALID_WAL_SCOPES = new Set([\"global\", \"user\", \"agent\", \"session\"]);\n\nfunction safeScope(v: unknown): \"global\" | \"user\" | \"agent\" | \"session\" | null {\n  const scope = safeString(v);\n  if (!scope || !VALID_WAL_SCOPES.has(scope)) return null;\n  return scope as \"global\" | \"user\" | \"agent\" | \"session\";\n}\n\nfunction isSafeWalText(v: unknown): v is string {\n  return safeString(v) !== null;\n}\n\n/**\n * Returns a diagnostic message if a WAL entry has a non-global scope but no scopeTarget,\n * or null if the entry is valid and safe to replay.\n *\n * A non-global scope without a scopeTarget cannot be replayed safely because FactsDB.store()\n * requires scopeTarget for scoped facts. Storing without one would silently fall back to\n * global scope, which is the bug described in issue #1574.\n */\nfunction invalidScopeMessage(\n  entryId: string,\n  operation: string,\n  scope: \"global\" | \"user\" | \"agent\" | \"session\" | null,\n  scopeTarget: string | null,\n): string | null {\n  if (scope && scope !== \"global\" && !scopeTarget) {\n    return `WAL replay skipped \"${operation}\" entry ${entryId}: scope=\"${scope}\" but scopeTarget is missing; refusing to globalize a scoped fact.`;\n  }\n  return null;\n}\n\nfunction findExistingFactIdForWal(factsDb: FactsDB, text: string, source: string | null): string | null {\n  try {\n    const src = source?.trim() || \"conversation\";\n    const row = factsDb\n      .getRawDb()\n      .prepare(\n        \"SELECT id FROM facts WHERE text = ? AND source = ? AND superseded_at IS NULL ORDER BY created_at DESC LIMIT 1\",\n      )\n      .get(text, src) as { id: string } | undefined;\n    return row?.id ?? null;\n  } catch {\n    return null;\n  }\n}\n\nfunction hasReplayDuplicateForWal(factsDb: FactsDB, text: string, source: string | null): boolean {\n  try {\n    return factsDb.hasDuplicate(text, source?.trim() || \"conversation\");\n  } catch {\n    return false;\n  }\n}\n\nasync function ensureVectorAndEmbeddingMeta(opts: {\n  factId: string;\n  text: string;\n  category: string;\n  importance: number;\n  vector: number[] | null;\n  embeddingModelName?: string | null;\n  vectorDb?: VectorDB;\n  embeddings?: EmbeddingProvider | null;\n  factsDb: FactsDB;\n}): Promise<void> {\n  const { factId, text, category, importance, vector, embeddingModelName, vectorDb, embeddings, factsDb } = opts;\n  if (!vectorDb) return;\n\n  const embedAndStore = async (): Promise<number[] | null> => {\n    if (!embeddings) return null;\n    try {\n      const v = await embeddings.embed(text);\n      await vectorDb.store({\n        id: factId,\n        text,\n        vector: Array.from(v),\n        importance,\n        category,\n      });\n      if (embeddings.modelName) {\n        factsDb.setEmbeddingModel(factId, embeddings.modelName);\n        factsDb.storeEmbedding(factId, embeddings.modelName, \"canonical\", new Float32Array(v), v.length);\n      }\n      return Array.from(v);\n    } catch {\n      return null;\n    }\n  };\n\n  try {\n    if (vector && vector.length > 0) {\n      await vectorDb.store({\n        id: factId,\n        text,\n        vector,\n        importance,\n        category,\n      });\n      const effectiveModel = embeddingModelName ?? embeddings?.modelName;\n      if (effectiveModel) {\n        try {\n          factsDb.setEmbeddingModel(factId, effectiveModel);\n          factsDb.storeEmbedding(factId, effectiveModel, \"canonical\", new Float32Array(vector), vector.length);\n        } catch (err) {\n          capturePluginError(err instanceof Error ? err : new Error(String(err)), {\n            subsystem: \"wal-replay\",\n            operation: \"store-embedding-metadata\",\n            factId,\n          });\n        }\n      }\n      return;\n    }\n  } catch {\n    // Non-fatal: fall back to re-embed if possible.\n  }\n\n  await embedAndStore();\n}\n\n/**\n * Replay all pending WAL entries to the facts database and optionally to the vector database.\n *\n * @param wal - Write-Ahead Log instance\n * @param factsDb - Facts database for storing entries\n * @param vectorDb - Optional vector database for storing embeddings\n * @param embeddings - Optional embedding provider for generating vectors\n * @param logger - Optional logger for operator-visible diagnostics (e.g. skipped WAL entries)\n * @returns Object with committed and skipped counts\n */\nexport async function replayWalEntries(\n  wal: WriteAheadLog,\n  factsDb: FactsDB,\n  vectorDb?: VectorDB,\n  embeddings?: EmbeddingProvider | null,\n  logger?: { warn?: (msg: string) => void },\n): Promise<WalReplayResult> {\n  let committed = 0;\n  let skipped = 0;\n\n  // Only replay entries within the WAL's maxAge window.\n  // Older entries are handled by WAL prune routines and should not be resurrected.\n  const walEntries = await wal.getValidEntries();\n  const nowSec = Math.floor(Date.now() / 1000);\n\n  for (const entry of walEntries) {\n    try {\n      // Skip diagnostic probe entries (e.g., doctor command durability tests).\n      if (entry.data?.probe) {\n        skipped++;\n        await wal.remove(entry.id);\n        continue;\n      }\n      if (entry.operation === \"store\" && isSafeWalText(entry.data?.text)) {\n        const text = safeString(entry.data.text);\n        if (!text) continue;\n        const source = safeString(entry.data.source) ?? \"conversation\";\n        const category = (safeString(entry.data.category) ?? \"other\") as import(\"../config.js\").MemoryCategory;\n        const importance = safeNumber(entry.data.importance) ?? 0.5;\n        const why = safeString(entry.data.why);\n        const scope = safeScope(entry.data.scope);\n        const scopeTarget = safeString(entry.data.scopeTarget);\n        const summary = safeString(entry.data.summary);\n        const tags = safeStringArray(entry.data.tags) ?? undefined;\n        const decayFreezeUntil = safeNumber(entry.data.decayFreezeUntil);\n        const preserveUntil = safeNumber(entry.data.preserveUntil);\n        const preserveTags = safeStringArray(entry.data.preserveTags);\n        const provenanceSession = safeString(entry.data.provenanceSession);\n        const sourceTurn = safeNumber(entry.data.sourceTurn);\n        const extractionMethod = safeString(entry.data.extractionMethod);\n        const extractionConfidence = safeNumber(entry.data.extractionConfidence);\n        const provenanceJson = safeString(entry.data.provenanceJson);\n        const sourceSessions = safeString(entry.data.sourceSessions);\n\n        const precomputedVector = Array.isArray(entry.data.vector)\n          ? (entry.data.vector as number[]).filter((n) => typeof n === \"number\" && Number.isFinite(n))\n          : null;\n        const embeddingModelName = safeString(entry.data.embeddingModelName);\n\n        // Guard: a non-global scope without a scopeTarget cannot be safely replayed — storing it\n        // would silently change the intended scope to global (issue #1574). Skip with a diagnostic\n        // so that scoped facts are never accidentally promoted to global during crash recovery.\n        const storeInvalidMsg = invalidScopeMessage(entry.id, \"store\", scope, scopeTarget);\n        if (storeInvalidMsg) {\n          capturePluginError(new Error(storeInvalidMsg), {\n            subsystem: \"wal-replay\",\n            operation: \"replay-store\",\n            severity: \"warning\",\n            entryId: entry.id,\n            scope,\n          });\n          logger?.warn?.(`memory-hybrid: ${storeInvalidMsg}`);\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Idempotent replay: if the fact already exists, still ensure vector/embedding metadata.\n        const existingId = findExistingFactIdForWal(factsDb, text, source);\n        if (existingId) {\n          await ensureVectorAndEmbeddingMeta({\n            factId: existingId,\n            text,\n            category,\n            importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Store-side dedupe can resolve this WAL write via hash/lexical/vector policy\n        // without creating an exact text+source row. If that already happened before\n        // a crash but before WAL removal, replay must not call store() again: boost\n        // and merge dedupe actions are not idempotent.\n        if (hasReplayDuplicateForWal(factsDb, text, source)) {\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const stored = factsDb.store({\n          text,\n          why,\n          category,\n          importance,\n          entity: safeString(entry.data.entity) ?? null,\n          key: safeString(entry.data.key) ?? null,\n          value: safeString(entry.data.value) ?? null,\n          source,\n          decayClass: safeString(entry.data.decayClass) as import(\"../config.js\").DecayClass | undefined,\n          summary,\n          tags,\n          scope: (scope ?? undefined) as \"global\" | \"user\" | \"agent\" | \"session\" | undefined,\n          scopeTarget: scope ? scopeTarget : null,\n          sourceSessions: sourceSessions ?? undefined,\n          provenanceSession: provenanceSession ?? undefined,\n          sourceTurn: sourceTurn ?? undefined,\n          extractionMethod: extractionMethod ?? undefined,\n          extractionConfidence: extractionConfidence ?? undefined,\n          decayFreezeUntil: decayFreezeUntil ?? undefined,\n          preserveUntil: preserveUntil ?? undefined,\n          preserveTags: preserveTags ?? undefined,\n          provenanceJson: provenanceJson ?? undefined,\n        });\n\n        // Skip vector operations if the store was rejected (artifact text)\n        if (stored.id !== \"\") {\n          await ensureVectorAndEmbeddingMeta({\n            factId: stored.id,\n            text: stored.text,\n            category: stored.category,\n            importance: stored.importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n          committed++;\n        } else {\n          skipped++;\n        }\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"update\" && entry.targetId && isSafeWalText(entry.data?.text)) {\n        const targetId = entry.targetId;\n        const text = safeString(entry.data.text);\n        if (!text) continue;\n        const source = safeString(entry.data.source) ?? \"conversation\";\n        const category = (safeString(entry.data.category) ?? \"other\") as import(\"../config.js\").MemoryCategory;\n        const importance = safeNumber(entry.data.importance) ?? 0.5;\n        const why = safeString(entry.data.why);\n        const scope = safeScope(entry.data.scope);\n        const scopeTarget = safeString(entry.data.scopeTarget);\n        const summary = safeString(entry.data.summary);\n        const tags = safeStringArray(entry.data.tags) ?? undefined;\n        const decayFreezeUntil = safeNumber(entry.data.decayFreezeUntil);\n        const preserveUntil = safeNumber(entry.data.preserveUntil);\n        const preserveTags = safeStringArray(entry.data.preserveTags);\n        const provenanceSession = safeString(entry.data.provenanceSession);\n        const sourceTurn = safeNumber(entry.data.sourceTurn);\n        const extractionMethod = safeString(entry.data.extractionMethod);\n        const extractionConfidence = safeNumber(entry.data.extractionConfidence);\n        const provenanceJson = safeString(entry.data.provenanceJson);\n        const sourceSessions = safeString(entry.data.sourceSessions);\n\n        const precomputedVector = Array.isArray(entry.data.vector)\n          ? (entry.data.vector as number[]).filter((n) => typeof n === \"number\" && Number.isFinite(n))\n          : null;\n        const embeddingModelName = safeString(entry.data.embeddingModelName);\n\n        // Guard: same as \"store\" path — do not replay a non-global scoped update without a scopeTarget.\n        const updateInvalidMsg = invalidScopeMessage(entry.id, \"update\", scope, scopeTarget);\n        if (updateInvalidMsg) {\n          capturePluginError(new Error(updateInvalidMsg), {\n            subsystem: \"wal-replay\",\n            operation: \"replay-update\",\n            severity: \"warning\",\n            entryId: entry.id,\n            scope,\n          });\n          logger?.warn?.(`memory-hybrid: ${updateInvalidMsg}`);\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const target = factsDb.getById(targetId);\n        if (!target) {\n          // Target fact already gone — nothing safe to replay.\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        // Idempotent replay: if the exact intended replacement already exists, ensure vector metadata.\n        const existingId = findExistingFactIdForWal(factsDb, text, source);\n        if (existingId && existingId !== targetId) {\n          const existing = factsDb.getById(existingId);\n          if (existing?.supersedesId === targetId) {\n            factsDb.supersede(targetId, existingId);\n            await ensureVectorAndEmbeddingMeta({\n              factId: existingId,\n              text,\n              category,\n              importance,\n              vector: precomputedVector,\n              embeddingModelName,\n              vectorDb,\n              embeddings,\n              factsDb,\n            });\n            skipped++;\n            await wal.remove(entry.id);\n            continue;\n          }\n        }\n\n        if (factsDb.hasDuplicate(text)) {\n          skipped++;\n          await wal.remove(entry.id);\n          continue;\n        }\n\n        const stored = factsDb.store({\n          text,\n          why,\n          category,\n          importance,\n          entity: safeString(entry.data.entity) ?? null,\n          key: safeString(entry.data.key) ?? null,\n          value: safeString(entry.data.value) ?? null,\n          source,\n          decayClass: safeString(entry.data.decayClass) as import(\"../config.js\").DecayClass | undefined,\n          summary,\n          tags,\n          validFrom: nowSec,\n          supersedesId: targetId,\n          scope: (scope ?? undefined) as \"global\" | \"user\" | \"agent\" | \"session\" | undefined,\n          scopeTarget: scope ? scopeTarget : null,\n          sourceSessions: sourceSessions ?? undefined,\n          provenanceSession: provenanceSession ?? undefined,\n          sourceTurn: sourceTurn ?? undefined,\n          extractionMethod: extractionMethod ?? undefined,\n          extractionConfidence: extractionConfidence ?? undefined,\n          decayFreezeUntil: decayFreezeUntil ?? undefined,\n          preserveUntil: preserveUntil ?? undefined,\n          preserveTags: preserveTags ?? undefined,\n          provenanceJson: provenanceJson ?? undefined,\n        });\n\n        // Skip supersede and vector operations if store was rejected (artifact text)\n        if (stored.id !== \"\") {\n          factsDb.supersede(targetId, stored.id);\n\n          await ensureVectorAndEmbeddingMeta({\n            factId: stored.id,\n            text: stored.text,\n            category: stored.category,\n            importance: stored.importance,\n            vector: precomputedVector,\n            embeddingModelName,\n            vectorDb,\n            embeddings,\n            factsDb,\n          });\n\n          committed++;\n        } else {\n          skipped++;\n        }\n        await wal.remove(entry.id);\n      } else if ((entry.operation === \"store\" || entry.operation === \"update\") && !isSafeWalText(entry.data?.text)) {\n        // Empty or whitespace-only text cannot ever be replayed into FactsDB.\n        skipped++;\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"update\") {\n        // Legacy UPDATE lines without targetId cannot be replayed safely.\n        skipped++;\n        await wal.remove(entry.id);\n      } else if (entry.operation === \"delete\") {\n        // Delete WAL entries cannot be reliably replayed: the WAL data structure stores\n        // text content in data.text, not the target fact UUID. Replaying would pass the\n        // memory text as a UUID, causing an \"Invalid UUID format\" error (see issue #334).\n        // Skip and remove to prevent unbounded WAL growth.\n        skipped++;\n        await wal.remove(entry.id);\n      }\n    } catch (err) {\n      // Non-fatal: log the failure (with entry id + operation for diagnostics) and continue\n      capturePluginError(err instanceof Error ? err : new Error(String(err)), {\n        subsystem: \"wal-replay\",\n        operation: `replay-${entry.operation ?? \"unknown\"}`,\n        entryId: entry.id,\n      });\n      // Leave the entry in the WAL so it can be retried (or pruned as stale).\n    }\n  }\n\n  return { committed, skipped };\n}\n"],"mappings":"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"}

package/dist/versionInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"versionInfo.js","names":[],"sources":["../versionInfo.ts"],"sourcesContent":["/**\n * Memory Manager version metadata — single source for upgrades and releases.\n * Plugin version is read from package.json; memory-manager and schema versions\n * are defined here and aligned with docs (hybrid-memory-manager-v3.md) and DB.\n *\n * The version is resolved via the plugin-root walk-up helper so it works\n * regardless of whether the runtime entry is the TS source or the compiled\n * `dist/index.js` (issue #1174).\n */\n\nimport { readPluginPackageJson } from \"./utils/plugin-root.js\";\n\nconst pkg = readPluginPackageJson(import.meta.url);\n\n/** Plugin release version (from package.json). Bump on each release. */\nconst pluginVersion: string = pkg.version;\n\n/** Memory Manager spec version — matches docs/hybrid-memory-manager-v3.md \"Version: X.Y\". */\nconst memoryManagerVersion = \"3.0\";\n\n/** Schema version for SQLite/LanceDB. Bump when adding migrations or breaking schema changes. */\nconst schemaVersion = 3;\n\nexport const versionInfo = {\n  pluginVersion,\n  memoryManagerVersion,\n  schemaVersion,\n} as const;\n"],"mappings":";AAuBA,MAAa,cAAc;CACzB,eAZU,sBAAsB,OAAO,KAAK,IAGb,CAAC;CAUhC;CACA;CACD"}
+{"version":3,"file":"versionInfo.js","names":[],"sources":["../versionInfo.ts"],"sourcesContent":["/**\n * Memory Manager version metadata — single source for upgrades and releases.\n * Plugin version is read from package.json; memory-manager and schema versions\n * are defined here and aligned with docs (hybrid-memory-manager-v3.md) and DB.\n *\n * The version is resolved via the plugin-root walk-up helper so it works\n * regardless of whether the runtime entry is the TS source or the compiled\n * `dist/index.js` (issue #1174).\n */\n\nimport { readPluginPackageJson } from \"./utils/plugin-root.js\";\n\nconst pkg = readPluginPackageJson(import.meta.url);\n\n/** Plugin release version (from package.json). Bump on each release. */\nconst pluginVersion: string = pkg.version;\n\n/** Memory Manager spec version — matches docs/hybrid-memory-manager-v3.md \"Version: X.Y\". */\nconst memoryManagerVersion = \"3.0\";\n\n/** Schema version for SQLite/LanceDB. Bump when adding migrations or breaking schema changes. */\nconst schemaVersion = 3;\n\nexport const versionInfo = {\n  pluginVersion,\n  memoryManagerVersion,\n  schemaVersion,\n} as const;\n"],"mappings":";AAuBA,MAAa,cAAc;CACzB,eAZU,sBAAsB,OAAO,KAAK,GAGd,EAAE;CAUhC;CACA;AACF"}

package/index.ts

@@ -66,8 +66,8 @@ const memoryHybridPlugin = {
   configSchema: hybridConfigSchema,
   versionInfo,
 
-  async register(api: ClawdbotPluginApi) {
-    await runMemoryHybridRegister(api);
+  register(api: ClawdbotPluginApi) {
+    runMemoryHybridRegister(api);
   },
 };
 

package/lifecycle/hooks.ts

@@ -10,7 +10,6 @@ import { homedir } from "node:os";
 import { isAbsolute, join } from "node:path";
 import type { ClawdbotPluginApi } from "openclaw/plugin-sdk/core";
 import { getCronModelConfig, getDefaultCronModel } from "../config/index.js";
-import "../config.js";
 import { isAbortOrTransientLlmError } from "../services/chat.js";
 import { capturePluginError } from "../services/error-reporter.js";
 import { buildDailyNarrative } from "../src/worker/narratives.js";