@cachly-dev/mcp-server 0.10.49 → 0.10.50

package/dist/src/bench/cachly-bench.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachly-bench.js","sourceRoot":"","sources":["../../../src/bench/cachly-bench.ts"],"names":[],"mappings":"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"}

package/dist/src/bench/fixtures.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cachly-Bench fixture corpus.
+ *
+ * A small but realistic corpus of engineering "lessons" plus a set of labeled
+ * natural-language queries. Each query declares which lesson topics are *truly*
+ * relevant — the answer an agent actually wants.
+ *
+ * The corpus is deliberately adversarial in a fair way: for several queries there
+ * is a text-similar but LOW-QUALITY distractor (a failed attempt, an unverified
+ * note) competing with the proven success lesson. This is exactly the situation
+ * where raw text ranking (and a flat-file memory) goes wrong, and where Cachly's
+ * quality-aware reranking should win. The labels reward the lesson that solves the
+ * problem, not the one that merely shares vocabulary.
+ */
+export interface BenchLesson {
+    /** Stored under cachly:lesson:best:{topic} */
+    topic: string;
+    outcome: 'success' | 'partial' | 'failure';
+    what_worked: string;
+    what_failed?: string;
+    context?: string;
+    severity?: 'critical' | 'major' | 'minor';
+    confidence?: number;
+    recall_count?: number;
+    tags?: string[];
+    ts?: string;
+}
+export interface BenchQuery {
+    query: string;
+    /** Topics that genuinely answer the query (the gold set). */
+    relevant: string[];
+}
+export declare const BENCH_LESSONS: BenchLesson[];
+export declare const BENCH_QUERIES: BenchQuery[];

package/dist/src/bench/fixtures.js

