opencodekit 0.12.1 → 0.12.3

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

@@ -17,7 +17,7 @@ Analyze open tasks and optimize prioritization using dependency graph analysis,
 ## Phase 1: Initialize Beads Connection
 
 ```typescript
-bd_init({ _: true, team: "project", role: "triage" });
+bd_init({ team: "project", role: "build" });
 ```
 
 ## Phase 2: Gather Workspace State
@@ -27,7 +27,7 @@ Run in parallel:
 ```typescript
 bd_status({ include_agents: true });
 bd_ls({ status: "open", limit: 50, offset: 0 });
-bd_reservations({ reason: "Check active file locks" });
+bd_reservations();
 bd_inbox({ n: 10, unread: true, global: true });
 
 // Search for past discussions on recurring issues
@@ -199,14 +199,14 @@ AGENT WORKLOAD
 ━━━━━━━━━━━━━━
 Agent     │ Active │ Completed │ Load
 ──────────┼────────┼───────────┼──────
-fe-agent  │ 2      │ 8         │ HIGH
-be-agent  │ 1      │ 12        │ MEDIUM
-qa-agent  │ 0      │ 5         │ LOW
+build-1   │ 2      │ 8         │ HIGH
+build-2   │ 1      │ 12        │ MEDIUM
+review    │ 0      │ 5         │ LOW
 
 RECOMMENDATIONS
 ━━━━━━━━━━━━━━━
-1. 🔴 URGENT: bd-abc12 is blocking 4 tasks - assign to be-agent
-2. 🟡 REBALANCE: fe-agent has high load - redistribute to qa-agent
+1. 🔴 URGENT: bd-abc12 is blocking 4 tasks - assign to build agent
+2. 🟡 REBALANCE: build-1 has high load - redistribute to review agent
 3. 🟢 PARALLEL: Start Track A and B simultaneously
 4. ⚠️  STALE: bd-old99 has no activity for 7 days - review or close
 
@@ -221,12 +221,13 @@ If `--auto-assign` flag:
 
 ```typescript
 const assignmentRules = {
-  // Role detection from task tags/title
-  "frontend|ui|css|react|vue": "fe",
-  "backend|api|database|server": "be",
-  "test|qa|e2e|integration": "qa",
-  "deploy|ci|docker|infra": "devops",
-  "mobile|ios|android|react-native": "mobile",
+  // All implementation work goes to build agents
+  "frontend|ui|css|react|vue": "build",
+  "backend|api|database|server": "build",
+  "deploy|ci|docker|infra": "build",
+  "mobile|ios|android|react-native": "build",
+  // Review/QA work goes to review agent
+  "test|qa|e2e|integration": "review",
 };
 
 // Load balancing: prefer agent with lowest active count
