opencodekit 0.12.1 → 0.12.2

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.12.1",
+  version: "0.12.2",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

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

@@ -36,7 +36,7 @@ Codebase complexity is a primary difficulty knob. Context is how you pay it down
 
 **Practical implications:**
 
-- Prefer `lsp_document_symbols` over reading entire files
+- Prefer `lsp_lsp_document_symbols` over reading entire files
 - Read specific line ranges, not whole documents
 - Navigate AGENTS.md hierarchy: root → subsystem → details (progressive disclosure)
 - Prune context aggressively; completed work doesn't need to stay loaded
@@ -217,51 +217,51 @@ Ask yourself: **"Am I looking for code structure or just text?"**
 
 **Use LSP tools when you need to:**
 
-- Understand what a symbol is → `lsp_hover`
-- Jump to where something is defined → `lsp_goto_definition`
-- Find all usages before refactoring → `lsp_find_references`
-- Rename across the entire codebase → `lsp_rename`
+- Understand what a symbol is → `lsp_lsp_hover`
+- Jump to where something is defined → `lsp_lsp_goto_definition`
+- Find all usages before refactoring → `lsp_lsp_find_references`
+- Rename across the entire codebase → `lsp_lsp_rename`
 
 **Rule**: Always `read` before `edit` to verify content.
 
 ### LSP Tools (10 tools)
 
-Semantic code intelligence via Language Server Protocol:
+Semantic code intelligence via Language Server Protocol. **Uses `lsp_lsp_*` prefix** (built-in experimental).
 
 **Navigation & Understanding:**
 
-- `lsp_hover(filePath, line, character)` - Get type info and docs at cursor
-- `lsp_goto_definition(filePath, line, character)` - Jump to where symbol is defined
-- `lsp_find_references(filePath, line, character)` - Find all usages of a symbol
-- `lsp_document_symbols(filePath)` - Get file outline (classes, functions, etc.)
-- `lsp_workspace_symbols(query, filePath)` - Fuzzy search symbols across workspace
+- `lsp_lsp_hover(filePath, line, character)` - Get type info and docs at cursor
+- `lsp_lsp_goto_definition(filePath, line, character)` - Jump to where symbol is defined
+- `lsp_lsp_find_references(filePath, line, character)` - Find all usages of a symbol
+- `lsp_lsp_document_symbols(filePath)` - Get file outline (classes, functions, etc.)
+- `lsp_lsp_workspace_symbols(query, filePath)` - Fuzzy search symbols across workspace
 
 **Diagnostics:**
 
-- `lsp_diagnostics(filePath, severity?)` - Get errors/warnings from language server
+- `lsp_lsp_diagnostics(filePath, severity?)` - Get errors/warnings from language server
 
 **Refactoring:**
 
-- `lsp_rename(filePath, line, character, newName)` - Rename symbol across codebase
-- `lsp_code_actions(filePath, startLine, startChar, endLine, endChar)` - Get available refactorings
-- `lsp_code_action_apply(...)` - Apply a specific code action
-- `lsp_organize_imports(filePath)` - Clean up and sort imports
+- `lsp_lsp_rename(filePath, line, character, newName)` - Rename symbol across codebase
+- `lsp_lsp_code_actions(filePath, startLine, startChar, endLine, endChar)` - Get available refactorings
+- `lsp_lsp_code_action_apply(...)` - Apply a specific code action
+- `lsp_lsp_organize_imports(filePath)` - Clean up and sort imports
 
 **When to use each tool:**
 
-**"What type is this variable?"** → Use `lsp_hover` to see type signature without reading the entire definition file.
+**"What type is this variable?"** → Use `lsp_lsp_hover` to see type signature without reading the entire definition file.
 
-**"Where is this function defined?"** → Use `lsp_goto_definition` to jump directly to source instead of grepping.
+**"Where is this function defined?"** → Use `lsp_lsp_goto_definition` to jump directly to source instead of grepping.
 
-**"What uses this function?"** → Use `lsp_find_references` before changing anything to see all call sites.
+**"What uses this function?"** → Use `lsp_lsp_find_references` before changing anything to see all call sites.
 
-**"What's in this file?"** → Use `lsp_document_symbols` for a quick outline without reading the entire file.
+**"What's in this file?"** → Use `lsp_lsp_document_symbols` for a quick outline without reading the entire file.
 
-**"Where is UserService defined?"** → Use `lsp_workspace_symbols` to fuzzy search across all files.
+**"Where is UserService defined?"** → Use `lsp_lsp_workspace_symbols` to fuzzy search across all files.
 
-**"Are there type errors?"** → Use `lsp_diagnostics` to check before running tests.
+**"Are there type errors?"** → Use `lsp_lsp_diagnostics` to check before running tests.
 
-**"Rename this function safely"** → Use `lsp_rename` to update all references automatically.
+**"Rename this function safely"** → Use `lsp_lsp_rename` to update all references automatically.
 
 **Caveat**: LSP tools modify files directly. Re-read files before further edits.
 

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

