opencode-codebase-index 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codebase-index",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Semantic codebase indexing and search for OpenCode - find code by meaning, not just keywords",
   "type": "module",
   "main": "dist/index.js",
@@ -45,9 +45,9 @@
     "eval:ci:ollama": "npx tsx src/cli.ts eval run --config .github/eval-ollama-config.json --reindex --ci --budget benchmarks/budgets/default.json --against benchmarks/baselines/eval-baseline-summary.json",
     "eval:compare": "npx tsx src/cli.ts eval compare",
     "test": "vitest",
-    "pretest:run": "npm run build:native",
+    "pretest:run": "RUSTFLAGS=\"-C target-cpu=generic\" npm run build:native",
     "test:run": "vitest run",
-    "pretest:coverage": "npm run build:native",
+    "pretest:coverage": "RUSTFLAGS=\"-C target-cpu=generic\" npm run build:native",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
@@ -70,28 +70,33 @@
     ]
   },
   "dependencies": {
+    "@opencode-ai/plugin": "~1.3.13",
     "chokidar": "^5.0.0",
     "ignore": "^7.0.5",
-    "p-queue": "^9.1.0",
+    "p-queue": "^9.1.1",
     "p-retry": "^7.1.1",
     "tiktoken": "^1.0.15"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "@napi-rs/cli": "^3.5.1",
-    "@opencode-ai/plugin": "^1.1.21",
-    "@types/node": "^25.0.8",
-    "@vitest/coverage-v8": "^4.0.17",
-    "eslint": "^9.0.0",
+    "@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",
+    "eslint": "^9.39.4",
     "tsup": "^8.1.0",
-    "typescript": "^5.5.0",
-    "typescript-eslint": "^8.53.0",
-    "vitest": "^4.0.17",
-    "zod": "^3.25.67"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^4.1.2",
+    "zod": "^3.25.76"
+  },
+  "overrides": {
+    "@hono/node-server": "1.19.14",
+    "hono": "4.12.12",
+    "vite": "8.0.8"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@opencode-ai/plugin": "^1.0.0",
     "zod": "^3.0.0"
   },

package/skill/SKILL.md

@@ -1,14 +1,22 @@
 ---
 name: codebase-search
-description: Semantic code search by meaning. Use codebase_peek to find WHERE code is (saves tokens), codebase_search to see actual code. For exact identifiers, use grep instead.
+description: Semantic code and documentation search by meaning. Use codebase_peek to find WHERE code is (saves tokens), codebase_search to see actual code. For exact identifiers, use grep instead. Search local codebase before using websearch for code/library/API/example questions.
 ---
 
 # Codebase Search Skill
 
+## Important: Indexed Content
+
+The indexed codebase contains **two types of content**:
+
+1. **Project Source Code** — all code files in the current workspace
+2. **Knowledge Base Documentation** — external documentation, usage guides, API references, and example programs added via `add_knowledge_base`
+
 ## When to Use What
 
 | Scenario | Tool | Why |
 |----------|------|-----|
+| Code/library/API question | `codebase_search` | Search local knowledge first |
 | Just need file locations | `codebase_peek` | Metadata only, saves ~90% tokens |
 | Need to see actual code | `codebase_search` | Returns full code content |
 | Find duplicates/patterns | `find_similar` | Given code snippet → similar code |
@@ -16,12 +24,40 @@ description: Semantic code search by meaning. Use codebase_peek to find WHERE co
 | 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 |
+| Access specific URL | `webfetch` | Direct URL access, no codebase search needed |
+| Local search fails | `websearch` | Fallback when codebase has no results |
+| Local and web search fails | suggest adding knowledge base | Notify user to add related folder |
+
+## Search Rule
+
+**Search local codebase first, then web search if needed.**
+
+```
+Question received
+    ↓
+Is this about code/library/API/framework?
+    ↓ YES
+codebase_search(query)
+    ↓
+Found relevant results? → YES → Return answer
+    ↓ NO
+websearch(query)
+    ↓
+Found relevant results? → YES → Return answer
+    ↓ NO
+Suggest: "知识库中未找到相关信息，是否添加相关文档文件夹？"
+```
+
+1. Use `codebase_search` for code/library/API questions
+2. If no relevant results → use `websearch`
+3. If web search also fails → suggest adding a knowledge base folder
 
 ## Recommended Workflow
 
-1. **Locate with peek**: `codebase_peek("authentication flow")` → get file locations
-2. **Read what matters**: `Read` the specific files you need
-3. **Drill down with grep**: `grep "validateToken"` for exact matches
+1. **Search first**: `codebase_search("ADC channels ESP32")` → check local knowledge
+2. **Locate with peek**: `codebase_peek("authentication flow")` → get file locations
+3. **Read what matters**: `Read` the specific files you need
+4. **Drill down with grep**: `grep "validateToken"` for exact matches
 
 ## Tools
 
@@ -47,28 +83,45 @@ find_similar(code="function validate(input) { return input.length > 0; }", exclu
 ```
 
 ### `call_graph`
-Query callers or callees of a function/method. Built automatically during indexing for TypeScript, JavaScript, Python, Go, and Rust.
+Query callers or callees of a function/method.
 
 ```
 call_graph(name="validateToken", direction="callers")
-call_graph(name="validateToken", direction="callees", symbolId="src/auth.ts::validateToken")
 ```
 
-- `direction="callers"`: Who calls this function?
-- `direction="callees"`: What does this function call? (requires `symbolId` from a prior callers query)
-
 ### `index_codebase`
-Manually trigger indexing. Required before first search. Incremental (~50ms when unchanged).
+Manually trigger indexing. Required before first search.
 
 ### `index_status`
 Check if indexed and ready.
 
+### `add_knowledge_base`
+Add a folder as a knowledge base. The folder will be indexed alongside project code.
+
+```
+add_knowledge_base(path="/path/to/docs")
+```
+
+### `list_knowledge_bases`
+List all configured knowledge base folders.
+
+### `remove_knowledge_base`
+Remove a knowledge base folder from the index.
+
+```
+remove_knowledge_base(path="/path/to/docs")
+```
+
 ## Query Tips
 
 **Describe behavior, not syntax:**
 - Good: `"function that hashes passwords securely"`
 - Bad: `"hashPassword"` (use grep for exact names)
 
+**Search across documentation:**
+- Good: `"how to configure WiFi in ESP-IDF"`
+- Good: `"GPIO initialization example"`
+
 ## Filters
 
 | Filter | Example |