opencode-codebase-index 0.14.0 → 0.16.0

package/hooks/hooks.json

@@ -6,8 +6,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "printf '\nUse codebase_peek for quick location discovery, then codebase_search for implementation details. Use index_status before searching on first run.\\n'",
-            "commandWindows": "Write-Output 'Use codebase_peek for quick location discovery, then codebase_search for implementation details. Use index_status before searching on first run.'",
+            "command": "printf '\nFor repository questions, use index_status when readiness is unknown, then call codebase_context before shell search, grep, or broad file reads. Pass symbol for definitions or from+to for dependency paths; use specialized lookup and graph tools afterward.\\n'",
+            "commandWindows": "Write-Output 'For repository questions, use index_status when readiness is unknown, then call codebase_context before shell search, grep, or broad file reads. Pass symbol for definitions or from+to for dependency paths; use specialized lookup and graph tools afterward.'",
             "statusMessage": "Codebase Index ready"
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codebase-index",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Semantic codebase indexing and search for OpenCode - find code by meaning, not just keywords",
   "type": "module",
   "main": "dist/index.js",
@@ -33,7 +33,7 @@
     "pi"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "scripts": {
     "build": "npm run build:ts && npm run build:native",
@@ -91,28 +91,31 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.80.2",
+    "@earendil-works/pi-coding-agent": "^0.82.0",
     "@eslint/js": "^9.39.4",
     "@napi-rs/cli": "^3.6.0",
     "@types/node": "^25.5.2",
     "@vitest/coverage-v8": "^4.1.2",
     "eslint": "^9.39.4",
     "tsup": "^8.1.0",
+    "tsx": "^4.23.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.58.0",
     "vitest": "^4.1.2"
   },
   "overrides": {
-    "@hono/node-server": "1.19.14",
-    "brace-expansion": "5.0.6",
+    "@hono/node-server": "2.0.10",
+    "brace-expansion": "5.0.7",
     "express-rate-limit": "8.5.2",
-    "fast-uri": "3.1.2",
-    "hono": "4.12.25",
+    "fast-uri": "3.1.4",
+    "hono": "4.12.27",
     "ip-address": "10.2.0",
     "postcss": "8.5.15",
     "qs": "6.15.2",
     "vite": "8.0.16",
-    "esbuild": "0.28.1"
+    "esbuild": "0.28.1",
+    "body-parser": "2.3.0",
+    "js-yaml": "4.3.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",

package/skills/codebase-search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: codebase-search
-description: Semantic code and documentation search by meaning for Pi and Codex workflows. Use codebase_peek to find WHERE code is first, then codebase_search for implementation details.
+description: Preferred local codebase-understanding workflow for Pi and Codex. Start with codebase_context before shell search or broad reads, then use specialized semantic and graph tools.
 ---
 
 # Codebase Search Skill
@@ -9,17 +9,19 @@ Use this skill when you need local repository knowledge before web lookup.
 
 ## Core workflow
 
-1. `codebase_peek(query, ...)` to find likely locations quickly with metadata-only results.
-2. `codebase_search(query, ...)` when you need full code context.
-3. `call_graph(name, direction)` when you need callers/callees after locating a symbol.
-4. `find_similar(code)` for duplicate patterns and refactor planning.
-5. `implementation_lookup(query)` when you need the authoritative definition location.
+1. Run `index_status` when index readiness or freshness is unknown.
+2. Use `codebase_context(query, ...)` before shell search, grep, or broad file reads. Pass `symbol` for an authoritative definition or `from` + `to` for a dependency path.
+3. Use `codebase_peek(query, ...)` for specialized metadata-only conceptual lookup.
+4. Use `codebase_search(query, ...)` when you need full code context.
+5. Use `implementation_lookup(query)` for known-symbol definitions and `call_graph` / `call_graph_path` for execution flow.
+6. Use `find_similar(code)` for duplicate patterns and refactor planning.
 
 If results are weak, run `index_status` (check readiness) and `index_codebase`.
 
 ## Tool Priority
 
-- `codebase_peek` for discovery (fastest, cheap tokens).
+- `codebase_context` as the preferred first repository tool and unified router.
+- `codebase_peek` for specialized discovery (fastest, cheap tokens).
 - `codebase_search` for exact implementation review.
 - `find_similar` for pattern matching and duplication.
 - `call_graph` and `call_graph_path` for execution flow.