@cachly-dev/mcp-server 0.10.26 → 0.10.40

package/dist/handlers/brain.js

@@ -5,13 +5,15 @@ import { safeJsonParse } from '../utils.js';
 import { keywordSearch, tokenize, splitMultiQuery, levenshtein, indexVocab as _indexVocab } from '../search.js';
 import { computeEmbedding, hasEmbedProvider } from '../embeddings.js';
 // ── Changelog (shown once per version in session_start) ──────────────────────
-const MCP_VERSION = '0.10.10';
+const MCP_VERSION = '0.10.0';
 const WHATS_NEW = {
-    '0.10.10': [
+    '0.10.0': [
         `🆕 **What's new in v${MCP_VERSION}:**`,
-        `  📌 **pin_lesson / unpin_lesson** — Pin critical lessons to always show in session_start`,
-        `  📊 **brain_stats** — At-a-glance health dashboard (lessons, streak, roadmap, pinned, top topics)`,
-        `  ✅ Pinned lessons appear at top of every session briefing — never decay, never forgotten`,
+        `  ✅ Zero-friction setup — auto-provisions your Brain, no manual config needed`,
+        `  ✅ 10× faster briefings — batch Redis fetches replace per-key loops`,
+        `  ✅ Crash-proof data reads — corrupted cache entries no longer break tools`,
+        `  ✅ \`session_end\` warns when called without an active session`,
+        `  ✅ \`get_api_status\` now shows live Redis ping + all instance statuses`,
     ],
 };
 export const BRAIN_TOOL_NAMES = new Set([
@@ -270,20 +272,6 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 }
             }
             catch { /* CKG updates are non-critical */ }
-            // ── Auto-pin critical lessons ──────────────────────────────────────────
-            // severity=critical → always pin automatically so the lesson
-            // appears in every session_start without the user ever calling pin_lesson.
-            let autoPinNote = '';
-            if (severity === 'critical' && (outcome === 'success' || outcome === 'partial')) {
-                try {
-                    const alreadyPinned = await redis.exists(`cachly:lesson:pin:${topic}`);
-                    if (!alreadyPinned) {
-                        await redis.set(`cachly:lesson:pin:${topic}`, '1');
-                        autoPinNote = `📌 Auto-pinned (critical severity) — will appear in every session_start.`;
-                    }
-                }
-                catch { /* non-critical */ }
-            }
             const emoji = outcome === 'success' ? '✅' : outcome === 'partial' ? '⚠️' : '❌';
             const sevEmoji = severity === 'critical' ? '🔴' : severity === 'major' ? '🟡' : '🟢';
             const action = isUpdate ? 'updated' : 'stored';
@@ -304,7 +292,6 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 depends_on.length > 0
                     ? `🔗 Depends on: ${depends_on.map(d => `\`${d}\``).join(', ')} → trace with \`trace_dependency\``
                     : '',
-                autoPinNote,
                 ...templateWarnings,
                 ...iWasWrongWarning,
             ].filter(l => l !== '').join('\n');
