opencodekit 0.17.11 → 0.17.13

package/dist/template/.opencode/skill/context-management/SKILL.md

@@ -5,65 +5,102 @@ description: Use when context is growing large, needing to prune/distill tool ou
 
 # Context Management
 
-Manage conversation context to prevent degradation. Uses DCP plugin.
+Manage conversation context to prevent degradation. Uses DCP plugin (`@tarquinen/opencode-dcp@latest`).
 
-## DCP Integration
+## Tool Hierarchy (v2.2+ Philosophy)
 
-This project uses the **DCP (Dynamic Context Pruning)** plugin. Prefer slash commands over tool calls for better reliability.
+DCP beta shifted to a compress-first approach. Follow this order strictly:
 
-### Slash Commands (Recommended)
+```
+compress > distill > prune
+```
+
+| Tool       | Use When                                               | Cache Impact |
+| ---------- | ------------------------------------------------------ | ------------ |
+| `compress` | A phase of work is complete — collapse the whole phase | Minimal      |
+| `distill`  | Large raw output with extractable value to preserve    | Low          |
+| `prune`    | Pure noise: wrong target, irrelevant, zero value       | Moderate     |
+
+**Why this matters:** Granular `prune` calls trigger cache invalidation on every provider, especially Anthropic. Compressing whole phases instead of surgically deleting individual outputs is cheaper, faster, and more reliable.
+
+**Never prune because it's convenient. Only prune true noise.**
+
+## DCP Slash Commands (Recommended)
 
 | Command                 | Purpose                                  | When to Use                         |
 | ----------------------- | ---------------------------------------- | ----------------------------------- |
 | `/dcp compress [focus]` | Collapse conversation range into summary | Phase complete, research done       |
-| `/dcp sweep [count]`    | Prune all tools since last user message  | Cleanup noise, quick prune          |
 | `/dcp distill [focus]`  | Distill key findings before removing     | Large outputs with valuable details |
+| `/dcp sweep [count]`    | Prune all tools since last user message  | Cleanup pure noise only             |
 | `/dcp context`          | Show token breakdown by category         | Check context usage                 |
 | `/dcp stats`            | Show cumulative pruning stats            | Review efficiency                   |
 
-### Tool Calls (Fallback)
+## Tool Calls (Fallback)
+
+Use when slash commands aren't suitable:
+
+| Tool       | Purpose                       | When to Use                           |
+| ---------- | ----------------------------- | ------------------------------------- |
+| `compress` | Collapse conversation range   | Phase complete, research done         |
+| `distill`  | Extract key info, then remove | Large outputs with valuable details   |
+| `prune`    | Remove tool outputs (no save) | Noise only — irrelevant, never-needed |
+
+**Note:** Prefer `/dcp compress` slash command over the `compress` tool — better boundary matching.
+
+## Phase-Boundary Compress Triggers
 
-Use tool calls when slash commands aren't suitable:
+The most effective compress timing is at natural phase endings. For the Compound Engineering loop:
 
-| Tool       | Purpose                       | When to Use                              |
-| ---------- | ----------------------------- | ---------------------------------------- |
-| `distill`  | Extract key info, then remove | Large outputs with valuable details      |
-| `prune`    | Remove tool outputs (no save) | Noise, irrelevant reads, superseded info |
-| `compress` | Collapse conversation range   | When slash command fails                 |
+| Phase ends            | What to compress                         | Keep                              |
+| --------------------- | ---------------------------------------- | --------------------------------- |
+| `/plan` research done | Exploration turns, scout/explore outputs | Plan.md facts, key decisions      |
+| `/ship` wave complete | Implementation turns, read file outputs  | Commit refs, verification results |
+| `/review` complete    | Raw agent outputs (all 5 reviewers)      | Synthesized findings summary      |
+| `/compound` done      | Entire compound loop session             | Observation titles stored         |
+| Session → handoff     | Everything since last compress           | Handoff doc summary               |
 
-**Note:** Compress tool has boundary matching issues. Prefer `/dcp compress` slash command.
+**Rule:** Every completed phase is a compress candidate. Don't wait until context is full — compress as chapters close.
 
 ## DCP Auto-Strategies
 
