@cachly-dev/mcp-server 0.10.102 → 0.10.103

package/README.md

@@ -494,6 +494,18 @@ keep talking to your backend on every editor launch. All data stays in your infr
 
 ---
 
+## 🧠 Brain v3 — what's new
+
+| Feature | Tool | What it does |
+|---|---|---|
+| Autonomous hygiene | `brain_hygiene` | Sweeps stale lessons, flags provisional, archives orphans |
+| PR risk scan | `brain_plan` + `cachly-action scan` | Predicts CI failures before they run, posts PR comment |
+| Multi-agent arbitration | `brain_conflicts` · `brain_resolve_conflict` | Detects + resolves conflicting lessons across agents |
+| Plans dashboard | `brain_plan` | Persistent plans in the UI with step tracking and brain-viz overlay |
+| Privacy federation | `brain_contribute_signal` · `brain_import_meta` | Share patterns without sharing data — k-anonymous global commons |
+
+---
+
 ## 🛠️ Ecosystem & Docs
 
 **One brain, wherever you work.** Start with the MCP server, or drop the same memory
@@ -505,11 +517,11 @@ straight into your editor — your lessons follow you across all of them.
 | **[Cachly Brain for VS Code](https://marketplace.visualstudio.com/items?itemName=cachly-dev.cachly-brain)** | One-click memory in the editor — status bar, lessons view, ambient learning. No terminal needed. |
 | **[Cachly Brain for JetBrains](https://plugins.jetbrains.com/plugin/32059-cachly-brain)** | Same brain for IntelliJ / PyCharm / GoLand / WebStorm / Rider — status bar, brain health, lessons view. |
 | **[`@cachly-dev/openclaw`](https://www.npmjs.com/package/@cachly-dev/openclaw)** | Cut LLM costs 60–90% in JS/TS apps |
+| **[cachly-dev/cachly-action](https://github.com/cachly-dev/cachly-action)** | GitHub Action: auto-setup, PR risk scan, auto-learn from merged PRs, weekly hygiene |
 
 - 🌐 [cachly.dev](https://cachly.dev) — Dashboard & free signup
 - 📖 [Docs](https://cachly.dev/docs/ai-memory) — Full documentation
-- 📊 [BENCH.md](./BENCH.md) — The recall-quality proof
-- 🧭 [STRATEGY.md](./STRATEGY.md) · [VISION_10X.md](./VISION_10X.md) · [PROGRESS.md](./PROGRESS.md)
+- 🗺️ [Public Roadmap](https://cachly.dev/roadmap) — what's coming next
 - 💬 [GitHub Issues](https://github.com/cachly-dev/cachly-mcp/issues) — Bugs & feature requests
 
 ---

package/dist/src/handlers/brain.js

@@ -536,10 +536,21 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
                         if (!existEdge)
                             continue;
                         if (existEdge.edgeType === 'fixes' && existEdge.confidence > 0.7 && existEdge.trials >= 3) {
-                            beliefConflict = `⚠️ **belief_conflict** on \`${topic}\`: previously confirmed fix (confidence ${existEdge.confidence.toFixed(2)}, n=${existEdge.trials}) now reports failure. Both beliefs retained as \`contested\`. Use \`ckg_inspect(concept="${conceptId}")\` to review.`;
-                            // Store conflict marker
+                            beliefConflict = `⚠️ **belief_conflict** on \`${topic}\`: previously confirmed fix (confidence ${existEdge.confidence.toFixed(2)}, n=${existEdge.trials}) now reports failure. Both beliefs retained as \`contested\`. Use \`brain_resolve_conflict(instance_id="...", topic="${topic}", winner="success"|"failure")\` to arbitrate, or \`ckg_inspect(concept="${conceptId}")\` to review.`;
+                            // Store conflict marker — records WHICH agent reported the contradiction
+                            // so multi-agent arbitration can show both sides (Move 4).
                             const conflictKey = `cachly:ckg:conflict:${conceptId}`;
-                            await redis.set(conflictKey, JSON.stringify({ topic, detected_at: new Date().toISOString(), fix_confidence: existEdge.confidence, fix_trials: existEdge.trials, failure_outcome: outcome }), 'EX', 60 * 60 * 24 * 90);
+                            await redis.set(conflictKey, JSON.stringify({
+                                topic,
+                                concept_id: conceptId,
+                                detected_at: new Date().toISOString(),
+                                fix_confidence: existEdge.confidence,
+                                fix_trials: existEdge.trials,
+                                failure_outcome: outcome,
+                                reported_by: author || 'unknown',
+                                what_failed: what_failed || '',
+                                resolved: false,
+                            }), 'EX', 60 * 60 * 24 * 90);
                             // Auto-trigger MADC deliberation in background — never blocks learn_from_attempts
                             // Note: fire-and-forget; madc_deliberate is handled elsewhere in the switch
                             // (conflict marker stored above — no warm-up call needed)
@@ -605,6 +616,10 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             // Builds the "who knows what" map automatically from author + file_paths.
             // Person → authored → Concept edges power brain_who_knows queries.
             if (author) {
+                // Agent activity registry (Move 4): track which agents are actively
+                // writing to this Brain, keyed by author, with a 1h TTL. Powers
+                // brain_conflicts' "who is live" view and multi-agent arbitration.
+                redis.set(`cachly:agents:active:${author}`, JSON.stringify({ author, last_topic: topic, last_outcome: outcome, ts: new Date().toISOString() }), 'EX', 60 * 60).catch(() => { });
                 try {
                     const domain = topic.split(':')[0] ?? 'unknown';
                     const personId = await ckgUpsertPersonNode(redis, author, domain);
@@ -818,12 +833,16 @@ export async function handleBrainTool(name, args, getConnection, apiFetch) {
             // text-similar failed attempts (the moat; see src/rerank.ts + Cachly-Bench). ──
             const kwMatches = rerankByQuality(rawMatches);
             const savedHere = [];
+            // Exclude archived lessons — they are kept for audit but must not surface in recall.
             const lessonMatches = kwMatches.filter(m => m.key.startsWith('cachly:lesson:best:'));
             let crossAuthorThisCall = 0;
             for (const m of lessonMatches.slice(0, 5)) {
                 const existing = await redis.get(m.key).catch(() => null);
                 if (existing) {
                     const lesson = safeJsonParse(existing, null);
+                    // Skip archived lessons — brain_hygiene moves them here; they should not resurface.
+                    if (lesson?.state === 'archived')
+                        continue;
                     if (lesson) {
                         const updated = { ...lesson, recall_count: (lesson.recall_count ?? 0) + 1, verified_at: new Date().toISOString() };
                         redis.set(m.key, JSON.stringify(updated)).catch(() => { });