sandboxbox 2.3.0 → 2.3.2

package/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * SandboxBox CLI - Portable Container Runner with Podman
@@ -10,7 +10,7 @@ import { color } from './utils/colors.js';
 import { showBanner, showHelp } from './utils/ui.js';
 import { buildCommand, runCommand, shellCommand, claudeCommand, versionCommand } from './utils/commands/index.js';
 
-async function main() {
+function main() {
   const args = process.argv.slice(2);
   showBanner();
 
@@ -71,10 +71,4 @@ async function main() {
   }
 }
 
-main().catch(error => {
-  console.error(color('red', '❌ SandboxBox failed:'));
-  console.error(color('red', error.message));
-  console.error('');
-  console.error(color('yellow', '💡 Try: npx sandboxbox --help'));
-  process.exit(1);
-});
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandboxbox",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "Portable container runner with Podman - Claude Code & Playwright support. Works on Windows, macOS, and Linux.",
   "type": "module",
   "main": "cli.js",

package/utils/commands/claude.js

@@ -3,7 +3,7 @@ import { execSync } from 'child_process';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { color } from '../colors.js';
-import { checkPodman, ensureBackend, getPodmanPath } from '../podman.js';
+import { checkPodman, setupBackendNonBlocking, getPodmanPath } from '../podman.js';
 import { buildClaudeContainerCommand, createClaudeDockerfile } from '../claude-workspace.js';
 import { createIsolatedEnvironment, setupCleanupHandlers, buildContainerMounts } from '../isolation.js';
 
@@ -42,7 +42,7 @@ export function claudeCommand(projectDir, command = 'claude') {
 
   const buildPodman = checkPodman();
   if (!buildPodman) return false;
-  if (!ensureBackend(buildPodman)) return false;
+  if (!setupBackendNonBlocking(buildPodman)) return false;
 
   try {
     const { tempProjectDir, cleanup } = createIsolatedEnvironment(projectDir);
@@ -73,7 +73,7 @@ function buildClaudeContainer() {
 
   const podmanPath = checkPodman();
   if (!podmanPath) return false;
-  if (!ensureBackend(podmanPath)) return false;
+  if (!setupBackendNonBlocking(podmanPath)) return false;
 
   try {
     execSync(`"${podmanPath}" build -f "${dockerfilePath}" -t sandboxbox-local:latest .`, {

package/utils/commands/container.js

@@ -2,7 +2,7 @@ import { existsSync } from 'fs';
 import { execSync } from 'child_process';
 import { dirname } from 'path';
 import { color } from '../colors.js';
-import { checkPodman, ensureBackend } from '../podman.js';
+import { checkPodman, setupBackendNonBlocking } from '../podman.js';
 import { createIsolatedEnvironment, setupCleanupHandlers, buildContainerMounts } from '../isolation.js';
 
 export function buildCommand(dockerfilePath) {
@@ -16,7 +16,7 @@ export function buildCommand(dockerfilePath) {
 
   const podmanPath = checkPodman();
   if (!podmanPath) return false;
-  if (!ensureBackend(podmanPath)) return false;
+  if (!setupBackendNonBlocking(podmanPath)) return false;
 
   try {
     execSync(`"${podmanPath}" build -f "${dockerfilePath}" -t sandboxbox:latest .`, {
@@ -45,7 +45,7 @@ export function runCommand(projectDir, cmd = 'bash') {
 
   const podmanPath = checkPodman();
   if (!podmanPath) return false;
-  if (!ensureBackend(podmanPath)) return false;
+  if (!setupBackendNonBlocking(podmanPath)) return false;
 
   try {
     const { tempProjectDir, cleanup } = createIsolatedEnvironment(projectDir);
@@ -78,7 +78,7 @@ export function shellCommand(projectDir) {
 
   const podmanPath = checkPodman();
   if (!podmanPath) return false;
-  if (!ensureBackend(podmanPath)) return false;
+  if (!setupBackendNonBlocking(podmanPath)) return false;
 
   try {
     const { tempProjectDir, cleanup } = createIsolatedEnvironment(projectDir);

package/utils/podman.js

@@ -1,5 +1,5 @@
 import { existsSync } from 'fs';
-import { execSync } from 'child_process';
+import { execSync, spawn } from 'child_process';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { color } from './colors.js';
@@ -26,7 +26,7 @@ export function getPodmanPath() {
   return 'podman';
 }
 
-export function ensureBackend(podmanPath) {
+export function setupBackendNonBlocking(podmanPath) {
   if (process.platform === 'linux') return true;
 
   const execOptions = { encoding: 'utf-8', stdio: 'pipe', shell: true };
@@ -35,9 +35,11 @@ export function ensureBackend(podmanPath) {
     execSync(`"${podmanPath}" info`, execOptions);
     return true;
   } catch (infoError) {
-    if (!infoError.message.includes('Cannot connect to Podman')) throw infoError;
+    if (!infoError.message.includes('Cannot connect to Podman')) {
+      return false;
+    }
 
-    console.log(color('yellow', '\n🔧 Initializing Podman backend (first run, takes 2-3 minutes)...'));
+    console.log(color('yellow', '\n🔧 Initializing Podman backend (one-time setup, takes 2-3 minutes)...'));
 
     try {
       const machineListOutput = execSync(`"${podmanPath}" machine list --format json`, execOptions);
@@ -48,17 +50,58 @@ export function ensureBackend(podmanPath) {
         const initCmd = process.platform === 'win32'
           ? `"${podmanPath}" machine init --rootful=false`
           : `"${podmanPath}" machine init`;
-        execSync(initCmd, { stdio: 'inherit', shell: true });
+
+        execSync(initCmd, {
+          stdio: 'inherit',
+          shell: true,
+          timeout: 120000 // 2 minutes
+        });
       }
 
       console.log(color('cyan', '   Starting Podman machine...'));
-      execSync(`"${podmanPath}" machine start`, { stdio: 'inherit', shell: true });
-      console.log(color('green', '✅ Podman backend ready\n'));
+      execSync(`"${podmanPath}" machine start`, {
+        stdio: 'inherit',
+        shell: true,
+        timeout: 60000 // 1 minute
+      });
+
+      console.log(color('green', '\n✅ Podman backend setup completed!\n'));
       return true;
-    } catch (backendError) {
-      console.log(color('red', `\n❌ Backend setup failed: ${backendError.message}`));
+    } catch (setupError) {
+      if (setupError.signal === 'SIGTERM') {
+        console.log(color('red', '\n❌ Setup timed out. Please run manually:'));
+      } else {
+        console.log(color('red', `\n❌ Setup failed: ${setupError.message}`));
+      }
+
+      const manualCmd = process.platform === 'win32'
+        ? `"${podmanPath}" machine init --rootful=false && "${podmanPath}" machine start`
+        : `"${podmanPath}" machine init && "${podmanPath}" machine start`;
+      console.log(color('cyan', `   Manual setup: ${manualCmd}`));
+      return false;
+    }
+  }
+}
+
+export function checkBackend(podmanPath) {
+  if (process.platform === 'linux') return true;
+
+  const execOptions = { encoding: 'utf-8', stdio: 'pipe', shell: true };
+
+  try {
+    execSync(`"${podmanPath}" info`, execOptions);
+    return true;
+  } catch (infoError) {
+    if (infoError.message.includes('Cannot connect to Podman')) {
+      console.log(color('red', '\n❌ Podman backend not running'));
+      console.log(color('yellow', '\n📋 One-time setup required:'));
+      console.log(color('cyan', process.platform === 'win32'
+        ? '   Run: podman machine init --rootful=false && podman machine start'
+        : '   Run: podman machine init && podman machine start'));
+      console.log(color('yellow', '\n⏱️  This takes 2-3 minutes, then works instantly forever.\n'));
       return false;
     }
+    throw infoError;
   }
 }