opencode-codebase-index 0.11.0 → 0.13.0

package/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "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.'",
+            "statusMessage": "Codebase Index ready"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codebase-index",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Semantic codebase indexing and search for OpenCode - find code by meaning, not just keywords",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,9 @@
     "vector-search",
     "embeddings",
     "tree-sitter",
-    "ai-coding"
+    "ai-coding",
+    "pi-package",
+    "pi"
   ],
   "engines": {
     "node": ">=18.0.0"
@@ -38,6 +40,7 @@
     "build:ts": "tsup",
     "build:native": "cd native && cargo build --release && napi build --release --platform",
     "build:native:all": "cd native && napi build --release --platform --target x86_64-apple-darwin --target aarch64-apple-darwin --target x86_64-unknown-linux-gnu --target aarch64-unknown-linux-gnu --target x86_64-pc-windows-msvc",
+    "visualize": "node dist/cli.js visualize",
     "dev": "tsup --watch",
     "eval": "npx tsx src/cli.ts eval run",
     "eval:smoke": "npx tsx src/cli.ts eval run --config .github/eval-config.json --reindex --dataset benchmarks/golden/small.json",
@@ -57,7 +60,12 @@
     "dist",
     "native/*.node",
     "skill",
-    "commands"
+    "commands",
+    ".codex-plugin",
+    ".claude-plugin",
+    ".mcp.json",
+    "skills",
+    "hooks"
   ],
   "napi": {
     "binaryName": "codebase-index-native",
@@ -70,16 +78,19 @@
     ]
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@opencode-ai/plugin": "~1.3.13",
     "chokidar": "^5.0.0",
     "ignore": "^7.0.5",
     "p-queue": "^9.1.1",
     "p-retry": "^7.1.1",
-    "tiktoken": "^1.0.15"
+    "tiktoken": "^1.0.15",
+    "typebox": "^1.3.2",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.80.2",
     "@eslint/js": "^9.39.4",
-    "@modelcontextprotocol/sdk": "^1.29.0",
     "@napi-rs/cli": "^3.6.0",
     "@types/node": "^25.5.2",
     "@vitest/coverage-v8": "^4.1.2",
@@ -87,15 +98,14 @@
     "tsup": "^8.1.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.58.0",
-    "vitest": "^4.1.2",
-    "zod": "^3.25.76"
+    "vitest": "^4.1.2"
   },
   "overrides": {
     "@hono/node-server": "1.19.14",
     "brace-expansion": "5.0.6",
     "express-rate-limit": "8.5.2",
     "fast-uri": "3.1.2",
-    "hono": "4.12.23",
+    "hono": "4.12.25",
     "ip-address": "10.2.0",
     "postcss": "8.5.15",
     "qs": "6.15.2",
@@ -103,19 +113,23 @@
     "esbuild": "0.28.1"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@opencode-ai/plugin": "^1.0.0",
-    "zod": "^3.0.0"
+    "@earendil-works/pi-coding-agent": "*",
+    "@opencode-ai/plugin": "^1.0.0"
   },
   "peerDependenciesMeta": {
-    "@modelcontextprotocol/sdk": {
-      "optional": true
-    },
     "@opencode-ai/plugin": {
       "optional": true
     },
-    "zod": {
+    "@earendil-works/pi-coding-agent": {
       "optional": true
     }
+  },
+  "pi": {
+    "extensions": [
+      "./dist/pi-extension.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
   }
 }

package/skill/SKILL.md

@@ -21,6 +21,8 @@ The indexed codebase contains **two types of content**:
 | Need to see actual code | `codebase_search` | Returns full code content |
 | Find duplicates/patterns | `find_similar` | Given code snippet → similar code |
 | Understand code flow | `call_graph` | Find callers/callees of any function |
+| Trace dependency paths | `call_graph_path` | Find a shortest known path between two symbols |
+| Analyze PR blast radius | `pr_impact` | Find affected symbols, communities, hub nodes, and risk |
 | Don't know function/class names | `codebase_peek` or `codebase_search` | Natural language → code |
 | Know exact identifier names | `grep` | Faster, more precise |
 | Need ALL occurrences | `grep` | Semantic returns top N only |
@@ -54,10 +56,11 @@ Suggest: "知识库中未找到相关信息，是否添加相关文档文件夹
 
 ## Recommended Workflow
 
-1. **Search first**: `codebase_search("ADC channels ESP32")` → check local knowledge
-2. **Locate with peek**: `codebase_peek("authentication flow")` → get file locations
+1. **Locate by meaning first**: `codebase_peek("authentication flow")` → get likely locations before grep or graph tools
+2. **Search with content**: `codebase_search("ADC channels ESP32")` → inspect implementation or knowledge-base matches
 3. **Read what matters**: `Read` the specific files you need
-4. **Drill down with grep**: `grep "validateToken"` for exact matches
+4. **Trace structure after discovery**: `call_graph`, `call_graph_path`, `pr_impact`, or OMO CodeGraph once you know the relevant symbol
+5. **Drill down with grep**: `grep "validateToken"` for exact matches
 
 ## Tools
 

package/skills/codebase-search/SKILL.md

@@ -0,0 +1,41 @@
+---
+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.
+---
+
+# Codebase Search Skill
+
+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.
+
+If results are weak, run `index_status` (check readiness) and `index_codebase`.
+
+## Tool Priority
+
+- `codebase_peek` for 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.
+- `index_codebase` (force/estimate/verbose) for first-time or stale indexes.
+- `index_status`, `index_health_check`, `index_metrics`, `index_logs` for operational checks.
+
+## Suggested Commands
+
+1. `codebase_peek("payment processing flow")`
+2. `codebase_search("payment processing flow")`
+3. `call_graph("chargeCard", "callees")`
+4. `find_similar("function validate(data)")`
+5. `implementation_lookup("validate")`
+
+## Additional Notes
+
+- Use `grep` for exact identifiers and tiny, deterministic lookups.
+- Use `websearch` only when local tools return no results and docs are likely missing.
+- Prefer `codebase_peek` before `codebase_search` to avoid high token usage.