@cachly-dev/mcp-server 0.10.93 → 0.10.95

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/115%20MCP%20tools-violet" alt="115 MCP tools" />
+  <img src="https://img.shields.io/badge/118%20MCP%20tools-violet" alt="118 MCP tools" />
   &nbsp;
   <img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
 </p>
@@ -190,6 +190,7 @@ close without breaking its own lock-in. **That gap is where cachly wins.**
 | **`brain_who_knows`** | *"Who on my team knows about Kubernetes deploys?"* → ranked experts 🥇🥈🥉, built automatically from authorship. |
 | **`brain_file_map`** | Before you touch a file: who's worked on it and which lessons reference it. |
 | **`team_expertise_map`** | The whole team's skills matrix in one table — onboarding and bus-factor insurance. |
+| **`brain_collab_pairs`** | Person↔Person Collaboration Graph — *"Frag X und Y, die haben das zusammen gelöst."* Bus-factor alerts included. |
 | **`brain_from_git`** | Reads your entire git history and populates the team knowledge graph (people + files + lessons) — zero setup, retroactively. |
 | **`brain_coverage` / `skill_gaps`** | A 0–100 health score for your knowledge + a ranked list of blind spots to fix. |
 | **`brain_predict`** | Predicts likely failures *before* they happen, from past incident patterns. |
@@ -244,7 +245,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 
 ---
 
-## MCP Tools (115 total)
+## MCP Tools (118 total)
 
 ### 🧠 Session & Memory (most used)
 
@@ -267,6 +268,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 | **`brain_who_knows`** | Find your team's experts on any topic — ranked 🥇🥈🥉 |
 | **`brain_file_map`** | Experts + lessons per file, before you touch it |
 | **`team_expertise_map`** | Full team skills matrix in one table |
+| **`brain_collab_pairs`** | Person↔Person Collaboration Graph — who collaborates with whom, bus-factor alerts |
 | **`skill_gaps`** | Knowledge blind spots: unresolved failures, missing attribution |
 | **`brain_coverage`** | 0–100 knowledge-health score for your codebase |
 | `madc_deliberate` | Specialist AI agents vote to resolve contradictory lessons |
@@ -297,6 +299,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 | Tool | What it does |
 |------|-------------|
 | `syndicate` / `fedbrain_search` | Contribute to / search the global Knowledge Commons |
+| `brain_marketplace` / `brain_install` | Browse + install curated Domain Brains (Kubernetes, Auth, DB…) into your Brain |
 | `cache_get` / `cache_set` / `semantic_search` / `index_project` | Cache + semantic ops |
 | `list_instances` / `create_instance` / `delete_instance` | Manage Brain instances |
 | `roadmap_add` / `roadmap_next` | Persistent project roadmap stored in the Brain |

package/dist/src/handlers/brain.js

@@ -7,8 +7,23 @@ 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.93';
+const MCP_VERSION = '0.10.95';
 const WHATS_NEW = {
+    '0.10.95': [
+        `🧠 **Domain Brain Marketplace (W10) — bootstrap your Brain with curated community knowledge**`,
+        `  🛒 \`brain_marketplace()\` — browse installable packs of high-trust lessons by domain: ☸️ Kubernetes, 🔐 Auth, 🗄️ Database, ⚛️ React, 💳 Payments & more`,
+        `  📦 \`brain_install(slug="k8s")\` — merges a domain's verified lessons into your Brain; live in \`smart_recall\` instantly, even offline`,
+        `  🛡️ Idempotent + non-destructive: installed lessons are tagged \`source:"marketplace:<slug>"\` and NEVER override your own`,
+        `  🔌 New gRPC \`Subscribe\` RPC — agents get new lessons streamed live the moment they're learned (completes the M2M loop with \`Learn\`)`,
+        `  📊 118 MCP tools (new: \`brain_marketplace\`, \`brain_install\`)`,
+    ],
+    '0.10.94': [
+        `🤝 **Person↔Person Collaboration Graph (W5) — "Frag X und Y, die haben das zusammen gelöst"**`,
+        `  🕸️ New \`brain_collab_pairs()\` tool: shows every contributor pair who've touched the same files or recalled each other's lessons — ideal for onboarding and bus-factor analysis`,
+        `  📡 \`smart_recall\` now wires CKG \`collaborates\` edges live when cross-author reuse fires — collaboration graph grows with every team recall`,
+        `  ⚠️ Bus-factor section: flags solo contributors whose knowledge no teammate has yet recalled`,
+        `  📊 116 MCP tools (new: \`brain_collab_pairs\`)`,
+    ],
     '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`,
@@ -78,7 +93,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 115 tools in any framework's dialect`,
+        `  🗂️ \`npx ... tool-specs --format=openai|anthropic|langchain\` — export all 118 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`,
     ],
