@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/handlers/syndicate.js

@@ -1,904 +1,38 @@
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import { calculateConfidence } from '../confidence.js';
-import { ckgSlug } from '../ckg.js';
-import { keywordSearch } from '../search.js';
-import { safeJsonParse } from '../utils.js';
-// tryOrgPredict resolves the caller's org from the instance record and calls the
-// server-side Org Knowledge Graph prediction (POST /orgs/:id/brain/predict). It
-// returns the rendered cross-team report, or null to signal "degrade to instance
-// scope" (instance has no org, endpoint 404/unavailable, or no cross-team signal).
-async function tryOrgPredict(instanceId, ctx, topK, scope, apiFetch) {
-    const inst = await apiFetch(`/api/v1/instances/${instanceId}`).catch(() => null);
-    const orgId = inst?.org_id;
-    if (!orgId)
-        return null; // solo instance — no org graph to widen into.
-    let res = null;
-    try {
-        res = await apiFetch(`/api/v1/orgs/${orgId}/brain/predict`, {
-            method: 'POST',
-            body: JSON.stringify({ context: ctx, top_k: topK }),
-        });
-    }
-    catch {
-        return null; // endpoint unavailable / not a member / graph disabled → degrade.
-    }
-    if (!res || !res.warnings || res.warnings.length === 0)
-        return null;
-    return await renderOrgPredict(ctx, res, scope, apiFetch);
-}
-async function fetchCommonsOverlay(ctx, res, apiFetch) {
-    const query = res.warnings[0]?.problem || ctx;
-    if (!query)
-        return [];
-    try {
-        const r = await apiFetch(`/api/v1/syndication/search?q=${encodeURIComponent(query)}&limit=3`);
-        const orgProblems = new Set(res.warnings.map((w) => w.problem));
-        return (r.results ?? [])
-            .filter((x) => Boolean(x.topic) && Boolean(x.what_worked) && !orgProblems.has(x.topic))
-            .slice(0, 3)
-            .map((x) => ({ topic: x.topic, what_worked: x.what_worked.slice(0, 160) }));
-    }
-    catch {
-        return []; // commons unavailable → org prediction stands alone (no regression).
-    }
-}
-async function renderOrgPredict(ctx, res, scope, apiFetch) {
-    const lines = [`🔮 **Org Brain Predict: "${ctx}"**`, ''];
-    for (const w of res.warnings) {
-        const otherTeams = Math.max(0, w.team_span - 1);
-        const totalHits = w.recurrence.reduce((s, r) => s + (r.count ?? 0), 0);
-        const sevIcon = w.severity === 'critical' ? '🔴' : w.severity === 'major' ? '🟠' : '🟡';
-        if (w.team_span >= 2) {
-            lines.push(`⚠️ **CROSS-TEAM RISK** — this pattern failed ${totalHits}× across ${otherTeams} other team${otherTeams === 1 ? '' : 's'}:`);
-        }
-        else {
-            lines.push(`⚠️ **RISK** — this pattern failed ${totalHits}× before:`);
-        }
-        lines.push(`   ${sevIcon} problem: \`${w.problem}\``);
-        for (const r of w.recurrence.slice(0, 6)) {
-            const last = r.last_seen ? ` (last: ${r.last_seen.slice(0, 10)})` : '';
-            lines.push(`      • ${r.team}  ×${r.count}${last}`);
-        }
-        const bestFix = w.fixes[0];
-        if (bestFix) {
-            const confPct = Math.round((bestFix.confidence ?? 0) * 100);
-            const confirmedBy = bestFix.source_team ? ` (${bestFix.source_team})` : '';
-            lines.push(`   ✅ Proven fix — ${confPct}% confidence, confirmed ${bestFix.confirm_count}×${confirmedBy}:`);
-            lines.push(`      ${bestFix.summary}`);
-        }
-        lines.push('');
-    }
-    if (scope === 'org+commons') {
-        // Overlay public Knowledge-Commons hits beneath the higher-signal org graph.
-        const commons = await fetchCommonsOverlay(ctx, res, apiFetch);
-        if (commons.length > 0) {
-            lines.push('🌐 **From the public Knowledge Commons** (cross-org, lower-signal):');
-            for (const c of commons) {
-                lines.push(`   • \`${c.topic}\` — ${c.what_worked}`);
-            }
-            lines.push('');
-        }
-    }
-    lines.push(`💡 Heeded the warning? \`learn_from_attempts(..., tags=["prevented-by-org-graph"])\` → counts as a prevented cross-team mistake.`);
-    return lines.join('\n');
-}
-export const SYNDICATE_TOOL_NAMES = new Set([
-    'syndicate', 'syndicate_search', 'syndicate_stats', 'syndicate_trending',
-    'brain_search', 'ckg_inspect', 'brain_predict', 'brain_plan',
-    'brain_marketplace', 'brain_install',
-    'brain_conflicts', 'brain_resolve_conflict',
-    'brain_confirm_ci', 'brain_briefing',
-]);
-export async function handleSyndicateTool(name, args, getConnection, apiFetch) {
-    switch (name) {
-        case 'syndicate': {
-            const { topic, outcome = 'success', what_worked, what_failed = '', severity = 'minor', tags = [], scope = 'public' } = args;
-            if (!topic || !what_worked) {
-                throw new McpError(ErrorCode.InvalidParams, 'topic and what_worked are required');
-            }
-            const body = { topic, outcome, what_worked, what_failed, severity, tags, scope };
-            const res = await apiFetch('/api/v1/syndication/contribute', { method: 'POST', body: JSON.stringify(body) });
-            const scopeLabel = scope === 'org' ? '🏢 org-private' : '🌐 global commons';
-            const dedupNote = res.deduped
-                ? `\n> ♻️ Duplicate detected — trust score incremented for the existing lesson.`
-                : '';
-            return [
-                `${scope === 'org' ? '🏢' : '🌐'} **Lesson syndicated to the ${scope === 'org' ? 'org Knowledge Commons' : 'global Knowledge Commons'}**${dedupNote}`,
-                ``,
-                `**ID:** \`${res.id}\``,
-                `**Topic:** \`${res.topic}\` · **Outcome:** ${res.outcome} · **Scope:** ${scopeLabel}`,
-                ``,
-                scope === 'org'
-                    ? `This lesson is visible only within your organisation. Use \`syndicate_search(scope="org")\` to find it.`
-                    : `Your lesson is now searchable by every AI brain in the network.`,
-                `When another instance confirms it works, its trust score rises — and so does your contributor reputation.`,
-                ``,
-                `**Tip:** Use \`syndicate_search(q="${topic}")\` to see all community lessons on this topic.`,
-            ].join('\n');
-        }
-        // ── v0.7 Knowledge Syndication: syndicate_search ─────────────────────────
-        case 'syndicate_search': {
-            const { q = '', limit = 20, category = '', scope = '' } = args;
-            const params = new URLSearchParams();
-            if (q)
-                params.set('q', q);
-            if (category)
-                params.set('category', category);
-            if (scope)
-                params.set('scope', scope);
-            params.set('limit', String(Math.min(Math.max(1, limit), 50)));
-            const res = await apiFetch(`/api/v1/syndication/search?${params}`);
-            if (!res.results || res.results.length === 0) {
-                return q
-                    ? `No lessons found for "${q}" in the global Knowledge Commons yet.\n\nBe the first to contribute: \`syndicate(topic="...", what_worked="...")\``
-                    : `The global Knowledge Commons is empty. Be the first contributor:\n\`syndicate(topic="deploy:api", what_worked="...")\``;
-            }
-            const outcomeIcon = (o) => o === 'success' ? '✅' : o === 'failure' ? '❌' : '⚠️';
-            const severityLabel = (s) => s === 'critical' ? '🔴' : s === 'major' ? '🟡' : '🟢';
-            const confirmBar = (n) => {
-                const filled = Math.min(10, Math.round(n / 5));
-                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
-            };
-            const header = [q, category].filter(Boolean).join(' · ');
-            const lines = [
-                `## 🌐 Global Knowledge Commons${header ? ` — ${header}` : ' — Recent'}`,
-                `*${res.count} lesson${res.count === 1 ? '' : 's'} found*`,
-                ``,
-            ];
-            for (const lesson of res.results) {
-                lines.push(`### ${outcomeIcon(lesson.outcome)} \`${lesson.topic}\` ${severityLabel(lesson.severity)}`, `**Trust:** ${confirmBar(lesson.confirm_count)}`, lesson.what_worked ? `**What worked:** ${lesson.what_worked}` : '', lesson.what_failed ? `**What failed:** ${lesson.what_failed}` : '', `*Contributed ${new Date(lesson.created_at).toLocaleDateString('de-DE')} · ID: \`${lesson.id}\`*`, ``);
-            }
-            lines.push(`---`, `**Confirm** (this helped you): \`syndicate(topic="${res.results[0]?.topic ?? '...'}", what_worked="...")\` → auto-deduped, trust +1`, `**Contribute your own:** \`syndicate(topic="fix:...", what_worked="...")\``, `**Filter by category:** \`syndicate_search(category="fix")\``);
-            return lines.filter(l => l !== '').join('\n');
-        }
-        // ── v0.7 Knowledge Syndication: syndicate_stats ──────────────────────────
-        case 'syndicate_stats': {
-            const res = await apiFetch('/api/v1/syndication/stats');
-            const confirmBar = (n) => {
-                const filled = Math.min(10, Math.round(n / 5));
-                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
-            };
-            const lines = [
-                `## 🌐 Global Knowledge Commons — Stats`,
-                ``,
-                `| Metric | Value |`,
-                `|---|---|`,
-                `| Total lessons | **${res.total_lessons.toLocaleString()}** |`,
-                `| Total confirms | **${res.total_confirms.toLocaleString()}** |`,
-                `| Added last 7 days | **${res.added_last_7_days}** |`,
-                ``,
-                `### Top Categories`,
-            ];
-            for (const cat of res.top_categories ?? []) {
-                lines.push(`- \`${cat.category}\` — ${cat.count} lesson${cat.count === 1 ? '' : 's'}`);
-            }
-            lines.push(``, `### Most Trusted Lessons`);
-            for (const lesson of res.most_trusted ?? []) {
-                lines.push(`**\`${lesson.topic}\`** ${confirmBar(lesson.confirm_count)}`, `> ${lesson.what_worked.slice(0, 120)}${lesson.what_worked.length > 120 ? '…' : ''}`, ``);
-            }
-            lines.push(`---`, `**Contribute:** \`syndicate(topic="...", what_worked="...")\`  |  **Search:** \`syndicate_search(q="your problem")\``);
-            // Top contributors (anonymous scores)
-            if (res.top_contributors?.length) {
-                lines.push(``, `### 🏅 Top Contributors (anonymous)`);
-                for (const c of res.top_contributors) {
-                    lines.push(`- Trust **${c.trust_score}** · ${c.lessons_count} lesson${c.lessons_count === 1 ? '' : 's'} · ${c.confirms_received} confirms received`);
-                }
-            }
-            return lines.join('\n');
-        }
-        // ── v0.8 Knowledge Syndication: syndicate_trending ───────────────────────
-        case 'syndicate_trending': {
-            const { limit = 10 } = args;
-            const params = new URLSearchParams({ limit: String(Math.min(Math.max(1, limit), 50)) });
-            const res = await apiFetch(`/api/v1/syndication/trending?${params}`);
-            if (!res.results || res.results.length === 0) {
-                return [
-                    `## 📈 Trending in the Knowledge Commons`,
-                    ``,
-                    `No trending lessons yet (need at least 2 confirms in the last 7 days).`,
-                    ``,
-                    `Contribute and confirm lessons to see them trend: \`syndicate(topic="...", what_worked="...")\``,
-                ].join('\n');
-            }
-            const outcomeIcon = (o) => o === 'success' ? '✅' : o === 'failure' ? '❌' : '⚠️';
-            const severityLabel = (s) => s === 'critical' ? '🔴' : s === 'major' ? '🟡' : '🟢';
-            const confirmBar = (n) => {
-                const filled = Math.min(10, Math.round(n / 5));
-                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
-            };
-            const trendBar = (score) => {
-                const filled = Math.min(10, Math.round(score * 2));
-                return '▲'.repeat(filled) + '△'.repeat(10 - filled) + ` ${score.toFixed(2)}/day`;
-            };
-            const lines = [
-                `## 📈 Trending in the Knowledge Commons`,
-                `*Lessons with the fastest confirmation velocity in the last 7 days*`,
-                ``,
-            ];
-            for (const lesson of res.results) {
-                lines.push(`### ${outcomeIcon(lesson.outcome)} \`${lesson.topic}\` ${severityLabel(lesson.severity)}`, `**Trend:** ${trendBar(lesson.trend_score)}  |  **Trust:** ${confirmBar(lesson.confirm_count)}`, lesson.what_worked ? `**What worked:** ${lesson.what_worked.slice(0, 200)}${lesson.what_worked.length > 200 ? '…' : ''}` : '', `*ID: \`${lesson.id}\` · ${new Date(lesson.created_at).toLocaleDateString('de-DE')}*`, ``);
-            }
-            lines.push(`---`, `**Confirm** (if this helped you): \`syndicate(topic="${res.results[0]?.topic ?? '...'}", what_worked="...")\` → auto-deduped, trust +1`, `**All trending:** \`syndicate_trending(limit=50)\`  |  **Search:** \`syndicate_search(q="...")\``);
-            return lines.filter(l => l !== '').join('\n');
-        }
-        // ── Layer 1: brain_search ─────────────────────────────────────────────────
-        case 'brain_search': {
-            const { instance_id, query, limit = 15 } = args;
-            const redis = await getConnection(instance_id);
-            // BM25+ over ALL brain key namespaces
-            const allMatches = await keywordSearch(redis, [
-                'cachly:lesson:best:*',
-                'cachly:ctx:*',
-                'cachly:idx:*',
-                'cachly:session:last',
-                'cachly:session:handoff',
-                'cachly:roadmap:*',
-                'cachly:ckg:node:*',
-            ], query, limit);
-            if (allMatches.length === 0) {
-                return [`🔎 **Brain Search: "${query}"**`, '', `No results found across all brain data.`, '', `💡 Try \`smart_recall\` or check \`list_remembered\`.`].join('\n');
-            }
-            const lines = [`🔎 **Brain Search: "${query}"** — ${allMatches.length} result${allMatches.length !== 1 ? 's' : ''} across all brain data\n`];
-            for (const m of allMatches.slice(0, limit)) {
-                const ns = m.key.startsWith('cachly:lesson:') ? '💡 lesson'
-                    : m.key.startsWith('cachly:ctx:') ? '📝 context'
-                        : m.key.startsWith('cachly:idx:') ? '📂 index'
-                            : m.key.startsWith('cachly:session:') ? '🕐 session'
-                                : m.key.startsWith('cachly:roadmap:') ? '🗺️ roadmap'
-                                    : m.key.startsWith('cachly:ckg:node:') ? '🕸️ ckg-node'
-                                        : '🗄️ data';
-                const preview = m.content.slice(0, 280).replace(/\n/g, ' ');
-                lines.push(`**${ns}** \`${m.key.split(':').slice(2).join(':')}\` _(BM25: ${m.score.toFixed(2)})_`);
-                lines.push(`> ${preview}${m.content.length > 280 ? '…' : ''}\n`);
-            }
-            return lines.join('\n');
-        }
-        // ── Layer 1: ckg_inspect ─────────────────────────────────────────────────
-        case 'ckg_inspect': {
-            const { instance_id, concept, max_hops = 2 } = args;
-            const redis = await getConnection(instance_id);
-            const conceptId = ckgSlug(concept);
-            const visited = new Set();
-            const allEdges = [];
-            // BFS traversal of CKG
-            const queue = [{ id: conceptId, hop: 0 }];
-            while (queue.length > 0) {
-                const { id, hop } = queue.shift();
-                if (visited.has(id) || hop > max_hops)
-                    continue;
-                visited.add(id);
-                const fromKeys = await redis.smembers(`cachly:ckg:idx:from:${id}`);
-                const toKeys = await redis.smembers(`cachly:ckg:idx:to:${id}`);
-                for (const ek of [...fromKeys, ...toKeys].slice(0, 50)) {
-                    const raw = await redis.get(ek);
-                    if (!raw)
-                        continue;
-                    const edge = safeJsonParse(raw, null);
-                    if (!edge)
-                        continue;
-                    allEdges.push(edge);
-                    if (hop < max_hops) {
-                        if (!visited.has(edge.from))
-                            queue.push({ id: edge.from, hop: hop + 1 });
-                        if (!visited.has(edge.to))
-                            queue.push({ id: edge.to, hop: hop + 1 });
-                    }
-                }
-            }
-            if (allEdges.length === 0) {
-                // Try fuzzy: scan for nodes matching the concept as substring
-                const nodeKeys = [];
-                const nStream = redis.scanStream({ match: `cachly:ckg:node:*${conceptId}*`, count: 100 });
-                await new Promise((res, rej) => { nStream.on('data', (b) => nodeKeys.push(...b)); nStream.on('end', res); nStream.on('error', rej); });
-                if (nodeKeys.length === 0) {
-                    return [`🕸️ **CKG Inspect: "${concept}"**`, '', `No CKG nodes found. The graph builds automatically as you call \`learn_from_attempts\`.`, '', `💡 Once you have lessons stored, CKG edges will appear here.`].join('\n');
-                }
-                const nodeList = nodeKeys.slice(0, 10).map(k => `  • \`${k.replace('cachly:ckg:node:', '')}\``).join('\n');
-                return [`🕸️ **CKG Inspect: "${concept}"**`, '', `No edges found for \`${conceptId}\`, but found similar nodes:`, nodeList, '', `Try: \`ckg_inspect(concept="<exact-node-id>")\``].join('\n');
-            }
-            // Sort by confidence desc, deduplicate
-            const edgeSeen = new Set();
-            const unique = allEdges.filter(e => {
-                const k = `${e.from}:${e.edgeType}:${e.to}`;
-                if (edgeSeen.has(k))
-                    return false;
-                edgeSeen.add(k);
-                return true;
-            }).sort((a, b) => b.confidence - a.confidence);
-            const EDGE_ICON = { fixes: '🔧', requires: '🔗', 'co-occurs': '🔄', causes: '⚡', contradicts: '⚠️', degrades_under: '📉' };
-            const lines = [`🕸️ **CKG Inspect: "${concept}"** (${unique.length} edge${unique.length !== 1 ? 's' : ''}, ${visited.size} node${visited.size !== 1 ? 's' : ''} traversed)\n`];
-            // Group by edge type
-            const byType = new Map();
-            for (const e of unique) {
-                if (!byType.has(e.edgeType))
-                    byType.set(e.edgeType, []);
-                byType.get(e.edgeType).push(e);
-            }
-            for (const [eType, edges] of byType) {
-                const icon = EDGE_ICON[eType] ?? '→';
-                lines.push(`**${icon} ${eType}** (${edges.length})`);
-                for (const e of edges.slice(0, 8)) {
-                    const confPct = Math.round(e.confidence * 100);
-                    const bar = '▓'.repeat(Math.round(confPct / 10)) + '░'.repeat(10 - Math.round(confPct / 10));
-                    lines.push(`  \`${e.from}\` → \`${e.to}\`  ${bar} ${confPct}% (${e.successes.toFixed(1)}/${e.trials} trials)`);
-                }
-                lines.push('');
-            }
-            lines.push(`💡 Expand: \`ckg_inspect(concept="${concept}", max_hops=3)\`  |  Predict: \`brain_predict(context="${concept}")\``);
-            return lines.join('\n');
-        }
-        // ── Layer 4: brain_predict (PPE) ─────────────────────────────────────────
-        case 'brain_predict': {
-            const { instance_id, context: ctx, top_k = 5, scope = 'instance' } = args;
-            // scope="org" / "org+commons" — widen prediction across the whole org via
-            // the Org Knowledge Graph (§3.4). Resolve the org from the instance the same
-            // way cache_org_stats does (instance record → org_id), then call the
-            // server-side traversal. Graceful-degrade to the instance path on any miss
-            // (no org, endpoint unavailable, empty graph) so there is zero regression.
-            if (scope === 'org' || scope === 'org+commons') {
-                const orgResult = await tryOrgPredict(instance_id, ctx, top_k, scope, apiFetch);
-                if (orgResult !== null)
-                    return orgResult;
-                // fall through to the instance-scoped path below.
-            }
-            const redis = await getConnection(instance_id);
-            const ctxTokens = ctx.toLowerCase().replace(/[^a-z0-9\s\-_:]/g, ' ').split(/\s+/).filter(t => t.length > 2);
-            const predictions = [];
-            for (const token of ctxTokens.slice(0, 6)) {
-                const nodeKeys = [];
-                const nStream = redis.scanStream({ match: `cachly:ckg:node:*${token}*`, count: 50 });
-                await new Promise((res, rej) => { nStream.on('data', (b) => nodeKeys.push(...b)); nStream.on('end', res); nStream.on('error', rej); });
-                for (const nk of nodeKeys.slice(0, 5)) {
-                    const nodeRaw = await redis.get(nk);
-                    if (!nodeRaw)
-                        continue;
-                    const node = safeJsonParse(nodeRaw, null);
-                    if (!node)
-                        continue;
-                    const edgeKeys = await redis.smembers(`cachly:ckg:idx:from:${node.id}`);
-                    for (const ek of edgeKeys.slice(0, 20)) {
-                        const edgeRaw = await redis.get(ek);
-                        if (!edgeRaw)
-                            continue;
-                        const edge = safeJsonParse(edgeRaw, null);
-                        if (!edge)
-                            continue;
-                        // Only interested in fixes and co-occurs for prediction
-                        if (edge.edgeType !== 'fixes' && edge.edgeType !== 'co-occurs' && edge.edgeType !== 'causes')
-                            continue;
-                        const lessonRaw = await redis.get(`cachly:lesson:best:${edge.from}`);
-                        const lesson = lessonRaw ? safeJsonParse(lessonRaw, null) ?? undefined : undefined;
-                        predictions.push({ concept: node.id, edgeType: edge.edgeType, target: edge.to, confidence: edge.confidence, lesson });
-                    }
-                }
-            }
-            // Step 2: Text-based fallback — scan lessons for matching topics
-            const textPredictions = [];
-            const lessonKeys = [];
-            const lStream = redis.scanStream({ match: 'cachly:lesson:best:*', count: 200 });
-            await new Promise((res, rej) => { lStream.on('data', (b) => lessonKeys.push(...b)); lStream.on('end', res); lStream.on('error', rej); });
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                {
-                    const l = safeJsonParse(raw, null);
-                    if (!l)
-                        continue;
-                    const haystack = [l.topic, l.what_failed ?? '', l.what_worked ?? ''].join(' ').toLowerCase();
-                    const score = ctxTokens.reduce((s, t) => s + (haystack.includes(t) ? 1 : 0), 0);
-                    if (score >= 1 && l.outcome !== 'failure') {
-                        const conf = calculateConfidence(l);
-                        textPredictions.push({ ...l, confidence: conf });
-                    }
-                }
-            }
-            textPredictions.sort((a, b) => b.confidence - a.confidence);
-            if (predictions.length === 0 && textPredictions.length === 0) {
-                return [
-                    `🔮 **Brain Predict: "${ctx}"**`,
-                    ``,
-                    `No predictions yet — the brain hasn't seen this domain.`,
-                    ``,
-                    `💡 As you solve problems in this area and call \`learn_from_attempts\`, the CKG builds up and predictions become available.`,
-                ].join('\n');
-            }
-            const lines = [`🔮 **Brain Predict: "${ctx}"**\n`];
-            // CKG-based predictions
-            if (predictions.length > 0) {
-                const pSeen = new Set();
-                const pUniq = predictions.filter(p => { const k = `${p.concept}:${p.edgeType}:${p.target}`; if (pSeen.has(k))
-                    return false; pSeen.add(k); return true; })
-                    .sort((a, b) => b.confidence - a.confidence).slice(0, top_k);
-                lines.push(`### 🕸️ CKG Predictions (based on ${pUniq.length} known edges)`);
-                for (const p of pUniq) {
-                    const confPct = Math.round(p.confidence * 100);
-                    const icon = p.edgeType === 'fixes' ? '🔧' : p.edgeType === 'co-occurs' ? '🔄' : '⚡';
-                    lines.push(`${icon} **${confPct}%** \`${p.concept}\` _${p.edgeType}_ \`${p.target}\``);
-                    if (p.lesson?.what_worked)
-                        lines.push(`   ✅ ${p.lesson.what_worked.slice(0, 120)}`);
-                }
-                lines.push('');
-            }
-            // Text-based lesson predictions
-            if (textPredictions.length > 0) {
-                lines.push(`### 📚 Relevant Lessons (${Math.min(textPredictions.length, top_k)} pre-loaded)`);
-                for (const l of textPredictions.slice(0, top_k)) {
-                    const confPct = Math.round(l.confidence * 100);
-                    lines.push(`  ✅ **${confPct}%** \`${l.topic}\` — ${(l.what_worked ?? '').slice(0, 120)}`);
-                }
-                lines.push('');
-            }
-            lines.push(`💡 Outcome confirmed? \`learn_from_attempts(topic="fix:...", outcome="success", ...)\` → improves future predictions`);
-            return lines.join('\n');
-        }
-        // ── brain_plan: generative planning on top of the CKG ───────────────────────
-        // Where brain_predict answers "what might fail?", brain_plan answers "what
-        // should I do, in what order?". It reads the same lessons + CKG but reframes
-        // them as an actionable plan: ranked failure modes to avoid, ordered steps
-        // grounded in proven fixes (dependency-aware), and a pre-flight checklist.
-        case 'brain_plan': {
-            const { instance_id, task, top_k = 5 } = args;
-            if (!task || !task.trim()) {
-                throw new McpError(ErrorCode.InvalidParams, 'task is required');
-            }
-            const redis = await getConnection(instance_id);
-            const taskTokens = task.toLowerCase().replace(/[^a-z0-9\s\-_:]/g, ' ').split(/\s+/).filter(t => t.length > 2);
-            // Scan every best-lesson once and score by token overlap against the task.
-            const lessonKeys = [];
-            const lStream = redis.scanStream({ match: 'cachly:lesson:best:*', count: 200 });
-            await new Promise((res, rej) => { lStream.on('data', (b) => lessonKeys.push(...b)); lStream.on('end', res); lStream.on('error', rej); });
-            const scored = [];
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                const l = safeJsonParse(raw, null);
-                if (!l)
-                    continue;
-                const haystack = [l.topic, l.what_worked ?? '', l.what_failed ?? ''].join(' ').toLowerCase();
-                const score = taskTokens.reduce((s, t) => s + (haystack.includes(t) ? 1 : 0), 0);
-                if (score >= 1)
-                    scored.push({ l, score, confidence: calculateConfidence(l) });
-            }
-            if (scored.length === 0) {
-                return [
-                    `🗺️ **Brain Plan: "${task}"**`,
-                    ``,
-                    `No grounded plan yet — the brain hasn't seen this area.`,
-                    ``,
-                    `💡 As you work here and call \`learn_from_attempts\`, brain_plan will assemble`,
-                    `   an ordered, proven plan from your own history. For now, proceed carefully`,
-                    `   and capture what works.`,
-                ].join('\n');
-            }
-            // Rank: relevance first, then confidence. Split into failure modes (things
-            // that bit us before) vs. proven steps (successful fixes).
-            scored.sort((a, b) => (b.score - a.score) || (b.confidence - a.confidence));
-            const failureModes = scored.filter(s => s.l.outcome === 'failure' || (s.l.what_failed ?? '').trim().length > 0);
-            const provenSteps = scored.filter(s => s.l.outcome === 'success' || s.l.outcome === 'partial');
-            const lines = [`🗺️ **Brain Plan: "${task}"**`, '', `_Grounded in ${scored.length} relevant lesson${scored.length !== 1 ? 's' : ''} from your own Brain._`, ''];
-            // ── Section 1: failure modes to avoid, ranked by confidence ───────────────
-            if (failureModes.length > 0) {
-                lines.push(`### ⚠️ Likely failure modes (avoid these)`);
-                const sevRank = { critical: 0, major: 1, minor: 2 };
-                failureModes
-                    .slice()
-                    .sort((a, b) => (sevRank[a.l.severity ?? 'minor'] ?? 1) - (sevRank[b.l.severity ?? 'minor'] ?? 1) || b.confidence - a.confidence)
-                    .slice(0, top_k)
-                    .forEach(({ l, confidence }) => {
-                    const sevEmoji = l.severity === 'critical' ? '🔴' : l.severity === 'major' ? '🟡' : '🟢';
-                    const detail = (l.what_failed ?? l.what_worked ?? '').slice(0, 120);
-                    lines.push(`${sevEmoji} **${Math.round(confidence * 100)}%** \`${l.topic}\`${detail ? ` — ${detail}` : ''}`);
-                });
-                lines.push('');
-            }
-            // ── Section 2: ordered, proven steps (dependency-aware) ───────────────────
-            if (provenSteps.length > 0) {
-                // Order steps so that any step a lesson depends_on comes first. We only
-                // have topics + depends_on links; do a light topological pass over the
-                // selected set, falling back to relevance order for anything unresolved.
-                const selected = provenSteps.slice(0, top_k);
-                const byTopic = new Map(selected.map(s => [s.l.topic, s]));
-                const ordered = [];
-                const placed = new Set();
-                const place = (s, depth) => {
-                    if (placed.has(s.l.topic) || depth > 10)
-                        return;
-                    for (const dep of s.l.depends_on ?? []) {
-                        const depEntry = byTopic.get(dep);
-                        if (depEntry && !placed.has(dep))
-                            place(depEntry, depth + 1);
-                    }
-                    if (!placed.has(s.l.topic)) {
-                        placed.add(s.l.topic);
-                        ordered.push(s);
-                    }
-                };
-                for (const s of selected)
-                    place(s, 0);
-                lines.push(`### 🔧 Recommended steps (proven fixes, in order)`);
-                ordered.forEach(({ l, confidence }, i) => {
-                    lines.push(`${i + 1}. **${Math.round(confidence * 100)}%** \`${l.topic}\` — ${(l.what_worked ?? '').slice(0, 140)}`);
-                    const cmds = (l.commands ?? []).slice(0, 2);
-                    if (cmds.length > 0)
-                        lines.push(`   \`\`\`\n   ${cmds.join('\n   ')}\n   \`\`\``);
-                    if ((l.depends_on ?? []).length > 0)
-                        lines.push(`   ↳ depends on: ${(l.depends_on ?? []).map(d => `\`${d}\``).join(', ')}`);
-                });
-                lines.push('');
-            }
-            // ── Section 3: pre-flight checklist ──────────────────────────────────────
-            const checklist = scored
-                .filter(s => (s.l.file_paths ?? []).length > 0 || (s.l.commands ?? []).length > 0)
-                .slice(0, 4);
-            if (checklist.length > 0) {
-                lines.push(`### ✅ Pre-flight checklist`);
-                const touchedFiles = [...new Set(checklist.flatMap(s => s.l.file_paths ?? []))].slice(0, 6);
-                if (touchedFiles.length > 0) {
-                    lines.push(`  • Review files that were involved before: ${touchedFiles.map(f => `\`${f}\``).join(', ')}`);
-                }
-                lines.push(`  • Confirm the top failure mode above can't recur in your change`);
-                lines.push(`  • Have a rollback ready for any \`critical\`/\`major\` step`);
-                lines.push('');
-            }
-            lines.push(`💡 After you ship: \`learn_from_attempts(topic="...", outcome="success", ...)\` → the next plan gets sharper.`);
-            return lines.join('\n');
-        }
-        // ── W10: Domain Brains marketplace — brain_marketplace ──────────────────────
-        // Browse curated, installable packs of high-trust community lessons by domain.
-        case 'brain_marketplace': {
-            const { min_confirms = 1 } = args;
-            const params = new URLSearchParams();
-            if (min_confirms && min_confirms > 1)
-                params.set('min_confirms', String(min_confirms));
-            const res = await apiFetch(`/api/v1/syndication/brains${params.toString() ? `?${params}` : ''}`);
-            if (!res.brains || res.brains.length === 0) {
-                return [
-                    `## 🧠 Domain Brain Marketplace`,
-                    ``,
-                    `No domain brains are available yet — the marketplace fills as the community`,
-                    `contributes verified lessons. Be an early contributor:`,
-                    `\`syndicate(topic="k8s:oom-kill", what_worked="raise memory limit + add probe")\``,
-                ].join('\n');
-            }
-            const lines = [
-                `## 🧠 Domain Brain Marketplace`,
-                `*${res.count} installable brain${res.count === 1 ? '' : 's'} · curated from the global Knowledge Commons*`,
-                ``,
-            ];
-            for (const b of res.brains) {
-                const badge = b.curated ? '⭐ curated' : 'community';
-                lines.push(`### ${b.icon} ${b.name}  \`${b.slug}\``, `${b.description}`, `**${b.lesson_count}** lesson${b.lesson_count === 1 ? '' : 's'} · 🤝 ${b.total_confirms} community confirm${b.total_confirms === 1 ? '' : 's'} · ${badge}`, `Install: \`brain_install(slug="${b.slug}")\``, ``);
-            }
-            lines.push(`---`, `_Installed brains merge into your local Brain and surface in \`smart_recall\` — they never override your own lessons._`);
-            return lines.join('\n');
-        }
-        // ── W10: Domain Brains marketplace — brain_install ──────────────────────────
-        // Pull a domain brain's curated lessons into the local Brain so they're
-        // available offline in smart_recall. Idempotent + non-destructive: never
-        // clobbers the user's own lessons (only prior marketplace installs).
-        case 'brain_install': {
-            const { instance_id, slug, min_confirms = 1, limit = 200, dry_run = false } = args;
-            const cleanSlug = typeof slug === 'string' ? slug.trim() : '';
-            if (!cleanSlug) {
-                throw new McpError(ErrorCode.InvalidParams, 'slug is required — run brain_marketplace() to see available domain brains');
-            }
-            const params = new URLSearchParams();
-            if (min_confirms && min_confirms > 1)
-                params.set('min_confirms', String(min_confirms));
-            if (limit && limit !== 200)
-                params.set('limit', String(Math.min(Math.max(1, limit), 500)));
-            const pack = await apiFetch(`/api/v1/syndication/brains/${encodeURIComponent(cleanSlug)}${params.toString() ? `?${params}` : ''}`);
-            if (!pack.lessons || pack.lessons.length === 0) {
-                return `No installable lessons found for domain brain \`${cleanSlug}\`. Run \`brain_marketplace()\` to see what's available.`;
-            }
-            if (dry_run) {
-                return [
-                    `## 📦 ${pack.name} (DRY RUN)`,
-                    `Would install **${pack.lessons.length}** lesson${pack.lessons.length === 1 ? '' : 's'} into your Brain.`,
-                    ``,
-                    ...pack.lessons.slice(0, 15).map(l => `  • \`${l.topic}\` · 🤝 ${l.confirm_count}`),
-                    pack.lessons.length > 15 ? `  …and ${pack.lessons.length - 15} more` : '',
-                    ``,
-                    `Run without \`dry_run\` to install: \`brain_install(slug="${cleanSlug}")\``,
-                ].filter(Boolean).join('\n');
-            }
-            const redis = await getConnection(instance_id);
-            const source = `marketplace:${cleanSlug}`;
-            const now = new Date().toISOString();
-            let installed = 0;
-            let skipped = 0;
-            for (const l of pack.lessons) {
-                if (!l.topic || !l.what_worked) {
-                    skipped++;
-                    continue;
-                }
-                const bestKey = `cachly:lesson:best:${l.topic}`;
-                // Never clobber a user's own lesson (or a prior install from a different brain).
-                const existing = await redis.get(bestKey);
-                if (existing) {
-                    const parsed = safeJsonParse(existing, null);
-                    if (parsed && parsed.source !== source) {
-                        skipped++;
-                        continue;
-                    }
-                }
-                // Tags arrive as a JSON string from the commons; normalise to an array.
-                const tags = (() => {
-                    const t = safeJsonParse(l.tags, []);
-                    return Array.isArray(t) ? t.filter((x) => typeof x === 'string') : [];
-                })();
-                const record = JSON.stringify({
-                    topic: l.topic,
-                    outcome: l.outcome || 'success',
-                    what_worked: l.what_worked,
-                    what_failed: l.what_failed || '',
-                    severity: l.severity || 'minor',
-                    tags,
-                    visibility: 'team',
-                    confidence: calculateConfidence({ ts: now, verified_at: now, recall_count: l.confirm_count }),
-                    recall_count: 0,
-                    source,
-                    ts: now,
-                    verified_at: now,
-                    version: 3,
-                });
-                await redis.set(bestKey, record);
-                const listKey = `cachly:lessons:${l.topic}`;
-                await redis.rpush(listKey, record);
-                await redis.ltrim(listKey, -100, -1);
-                await redis.expire(listKey, 90 * 86400);
-                installed++;
-            }
-            // Stamp born_at so time-to-first-recall counts from the install moment.
-            await redis.set(`cachly:stats:born_at:${instance_id}`, now, 'EX', 365 * 86400, 'NX').catch(() => { });
-            return [
-                `## 📦 Installed: ${pack.name}`,
-                ``,
-                `**${installed}** lesson${installed === 1 ? '' : 's'} merged into your Brain${skipped > 0 ? ` · ${skipped} skipped (your own lessons take priority)` : ''}.`,
-                ``,
-                `They're live in \`smart_recall\` now — try a query in this domain:`,
-                `  • \`smart_recall(query="${pack.lessons[0]?.topic.split(':').pop() ?? 'your problem'}")\``,
-                ``,
-                `_Installed lessons are tagged \`source: "${source}"\` and never override your own. Re-run anytime to pull updates._`,
-            ].join('\n');
-        }
-        // ── brain_conflicts: list live belief conflicts + active agents ─────────────
-        // Surfaces every unresolved belief_conflict marker (a previously confirmed
-        // fix now contradicted by a failure) plus the agents currently writing to
-        // this Brain. This is the arbitration inbox for multi-agent teams (Move 4).
-        case 'brain_conflicts': {
-            const { instance_id } = args;
-            const redis = await getConnection(instance_id);
-            const conflictKeys = [];
-            const cStream = redis.scanStream({ match: 'cachly:ckg:conflict:*', count: 100 });
-            await new Promise((resolve, reject) => {
-                cStream.on('data', (batch) => conflictKeys.push(...batch));
-                cStream.on('end', resolve);
-                cStream.on('error', reject);
-            });
-            const conflicts = [];
-            if (conflictKeys.length > 0) {
-                const raws = await redis.mget(...conflictKeys);
-                for (const raw of raws) {
-                    const c = safeJsonParse(raw ?? null, null);
-                    if (c && !c.resolved)
-                        conflicts.push(c);
-                }
-            }
-            const agentKeys = [];
-            const aStream = redis.scanStream({ match: 'cachly:agents:active:*', count: 100 });
-            await new Promise((resolve, reject) => {
-                aStream.on('data', (batch) => agentKeys.push(...batch));
-                aStream.on('end', resolve);
-                aStream.on('error', reject);
-            });
-            const agents = [];
-            if (agentKeys.length > 0) {
-                const raws = await redis.mget(...agentKeys);
-                for (const raw of raws) {
-                    const a = safeJsonParse(raw ?? null, null);
-                    if (a)
-                        agents.push(a);
-                }
-            }
-            const lines = [`## ⚔️ Brain Conflicts & Live Agents`, ``];
-            lines.push(`**🤖 Active agents (last 1h):** ${agents.length}`);
-            if (agents.length > 0) {
-                for (const a of agents.sort((x, y) => y.ts.localeCompare(x.ts)).slice(0, 10)) {
-                    const ago = Math.round((Date.now() - new Date(a.ts).getTime()) / 60000);
-                    lines.push(`  - **${a.author}** — last: \`${a.last_topic ?? '?'}\` (${a.last_outcome ?? '?'}, ${ago}m ago)`);
-                }
-            }
-            lines.push('');
-            if (conflicts.length === 0) {
-                lines.push(`**✅ No unresolved belief conflicts.** The Brain is in consensus.`);
-                return lines.join('\n');
-            }
-            lines.push(`**⚠️ Unresolved belief conflicts:** ${conflicts.length}`);
-            lines.push('');
-            lines.push(`| Topic | Confirmed fix | Contradicted by | Detected |`);
-            lines.push(`|---|---|---|---|`);
-            for (const c of conflicts.sort((x, y) => y.detected_at.localeCompare(x.detected_at)).slice(0, 20)) {
-                const ago = Math.round((Date.now() - new Date(c.detected_at).getTime()) / 3600000);
-                lines.push(`| \`${c.topic}\` | ${(c.fix_confidence * 100).toFixed(0)}% (n=${c.fix_trials}) | ${c.reported_by ?? 'unknown'} | ${ago}h ago |`);
-            }
-            lines.push('');
-            lines.push(`_Arbitrate with \`brain_resolve_conflict(instance_id="${instance_id}", topic="<topic>", winner="success"|"failure")\`._`);
-            return lines.join('\n');
-        }
-        // ── brain_resolve_conflict: arbitrate a belief conflict ─────────────────────
-        // Picks a winning side for a contested topic. The losing side's CKG fixes
-        // edges are decayed to near-zero confidence and the loser's `best` lesson is
-        // archived; the winner is reinforced. The resolution is recorded so the
-        // conflict no longer surfaces. Human-in-the-loop is the strongest signal.
-        case 'brain_resolve_conflict': {
-            const { instance_id, topic, winner, resolved_by = 'human' } = args;
-            if (!topic || !topic.trim()) {
-                throw new McpError(ErrorCode.InvalidParams, 'topic is required');
-            }
-            if (winner !== 'success' && winner !== 'failure') {
-                throw new McpError(ErrorCode.InvalidParams, 'winner must be "success" or "failure"');
-            }
-            const redis = await getConnection(instance_id);
-            const conceptId = ckgSlug(topic);
-            const conflictKey = `cachly:ckg:conflict:${conceptId}`;
-            const markerRaw = await redis.get(conflictKey);
-            if (!markerRaw) {
-                return `📭 No active conflict found for \`${topic}\`. Run \`brain_conflicts(instance_id="${instance_id}")\` to list open conflicts.`;
-            }
-            // ── Decay the losing side's `fixes` edges ─────────────────────────────────
-            // winner=success → the fix is real; keep fixes edges, no decay.
-            // winner=failure → the fix is wrong; decay fixes edges to 0.1.
-            let decayedEdges = 0;
-            if (winner === 'failure') {
-                const fromKeys = await redis.smembers(`cachly:ckg:idx:from:${conceptId}`);
-                for (const ek of fromKeys) {
-                    const er = await redis.get(ek);
-                    if (!er)
-                        continue;
-                    const edge = safeJsonParse(er, null);
-                    if (!edge || edge.edgeType !== 'fixes')
-                        continue;
-                    edge.confidence = 0.1;
-                    await redis.set(ek, JSON.stringify(edge));
-                    decayedEdges++;
-                }
-            }
-            // ── Archive the losing `best` lesson (if its outcome is the losing side) ──
-            let archivedLesson = false;
-            const bestKey = `cachly:lesson:best:${topic}`;
-            const bestRaw = await redis.get(bestKey);
-            if (bestRaw) {
-                const lesson = safeJsonParse(bestRaw, null);
-                if (lesson && lesson.outcome === winner) {
-                    // The surviving lesson matches the winner — reinforce by clearing any provisional state.
-                    if (lesson.state === 'provisional') {
-                        lesson.state = 'active';
-                        lesson.verified_at = new Date().toISOString();
-                        await redis.set(bestKey, JSON.stringify(lesson));
-                    }
-                }
-                else if (lesson && lesson.outcome && lesson.outcome !== winner) {
-                    // The stored best lesson is the losing side — archive it.
-                    lesson.state = 'archived';
-                    lesson.audit_trail = [
-                        ...(Array.isArray(lesson.audit_trail) ? lesson.audit_trail : []),
-                        { ts: new Date().toISOString(), action: 'conflict_loser_archived', resolved_by },
-                    ];
-                    await redis.set(bestKey, JSON.stringify(lesson));
-                    archivedLesson = true;
-                }
-            }
-            // ── Mark the conflict resolved ────────────────────────────────────────────
-            const marker = safeJsonParse(markerRaw, null) ?? {};
-            marker.resolved = true;
-            marker.winner = winner;
-            marker.resolved_by = resolved_by;
-            marker.resolved_at = new Date().toISOString();
-            await redis.set(conflictKey, JSON.stringify(marker), 'EX', 60 * 60 * 24 * 30);
-            return [
-                `## ✅ Conflict resolved — \`${topic}\``,
-                ``,
-                `**Winner:** ${winner === 'success' ? '✅ success (fix is valid)' : '❌ failure (fix retired)'}`,
-                `**Resolved by:** ${resolved_by}`,
-                ``,
-                `- CKG \`fixes\` edges decayed: **${decayedEdges}**`,
-                `- Losing lesson archived: **${archivedLesson ? 'yes' : 'no'}**`,
-                ``,
-                winner === 'failure'
-                    ? `_The contradicted fix is retired. smart_recall will stop surfacing it; future attempts start fresh._`
-                    : `_The fix is reaffirmed. The contradicting failure no longer blocks recall._`,
-            ].join('\n');
-        }
-        // ── v4 Move 1: brain_confirm_ci — closed-loop CI learning ────────────────
-        case 'brain_confirm_ci': {
-            const { instance_id, job_status, topics, scan_topics = [], source = 'manual', } = args;
-            if (!job_status || !['success', 'failure', 'cancelled'].includes(job_status)) {
-                throw new Error('job_status must be success, failure, or cancelled');
-            }
-            if (!topics?.length)
-                throw new Error('topics is required');
-            if (job_status === 'cancelled') {
-                return '⏭️ CI was cancelled — no confidence changes applied.';
-            }
-            let result;
-            try {
-                result = await apiFetch(`/api/v1/instances/${instance_id}/ci-outcome`, {
-                    method: 'POST',
-                    body: JSON.stringify({ job_status, topics, scan_topics, source }),
-                });
-            }
-            catch {
-                return `⚠️ Could not reach Brain API — CI outcome not recorded. Will retry on next call.`;
-            }
-            if (result.updated === 0) {
-                return [
-                    `🤖 **brain_confirm_ci** — CI ${job_status}`,
-                    '',
-                    `No confidence changes (no matching predictions for these topics).`,
-                    `Topics checked: ${topics.slice(0, 5).map(t => `\`${t}\``).join(', ')}${topics.length > 5 ? ` +${topics.length - 5} more` : ''}`,
-                ].join('\n');
-            }
-            const lines = [
-                `🤖 **brain_confirm_ci** — CI ${job_status === 'success' ? '✅' : '❌'} · ${result.updated} lesson${result.updated !== 1 ? 's' : ''} updated`,
-                '',
-                `| Topic | Old | New | Δ | Reason |`,
-                `|---|---|---|---|---|`,
-            ];
-            for (const d of result.confidence_deltas) {
-                const sign = d.delta > 0 ? '+' : '';
-                const icon = d.reason === 'confirmed_failure' ? '🔴' : '🟡';
-                lines.push(`| \`${d.topic}\` | ${(d.old * 100).toFixed(0)}% | ${(d.new * 100).toFixed(0)}% | ${sign}${(d.delta * 100).toFixed(0)}% | ${icon} ${d.reason} |`);
-            }
-            lines.push('', `_Brain self-calibrated from real CI signal. No manual \`learn_from_attempts\` needed._`);
-            return lines.join('\n');
-        }
-        case 'brain_briefing': {
-            const { instance_id, event_type, context, threshold, } = args;
-            if (!['file_open', 'pr_open', 'deploy', 'manual'].includes(event_type)) {
-                throw new Error('event_type must be file_open, pr_open, deploy, or manual');
-            }
-            if (!context?.trim())
-                throw new Error('context is required');
-            let result;
-            try {
-                result = await apiFetch(`/api/v1/instances/${instance_id}/briefing`, {
-                    method: 'POST',
-                    body: JSON.stringify({ event_type, context, ...(threshold !== undefined ? { threshold } : {}) }),
-                });
-            }
-            catch {
-                return `⚠️ Could not reach Brain API — no proactive briefing available right now.`;
-            }
-            const eventIcon = event_type === 'file_open' ? '📂' : event_type === 'pr_open' ? '🔀' : event_type === 'deploy' ? '🚀' : '🔍';
-            if (result.warnings.length === 0) {
-                return [
-                    `${eventIcon} **brain_briefing** — ${event_type} · ✅ no known risk patterns matched`,
-                    '',
-                    `Checked against ${result.matched_lessons} related lesson${result.matched_lessons !== 1 ? 's' : ''}. You're clear to proceed.`,
-                ].join('\n');
-            }
-            const riskIcon = result.risk_level === 'high' ? '🔴' : result.risk_level === 'medium' ? '🟡' : '🟢';
-            const lines = [
-                `${eventIcon} **brain_briefing** — ${event_type} · ${riskIcon} risk: ${result.risk_level.toUpperCase()}`,
-                '',
-                `The Brain proactively found ${result.warnings.length} known pattern${result.warnings.length !== 1 ? 's' : ''} that may apply here:`,
-                '',
-                `| Topic | Confidence | Severity | What to watch | Known fix |`,
-                `|---|---|---|---|---|`,
-            ];
-            for (const w of result.warnings) {
-                const fix = w.fix ? (w.fix.length > 80 ? w.fix.slice(0, 80) + '…' : w.fix) : '—';
-                lines.push(`| \`${w.topic}\` | ${(w.confidence * 100).toFixed(0)}% | ${w.severity} | ${w.message} | ${fix} |`);
-            }
-            lines.push('', `_Surfaced proactively — no \`smart_recall\` needed. Address the highest-confidence items first._`);
-            return lines.join('\n');
-        }
-        // ── Layer 3: MADC ─────────────────────────────────────────────────────────
-        default:
-            return null;
-    }
-}
-//# sourceMappingURL=syndicate.js.map
+import{McpError as T,ErrorCode as C}from"@modelcontextprotocol/sdk/types.js";import{calculateConfidence as I}from"../confidence.js";import{ckgSlug as M}from"../ckg.js";import{keywordSearch as K}from"../search.js";import{safeJsonParse as S}from"../utils.js";async function B(x,y,v,b,a){const t=(await a(`/api/v1/instances/${x}`).catch(()=>null))?.org_id;if(!t)return null;let c=null;try{c=await a(`/api/v1/orgs/${t}/brain/predict`,{method:"POST",body:JSON.stringify({context:y,top_k:v})})}catch{return null}return!c||!c.warnings||c.warnings.length===0?null:await O(y,c,b,a)}async function N(x,y,v){const b=y.warnings[0]?.problem||x;if(!b)return[];try{const a=await v(`/api/v1/syndication/search?q=${encodeURIComponent(b)}&limit=3`),n=new Set(y.warnings.map(t=>t.problem));return(a.results??[]).filter(t=>!!t.topic&&!!t.what_worked&&!n.has(t.topic)).slice(0,3).map(t=>({topic:t.topic,what_worked:t.what_worked.slice(0,160)}))}catch{return[]}}async function O(x,y,v,b){const a=[`\u{1F52E} **Org Brain Predict: "${x}"**`,""];for(const n of y.warnings){const t=Math.max(0,n.team_span-1),c=n.recurrence.reduce((l,r)=>l+(r.count??0),0),s=n.severity==="critical"?"\u{1F534}":n.severity==="major"?"\u{1F7E0}":"\u{1F7E1}";n.team_span>=2?a.push(`\u26A0\uFE0F **CROSS-TEAM RISK** \u2014 this pattern failed ${c}\xD7 across ${t} other team${t===1?"":"s"}:`):a.push(`\u26A0\uFE0F **RISK** \u2014 this pattern failed ${c}\xD7 before:`),a.push(`   ${s} problem: \`${n.problem}\``);for(const l of n.recurrence.slice(0,6)){const r=l.last_seen?` (last: ${l.last_seen.slice(0,10)})`:"";a.push(`      \u2022 ${l.team}  \xD7${l.count}${r}`)}const f=n.fixes[0];if(f){const l=Math.round((f.confidence??0)*100),r=f.source_team?` (${f.source_team})`:"";a.push(`   \u2705 Proven fix \u2014 ${l}% confidence, confirmed ${f.confirm_count}\xD7${r}:`),a.push(`      ${f.summary}`)}a.push("")}if(v==="org+commons"){const n=await N(x,y,b);if(n.length>0){a.push("\u{1F310} **From the public Knowledge Commons** (cross-org, lower-signal):");for(const t of n)a.push(`   \u2022 \`${t.topic}\` \u2014 ${t.what_worked}`);a.push("")}}return a.push('\u{1F4A1} Heeded the warning? `learn_from_attempts(..., tags=["prevented-by-org-graph"])` \u2192 counts as a prevented cross-team mistake.'),a.join(`
+`)}const A=new Set(["syndicate","syndicate_search","syndicate_stats","syndicate_trending","brain_search","ckg_inspect","brain_predict","brain_plan","brain_marketplace","brain_install","brain_conflicts","brain_resolve_conflict","brain_confirm_ci","brain_briefing"]);async function W(x,y,v,b){switch(x){case"syndicate":{const{topic:a,outcome:n="success",what_worked:t,what_failed:c="",severity:s="minor",tags:f=[],scope:l="public"}=y;if(!a||!t)throw new T(C.InvalidParams,"topic and what_worked are required");const o=await b("/api/v1/syndication/contribute",{method:"POST",body:JSON.stringify({topic:a,outcome:n,what_worked:t,what_failed:c,severity:s,tags:f,scope:l})}),p=l==="org"?"\u{1F3E2} org-private":"\u{1F310} global commons",u=o.deduped?`
+> \u267B\uFE0F Duplicate detected \u2014 trust score incremented for the existing lesson.`:"";return[`${l==="org"?"\u{1F3E2}":"\u{1F310}"} **Lesson syndicated to the ${l==="org"?"org Knowledge Commons":"global Knowledge Commons"}**${u}`,"",`**ID:** \`${o.id}\``,`**Topic:** \`${o.topic}\` \xB7 **Outcome:** ${o.outcome} \xB7 **Scope:** ${p}`,"",l==="org"?'This lesson is visible only within your organisation. Use `syndicate_search(scope="org")` to find it.':"Your lesson is now searchable by every AI brain in the network.","When another instance confirms it works, its trust score rises \u2014 and so does your contributor reputation.","",`**Tip:** Use \`syndicate_search(q="${a}")\` to see all community lessons on this topic.`].join(`
+`)}case"syndicate_search":{const{q:a="",limit:n=20,category:t="",scope:c=""}=y,s=new URLSearchParams;a&&s.set("q",a),t&&s.set("category",t),c&&s.set("scope",c),s.set("limit",String(Math.min(Math.max(1,n),50)));const f=await b(`/api/v1/syndication/search?${s}`);if(!f.results||f.results.length===0)return a?`No lessons found for "${a}" in the global Knowledge Commons yet.
+
+Be the first to contribute: \`syndicate(topic="...", what_worked="...")\``:'The global Knowledge Commons is empty. Be the first contributor:\n`syndicate(topic="deploy:api", what_worked="...")`';const l=i=>i==="success"?"\u2705":i==="failure"?"\u274C":"\u26A0\uFE0F",r=i=>i==="critical"?"\u{1F534}":i==="major"?"\u{1F7E1}":"\u{1F7E2}",o=i=>{const d=Math.min(10,Math.round(i/5));return"\u2588".repeat(d)+"\u2591".repeat(10-d)+` \xD7${i}`},p=[a,t].filter(Boolean).join(" \xB7 "),u=[`## \u{1F310} Global Knowledge Commons${p?` \u2014 ${p}`:" \u2014 Recent"}`,`*${f.count} lesson${f.count===1?"":"s"} found*`,""];for(const i of f.results)u.push(`### ${l(i.outcome)} \`${i.topic}\` ${r(i.severity)}`,`**Trust:** ${o(i.confirm_count)}`,i.what_worked?`**What worked:** ${i.what_worked}`:"",i.what_failed?`**What failed:** ${i.what_failed}`:"",`*Contributed ${new Date(i.created_at).toLocaleDateString("de-DE")} \xB7 ID: \`${i.id}\`*`,"");return u.push("---",`**Confirm** (this helped you): \`syndicate(topic="${f.results[0]?.topic??"..."}", what_worked="...")\` \u2192 auto-deduped, trust +1`,'**Contribute your own:** `syndicate(topic="fix:...", what_worked="...")`','**Filter by category:** `syndicate_search(category="fix")`'),u.filter(i=>i!=="").join(`
+`)}case"syndicate_stats":{const a=await b("/api/v1/syndication/stats"),n=c=>{const s=Math.min(10,Math.round(c/5));return"\u2588".repeat(s)+"\u2591".repeat(10-s)+` \xD7${c}`},t=["## \u{1F310} Global Knowledge Commons \u2014 Stats","","| Metric | Value |","|---|---|",`| Total lessons | **${a.total_lessons.toLocaleString()}** |`,`| Total confirms | **${a.total_confirms.toLocaleString()}** |`,`| Added last 7 days | **${a.added_last_7_days}** |`,"","### Top Categories"];for(const c of a.top_categories??[])t.push(`- \`${c.category}\` \u2014 ${c.count} lesson${c.count===1?"":"s"}`);t.push("","### Most Trusted Lessons");for(const c of a.most_trusted??[])t.push(`**\`${c.topic}\`** ${n(c.confirm_count)}`,`> ${c.what_worked.slice(0,120)}${c.what_worked.length>120?"\u2026":""}`,"");if(t.push("---",'**Contribute:** `syndicate(topic="...", what_worked="...")`  |  **Search:** `syndicate_search(q="your problem")`'),a.top_contributors?.length){t.push("","### \u{1F3C5} Top Contributors (anonymous)");for(const c of a.top_contributors)t.push(`- Trust **${c.trust_score}** \xB7 ${c.lessons_count} lesson${c.lessons_count===1?"":"s"} \xB7 ${c.confirms_received} confirms received`)}return t.join(`
+`)}case"syndicate_trending":{const{limit:a=10}=y,n=new URLSearchParams({limit:String(Math.min(Math.max(1,a),50))}),t=await b(`/api/v1/syndication/trending?${n}`);if(!t.results||t.results.length===0)return["## \u{1F4C8} Trending in the Knowledge Commons","","No trending lessons yet (need at least 2 confirms in the last 7 days).","",'Contribute and confirm lessons to see them trend: `syndicate(topic="...", what_worked="...")`'].join(`
+`);const c=o=>o==="success"?"\u2705":o==="failure"?"\u274C":"\u26A0\uFE0F",s=o=>o==="critical"?"\u{1F534}":o==="major"?"\u{1F7E1}":"\u{1F7E2}",f=o=>{const p=Math.min(10,Math.round(o/5));return"\u2588".repeat(p)+"\u2591".repeat(10-p)+` \xD7${o}`},l=o=>{const p=Math.min(10,Math.round(o*2));return"\u25B2".repeat(p)+"\u25B3".repeat(10-p)+` ${o.toFixed(2)}/day`},r=["## \u{1F4C8} Trending in the Knowledge Commons","*Lessons with the fastest confirmation velocity in the last 7 days*",""];for(const o of t.results)r.push(`### ${c(o.outcome)} \`${o.topic}\` ${s(o.severity)}`,`**Trend:** ${l(o.trend_score)}  |  **Trust:** ${f(o.confirm_count)}`,o.what_worked?`**What worked:** ${o.what_worked.slice(0,200)}${o.what_worked.length>200?"\u2026":""}`:"",`*ID: \`${o.id}\` \xB7 ${new Date(o.created_at).toLocaleDateString("de-DE")}*`,"");return r.push("---",`**Confirm** (if this helped you): \`syndicate(topic="${t.results[0]?.topic??"..."}", what_worked="...")\` \u2192 auto-deduped, trust +1`,'**All trending:** `syndicate_trending(limit=50)`  |  **Search:** `syndicate_search(q="...")`'),r.filter(o=>o!=="").join(`
+`)}case"brain_search":{const{instance_id:a,query:n,limit:t=15}=y,c=await v(a),s=await K(c,["cachly:lesson:best:*","cachly:ctx:*","cachly:idx:*","cachly:session:last","cachly:session:handoff","cachly:roadmap:*","cachly:ckg:node:*"],n,t);if(s.length===0)return[`\u{1F50E} **Brain Search: "${n}"**`,"","No results found across all brain data.","","\u{1F4A1} Try `smart_recall` or check `list_remembered`."].join(`
+`);const f=[`\u{1F50E} **Brain Search: "${n}"** \u2014 ${s.length} result${s.length!==1?"s":""} across all brain data
+`];for(const l of s.slice(0,t)){const r=l.key.startsWith("cachly:lesson:")?"\u{1F4A1} lesson":l.key.startsWith("cachly:ctx:")?"\u{1F4DD} context":l.key.startsWith("cachly:idx:")?"\u{1F4C2} index":l.key.startsWith("cachly:session:")?"\u{1F550} session":l.key.startsWith("cachly:roadmap:")?"\u{1F5FA}\uFE0F roadmap":l.key.startsWith("cachly:ckg:node:")?"\u{1F578}\uFE0F ckg-node":"\u{1F5C4}\uFE0F data",o=l.content.slice(0,280).replace(/\n/g," ");f.push(`**${r}** \`${l.key.split(":").slice(2).join(":")}\` _(BM25: ${l.score.toFixed(2)})_`),f.push(`> ${o}${l.content.length>280?"\u2026":""}
+`)}return f.join(`
+`)}case"ckg_inspect":{const{instance_id:a,concept:n,max_hops:t=2}=y,c=await v(a),s=M(n),f=new Set,l=[],r=[{id:s,hop:0}];for(;r.length>0;){const{id:e,hop:h}=r.shift();if(f.has(e)||h>t)continue;f.add(e);const g=await c.smembers(`cachly:ckg:idx:from:${e}`),m=await c.smembers(`cachly:ckg:idx:to:${e}`);for(const w of[...g,...m].slice(0,50)){const $=await c.get(w);if(!$)continue;const _=S($,null);_&&(l.push(_),h<t&&(f.has(_.from)||r.push({id:_.from,hop:h+1}),f.has(_.to)||r.push({id:_.to,hop:h+1})))}}if(l.length===0){const e=[],h=c.scanStream({match:`cachly:ckg:node:*${s}*`,count:100});if(await new Promise((m,w)=>{h.on("data",$=>e.push(...$)),h.on("end",m),h.on("error",w)}),e.length===0)return[`\u{1F578}\uFE0F **CKG Inspect: "${n}"**`,"","No CKG nodes found. The graph builds automatically as you call `learn_from_attempts`.","","\u{1F4A1} Once you have lessons stored, CKG edges will appear here."].join(`
+`);const g=e.slice(0,10).map(m=>`  \u2022 \`${m.replace("cachly:ckg:node:","")}\``).join(`
+`);return[`\u{1F578}\uFE0F **CKG Inspect: "${n}"**`,"",`No edges found for \`${s}\`, but found similar nodes:`,g,"",'Try: `ckg_inspect(concept="<exact-node-id>")`'].join(`
+`)}const o=new Set,p=l.filter(e=>{const h=`${e.from}:${e.edgeType}:${e.to}`;return o.has(h)?!1:(o.add(h),!0)}).sort((e,h)=>h.confidence-e.confidence),u={fixes:"\u{1F527}",requires:"\u{1F517}","co-occurs":"\u{1F504}",causes:"\u26A1",contradicts:"\u26A0\uFE0F",degrades_under:"\u{1F4C9}"},i=[`\u{1F578}\uFE0F **CKG Inspect: "${n}"** (${p.length} edge${p.length!==1?"s":""}, ${f.size} node${f.size!==1?"s":""} traversed)
+`],d=new Map;for(const e of p)d.has(e.edgeType)||d.set(e.edgeType,[]),d.get(e.edgeType).push(e);for(const[e,h]of d){const g=u[e]??"\u2192";i.push(`**${g} ${e}** (${h.length})`);for(const m of h.slice(0,8)){const w=Math.round(m.confidence*100),$="\u2593".repeat(Math.round(w/10))+"\u2591".repeat(10-Math.round(w/10));i.push(`  \`${m.from}\` \u2192 \`${m.to}\`  ${$} ${w}% (${m.successes.toFixed(1)}/${m.trials} trials)`)}i.push("")}return i.push(`\u{1F4A1} Expand: \`ckg_inspect(concept="${n}", max_hops=3)\`  |  Predict: \`brain_predict(context="${n}")\``),i.join(`
+`)}case"brain_predict":{const{instance_id:a,context:n,top_k:t=5,scope:c="instance"}=y;if(c==="org"||c==="org+commons"){const i=await B(a,n,t,c,b);if(i!==null)return i}const s=await v(a),f=n.toLowerCase().replace(/[^a-z0-9\s\-_:]/g," ").split(/\s+/).filter(i=>i.length>2),l=[];for(const i of f.slice(0,6)){const d=[],e=s.scanStream({match:`cachly:ckg:node:*${i}*`,count:50});await new Promise((h,g)=>{e.on("data",m=>d.push(...m)),e.on("end",h),e.on("error",g)});for(const h of d.slice(0,5)){const g=await s.get(h);if(!g)continue;const m=S(g,null);if(!m)continue;const w=await s.smembers(`cachly:ckg:idx:from:${m.id}`);for(const $ of w.slice(0,20)){const _=await s.get($);if(!_)continue;const k=S(_,null);if(!k||k.edgeType!=="fixes"&&k.edgeType!=="co-occurs"&&k.edgeType!=="causes")continue;const j=await s.get(`cachly:lesson:best:${k.from}`),P=j?S(j,null)??void 0:void 0;l.push({concept:m.id,edgeType:k.edgeType,target:k.to,confidence:k.confidence,lesson:P})}}}const r=[],o=[],p=s.scanStream({match:"cachly:lesson:best:*",count:200});await new Promise((i,d)=>{p.on("data",e=>o.push(...e)),p.on("end",i),p.on("error",d)});for(const i of o){const d=await s.get(i);if(d){const e=S(d,null);if(!e)continue;const h=[e.topic,e.what_failed??"",e.what_worked??""].join(" ").toLowerCase();if(f.reduce((m,w)=>m+(h.includes(w)?1:0),0)>=1&&e.outcome!=="failure"){const m=I(e);r.push({...e,confidence:m})}}}if(r.sort((i,d)=>d.confidence-i.confidence),l.length===0&&r.length===0)return[`\u{1F52E} **Brain Predict: "${n}"**`,"","No predictions yet \u2014 the brain hasn't seen this domain.","","\u{1F4A1} As you solve problems in this area and call `learn_from_attempts`, the CKG builds up and predictions become available."].join(`
+`);const u=[`\u{1F52E} **Brain Predict: "${n}"**
+`];if(l.length>0){const i=new Set,d=l.filter(e=>{const h=`${e.concept}:${e.edgeType}:${e.target}`;return i.has(h)?!1:(i.add(h),!0)}).sort((e,h)=>h.confidence-e.confidence).slice(0,t);u.push(`### \u{1F578}\uFE0F CKG Predictions (based on ${d.length} known edges)`);for(const e of d){const h=Math.round(e.confidence*100),g=e.edgeType==="fixes"?"\u{1F527}":e.edgeType==="co-occurs"?"\u{1F504}":"\u26A1";u.push(`${g} **${h}%** \`${e.concept}\` _${e.edgeType}_ \`${e.target}\``),e.lesson?.what_worked&&u.push(`   \u2705 ${e.lesson.what_worked.slice(0,120)}`)}u.push("")}if(r.length>0){u.push(`### \u{1F4DA} Relevant Lessons (${Math.min(r.length,t)} pre-loaded)`);for(const i of r.slice(0,t)){const d=Math.round(i.confidence*100);u.push(`  \u2705 **${d}%** \`${i.topic}\` \u2014 ${(i.what_worked??"").slice(0,120)}`)}u.push("")}return u.push('\u{1F4A1} Outcome confirmed? `learn_from_attempts(topic="fix:...", outcome="success", ...)` \u2192 improves future predictions'),u.join(`
+`)}case"brain_plan":{const{instance_id:a,task:n,top_k:t=5}=y;if(!n||!n.trim())throw new T(C.InvalidParams,"task is required");const c=await v(a),s=n.toLowerCase().replace(/[^a-z0-9\s\-_:]/g," ").split(/\s+/).filter(d=>d.length>2),f=[],l=c.scanStream({match:"cachly:lesson:best:*",count:200});await new Promise((d,e)=>{l.on("data",h=>f.push(...h)),l.on("end",d),l.on("error",e)});const r=[];for(const d of f){const e=await c.get(d);if(!e)continue;const h=S(e,null);if(!h)continue;const g=[h.topic,h.what_worked??"",h.what_failed??""].join(" ").toLowerCase(),m=s.reduce((w,$)=>w+(g.includes($)?1:0),0);m>=1&&r.push({l:h,score:m,confidence:I(h)})}if(r.length===0)return[`\u{1F5FA}\uFE0F **Brain Plan: "${n}"**`,"","No grounded plan yet \u2014 the brain hasn't seen this area.","","\u{1F4A1} As you work here and call `learn_from_attempts`, brain_plan will assemble","   an ordered, proven plan from your own history. For now, proceed carefully","   and capture what works."].join(`
+`);r.sort((d,e)=>e.score-d.score||e.confidence-d.confidence);const o=r.filter(d=>d.l.outcome==="failure"||(d.l.what_failed??"").trim().length>0),p=r.filter(d=>d.l.outcome==="success"||d.l.outcome==="partial"),u=[`\u{1F5FA}\uFE0F **Brain Plan: "${n}"**`,"",`_Grounded in ${r.length} relevant lesson${r.length!==1?"s":""} from your own Brain._`,""];if(o.length>0){u.push("### \u26A0\uFE0F Likely failure modes (avoid these)");const d={critical:0,major:1,minor:2};o.slice().sort((e,h)=>(d[e.l.severity??"minor"]??1)-(d[h.l.severity??"minor"]??1)||h.confidence-e.confidence).slice(0,t).forEach(({l:e,confidence:h})=>{const g=e.severity==="critical"?"\u{1F534}":e.severity==="major"?"\u{1F7E1}":"\u{1F7E2}",m=(e.what_failed??e.what_worked??"").slice(0,120);u.push(`${g} **${Math.round(h*100)}%** \`${e.topic}\`${m?` \u2014 ${m}`:""}`)}),u.push("")}if(p.length>0){const d=p.slice(0,t),e=new Map(d.map(w=>[w.l.topic,w])),h=[],g=new Set,m=(w,$)=>{if(!(g.has(w.l.topic)||$>10)){for(const _ of w.l.depends_on??[]){const k=e.get(_);k&&!g.has(_)&&m(k,$+1)}g.has(w.l.topic)||(g.add(w.l.topic),h.push(w))}};for(const w of d)m(w,0);u.push("### \u{1F527} Recommended steps (proven fixes, in order)"),h.forEach(({l:w,confidence:$},_)=>{u.push(`${_+1}. **${Math.round($*100)}%** \`${w.topic}\` \u2014 ${(w.what_worked??"").slice(0,140)}`);const k=(w.commands??[]).slice(0,2);k.length>0&&u.push(`   \`\`\`
+   ${k.join(`
+   `)}
+   \`\`\``),(w.depends_on??[]).length>0&&u.push(`   \u21B3 depends on: ${(w.depends_on??[]).map(j=>`\`${j}\``).join(", ")}`)}),u.push("")}const i=r.filter(d=>(d.l.file_paths??[]).length>0||(d.l.commands??[]).length>0).slice(0,4);if(i.length>0){u.push("### \u2705 Pre-flight checklist");const d=[...new Set(i.flatMap(e=>e.l.file_paths??[]))].slice(0,6);d.length>0&&u.push(`  \u2022 Review files that were involved before: ${d.map(e=>`\`${e}\``).join(", ")}`),u.push("  \u2022 Confirm the top failure mode above can't recur in your change"),u.push("  \u2022 Have a rollback ready for any `critical`/`major` step"),u.push("")}return u.push('\u{1F4A1} After you ship: `learn_from_attempts(topic="...", outcome="success", ...)` \u2192 the next plan gets sharper.'),u.join(`
+`)}case"brain_marketplace":{const{min_confirms:a=1}=y,n=new URLSearchParams;a&&a>1&&n.set("min_confirms",String(a));const t=await b(`/api/v1/syndication/brains${n.toString()?`?${n}`:""}`);if(!t.brains||t.brains.length===0)return["## \u{1F9E0} Domain Brain Marketplace","","No domain brains are available yet \u2014 the marketplace fills as the community","contributes verified lessons. Be an early contributor:",'`syndicate(topic="k8s:oom-kill", what_worked="raise memory limit + add probe")`'].join(`
+`);const c=["## \u{1F9E0} Domain Brain Marketplace",`*${t.count} installable brain${t.count===1?"":"s"} \xB7 curated from the global Knowledge Commons*`,""];for(const s of t.brains){const f=s.curated?"\u2B50 curated":"community";c.push(`### ${s.icon} ${s.name}  \`${s.slug}\``,`${s.description}`,`**${s.lesson_count}** lesson${s.lesson_count===1?"":"s"} \xB7 \u{1F91D} ${s.total_confirms} community confirm${s.total_confirms===1?"":"s"} \xB7 ${f}`,`Install: \`brain_install(slug="${s.slug}")\``,"")}return c.push("---","_Installed brains merge into your local Brain and surface in `smart_recall` \u2014 they never override your own lessons._"),c.join(`
+`)}case"brain_install":{const{instance_id:a,slug:n,min_confirms:t=1,limit:c=200,dry_run:s=!1}=y,f=typeof n=="string"?n.trim():"";if(!f)throw new T(C.InvalidParams,"slug is required \u2014 run brain_marketplace() to see available domain brains");const l=new URLSearchParams;t&&t>1&&l.set("min_confirms",String(t)),c&&c!==200&&l.set("limit",String(Math.min(Math.max(1,c),500)));const r=await b(`/api/v1/syndication/brains/${encodeURIComponent(f)}${l.toString()?`?${l}`:""}`);if(!r.lessons||r.lessons.length===0)return`No installable lessons found for domain brain \`${f}\`. Run \`brain_marketplace()\` to see what's available.`;if(s)return[`## \u{1F4E6} ${r.name} (DRY RUN)`,`Would install **${r.lessons.length}** lesson${r.lessons.length===1?"":"s"} into your Brain.`,"",...r.lessons.slice(0,15).map(e=>`  \u2022 \`${e.topic}\` \xB7 \u{1F91D} ${e.confirm_count}`),r.lessons.length>15?`  \u2026and ${r.lessons.length-15} more`:"","",`Run without \`dry_run\` to install: \`brain_install(slug="${f}")\``].filter(Boolean).join(`
+`);const o=await v(a),p=`marketplace:${f}`,u=new Date().toISOString();let i=0,d=0;for(const e of r.lessons){if(!e.topic||!e.what_worked){d++;continue}const h=`cachly:lesson:best:${e.topic}`,g=await o.get(h);if(g){const _=S(g,null);if(_&&_.source!==p){d++;continue}}const m=(()=>{const _=S(e.tags,[]);return Array.isArray(_)?_.filter(k=>typeof k=="string"):[]})(),w=JSON.stringify({topic:e.topic,outcome:e.outcome||"success",what_worked:e.what_worked,what_failed:e.what_failed||"",severity:e.severity||"minor",tags:m,visibility:"team",confidence:I({ts:u,verified_at:u,recall_count:e.confirm_count}),recall_count:0,source:p,ts:u,verified_at:u,version:3});await o.set(h,w);const $=`cachly:lessons:${e.topic}`;await o.rpush($,w),await o.ltrim($,-100,-1),await o.expire($,90*86400),i++}return await o.set(`cachly:stats:born_at:${a}`,u,"EX",365*86400,"NX").catch(()=>{}),[`## \u{1F4E6} Installed: ${r.name}`,"",`**${i}** lesson${i===1?"":"s"} merged into your Brain${d>0?` \xB7 ${d} skipped (your own lessons take priority)`:""}.`,"","They're live in `smart_recall` now \u2014 try a query in this domain:",`  \u2022 \`smart_recall(query="${r.lessons[0]?.topic.split(":").pop()??"your problem"}")\``,"",`_Installed lessons are tagged \`source: "${p}"\` and never override your own. Re-run anytime to pull updates._`].join(`
+`)}case"brain_conflicts":{const{instance_id:a}=y,n=await v(a),t=[],c=n.scanStream({match:"cachly:ckg:conflict:*",count:100});await new Promise((p,u)=>{c.on("data",i=>t.push(...i)),c.on("end",p),c.on("error",u)});const s=[];if(t.length>0){const p=await n.mget(...t);for(const u of p){const i=S(u??null,null);i&&!i.resolved&&s.push(i)}}const f=[],l=n.scanStream({match:"cachly:agents:active:*",count:100});await new Promise((p,u)=>{l.on("data",i=>f.push(...i)),l.on("end",p),l.on("error",u)});const r=[];if(f.length>0){const p=await n.mget(...f);for(const u of p){const i=S(u??null,null);i&&r.push(i)}}const o=["## \u2694\uFE0F Brain Conflicts & Live Agents",""];if(o.push(`**\u{1F916} Active agents (last 1h):** ${r.length}`),r.length>0)for(const p of r.sort((u,i)=>i.ts.localeCompare(u.ts)).slice(0,10)){const u=Math.round((Date.now()-new Date(p.ts).getTime())/6e4);o.push(`  - **${p.author}** \u2014 last: \`${p.last_topic??"?"}\` (${p.last_outcome??"?"}, ${u}m ago)`)}if(o.push(""),s.length===0)return o.push("**\u2705 No unresolved belief conflicts.** The Brain is in consensus."),o.join(`
+`);o.push(`**\u26A0\uFE0F Unresolved belief conflicts:** ${s.length}`),o.push(""),o.push("| Topic | Confirmed fix | Contradicted by | Detected |"),o.push("|---|---|---|---|");for(const p of s.sort((u,i)=>i.detected_at.localeCompare(u.detected_at)).slice(0,20)){const u=Math.round((Date.now()-new Date(p.detected_at).getTime())/36e5);o.push(`| \`${p.topic}\` | ${(p.fix_confidence*100).toFixed(0)}% (n=${p.fix_trials}) | ${p.reported_by??"unknown"} | ${u}h ago |`)}return o.push(""),o.push(`_Arbitrate with \`brain_resolve_conflict(instance_id="${a}", topic="<topic>", winner="success"|"failure")\`._`),o.join(`
+`)}case"brain_resolve_conflict":{const{instance_id:a,topic:n,winner:t,resolved_by:c="human"}=y;if(!n||!n.trim())throw new T(C.InvalidParams,"topic is required");if(t!=="success"&&t!=="failure")throw new T(C.InvalidParams,'winner must be "success" or "failure"');const s=await v(a),f=M(n),l=`cachly:ckg:conflict:${f}`,r=await s.get(l);if(!r)return`\u{1F4ED} No active conflict found for \`${n}\`. Run \`brain_conflicts(instance_id="${a}")\` to list open conflicts.`;let o=0;if(t==="failure"){const e=await s.smembers(`cachly:ckg:idx:from:${f}`);for(const h of e){const g=await s.get(h);if(!g)continue;const m=S(g,null);!m||m.edgeType!=="fixes"||(m.confidence=.1,await s.set(h,JSON.stringify(m)),o++)}}let p=!1;const u=`cachly:lesson:best:${n}`,i=await s.get(u);if(i){const e=S(i,null);e&&e.outcome===t?e.state==="provisional"&&(e.state="active",e.verified_at=new Date().toISOString(),await s.set(u,JSON.stringify(e))):e&&e.outcome&&e.outcome!==t&&(e.state="archived",e.audit_trail=[...Array.isArray(e.audit_trail)?e.audit_trail:[],{ts:new Date().toISOString(),action:"conflict_loser_archived",resolved_by:c}],await s.set(u,JSON.stringify(e)),p=!0)}const d=S(r,null)??{};return d.resolved=!0,d.winner=t,d.resolved_by=c,d.resolved_at=new Date().toISOString(),await s.set(l,JSON.stringify(d),"EX",3600*24*30),[`## \u2705 Conflict resolved \u2014 \`${n}\``,"",`**Winner:** ${t==="success"?"\u2705 success (fix is valid)":"\u274C failure (fix retired)"}`,`**Resolved by:** ${c}`,"",`- CKG \`fixes\` edges decayed: **${o}**`,`- Losing lesson archived: **${p?"yes":"no"}**`,"",t==="failure"?"_The contradicted fix is retired. smart_recall will stop surfacing it; future attempts start fresh._":"_The fix is reaffirmed. The contradicting failure no longer blocks recall._"].join(`
+`)}case"brain_confirm_ci":{const{instance_id:a,job_status:n,topics:t,scan_topics:c=[],source:s="manual"}=y;if(!n||!["success","failure","cancelled"].includes(n))throw new Error("job_status must be success, failure, or cancelled");if(!t?.length)throw new Error("topics is required");if(n==="cancelled")return"\u23ED\uFE0F CI was cancelled \u2014 no confidence changes applied.";let f;try{f=await b(`/api/v1/instances/${a}/ci-outcome`,{method:"POST",body:JSON.stringify({job_status:n,topics:t,scan_topics:c,source:s})})}catch{return"\u26A0\uFE0F Could not reach Brain API \u2014 CI outcome not recorded. Will retry on next call."}if(f.updated===0)return[`\u{1F916} **brain_confirm_ci** \u2014 CI ${n}`,"","No confidence changes (no matching predictions for these topics).",`Topics checked: ${t.slice(0,5).map(r=>`\`${r}\``).join(", ")}${t.length>5?` +${t.length-5} more`:""}`].join(`
+`);const l=[`\u{1F916} **brain_confirm_ci** \u2014 CI ${n==="success"?"\u2705":"\u274C"} \xB7 ${f.updated} lesson${f.updated!==1?"s":""} updated`,"","| Topic | Old | New | \u0394 | Reason |","|---|---|---|---|---|"];for(const r of f.confidence_deltas){const o=r.delta>0?"+":"",p=r.reason==="confirmed_failure"?"\u{1F534}":"\u{1F7E1}";l.push(`| \`${r.topic}\` | ${(r.old*100).toFixed(0)}% | ${(r.new*100).toFixed(0)}% | ${o}${(r.delta*100).toFixed(0)}% | ${p} ${r.reason} |`)}return l.push("","_Brain self-calibrated from real CI signal. No manual `learn_from_attempts` needed._"),l.join(`
+`)}case"brain_briefing":{const{instance_id:a,event_type:n,context:t,threshold:c}=y;if(!["file_open","pr_open","deploy","manual"].includes(n))throw new Error("event_type must be file_open, pr_open, deploy, or manual");if(!t?.trim())throw new Error("context is required");let s;try{s=await b(`/api/v1/instances/${a}/briefing`,{method:"POST",body:JSON.stringify({event_type:n,context:t,...c!==void 0?{threshold:c}:{}})})}catch{return"\u26A0\uFE0F Could not reach Brain API \u2014 no proactive briefing available right now."}const f=n==="file_open"?"\u{1F4C2}":n==="pr_open"?"\u{1F500}":n==="deploy"?"\u{1F680}":"\u{1F50D}";if(s.warnings.length===0)return[`${f} **brain_briefing** \u2014 ${n} \xB7 \u2705 no known risk patterns matched`,"",`Checked against ${s.matched_lessons} related lesson${s.matched_lessons!==1?"s":""}. You're clear to proceed.`].join(`
+`);const l=s.risk_level==="high"?"\u{1F534}":s.risk_level==="medium"?"\u{1F7E1}":"\u{1F7E2}",r=[`${f} **brain_briefing** \u2014 ${n} \xB7 ${l} risk: ${s.risk_level.toUpperCase()}`,"",`The Brain proactively found ${s.warnings.length} known pattern${s.warnings.length!==1?"s":""} that may apply here:`,"","| Topic | Confidence | Severity | What to watch | Known fix |","|---|---|---|---|---|"];for(const o of s.warnings){const p=o.fix?o.fix.length>80?o.fix.slice(0,80)+"\u2026":o.fix:"\u2014";r.push(`| \`${o.topic}\` | ${(o.confidence*100).toFixed(0)}% | ${o.severity} | ${o.message} | ${p} |`)}return r.push("","_Surfaced proactively \u2014 no `smart_recall` needed. Address the highest-confidence items first._"),r.join(`
+`)}default:return null}}export{A as SYNDICATE_TOOL_NAMES,W as handleSyndicateTool};