@@ -253,12 +254,12 @@ for (const task of readyTasks.filter((t) => !t.assignee && t.priority <= 2)) {
 AUTO-ASSIGNMENTS
 ━━━━━━━━━━━━━━━━
 
-✓ bd-abc12 → be-agent (detected: backend, API)
-✓ bd-def34 → fe-agent (detected: frontend, React)
-✓ bd-ghi56 → devops (detected: infrastructure)
+✓ bd-abc12 → build (detected: backend, API)
+✓ bd-def34 → build (detected: frontend, React)
+✓ bd-ghi56 → build (detected: infrastructure)
 
 Skipped:
-- bd-xyz99: Already assigned to qa-agent
+- bd-xyz99: Already assigned to review agent
 - bd-old88: No matching role detected (manual assignment needed)
 ```
 
@@ -293,7 +294,11 @@ console.log("3. Review individually");
 ## Phase 9: Sync and Notify
 
 ```typescript
-bd_sync({ reason: "Triage complete" });
+
+```
+
+```typescript
+bd_sync({ reason: "Sync triage changes" });
 
 // Broadcast triage summary if significant changes
 if (assignmentsMade > 0 || priorityChanges > 0) {

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,171 @@ 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 CLI (Core)
+
+The `bd` command is your issue tracker. JSONL is source of truth, SQLite is cache.
+
+### Essential Commands
+
+```bash
+bd ready                              # Unblocked tasks (use this to find work)
+bd list --status=open                 # All open issues
+bd show <id>                          # Full details
+bd create "Title" -t task -p 2        # Create (type: task/bug/feature/epic, priority: 0-4)
+bd update <id> --status in_progress   # Claim work
+bd close <id> --reason "Done"         # Complete
+bd sync                               # Export/commit/push (always run at session end)
+```
+
+### Dependencies
+
+```bash
+bd dep add <child> <parent> --type blocks   # Child blocked until parent closes
+bd dep tree <id>                            # Visualize dependency chain
+bd blocked                                  # Show all blocked issues
+```
+
+### Coordination
+
+```bash
+bd list --status in_progress          # See what's claimed by others
+git pull && bd import                 # Get latest from team
+bd sync                               # Push your changes
+```
+
+### Priority Levels
+
+- **P0** - Critical (security, data loss)
+- **P1** - High (major features, important bugs)
+- **P2** - Medium (default)
+- **P3** - Low
+- **P4** - Backlog
+
+### Sandbox Mode
+
+If running in restricted environment (Claude Code, etc.):
+
+```bash
+bd --sandbox ready
+# Or: bd --no-daemon --no-auto-flush --no-auto-import list
+```
+
+## Beads Plugin Tools (For OpenCode Agents)
+
+This project's plugin (`.opencode/plugin/beads.ts`) provides typed tools that wrap the CLI.
+
+### Session Lifecycle
+
+```typescript
+bd_init({ role: "build" }); // Join workspace - MUST call first
+bd_claim(); // Get next ready task, mark in_progress
+bd_reserve({ paths: ["src/foo.ts"] }); // Lock files before editing
+// ... do work ...
+bd_done({ id: "bd-xxx", msg: "Done" }); // Close + release locks + sync
+```
+
+### Task Management
+
+```typescript
+bd_add({ title: "Task", pri: 2, type: "task" }); // Create issue
+bd_show({ id: "bd-xxx" }); // Get full details
+bd_ls({ status: "open", limit: 10 }); // List issues
+bd_ready(); // Ready-to-work tasks
+bd_update({ id: "bd-xxx", status: "in_progress" }); // Update issue
+bd_search({ query: "auth" }); // Search issues
+```
+
+### File Locking (Plugin-Only)
+
+```typescript
+bd_reserve({ paths: ["src/a.ts", "src/b.ts"], ttl: 600 }); // Lock files
+bd_reservations(); // List active locks
+bd_release({ paths: ["src/a.ts"] }); // Release specific
+bd_release(); // Release all
+```
+
+### Messaging (Plugin-Only)
+
+```typescript
+bd_msg({ subj: "Done", to: "all", global: true }); // Broadcast
+bd_inbox({ n: 5, unread: true }); // Check messages
+bd_ack({ ids: ["msg-abc", "msg-def"] }); // Mark messages as read
+```
+
+### Agent Coordination (Plugin-Only)
+
+```typescript
+bd_whois(); // See all agents and their current work
+bd_whois({ agent: "build-abc" }); // Lookup specific agent
+```
+
+### Maintenance
+
+```typescript
+bd_sync(); // Sync with git
+bd_status({ include_agents: true }); // Workspace overview
+bd_doctor(); // Check database health
+bd_cleanup({ days: 7 }); // Remove old closed issues
+```
+
+## Beads Workflow
+
+### Start Work
+
+```bash
+bd ready                              # Find unblocked task
+bd update bd-xxx --status in_progress # Claim it
+git checkout -b bd-xxx                # Create branch
+```
+
+### During Work
+
+```bash
+git commit -m "WIP: bd-xxx - [progress]"  # Checkpoint commits
+bd sync                                    # Sync beads state
+```
+
+### End Session
+
+```bash
+git add -A && git commit -m "bd-xxx: [summary]"
+bd close bd-xxx --reason "Completed: [what]"
+bd sync
+git push
+```
+
+### Handoff (If Not Finishing)
+
+```bash
+git commit -m "WIP: bd-xxx - [where stopped]"
+# Create handoff in .beads/artifacts/bd-xxx/handoffs/
+bd sync
+git push
+```
+
+Resume later with: `/resume bd-xxx`

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,145 @@
 ---
 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`
+
+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
 
-<!-- Subtle bugs, misleading APIs -->
+- `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
+
+### Protected Tools in DCP
+
+v1.1.3 recognizes more tool variants. Ensure these are protected:
 
-<!-- Environment variables, config files that bite -->
+- `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
+
+If tools are unexpectedly blocked:
+
+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
+
+## Beads Gotchas
+
+### Core Beads CLI vs This Project's Plugin
+
+**Core beads CLI** (`bd`) is the upstream tool from steveyegge/beads.
+
+**This project's plugin** (`.opencode/plugin/beads.ts`) wraps the CLI and adds:
+
+- `bd_done()` - closes task + releases locks + syncs in one call
+- `bd_reserve()` / `bd_release()` - atomic file locking via mkdir
+- `bd_claim()` - finds ready task + marks in_progress
+- `bd_msg()` / `bd_inbox()` / `bd_ack()` - agent-to-agent messaging
+- `bd_whois()` - agent directory lookup (who's working on what)
+- Agent state (current task, reserved files, agent ID)
+
+### Which To Use
+
+| Context              | Use                     |
+| -------------------- | ----------------------- |
+| OpenCode agents      | Plugin tools (`bd_*()`) |
+| Shell scripts, CI/CD | CLI (`bd`)              |
+| Human terminal       | CLI (`bd`)              |
+
+### Plugin Tools (Preferred for Agents)
+
+```typescript
+bd_init({ role: "build" }); // Join workspace
+bd_claim(); // Get next ready task
+bd_reserve({ paths: ["src/foo.ts"] }); // Lock files
+// ... do work ...
+bd_done({ id: "bd-xxx", msg: "Done" }); // Close + release + sync
+```
+
+### CLI Commands (For Scripts/Humans)
+
+```bash
+bd create "Task title" -t task -p 2   # Create
+bd update bd-xxx --status in_progress  # Claim
+bd close bd-xxx --reason "Done"        # Complete
+bd sync                                 # Push to git
+```
+
+### Hash-Based IDs Prevent Collisions
+
+Beads uses hash IDs (`bd-a3f8`) not sequential IDs (`bd-1`, `bd-2`). This eliminates merge conflicts when multiple agents create issues on different branches.
+
+Don't assume sequential IDs. Always use `bd show` to get exact IDs.
+
+### `bd ready` Is Your Friend
+
+`bd ready` shows tasks with NO unresolved blockers. Use it to find work instead of `bd list`.
+
+### Dependencies Block Work
+
+```bash
+bd dep add bd-child bd-parent --type blocks
+```
+
+Now `bd-child` won't appear in `bd ready` until `bd-parent` closes. Check `bd blocked` to see what's waiting.
+
+### Git Is The Coordination Layer
+
+No central server. Agents coordinate via:
+
+1. Issue status (in_progress = claimed)
+2. Git branches
+3. `bd sync` to push/pull changes
+
+### Sandbox Environments (Claude Code, etc.)
+
+Daemon can't be killed by sandbox. Use:
+
+```bash
+bd --sandbox ready
+# Or: bd --no-daemon --no-auto-flush --no-auto-import list
+```
+
+### 30-Second Debounce
 
-## Platform-Specific Issues
+Rapid operations get batched into single JSONL flush after 30s. Force immediate sync:
 
-<!-- macOS vs Linux, Node versions, etc. -->
+```bash
+bd sync
+```