docdex 0.2.43 → 0.2.44

package/CHANGELOG.md

@@ -1,8 +1,8 @@
 # Changelog
 
-## 0.2.43
+## 0.2.44
 - Fix MCP tool schema compatibility with Claude Code by removing top-level anyOf from `docdex_dag_export`.
-- Bump release metadata to 0.2.43.
+- Bump release metadata to 0.2.44.
 
 ## 0.2.42
 - Bump release metadata to 0.2.42.

package/README.md

@@ -231,8 +231,9 @@ DOCDEX_OLLAMA_BASE_URL=http://127.0.0.1:11434 docdexd daemon --host 127.0.0.1 --
 Docdex runs as a local daemon serving:
 
 * **CLI Commands:** `docdexd chat`
-* **HTTP API:** `/search`, `/v1/ast`, `/v1/graph/impact`
+* **HTTP API:** `/search`, `/v1/capabilities`, `/v1/search/rerank`, `/v1/search/batch`, `/v1/ast`, `/v1/graph/impact`
 * **MCP Endpoints:** `/v1/mcp` and `/v1/mcp/sse`
+* **Capability Negotiation Tools:** `docdex_capabilities`, `docdex_rerank`, `docdex_batch_search`
 
 ### Multi-Repo Setup
 

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.43 ----
+---- START OF DOCDEX INFO V0.2.44 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).
@@ -146,6 +146,10 @@ Use these to verify index coverage, repo binding, and to read precise file slice
 - docdex_impact_graph: Mandatory before code changes to review inbound/outbound deps (use MCP/IPC if shell networking is blocked).
 - docdex_dag_export: Export dependency graph to plan change order.
 - HTTP /v1/initialize: Mount/bind a repo for HTTP daemon mode. Request JSON uses rootUri/root_uri (NOT repo_root).
+- HTTP /v1/capabilities: Read optional retrieval feature flags and bounded limits before using optional flows.
+- HTTP /v1/search/rerank: Rerank a candidate hit set; use when capability negotiation says rerank is available.
+- HTTP /v1/search/batch: Execute bounded multi-query retrieval in one request.
+- MCP tools `docdex_capabilities`, `docdex_rerank`, `docdex_batch_search`: optional capability/flow surfaces for Codali integration.
 - HTTP /v1/snippet: Fetch exact line-safe snippets for a doc_id returned by search.
 - HTTP /v1/impact/diagnostics: Inspect unresolved/dynamic imports when impact graphs look incomplete.
 
@@ -222,6 +226,41 @@ Notes:
 - `skip_local_search=true` effectively forces web discovery (Tier 2).
 - If DOCDEX_WEB_ENABLED=1, web discovery can be slow; plan timeouts accordingly.
 
+### 3a) Capabilities (HTTP)
+
+`GET /v1/capabilities`
+
+Returns the optional-feature capability contract and current limit values for retrieval extensions.
+
+### 3b) Rerank (HTTP)
+
+`POST /v1/search/rerank`
+
+Required JSON fields:
+- `query` (string)
+- `candidates` (array of search hits)
+
+Common optional fields:
+- `limit`, `repo_id`
+
+Notes:
+- Candidate sets are deterministically truncated to the rerank limit exposed by `/v1/capabilities`.
+- Response includes `returned_count`, `input_count`, `limit`, and `truncated`.
+
+### 3c) Batch search (HTTP)
+
+`POST /v1/search/batch`
+
+Required JSON fields:
+- `queries` (array of query strings)
+
+Common optional fields:
+- `limit`, `include_libs`, `repo_id`
+
+Notes:
+- Query lists are deterministically truncated to the batch limit exposed by `/v1/capabilities`.
+- Response includes `query_count`, `effective_query_count`, `results`, and `truncated`.
+
 ### 4) Snippet (HTTP)
 
 `GET /snippet/:doc_id`
@@ -263,6 +302,9 @@ Notes:
 Do not guess fields; use these canonical shapes.
 
 - `docdex_search`: `{ project_root, query, limit?, diff?, repo_only?, force_web? }`
+- `docdex_capabilities`: `{ project_root? }`
+- `docdex_rerank`: `{ project_root?, query, candidates, limit? }`
+- `docdex_batch_search`: `{ project_root?, queries, limit?, include_libs? }`
 - `docdex_open`: `{ project_root, path, start_line?, end_line?, head?, clamp? }` (range must be valid unless clamp/head used)
 - `docdex_files`: `{ project_root, limit?, offset? }`
 - `docdex_stats`: `{ project_root }`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.43",
+  "version": "0.2.44",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {