opencodekit 0.18.5 → 0.18.7

package/dist/index.js

@@ -2,7 +2,7 @@
 import { createRequire } from "node:module";
 import { cac } from "cac";
 import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, relative, resolve } from "node:path";
+import { basename, dirname, join, relative } from "node:path";
 import * as p from "@clack/prompts";
 import color from "picocolors";
 import { z } from "zod";
@@ -18,11 +18,35 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.18.5";
+var version = "0.18.7";
 
 //#endregion
 //#region src/utils/errors.ts
 /**
+* Resolve the .opencode directory path.
+* Handles two cases:
+* 1. Standard project: cwd has .opencode/ subdirectory
+* 2. Global config dir: cwd IS the opencode config dir (has opencode.json directly)
+* Returns null if neither case applies.
+*/
+function resolveOpencodePath() {
+	const nested = join(process.cwd(), ".opencode");
+	if (existsSync(nested)) return nested;
+	if (existsSync(join(process.cwd(), "opencode.json"))) return process.cwd();
+	return null;
+}
+/**
+* Resolve opencode path or show "not initialized" error and return null.
+*/
+function requireOpencodePath() {
+	const resolved = resolveOpencodePath();
+	if (!resolved) {
+		notInitialized();
+		return null;
+	}
+	return resolved;
+}
+/**
 * Display a styled error message with optional fix suggestion
 */
 function showError(message, fix) {
@@ -79,7 +103,8 @@ const InitOptionsSchema = z.object({
 	yes: z.boolean().optional().default(false),
 	backup: z.boolean().optional().default(false),
 	prune: z.boolean().optional().default(false),
-	pruneAll: z.boolean().optional().default(false)
+	pruneAll: z.boolean().optional().default(false),
+	projectOnly: z.boolean().optional().default(false)
 });
 const UpgradeOptionsSchema = z.object({
 	force: z.boolean().optional().default(false),
@@ -192,11 +217,8 @@ function parseAction(schema, action) {
 //#region src/commands/agent.ts
 async function agentCommand(action) {
 	const validatedAction = parseAction(AgentActionSchema, action);
-	const opencodePath = join(process.cwd(), ".opencode");
-	if (!existsSync(opencodePath)) {
-		notInitialized();
-		return;
-	}
+	const opencodePath = requireOpencodePath();
+	if (!opencodePath) return;
 	const agentPath = join(opencodePath, "agent");
 	switch (validatedAction) {
 		case "list":
@@ -473,11 +495,8 @@ async function removeAgent(agentPath, agentNameArg) {
 //#region src/commands/command.ts
 async function commandCommand(action) {
 	const validatedAction = parseAction(CommandActionSchema, action);
-	const opencodePath = join(process.cwd(), ".opencode");
-	if (!existsSync(opencodePath)) {
-		notInitialized();
-		return;
-	}
+	const opencodePath = requireOpencodePath();
+	if (!opencodePath) return;
 	const commandDir = join(opencodePath, "command");
 	switch (validatedAction) {
 		case "list":
@@ -982,12 +1001,9 @@ async function getAgentsFromServer() {
 	return fetchFromServer("/agent");
 }
 async function configCommand(action) {
-	const opencodePath = join(process.cwd(), ".opencode");
+	const opencodePath = requireOpencodePath();
+	if (!opencodePath) return;
 	const configPath = join(opencodePath, "opencode.json");
-	if (!existsSync(opencodePath)) {
-		notInitialized();
-		return;
-	}
 	if (!existsSync(configPath)) {
 		showError("opencode.json not found", "ock init --force");
 		return;
@@ -2758,6 +2774,34 @@ const EXCLUDED_FILES = [
 	"pnpm-lock.yaml"
 ];
 const PRESERVE_USER_DIRS = ["memory/project", "context"];
+const SHARED_CONFIG_DIRS = [
+	"agent",
+	"command",
+	"skill",
+	"tool"
+];
+/**
+* Detect if global config has any of the shared dirs populated.
+* Returns null if no global config or no shared dirs found.
+*/
+function detectGlobalConfig() {
+	const globalDir = getGlobalConfigDir();
+	if (!existsSync(globalDir)) return null;
+	const coveredDirs = SHARED_CONFIG_DIRS.filter((d) => {
+		const dirPath = join(globalDir, d);
+		if (!existsSync(dirPath)) return false;
+		try {
+			return readdirSync(dirPath).filter((e) => !e.startsWith(".")).length > 0;
+		} catch {
+			return false;
+		}
+	});
+	if (coveredDirs.length === 0) return null;
+	return {
+		dir: globalDir,
+		coveredDirs
+	};
+}
 /**
 * Get the global OpenCode config directory based on OS.
 * - macOS/Linux: ~/.config/opencode/ (respects XDG_CONFIG_HOME)
@@ -2801,10 +2845,25 @@ async function copyDir(src, dest) {
 		else writeFileSync(destPath, readFileSync(srcPath, "utf-8"));
 	}
 }
-async function copyOpenCodeOnly(templateRoot, targetDir) {
+async function copyOpenCodeOnly(templateRoot, targetDir, skipDirs) {
 	const opencodeSrc = join(templateRoot, ".opencode");
 	const opencodeDest = join(targetDir, ".opencode");
 	if (!existsSync(opencodeSrc)) return false;
+	if (skipDirs && skipDirs.length > 0) {
+		const skipSet = new Set(skipDirs);
+		mkdirSync(opencodeDest, { recursive: true });
+		for (const entry of readdirSync(opencodeSrc, { withFileTypes: true })) {
+			if (EXCLUDED_DIRS.includes(entry.name)) continue;
+			if (!entry.isDirectory() && EXCLUDED_FILES.includes(entry.name)) continue;
+			if (entry.isSymbolicLink()) continue;
+			if (entry.isDirectory() && skipSet.has(entry.name)) continue;
+			const srcPath = join(opencodeSrc, entry.name);
+			const destPath = join(opencodeDest, entry.name);
+			if (entry.isDirectory()) await copyDir(srcPath, destPath);
+			else writeFileSync(destPath, readFileSync(srcPath, "utf-8"));
+		}
+		return true;
+	}
 	await copyDir(opencodeSrc, opencodeDest);
 	return true;
 }
@@ -3100,18 +3159,36 @@ async function initCommand(rawOptions = {}) {
 		}
 		projectName = name || projectName;
 	}
+	let skipDirs = [];
+	if (!options.global) {
+		const globalConfig = detectGlobalConfig();
+		if (globalConfig && options.projectOnly) {
+			skipDirs = globalConfig.coveredDirs;
+			p.log.info(`Using global config from ${color.cyan(globalConfig.dir)}`);
+			p.log.info(`Skipping: ${skipDirs.map((d) => color.dim(d)).join(", ")}`);
+		} else if (globalConfig && !options.yes) {
+			p.log.info(`Global config found at ${color.cyan(globalConfig.dir)}`);
+			p.log.info(`Available globally: ${globalConfig.coveredDirs.map((d) => color.green(d)).join(", ")}`);
+			const useGlobal = await p.confirm({
+				message: "Skip these (use global config)? Only project-scope files will be created locally.",
+				initialValue: true
+			});
+			if (!p.isCancel(useGlobal) && useGlobal) skipDirs = globalConfig.coveredDirs;
+		} else if (globalConfig && options.yes) p.log.info(`Global config found at ${color.cyan(globalConfig.dir)} — use ${color.bold("--project-only")} to skip shared dirs`);
+	}
 	const s = p.spinner();
 	if (mode === "scaffold") {
 		s.start("Scaffolding project");
 		mkdirSync(targetDir, { recursive: true });
 	} else if (mode === "add-config") s.start("Adding OpenCodeKit");
 	else s.start("Reinitializing");
-	if (!await copyOpenCodeOnly(templateRoot, targetDir)) {
+	if (!await copyOpenCodeOnly(templateRoot, targetDir, skipDirs)) {
 		s.stop("Failed");
 		p.outro(color.red("Template copy failed"));
 		process.exit(1);
 	}
 	s.stop("Done");
+	if (skipDirs.length > 0) p.log.info(`Project-only init: skipped ${skipDirs.map((d) => color.dim(d)).join(", ")} (using global config)`);
 	const restoredFileCount = finalizeInstalledFiles(targetDir, getPackageVersion$1(), preservedFiles);
 	if (restoredFileCount > 0) p.log.info(`Preserved ${restoredFileCount} user memory files (memory/project/)`);
 	if (options.free) {
@@ -3280,11 +3357,8 @@ async function initCommand(rawOptions = {}) {
 //#region src/commands/skill.ts
 async function skillCommand(action) {
 	const validatedAction = parseAction(SkillActionSchema, action);
-	const opencodePath = join(process.cwd(), ".opencode");
-	if (!existsSync(opencodePath)) {
-		notInitialized();
-		return;
-	}
+	const opencodePath = requireOpencodePath();
+	if (!opencodePath) return;
 	const skillDir = join(opencodePath, "skill");
 	switch (validatedAction) {
 		case "list":
@@ -3684,12 +3758,9 @@ function findUpgradeOrphans(installedFiles, templateFiles) {
 async function upgradeCommand(rawOptions = {}) {
 	const options = parseOptions(UpgradeOptionsSchema, rawOptions);
 	if (process.argv.includes("--quiet")) return;
-	const opencodeDir = join(process.cwd(), ".opencode");
+	const opencodeDir = requireOpencodePath();
+	if (!opencodeDir) return;
 	const manifest = loadManifest(opencodeDir);
-	if (!existsSync(opencodeDir)) {
-		notInitialized();
-		return;
-	}
 	p.intro(color.bgCyan(color.black(" Upgrade ")));
 	const versionInfo = await checkVersion(opencodeDir);
 	console.log();
@@ -4120,11 +4191,8 @@ function displayChecks(checks) {
 async function statusCommand() {
 	if (process.argv.includes("--quiet")) return;
 	const cwd = process.cwd();
-	const opencodeDir = join(cwd, ".opencode");
-	if (!existsSync(opencodeDir)) {
-		notInitialized();
-		return;
-	}
+	const opencodeDir = requireOpencodePath();
+	if (!opencodeDir) return;
 	const projectName = basename(cwd);
 	p.intro(color.bgCyan(color.black(` ${projectName} `)));
 	const agentDir = join(opencodeDir, "agent");
@@ -4163,14 +4231,6 @@ async function statusCommand() {
 
 //#endregion
 //#region src/commands/patch.ts
-function getOpencodeDir() {
-	const opencodeDir = join(resolve("."), ".opencode");
-	if (!existsSync(opencodeDir)) {
-		notInitialized();
-		return null;
-	}
-	return opencodeDir;
-}
 function listPatches(opencodeDir) {
 	const metadata = loadPatchMetadata(opencodeDir);
 	const entries = Object.entries(metadata.patches);
@@ -4399,7 +4459,7 @@ function togglePatch(opencodeDir, disable) {
 	}
 }
 async function patchCommand(action) {
-	const opencodeDir = getOpencodeDir();
+	const opencodeDir = requireOpencodePath();
 	if (!opencodeDir) return;
 	const validatedAction = parseAction(PatchActionSchema, action);
 	if (!validatedAction) {
@@ -5416,7 +5476,7 @@ function stripAnsi(str) {
 //#region src/tui/hooks/useData.ts
 function loadProjectData() {
 	const cwd = process.cwd();
-	const opencodeDir = join(cwd, ".opencode");
+	const opencodeDir = resolveOpencodePath() ?? join(cwd, ".opencode");
 	const projectName = basename(cwd);
 	const agentDir = join(opencodeDir, "agent");
 	let agents = [];
@@ -5445,9 +5505,6 @@ function loadProjectData() {
 		mcpServers
 	};
 }
-function isInitialized() {
-	return existsSync(join(process.cwd(), ".opencode"));
-}
 
 //#endregion
 //#region src/tui/index.ts
@@ -5455,10 +5512,7 @@ function isInitialized() {
 * Launch the TUI dashboard with interactive navigation.
 */
 async function launchTUI() {
-	if (!isInitialized()) {
-		notInitialized();
-		return;
-	}
+	if (!requireOpencodePath()) return;
 	await mainMenu();
 }
 async function mainMenu() {
@@ -5561,7 +5615,7 @@ const cli = cac("ock");
 cli.option("--verbose", "Enable verbose logging");
 cli.option("--quiet", "Suppress all output");
 cli.version(`${packageVersion}`);
-cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").option("--global", "Install to global OpenCode config (~/.config/opencode/)").option("--free", "Use free models (default)").option("--recommend", "Use recommended premium models").option("-y, --yes", "Skip prompts, use defaults (for CI)").option("--backup", "Backup existing .opencode before overwriting").option("--prune", "Manually select orphan files to delete").option("--prune-all", "Auto-delete all orphan files").action(initCommand);
+cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").option("--global", "Install to global OpenCode config (~/.config/opencode/)").option("--free", "Use free models (default)").option("--recommend", "Use recommended premium models").option("-y, --yes", "Skip prompts, use defaults (for CI)").option("--backup", "Backup existing .opencode before overwriting").option("--prune", "Manually select orphan files to delete").option("--prune-all", "Auto-delete all orphan files").option("--project-only", "Only init project-scope files (skip if global config has agents/skills/commands/tools)").action(initCommand);
 cli.command("agent [action]", "Manage agents (list, add, view)").action(async (action) => {
 	if (!action) {
 		console.log("\nUsage: ock agent <action>\n");

package/dist/template/.opencode/AGENTS.md

@@ -201,19 +201,21 @@ For major tracked work:
 | 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  |
+| Mid-task          | 50-100k | Compress completed phases, keep active files |
+| Approaching limit | >100k   | Aggressive compression, sweep stale noise    |
 | Near capacity     | >150k   | Session restart with handoff               |
 
-### Tools
+### DCP Commands
 
-- `distill` — Extract key info from tool outputs, then remove raw output (preferred)
-- `prune` — Remove tool outputs entirely (noise only, no preservation)
+- `/dcp context` — Show current context health and pressure
+- `/dcp compress` — Compress completed conversation ranges (primary tool)
+- `/dcp sweep` — Remove stale/noisy content according to DCP rules
+- `/dcp stats` — Inspect pruning/compression activity
 
 ### Rules
 
-1. **Distill at turn START** — not end (you know what's needed)
-2. **Batch operations** — accumulate candidates before acting
+1. **Compress at phase boundaries** — not during active edits
+2. **Batch cleanup** — use `/dcp sweep` for stale noise, not ad-hoc deletion
 3. **Protected content** — AGENTS.md, .opencode/, .beads/, config files
 
 ---

package/dist/template/.opencode/agent/explore.md

@@ -11,6 +11,9 @@ tools:
   memory-update: false
   observation: false
   question: false
+  websearch: false
+  webfetch: false
+  codesearch: false
 ---
 
 You are OpenCode, the best coding agent on the planet.
@@ -19,8 +22,6 @@ You are OpenCode, the best coding agent on the planet.
 
 **Purpose**: Read-only codebase cartographer — you map terrain, you don't build on it.
 
-> _"Agency is knowing where the levers are before you pull them."_
-
 ## Identity
 
 You are a read-only codebase explorer. You output concise, evidence-backed findings with absolute paths only.
@@ -29,45 +30,41 @@ You are a read-only codebase explorer. You output concise, evidence-backed findi
 
 Find relevant files, symbols, and usage paths quickly for the caller.
 
-## Skills
+## Tools — Use These for Local Code Search
 
-Always load:
+| Tool | Use For | Example |
+|------|---------|--------|
+| `grep` | Find text/regex patterns in files | `grep(pattern: "PatchEntry", include: "*.ts")` |
+| `glob` | Find files by name/pattern | `glob(pattern: "src/**/*.ts")` |
+| `lsp` (goToDefinition) | Jump to symbol definition | `lsp(operation: "goToDefinition", filePath: "...", line: N, character: N)` |
+| `lsp` (findReferences) | Find all usages of a symbol | `lsp(operation: "findReferences", ...)` |
+| `lsp` (hover) | Get type info and docs | `lsp(operation: "hover", ...)` |
+| `read` | Read file content | `read(filePath: "src/utils/patch.ts")` |
 
-```typescript
-skill({ name: "code-navigation" });
-```
+**NEVER** use `websearch`, `webfetch`, or `codesearch` — those search the internet, not your project.
 
 ## Rules
 
 - Never modify files — read-only is a hard constraint
 - Return absolute paths in final output
 - Cite `file:line` evidence whenever possible
-- Prefer semantic lookup (LSP) before broad text search when it improves precision
-- Stop when you can answer with concrete evidence or when additional search only repeats confirmed paths
+- **Always start with `grep` or `glob`** to locate files and symbols — do NOT read directories to browse
+- Use LSP for precise navigation after finding candidate locations
+- Stop when you can answer with concrete evidence
 
-## Before You Explore
+## Navigation Patterns
 
-- **Be certain**: Only explore what's needed for the task at hand
-- **Don't over-explore**: Stop when you have enough evidence to answer
-- **Use LSP first**: Start with goToDefinition/findReferences before grep
-- **Stay scoped**: Don't explore files outside the task scope
-- **Cite evidence**: Every finding needs file:line reference
+1. **Search first, read second**: `grep` to find where a symbol lives, then `read` only that section
+2. **Don't re-read**: If you already read a file, reference what you learned — don't read it again
+3. **Follow the chain**: definition → usages → callers via LSP findReferences
+4. **Target ≤3 tool calls per symbol**: grep → read section → done
 
 ## Workflow
 
-1. Discover candidate files with `glob` or `workspaceSymbol`
-2. Validate symbol flow with LSP (`goToDefinition`, `findReferences`)
-3. Use `grep` for targeted pattern checks
-4. Read only relevant sections
-5. Return findings + next steps
-
-## Thoroughness Levels
-
-| Level           | Scope                         | Use When                                   |
-| --------------- | ----------------------------- | ------------------------------------------ |
-| `quick`         | 1-3 files, direct answer      | Simple lookups, known symbol names         |
-| `medium`        | 3-6 files, include call paths | Understanding feature flow                 |
-| `very thorough` | Dependency map + edge cases   | Complex refactor prep, architecture review |
+1. `grep` or `glob` to discover candidate files
+2. `lsp` goToDefinition/findReferences for precise symbol navigation
+3. `read` only the relevant sections (use offset/limit)
+4. Return findings with file:line evidence
 
 ## Output
 

package/dist/template/.opencode/command/ship.md

@@ -75,13 +75,15 @@ ls .beads/artifacts/$ARGUMENTS/
 
 If `plan.md` exists with dependency graph:
 
-1. **Parse waves** from plan header (Wave 1, Wave 2, etc.)
-2. **Execute Wave 1** (independent tasks) in parallel using `task()` subagents
-3. **Wait for Wave 1 completion** — all tasks pass or report failures
-4. **Execute Wave 2** (depends on Wave 1) in parallel
+1. **Load skill:** `skill({ name: "executing-plans" })`
+2. **Parse waves** from dependency graph section
+3. **Execute wave-by-wave:**
+   - Single-task wave → execute directly (no subagent overhead)
+   - Multi-task wave → dispatch parallel `task({ subagent_type: "general" })` subagents, one per task
+4. **Review after each wave** — run verification gates, report, wait for feedback
 5. **Continue** until all waves complete
 
-**Parallel safety:** Only tasks within same wave run in parallel. Tasks in Wave N+1 wait for Wave N.
+**Parallel safety:** Only tasks within same wave run in parallel. Tasks must NOT share files. Tasks in Wave N+1 wait for Wave N.
 
 ### Phase 3A: PRD Task Loop (Sequential Fallback)
 

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

@@ -1,83 +1,73 @@
 {
-  "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-  "enabled": true,
-  "debug": false,
-  // "minimal" shows prune activity without noise; "detailed" shows token counts
-  "pruneNotification": "detailed",
-  // "chat" (in-conversation) or "toast" (system notification)
-  "pruneNotificationType": "toast",
-  // Commands: /dcp context, /dcp stats, /dcp sweep
-  "commands": {
-    "enabled": true,
-    // Protect these from /dcp sweep
-    "protectedTools": ["observation", "memory-update", "memory-search"],
-  },
-  "turnProtection": {
-    "enabled": true,
-    "turns": 4,
-  },
-  // Protected file patterns - never auto-prune reads of these files
-  "protectedFilePatterns": [
-    "**/.env*",
-    "**/AGENTS.md",
-    "**/.opencode/**",
-    "**/.beads/**",
-    "**/package.json",
-    "**/tsconfig.json",
-    "**/biome.json",
-  ],
-  "tools": {
-    "settings": {
-      "nudgeEnabled": true,
-      "nudgeFrequency": 10,
-      // v2.0.1: percentage support - 80% of model's context (most models = 128k)
-      "contextLimit": "80%",
-      // Protect state-modifying and critical workflow tools
-      // LSP excluded: ephemeral exploration, prune after understanding
-      "protectedTools": [
-        "write",
-        "edit",
-        "memory-update",
-        "observation",
-        "skill",
-        "skill_mcp",
-        "task",
-        "batch",
-        "todowrite",
-        "todoread",
-      ],
-    },
-    // v2.0.0: permission model - "allow", "ask", or "deny"
-    "prune": {
-      "permission": "allow",
-    },
-    "distill": {
-      "permission": "allow",
-      "showDistillation": false,
-    },
-    "compress": {
-      // v2.1.1: compress can have boundary matching issues - use ask for safety
-      "permission": "allow",
-      "showCompression": false,
-    },
-  },
-  // Auto strategies - TOP LEVEL, not under tools
-  "strategies": {
-    // Dedup = zero LLM cost, high impact - always enable
-    "deduplication": {
-      "enabled": true,
-      "protectedTools": [],
-    },
-    // Supersede writes = zero cost, removes redundant write inputs after read
-    // Note: default changed to false in beta, we explicitly enable
-    "supersedeWrites": {
-      "enabled": true,
-    },
-    // Purge error inputs after N turns
-    "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,
+	// "minimal" shows prune activity without noise; "detailed" shows token counts
+	"pruneNotification": "detailed",
+	// "chat" (in-conversation) or "toast" (system notification)
+	"pruneNotificationType": "toast",
+	// Commands: /dcp context, /dcp stats, /dcp sweep, /dcp decompress, /dcp recompress
+	"commands": {
+		"enabled": true,
+		// Protect these from /dcp sweep
+		"protectedTools": ["observation", "memory-update", "memory-search"]
+	},
+	"turnProtection": {
+		"enabled": true,
+		"turns": 4
+	},
+	// Protected file patterns - never auto-prune reads of these files
+	"protectedFilePatterns": [
+		"**/.env*",
+		"**/AGENTS.md",
+		"**/.opencode/**",
+		"**/.beads/**",
+		"**/package.json",
+		"**/tsconfig.json",
+		"**/biome.json"
+	],
+	"compress": {
+		// v2.2.x beta: compress is the primary context management tool
+		"permission": "allow",
+		"showCompression": false,
+		"maxContextLimit": "80%",
+		"minContextLimit": 30000,
+		"flatSchema": false,
+		"protectUserMessages": true,
+		"protectedTools": [
+			"write",
+			"edit",
+			"memory-*",
+			"observation",
+			"skill",
+			"skill_mcp",
+			"task",
+			"batch",
+			"todowrite",
+			"todoread",
+			"tilth_*"
+		]
+	},
+	// v2.2.5-beta0: experimental subagent support
+	"experimental": {
+		"allowSubAgents": true
+	},
+	// Auto strategies - TOP LEVEL, not under tools
+	"strategies": {
+		// Dedup = zero LLM cost, high impact - always enable
+		"deduplication": {
+			"enabled": true,
+			"protectedTools": []
+		},
+		// Supersede writes = zero cost, removes redundant write inputs after read
+		"supersedeWrites": {
+			"enabled": true
+		},
+		// Purge error inputs after N turns
+		"purgeErrors": {
+			"enabled": true,
+			"turns": 4,
+			"protectedTools": []
+		}
+	}
 }

package/dist/template/.opencode/memory/project/gotchas.md

@@ -38,10 +38,10 @@ The edit tool (`str_replace`) is the #1 source of failures in LLM coding. Models
 
 ### Context Hygiene
 
-- Distill large tool outputs immediately after use
-- Prune irrelevant reads before proceeding
+- Compress completed work phases before moving on
+- Use `/dcp sweep` after a closed phase to remove stale noise
 - Token budget: <50k start → 50-100k mid → >150k restart session
-- Subagent outputs can leak tokens — be aggressive about distilling
+- Subagent outputs can leak tokens — compress completed phases and sweep stale subagent noise
 
 ## OpenCode Config
 

package/dist/template/.opencode/opencode.json

@@ -151,7 +151,7 @@
 		}
 	},
 	"plugin": [
-		"@tarquinen/opencode-dcp@latest",
+		"@tarquinen/opencode-dcp@beta",
 		"@franlol/opencode-md-table-formatter@0.0.3",
 		"openslimedit@latest"
 	],

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.2.21"
+    "@opencode-ai/plugin": "1.2.22"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",