opencodekit 0.14.0 → 0.14.2

package/dist/template/.opencode/memory/observations/2026-01-09-pattern-ampcode-mcp-json-includetools-pattern.md

@@ -0,0 +1,42 @@
+---
+type: pattern
+created: 2026-01-09T08:04:40.257Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["mcp", "includeTools", "ampcode", "skill", "token-optimization", "lazy-load", "filtering"]
+---
+
+# 🔄 Ampcode mcp.json includeTools pattern
+
+🟢 **Confidence:** high
+
+Learned from Ampcode's ui-preview skill (https://github.com/ampcode/amp-contrib/tree/main/.agents/skills/ui-preview):
+
+## Pattern: Lazy-load MCP with includeTools filtering
+
+1. **mcp.json file** (separate from SKILL.md):
+```json
+{
+  "chrome-devtools": {
+    "command": "npx",
+    "args": ["-y", "chrome-devtools-mcp@latest"],
+    "includeTools": ["navigate_page", "take_screenshot", "new_page", "list_pages"]
+  }
+}
+```
+
+2. **SKILL.md documents ONLY filtered tools**:
+- "Available Tools" section lists only the filtered tools
+- Workflow examples use only those tools
+- Note at bottom explains how to expand filter if needed
+
+3. **Token savings**: ~90% reduction (4 tools vs 26+ for chrome-devtools)
+
+## Applied to OpenCodeKit:
+- chrome-devtools: 11 tools (from 26+) 
+- playwright: 8 tools (from 17+)
+- Other MCP skills already minimal (2-4 tools), no filtering needed
+
+## Key insight:
+SKILL.md and mcp.json must be synchronized - don't document tools that aren't in includeTools filter, or agents get confused.

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

@@ -111,10 +111,60 @@ This transforms passive detection into active agent behavior (e.g., Memory plugi
 
 ## Agent Behavior Rules
 
-### Active LSP Nudge
+### MANDATORY LSP-First Workflow
 
-When a tool output displays `[LSP NAVIGATION AVAILABLE]`, it means relevant code files were found.
-**Rule**: You MUST immediately execute the suggested `lsp_lsp_*` tool calls to retrieve code context without waiting for user instruction. This ensures you always have the latest code context for your implementation.
+**HARD RULE**: Before editing ANY code file, you MUST use LSP tools first.
+
+```
+grep/read → LSP → understand → THEN edit
+```
+
+**After EVERY grep/glob/read that returns code files:**
+
+1. **IMMEDIATELY** call `lsp` with `documentSymbol` to understand file structure
+2. **IMMEDIATELY** call `lsp` with `findReferences` on symbols you'll modify
+3. **IMMEDIATELY** call `lsp` with `goToDefinition` to trace dependencies
+4. **USE** additional LSP operations as needed:
+   - `hover` - Get type info and documentation
+   - `goToImplementation` - Find implementations of interface/abstract
+   - `workspaceSymbol` - Search symbols across entire workspace
+   - `prepareCallHierarchy` - Get call hierarchy item at position
+   - `incomingCalls` - Find what calls this function
+   - `outgoingCalls` - Find what this function calls
+5. **ONLY THEN** proceed with edits
+
+**Example - The Correct Flow:**
+
+```
+User: "Fix the auth bug in src/auth.ts"
+
+# Step 1: Read the file
+read({ filePath: "src/auth.ts" })
+
+# Step 2: MANDATORY LSP (before ANY edit) - use ALL relevant operations
+lsp({ operation: "documentSymbol", filePath: "src/auth.ts", line: 1, character: 1 })
+lsp({ operation: "findReferences", filePath: "src/auth.ts", line: 42, character: 10 })
+lsp({ operation: "goToDefinition", filePath: "src/auth.ts", line: 42, character: 10 })
+lsp({ operation: "hover", filePath: "src/auth.ts", line: 42, character: 10 })
+lsp({ operation: "incomingCalls", filePath: "src/auth.ts", line: 42, character: 10 })
+lsp({ operation: "outgoingCalls", filePath: "src/auth.ts", line: 42, character: 10 })
+
+# Step 3: NOW you can edit
+edit({ filePath: "src/auth.ts", ... })
+```
+
+**Why This Matters:**
+
+- LSP gives you semantic understanding (types, references, call hierarchy)
+- grep/read only gives you text (no understanding of relationships)
+- Editing without LSP context leads to broken refactors
+
+**Violations:**
+
+- ❌ `read → edit` (WRONG - no LSP)
+- ❌ `grep → edit` (WRONG - no LSP)
+- ✅ `read → LSP → edit` (CORRECT)
+- ✅ `grep → read → LSP → edit` (CORRECT)
 
 ## Patterns to Avoid
 

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

@@ -1,12 +1,46 @@
 ---
 purpose: Footguns, edge cases, and "don't forget this" warnings
-updated: 2025-01-05
+updated: 2025-01-09
 ---
 
 # Project Gotchas
 
 ## Configuration Quirks
 
+### OpenCode v1.1.7 → v1.1.8 Changes
+
+**v1.1.7 Features:**
+
+- **Question tool**: New interactive tool for gathering user preferences/clarifying instructions
+- **Config precedence fix**: Local `.opencode/opencode.json` now correctly overrides remote/global config
+- **`.claude` loading toggle**: Can disable via `--no-claude-prompts` / `--no-claude-skills` flags
+- **Task tool filtering**: Simplified subagent filtering
+
+**v1.1.8 Features:**
+
+- **Multi-select questions**: Question tool now supports `multiple: true` for multi-select
+- **Performance**: Chunked message loading, lazy diff rendering
+- **Full path fuzzy matching**: Autocomplete uses full file paths
+- **OpenTUI v0.1.70**: UI improvements
+
+**Plugin SDK Update Required:**
+
+```json
+"@opencode-ai/plugin": "^1.1.8"  // Was ^1.1.2
+```
+
+### DCP Protected Tools (v1.1.8)
+
+Legacy `bd_*` tool names don't exist - use actual custom tool names:
+
+| Old (Wrong)       | New (Correct) |
+| ----------------- | ------------- |
+| `bd_init`         | N/A (use CLI) |
+| `bd_claim`        | N/A (use CLI) |
+| `bd_reserve`      | `bd-reserve`  |
+| `bd_reservations` | `bd-release`  |
+| `bd_sync`         | N/A (use CLI) |
+
 ### DCP v1.1.3 Schema Breaking Changes
 
 1. **Legacy `strategies.onIdle` removed**: v1.1.2+ no longer supports this field
@@ -35,10 +69,23 @@ updated: 2025-01-05
 
 ### 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)
+v1.1.8 recognizes more tool variants. Ensure these are protected:
+
+```jsonc
+"protectedTools": [
+  // State-modifying
+  "write", "edit", "question",
+  // Memory/observation
+  "memory-read", "memory-update", "memory-search", "observation",
+  // Skills/tasks
+  "skill", "skill_mcp", "task", "batch", "todowrite", "todoread",
+  // LSP
+  "lsp", "lsp_lsp_rename", "lsp_lsp_find_references", "lsp_lsp_goto_definition",
+  "lsp_lsp_code_actions", "lsp_lsp_code_action_apply", "lsp_lsp_organize_imports",
+  // Beads (custom tools only - CLI uses bash)
+  "bd-reserve", "bd-release", "bd-msg", "bd-inbox"
+]
+```
 
 ## Time Wasters