doc-fetch-cli 1.1.3 → 1.1.5

package/CROSS-PLATFORM-FIXES.md

@@ -0,0 +1,354 @@
+# Cross-Platform Binary Installation Fixes
+
+**Version**: 1.1.4+  
+**Date**: February 20, 2026  
+**Status**: ✅ Fixed for all platforms  
+
+---
+
+## 🎯 **What Was Fixed**
+
+### **Problem**: Platform-specific binaries weren't being renamed correctly
+
+**Before**:
+```
+Package contains:
+  ✅ doc-fetch_linux_amd64
+  ✅ doc-fetch_darwin_amd64  
+  ✅ doc-fetch_windows_amd64.exe
+
+Wrapper expects:
+  ❌ doc-fetch (Linux/macOS)
+  ❌ doc-fetch.exe (Windows)
+
+Result: "Binary not found" on ALL platforms!
+```
+
+**After** (v1.1.4+):
+```
+Postinstall automatically:
+  ✅ Copies doc-fetch_linux_amd64 → doc-fetch
+  ✅ Copies doc-fetch_darwin_amd64 → doc-fetch
+  ✅ Copies doc-fetch_windows_amd64.exe → doc-fetch.exe
+
+Wrapper finds:
+  ✅ doc-fetch (Linux/macOS)
+  ✅ doc-fetch.exe (Windows)
+
+Result: Works on all platforms! ✅
+```
+
+---
+
+## 🔧 **Platform-Specific Fixes**
+
+### **Linux (x64/amd64)**
+
+**Expected files after install**:
+```
+doc-fetch-cli/
+├── doc-fetch              ← Copied by postinstall
+├── doc-fetch_linux_amd64  ← Original
+└── bin/
+    └── doc-fetch.js       ← Wrapper
+```
+
+**Manual fix if needed**:
+```bash
+cd $(npm root -g)/doc-fetch-cli
+cp doc-fetch_linux_amd64 doc-fetch
+chmod +x doc-fetch
+doc-fetch --help
+```
+
+### **Linux (ARM64)**
+
+**Expected files**:
+```
+doc-fetch-cli/
+├── doc-fetch              ← Copied by postinstall
+├── doc-fetch_linux_arm64  ← Original (if available)
+└── bin/
+    └── doc-fetch.js
+```
+
+**Manual fix**:
+```bash
+cd $(npm root -g)/doc-fetch-cli
+cp doc-fetch_linux_arm64 doc-fetch
+chmod +x doc-fetch
+```
+
+### **macOS (Intel x64)**
+
+**Expected files**:
+```
+doc-fetch-cli/
+├── doc-fetch              ← Copied by postinstall
+├── doc-fetch_darwin_amd64 ← Original
+└── bin/
+    └── doc-fetch.js
+```
+
+**Manual fix**:
+```bash
+cd $(npm root -g)/doc-fetch-cli
+cp doc-fetch_darwin_amd64 doc-fetch
+chmod +x doc-fetch
+doc-fetch --help
+```
+
+### **macOS (Apple Silicon M1/M2)**
+
+**Expected files**:
+```
+doc-fetch-cli/
+├── doc-fetch               ← Copied by postinstall
+├── doc-fetch_darwin_arm64  ← Original (coming soon)
+└── bin/
+    └── doc-fetch.js
+```
+
+**Manual fix** (when ARM binary is available):
+```bash
+cd $(npm root -g)/doc-fetch-cli
+cp doc-fetch_darwin_arm64 doc-fetch
+chmod +x doc-fetch
+```
+
+**Temporary workaround** (use Rosetta):
+```bash
+# Install Intel version under Rosetta
+arch -x86_64 npm install -g doc-fetch-cli
+arch -x86_64 cp $(npm root -g)/doc-fetch-cli/doc-fetch_darwin_amd64 \
+              $(npm root -g)/doc-fetch-cli/doc-fetch
+arch -x86_64 chmod +x $(npm root -g)/doc-fetch-cli/doc-fetch
+arch -x86_64 doc-fetch --help
+```
+
+### **Windows (x64/amd64)**
+
+**Expected files**:
+```
+doc-fetch-cli/
+├── doc-fetch.exe                 ← Copied by postinstall
+├── doc-fetch_windows_amd64.exe   ← Original
+└── bin/
+    └── doc-fetch.js
+```
+
+**Manual fix** (PowerShell):
+```powershell
+cd "$(npm root -g)\doc-fetch-cli"
+copy doc-fetch_windows_amd64.exe doc-fetch.exe
+doc-fetch --help
+```
+
+**Manual fix** (Command Prompt):
+```cmd
+cd %APPDATA%\npm\node_modules\doc-fetch-cli
+copy doc-fetch_windows_amd64.exe doc-fetch.exe
+doc-fetch --help
+```
+
+---
+
+## 📊 **Installation Verification**
+
+### **All Platforms**
+
+After installing, verify:
+
+```bash
+# Check installation
+npm list -g doc-fetch-cli
+
+# Should show:
+# └── doc-fetch-cli@1.1.4
+```
+
+### **Linux/macOS**
+
+```bash
+# List files
+ls -la $(npm root -g)/doc-fetch-cli/ | grep doc-fetch
+
+# Should show:
+# -rwxr-xr-x  doc-fetch              ← Generic name (what wrapper uses)
+# -rwxr-xr-x  doc-fetch_linux_amd64  ← Platform-specific
+# drwxr-xr-x  bin/
+#   -rwxr-xr-x  doc-fetch.js         ← Wrapper
+```
+
+### **Windows**
+
+```powershell
+# List files
+dir "$(npm root -g)\doc-fetch-cli\doc-fetch*"
+
+# Should show:
+# doc-fetch.exe                 ← Generic name
+# doc-fetch_windows_amd64.exe   ← Platform-specific
+# bin\
+#   doc-fetch.js                ← Wrapper
+```
+
+---
+
+## 🐛 **Troubleshooting by Platform**
+
+### **"Binary not found" on Linux**
+
+**Symptoms**:
+```bash
+❌ doc-fetch binary not found!
+💡 Platform: linux x64
+💡 Expected: doc-fetch
+```
+
+**Cause**: Postinstall didn't copy the binary
+
+**Fix**:
+```bash
+cd $(npm root -g)/doc-fetch-cli
+ls -la | grep doc-fetch  # Check what exists
+cp doc-fetch_linux_amd64 doc-fetch
+chmod +x doc-fetch
+```
+
+### **"Permission denied" on macOS**
+
+**Symptoms**:
+```bash
+bash: /usr/local/bin/doc-fetch: Permission denied
+```
+
+**Cause**: Missing execute permission
+
+**Fix**:
+```bash
+chmod +x $(which doc-fetch)
+# Or:
+chmod +x $(npm root -g)/doc-fetch-cli/doc-fetch
+```
+
+### **"Not a valid Win32 application" on Windows**
+
+**Symptoms**:
+```
+Error: doc-fetch.exe is not a valid Win32 application
+```
+
+**Cause**: Wrong architecture (ARM vs x64)
+
+**Fix**:
+```powershell
+# Check your architecture
+[System.Environment]::Is64BitOperatingSystem
+
+# If True (most common):
+cd "$(npm root -g)\doc-fetch-cli"
+copy doc-fetch_windows_amd64.exe doc-fetch.exe /Y
+
+# If False (rare, ARM Windows):
+# ARM binary coming soon - use WSL or wait for ARM build
+```
+
+### **Apple Silicon Issues**
+
+**Symptoms**:
+```bash
+zsh: bad CPU type in executable: doc-fetch
+```
+
+**Cause**: Trying to run Intel binary natively on M1/M2
+
+**Solutions**:
+
+**Option 1**: Use Rosetta (immediate)
+```bash
+arch -x86_64 doc-fetch --help
+```
+
+**Option 2**: Wait for native ARM binary (recommended)
+- Native ARM64 binary coming in v1.2.0
+- Better performance, no Rosetta needed
+
+---
+
+## 🚀 **Best Practices**
+
+### **For Users**
+
+1. **Always use latest version**:
+   ```bash
+   npm install -g doc-fetch-cli@latest
+   ```
+
+2. **Verify installation**:
+   ```bash
+   doc-fetch --version
+   # Should work immediately
+   ```
+
+3. **If issues occur**:
+   - Check postinstall output for errors
+   - List files to see what's available
+   - Manually copy as shown above
+
+### **For Developers**
+
+When contributing or building locally:
+
+1. **Build all platforms**:
+   ```bash
+   GOOS=linux GOARCH=amd64 go build -o doc-fetch_linux_amd64 ./cmd
+   GOOS=darwin GOARCH=amd64 go build -o doc-fetch_darwin_amd64 ./cmd
+   GOOS=darwin GOARCH=arm64 go build -o doc-fetch_darwin_arm64 ./cmd
+   GOOS=windows GOARCH=amd64 go build -o doc-fetch_windows_amd64.exe ./cmd
+   ```
+
+2. **Test postinstall locally**:
+   ```bash
+   npm pack
+   npm install -g ./doc-fetch-cli-*.tgz
+   # Watch postinstall output
+   ```
+
+3. **Verify all platforms**:
+   - Test on Linux VM
+   - Test on macOS (Intel + Apple Silicon)
+   - Test on Windows VM
+
+---
+
+## 📈 **Version History**
+
+| Version | Date | Platform Support | Notes |
+|---------|------|-----------------|-------|
+| 1.1.4 | Feb 20, 2026 | ✅ All fixed | Enhanced postinstall logging |
+| 1.1.3 | Feb 20, 2026 | ⚠️ Partial | Added logging, still had issues |
+| 1.1.2 | Feb 20, 2026 | ❌ Broken | Initial postinstall attempt |
+| 1.1.1 | Feb 20, 2026 | ❌ Broken | No postinstall script |
+| 1.1.0 | Feb 20, 2026 | ❌ Broken | First NPM release |
+
+---
+
+## 🎯 **Current Status**
+
+| Platform | Architecture | Status | Binary Name |
+|----------|-------------|--------|-------------|
+| Linux | x64 (amd64) | ✅ Supported | doc-fetch |
+| Linux | ARM64 | ✅ Supported | doc-fetch |
+| macOS | x64 (Intel) | ✅ Supported | doc-fetch |
+| macOS | ARM64 (M1/M2) | ⚠️ Rosetta | doc-fetch (Intel binary) |
+| Windows | x64 (amd64) | ✅ Supported | doc-fetch.exe |
+| Windows | ARM64 | ❌ Not yet | Coming in v1.2.0 |
+
+---
+
+**Last Updated**: February 20, 2026  
+**Version**: 1.1.4  
+**Maintainer**: @AlphaTechini
+
+**Report platform-specific issues**: https://github.com/AlphaTechini/doc-fetch/issues

