clementine-agent 1.0.34 → 1.0.36

package/dist/agent/self-improve.js

@@ -198,6 +198,11 @@ export class SelfImproveLoop {
         const loopStart = Date.now();
         const history = this.loadExperimentLog();
         let consecutiveLow = 0;
+        // Cap accepted proposals per run so the owner's approval queue stays
+        // scannable. The nightly loop should surface 1-3 solid ideas — not a
+        // flood — even if the hypothesizer is inspired.
+        const maxAcceptancesPerRun = 3;
+        let acceptedThisRun = 0;
         try {
             // Step 1: Gather baseline metrics
             const metrics = await this.gatherMetrics();
@@ -379,6 +384,7 @@ export class SelfImproveLoop {
                             }
                         }
                         consecutiveLow = 0;
+                        acceptedThisRun++;
                     }
                     else {
                         consecutiveLow++;
@@ -389,7 +395,13 @@ export class SelfImproveLoop {
                         area: proposal.area,
                         score,
                         accepted,
+                        acceptedThisRun,
                     }, `Iteration ${i} complete`);
+                    // Stop once we've landed enough good ideas for the owner to review.
+                    if (acceptedThisRun >= maxAcceptancesPerRun) {
+                        logger.info({ acceptedThisRun }, 'Reached max-acceptances per run — stopping');
+                        break;
+                    }
                 }
                 catch (err) {
                     const classified = classifyError(err);
@@ -666,6 +678,17 @@ export class SelfImproveLoop {
         const recentTargets = new Map();
         const recentAreas = new Map();
         for (const e of history.slice(-50)) {
+            // Skip error-fallback experiments. They default to `area: 'soul', target:
+            // 'unknown'` (see the error-catch block below) and historically have
+            // poisoned diversity accounting — e.g. a ~2-week stretch of API errors
+            // artificially blacklisted the whole 'soul' area even though no real
+            // attempt was made. A crashed iteration isn't evidence we explored the
+            // space, just that the SDK call failed.
+            if (e.reason?.startsWith('Error:'))
+                continue;
+            // Plateau markers also shouldn't count as attempts.
+            if (e.hypothesis?.startsWith('No new hypothesis'))
+                continue;
             const key = `${e.area}:${e.target}`;
             const ts = Date.parse(e.startedAt);
             const tsMs = Number.isFinite(ts) ? ts : 0;
@@ -717,7 +740,7 @@ export class SelfImproveLoop {
                     (overTargeted.length > 0
                         ? `These specific targets MUST NOT be re-targeted:\n${overTargeted.map(t => `- ${t}`).join('\n')}\n`
                         : '') +
-                    `Choose a DIFFERENT area/target. If no other improvement is needed, output { "area": null }.\n`
+                    `Choose a DIFFERENT area/target. If no other improvement is genuinely needed today, return an empty results array: { "results": [] }.\n`
                 : '');
         const patternAnalysis = this.analyzeExperimentPatterns(history);
         // Format negative feedback
@@ -802,18 +825,17 @@ export class SelfImproveLoop {
             agentFocusText +
             soulCandidatesText +
             `\n## Instructions\n` +
-            `Rank these by expected impact. For each opportunity, specify:\n` +
+            `Propose **1-3 concrete, high-impact improvements** the owner should review today — no fewer (aim for at least one actionable suggestion when data warrants it), no more (the owner reads each proposal manually and you'll overwhelm them). Rank by expected impact; drop anything below "solid idea".\n\n` +
+            `For each opportunity, specify:\n` +
             `- area: ${areas}\n` +
-            `- target: the file/agent slug that should change\n` +
+            `- target: the exact file path / agent slug / cron job name that should change (not "unknown", not "n/a")\n` +
             `- what: a 1-sentence description of what specifically should change\n` +
-            `- why: which metric this should improve\n\n` +
+            `- why: which metric or signal from the data above this should improve\n\n` +
             `Area notes:\n` +
             `- For "goal": target = "{owner}/{goal-slug}" (e.g. "clementine/improve-reply-rates" or "ross-the-sdr/book-demos"). ` +
             `Propose when you observe a pattern in completed tasks or cron runs that suggests a missing or stale goal. ` +
             `The proposedChange must be a JSON goal object with at minimum: title, description, priority, reviewFrequency.\n\n` +
-            `Output ONLY a JSON array of 1-3 objects (no markdown, no explanation):\n` +
-            `[{ "area": "...", "target": "...", "what": "...", "why": "..." }]\n` +
-            `If no improvement is needed, output: []`;
+            `Return your answer as a JSON object matching the schema: { "results": [ ... ] }. Up to 3 items. If absolutely nothing actionable today, return { "results": [] }.`;
         const analysisResult = await this.assistant.runPlanStep('si-analyze', analysisPrompt, {
             tier: 2,
             maxTurns: 3,

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.34",
+  "version": "1.0.36",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",