sandboxbox 2.2.0 → 2.2.2

package/CLAUDE.md

@@ -14,6 +14,9 @@ Portable containerized environments using Podman with automatic WSL management a
 - Cross-platform binary downloads from GitHub releases
 - PowerShell ZIP extraction on Windows
 - Auto-detects existing installations
+- Auto-triggers on first use if Podman not found
+- Verifies binary existence post-download
+- Auto-initializes Podman machine on Windows after download
 
 ### Container Images
 - **sandboxbox:latest**: Full development environment
@@ -50,19 +53,27 @@ if (process.platform === 'win32') {
 }
 ```
 
-### Auto Podman Machine Start
+### Auto Podman Machine Start (Rootless Mode)
 ```javascript
+// Initialize with explicit rootless mode for portability
 if (process.platform === 'win32' && isBundled) {
   try {
     execSync(`"${podmanPath}" info`, { stdio: 'pipe' });
   } catch (infoError) {
     if (infoError.message.includes('Cannot connect to Podman')) {
+      // Auto-initialize with rootless mode if machine doesn't exist
+      execSync(`"${podmanPath}" machine init --rootful=false`, { stdio: 'inherit' });
       execSync(`"${podmanPath}" machine start`, { stdio: 'inherit' });
     }
   }
 }
 ```
 
+### Rootless vs Rootful Mode
+- **Rootless (default)**: Runs without administrator privileges, portable across systems
+- **Configuration**: All machines initialized with `--rootful=false` flag
+- **Benefits**: No elevated permissions required, better security, true portability
+
 ## Isolation Architecture
 
 ### Workflow

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "sandboxbox",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Portable container runner with Podman - Claude Code & Playwright support. Works on Windows, macOS, and Linux.",
   "type": "module",
   "main": "cli.js",
   "bin": {
-    "sandboxbox": "./cli.js"
+    "sandboxbox": "cli.js"
   },
   "scripts": {
     "start": "node cli.js",
@@ -29,7 +29,7 @@
   "dependencies": {},
   "repository": {
     "type": "git",
-    "url": "https://github.com/AnEntrypoint/sandboxbox.git"
+    "url": "git+https://github.com/AnEntrypoint/sandboxbox.git"
   },
   "homepage": "https://github.com/AnEntrypoint/sandboxbox#readme",
   "bugs": {

package/utils/podman.js

@@ -55,7 +55,7 @@ export function checkPodman() {
             console.log('\n✅ Podman machine started successfully in rootless mode!');
           } catch (startError) {
             if (startError.message.includes('not found') || startError.message.includes('does not exist')) {
-              execSync(`"${podmanPath}" machine init`, {
+              execSync(`"${podmanPath}" machine init --rootful=false`, {
                 stdio: 'inherit',
                 cwd: __dirname,
                 shell: process.platform === 'win32'
@@ -65,7 +65,7 @@ export function checkPodman() {
                 cwd: __dirname,
                 shell: process.platform === 'win32'
               });
-              console.log('\n✅ Podman machine initialized and started successfully!');
+              console.log('\n✅ Podman machine initialized and started in rootless mode!');
             } else {
               throw startError;
             }
@@ -76,28 +76,47 @@ export function checkPodman() {
 
     return podmanPath;
   } catch (error) {
-    if (!isBundled) {
-      console.log('❌ Podman not found');
-      console.log('\n📦 Auto-downloading Podman...');
+    console.log('❌ Podman not found');
+    console.log('\n📦 Auto-downloading Podman...');
 
-      try {
-        const scriptPath = resolve(__dirname, '..', 'scripts', 'download-podman.js');
-        execSync(`node "${scriptPath}"`, { stdio: 'inherit', cwd: __dirname, shell: process.platform === 'win32' });
-
-        const newPodmanPath = getPodmanPath();
-        const execOptions = {
-          encoding: 'utf-8',
-          stdio: 'pipe',
-          shell: process.platform === 'win32'
-        };
-        const newVersion = execSync(`"${newPodmanPath}" --version`, execOptions).trim();
-        console.log(`\n✅ ${newVersion} (auto-downloaded)`);
-        return newPodmanPath;
-      } catch (downloadError) {
-        console.log(`\n❌ Auto-download failed: ${downloadError.message}`);
+    try {
+      const scriptPath = resolve(__dirname, '..', 'scripts', 'download-podman.js');
+      execSync(`node "${scriptPath}"`, { stdio: 'inherit', cwd: __dirname, shell: process.platform === 'win32' });
+
+      const newPodmanPath = getPodmanPath();
+      if (!existsSync(newPodmanPath) && newPodmanPath !== 'podman') {
+        throw new Error('Download completed but binary not found');
       }
-    } else {
-      console.log('❌ Podman not found');
+
+      const execOptions = {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        shell: process.platform === 'win32'
+      };
+
+      const newVersion = execSync(`"${newPodmanPath}" --version`, execOptions).trim();
+      console.log(`\n✅ ${newVersion} (auto-downloaded)`);
+
+      if (process.platform === 'win32') {
+        try {
+          execSync(`"${newPodmanPath}" info`, { ...execOptions, stdio: 'pipe' });
+        } catch (infoError) {
+          if (infoError.message.includes('Cannot connect to Podman')) {
+            console.log('\n🔧 Initializing Podman machine in rootless mode...');
+            try {
+              execSync(`"${newPodmanPath}" machine init --rootful=false`, { stdio: 'inherit', shell: true });
+              execSync(`"${newPodmanPath}" machine start`, { stdio: 'inherit', shell: true });
+              console.log('\n✅ Podman machine initialized and started in rootless mode!');
+            } catch (machineError) {
+              console.log('\n⚠️  Podman machine initialization will be done on first use');
+            }
+          }
+        }
+      }
+
+      return newPodmanPath;
+    } catch (downloadError) {
+      console.log(`\n❌ Auto-download failed: ${downloadError.message}`);
     }
 
     console.log('\n💡 Please install Podman manually:');