opencodekit 0.14.6 → 0.15.1

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

@@ -325,7 +325,7 @@ git checkout --ours [file]    # Use reverted
 ## Phase 10: Update Bead Status
 
 ```bash
-bd-msg --subj "Reverted: [bead-id]" --body "Feature reverted at [timestamp]\nReason: [reason]\nBackup: backup/[bead-id]-pre-revert" --to "all" --importance normal
+bd close [bead-id] --reason "Reverted: [brief reason]"
 ```
 
 ---

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

@@ -39,11 +39,11 @@ lsp_lsp_diagnostics(); // for each changed file
 !`npm run lint || true`
 
 ```typescript
-// Anti-pattern detection with ast-grep
-ast - grep({ pattern: "console.log($$$)" }); // Debug statements
-ast - grep({ pattern: "any" }); // TypeScript any
+// Anti-pattern detection with grep
+grep({ pattern: "console\\.log" }); // Debug statements
+grep({ pattern: "any" }); // TypeScript any
 grep({ pattern: "TODO|FIXME|HACK|XXX" });
-ast - grep({ pattern: 'password = "$$$"' }); // Hardcoded secrets
+grep({ pattern: "password\\s*=" }); // Hardcoded secrets
 ```
 
 !`npm test || pytest || cargo test`

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

@@ -215,10 +215,9 @@ Recommendation: Prune completed tool outputs before next major task
 
 
 REQUIRED ACTIONS
-━━━━━━━━━━━━━━━━
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Priority │ Action                              │ Command
 ─────────┼─────────────────────────────────────┼────────────────────
-HIGH     │ Reply to build-1 question          │ bd-msg --to "build-1" --subj "Re:" --body "..."
 HIGH     │ Add plan for bd-ghi56               │ /plan bd-ghi56
 MEDIUM   │ Review 2 stale tasks                │ /triage --stale
 LOW      │ Push 2 local commits                │ git push

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

