opencodekit 0.23.2 → 0.23.4

package/dist/template/.opencode/plugin/memory/tools.ts

@@ -114,23 +114,23 @@ Feedback mode examples:
         // --- Feedback mode: observation #id marked helpful/harmful ---
         if (args.id !== undefined && args.feedback !== undefined) {
           const obsId = Number(args.id);
-          if (!Number.isInteger(obsId)) return "❌ id must be an integer.";
+          if (!Number.isInteger(obsId)) return "id must be an integer.";
           const fb = String(args.feedback);
           if (fb !== "helpful" && fb !== "harmful")
-            return '❌ feedback must be "helpful" or "harmful".';
+            return 'feedback must be "helpful" or "harmful".';
 
           const result = recordFeedback(obsId, fb, args.reason as string | undefined);
-          if (!result.success) return `❌ ${result.error ?? "Failed to record feedback."}`;
+          if (!result.success) return `${result.error ?? "Failed to record feedback."}`;
 
           return [
-            `✅ Observation #${obsId} marked as ${fb}.`,
+            `Observation #${obsId} marked as ${fb}.`,
             `- Feedback: ${result.helpfulCount} helpful / ${result.harmfulCount} harmful`,
           ].join("\n");
         }
 
         // --- Create mode: store a new observation ---
         if (!args.type || !args.title) {
-          return "❌ Provide type+title to create an observation, or id+feedback to give feedback.";
+          return "Provide type+title to create an observation, or id+feedback to give feedback.";
         }
 
         const obsType = args.type as ObservationType;
@@ -200,7 +200,7 @@ Feedback mode examples:
 
         const warnings =
           validation.issues.length > 0
-            ? `\n⚠️ Warnings: ${validation.issues.map((i) => i.message).join("; ")}`
+            ? `\nWarnings: ${validation.issues.map((i) => i.message).join("; ")}`
             : "";
 
         return `${TYPE_ICONS[obsType] ?? "📌"} Observation #${id} stored [${obsType}] "${args.title}" (confidence: ${confidence}, source: ${source})${warnings}`;

package/dist/template/.opencode/plugin/session-summary.ts

@@ -454,9 +454,7 @@ export const SessionSummaryPlugin: Plugin = async ({ client, directory }) => {
           addRead(summary, normalized, "Code navigation");
           break;
         case "grep":
-        case "srcwalk_search":
         case "glob":
-        case "srcwalk_files":
           // Search tools — not tracking individual files
           break;
       }

package/dist/template/.opencode/plugin/srcwalk.ts

@@ -5,9 +5,7 @@
  * Wraps available CLI tools (rg/grep, find, cat, ls) into unified srcwalk_* tools.
  *
  * Tools (matching pikit srcwalk extension surface):
- *   - srcwalk_search  — Search symbols/text/regex in codebase
  *   - srcwalk_read    — Read files with optional section/range
- *   - srcwalk_files   — Find files by glob pattern
  *   - srcwalk_deps    — Show imports and dependents for a file
  *   - srcwalk_map     — Directory tree overview
  *   - srcwalk_callers — Reverse call graph (grep-based)
@@ -23,7 +21,6 @@ import path from "node:path";
 import { tool } from "@opencode-ai/plugin/tool";
 import type { Plugin } from "@opencode-ai/plugin";
 
-const BIN_RG = "rg";
 const TIMEOUT_MS = 15_000;
 const MAX_BUFFER = 5 * 1024 * 1024;
 
@@ -55,17 +52,25 @@ function run(
   }
 }
 
