@remnic/core 9.4.0 → 9.4.1

package/dist/orchestrator.d.ts

@@ -8,7 +8,7 @@ import './summarizer.js';
 import './local-llm.js';
 import './fallback-llm.js';
 import './orchestration/maintenance.js';
-export { Q as BulkImportBatchIngestResult, T as BulkImportBatchPartialFailureError, U as COMPACTION_SIGNAL_MAX_AGE_MS, V as DaySummaryGatherOptions, X as ExtractionRunResult, Y as GraphRecallRankedResult, Z as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, _ as QmdRecallSnapshot, $ as QueryAwarePrefilter, a0 as RecallInvocationOptions, a1 as RecallModeDecision, a2 as appendMemoryToGraphContext, a3 as applyQueryAwareCandidateFilter, a4 as blendGraphExpandedRecallScore, a5 as buildCompressionGuidelinesMarkdown, a6 as buildMemoryPathById, a7 as computeArtifactCandidateFetchLimit, a8 as computeArtifactRecallLimit, a9 as computeQmdHybridFetchLimit, t as defaultWorkspaceDir, aa as deriveTopicsFromExtraction, ab as filterHourlySummaryMarkdownForLocalDay, ac as filterRecallCandidates, ad as formatDateInTimeZone, ae as graphPathRelativeToStorage, af as hasIdentityRecoveryIntent, ag as isArtifactMemoryPath, ah as lifecycleRecallScoreAdjustment, ai as mapRecallSourceToXrayServedBy, aj as mergeArtifactRecallCandidates, ak as mergeGraphExpandedResults, al as normalizeIanaTimeZone, am as parseFiniteDate, an as parseGraphRecallRankedResults, ao as parseMemoryIntentSnapshot, ap as parseQmdRecallResults, aq as qmdStartupCollectionCheckWithTimeout, ar as raceRecallAbort, as as resolveEffectiveIdentityInjectionMode, at as resolveEffectiveRecallMode, au as resolvePersistedMemoryRelativePath, av as resolveRecallModeDecision, aw as resolveRecallModeDecisionAsync, ax as resolveRecentThreadMemoryPaths, E as sanitizeSessionKeyForFilename, ay as shouldFilterLifecycleRecallCandidate, az as splitTurnsBySourceValidAt, aA as summarizeGraphShadowComparison, aB as targetSourceValidAtSortMs, aC as throwIfRecallAborted, aD as tokenizeRecallQuery, aE as utcDateKeysForLocalDay } from './orchestrator-Y9wyG4jK.js';
+export { Q as BulkImportBatchIngestResult, T as BulkImportBatchPartialFailureError, U as COMPACTION_SIGNAL_MAX_AGE_MS, V as DaySummaryGatherOptions, X as ExtractionRunResult, Y as GraphRecallRankedResult, Z as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, _ as QmdRecallSnapshot, $ as QueryAwarePrefilter, a0 as RecallInvocationOptions, a1 as RecallModeDecision, a2 as appendMemoryToGraphContext, a3 as applyQueryAwareCandidateFilter, a4 as blendGraphExpandedRecallScore, a5 as buildCompressionGuidelinesMarkdown, a6 as buildMemoryPathById, a7 as computeArtifactCandidateFetchLimit, a8 as computeArtifactRecallLimit, a9 as computeQmdHybridFetchLimit, t as defaultWorkspaceDir, aa as deriveTopicsFromExtraction, ab as filterHourlySummaryMarkdownForLocalDay, ac as filterRecallCandidates, ad as formatDateInTimeZone, ae as graphPathRelativeToStorage, af as hasIdentityRecoveryIntent, ag as isArtifactMemoryPath, ah as lifecycleRecallScoreAdjustment, ai as mapRecallSourceToXrayServedBy, aj as mergeArtifactRecallCandidates, ak as mergeGraphExpandedResults, al as normalizeIanaTimeZone, am as parseFiniteDate, an as parseGraphRecallRankedResults, ao as parseMemoryIntentSnapshot, ap as parseQmdRecallResults, aq as qmdStartupCollectionCheckWithTimeout, ar as raceRecallAbort, as as resolveEffectiveIdentityInjectionMode, at as resolveEffectiveRecallMode, au as resolvePersistedMemoryRelativePath, av as resolveRecallModeDecision, aw as resolveRecallModeDecisionAsync, ax as resolveRecentThreadMemoryPaths, E as sanitizeSessionKeyForFilename, ay as shouldFilterLifecycleRecallCandidate, az as splitTurnsBySourceValidAt, aA as summarizeGraphShadowComparison, aB as targetSourceValidAtSortMs, aC as throwIfRecallAborted, aD as tokenizeRecallQuery, aE as utcDateKeysForLocalDay } from './orchestrator-B2Y28Z9t.js';
 export { formatCompressionGuidelinesForRecall } from './orchestration/compression-guideline-coordinator.js';
 import './live-connectors-runner.js';
 import './model-registry.js';
@@ -22,10 +22,10 @@ import './semantic-DJR8_DMQ.js';
 import './replay/types.js';
 import './types-gb_SNtjR.js';
 import './lcm/engine.js';
-import './semantic-consolidation-bfXJNKVf.js';
+import './semantic-consolidation-BDVIbLRw.js';
 import './conversation-index/backend.js';
-import './catalog-bflYNWsM.js';
-import './types-D1iBqhJA.js';
+import './catalog-BxWokdC2.js';
+import './types-ljkd82rn.js';
 import './namespaces/search.js';
 import './shared-context/manager.js';
 import './compounding/engine.js';

package/dist/orchestrator.js

@@ -43,12 +43,12 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-XZJMIJLW.js";
-import "./chunk-64ZYXSCO.js";
+} from "./chunk-5QZDMSSN.js";
+import "./chunk-2U2A5HF4.js";
 import {
   formatCompressionGuidelinesForRecall
 } from "./chunk-BRDJ2HFP.js";
-import "./chunk-VBVSN2TV.js";
+import "./chunk-6ZIETXZ2.js";
 import "./chunk-I74SUMNI.js";
 import "./chunk-ILNPU5W5.js";
 import "./chunk-7HYPN2GC.js";
@@ -57,20 +57,21 @@ import "./chunk-KBL3JJR6.js";
 import "./chunk-ABP6QMVM.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-UWK5OXUJ.js";
-import "./chunk-FWPHPN3V.js";
-import "./chunk-42BBIR33.js";
+import "./chunk-CLX5VDNY.js";
+import "./chunk-KCYE2MZM.js";
+import "./chunk-7N2RUBAP.js";
 import "./chunk-MTR7BZQN.js";
 import "./chunk-O7BBFJLP.js";
 import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
-import "./chunk-KCYE2MZM.js";
 import "./chunk-CGS7UKWM.js";
 import "./chunk-V5OCT34X.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-RP7YXA67.js";