@@ -22,8 +22,7 @@ const parseReference = (ref: string) => {
 
   // Relative references
   if (ref === "last") return { type: "relative", offset: 0 };
-  if (ref.match(/^\d+ ago$/))
-    return { type: "relative", offset: parseInt(ref) };
+  if (ref.match(/^\d+ ago$/)) return { type: "relative", offset: parseInt(ref) };
 
   // Time-based
   if (ref === "today") return { type: "time", period: "today" };

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

@@ -147,12 +147,7 @@ const ageHours = (now - created) / (1000 * 60 * 60);
 const slaByPriority = { 0: 4, 1: 24, 2: 168, 3: 336, 4: Infinity };
 const slaHours = slaByPriority[task.priority];
 const slaRemaining = slaHours - ageHours;
-const slaStatus =
-  slaRemaining < 0
-    ? "BREACHED"
-    : slaRemaining < slaHours * 0.2
-      ? "AT_RISK"
-      : "OK";
+const slaStatus = slaRemaining < 0 ? "BREACHED" : slaRemaining < slaHours * 0.2 ? "AT_RISK" : "OK";
 ```
 
 ## Phase 6: Bottleneck Analysis
@@ -272,9 +267,7 @@ const assignmentRules = {
 
 // Load balancing: prefer agent with lowest active count
 function selectAgent(role: string, agents: Agent[]): Agent {
-  return agents
-    .filter((a) => a.role === role)
-    .sort((a, b) => a.activeCount - b.activeCount)[0];
+  return agents.filter((a) => a.role === role).sort((a, b) => a.activeCount - b.activeCount)[0];
 }
 ```
 
@@ -318,9 +311,7 @@ for each breached task:
 
 ```typescript
 // Find tasks with no activity > 14 days
-const staleTasks = openTasks.filter(
-  (t) => daysSince(t.updated_at) > 14 && t.status === "open",
-);
+const staleTasks = openTasks.filter((t) => daysSince(t.updated_at) > 14 && t.status === "open");
 
 // Prompt for action
 console.log(`Found ${staleTasks.length} stale tasks. Options:`);
@@ -340,22 +331,7 @@ bd list --status=closed --json | wc -l  # Check closed count
 
 **Best Practice (from Steve Yegge):** Run `bd cleanup` every few days to prevent database bloat.
 
-## Phase 10: Check Memory Health
-
-```typescript
-memory - index({ action: "status" });
-```
-
-If documents count is low or index is stale:
-
-```
-⚠️  Vector store may be stale.
-Run: memory-index rebuild
-```
-
-Optionally trigger background reindex if many observations were created recently.
-
-## Phase 11: Sync and Notify
+## Phase 10: Sync and Notify
 
 ```typescript
 
@@ -363,10 +339,6 @@ Optionally trigger background reindex if many observations were created recently
 
 ```typescript
 bd sync
-
-# Broadcast triage summary if significant changes
-if assignments or priority changes:
-  bd-msg --subj "Triage Complete" --body "Assigned X tasks, updated Y priorities" --to "all" --importance normal
 ```
 
 ## Alternative: Manual Triage

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

@@ -1,70 +1,70 @@
 {
-	"enabled": true,
-	"debug": false,
-	// "minimal" shows prune activity without noise; "off" if you want silence
-	"pruneNotification": "off",
-	"turnProtection": {
-		"enabled": true,
-		// 3 turns = faster cleanup while still protecting recent context
-		"turns": 3
-	},
-	"tools": {
-		"settings": {
-			"nudgeEnabled": true,
-			// Nudge every 8 tool calls (slightly more aggressive than default 10)
-			"nudgeFrequency": 8,
-			// Protect state-modifying and critical workflow tools
-			// Updated for v1.1.8: Added question tool, removed legacy bd_* (use CLI)
-			"protectedTools": [
-				"write",
-				"edit",
-				"question",
-				"memory-read",
-				"memory-update",
-				"memory-search",
-				"observation",
-				"skill",
-				"skill_mcp",
-				"task",
-				"batch",
-				"todowrite",
-				"todoread",
-				"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",
-				"bd-reserve",
-				"bd-release",
-				"bd-msg",
-				"bd-inbox"
-			]
-		},
-		"discard": {
-			"enabled": true
-		},
-		"extract": {
-			"enabled": true,
-			"showDistillation": false
-		}
-	},
-	"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 3 turns
-		"purgeErrors": {
-			"enabled": true,
-			"turns": 3,
-			"protectedTools": []
-		}
-	}
+  "enabled": true,
+  "debug": false,
+  // "minimal" shows prune activity without noise; "off" if you want silence
+  "pruneNotification": "off",
+  "turnProtection": {
+    "enabled": true,
+    // 3 turns = faster cleanup while still protecting recent context
+    "turns": 3,
+  },
+  "tools": {
+    "settings": {
+      "nudgeEnabled": true,
+      // Nudge every 8 tool calls (slightly more aggressive than default 10)
+      "nudgeFrequency": 8,
+      // Protect state-modifying and critical workflow tools
+      // Updated for v1.1.8: Added question tool, removed legacy bd_* (use CLI)
+      "protectedTools": [
+        "write",
+        "edit",
+        "question",
+        "memory-read",
+        "memory-update",
+        "memory-search",
+        "observation",
+        "skill",
+        "skill_mcp",
+        "task",
+        "batch",
+        "todowrite",
+        "todoread",
+        "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",
+        "bd-reserve",
+        "bd-release",
+        "bd-msg",
+        "bd-inbox",
+      ],
+    },
+    "discard": {
+      "enabled": true,
+    },
+    "extract": {
+      "enabled": true,
+      "showDistillation": false,
+    },
+  },
+  "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 3 turns
+    "purgeErrors": {
+      "enabled": true,
+      "turns": 3,
+      "protectedTools": [],
+    },
+  },
 }

package/dist/template/.opencode/memory/_templates/README.md

@@ -0,0 +1,35 @@
+---
+purpose: Index of available memory templates
+updated: 2026-01-12
+---
+
+# Memory Templates
+
+Copy these templates to `.opencode/memory/project/` when starting a new project.
+
+## Available Templates
+
+| Template          | Purpose                                        |
+| ----------------- | ---------------------------------------------- |
+| `architecture.md` | Document project structure, modules, data flow |
+| `conventions.md`  | Code style, naming, patterns, commit rules     |
+| `gotchas.md`      | Known issues, edge cases, troubleshooting      |
+| `commands.md`     | Build, test, lint, deploy commands             |
+
+## Usage
+
+```bash
+# Copy template (replace DATE)
+cp _templates/architecture.md ../project/architecture.md
+sed -i '' "s/{{DATE}}/$(date +%Y-%m-%d)/g" ../project/architecture.md
+
+# Or create your own from scratch
+touch ../project/architecture.md
+```
+
+## Tips
+
+- Fill out templates when you first learn about a project
+- Update as you discover new patterns or issues
+- Use `observation` tool for quick notes during work
+- Use `memory-search` to find relevant context later