@@ -773,6 +788,12 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                             crossAuthorThisCall++;
                             redis.incr(`cachly:stats:cross_author_recalls:${instance_id}`).catch(() => { });
                             redis.sadd(`cachly:stats:reuse_pairs:${instance_id}`, `${requester}<-${lesson.author}`).catch(() => { });
+                            // W5: wire person↔person CKG collaborates edges from knowledge-reuse events.
+                            // This feeds brain_collab_pairs and enriches brain_who_knows with reuse-based edges.
+                            const reqPersonId = `person:${ckgSlug(requester)}`;
+                            const authPersonId = `person:${ckgSlug(lesson.author)}`;
+                            ckgUpdateEdge(redis, reqPersonId, 'collaborates', authPersonId, true).catch(() => { });
+                            ckgUpdateEdge(redis, authPersonId, 'collaborates', reqPersonId, true).catch(() => { });
                         }
                         // Surface banner for proven successes (recall_count >= 1 means it's been validated)
                         if (lesson.outcome === 'success' && (lesson.recall_count ?? 0) >= 1) {
@@ -2796,6 +2817,100 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             lines.push(`---`, `_Tag lessons with \`service="${service}"\` to keep this map current. For infra, pass \`service_kind="system"\`._`);
             return lines.join('\n');
         }
