diff --git a/packages/coding-agent/docs/compaction.md b/packages/coding-agent/docs/compaction.md index de9d02d47..788348eea 100644 --- a/packages/coding-agent/docs/compaction.md +++ b/packages/coding-agent/docs/compaction.md @@ -1,6 +1,6 @@ # Compaction & Branch Summarization -LLMs have limited context windows. When conversations grow too long, pi uses compaction to summarize older content while preserving recent work. This page covers both auto-compaction and branch summarization. +LLMs have limited context windows. When conversations grow too long, Pi uses compaction to summarize older content while preserving recent work. This page covers both auto-compaction and branch summarization. **Source files** ([pi-mono](https://github.com/earendil-works/pi-mono)): - [`packages/coding-agent/src/core/compaction/compaction.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/compaction/compaction.ts) - Auto-compaction logic @@ -48,7 +48,7 @@ You can also trigger manually with `/compact [instructions]`, where optional ins Before compaction: entry: 0 1 2 3 4 5 6 7 8 9 - ┌─────┬─────┬─────┬─────┬──────┬─────┬─────┬──────┬──────┬─────┐ + ┌─────┬─────┬─────┬─────┬──────┬─────┬──── ─┬──────┬─────┬─────┐ │ hdr │ usr │ ass │ tool │ usr │ ass │ tool │ tool │ ass │ tool│ └─────┴─────┴─────┴──────┴─────┴─────┴──────┴──────┴─────┴─────┘ └────────┬───────┘ └──────────────┬──────────────┘ @@ -59,7 +59,7 @@ Before compaction: After compaction (new entry appended): entry: 0 1 2 3 4 5 6 7 8 9 10 - ┌─────┬─────┬─────┬─────┬──────┬─────┬─────┬──────┬──────┬─────┬─────┐ + ┌─────┬─────┬─────┬─────┬──────┬─────┬──── ─┬──────┬─────┬─────┬─────┐ │ hdr │ usr │ ass │ tool │ usr │ ass │ tool │ tool │ ass │ tool│ cmp │ └─────┴─────┴─────┴──────┴─────┴─────┴──────┴──────┴─────┴─────┴─────┘ └──────────┬──────┘ └──────────────────────┬───────────────────┘ @@ -102,7 +102,7 @@ Split turn (one huge turn exceeds budget): turnPrefixMessages = [usr, ass, tool, ass, tool, tool] ``` -For split turns, pi generates two summaries and merges them: +For split turns, Pi generates two summaries and merges them: 1. **History summary**: Previous context (if any) 2. **Turn prefix summary**: The early part of the split turn @@ -149,7 +149,7 @@ See [`prepareCompaction()`](https://github.com/earendil-works/pi-mono/blob/main/ ### When It Triggers -When you use `/tree` to navigate to a different branch, pi offers to summarize the work you're leaving. This injects context from the left branch into the new branch. +When you use `/tree` to navigate to a different branch, Pi offers to summarize the work you're leaving. This injects context from the left branch into the new branch. ### How It Works