Opencode-DCP · Tarquinen · Jan 24, 2026 · Jan 25, 2026 · Jan 26, 2026 · Jan 26, 2026
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,8 @@
+### Summary
+<!-- Provide a brief description of the changes in this PR -->
+
+### Checklist
+- [ ] I have read the [CONTRIBUTING.md](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning/blob/dev/CONTRIBUTING.md)
+- [ ] I have signed the CLA via the CLA Assistant bot (check the bot comment below after opening the PR)
+- [ ] My changes follow the project's coding style
+- [ ] I have added tests to cover my changes (if applicable)
diff --git a/.gitignore b/.gitignore
@@ -28,11 +28,16 @@ Thumbs.db
 # OpenCode
 .opencode/
 
-# Tests (local development only)
-tests/
+# Generated prompt files (from scripts/generate-prompts.ts)
+lib/prompts/*.generated.ts
+
+# Tests
+tests/results/
 notes/
 test-update.ts
 
 # Documentation (local development only)
 docs/
 SCHEMA_NOTES.md
+
+repomix-output.xml
diff --git a/.repomixignore b/.repomixignore
@@ -0,0 +1,9 @@
+.github/
+.logs/
+.opencode/
+dist/
+.repomixignore
+repomix-output.xml
+bun.lock
+package-lock.jsonc
+LICENCE
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,21 @@
+# Contributing to DCP
+
+Thank you for your interest in contributing to Dynamic Context Pruning (DCP)!
+
+## License and Contributor License Agreement (CLA)
+
+This project uses the **GNU Affero General Public License v3.0 (AGPL-3.0)**. 
+
+To maintain the project's sustainability, we require contributors to sign a **Contributor License Agreement (CLA)**. We use the standard **SAP Individual Contributor License Agreement**, which allows us to keep the project open-source while preserving the ability to offer commercial licenses to organizations that cannot comply with the AGPL-3.0.
+
+When you open a Pull Request, the **[CLA Assistant](https://cla-assistant.io/)** bot will automatically ask you to sign the agreement if you haven't already.
+
+## Getting Started
+
+1.  Fork the repository.
+2.  Create a feature branch.
+3.  Implement your changes and add tests if applicable.
+4.  Ensure all tests pass and the code is formatted.
+5.  Submit a Pull Request.
+
+We look forward to your contributions!
diff --git a/LICENSE b/LICENSE
diff --git a/README.md b/README.md
@@ -1,10 +1,11 @@
 # Dynamic Context Pruning Plugin
 
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/dansmolsky)
 [![npm version](https://img.shields.io/npm/v/@tarquinen/opencode-dcp.svg)](https://www.npmjs.com/package/@tarquinen/opencode-dcp)
 
-Automatically reduces token usage in OpenCode by removing obsolete tools from conversation history.
+Automatically reduces token usage in OpenCode by removing obsolete content from conversation history.
 
-![DCP in action](dcp-demo5.png)
+![DCP in action](assets/images/dcp-demo5.png)
 
 ## Installation
 
@@ -27,15 +28,17 @@ DCP uses multiple tools and strategies to reduce context size:
 
 ### Tools
 
-**Discard** — Exposes a `discard` tool that the AI can call to remove completed or noisy tool content from context.
+**Distill** — Exposes a `distill` tool that the AI can call to distill valuable context into concise summaries before removing the tool content.
 
-**Extract** — Exposes an `extract` tool that the AI can call to distill valuable context into concise summaries before removing the tool content.
+**Compress** — Exposes a `compress` tool that the AI can call to collapse a large section of conversation (messages and tools) into a single summary.
+
+**Prune** — Exposes a `prune` tool that the AI can call to remove completed or noisy tool content from context.
 
 ### Strategies
 
 **Deduplication** — Identifies repeated tool calls (e.g., reading the same file multiple times) and keeps only the most recent output. Runs automatically on every request with zero LLM cost.
 
-**Supersede Writes** — Prunes write tool inputs for files that have subsequently been read. When a file is written and later read, the original write content becomes redundant since the current file state is captured in the read result. Runs automatically on every request with zero LLM cost.
+**Supersede Writes** — Removes write tool calls for files that have subsequently been read. When a file is written and later read, the original write content becomes redundant since the current file state is captured in the read result. Runs automatically on every request with zero LLM cost.
 
 **Purge Errors** — Prunes tool inputs for tools that returned errors after a configurable number of turns (default: 4). Error messages are preserved for context, but the potentially large input content is removed. Runs automatically on every request with zero LLM cost.
 
@@ -47,90 +50,100 @@ LLM providers like Anthropic and OpenAI cache prompts based on exact prefix matc
 
 **Trade-off:** You lose some cache read benefits but gain larger token savings from reduced context size and performance improvements through reduced context poisoning. In most cases, the token savings outweigh the cache miss cost—especially in long sessions where context bloat becomes significant.
 
-> **Note:** In testing, cache hit rates were approximately 65% with DCP enabled vs 85% without.
+> **Note:** In testing, cache hit rates were approximately 80% with DCP enabled vs 85% without for most providers.
+
+**Best use case:** Providers that count usage in requests, such as Github Copilot and Google Antigravity, have no negative price impact.
 
-**Best use case:** Providers that count usage in requests, such as Github Copilot and Google Antigravity have no negative price impact.
+**Claude Subscriptions:** Anthropic subscription users (who receive "free" caching) may experience faster limit depletion than hit-rate ratios suggest due to the higher relative cost of cache misses. See [Claude Cache Limits](https://she-llac.com/claude-limits) for details.
 
 ## Configuration
 
 DCP uses its own config file:
 
 - Global: `~/.config/opencode/dcp.jsonc` (or `dcp.json`), created automatically on first run
 - Custom config directory: `$OPENCODE_CONFIG_DIR/dcp.jsonc` (or `dcp.json`), if `OPENCODE_CONFIG_DIR` is set
-- Project: `.opencode/dcp.jsonc` (or `dcp.json`) in your project’s `.opencode` directory
-
-<details>
-<summary><strong>Default Configuration</strong> (click to expand)</summary>
-
-```jsonc
-{
-    "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-    // Enable or disable the plugin
-    "enabled": true,
-    // Enable debug logging to ~/.config/opencode/logs/dcp/
-    "debug": false,
-    // Notification display: "off", "minimal", or "detailed"
-    "pruneNotification": "detailed",
-    // Slash commands configuration
-    "commands": {
-        "enabled": true,
-        // Additional tools to protect from pruning via commands (e.g., /dcp sweep)
-        "protectedTools": [],
-    },
-    // Protect from pruning for <turns> message turns
-    "turnProtection": {
-        "enabled": false,
-        "turns": 4,
-    },
-    // Protect file operations from pruning via glob patterns
-    // Patterns match tool parameters.filePath (e.g. read/write/edit)
-    "protectedFilePatterns": [],
-    // LLM-driven context pruning tools
-    "tools": {
-        // Shared settings for all prune tools
-        "settings": {
-            // Nudge the LLM to use prune tools (every <nudgeFrequency> tool results)
-            "nudgeEnabled": true,
-            "nudgeFrequency": 10,
-            // Additional tools to protect from pruning
-            "protectedTools": [],
-        },
-        // Removes tool content from context without preservation (for completed tasks or noise)
-        "discard": {
-            "enabled": true,
-        },
-        // Distills key findings into preserved knowledge before removing raw content
-        "extract": {
-            "enabled": true,
-            // Show distillation content as an ignored message notification
-            "showDistillation": false,
-        },
-    },
-    // Automatic pruning strategies
-    "strategies": {
-        // Remove duplicate tool calls (same tool with same arguments)
-        "deduplication": {
-            "enabled": true,
-            // Additional tools to protect from pruning
-            "protectedTools": [],
-        },
-        // Prune write tool inputs when the file has been subsequently read
-        "supersedeWrites": {
-            "enabled": false,
-        },
-        // Prune tool inputs for errored tools after X turns
-        "purgeErrors": {
-            "enabled": true,
-            // Number of turns before errored tool inputs are pruned
-            "turns": 4,
-            // Additional tools to protect from pruning
-            "protectedTools": [],
-        },
-    },
-}
-```
-
-</details>
+- Project: `.opencode/dcp.jsonc` (or `dcp.json`) in your project's `.opencode` directory
+
+> <details>
+> <summary><strong>Default Configuration</strong> (click to expand)</summary>
+>
+> ```jsonc
+> {
+>     "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
+>     // Enable or disable the plugin
+>     "enabled": true,
+>     // Enable debug logging to ~/.config/opencode/logs/dcp/
+>     "debug": false,
+>     // Notification display: "off", "minimal", or "detailed"
+>     "pruneNotification": "detailed",
+>     // Notification type: "chat" (in-conversation) or "toast" (system toast)
+>     "pruneNotificationType": "chat",
+>     // Slash commands configuration
+>     "commands": {
+>         "enabled": true,
+>         // Additional tools to protect from pruning via commands (e.g., /dcp sweep)
+>         "protectedTools": [],
+>     },
+>     // Protect from pruning for <turns> message turns past tool invocation
+>     "turnProtection": {
+>         "enabled": false,
+>         "turns": 4,
+>     },
+>     // Protect file operations from pruning via glob patterns
+>     // Patterns match tool parameters.filePath (e.g. read/write/edit)
+>     "protectedFilePatterns": [],
+>     // LLM-driven context pruning tools
+>     "tools": {
+>         // Shared settings for all prune tools
+>         "settings": {
+>             // Nudge the LLM to use prune tools (every <nudgeFrequency> tool results)
+>             "nudgeEnabled": true,
+>             "nudgeFrequency": 10,
+>             // Additional tools to protect from pruning
+>             "protectedTools": [],
+>         },
+>         // Removes tool content from context without preservation (for completed tasks or noise)
+>         "prune": {
+>             "enabled": true,
+>         },
+>         // Distills key findings into preserved knowledge before removing raw content
+>         "distill": {
+>             "enabled": true,
+>             // Show distillation content as an ignored message notification
+>             "showDistillation": false,
+>         },
+>         // Collapses a range of conversation content into a single summary
+>         "compress": {
+>             "enabled": true,
+>             // Show summary content as an ignored message notification
+>             "showCompression": true,
+>         },
+>     },
+>     // Automatic pruning strategies
+>     "strategies": {
+>         // Remove duplicate tool calls (same tool with same arguments)
+>         "deduplication": {
+>             "enabled": true,
+>             // Additional tools to protect from pruning
+>             "protectedTools": [],
+>         },
+>         // Prune write tool inputs when the file has been subsequently read
+>         "supersedeWrites": {
+>             "enabled": true,
+>         },
+>         // Prune tool inputs for errored tools after X turns
+>         "purgeErrors": {
+>             "enabled": true,
+>             // Number of turns before errored tool inputs are pruned
+>             "turns": 4,
+>             // Additional tools to protect from pruning
+>             "protectedTools": [],
+>         },
+>     },
+> }
+> ```
+>
+> </details>
 
 ### Commands
 
@@ -141,14 +154,10 @@ DCP provides a `/dcp` slash command:
 - `/dcp stats` — Shows cumulative pruning statistics across all sessions.
 - `/dcp sweep` — Prunes all tools since the last user message. Accepts an optional count: `/dcp sweep 10` prunes the last 10 tools. Respects `commands.protectedTools`.
 
-### Turn Protection
-
-When enabled, turn protection prevents tool outputs from being pruned for a configurable number of message turns. This gives the AI time to reference recent tool outputs before they become prunable. Applies to both `discard` and `extract` tools, as well as automatic strategies.
-
 ### Protected Tools
 
-By default, these tools are always protected from pruning across all strategies:
-`task`, `todowrite`, `todoread`, `discard`, `extract`, `batch`, `write`, `edit`
+By default, these tools are always protected from pruning:
+`task`, `todowrite`, `todoread`, `distill`, `compress`, `prune`, `batch`, `plan_enter`, `plan_exit`
 
 The `protectedTools` arrays in each section add to this default list.
 
@@ -166,4 +175,4 @@ Restart OpenCode after making config changes.
 
 ## License
 
-MIT
+AGPL-3.0-or-later
diff --git a/dcp-demo.png → assets/images/dcp-demo.png b/dcp-demo.png → assets/images/dcp-demo.png
diff --git a/dcp-demo2.png → assets/images/dcp-demo2.png b/dcp-demo2.png → assets/images/dcp-demo2.png
diff --git a/dcp-demo3.png → assets/images/dcp-demo3.png b/dcp-demo3.png → assets/images/dcp-demo3.png
diff --git a/dcp-demo4.png → assets/images/dcp-demo4.png b/dcp-demo4.png → assets/images/dcp-demo4.png
diff --git a/dcp-demo5.png → assets/images/dcp-demo5.png b/dcp-demo5.png → assets/images/dcp-demo5.png
diff --git a/cla-test.txt b/cla-test.txt
@@ -0,0 +1 @@
+This is a test file to verify the CLA Assistant bot.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		This is a test file to verify the CLA Assistant bot.