gitnexus 1.6.6-rc.17 → 1.6.6-rc.19

package/dist/cli/setup.js

@@ -48,11 +48,13 @@ function resolveGitnexusBin() {
             .map((l) => l.trim())
             .filter(Boolean);
         if (isWin) {
-            // On Windows, `where` returns multiple entries (e.g. the POSIX shell
-            // script AND the .cmd/.bat wrapper). Prefer the wrapper because
-            // child_process.spawn() cannot execute a shell script directly.
+            // On Windows, npm global installs can surface multiple launchers for the
+            // same package (e.g. a POSIX shell shim plus .cmd/.bat wrappers). Claude
+            // and the other MCP hosts need a directly spawnable command path, so only
+            // accept the Windows wrapper. If it is missing, fall back to the slower
+            // npx entry instead of persisting a non-spawnable shim path.
             const cmdLine = lines.find((l) => /\.(cmd|bat)$/i.test(l));
-            return cmdLine || lines[0] || null;
+            return cmdLine || null;
         }
         return lines[0] || null;
     }

package/dist/core/lbug/pool-adapter.d.ts

@@ -15,6 +15,25 @@
  * from the same Database is the officially supported concurrency pattern.
  */
 import lbug from '@ladybugdb/core';
+/**
+ * Probe whether a Windows FTS extension binary is locally installed under
+ * ~/.lbdb/extension/<any-version>/win_amd64/fts/. Returns true on the first
+ * version dir whose libfts.lbug_extension exists on disk; false if the
+ * extension root is missing or contains no FTS binary.
+ *
+ * Gates the Windows skip-FTS-load guard below so we only skip the load
+ * when no extension binary is present. When at least one binary exists,
+ * loadFTSExtension is called with policy: 'load-only' — LadybugDB resolves
+ * LOAD EXTENSION fts to its version-specific path internally, and the
+ * ExtensionManager's tryLoad try/catch handles version-mismatch errors
+ * cleanly without ever attempting dlopen of a stale binary. The install
+ * path that the #1199/#1217 SIGSEGV documented is never exercised at
+ * query time.
+ *
+ * Exported so unit tests can exercise the probe directly against a
+ * temp-dir plus spied `os.homedir()` — see lbug-pool-win-fts-probe.test.ts.
+ */
+export declare function hasLocalWinFtsExtension(): Promise<boolean>;
 /**
  * Listeners notified when a pool entry is torn down (LRU eviction, idle
  * timeout, explicit close). Used by upper layers (e.g. the BM25 search

package/dist/core/lbug/pool-adapter.js

@@ -15,9 +15,48 @@
  * from the same Database is the officially supported concurrency pattern.
  */
 import fs from 'fs/promises';
+import os from 'os';
+import path from 'path';
 import lbug from '@ladybugdb/core';
 import { isReadOnlyDbError, loadFTSExtension } from './lbug-adapter.js';
 import { createLbugDatabase, isWalCorruptionError, WAL_RECOVERY_SUGGESTION, } from './lbug-config.js';
+/**
+ * Probe whether a Windows FTS extension binary is locally installed under
+ * ~/.lbdb/extension/<any-version>/win_amd64/fts/. Returns true on the first
+ * version dir whose libfts.lbug_extension exists on disk; false if the
+ * extension root is missing or contains no FTS binary.
+ *
+ * Gates the Windows skip-FTS-load guard below so we only skip the load
+ * when no extension binary is present. When at least one binary exists,
+ * loadFTSExtension is called with policy: 'load-only' — LadybugDB resolves
+ * LOAD EXTENSION fts to its version-specific path internally, and the
+ * ExtensionManager's tryLoad try/catch handles version-mismatch errors
+ * cleanly without ever attempting dlopen of a stale binary. The install
+ * path that the #1199/#1217 SIGSEGV documented is never exercised at
+ * query time.
+ *
+ * Exported so unit tests can exercise the probe directly against a
+ * temp-dir plus spied `os.homedir()` — see lbug-pool-win-fts-probe.test.ts.
+ */
+export async function hasLocalWinFtsExtension() {
+    try {
+        const extRoot = path.join(os.homedir(), '.lbdb', 'extension');
+        const versions = await fs.readdir(extRoot);
+        for (const v of versions) {
+            try {
+                await fs.stat(path.join(extRoot, v, 'win_amd64', 'fts', 'libfts.lbug_extension'));
+                return true;
+            }
+            catch {
+                /* missing for this version, keep looking */
+            }
+        }
+    }
+    catch {
+        /* no .lbdb/extension dir */
+    }
+    return false;
+}
 const pool = new Map();
 const poolCloseListeners = new Set();
 /**
@@ -347,14 +386,24 @@ async function doInitLbug(repoId, dbPath) {
     // install; analyze owns extension installation. If LOAD fails, search
     // features degrade gracefully and the user-facing query path proceeds.
     if (!shared.ftsLoaded) {
-        // Windows guard: LOAD EXTENSION fts crashes with SIGSEGV on Windows when
-        // the FTS extension binary is not installed locally (@ladybugdb/core native
-        // bug — the extension loader hits an unhandled error path that signals SIGSEGV
-        // rather than throwing a JS exception, so try/catch cannot protect here).
-        // Skip the load on Windows; bm25-index.js catches the resulting Kuzu catalog
-        // errors and returns empty BM25 results gracefully. Graph queries are unaffected.
+        // Windows guard: LOAD EXTENSION fts crashes with SIGSEGV on Windows during
+        // *install* — the @ladybugdb/core out-of-process installer hits an unhandled
+        // error path that signals SIGSEGV instead of throwing (see #1199, #1217).
+        // The previous unconditional skip was over-broad: it also disabled FTS on
+        // hosts where the binary was already on disk and only needed LOAD, leaving
+        // BM25 silently degraded with no error path (see #1690).
+        //
+        // Probe ~/.lbdb/extension/*/win_amd64/fts/ first. If any binary is on disk
+        // we run loadFTSExtension(..., 'load-only'); the install path is never
+        // exercised, and LadybugDB's version-specific resolution + ExtensionManager
+        // try/catch handle stale/zero-byte siblings cleanly (verified empirically
+        // on Win10 + Node 22.19 + gitnexus 1.6.5 + @ladybugdb/core 0.16.1). With
+        // no binary at all, we fall back to the upstream skip so install-time
+        // SIGSEGV continues to be avoided.
         if (process.platform === 'win32') {
-            shared.ftsLoaded = true;
+            shared.ftsLoaded = (await hasLocalWinFtsExtension())
+                ? await loadFTSExtension(available[0], { policy: 'load-only' })
+                : true;
         }
         else {
             shared.ftsLoaded = await loadFTSExtension(available[0], { policy: 'load-only' });
@@ -414,10 +463,12 @@ export async function initLbugWithDb(repoId, existingDb, dbPath) {
     // Load FTS extension if not already loaded on this Database.
     // policy: 'load-only' — same contract as initLbug above; the read pool
     // must not block on a network install during query execution.
-    // Windows guard: same SIGSEGV risk as doInitLbug above — skip on Windows.
+    // Windows guard: same probe-then-load policy as doInitLbug above.
     if (!shared.ftsLoaded) {
         if (process.platform === 'win32') {
-            shared.ftsLoaded = true;
+            shared.ftsLoaded = (await hasLocalWinFtsExtension())
+                ? await loadFTSExtension(available[0], { policy: 'load-only' })
+                : true;
         }
         else {
             shared.ftsLoaded = await loadFTSExtension(available[0], { policy: 'load-only' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.6-rc.17",
+  "version": "1.6.6-rc.19",
   "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",