scythe-context-mcp 0.1.4 → 0.1.6

package/.env.example

@@ -18,4 +18,7 @@ SCYTHE_CONTEXT_MAX_CHUNKS_PER_FILE=80
 SCYTHE_CONTEXT_EMBEDDING_BATCH_SIZE=16
 SCYTHE_CONTEXT_MAX_EMBEDDING_CHUNKS=256
 
+# auto | off
+SCYTHE_CONTEXT_RERANK_MODE=auto
+
 # Legacy REPO_BEACON_* variables are still accepted as fallback during migration.

package/CHANGELOG.md

@@ -6,6 +6,22 @@ This project follows semantic versioning before npm publication where practical.
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-06-14
+
+### Added
+
+- Add `repo_doctor` local diagnostics for runtime, native modules, Gemini env, WSL interop, and index health without external API calls.
+- Expand the context-search benchmark to cover 30 repo-self lookup cases and exclude benchmark case text from scoring.
+- Add `SCYTHE_CONTEXT_RERANK_MODE=auto|off` and benchmark `--rerank auto|off` for ranking diagnostics.
+- Add a repo-local provider capability cache so Gemini-compatible batch support and dimensionality observations are reused across probes and embedding indexing.
+
+## [0.1.5] - 2026-06-14
+
+### Added
+
+- Add a context-search benchmark comparing `rg`, keyword-only Scythe search, and Gemini-backed hybrid search.
+- Add a local code-aware reranker that uses path, snippet, symbol, import graph, file-role, and source-counterpart signals without extra model/API calls.
+
 ## [0.1.4] - 2026-06-14
 
 ### Added

package/README.en.md

@@ -149,7 +149,8 @@ enabled_tools = [
   "repo_context_pack",
   "repo_semantic_search",
   "repo_related_files",
-  "gemini_embedding_probe"
+  "gemini_embedding_probe",
+  "repo_doctor"
 ]
 ```
 
@@ -157,6 +158,10 @@ enabled_tools = [
 
 If you really want to pin one default project, set `SCYTHE_CONTEXT_DEFAULT_PROJECT` under `[mcp_servers.scythe_context.env]`. Normal multi-repo usage should not need this; Scythe prefers a tool call's `project_path`, then `PWD`, then the MCP process `cwd`.
 
+`SCYTHE_CONTEXT_RERANK_MODE` can be `auto` or `off`. The default `auto` enables the local code-aware reranker; set it to `off` temporarily when diagnosing ranking behavior and comparing against the raw semantic/keyword merge.
+
+Scythe stores observed Gemini-compatible provider capabilities in repo-local `.scythe-context/provider-capabilities.json`, including whether batch embedding works, whether output dimensionality matches the expected size, and the latest probe / success / failure timestamps. This file is not committed; `repo_reindex(index_embeddings=true)` uses it to avoid repeatedly trying a batch endpoint that is already known to be unsupported.
+
 ### Gemini / v1beta proxy
 
 If URL/model/auth are not set, Scythe uses the official Gemini-compatible defaults:
@@ -243,14 +248,15 @@ Use `PWD/p` only if you intentionally run a Windows Node process and need WSL to
 | `repo_semantic_search` | Runs hybrid or semantic search over indexed chunks; useful for ranking diagnostics. |
 | `repo_related_files` | Shows symbols, imports, and importedBy for one file. |
 | `gemini_embedding_probe` | Tests Gemini or proxy compatibility and returns endpoint, latency, error classification, and remediation hints. |
+| `repo_doctor` | Checks Node runtime, native modules, Gemini env, provider capability cache, WSL interop, and index health without calling external APIs. |
 
 `repo_context_pack(mode="hybrid")` and `repo_semantic_search(mode="hybrid")` degrade to keyword-only results when query embedding is unavailable, returning `effectiveMode: "keyword"` and `fallback.reason: "embedding_unavailable"`. `mode="semantic"` does not degrade and returns `status: "embedding_unavailable"` because pure semantic search requires query embedding. Use `rg` / direct file reads for exact strings, known paths, or small targeted checks.
 
 ## Feature Status
 
-Implemented: repo scanning, chunking, SQLite metadata, SQLite FTS5, sqlite-vec, Gemini Embedding 2 provider, semantic/keyword/hybrid search, lightweight symbol/dependency graph, related-file lookup, `repo_context_pack`, provider diagnostics, and index freshness diagnostics.
+Implemented: repo scanning, chunking, SQLite metadata, SQLite FTS5, sqlite-vec, Gemini Embedding 2 provider, semantic/keyword/hybrid search, keyword-only fallback when embeddings fail, local code-aware reranker, lightweight symbol/dependency graph, related-file lookup, `repo_context_pack`, provider diagnostics, provider capability cache, index freshness diagnostics, and `repo_doctor`.
 
-Next: provider capability cache, install/native dependency doctor, keyword-only fallback when embeddings fail, and tree-sitter symbol extraction if needed.
+Next: expanded benchmark cases, remediation-message polish, and tree-sitter symbol extraction if needed.
 
 ## Privacy and Local Files
 
@@ -268,6 +274,7 @@ Do not include API keys, proxy tokens, private source snippets, or index databas
 - [Gemini Compatibility](docs/gemini-compatibility.md)
 - [Tech Stack](docs/tech-stack.md)
 - [Codex Integration Review](docs/codex-integration.md)
+- [Context Search Benchmark](docs/benchmark.md)
 
 ## Development and Publishing Checks
 

package/README.md

@@ -149,7 +149,8 @@ enabled_tools = [
   "repo_context_pack",
   "repo_semantic_search",
   "repo_related_files",
-  "gemini_embedding_probe"
+  "gemini_embedding_probe",
+  "repo_doctor"
 ]
 ```
 