@@ -0,0 +1,199 @@
+/**
+ * Cachly-Bench fixture corpus.
+ *
+ * A small but realistic corpus of engineering "lessons" plus a set of labeled
+ * natural-language queries. Each query declares which lesson topics are *truly*
+ * relevant — the answer an agent actually wants.
+ *
+ * The corpus is deliberately adversarial in a fair way: for several queries there
+ * is a text-similar but LOW-QUALITY distractor (a failed attempt, an unverified
+ * note) competing with the proven success lesson. This is exactly the situation
+ * where raw text ranking (and a flat-file memory) goes wrong, and where Cachly's
+ * quality-aware reranking should win. The labels reward the lesson that solves the
+ * problem, not the one that merely shares vocabulary.
+ */
+const NOW = Date.now();
+const daysAgo = (d) => new Date(NOW - d * 86400_000).toISOString();
+export const BENCH_LESSONS = [
+    // ── Deploy domain ──────────────────────────────────────────────────────────
+    {
+        topic: 'deploy:k8s:rollout-stuck',
+        outcome: 'success',
+        what_worked: 'Set a readinessProbe with a longer initialDelaySeconds and a higher failureThreshold so the liveness probe stopped terminating the container before startup completed. The pod then reached ready and traffic flowed.',
+        context: 'Production release never became healthy.',
+        severity: 'critical', confidence: 0.95, recall_count: 12,
+        tags: ['kubernetes', 'deploy', 'probe'], ts: daysAgo(8),
+    },
+    {
+        topic: 'deploy:k8s:rollout-attempt-restart',
+        outcome: 'failure',
+        what_worked: '',
+        what_failed: 'The kubernetes deploy was stuck, the rollout was not finishing, so I restarted the deploy. The kubernetes deploy stayed stuck and the rollout still was not finishing. Restarted the stuck rollout again, deploy still stuck.',
+        context: 'Kubernetes deploy stuck, rollout not finishing.',
+        severity: 'major', confidence: 0.3, recall_count: 0,
+        tags: ['kubernetes', 'deploy'], ts: daysAgo(9),
+    },
+    {
+        topic: 'deploy:docker:image-too-large',
+        outcome: 'success',
+        what_worked: 'Reduced Docker image size dramatically with a multi-stage build and a slim base image, moving build-only deps out of the final layer.',
+        context: 'CI pushes were slow due to a 1.8GB image.',
+        severity: 'minor', confidence: 0.9, recall_count: 6,
+        tags: ['docker', 'deploy', 'optimization'], ts: daysAgo(20),
+    },
+    // ── Database domain ────────────────────────────────────────────────────────
+    {
+        topic: 'db:postgres:connection-pool-exhausted',
+        outcome: 'success',
+        what_worked: 'Added PgBouncer in transaction pooling mode and lowered the per-service max pool size so backends were shared. Peak traffic stopped exhausting backends.',
+        context: 'API returned 500s at peak traffic.',
+        severity: 'critical', confidence: 0.92, recall_count: 9,
+        tags: ['postgres', 'database', 'pool'], ts: daysAgo(15),
+    },
+    {
+        topic: 'db:postgres:slow-query-missing-index',
+        outcome: 'success',
+        what_worked: 'A slow Postgres query was fixed by adding a composite index on (tenant_id, created_at); query dropped from 4s to 12ms.',
+        context: 'Dashboard timed out loading recent events.',
+        severity: 'major', confidence: 0.88, recall_count: 4,
+        tags: ['postgres', 'database', 'index', 'performance'], ts: daysAgo(30),
+    },
+    {
+        topic: 'db:postgres:pool-raise-limit-attempt',
+        outcome: 'failure',
+        what_worked: '',
+        what_failed: 'Postgres had too many connections under load, so I raised max_connections. Postgres still had too many connections under load and the load made it worse — too many connections again under load.',
+        context: 'Postgres too many connections under load.',
+        severity: 'major', confidence: 0.25, recall_count: 0,
+        tags: ['postgres', 'database', 'pool'], ts: daysAgo(16),
+    },
+    // ── Auth domain ────────────────────────────────────────────────────────────
+    {
+        topic: 'auth:jwt:expired-on-restart',
+        outcome: 'success',
+        what_worked: 'JWT was lost on server restart because it was only kept in memory; persisting the token to disk after the device flow fixed recall counts staying at zero.',
+        context: 'Telemetry showed zero authenticated calls after restarts.',
+        severity: 'critical', confidence: 0.93, recall_count: 7,
+        tags: ['jwt', 'auth', 'persistence'], ts: daysAgo(3),
+    },
+    {
+        topic: 'auth:pkce:keycloak-rejects-exchange',
+        outcome: 'success',
+        what_worked: 'Keycloak rejected the PKCE code exchange because the verifier used non-URL-safe Base64; switching to RFC 7636 Base64URL random bytes fixed the login.',
+        context: 'Mobile login failed at the token exchange step.',
+        severity: 'major', confidence: 0.9, recall_count: 3,
+        tags: ['pkce', 'auth', 'keycloak', 'oauth'], ts: daysAgo(2),
+    },
+    // ── Redis / cache domain ───────────────────────────────────────────────────
+    {
+        topic: 'redis:noauth-on-every-call',
+        outcome: 'success',
+        what_worked: 'The connection endpoint omitted the password field, so the client connected unauthenticated; returning the credential explicitly in the response let the client authenticate and the calls succeeded.',
+        context: 'Hosted Valkey requires a credential.',
+        severity: 'critical', confidence: 0.94, recall_count: 11,
+        tags: ['redis', 'valkey', 'auth'], ts: daysAgo(4),
+    },
+    {
+        topic: 'redis:noauth-disable-auth-attempt',
+        outcome: 'failure',
+        what_worked: '',
+        what_failed: 'Redis threw NOAUTH on every call, so I tried disabling auth on Redis. Redis still threw NOAUTH on every call. Tried again to stop the NOAUTH error on every Redis call — no luck.',
+        context: 'Redis NOAUTH error on every call.',
+        severity: 'major', confidence: 0.2, recall_count: 0,
+        tags: ['redis', 'auth'], ts: daysAgo(5),
+    },
+    {
+        topic: 'redis:keys-no-ttl-memory-leak',
+        outcome: 'success',
+        what_worked: 'Redis memory grew unbounded because dependency-index and history keys had no TTL; adding a 90-day expire and an ltrim bounded the memory.',
+        context: 'Instance memory crept up over weeks of use.',
+        severity: 'major', confidence: 0.85, recall_count: 2,
+        tags: ['redis', 'ttl', 'memory'], ts: daysAgo(1),
+    },
+    // ── CI / build domain ──────────────────────────────────────────────────────
+    {
+        topic: 'ci:npm-ci-lockfile-mismatch',
+        outcome: 'success',
+        what_worked: 'CI "npm ci" failed because a dependency was added to package.json but the lockfile was never regenerated; running npm install to update package-lock.json fixed the build.',
+        context: 'GitHub Actions install step failed after adding a dep.',
+        severity: 'major', confidence: 0.91, recall_count: 5,
+        tags: ['ci', 'npm', 'lockfile'], ts: daysAgo(0),
+    },
+    {
+        topic: 'ci:golangci-lint-errcheck',
+        outcome: 'success',
+        what_worked: 'golangci-lint failed on an unchecked recover() return value; assigning it to _ satisfied errcheck.',
+        context: 'Go lint job blocked the deploy pipeline.',
+        severity: 'minor', confidence: 0.8, recall_count: 1,
+        tags: ['ci', 'go', 'lint'], ts: daysAgo(1),
+    },
+    // ── Frontend domain ────────────────────────────────────────────────────────
+    {
+        topic: 'frontend:cors-preflight-blocked',
+        outcome: 'success',
+        what_worked: 'Dashboard mutations failed because the CORS middleware did not allow PUT/PATCH; adding them to AllowMethods fixed the preflight.',
+        context: 'BYOK and webhook settings could not be saved from the browser.',
+        severity: 'major', confidence: 0.87, recall_count: 4,
+        tags: ['cors', 'frontend', 'api'], ts: daysAgo(6),
+    },
+    {
+        topic: 'frontend:hydration-mismatch',
+        outcome: 'partial',
+        what_worked: 'A Next.js hydration mismatch was reduced by guarding a date render with a client-only effect, though the root cause (locale formatting) still needs work.',
+        context: 'Console hydration warnings on the landing page.',
+        severity: 'minor', confidence: 0.6, recall_count: 1,
+        tags: ['nextjs', 'frontend', 'hydration'], ts: daysAgo(25),
+    },
+];
+export const BENCH_QUERIES = [
+    {
+        query: 'kubernetes deploy stuck rollout not finishing',
+        relevant: ['deploy:k8s:rollout-stuck'],
+    },
+    {
+        query: 'postgres too many connections under load',
+        relevant: ['db:postgres:connection-pool-exhausted'],
+    },
+    {
+        query: 'dashboard query is slow and times out',
+        relevant: ['db:postgres:slow-query-missing-index'],
+    },
+    {
+        query: 'jwt lost after restart recall count zero',
+        relevant: ['auth:jwt:expired-on-restart'],
+    },
+    {
+        query: 'keycloak rejects pkce token exchange on login',
+        relevant: ['auth:pkce:keycloak-rejects-exchange'],
+    },
+    {
+        query: 'redis noauth error on every call',
+        relevant: ['redis:noauth-on-every-call'],
+    },
+    {
+        query: 'redis memory keeps growing unbounded',
+        relevant: ['redis:keys-no-ttl-memory-leak'],
+    },
+    {
+        query: 'npm ci fails in github actions after adding dependency',
+        relevant: ['ci:npm-ci-lockfile-mismatch'],
+    },
+    {
+        query: 'cannot save settings cors preflight blocked',
+        relevant: ['frontend:cors-preflight-blocked'],
+    },
+    {
+        query: 'docker image too big slow ci push',
+        relevant: ['deploy:docker:image-too-large'],
+    },
+    {
+        query: 'go lint failing on unchecked return value',
+        relevant: ['ci:golangci-lint-errcheck'],
+    },
+    // Multi-relevant: both postgres performance lessons are reasonable answers.
+    {
+        query: 'postgres performance problem in production',
+        relevant: ['db:postgres:connection-pool-exhausted', 'db:postgres:slow-query-missing-index'],
+    },
+];
+//# sourceMappingURL=fixtures.js.map

