opencodekit 0.12.0 → 0.12.2

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

@@ -1,13 +1,16 @@
 ---
 purpose: Code patterns, commit style, PR process, team conventions
-updated: 2024-12-21
+updated: 2025-01-05
 ---
 
 # Project Conventions
 
 ## Code Style
 
-<!-- Naming conventions, formatting rules, import ordering -->
+- **TypeScript**: ES2022, ESNext modules, strict disabled, forceConsistentCasing
+- **Python**: 3.10+, type hints required, dataclasses for config, pathlib for paths
+- **Imports**: Group stdlib, third-party, local imports
+- **Naming**: PascalCase classes, snake_case functions/variables, UPPER_CASE constants
 
 ## Commit Messages
 
@@ -17,10 +20,106 @@ updated: 2024-12-21
 
 <!-- Review requirements, CI checks, merge strategy -->
 
-## Patterns to Follow
+## OpenCode Configuration Patterns (v1.1.2+)
 
-<!-- Recurring patterns in this codebase -->
+### Permission Structure Best Practice
+
+```jsonc
+{
+  "permission": {
+    "bash": {
+      "*": "allow", // 1. Base rule first (catch-all)
+      "git status*": "allow", // 2. Safe operations whitelisted
+      "git diff*": "allow",
+      "npm *": "allow",
+      "rm*": "deny", // 3. Dangerous operations denied
+      "sudo*": "deny",
+    },
+    "read": {
+      ".env": "deny", // 4. Protect secrets
+      ".env.example": "allow", //    But allow examples
+    },
+  },
+}
+```
+
+### LSP Tool Strategy
+
+**This project uses built-in experimental LSP** (`experimental.lsp: true`).
+
+| Tool                        | Purpose                      |
+| --------------------------- | ---------------------------- |
+| `lsp_lsp_hover`             | Type info and docs at cursor |
+| `lsp_lsp_goto_definition`   | Jump to symbol definition    |
+| `lsp_lsp_find_references`   | Find all usages              |
+| `lsp_lsp_rename`            | Rename across codebase       |
+| `lsp_lsp_code_actions`      | Get available refactorings   |
+| `lsp_lsp_code_action_apply` | Apply a code action          |
+| `lsp_lsp_diagnostics`       | Get errors/warnings          |
+| `lsp_lsp_document_symbols`  | File outline                 |
+| `lsp_lsp_workspace_symbols` | Search symbols               |
+| `lsp_lsp_organize_imports`  | Clean up imports             |
+
+### DCP Configuration Tiers
+
+| Tier             | Strategies         | nudgeFrequency | turnProtection | Use When                     |
+| ---------------- | ------------------ | -------------- | -------------- | ---------------------------- |
+| **Aggressive**   | All enabled        | 8              | 3              | Long sessions, context-heavy |
+| **Conservative** | Deduplication only | 12+            | 6+             | Safety-first, debugging      |
+| **Balanced**     | All enabled        | 10             | 4              | Default, general use         |
+
+### Protected Tools Pattern
+
+Always protect these tools from auto-pruning:
+
+```jsonc
+"protectedTools": [
+  // State-modifying
+  "write", "edit", "skill_mcp", "bd_sync",
+  // Metadata
+  "memory-search", "memory-update", "observation", "todowrite", "todoread",
+  // Task management
+  "task", "batch",
+  // LSP (if using plugin)
+  "lsp_lsp_find_references", "lsp_lsp_goto_definition"
+]
+```
 
 ## Patterns to Avoid
 
-<!-- Anti-patterns specific to this project -->
+### Anti-Pattern: Mixing LSP Systems
+
+```jsonc
+// DON'T: Causes tool duplication and naming confusion
+{
+  "experimental": { "lsp": true },  // Built-in: lsp_lsp_*
+  // AND .opencode/tool/lsp.ts      // Custom: lsp_*
+}
+
+// DO: Use built-in only (recommended for this project)
+{
+  "experimental": { "lsp": true }
+}
+// Delete any custom .opencode/tool/lsp.ts
+```
+
+### Anti-Pattern: Over-Restrictive Permissions
+
+```jsonc
+// DON'T: Blocks legitimate workflow
+{
+  "bash": { "git *": "ask" }  // Every git command asks
+}
+
+// DO: Whitelist safe, ask dangerous
+{
+  "bash": {
+    "git status*": "allow",
+    "git diff*": "allow",
+    "git log*": "allow",
+    "git commit*": "ask",
+    "git push*": "ask",
+    "git reset*": "ask"
+  }
+}
+```

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

@@ -1,26 +1,60 @@
 ---
 purpose: Footguns, edge cases, and "don't forget this" warnings
-updated: 2024-12-21
+updated: 2025-01-05
 ---
 
 # Project Gotchas
 
-## Code That Looks Right But Breaks
+## Configuration Quirks
+
+### DCP v1.1.3 Schema Breaking Changes
+
+1. **Legacy `strategies.onIdle` removed**: v1.1.2+ no longer supports this field
+   - Error: `Unknown keys: strategies.onIdle`
+   - Fix: Remove the entire `onIdle` block from `dcp.jsonc`
 
