codesearch-mcp 0.2.3-alpha → 0.3.0-alpha

package/dist/src/commands/IndexCommand.js

@@ -8,7 +8,6 @@ const MonorepoAwareDiscoveryService_1 = require("../services/MonorepoAwareDiscov
 const project_scope_1 = require("../project-scope");
 const file_utils_1 = require("../file-utils");
 const legacy_ollama_index_1 = require("../services/legacy-ollama-index");
-/** `--project`'s index in `args`; the following token is its name unless absent or itself a flag. */
 function parseProjectFlag(args) {
     const i = args.indexOf('--project');
     if (i === -1)
@@ -38,8 +37,6 @@ class IndexCommand {
             process.exitCode = 1;
             return;
         }
-        // Resolve --project before any database or embedding work, so a bad name
-        // (or a cancelled no-name prompt) has zero side effects.
         let scanTargets;
         if (projectFlag.present) {
             let name = projectFlag.name;
@@ -65,11 +62,6 @@ class IndexCommand {
             scanTargets = targets;
         }
         await db.initDbWithSchema();
-        // A former Ollama installation the config layer cannot recognise (old
-        // defaults, no `embedding`/`ollama` block) is protected here: without an
-        // explicit `--reindex`, refuse to touch an index built by `ollama` (or a
-        // pre-`index_meta` install, which is indistinguishable from one) before
-        // any backend readiness check, Docker command, or schema work.
         if (!force) {
             let identity;
             try {
@@ -96,17 +88,9 @@ class IndexCommand {
             const selected = await new project_selector_1.ProjectSelector(config.workspaceRoot).select(discovered, forceSelect);
             if (selected.length === 0)
                 return;
-            // Expand any selected nested-monorepo unit (e.g. an Nx repo) into its
-            // sub-projects; ordinary projects pass through unchanged.
             projects = (0, MonorepoAwareDiscoveryService_1.toLeafProjects)(selected);
         }
-        // The post-index graph always reflects the full workspace, regardless of
-        // what this run actually scanned.
         const fullLeafProjects = (0, MonorepoAwareDiscoveryService_1.toLeafProjects)(discovered);
-        // Ensure the local model is served (Infinity only — no-op for cloud), then
-        // resolve the active embedding dimension and reconcile it with index_meta
-        // (recreate code_chunk on a dimension change, clear rows on a model change)
-        // before scanning. A clear error here beats a mid-run vector width mismatch.
         try {
             await embedder.ensureModelAvailable?.();
             const meta = await indexer.prepareEmbeddingSchema();
@@ -120,8 +104,6 @@ class IndexCommand {
         const controller = new AbortController();
         const teardown = (0, interrupt_1.setupInterrupt)(controller);
         try {
-            // --project bypasses pruning entirely — it promises "touch only this
-            // project," so nothing outside the resolved target(s) is ever removed.
             if (!scanTargets) {
                 let pruneResult;
                 try {
@@ -150,11 +132,7 @@ class IndexCommand {
                 console.log('\nIndexing interrupted.');
             this.printSummary(allStats);
             if (!controller.signal.aborted) {
-                // The graph is a post-index nicety — a failure here (DB dropped after a
-                // long run, unreadable dir) must not fail the whole run: indexing already
-                // succeeded and the summary is printed.
                 try {
-                    // Real import edges (code_dependency, just written) → intra-repo graph links.
                     const projectEdges = await searcher.getProjectEdges();
                     (0, graph_1.generateProjectGraph)(fullLeafProjects, projectEdges, config.workspaceRoot);
                 }

package/dist/src/commands/McpCommand.js

@@ -11,25 +11,19 @@ class McpCommand {
         let startupError;
         try {
             await db.initDb();
-            // Refuse to serve searches embedded into a foreign vector space — surface
-            // the mismatch through the existing startup-error plumbing so every tool
-            // call reports it clearly.
             await searcher.assertIndexMatches();
         }
         catch (err) {
             startupError = err instanceof Error ? err : new Error(String(err));
-            logger.error('McpCommand: startup check failed', { reason: startupError.message });
+            logger.error('McpCommand: startup check failed', { err: startupError });
         }
         try {
             await mcp.start(startupError);
         }
         catch (err) {
-            const reason = err instanceof Error ? err.message : String(err);
-            logger.error('McpCommand: MCP server failed to start', { reason });
+            logger.error('McpCommand: MCP server failed to start', { err });
             return;
         }
-        // server.connect() resolves immediately after setup; keep the process alive
-        // until the MCP client disconnects (stdin closes)
         await new Promise(resolve => {
             process.stdin.once('close', resolve);
             process.stdin.once('end', resolve);

package/dist/src/commands/WebCommand.js

@@ -17,9 +17,8 @@ class WebCommand {
         }
         catch (err) {
             const reason = err instanceof Error ? err.message : String(err);
-            logger.error('WebCommand: database connection failed', { reason });
+            logger.error('WebCommand: database connection failed', { err });
             console.error(`Database connection failed: ${reason}`);
-            // Continue: config editing still works; project/graph tabs will error in-page.
         }
         const server = new WebServerService_1.WebServer(searcher, config, logger, embedder);
         const host = '127.0.0.1';
@@ -28,13 +27,11 @@ class WebCommand {
         }
         catch (err) {
             const reason = err instanceof Error ? err.message : String(err);
-            logger.error('WebCommand: server failed to start', { reason });
+            logger.error('WebCommand: server failed to start', { err });
             console.error(`Failed to start web server on ${host}:${this.port}: ${reason}`);
             return;
         }
         console.log(`RAG dashboard: http://${host}:${this.port}  (Ctrl+C to stop)`);
-        // Keep execute() pending until a shutdown signal, otherwise app.ts tears
-        // down the DB and exits immediately (mirrors McpCommand's keep-alive).
         await new Promise(resolve => {
             const shutdown = () => { void server.stop().then(resolve); };
             process.once('SIGINT', shutdown);

package/dist/src/config-error.d.ts

@@ -1,7 +1,3 @@
-/**
- * Own module (not `config.ts`) so `config-store.ts` can throw it too without
- * an import cycle — `config.ts` imports from `config-store.ts`.
- */
 export declare class ConfigError extends Error {
     constructor(message: string);
 }

package/dist/src/config-error.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigError = void 0;
-/**
- * Own module (not `config.ts`) so `config-store.ts` can throw it too without
- * an import cycle — `config.ts` imports from `config-store.ts`.
- */
 class ConfigError extends Error {
     constructor(message) {
         super(message);

package/dist/src/config-store.d.ts

@@ -42,6 +42,7 @@ declare const jsonSchema: z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         provider: z.ZodOptional<z.ZodEnum<{
             "openai-compatible": "openai-compatible";
+            voyage: "voyage";
         }>>;
         baseURL: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
@@ -58,24 +59,11 @@ declare const jsonSchema: z.ZodObject<{
             warn: "warn";
         }>>;
         dir: z.ZodOptional<z.ZodString>;
-        searchMetrics: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     workspaceRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type JsonConfig = z.infer<typeof jsonSchema>;
 export declare const ALL_KEYS: string[];
-/**
- * Single source of truth for built-in defaults, keyed by raw config.json dotted
- * key. Consumed both by the web dashboard (`GET /api/defaults`) and by
- * `resolvedSchema` in `src/config.ts`, whose `.default(...)` calls reference
- * these values — so the runtime default and the dashboard-displayed default
- * cannot diverge. `as const` keeps the literal types so those `.default()`
- * lookups stay type-safe. Keys omitted here have no static default: required
- * fields (db.host/user/password) and values derived at runtime — db.name →
- * rag_<user>, and the provider-dependent URLs (embedding.baseURL,
- * reranker.baseURL, reranker.url), which are computed in the `Config`
- * constructor per provider rather than through a schema `.default(...)`.
- */
 export declare const CONFIG_DEFAULTS: {
     readonly 'db.port': 5433;
     readonly 'embedding.provider': "infinity";
@@ -97,54 +85,13 @@ export declare const CONFIG_DEFAULTS: {
     readonly 'reranker.overfetch': 5;
     readonly 'reranker.candidateFloor': 80;
     readonly 'logging.level': "error";
-    readonly 'logging.searchMetrics': false;
 };
 export declare function readConfigJson(): JsonConfig | null;
-/**
- * Detect a raw (pre-migration) config object that still selects the removed
- * `ollama` embedding provider — explicitly, via a legacy top-level `ollama`
- * block, or implicitly (no `provider` set, but `baseURL`/`model` point at
- * Ollama's defaults) — and throw a `ConfigError` with migration guidance
- * instead of letting it validate under a silently reinterpreted provider.
- * Runs before `migrateRawConfig` so a legacy `ollama.*` block is never
- * converted into an `embedding` block first. Pure — never mutates `raw`.
- */
 export declare function detectFormerOllamaConfig(raw: unknown): void;
-/**
- * Migrate a legacy raw config object to the current shape, in place of a
- * versioned migration system. Pure — returns a new object, never mutates input.
- *
- * - Removed translation keys (`search.autoTranslate`, `search.translateModel`)
- *   are dropped so they neither validate-fail nor take effect.
- * - Legacy `reranker.provider: 'ollama'` (a dead value — Ollama has no rerank
- *   API) is rewritten to `openai-compatible`, and a stale `/api/rerank` URL is
- *   dropped so it re-derives to `/rerank`. Otherwise the tightened enum would
- *   fail validation on existing configs and lock the user out.
- *
- * A legacy top-level `ollama` block reaches here only when `detectFormerOllamaConfig`
- * did not already reject it (i.e. an `embedding` block is also present); it is
- * dropped rather than merged. Exported for unit testing.
- */
 export declare function migrateRawConfig(raw: unknown): unknown;
-/**
- * Validate a raw (pre-migration) config object against the Zod schema: first
- * `detectFormerOllamaConfig` (a `ConfigError` on a former-Ollama config takes
- * priority over both migration and the regular Zod enum rejection), then
- * `migrateRawConfig`, then the schema itself. Unknown keys (e.g. the "$schema"
- * editor reference) are stripped. Throws with a caller-friendly message on
- * validation failure. The single entry point for both `readConfigJson` and
- * `PUT /api/config`, so both apply identical rules with an identical message.
- * Pure — no file I/O.
- */
 export declare function parseConfig(raw: unknown, source?: string): JsonConfig;
-/** Build the JSON Schema object generated from the Zod config schema. Pure. */
 export declare function buildJsonSchema(): Record<string, unknown>;
 export declare function writeConfigJson(data: JsonConfig): void;
-/**
- * Generate a JSON Schema from the Zod config schema and write it next to
- * config.json. Editors resolve it via the "$schema" reference and provide
- * key autocomplete, type hints, and inline validation while editing.
- */
 export declare function writeSchemaFile(): void;
 export declare function getNestedValue(cfg: JsonConfig, key: string): unknown;
 export declare function setNestedValue(cfg: JsonConfig, key: string, raw: string): JsonConfig;

package/dist/src/config-store.js

@@ -54,11 +54,7 @@ exports.CONFIG_DIR = path.join(os.homedir(), '.config', 'codesearch-mcp');
 exports.CONFIG_FILE = path.join(exports.CONFIG_DIR, 'config.json');
 exports.SCHEMA_FILE = path.join(exports.CONFIG_DIR, 'config.schema.json');
 exports.ENV_FILE = path.join(exports.CONFIG_DIR, '.env');
-// Relative $schema reference written into config.json so editors resolve the
-// sibling schema file for autocomplete / inline validation.
 const SCHEMA_REF = './config.schema.json';
-// All fields optional — defaults live in config.ts. The file stays minimal.
-// Descriptions surface as tooltips in schema-aware editors (VS Code, JetBrains).
 const jsonSchema = zod_1.z.object({
     db: zod_1.z.object({
         host: zod_1.z.string().describe('PostgreSQL host').optional(),
@@ -88,11 +84,11 @@ const jsonSchema = zod_1.z.object({
         maxLimit: zod_1.z.number().int().describe('Hard cap on results (default 20)').optional(),
     }).optional(),
     reranker: zod_1.z.object({
-        enabled: zod_1.z.boolean().describe('Enable cross-encoder reranking; requires reranker.model').optional(),
-        provider: zod_1.z.enum(['openai-compatible']).describe('Rerank backend. Only openai-compatible /rerank servers (Infinity, TEI, vLLM).').optional(),
-        baseURL: zod_1.z.string().describe('Rerank server base URL (defaults to embedding.baseURL — Infinity serves both).').optional(),
-        apiKey: zod_1.z.string().describe('API key, or env:VAR_NAME. Empty for local servers.').optional(),
-        model: zod_1.z.string().describe('Reranker model name (e.g. qllama/bge-reranker-v2-m3)').optional(),
+        enabled: zod_1.z.boolean().describe('Enable cross-encoder reranking (default true with infinity embedding or when reranker.provider/baseURL/url is set, else false)').optional(),
+        provider: zod_1.z.enum(['openai-compatible', 'voyage']).describe('Rerank backend: openai-compatible /rerank servers (Infinity, vLLM) or voyage (Voyage AI, requires reranker.apiKey) (default openai-compatible)').optional(),
+        baseURL: zod_1.z.string().describe('Rerank server base URL (default embedding.baseURL for openai-compatible — Infinity serves both; https://api.voyageai.com/v1 for voyage)').optional(),
+        apiKey: zod_1.z.string().describe('API key, or env:VAR_NAME. Empty for local servers; required for voyage.').optional(),
+        model: zod_1.z.string().describe('Reranker model name (default mixedbread-ai/mxbai-rerank-xsmall-v1 for openai-compatible, rerank-3 for voyage)').optional(),
         url: zod_1.z.string().describe('Full URL of the rerank endpoint (default derived from provider + baseURL)').optional(),
         overfetch: zod_1.z.number().int().min(1).max(20).describe('Candidate multiplier before reranking (limit × N, default 5)').optional(),
         candidateFloor: zod_1.z.number().int().min(1).describe('Minimum candidate pool fed to the reranker regardless of limit; fetchLimit = min(max(limit × overfetch, candidateFloor), 200) (default 80)').optional(),
@@ -100,7 +96,6 @@ const jsonSchema = zod_1.z.object({
     logging: zod_1.z.object({
         level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).describe('File log level (default error)').optional(),
         dir: zod_1.z.string().describe('Base log directory; "false" to disable file logging').optional(),
-        searchMetrics: zod_1.z.boolean().describe('Emit one structured search-tuning line (info level) per search, independent of level (default false)').optional(),
     }).optional(),
     workspaceRoot: zod_1.z.string().describe('Full path to the directory containing all your projects').optional(),
 });
@@ -134,22 +129,9 @@ const FIELD_TYPES = {
     'reranker.candidateFloor': 'number',
     'logging.level': 'string',
     'logging.dir': 'string',
-    'logging.searchMetrics': 'boolean',
     'workspaceRoot': 'string',
 };
 exports.ALL_KEYS = Object.keys(FIELD_TYPES);
-/**
- * Single source of truth for built-in defaults, keyed by raw config.json dotted
- * key. Consumed both by the web dashboard (`GET /api/defaults`) and by
- * `resolvedSchema` in `src/config.ts`, whose `.default(...)` calls reference
- * these values — so the runtime default and the dashboard-displayed default
- * cannot diverge. `as const` keeps the literal types so those `.default()`
- * lookups stay type-safe. Keys omitted here have no static default: required
- * fields (db.host/user/password) and values derived at runtime — db.name →
- * rag_<user>, and the provider-dependent URLs (embedding.baseURL,
- * reranker.baseURL, reranker.url), which are computed in the `Config`
- * constructor per provider rather than through a schema `.default(...)`.
- */
 exports.CONFIG_DEFAULTS = {
     'db.port': 5433,
     'embedding.provider': 'infinity',
@@ -171,7 +153,6 @@ exports.CONFIG_DEFAULTS = {
     'reranker.overfetch': 5,
     'reranker.candidateFloor': 80,
     'logging.level': 'error',
-    'logging.searchMetrics': false,
 };
 function readConfigJson() {
     if (!fs.existsSync(exports.CONFIG_FILE))
@@ -181,7 +162,7 @@ function readConfigJson() {
         raw = fs.readFileSync(exports.CONFIG_FILE, 'utf-8');
     }
     catch (e) {
-        throw new Error(`Cannot read ${exports.CONFIG_FILE}: ${e.message}`);
+        throw new Error(`Cannot read ${exports.CONFIG_FILE}: ${e.message}`, { cause: e });
     }
     let parsed;
     try {
@@ -189,7 +170,7 @@ function readConfigJson() {
     }
     catch (e) {
         throw new Error(`Invalid JSON in ${exports.CONFIG_FILE}: ${e.message}\n` +
-            `Fix the file manually or delete it and run: rag-setup`);
+            `Fix the file manually or delete it and run: rag-setup`, { cause: e });
     }
     return parseConfig(parsed, exports.CONFIG_FILE);
 }
@@ -198,19 +179,9 @@ const OLLAMA_MIGRATION_REMEDY = 'The "ollama" embedding provider has been remove
     'and embedding.baseURL to "http://localhost:11434/v1" — via `rag-config edit` (or by ' +
     'editing the config file directly) or by re-running `rag-setup`. After switching, rebuild ' +
     'the index with `rag-index --reindex`.';
-/** Strip a trailing `:tag` (Docker-style) from a model name, if present. */
 function stripModelTag(model) {
     return model.replace(/:[^:]*$/, '');
 }
-/**
- * Detect a raw (pre-migration) config object that still selects the removed
- * `ollama` embedding provider — explicitly, via a legacy top-level `ollama`
- * block, or implicitly (no `provider` set, but `baseURL`/`model` point at
- * Ollama's defaults) — and throw a `ConfigError` with migration guidance
- * instead of letting it validate under a silently reinterpreted provider.
- * Runs before `migrateRawConfig` so a legacy `ollama.*` block is never
- * converted into an `embedding` block first. Pure — never mutates `raw`.
- */
 function detectFormerOllamaConfig(raw) {
     if (raw == null || typeof raw !== 'object')
         return;
@@ -227,7 +198,7 @@ function detectFormerOllamaConfig(raw) {
                 try {
                     port = new URL(e.baseURL).port;
                 }
-                catch { /* unparsable — not a signal */ }
+                catch { }
                 if (port === '11434') {
                     throw new config_error_1.ConfigError(`Config's embedding.baseURL targets Ollama's default port (11434) with no embedding.provider set. ${OLLAMA_MIGRATION_REMEDY}`);
                 }
@@ -242,21 +213,6 @@ function detectFormerOllamaConfig(raw) {
         throw new config_error_1.ConfigError(`Config has a legacy "ollama" configuration block. ${OLLAMA_MIGRATION_REMEDY}`);
     }
 }
-/**
- * Migrate a legacy raw config object to the current shape, in place of a
- * versioned migration system. Pure — returns a new object, never mutates input.
- *
- * - Removed translation keys (`search.autoTranslate`, `search.translateModel`)
- *   are dropped so they neither validate-fail nor take effect.
- * - Legacy `reranker.provider: 'ollama'` (a dead value — Ollama has no rerank
- *   API) is rewritten to `openai-compatible`, and a stale `/api/rerank` URL is
- *   dropped so it re-derives to `/rerank`. Otherwise the tightened enum would
- *   fail validation on existing configs and lock the user out.
- *
- * A legacy top-level `ollama` block reaches here only when `detectFormerOllamaConfig`
- * did not already reject it (i.e. an `embedding` block is also present); it is
- * dropped rather than merged. Exported for unit testing.
- */
 function migrateRawConfig(raw) {
     if (raw == null || typeof raw !== 'object')
         return raw;
@@ -274,16 +230,6 @@ function migrateRawConfig(raw) {
     }
     return obj;
 }
-/**
- * Validate a raw (pre-migration) config object against the Zod schema: first
- * `detectFormerOllamaConfig` (a `ConfigError` on a former-Ollama config takes
- * priority over both migration and the regular Zod enum rejection), then
- * `migrateRawConfig`, then the schema itself. Unknown keys (e.g. the "$schema"
- * editor reference) are stripped. Throws with a caller-friendly message on
- * validation failure. The single entry point for both `readConfigJson` and
- * `PUT /api/config`, so both apply identical rules with an identical message.
- * Pure — no file I/O.
- */
 function parseConfig(raw, source = exports.CONFIG_FILE) {
     detectFormerOllamaConfig(raw);
     const migrated = migrateRawConfig(raw);
@@ -295,7 +241,6 @@ function parseConfig(raw, source = exports.CONFIG_FILE) {
     }
     return result.data;
 }
-/** Build the JSON Schema object generated from the Zod config schema. Pure. */
 function buildJsonSchema() {
     return {
         $id: 'https://github.com/oleksandr-antoniuk/RAG/config.schema.json',
@@ -306,15 +251,9 @@ function buildJsonSchema() {
 function writeConfigJson(data) {
     fs.mkdirSync(exports.CONFIG_DIR, { recursive: true });
     writeSchemaFile();
-    // $schema first so editors pick it up; readConfigJson strips it on validation.
     const withSchema = { $schema: SCHEMA_REF, ...data };
     fs.writeFileSync(exports.CONFIG_FILE, JSON.stringify(withSchema, null, 2) + '\n', { mode: 0o600 });
 }
-/**
- * Generate a JSON Schema from the Zod config schema and write it next to
- * config.json. Editors resolve it via the "$schema" reference and provide
- * key autocomplete, type hints, and inline validation while editing.
- */
 function writeSchemaFile() {
     fs.mkdirSync(exports.CONFIG_DIR, { recursive: true });
     fs.writeFileSync(exports.SCHEMA_FILE, JSON.stringify(buildJsonSchema(), null, 2) + '\n');

package/dist/src/config.d.ts

@@ -1,13 +1,12 @@
+import { type JsonConfig } from './config-store';
 import { ConfigError } from './config-error';
 export { ConfigError };
-/**
- * Resolve a config value that may reference an environment variable. A value of
- * the form `env:VAR_NAME` resolves to `process.env.VAR_NAME`; any other string
- * (including empty) is returned verbatim. A referenced-but-unset variable throws
- * a clear error naming the variable and the `.env` file. Pure aside from the
- * injected env map. See `src/app.ts` for how `.env` is loaded into the process.
- */
 export declare function resolveEnvRef(value: string, env?: NodeJS.ProcessEnv): string;
+export declare function rerankContext(raw: JsonConfig): {
+    wanted: boolean;
+    missingKey: boolean;
+    model: string;
+};
 export declare class Config {
     private readonly data;
     get db(): {
@@ -17,13 +16,6 @@ export declare class Config {
         password: string;
         database: string;
     };
-    /**
-     * Embedding config. `apiKey` is returned **raw** (possibly an `env:VAR` ref) —
-     * callers resolve it lazily via `resolveEnvRef` at the moment they build a
-     * request, so an unset referenced variable fails only when the key is actually
-     * needed (during embed/search) rather than crashing container construction and
-     * locking the user out of `rag-web`/`rag-mcp`.
-     */
     get embedding(): {
         provider: "openai-compatible" | "voyage" | "infinity";
         baseURL: string;
@@ -32,14 +24,14 @@ export declare class Config {
         dimensions: number | null;
         batchSize: number;
     };
-    /** Reranker config. `apiKey` is raw — resolve lazily with `resolveEnvRef`. */
     get reranker(): {
         enabled: boolean;
-        provider: "openai-compatible";
+        provider: "openai-compatible" | "voyage";
         baseURL: string;
         apiKey: string;
         model: string;
         url: string;
+        missingApiKey: boolean;
         overfetch: number;
         candidateFloor: number;
     };
@@ -57,7 +49,6 @@ export declare class Config {
     };
     get logging(): {
         level: "error" | "debug" | "info" | "warn";
-        searchMetrics: boolean;
         dir?: string | undefined;
     };
     get workspaceRoot(): string;

package/dist/src/config.js

@@ -35,18 +35,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = exports.ConfigError = void 0;
 exports.resolveEnvRef = resolveEnvRef;
+exports.rerankContext = rerankContext;
 const os = __importStar(require("os"));
 const zod_1 = require("zod");
 const config_store_1 = require("./config-store");
+const constants_1 = require("./constants");
 const config_error_1 = require("./config-error");
 Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return config_error_1.ConfigError; } });
-/**
- * Resolve a config value that may reference an environment variable. A value of
- * the form `env:VAR_NAME` resolves to `process.env.VAR_NAME`; any other string
- * (including empty) is returned verbatim. A referenced-but-unset variable throws
- * a clear error naming the variable and the `.env` file. Pure aside from the
- * injected env map. See `src/app.ts` for how `.env` is loaded into the process.
- */
 function resolveEnvRef(value, env = process.env) {
     if (!value.startsWith('env:'))
         return value;
@@ -66,12 +61,19 @@ const DEFAULT_BASE_URLS = {
 function defaultBaseURL(provider) {
     return DEFAULT_BASE_URLS[provider] ?? DEFAULT_BASE_URLS.infinity;
 }
-// Reranking is served only by OpenAI-compatible `/rerank` endpoints (Infinity,
-// TEI, vLLM, Jina/Cohere-shape) — a single endpoint shape. Normalize a trailing
-// `/embeddings` or `/v1` to the server root so a baseURL written with an
-// OpenAI-style suffix still yields `<root>/rerank`.
-function deriveRerankUrl(baseURL) {
-    const root = baseURL.replace(/\/+$/, '').replace(/\/(embeddings|v1)$/, '');
+function rerankContext(raw) {
+    const rr = raw.reranker;
+    const embProvider = raw.embedding?.provider ?? config_store_1.CONFIG_DEFAULTS['embedding.provider'];
+    const isVoyage = (rr?.provider ?? config_store_1.CONFIG_DEFAULTS['reranker.provider']) === 'voyage';
+    return {
+        wanted: embProvider === 'infinity' || rr?.provider != null || rr?.baseURL != null || rr?.url != null,
+        missingKey: isVoyage && !rr?.apiKey,
+        model: isVoyage ? constants_1.VOYAGE_RERANK_MODELS[0] : config_store_1.CONFIG_DEFAULTS['reranker.model'],
+    };
+}
+function deriveRerankUrl(provider, baseURL) {
+    const trimmed = baseURL.replace(/\/+$/, '');
+    const root = provider === 'voyage' ? trimmed : trimmed.replace(/\/(embeddings|v1)$/, '');
     return `${root}/rerank`;
 }
 const resolvedSchema = zod_1.z.object({
@@ -91,12 +93,13 @@ const resolvedSchema = zod_1.z.object({
         batchSize: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['embedding.batchSize']),
     }),
     reranker: zod_1.z.object({
-        enabled: zod_1.z.boolean().default(config_store_1.CONFIG_DEFAULTS['reranker.enabled']),
-        provider: zod_1.z.enum(['openai-compatible']).default(config_store_1.CONFIG_DEFAULTS['reranker.provider']),
+        enabled: zod_1.z.boolean(),
+        provider: zod_1.z.enum(['openai-compatible', 'voyage']).default(config_store_1.CONFIG_DEFAULTS['reranker.provider']),
         baseURL: zod_1.z.string().min(1),
         apiKey: zod_1.z.string().default(config_store_1.CONFIG_DEFAULTS['reranker.apiKey']),
-        model: zod_1.z.string().default(config_store_1.CONFIG_DEFAULTS['reranker.model']),
+        model: zod_1.z.string(),
         url: zod_1.z.string().min(1),
+        missingApiKey: zod_1.z.boolean(),
         overfetch: zod_1.z.number().int().min(1).max(20).default(config_store_1.CONFIG_DEFAULTS['reranker.overfetch']),
         candidateFloor: zod_1.z.number().int().min(1).default(config_store_1.CONFIG_DEFAULTS['reranker.candidateFloor']),
     }),
@@ -115,22 +118,13 @@ const resolvedSchema = zod_1.z.object({
     logging: zod_1.z.object({
         level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default(config_store_1.CONFIG_DEFAULTS['logging.level']),
         dir: zod_1.z.string().optional(),
-        searchMetrics: zod_1.z.boolean().default(config_store_1.CONFIG_DEFAULTS['logging.searchMetrics']),
     }),
     workspaceRoot: zod_1.z.string().default(''),
 });
 class Config {
     data;
     get db() { return this.data.db; }
-    /**
-     * Embedding config. `apiKey` is returned **raw** (possibly an `env:VAR` ref) —
-     * callers resolve it lazily via `resolveEnvRef` at the moment they build a
-     * request, so an unset referenced variable fails only when the key is actually
-     * needed (during embed/search) rather than crashing container construction and
-     * locking the user out of `rag-web`/`rag-mcp`.
-     */
     get embedding() { return this.data.embedding; }
-    /** Reranker config. `apiKey` is raw — resolve lazily with `resolveEnvRef`. */
     get reranker() { return this.data.reranker; }
     get indexer() { return this.data.indexer; }
     get search() { return this.data.search; }
@@ -142,8 +136,15 @@ class Config {
             throw new config_error_1.ConfigError('Config not found. Run rag-setup.');
         const embProvider = (raw.embedding?.provider ?? config_store_1.CONFIG_DEFAULTS['embedding.provider']);
         const embBaseURL = raw.embedding?.baseURL ?? defaultBaseURL(embProvider);
-        const rerankBaseURL = raw.reranker?.baseURL ?? embBaseURL;
-        const rerankUrl = raw.reranker?.url ?? deriveRerankUrl(rerankBaseURL);
+        const rr = raw.reranker;
+        const rerankProvider = (rr?.provider ?? config_store_1.CONFIG_DEFAULTS['reranker.provider']);
+        const isVoyageRerank = rerankProvider === 'voyage';
+        const rerankBaseURL = rr?.baseURL ?? (isVoyageRerank ? DEFAULT_BASE_URLS.voyage : embBaseURL);
+        const rerankUrl = rr?.url ?? deriveRerankUrl(rerankProvider, rerankBaseURL);
+        const rerankCtx = rerankContext(raw);
+        const rerankModel = rr?.model ?? rerankCtx.model;
+        const rerankWanted = rr?.enabled ?? rerankCtx.wanted;
+        const missingApiKey = rerankWanted && rerankCtx.missingKey;
         const result = resolvedSchema.safeParse({
             db: {
                 host: raw.db?.host,
@@ -161,14 +162,15 @@ class Config {
                 batchSize: raw.embedding?.batchSize,
             },
             reranker: {
-                enabled: raw.reranker?.enabled,
-                provider: raw.reranker?.provider,
+                enabled: rerankWanted && !missingApiKey,
+                provider: rr?.provider,
                 baseURL: rerankBaseURL,
-                apiKey: raw.reranker?.apiKey,
-                model: raw.reranker?.model,
+                apiKey: rr?.apiKey,
+                model: rerankModel,
                 url: rerankUrl,
-                overfetch: raw.reranker?.overfetch,
-                candidateFloor: raw.reranker?.candidateFloor,
+                missingApiKey,
+                overfetch: rr?.overfetch,
+                candidateFloor: rr?.candidateFloor,
             },
             indexer: {
                 chunkSize: raw.indexing?.chunkSize,
@@ -185,7 +187,6 @@ class Config {
             logging: {
                 level: raw.logging?.level,
                 dir: raw.logging?.dir,
-                searchMetrics: raw.logging?.searchMetrics,
             },
             workspaceRoot: raw.workspaceRoot,
         });

package/dist/src/constants.d.ts

@@ -1,42 +1,16 @@
 export type EmbeddingProvider = 'openai-compatible' | 'voyage' | 'infinity';
-/**
- * pgvector's HNSW / IVFFlat index hard limit. The effective embedding dimension
- * must not exceed this; larger cloud models must reduce via the Matryoshka
- * `dimensions` request parameter (`embedding.dimensions`).
- */
+export type RerankProvider = 'openai-compatible' | 'voyage';
+export declare const VOYAGE_RERANK_MODELS: readonly ["rerank-3", "rerank-3-lite"];
 export declare const MAX_EMBED_DIM = 2000;
 export interface ModelInfo {
     provider: EmbeddingProvider;
-    /** Native / default output width. */
     dimensions: number;
-    /** Model supports Matryoshka dimension reduction via a request parameter. */
     dimConfigurable?: boolean;
-    /** Max width that can be indexed under the pgvector cap (advisory). */
     maxIndexable?: number;
-    /** Max width the model itself can emit (advisory). */
     maxDim?: number;
 }
-/**
- * Advisory (NOT exhaustive) registry of known embedding models. Used to resolve
- * a model's dimension without a runtime probe and to suggest models in the
- * dashboard. Models absent here still work — their dimension is probed at index
- * time (see `resolveDimension`).
- */
 export declare const MODEL_REGISTRY: Record<string, ModelInfo>;
 export declare const DEFAULT_EMBED_MODEL = "jinaai/jina-embeddings-v2-base-code";
-/**
- * Former Ollama registry model names, kept only so config validation can
- * recognise an implicit (provider-less) config that still targets Ollama —
- * see `detectFormerOllamaConfig` in `config-store.ts`.
- */
 export declare const FORMER_OLLAMA_MODELS: readonly ["bge-m3", "nomic-embed-text", "mxbai-embed-large"];
-/** Advisory dimension for a model, or `undefined` when the model is unknown. */
 export declare function registryDimension(model: string): number | undefined;
-/**
- * Resolve the effective vector dimension: explicit override → registry → probe.
- * Validates the result is ≤ MAX_EMBED_DIM, throwing an error that names
- * `embedding.dimensions` as the fix. `probeFn` embeds a short string once and
- * returns the observed length; only called when neither override nor registry
- * yields a value. Pure aside from the injected probe.
- */
 export declare function resolveDimension(override: number | null | undefined, model: string, probeFn: () => Promise<number>, registry?: Record<string, ModelInfo>): Promise<number>;