v1.1.1-beta.1 - Split prune into discard/extract, assistant-role injection, config restructure

.github/workflows/pr-checks.yml

@@ -1,33 +1,36 @@
 name: PR Checks
 
 on:
-  pull_request:
-    branches: [master, dev]
+    pull_request:
+        branches: [master, dev]
 
 jobs:
-  validate:
-    name: Type Check, Build & Audit
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Type check
-        run: npm run typecheck
-
-      - name: Build
-        run: npm run build
-
-      - name: Security audit
-        run: npm audit --audit-level=high
-        continue-on-error: false
+    validate:
+        name: Type Check, Build & Audit
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: "20"
+                  cache: "npm"
+
+            - name: Install dependencies
+              run: npm ci
+
+            - name: Format check
+              run: npm run format:check
+
+            - name: Type check
+              run: npm run typecheck
+
+            - name: Build
+              run: npm run build
+
+            - name: Security audit
+              run: npm audit --audit-level=high
+              continue-on-error: false

.gitignore

@@ -32,3 +32,7 @@ Thumbs.db
 tests/
 notes/
 test-update.ts
+
+# Documentation (local development only)
+docs/
+SCHEMA_NOTES.md

.prettierrc

@@ -0,0 +1,10 @@
+{
+    "semi": false,
+    "singleQuote": false,
+    "tabWidth": 4,
+    "useTabs": false,
+    "trailingComma": "all",
+    "printWidth": 100,
+    "bracketSpacing": true,
+    "arrowParens": "always"
+}

README.md

@@ -13,7 +13,7 @@ Add to your OpenCode config:
 ```jsonc
 // opencode.jsonc
 {
-  "plugin": ["@tarquinen/opencode-dcp@latest"]
+    "plugin": ["@tarquinen/opencode-dcp@latest"],
 }
 ```
 
@@ -29,7 +29,9 @@ DCP uses multiple strategies to reduce context size:
 
 **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.
 
-**Prune Tool** — Exposes a `prune` tool that the AI can call to manually trigger pruning when it determines context cleanup is needed.
+**Discard Tool** — Exposes a `discard` tool that the AI can call to remove completed or noisy tool outputs from context. Use this for task completion cleanup and removing irrelevant outputs.
+
+**Extract Tool** — Exposes an `extract` tool that the AI can call to distill valuable context into concise summaries before removing the raw outputs. Use this when you need to preserve key findings while reducing context size.
 
 **On Idle Analysis** — Uses a language model to semantically analyze conversation context during idle periods and identify tool outputs that are no longer relevant.
 
@@ -54,59 +56,82 @@ DCP uses its own config file:
 
 ```jsonc
 {
-  // Enable or disable the plugin
-  "enabled": true,
-  // Enable debug logging to ~/.config/opencode/logs/dcp/
-  "debug": false,
-  // Summary display: "off", "minimal", or "detailed"
-  "pruningSummary": "detailed",
-  // Strategies for pruning tokens from chat history
-  "strategies": {
-    // Remove duplicate tool calls (same tool with same arguments)
-    "deduplication": {
-      "enabled": true,
-      // Additional tools to protect from pruning
-      "protectedTools": []
+    // 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",
+    // Protect from pruning for <turns> message turns
+    "turnProtection": {
+        "enabled": false,
+        "turns": 4,
     },
-    // Prune write tool inputs when the file has been subsequently read
-    "supersedeWrites": {
-      "enabled": true
+    // 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,
+        },
     },
-    // Exposes a prune tool to your LLM to call when it determines pruning is necessary
-    "pruneTool": {
-      "enabled": true,
-      // Additional tools to protect from pruning
-      "protectedTools": [],
-      // Nudge the LLM to use the prune tool (every <frequency> tool results)
-      "nudge": {
-        "enabled": true,
-        "frequency": 10
-      }
+    // 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,
+        },
+        // (Legacy) Run an LLM to analyze what tool calls are no longer relevant on idle
+        "onIdle": {
+            "enabled": false,
+            // Additional tools to protect from pruning
+            "protectedTools": [],
+            // Override model for analysis (format: "provider/model")
+            // "model": "anthropic/claude-haiku-4-5",
+            // Show toast notifications when model selection fails
+            "showModelErrorToasts": true,
+            // When true, fallback models are not permitted
+            "strictModelSelection": false,
+        },
     },
-    // (Legacy) Run an LLM to analyze what tool calls are no longer relevant on idle
-    "onIdle": {
-      "enabled": false,
-      // Additional tools to protect from pruning
-      "protectedTools": [],
-      // Override model for analysis (format: "provider/model")
-      // "model": "anthropic/claude-haiku-4-5",
-      // Show toast notifications when model selection fails
-      "showModelErrorToasts": true,
-      // When true, fallback models are not permitted
-      "strictModelSelection": false
-    }
-  }
 }
 ```
 
 </details>
 
+### 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`, `prune`, `batch`
+`task`, `todowrite`, `todoread`, `discard`, `extract`, `batch`
+
+The `protectedTools` arrays in each section add to this default list:
 
-The `protectedTools` arrays in each strategy add to this default list.
+- `tools.settings.protectedTools` — Protects tools from the `discard` and `extract` tools
+- `strategies.deduplication.protectedTools` — Protects tools from deduplication
+- `strategies.onIdle.protectedTools` — Protects tools from on-idle analysis
 
 ### Config Precedence