@cachly-dev/mcp-server 0.10.96 → 0.10.98

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/119%20MCP%20tools-violet" alt="119 MCP tools" />
+  <img src="https://img.shields.io/badge/121%20MCP%20tools-violet" alt="121 MCP tools" />
   &nbsp;
   <img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
 </p>
@@ -191,6 +191,7 @@ close without breaking its own lock-in. **That gap is where cachly wins.**
 | **`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_portability`** | W9 Model-Neutrality — config for 7 clients (Claude, Cursor, Copilot, Windsurf, Cline, Zed, Continue). *"Same Brain, any model."* |
 | **`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. |
@@ -245,7 +246,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 
 ---
 
-## MCP Tools (119 total)
+## MCP Tools (120 total)
 
 ### 🧠 Session & Memory (most used)
 
@@ -271,10 +272,12 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 | **`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 |
+| **`brain_portability`** | Config snippets for 7 MCP clients — proves model-neutrality, same Brain everywhere |
 | **`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 |
 | `memory_crystalize` | Distill all lessons into a Crystal for instant team context |
+| `team_crystallize` | Team Crystal — fixes that 2+ teammates independently converged on (the cross-person, causal layer) |
 
 ### 🧬 Causal Intelligence
 

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.96';
+const MCP_VERSION = '0.10.98';
 const WHATS_NEW = {
+    '0.10.98': [
+        `🌐 **Model-Neutrality as Feature (W9) — "Bring your own model, keep your brain."**`,
+        `  🔌 New \`brain_portability()\` — shows your Brain ID, all compatible MCP clients, and ready-to-paste config snippets for each; proves the same Brain works in Claude, Cursor, Copilot, Windsurf, Cline, Zed and more`,
+        `  🧠 Your lessons, crystals, and predictions are model-agnostic — no vendor lock-in at the memory layer`,
+        `  📖 New docs: cachly.dev/docs/model-neutral — "Same Brain, Any Model" guide with live config examples`,
+        `  📊 121 MCP tools (new: \`brain_portability\`)`,
+    ],
+    '0.10.97': [
+        `💠 **Team Crystallize (W8) — the team-wide, causal counter to per-user "Dreaming"**`,
+        `  🧬 New \`team_crystallize()\` — surfaces fixes that 2+ teammates *independently converged on*, the one thing a single-user memory structurally can't build`,
+        `  🧩 Cross-person clustering: groups structurally similar problems across people & namespaces (e.g. "pool exhaustion" solved the same way in payments, auth & db)`,
+        `  👥 Each pattern names who converged — instant "ask @alice and @bob, they both hit this"`,
+        `  💎 Shows up in \`crystal_view\` alongside your per-brain crystal`,
+        `  📊 120 MCP tools (new: \`team_crystallize\`)`,
+    ],
     '0.10.96': [
         `🔐 **Roles & Team-Scopes now ENFORCED (W6) — the enterprise governance layer**`,
         `  🛡️ \`team_confirm\` is now reviewer-gated, \`team_learn\` blocks viewers (recall-only) — roles stop being cosmetic the moment an admin is assigned`,
@@ -100,7 +115,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 119 tools in any framework's dialect`,
+        `  🗂️ \`npx ... tool-specs --format=openai|anthropic|langchain\` — export all 121 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`,
     ],
