docs: add proactive context usage and compaction guidance

2026-02-16 15:44:13 -08:00
parent fee8be1de0
commit 9c8da41610
5 changed files with 187 additions and 1 deletions
@@ -71,6 +71,21 @@ keepTurns: 10         # More history
 summaryMaxTokens: 4096 # Detailed summaries
 ```

+### Proactive Compaction Signals
+
+Use proactive thresholds to checkpoint before compaction cliffs and emit warning telemetry:
+
+```yaml
+compaction:
+  proactive:
+    enabled: true
+    warn_pct: 75
+    checkpoint_pct: 85
+    auto_compact_pct: 95
+    checkpoint_cooldown_ms: 300000
+    memory_namespace: session/checkpoints
+```
+
 ### Context Depth Levels

 Control how much context is injected into the system prompt: