opencodekit 0.19.2 → 0.19.4

package/dist/index.js

@@ -20,7 +20,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.19.2";
+var version = "0.19.4";
 
 //#endregion
 //#region src/utils/license.ts

package/dist/template/.opencode/context/git-context.md

@@ -0,0 +1,32 @@
+---
+purpose: Git spatial awareness injected into all agent prompts
+updated: 2026-04-01
+---
+
+# Git Context
+
+## Auto-Context (start of every task)
+
+Before starting work, establish your position in the repo. Run once per session and cache results:
+
+```bash
+git branch --show-current        # What branch am I on?
+git status --short               # What's modified/staged? (cap at 20 lines)
+git log --oneline -5             # What happened recently?
+```
+
+## When to Refresh
+
+Re-run git context after:
+
+- Any commit you make
+- Switching branches
+- Pulling, merging, or rebasing
+- Stashing or unstashing
+
+## How to Use
+
+- **Commit messages**: Use branch name for scope (e.g., `feat(auth):` if on `feature/auth`)
+- **Branch decisions**: Check if you're on main before creating a feature branch
+- **Conflict awareness**: `git status` shows modified files — avoid editing files with uncommitted changes from another task
+- **Recent history**: `git log` shows what was just done — prevents duplicate work

package/dist/template/.opencode/dcp-prompts/defaults/README.md

@@ -0,0 +1,40 @@
+# DCP Prompt Defaults
+
+This directory stores the DCP prompts.
+Each prompt file here should contain plain text only (no XML wrappers).
+
+## Creating Overrides
+
+1. Copy a prompt file from this directory into an overrides directory using the same filename.
+2. Edit the copied file using plain text.
+3. Restart OpenCode.
+
+To reset an override, delete the matching file from your overrides directory.
+
+Do not edit the default prompt files directly, they are just for reference, only files in the overrides directory are used.
+
+Override precedence (highest first):
+1. `.opencode/dcp-prompts/overrides/` (project)
+2. `$OPENCODE_CONFIG_DIR/dcp-prompts/overrides/` (config dir)
+3. `~/.config/opencode/dcp-prompts/overrides/` (global)
+
+## Prompt Files
+
+- `system.md`
+  - Purpose: Core system-level DCP instruction block.
+  - Runtime use: Injected into the model system prompt on every request.
+- `compress-range.md`
+  - Purpose: range-mode compress tool instructions and summary constraints.
+  - Runtime use: Registered as the range-mode compress tool description.
+- `compress-message.md`
+  - Purpose: message-mode compress tool instructions and summary constraints.
+  - Runtime use: Registered as the message-mode compress tool description.
+- `context-limit-nudge.md`
+  - Purpose: High-priority nudge when context is over max threshold.
+  - Runtime use: Injected when context usage is beyond configured max limits.
+- `turn-nudge.md`
+  - Purpose: Nudge to compress closed ranges at turn boundaries.
+  - Runtime use: Injected when context is between min and max limits at a new user turn.
+- `iteration-nudge.md`
+  - Purpose: Nudge after many iterations without user input.
+  - Runtime use: Injected when iteration threshold is crossed.

package/dist/template/.opencode/dcp-prompts/defaults/compress-message.md

