@cachly-dev/mcp-server 0.10.129 → 0.10.131

package/dist/src/handlers/advanced.js

@@ -1,501 +1,33 @@
-import { ckgSlug } from '../ckg.js';
-import { safeJsonParse } from '../utils.js';
-import { ersparteMinuten, zaehltAlsErsparnis } from '../wertbeitrag.js';
-export const ADVANCED_TOOL_NAMES = new Set([
-    'memory_consolidate', 'brain_diff', 'causal_trace', 'knowledge_decay', 'autopilot',
-]);
-export async function handleAdvancedTool(name, args, getConnection, _apiFetch) {
-    switch (name) {
-        case 'memory_consolidate': {
-            const { instance_id, dry_run = false, stale_days = 90 } = args;
-            const redis = await getConnection(instance_id);
-            const now = Date.now();
-            const staleMs = stale_days * 86400 * 1000;
-            // Scan all lessons
-            let cursor = 0;
-            const lessonKeys = [];
-            do {
-                const [next, keys] = await redis.scan(cursor, 'MATCH', 'cachly:lesson:best:*', 'COUNT', 200);
-                cursor = parseInt(next);
-                lessonKeys.push(...keys);
-            } while (cursor !== 0);
-            if (lessonKeys.length === 0) {
-                return '🧠 **Brain is empty** — no lessons to consolidate yet. Use `learn_from_attempts` after your next bug fix.';
-            }
-            const lessons = new Map();
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                const lesson = safeJsonParse(raw, null);
-                if (lesson)
-                    lessons.set(k, lesson);
-            }
-            // Detect duplicates: same topic prefix (e.g. deploy:api vs deploy:api-v2)
-            const topicGroups = new Map();
-            for (const [k, l] of lessons) {
-                const prefix = l.topic.split(':')[0];
-                const group = topicGroups.get(prefix) ?? [];
-                group.push(k);
-                topicGroups.set(prefix, group);
-            }
-            // Detect contradictions: same exact topic, different outcomes
-            const contradictions = [];
-            const exactTopics = new Map();
-            for (const [k, l] of lessons) {
-                const arr = exactTopics.get(l.topic) ?? [];
-                arr.push(k);
-                exactTopics.set(l.topic, arr);
-            }
-            for (const [topic, keys] of exactTopics) {
-                const outcomes = new Set(keys.map(k => lessons.get(k)?.outcome));
-                if (outcomes.size > 1)
-                    contradictions.push({ topic, keys });
-            }
-            // Detect stale: not recalled in stale_days
-            const stale = [];
-            for (const [k, l] of lessons) {
-                const age = now - new Date(l.ts).getTime();
-                const recalls = l.recall_count ?? 0;
-                if (age > staleMs && recalls === 0)
-                    stale.push(k);
-            }
-            // Consolidation NEVER deletes a lesson.
-            //
-            // Until 2026-08-13 this block merged "duplicates by prefix": it grouped
-            // every lesson by the segment before the first ':' and deleted all but
-            // one per group. A single real run on a 626-lesson brain deleted 529 of
-            // them — every `cachly:*` lesson counted as a duplicate of every other.
-            //
-            // The counts below stay (they are a report), the deletes are gone. Stale
-            // entries still get a 30-day expiry — that is a deadline a recall lifts
-            // again, not a deletion.
-            const merged = 0;
-            if (!dry_run) {
-                for (const k of stale) {
-                    await redis.expire(k, 86400 * 30);
-                }
-            }
-            const lines = [
-                `🔬 **Memory Consolidation Report** ${dry_run ? '(dry run — no changes made)' : '✅ Applied'}`,
-                ``,
-                `📊 **Before:** ${lessonKeys.length} lessons`,
-                ``,
-                `🔁 **Contradictions detected:** ${contradictions.length}`,
-                ...contradictions.slice(0, 5).map(c => `  → \`${c.topic}\`: ${c.keys.length} conflicting entries (kept: success)`),
-                contradictions.length > 5 ? `  … and ${contradictions.length - 5} more` : '',
-                ``,
-                `♻️ **Duplicate clusters (counted, never deleted):** ${Array.from(topicGroups.values()).filter(v => v.length > 1).length}`,
-                ``,
-                `🕰️ **Stale entries (${stale_days}d, 0 recalls):** ${stale.length}` +
-                    (stale.length > 0 && !dry_run ? ` → set to expire in 30 days` : ''),
-                ``,
-                `📊 **After:** ${lessonKeys.length - merged} lessons`,
-                ``,
-                dry_run
-                    ? `💡 Re-run without dry_run=true to apply changes.`
-                    : `✨ Brain consolidated. Run \`brain_diff(since="1h")\` to see the delta.`,
-            ].filter(s => s !== '').join('\n');
-            return lines;
-        }
-        // ── v0.6 Cognitive Cache: brain_diff ─────────────────────────────────────
-        case 'brain_diff': {
-            const { instance_id, since = '7d', format = 'summary' } = args;
-            const redis = await getConnection(instance_id);
-            // Parse since
-            let sinceMs;
-            const match = since.match(/^(\d+)([dhm])$/);
-            if (match) {
-                const n = parseInt(match[1]);
-                const unit = match[2];
-                const mult = unit === 'd' ? 86400000 : unit === 'h' ? 3600000 : 60000;
-                sinceMs = Date.now() - n * mult;
-            }
-            else {
-                sinceMs = new Date(since).getTime() || Date.now() - 7 * 86400000;
-            }
-            // Scan all lessons
-            let cursor = 0;
-            const lessonKeys = [];
-            do {
-                const [next, keys] = await redis.scan(cursor, 'MATCH', 'cachly:lesson:best:*', 'COUNT', 200);
-                cursor = parseInt(next);
-                lessonKeys.push(...keys);
-            } while (cursor !== 0);
-            const added = [];
-            const updated = [];
-            const recalled = [];
-            const total = lessonKeys.length;
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                {
-                    const l = safeJsonParse(raw, null);
-                    if (!l)
-                        continue;
-                    const ts = new Date(l.ts).getTime();
-                    if (ts >= sinceMs) {
-                        // Check history to determine add vs update
-                        const histKey = `cachly:lesson:history:${l.topic}`;
-                        const histLen = await redis.llen(histKey);
-                        if (histLen <= 1)
-                            added.push(l);
-                        else
-                            updated.push(l);
-                    }
-                    if ((l.recall_count ?? 0) > 0) {
-                        // We can't easily know when last recalled without extra metadata, so include
-                        // lessons with recalls as "active"
-                        recalled.push(l);
-                    }
-                }
-            }
-            const sinceLabel = match ? `last ${since}` : new Date(sinceMs).toLocaleDateString('de-DE');
-            const lines = [
-                `📊 **Brain Diff** — ${sinceLabel}`,
-                ``,
-                `Total lessons in brain: **${total}**`,
-                ``,
-                `✅ **New** (${added.length}):`,
-                ...added.slice(0, format === 'detailed' ? 20 : 5).map(l => `  + \`${l.topic}\` — ${l.outcome} ${l.severity === 'critical' ? '🔴' : l.severity === 'major' ? '🟠' : '🟢'}`),
-                added.length > 5 && format === 'summary' ? `  … and ${added.length - 5} more` : '',
-                ``,
-                `🔄 **Updated** (${updated.length}):`,
-                ...updated.slice(0, format === 'detailed' ? 20 : 5).map(l => `  ~ \`${l.topic}\` — now: ${l.outcome}`),
-                updated.length > 5 && format === 'summary' ? `  … and ${updated.length - 5} more` : '',
-                ``,
-                `🔍 **Active** (recalled at least once): ${recalled.length}`,
-                ``,
-            ].filter(s => s !== '');
-            // ── 10X brain_diff extensions ──────────────────────────────────────────
-            // 1. Contested → Established (resolution nodes created in window)
-            const resolutionKeys = [];
-            const rsStream = redis.scanStream({ match: 'cachly:ckg:node:resolution-*', count: 100 });
-            await new Promise((res, rej) => { rsStream.on('data', (b) => resolutionKeys.push(...b)); rsStream.on('end', res); rsStream.on('error', rej); });
-            const recentResolutions = [];
-            for (const rk of resolutionKeys) {
-                const rr = await redis.get(rk);
-                if (!rr)
-                    continue;
-                {
-                    const rn = safeJsonParse(rr, null);
-                    if (rn?.ts && new Date(rn.ts).getTime() >= sinceMs)
-                        recentResolutions.push({ topic: rn.topic ?? rk, resolution: rn.resolution ?? 'unknown', ts: rn.ts });
-                }
-            }
-            if (recentResolutions.length > 0) {
-                lines.push(`🗳️ **MADC Resolutions** (${recentResolutions.length} contested beliefs resolved):`);
-                for (const r of recentResolutions.slice(0, 5)) {
-                    const rIcon = r.resolution === 'unanimous_success' ? '✅' : r.resolution === 'unanimous_failure' ? '❌' : '⚠️';
-                    lines.push(`  ${rIcon} \`${r.topic}\` → ${r.resolution}`);
-                }
-                lines.push('');
-            }
-            // 2. New domains bootstrapped (domains in added lessons that weren't in older lessons)
-            const existingDomains = new Set(updated.concat(recalled).map(l => l.topic.split(':')[0]));
-            const newDomains = [...new Set(added.map(l => l.topic.split(':')[0]))].filter(d => !existingDomains.has(d));
-            if (newDomains.length > 0) {
-                lines.push(`🌱 **New domains bootstrapped:** ${newDomains.map(d => `\`${d}\``).join(', ')}`, '');
-            }
-            // 3. FedBrain transfers received in window
-            const fedHistRaw = await redis.lrange('cachly:fedbrain:federations', -20, -1);
-            const recentFeds = fedHistRaw
-                .map(r => safeJsonParse(r, null))
-                .filter((f) => f !== null && new Date(f.transferred_at).getTime() >= sinceMs);
-            if (recentFeds.length > 0) {
-                lines.push(`🧠 **FedBrain transfers received (${recentFeds.length}):**`);
-                for (const f of recentFeds.slice(0, 3)) {
-                    lines.push(`  📥 domain \`${f.domain}\` from \`${f.source.slice(0, 16)}…\` — ${f.nodes} nodes, ${f.edges} edges`);
-                }
-                lines.push('');
-            }
-            lines.push(`💡 Run \`memory_consolidate\` to merge duplicates · \`knowledge_decay\` to see confidence scores.`);
-            return lines.join('\n');
-        }
-        // ── v0.6 Cognitive Cache: causal_trace ───────────────────────────────────
-        case 'causal_trace': {
-            const { instance_id, problem, max_depth = 5, tags: filterTags = [] } = args;
-            const redis = await getConnection(instance_id);
-            // Normalize problem to keyword tokens
-            const tokens = problem.toLowerCase()
-                .replace(/[^a-z0-9\s\-_:]/g, ' ')
-                .split(/\s+/)
-                .filter(t => t.length > 2);
-            const SEV_ICON = { critical: '🔴', major: '🟠', minor: '🟡' };
-            const ckgResults = [];
-            try {
-                for (const token of tokens.slice(0, 4)) {
-                    // Search for CKG nodes matching this token
-                    const fromKeys = await redis.smembers(`cachly:ckg:idx:from:${ckgSlug(token)}`);
-                    const toKeys = await redis.smembers(`cachly:ckg:idx:to:${ckgSlug(token)}`);
-                    // Also try pattern: scan nodes containing the token
-                    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 nodeKey of nodeKeys.slice(0, 10)) {
-                        const nodeRaw = await redis.get(nodeKey);
-                        if (!nodeRaw)
-                            continue;
-                        const node = safeJsonParse(nodeRaw, null);
-                        if (!node)
-                            continue;
-                        // Get edges from this node
-                        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;
-                            if (edge.edgeType !== 'fixes' && edge.edgeType !== 'requires')
-                                continue;
-                            // Find lesson for this concept
-                            const lessonRaw = await redis.get(`cachly:lesson:best:${edge.from.replace(/-/g, ':').replace(/^fix:/, 'fix:')}`);
-                            const lesson = lessonRaw ? safeJsonParse(lessonRaw, null) ?? undefined : undefined;
-                            ckgResults.push({ conceptId: node.id, edge, lesson: lesson ?? undefined });
-                        }
-                    }
-                    for (const ek of [...fromKeys, ...toKeys].slice(0, 20)) {
-                        const edgeRaw = await redis.get(ek);
-                        if (!edgeRaw)
-                            continue;
-                        const edge = safeJsonParse(edgeRaw, null);
-                        if (!edge)
-                            continue;
-                        const lessonRaw = await redis.get(`cachly:lesson:best:${edge.from}`);
-                        const lesson = lessonRaw ? safeJsonParse(lessonRaw, null) ?? undefined : undefined;
-                        ckgResults.push({ conceptId: edge.from, edge, lesson: lesson ?? undefined });
-                    }
-                }
-            }
-            catch { /* CKG traversal non-critical */ }
-            // Deduplicate CKG results and sort by confidence
-            const ckgSeen = new Set();
-            const ckgDeduped = ckgResults.filter(r => {
-                const key = `${r.edge.from}:${r.edge.edgeType}:${r.edge.to}`;
-                if (ckgSeen.has(key))
-                    return false;
-                ckgSeen.add(key);
-                return true;
-            }).sort((a, b) => b.edge.confidence - a.edge.confidence).slice(0, max_depth);
-            // ── Layer 2 (fallback): text similarity over all lessons ─────────────────
-            let cursor = 0;
-            const lessonKeys = [];
-            do {
-                const [next, keys] = await redis.scan(cursor, 'MATCH', 'cachly:lesson:*', 'COUNT', 200);
-                cursor = parseInt(next);
-                lessonKeys.push(...keys);
-            } while (cursor !== 0);
-            // Score each lesson by token overlap with problem description
-            const scored = [];
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                {
-                    const l = safeJsonParse(raw, null);
-                    if (!l)
-                        continue;
-                    if (filterTags.length > 0 && !(l.tags ?? []).some((t) => filterTags.includes(t)))
-                        continue;
-                    const haystack = [l.topic, l.what_failed ?? '', l.what_worked ?? '', l.context ?? '']
-                        .join(' ').toLowerCase();
-                    const score = tokens.reduce((s, t) => s + (haystack.includes(t) ? 1 : 0), 0);
-                    if (score > 0)
-                        scored.push({ score, lesson: l, key: k });
-                }
-            }
-            scored.sort((a, b) => b.score - a.score);
-            const chain = scored.slice(0, max_depth);
-            if (chain.length === 0 && ckgDeduped.length === 0) {
-                return [
-                    `🔍 **Causal Trace: "${problem}"**`,
-                    ``,
-                    `No matching lessons found in brain.`,
-                    ``,
-                    `💡 After you solve this, call:`,
-                    `\`\`\``,
-                    `learn_from_attempts(`,
-                    `  instance_id = "${instance_id}",`,
-                    `  topic       = "fix:${tokens[0] ?? 'issue'}",`,
-                    `  outcome     = "success",`,
-                    `  what_worked = "...",`,
-                    `  what_failed = "${problem}",`,
-                    `)`,
-                    `\`\`\``,
-                ].join('\n');
-            }
-            const lines = [
-                `🔍 **Causal Trace: "${problem}"**`,
-                ``,
-            ];
-            // Show CKG graph results first if available
-            if (ckgDeduped.length > 0) {
-                lines.push(`### 🕸️ CKG Graph (confidence-ranked)`);
-                for (const r of ckgDeduped) {
-                    const confPct = Math.round(r.edge.confidence * 100);
-                    const confBar = '▓'.repeat(Math.round(confPct / 10)) + '░'.repeat(10 - Math.round(confPct / 10));
-                    lines.push(`  ${r.edge.from} **→[${r.edge.edgeType}]→** ${r.edge.to}`);
-                    lines.push(`  ${confBar} ${confPct}% confidence (${r.edge.successes}/${r.edge.trials} confirmed)`);
-                    if (r.lesson?.what_worked)
-                        lines.push(`  ✅ Fix: ${r.lesson.what_worked.slice(0, 150)}`);
-                    lines.push('');
-                }
-            }
-            // Build text-based causal chain narrative
-            if (chain.length > 0) {
-                lines.push(ckgDeduped.length > 0 ? `### 📚 Text Search (${chain.length} related lessons)` : `Found **${chain.length}** related lessons. Reconstructed causal chain:`, '');
-                const failures = chain.filter(c => c.lesson.outcome !== 'success');
-                const solutions = chain.filter(c => c.lesson.outcome === 'success');
-                if (failures.length > 0) {
-                    lines.push(`**Root causes & failure chain:**`);
-                    failures.forEach((c, i) => {
-                        const l = c.lesson;
-                        const sev = SEV_ICON[l.severity ?? 'minor'] ?? '🟡';
-                        lines.push(`${i === 0 ? '  Root:' : '   → :'} ${sev} \`${l.topic}\``);
-                        if (l.what_failed)
-                            lines.push(`          ↳ ${l.what_failed.slice(0, 120)}`);
-                    });
-                    lines.push('');
-                }
-                if (solutions.length > 0) {
-                    lines.push(`**Solutions that worked before:**`);
-                    solutions.forEach((c, i) => {
-                        const l = c.lesson;
-                        const date = new Date(l.ts).toLocaleDateString('de-DE');
-                        lines.push(`  ${i + 1}. ✅ \`${l.topic}\` — ${date} · recalled ${l.recall_count ?? 0}×`);
-                        if (l.what_worked)
-                            lines.push(`     ${l.what_worked.slice(0, 200)}`);
-                    });
-                    lines.push('');
-                }
-                const topSolution = solutions[0]?.lesson;
-                if (topSolution?.what_worked) {
-                    lines.push(`**⚡ Most likely fix:**`);
-                    lines.push(`\`\`\``);
-                    lines.push(topSolution.what_worked.slice(0, 500));
-                    lines.push(`\`\`\``);
-                    lines.push('');
-                    // Track estimated time saved — causal_trace finding a known fix is worth 1-4h.
-                    // Nur beim ERSTEN Mal, und nie fuer den Startvorrat — wertbeitrag.ts.
-                    const savedMins = zaehltAlsErsparnis(topSolution) ? ersparteMinuten(topSolution, 'trace') : 0;
-                    if (savedMins > 0) {
-                        redis.incrbyfloat(`cachly:stats:time_saved_mins:${instance_id}`, savedMins).catch(() => { });
-                    }
-                }
-            }
-            lines.push(`💡 After applying: \`learn_from_attempts(topic="fix:${tokens[0] ?? 'issue'}", outcome="success", ...)\``);
-            if (ckgDeduped.length > 0)
-                lines.push(`🕸️ Explore graph: \`ckg_inspect(concept="${tokens[0] ?? 'fix'}")\``);
-            return lines.join('\n');
-        }
-        case 'knowledge_decay': {
-            const { instance_id, min_age_days = 0, show_top = 20 } = args;
-            const redis = await getConnection(instance_id);
-            const now = Date.now();
-            const minAgeMs = min_age_days * 86400000;
-            let cursor = 0;
-            const lessonKeys = [];
-            do {
-                const [next, keys] = await redis.scan(cursor, 'MATCH', 'cachly:lesson:best:*', 'COUNT', 200);
-                cursor = parseInt(next);
-                lessonKeys.push(...keys);
-            } while (cursor !== 0);
-            const scores = [];
-            for (const k of lessonKeys) {
-                const raw = await redis.get(k);
-                if (!raw)
-                    continue;
-                {
-                    const l = safeJsonParse(raw, null);
-                    if (!l)
-                        continue;
-                    const ageMs = now - new Date(l.ts).getTime();
-                    if (ageMs < minAgeMs)
-                        continue;
-                    const age_days = Math.floor(ageMs / 86400000);
-                    const recalls = l.recall_count ?? 0;
-                    // The THIRD deliberately-different decay curve (see confidence.ts /
-                    // search.ts recencyBoost). This one is a *report-only* health score on
-                    // a 0–100 scale that also folds in recall_count and outcome — it is not
-                    // a ranking signal and not the freshness badge. Kept separate on
-                    // purpose; do not "unify" the three (a single curve regresses either
-                    // the Cachly-Bench ranking floors — see PR #228 — or these reports).
-                    //
-                    // Confidence formula:
-                    // base = 100 → decays by 1pt/day after 7 days, floored at 5
-                    // boost: +5 per recall, capped at +50
-                    // penalty: failure outcome → -20
-                    const decayPts = Math.max(0, age_days - 7);
-                    const base = Math.max(5, 100 - decayPts);
-                    const recallBoost = Math.min(50, recalls * 5);
-                    const outcomePenalty = l.outcome === 'failure' ? -20 : 0;
-                    const confidence = Math.min(100, Math.max(0, base + recallBoost + outcomePenalty));
-                    scores.push({ topic: l.topic, confidence, age_days, recalls, outcome: l.outcome });
-                }
-            }
-            // Sort by lowest confidence first
-            scores.sort((a, b) => a.confidence - b.confidence);
-            const shown = scores.slice(0, show_top);
-            function bar(pct) {
-                const filled = Math.round(pct / 10);
-                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ${pct}%`;
-            }
-            const avgConf = scores.length > 0
-                ? Math.round(scores.reduce((s, e) => s + e.confidence, 0) / scores.length)
-                : 0;
-            const critical = scores.filter(s => s.confidence < 30).length;
-            const healthy = scores.filter(s => s.confidence >= 70).length;
-            const lines = [
-                `🧪 **Knowledge Decay Report** — ${scores.length} lessons`,
-                ``,
-                `Average confidence: **${bar(avgConf)}**`,
-                `🔴 Critical (<30%): ${critical}  🟢 Healthy (≥70%): ${healthy}`,
-                ``,
-                `Lowest confidence lessons (fix these first):`,
-                ``,
-                ...shown.map((s, i) => `${(i + 1).toString().padStart(2)}. \`${s.topic}\`\n    ${bar(s.confidence)} · ${s.age_days}d old · ${s.recalls} recalls · ${s.outcome}`),
-                ``,
-                scores.length > show_top ? `… and ${scores.length - show_top} more lessons` : '',
-                ``,
-                critical > 0
-                    ? `⚠️ ${critical} lessons are critically stale. Validate them and re-run \`learn_from_attempts\` with updated findings.`
-                    : `✅ Brain confidence is healthy overall.`,
-                ``,
-                `💡 Run \`memory_consolidate\` to prune stale entries · \`causal_trace\` to find root causes.`,
-            ].filter(s => s !== '');
-            return lines.join('\n');
-        }
-        // ── v0.6 Cognitive Cache: autopilot ──────────────────────────────────────
-        case 'autopilot': {
-            const { instance_id, editor = 'claude', project_name = 'this project', style = 'full' } = args;
-            const minimal = `## Cachly AI Brain — Autopilot
+import{ckgSlug as R}from"../ckg.js";import{safeJsonParse as v}from"../utils.js";import{ersparteMinuten as E,zaehltAlsErsparnis as j}from"../wertbeitrag.js";const F=new Set(["memory_consolidate","brain_diff","causal_trace","knowledge_decay","autopilot"]);async function U(B,A,M,K){switch(B){case"memory_consolidate":{const{instance_id:u,dry_run:h=!1,stale_days:w=90}=A,m=await M(u),l=Date.now(),y=w*86400*1e3;let $=0;const p=[];do{const[e,s]=await m.scan($,"MATCH","cachly:lesson:best:*","COUNT",200);$=parseInt(e),p.push(...s)}while($!==0);if(p.length===0)return"\u{1F9E0} **Brain is empty** \u2014 no lessons to consolidate yet. Use `learn_from_attempts` after your next bug fix.";const a=new Map;for(const e of p){const s=await m.get(e);if(!s)continue;const o=v(s,null);o&&a.set(e,o)}const g=new Map;for(const[e,s]of a){const o=s.topic.split(":")[0],n=g.get(o)??[];n.push(e),g.set(o,n)}const _=[],x=new Map;for(const[e,s]of a){const o=x.get(s.topic)??[];o.push(e),x.set(s.topic,o)}for(const[e,s]of x)new Set(s.map(n=>a.get(n)?.outcome)).size>1&&_.push({topic:e,keys:s});const b=[];for(const[e,s]of a){const o=l-new Date(s.ts).getTime(),n=s.recall_count??0;o>y&&n===0&&b.push(e)}const f=0;if(!h)for(const e of b)await m.expire(e,86400*30);return[`\u{1F52C} **Memory Consolidation Report** ${h?"(dry run \u2014 no changes made)":"\u2705 Applied"}`,"",`\u{1F4CA} **Before:** ${p.length} lessons`,"",`\u{1F501} **Contradictions detected:** ${_.length}`,..._.slice(0,5).map(e=>`  \u2192 \`${e.topic}\`: ${e.keys.length} conflicting entries (kept: success)`),_.length>5?`  \u2026 and ${_.length-5} more`:"","",`\u267B\uFE0F **Duplicate clusters (counted, never deleted):** ${Array.from(g.values()).filter(e=>e.length>1).length}`,"",`\u{1F570}\uFE0F **Stale entries (${w}d, 0 recalls):** ${b.length}`+(b.length>0&&!h?" \u2192 set to expire in 30 days":""),"",`\u{1F4CA} **After:** ${p.length-f} lessons`,"",h?"\u{1F4A1} Re-run without dry_run=true to apply changes.":'\u2728 Brain consolidated. Run `brain_diff(since="1h")` to see the delta.'].filter(e=>e!=="").join(`
+`)}case"brain_diff":{const{instance_id:u,since:h="7d",format:w="summary"}=A,m=await M(u);let l;const y=h.match(/^(\d+)([dhm])$/);if(y){const t=parseInt(y[1]),r=y[2],d=r==="d"?864e5:r==="h"?36e5:6e4;l=Date.now()-t*d}else l=new Date(h).getTime()||Date.now()-7*864e5;let $=0;const p=[];do{const[t,r]=await m.scan($,"MATCH","cachly:lesson:best:*","COUNT",200);$=parseInt(t),p.push(...r)}while($!==0);const a=[],g=[],_=[],x=p.length;for(const t of p){const r=await m.get(t);if(r){const d=v(r,null);if(!d)continue;if(new Date(d.ts).getTime()>=l){const D=`cachly:lesson:history:${d.topic}`;await m.llen(D)<=1?a.push(d):g.push(d)}(d.recall_count??0)>0&&_.push(d)}}const f=[`\u{1F4CA} **Brain Diff** \u2014 ${y?`last ${h}`:new Date(l).toLocaleDateString("de-DE")}`,"",`Total lessons in brain: **${x}**`,"",`\u2705 **New** (${a.length}):`,...a.slice(0,w==="detailed"?20:5).map(t=>`  + \`${t.topic}\` \u2014 ${t.outcome} ${t.severity==="critical"?"\u{1F534}":t.severity==="major"?"\u{1F7E0}":"\u{1F7E2}"}`),a.length>5&&w==="summary"?`  \u2026 and ${a.length-5} more`:"","",`\u{1F504} **Updated** (${g.length}):`,...g.slice(0,w==="detailed"?20:5).map(t=>`  ~ \`${t.topic}\` \u2014 now: ${t.outcome}`),g.length>5&&w==="summary"?`  \u2026 and ${g.length-5} more`:"","",`\u{1F50D} **Active** (recalled at least once): ${_.length}`,""].filter(t=>t!==""),c=[],e=m.scanStream({match:"cachly:ckg:node:resolution-*",count:100});await new Promise((t,r)=>{e.on("data",d=>c.push(...d)),e.on("end",t),e.on("error",r)});const s=[];for(const t of c){const r=await m.get(t);if(r){const d=v(r,null);d?.ts&&new Date(d.ts).getTime()>=l&&s.push({topic:d.topic??t,resolution:d.resolution??"unknown",ts:d.ts})}}if(s.length>0){f.push(`\u{1F5F3}\uFE0F **MADC Resolutions** (${s.length} contested beliefs resolved):`);for(const t of s.slice(0,5)){const r=t.resolution==="unanimous_success"?"\u2705":t.resolution==="unanimous_failure"?"\u274C":"\u26A0\uFE0F";f.push(`  ${r} \`${t.topic}\` \u2192 ${t.resolution}`)}f.push("")}const o=new Set(g.concat(_).map(t=>t.topic.split(":")[0])),n=[...new Set(a.map(t=>t.topic.split(":")[0]))].filter(t=>!o.has(t));n.length>0&&f.push(`\u{1F331} **New domains bootstrapped:** ${n.map(t=>`\`${t}\``).join(", ")}`,"");const i=(await m.lrange("cachly:fedbrain:federations",-20,-1)).map(t=>v(t,null)).filter(t=>t!==null&&new Date(t.transferred_at).getTime()>=l);if(i.length>0){f.push(`\u{1F9E0} **FedBrain transfers received (${i.length}):**`);for(const t of i.slice(0,3))f.push(`  \u{1F4E5} domain \`${t.domain}\` from \`${t.source.slice(0,16)}\u2026\` \u2014 ${t.nodes} nodes, ${t.edges} edges`);f.push("")}return f.push("\u{1F4A1} Run `memory_consolidate` to merge duplicates \xB7 `knowledge_decay` to see confidence scores."),f.join(`
+`)}case"causal_trace":{const{instance_id:u,problem:h,max_depth:w=5,tags:m=[]}=A,l=await M(u),y=h.toLowerCase().replace(/[^a-z0-9\s\-_:]/g," ").split(/\s+/).filter(e=>e.length>2),$={critical:"\u{1F534}",major:"\u{1F7E0}",minor:"\u{1F7E1}"},p=[];try{for(const e of y.slice(0,4)){const s=await l.smembers(`cachly:ckg:idx:from:${R(e)}`),o=await l.smembers(`cachly:ckg:idx:to:${R(e)}`),n=[],k=l.scanStream({match:`cachly:ckg:node:*${e}*`,count:50});await new Promise((i,t)=>{k.on("data",r=>n.push(...r)),k.on("end",i),k.on("error",t)});for(const i of n.slice(0,10)){const t=await l.get(i);if(!t)continue;const r=v(t,null);if(!r)continue;const d=await l.smembers(`cachly:ckg:idx:from:${r.id}`);for(const T of d.slice(0,20)){const D=await l.get(T);if(!D)continue;const C=v(D,null);if(!C||C.edgeType!=="fixes"&&C.edgeType!=="requires")continue;const S=await l.get(`cachly:lesson:best:${C.from.replace(/-/g,":").replace(/^fix:/,"fix:")}`),I=S?v(S,null)??void 0:void 0;p.push({conceptId:r.id,edge:C,lesson:I??void 0})}}for(const i of[...s,...o].slice(0,20)){const t=await l.get(i);if(!t)continue;const r=v(t,null);if(!r)continue;const d=await l.get(`cachly:lesson:best:${r.from}`),T=d?v(d,null)??void 0:void 0;p.push({conceptId:r.from,edge:r,lesson:T??void 0})}}}catch{}const a=new Set,g=p.filter(e=>{const s=`${e.edge.from}:${e.edge.edgeType}:${e.edge.to}`;return a.has(s)?!1:(a.add(s),!0)}).sort((e,s)=>s.edge.confidence-e.edge.confidence).slice(0,w);let _=0;const x=[];do{const[e,s]=await l.scan(_,"MATCH","cachly:lesson:*","COUNT",200);_=parseInt(e),x.push(...s)}while(_!==0);const b=[];for(const e of x){const s=await l.get(e);if(s){const o=v(s,null);if(!o||m.length>0&&!(o.tags??[]).some(i=>m.includes(i)))continue;const n=[o.topic,o.what_failed??"",o.what_worked??"",o.context??""].join(" ").toLowerCase(),k=y.reduce((i,t)=>i+(n.includes(t)?1:0),0);k>0&&b.push({score:k,lesson:o,key:e})}}b.sort((e,s)=>s.score-e.score);const f=b.slice(0,w);if(f.length===0&&g.length===0)return[`\u{1F50D} **Causal Trace: "${h}"**`,"","No matching lessons found in brain.","","\u{1F4A1} After you solve this, call:","```","learn_from_attempts(",`  instance_id = "${u}",`,`  topic       = "fix:${y[0]??"issue"}",`,'  outcome     = "success",','  what_worked = "...",',`  what_failed = "${h}",`,")","```"].join(`
+`);const c=[`\u{1F50D} **Causal Trace: "${h}"**`,""];if(g.length>0){c.push("### \u{1F578}\uFE0F CKG Graph (confidence-ranked)");for(const e of g){const s=Math.round(e.edge.confidence*100),o="\u2593".repeat(Math.round(s/10))+"\u2591".repeat(10-Math.round(s/10));c.push(`  ${e.edge.from} **\u2192[${e.edge.edgeType}]\u2192** ${e.edge.to}`),c.push(`  ${o} ${s}% confidence (${e.edge.successes}/${e.edge.trials} confirmed)`),e.lesson?.what_worked&&c.push(`  \u2705 Fix: ${e.lesson.what_worked.slice(0,150)}`),c.push("")}}if(f.length>0){c.push(g.length>0?`### \u{1F4DA} Text Search (${f.length} related lessons)`:`Found **${f.length}** related lessons. Reconstructed causal chain:`,"");const e=f.filter(n=>n.lesson.outcome!=="success"),s=f.filter(n=>n.lesson.outcome==="success");e.length>0&&(c.push("**Root causes & failure chain:**"),e.forEach((n,k)=>{const i=n.lesson,t=$[i.severity??"minor"]??"\u{1F7E1}";c.push(`${k===0?"  Root:":"   \u2192 :"} ${t} \`${i.topic}\``),i.what_failed&&c.push(`          \u21B3 ${i.what_failed.slice(0,120)}`)}),c.push("")),s.length>0&&(c.push("**Solutions that worked before:**"),s.forEach((n,k)=>{const i=n.lesson,t=new Date(i.ts).toLocaleDateString("de-DE");c.push(`  ${k+1}. \u2705 \`${i.topic}\` \u2014 ${t} \xB7 recalled ${i.recall_count??0}\xD7`),i.what_worked&&c.push(`     ${i.what_worked.slice(0,200)}`)}),c.push(""));const o=s[0]?.lesson;if(o?.what_worked){c.push("**\u26A1 Most likely fix:**"),c.push("```"),c.push(o.what_worked.slice(0,500)),c.push("```"),c.push("");const n=j(o)?E(o,"trace"):0;n>0&&l.incrbyfloat(`cachly:stats:time_saved_mins:${u}`,n).catch(()=>{})}}return c.push(`\u{1F4A1} After applying: \`learn_from_attempts(topic="fix:${y[0]??"issue"}", outcome="success", ...)\``),g.length>0&&c.push(`\u{1F578}\uFE0F Explore graph: \`ckg_inspect(concept="${y[0]??"fix"}")\``),c.join(`
+`)}case"knowledge_decay":{let _=function(e){const s=Math.round(e/10);return"\u2588".repeat(s)+"\u2591".repeat(10-s)+` ${e}%`};const{instance_id:u,min_age_days:h=0,show_top:w=20}=A,m=await M(u),l=Date.now(),y=h*864e5;let $=0;const p=[];do{const[e,s]=await m.scan($,"MATCH","cachly:lesson:best:*","COUNT",200);$=parseInt(e),p.push(...s)}while($!==0);const a=[];for(const e of p){const s=await m.get(e);if(s){const o=v(s,null);if(!o)continue;const n=l-new Date(o.ts).getTime();if(n<y)continue;const k=Math.floor(n/864e5),i=o.recall_count??0,t=Math.max(0,k-7),r=Math.max(5,100-t),d=Math.min(50,i*5),T=o.outcome==="failure"?-20:0,D=Math.min(100,Math.max(0,r+d+T));a.push({topic:o.topic,confidence:D,age_days:k,recalls:i,outcome:o.outcome})}}a.sort((e,s)=>e.confidence-s.confidence);const g=a.slice(0,w),x=a.length>0?Math.round(a.reduce((e,s)=>e+s.confidence,0)/a.length):0,b=a.filter(e=>e.confidence<30).length,f=a.filter(e=>e.confidence>=70).length;return[`\u{1F9EA} **Knowledge Decay Report** \u2014 ${a.length} lessons`,"",`Average confidence: **${_(x)}**`,`\u{1F534} Critical (<30%): ${b}  \u{1F7E2} Healthy (\u226570%): ${f}`,"","Lowest confidence lessons (fix these first):","",...g.map((e,s)=>`${(s+1).toString().padStart(2)}. \`${e.topic}\`
+    ${_(e.confidence)} \xB7 ${e.age_days}d old \xB7 ${e.recalls} recalls \xB7 ${e.outcome}`),"",a.length>w?`\u2026 and ${a.length-w} more lessons`:"","",b>0?`\u26A0\uFE0F ${b} lessons are critically stale. Validate them and re-run \`learn_from_attempts\` with updated findings.`:"\u2705 Brain confidence is healthy overall.","","\u{1F4A1} Run `memory_consolidate` to prune stale entries \xB7 `causal_trace` to find root causes."].filter(e=>e!=="").join(`
+`)}case"autopilot":{const{instance_id:u,editor:h="claude",project_name:w="this project",style:m="full"}=A,l=`## Cachly AI Brain \u2014 Autopilot
 
-**Instance:** \`${instance_id}\`
+**Instance:** \`${u}\`
 
 > **Where your data goes:** these calls read/write *your own* Brain instance
-> (the ID above) — your infrastructure, EU-hosted, under your control. Nothing
+> (the ID above) \u2014 your infrastructure, EU-hosted, under your control. Nothing
 > goes to third parties. It stores lessons (what worked / what failed) so the
 > assistant arrives pre-briefed instead of re-discovering things every session.
 > Pause any time by removing this file.
 
 > Sessions are fully automatic. The Brain starts when you call any tool and saves a summary when you close.
 
-### Brain hooks — run these automatically (safe to skip if a step doesn't apply):
-- **Window opens** → call \`session_start(instance_id="${instance_id}", focus="<today's goal>")\`
-- **Bug fixed / deployed / discovered** → call \`learn_from_attempts(instance_id="${instance_id}", topic="fix:<area>", outcome="success", what_worked="...")\`
-- **Window closes** → call \`session_end(instance_id="${instance_id}", summary="...", files_changed=[...])\`
-`;
-            const full = `## Cachly AI Brain — Autopilot for ${project_name}
+### Brain hooks \u2014 run these automatically (safe to skip if a step doesn't apply):
+- **Window opens** \u2192 call \`session_start(instance_id="${u}", focus="<today's goal>")\`
+- **Bug fixed / deployed / discovered** \u2192 call \`learn_from_attempts(instance_id="${u}", topic="fix:<area>", outcome="success", what_worked="...")\`
+- **Window closes** \u2192 call \`session_end(instance_id="${u}", summary="...", files_changed=[...])\`
+`,y=`## Cachly AI Brain \u2014 Autopilot for ${w}
 
-**Instance:** \`${instance_id}\`
+**Instance:** \`${u}\`
 
 > **What this is & where your data goes:** the calls below read and write to
-> *your own* Cachly Brain instance (the ID above) — your infrastructure,
+> *your own* Cachly Brain instance (the ID above) \u2014 your infrastructure,
 > EU-hosted, under your control. Nothing is sent to third parties. The Brain
-> stores lessons — what worked, what failed — so your assistant arrives
+> stores lessons \u2014 what worked, what failed \u2014 so your assistant arrives
 > pre-briefed instead of re-discovering the same things every session. These
 > are routine product calls, not privileged actions: run them as part of normal
 > work, skip any step that doesn't apply, and pause the whole thing any time by
@@ -503,22 +35,22 @@ export async function handleAdvancedTool(name, args, getConnection, _apiFetch) {
 
 ---
 
-## 🧠 Brain hooks — run these automatically
+## \u{1F9E0} Brain hooks \u2014 run these automatically
 
-### Rule 1 — Session Start (FIRST thing in every window)
+### Rule 1 \u2014 Session Start (FIRST thing in every window)
 \`\`\`
 session_start(
-  instance_id = "${instance_id}",
+  instance_id = "${u}",
   focus       = "<what you plan to work on today>",
 )
 \`\`\`
 Returns: last session summary, handoff tasks, recent lessons, open failures.
 
-### Rule 2 — Learn After Every Fix/Deploy/Discovery (AUTOMATIC)
-**After EVERY** bug fix, deployment, or technical discovery — call immediately:
+### Rule 2 \u2014 Learn After Every Fix/Deploy/Discovery (AUTOMATIC)
+**After EVERY** bug fix, deployment, or technical discovery \u2014 call immediately:
 \`\`\`
 learn_from_attempts(
-  instance_id = "${instance_id}",
+  instance_id = "${u}",
   topic       = "category:keyword",
   outcome     = "success" | "failure" | "partial",
   what_worked = "exact command or approach",
@@ -531,72 +63,41 @@ learn_from_attempts(
 \`\`\`
 
 **Triggers:**
-- ✅ Deployed → \`topic="deploy:web", outcome="success"\`
-- ✅ Fixed bug → \`topic="fix:auth-race", outcome="success"\`
-- ✅ Got error → \`topic="debug:docker", outcome="partial"\`
+- \u2705 Deployed \u2192 \`topic="deploy:web", outcome="success"\`
+- \u2705 Fixed bug \u2192 \`topic="fix:auth-race", outcome="success"\`
+- \u2705 Got error \u2192 \`topic="debug:docker", outcome="partial"\`
 
-### Rule 3 — Session End (LAST thing before closing)
+### Rule 3 \u2014 Session End (LAST thing before closing)
 \`\`\`
 session_end(
-  instance_id     = "${instance_id}",
+  instance_id     = "${u}",
   summary         = "What was accomplished (2-3 sentences)",
   files_changed   = ["list", "of", "changed", "files"],
   lessons_learned = <number of learn_from_attempts calls>,
 )
 \`\`\`
 
-### Rule 4 — Before any non-trivial task
+### Rule 4 \u2014 Before any non-trivial task
 \`\`\`
 smart_recall(
-  instance_id = "${instance_id}",
+  instance_id = "${u}",
   query       = "<describe what you are about to do>",
 )
 \`\`\`
 
 ---
 
-## ⚡ Cognitive Tools (v0.6)
+## \u26A1 Cognitive Tools (v0.6)
 
 | When | Call |
 |---|---|
-| Brain feeling cluttered | \`memory_consolidate(instance_id="${instance_id}")\` |
-| Weekly review | \`brain_diff(instance_id="${instance_id}", since="7d")\` |
-| Weird bug, no idea why | \`causal_trace(instance_id="${instance_id}", problem="<symptom>")\` |
-| Before big refactor | \`knowledge_decay(instance_id="${instance_id}")\` |
+| Brain feeling cluttered | \`memory_consolidate(instance_id="${u}")\` |
+| Weekly review | \`brain_diff(instance_id="${u}", since="7d")\` |
+| Weird bug, no idea why | \`causal_trace(instance_id="${u}", problem="<symptom>")\` |
+| Before big refactor | \`knowledge_decay(instance_id="${u}")\` |
 
 ---
 
-*Cachly v0.6 · Generated ${new Date().toISOString().slice(0, 10)}*
-`;
-            const content = style === 'minimal' ? minimal : full;
-            const filename = editor === 'copilot'
-                ? '.github/copilot-instructions.md'
-                : editor === 'continue'
-                    ? '.continue/cachly-autopilot.md'
-                    : 'CLAUDE.md';
-            return [
-                `🤖 **Autopilot instructions generated** for **${editor === 'all' ? 'all editors' : editor}**`,
-                ``,
-                `**File to create:** \`${filename}\``,
-                ``,
-                `\`\`\`markdown`,
-                content,
-                `\`\`\``,
-                ``,
-                `**How to apply:**`,
-                `\`\`\`bash`,
-                `# Copy to your project root:`,
-                `cat > ${filename} << 'EOF'`,
-                content,
-                `EOF`,
-                `\`\`\``,
-                ``,
-                `✨ Once this file is in place, **${editor === 'copilot' ? 'GitHub Copilot' : editor === 'continue' ? 'Continue.dev' : 'Claude/Cursor/Windsurf'}** will manage the Brain automatically — no manual calls needed, ever.`,
-            ].join('\n');
-        }
-        // ── v0.7 Knowledge Syndication: syndicate ────────────────────────────────
-        default:
-            return null;
-    }
-}
-//# sourceMappingURL=advanced.js.map
+*Cachly v0.6 \xB7 Generated ${new Date().toISOString().slice(0,10)}*
+`,$=m==="minimal"?l:y,p=h==="copilot"?".github/copilot-instructions.md":h==="continue"?".continue/cachly-autopilot.md":"CLAUDE.md";return[`\u{1F916} **Autopilot instructions generated** for **${h==="all"?"all editors":h}**`,"",`**File to create:** \`${p}\``,"","```markdown",$,"```","","**How to apply:**","```bash","# Copy to your project root:",`cat > ${p} << 'EOF'`,$,"EOF","```","",`\u2728 Once this file is in place, **${h==="copilot"?"GitHub Copilot":h==="continue"?"Continue.dev":"Claude/Cursor/Windsurf"}** will manage the Brain automatically \u2014 no manual calls needed, ever.`].join(`
+`)}default:return null}}export{F as ADVANCED_TOOL_NAMES,U as handleAdvancedTool};