package/dist/src/bench/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/bench/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/src/handlers/brain.js

@@ -3,20 +3,26 @@ import { calculateConfidence, confidenceBadge, STRUCTURED_TEMPLATES, CONFIDENCE_
 import { ckgSlug, extractProblemConcept, ckgUpsertNode, ckgUpdateEdge } from '../ckg.js';
 import { safeJsonParse } from '../utils.js';
 import { keywordSearch, tokenize, splitMultiQuery, levenshtein, indexVocab as _indexVocab } from '../search.js';
+import { rerankByQuality } from '../rerank.js';
 import { computeEmbedding, hasEmbedProvider } from '../embeddings.js';
 // ── Changelog (shown once per version in session_start) ──────────────────────
-const MCP_VERSION = '0.10.49';
+const MCP_VERSION = '0.10.50';
 const WHATS_NEW = {
-    '0.10.49': [
+    '0.10.50': [
         `🆕 **What's new in v${MCP_VERSION}:**`,
+        `  ✅ \`smart_recall\` — unified keyword + semantic hybrid list (one ranked result, not two sections)`,
+        `  ✅ \`smart_recall\` — "Brain saved you here" banner surfaces time saved inline per proven lesson`,
+        `  ✅ Quality reranking — proven successes outrank symptom-dense failures (+11% Precision@1)`,
+        `  ✅ Cachly-Bench — IR benchmark with CI regression guard (see BENCH.md for the proof)`,
+        `  🔧 Contradiction resolution now persisted to Redis (90-day TTL)`,
+        `  💡 Run \`smart_recall\` to see your Brain's recall quality in action`,
+    ],
+    '0.10.49': [
         `  ✅ \`brain_from_git\` — auto-seed your Brain from git history in seconds`,
         `  ✅ \`brain_predict_failures\` — predict CI/build failures before they happen`,
-        `  ✅ \`smart_recall\` — semantic + keyword hybrid recall, now in every CLAUDE.md`,
         `  ✅ VS Code extension — Brain status bar, ambient learning, CodeLens hints`,
         `  ✅ Team Brain — share lessons across your whole engineering team`,
-        `  ✅ 89 MCP tools — roadmap, A/B tests, cache, index, predict, syndicate`,
         `  🔧 Stability — auto-expiring memory keys, longer provisioning wait, robust recall`,
-        `  💡 Run \`brain_from_git\` to seed your Brain from existing commits instantly`,
     ],
 };
 export const BRAIN_TOOL_NAMES = new Set([
@@ -72,6 +78,19 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                             await ckgUpdateEdge(redis, cId, 'contradicts', resId, false);
                         }
                         catch { /* non-critical */ }
+                        // Persist a queryable resolution record — so contradiction history survives
+                        // (CKG edges alone aren't easily auditable). Bounded + TTL'd like other history.
+                        try {
+                            const resolutionKey = `cachly:contradictions:${topic}`;
+                            const direction = prev.outcome === 'success' && outcome === 'failure'
+                                ? 'kept-success' : 'overwrote-failure';
+                            await redis.rpush(resolutionKey, JSON.stringify({
+                                ts, prev_outcome: prev.outcome, new_outcome: outcome, direction,
+                            }));
+                            await redis.ltrim(resolutionKey, -50, -1);
+                            await redis.expire(resolutionKey, 180 * 86400);
+                        }
+                        catch { /* non-critical */ }
                         contradictionWarning.push(`🗳️ Run \`madc_deliberate(topic="${topic}")\` to resolve via expert agent voting.`);
                     }
                 }
@@ -411,9 +430,11 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             const { instance_id, query, threshold = 0.78, } = args;
             const redis = await getConnection(instance_id);
             // ── Layer 1: Keyword search across ALL brain data (always works, no embedding) ──
-            const kwMatches = await keywordSearch(redis, ['cachly:ctx:*', 'cachly:lesson:best:*', 'cachly:idx:*'], query, 10);
-            // Increment recall_count on matched lessons (fire-and-forget — same as recall_best_solution).
-            // This ensures the dashboard metric, Proven Laws, and trust badges reflect real smart_recall usage.
+            const rawMatches = await keywordSearch(redis, ['cachly:ctx:*', 'cachly:lesson:best:*', 'cachly:idx:*'], query, 10);
+            // ── Layer 1.5: Quality-aware rerank — proven success lessons outrank
+            // text-similar failed attempts (the moat; see src/rerank.ts + Cachly-Bench). ──
+            const kwMatches = rerankByQuality(rawMatches);
+            const savedHere = [];
             const lessonMatches = kwMatches.filter(m => m.key.startsWith('cachly:lesson:best:'));
             for (const m of lessonMatches.slice(0, 5)) {
                 const existing = await redis.get(m.key).catch(() => null);
@@ -422,41 +443,118 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                     if (lesson) {
                         const updated = { ...lesson, recall_count: (lesson.recall_count ?? 0) + 1, verified_at: new Date().toISOString() };
                         redis.set(m.key, JSON.stringify(updated)).catch(() => { });
-                        const savedMins = lesson.severity === 'critical' ? 240 : lesson.severity === 'major' ? 60 : 30;
+                        const sev = lesson.severity;
+                        const savedMins = sev === 'critical' ? 240 : sev === 'major' ? 60 : 30;
                         redis.incrbyfloat(`cachly:stats:time_saved_mins:${instance_id}`, savedMins).catch(() => { });
+                        // Surface banner for proven successes (recall_count >= 1 means it's been validated)
+                        if (lesson.outcome === 'success' && (lesson.recall_count ?? 0) >= 1) {
+                            savedHere.push({
+                                topic: m.key.replace('cachly:lesson:best:', ''),
+                                severity: sev ?? 'major',
+                                recall_count: (lesson.recall_count ?? 0) + 1,
+                                savedMins,
+                            });
+                        }
+                    }
+                }
+            }
+            // ── Layer 2: Semantic search (parallel, optional) ────────────────────────
+            const inst = await apiFetch(`/api/v1/instances/${instance_id}`);
+            const semHits = [];
+            if (inst.vector_token && hasEmbedProvider()) {
+                try {
+                    const embedding = await computeEmbedding(query);
+                    const vectorUrl = `https://api.cachly.dev/v1/sem/${inst.vector_token}`;
+                    const searchRes = await fetch(`${vectorUrl}/search`, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ embedding, namespace: 'cachly:ctx', threshold, top_k: 5 }),
+                    });
+                    if (searchRes.ok) {
+                        const results = (await searchRes.json());
+                        for (const hit of results.filter(r => r.found && r.id)) {
+                            const parts = hit.id.replace('ctx:', '').split(':');
+                            const category = parts[0];
+                            const key = parts.slice(1).join(':');
+                            const redisKey = `cachly:ctx:${category}:${key}`;
+                            const content = await redis.get(redisKey).catch(() => null);
+                            semHits.push({ key: redisKey, similarity: hit.similarity ?? 0, content: content ?? '(evicted)' });
+                        }
                     }
                 }
