claude-flow 2.7.42 → 2.7.43

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,