clementine-agent 1.18.188 → 1.18.189

package/dist/agent/project-resolver.d.ts

@@ -90,6 +90,14 @@ export interface DiscoveryCandidate {
  * Search the filesystem for folders that could plausibly be the
  * project the user is mentioning. Used when the registry has no match.
  *
+ * 1.18.189 — search order:
+ *   1. Spotlight (`mdfind`) on macOS — instant, system-indexed,
+ *      finds folders ANYWHERE on disk by name. Critical when the
+ *      project is at depth 2+ ("~/Documents/Work/team-coaches")
+ *      or the owner only knows part of the name.
+ *   2. Direct walk of DEFAULT_DISCOVERY_ROOTS (depth 1) — fallback
+ *      for non-macOS and edge cases where Spotlight is disabled.
+ *
  * Returns candidates sorted by composite score (best first). The
  * caller — typically the chat agent via the `project_discover` tool —
  * inspects the list and decides whether to ask the owner for
@@ -102,6 +110,7 @@ export declare function discoverProjectCandidates(searchTerm: string, opts?: {
     searchRoots?: string[];
     maxResults?: number;
     nowMs?: number;
+    disableSpotlight?: boolean;
 }): DiscoveryCandidate[];
 /**
  * Heuristic: does the user message indicate they're disputing prior

package/dist/agent/project-resolver.js

@@ -29,6 +29,7 @@
  * Pure functions where possible; filesystem discovery is the only
  * I/O. Safe to call from any layer that has a sessionKey.
  */
+import { execSync } from 'node:child_process';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -150,6 +151,14 @@ export function resolveProjectFromMessage(message, opts = {}) {
  * Search the filesystem for folders that could plausibly be the
  * project the user is mentioning. Used when the registry has no match.
  *
+ * 1.18.189 — search order:
+ *   1. Spotlight (`mdfind`) on macOS — instant, system-indexed,
+ *      finds folders ANYWHERE on disk by name. Critical when the
+ *      project is at depth 2+ ("~/Documents/Work/team-coaches")
+ *      or the owner only knows part of the name.
+ *   2. Direct walk of DEFAULT_DISCOVERY_ROOTS (depth 1) — fallback
+ *      for non-macOS and edge cases where Spotlight is disabled.
+ *
  * Returns candidates sorted by composite score (best first). The
  * caller — typically the chat agent via the `project_discover` tool —
  * inspects the list and decides whether to ask the owner for
@@ -167,6 +176,55 @@ export function discoverProjectCandidates(searchTerm, opts = {}) {
     const nowMs = opts.nowMs ?? Date.now();
     const candidates = [];
     const seen = new Set();
+    const consider = (full) => {
+        if (seen.has(full))
+            return;
+        seen.add(full);
+        let stat;
+        try {
+            stat = fs.statSync(full);
+        }
+        catch {
+            return;
+        }
+        if (!stat.isDirectory())
+            return;
+        const basename = path.basename(full).toLowerCase();
+        if (DISCOVERY_IGNORE.has(path.basename(full)))
+            return;
+        if (basename.startsWith('.'))
+            return;
+        // Skip anything under our own ignore roots even if Spotlight indexed them.
+        if (/\/(node_modules|\.git|Library|\.cache|\.Trash)\//.test(full))
+            return;
+        const nameScore = computeNameScore(basename, term);
+        if (nameScore === 0)
+            return;
+        const recencyScore = computeRecencyScore(stat.mtimeMs, nowMs);
+        const { score: contentScore, summary: contentSummary } = computeContentScore(full);
+        const totalScore = 0.6 * nameScore + 0.25 * contentScore + 0.15 * recencyScore;
+        candidates.push({
+            path: full,
+            basename: path.basename(full),
+            nameScore,
+            recencyScore,
+            contentScore,
+            totalScore,
+            contentSummary,
+        });
+    };
+    // ── 1. Spotlight (macOS) ─────────────────────────────────────────
+    if (!opts.disableSpotlight && process.platform === 'darwin') {
+        try {
+            const spotlightHits = mdfindFolders(term);
+            for (const full of spotlightHits)
+                consider(full);
+        }
+        catch {
+            // Spotlight unavailable / disabled — fall through to walk.
+        }
+    }
+    // ── 2. Direct walk of standard roots (depth 1) ───────────────────
     for (const root of roots) {
         if (!root || !fs.existsSync(root))
             continue;
@@ -182,42 +240,38 @@ export function discoverProjectCandidates(searchTerm, opts = {}) {
                 continue;
             if (DISCOVERY_IGNORE.has(entry))
                 continue;
-            const full = path.join(root, entry);
-            if (seen.has(full))
-                continue;
-            seen.add(full);
-            let stat;
-            try {
-                stat = fs.statSync(full);
-            }
-            catch {
-                continue;
-            }
-            if (!stat.isDirectory())
-                continue;
-            const basename = entry.toLowerCase();
-            const nameScore = computeNameScore(basename, term);
-            // Cheap pre-filter: skip if name has zero overlap with the term.
-            if (nameScore === 0)
-                continue;
-            const recencyScore = computeRecencyScore(stat.mtimeMs, nowMs);
-            const { score: contentScore, summary: contentSummary } = computeContentScore(full);
-            // Weighted composite. Name dominates; content + recency are tiebreakers.
-            const totalScore = 0.6 * nameScore + 0.25 * contentScore + 0.15 * recencyScore;
-            candidates.push({
-                path: full,
-                basename: entry,
-                nameScore,
-                recencyScore,
-                contentScore,
-                totalScore,
-                contentSummary,
-            });
+            consider(path.join(root, entry));
         }
     }
     candidates.sort((a, b) => b.totalScore - a.totalScore);
     return candidates.slice(0, maxResults);
 }
+/**
+ * Run `mdfind` to find folders whose name matches the search term.
+ * macOS only. Returns absolute paths. Limits result count + total
+ * runtime so a vague query can't hang the agent.
+ */
+function mdfindFolders(term) {
+    // kMDItemDisplayName — folder name as Finder shows it
+    // kMDItemContentTypeTree includes "public.folder" — restricts to folders
+    // The query: name contains term (case-insensitive) AND is a folder.
+    // Escape double quotes in the term defensively.
+    const safe = term.replace(/["\\]/g, '');
+    if (!safe)
+        return [];
+    const query = `kMDItemDisplayName == "*${safe}*"cd && kMDItemContentTypeTree == "public.folder"`;
+    try {
+        const out = execSync(`mdfind '${query}' 2>/dev/null | head -40`, {
+            timeout: 4_000,
+            maxBuffer: 256 * 1024,
+            encoding: 'utf-8',
+        });
+        return out.split('\n').map((s) => s.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
 // ── Scoring helpers ──────────────────────────────────────────────────
 function computeNameScore(basename, term) {
     // Exact match: 1.0

package/dist/agent/run-agent-cron.js

@@ -47,6 +47,19 @@ const BACKGROUND_TASK_WORKER_PROMPT = [
     '',
     'Use TodoWrite for multi-step state. Process batch work in bounded chunks, checkpoint meaningful progress in durable artifacts when useful, and avoid repeating the same expensive read or tool call.',
     '',
+    '## Context budget — survive long jobs without thrashing (1.18.189)',
+    '',
+    'Your context window is finite. Two failure patterns kill long jobs:',
+    '1. **Reading too much, too soon.** Don\'t `Read` a 10MB CSV to find one column — use `Bash head -100`, `awk -F, \'{print $3}\'`, or `Grep` first to confirm shape, then narrow.',
+    '2. **Searching by scanning.** Don\'t `Glob`/`Read` through `~/Documents` looking for a project — call `project_discover` with the project name; it uses Spotlight on macOS and returns ranked candidates instantly.',
+    '',
+    'Tool-by-tool guidance:',
+    '- **Finding a project**: call `mcp__clementine-tools__project_discover` with the search term. ONE call. Returns candidates.',
+    '- **Linking a project**: after the owner confirms which candidate is right, call `mcp__clementine-tools__project_link`. Don\'t skip this — without linking, future turns can\'t resolve the project.',
+    '- **Deploying**: call `mcp__clementine-tools__project_deploy` — it runs the command AND curls the verify URL. Don\'t invent deploy commands by hand.',
+    '- **Reading large data files**: prefer `Bash head/wc/awk/jq` over `Read` for any file >500 lines.',
+    '- **Listing many files**: `Bash ls`/`find` with `head -N` is cheaper than `Glob` for big trees.',
+    '',
     'If credentials, missing scope, human approval, or an irreversible action blocks completion, stop with one concise blocker/question and the exact next action needed. Do not keep retrying blindly.',
     '',
     'Return only the final user-facing result: links or changed locations, counts, skipped/error records, and the next recommended action.',

package/dist/gateway/router.js

@@ -49,8 +49,15 @@ const CHAT_TIMEOUT_MS = 10 * 60 * 1000;
  *  Safety net so no session runs forever, even if active.
  *  Primary guardrail is cost budget (maxBudgetUsd), not this timer. */
 const CHAT_MAX_WALL_MS = 30 * 60 * 1000;
-const CHAT_CONTEXT_RETRY_CONTEXT_MAX_CHARS = 6_000;
-const CHAT_CONTEXT_RETRY_SYSTEM_MAX_CHARS = 16_000;
+// 1.18.189 — tightened from 6_000 / 16_000 because the recovery prompt
+// was eating ~22KB of the bg-task worker's context window before any
+// real work started. On 2026-05-12 the worker autocompact-thrashed while
+// reading project files; the new tighter caps give it ~10KB more headroom
+// to do actual tool calls. The dropped content (older memory recall,
+// less-relevant bg-task headlines) is recoverable via memory_search if
+// the model actually needs it.
+const CHAT_CONTEXT_RETRY_CONTEXT_MAX_CHARS = 3_000;
+const CHAT_CONTEXT_RETRY_SYSTEM_MAX_CHARS = 8_000;
 const BACKGROUND_TASK_ID_RE = /\bbg-[a-z0-9]+-[a-f0-9]{6}\b/i;
 function collectRunToolNames(runId) {
     if (!runId)

package/package.json

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