Module memory_lifecycle 

Memory Lifecycle Management — consolidation, decay, compaction, archival.

Runs automatically on knowledge stores to keep memory healthy:

• Confidence decay over time
• Semantic consolidation of similar facts
• Compaction when limits are exceeded
• Archival of old/unused facts

Structs

ClusterCompactionConfig

Guardrails for cluster compaction (#971). See crate::core::memory_policy::CompactionPolicy for field meanings.

LifecycleConfig

LifecycleReport

Enums

ForgettingModel

Which forgetting curve drives confidence decay (#1).

Constants

DEFAULT_BASE_STABILITY_DAYS

Default characteristic memory stability (days) for the Ebbinghaus curve.

DEFAULT_RECLAIM_HEADROOM_PCT

Default proactive headroom on a capacity reclaim: settle a full store at 75% so it keeps real working room instead of churning at its cap.

Functions

apply_confidence_decay

archive_facts

Archive evicted facts (lossless). Facts keep the legacy global archive root for backward compatibility; the generic multi-store archive lives in crate::core::memory_archive.

compact

compact_clusters

Collapse clusters of low-value, mutually-similar, same-category facts into one recoverable digest each. Returns (clusters_collapsed, archived_originals); the caller archives the originals so the operation is lossless. Deterministic: candidates are scanned in the store’s existing order and similarity ties resolve to the earliest-founded cluster.

consolidate_similar

list_archives

All facts archive files, sorted ascending (chronological).

reachable_archives

The newest reachable facts archives for the recall-miss rehydrate path — bounded by ArchiveConfig::rehydrate_reach so every retained archive is reachable (closes the pre-#995 retained-vs-reachable gap).

restore_archive

Restore the facts from a single archive file (legacy facts key supported).

run_lifecycle