Add version checks for Node.js and Python prerequisites

Enforces Node.js >=18 and Python >=3.8 requirements in code rather
than just documenting them. Scripts now fail fast with helpful error
messages if version requirements are not met.

Author: jdalton

scripts/wasm.mjs

@@ -30,6 +30,21 @@ const outputFile = path.join(externalDir, 'socket-ai-sync.mjs')
 const GITHUB_REPO = 'SocketDev/socket-cli'
 const WASM_ASSET_NAME = 'socket-ai-sync.mjs'
 
+/**
+ * Check Node.js version requirement.
+ */
+function checkNodeVersion() {
+  const nodeVersion = process.versions.node
+  const major = Number.parseInt(nodeVersion.split('.')[0], 10)
+
+  if (major < 18) {
+    console.error('❌ Node.js version 18 or higher is required')
+    console.error(`   Current version: ${nodeVersion}`)
+    console.error('   Please upgrade: https://nodejs.org/')
+    process.exit(1)
+  }
+}
+
 /**
  * Show help message.
  */
@@ -41,8 +56,8 @@ function showHelp() {
 
 Commands:
   --build     Build WASM bundle from source
-              Requirements: Python 3.8+, Rust, wasm-pack, Homebrew (macOS)
-              Time: ~10-20 minutes
+              Requirements: Python 3.8+ (auto-installs packages, Rust, wasm-pack, binaryen)
+              Time: ~10-20 minutes (first run), ~5 minutes (subsequent)
               Size: ~115MB output
 
   --download  Download pre-built WASM bundle from GitHub releases
@@ -279,6 +294,9 @@ async function downloadWasm() {
  * Main entry point.
  */
 async function main() {
+  // Check Node.js version first.
+  checkNodeVersion()
+
   const args = process.argv.slice(2)
 
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {

scripts/wasm/convert-codet5.mjs

@@ -64,16 +64,18 @@ console.log('╚═════════════════════
 console.log('Step 1: Checking Python installation...\n')
 
 let pythonCmd = 'python3'
+let pythonVersion = ''
 try {
   const pythonResult = await exec(pythonCmd, ['--version'])
-  const pythonVersion = pythonResult.stdout.trim()
-  console.log(`✓ Found ${pythonVersion}\n`)
+  pythonVersion = pythonResult.stdout.trim()
+  console.log(`✓ Found ${pythonVersion}`)
 } catch (_e) {
   // Try 'python' as fallback.
   try {
-    await exec('python', ['--version'])
+    const pythonResult = await exec('python', ['--version'])
+    pythonVersion = pythonResult.stdout.trim()
     pythonCmd = 'python'
-    console.log('✓ Found Python\n')
+    console.log(`✓ Found ${pythonVersion}`)
   } catch {
     console.error('❌ Python 3 not found')
     console.error(
@@ -83,6 +85,20 @@ try {
   }
 }
 
+// Check Python version (need 3.8+).
+const versionMatch = pythonVersion.match(/Python (\d+)\.(\d+)/)
+if (versionMatch) {
+  const major = Number.parseInt(versionMatch[1], 10)
+  const minor = Number.parseInt(versionMatch[2], 10)
+
+  if (major < 3 || (major === 3 && minor < 8)) {
+    console.error(`❌ Python 3.8+ required, found ${pythonVersion}`)
+    console.error('   Please upgrade: https://www.python.org/downloads/')
+    process.exit(1)
+  }
+}
+console.log()
+
 // Step 2: Check and install required packages.
 console.log('Step 2: Checking required packages...\n')