-import "./chunk-TH2KIPP7.js";
+import "./chunk-CZAA5N5S.js";
 import "./chunk-UI4FVU6T.js";
 import "./chunk-LXOM6IQU.js";
+import "./chunk-E2SPGGUI.js";
 import "./chunk-UHGBNIOS.js";
 import "./chunk-BCDKBDSY.js";
 import "./chunk-YN2UN7N3.js";
@@ -78,7 +79,6 @@ import "./chunk-4EX5WZ4M.js";
 import "./chunk-VOUOLGIP.js";
 import "./chunk-S75M5ZRK.js";
 import "./chunk-ECZU5BJH.js";
-import "./chunk-E2SPGGUI.js";
 import "./chunk-XZ5I7OZR.js";
 import "./chunk-3FAMU5TX.js";
 import "./chunk-4SBW47WK.js";
@@ -90,10 +90,10 @@ import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-2IZAGAJR.js";
 import "./chunk-E3VODCC3.js";
+import "./chunk-YDBIWGNI.js";
 import "./chunk-JZHHREBL.js";
 import "./chunk-E5BK6CGV.js";
 import "./chunk-ZZTOURJI.js";
-import "./chunk-YDBIWGNI.js";
 import "./chunk-3GPTTA4J.js";
 import "./chunk-IISBCCWR.js";
 import "./chunk-A3GOMRJG.js";
@@ -124,55 +124,55 @@ import "./chunk-VEWZZM3H.js";
 import "./chunk-Q6IP2ARR.js";
 import "./chunk-6HEM6HTQ.js";
 import "./chunk-O2EL7EGG.js";
-import "./chunk-YM7IEUO7.js";
-import "./chunk-UQI2NHTY.js";
+import "./chunk-ZPOROUTX.js";
+import "./chunk-7QWMTOIF.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
 import "./chunk-JJEJJ7RK.js";
+import "./chunk-PYHOAXTI.js";
 import "./chunk-UP6MOYCB.js";
-import "./chunk-7VFZTJ7K.js";
-import "./chunk-HDDRVXX4.js";
-import "./chunk-AGNBY3VG.js";
+import "./chunk-BV2TIZ4F.js";
 import "./chunk-Z734BLO3.js";
+import "./chunk-HDDRVXX4.js";
 import "./chunk-OZKVVUJB.js";
 import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2BFLDH5F.js";
 import "./chunk-765K3SAT.js";
+import "./chunk-HOJZMQ4J.js";
+import "./chunk-2PRQG7PV.js";
 import "./chunk-KQPJLK3X.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
-import "./chunk-HOJZMQ4J.js";
-import "./chunk-2PRQG7PV.js";
-import "./chunk-XOE5DYQL.js";
-import "./chunk-MWH5MAFP.js";
+import "./chunk-D6RIFG4O.js";
+import "./chunk-HRCACVHL.js";
+import "./chunk-6BISDEN6.js";
 import "./chunk-LZZNTPLR.js";
+import "./chunk-JCK7V6SN.js";
 import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
-import "./chunk-D6RIFG4O.js";
-import "./chunk-JCK7V6SN.js";
 import "./chunk-GQL52GQ5.js";
 import "./chunk-CKITWVWJ.js";
 import "./chunk-OUELRE5E.js";
-import "./chunk-H2EJNV2Z.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
+import "./chunk-66FLU5BT.js";
 import "./chunk-DBRYEIGY.js";
-import "./chunk-QGS7Z7YU.js";
-import "./chunk-ABGDGBDT.js";
-import "./chunk-OH6BKCPB.js";
+import "./chunk-OHDJ34CC.js";
+import "./chunk-YPEMNNNY.js";
+import "./chunk-TGQ2NTWH.js";
+import "./chunk-XN3TUUX2.js";
 import "./chunk-ZRWB5D4H.js";
 import "./chunk-5EZXHU36.js";
 import "./chunk-DANV2HTH.js";
-import "./chunk-TGQ2NTWH.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-33JBK2XP.js";
-import "./chunk-UAOZJX5J.js";
-import "./chunk-H5IT5JL7.js";
-import "./chunk-UQMCR5RW.js";
-import "./chunk-FT37KV7R.js";
+import "./chunk-P6SYWE4G.js";
+import "./chunk-LOR6ZM5R.js";
+import "./chunk-JLR3JSTL.js";
+import "./chunk-BGTAL46Y.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-CMTINOFS.js";
 import "./chunk-HL4DB7TO.js";
@@ -193,8 +193,8 @@ import "./chunk-Y4Z4I6WK.js";
 import "./chunk-LMDRGRJ2.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-3I4FUAVJ.js";
-import "./chunk-2TCZE3C2.js";
-import "./chunk-5H56JAHW.js";
+import "./chunk-EPGWWCZF.js";
+import "./chunk-KCJ5H6XQ.js";
 import "./chunk-QLULYKWZ.js";
 import "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
@@ -208,7 +208,7 @@ import "./chunk-UQ7RN5HK.js";
 import "./chunk-F53UF7CI.js";
 import "./chunk-H3FZVNRN.js";
 import "./chunk-PI23H7FV.js";
-import "./chunk-QICQ35K5.js";
+import "./chunk-7Z2DZNWN.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-G6NKALRN.js";
@@ -216,21 +216,21 @@ import "./chunk-OO42R444.js";
 import "./chunk-K6MV3TRQ.js";
 import "./chunk-LBJBNWS2.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-XXEOGY77.js";
-import "./chunk-7WV3F5DQ.js";
+import "./chunk-2FOD2YY3.js";
+import "./chunk-V7IZKJI3.js";
 import "./chunk-SEDEKFYQ.js";
-import "./chunk-AU7Q3LSC.js";
+import "./chunk-2QSZNTDO.js";
+import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
 import "./chunk-J64TK33U.js";
-import "./chunk-RSUYKGGZ.js";
 import "./chunk-7RXCMVFQ.js";
-import "./chunk-GEVIE5NV.js";
+import "./chunk-DR6PEJU3.js";
 import "./chunk-D24OXEPB.js";
 import "./chunk-5RUE3GHQ.js";
-import "./chunk-G47FEGGK.js";
-import "./chunk-6Y4JTNX7.js";
-import "./chunk-H25TAODC.js";
+import "./chunk-NG7YBCJO.js";
+import "./chunk-2MR3MFQB.js";
+import "./chunk-ILFJ7AVS.js";
 import "./chunk-YF6FMLBT.js";
 import "./chunk-HLTAPHZZ.js";
 import "./chunk-PRTA6444.js";
@@ -238,16 +238,16 @@ import "./chunk-KQDNAXOM.js";
 import "./chunk-35NN3ZFA.js";
 import "./chunk-FTYDWKO6.js";
 import "./chunk-T4WDJPEZ.js";
-import "./chunk-YPL66L3U.js";
-import "./chunk-IGF4DII6.js";
+import "./chunk-FZGGZAAU.js";
+import "./chunk-X4A62ET7.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-64SE4X5G.js";
 import "./chunk-M5QKGHCR.js";
+import "./chunk-64SE4X5G.js";
 import "./chunk-VQ7B2Q6M.js";
 import "./chunk-ERA5RSMZ.js";
 import "./chunk-JGSKJHF7.js";
-import "./chunk-LLMZK53N.js";
+import "./chunk-PUBTHW5O.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BT7NVCML.js";
@@ -259,24 +259,25 @@ import "./chunk-ICP53SKG.js";
 import "./chunk-AQEJKOKI.js";
 import "./chunk-6HMYUWXR.js";
 import "./chunk-BAVVI5GP.js";
-import "./chunk-4NMATTXV.js";
-import "./chunk-TKUQSXU4.js";
-import "./chunk-5K5VEDFY.js";
-import "./chunk-L4UZBJNM.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-7BAJAXGB.js";
+import "./chunk-4BFRBP45.js";
+import "./chunk-27FLVMDC.js";
 import "./chunk-ZIDSD6VC.js";
-import "./chunk-AER6MT24.js";
 import "./chunk-QWGNDWKB.js";
+import "./chunk-YDSWRD33.js";
+import "./chunk-4P4626RY.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-CZAZX7JP.js";
 import "./chunk-CINZGPSJ.js";
+import "./chunk-AER6MT24.js";
 import "./chunk-EGGE52UU.js";
-import "./chunk-KS4PRHRD.js";
-import "./chunk-JI5AVXYO.js";
+import "./chunk-IC6QX5TC.js";
+import "./chunk-AKUCU7CI.js";
+import "./chunk-FC77VUX5.js";
 import "./chunk-TN7THW5U.js";
 import "./chunk-R5VAVVHP.js";
-import "./chunk-FC77VUX5.js";
-import "./chunk-RBGL4MKQ.js";
+import "./chunk-3F4N4WDH.js";
 import "./chunk-WU46YPY6.js";
+import "./chunk-64UDOIMI.js";
 import "./chunk-EIR5VLIH.js";
 import "./chunk-HG32URJJ.js";
 import "./chunk-EI6V5UXY.js";
@@ -291,10 +292,10 @@ import "./chunk-OBMR4VIX.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-CXLNZXG5.js";
-import "./chunk-APMGGGTY.js";
-import "./chunk-VBBMTSOV.js";
-import "./chunk-L2B3EE7B.js";
+import "./chunk-DGYCWCQ7.js";
+import "./chunk-M7GGMGMZ.js";
 import "./chunk-M7XQSUBB.js";
+import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-EHK6KZHK.js";
@@ -308,8 +309,8 @@ import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-SXN3LCUT.js";
-import "./chunk-6KYMPV2O.js";
+import "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-MNUHL34L.js";
@@ -323,13 +324,13 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
-import "./chunk-OUXPVWTZ.js";
-import "./chunk-J4EB7DNW.js";
+import "./chunk-FLVL4L3L.js";
 import "./chunk-WEHSQBFR.js";
 import "./chunk-437S3G37.js";
 import "./chunk-GWTFLF2P.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
+import "./chunk-J4EB7DNW.js";
 import "./chunk-Z2YFLXHU.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/patterns-cli.d.ts

@@ -1,4 +1,4 @@
-import { h as MemoryCategory, M as MemoryFile } from './types-D1iBqhJA.js';
+import { h as MemoryCategory, M as MemoryFile } from './types-ljkd82rn.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/policy-runtime.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as BehaviorLoopPolicyState } from './types-D1iBqhJA.js';
+import { P as PluginConfig, g as BehaviorLoopPolicyState } from './types-ljkd82rn.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/provenance.d.ts

@@ -1,4 +1,4 @@
-import { J as ProvenanceSource, an as ProvenanceConfig, q as MemoryFrontmatter } from './types-D1iBqhJA.js';
+import { J as ProvenanceSource, am as ProvenanceConfig, q as MemoryFrontmatter } from './types-ljkd82rn.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/{purge-IHRX4Z7X.js → purge-NDWV6WYD.js}

