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
@@ -218,6 +218,23 @@ hooks:
 #   extra_sections: []
 #   context_level: normal  # minimal | normal | detailed | debug

+# ── Context Compaction ────────────────────────────────────────────────
+# Optional proactive context monitoring and checkpointing.
+#
+# compaction:
+#   enabled: true
+#   threshold_pct: 80
+#   keep_turns: 4
+#   summary_max_tokens: 1024
+#   importance_threshold: 1
+#   proactive:
+#     enabled: false
+#     warn_pct: 75
+#     checkpoint_pct: 85
+#     auto_compact_pct: 95
+#     checkpoint_cooldown_ms: 300000
+#     memory_namespace: session/checkpoints
+
 # skills:
 #   # Registry catalog source for discovery and install-by-id:
 #   # local path or HTTPS URL. Can also be set via FLYNN_SKILLS_REGISTRY_SOURCE.