-DCP runs these automatically (zero LLM cost):
+DCP runs these automatically at zero LLM cost — don't manually manage these:
 
 - **Deduplication** — removes duplicate tool calls (same tool + same args)
 - **Supersede Writes** — removes write inputs when file is later read
 - **Purge Errors** — removes errored tool inputs after 4 turns
 
-You don't need to manually prune these.
-
 ## When to Evaluate
 
-**DO evaluate context when:**
+**DO evaluate at:**
 
-- Starting a new phase of work (best timing)
-- Accessed something irrelevant
-- Information superseded by newer outputs
-- Large tool outputs with extractable details
-- Phase complete (research, exploration, implementation)
+- Start of new turn after receiving user message (best timing — you know what's needed next)
+- Phase boundary: research done, implementation wave done, review done
+- Large tool output just returned that won't be needed for upcoming edits
+- Information superseded by newer, more specific output
 
 **DO NOT manage when:**
 
-- Output needed for upcoming edits
-- Contains files you'll reference when editing
-- Uncertain if you'll need it again
+- Output needed for upcoming file edits (read files stay until edit is done)
+- Contains active file contents you're about to modify
+- Uncertain if you'll need it — defer until certain
+- DCP auto-strategies already handle it
+
+## Protected Content
+
+Auto-protected from pruning (v2.1.7+):
+
+- `write` and `edit` tool outputs
+- `.env*` files
+- `AGENTS.md`
+- `.opencode/**` config
+- `.beads/**` tasks
+- `package.json`, `tsconfig.json`
 
-## Tool Usage
+Don't manually protect what's already protected.
 
-### Distill — Preserve + Remove (Preferred)
+## Distill — Preserve + Remove
 
-Extract high-fidelity knowledge from tool outputs, then remove the raw output. Your distillation must be a **complete technical substitute** — capture signatures, types, logic, constraints, everything essential.
+Extract high-fidelity knowledge from tool outputs, then remove the raw output. Distillation must be a **complete technical substitute** — capture signatures, types, logic, constraints, everything essential.
 
 ```typescript
 distill({
@@ -82,55 +119,34 @@ distill({
 });
 ```
 
-### Prune — Remove Noise (Last Resort)
-
-Delete tool outputs entirely. No preservation. Use for noise, wrong targets, or superseded information.
-
-```typescript
-prune({ ids: ["5", "8"] }); // IDs from <prunable-tools> list
-```
-
-## Critical Rules
-
-- IDs MUST come from the current `<prunable-tools>` list
-- The list refreshes after every tool use — don't cache IDs
-- Invalid IDs will error
-- **Distill before prune** — if there's anything worth keeping, distill it
-- **Batch operations** — accumulate several candidates before acting
-- **Timing** — manage at the START of a new turn (after user message), not at the end of your turn
-
-## Protected Content
-
-Auto-protected from pruning:
-
-- `.env*` files
-- `AGENTS.md`
-- `.opencode/**` config
-- `.beads/**` tasks
-- `package.json`, `tsconfig.json`
-
 ## Context Budget Guidelines
 
-| Phase             | Target  | Action                                     |
-| ----------------- | ------- | ------------------------------------------ |
-| Starting work     | <50k    | Load only essential AGENTS.md + task spec  |
-| Mid-task          | 50-100k | Distill completed reads, keep active files |
-| Approaching limit | >100k   | Aggressive distill, prune remaining noise  |
-| Near capacity     | >150k   | Session restart with handoff               |
+| Phase             | Target  | Action                                            |
+| ----------------- | ------- | ------------------------------------------------- |
+| Starting work     | <50k    | Load only essential AGENTS.md + task spec         |
+| Mid-task          | 50-100k | Compress completed phases, keep active files      |
+| Approaching limit | >100k   | Compress aggressively by phase, distill remaining |
+| Near capacity     | >150k   | Session restart with handoff                      |
+
+At >100k: prefer compressing full phases over distilling individual outputs. The cache cost is lower.
 
 ## Quick Reference
 
 ```
+HIERARCHY: compress > distill > prune
+TIMING: manage at turn START, not turn END
+PHASE ENDS = compress trigger
+
 DCP SLASH COMMANDS (preferred):
-/dcp compress [focus]  → Collapse range into summary
+/dcp compress [focus]  → Collapse completed phase
 /dcp distill [focus]   → Distill key findings
-/dcp sweep [count]     → Prune all since last user
+/dcp sweep [count]     → Prune pure noise only
 /dcp context           → Show token breakdown
 
 TOOL CALLS (fallback):
+compress({ topic, content: { startId, endId, summary } })
 distill({ targets: [{ id, distillation }] })
-prune({ ids: [...] })
+prune({ ids: [...] })  ← last resort only
 
-BUDGET: <50k start → 50-100k mid → >100k distill → >150k restart
-TIMING: Manage at turn START, not turn END
+BUDGET: <50k start → 50-100k compress phases → >100k aggressive → >150k restart
 ```

package/dist/template/.opencode/skill/deep-research/SKILL.md

@@ -93,15 +93,17 @@ The explore agent will run:
 ### Phase 3: Pattern Discovery
 
 ```typescript
-// Find similar patterns in codebase
-grep({ pattern: "<relevant pattern>", include: "*.ts" });
+// Find similar patterns in codebase (use project's file extension: *.ts, *.py, *.rs, *.go, *.java, etc.)
+grep({ pattern: "<relevant pattern>", include: "*.<ext>" });
 
 // Locate related files
 glob({ pattern: "src/**/*<topic>*" });
 
-// Check tests for usage examples
-glob({ pattern: "**/*.test.ts" });
-grep({ pattern: "<function name>", include: "*.test.ts" });
+// Check tests for usage examples (adapt glob to project conventions)
+// JS/TS: **/*.test.ts, **/*.spec.ts  |  Python: **/test_*.py  |  Rust: **/tests/**
+// Go: **/*_test.go  |  Java: **/src/test/**/*.java
+glob({ pattern: "**/*test*" });
+grep({ pattern: "<function name>", include: "*test*" });
 ```
 
 ### Phase 4: External Research (If Needed)
@@ -113,9 +115,9 @@ Only if internal exploration doesn't answer the question:
 context7({ operation: "resolve", libraryName: "<lib>" });
 context7({ operation: "query", libraryId: "<id>", topic: "<specific question>" });
 
-// Real-world patterns
+// Real-world patterns (adapt language parameter to project)
 codesearch({ query: "<API usage pattern>", tokensNum: 5000 });
-grepsearch({ query: "<code pattern>", language: "TypeScript" });
+grepsearch({ query: "<code pattern>", language: "<project language>" });
 ```
 
 ## Confidence Levels
@@ -279,9 +281,9 @@ Return file:line references for all findings.`,
 });
 
 // Phase 3: Pattern discovery (parallel with Phase 2)