@@ -636,19 +623,70 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             const isFirstSession = !lastSession && lessons.length === 0 && ctxCount === 0;
             if (isFirstSession) {
                 lines.push('🎉 **Welcome! Your AI Brain is live.**', '');
-                lines.push('It learns from your work automatically. After your first session it will look like this:', '');
-                lines.push('  ✅ `api:auth` — Bearer token in header, not cookie; 401 on missing scope');
-                lines.push('  ✅ `database:migrations` — always run migrations before deploy');
-                lines.push('  ⚠️ `docker:build` — ARG changes bust all subsequent cache layers');
-                lines.push('');
-                lines.push('**3 steps to grow your brain:**');
-                lines.push('  1. Fix something → `learn_from_attempts(topic="bug:name", outcome="success", what_worked="...")`');
-                lines.push('  2. Save context → `remember_context(key="arch", value="...")`');
-                lines.push('  3. End session → `session_end(summary="What I did")`');
+                if (workspace_path) {
+                    lines.push(`🚀 **Auto-bootstrapping from your git history...** (this takes a few seconds)`);
+                    lines.push(`   Your brain will learn from your recent commits — no setup needed.`, '');
+                }
+                else {
+                    lines.push('It learns from your work automatically. After your first session it will look like this:', '');
+                    lines.push('  ✅ `api:auth` — Bearer token in header, not cookie; 401 on missing scope');
+                    lines.push('  ✅ `database:migrations` — always run migrations before deploy');
+                    lines.push('  ⚠️ `docker:build` — ARG changes bust all subsequent cache layers');
+                    lines.push('');
+                    lines.push('**Tip:** Pass `workspace_path` to `session_start` to auto-learn from git history instantly.');
+                    lines.push('');
+                }
+                lines.push('**Your brain grows automatically:**');
+                lines.push('  • End each session → `session_end(summary="What I did")` — auto-learns from git commits');
+                lines.push('  • After fixing bugs → `learn_from_attempts(topic="...", outcome="success", what_worked="...")`');
                 lines.push('');
-                lines.push('💡 Run `brain_doctor` for a setup health-check and personalised tips.');
+                lines.push('💡 Run `brain_doctor` for a health-check and personalised tips.');
                 lines.push('');
             }
+            // ── Team-virality: first-team-briefing wow moment ────────────────────
+            // When a user joins a team brain (has team lessons from colleagues but
+            // has never been briefed on them), show a dedicated "Welcome to your
+            // team's brain" section. Only fires once per user.
+            if (author && !isFirstSession) {
+                try {
+                    const briefingKey = `cachly:team:first_briefing:${author}`;
+                    const alreadyBriefed = await redis.get(briefingKey);
+                    if (!alreadyBriefed) {
+                        const teamLessons = lessons.filter(l => l.author && l.author !== author);
+                        if (teamLessons.length > 0) {
+                            // Mark briefed so this only fires once
+                            await redis.set(briefingKey, '1', 'EX', 365 * 86400);
+                            const byAuthor = new Map();
+                            for (const l of teamLessons) {
+                                const a = l.author;
+                                if (!byAuthor.has(a))
+                                    byAuthor.set(a, []);
+                                byAuthor.get(a).push(l);
+                            }
+                            lines.push('');
+                            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                            lines.push('🤝 **Your team\'s AI brain has been briefing you.**');
+                            lines.push('');
+                            lines.push(`Your teammates have already solved problems you\'re about to hit:`);
+                            lines.push('');
+                            for (const [teamAuthor, tls] of byAuthor) {
+                                lines.push(`  👤 **${teamAuthor}** fixed ${tls.length} thing${tls.length > 1 ? 's' : ''}:`);
+                                for (const l of tls.slice(0, 2)) {
+                                    const emoji = l.outcome === 'success' ? '✅' : '⚠️';
+                                    lines.push(`    ${emoji} \`${l.topic}\` — ${l.what_worked.slice(0, 90)}`);
+                                }
+                                if (tls.length > 2)
+                                    lines.push(`    … and ${tls.length - 2} more lessons`);
+                            }
+                            lines.push('');
+                            lines.push(`💡 Use \`team_learn\` after your next fix to pay it forward.`);
+                            lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                            lines.push('');
+                        }
+                    }
+                }
+                catch { /* team briefing errors must never break session_start */ }
+            }
             // Handoff from previous window (if any)
             const handoffRaw = await redis.get('cachly:session:handoff');
             if (handoffRaw) {
@@ -831,47 +869,34 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 }
                 lines.push('');
             }