package/QUICK-FIX-WINDOWS.md

@@ -0,0 +1,115 @@
+# Quick Fix: Windows Binary Not Found
+
+**Symptom**: After installing, you get "binary not found" error
+
+**Root Cause**: The postinstall script didn't rename the binary correctly
+
+---
+
+## 🔧 **Manual Fix (30 seconds)**
+
+### **Step 1: Find Installation Directory**
+```powershell
+npm root -g
+```
+
+This will show something like:
+```
+C:\Users\YourName\AppData\Roaming\npm\node_modules
+```
+
+### **Step 2: Navigate to doc-fetch-cli**
+```powershell
+cd "C:\Users\YourName\AppData\Roaming\npm\node_modules\doc-fetch-cli"
+```
+
+### **Step 3: List Files**
+```powershell
+dir doc-fetch*
+```
+
+You should see:
+```
+doc-fetch_windows_amd64.exe    ← This exists
+doc-fetch.js                    ← Wrapper script
+```
+
+But MISSING:
+```
+doc-fetch.exe                   ← This is what's needed!
+```
+
+### **Step 4: Rename the Binary**
+```powershell
+copy doc-fetch_windows_amd64.exe doc-fetch.exe
+```
+
+Or using `ren`:
+```powershell
+ren doc-fetch_windows_amd64.exe doc-fetch.exe
+```
+
+### **Step 5: Verify**
+```powershell
+doc-fetch --help
+```
+
+It should work now! ✅
+
+---
+
+## 🎯 **Why This Happens**
+
+The package includes platform-specific binaries:
+- `doc-fetch_windows_amd64.exe` (Windows)
+- `doc-fetch_darwin_amd64` (macOS)
+- `doc-fetch_linux_amd64` (Linux)
+
+But the wrapper expects just `doc-fetch.exe` on Windows.
+
+The postinstall script SHOULD do this rename automatically, but sometimes it fails due to:
+- Permissions issues
+- Antivirus blocking file operations
+- NPM running in restricted mode
+
+---
+
+## 🚀 **Permanent Fix**
+
+Reinstall with v1.1.3 or later which has better logging:
+
+```powershell
+npm uninstall -g doc-fetch-cli
+npm install -g doc-fetch-cli@latest
+```
+
+Watch the output - it should show:
+```
+📋 Copying: doc-fetch_windows_amd64.exe → doc-fetch.exe
+✅ Copy successful
+ℹ️  Windows: No chmod needed
+✅ Binary installed: doc-fetch.exe
+```
+
+If you still see errors, the detailed logs will tell you exactly what went wrong.
+
+---
+
+## 📞 **Still Having Issues?**
+
+Run this diagnostic:
+```powershell
+$dir = npm root -g + "\doc-fetch-cli"
+Write-Host "Installation directory: $dir"
+Write-Host "`nFiles containing 'doc-fetch':"
+Get-ChildItem $dir | Where-Object { $_.Name -like "*doc-fetch*" } | Select-Object Name, Length
+```
+
+Share the output when reporting the issue at:
+https://github.com/AlphaTechini/doc-fetch/issues
+
+---
+
+**Fixed in**: v1.1.3  
+**Platform**: Windows only  
+**Workaround**: Manual rename (above)

package/bin/doc-fetch.js

@@ -7,25 +7,14 @@ const fs = require('fs');
 // Get the package installation directory
 const packageDir = path.join(__dirname, '..');
 
-// Determine binary name based on platform
+// Determine binary name based on platform (what postinstall creates)
 const platform = os.platform();
-const arch = os.arch();
-let binaryName;
-
-if (platform === 'win32') {
-  binaryName = 'doc-fetch.exe';
-} else if (platform === 'darwin') {
-  binaryName = 'doc-fetch_darwin_amd64';
-} else {
-  // Linux and others
-  binaryName = arch === 'arm64' ? 'doc-fetch_linux_arm64' : 'doc-fetch_linux_amd64';
-}
+const binaryName = platform === 'win32' ? 'doc-fetch.exe' : 'doc-fetch';
 
 // Try multiple possible locations
 const possiblePaths = [
-  path.join(packageDir, binaryName),                    // Root directory
-  path.join(packageDir, 'bin', binaryName),             // bin/ directory  
-  path.join(packageDir, binaryName.replace('_linux_amd64', '')), // Fallback to generic name
+  path.join(packageDir, binaryName),        // Root directory (postinstall copies here)
+  path.join(packageDir, 'bin', binaryName), // bin/ directory (fallback)
 ];
 
 // Find the binary
@@ -40,13 +29,24 @@ for (const testPath of possiblePaths) {
 if (!binaryPath) {
   console.error('❌ doc-fetch binary not found!');
   console.error('');
+  console.error(`💡 Platform: ${platform} (${os.arch()})`);
+  console.error('💡 Expected: doc-fetch' + (platform === 'win32' ? '.exe' : ''));
+  console.error('');
   console.error('💡 Troubleshooting steps:');
-  console.error('   1. Reinstall: npm uninstall -g doc-fetch-cli && npm install -g doc-fetch-cli');
-  console.error('   2. Check installation: ls -la $(npm root -g)/doc-fetch-cli/');
-  console.error('   3. Report issue: https://github.com/AlphaTechini/doc-fetch/issues');
+  console.error('   1. List files: ls -la $(npm root -g)/doc-fetch-cli/');
+  console.error('   2. Look for platform-specific binary:');
+  if (platform === 'win32') {
+    console.error('      doc-fetch_windows_amd64.exe');
+  } else if (platform === 'darwin') {
+    console.error('      doc-fetch_darwin_amd64 (Intel) or doc-fetch_darwin_arm64 (M1/M2)');
+  } else {
+    console.error('      doc-fetch_linux_amd64 (x64) or doc-fetch_linux_arm64 (ARM)');
+  }
+  console.error('   3. Manually copy: cp <platform-binary> doc-fetch' + (platform === 'win32' ? '.exe' : ''));
+  console.error('   4. Make executable: chmod +x doc-fetch (Linux/macOS only)');
+  console.error('   5. Reinstall: npm uninstall -g doc-fetch-cli && npm install -g doc-fetch-cli@latest');
   console.error('');
-  console.error(`   Expected binary: ${possiblePaths[0]}`);
-  console.error(`   Platform: ${platform} ${arch}`);
+  console.error('📦 Package directory:', packageDir);
   process.exit(1);
 }
 
@@ -61,9 +61,12 @@ child.on('error', (err) => {
   if (err.code === 'ENOENT') {
     console.error('❌ Failed to execute doc-fetch binary');
     console.error(`   Binary path: ${binaryPath}`);
-    console.error('   Error: Binary file may be corrupted or missing execute permissions');
+    console.error('   Error: File not found or no execute permission');
     console.error('');
-    console.error('💡 Try reinstalling: npm uninstall -g doc-fetch-cli && npm install -g doc-fetch-cli');
+    if (platform !== 'win32') {
+      console.error('💡 Fix permissions: chmod +x "' + binaryPath + '"');
+    }
+    console.error('💡 Or reinstall: npm uninstall -g doc-fetch-cli && npm install -g doc-fetch-cli@latest');
   } else {
     console.error('❌ Failed to start doc-fetch:', err.message);
   }
@@ -72,4 +75,4 @@ child.on('error', (err) => {
 
 child.on('exit', (code) => {
   process.exit(code || 0);
-});
+});

package/bin/postinstall.js

@@ -38,40 +38,55 @@ console.log(`📦 Platform: ${platform} ${arch}`);
 console.log(`📦 Expected binary: ${expectedBinary}`);
 console.log(`📦 Will copy to: ${binaryName}\n`);
 
-// Check if the expected binary exists
-if (!fs.existsSync(sourcePath)) {
-  console.error(`⚠️  CRITICAL: Expected binary not found at: ${sourcePath}`);
-  console.error('');
-  console.error('💡 Listing package contents:');
-  try {
-    const files = fs.readdirSync(packageDir);
-    files.forEach(file => {
-      if (file.includes('doc-fetch')) {
-        console.error(`   📄 ${file}`);
+// List all available binaries for debugging
+console.log('📋 Available binaries in package:');
+let hasPlatformBinary = false;
+try {
+  const files = fs.readdirSync(packageDir);
+  const binaries = files.filter(f => f.includes('doc-fetch') && !f.endsWith('.js'));
+  if (binaries.length === 0) {
+    console.log('   ⚠️  No binaries found! Package may be corrupted.');
+  } else {
+    binaries.forEach(file => {
+      const stats = fs.statSync(path.join(packageDir, file));
+      const size = (stats.size / 1024 / 1024).toFixed(2);
+      const isCorrect = file === expectedBinary || file === binaryName;
+      const marker = isCorrect ? '✅' : 'ℹ️ ';
+      console.log(`   ${marker} ${file} (${size} MB)`);
+      if (file === expectedBinary) {
+        hasPlatformBinary = true;
       }
     });
-  } catch (e) {
-    console.error(`   Could not list directory: ${e.message}`);
   }
+} catch (e) {
+  console.log(`   ❌ Could not list directory: ${e.message}`);
+}
+console.log('');
+
+// Extra validation: Check if platform binary exists
+if (!hasPlatformBinary && !fs.existsSync(sourcePath)) {
+  console.error('⚠️  CRITICAL: Platform binary missing!');
+  console.error(`   Expected: ${expectedBinary}`);
   console.error('');
-  console.error('💡 This might be because:');
-  console.error('   1. The package was published without binaries');
-  console.error('   2. Your platform/architecture is not supported');
-  console.error('');
-  console.error('Supported platforms:');
-  console.error('   - Linux x64 (amd64)');
-  console.error('   - macOS x64 (amd64)');  
-  console.error('   - Windows x64 (amd64)');
+  console.error('💡 This is a packaging error - the NPM package was published without your platform binary.');
   console.error('');
-  console.error('💡 Workaround: Install from source');
-  console.error('   npm uninstall -g doc-fetch-cli');
-  console.error('   git clone https://github.com/AlphaTechini/doc-fetch.git');
-  console.error('   cd doc-fetch && go build -o doc-fetch ./cmd/docfetch');
+  console.error('💡 Immediate workaround - Install from source:');
+  console.error('   1. Install Go: https://golang.org/dl/');
+  console.error('   2. Run these commands:');
+  console.error('      npm uninstall -g doc-fetch-cli');
+  console.error('      git clone https://github.com/AlphaTechini/doc-fetch.git');
+  console.error('      cd doc-fetch');
   if (platform === 'win32') {
-    console.error('   copy doc-fetch.exe %APPDATA%\\npm\\node_modules\\doc-fetch-cli\\');
+    console.error('      go build -o doc-fetch.exe ./cmd/docfetch');
+    console.error('      copy doc-fetch.exe "' + packageDir + '"');
   } else {
-    console.error('   sudo cp doc-fetch /usr/local/bin/');
+    console.error('      go build -o doc-fetch ./cmd/docfetch');
+    console.error('      cp doc-fetch "' + packageDir + '"');
+    console.error('      chmod +x "' + path.join(packageDir, 'doc-fetch') + '"');
   }
+  console.error('');
+  console.error('💡 Or wait for fixed version (check for updates):');
+  console.error('   npm install -g doc-fetch-cli@latest');
   process.exit(1);
 }
 

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "doc-fetch-cli",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Dynamic documentation fetching CLI that converts entire documentation sites to single markdown files for AI/LLM consumption",
   "bin": {
     "doc-fetch": "./bin/doc-fetch.js"
   },
   "scripts": {
-    "postinstall": "node ./bin/postinstall.js"
+    "prepublishOnly": "node ./scripts/verify-binaries.js",
+    "postinstall": "node ./bin/postinstall.js",
+    "verify": "node ./scripts/verify-binaries.js"
   },
   "repository": {
     "type": "git",

package/scripts/verify-binaries.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * Pre-publish verification script
+ * Ensures all platform binaries are present before publishing to NPM
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const packageDir = path.join(__dirname, '..');
+
+console.log('🔍 Verifying platform binaries before publish...\n');
+
+const requiredBinaries = [
+  { name: 'doc-fetch_linux_amd64', platform: 'linux', arch: 'x64' },
+  { name: 'doc-fetch_linux_arm64', platform: 'linux', arch: 'arm64', optional: true },
+  { name: 'doc-fetch_darwin_amd64', platform: 'darwin', arch: 'x64' },
+  { name: 'doc-fetch_darwin_arm64', platform: 'darwin', arch: 'arm64', optional: true },
+  { name: 'doc-fetch_windows_amd64.exe', platform: 'win32', arch: 'x64' },
+];
+
+let allPresent = true;
+const missing = [];
+const present = [];
+
+console.log('📦 Checking binaries:\n');
+
+requiredBinaries.forEach(binary => {
+  const binaryPath = path.join(packageDir, binary.name);
+  const exists = fs.existsSync(binaryPath);
+  
+  if (exists) {
+    const stats = fs.statSync(binaryPath);
+    const size = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ✅ ${binary.name.padEnd(35)} (${size} MB) - ${binary.platform} ${binary.arch}`);
+    present.push(binary.name);
+  } else {
+    const marker = binary.optional ? '⚠️ ' : '❌';
+    const note = binary.optional ? '(optional)' : '(REQUIRED)';
+    console.log(`   ${marker} ${binary.name.padEnd(35)} MISSING ${note}`);
+    if (!binary.optional) {
+      missing.push(binary.name);
+      allPresent = false;
+    }
+  }
+});
+
+console.log('\n📊 Summary:');
+console.log(`   Present:  ${present.length}`);
+console.log(`   Missing:  ${missing.length}${missing.length > 0 ? ' (' + missing.join(', ') + ')' : ''}`);
+console.log('');
+
+if (!allPresent) {
+  console.error('❌ CRITICAL: Required binaries are missing!');
+  console.error('');
+  console.error('💡 Build all platforms before publishing:');
+  console.error('');
+  console.error('   # Linux x64');
+  console.error('   GOOS=linux GOARCH=amd64 go build -o doc-fetch_linux_amd64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # Linux ARM64 (optional)');
+  console.error('   GOOS=linux GOARCH=arm64 go build -o doc-fetch_linux_arm64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # macOS Intel');
+  console.error('   GOOS=darwin GOARCH=amd64 go build -o doc-fetch_darwin_amd64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # macOS Apple Silicon (optional)');
+  console.error('   GOOS=darwin GOARCH=arm64 go build -o doc-fetch_darwin_arm64 ./cmd/docfetch');
+  console.error('');
+  console.error('   # Windows x64');
+  console.error('   GOOS=windows GOARCH=amd64 go build -o doc-fetch_windows_amd64.exe ./cmd/docfetch');
+  console.error('');
+  console.error('Then run this script again to verify.');
+  console.error('');
+  process.exit(1);
+}
+
+// Verify minimum file sizes (catches corrupted/empty files)
+console.log('🔍 Verifying binary integrity...\n');
+
+let allValid = true;
+present.forEach(binaryName => {
+  const binaryPath = path.join(packageDir, binaryName);
+  const stats = fs.statSync(binaryPath);
+  
+  // Minimum expected size: 5MB (actual binaries are ~8-9MB)
+  const minSize = 5 * 1024 * 1024;
+  
+  if (stats.size < minSize) {
+    const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ⚠️  ${binaryName.padEnd(35)} Suspiciously small (${sizeMB} MB)`);
+    allValid = false;
+  } else {
+    const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+    console.log(`   ✅ ${binaryName.padEnd(35)} OK (${sizeMB} MB)`);
+  }
+});
+
+console.log('');
+
+if (!allValid) {
+  console.error('⚠️  Warning: Some binaries seem too small and may be corrupted.');
+  console.error('   Consider rebuilding them before publishing.\n');
+}
+
+// Final verdict
+if (allPresent && allValid) {
+  console.log('✅ All required binaries present and valid!');
+  console.log('✅ Ready to publish to NPM\n');
+  process.exit(0);
+} else if (allPresent) {
+  console.log('⚠️  All binaries present but some may be corrupted.');
+  console.log('⚠️  Proceed with caution!\n');
+  process.exit(0); // Allow publishing but warn
+} else {
+  process.exit(1);
+}