@@ -1,7 +1,8 @@
 import {
   markProjectedMemoryPathInvalid
-} from "./chunk-SXN3LCUT.js";
-import "./chunk-6KYMPV2O.js";
+} from "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
+import "./chunk-37CTGERM.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/maintenance/purge.ts
@@ -208,4 +209,4 @@ async function purgeMemories(options) {
 export {
   purgeMemories
 };
-//# sourceMappingURL=purge-IHRX4Z7X.js.map
+//# sourceMappingURL=purge-NDWV6WYD.js.map

package/dist/{purge-IHRX4Z7X.js.map → purge-NDWV6WYD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/purge.ts"],"sourcesContent":["/**\n * Operator-facing bulk hard-delete (issue #686 retention-completion).\n *\n * `purgeMemories(opts)` hard-deletes memories that are:\n *   - older than `olderThanMs` (measured against `updated ?? created`), AND\n *   - in the specified tier (`\"cold\"` or `\"all\"`), AND\n *   - optionally in `status: \"forgotten\"` only (when `forgottenOnly` is true)\n *\n * Hard-delete means:\n *   1. Remove the file from disk.\n *   2. Trigger a QMD collection update so the index no longer contains it.\n *   3. Append a purge audit entry to the observation ledger.\n *\n * `dryRun: true` (the default) reports what *would* be deleted without\n * actually removing anything — callers must opt into mutations by\n * setting `dryRun: false`.\n *\n * The CLI surface enforces an explicit `--confirm yes` guard and\n * defaults to `--dry-run` to make accidental data loss impossible.\n */\n\nimport path from \"node:path\";\nimport { appendFile, mkdir, unlink } from \"node:fs/promises\";\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile } from \"../types.js\";\nimport { markProjectedMemoryPathInvalid } from \"../memory-projection-store.js\";\nimport type { SearchBackend } from \"../search/port.js\";\n\nexport type PurgeTierFilter = \"cold\" | \"all\";\n\nexport interface PurgeMemoriesOptions {\n  storage: StorageManager;\n  /**\n   * Only memories whose `updated ?? created` timestamp is older than this\n   * value (in milliseconds, Unix epoch) will be candidates.\n   */\n  olderThanMs: number;\n  /**\n   * `\"cold\"` — only memories in the cold tier (files under `.../cold/`).\n   * `\"all\"` — memories in any tier (hot, cold, or archived).\n   * Default: `\"cold\"`.\n   */\n  tier?: PurgeTierFilter;\n  /**\n   * When `true`, only memories with `status === \"forgotten\"` are candidates.\n   * Default: `false` (purge by age + tier regardless of status).\n   */\n  forgottenOnly?: boolean;\n  /** When `true` (default), report candidates but do not delete. */\n  dryRun?: boolean;\n  /**\n   * Optional QMD backend. When supplied and `dryRun === false`, a\n   * `updateCollection` call is issued after each deletion so the index stays\n   * consistent. Pass `undefined` or omit to skip index maintenance (e.g. in\n   * tests that don't have a live QMD instance).\n   */\n  qmd?: SearchBackend;\n  /** Hot-tier QMD collection name (default: `\"openclaw-engram\"`). */\n  hotCollection?: string;\n  /** Cold-tier QMD collection name (default: `\"openclaw-engram-cold\"`). */\n  coldCollection?: string;\n  /** Optional hook for long-lived hosts to clear their live dedupe mirror after purge hash cleanup. */\n  afterFactHashRemoval?: () => void | Promise<void>;\n  /** Optional shutdown signal forwarded to QMD collection refreshes. */\n  signal?: AbortSignal;\n  /** Override clock for tests. */\n  now?: () => Date;\n}\n\nexport interface PurgeCandidate {\n  id: string;\n  path: string;\n  tier: \"hot\" | \"cold\" | \"archive\";\n  status: string;\n  updatedOrCreated: string;\n  ageMs: number;\n}\n\nexport interface PurgeMemoriesResult {\n  dryRun: boolean;\n  tier: PurgeTierFilter;\n  olderThanMs: number;\n  candidates: PurgeCandidate[];\n  purgedCount: number;\n  alreadyAbsentCount: number;\n  errorCount: number;\n  errors: Array<{ id: string; path: string; error: string }>;\n}\n\nfunction hasErrorCode(err: unknown, code: string): boolean {\n  return typeof err === \"object\" && err !== null && \"code\" in err && (err as { code?: unknown }).code === code;\n}\n\nfunction resolveTimestamp(memory: MemoryFile): string {\n  const fm = memory.frontmatter as unknown as Record<string, unknown>;\n  const updated = typeof fm.updated === \"string\" ? (fm.updated as string) : \"\";\n  const created = typeof fm.created === \"string\" ? (fm.created as string) : \"\";\n  return updated.length > 0 ? updated : created;\n}\n\nasync function logPurgeAudit(\n  storage: StorageManager,\n  candidates: PurgeCandidate[],\n  now: Date,\n  event: \"PURGE_DELETE_INTENT\" | \"PURGE_HARD_DELETE\" | \"PURGE_ALREADY_ABSENT\" = \"PURGE_HARD_DELETE\",\n): Promise<void> {\n  if (candidates.length === 0) return;\n  const ledgerDir = path.join(storage.dir, \"state\", \"observation-ledger\");\n  await mkdir(ledgerDir, { recursive: true });\n  const ledgerPath = path.join(ledgerDir, \"purge-audit.jsonl\");\n  const entries = candidates.map((c) =>\n    JSON.stringify({\n      event,\n      timestamp: now.toISOString(),\n      memoryId: c.id,\n      path: c.path,\n      tier: c.tier,\n      status: c.status,\n      updatedOrCreated: c.updatedOrCreated,\n    }),\n  );\n  if (entries.length > 0) {\n    await appendFile(ledgerPath, `${entries.join(\"\\n\")}\\n`, \"utf-8\");\n  }\n}\n\nexport async function purgeMemories(\n  options: PurgeMemoriesOptions,\n): Promise<PurgeMemoriesResult> {\n  const {\n    storage,\n    olderThanMs,\n    tier = \"cold\",\n    forgottenOnly = false,\n    dryRun = true,\n    qmd,\n    hotCollection = \"openclaw-engram\",\n    coldCollection = \"openclaw-engram-cold\",\n  } = options;\n\n  if (!Number.isFinite(olderThanMs) || olderThanMs <= 0) {\n    throw new Error(\"olderThanMs must be a finite positive number\");\n  }\n\n  const now = (options.now ?? (() => new Date()))();\n  const nowMs = now.getTime();\n\n  // Collect all memories from applicable tiers\n  const [hotMemories, coldMemories, archivedMemories] = await Promise.all([\n    tier === \"all\" ? storage.readAllMemories() : Promise.resolve([]),\n    storage.readAllColdMemories(),\n    tier === \"all\" ? storage.readArchivedMemories() : Promise.resolve([]),\n  ]);\n\n  const poolEntries: Array<{ memory: MemoryFile; resolvedTier: \"hot\" | \"cold\" | \"archive\" }> = [];\n\n  if (tier === \"all\") {\n    for (const m of hotMemories) {\n      poolEntries.push({ memory: m, resolvedTier: \"hot\" });\n    }\n    for (const m of archivedMemories) {\n      poolEntries.push({ memory: m, resolvedTier: \"archive\" });\n    }\n  }\n  for (const m of coldMemories) {\n    poolEntries.push({ memory: m, resolvedTier: \"cold\" });\n  }\n\n  // Build candidate list\n  const candidates: PurgeCandidate[] = [];\n  const candidateMemoriesById = new Map<string, MemoryFile>();\n  for (const { memory, resolvedTier } of poolEntries) {\n    const ts = resolveTimestamp(memory);\n    if (ts.length === 0) continue;\n\n    const tsMs = Date.parse(ts);\n    if (!Number.isFinite(tsMs)) continue;\n\n    const ageMs = nowMs - tsMs;\n    if (ageMs < olderThanMs) continue;\n\n    const fm = memory.frontmatter as unknown as Record<string, unknown>;\n    const status: string =\n      typeof fm.status === \"string\" ? (fm.status as string) : \"active\";\n\n    if (forgottenOnly && status !== \"forgotten\") continue;\n\n    candidates.push({\n      id: memory.frontmatter.id,\n      path: memory.path,\n      tier: resolvedTier,\n      status,\n      updatedOrCreated: ts,\n      ageMs,\n    });\n    candidateMemoriesById.set(memory.frontmatter.id, memory);\n  }\n\n  if (dryRun) {\n    return {\n      dryRun: true,\n      tier,\n      olderThanMs,\n      candidates,\n      purgedCount: 0,\n      alreadyAbsentCount: 0,\n      errorCount: 0,\n      errors: [],\n    };\n  }\n\n  // Hard-delete phase\n  const errors: Array<{ id: string; path: string; error: string }> = [];\n  try {\n    await logPurgeAudit(storage, candidates, now, \"PURGE_DELETE_INTENT\");\n  } catch (auditErr) {\n    errors.push({\n      id: \"(purge-audit)\",\n      path: path.join(storage.dir, \"state\", \"observation-ledger\", \"purge-audit.jsonl\"),\n      error: auditErr instanceof Error ? auditErr.message : String(auditErr),\n    });\n  }\n\n  const actuallyPurged: PurgeCandidate[] = [];\n  const alreadyAbsent: PurgeCandidate[] = [];\n  const collectionsToUpdate = new Set<string>();\n  const addCollectionForCandidate = (candidate: PurgeCandidate) => {\n    if (candidate.tier === \"cold\") {\n      collectionsToUpdate.add(coldCollection);\n    } else if (candidate.tier === \"hot\") {\n      collectionsToUpdate.add(hotCollection);\n    }\n  };\n\n  for (const candidate of candidates) {\n    try {\n      await unlink(candidate.path);\n      actuallyPurged.push(candidate);\n      addCollectionForCandidate(candidate);\n      markProjectedMemoryPathInvalid(storage.dir, candidate.id);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      // ENOENT is fine — already gone\n      if (hasErrorCode(err, \"ENOENT\")) {\n        alreadyAbsent.push(candidate);\n        addCollectionForCandidate(candidate);\n        markProjectedMemoryPathInvalid(storage.dir, candidate.id);\n      } else {\n        errors.push({ id: candidate.id, path: candidate.path, error: message });\n      }\n    }\n  }\n\n  const recordPostDeleteAudit = async (\n    purgedCandidates: PurgeCandidate[],\n    event: \"PURGE_HARD_DELETE\" | \"PURGE_ALREADY_ABSENT\",\n  ) => {\n    try {\n      await logPurgeAudit(storage, purgedCandidates, now, event);\n    } catch (auditErr) {\n      errors.push({\n        id: \"(purge-audit)\",\n        path: path.join(storage.dir, \"state\", \"observation-ledger\", \"purge-audit.jsonl\"),\n        error: auditErr instanceof Error ? auditErr.message : String(auditErr),\n      });\n    }\n  };\n  await recordPostDeleteAudit(actuallyPurged, \"PURGE_HARD_DELETE\");\n  await recordPostDeleteAudit(alreadyAbsent, \"PURGE_ALREADY_ABSENT\");\n\n  const resolvedPurges = [...actuallyPurged, ...alreadyAbsent];\n\n  const invalidateTierCaches = (\n    storage as unknown as {\n      invalidateMemoryCachesForTiers?: (tiers: Iterable<\"hot\" | \"cold\" | \"archive\">) => void;\n    }\n  ).invalidateMemoryCachesForTiers;\n  if (typeof invalidateTierCaches === \"function\") {\n    invalidateTierCaches.call(storage, new Set(resolvedPurges.map((candidate) => candidate.tier)));\n  } else if (typeof (storage as unknown as { invalidateAllMemoriesCacheForDir?: () => void }).invalidateAllMemoriesCacheForDir === \"function\") {\n    (storage as unknown as { invalidateAllMemoriesCacheForDir: () => void }).invalidateAllMemoriesCacheForDir();\n  }\n\n  // Update QMD index for affected collections\n  if (qmd) {\n    for (const collection of collectionsToUpdate) {\n      try {\n        if (typeof qmd.updateCollectionStrict === \"function\") {\n          await qmd.updateCollectionStrict(collection, { signal: options.signal });\n        } else {\n          await qmd.updateCollection(collection, { signal: options.signal });\n        }\n      } catch (indexErr) {\n        // Non-fatal — operator can re-index manually\n        errors.push({\n          id: \"(qmd-update)\",\n          path: collection,\n          error: indexErr instanceof Error ? indexErr.message : String(indexErr),\n        });\n      }\n    }\n  }\n\n  const purgedFactMemories = resolvedPurges\n    .map((candidate) => candidateMemoriesById.get(candidate.id))\n    .filter((memory): memory is MemoryFile => memory?.frontmatter.category === \"fact\");\n  if (purgedFactMemories.length > 0) {\n    const removeFactHashes = (\n      storage as unknown as {\n        removeFactContentHashesForMemories?: (memories: MemoryFile[]) => Promise<void>;\n      }\n    ).removeFactContentHashesForMemories;\n    if (typeof removeFactHashes === \"function\") {\n      try {\n        await removeFactHashes.call(storage, purgedFactMemories);\n        await options.afterFactHashRemoval?.();\n      } catch (hashErr) {\n        errors.push({\n          id: \"(fact-hash-index)\",\n          path: path.join(storage.dir, \"state\", \"fact-hashes.txt\"),\n          error: hashErr instanceof Error ? hashErr.message : String(hashErr),\n        });\n      }\n    }\n  }\n\n  return {\n    dryRun: false,\n    tier,\n    olderThanMs,\n    candidates,\n    purgedCount: actuallyPurged.length,\n    alreadyAbsentCount: alreadyAbsent.length,\n    errorCount: errors.length,\n    errors,\n  };\n}\n"],"mappings":";;;;;;;AAqBA,OAAO,UAAU;AACjB,SAAS,YAAY,OAAO,cAAc;AAmE1C,SAAS,aAAa,KAAc,MAAuB;AACzD,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,UAAU,OAAQ,IAA2B,SAAS;AAC1G;AAEA,SAAS,iBAAiB,QAA4B;AACpD,QAAM,KAAK,OAAO;AAClB,QAAM,UAAU,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAC1E,QAAM,UAAU,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAC1E,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,eAAe,cACb,SACA,YACA,KACA,QAA8E,qBAC/D;AACf,MAAI,WAAW,WAAW,EAAG;AAC7B,QAAM,YAAY,KAAK,KAAK,QAAQ,KAAK,SAAS,oBAAoB;AACtE,QAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,QAAM,aAAa,KAAK,KAAK,WAAW,mBAAmB;AAC3D,QAAM,UAAU,WAAW;AAAA,IAAI,CAAC,MAC9B,KAAK,UAAU;AAAA,MACb;AAAA,MACA,WAAW,IAAI,YAAY;AAAA,MAC3B,UAAU,EAAE;AAAA,MACZ,MAAM,EAAE;AAAA,MACR,MAAM,EAAE;AAAA,MACR,QAAQ,EAAE;AAAA,MACV,kBAAkB,EAAE;AAAA,IACtB,CAAC;AAAA,EACH;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,UAAM,WAAW,YAAY,GAAG,QAAQ,KAAK,IAAI,CAAC;AAAA,GAAM,OAAO;AAAA,EACjE;AACF;AAEA,eAAsB,cACpB,SAC8B;AAC9B,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP,gBAAgB;AAAA,IAChB,SAAS;AAAA,IACT;AAAA,IACA,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,EACnB,IAAI;AAEJ,MAAI,CAAC,OAAO,SAAS,WAAW,KAAK,eAAe,GAAG;AACrD,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,QAAQ,IAAI,QAAQ;AAG1B,QAAM,CAAC,aAAa,cAAc,gBAAgB,IAAI,MAAM,QAAQ,IAAI;AAAA,IACtE,SAAS,QAAQ,QAAQ,gBAAgB,IAAI,QAAQ,QAAQ,CAAC,CAAC;AAAA,IAC/D,QAAQ,oBAAoB;AAAA,IAC5B,SAAS,QAAQ,QAAQ,qBAAqB,IAAI,QAAQ,QAAQ,CAAC,CAAC;AAAA,EACtE,CAAC;AAED,QAAM,cAAuF,CAAC;AAE9F,MAAI,SAAS,OAAO;AAClB,eAAW,KAAK,aAAa;AAC3B,kBAAY,KAAK,EAAE,QAAQ,GAAG,cAAc,MAAM,CAAC;AAAA,IACrD;AACA,eAAW,KAAK,kBAAkB;AAChC,kBAAY,KAAK,EAAE,QAAQ,GAAG,cAAc,UAAU,CAAC;AAAA,IACzD;AAAA,EACF;AACA,aAAW,KAAK,cAAc;AAC5B,gBAAY,KAAK,EAAE,QAAQ,GAAG,cAAc,OAAO,CAAC;AAAA,EACtD;AAGA,QAAM,aAA+B,CAAC;AACtC,QAAM,wBAAwB,oBAAI,IAAwB;AAC1D,aAAW,EAAE,QAAQ,aAAa,KAAK,aAAa;AAClD,UAAM,KAAK,iBAAiB,MAAM;AAClC,QAAI,GAAG,WAAW,EAAG;AAErB,UAAM,OAAO,KAAK,MAAM,EAAE;AAC1B,QAAI,CAAC,OAAO,SAAS,IAAI,EAAG;AAE5B,UAAM,QAAQ,QAAQ;AACtB,QAAI,QAAQ,YAAa;AAEzB,UAAM,KAAK,OAAO;AAClB,UAAM,SACJ,OAAO,GAAG,WAAW,WAAY,GAAG,SAAoB;AAE1D,QAAI,iBAAiB,WAAW,YAAa;AAE7C,eAAW,KAAK;AAAA,MACd,IAAI,OAAO,YAAY;AAAA,MACvB,MAAM,OAAO;AAAA,MACb,MAAM;AAAA,MACN;AAAA,MACA,kBAAkB;AAAA,MAClB;AAAA,IACF,CAAC;AACD,0BAAsB,IAAI,OAAO,YAAY,IAAI,MAAM;AAAA,EACzD;AAEA,MAAI,QAAQ;AACV,WAAO;AAAA,MACL,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa;AAAA,MACb,oBAAoB;AAAA,MACpB,YAAY;AAAA,MACZ,QAAQ,CAAC;AAAA,IACX;AAAA,EACF;AAGA,QAAM,SAA6D,CAAC;AACpE,MAAI;AACF,UAAM,cAAc,SAAS,YAAY,KAAK,qBAAqB;AAAA,EACrE,SAAS,UAAU;AACjB,WAAO,KAAK;AAAA,MACV,IAAI;AAAA,MACJ,MAAM,KAAK,KAAK,QAAQ,KAAK,SAAS,sBAAsB,mBAAmB;AAAA,MAC/E,OAAO,oBAAoB,QAAQ,SAAS,UAAU,OAAO,QAAQ;AAAA,IACvE,CAAC;AAAA,EACH;AAEA,QAAM,iBAAmC,CAAC;AAC1C,QAAM,gBAAkC,CAAC;AACzC,QAAM,sBAAsB,oBAAI,IAAY;AAC5C,QAAM,4BAA4B,CAAC,cAA8B;AAC/D,QAAI,UAAU,SAAS,QAAQ;AAC7B,0BAAoB,IAAI,cAAc;AAAA,IACxC,WAAW,UAAU,SAAS,OAAO;AACnC,0BAAoB,IAAI,aAAa;AAAA,IACvC;AAAA,EACF;AAEA,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,OAAO,UAAU,IAAI;AAC3B,qBAAe,KAAK,SAAS;AAC7B,gCAA0B,SAAS;AACnC,qCAA+B,QAAQ,KAAK,UAAU,EAAE;AAAA,IAC1D,SAAS,KAAK;AACZ,YAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAE/D,UAAI,aAAa,KAAK,QAAQ,GAAG;AAC/B,sBAAc,KAAK,SAAS;AAC5B,kCAA0B,SAAS;AACnC,uCAA+B,QAAQ,KAAK,UAAU,EAAE;AAAA,MAC1D,OAAO;AACL,eAAO,KAAK,EAAE,IAAI,UAAU,IAAI,MAAM,UAAU,MAAM,OAAO,QAAQ,CAAC;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,QAAM,wBAAwB,OAC5B,kBACA,UACG;AACH,QAAI;AACF,YAAM,cAAc,SAAS,kBAAkB,KAAK,KAAK;AAAA,IAC3D,SAAS,UAAU;AACjB,aAAO,KAAK;AAAA,QACV,IAAI;AAAA,QACJ,MAAM,KAAK,KAAK,QAAQ,KAAK,SAAS,sBAAsB,mBAAmB;AAAA,QAC/E,OAAO,oBAAoB,QAAQ,SAAS,UAAU,OAAO,QAAQ;AAAA,MACvE,CAAC;AAAA,IACH;AAAA,EACF;AACA,QAAM,sBAAsB,gBAAgB,mBAAmB;AAC/D,QAAM,sBAAsB,eAAe,sBAAsB;AAEjE,QAAM,iBAAiB,CAAC,GAAG,gBAAgB,GAAG,aAAa;AAE3D,QAAM,uBACJ,QAGA;AACF,MAAI,OAAO,yBAAyB,YAAY;AAC9C,yBAAqB,KAAK,SAAS,IAAI,IAAI,eAAe,IAAI,CAAC,cAAc,UAAU,IAAI,CAAC,CAAC;AAAA,EAC/F,WAAW,OAAQ,QAAyE,qCAAqC,YAAY;AAC3I,IAAC,QAAwE,iCAAiC;AAAA,EAC5G;AAGA,MAAI,KAAK;AACP,eAAW,cAAc,qBAAqB;AAC5C,UAAI;AACF,YAAI,OAAO,IAAI,2BAA2B,YAAY;AACpD,gBAAM,IAAI,uBAAuB,YAAY,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAAA,QACzE,OAAO;AACL,gBAAM,IAAI,iBAAiB,YAAY,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAAA,QACnE;AAAA,MACF,SAAS,UAAU;AAEjB,eAAO,KAAK;AAAA,UACV,IAAI;AAAA,UACJ,MAAM;AAAA,UACN,OAAO,oBAAoB,QAAQ,SAAS,UAAU,OAAO,QAAQ;AAAA,QACvE,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,QAAM,qBAAqB,eACxB,IAAI,CAAC,cAAc,sBAAsB,IAAI,UAAU,EAAE,CAAC,EAC1D,OAAO,CAAC,WAAiC,QAAQ,YAAY,aAAa,MAAM;AACnF,MAAI,mBAAmB,SAAS,GAAG;AACjC,UAAM,mBACJ,QAGA;AACF,QAAI,OAAO,qBAAqB,YAAY;AAC1C,UAAI;AACF,cAAM,iBAAiB,KAAK,SAAS,kBAAkB;AACvD,cAAM,QAAQ,uBAAuB;AAAA,MACvC,SAAS,SAAS;AAChB,eAAO,KAAK;AAAA,UACV,IAAI;AAAA,UACJ,MAAM,KAAK,KAAK,QAAQ,KAAK,SAAS,iBAAiB;AAAA,UACvD,OAAO,mBAAmB,QAAQ,QAAQ,UAAU,OAAO,OAAO;AAAA,QACpE,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,eAAe;AAAA,IAC5B,oBAAoB,cAAc;AAAA,IAClC,YAAY,OAAO;AAAA,IACnB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/maintenance/purge.ts"],"sourcesContent":["/**\n * Operator-facing bulk hard-delete (issue #686 retention-completion).\n *\n * `purgeMemories(opts)` hard-deletes memories that are:\n *   - older than `olderThanMs` (measured against `updated ?? created`), AND\n *   - in the specified tier (`\"cold\"` or `\"all\"`), AND\n *   - optionally in `status: \"forgotten\"` only (when `forgottenOnly` is true)\n *\n * Hard-delete means:\n *   1. Remove the file from disk.\n *   2. Trigger a QMD collection update so the index no longer contains it.\n *   3. Append a purge audit entry to the observation ledger.\n *\n * `dryRun: true` (the default) reports what *would* be deleted without\n * actually removing anything — callers must opt into mutations by\n * setting `dryRun: false`.\n *\n * The CLI surface enforces an explicit `--confirm yes` guard and\n * defaults to `--dry-run` to make accidental data loss impossible.\n */\n\nimport path from \"node:path\";\nimport { appendFile, mkdir, unlink } from \"node:fs/promises\";\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile } from \"../types.js\";\nimport { markProjectedMemoryPathInvalid } from \"../memory-projection-store.js\";\nimport type { SearchBackend } from \"../search/port.js\";\n\nexport type PurgeTierFilter = \"cold\" | \"all\";\n\nexport interface PurgeMemoriesOptions {\n  storage: StorageManager;\n  /**\n   * Only memories whose `updated ?? created` timestamp is older than this\n   * value (in milliseconds, Unix epoch) will be candidates.\n   */\n  olderThanMs: number;\n  /**\n   * `\"cold\"` — only memories in the cold tier (files under `.../cold/`).\n   * `\"all\"` — memories in any tier (hot, cold, or archived).\n   * Default: `\"cold\"`.\n   */\n  tier?: PurgeTierFilter;\n  /**\n   * When `true`, only memories with `status === \"forgotten\"` are candidates.\n   * Default: `false` (purge by age + tier regardless of status).\n   */\n  forgottenOnly?: boolean;\n  /** When `true` (default), report candidates but do not delete. */\n  dryRun?: boolean;\n  /**\n   * Optional QMD backend. When supplied and `dryRun === false`, a\n   * `updateCollection` call is issued after each deletion so the index stays\n   * consistent. Pass `undefined` or omit to skip index maintenance (e.g. in\n   * tests that don't have a live QMD instance).\n   */\n  qmd?: SearchBackend;\n  /** Hot-tier QMD collection name (default: `\"openclaw-engram\"`). */\n  hotCollection?: string;\n  /** Cold-tier QMD collection name (default: `\"openclaw-engram-cold\"`). */\n  coldCollection?: string;\n  /** Optional hook for long-lived hosts to clear their live dedupe mirror after purge hash cleanup. */\n  afterFactHashRemoval?: () => void | Promise<void>;\n  /** Optional shutdown signal forwarded to QMD collection refreshes. */\n  signal?: AbortSignal;\n  /** Override clock for tests. */\n  now?: () => Date;\n}\n\nexport interface PurgeCandidate {\n  id: string;\n  path: string;\n  tier: \"hot\" | \"cold\" | \"archive\";\n  status: string;\n  updatedOrCreated: string;\n  ageMs: number;\n}\n\nexport interface PurgeMemoriesResult {\n  dryRun: boolean;\n  tier: PurgeTierFilter;\n  olderThanMs: number;\n  candidates: PurgeCandidate[];\n  purgedCount: number;\n  alreadyAbsentCount: number;\n  errorCount: number;\n  errors: Array<{ id: string; path: string; error: string }>;\n}\n\nfunction hasErrorCode(err: unknown, code: string): boolean {\n  return typeof err === \"object\" && err !== null && \"code\" in err && (err as { code?: unknown }).code === code;\n}\n\nfunction resolveTimestamp(memory: MemoryFile): string {\n  const fm = memory.frontmatter as unknown as Record<string, unknown>;\n  const updated = typeof fm.updated === \"string\" ? (fm.updated as string) : \"\";\n  const created = typeof fm.created === \"string\" ? (fm.created as string) : \"\";\n  return updated.length > 0 ? updated : created;\n}\n\nasync function logPurgeAudit(\n  storage: StorageManager,\n  candidates: PurgeCandidate[],\n  now: Date,\n  event: \"PURGE_DELETE_INTENT\" | \"PURGE_HARD_DELETE\" | \"PURGE_ALREADY_ABSENT\" = \"PURGE_HARD_DELETE\",\n): Promise<void> {\n  if (candidates.length === 0) return;\n  const ledgerDir = path.join(storage.dir, \"state\", \"observation-ledger\");\n  await mkdir(ledgerDir, { recursive: true });\n  const ledgerPath = path.join(ledgerDir, \"purge-audit.jsonl\");\n  const entries = candidates.map((c) =>\n    JSON.stringify({\n      event,\n      timestamp: now.toISOString(),\n      memoryId: c.id,\n      path: c.path,\n      tier: c.tier,\n      status: c.status,\n      updatedOrCreated: c.updatedOrCreated,\n    }),\n  );\n  if (entries.length > 0) {\n    await appendFile(ledgerPath, `${entries.join(\"\\n\")}\\n`, \"utf-8\");\n  }\n}\n\nexport async function purgeMemories(\n  options: PurgeMemoriesOptions,\n): Promise<PurgeMemoriesResult> {\n  const {\n    storage,\n    olderThanMs,\n    tier = \"cold\",\n    forgottenOnly = false,\n    dryRun = true,\n    qmd,\n    hotCollection = \"openclaw-engram\",\n    coldCollection = \"openclaw-engram-cold\",\n  } = options;\n\n  if (!Number.isFinite(olderThanMs) || olderThanMs <= 0) {\n    throw new Error(\"olderThanMs must be a finite positive number\");\n  }\n\n  const now = (options.now ?? (() => new Date()))();\n  const nowMs = now.getTime();\n\n  // Collect all memories from applicable tiers\n  const [hotMemories, coldMemories, archivedMemories] = await Promise.all([\n    tier === \"all\" ? storage.readAllMemories() : Promise.resolve([]),\n    storage.readAllColdMemories(),\n    tier === \"all\" ? storage.readArchivedMemories() : Promise.resolve([]),\n  ]);\n\n  const poolEntries: Array<{ memory: MemoryFile; resolvedTier: \"hot\" | \"cold\" | \"archive\" }> = [];\n\n  if (tier === \"all\") {\n    for (const m of hotMemories) {\n      poolEntries.push({ memory: m, resolvedTier: \"hot\" });\n    }\n    for (const m of archivedMemories) {\n      poolEntries.push({ memory: m, resolvedTier: \"archive\" });\n    }\n  }\n  for (const m of coldMemories) {\n    poolEntries.push({ memory: m, resolvedTier: \"cold\" });\n  }\n\n  // Build candidate list\n  const candidates: PurgeCandidate[] = [];\n  const candidateMemoriesById = new Map<string, MemoryFile>();\n  for (const { memory, resolvedTier } of poolEntries) {\n    const ts = resolveTimestamp(memory);\n    if (ts.length === 0) continue;\n\n    const tsMs = Date.parse(ts);\n    if (!Number.isFinite(tsMs)) continue;\n\n    const ageMs = nowMs - tsMs;\n    if (ageMs < olderThanMs) continue;\n\n    const fm = memory.frontmatter as unknown as Record<string, unknown>;\n    const status: string =\n      typeof fm.status === \"string\" ? (fm.status as string) : \"active\";\n\n    if (forgottenOnly && status !== \"forgotten\") continue;\n\n    candidates.push({\n      id: memory.frontmatter.id,\n      path: memory.path,\n      tier: resolvedTier,\n      status,\n      updatedOrCreated: ts,\n      ageMs,\n    });\n    candidateMemoriesById.set(memory.frontmatter.id, memory);\n  }\n\n  if (dryRun) {\n    return {\n      dryRun: true,\n      tier,\n      olderThanMs,\n      candidates,\n      purgedCount: 0,\n      alreadyAbsentCount: 0,\n      errorCount: 0,\n      errors: [],\n    };\n  }\n\n  // Hard-delete phase\n  const errors: Array<{ id: string; path: string; error: string }> = [];\n  try {\n    await logPurgeAudit(storage, candidates, now, \"PURGE_DELETE_INTENT\");\n  } catch (auditErr) {\n    errors.push({\n      id: \"(purge-audit)\",\n      path: path.join(storage.dir, \"state\", \"observation-ledger\", \"purge-audit.jsonl\"),\n      error: auditErr instanceof Error ? auditErr.message : String(auditErr),\n    });\n  }\n\n  const actuallyPurged: PurgeCandidate[] = [];\n  const alreadyAbsent: PurgeCandidate[] = [];\n  const collectionsToUpdate = new Set<string>();\n  const addCollectionForCandidate = (candidate: PurgeCandidate) => {\n    if (candidate.tier === \"cold\") {\n      collectionsToUpdate.add(coldCollection);\n    } else if (candidate.tier === \"hot\") {\n      collectionsToUpdate.add(hotCollection);\n    }\n  };\n\n  for (const candidate of candidates) {\n    try {\n      await unlink(candidate.path);\n      actuallyPurged.push(candidate);\n      addCollectionForCandidate(candidate);\n      markProjectedMemoryPathInvalid(storage.dir, candidate.id);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      // ENOENT is fine — already gone\n      if (hasErrorCode(err, \"ENOENT\")) {\n        alreadyAbsent.push(candidate);\n        addCollectionForCandidate(candidate);\n        markProjectedMemoryPathInvalid(storage.dir, candidate.id);\n      } else {\n        errors.push({ id: candidate.id, path: candidate.path, error: message });\n      }\n    }\n  }\n\n  const recordPostDeleteAudit = async (\n    purgedCandidates: PurgeCandidate[],\n    event: \"PURGE_HARD_DELETE\" | \"PURGE_ALREADY_ABSENT\",\n  ) => {\n    try {\n      await logPurgeAudit(storage, purgedCandidates, now, event);\n    } catch (auditErr) {\n      errors.push({\n        id: \"(purge-audit)\",\n        path: path.join(storage.dir, \"state\", \"observation-ledger\", \"purge-audit.jsonl\"),\n        error: auditErr instanceof Error ? auditErr.message : String(auditErr),\n      });\n    }\n  };\n  await recordPostDeleteAudit(actuallyPurged, \"PURGE_HARD_DELETE\");\n  await recordPostDeleteAudit(alreadyAbsent, \"PURGE_ALREADY_ABSENT\");\n\n  const resolvedPurges = [...actuallyPurged, ...alreadyAbsent];\n\n  const invalidateTierCaches = (\n    storage as unknown as {\n      invalidateMemoryCachesForTiers?: (tiers: Iterable<\"hot\" | \"cold\" | \"archive\">) => void;\n    }\n  ).invalidateMemoryCachesForTiers;\n  if (typeof invalidateTierCaches === \"function\") {\n    invalidateTierCaches.call(storage, new Set(resolvedPurges.map((candidate) => candidate.tier)));\n  } else if (typeof (storage as unknown as { invalidateAllMemoriesCacheForDir?: () => void }).invalidateAllMemoriesCacheForDir === \"function\") {\n    (storage as unknown as { invalidateAllMemoriesCacheForDir: () => void }).invalidateAllMemoriesCacheForDir();\n  }\n\n  // Update QMD index for affected collections\n  if (qmd) {\n    for (const collection of collectionsToUpdate) {\n      try {\n        if (typeof qmd.updateCollectionStrict === \"function\") {\n          await qmd.updateCollectionStrict(collection, { signal: options.signal });\n        } else {\n          await qmd.updateCollection(collection, { signal: options.signal });\n        }\n      } catch (indexErr) {\n        // Non-fatal — operator can re-index manually\n        errors.push({\n          id: \"(qmd-update)\",\n          path: collection,\n          error: indexErr instanceof Error ? indexErr.message : String(indexErr),\n        });\n      }\n    }\n  }\n\n  const purgedFactMemories = resolvedPurges\n    .map((candidate) => candidateMemoriesById.get(candidate.id))\n    .filter((memory): memory is MemoryFile => memory?.frontmatter.category === \"fact\");\n  if (purgedFactMemories.length > 0) {\n    const removeFactHashes = (\n      storage as unknown as {\n        removeFactContentHashesForMemories?: (memories: MemoryFile[]) => Promise<void>;\n      }\n    ).removeFactContentHashesForMemories;\n    if (typeof removeFactHashes === \"function\") {\n      try {\n        await removeFactHashes.call(storage, purgedFactMemories);\n        await options.afterFactHashRemoval?.();\n      } catch (hashErr) {\n        errors.push({\n          id: \"(fact-hash-index)\",\n          path: path.join(storage.dir, \"state\", \"fact-hashes.txt\"),\n          error: hashErr instanceof Error ? hashErr.message : String(hashErr),\n        });\n      }\n    }\n  }\n\n  return {\n    dryRun: false,\n    tier,\n    olderThanMs,\n    candidates,\n    purgedCount: actuallyPurged.length,\n    alreadyAbsentCount: alreadyAbsent.length,\n    errorCount: errors.length,\n    errors,\n  };\n}\n"],"mappings":"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","names":[]}