package/dist/template/.opencode/memory/_templates/project/architecture.md

@@ -0,0 +1,60 @@
+---
+purpose: Key modules, directory structure, architectural decisions
+updated: { { DATE } }
+---
+
+# Project Architecture
+
+## Directory Structure
+
+```
+src/              # Source code
+  index.ts        # Entry point
+  commands/       # CLI commands
+  utils/          # Utilities
+
+dist/             # Built output
+.opencode/        # OpenCode configuration
+.beads/           # Task tracking
+```
+
+## Key Modules
+
+### Module Name
+
+**Purpose**: Brief description
+
+**Files**:
+
+- `src/module/file.ts`
+
+**Dependencies**:
+
+- External libs
+- Internal modules
+
+## Data Flow
+
+```
+User Action
+  → Module A
+    → Module B
+      → External Service
+```
+
+## External Dependencies
+
+- **Library**: Version, purpose
+- **Service**: API endpoint, auth method
+
+## Architectural Decisions
+
+| Decision | Rationale    | Trade-offs   |
+| -------- | ------------ | ------------ |
+| Choice 1 | Why this way | Limitation 1 |
+
+## TODO
+
+- [ ] Document missing modules
+- [ ] Add dependency diagram
+- [ ] Map data flow diagrams

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

@@ -0,0 +1,72 @@
+---
+purpose: Build, test, lint, deploy commands discovered for this project
+updated: { { DATE } }
+---
+
+# Project Commands
+
+## Development
+
+```bash
+npm run dev        # Start development server
+bun run src/index.ts  # Run CLI directly
+```
+
+## Build
+
+```bash
+npm run build      # Build for production
+bun build ...      # Additional build options
+```
+
+## Test
+
+```bash
+bun test           # Run all tests
+bun test --watch   # Watch mode
+bun test file.ts   # Run single file
+```
+
+## Lint
+
+```bash
+npm run lint       # Check for issues
+npm run lint:fix   # Auto-fix issues
+```
+
+## Typecheck
+
+```bash
+npm run typecheck  # TypeScript checking only
+```
+
+## Database
+
+```bash
+npm run db:push    # Push schema changes
+npm run db:studio  # Open database UI
+```
+
+## Deployment
+
+```bash
+npm run deploy     # Deploy to production
+```
+
+## CI/CD
+
+- **Lint**: Runs on push
+- **Test**: Runs on push
+- **Deploy**: Triggers on main branch
+
+## Beads (Task Tracking)
+
+```bash
+bd ready              # Find unblocked tasks
+bd list --status=open # All open issues
+bd show <id>          # Full details
+bd create "Title" -p 2        # Create task
+bd update <id> --status in_progress  # Claim
+bd close <id> --reason "Done"        # Complete
+bd sync               # Push to git
+```

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

@@ -0,0 +1,68 @@
+---
+purpose: Code patterns, commit style, team conventions
+updated: { { DATE } }
+---
+
+# Project Conventions
+
+## Code Style
+
+### TypeScript
+
+- **Module**: ESNext, bundler moduleResolution
+- **Strict**: Disabled
+- **Imports**: Group stdlib, third-party, local
+
+### Python
+
+- **Version**: 3.10+
+- **Style**: type hints required, dataclasses for config
+
+## Naming Conventions
+
+| Type      | Convention | Example           |
+| --------- | ---------- | ----------------- |
+| Classes   | PascalCase | `UserService`     |
+| Functions | snake_case | `get_user_data()` |
+| Variables | snake_case | `user_data`       |
+| Constants | UPPER_CASE | `MAX_RETRIES`     |
+| Files     | kebab-case | `user-service.ts` |
+
+## Import Order
+
+```typescript
+// 1. Node.js stdlib
+import fs from "node:fs/promises";
+import path from "node:path";
+
+// 2. Third-party
+import { cli } from "cac";
+import { log } from "@clack/prompts";
+
+// 3. Local
+import { initCommand } from "./commands/init.js";
+```
+
+## Commit Messages
+
+```
+type(scope): subject
+
+body (optional)
+
+footer (optional)
+```
+
+**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+## Code Review
+
+- **Self-review**: Run lint/typecheck before PR
+- **Test coverage**: Add tests for new features
+- **Docs**: Update README for user-facing changes
+
+## Patterns to Avoid
+
+- Premature abstraction
+- Circular dependencies
+- Magic numbers/strings

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