-grep({ pattern: "middleware", include: "*.ts" });
-grep({ pattern: "rateLimit", include: "*.ts" });
-glob({ pattern: "src/middleware/*.ts" });
+grep({ pattern: "middleware", include: "*.<ext>" });
+grep({ pattern: "rateLimit", include: "*.<ext>" });
+glob({ pattern: "src/middleware/*" });
 
 // Phase 4: External (if patterns unclear)
 context7({ operation: "resolve", libraryName: "express" });

package/dist/template/.opencode/skill/finishing-a-development-branch/SKILL.md

@@ -193,7 +193,7 @@ npm run lint
 # Must exit 0. If fails → STOP. Run npm run lint:fix, then fix remaining.
 
 # Gate 3: Tests
-bun test
+vitest
 # Must exit 0. If fails → STOP. Fix failing tests first.
 ```
 
@@ -216,7 +216,7 @@ npm run lint || {
 }
 
 echo "Gate 3/3: Tests..."
-bun test || { echo "FAILED: Fix failing tests before proceeding."; exit 1; }
+vitest || { echo "FAILED: Fix failing tests before proceeding."; exit 1; }
 
 echo "All gates passed. Safe to merge/PR/close."
 ```
@@ -248,7 +248,7 @@ echo "All gates passed. Safe to merge/PR/close."
 
 ```bash
 # Before closing any bead:
-npm run typecheck && npm run lint && bun test
+npm run typecheck && npm run lint && vitest
 
 # If all pass:
 br close <id> --reason "Implementation complete. All gates passed."
@@ -273,7 +273,7 @@ Workers must include gate results in their completion report:
 
 ### Gate Command Used
 
-`npm run typecheck && npm run lint && bun test`
+`npm run typecheck && npm run lint && vitest`
 ```
 
 ## Common Mistakes

