memory-optimization-system

Offload long tool outputs to external files when they exceed 10KB or 50 lines. The original content is saved to a context_refs directory and replaced with a compact Mermaid summary plus a reference path, keeping the active context lightweight.

Register a cron job running a consolidation script daily at 3:00 in no_agent mode. The script computes FSRS retrievability scores, checks memory usage percentages, and only prints output when metrics change.

Silent failures occur when stored entries contain hidden Unicode characters like zero-width spaces, so exact string matching fails. Use a short unique ASCII prefix of 3-5 characters as the old_text value, then verify the capacity number actually changed.

FSRS computes retrievability as R = 1/(1 + age_days/(9*2.5)). Entries never accessed and older than 14 days are removable, R below 0.3 is low-retrievability, and R above 0.7 with 2+ accesses is healthy.

Promote entries containing explicit entity names that remain valid across sessions, especially when memory space exceeds 90%. Facts with trust scores above 0.7 and retrieval counts above 2 should also be referenced in memory when space allows.

Three tiers apply: above 85% triggers proactive cleanup in the current session, above 90% triggers immediate cleanup plus compression, and above 95% forces compression down to below 70% capacity.