@@ -0,0 +1,42 @@
+Collapse selected individual messages in the conversation into detailed summaries.
+
+THE SUMMARY
+Your summary must be EXHAUSTIVE. Capture file paths, function signatures, decisions made, constraints discovered, key findings, tool outcomes, and user intent details that matter... EVERYTHING that preserves the value of the selected message after the raw message is removed.
+
+USER INTENT FIDELITY
+When a selected message contains user intent, preserve that intent with extra care. Do not change scope, constraints, priorities, acceptance criteria, or requested outcomes.
+Directly quote short user instructions when that best preserves exact meaning.
+
+Yet be LEAN. Strip away the noise: failed attempts that led nowhere, verbose tool output, and repetition. What remains should be pure signal - golden nuggets of detail that preserve full understanding with zero ambiguity.
+
+MESSAGE IDS
+You specify individual raw messages by ID using the injected IDs visible in the conversation:
+
+- `mNNNN` IDs identify raw messages
+
+Each message has an ID inside XML metadata tags like `<dcp-message-id priority="high">m0007</dcp-message-id>`.
+The ID tag appears at the end of the message it belongs to — each ID covers all the content above it back to the previous ID.
+Treat these tags as message metadata only, not as content to summarize. Use only the inner `mNNNN` value as the `messageId`.
+The `priority` attribute indicates relative context cost. Prefer higher-priority closed messages before lower-priority ones.
+Messages marked as `<dcp-message-id>BLOCKED</dcp-message-id>` cannot be compressed.
+
+Rules:
+
+- Pick each `messageId` directly from injected IDs visible in context.
+- Only use raw message IDs of the form `mNNNN`.
+- Ignore XML attributes such as `priority` when copying the ID; use only the inner `mNNNN` value.
+- Do NOT use compressed block IDs like `bN`.
+- Do not invent IDs. Use only IDs that are present in context.
+- Do not target prior compressed blocks or block summaries.
+
+BATCHING
+Select MANY messages in a single tool call when they are independently safe to compress.
+Each entry should summarize exactly one message, and the tool can receive as many entries as needed in one batch.
+When several messages are equally safe to compress, prefer higher-priority messages first.
+
+Because each message is compressed independently:
+
+- Do not describe ranges
+- Do not use start/end boundaries
+- Do not use compressed block placeholders
+- Do not reference prior compressed blocks with `(bN)`

package/dist/template/.opencode/dcp-prompts/defaults/compress-range.md

@@ -0,0 +1,59 @@
+Collapse a range in the conversation into a detailed summary.
+
+THE SUMMARY
+Your summary must be EXHAUSTIVE. Capture file paths, function signatures, decisions made, constraints discovered, key findings... EVERYTHING that maintains context integrity. This is not a brief note - it is an authoritative record so faithful that the original conversation adds no value.
+
+USER INTENT FIDELITY
+When the compressed range includes user messages, preserve the user's intent with extra care. Do not change scope, constraints, priorities, acceptance criteria, or requested outcomes.
+Directly quote user messages when they are short enough to include safely. Direct quotes are preferred when they best preserve exact meaning.
+
+Yet be LEAN. Strip away the noise: failed attempts that led nowhere, verbose tool outputs, back-and-forth exploration. What remains should be pure signal - golden nuggets of detail that preserve full understanding with zero ambiguity.
+
+COMPRESSED BLOCK PLACEHOLDERS
+When the selected range includes previously compressed blocks, use this exact placeholder format when referencing one:
+
+- `(bN)`
+
+Compressed block sections in context are clearly marked with a header:
+
+- `[Compressed conversation section]`
+
+Compressed block IDs always use the `bN` form (never `mNNNN`) and are represented in the same XML metadata tag format.
+
+Rules:
+
+- Include every required block placeholder exactly once.
+- Do not invent placeholders for blocks outside the selected range.
+- Treat `(bN)` placeholders as RESERVED TOKENS. Do not emit `(bN)` text anywhere except intentional placeholders.
+- If you need to mention a block in prose, use plain text like `compressed bN` (not as a placeholder).
+- Preflight check before finalizing: the set of `(bN)` placeholders in your summary must exactly match the required set, with no duplicates.
+
+These placeholders are semantic references. They will be replaced with the full stored compressed block content when the tool processes your output.
+
+FLOW PRESERVATION WITH PLACEHOLDERS
+When you use compressed block placeholders, write the surrounding summary text so it still reads correctly AFTER placeholder expansion.
+
+- Treat each placeholder as a stand-in for a full conversation segment, not as a short label.
+- Ensure transitions before and after each placeholder preserve chronology and causality.
+- Do not write text that depends on the placeholder staying literal (for example, "as noted in `(b2)`").
+- Your final meaning must be coherent once each placeholder is replaced with its full compressed block content.
+
+BOUNDARY IDS
+You specify boundaries by ID using the injected IDs visible in the conversation:
+
+- `mNNNN` IDs identify raw messages
+- `bN` IDs identify previously compressed blocks
+
+Each message has an ID inside XML metadata tags like `<dcp-message-id>...</dcp-message-id>`.
+The ID tag appears at the end of the message it belongs to — each ID covers all the content above it back to the previous ID.
+Treat these tags as boundary metadata only, not as tool result content.
+
+Rules:
+
+- Pick `startId` and `endId` directly from injected IDs in context.
+- IDs must exist in the current visible context.
+- `startId` must appear before `endId`.
+- Do not invent IDs. Use only IDs that are present in context.
+
+BATCHING
+When multiple independent ranges are ready and their boundaries do not overlap, include all of them as separate entries in the `content` array of a single tool call. Each entry should have its own `startId`, `endId`, and `summary`.