-            // ── Pinned lessons — always shown regardless of age/confidence ───────────
-            try {
-                const pinKeys = [];
-                const pinStream = redis.scanStream({ match: 'cachly:lesson:pin:*', count: 100 });
-                await new Promise((res, rej) => {
-                    pinStream.on('data', (b) => pinKeys.push(...b));
-                    pinStream.on('end', res);
-                    pinStream.on('error', rej);
-                });
-                if (pinKeys.length > 0) {
-                    const pinnedTopics = pinKeys.map(k => k.replace('cachly:lesson:pin:', ''));
-                    const pinLessonRaws = await redis.mget(...pinnedTopics.map(t => `cachly:lesson:best:${t}`));
-                    const pinLines = [];
-                    for (const raw of pinLessonRaws) {
-                        if (!raw)
-                            continue;
-                        const l = safeJsonParse(raw, null);
-                        if (!l)
-                            continue;
+            // Top lessons — sorted by recall_count desc (most-used = most proven value).
+            // If focus is set, focus-matched lessons already shown above; show remaining here.
+            if (lessons.length > 0) {
+                const byRecall = [...lessons].sort((a, b) => (b.recall_count ?? 0) - (a.recall_count ?? 0));
+                const topRecalled = byRecall.filter(l => (l.recall_count ?? 0) > 0).slice(0, 3);
+                const remaining = (focusLessons.length > 0 ? lessons.filter(l => !focusLessons.includes(l)) : lessons)
+                    .filter(l => !topRecalled.includes(l))
+                    .slice(0, focusLessons.length > 0 ? 3 : 4);
+                if (topRecalled.length > 0) {
+                    lines.push(`🏆 **Most valuable** (recalled ${topRecalled[0].recall_count}× before):`);
+                    for (const l of topRecalled) {
                         const emoji = l.outcome === 'success' ? '✅' : l.outcome === 'partial' ? '⚠️' : '❌';
                         const sev = l.severity === 'critical' ? '🔴' : l.severity === 'major' ? '🟡' : '';
-                        pinLines.push(`  📌${emoji}${sev} \`${l.topic}\` — ${l.what_worked.slice(0, 100)}`);
-                    }
-                    if (pinLines.length > 0) {
-                        lines.push(`📌 **Pinned lessons (always shown):**`);
-                        lines.push(...pinLines);
-                        lines.push('');
+                        const rct = l.recall_count && l.recall_count > 1 ? ` _(${l.recall_count}× recalled)_` : '';
+                        lines.push(`  ${emoji}${sev} \`${l.topic}\`${rct} — ${l.what_worked.slice(0, 100)}`);
                     }
+                    lines.push('');
                 }
-            }
-            catch { /* non-critical */ }
-            // Recent lessons
-            if (lessons.length > 0) {
-                lines.push(`🕐 **Recent lessons:**`);
-                const toShow = focusLessons.length > 0 ? lessons.filter(l => !focusLessons.includes(l)).slice(0, 4) : lessons.slice(0, 5);
-                for (const l of toShow) {
-                    const emoji = l.outcome === 'success' ? '✅' : l.outcome === 'partial' ? '⚠️' : '❌';
-                    const sev = l.severity === 'critical' ? '🔴' : l.severity === 'major' ? '🟡' : '';
-                    lines.push(`  ${emoji}${sev} \`${l.topic}\` — ${l.what_worked.slice(0, 90)}`);
+                if (remaining.length > 0) {
+                    const header = topRecalled.length > 0 ? `🕐 **Recent:**` : `🕐 **Recent lessons:**`;
+                    lines.push(header);
+                    for (const l of remaining) {
+                        const emoji = l.outcome === 'success' ? '✅' : l.outcome === 'partial' ? '⚠️' : '❌';
+                        const sev = l.severity === 'critical' ? '🔴' : l.severity === 'major' ? '🟡' : '';
+                        lines.push(`  ${emoji}${sev} \`${l.topic}\` — ${l.what_worked.slice(0, 100)}`);
+                    }
+                    lines.push('');
                 }
-                lines.push('');
             }
             else {
                 lines.push('📭 No lessons yet. Use `learn_from_attempts` after solving tasks.', '');
@@ -1328,21 +1353,33 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 catch { /* git not available or not a repo — silent skip */ }
             }
             const durationStr = durationMin !== undefined ? ` · ${durationMin} min` : '';
-            // ── Mini brain-stats snapshot at session end ───────────────────────────
-            let miniStatsLines = [];
-            try {
-                const totalLessons = await redis.keys('cachly:lesson:best:*').then(k => k.length).catch(() => 0);
-                const pinCount = await redis.keys('cachly:lesson:pin:*').then(k => k.length).catch(() => 0);
-                const streakRaw = await redis.get('cachly:streak:current');
-                const streak = streakRaw ? JSON.parse(streakRaw).days : 0;
-                const parts = [`📚 ${totalLessons} lesson${totalLessons !== 1 ? 's' : ''} total`];
-                if (pinCount > 0)
-                    parts.push(`📌 ${pinCount} pinned`);
-                if (streak > 1)
-                    parts.push(`🔥 ${streak}-day streak`);
-                miniStatsLines = [`🧠 **Brain:** ${parts.join(' · ')}`];
-            }
-            catch { /* non-critical */ }
+            const totalAutoLearned = autoLearned.length + ambientLearned.length;
+            // ── Shareable Session Summary Card ────────────────────────────────────────
+            // Generated after each session so the user can share their progress.
+            const tweetLines = [];
+            if (durationMin !== undefined && durationMin > 0)
+                tweetLines.push(`⏱ ${durationMin} min session`);
+            if (totalAutoLearned > 0)
+                tweetLines.push(`🧠 ${totalAutoLearned} lessons saved to Brain`);
+            if (files_changed.length > 0)
+                tweetLines.push(`📁 ${files_changed.length} file${files_changed.length > 1 ? 's' : ''} changed`);
+            const tweetBody = tweetLines.length > 0
+                ? `${tweetLines.join(' · ')}\n\nMy AI Brain remembers this so I never repeat it. @cachlydev\ncachly.dev`
+                : `Session saved to my AI Brain. No more re-explaining this tomorrow. @cachlydev\ncachly.dev`;
+            const tweetURL = `https://twitter.com/intent/tweet?text=${encodeURIComponent(tweetBody)}`;
+            const sessionCard = [
+                ``,
+                `┌─────────────────────────────────────────────┐`,
+                `│  🧠 Session Summary Card                    │`,
+                `│  Share your progress — cached forever       │`,
+                `├─────────────────────────────────────────────┤`,
+                durationMin !== undefined ? `│  ⏱  Duration   : ${String(durationMin + ' min').padEnd(26)}│` : '',
+                totalAutoLearned > 0 ? `│  📚 Learned    : ${String(totalAutoLearned + ' lessons').padEnd(26)}│` : '',
+                files_changed.length > 0 ? `│  📁 Changed    : ${String(files_changed.length + ' file' + (files_changed.length > 1 ? 's' : '')).padEnd(26)}│` : '',
+                `├─────────────────────────────────────────────┤`,
+                `│  📣 Share: ${tweetURL.slice(0, 34).padEnd(34)}│`,
+                `└─────────────────────────────────────────────┘`,
+            ].filter(l => l !== '').join('\n');
             return [
                 `✅ **Session saved**${durationStr}`,
                 ``,
@@ -1351,7 +1388,7 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 lessons_learned !== undefined ? `🧠 **Lessons stored:** ${lessons_learned}` : '',
                 autoLearned.length > 0 ? `🤖 **Auto-learned:** ${autoLearned.length} lessons extracted from summary (${autoLearned.slice(0, 3).map(t => `\`${t}\``).join(', ')}${autoLearned.length > 3 ? '…' : ''})` : '',
                 ambientLearned.length > 0 ? `🌿 **Ambient git learning:** ${ambientLearned.length} commit${ambientLearned.length > 1 ? 's' : ''} auto-learned (${ambientLearned.slice(0, 3).map(t => `\`${t}\``).join(', ')}${ambientLearned.length > 3 ? '…' : ''})` : '',
-                ...miniStatsLines,
+                sessionCard,
                 ``,
                 `💡 Next session: \`session_start(focus="...")\` to see this summary.`,
             ].filter(l => l !== '').join('\n');