slackhive 0.1.10 → 0.1.12

package/dist/commands/init.js

@@ -176,6 +176,24 @@ async function init(opts) {
         console.log(chalk_1.default.bold.hex('#D97757')('  [4/4]') + chalk_1.default.bold(' Building & starting services'));
         console.log(chalk_1.default.gray('  This takes 3–5 minutes on first run while Docker builds images.'));
         console.log('');
+        // Pre-flight: check Docker has enough disk space (need ~3GB)
+        try {
+            const dfOut = (0, child_process_1.execSync)('docker system df --format "{{.Size}}"', { encoding: 'utf-8' });
+            void dfOut; // just checking it runs without error
+        }
+        catch {
+            console.log(chalk_1.default.yellow('  ↳ Could not check Docker disk usage — continuing anyway'));
+        }
+        // Pre-flight: warn if low disk space on host
+        try {
+            const df = (0, child_process_1.execSync)('df -k . | tail -1', { encoding: 'utf-8' }).trim();
+            const available = parseInt(df.split(/\s+/)[3]);
+            if (!isNaN(available) && available < 3 * 1024 * 1024) {
+                console.log(chalk_1.default.yellow(`  ↳ Warning: less than 3GB disk space available. Build may fail.`));
+                console.log('');
+            }
+        }
+        catch { /* non-fatal */ }
         await runDockerBuild(dir, opts.dir);
         // Wait for web UI
         const webSpinner = (0, ora_1.default)('  Waiting for web UI to be ready...').start();
@@ -258,6 +276,7 @@ function runDockerBuild(cwd, displayDir) {
         }, 80);
         let stdoutBuf = '';
         let stderrBuf = '';
+        const errorLines = [];
         proc.stdout.on('data', (chunk) => {
             stdoutBuf += chunk.toString();
             const lines = stdoutBuf.split('\n');
@@ -279,6 +298,8 @@ function runDockerBuild(cwd, displayDir) {
                 const m = /\[([^\]]+)\] (.+)/.exec(line.trim());
                 if (m)
                     currentStep = `${m[1]} — ${m[2].slice(0, 40)}`;
+                if (/error/i.test(line) && line.trim())
+                    errorLines.push(line.trim());
             });
         });
         proc.on('close', (code) => {
@@ -290,8 +311,38 @@ function runDockerBuild(cwd, displayDir) {
             }
             else {
                 console.log('  ' + chalk_1.default.red('✗') + ' Failed to start services');
-                console.log(chalk_1.default.gray(`  Try manually: cd ${displayDir} && docker compose up -d --build`));
-                reject(new Error(`docker compose exited with code ${code}`));
+                console.log('');
+                // Classify the error and give actionable guidance
+                const allErrors = errorLines.join('\n').toLowerCase();
+                if (allErrors.includes('no space left') || allErrors.includes('disk full')) {
+                    console.log(chalk_1.default.yellow('  Cause: Docker is out of disk space.'));
+                    console.log(chalk_1.default.gray('  Fix:   Run `docker system prune -a` to free space, then retry.'));
+                }
+                else if (allErrors.includes('port is already allocated') || allErrors.includes('address already in use')) {
+                    const portMatch = /bind for .+:(\d+)/.exec(allErrors);
+                    const port = portMatch ? portMatch[1] : 'a required port';
+                    console.log(chalk_1.default.yellow(`  Cause: Port ${port} is already in use by another process.`));
+                    console.log(chalk_1.default.gray(`  Fix:   Stop the process using port ${port}, then retry.`));
+                }
+                else if (allErrors.includes('permission denied') || allErrors.includes('unauthorized')) {
+                    console.log(chalk_1.default.yellow('  Cause: Docker permission denied.'));
+                    console.log(chalk_1.default.gray('  Fix:   Make sure Docker Desktop is running and you are logged in.'));
+                }
+                else if (allErrors.includes('network') || allErrors.includes('timeout') || allErrors.includes('pull')) {
+                    console.log(chalk_1.default.yellow('  Cause: Network error while pulling Docker images.'));
+                    console.log(chalk_1.default.gray('  Fix:   Check your internet connection and retry.'));
+                }
+                else if (allErrors.includes('memory') || allErrors.includes('oom')) {
+                    console.log(chalk_1.default.yellow('  Cause: Docker ran out of memory.'));
+                    console.log(chalk_1.default.gray('  Fix:   Increase Docker Desktop memory in Settings → Resources (4GB+ recommended).'));
+                }
+                else if (errorLines.length > 0) {
+                    console.log(chalk_1.default.gray('  Error details:'));
+                    errorLines.slice(-5).forEach(l => console.log(chalk_1.default.red('    ' + l)));
+                }
+                console.log('');
+                console.log(chalk_1.default.gray(`  To retry: cd ${displayDir} && docker compose up -d --build`));
+                resolve(); // don't reject — let init finish gracefully
             }
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slackhive",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "CLI to install and manage SlackHive — AI agent teams on Slack",
   "bin": {
     "slackhive": "./dist/index.js"