+                catch {
+                    // Semantic search failed silently — keyword results are enough
+                }
+            }
+            const bm25Scores = kwMatches.map(m => m.score);
+            const bm25Min = bm25Scores.length ? Math.min(...bm25Scores) : 0;
+            const bm25Range = bm25Scores.length ? (Math.max(...bm25Scores) - bm25Min) || 1 : 1;
+            const bm25Norm = (s) => (s - bm25Min) / bm25Range;
+            const hybridMap = new Map();
+            for (const m of kwMatches) {
+                const n = bm25Norm(m.score);
+                hybridMap.set(m.key, {
+                    key: m.key, content: m.content, bm25Score: n,
+                    hybridScore: n * (semHits.length > 0 ? 0.7 : 1.0),
+                    matchedWords: m.matchedWords, matchType: 'keyword', subQuery: m.subQuery,
+                });
+            }
+            for (const hit of semHits) {
+                const existing = hybridMap.get(hit.key);
+                if (existing) {
+                    existing.semScore = hit.similarity;
+                    existing.hybridScore = (existing.bm25Score ?? 0) * 0.6 + hit.similarity * 0.4;
+                    existing.matchType = 'hybrid';
+                }
+                else {
+                    hybridMap.set(hit.key, {
+                        key: hit.key, content: hit.content, semScore: hit.similarity,
+                        hybridScore: hit.similarity * 0.5, matchType: 'semantic',
+                    });
+                }
             }