package/dist/template/.opencode/skill/test-driven-development/SKILL.md

@@ -120,8 +120,13 @@ Vague name, tests mock not code
 
 **MANDATORY. Never skip.**
 
+Run the project's test command:
+
 ```bash
-npm test path/to/test.test.ts
+# Detect from project config:
+# package.json → npm test / vitest       | Cargo.toml → cargo test
+# pyproject.toml → pytest               | go.mod → go test ./...
+# pom.xml → mvn test                    | build.gradle → gradle test
 ```
 
 Confirm:
@@ -176,9 +181,7 @@ Don't add features, refactor other code, or "improve" beyond the test.
 
 **MANDATORY.**
 
-```bash
-npm test path/to/test.test.ts
-```
+Run the project's test command (same as Verify RED).
 
 Confirm:
 
@@ -316,7 +319,7 @@ test("rejects empty email", async () => {
 **Verify RED**
 
 ```bash
-$ npm test
+$ <project test command>
 FAIL: expected 'Email required', got undefined
 ```
 
@@ -334,7 +337,7 @@ function submitForm(data: FormData) {
 **Verify GREEN**
 
 ```bash
-$ npm test
+$ <project test command>
 PASS
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.17.11",
+	"version": "0.17.13",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",
@@ -19,15 +19,13 @@
 		"registry": "https://registry.npmjs.org"
 	},
 	"scripts": {
-		"dev": "bun run src/index.ts",
-		"build": "bun run build.ts && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
-		"compile": "bun build src/index.ts --compile --outfile ock",
-		"compile:binary": "bun build src/index.ts --compile --outfile bin/ock",
-		"typecheck": "tsc --noEmit",
-		"test": "bun test",
-		"test:watch": "bun test --watch",
-		"validate:command-doc": "bun run src/validation/command-doc.ts --check",
-		"validate:docs-drift": "bun run src/validation/docs-drift.ts --check",
+		"dev": "tsx src/index.ts",
+		"build": "tsdown && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
+		"typecheck": "tsgo --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"validate:command-doc": "tsx src/validation/command-doc.ts --check",
+		"validate:docs-drift": "tsx src/validation/docs-drift.ts --check",
 		"validate:governance": "npm run validate:command-doc && npm run validate:docs-drift",
 		"lint": "oxlint .",
 		"lint:fix": "oxlint --fix .",
@@ -39,26 +37,25 @@
 		"@ai-sdk/provider-utils": "^4.0.15",
 		"@clack/prompts": "^0.7.0",
 		"@opencode-ai/plugin": "^1.2.6",
-		"@opentui/core": "^0.1.80",
-		"@opentui/solid": "^0.1.80",
 		"cac": "^6.7.14",
 		"cli-table3": "^0.6.5",
 		"diff": "^8.0.3",
 		"ora": "^9.3.0",
 		"picocolors": "^1.1.1",
-		"solid-js": "1.9.9",
 		"zod": "^3.25.76"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^1.9.4",
-		"@types/bun": "latest",
 		"@types/diff": "^8.0.0",
 		"@types/node": "^22.19.11",
+		"@typescript/native-preview": "latest",
 		"oxfmt": "^0.23.0",
 		"oxlint": "^1.48.0",
-		"typescript": "^5.9.3"
+		"tsdown": "latest",
+		"tsx": "latest",
+		"typescript": "^5.9.3",
+		"vitest": "latest"
 	},
 	"engines": {
-		"bun": ">=1.3.2"
+		"node": ">=20.19.0"
 	}
 }