gitnexus 1.6.4-rc.23 → 1.6.4-rc.25

package/dist/mcp/local/local-backend.d.ts

@@ -73,6 +73,13 @@ export declare class LocalBackend {
      * making MCP stderr unreadable.
      */
     private warnedSiblingDrift;
+    /**
+     * One-shot stderr warning for the VECTOR-extension fallback. Without this
+     * guard the diagnostic would fire on every `semanticSearch()` call on
+     * platforms where the extension is unsupported (e.g. Windows), making MCP
+     * stderr noisy per DoD §2.8.
+     */
+    private warnedVectorUnsupported;
     /**
      * Cross-repo group tools (CLI). Shares logic with MCP `group_*` handlers.
      */

package/dist/mcp/local/local-backend.js

@@ -20,7 +20,7 @@ import { resolveAtGroupMemberRepoPath } from '../../core/group/resolve-at-member
 import { collectBestChunks } from '../../core/embeddings/types.js';
 import { rankExactEmbeddingRows, } from '../../core/embeddings/exact-search.js';
 import { EMBEDDING_TABLE_NAME, EMBEDDING_INDEX_NAME } from '../../core/lbug/schema.js';
-import { getExactScanLimit } from '../../core/platform/capabilities.js';
+import { getExactScanLimit, isVectorExtensionSupportedByPlatform, } from '../../core/platform/capabilities.js';
 import { PhaseTimer } from '../../core/search/phase-timer.js';
 import { checkStaleness, checkCwdMatch } from '../../core/git-staleness.js';
 // AI context generation is CLI-only (gitnexus analyze)
@@ -172,6 +172,13 @@ export class LocalBackend {
      * making MCP stderr unreadable.
      */
     warnedSiblingDrift = new Set();
+    /**
+     * One-shot stderr warning for the VECTOR-extension fallback. Without this
+     * guard the diagnostic would fire on every `semanticSearch()` call on
+     * platforms where the extension is unsupported (e.g. Windows), making MCP
+     * stderr noisy per DoD §2.8.
+     */
+    warnedVectorUnsupported = false;
     /**
      * Cross-repo group tools (CLI). Shares logic with MCP `group_*` handlers.
      */
@@ -892,9 +899,10 @@ export class LocalBackend {
             const dims = getEmbeddingDims();
             const queryVecStr = `[${queryVec.join(',')}]`;
             let bestChunks = new Map();
-            try {
-                bestChunks = await collectBestChunks(limit, async (fetchLimit) => {
-                    const vectorQuery = `
+            if (isVectorExtensionSupportedByPlatform()) {
+                try {
+                    bestChunks = await collectBestChunks(limit, async (fetchLimit) => {
+                        const vectorQuery = `
             CALL QUERY_VECTOR_INDEX('${EMBEDDING_TABLE_NAME}', '${EMBEDDING_INDEX_NAME}',
               CAST(${queryVecStr} AS FLOAT[${dims}]), ${fetchLimit})
             YIELD node AS emb, distance
@@ -904,18 +912,28 @@ export class LocalBackend {
                    emb.startLine AS startLine, emb.endLine AS endLine, distance
             ORDER BY distance
           `;
-                    const embResults = await executeQuery(repo.id, vectorQuery);
-                    return embResults.map((row) => ({
-                        nodeId: row.nodeId ?? row[0],
-                        chunkIndex: row.chunkIndex ?? row[1] ?? 0,
-                        startLine: row.startLine ?? row[2] ?? 0,
-                        endLine: row.endLine ?? row[3] ?? 0,
-                        distance: row.distance ?? row[4],
-                    }));
-                });
+                        const embResults = await executeQuery(repo.id, vectorQuery);
+                        return embResults.map((row) => ({
+                            nodeId: row.nodeId ?? row[0],
+                            chunkIndex: row.chunkIndex ?? row[1] ?? 0,
+                            startLine: row.startLine ?? row[2] ?? 0,
+                            endLine: row.endLine ?? row[3] ?? 0,
+                            distance: row.distance ?? row[4],
+                        }));
+                    });
+                }
+                catch {
+                    bestChunks = new Map();
+                }
             }
-            catch {
-                bestChunks = new Map();
+            else if (!this.warnedVectorUnsupported) {
+                // Rare diagnostic: surface why we fell back to the exact scan path so
+                // operators can see at a glance that the VECTOR extension is missing on
+                // this runtime (e.g. Windows builds without the optional native
+                // dependency). Emitted once per `LocalBackend` instance lifetime to
+                // avoid noisy stderr on hot semantic-search paths (DoD §2.8).
+                this.warnedVectorUnsupported = true;
+                console.error('GitNexus [query:vector]: VECTOR index unavailable for this runtime; using exact scan fallback');
             }
             if (bestChunks.size === 0) {
                 const embeddingCount = Number(tableCheck[0].cnt ?? tableCheck[0][0] ?? 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.4-rc.23",
+  "version": "1.6.4-rc.25",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",