clementine-agent 1.0.35 → 1.0.36

package/dist/cli/index.js

@@ -480,6 +480,7 @@ function cmdDoctor(opts = {}) {
     console.log(`  ${DIM}Running health checks...${fix ? ` (auto-fix enabled)` : ''}${RESET}`);
     console.log();
     let issues = 0;
+    let warnings = 0;
     let fixed = 0;
     const isMac = process.platform === 'darwin';
     const isLinux = process.platform === 'linux';
@@ -497,6 +498,9 @@ function cmdDoctor(opts = {}) {
     catch {
         return false;
     } })();
+    // One-liner to install Homebrew on macOS — surfaced when brew is missing
+    // so users have a copy-pasteable fix instead of searching for it.
+    const BREW_INSTALL_CMD = '/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"';
     /** Attempt a fix command, return true on success. */
     function tryFix(label, cmd, opts) {
         if (!fix)
@@ -572,24 +576,32 @@ function cmdDoctor(opts = {}) {
         }
     }
     // FalkorDB graph engine — system dependencies: redis
+    // Optional at runtime: graph-store.ts degrades gracefully (isAvailable()
+    // returns false; graph operations become no-ops). Missing deps are a
+    // warning, not a blocking issue — daemon launches fine without them.
     try {
         execSync('which redis-server', { stdio: 'pipe' });
         console.log(`  ${GREEN}OK${RESET}  redis-server found`);
     }
     catch {
-        console.log(`  ${RED}FAIL${RESET}  redis-server not found (required for knowledge graph)`);
+        console.log(`  ${YELLOW}WARN${RESET}  redis-server not found (optional — enables knowledge graph)`);
         const fixCmd = hasBrew ? 'brew install redis' : hasApt ? 'sudo apt-get install -y redis-server' : null;
         if (fixCmd && tryFix('redis-server', fixCmd)) {
             // fixed
         }
         else if (!fixCmd && fix) {
-            console.log(`       ${YELLOW}Cannot auto-fix:${RESET} no supported package manager found`);
-            console.log(`       Install redis-server manually`);
-            issues++;
+            if (isMac) {
+                console.log(`       ${YELLOW}Homebrew not installed.${RESET} Install it first, then re-run ${CYAN}clementine doctor --fix${RESET}:`);
+                console.log(`         ${BREW_INSTALL_CMD}`);
+            }
+            else {
+                console.log(`       Install redis-server manually (no supported package manager detected)`);
+            }
+            warnings++;
         }
         else {
             console.log(`       Fix: brew install redis (macOS) or sudo apt install redis-server (Linux)`);
-            issues++;
+            warnings++;
         }
     }
     // FalkorDB graph engine — system dependencies: libomp
@@ -603,19 +615,25 @@ function cmdDoctor(opts = {}) {
         console.log(`  ${GREEN}OK${RESET}  libomp (OpenMP runtime) found`);
     }
     catch {
-        console.log(`  ${RED}FAIL${RESET}  libomp (OpenMP runtime) not found (required for knowledge graph)`);
+        console.log(`  ${YELLOW}WARN${RESET}  libomp (OpenMP runtime) not found (optional — enables knowledge graph)`);
         const fixCmd = hasBrew ? 'brew install libomp' : hasApt ? 'sudo apt-get install -y libomp-dev' : null;
         if (fixCmd && tryFix('libomp', fixCmd)) {
             // fixed
         }
         else if (!fixCmd && fix) {
-            console.log(`       ${YELLOW}Cannot auto-fix:${RESET} no supported package manager found`);
-            console.log(`       Install libomp manually`);
-            issues++;
+            if (isMac) {
+                // Redis check above already printed the brew installer command;
+                // avoid spamming it twice by just pointing back to that guidance.
+                console.log(`       Install Homebrew (see redis-server WARN above), then ${CYAN}brew install libomp${RESET}`);
+            }
+            else {
+                console.log(`       Install libomp manually (no supported package manager detected)`);
+            }
+            warnings++;
         }
         else {
             console.log(`       Fix: brew install libomp (macOS) or sudo apt install libomp-dev (Linux)`);
-            issues++;
+            warnings++;
         }
     }
     // FalkorDB graph engine — module binaries
@@ -624,10 +642,11 @@ function cmdDoctor(opts = {}) {
         console.log(`  ${GREEN}OK${RESET}  FalkorDB graph engine binaries installed`);
     }
     catch {
-        console.log(`  ${RED}FAIL${RESET}  FalkorDB graph engine binaries not available`);
+        console.log(`  ${YELLOW}WARN${RESET}  FalkorDB graph engine binaries not available (optional — enables knowledge graph)`);
         if (!tryFix('FalkorDB binaries', `node node_modules/falkordblite/scripts/postinstall.js`, { cwd: PACKAGE_ROOT, timeout: 180000 })) {
             console.log(`       Fix: cd ${PACKAGE_ROOT} && node node_modules/falkordblite/scripts/postinstall.js`);
-            issues++;
+            console.log(`       ${DIM}(Usually self-heals once redis-server + libomp are installed)${RESET}`);
+            warnings++;
         }
     }
     // Data home
@@ -829,17 +848,21 @@ function cmdDoctor(opts = {}) {
         }
     }
     console.log();
-    if (issues === 0 && fixed === 0) {
+    const warnSuffix = warnings > 0 ? `, ${warnings} warning(s)` : '';
+    if (issues === 0 && fixed === 0 && warnings === 0) {
         console.log(`  ${GREEN}All checks passed.${RESET}`);
     }
+    else if (issues === 0 && fixed === 0 && warnings > 0) {
+        console.log(`  ${GREEN}Ready to launch.${RESET} ${warnings} optional dependency warning(s) — safe to ignore or install for full experience.`);
+    }
     else if (issues === 0 && fixed > 0) {
-        console.log(`  ${GREEN}All issues fixed!${RESET} (${fixed} auto-fixed)`);
+        console.log(`  ${GREEN}All issues fixed!${RESET} (${fixed} auto-fixed${warnSuffix})`);
     }
     else if (fixed > 0) {
-        console.log(`  ${YELLOW}${issues} issue(s) remaining${RESET} (${fixed} auto-fixed)`);
+        console.log(`  ${YELLOW}${issues} issue(s) remaining${RESET} (${fixed} auto-fixed${warnSuffix})`);
     }
     else {
-        console.log(`  ${YELLOW}${issues} issue(s) found.${RESET}${!fix ? ` Run ${CYAN}clementine doctor --fix${RESET} to auto-install dependencies.` : ''}`);
+        console.log(`  ${YELLOW}${issues} issue(s) found${warnSuffix}.${RESET}${!fix ? ` Run ${CYAN}clementine doctor --fix${RESET} to auto-install dependencies.` : ''}`);
     }
     console.log();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",