package/dist/template/.opencode/dcp-prompts/defaults/context-limit-nudge.md

@@ -0,0 +1,21 @@
+CRITICAL WARNING: MAX CONTEXT LIMIT REACHED
+
+You are at or beyond the configured max context threshold. This is an emergency context-recovery moment.
+
+You MUST use the `compress` tool now. Do not continue normal exploration until compression is handled.
+
+If you are in the middle of a critical atomic operation, finish that atomic step first, then compress immediately.
+
+RANGE STRATEGY (MANDATORY)
+Prioritize one large, closed, high-yield compression range first.
+This overrides the normal preference for many small compressions.
+Only split into multiple compressions if one large range would reduce summary quality or make boundary selection unsafe.
+
+RANGE SELECTION
+Start from older, resolved history and capture as much stale context as safely possible in one pass.
+Avoid the newest active working slice unless it is clearly closed.
+Use visible injected boundary IDs for compression (`mNNNN` for messages, `bN` for compressed blocks), and ensure `startId` appears before `endId`.
+
+SUMMARY REQUIREMENTS
+Your summary must cover all essential details from the selected range so work can continue without reopening raw messages.
+If the compressed range includes user messages, preserve user intent exactly. Prefer direct quotes for short user messages to avoid semantic drift.

package/dist/template/.opencode/dcp-prompts/defaults/iteration-nudge.md

@@ -0,0 +1,5 @@
+You've been iterating for a while after the last user message.
+
+If there is a closed portion that is unlikely to be referenced immediately (for example, finished research before implementation), use the compress tool on it now.
+
+Prefer multiple short, closed ranges over one large range when several independent slices are ready.

package/dist/template/.opencode/dcp-prompts/defaults/system.md

@@ -0,0 +1,44 @@
+You operate in a context-constrained environment. Manage context continuously to avoid buildup and preserve retrieval quality. Efficient context management is paramount for your agentic performance.
+
+The ONLY tool you have for context management is `compress`. It replaces older conversation content with technical summaries you produce.
+
+`<dcp-message-id>` and `<dcp-system-reminder>` tags are environment-injected metadata. Do not output them.
+
+THE PHILOSOPHY OF COMPRESS
+`compress` transforms conversation content into dense, high-fidelity summaries. This is not cleanup - it is crystallization. Your summary becomes the authoritative record of what transpired.
+
+Think of compression as phase transitions: raw exploration becomes refined understanding. The original context served its purpose; your summary now carries that understanding forward.
+
+OPERATING STANCE
+Prefer short, closed, summary-safe compressions.
+When multiple independent stale sections exist, prefer several focused compressions (in parallel when possible) over one broad compression.
+
+Use `compress` as steady housekeeping while you work.
+
+CADENCE, SIGNALS, AND LATENCY
+
+- No fixed threshold mandates compression
+- Prioritize closedness and independence over raw size
+- Prefer smaller, regular compressions over infrequent massive compressions for better latency and summary quality
+- When multiple independent stale sections are ready, batch compressions in parallel
+
+COMPRESS WHEN
+
+A section is genuinely closed and the raw conversation has served its purpose:
+
+- Research concluded and findings are clear
+- Implementation finished and verified
+- Exploration exhausted and patterns understood
+- Dead-end noise can be discarded without waiting for a whole chapter to close
+
+DO NOT COMPRESS IF
+
+- Raw context is still relevant and needed for edits or precise references
+- The target content is still actively in progress
+- You may need exact code, error messages, or file contents in the immediate next steps
+
+Before compressing, ask: _"Is this section closed enough to become summary-only right now?"_
+
+Evaluate conversation signal-to-noise REGULARLY. Use `compress` deliberately with quality-first summaries. Prioritize stale content intelligently to maintain a high-signal context window that supports your agency.
+
+It is of your responsibility to keep a sharp, high-quality context window for optimal performance.