@@ -157,6 +158,10 @@ enabled_tools = [
 
 如果你真的想固定某一個預設專案，可以在 `[mcp_servers.scythe_context.env]` 設 `SCYTHE_CONTEXT_DEFAULT_PROJECT`。一般多 repo 使用不需要這樣做；Scythe 會優先使用工具呼叫的 `project_path`，再使用 `PWD`，最後才使用 MCP process 的 `cwd`。
 
+`SCYTHE_CONTEXT_RERANK_MODE` 可設為 `auto` 或 `off`。預設 `auto` 會啟用 local code-aware reranker；排查 ranking 問題時可暫時設為 `off`，回到 semantic/keyword merge 的原始排序。
+
+Scythe 會在 repo-local `.scythe-context/provider-capabilities.json` 記錄目前 Gemini-compatible provider 的能力觀察結果，例如 batch embedding 是否可用、output dimensionality 是否符合預期，以及最近一次 probe / success / failure。這個檔案不提交；`repo_reindex(index_embeddings=true)` 會使用它避免反覆嘗試已知不支援的 batch endpoint。
+
 ### Gemini / v1beta proxy
 
 如果不填 URL/model/auth，預設會使用官方 Gemini 相容設定：
@@ -243,14 +248,15 @@ GEMINI_OUTPUT_DIMENSIONALITY = "1536"
 | `repo_semantic_search` | 對已索引 chunks 做 hybrid 或 semantic search，適合排查 ranking。 |
 | `repo_related_files` | 查看單一檔案的 symbols、imports、importedBy。 |
 | `gemini_embedding_probe` | 測試 Gemini 或 proxy 相容性，回傳 endpoint、latency、錯誤分類與可修復建議。 |
+| `repo_doctor` | 不呼叫外部 API，檢查 Node runtime、native modules、Gemini env、provider capability cache、WSL interop 與 index health。 |
 
 `repo_context_pack(mode="hybrid")` 和 `repo_semantic_search(mode="hybrid")` 在 query embedding 不可用時會降級成 keyword-only 結果，並回傳 `effectiveMode: "keyword"` 與 `fallback.reason: "embedding_unavailable"`。`mode="semantic"` 不會降級，會回傳 `status: "embedding_unavailable"`，因為純 semantic search 必須有 query embedding。精確字串、已知路徑或小範圍檢查仍建議直接用 `rg` / 直接讀檔。
 
 ## 功能狀態
 
-已完成：repo 掃描、chunking、SQLite metadata、SQLite FTS5、sqlite-vec、Gemini Embedding 2 provider、semantic/keyword/hybrid search、輕量 symbol/dependency graph、related-file lookup、`repo_context_pack`、provider diagnostics、index freshness diagnostics。
+已完成：repo 掃描、chunking、SQLite metadata、SQLite FTS5、sqlite-vec、Gemini Embedding 2 provider、semantic/keyword/hybrid search、embedding 失敗時的 keyword-only fallback、local code-aware reranker、輕量 symbol/dependency graph、related-file lookup、`repo_context_pack`、provider diagnostics、provider capability cache、index freshness diagnostics、`repo_doctor`。
 
-下一步：provider capability cache、安裝/原生依賴 doctor、embedding 失敗時的 keyword-only fallback、必要時加入 tree-sitter symbol extraction。
+下一步：擴充 benchmark cases、錯誤修復提示 polish、必要時加入 tree-sitter symbol extraction。
 
 ## 隱私與本機檔案
 
@@ -268,6 +274,7 @@ GEMINI_OUTPUT_DIMENSIONALITY = "1536"
 - [Gemini 相容性](docs/gemini-compatibility.md)
 - [技術棧](docs/tech-stack.md)
 - [Codex 整合審查](docs/codex-integration.md)
+- [Context search benchmark](docs/benchmark.md)
 
 ## 開發與發佈檢查
 

package/README.zh-CN.md

@@ -149,7 +149,8 @@ enabled_tools = [
   "repo_context_pack",
   "repo_semantic_search",
   "repo_related_files",
-  "gemini_embedding_probe"
+  "gemini_embedding_probe",
+  "repo_doctor"
 ]
 ```
 
@@ -157,6 +158,10 @@ enabled_tools = [
 
 如果你真的想固定某一个默认项目，可以在 `[mcp_servers.scythe_context.env]` 设置 `SCYTHE_CONTEXT_DEFAULT_PROJECT`。一般多 repo 使用不需要这样做；Scythe 会优先使用工具调用的 `project_path`，再使用 `PWD`，最后才使用 MCP process 的 `cwd`。
 
+`SCYTHE_CONTEXT_RERANK_MODE` 可设为 `auto` 或 `off`。默认 `auto` 会启用 local code-aware reranker；排查 ranking 问题时可暂时设为 `off`，回到 semantic/keyword merge 的原始排序。
+
+Scythe 会在 repo-local `.scythe-context/provider-capabilities.json` 记录当前 Gemini-compatible provider 的能力观察结果，例如 batch embedding 是否可用、output dimensionality 是否符合预期，以及最近一次 probe / success / failure。这个文件不提交；`repo_reindex(index_embeddings=true)` 会使用它避免反复尝试已知不支持的 batch endpoint。
+
 ### Gemini / v1beta proxy
 
 如果不填 URL/model/auth，默认会使用官方 Gemini 兼容配置：
@@ -243,14 +248,15 @@ GEMINI_OUTPUT_DIMENSIONALITY = "1536"
 | `repo_semantic_search` | 对已索引 chunks 做 hybrid 或 semantic search，适合排查 ranking。 |
 | `repo_related_files` | 查看单一文件的 symbols、imports、importedBy。 |
 | `gemini_embedding_probe` | 测试 Gemini 或 proxy 兼容性，返回 endpoint、latency、错误分类与可修复建议。 |
+| `repo_doctor` | 不调用外部 API，检查 Node runtime、native modules、Gemini env、provider capability cache、WSL interop 与 index health。 |
 
 `repo_context_pack(mode="hybrid")` 和 `repo_semantic_search(mode="hybrid")` 在 query embedding 不可用时会降级成 keyword-only 结果，并返回 `effectiveMode: "keyword"` 与 `fallback.reason: "embedding_unavailable"`。`mode="semantic"` 不会降级，会返回 `status: "embedding_unavailable"`，因为纯 semantic search 必须有 query embedding。精确字符串、已知路径或小范围检查仍建议直接用 `rg` / 直接读文件。
 
 ## 功能状态
 
-已完成：repo 扫描、chunking、SQLite metadata、SQLite FTS5、sqlite-vec、Gemini Embedding 2 provider、semantic/keyword/hybrid search、轻量 symbol/dependency graph、related-file lookup、`repo_context_pack`、provider diagnostics、index freshness diagnostics。
+已完成：repo 扫描、chunking、SQLite metadata、SQLite FTS5、sqlite-vec、Gemini Embedding 2 provider、semantic/keyword/hybrid search、embedding 失败时的 keyword-only fallback、local code-aware reranker、轻量 symbol/dependency graph、related-file lookup、`repo_context_pack`、provider diagnostics、provider capability cache、index freshness diagnostics、`repo_doctor`。
 
-下一步：provider capability cache、安装/原生依赖 doctor、embedding 失败时的 keyword-only fallback、必要时加入 tree-sitter symbol extraction。
+下一步：扩充 benchmark cases、错误修复提示 polish、必要时加入 tree-sitter symbol extraction。
 
 ## 隐私与本地文件
 
@@ -268,6 +274,7 @@ GEMINI_OUTPUT_DIMENSIONALITY = "1536"
 - [Gemini 兼容性](docs/gemini-compatibility.md)
 - [技术栈](docs/tech-stack.md)
 - [Codex 集成审查](docs/codex-integration.md)
+- [Context search benchmark](docs/benchmark.md)
 
 ## 开发与发布检查
 

package/benchmarks/context-search-cases.json

@@ -0,0 +1,291 @@
+[
+  {
+    "id": "embedding-fallback",
+    "query": "embedding unavailable should fall back to keyword-only context pack",
+    "expectedPaths": [
+      "src/tools/registerTools.ts",
+      "src/indexing/hybridSearch.ts"
+    ],
+    "notes": "Task-style query for the hybrid-to-keyword fallback path."
+  },
+  {
+    "id": "stable-chunk-ids",
+    "query": "preserve stable chunk row ids so embedding cache remains useful after reindex",
+    "expectedPaths": [
+      "src/indexing/indexWriter.ts",
+      "src/storage/schema.ts",
+      "src/storage/sqliteVec.test.ts"
+    ],
+    "notes": "Looks for storage and reindex behavior tied to embedding reuse."
+  },
+  {
+    "id": "utf8-binary-detection",
+    "query": "UTF-8 scanner should not treat a file as binary when prefix ends in multibyte character",
+    "expectedPaths": [
+      "src/indexing/binary.ts",
+      "src/indexing/scanner.test.ts"
+    ],
+    "notes": "Regression coverage for text detection around multibyte boundaries."
+  },
+  {
+    "id": "codex-wsl-config",
+    "query": "Codex App WSL Windows node setup with PWD and WSLENV",
+    "expectedPaths": [
+      "README.md",
+      "docs/codex-integration.md",
+      "src/config.ts"
+    ],
+    "notes": "Documentation and config lookup for the Windows Node plus WSL workspace mode."
+  },
+  {
+    "id": "related-file-graph",
+    "query": "related files imports reverse imports graph for context pack",
+    "expectedPaths": [
+      "src/indexing/relatedFiles.ts",
+      "src/indexing/contextPack.ts"
+    ],
+    "notes": "Finds symbol and dependency graph code used by repo_context_pack."
+  },
+  {
+    "id": "gemini-proxy-url",
+    "query": "Gemini v1beta compatible proxy base URL bearer auth output dimensionality",
+    "expectedPaths": [
+      "src/providers/gemini.ts",
+      "src/config.ts",
+      "docs/gemini-compatibility.md"
+    ],
+    "notes": "Provider compatibility query with base URL and auth details."
+  },
+  {
+    "id": "npm-bin-mode",
+    "query": "npm package executable bin mode should be checked before publish",
+    "expectedPaths": [
+      "scripts/bin-mode.mjs",
+      "package.json",
+      "src/cli.ts"
+    ],
+    "notes": "Release packaging and executable bit smoke coverage."
+  },
+  {
+    "id": "fts-keyword-search",
+    "query": "FTS trigram keyword search ranks chunks by bm25 and file path fallback",
+    "expectedPaths": [
+      "src/indexing/keywordSearch.ts",
+      "src/storage/schema.ts"
+    ],
+    "notes": "Keyword search internals and schema lookup."
+  },
+  {
+    "id": "doctor-native-modules",
+    "query": "diagnose better-sqlite3 sqlite-vec native module load failure without external API calls",
+    "expectedPaths": [
+      "src/tools/doctor.ts",
+      "src/storage/sqliteVec.ts",
+      "src/tools/doctor.test.ts"
+    ],
+    "notes": "Install/runtime diagnostics for native dependencies."
+  },
+  {
+    "id": "doctor-embedding-coverage",
+    "query": "repo doctor should warn when embedding coverage is incomplete",
+    "expectedPaths": [
+      "src/tools/doctor.ts",
+      "src/tools/doctor.test.ts"
+    ],
+    "notes": "Doctor index health and embedding coverage warning behavior."
+  },
+  {
+    "id": "register-repo-doctor-tool",
+    "query": "where is repo_doctor registered as an MCP tool",
+    "expectedPaths": [
+      "src/tools/registerTools.ts",
+      "src/tools/doctor.ts"
+    ],
+    "notes": "Exact tool wiring lookup."
+  },
+  {
+    "id": "server-instructions-rg-vs-context",
+    "query": "server instructions tell Codex when to use Scythe Context and when rg is better",
+    "expectedPaths": [
+      "src/index.ts",
+      "README.md",
+      "docs/codex-integration.md"
+    ],
+    "notes": "Prompt/tool-use policy lookup."
+  },
+  {
+    "id": "cli-version-help",
+    "query": "CLI --version and --help should match package version and show MCP config",
+    "expectedPaths": [
+      "src/cli.ts",
+      "src/cli.test.ts",
+      "package.json"
+    ],
+    "notes": "CLI smoke and version consistency."
+  },
+  {
+    "id": "config-default-project-pwd",
+    "query": "default project path should prefer SCYTHE_CONTEXT_DEFAULT_PROJECT then PWD then cwd",
+    "expectedPaths": [
+      "src/config.ts",
+      "src/config.test.ts"
+    ],
+    "notes": "Multi-repo default project behavior."
+  },
+  {
+    "id": "legacy-env-aliases",
+    "query": "legacy REPO_BEACON environment variables should still work as fallback aliases",
+    "expectedPaths": [
+      "src/config.ts",
+      "src/config.test.ts",
+      "README.md"
+    ],
+    "notes": "Rename compatibility and config migration."
+  },
+  {
+    "id": "gemini-batch-fallback",
+    "query": "embedding writer should fall back from batch embedding to single embed requests",
+    "expectedPaths": [
+      "src/indexing/embeddingWriter.ts",
+      "src/indexing/embeddingWriter.test.ts"
+    ],
+    "notes": "Provider capability and batch compatibility behavior."
+  },
+  {
+    "id": "gemini-error-classification",
+    "query": "Gemini provider should classify retryable HTTP errors and include safe body snippets",
+    "expectedPaths": [
+      "src/providers/gemini.ts",
+      "src/providers/gemini.test.ts"
+    ],
+    "notes": "Provider error handling lookup."
+  },
+  {
+    "id": "context-budgeting-truncation",
+    "query": "context pack should respect max context chars and mark truncated snippets",
+    "expectedPaths": [
+      "src/indexing/contextPack.ts",
+      "src/indexing/resultFormat.ts",
+      "src/indexing/contextPack.test.ts",
+      "src/indexing/resultFormat.test.ts"
+    ],
+    "notes": "Context budget and formatting behavior."
+  },
+  {
+    "id": "related-snippet-packing",
+    "query": "include related snippets for non-primary related files in context pack",
+    "expectedPaths": [
+      "src/indexing/relatedSnippets.ts",
+      "src/tools/registerTools.ts",
+      "src/indexing/contextPack.test.ts"
+    ],
+    "notes": "Related context expansion query."
+  },
+  {
+    "id": "code-aware-reranker-source-counterpart",
+    "query": "local code-aware reranker should add source counterpart when matched test file contains query terms",
+    "expectedPaths": [
+      "src/indexing/codeAwareReranker.ts",
+      "src/indexing/hybridSearch.test.ts",
+      "src/indexing/hybridSearch.ts"
+    ],
+    "notes": "Reranker source/test relation behavior."
+  },
+  {
+    "id": "path-role-ranking",
+    "query": "ranking should boost source files and downrank docs tests generated files depending on query intent",
+    "expectedPaths": [
+      "src/indexing/codeAwareReranker.ts",
+      "src/indexing/relatedFiles.ts"
+    ],
+    "notes": "File role and intent based ranking."
+  },
+  {
+    "id": "scanner-ignore-local-secrets",
+    "query": "scanner should ignore local secrets references screenshots and index directories",
+    "expectedPaths": [
+      "src/indexing/scanner.ts",
+      ".gitignore",
+      "AGENTS.md"
+    ],
+    "notes": "Privacy and ignored files behavior."
+  },
+  {
+    "id": "dry-run-indexing-stats",
+    "query": "dry run should scan project and report skipped files chunks bytes without writing metadata",
+    "expectedPaths": [
+      "src/indexing/dryRun.ts",
+      "src/indexing/dryRun.test.ts"
+    ],
+    "notes": "Safe indexing preview lookup."
+  },
+  {
+    "id": "sqlite-schema-fts-vector",
+    "query": "SQLite schema creates chunk FTS virtual table and sqlite-vec vector table",
+    "expectedPaths": [
+      "src/storage/schema.ts",
+      "src/storage/schema.test.ts",
+      "src/storage/sqliteVec.ts"
+    ],
+    "notes": "Storage schema internals."
+  },
+  {
+    "id": "dependency-resolution-relative-imports",
+    "query": "resolve relative imports to active project paths for TypeScript Python Rust and Go",
+    "expectedPaths": [
+      "src/indexing/symbolGraph.ts",
+      "src/indexing/symbolGraph.test.ts"
+    ],
+    "notes": "Symbol/dependency graph extraction."
+  },
+  {
+    "id": "semantic-vector-search-sqlite-vec",
+    "query": "semantic search uses sqlite-vec table and query vector dimensions",
+    "expectedPaths": [
+      "src/indexing/semanticSearch.ts",
+      "src/indexing/semanticSearch.test.ts",
+      "src/storage/sqliteVec.ts"
+    ],
+    "notes": "Raw semantic vector search behavior."
+  },
+  {
+    "id": "benchmark-rg-baseline",
+    "query": "benchmark compares rg smart baseline against scythe keyword and hybrid search",
+    "expectedPaths": [
+      "scripts/context-benchmark.mjs",
+      "benchmarks/context-search-cases.json",
+      "docs/benchmark.md"
+    ],
+    "notes": "Benchmark harness and no-MCP baseline."
+  },
+  {
+    "id": "npm-package-files",
+    "query": "npm package should include dist docs benchmark cases and context benchmark script but not local secrets",
+    "expectedPaths": [
+      "package.json",
+      ".gitignore",
+      "scripts/context-benchmark.mjs"
+    ],
+    "notes": "Package files and privacy boundary."
+  },
+  {
+    "id": "github-ci-release-checks",
+    "query": "CI should run tests build smoke audit before release",
+    "expectedPaths": [
+      ".github/workflows/ci.yml",
+      "package.json",
+      "CONTRIBUTING.md"
+    ],
+    "notes": "Contributor and CI workflow lookup."
+  },
+  {
+    "id": "security-privacy-embedding-text",
+    "query": "security policy should explain embedding text goes to configured remote provider and local indexes are not committed",
+    "expectedPaths": [
+      "SECURITY.md",
+      "README.md",
+      "AGENTS.md"
+    ],
+    "notes": "Privacy docs and remote embedding risk."
+  }
+]

package/dist/cli.js

@@ -1,4 +1,4 @@
-export const PACKAGE_VERSION = "0.1.4";
+export const PACKAGE_VERSION = "0.1.6";
 export function parseCliArgs(args) {
     if (args.length === 0)
         return { kind: "serve" };
@@ -31,5 +31,6 @@ Environment:
   GEMINI_API_KEY                  Gemini or Gemini-compatible API key
   GEMINI_BASE_URL                 Gemini-compatible base URL, default https://generativelanguage.googleapis.com/v1beta
   GEMINI_OUTPUT_DIMENSIONALITY    Embedding dimensions, default 1536
+  SCYTHE_CONTEXT_RERANK_MODE      auto or off, default auto
 `;
 }

