@robbiesrobotics/alice-agents 1.3.1 → 1.3.2

package/lib/doctor.mjs

@@ -1,6 +1,6 @@
-import { readFileSync, existsSync } from 'node:fs';
+import { readFileSync, existsSync, accessSync, constants } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { homedir } from 'node:os';
+import { homedir, platform } from 'node:os';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 
@@ -42,6 +42,72 @@ function loadConfig() {
   }
 }
 
+/**
+ * Check Docker socket accessibility.
+ * On Linux, Docker often requires sudo unless the user is in the docker group.
+ * Returns { present, accessible, needsSudo, hint }
+ */
+function checkDockerEnvironment() {
+  const isLinux = platform() === 'linux';
+
+  // Check if docker binary exists at all
+  let dockerInstalled = false;
+  try {
+    execSync('which docker', { stdio: 'pipe' });
+    dockerInstalled = true;
+  } catch {
+    // Docker not installed — not a blocker unless openclaw needs it
+    return { present: false, accessible: false, needsSudo: false, hint: null };
+  }
+
+  // Try docker ps without sudo
+  try {
+    execSync('docker ps', { stdio: 'pipe' });
+    return { present: true, accessible: true, needsSudo: false, hint: null };
+  } catch (err) {
+    const msg = err.stderr?.toString() || '';
+
+    // Permission denied / cannot connect to daemon — classic sudo-required scenario
+    const isPermissionIssue =
+      msg.includes('permission denied') ||
+      msg.includes('Got permission denied') ||
+      msg.includes('Cannot connect to the Docker daemon') ||
+      msg.includes('dial unix') ||
+      msg.includes('connect: permission denied');
+
+    if (isLinux && isPermissionIssue) {
+      // Try sudo docker ps to confirm it works with elevated perms
+      let sudoWorks = false;
+      try {
+        execSync('sudo docker ps', { stdio: 'pipe', timeout: 5000 });
+        sudoWorks = true;
+      } catch {}
+
+      return {
+        present: true,
+        accessible: false,
+        needsSudo: true,
+        sudoWorks,
+        hint: sudoWorks
+          ? `Docker requires sudo on this machine. Fix with:\n     sudo usermod -aG docker $USER && newgrp docker\n     Then log out and back in. Or run OpenClaw with sudo (not recommended for production).`
+          : `Docker found but not accessible. Check that the Docker daemon is running:\n     sudo systemctl start docker\n     Then add your user to the docker group:\n     sudo usermod -aG docker $USER && newgrp docker`,
+      };
+    }
+
+    // Docker is installed but daemon isn't running
+    if (msg.includes('Is the docker daemon running') || msg.includes('Cannot connect')) {
+      return {
+        present: true,
+        accessible: false,
+        needsSudo: false,
+        hint: 'Docker daemon is not running. Start it:\n     sudo systemctl start docker   (Linux)\n     open -a Docker                  (macOS)',
+      };
+    }
+
+    return { present: true, accessible: false, needsSudo: false, hint: `docker ps failed: ${msg.slice(0, 100)}` };
+  }
+}
+
 export async function runDoctor() {
   console.log('\n  🩺 A.L.I.C.E. Doctor — Diagnostic Report\n');
   let allOk = true;
@@ -157,7 +223,27 @@ export async function runDoctor() {
   );
   allOk = allOk && modelOk;
 
-  // 6. License check
+  // 6. Docker environment check (Linux-aware)
+  const docker = checkDockerEnvironment();
+  if (docker.present) {
+    if (docker.accessible) {
+      check('Docker accessible', true);
+    } else if (docker.needsSudo) {
+      check(
+        'Docker requires sudo — user not in docker group',
+        false,
+        docker.hint
+      );
+      // Docker permission issue is a warning, not a hard failure for A.L.I.C.E. itself
+      // but it will break OpenClaw's own Docker features
+      console.log('  ℹ️  Note: This will affect OpenClaw features that use Docker.\n');
+    } else {
+      check('Docker daemon not running or not accessible', false, docker.hint);
+    }
+  }
+  // If docker not present at all, skip silently — not required for all setups
+
+  // 7. License check
   const { checkProLicense } = await import('./license.mjs');
   const manifest = (() => {
     try {

package/lib/installer.mjs

@@ -29,6 +29,44 @@ function isOpenClawInstalled() {
   }
 }
 
+/**
+ * On Linux, Docker requires the user to be in the docker group.
+ * Detect this early and warn before OpenClaw's own preflight fails cryptically.
+ */
+function checkLinuxDockerPermissions() {
+  if (process.platform !== 'linux') return;
+
+  try {
+    execSync('which docker', { stdio: 'pipe' });
+  } catch {
+    return; // Docker not installed — not our problem
+  }
+
+  try {
+    execSync('docker ps', { stdio: 'pipe' });
+    return; // Works fine — user is in docker group
+  } catch (err) {
+    const msg = err.stderr?.toString() || '';
+    const isPermissionIssue =
+      msg.includes('permission denied') ||
+      msg.includes('Got permission denied') ||
+      msg.includes('Cannot connect to the Docker daemon') ||
+      msg.includes('connect: permission denied');
+
+    if (isPermissionIssue) {
+      console.log('  ⚠️  Docker permission issue detected.\n');
+      console.log('  Your user is not in the docker group. This will cause');
+      console.log('  OpenClaw to fail when it tries to access Docker.\n');
+      console.log('  Fix this now (recommended):');
+      console.log('    sudo usermod -aG docker $USER');
+      console.log('    newgrp docker\n');
+      console.log('  Or log out and back in after running the usermod command.');
+      console.log('  You can also run: npx @robbiesrobotics/alice-agents --doctor');
+      console.log('  after fixing to verify the issue is resolved.\n');
+    }
+  }
+}
+
 async function detectRuntime() {
   // Check for NemoClaw binary
   try {
@@ -215,6 +253,9 @@ export async function runInstall(options = {}) {
 
   printBanner();
 
+  // 0. Linux Docker permission check — warn early before OpenClaw preflight fails
+  checkLinuxDockerPermissions();
+
   // 1. Detect OpenClaw — offer to install if missing
   if (!isOpenClawInstalled() || !configExists()) {
     await installRuntime(auto);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbiesrobotics/alice-agents",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "A.L.I.C.E. — 28 AI agents for OpenClaw. One conversation, one team.",
   "bin": {
     "alice-agents": "bin/alice-install.mjs"