gitnexus 1.6.6-rc.2 → 1.6.6-rc.3

package/dist/cli/analyze.js

@@ -12,6 +12,7 @@ import { execFileSync } from 'child_process';
 import v8 from 'v8';
 import cliProgress from 'cli-progress';
 import { closeLbug } from '../core/lbug/lbug-adapter.js';
+import { isWalCorruptionError, WAL_RECOVERY_SUGGESTION } from '../core/lbug/lbug-config.js';
 import { getStoragePaths, getGlobalRegistryPath, RegistryNameCollisionError, AnalysisNotFinalizedError, assertAnalysisFinalized, } from '../storage/repo-manager.js';
 import { getGitRoot, hasGitDir } from '../storage/git.js';
 import { runFullAnalysis } from '../core/run-analyze.js';
@@ -468,6 +469,16 @@ export const analyzeCommand = async (inputPath, options) => {
             process.exitCode = 1;
             return;
         }
+        // WAL corruption — the index file is unreadable. Give a clear recovery
+        // path without a confusing stack trace (the native error message alone
+        // is enough signal).
+        if (isWalCorruptionError(err) || msg.includes('LadybugDB WAL corruption')) {
+            cliError(`  The GitNexus index has a corrupted WAL file.\n` +
+                `  This usually happens when a previous analysis was interrupted mid-write.\n` +
+                `  ${WAL_RECOVERY_SUGGESTION}\n`, { recoveryHint: 'wal-corruption' });
+            process.exitCode = 1;
+            return;
+        }
         // HF download failure — show clean guidance without the raw stack trace.
         // Checked before writeFatalToStderr so the user sees one focused message
         // rather than a stack-trace dump followed by a second remediation block.

package/dist/cli/serve.js

@@ -1,6 +1,7 @@
 import { createServer } from '../server/api.js';
 import { logger, flushLoggerSync } from '../core/logger.js';
 import { cliError } from './cli-message.js';
+import { isWalCorruptionError, WAL_RECOVERY_SUGGESTION } from '../core/lbug/lbug-config.js';
 // Catch anything that would cause a silent exit. Pino v10's default
 // destination is `sync: false` (SonicBoom buffered) — call
 // `flushLoggerSync()` between the log and `process.exit(1)` so the crash
@@ -32,7 +33,11 @@ export const serveCommand = async (options) => {
         await createServer(port, host);
     }
     catch (err) {
-        if (err.code === 'EADDRINUSE') {
+        if (isWalCorruptionError(err)) {
+            cliError(`\nGitNexus server could not start: the index has a corrupted WAL file.\n` +
+                `  ${WAL_RECOVERY_SUGGESTION}\n`, { recoveryHint: 'wal-corruption' });
+        }
+        else if (err.code === 'EADDRINUSE') {
             cliError(`\nFailed to start GitNexus server:\n` +
                 `  ${err.message || err}\n\n` +
                 `  Port ${port} is already in use. Either:\n` +

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

@@ -8,7 +8,7 @@ import lbug from '@ladybugdb/core';
 import { NODE_TABLES, REL_TABLE_NAME, SCHEMA_QUERIES, EMBEDDING_TABLE_NAME, STALE_HASH_SENTINEL, } from './schema.js';
 import { streamAllCSVsToDisk } from './csv-generator.js';
 import { extensionManager } from './extension-loader.js';
-import { closeLbugConnection, isDbBusyError, isOpenRetryExhausted, openLbugConnection, waitForWindowsHandleRelease, } from './lbug-config.js';
+import { closeLbugConnection, isDbBusyError, isOpenRetryExhausted, isWalCorruptionError, openLbugConnection, WAL_RECOVERY_SUGGESTION, waitForWindowsHandleRelease, } from './lbug-config.js';
 import { isVectorExtensionSupportedByPlatform } from '../platform/capabilities.js';
 import { logger } from '../logger.js';
 /**
@@ -508,6 +508,22 @@ const doInitLbug = async (dbPath) => {
             //     anyway and any genuine cross-process lock contention surfaces
             //     on the next operation via withLbugDb's retry. Logging it here
             //     would just be noise in CI.
+            //
+            // WAL corruption: the first DDL write after DB open triggers WAL
+            // replay — if the WAL file was left in a corrupt state by an
+            // interrupted previous run, the native engine throws here. Rather
+            // than logging a WARN and continuing in a broken state, close the
+            // DB cleanly and surface an actionable error so the caller (serve,
+            // MCP, analyze) can exit with a clear recovery message.
+            if (isWalCorruptionError(err)) {
+                await safeClose();
+                currentDbPath = null;
+                ftsLoaded = false;
+                vectorExtensionLoaded = false;
+                ensuredFTSIndexes.clear();
+                throw new Error(`LadybugDB WAL corruption detected at ${dbPath}. ${WAL_RECOVERY_SUGGESTION}\n` +
+                    `  Original error: ${msg.slice(0, 200)}`);
+            }
             if (!msg.includes('already exists') && !isDbBusyError(err)) {
                 logger.warn(`⚠️ Schema creation warning: ${msg.slice(0, 120)}`);
             }

package/dist/core/lbug/lbug-config.d.ts

@@ -32,7 +32,7 @@ import type lbug from '@ladybugdb/core';
  * integer; anything invalid falls back to the default.
  */
 export declare const LBUG_MAX_DB_SIZE: number;
-export declare const WAL_RECOVERY_SUGGESTION = "WAL corruption detected. Run `gitnexus analyze` to rebuild the index.";
+export declare const WAL_RECOVERY_SUGGESTION = "WAL corruption detected. Run `gitnexus analyze --force` to rebuild the index.";
 export declare function isWalCorruptionError(err: unknown): boolean;
 type LbugModule = typeof lbug;
 export interface LbugDatabaseOptions {

package/dist/core/lbug/lbug-config.js

@@ -44,7 +44,7 @@ export const LBUG_MAX_DB_SIZE = (() => {
 })();
 /** Matches WAL corruption errors from the LadybugDB engine. */
 const WAL_CORRUPTION_RE = /corrupt(ed)?\s+wal|invalid\s+wal\s+record|wal.*corrupt|checksum.*wal/i;
-export const WAL_RECOVERY_SUGGESTION = 'WAL corruption detected. Run `gitnexus analyze` to rebuild the index.';
+export const WAL_RECOVERY_SUGGESTION = 'WAL corruption detected. Run `gitnexus analyze --force` to rebuild the index.';
 export function isWalCorruptionError(err) {
     if (!err)
         return false;

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

@@ -17,7 +17,7 @@
 import fs from 'fs/promises';
 import lbug from '@ladybugdb/core';
 import { loadFTSExtension } from './lbug-adapter.js';
-import { createLbugDatabase, isWalCorruptionError } from './lbug-config.js';
+import { createLbugDatabase, isWalCorruptionError, WAL_RECOVERY_SUGGESTION, } from './lbug-config.js';
 const pool = new Map();
 const poolCloseListeners = new Set();
 /**
@@ -310,8 +310,7 @@ async function doInitLbug(repoId, dbPath) {
                         break;
                     }
                     catch (retryErr) {
-                        throw new Error(`LadybugDB WAL corruption detected for ${repoId}. ` +
-                            `Run \`gitnexus analyze\` to rebuild the index. ` +
+                        throw new Error(`LadybugDB WAL corruption detected for ${repoId}. ${WAL_RECOVERY_SUGGESTION} ` +
                             `(${retryErr instanceof Error ? retryErr.message : String(retryErr)})`);
                     }
                 }

package/package.json

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