package/dist/config.js

@@ -33,6 +33,13 @@ function authModeFromEnv(value) {
     }
     throw new Error("GEMINI_AUTH_MODE must be one of: x-goog-api-key, bearer, query");
 }
+function rerankModeFromEnv(value) {
+    if (!value)
+        return "auto";
+    if (value === "auto" || value === "off")
+        return value;
+    throw new Error("SCYTHE_CONTEXT_RERANK_MODE must be one of: auto, off");
+}
 function defaultProjectPathFromEnv() {
     const explicitProject = envValue("SCYTHE_CONTEXT_DEFAULT_PROJECT", "REPO_BEACON_DEFAULT_PROJECT");
     if (explicitProject)
@@ -61,6 +68,9 @@ export function loadConfig() {
             embeddingBatchSize: numberFromEnvAlias("SCYTHE_CONTEXT_EMBEDDING_BATCH_SIZE", "REPO_BEACON_EMBEDDING_BATCH_SIZE", 16) ?? 16,
             maxEmbeddingChunks: numberFromEnvAlias("SCYTHE_CONTEXT_MAX_EMBEDDING_CHUNKS", "REPO_BEACON_MAX_EMBEDDING_CHUNKS", 256) ?? 256,
         },
+        search: {
+            rerankMode: rerankModeFromEnv(envValue("SCYTHE_CONTEXT_RERANK_MODE", "REPO_BEACON_RERANK_MODE")),
+        },
         gemini: {
             apiKey: process.env.GEMINI_API_KEY,
             baseUrl: process.env.GEMINI_BASE_URL || "https://generativelanguage.googleapis.com/v1beta",