Heat bands
Every memory has a heat score (0-100) that decays over time since last access:
Heat is computed using a decay function inspired by the Ebbinghaus forgetting curve — rapid initial decay that slows over time.
Forgetting risk
Whenforget or consolidate runs, each memory gets a forgetting risk score:
Risk thresholds
What’s always protected
Some memories never decay, regardless of heat or age:Accessing refreshes heat
Everyrecall that returns a memory bumps its heat back up. This means:
- Frequently used memories stay hot naturally
- Important but rarely accessed memories can be pinned (
importance >= 0.9) to prevent decay - Truly forgotten memories fade gracefully
Consolidation lifecycle
Cold memories are candidates forconsolidate, which clusters them by (entity, layer) and produces a single learning-layer summary. The originals are deleted, but the essential knowledge is preserved in compressed form.