@@ -35,9 +35,9 @@ File search specialist. Navigate and explore codebases efficiently.
 
 **Progressive disclosure**: Start broad, narrow based on findings.
 
-1. Use `lsp_workspace_symbols` or `lsp_document_symbols` to understand structure without reading whole files
-2. Use `lsp_goto_definition` to jump directly to source instead of grepping
-3. Use `lsp_find_references` to map usage before returning
+1. Use `lsp_lsp_workspace_symbols` or `lsp_lsp_document_symbols` to understand structure without reading whole files
+2. Use `lsp_lsp_goto_definition` to jump directly to source instead of grepping
+3. Use `lsp_lsp_find_references` to map usage before returning
 4. Only `read` the specific lines that matter
 
 **Avoid blind exploration**: Don't grep for generic terms. Use semantic tools first.
@@ -52,8 +52,8 @@ File search specialist. Navigate and explore codebases efficiently.
 
 ## Thoroughness Levels
 
-**Quick**: Single ast-grep, lsp_workspace_symbols, or glob. Read 1-3 files. Return immediately.
+**Quick**: Single ast-grep, lsp_lsp_workspace_symbols, or glob. Read 1-3 files. Return immediately.
 
-**Medium**: AST-grep + LSP verification. Check 2-3 naming conventions. Read 3-5 files. Use `lsp_find_references` to trace usage.
+**Medium**: AST-grep + LSP verification. Check 2-3 naming conventions. Read 3-5 files. Use `lsp_lsp_find_references` to trace usage.
 
-**Very Thorough**: Comprehensive search across multiple terms and locations. Use `lsp_find_references` to build dependency map. Report with file:line references.
+**Very Thorough**: Comprehensive search across multiple terms and locations. Use `lsp_lsp_find_references` to build dependency map. Report with file:line references.

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

@@ -97,7 +97,7 @@ grep({ pattern: "[related concept]", include: "*.ts" });
 ast - grep({ pattern: "[code pattern]" });
 
 // Understand existing architecture
-lsp_document_symbols({ filePath: "<relevant file>" });
+lsp_lsp_document_symbols({ filePath: "<relevant file>" });
 ```
 
 For each promising idea, note:

package/dist/template/.opencode/command/fix-types.md

@@ -78,14 +78,14 @@ Files affected: [N]
 Get errors with full context:
 
 ```typescript
-lsp_diagnostics({ filePath: "<file>", severity: "error" });
+lsp_lsp_diagnostics({ filePath: "<file>", severity: "error" });
 ```
 
 For each file with errors:
 
 ```typescript
-lsp_hover({ filePath: "<file>", line: N, character: N }); // Understand types
-lsp_goto_definition({ filePath: "<file>", line: N, character: N }); // Find source
+lsp_lsp_hover({ filePath: "<file>", line: N, character: N }); // Understand types
+lsp_lsp_goto_definition({ filePath: "<file>", line: N, character: N }); // Find source
 ```
 
 ## Phase 4: Categorize Errors

package/dist/template/.opencode/command/new-feature.md

@@ -39,7 +39,7 @@ bd_ls({ status: "all", limit: 20, offset: 0 })
 
 # Analyze codebase structure
 glob pattern="src/**/*.{ts,tsx,py}"
-lsp_workspace_symbols({ query: "[relevant-terms]" })
+lsp_lsp_workspace_symbols({ query: "[relevant-terms]" })
 
 # Check recent changes in related areas
 git log --oneline -10 -- src/[relevant-path]/

package/dist/template/.opencode/command/research-ui.md

@@ -68,7 +68,7 @@ const parseTarget = (input: string) => {
 glob({ pattern: `${path}/**/*.{tsx,jsx,css,scss,vue,svelte}` });
 
 // Analyze component structure
-lsp_document_symbols({ filePath: mainComponentFile });
+lsp_lsp_document_symbols({ filePath: mainComponentFile });
 
 // Search for styling patterns
 ast_grep({ pattern: "className={$$$}", path });

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

@@ -88,9 +88,9 @@ Prioritize sources in this order:
 
 ```typescript
 // Semantic understanding
-lsp_find_references({ filePath: "<file>", line: N, character: N });
-lsp_hover({ filePath: "<file>", line: N, character: N });
-lsp_document_symbols({ filePath: "<file>" });
+lsp_lsp_find_references({ filePath: "<file>", line: N, character: N });
+lsp_lsp_hover({ filePath: "<file>", line: N, character: N });
+lsp_lsp_document_symbols({ filePath: "<file>" });
 
 // Pattern search
 ast-grep({ pattern: "<code pattern>" });

package/dist/template/.opencode/command/review-codebase.md

