opencodekit 0.14.5 → 0.15.0

package/README.md

@@ -65,7 +65,7 @@ create test.txt with "Hello OpenCodeKit"
 ```
 build (Primary Orchestrator - 70% of work)
   ├→ @rush (Fast agent for simple tasks)
-  ├→ @planner (Complex planning ≥3 phases)
+  ├→ @plan (Complex planning ≥3 phases)
   ├→ @review (Code review + security + debugging)
   ├→ @scout (External research, library docs, GitHub patterns)
   ├→ @explore (Fast codebase search)
@@ -175,7 +175,7 @@ Need speed over depth?
   ✓ → @rush (fast agent, same capabilities)
 
 Complex task (≥3 phases)?
-  ✓ → @planner (creates implementation plan)
+  ✓ → @plan (creates implementation plan)
 
 Need research?
   ✓ → @scout (library docs + GitHub patterns)

package/dist/index.js

@@ -750,21 +750,24 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.14.5",
+  version: "0.15.0",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
-  type: "module",
+  keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
+  license: "MIT",
+  author: "OpenCodeKit",
   repository: {
     type: "git",
     url: "git+https://github.com/opencodekit/opencodekit-template.git"
   },
-  publishConfig: {
-    access: "public",
-    registry: "https://registry.npmjs.org"
-  },
   bin: {
     ock: "dist/index.js"
   },
   files: ["dist", "README.md"],
+  type: "module",
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org"
+  },
   scripts: {
     dev: "bun run src/index.ts",
     build: "bun run build.ts && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
@@ -773,14 +776,10 @@ var package_default = {
     typecheck: "tsc --noEmit",
     test: "bun test",
     "test:watch": "bun test --watch",
-    lint: "biome check .",
-    "lint:fix": "biome check --fix ."
-  },
-  keywords: ["cli", "opencodekit", "template", "agents", "mcp", "opencode"],
-  author: "OpenCodeKit",
-  license: "MIT",
-  engines: {
-    bun: ">=1.3.2"
+    lint: "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    format: "oxfmt",
+    "format:check": "oxfmt --check"
   },
   dependencies: {
     "@clack/prompts": "^0.7.0",
@@ -792,7 +791,7 @@ var package_default = {
     "cli-table3": "^0.6.5",
     ora: "^9.0.0",
     picocolors: "^1.1.1",
-    "solid-js": "^1.9.10",
+    "solid-js": "1.9.9",
     zod: "^3.25.76"
   },
   devDependencies: {
@@ -800,8 +799,13 @@ var package_default = {
     "@biomejs/biome": "^1.9.4",
     "@types/bun": "latest",
     "@types/node": "^22.19.5",
+    oxfmt: "^0.23.0",
+    oxlint: "^1.38.0",
     typescript: "^5.9.3"
   },
+  engines: {
+    bun: ">=1.3.2"
+  },
   trustedDependencies: ["@beads/bd"]
 };
 
@@ -2762,7 +2766,7 @@ async function editModel(configPath, modelType = "model") {
   }
   f2.success("Fetched models from models.dev");
   const localProviders = config.provider || {};
-  const configuredProviderIds = new Set(Object.keys(localProviders));
+  const _configuredProviderIds = new Set(Object.keys(localProviders));
   const allProviders = Object.values(modelsDevData);
   const quickOptions = [];
   quickOptions.push({
@@ -2929,7 +2933,7 @@ async function editAgentModel(configPath) {
     config.agent = {};
   }
   const serverAgents = await getAgentsFromServer();
-  const serverData = await getProvidersFromServer();
+  const _serverData = await getProvidersFromServer();
   let agentNames = [];
   const agentInfoMap = new Map;
   if (serverAgents && serverAgents.length > 0) {
@@ -2943,7 +2947,7 @@ async function editAgentModel(configPath) {
       });
     }
   } else {
-    agentNames = Object.keys(config.agent).filter((name) => name !== "general" && name !== "plan");
+    agentNames = Object.keys(config.agent);
     for (const name of agentNames) {
       const agent = config.agent[name];
       agentInfoMap.set(name, {
@@ -3758,32 +3762,13 @@ async function editAutoupdate(configPath) {
 
 // src/commands/init.ts
 import { execSync } from "node:child_process";
-import {
-  existsSync as existsSync4,
-  mkdirSync as mkdirSync3,
-  readFileSync as readFileSync4,
-  readdirSync as readdirSync3,
-  writeFileSync as writeFileSync4
-} from "node:fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, readdirSync as readdirSync3, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir, platform } from "node:os";
 import { basename as basename2, dirname, join as join4 } from "node:path";
 import { fileURLToPath } from "node:url";
 var import_picocolors8 = __toESM(require_picocolors(), 1);
-var EXCLUDED_DIRS = [
-  "node_modules",
-  ".git",
-  "dist",
-  ".DS_Store",
-  "coverage",
-  ".next",
-  ".turbo"
-];
-var EXCLUDED_FILES = [
-  "bun.lock",
-  "package-lock.json",
-  "yarn.lock",
-  "pnpm-lock.yaml"
-];
+var EXCLUDED_DIRS = ["node_modules", ".git", "dist", ".DS_Store", "coverage", ".next", ".turbo"];
+var EXCLUDED_FILES = ["bun.lock", "package-lock.json", "yarn.lock", "pnpm-lock.yaml"];
 function getGlobalConfigDir() {
   const os = platform();
   if (os === "win32") {
@@ -3810,10 +3795,7 @@ function detectMode(targetDir) {
 function getTemplateRoot() {
   const __filename2 = fileURLToPath(import.meta.url);
   const __dirname2 = dirname(__filename2);
-  const possiblePaths = [
-    join4(__dirname2, "template"),
-    join4(__dirname2, "..", "..", ".opencode")
-  ];
+  const possiblePaths = [join4(__dirname2, "template"), join4(__dirname2, "..", "..", ".opencode")];
   for (const path of possiblePaths) {
     const opencodeDir = join4(path, ".opencode");
     if (existsSync4(opencodeDir)) {
@@ -3964,14 +3946,7 @@ import { basename as basename4, join as join7 } from "node:path";
 var import_picocolors11 = __toESM(require_picocolors(), 1);
 
 // src/commands/skill.ts
-import {
-  existsSync as existsSync5,
-  mkdirSync as mkdirSync4,
-  readFileSync as readFileSync5,
-  readdirSync as readdirSync4,
-  rmSync,
-  writeFileSync as writeFileSync5
-} from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, readdirSync as readdirSync4, rmSync, writeFileSync as writeFileSync5 } from "node:fs";
 import { basename as basename3, join as join5 } from "node:path";
 var import_picocolors9 = __toESM(require_picocolors(), 1);
 async function skillCommand(action) {
@@ -4677,7 +4652,7 @@ async function doctorCommand() {
       }
       checks.push(...configChecks);
       displayChecks(configChecks);
-    } catch (err) {
+    } catch {
       checks.push({
         name: "Valid JSON syntax",
         ok: false,
@@ -4964,7 +4939,6 @@ async function runBrowser(options) {
     items,
     icon = "●",
     color: itemColor = import_picocolors12.default.cyan,
-    onSelect,
     onBack
   } = options;
   if (items.length === 0) {
@@ -5155,7 +5129,24 @@ function padRight2(str, len) {
   return str + " ".repeat(pad);
 }
 function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
+  const esc = "\x1B";
+  let result = "";
+  let index = 0;
+  while (index < str.length) {
+    const start = str.indexOf(esc, index);
+    if (start === -1) {
+      result += str.slice(index);
+      break;
+    }
+    result += str.slice(index, start);
+    const end = str.indexOf("m", start);
+    if (end === -1) {
+      index = start + 1;
+      continue;
+    }
+    index = end + 1;
+  }
+  return result;
 }
 async function showFileViewer(item) {
   if (!existsSync8(item.path)) {
@@ -5570,7 +5561,24 @@ function padRight3(str, len) {
   return str + " ".repeat(pad);
 }
 function stripAnsi2(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
+  const esc = "\x1B";
+  let result = "";
+  let index = 0;
+  while (index < str.length) {
+    const start = str.indexOf(esc, index);
+    if (start === -1) {
+      result += str.slice(index);
+      break;
+    }
+    result += str.slice(index, start);
+    const end = str.indexOf("m", start);
+    if (end === -1) {
+      index = start + 1;
+      continue;
+    }
+    index = end + 1;
+  }
+  return result;
 }
 
 // src/tui/components/Dashboard.tsx
@@ -5685,7 +5693,24 @@ function padRight4(str, len) {
   return str + " ".repeat(pad);
 }
 function stripAnsi3(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
+  const esc = "\x1B";
+  let result = "";
+  let index = 0;
+  while (index < str.length) {
+    const start = str.indexOf(esc, index);
+    if (start === -1) {
+      result += str.slice(index);
+      break;
+    }
+    result += str.slice(index, start);
+    const end = str.indexOf("m", start);
+    if (end === -1) {
+      index = start + 1;
+      continue;
+    }
+    index = end + 1;
+  }
+  return result;
 }
 
 // src/tui/components/MCPMonitor.ts
@@ -5869,7 +5894,24 @@ function padRight5(str, len) {
   return str + " ".repeat(pad);
 }
 function stripAnsi4(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
+  const esc = "\x1B";
+  let result = "";
+  let index = 0;
+  while (index < str.length) {
+    const start = str.indexOf(esc, index);
+    if (start === -1) {
+      result += str.slice(index);
+      break;
+    }
+    result += str.slice(index, start);
+    const end = str.indexOf("m", start);
+    if (end === -1) {
+      index = start + 1;
+      continue;
+    }
+    index = end + 1;
+  }
+  return result;
 }
 
 // src/tui/hooks/useData.ts

package/dist/template/.opencode/.env.example

@@ -11,6 +11,7 @@ export OPENCODE_DISABLE_PRUNE=0        # Disable potentially buggy pruning
 export OPENCODE_EXPERIMENTAL_TURN_SUMMARY=1
 export OPENCODE_ENABLE_EXPERIMENTAL_MODELS=1
 export OPENCODE_EXPERIMENTAL_EXA=1
+export OPENCODE_EXPERIMENTAL_OXFMT=1
 
 # =============================================================================
 # MCP SERVICES (Remote APIs)

package/dist/template/.opencode/AGENTS.md

@@ -14,9 +14,10 @@ Everything else is guidelines, not laws.
 
 **Rule**: Before any complex tool call, ask: "Can a specialist agent do this better?"
 
+- **Fast Tasks** → @general (small, well-defined, ≤3 files)
 - **Search/Docs** → @explore / @scout
 - **Review/Debug** → @review
-- **Plan/Design** → @planner / @vision
+- **Plan/Design** → @plan / @vision
 - **Media Extraction** → @looker (images, PDFs, diagrams needing OCR/parsing)
 
 If yes → Delegate. If no → Execute directly.
@@ -99,8 +100,8 @@ question({
     - `prepareCallHierarchy` - Get call hierarchy item at position
     - `incomingCalls` - Find what calls this function
     - `outgoingCalls` - Find what this function calls
-2.  **Memory**: `memory-search` (Check past learnings), `repo-map` (Understand structure).
-3.  **Structure**: `ast-grep` (Find functions/classes patterns)
+2.  **Memory**: `memory-search` (Check past learnings)
+3.  **Structure**: `lsp` (Find symbols, definitions, references)
 4.  **Search**: `grep` (Find text/TODOs)
 5.  **Files**: `glob` (Find files)
 
@@ -122,40 +123,28 @@ Violations: `read → edit` or `grep → edit` without LSP = WRONG.
 
 ## Beads (Task Tracking)
 
-**Leader Only**: `build` and `rush` agents own the DB. Subagents read-only.
+**Leader Only**: `build` and `plan` agents own the DB. Subagents read-only.
 
 - **Start**: `bd ready` → `bd update <id> --status in_progress`
-- **Work**: `bd-reserve({ paths: [...] })` (Lock files!) → Edit
+- **Work**: `bd update <id> --status in_progress` → Edit
 - **Finish**: `bd close <id> --reason "..."` → `bd sync` → **RESTART SESSION**
 
 ## Parallel Execution
 
-**Rule**: Fire research subagents in background, continue working, collect when needed.
+**Rule**: Fire research subagents in parallel, continue working, collect when needed.
 
-For complex tasks with multiple unknowns, don't wait for sequential research. Launch parallel background tasks:
-
-**Allowed agents for background delegation:**
-
-- **Subagents**: explore, scout, review, planner, vision, looker (stateless workers)
-- **Primary**: rush (autonomous execution)
-- **NOT allowed**: build (build is the orchestrator that uses this tool)
+For complex tasks with multiple unknowns, don't wait for sequential research. Launch parallel tasks using the built-in `task` tool:
 
 ```typescript
