@cachly-dev/mcp-server 0.10.128 → 0.10.130

package/dist/src/handlers/viz.js

@@ -1,148 +1,3 @@
-import { safeJsonParse } from '../utils.js';
-export const VIZ_TOOL_NAMES = new Set(['brain_graph']);
-// Stable color groups so the 3D frontend can theme node kinds consistently.
-const NODE_GROUP = {
-    concept: 1, person: 2, file: 3, service: 4,
-};
-function nodeKind(id) {
-    if (id.startsWith('person:'))
-        return 'person';
-    if (id.startsWith('file:'))
-        return 'file';
-    if (id.startsWith('service:'))
-        return 'service';
-    return 'concept';
-}
-function nodeLabel(n, kind) {
-    if (kind === 'person')
-        return n.handle ?? n.id.replace(/^person:/, '');
-    if (kind === 'file')
-        return (n.path ?? n.id.replace(/^file:/, '')).split('/').slice(-1)[0] ?? n.id;
-    if (kind === 'service')
-        return n.name ?? n.id.replace(/^service:/, '');
-    return n.id;
-}
-async function scanAll(redis, match, limit) {
-    const keys = [];
-    const stream = redis.scanStream({ match, count: 200 });
-    await new Promise((resolve, reject) => {
-        stream.on('data', (batch) => {
-            for (const k of batch) {
-                if (keys.length < limit)
-                    keys.push(k);
-            }
-            if (keys.length >= limit)
-                stream.destroy();
-        });
-        stream.on('end', resolve);
-        stream.on('close', resolve);
-        stream.on('error', reject);
-    });
-    return keys;
-}
-export async function handleVizTool(name, args, getConnection, _apiFetch) {
-    if (name !== 'brain_graph')
-        return null;
-    const { instance_id, max_nodes = 400, domain = '', min_confidence = 0, format = 'json', } = args;
-    const redis = await getConnection(instance_id);
-    const nodeCap = Math.max(1, Math.min(2000, Number(max_nodes) || 400));
-    const minConf = Math.max(0, Math.min(1, Number(min_confidence) || 0));
-    const domainFilter = String(domain || '').toLowerCase().trim();
-    // ── Nodes ────────────────────────────────────────────────────────────────
-    const nodeKeys = await scanAll(redis, 'cachly:ckg:node:*', nodeCap);
-    const nodes = [];
-    const present = new Set();
-    for (const key of nodeKeys) {
-        const raw = await redis.get(key);
-        const stored = safeJsonParse(raw, null);
-        if (!stored || !stored.id)
-            continue;
-        const kind = nodeKind(stored.id);
-        const ndomain = String(stored.domain ?? '').toLowerCase();
-        if (domainFilter && !ndomain.includes(domainFilter) && !stored.id.toLowerCase().includes(domainFilter))
-            continue;
-        const count = Number(stored.count ?? 1) || 1;
-        nodes.push({
-            id: stored.id,
-            name: nodeLabel(stored, kind),
-            type: kind,
-            group: NODE_GROUP[kind] ?? 0,
-            domain: stored.domain ?? '',
-            val: Math.max(1, Math.round(Math.sqrt(count) * 3)),
-            count,
-        });
-        present.add(stored.id);
-    }
-    // ── Edges ──────────────────────────────────────────────────────────────────
-    // Edge keys: cachly:ckg:edge:{from}:{edgeType}:{to}. We read the stored CKGEdge
-    // (not the key) so from/to/confidence come straight from the value — robust to
-    // ids that themselves contain ':' (e.g. "docker:layer-cache").
-    const edgeKeys = await scanAll(redis, 'cachly:ckg:edge:*', nodeCap * 8);
-    const links = [];
-    let edgesSkippedConf = 0;
-    let edgesSkippedDangling = 0;
-    for (const key of edgeKeys) {
-        const raw = await redis.get(key);
-        const edge = safeJsonParse(raw, null);
-        if (!edge || !edge.from || !edge.to)
-            continue;
-        if ((edge.confidence ?? 0) < minConf) {
-            edgesSkippedConf++;
-            continue;
-        }
-        // Drop dangling edges (endpoint filtered out) so the 3D graph stays consistent.
-        if (!present.has(edge.from) || !present.has(edge.to)) {
-            edgesSkippedDangling++;
-            continue;
-        }
-        links.push({
-            source: edge.from,
-            target: edge.to,
-            type: edge.edgeType ?? 'related',
-            value: Number((edge.confidence ?? 0).toFixed(3)),
-            trials: edge.trials ?? 0,
-        });
-    }
-    const byType = {};
-    for (const n of nodes)
-        byType[n.type] = (byType[n.type] ?? 0) + 1;
-    const graph = {
-        schema: 'cachly.brain_graph/v1',
-        nodes,
-        links,
-        meta: {
-            instance_id,
-            generated_at: new Date().toISOString(),
-            node_count: nodes.length,
-            link_count: links.length,
-            node_types: byType,
-            truncated: nodeKeys.length >= nodeCap,
-            filters: { domain: domainFilter || null, min_confidence: minConf, max_nodes: nodeCap },
-        },
-    };
-    if (format === 'summary') {
-        const lines = [
-            `## 🧠 Brain Graph — 3D Viz Export`,
-            '',
-            `**${nodes.length}** nodes · **${links.length}** links`,
-            ...Object.entries(byType).map(([t, c]) => `  • ${t}: ${c}`),
-            edgesSkippedConf ? `  • ${edgesSkippedConf} edges below confidence ${minConf}` : '',
-            edgesSkippedDangling ? `  • ${edgesSkippedDangling} dangling edges dropped` : '',
-            '',
-            graph.meta.truncated ? `⚠️ Truncated at ${nodeCap} nodes — raise \`max_nodes\` for the full graph.` : '',
-            '',
-            `Call \`brain_graph(instance_id="${instance_id}", format="json")\` for the full payload the 3D frontend renders.`,
-        ].filter(Boolean);
-        return lines.join('\n');
-    }
-    // Default: emit the renderable payload in a fenced block so the frontend /
-    // API can lift it verbatim into react-force-graph-3d.
-    return [
-        `🧠 **Brain Graph** — ${nodes.length} nodes, ${links.length} links (schema \`cachly.brain_graph/v1\`)`,
-        '',
-        '```json',
-        JSON.stringify(graph, null, 2),
-        '```',
-    ].join('\n');
-}
-//# sourceMappingURL=viz.js.map
+import{safeJsonParse as M}from"../utils.js";const B=new Set(["brain_graph"]),j={concept:1,person:2,file:3,service:4};function D(n){return n.startsWith("person:")?"person":n.startsWith("file:")?"file":n.startsWith("service:")?"service":"concept"}function L(n,o){return o==="person"?n.handle??n.id.replace(/^person:/,""):o==="file"?(n.path??n.id.replace(/^file:/,"")).split("/").slice(-1)[0]??n.id:o==="service"?n.name??n.id.replace(/^service:/,""):n.id}async function C(n,o,l){const i=[],t=n.scanStream({match:o,count:200});return await new Promise((f,m)=>{t.on("data",g=>{for(const y of g)i.length<l&&i.push(y);i.length>=l&&t.destroy()}),t.on("end",f),t.on("close",f),t.on("error",m)}),i}async function E(n,o,l,i){if(n!=="brain_graph")return null;const{instance_id:t,max_nodes:f=400,domain:m="",min_confidence:g=0,format:y="json"}=o,u=await l(t),s=Math.max(1,Math.min(2e3,Number(f)||400)),_=Math.max(0,Math.min(1,Number(g)||0)),p=String(m||"").toLowerCase().trim(),$=await C(u,"cachly:ckg:node:*",s),a=[],w=new Set;for(const r of $){const d=await u.get(r),e=M(d,null);if(!e||!e.id)continue;const S=D(e.id),O=String(e.domain??"").toLowerCase();if(p&&!O.includes(p)&&!e.id.toLowerCase().includes(p))continue;const v=Number(e.count??1)||1;a.push({id:e.id,name:L(e,S),type:S,group:j[S]??0,domain:e.domain??"",val:Math.max(1,Math.round(Math.sqrt(v)*3)),count:v}),w.add(e.id)}const N=await C(u,"cachly:ckg:edge:*",s*8),c=[];let b=0,k=0;for(const r of N){const d=await u.get(r),e=M(d,null);if(!(!e||!e.from||!e.to)){if((e.confidence??0)<_){b++;continue}if(!w.has(e.from)||!w.has(e.to)){k++;continue}c.push({source:e.from,target:e.to,type:e.edgeType??"related",value:Number((e.confidence??0).toFixed(3)),trials:e.trials??0})}}const h={};for(const r of a)h[r.type]=(h[r.type]??0)+1;const x={schema:"cachly.brain_graph/v1",nodes:a,links:c,meta:{instance_id:t,generated_at:new Date().toISOString(),node_count:a.length,link_count:c.length,node_types:h,truncated:$.length>=s,filters:{domain:p||null,min_confidence:_,max_nodes:s}}};return y==="summary"?["## \u{1F9E0} Brain Graph \u2014 3D Viz Export","",`**${a.length}** nodes \xB7 **${c.length}** links`,...Object.entries(h).map(([d,e])=>`  \u2022 ${d}: ${e}`),b?`  \u2022 ${b} edges below confidence ${_}`:"",k?`  \u2022 ${k} dangling edges dropped`:"","",x.meta.truncated?`\u26A0\uFE0F Truncated at ${s} nodes \u2014 raise \`max_nodes\` for the full graph.`:"","",`Call \`brain_graph(instance_id="${t}", format="json")\` for the full payload the 3D frontend renders.`].filter(Boolean).join(`
+`):[`\u{1F9E0} **Brain Graph** \u2014 ${a.length} nodes, ${c.length} links (schema \`cachly.brain_graph/v1\`)`,"","```json",JSON.stringify(x,null,2),"```"].join(`
+`)}export{B as VIZ_TOOL_NAMES,E as handleVizTool};