+        // ── brain_collab_pairs ───────────────────────────────────────────────────
+        // W5: Person↔Person Collaboration Graph. Shows who works with whom on the
+        // team — built from (a) shared file-touches during learn_from_attempts and
+        // (b) cross-author knowledge-reuse events from smart_recall. Answers the
+        // onboarding question: "Frag X und Y — they solved that together."
+        case 'brain_collab_pairs': {
+            const { instance_id, min_weight = 1 } = args;
+            const redis = await getConnection(instance_id);
+            const minW = typeof min_weight === 'number' && min_weight >= 1 ? Math.floor(min_weight) : 1;
+            // Collect all person nodes.
+            const personKeys = await scanKeys(redis, 'cachly:ckg:node:person:*', { max: 500 });
+            const persons = new Map();
+            for (const k of personKeys) {
+                const raw = await redis.get(k);
+                if (!raw)
+                    continue;
+                const pn = safeJsonParse(raw, null);
+                if (!pn || pn.type !== 'person')
+                    continue;
+                persons.set(pn.id, { id: pn.id, handle: pn.handle, domain: pn.domain, count: pn.count });
+            }
+            if (persons.size === 0) {
+                return [
+                    `## 🤝 Team Collaboration Graph`,
+                    ``,
+                    `No contributors found yet.`,
+                    ``,
+                    `The graph builds automatically as teammates store lessons with \`author="name"\`:`,
+                    `\`learn_from_attempts(topic="...", author="alice", file_paths=["src/auth.ts"], ...)\``,
+                ].join('\n');
+            }
+            const pairMap = new Map();
+            for (const [personId, pInfo] of persons) {
+                const edgeKeys = await redis.smembers(`cachly:ckg:idx:from:${personId}`);
+                for (const ek of edgeKeys) {
+                    const er = await redis.get(ek);
+                    if (!er)
+                        continue;
+                    const edge = safeJsonParse(er, null);
+                    if (!edge || edge.edgeType !== 'collaborates')
+                        continue;
+                    const otherInfo = persons.get(edge.to);
+                    if (!otherInfo)
+                        continue;
+                    // Canonical pair key: alphabetically smaller id first.
+                    const [idA, idB] = personId < edge.to ? [personId, edge.to] : [edge.to, personId];
+                    const pairKey = `${idA}||${idB}`;
+                    const existing = pairMap.get(pairKey);
+                    if (existing) {
+                        existing.trials += edge.trials;
+                    }
+                    else {
+                        const [pA, pB] = personId < edge.to ? [pInfo, otherInfo] : [otherInfo, pInfo];
+                        pairMap.set(pairKey, { a: pA, b: pB, trials: edge.trials, confidence: edge.confidence });
+                    }
+                }
+            }
+            const pairs = [...pairMap.values()]
+                .filter(p => p.trials >= minW)
+                .sort((a, b) => b.trials - a.trials);
+            // Find solo contributors (no collaborators).
+            const connectedIds = new Set();
+            for (const p of pairs) {
+                connectedIds.add(p.a.id);
+                connectedIds.add(p.b.id);
+            }
+            const soloPersons = [...persons.values()].filter(p => !connectedIds.has(p.id));
+            const lines = [
+                `## 🤝 Team Collaboration Graph`,
+                ``,
+            ];
+            if (pairs.length === 0) {
+                lines.push(`No collaboration pairs yet (min weight: ${minW}).`, ``, `Pairs appear when two contributors touch the same file in \`learn_from_attempts\``, `or when someone recalls a teammate's lesson via \`smart_recall(requester="...")\`.`);
+            }
+            else {
+                lines.push(`**${pairs.length} collaboration pair${pairs.length !== 1 ? 's' : ''}** across ${connectedIds.size} contributor${connectedIds.size !== 1 ? 's' : ''}:`, ``);
+                for (const p of pairs.slice(0, 20)) {
+                    const conf = (p.confidence * 100).toFixed(0);
+                    const sharedDomains = [p.a.domain, p.b.domain]
+                        .filter((d, i, arr) => d && arr.indexOf(d) === i)
+                        .map(d => `\`${d}\``)
+                        .join(', ');
+                    lines.push(`### @${p.a.handle} ↔ @${p.b.handle}`, `- **${p.trials} collaboration event${p.trials !== 1 ? 's' : ''}** · ${conf}% confidence`, `- Domains: ${sharedDomains || '_unknown_'}`, `> 💬 _"Frag **@${p.a.handle}** und **@${p.b.handle}** — they've solved problems together in these areas."_`, ``);
+                }
+                if (pairs.length > 20) {
+                    lines.push(`_...and ${pairs.length - 20} more pairs. Use \`min_weight\` to filter._`, ``);
+                }
+            }
+            if (soloPersons.length > 0) {
+                lines.push(`---`, `### ⚠️ Bus Factor Alert — No Collaborators Yet`, ``, `${soloPersons.length} contributor${soloPersons.length !== 1 ? 's have' : ' has'} knowledge that no teammate has recalled or co-touched:`, ``, ...soloPersons.slice(0, 10).map(p => `- **@${p.handle}** — ${p.count} lesson${p.count !== 1 ? 's' : ''} · domain: \`${p.domain}\``), ``, `_Tip: pair these contributors with teammates on shared files to reduce bus factor._`);
+            }
+            lines.push(``, `---`, `_Collaboration edges build from \`learn_from_attempts(author=..., file_paths=[...])\` and \`smart_recall(requester=...)\` cross-author reuse._`);
+            return lines.join('\n');
+        }
         // ── sync_file_changes ─────────────────────────────────────────────────────
         default:
             return null;