gitnexus 1.6.10-rc.90 → 1.6.10-rc.91

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

@@ -15,7 +15,7 @@ import { getNodeLabel as deriveNodeLabel } from './rel-pair-routing.js';
 import { EMBEDDABLE_LABELS } from '../embeddings/types.js';
 import { extensionManager, resolveAnalyzeInstallPolicy, } from './extension-loader.js';
 import { classifyDeleteAllError, closeLbugConnection, HANDLE_RELEASE_PROBE_ATTEMPTS, HANDLE_RELEASE_PROBE_DELAY_MS, isDbBusyError, isOpenRetryExhausted, isWalCorruptionError, bufferPoolExhaustionRemedy, openLbugConnection, sleep, toNativeSafePath, resolveNativeSafeStorageDir, WAL_RECOVERY_SUGGESTION, waitForWindowsHandleRelease, } from './lbug-config.js';
-import { finalizeLbugSidecarsAfterClose, guardWalQuarantine, isMissingShadowSidecarError, isReadOnlyShadowReplayError, lbugLockRemediation, preflightLbugSidecars, quarantineWalForMissingShadow, renameFailureMessage, shadowSidecarRecoveryMessage, } from './sidecar-recovery.js';
+import { cleanQuarantinedMissingShadowWals, finalizeLbugSidecarsAfterClose, guardWalQuarantine, isMissingShadowSidecarError, isReadOnlyShadowReplayError, lbugLockRemediation, preflightLbugSidecars, quarantineWalForMissingShadow, renameFailureMessage, shadowSidecarRecoveryMessage, sidecarPreflightDisabled, } from './sidecar-recovery.js';
 import { logger } from '../logger.js';
 /**
  * Split a relationship CSV into per-label-pair files on disk.
@@ -688,6 +688,26 @@ const doInitLbug = async (dbPath, readOnly = false) => {
         // -------------------------------------------------------------------------
         const releaseInitLock = await acquireInitLock(dbPath);
         try {
+            // Reclaim missing-shadow WAL quarantines from a PRIOR crash (#2637).
+            // LadybugDB renames an unrecoverable WAL aside as
+            // `${dbPath}.wal.missing-shadow.<ts>-<rand>` (quarantineWalForMissingShadow)
+            // instead of deleting it. Once quarantined it is permanently detached from
+            // the live store and never reopened, so reclaiming it is safe regardless of
+            // whether the main DB file exists this run — unlike the orphan-sidecar
+            // cleanup below, this must NOT be gated on "main DB missing": a quarantine
+            // event and a healthy main DB are independent facts. Never let a reclaim
+            // failure (e.g. a transient EBUSY from an antivirus scan) block DB startup.
+            if (!sidecarPreflightDisabled()) {
+                try {
+                    const reclaimed = await cleanQuarantinedMissingShadowWals(dbPath);
+                    for (const file of reclaimed) {
+                        logger.warn(`GitNexus: reclaimed quarantined WAL ${path.basename(file)} from a prior crash`);
+                    }
+                }
+                catch (err) {
+                    logger.warn(`GitNexus: failed to reclaim missing-shadow WAL quarantines: ${summarizeError(err)}`);
+                }
+            }
             // Crash-recovery cleanup: if the main DB file is missing, stale sidecars
             // from an interrupted run can block fresh opens indefinitely.
             try {

package/dist/core/lbug/sidecar-recovery.d.ts

@@ -26,6 +26,7 @@ export interface SidecarRecoveryLogger {
 }
 export declare const TINY_ORPHAN_WAL_BYTES: number;
 export declare const isMissingFsError: (err: unknown) => boolean;
+export declare const sidecarPreflightDisabled: () => boolean;
 export declare const statIfExists: (filePath: string) => Promise<{
     size: number;
 } | null>;

package/dist/core/lbug/sidecar-recovery.js

@@ -35,7 +35,7 @@ const ordinal = (n) => {
 };
 export const isMissingFsError = (err) => err?.code === 'ENOENT';
 const missing = isMissingFsError;
-const sidecarPreflightDisabled = () => /^(1|true|yes|on)$/i.test(process.env.GITNEXUS_DISABLE_LBUG_SIDECAR_PREFLIGHT ?? '');
+export const sidecarPreflightDisabled = () => /^(1|true|yes|on)$/i.test(process.env.GITNEXUS_DISABLE_LBUG_SIDECAR_PREFLIGHT ?? '');
 export const statIfExists = async (filePath) => {
     try {
         const statFn = fs.stat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.10-rc.90",
+  "version": "1.6.10-rc.91",
   "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",