@@ -284,6 +299,7 @@ export const BRAIN_TOOL_NAMES = new Set([
     'session_start', 'session_end', 'session_ping', 'session_handoff', 'auto_learn_session',
     'brain_who_knows', 'brain_file_map', 'team_expertise_map',
     'skill_gaps', 'brain_coverage', 'brain_metrics', 'brain_service_map',
+    'brain_collab_pairs', 'brain_portability',
 ]);
 export async function handleBrainTool(name, args, getConnection, apiFetch) {
     switch (name) {
@@ -2918,6 +2934,137 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             lines.push(``, `---`, `_Collaboration edges build from \`learn_from_attempts(author=..., file_paths=[...])\` and \`smart_recall(requester=...)\` cross-author reuse._`);
             return lines.join('\n');
         }
+        // ── brain_portability ─────────────────────────────────────────────────────
+        case 'brain_portability': {
+            const { instance_id } = args;
+            const clients = [
+                {
+                    name: 'Claude Code',
+                    slug: 'claude-code',
+                    icon: '🤖',
+                    configPath: '~/.claude/settings.json',
+                    configBlock: JSON.stringify({
+                        mcpServers: {
+                            cachly: {
+                                command: 'npx',
+                                args: ['@cachly-dev/mcp-server@latest'],
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'Cursor',
+                    slug: 'cursor',
+                    icon: '🖱️',
+                    configPath: '~/.cursor/mcp.json',
+                    configBlock: JSON.stringify({
+                        mcpServers: {
+                            cachly: {
+                                command: 'npx',
+                                args: ['@cachly-dev/mcp-server@latest'],
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'Windsurf',
+                    slug: 'windsurf',
+                    icon: '🏄',
+                    configPath: '~/.windsurf/mcp.json',
+                    configBlock: JSON.stringify({
+                        mcpServers: {
+                            cachly: {
+                                command: 'npx',
+                                args: ['@cachly-dev/mcp-server@latest'],
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'GitHub Copilot (VS Code)',
+                    slug: 'copilot',
+                    icon: '🐙',
+                    configPath: '.vscode/mcp.json (workspace)',
+                    configBlock: JSON.stringify({
+                        servers: {
+                            cachly: {
+                                type: 'stdio',
+                                command: 'npx',
+                                args: ['@cachly-dev/mcp-server@latest'],
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'Cline',
+                    slug: 'cline',
+                    icon: '⚡',
+                    configPath: '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json',
+                    configBlock: JSON.stringify({
+                        mcpServers: {
+                            cachly: {
+                                command: 'npx',
+                                args: ['@cachly-dev/mcp-server@latest'],
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'Zed',
+                    slug: 'zed',
+                    icon: '⚡',
+                    configPath: '~/.config/zed/settings.json',
+                    configBlock: JSON.stringify({
+                        context_servers: {
+                            cachly: {
+                                command: { path: 'npx', args: ['@cachly-dev/mcp-server@latest'] },
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        },
+                    }, null, 2),
+                },
+                {
+                    name: 'Continue',
+                    slug: 'continue',
+                    icon: '▶️',
+                    configPath: '~/.continue/config.json',
+                    configBlock: JSON.stringify({
+                        mcpServers: [
+                            {
+                                name: 'cachly',
+                                command: 'npx @cachly-dev/mcp-server@latest',
+                                env: { CACHLY_INSTANCE_ID: instance_id },
+                            },
+                        ],
+                    }, null, 2),
+                },
+            ];
+            const lines = [
+                `## 🌐 Brain Portability — Same Brain, Any Model`,
+                ``,
+                `> _"Bring your own model, keep your brain."_`,
+                ``,
+                `**Your Brain ID:** \`${instance_id}\``,
+                ``,
+                `This Brain ID is model-agnostic. Every lesson you've learned, every Memory Crystal you've distilled,`,
+                `and every prediction from your Causal Knowledge Graph is accessible from **any MCP-compatible AI client**.`,
+                ``,
+                `---`,
+                ``,
+                `### Compatible Clients (${clients.length} supported)`,
+                ``,
+            ];
+            for (const c of clients) {
+                lines.push(`#### ${c.icon} ${c.name}`, `Config: \`${c.configPath}\``, ``, '```json', c.configBlock, '```', ``);
+            }
+            lines.push(`---`, ``, `### What travels with you`, ``, `| Data | Model-neutral? |`, `|------|---------------|`, `| Lessons (learn_from_attempts) | ✅ Full access in all clients |`, `| Memory Crystals (memory_crystalize) | ✅ Included in every session_start |`, `| Causal Knowledge Graph (brain_predict) | ✅ Same graph, same predictions |`, `| Team lessons (team_learn, team_confirm) | ✅ Team is per-Brain, not per-model |`, `| Domain Brain Marketplace installs | ✅ Installed once, available everywhere |`, `| Session handoffs (session_handoff) | ✅ Cross-client continuity |`, ``, `---`, ``, `### One-command setup for any new client`, ``, '```bash', `npx @cachly-dev/mcp-server@latest autopilot`, '```', ``, `Autopilot detects all installed editors and writes the config for each — with your \`${instance_id}\` Brain ID pre-filled.`, ``, `---`, `_Docs: cachly.dev/docs/model-neutral • Your Brain, Any Model_`);
+            return lines.join('\n');
+        }
         // ── sync_file_changes ─────────────────────────────────────────────────────
         default:
             return null;