@cachly-dev/mcp-server 0.10.79 → 0.10.81

package/README.md

@@ -239,6 +239,7 @@ npx @cachly-dev/mcp-server@latest setup     # Wire up all your AI editors (1–5
 npx @cachly-dev/mcp-server@latest health    # Check token, API, editors, git hook
 npx @cachly-dev/mcp-server@latest digest    # Weekly Brain summary — shareable
 npx @cachly-dev/mcp-server@latest share     # Generate a shareable stats card + tweet
+npx @cachly-dev/mcp-server@latest publish   # Publish your Brain as an importable link (--public)
 npx @cachly-dev/mcp-server@latest badge     # Get a live README badge for your Brain
 npx @cachly-dev/mcp-server@latest invite    # Invite a teammate to share your Brain
 npx @cachly-dev/mcp-server@latest index .   # Index a project's code into the Brain (CI-friendly)
@@ -251,7 +252,7 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 
 ---
 
-## MCP Tools (100 total)
+## MCP Tools (113 total)
 
 ### 🧠 Session & Memory (most used)
 
@@ -289,6 +290,16 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
 | `memory_consolidate` | Detect contradictions, merge duplicates, expire stale lessons |
 | `ckg_inspect` | Inspect the causal graph around any concept |
 
+### 🌐 Shareable & Public Brains
+
+| Tool | What it does |
+|------|-------------|
+| **`brain_seed_starter`** | Seed 16 universal lessons so your **first** `smart_recall` hits — auto-runs on a fresh repo |
+| **`brain_share`** | Export a Brain snapshot as a shareable link (public or unlisted) |
+| **`brain_import`** | Import any shared Brain into yours — `topic_prefix`, `min_confidence`, `dry_run` |
+| `brain_share_list` / `brain_unshare` | List your shares · revoke a share (link goes dead) |
+| **`brain_discover`** | Search the Brain marketplace for ready-made knowledge bases |
+
 ### 🌍 Knowledge Commons · ⚙️ Infrastructure · 📋 Roadmap
 
 | Tool | What it does |

package/dist/src/handlers/brain.js

@@ -7,8 +7,24 @@ 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.79';
+const MCP_VERSION = '0.10.81';
 const WHATS_NEW = {
+    '0.10.81': [
+        `⏱️ **Onboarding-Bench — time-to-first-recall, now measured**`,
+        `  📐 \`npm run bench:onboarding\` — cold (empty) vs seeded (starter) first-query hit rate via the real search engine`,
+        `  📊 Result: first-query hit@1 **0% → 87.5%**, hit@3 **0% → 100%**, MRR **0% → 93.8%**`,
+        `  🛡️ CI-defended in \`onboarding-bench.test.ts\` (cold must answer 0%, seeded thresholds enforced)`,
+        `  📋 \`PLAN-DASHBOARD.md\` — full build spec for the external Team-Knowledge-Reuse dashboard (separate repo)`,
+    ],
+    '0.10.80': [
+        `🌱 **Starter corpus — first recall in seconds, not sessions**`,
+        `  📚 \`brain_seed_starter(instance_id)\` — seed 16 curated universal lessons (Docker cache, JWT skew, K8s OOM, N+1, cache stampede…)`,
+        `  🚀 Auto-seeds on first session when git history is empty/shallow — your first \`smart_recall\` returns a real hit`,
+        `  🛡️ Tagged \`source:"starter"\`, idempotent, never overrides your own lessons`,
+        `  ⏱️ Directly attacks time-to-first-recall (<2 min goal); stamps \`born_at\` on seed`,
+        `  🧪 18 new tests: seeding, idempotency, topic_filter, force, user-lesson protection`,
+        `  📊 113 MCP tools`,
+    ],
     '0.10.79': [
         `🌐 **Brain Marketplace — full shareable Brain lifecycle**`,
         `  📋 \`brain_share_list(instance_id)\` — see all your public shares with lesson counts + share IDs`,
@@ -1090,6 +1106,11 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                 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('🌱 **Want answers right now?** Seed 16 universal engineering lessons so your first');
+                lines.push('   `smart_recall` returns a hit instead of nothing:');
+                lines.push(`   \`brain_seed_starter(instance_id="${instance_id}")\``);
+                lines.push('   _(Docker cache, JWT skew, K8s OOM, N+1 queries, cache stampede… — never overrides your own lessons.)_');
+                lines.push('');
                 lines.push('💡 Run `brain_doctor` for a health-check and personalised tips.');
                 lines.push('');
             }