claude-flow 2.7.41 → 2.7.43

package/src/memory/sqlite-wrapper.js

@@ -33,35 +33,79 @@ async function tryLoadSQLite() {
       return true;
     } catch (importErr) {
       loadError = importErr;
-      
-      // Check for specific Windows errors
-      if (requireErr.message.includes('was compiled against a different Node.js version') ||
-          requireErr.message.includes('Could not locate the bindings file') ||
-          requireErr.message.includes('The specified module could not be found') ||
+
+      // Check for NODE_MODULE_VERSION mismatch (different Node.js ABI)
+      const isVersionMismatch =
+        requireErr.message?.includes('NODE_MODULE_VERSION') ||
+        importErr.message?.includes('NODE_MODULE_VERSION') ||
+        requireErr.message?.includes('was compiled against a different Node.js version') ||
+        importErr.message?.includes('was compiled against a different Node.js version');
+
+      if (isVersionMismatch) {
+        // Extract version info for helpful message
+        const errorMsg = requireErr.message || importErr.message || '';
+        const compiledMatch = errorMsg.match(/NODE_MODULE_VERSION (\d+)/);
+        const requiredMatch = errorMsg.match(/requires\s+NODE_MODULE_VERSION (\d+)/);
+
+        const nodeVersionMap = {
+          '108': '18.x', '115': '20.x', '120': '21.x', '127': '22.x', '131': '23.x'
+        };
+
+        let versionInfo = '';
+        if (compiledMatch && requiredMatch) {
+          const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;
+          const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;
+          versionInfo = `\n║  Module compiled for Node.js ${compiled}, running Node.js ${required}`.padEnd(79) + '║';
+        }
+
+        console.warn(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║              Native Module Version Mismatch (NODE_MODULE_VERSION)            ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  The better-sqlite3 module was compiled for a different Node.js version.    ║${versionInfo}
+║                                                                              ║
+║  Claude Flow will continue with JSON fallback storage (still works fine).   ║
+║                                                                              ║
+║  To fix this and use SQLite:                                                 ║
+║                                                                              ║
+║  Option 1 - Rebuild the module:                                              ║
+║  > npm rebuild better-sqlite3                                                ║
+║                                                                              ║
+║  Option 2 - Clear npx cache (if using npx):                                  ║
+║  > rm -rf ~/.npm/_npx/ && npx claude-flow@alpha ...                         ║
+║                                                                              ║
+║  Option 3 - Reinstall dependencies:                                         ║
+║  > rm -rf node_modules && npm install                                        ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+`);
+        return false;
+      }
+
+      // Check for other Windows/installation errors
+      if (requireErr.message?.includes('Could not locate the bindings file') ||
+          requireErr.message?.includes('The specified module could not be found') ||
           requireErr.code === 'MODULE_NOT_FOUND') {
-        
+
         console.warn(`
 ╔══════════════════════════════════════════════════════════════════════════════╗
-║                     Windows SQLite Installation Issue                         ║
+║                     SQLite Native Module Installation Issue                   ║
 ╠══════════════════════════════════════════════════════════════════════════════╣
 ║                                                                              ║
 ║  The native SQLite module failed to load. This is common on Windows when    ║
-║  using 'npx' or when node-gyp build tools are not available.               ║
-║                                                                              ║
-║  Claude Flow will continue with in-memory storage (non-persistent).         ║
+║  using 'npx' or when node-gyp build tools are not available.                ║
 ║                                                                              ║
-║  To enable persistent storage on Windows:                                    ║
+║  Claude Flow will continue with JSON fallback storage (still works fine).   ║
 ║                                                                              ║
-║  Option 1 - Install Windows Build Tools:                                    ║
-║  > npm install --global windows-build-tools                                 ║
-║  > npm install claude-flow@alpha                                           ║
+║  To enable SQLite storage:                                                   ║
 ║                                                                              ║
-║  Option 2 - Use Pre-built Binaries:                                        ║
-║  > npm config set python python3                                           ║
-║  > npm install claude-flow@alpha --build-from-source=false                 ║
+║  Option 1 - Install Build Tools (Windows):                                   ║
+║  > npm install --global windows-build-tools                                  ║
+║  > npm install claude-flow@alpha                                             ║
 ║                                                                              ║
-║  Option 3 - Use WSL (Windows Subsystem for Linux):                         ║
-║  Install WSL and run Claude Flow inside a Linux environment                 ║
+║  Option 2 - Use WSL (Windows Subsystem for Linux):                           ║
+║  Install WSL and run Claude Flow inside a Linux environment                  ║
 ║                                                                              ║
 ╚══════════════════════════════════════════════════════════════════════════════╝
 `);

package/src/utils/error-recovery.ts

@@ -33,6 +33,52 @@ export function isNpmCacheError(error: any): boolean {
   ) || errorStr.includes('better-sqlite3');
 }
 
+/**
+ * Detect if an error is a native module version mismatch (NODE_MODULE_VERSION)
+ * This happens when native modules are compiled for a different Node.js version
+ */
+export function isNativeModuleVersionError(error: any): boolean {
+  const errorStr = error?.message || String(error);
+  return (
+    errorStr.includes('NODE_MODULE_VERSION') ||
+    errorStr.includes('was compiled against a different Node.js version') ||
+    errorStr.includes('re-compiling or re-installing the module')
+  );
+}
+
+/**
+ * Get helpful message for native module version mismatch
+ */
+export function getNativeModuleRecoveryMessage(error: any): string {
+  const errorStr = error?.message || String(error);
+
+  // Extract version numbers if available
+  const compiledMatch = errorStr.match(/NODE_MODULE_VERSION (\d+)/);
+  const requiredMatch = errorStr.match(/requires\s+NODE_MODULE_VERSION (\d+)/);
+
+  let message = '⚠️  Native module version mismatch detected.\n';
+
+  if (compiledMatch && requiredMatch) {
+    const nodeVersionMap: Record<string, string> = {
+      '108': '18.x',
+      '115': '20.x',
+      '120': '21.x',
+      '127': '22.x',
+      '131': '23.x'
+    };
+    const compiled = nodeVersionMap[compiledMatch[1]] || `ABI ${compiledMatch[1]}`;
+    const required = nodeVersionMap[requiredMatch[1]] || `ABI ${requiredMatch[1]}`;
+    message += `   Module was compiled for Node.js ${compiled}, but running Node.js ${required}.\n`;
+  }
+
+  message += '\n   To fix this, try one of:\n';
+  message += '   1. npm rebuild better-sqlite3\n';
+  message += '   2. rm -rf node_modules && npm install\n';
+  message += '   3. npx cache: rm -rf ~/.npm/_npx/ && run command again\n';
+
+  return message;
+}
+
 /**
  * Detect if running on WSL (Windows Subsystem for Linux)
  */
@@ -315,6 +361,8 @@ export async function recoverInitErrors(error: any): Promise<RecoveryResult> {
  */
 export const errorRecovery = {
   isNpmCacheError,
+  isNativeModuleVersionError,
+  getNativeModuleRecoveryMessage,
   isWSL,
   cleanNpmCache,
   retryWithRecovery,