opencodekit 0.12.0 → 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.0",
+  version: "0.12.2",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -3133,6 +3133,8 @@ async function copyOpenCodeOnly(templateRoot, targetDir) {
   return true;
 }
 async function initCommand(options = {}) {
+  if (process.argv.includes("--quiet"))
+    return;
   const targetDir = process.cwd();
   const mode = detectMode(targetDir);
   oe(import_picocolors7.default.bgCyan(import_picocolors7.default.black(" OpenCodeKit ")));
@@ -3203,9 +3205,9 @@ version: 1
 }
 
 // src/commands/menu.ts
+import { existsSync as existsSync6, lstatSync as lstatSync3, readdirSync as readdirSync5 } from "node:fs";
+import { basename as basename2, join as join6 } from "node:path";
 var import_picocolors10 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync6, readdirSync as readdirSync5, lstatSync as lstatSync3 } from "node:fs";
-import { join as join6, basename as basename2 } from "node:path";
 
 // src/commands/skill.ts
 import { join as join4 } from "node:path";
@@ -3367,16 +3369,16 @@ async function viewSkill(opencodePath, skillName) {
 }
 
 // src/commands/upgrade.ts
-import { join as join5, dirname as dirname2 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
 import {
+  copyFileSync,
   existsSync as existsSync5,
+  mkdirSync as mkdirSync3,
   readFileSync as readFileSync5,
-  writeFileSync as writeFileSync4,
   readdirSync as readdirSync4,
-  mkdirSync as mkdirSync3,
-  copyFileSync
+  writeFileSync as writeFileSync4
 } from "node:fs";
+import { dirname as dirname2, join as join5 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 var import_picocolors9 = __toESM(require_picocolors(), 1);
 var PRESERVE_FILES = [
   "opencode.json"
@@ -3495,6 +3497,8 @@ function copyDirPreserveExisting(src, dest) {
   return { updated, preserved };
 }
 async function upgradeCommand(options = {}) {
+  if (process.argv.includes("--quiet"))
+    return;
   const cwd = process.cwd();
   const opencodeDir = join5(cwd, ".opencode");
   if (!existsSync5(opencodeDir)) {
@@ -3610,6 +3614,8 @@ async function interactiveMenu(version) {
   }
 }
 async function doctorCommand() {
+  if (process.argv.includes("--quiet"))
+    return;
   const cwd = process.cwd();
   const opencodeDir = join6(cwd, ".opencode");
   const checks = [];
@@ -3662,6 +3668,8 @@ async function doctorCommand() {
   }
 }
 async function statusCommand() {
+  if (process.argv.includes("--quiet"))
+    return;
   const cwd = process.cwd();
   const opencodeDir = join6(cwd, ".opencode");
   if (!existsSync6(opencodeDir)) {
@@ -3715,18 +3723,38 @@ async function statusCommand() {
 // src/utils/logger.ts
 var import_picocolors11 = __toESM(require_picocolors(), 1);
 var logger = {
-  log: (message) => console.log(message),
-  info: (message) => console.log(import_picocolors11.default.blue(`[i] ${message}`)),
-  success: (message) => console.log(import_picocolors11.default.green(`[+] ${message}`)),
-  warn: (message) => console.warn(import_picocolors11.default.yellow(`[!] ${message}`)),
-  error: (message) => console.error(import_picocolors11.default.red(`[x] ${message}`)),
+  log: (message) => {
+    if (!process.argv.includes("--quiet")) {
+      console.log(message);
+    }
+  },
+  info: (message) => {
+    if (!process.argv.includes("--quiet")) {
+      console.log(import_picocolors11.default.blue(`[i] ${message}`));
+    }
+  },
+  success: (message) => {
+    if (!process.argv.includes("--quiet")) {
+      console.log(import_picocolors11.default.green(`[+] ${message}`));
+    }
+  },
+  warn: (message) => {
+    if (!process.argv.includes("--quiet")) {
+      console.warn(import_picocolors11.default.yellow(`[!] ${message}`));
+    }
+  },
+  error: (message) => {
+    if (!process.argv.includes("--quiet")) {
+      console.error(import_picocolors11.default.red(`[x] ${message}`));
+    }
+  },
   debug: (message) => {
-    if (process.env.DEBUG || process.argv.includes("--verbose")) {
+    if ((process.env.DEBUG || process.argv.includes("--verbose")) && !process.argv.includes("--quiet")) {
       console.log(import_picocolors11.default.dim(`[DEBUG] ${message}`));
     }
   },
   verbose: (message) => {
-    if (process.argv.includes("--verbose")) {
+    if (process.argv.includes("--verbose") && !process.argv.includes("--quiet")) {
       console.log(import_picocolors11.default.dim(message));
     }
   }

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.
 
@@ -401,6 +401,16 @@ read_session("today")                                 # Today's first session
 read_session("ses_abc123", focus="file changes")      # Specific aspect
 ```
 
+**`search_session`** - Full-text search across sessions
+
+```
+search_session(query="auth bug")                      # Search all sessions
+search_session(query="OAuth", session_id="ses_abc")   # Search specific session
+search_session(query="error", limit=10)               # Limit results
+```
+
+Use to find past discussions, decisions, or work on a topic before starting new work.
+
 **`summarize_session`** - Generate AI summary of a session
 
 ```

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

@@ -39,6 +39,10 @@ bd_reserve({
 **Check for previous research:**
 
 ```typescript
+// Search for past research on this topic
+search_session({ query: "<topic keywords>" });
+
+// Also check recent sessions
 list_sessions({ project: "current", since: "this week", limit: 5 });
 ```
 
@@ -84,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/resume.md

@@ -94,13 +94,22 @@ Options:
 
 ## Phase 4: Load Previous Session Context
 
-### Step 1: Find Related Sessions
+### Step 1: Search for Related Work
+
+```typescript
+// Search past sessions for work on this bead
+search_session({ query: "$ARGUMENTS" });
+```
+
+This finds all sessions that discussed or worked on this bead.
+
+### Step 2: Find Related Sessions
 
 ```typescript
 list_sessions({ project: "current", limit: 10, _: true });
 ```
 
-### Step 2: Identify Relevant Session
+### Step 3: Identify Relevant Session
 
 Look for sessions that:
 

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/command/status.md

@@ -30,6 +30,9 @@ bd_reservations({ reason: "Check file locks" });
 // Sessions
 list_sessions({ project: "current", since: "today", limit: 5, _: true });
 
+// Search for recent activity on current work (if bead in progress)
+search_session({ query: "<current-bead-id>", limit: 5 });
+
 // Git state
 bash("git status --porcelain");
 bash("git branch --show-current");

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

@@ -29,6 +29,9 @@ bd_status({ include_agents: true });
 bd_ls({ status: "open", limit: 50, offset: 0 });
 bd_reservations({ reason: "Check active file locks" });
 bd_inbox({ n: 10, unread: true, global: true });
+
+// Search for past discussions on recurring issues
+search_session({ query: "blocked OR regression OR urgent", limit: 10 });
 ```
 
 Capture:
@@ -38,6 +41,7 @@ Capture:
 - Active agents
 - File locks
 - Pending messages
+- Past context on recurring issues
 
 ## Phase 3: Analyze Dependencies
 

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
+```