@cachly-dev/mcp-server 0.10.91 → 0.10.93

package/README.md

@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/badge/GDPR-EU%20servers-green" alt="GDPR: EU servers" />
   </a>
   &nbsp;
-  <img src="https://img.shields.io/badge/114%20MCP%20tools-violet" alt="114 MCP tools" />
+  <img src="https://img.shields.io/badge/115%20MCP%20tools-violet" alt="115 MCP tools" />
   &nbsp;
   <img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
 </p>
@@ -244,7 +244,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 
 ---
 
-## MCP Tools (114 total)
+## MCP Tools (115 total)
 
 ### 🧠 Session & Memory (most used)
 

package/dist/src/handlers/brain.js

@@ -7,21 +7,34 @@ import { keywordSearch, tokenize, splitMultiQuery, levenshtein, indexVocab as _i
 import { rerankByQuality } from '../rerank.js';
 import { computeEmbedding, hasEmbedProvider } from '../embeddings.js';
 // ── Changelog (shown once per version in session_start) ──────────────────────
-const MCP_VERSION = '0.10.91';
+const MCP_VERSION = '0.10.93';
 const WHATS_NEW = {
+    '0.10.93': [
+        `🗺️ **\`brain_plan\` — your Brain goes from "what did we learn?" to "what should I do?"**`,
+        `  🧭 Give it a task you're about to start ("upgrade Postgres 14→16") and it returns an ordered, grounded action plan: ranked failure modes to avoid, proven fix steps (dependency-aware, with commands), and a pre-flight checklist — all from your own lessons`,
+        `  🔬 Generative layer on the CKG: where \`brain_predict\` answers "what might fail?", \`brain_plan\` answers "what, in what order?"`,
+        `  📊 115 MCP tools (new: \`brain_plan\`)`,
+    ],
+    '0.10.92': [
+        `👋 **Welcome-back digest — re-entry after a week away now leads with what changed**`,
+        `  🌱 \`session_start\` detects a gap ≥ 7 days and surfaces how many lessons your Brain gained while you were gone (git, CI & teammates kept it learning), with the freshest topics`,
+        `  🧠 Zero extra latency — the digest is computed from data session_start already loads`,
+        `  🔌 New gRPC \`Learn\` RPC (M2M write path) — agents & CI can now teach the Brain directly, byte-compatible with the MCP lesson format`,
+        `  📊 115 MCP tools`,
+    ],
     '0.10.91': [
         `🕐 **Lesson-anchored time attribution — every recall shows when it was learned and how much it saves**`,
         `  💡 "Brain saved you" banner now includes: when the lesson was learned (e.g. "12 May"), estimated original debug cost by severity (critical=2h, major=1h, minor=20min), and team attribution when a teammate's lesson fires`,
         `  📅 Origin date formatted as "12 May" (same year) or "12 May 2024" (different year) — no clutter`,
         `  👥 Cross-author recalls now show "@author" on the same banner line — the "team knowledge reuse" value is front-and-center`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.90': [
         `📊 **External benchmark corpus v2 — the proof is now statistically solid**`,
         `  🧪 Expanded from 8 queries → 61 lessons / 56 queries across 10 real-world engineering domains (k8s, DB, auth, CI, frontend, API, payments, observability, network, Node.js, security, infra)`,
         `  ⚔️  10 adversarial distractors added — failure lessons that share the exact same vocabulary as the query, forcing the quality reranker to earn its lift`,
         `  📈 Results on the larger corpus: cachly +2.9% Precision@1 vs flat-file, +12.5% vs raw BM25 baseline — on a harder dataset, not an easy one`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.89': [
         `⚡ **One-command onboarding — \`autopilot\` is now the single canonical setup**`,
@@ -29,14 +42,14 @@ const WHATS_NEW = {
         `  🧹 Retired the split-brain instructions (legacy \`@cachly-dev/init\` wrapper + the old "three steps") so there's exactly one thing to copy-paste`,
         `  🔧 Fixed a build-breaking duplicate \`export\` on buildClaudeMdBlock that failed CI on v0.10.88`,
         `  🔢 Version hygiene — package.json, server.json, lockfile and MCP_VERSION resynced (server.json/lockfile were stuck at 0.10.85)`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.88': [
         `✅ **Honest setup + tested config writer (v0.10.88)**`,
         `  🔒 setup/autopilot now report the truth: if no editor config could be written it exits non-zero with the exact failures instead of falsely claiming "Brain is ready"`,
         `  📊 New setup_config_write_failed telemetry — permission/path failures that block activation are now visible in reporting`,
         `  🧪 24 new unit tests for the config writer (buildServerEnv, buildMcpConfig, mergeMcpConfig, buildClaudeMdBlock) — the merge logic that must never clobber your other MCP servers is now regression-guarded`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.87': [
         `🌐 **Multi-editor auth persistence + full activation telemetry (v0.10.87)**`,
@@ -46,7 +59,7 @@ const WHATS_NEW = {
         `  📡 \`brain_from_git_failed\` fires with error reason when auto-bootstrap throws — no more empty brain with no explanation`,
         `  ✨ Git bootstrap shows lesson count in session_start: "Brain bootstrapped — 23 lessons loaded" — the WOW moment`,
         `  🔧 API: McpEvent stores brain quality metrics (fixes/features/refactors/total) — git learning quality now measurable`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.86': [
         `🛡️ **Zero-friction activation — your Brain self-heals into existence**`,
@@ -54,7 +67,7 @@ const WHATS_NEW = {
         `  🤝 Parallel tool calls on startup are coalesced into one resolve (no more duplicate-instance races)`,
         `  💬 Clearer "instance still starting" message — leads with "just retry", no manual config needed`,
         `  📈 New activation-funnel telemetry: install → sign-in → provision, so silent churn is visible`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.85': [
         `🚀 **One-command onboarding — \`npx @cachly-dev/mcp-server@latest autopilot\`**`,
@@ -65,7 +78,7 @@ const WHATS_NEW = {
     '0.10.84': [
         `🤖 **M2M & agent-ecosystem reach — cachly for every caller, human or machine**`,
         `  🔑 OAuth2 \`client_credentials\` grant — set CACHLY_CLIENT_ID + CACHLY_CLIENT_SECRET for fully headless auth (CI, agents, AI-to-AI)`,
-        `  🗂️ \`npx ... tool-specs --format=openai|anthropic|langchain\` — export all 114 tools in any framework's dialect`,
+        `  🗂️ \`npx ... tool-specs --format=openai|anthropic|langchain\` — export all 115 tools in any framework's dialect`,
         `  🌐 \`npx ... openapi\` — OpenAPI 3.1 doc (1 POST path per tool) for Assistants / codegen / Postman`,
         `  🧪 14 new tests: client_credentials helpers, all four spec dialects, OpenAPI required-body inference`,
     ],
@@ -76,7 +89,7 @@ const WHATS_NEW = {
         `  🖥️ Consumed verbatim by the 3D frontend (react-force-graph-3d / three.js) — the visual brain map`,
         `  🔎 Filters: \`domain\`, \`min_confidence\`, \`max_nodes\` (with truncation flag), \`format="summary"\``,
         `  🧪 10 tests: kind detection, dangling-edge pruning, confidence/domain filters, schema contract`,
-        `  📊 114 MCP tools`,
+        `  📊 115 MCP tools`,
     ],
     '0.10.82': [
         `📡 **Telemetry API contracts — dashboard ingest pipeline prepared**`,
@@ -1166,6 +1179,32 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 const timeStr = h > 0 ? `${h}h${m > 0 ? ` ${m}m` : ''}` : `${m}m`;
                 lines.push(`⏱️ **Brain saved you ~${timeStr} total** (time not re-researching known fixes)`, '');
             }
+            // ── Welcome-back digest (gap ≥ 7 days) ──────────────────────────────────
+            // When the user has been away a week or more, lead with a short "what
+            // happened while you were gone" digest. All data is already loaded above
+            // (lastSession + lessons), so this adds zero Redis round-trips. The point
+            // is re-entry value: the brain kept compounding (git/CI/teammates) and we
+            // surface the growth before anything else competes for attention.
+            if (lastSession?.ts) {
+                const lastTs = new Date(lastSession.ts).getTime();
+                const daysAway = Math.floor((Date.now() - lastTs) / 86_400_000);
+                if (daysAway >= 7 && !Number.isNaN(lastTs)) {
+                    const newSinceAway = lessons.filter(l => {
+                        const t = new Date(l.ts).getTime();
+                        return !Number.isNaN(t) && t > lastTs;
+                    });
+                    lines.push(`👋 **Welcome back** — it's been ${daysAway} days since your last session.`);
+                    if (newSinceAway.length > 0) {
+                        // lessons is already recency-sorted desc, so take the freshest few.
+                        const topNew = newSinceAway.slice(0, 3).map(l => `\`${l.topic}\``).join(', ');
+                        lines.push(`   🌱 Your Brain grew by **${newSinceAway.length} lesson${newSinceAway.length !== 1 ? 's' : ''}** while you were gone (git, CI & teammates kept it learning): ${topNew}${newSinceAway.length > 3 ? ', …' : ''}`);
+                    }
+                    else {
+                        lines.push(`   🧠 ${lessons.length} lesson${lessons.length !== 1 ? 's' : ''} held steady and ready — recall anything with \`smart_recall\`.`);
+                    }
+                    lines.push(`   💡 Full breakdown: \`npx @cachly-dev/mcp-server@latest digest\``, '');
+                }
+            }
             // ── What's New (shown once per version update) ──────────────────────────
             try {
                 const seenVersion = await redis.get('cachly:mcp:version:last_seen');