@@ -0,0 +1,41 @@
+---
+purpose: Footguns, edge cases, and "don't forget this" warnings
+updated: { { DATE } }
+---
+
+# Project Gotchas
+
+## Configuration Quirks
+
+### Field Name
+
+**Issue**: What goes wrong
+**Fix**: How to handle it
+
+## Dependencies
+
+### Package Name
+
+**Version**: x.y.z
+**Why Required**: Purpose
+**Gotcha**: Edge case or limitation
+
+## Time Wasters
+
+### Issue Description
+
+**Symptoms**: What you'll see
+**Cause**: Root cause
+**Fix**: Solution
+
+## Common Errors
+
+| Error Message | Cause  | Fix       |
+| ------------- | ------ | --------- |
+| "Error: ..."  | Reason | Fix steps |
+
+## TODO
+
+- [ ] Document more edge cases
+- [ ] Add troubleshooting section
+- [ ] List known issues

package/dist/template/.opencode/memory/beads-workflow.md

@@ -147,27 +147,28 @@ git worktree prune
 ```
 Leader Agents (touch beads, sync, coordinate)
 ├── build   - Primary implementation agent
-└── rush    - Fast-track implementation agent
+└── plan    - Architecture and planning agent
 
 Subagents (read-only, stateless workers)
+├── general - Fast, well-defined tasks
 ├── explore - Codebase search, patterns
 ├── scout   - External docs, best practices
-├── planner - Architecture, decomposition
 ├── review  - Code review, debugging
 └── vision  - UI/UX, visual analysis
 ```
 
 ### Delegation Rules
 
-| Agent     | Can Do                     | Cannot Do              |
-| --------- | -------------------------- | ---------------------- |
-| `build`   | All beads ops, `bd sync`   | -                      |
-| `rush`    | All beads ops, `bd sync`   | -                      |
-| `explore` | Read, grep, glob, ast-grep | Edit, write, `bd sync` |
-| `scout`   | Fetch, search, Context7    | Edit, write, `bd sync` |
-| `planner` | Read, create artifacts     | Edit files, `bd sync`  |
-| `review`  | Read, analyze, suggest     | Edit files, `bd sync`  |
-| `vision`  | Analyze images, mockups    | All beads operations   |
+| Agent     | Can Do                   | Cannot Do              |
+| --------- | ------------------------ | ---------------------- |
+| `build`   | All beads ops, `bd sync` | -                      |
+| `plan`    | All beads ops, `bd sync` | -                      |
+| `general` | Read, small edits        | `bd sync`, beads write |
+| `explore` | Read, grep, glob         | Edit, write, `bd sync` |
+| `scout`   | Fetch, search, Context7  | Edit, write, `bd sync` |
+| `plan`    | Read, create artifacts   | Edit files, `bd sync`  |
+| `review`  | Read, analyze, suggest   | Edit files, `bd sync`  |
+| `vision`  | Analyze images, mockups  | All beads operations   |
 
 ### Parallel Research Pattern
 
