opencodekit 0.14.5 → 0.15.0

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

@@ -3,11 +3,21 @@ description: External research specialist for library docs, GitHub patterns, and
 mode: subagent
 temperature: 0.3
 maxSteps: 30
-tools:
-  edit: false
-  write: false
-  bash: false
-  question: false
+permission:
+  write:
+    "*": deny
+    ".beads/artifacts/*/*.md": allow
+  edit:
+    "*": deny
+    ".beads/artifacts/*/*.md": allow
+  bash:
+    "*": allow
+    "rm*": deny
+    "git push*": deny
+    "git commit*": deny
+    "git reset*": deny
+    "npm publish*": deny
+  question: deny
 ---
 
 # Scout Agent

package/dist/template/.opencode/command/analyze-project.md

@@ -82,8 +82,8 @@ Task({
 
 **Fallback:** If Task tool fails or network is unavailable, use local tools:
 
-- `repo-map` for architecture analysis
 - `memory-search` for existing project knowledge
+- Use `glob` + `read` to explore structure
 - Skip external research phases
 
 ---
@@ -210,7 +210,7 @@ Integrate findings from Phase 2 subagents into the report:
 If subagents failed in Phase 2, use fallback data:
 
 - Check `memory-read({ file: "project/architecture" })` for cached architecture
-- Use `repo-map` output for structure analysis
+- Use `glob` + `read` to explore structure
 - Skip best practices comparison (mark as "N/A - offline mode")
 
 ---

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

@@ -1,7 +1,7 @@
 ---
 description: Brainstorm and explore ideas with structured ideation
 argument-hint: "<topic or bead-id> [--quick]"
-agent: planner
+agent: plan
 subtask: true
 ---
 

package/dist/template/.opencode/command/design-audit.md

@@ -107,11 +107,11 @@ Analyze all images and extract:
 
 ### For Codebase
 
-Search for hardcoded values using ast-grep and grep:
+Search for hardcoded values using grep:
 
 ```typescript
-ast - grep({ pattern: 'color: "#$HEX"' });
-ast - grep({ pattern: 'background: "#$HEX"' });
+grep({ pattern: "color:", include: "*.{css,scss,tsx,jsx}" });
+grep({ pattern: "background:", include: "*.{css,scss,tsx,jsx}" });
 grep({ pattern: "#[0-9a-fA-F]{3,8}", include: "*.{css,scss,tsx,jsx}" });
 grep({ pattern: "rgb\\(", include: "*.{css,scss,tsx,jsx}" });
 grep({ pattern: "hsl\\(", include: "*.{css,scss,tsx,jsx}" });
@@ -121,8 +121,7 @@ grep({ pattern: "[0-9]+rem", include: "*.{css,scss,tsx,jsx}" });
 
 grep({ pattern: "font-size:", include: "*.css" });
 grep({ pattern: "fontSize:", include: "*.{tsx,jsx}" });
-
-ast - grep({ pattern: 'className="$$$"' }); // then analyze for arbitrary values like [16px]
+grep({ pattern: "className=", include: "*.{tsx,jsx}" }); // then analyze for arbitrary values
 ```
 
 ---

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

@@ -356,12 +356,10 @@ const buttonVariants = cva(
     variants: {
       variant: {
         default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        secondary:
-          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
         outline: "border border-input bg-background hover:bg-accent",
         ghost: "hover:bg-accent hover:text-accent-foreground",
-        destructive:
-          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
       },
       size: {
         sm: "h-8 px-3 text-sm",
@@ -377,17 +375,10 @@ const buttonVariants = cva(
 );
 
 interface ButtonProps
-  extends
-    React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {}
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {}
 
 export function Button({ className, variant, size, ...props }: ButtonProps) {
-  return (
-    <button
-      className={cn(buttonVariants({ variant, size }), className)}
-      {...props}
-    />
-  );
+  return <button className={cn(buttonVariants({ variant, size }), className)} {...props} />;
 }
 ```
 

package/dist/template/.opencode/command/generate-pattern.md

@@ -195,20 +195,13 @@ Use `--colors=<preset>` or specify hex values:
 /* With overlay for text readability */
 .pattern-overlay {
   background:
-    linear-gradient(rgba(255, 255, 255, 0.9), rgba(255, 255, 255, 0.9)),
-    url("pattern-512.png");
+    linear-gradient(rgba(255, 255, 255, 0.9), rgba(255, 255, 255, 0.9)), url("pattern-512.png");
   background-repeat: repeat;
 }
 
 /* CSS-only alternative (if simple enough) */
 .pattern-css {
-  background: repeating-linear-gradient(
-    45deg,
-    #f0f0f0,
-    #f0f0f0 10px,
-    #ffffff 10px,
-    #ffffff 20px
-  );
+  background: repeating-linear-gradient(45deg, #f0f0f0, #f0f0f0 10px, #ffffff 10px, #ffffff 20px);
 }
 ```
 

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

@@ -64,7 +64,7 @@ bd ready --json | grep -q "$ARGUMENTS"
 // Fire all READY subtasks in parallel using Task tool
 // Multiple Task calls in one message run simultaneously
 Task({
-  subagent_type: "rush",
+  subagent_type: "general",
   description: "Execute subtask 1",
   prompt: `Execute bd-subtask1: [Subtask description]
 
@@ -78,7 +78,7 @@ Task({
 });
 
 Task({
-  subagent_type: "rush",
+  subagent_type: "general",
   description: "Execute subtask 2",
   prompt: `Execute bd-subtask2: [Subtask description]
     ...same pattern...`,
@@ -201,7 +201,7 @@ Task({
   subagent_type: "explore",
   description: "Find codebase patterns",
   prompt: `For implementing $ARGUMENTS, find:
-    1. Similar patterns in this codebase (grep/ast-grep)
+    1. Similar patterns in this codebase (grep)
     2. Related test files and testing patterns
     3. Configuration or setup requirements
     Return: File paths, code patterns, test approach`,
@@ -232,7 +232,7 @@ Task({
 | `explore`| Codebase search, patterns | Read, grep, glob | Edit, bd sync |
 | `scout` | External docs, best practices | Fetch, search | Edit, bd sync |
 | `review` | Code review, debugging | Read, analyze | Edit, bd sync |
-| `planner`| Architecture, decomposition | Read, plan | Edit, bd sync |
+| `plan` | Architecture, decomposition | Read, plan | Edit, bd sync |
 
 **You (build agent) are the leader:**
 

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

@@ -1,7 +1,7 @@
 ---
 description: Initialize project for AI-assisted development (creates AGENTS.md + memory files)
 argument-hint: "[--deep] [--skip-questions]"
-agent: planner
+agent: plan
 subtask: true
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 description: Create a new feature with discovery, spec, plan, and sub-tasks
 argument-hint: "<feature-name> [--priority=<0-4>] [--type=<type>] [--worktree] [--quick]"
-agent: planner
+agent: plan
 ---
 
 # New Feature: $ARGUMENTS
@@ -153,8 +153,7 @@ question({
   questions: [
     {
       header: "Approve",
-      question:
-        "Should I proceed with creating the specification for $ARGUMENTS?",
+      question: "Should I proceed with creating the specification for $ARGUMENTS?",
       options: [
         {
           label: "Yes, proceed",

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

@@ -1,7 +1,7 @@
 ---
 description: Create implementation plan for a bead with subtask hierarchy
 argument-hint: "<bead-id> [--create-beads] [--parallel]"
-agent: planner
+agent: plan
 ---
 
 # Plan: $ARGUMENTS

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

@@ -242,7 +242,6 @@ CI Status:
 ## Phase 7: Update Bead & Sync
 
 ```bash
-bd-msg --subj "PR created" --body "PR: <pr-url>\nStatus: [ready/draft]\nCI: [passing/pending]" --to "all" --importance normal
 bd sync
 ```
 

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

@@ -23,7 +23,21 @@ First, understand the codebase structure:
 
 ```typescript
 // Quick overview of relevant directories
-repo-map({ path: "src", format: "compact", maxDepth: 3 });
+lsp_lsp_document_symbols({ filePath: "src/index.ts", line: 1, character: 1 });
+
+// Find files by pattern
+glob({ pattern: "src/**/*.ts" });
+```
+
+### Deep Dive
+
+```typescript
+// Find similar patterns
+grep({ pattern: "<text pattern>", include: "*.ts" });
+
+// Understand types
+lsp_lsp_hover({ filePath: "<file>", line: N, character: N });
+lsp_lsp_find_references({ filePath: "<file>", line: N, character: N });
 ```
 
 This helps identify relevant directories and files before diving deeper.
@@ -88,17 +102,17 @@ If memory search fails (Ollama not running), continue to external sources.
 
 ### Internal Codebase - Get Quick Overview
 
-First, generate a compact repository map to understand the codebase structure:
+First, understand codebase structure:
 
 ```typescript
 // Quick overview of relevant directories
-repo-map({ path: "src", format: "compact", maxDepth: 3 });
+glob({ pattern: "src/**/*.ts" });
 
-// For specific feature area
-repo-map({ path: "src/commands", format: "tree", maxDepth: 2 });
+// Check file structure
+lsp_lsp_document_symbols({ filePath: "src/index.ts", line: 1, character: 1 });
 ```
 
-**Use repo-map when:**
+**Use these tools when:**
 
 - Starting research on a new area of the codebase
 - Need to understand file organization before diving deep

package/dist/template/.opencode/command/restore-image.md

@@ -19,15 +19,7 @@ const parseInput = (input: string) => {
   const imagePath = parts[0];
   const mode = parts[1] || "enhance";
 
-  const validModes = [
-    "enhance",
-    "upscale",
-    "restore",
-    "denoise",
-    "colorize",
-    "sharpen",
-    "deblur",
-  ];
+  const validModes = ["enhance", "upscale", "restore", "denoise", "colorize", "sharpen", "deblur"];
 
   if (!validModes.includes(mode)) {
     console.warn(`Unknown mode: ${mode}. Using 'enhance' as default.`);

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