-function hasRg(): boolean {
-  try {
-    execFileSync(BIN_RG, ["--version"], { encoding: "utf-8", timeout: 1000, stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 function plural(n: number, word: string): string {
-  return `${n} ${word}${n !== 1 ? "s" : ""}`;
+  if (n === 1) return `${n} ${word}`;
+  if (
+    word.endsWith("ch") ||
+    word.endsWith("s") ||
+    word.endsWith("sh") ||
+    word.endsWith("x") ||
+    word.endsWith("z")
+  ) {
+    return `${n} ${word}es`;
+  }
+  if (
+    word.endsWith("y") &&
+    word.length > 1 &&
+    !["a", "e", "i", "o", "u"].includes(word[word.length - 2])
+  ) {
+    return `${n} ${word.slice(0, -1)}ies`;
+  }
+  return `${n} ${word}s`;
 }
 
 // ---------------------------------------------------------------------------
@@ -73,68 +78,6 @@ function plural(n: number, word: string): string {
 // ---------------------------------------------------------------------------
 
 const srcwalkTools = {
-  // -----------------------------------------------------------------------
-  // srcwalk_search: Search codebase
-  // -----------------------------------------------------------------------
-  srcwalk_search: tool({
-    description: `Search for symbols, text, or regex patterns in code.\n\nUses ripgrep (rg) when available, falls back to grep.\nSupports symbol search (definitions first), content search, and regex.`,
-    args: {
-      query: tool.schema.string().describe("Search query or regex pattern"),
-      scope: tool.schema.string().optional().describe("Subdirectory scope (default: project root)"),
-      kind: tool.schema.string().optional().describe("Search type: text (default), regex, content"),
-      context: tool.schema.number().optional().describe("Lines of context before/after each match"),
-      limit: tool.schema.number().optional().describe("Max results (default: 30)"),
-    },
-    execute: async (args, context) => {
-      const query = String(args.query ?? "").trim();
-      if (!query) return "❌ query is required.";
-      const scope = args.scope ? String(args.scope) : context.directory;
-      const limit = Math.min(args.limit ?? 30, 100);
-      const ctxLines = args.context ?? 0;
-      const kind = String(args.kind ?? "text");
-
-      const searchDir = path.resolve(context.directory, scope);
-
-      if (hasRg()) {
-        const rgArgs = ["--no-heading", "--line-number", "--color", "never"];
-        rgArgs.push("--max-count", String(limit * 2));
-        if (ctxLines > 0) {
-          rgArgs.push("-C", String(ctxLines));
-        }
-        if (kind === "regex") {
-          rgArgs.push("-E", "rust");
-        } else {
-          rgArgs.push("-F"); // literal
-        }
-        rgArgs.push(query, searchDir);
-
-        const result = run(BIN_RG, rgArgs);
-        if (result.code !== 0 && result.stderr) {
-          // Try plain grep fallback
-        } else {
-          const lines = result.stdout.split("\n").filter(Boolean).slice(0, limit);
-          if (lines.length === 0) return "No matches found.";
-          return lines.join("\n");
-        }
-      }
-
-      // Fallback to grep
-      const grepArgs = ["-rn", "--color=never"];
-      if (ctxLines > 0) grepArgs.push("-C", String(ctxLines));
-      if (kind === "regex") {
-        grepArgs.push("-E");
-      } else {
-        grepArgs.push("-F");
-      }
-      grepArgs.push(query, searchDir);
-
-      const result = run("grep", grepArgs);
-      const lines = result.stdout.split("\n").filter(Boolean).slice(0, limit);
-      if (lines.length === 0) return "No matches found.";
-      return lines.join("\n");
-    },
-  }),
-
   // -----------------------------------------------------------------------
   // srcwalk_read: Read files
   // -----------------------------------------------------------------------
@@ -233,84 +176,6 @@ const srcwalkTools = {
     },
   }),
 
-  // -----------------------------------------------------------------------
-  // srcwalk_files: Find files
-  // -----------------------------------------------------------------------
-  srcwalk_files: tool({
-    description: `Find files by glob pattern. Returns matched file paths with size estimates, grouped by directory. Respects .gitignore.`,
-    args: {
-      pattern: tool.schema.string().describe("Glob pattern (e.g. '*.ts', 'src/**/*.ts')"),
-      scope: tool.schema
-        .string()
-        .optional()
-        .describe("Directory to search (default: project root)"),
-    },
-    execute: async (args, context) => {
-      const pattern = String(args.pattern ?? "").trim();
-      if (!pattern) return "❌ pattern is required.";
-      const scopeDir = path.resolve(context.directory, args.scope ? String(args.scope) : "");
-
-      // Use find with simple glob pattern
-      const findArgs: string[] = [scopeDir, "-type", "f"];
-
-      // Convert simple glob to -name pattern
-      if (pattern.includes("**")) {
-        // find handles ** naturally with -path
-        findArgs.push("-path", `*/${pattern.replace(/\*\*/g, "*")}`);
-      } else if (pattern.includes("*")) {
-        findArgs.push("-name", pattern);
-      } else if (pattern.includes(".")) {
-        findArgs.push("-name", pattern);
-      } else {
-        findArgs.push("-name", `*${pattern}*`);
-      }
-
-      // Exclude common dirs
-      for (const dir of [
-        ".git",
-        "node_modules",
-        "dist",
-        "build",
-        "coverage",
-        ".next",
-        ".opencode",
-      ]) {
-        findArgs.push("-not", "-path", `*/${dir}/*`);
-      }
-
-      const result = run("find", findArgs);
-      const files = result.stdout.split("\n").filter(Boolean).slice(0, 200);
-
-      if (files.length === 0) return `No files matching "${pattern}" found.`;
-
-      // Group by directory
-      const groups: Record<string, string[]> = {};
-      for (const f of files) {
-        const dir = path.dirname(f);
-        if (!groups[dir]) groups[dir] = [];
-        groups[dir].push(path.basename(f));
-      }
-
-      const lines: string[] = [`# Files matching "${pattern}" (${plural(files.length, "file")})\n`];
-      for (const [dir, files] of Object.entries(groups).sort()) {
-        const relDir = path.relative(context.directory, dir) || ".";
-        lines.push(`${relDir}/ (${plural(files.length, "file")})`);
-        for (const f of files) {
-          const fp = path.join(dir, f);
-          try {
-            const size = statSync(fp).size;
-            const tokenEst = Math.ceil(size / 4);
-            lines.push(`  ${f}  (~${tokenEst.toLocaleString()} tokens)`);
-          } catch {
-            lines.push(`  ${f}`);
-          }
-        }
-        lines.push("");
-      }
-      return lines.join("\n");
-    },
-  }),
-
   // -----------------------------------------------------------------------
   // srcwalk_deps: Import analysis
   // -----------------------------------------------------------------------
@@ -419,7 +284,7 @@ const srcwalkTools = {
     },
     execute: async (args, context) => {
       const symbol = String(args.symbol ?? "").trim();
-      if (!symbol) return "❌ symbol is required.";
+      if (!symbol) return "symbol is required.";
       const scopeDir = path.resolve(context.directory, args.scope ? String(args.scope) : "");
       const depth = Math.min(args.depth ?? 1, 3);
 
@@ -483,7 +348,7 @@ const srcwalkTools = {
     },
     execute: async (args, context) => {
       const symbol = String(args.symbol ?? "").trim();
-      if (!symbol) return "❌ symbol is required.";
+      if (!symbol) return "symbol is required.";
       const scopeDir = path.resolve(context.directory, args.scope ? String(args.scope) : "");
 
       // Find the function definition
@@ -598,7 +463,7 @@ const srcwalkTools = {
     },
     execute: async (args, context) => {
       const symbol = String(args.symbol ?? "").trim();
-      if (!symbol) return "❌ symbol is required.";
+      if (!symbol) return "symbol is required.";
       const scopeDir = path.resolve(context.directory, args.scope ? String(args.scope) : "");
 
       // Get callers
@@ -705,7 +570,7 @@ const srcwalkTools = {
     },
     execute: async (args, context) => {
       const symbol = String(args.symbol ?? "").trim();
-      if (!symbol) return "❌ symbol is required.";
+      if (!symbol) return "symbol is required.";
       const scopeDir = path.resolve(context.directory, args.scope ? String(args.scope) : "");
 
       // Count usages per directory

package/dist/template/.opencode/skill/code-review-and-quality/SKILL.md

@@ -5,7 +5,7 @@ version: 1.0.0
 tags: [review, code-quality, verification]
 dependencies: [verification-before-completion]
 agent_types: [reviewer]
-tools: [srcwalk_search, srcwalk_deps, bash]
+tools: [grep, srcwalk_deps, bash]
 ---
 
 # Code Review & Quality

package/dist/template/.opencode/skill/debugging-and-error-recovery/SKILL.md

@@ -5,7 +5,7 @@ version: 1.0.0
 tags: [debugging, workflow, verification]
 dependencies: [test-driven-development, verification-before-completion]
 agent_types: [worker, reviewer]
-tools: [bash, srcwalk_search, srcwalk_deps]
+tools: [bash, grep, srcwalk_deps]
 ---
 
 # Debugging & Error Recovery

package/dist/template/.opencode/skill/deep-module-design/SKILL.md

@@ -5,7 +5,7 @@ version: 1.0.0
 tags: [architecture, code-quality, ousterhout]
 dependencies: []
 agent_types: [planner, worker, reviewer]
-tools: [srcwalk_search, srcwalk_deps]
+tools: [grep, srcwalk_deps]
 ---
 
 # Deep Module Design

package/dist/template/.opencode/skill/defense-in-depth/SKILL.md

@@ -172,5 +172,3 @@ All four layers were necessary. During testing, each layer caught bugs the other
 - Remove one validation layer — the next layer should still catch the error.
 
 ## See Also
-
-- **structured-edit** - Reliable read/verify/edit workflow when changing validation code across layers

package/dist/template/.opencode/skill/development-lifecycle/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: development-lifecycle
-description: Orchestrates the full feature development lifecycle from ideation through verification. Guides through phases (brainstorm → design → specify → plan → implement → verify) and loads appropriate sub-skills at each stage.
-version: 1.0.0
-tags: [workflow, planning]
+description: Single-agent guide through the full feature development lifecycle (brainstorm → design → specify → plan → implement → verify). For parallel multi-agent execution, use the development-lifecycle-workflow instead.
+version: 1.1.0
+tags: [planning, single-agent]
 dependencies:
   [
     brainstorming,
@@ -17,25 +17,27 @@ dependencies:
 
 ---
 
-# Development Lifecycle Orchestration
+# Development Lifecycle Guide (Single-Agent)
 
 ## When to Use
 
-- Starting a new feature, migration, or refactor and need the full end-to-end workflow
-- You want phase-by-phase guidance with the correct sub-skill at each stage
+- Starting a new feature, migration, or refactor and need phase-by-phase guidance
+- Working alone or with a single agent through the full lifecycle
+- You want to load appropriate sub-skills at each stage
 
 ## When NOT to Use
 
+- You need parallel multi-agent execution (use `development-lifecycle-workflow` instead)
 - You are already mid-phase and only need a specific sub-skill
 - The change is trivial and can skip the full lifecycle
 
 ## Overview
 
-This skill orchestrates the complete feature development workflow, guiding you through each phase and loading the appropriate sub-skills automatically.
+This skill guides a single agent through the complete feature development workflow, loading the appropriate sub-skills at each phase.
 
-**Note:** For quick skill routing by intent, see the Intent → Skill Mapping table in `AGENTS.md`. This skill is for full end-to-end orchestration when you need phase-by-phase guidance.
+**Note:** For parallel multi-agent execution with specialized agents (scouts, reviewers, planners), use the `development-lifecycle-workflow` in `.opencode/workflows/`.
 
-**Use when:** Starting any new feature, migration, refactor, or significant change.
+**Use when:** Starting any new feature, migration, refactor, or significant change with a single agent.
 
 **Announce at start:** "I'm using development-lifecycle to guide this work through all phases."
 

package/dist/template/.opencode/skill/manifest.json

@@ -0,0 +1,77 @@
+{
+  "version": 1,
+  "description": "OpenCodeKit skill tier classification. Tiers determine visibility and loading strategy.",
+  "tiers": {
+    "1": {
+      "label": "Essential",
+      "description": "Always available — referenced in AGENTS.md, agents should consider these first for every task. Small, general-purpose skills that shape execution discipline.",
+      "skills": [
+        "behavioral-kernel",
+        "defense-in-depth",
+        "incremental-implementation",
+        "verification-before-completion"
+      ]
+    },
+    "2": {
+      "label": "On-Demand",
+      "description": "Shipped with the template, loaded via `skill()` when relevant. Covers most domains — UI, testing, debugging, design, workflow, platform integration.",
+      "skills": [
+        "accessibility-audit",
+        "agent-code-quality-gate",
+        "api-and-interface-design",
+        "brainstorming",
+        "browser-testing-with-devtools",
+        "chrome-devtools",
+        "ci-cd-and-automation",
+        "cloudflare",
+        "code-cleanup",
+        "code-review-and-quality",
+        "core-data-expert",
+        "debugging-and-error-recovery",
+        "deep-module-design",
+        "deprecation-and-migration",
+        "design-system-audit",
+        "design-taste-frontend",
+        "development-lifecycle",
+        "documentation-and-adrs",
+        "fallow",
+        "figma",
+        "frontend-design",
+        "gemini-large-context",
+        "git-workflow-and-versioning",
+        "grill-me",
+        "high-end-visual-design",
+        "industrial-brutalist-ui",
+        "jira",
+        "minimalist-ui",
+        "mockup-to-code",
+        "opensrc",
+        "pdf-extract",
+        "performance-optimization",
+        "planning-and-task-breakdown",
+        "playwright",
+        "polar",
+        "react-best-practices",
+        "redesign-existing-projects",
+        "resend",
+        "root-cause-tracing",
+        "security-and-hardening",
+        "shipping-and-launch",
+        "source-driven-development",
+        "spec-driven-development",
+        "srcwalk",
+        "subagent-driven-development",
+        "supabase",
+        "supabase-postgres-best-practices",
+        "swift-concurrency",
+        "swiftui-expert-skill",
+        "test-driven-development",
+        "testing-anti-patterns",
+        "using-git-worktrees",
+        "vercel-deploy-claimable",
+        "webclaw",
+        "writing-skills"
+      ]
+    }
+  }
+}

package/dist/template/.opencode/skill/planning-and-task-breakdown/SKILL.md

@@ -5,7 +5,7 @@ version: 1.0.0
 tags: [workflow, planning, agent-coordination]
 dependencies: [spec-driven-development]
 agent_types: [planner]
-tools: [TaskCreate, TaskUpdate, memory, srcwalk_search]
+tools: [TaskCreate, TaskUpdate, memory, grep]
 ---
 
 # Planning & Task Breakdown

package/dist/template/.opencode/skill/srcwalk/SKILL.md

@@ -6,7 +6,7 @@ version: 2.1.0
 tags: [code-intelligence, search, cli, srcwalk]
 dependencies: []
 agent_types: [planner, worker, reviewer, explorer]
-tools: [bash, srcwalk_search, srcwalk_read, srcwalk_files, srcwalk_deps, srcwalk_map, srcwalk_callers, srcwalk_callees, srcwalk_flow, srcwalk_impact]
+tools: [bash, srcwalk_read, srcwalk_deps, srcwalk_map, srcwalk_callers, srcwalk_callees, srcwalk_flow, srcwalk_impact]
 ---
 
 # Srcwalk — Code Navigation
@@ -41,9 +41,7 @@ Do not pipe, truncate, or summarize `srcwalk guide`.
 
 | Tool | Srcwalk command | Purpose |
 |---|---|---|
-| `srcwalk_search` | `srcwalk discover` / `srcwalk trace callers` | AST-aware symbol/content/regex/callers search |
 | `srcwalk_read` | `srcwalk <path>` | Smart file reading: outline or full with sections |
-| `srcwalk_files` | `srcwalk discover --as file` | Glob file finding with token estimates, grouped by dir |
 | `srcwalk_deps` | `srcwalk deps` + exact import scan | Blast-radius: importers + dep-aware dependents (v1.0.0) |
 
 ### Extended analysis tools
@@ -65,9 +63,9 @@ Do not pipe, truncate, or summarize `srcwalk guide`.
 | Jump to exact line | `srcwalk_read({ path: "file:42" })` |
 | Read a line range | `srcwalk_read({ path: "file:44-89" })` — v1.0.0 shortcut |
 | Read by symbol name | `srcwalk_read({ section: "symbolName" })` |
-| Find definition/usages/text/glob | `srcwalk_search` |
-| Find files by glob | `srcwalk_files` |
-| Multi-symbol search | `srcwalk_search({ query: "A, B, C" })` |
+| Find patterns and symbols | `grep` (exact), `csearch` (multi-keyword) |
+| Find files by glob | `glob` |
+| Multi-symbol search | `grep({ pattern: "A|B|C" })` |
 | Who directly calls this? | `srcwalk_callers` |
 | Who reaches this transitively? | `srcwalk_callers({ depth: 2 })` |
 | What does this call? | `srcwalk_callees` |
@@ -82,7 +80,7 @@ Do not pipe, truncate, or summarize `srcwalk guide`.
 
 ```
 srcwalk_map({ scope: "." })
-srcwalk_search({ query: "likely_symbol", scope: "src" })
+grep({ pattern: "likely_symbol", path: "src/" })
 srcwalk_read({ path: "src/file.ts:42" })         // jump to line
 srcwalk_read({ path: "src/file.ts:44-89" })      // range shortcut (v1.0.0)
 ```
@@ -100,9 +98,9 @@ Prefer outline/section reads before `full: true`.
 ### Find and drill into symbols
 
 ```
-srcwalk_search({ query: "handleAuth", scope: "src" })
-srcwalk_search({ query: "A, B, C", scope: "src" })           // multi-symbol
-srcwalk_search({ query: "handleAuth", expand: 2 })            // inline source
+grep({ pattern: "handleAuth", path: "src/" })
+grep({ pattern: "A|B|C", path: "src/" })                     // multi-symbol
+csearch({ query: "auth token login middleware" })          // multi-keyword chunk search
 ```
 
 ### Trace call graph
@@ -123,7 +121,7 @@ srcwalk_callees({ symbol: "handleAuth", depth: 2, scope: "src" })       // trans
 srcwalk_flow({ symbol: "handleAuth", scope: "src" })
 ```
 
-Use `srcwalk_search({ kind: "callers" })` for quick single-hop. Use `srcwalk_callers` when you need depth, filters, or aggregation.
+Use `grep` for quick single-hop searches. Use `srcwalk_callers` when you need depth, filters, or aggregation.
 
 > Note: `--count-by` and `--depth` are mutually exclusive in `srcwalk_callers` — use one or the other, not both.
 
@@ -143,8 +141,7 @@ srcwalk_impact({ symbol: "handleAuth", scope: "src" })  // heuristic; follow up
 
 ## Critical Rules
 
-- **Do NOT** use built-in `read`/`grep`/`find` when srcwalk_* tools can answer
-- **Do NOT** re-read files already shown in expanded `srcwalk_search` results
+- **Do NOT** use built-in `read`/`find` when srcwalk_* tools can answer; `grep` is preferred for text searches
 - `srcwalk_impact` is heuristic, not proof — verify with `srcwalk_callers` or exact reads
 - `srcwalk_flow` may collapse nested/fluent chains — drill with `srcwalk_callees({ detailed: true })` when inner calls matter
 - Follow `> Next:` footers in output — they suggest the best next command