-// Fire parallel research (non-blocking)
-background_start({ agent: "explore", prompt: "Find auth patterns..." }); // → bg_123_abc
-background_start({ agent: "scout", prompt: "Find JWT docs..." }); // → bg_456_def
+// Parallel Task tool calls (recommended)
+task({ subagent_type: "explore", prompt: "Find auth patterns..." }); // → runs in parallel
+task({ subagent_type: "scout", prompt: "Find JWT docs..." }); // → runs in parallel
 
 // Continue with implementation work immediately...
-
-// Collect results when needed
-background_output({ taskId: "bg_123_abc" });
-background_output({ taskId: "bg_456_def" });
-
-// Cleanup at session end
-background_cancel({ all: true });
+// Results come back in same message (no manual collection needed)
 ```
 
-**When to use background execution:**
+**When to use parallel execution:**
 
 - Multiple independent research questions
 - Complex tasks touching unfamiliar code

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

@@ -42,7 +42,7 @@ opencode
 ├── agent/                 # Custom agents (5 total)
 ├── command/               # Custom commands (26 workflows)
 ├── skill/                 # Domain expertise (27 skills)
-├── tool/                  # Custom MCP tools (memory-*, observation, ast-grep)
+├── tool/                  # Custom MCP tools (memory-*, observation)
 ├── plugin/                # Background plugins (enforcer, compactor, truncator)
 └── memory/                # Persistent context
 ```