@@ -31,7 +31,7 @@ Run these checks first (batch for speed):
 
 ```
 # Type/lint errors
-lsp_diagnostics() for each changed file
+lsp_lsp_diagnostics() for each changed file
 npm run type-check || tsc --noEmit
 npm run lint || true
 

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

@@ -1,32 +1,31 @@
 {
-	// Enable or disable the plugin
 	"enabled": true,
-	// Enable debug logging to ~/.config/opencode/logs/dcp/
 	"debug": false,
-	// Notification display: "off", "minimal", or "detailed"
+	// "minimal" shows prune activity without noise; "off" if you want silence
 	"pruneNotification": "off",
-	// Protect from pruning for <turns> message turns
 	"turnProtection": {
 		"enabled": true,
-		"turns": 4
+		// 3 turns = faster cleanup while still protecting recent context
+		"turns": 3
 	},
-	// 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 (defaults: task, todowrite, todoread, discard, extract, batch)
+			// Nudge every 8 tool calls (slightly more aggressive than default 10)
+			"nudgeFrequency": 8,
+			// Protect state-modifying and critical workflow tools
 			"protectedTools": [
 				"write",
 				"edit",
 				"memory-read",
 				"memory-update",
+				"memory-search",
 				"observation",
 				"skill",
-				"lsp",
+				"skill_mcp",
 				"lsp_lsp_rename",
+				"lsp_lsp_find_references",
+				"lsp_lsp_goto_definition",
 				"lsp_lsp_code_actions",
 				"lsp_lsp_code_action_apply",
 				"lsp_lsp_organize_imports",
@@ -35,49 +34,33 @@
 				"bd_done",
 				"bd_show",
 				"bd_reserve",
-				"bd_reservations"
+				"bd_reservations",
+				"bd_sync"
 			]
 		},
-		// 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
 		}
 	},
-	// Automatic pruning strategies
 	"strategies": {
-		// Remove duplicate tool calls (same tool with same arguments)
+		// Dedup = zero LLM cost, high impact - always enable
 		"deduplication": {
 			"enabled": true,
-			// Additional tools to protect from pruning
 			"protectedTools": []
 		},
-		// Prune write tool inputs when the file has been subsequently read
+		// Supersede writes = zero cost, removes redundant write inputs after read
 		"supersedeWrites": {
 			"enabled": true
 		},
-		// Prune tool inputs for errored tools after X turns
+		// Purge error inputs after 3 turns
 		"purgeErrors": {
 			"enabled": true,
-			// Number of turns before errored tool inputs are pruned
-			"turns": 4,
-			// Additional tools to protect from pruning
+			"turns": 3,
 			"protectedTools": []
-		},
-		// (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": [],
-			// Show toast notifications when model selection fails
-			"showModelErrorToasts": true,
-			// When true, fallback models are not permitted
-			"strictModelSelection": false
 		}
 	}
 }

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

@@ -1,17 +1,23 @@
 ---
 purpose: Build, test, lint, deploy commands discovered for this project
-updated: 2024-12-21
+updated: 2025-01-05
 ---
 
 # Project Commands
 
 ## Build
 
-<!-- npm run build, make, cargo build, etc. -->
+```bash
+npm run type-check    # TypeScript type checking only (no emit)
+```
 
 ## Test
 
-<!-- npm test, pytest, cargo test, etc. -->
+```bash
+pytest tests/ -v                    # Run all Python tests
+pytest tests/test_specific.py -v    # Run single test file
+pytest tests/ --cov=. --cov-report=html  # Coverage report
+```
 
 ## Lint
 
@@ -21,6 +27,39 @@ updated: 2024-12-21
 
 <!-- Deployment commands if applicable -->
 
-## Other
+## OpenCode Configuration
 
-<!-- Project-specific commands worth remembering -->
+### Environment Variables
+
+```bash
+OPENCODE_EXPERIMENTAL=true              # Enable experimental features (LSP, batch)
+OPENCODE_EXPERIMENTAL_LSP_TOOL=true     # Enable built-in LSP navigation tool
+OPENCODE_DISABLE_LSP_DOWNLOAD=true      # Skip auto-downloading LSP servers
+OPENCODE_DISABLE_AUTOCOMPACT=true       # Disable automatic session compaction
+OPENCODE_DISABLE_PRUNE=true             # Disable DCP pruning
+```
+
+### Configuration File Priorities
+
+1. Global: `~/.config/opencode/opencode.json` or `dcp.jsonc`
+2. Config Dir: `$OPENCODE_CONFIG_DIR/opencode.json`
+3. Project: `.opencode/opencode.json` (highest priority)
+
+### DCP Nudge Tuning
+
+```jsonc
+// Lower nudgeFrequency = more aggressive pruning suggestions
+"nudgeFrequency": 8    // LLM nudged every 8 tool calls (default: 10)
+```
+
+## Beads Workflow
+
+```bash
+bd ready              # Show issues ready to work (no blockers)
+bd list --status=open # All open issues
+bd show <id>          # Full issue details with dependencies
+bd create --title="..." --type=task --priority=2
+bd update <id> --status=in_progress
+bd close <id> --reason="Completed"
+bd sync               # Commit and push changes
+```

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