+            const hybridResults = [...hybridMap.values()].sort((a, b) => b.hybridScore - a.hybridScore);
+            // ── Build output ──────────────────────────────────────────────────────────
             const lines = [`🧠 **Smart Recall** for: _"${query}"_\n`];
+            // "Brain saved you here" banner — surfaces value inline for proven recalled lessons
+            const SORDER = { critical: 0, major: 1, minor: 2 };
+            const topLesson = savedHere.sort((a, b) => (SORDER[a.severity] ?? 1) - (SORDER[b.severity] ?? 1))[0];
+            if (topLesson) {
+                lines.push(`> 💡 **Brain saved you ~${topLesson.savedMins}m here** — ${topLesson.severity} issue from \`${topLesson.topic}\` recalled ${topLesson.recall_count}× proven\n`);
+            }
             // Show sub-query info if multi-topic was detected
             const subQueries = splitMultiQuery(query);
             if (subQueries.length > 1) {
                 lines.push(`_Detected ${subQueries.length} sub-topics:_ ${subQueries.map((s, i) => `${i + 1}. "${s}"`).join(', ')}\n`);
             }
-            if (kwMatches.length > 0) {
-                lines.push(`### 🔍 BM25 Matches (${kwMatches.length})\n`);
-                // Group by sub-query if multi-topic
+            if (hybridResults.length > 0) {
+                const modeLabel = semHits.length > 0
+                    ? `keyword + semantic hybrid`
+                    : `keyword`;
+                lines.push(`### 🔍 Results (${hybridResults.length} — ${modeLabel})\n`);
+                // Group by sub-query for multi-topic queries
                 if (subQueries.length > 1) {
                     const grouped = new Map();
-                    for (const m of kwMatches.slice(0, 12)) {
-                        const sq = m.subQuery ?? query;
+                    for (const r of hybridResults.slice(0, 12)) {
+                        const sq = r.subQuery ?? query;
                         if (!grouped.has(sq))
                             grouped.set(sq, []);
-                        grouped.get(sq).push(m);
+                        grouped.get(sq).push(r);
                     }
-                    for (const [sq, matches] of grouped) {
-                        lines.push(`**Topic: "${sq}"** (${matches.length} results)\n`);
-                        for (const m of matches.slice(0, 4)) {
-                            const label = m.key
-                                .replace('cachly:ctx:', '📝 ')
-                                .replace('cachly:lesson:best:', '💡 ')
-                                .replace('cachly:idx:', '📂 ');
-                            const preview = m.content.slice(0, 300).replace(/\n/g, ' ');
-                            lines.push(`  **${label}** _(BM25: ${m.score.toFixed(2)}, matched: ${m.matchedWords.join(', ')})_`);
-                            lines.push(`  > ${preview}${m.content.length > 300 ? '…' : ''}\n`);
+                    for (const [sq, results] of grouped) {
+                        lines.push(`**Topic: "${sq}"** (${results.length} results)\n`);
+                        for (const r of results.slice(0, 4)) {
+                            const label = r.key.replace('cachly:ctx:', '📝 ').replace('cachly:lesson:best:', '💡 ').replace('cachly:idx:', '📂 ');
+                            const scorePart = r.matchType === 'hybrid'
+                                ? `BM25: ${(r.bm25Score ?? 0).toFixed(2)}, sem: ${((r.semScore ?? 0) * 100).toFixed(0)}%, 🔀 hybrid`
+                                : r.matchType === 'semantic'
+                                    ? `sem: ${((r.semScore ?? 0) * 100).toFixed(0)}%, 🎯 semantic`
+                                    : `BM25: ${(r.bm25Score ?? 0).toFixed(2)}, matched: ${r.matchedWords?.join(', ')}`;
+                            const preview = r.content.slice(0, 300).replace(/\n/g, ' ');
+                            lines.push(`  **${label}** _(${scorePart})_`);
+                            lines.push(`  > ${preview}${r.content.length > 300 ? '…' : ''}\n`);
                         }
                     }
-                    // Summary: which sub-queries had matches
                     const matched = [...grouped.keys()];
                     const unmatched = subQueries.filter(sq => !matched.includes(sq));
                     if (unmatched.length > 0) {
@@ -464,48 +562,20 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                     }
                 }
                 else {
-                    for (const m of kwMatches.slice(0, 8)) {
-                        const label = m.key
-                            .replace('cachly:ctx:', '📝 ')
-                            .replace('cachly:lesson:best:', '💡 ')
-                            .replace('cachly:idx:', '📂 ');
-                        const preview = m.content.slice(0, 400).replace(/\n/g, ' ');
-                        lines.push(`**${label}** _(BM25: ${m.score.toFixed(2)}, matched: ${m.matchedWords.join(', ')})_`);
-                        lines.push(`> ${preview}${m.content.length > 400 ? '…' : ''}\n`);
-                    }
-                }
-            }
-            // ── Layer 2: Semantic search (optional, only if embedding provider + vector_token available) ──
-            const inst = await apiFetch(`/api/v1/instances/${instance_id}`);
-            if (inst.vector_token && hasEmbedProvider()) {
-                try {
-                    const embedding = await computeEmbedding(query);
-                    const vectorUrl = `https://api.cachly.dev/v1/sem/${inst.vector_token}`;
-                    const searchRes = await fetch(`${vectorUrl}/search`, {
-                        method: 'POST',
-                        headers: { 'Content-Type': 'application/json' },
-                        body: JSON.stringify({ embedding, namespace: 'cachly:ctx', threshold, top_k: 5 }),
-                    });
-                    if (searchRes.ok) {
-                        const results = (await searchRes.json());
-                        const semHits = results.filter(r => r.found && r.id);
-                        if (semHits.length > 0) {
-                            lines.push(`\n### 🎯 Semantic Matches (${semHits.length})\n`);
-                            for (const hit of semHits) {
-                                const parts = hit.id.replace('ctx:', '').split(':');
-                                const category = parts[0];
-                                const key = parts.slice(1).join(':');
-                                const content = await redis.get(`cachly:ctx:${category}:${key}`);
-                                lines.push(`**${key}** _(${((hit.similarity ?? 0) * 100).toFixed(0)}% similar)_`, `> ${content?.slice(0, 300) ?? '(evicted)'}${(content?.length ?? 0) > 300 ? '…' : ''}\n`);
-                            }
-                        }
+                    for (const r of hybridResults.slice(0, 8)) {
+                        const label = r.key.replace('cachly:ctx:', '📝 ').replace('cachly:lesson:best:', '💡 ').replace('cachly:idx:', '📂 ');
+                        const scorePart = r.matchType === 'hybrid'
+                            ? `BM25: ${(r.bm25Score ?? 0).toFixed(2)}, sem: ${((r.semScore ?? 0) * 100).toFixed(0)}%, 🔀 hybrid`
+                            : r.matchType === 'semantic'
+                                ? `sem: ${((r.semScore ?? 0) * 100).toFixed(0)}%, 🎯 semantic`
+                                : `BM25: ${(r.bm25Score ?? 0).toFixed(2)}, matched: ${r.matchedWords?.join(', ')}`;
+                        const preview = r.content.slice(0, 400).replace(/\n/g, ' ');
+                        lines.push(`**${label}** _(${scorePart})_`);
+                        lines.push(`> ${preview}${r.content.length > 400 ? '…' : ''}\n`);
                     }
                 }
-                catch {
-                    // Semantic search failed silently — keyword results are enough
-                }
             }
-            if (kwMatches.length === 0) {
+            else {
                 lines.push(`⚠️ No matches found for: "${query}"`);
                 // Did-You-Mean: find nearest token in index vocab
                 const queryTokens = tokenize(query);