@@ -203,9 +204,9 @@ Task({
 
 | Situation                | Delegate To | Why                        |
 | ------------------------ | ----------- | -------------------------- |
-| Need codebase patterns   | `@explore`  | Fast grep/glob/ast-grep    |
+| Need codebase patterns   | `@explore`  | Fast grep/glob             |
 | Need library docs        | `@scout`    | Context7, GitHub patterns  |
-| Complex planning         | `@planner`  | Structured decomposition   |
+| Complex planning         | `@plan`     | Structured decomposition   |
 | Code review before merge | `@review`   | Fresh eyes, evidence-based |
 | UI/mockup analysis       | `@vision`   | Visual expertise           |
 | Stuck on implementation  | `@explore`  | Fresh search perspective   |
@@ -229,7 +230,7 @@ Based on [OpenCode Command Docs](https://opencode.ai/docs/commands/).
 ---
 description: Short description shown in TUI command list
 argument-hint: "<required> [optional] [--flag]"
-agent: build | planner | scout | explore | review | vision
+agent: build | plan | scout | explore | review | vision
 subtask: true # Run as subagent (doesn't pollute primary context)
 model: gemini-2.5-pro # Override default model
 ---
@@ -302,11 +303,11 @@ model: gemini-2.5-pro # Override default model
 | `/start <id> --worktree`     | build   | + Create git worktree                                  | Isolated feature work       |
 | `/start <id> --research`     | build   | + Parallel subagent research                           | Complex task preparation    |
 | `/create`                    | build   | `bd create`, `bd sync`                                 | Create new tracked task     |
-| `/new-feature`               | planner | `bd create` (epic + subtasks), `bd dep add`, `bd sync` | Complex feature with phases |
-| `/new-feature --worktree`    | planner | + Create git worktree for epic                         | Isolated feature branch     |
+| `/new-feature`               | plan    | `bd create` (epic + subtasks), `bd dep add`, `bd sync` | Complex feature with phases |
+| `/new-feature --worktree`    | plan    | + Create git worktree for epic                         | Isolated feature branch     |
 | `/issue <num>`               | build   | `bd create`, `bd sync`, `gh issue comment`             | Import GitHub issue         |
-| `/plan <id>`                 | planner | `bd create` (subtasks), `bd dep add`, `bd sync`        | Break down task             |
-| `/plan <id> --create-beads`  | planner | Create child beads after planning                      | Auto-hierarchy creation     |
+| `/plan <id>`                 | plan    | `bd create` (subtasks), `bd dep add`, `bd sync`        | Break down task             |
+| `/plan <id> --create-beads`  | plan    | Create child beads after planning                      | Auto-hierarchy creation     |
 | `/implement <id>`            | build   | `bd update --status in_progress`, `bd sync`            | Do the work                 |
 | `/implement <id> --parallel` | build   | + Aggressive subagent research                         | Complex implementation      |
 | `/commit [id]`               | build   | `bd sync` (if bead-id provided)                        | Commit with traceability    |
@@ -322,21 +323,21 @@ model: gemini-2.5-pro # Override default model
 | Command            | Agent   | Beads Operations      | Notes                      |
 | ------------------ | ------- | --------------------- | -------------------------- |
 | `/research <id>`   | scout   | `bd show` (read-only) | NO `bd sync` - subagent    |
-| `/brainstorm`      | planner | None                  | Pure planning, no tracking |
+| `/brainstorm`      | plan    | None                  | Pure planning, no tracking |
 | `/analyze-project` | explore | None                  | Codebase exploration       |
 | `/summarize`       | explore | None                  | Session/code summary       |
 | `/review-codebase` | review  | None                  | Code review                |
 
 ### Non-Beads Commands
 
-| Command                | Agent   | Purpose                        |
-| ---------------------- | ------- | ------------------------------ |
-| `/quick-build`         | build   | Trivial fixes, no bead created |
-| `/design`              | planner | Architecture design            |
-| `/ui-review`           | vision  | UI/UX analysis                 |
-| `/accessibility-check` | vision  | A11y audit                     |
-| `/fix-ci`              | build   | CI pipeline fixes              |
-| `/fix-types`           | build   | TypeScript errors              |
+| Command                | Agent  | Purpose                        |
+| ---------------------- | ------ | ------------------------------ |
+| `/quick-build`         | build  | Trivial fixes, no bead created |
+| `/design`              | plan   | Architecture design            |
+| `/ui-review`           | vision | UI/UX analysis                 |
+| `/accessibility-check` | vision | A11y audit                     |
+| `/fix-ci`              | build  | CI pipeline fixes              |
+| `/fix-types`           | build  | TypeScript errors              |
 
 ## Workflow Patterns
 
@@ -486,13 +487,13 @@ bd sync
 | Agent   | Can Do                          | Cannot Do |
 | ------- | ------------------------------- | --------- |
 | `build` | All beads operations, `bd sync` | -         |
-| `rush`  | All beads operations, `bd sync` | -         |
+| `plan`  | All beads operations, `bd sync` | -         |
 
 ### Subagents (Read-Only Beads)
 
 | Agent     | Can Do                                 | Cannot Do             |
 | --------- | -------------------------------------- | --------------------- |
-| `planner` | `bd show`, `bd list`, create artifacts | `bd sync`, `bd close` |
+| `plan`    | `bd show`, `bd list`, create artifacts | `bd sync`, `bd close` |
 | `scout`   | `bd show` (read context)               | Any writes            |
 | `explore` | `bd show`, `bd list`                   | Any writes            |
 | `review`  | `bd show`                              | Any writes            |