@@ -84,11 +84,11 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
 **Primary Agents:**
 
 - **@build** - Main orchestrator (Claude Opus 4.5) - handles 70% of work
-- **@rush** - Fast agent (GLM-4.6) - same capabilities, faster
+- **@general** - Fast subagent for small, well-defined tasks
 
 **Subagents:**
 
-- **@planner** - Architecture, multi-phase coordination
+- **@plan** - Architecture, multi-phase coordination
 - **@scout** - External research (library docs + GitHub patterns)
 - **@review** - Code review + debugging + security audit
 - **@vision** - UI/UX design: mockup, UI review, accessibility, aesthetics, visual
@@ -161,124 +161,13 @@ Plugins run automatically in every session:
 
 - **memory-read** - Load previous context, templates
 - **memory-update** - Save learnings, handoffs
-- **memory-search** - Search across all memory files (keyword, semantic, hybrid)
-- **memory-index** - Rebuild vector store for semantic search
-- **memory-embed** - Generate embeddings using Ollama
-- **observation** - Create structured observations (auto-embedded)
-- **ast-grep** - Semantic code search/replace (AST-based)
-
----
-
-## Semantic Memory Setup (Ollama)
-
-Semantic search requires Ollama running locally. Zero API keys needed.
-
-**Model:** `qwen3-embedding:0.6b` (639MB)
-
-- State-of-the-art quality (MTEB #1 for 8B version)
-- Code-aware (optimized for code retrieval)
-- Multilingual (100+ languages including Vietnamese)
-- 32K context, 1024 dimensions
-
-### Installation
-
-**macOS:**
-
-```bash
-brew install ollama
-```
-
-**Linux:**
-
-```bash
-curl -fsSL https://ollama.com/install.sh | sh
-```
-
-**Windows:**
-
-1. Download from https://ollama.com/download/windows
-2. Run the installer
-3. Ollama runs as a background service automatically
-
-### Setup
-
-```bash
-# Start Ollama (macOS/Linux - if not running as service)
-ollama serve
-
-# Pull embedding model (one-time, ~639MB)
-ollama pull qwen3-embedding:0.6b
-
-# Verify
-ollama list  # Should show qwen3-embedding:0.6b
-```
-
-**Linux:**
-
-```bash
-curl -fsSL https://ollama.com/install.sh | sh
-```
-
-**Windows:**
-
-1. Download from https://ollama.com/download/windows
-2. Run the installer
-3. Ollama runs as a background service automatically
-
-### Setup
-
-```bash
-# Start Ollama (macOS/Linux - if not running as service)
-ollama serve
-
-# Pull embedding model (one-time, ~274MB)
-ollama pull nomic-embed-text
-
-# Verify
-ollama list  # Should show nomic-embed-text
-```
-
-### Custom Host (Optional)
-
-If Ollama runs on a different machine:
-
-```bash
-export OLLAMA_HOST=http://192.168.1.100:11434
-```
-
-### Usage
-
-```bash
-# Rebuild vector index (after adding new observations)
-memory-index action=rebuild
-
-# Search with semantic similarity
-memory-search query="authentication patterns" mode=semantic
-
-# Hybrid search (keyword + semantic)
-memory-search query="auth" mode=hybrid
-```
+- **memory-search** - Search across all memory files (keyword-based)
+- **observation** - Create structured observations (decision, bugfix, feature, etc.)
 
 ---
 
 ### AST-Grep Usage
 
-Semantic code operations - smarter than regex:
-
-```bash
-# Search patterns
-ast-grep pattern="console.log($$$)"                    # Find all console.log
-ast-grep pattern="async function $NAME($$$) { $$$ }"   # Find async functions
-ast-grep pattern="const [$S, $SET] = useState($$$)"    # Find React hooks
-
-# Replace (dry run by default)
-ast-grep pattern="oldFunc($$$)" rewrite="newFunc($$$)" dryRun=true
-```
-
-**Pattern syntax**: `$NAME` = single node, `$$$` = zero or more nodes
-
-**Requires**: `brew install ast-grep` or `cargo install ast-grep --locked`
-
 ---
 
 ## MCP Services
@@ -335,8 +224,8 @@ Result: Comprehensive research doc
 
 ```
 User: "Build auth system"
-@build → @planner (4 phases)
-@planner → @review (security audit)
+@build → @plan (4 phases)
+@plan → @review (security audit)
 Result: Secure auth with tests
 ```
 
@@ -409,7 +298,7 @@ fi
 **Delegation:**
 
 - Use @build for 70% of work
-- Delegate to @planner for 3+ phases
+- Delegate to @plan for 3+ phases
 - Use @review before deployment (code review + security)
 - Use @scout for library docs + GitHub patterns
 - Use @explore for codebase search

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

@@ -41,7 +41,6 @@ File search specialist. Navigate and explore codebases efficiently.
 - Finding files using glob patterns
 - Searching code with regex patterns
 - Reading and analyzing file contents
-- Semantic code search with AST-Grep
 - Understanding symbol types and definitions with LSP
 
 ## Navigation Strategy
@@ -64,8 +63,8 @@ File search specialist. Navigate and explore codebases efficiently.
 
 ## Thoroughness Levels
 
-**Quick**: Single ast-grep, lsp_lsp_workspace_symbols, or glob. Read 1-3 files. Return immediately.
+**Quick**: Single 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_lsp_find_references` to trace usage.
+**Medium**: 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_lsp_find_references` to build dependency map. Report with file:line references.

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

@@ -0,0 +1,56 @@
+---
+description: General-purpose subagent for fast, well-defined tasks; delegates complexity to specialists.
+mode: subagent
+temperature: 0.1
+permission:
+  bash:
+    "*": allow
+    "git push*": ask
+    "rm -rf*": deny
+    "sudo*": deny
+---
+
+# General Agent
+
+Fast subagent for small, clear tasks. Delegate complexity quickly.
+
+<system-reminder>
+# General Mode - System Reminder
+
+You are the general subagent. Move fast, avoid risk.
+
+## Critical Constraints
+
+1. Read before edit; never edit unseen code.
+2. Two-strike rule: after 2 failed attempts, stop and escalate.
+3. Bail on complexity: 4+ files, architecture decisions, unclear specs → delegate.
+4. No hallucinated URLs; only use provided or verified links.
+5. Ask before commits/pushes.
+
+## Intent Gate
+
+- Specialist fit? Use explore/scout/review/plan/vision/looker when better.
+- Scope small and clear (≤3 files, no refactors)? Otherwise delegate.
+- Need clarification? One focused question; if more, escalate.
+
+## Bail Triggers
+
+- Scope creep or cross-cutting changes
+- Research-heavy tasks
+- Two failed attempts
+- Architecture pattern choices
+- Legacy/edge-case minefields
+
+## Guidelines
+
+- Match existing style; change only what’s requested.
+- Prefer minimal, surgical edits; avoid unrelated refactors.
+- Run a quick sanity check (lint/typecheck or LSP diagnostics) after edits.
+- Use `file:line` references in summaries; no emojis unless asked.
+
+## Progress Updates
+
+- Keep brief preambles (8–12 words) during multi-step changes.
+- Examples: “Found issue; patching helper now.” / “Config updated; running lint.”
+
+</system-reminder>

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

@@ -0,0 +1,54 @@
+---
+description: Primary planning agent for architecture and multi-phase execution; produces actionable plans with gated steps.
+mode: primary
+temperature: 0.2
+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: allow
+---
+
+# Plan Agent
+
+<system-reminder>
+# Plan Mode - System Reminder
+
+You are the primary planning agent. Stay read-focused; only edit planning artifacts in `.beads/artifacts/<bead_id>/` when needed.
+
+## Critical Constraints
+
+1. No code edits outside planning docs. Read-first, no destructive commands.
+2. Two-strike rule: after two failed attempts to get clarity, escalate.
+3. Bail on complexity outside planning scope; delegate execution to @build, research to @explore/@scout.
+4. No hallucinated URLs; only use provided or verified links.
+5. Ask before commits/pushes.
+
+## When to Plan vs Execute
+
+- Plan when work spans multiple phases, has dependencies, or needs coordination.
+- Skip planning for trivial single-step fixes; delegate directly to @build.
+
+## Planning Workflow
+
+- Phase 1: Understand request; launch minimal @explore/@scout in parallel when scope is unclear.
+- Phase 2: Draft approach with phases, owners, and validation gates.
+- Phase 3: Synthesize into a concise plan with deliverables and risks.
+- End with a clarifying question if options exist, otherwise present the plan and ask "Ready to proceed?"
+
+## Output Expectations
+
+- Provide phase breakdown, critical files to touch, validation steps, and agent assignments.
+- Surface risks, edge cases, and acceptance criteria.
+- Keep progress updates brief (8–12 words) during research.
+  </system-reminder>