package/dist/template/.opencode/dcp-prompts/defaults/turn-nudge.md

@@ -0,0 +1,8 @@
+Evaluate the conversation for compressible ranges.
+
+If any range is cleanly closed and unlikely to be needed again, use the compress tool on it.
+If direction has shifted, compress earlier ranges that are now less relevant.
+
+Prefer small, closed-range compressions over one broad compression.
+The goal is to filter noise and distill key information so context accumulation stays under control.
+Keep active context uncompressed.

package/dist/template/.opencode/dcp-prompts/overrides/compress-message.md

@@ -0,0 +1,71 @@
+Collapse selected individual messages in the conversation into detailed summaries.
+
+THE SUMMARY
+Your summary must be EXHAUSTIVE. Use the following 9-section structure to ensure nothing is lost.
+Capture file paths, function signatures, decisions made, constraints discovered, key findings, tool outcomes, and user intent details that matter... EVERYTHING that preserves the value of the selected message after the raw message is removed.
+
+STRUCTURED SUMMARY FORMAT
+When summarizing each message, organize findings into these sections (omit empty sections):
+
+1. **Primary Request** — What the user actually wants. Quote exact instructions when short.
+2. **Key Technical Concepts** — Decisions made, constraints discovered, architecture choices, patterns identified.
+3. **Files and Code** — Exact file paths with line numbers (`path/file.ts:42-67`). Function signatures. Code snippets critical to understanding.
+4. **Errors and Fixes** — What broke, root cause, what fixed it. Include error messages verbatim when diagnostic.
+5. **Problem Solving** — Approaches tried (including failures). What worked and why.
+6. **User Messages** — Preserve exact user intent. Directly quote short user instructions when that best preserves meaning.
+7. **Pending Tasks** — Incomplete work with current status.
+8. **Current Work** — What's actively happening right now.
+9. **Next Step** — What should happen next (if clear from context).
+
+USER INTENT FIDELITY
+When a selected message contains user intent, preserve that intent with extra care. Do not change scope, constraints, priorities, acceptance criteria, or requested outcomes.
+Directly quote short user instructions when that best preserves exact meaning.
+
+Yet be LEAN. Strip away the noise: failed attempts that led nowhere, verbose tool output, and repetition. What remains should be pure signal — golden nuggets of detail that preserve full understanding with zero ambiguity.
+
+MESSAGE IDS
+You specify individual raw messages by ID using the injected IDs visible in the conversation:
+
+- `mNNNN` IDs identify raw messages
+
+Each message has an ID inside XML metadata tags like `<dcp-message-id priority="high">m0007</dcp-message-id>`.
+The ID tag appears at the end of the message it belongs to — each ID covers all the content above it back to the previous ID.
+Treat these tags as message metadata only, not as content to summarize. Use only the inner `mNNNN` value as the `messageId`.
+The `priority` attribute indicates relative context cost. Prefer higher-priority closed messages before lower-priority ones.
+Messages marked as `<dcp-message-id>BLOCKED</dcp-message-id>` cannot be compressed.
+
+Rules:
+
+- Pick each `messageId` directly from injected IDs visible in context.
+- Only use raw message IDs of the form `mNNNN`.
+- Ignore XML attributes such as `priority` when copying the ID; use only the inner `mNNNN` value.
+- Do NOT use compressed block IDs like `bN`.
+- Do not invent IDs. Use only IDs that are present in context.
+- Do not target prior compressed blocks or block summaries.
+
+BATCHING
+Select MANY messages in a single tool call when they are independently safe to compress.
+Each entry should summarize exactly one message, and the tool can receive as many entries as needed in one batch.
+When several messages are equally safe to compress, prefer higher-priority messages first.
+
+Because each message is compressed independently:
+
+- Do not describe ranges
+- Do not use start/end boundaries
+- Do not use compressed block placeholders
+- Do not reference prior compressed blocks with `(bN)`
+
+THE FORMAT OF COMPRESS
+
+```
+{
+  topic: string,           // Short label (3-5 words) for the overall batch
+  content: [               // One or more messages to compress independently
+    {
+      messageId: string,   // Raw message ID only: mNNNN (ignore metadata attributes like priority)
+      topic: string,       // Short label (3-5 words) for this one message summary
+      summary: string      // Complete technical summary replacing that one message (use 9-section format above)
+    }
+  ]
+}
+```

