@beads/bd 0.51.0 → 0.55.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beads/bd",
-  "version": "0.51.0",
+  "version": "0.55.4",
   "description": "Beads issue tracker - lightweight memory system for coding agents with native binary support",
   "main": "bin/bd.js",
   "bin": {

package/scripts/postinstall.js

@@ -128,6 +128,30 @@ function sleep(ms) {
   return new Promise(resolve => setTimeout(resolve, ms));
 }
 
+// Wait for a file to become accessible (Windows file lock workaround).
+// After fs.createWriteStream closes, Windows may hold the file lock for a
+// short period. This function polls until the file can be opened exclusively.
+async function waitForFileAccess(filePath, timeoutMs = 30000) {
+  const intervalMs = 200;
+  const startTime = Date.now();
+
+  while (Date.now() - startTime < timeoutMs) {
+    try {
+      const fd = fs.openSync(filePath, 'r');
+      fs.closeSync(fd);
+      return; // File is accessible
+    } catch (err) {
+      if (err.code === 'EBUSY' || err.code === 'EPERM') {
+        await sleep(intervalMs);
+      } else {
+        return; // Not a lock error — let extraction attempt handle it
+      }
+    }
+  }
+  // Timed out, but proceed anyway — extractZip has its own retry logic
+  console.warn(`Warning: file ${path.basename(filePath)} may still be locked after ${timeoutMs}ms, attempting extraction anyway...`);
+}
+
 // Extract zip file (for Windows) with retry logic
 async function extractZip(zipPath, destDir, binaryName) {
   console.log(`Extracting ${zipPath}...`);
@@ -139,9 +163,10 @@ async function extractZip(zipPath, destDir, binaryName) {
     try {
       // Use unzip command or powershell on Windows
       if (os.platform() === 'win32') {
-        execSync(`powershell -command "Expand-Archive -Path '${zipPath}' -DestinationPath '${destDir}' -Force"`, { stdio: 'inherit' });
+        // Use stdio: 'pipe' to capture error output for file-lock detection
+        execSync(`powershell -command "Expand-Archive -Path '${zipPath}' -DestinationPath '${destDir}' -Force"`, { stdio: 'pipe' });
       } else {
-        execSync(`unzip -o "${zipPath}" -d "${destDir}"`, { stdio: 'inherit' });
+        execSync(`unzip -o "${zipPath}" -d "${destDir}"`, { stdio: 'pipe' });
       }
 
       // The binary should now be in destDir
@@ -154,20 +179,26 @@ async function extractZip(zipPath, destDir, binaryName) {
       console.log(`Binary extracted to: ${extractedBinary}`);
       return; // Success
     } catch (err) {
-      const isFileLockError = err.message && (
-        err.message.includes('being used by another process') ||
-        err.message.includes('Access is denied') ||
-        err.message.includes('cannot access the file')
-      );
+      // Combine all available error output for reliable detection.
+      // With stdio: 'pipe', the PowerShell error text is in err.stderr,
+      // while err.message only contains "Command failed: ...".
+      const stderr = err.stderr ? err.stderr.toString() : '';
+      const errorText = `${err.message} ${stderr}`;
+
+      const isFileLockError =
+        errorText.includes('being used by another process') ||
+        errorText.includes('Access is denied') ||
+        errorText.includes('cannot access the file') ||
+        errorText.includes('EBUSY');
 
       if (isFileLockError && attempt < maxRetries) {
         const delayMs = baseDelayMs * Math.pow(2, attempt - 1);
-        console.log(`File may be locked (attempt ${attempt}/${maxRetries}). Retrying in ${delayMs}ms...`);
+        console.log(`File appears locked (attempt ${attempt}/${maxRetries}). Retrying in ${delayMs}ms...`);
         await sleep(delayMs);
       } else if (attempt === maxRetries) {
-        throw new Error(`Failed to extract archive after ${maxRetries} attempts: ${err.message}`);
+        throw new Error(`Failed to extract archive after ${maxRetries} attempts: ${err.message}\n${stderr}`);
       } else {
-        throw new Error(`Failed to extract archive: ${err.message}`);
+        throw new Error(`Failed to extract archive: ${err.message}\n${stderr}`);
       }
     }
   }
@@ -201,6 +232,12 @@ async function install() {
     console.log(`Downloading bd binary...`);
     await downloadFile(downloadUrl, archivePath);
 
+    // On Windows, wait for the OS to release the file lock before extracting.
+    // Windows may hold the file handle for a short time after close().
+    if (process.platform === 'win32') {
+      await waitForFileAccess(archivePath);
+    }
+
     // Extract the archive based on platform
     if (platformName === 'windows') {
       await extractZip(archivePath, binDir, binaryName);