-<!-- Subtle bugs, misleading APIs -->
+2. **Permission model changed**: v1.1.1+ deprecated legacy `tools: { write: true }` boolean syntax
+   - Old: Global `tools: {}` with booleans
+   - New: `permission: {}` with `"allow"` / `"ask"` / `"deny"` actions
+   - Both still work for backwards compatibility, but new syntax preferred
+
+### OpenCode v1.1.2 New Features
+
+- `compaction.auto` and `compaction.prune` are NEW - enable both for long sessions
+- `experimental.continue_loop_on_deny` - controls agent behavior after permission denial
+- `cargo-fmt` formatter support added for Rust projects
 
 ## Non-Obvious Dependencies
 
-<!-- Hidden coupling, initialization order -->
+### LSP Tool Naming Convention
 
-## Configuration Quirks
+- OpenCode built-in LSP uses `lsp_lsp_*` prefix (e.g., `lsp_lsp_rename`, `lsp_lsp_hover`)
+- Requires `experimental.lsp: true` in opencode.json
+- **This project uses built-in LSP** (custom plugin removed for simplicity)
+- Custom plugins would use `lsp_*` prefix - avoid mixing both
 
-<!-- Environment variables, config files that bite -->
+### Protected Tools in DCP
+
+v1.1.3 recognizes more tool variants. Ensure these are protected:
+
+- `lsp_lsp_find_references`, `lsp_lsp_goto_definition` (plugin-specific naming)
+- `memory-search`, `skill_mcp`, `bd_sync` (often forgotten)
 
 ## Time Wasters
 
-<!-- Things that will waste 2+ hours if you forget -->
+### Debugging DCP Errors
+
+If DCP plugin throws "Unknown keys" errors:
+
+1. Check OpenCode version (`opencode --version`)
+2. Compare against [DCP schema](https://github.com/opencode/dcp) for your version
+3. Remove deprecated fields - don't try to "fix" them
+
+### Permission Debugging
 
-## Platform-Specific Issues
+If tools are unexpectedly blocked:
 
-<!-- macOS vs Linux, Node versions, etc. -->
+1. Check global config: `~/.config/opencode/opencode.json`
+2. Check project config: `.opencode/opencode.json`
+3. Project config takes precedence
+4. Use `"*": "ask"` as base rule to debug which pattern is matching

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

@@ -41,16 +41,26 @@
 		}
 	},
 	"autoupdate": false,
+	"compaction": {
+		"auto": true,
+		"prune": true
+	},
 	"experimental": {
 		"batch_tool": true,
 		"chatMaxRetries": 2,
-		"primary_tools": ["edit", "write", "bash", "prune"]
+		"continue_loop_on_deny": false,
+		"lsp": true,
+		"primary_tools": ["edit", "write", "bash"]
 	},
 	"formatter": {
 		"biome": {
 			"command": ["npx", "@biomejs/biome", "check", "--write", "$FILE"],
 			"extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
 		},
+		"cargo-fmt": {
+			"command": ["cargo", "fmt", "--", "$FILE"],
+			"extensions": [".rs"]
+		},
 		"java-formatter": {
 			"command": ["google-java-format", "--replace", "$FILE"],
 			"environment": {
@@ -92,14 +102,32 @@
 	"model": "github-copilot/claude-haiku-4.5",
 	"permission": {
 		"bash": {
+			"*": "allow",
+			"git status *": "allow",
+			"git diff *": "allow",
+			"git log *": "allow",
+			"git branch *": "allow",
+			"npm *": "allow",
+			"npx *": "allow",
+			"ls *": "allow",
+			"cat *": "allow",
 			"git commit *": "ask",
 			"git push *": "ask",
-			"rm *": "ask",
-			"rm -rf *": "ask"
+			"git reset *": "ask",
+			"git rebase *": "ask",
+			"rm *": "deny",
+			"rm -rf *": "deny",
+			"sudo *": "deny"
 		},
 		"doom_loop": "ask",
 		"edit": "allow",
-		"external_directory": "allow"
+		"external_directory": "ask",
+		"read": {
+			"*": "allow",
+			"*.env": "deny",
+			"*.env.*": "deny",
+			"*.env.example": "allow"
+		}
 	},
 	"plugin": [
 		"@tarquinen/opencode-dcp@latest",
@@ -217,7 +245,14 @@
 						"context": 880964,
 						"output": 65536
 					},
-					"name": "Gemini 3 Flash Preview"
+					"name": "Gemini 3 Flash Preview",
+					"options": {
+						"thinking": {
+							"budgetTokens": 24576,
+							"type": "enabled"
+						}
+					},
+					"reasoning": true
 				},
 				"gemini-3-pro-image-preview": {
 					"limit": {
@@ -231,7 +266,14 @@
 						"context": 880964,
 						"output": 65536
 					},
-					"name": "Gemini 3 Pro Preview"
+					"name": "Gemini 3 Pro Preview",
+					"options": {
+						"thinking": {
+							"budgetTokens": 24576,
+							"type": "enabled"
+						}
+					},
+					"reasoning": true
 				},
 				"gemini-claude-opus-4-5-thinking": {
 					"limit": {
@@ -450,17 +492,6 @@
 	},
 	"share": "manual",
 	"small_model": "opencode/gpt-5-nano",
-	"permission": {
-		"bash": {
-			"git commit *": "ask",
-			"git push *": "ask",
-			"rm *": "ask",
-			"rm -rf *": "ask"
-		},
-		"doom_loop": "ask",
-		"edit": "allow",
-		"external_directory": "allow"
-	},
 	"tui": {
 		"diff_style": "auto",
 		"scroll_acceleration": {

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

@@ -11,7 +11,7 @@
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"@opencode-ai/plugin": "1.1.1"
+		"@opencode-ai/plugin": "1.1.2"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.3",