opencodekit 0.23.1 → 0.23.3

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

package/dist/template/.opencode/skill/ubiquitous-language/SKILL.md

@@ -5,7 +5,7 @@ version: 1.0.0
 tags: [architecture, domain-driven-design, ai-workflow]
 dependencies: []
 agent_types: [planner, scout]
-tools: [srcwalk_search, grep, memory]
+tools: [grep, memory]
 ---
 
 # Ubiquitous Language

package/dist/template/.opencode/tool/grepsearch.ts

@@ -3,19 +3,19 @@ import { tool } from "@opencode-ai/plugin";
 const GREP_APP_API = "https://grep.app/api/search";
 
 interface SearchResult {
-	repo: string;
-	path: string;
-	content: { snippet: string };
-	total_matches: string;
+  repo: string;
+  path: string;
+  content: { snippet: string };
+  total_matches: string;
 }
 
 interface GrepResponse {
-	hits: { hits: SearchResult[] };
-	time: number;
+  hits: { hits: SearchResult[] };
+  time: number;
 }
 
 export default tool({
-	description: `Search real-world code examples from GitHub repositories via grep.app. Replaces asking "how do others use X?" — use this for finding production patterns and real-world API usage.
+  description: `Search real-world code examples from GitHub repositories via grep.app. Replaces asking "how do others use X?" — use this for finding production patterns and real-world API usage.
 
 WHEN: Implementing unfamiliar APIs, looking for production patterns, understanding library integrations.
 SKIP: Searching your own codebase (use grep/srcwalk), looking up docs (use context7), general research (use websearch).
@@ -31,113 +31,102 @@ Use when:
 - Understanding library integrations - see how things work together
 
 IMPORTANT: Search for **literal code patterns**, not keywords:
-✅ Good: "useState(", "import React from", "async function"
-❌ Bad: "react tutorial", "best practices", "how to use"
+Good: "useState(", "import React from", "async function"
 
+Bad: "react tutorial", "best practices", "how to use"
 Examples:
   grepsearch({ query: "getServerSession", language: "TypeScript" })
   grepsearch({ query: "CORS(", language: "Python", repo: "flask" })
   grepsearch({ query: "export async function POST", path: "route.ts" })
 `,
-	args: {
-		query: tool.schema
-			.string()
-			.describe("Code pattern to search for (literal text)"),
-		language: tool.schema
-			.string()
-			.optional()
-			.describe("Filter by language: TypeScript, TSX, Python, Go, Rust, etc."),
-		repo: tool.schema
-			.string()
-			.optional()
-			.describe("Filter by repo: 'owner/repo' or partial match"),
-		path: tool.schema
-			.string()
-			.optional()
-			.describe("Filter by file path: 'src/', '.test.ts', etc."),
-		limit: tool.schema
-			.number()
-			.optional()
-			.describe("Max results to return (default: 10, max: 20)"),
-	},
-	execute: async (args) => {
-		const { query, language, repo, path, limit = 10 } = args;
-
-		if (!query || query.trim() === "") {
-			return "Error: query is required";
-		}
-
-		// Build URL with proper filter parameters
-		// grep.app uses filter[lang][0]=TypeScript format, NOT inline lang:TypeScript
-		const url = new URL(GREP_APP_API);
-		url.searchParams.set("q", query);
-
-		// Add language filter (grep.app uses filter[lang][0] format)
-		if (language) {
-			url.searchParams.set("filter[lang][0]", language);
-		}
-
-		// Add repo filter
-		if (repo) {
-			url.searchParams.set("filter[repo][0]", repo);
-		}
-
-		// Add path filter
-		if (path) {
-			url.searchParams.set("filter[path][0]", path);
-		}
-
-		try {
-			const response = await fetch(url.toString(), {
-				headers: {
-					Accept: "application/json",
-					"User-Agent": "OpenCode/1.0",
-				},
-			});
-
-			if (!response.ok) {
-				return `Error: grep.app API returned ${response.status}`;
-			}
-
-			const data = (await response.json()) as GrepResponse;
-
-			if (!data.hits?.hits?.length) {
-				return `No results found for: ${query}${language ? ` (${language})` : ""}`;
-			}
-
-			const maxResults = Math.min(limit, 20);
-			const results = data.hits.hits.slice(0, maxResults);
-
-			const formatted = results.map((hit, i) => {
-				const repoName = hit.repo || "unknown";
-				const filePath = hit.path || "unknown";
-				const snippet = hit.content?.snippet || "";
-
-				// Clean up HTML from snippet and extract text
-				const cleanCode = snippet
-					.replace(/<[^>]*>/g, "") // Remove HTML tags
-					.replace(/&lt;/g, "<")
-					.replace(/&gt;/g, ">")
-					.replace(/&amp;/g, "&")
-					.replace(/&quot;/g, '"')
-					.split("\n")
-					.slice(0, 8)
-					.join("\n")
-					.trim();
-
-				return `## ${i + 1}. ${repoName}
+  args: {
+    query: tool.schema.string().describe("Code pattern to search for (literal text)"),
+    language: tool.schema
+      .string()
+      .optional()
+      .describe("Filter by language: TypeScript, TSX, Python, Go, Rust, etc."),
+    repo: tool.schema.string().optional().describe("Filter by repo: 'owner/repo' or partial match"),
+    path: tool.schema.string().optional().describe("Filter by file path: 'src/', '.test.ts', etc."),
+    limit: tool.schema.number().optional().describe("Max results to return (default: 10, max: 20)"),
+  },
+  execute: async (args) => {
+    const { query, language, repo, path, limit = 10 } = args;
+
+    if (!query || query.trim() === "") {
+      return "Error: query is required";
+    }
+
+    // Build URL with proper filter parameters
+    // grep.app uses filter[lang][0]=TypeScript format, NOT inline lang:TypeScript
+    const url = new URL(GREP_APP_API);
+    url.searchParams.set("q", query);
+
+    // Add language filter (grep.app uses filter[lang][0] format)
+    if (language) {
+      url.searchParams.set("filter[lang][0]", language);
+    }
+
+    // Add repo filter
+    if (repo) {
+      url.searchParams.set("filter[repo][0]", repo);
+    }
+
+    // Add path filter
+    if (path) {
+      url.searchParams.set("filter[path][0]", path);
+    }
+
+    try {
+      const response = await fetch(url.toString(), {
+        headers: {
+          Accept: "application/json",
+          "User-Agent": "OpenCode/1.0",
+        },
+      });
+
+      if (!response.ok) {
+        return `Error: grep.app API returned ${response.status}`;
+      }
+
+      const data = (await response.json()) as GrepResponse;
+
+      if (!data.hits?.hits?.length) {
+        return `No results found for: ${query}${language ? ` (${language})` : ""}`;
+      }
+
+      const maxResults = Math.min(limit, 20);
+      const results = data.hits.hits.slice(0, maxResults);
+
+      const formatted = results.map((hit, i) => {
+        const repoName = hit.repo || "unknown";
+        const filePath = hit.path || "unknown";
+        const snippet = hit.content?.snippet || "";
+
+        // Clean up HTML from snippet and extract text
+        const cleanCode = snippet
+          .replace(/<[^>]*>/g, "") // Remove HTML tags
+          .replace(/&lt;/g, "<")
+          .replace(/&gt;/g, ">")
+          .replace(/&amp;/g, "&")
+          .replace(/&quot;/g, '"')
+          .split("\n")
+          .slice(0, 8)
+          .join("\n")
+          .trim();
+
+        return `## ${i + 1}. ${repoName}
 **File**: ${filePath}
 \`\`\`
 ${cleanCode}
 \`\`\``;
-			});
+      });
 
-			return `Found ${data.hits.hits.length} results (showing ${results.length}) in ${data.time}ms:
+      return `Found ${data.hits.hits.length} results (showing ${results.length}) in ${data.time}ms:
 
 ${formatted.join("\n\n")}`;
-		} catch (error: unknown) {
-			const message = error instanceof Error ? error.message : String(error);
-			return `Error searching grep.app: ${message}`;
-		}
-	},
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : String(error);
+      return `Error searching grep.app: ${message}`;
+    }
+  },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencodekit",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
   "keywords": [
     "agents",