package/dist/template/.opencode/dcp.jsonc

@@ -1,83 +1,102 @@
 {
-  "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-  "enabled": true,
-  "debug": false,
-  // "off" | "minimal" | "detailed" — keep minimal for low-noise dev flow
-  "pruneNotification": "minimal",
-  // "chat" (in-conversation) or "toast" (system notification)
-  "pruneNotificationType": "toast",
-  // Slash commands: /dcp context, /dcp stats, /dcp sweep, /dcp compress, /dcp decompress, /dcp recompress
-  "commands": {
-    "enabled": true,
-    // Additional tools to protect from /dcp sweep (supports glob wildcards)
-    "protectedTools": ["observation", "memory-*"],
-  },
-  // Manual mode: disables autonomous context management
-  "manualMode": {
-    "enabled": false,
-    "automaticStrategies": true,
-  },
-  // Protect recent tool outputs from pruning
-  "turnProtection": {
-    "enabled": false,
-    "turns": 4,
-  },
-  // Glob patterns for files that should never be auto-pruned
-  // Keep tight: broad patterns reduce DCP effectiveness
-  "protectedFilePatterns": [
-    "**/.env*",
-    "**/AGENTS.md",
-    "**/.opencode/**",
-    "**/.beads/**",
-    "**/package.json",
-    "**/tsconfig.json",
-  ],
-  // Unified context compression tool (v3.1.0)
-  "compress": {
-    // "range" (stable) compresses spans into block summaries
-    // "message" (experimental) compresses individual raw messages
-    "mode": "message",
-    // "allow" (no prompt) | "ask" (prompt) | "deny" (tool not registered)
-    "permission": "allow",
-    "showCompression": false,
-    // v3.1.0: active summary tokens extend effective maxContextLimit
-    "summaryBuffer": true,
-    // Soft upper threshold: above this, strong compression nudges fire
-    // Accepts number or "X%" of model context window
-    "maxContextLimit": "80%",
-    // Soft lower threshold: below this, turn/iteration reminders are off
-    "minContextLimit": "35%",
-    // How often context-limit nudge fires above maxContextLimit (1 = every fetch)
-    "nudgeFrequency": 5,
-    // Messages since last user message before adding compression reminders
-    "iterationNudgeThreshold": 15,
-    // "strong" = more likely to compress, "soft" = less likely
-    "nudgeForce": "soft",
-    // Keep user messages compressible to avoid permanent context growth
-    "protectUserMessages": false,
-    // Auto-protected by DCP: task, skill, todowrite, todoread, compress, batch, plan_enter, plan_exit, write, edit
-    // Only list ADDITIONAL tools whose outputs should be appended to compression summaries
-    "protectedTools": ["observation", "memory-*", "tilth_*"],
-  },
-  // Experimental features
-  "experimental": {
-    // Allow DCP processing in subagent sessions (default: false)
-    "allowSubAgents": false,
-    // Enable user-editable prompt overrides under dcp-prompts directories
-    "customPrompts": false,
-  },
-  // Automatic pruning strategies (zero LLM cost)
-  "strategies": {
-    // Removes duplicate tool calls (same tool + same arguments), keeps most recent
-    "deduplication": {
-      "enabled": true,
-      "protectedTools": [],
-    },
-    // Prunes inputs from errored tool calls after N turns (error messages preserved)
-    "purgeErrors": {
-      "enabled": true,
-      "turns": 4,
-      "protectedTools": [],
-    },
-  },
+	"$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
+	"enabled": true,
+	"debug": false,
+	// "off" | "minimal" | "detailed" — keep minimal for low-noise dev flow
+	"pruneNotification": "minimal",
+	// "chat" (in-conversation) or "toast" (system notification)
+	"pruneNotificationType": "toast",
+	// Slash commands: /dcp context, /dcp stats, /dcp sweep, /dcp compress, /dcp decompress, /dcp recompress
+	"commands": {
+		"enabled": true,
+		// Additional tools to protect from /dcp sweep (supports glob wildcards)
+		"protectedTools": ["observation", "memory-*"]
+	},
+	// Manual mode: disables autonomous context management
+	"manualMode": {
+		"enabled": false,
+		"automaticStrategies": true
+	},
+	// Protect recent tool outputs from pruning
+	"turnProtection": {
+		"enabled": false,
+		"turns": 4
+	},
+	// Glob patterns for files that should never be auto-pruned
+	// Keep tight: broad patterns reduce DCP effectiveness
+	"protectedFilePatterns": [
+		"**/.env*",
+		"**/AGENTS.md",
+		"**/.opencode/**",
+		"**/.beads/**",
+		"**/package.json",
+		"**/tsconfig.json"
+	],
+	// Unified context compression tool (v3.1.0)
+	"compress": {
+		// "range" (stable) compresses spans into block summaries
+		// "message" (experimental) compresses individual raw messages
+		"mode": "message",
+		// "allow" (no prompt) | "ask" (prompt) | "deny" (tool not registered)
+		"permission": "allow",
+		"showCompression": false,
+		// v3.1.0: active summary tokens extend effective maxContextLimit
+		"summaryBuffer": true,
+		// Soft upper threshold: above this, strong compression nudges fire
+		// Accepts number or "X%" of model context window
+		"maxContextLimit": "80%",
+		// Per-model override for maxContextLimit (takes priority over global)
+		// Aligned to claude-opus-4.6 (216k context, 64k output) as primary build agent
+		"modelMaxLimits": {
+			"github-copilot/claude-opus-4.6": 192000,
+			"github-copilot/claude-opus-4.5": 192000,
+			"github-copilot/claude-sonnet-4.6": 192000,
+			"github-copilot/claude-sonnet-4.5": 192000,
+			"github-copilot/claude-sonnet-4": 192000,
+			"github-copilot/claude-haiku-4.5": 172000
+		},
+		// Soft lower threshold: below this, turn/iteration reminders are off
+		"minContextLimit": "35%",
+		// Per-model override for minContextLimit (takes priority over global)
+		"modelMinLimits": {
+			"github-copilot/claude-opus-4.6": "30%",
+			"github-copilot/claude-opus-4.5": "35%",
+			"github-copilot/claude-sonnet-4.6": "35%",
+			"github-copilot/claude-sonnet-4.5": "35%",
+			"github-copilot/claude-sonnet-4": "35%",
+			"github-copilot/claude-haiku-4.5": "25%"
+		},
+		// How often context-limit nudge fires above maxContextLimit (1 = every fetch)
+		"nudgeFrequency": 5,
+		// Messages since last user message before adding compression reminders
+		"iterationNudgeThreshold": 15,
+		// "strong" = more likely to compress, "soft" = less likely
+		"nudgeForce": "soft",
+		// Keep user messages compressible to avoid permanent context growth
+		"protectUserMessages": false,
+		// Auto-protected by DCP: task, skill, todowrite, todoread, compress, batch, plan_enter, plan_exit, write, edit
+		// Only list ADDITIONAL tools whose outputs should be appended to compression summaries
+		"protectedTools": ["observation", "memory-*", "tilth_*"]
+	},
+	// Experimental features
+	"experimental": {
+		// Allow DCP processing in subagent sessions (default: false)
+		"allowSubAgents": false,
+		// Enable user-editable prompt overrides under dcp-prompts directories
+		"customPrompts": true
+	},
+	// Automatic pruning strategies (zero LLM cost)
+	"strategies": {
+		// Removes duplicate tool calls (same tool + same arguments), keeps most recent
+		"deduplication": {
+			"enabled": true,
+			"protectedTools": []
+		},
+		// Prunes inputs from errored tool calls after N turns (error messages preserved)
+		"purgeErrors": {
+			"enabled": true,
+			"turns": 4,
+			"protectedTools": []
+		}
+	}
 }