@4da/mcp-server 4.3.0 → 4.6.0

package/dist/tools/topic-connections.js

@@ -1,319 +0,0 @@
-// SPDX-License-Identifier: FSL-1.1-Apache-2.0
-/**
- * Topic Connections Tool
- *
- * Build and explore knowledge graphs from discovered content.
- * This is a SUPERPOWER - it reveals hidden connections between topics.
- *
- * With synthesize=true, uses LLM to explain the significance of connections.
- */
-import { getLLMConfig, canSynthesize, synthesize, SYNTHESIS_PROMPTS } from "../llm.js";
-import { createTopicConnectionsCompact } from "../output-manager.js";
-export const topicConnectionsTool = {
-    name: "topic_connections",
-    description: `Discover connections between topics in your content.
-
-With synthesize=true (recommended), uses AI to explain the significance of connections.
-
-Returns:
-- Topic co-occurrence graph
-- Strongest topic relationships
-- Central/hub topics
-- Path finding between topics
-- AI insights about connections (when enabled)
-
-Use this to understand how your interests connect.`,
-    inputSchema: {
-        type: "object",
-        properties: {
-            topics: {
-                type: "array",
-                items: { type: "string" },
-                description: "Specific topics to analyze (optional, auto-detect if not specified)",
-            },
-            find_path: {
-                type: "object",
-                properties: {
-                    from: { type: "string" },
-                    to: { type: "string" },
-                },
-                description: "Find connection path between two topics",
-            },
-            days: {
-                type: "number",
-                description: "Days of content to analyze (default: 30)",
-            },
-            synthesize: {
-                type: "boolean",
-                description: "Use AI to explain connection significance (default: true if LLM configured)",
-            },
-            compact: {
-                type: "boolean",
-                description: "Return compact result with file reference (default: true for ~80% token reduction)",
-            },
-        },
-    },
-};
-export async function executeTopicConnections(db, params) {
-    const { topics: customTopics, find_path, days = 30 } = params;
-    const useCompact = params.compact !== false; // Default to compact=true
-    const dbInstance = db.db;
-    // Check LLM availability
-    const llmConfig = getLLMConfig(dbInstance);
-    const shouldSynthesize = params.synthesize ?? canSynthesize(llmConfig);
-    // Default topics to analyze
-    const topics = customTopics || [
-        "rust", "typescript", "python", "go", "javascript",
-        "ai", "llm", "embedding", "database", "sql", "sqlite",
-        "react", "async", "wasm", "security", "api", "performance"
-    ];
-    // Get items for analysis
-    const items = db.getRelevantContent(0, undefined, 500, days * 24);
-    // Build nodes
-    const nodes = [];
-    const topicItems = new Map();
-    for (const topic of topics) {
-        const matching = items.filter(i => {
-            const text = (i.title + " " + i.content).toLowerCase();
-            return text.includes(topic.toLowerCase());
-        });
-        if (matching.length > 0) {
-            topicItems.set(topic, matching);
-            const avgRelevance = matching.reduce((sum, i) => sum + i.relevance_score, 0) / matching.length;
-            nodes.push({
-                topic,
-                mention_count: matching.length,
-                avg_relevance: Math.round(avgRelevance * 100) / 100,
-                centrality: 0, // Calculated later
-                connections: 0, // Calculated later
-            });
-        }
-    }
-    // Build edges (co-occurrence)
-    const edges = [];
-    const nodeTopics = nodes.map(n => n.topic);
-    for (let i = 0; i < nodeTopics.length; i++) {
-        for (let j = i + 1; j < nodeTopics.length; j++) {
-            const topicA = nodeTopics[i];
-            const topicB = nodeTopics[j];
-            // Count co-occurrences
-            const coOccur = items.filter(item => {
-                const text = (item.title + " " + item.content).toLowerCase();
-                return text.includes(topicA.toLowerCase()) && text.includes(topicB.toLowerCase());
-            }).length;
-            if (coOccur > 0) {
-                edges.push({
-                    from: topicA,
-                    to: topicB,
-                    co_occurrences: coOccur,
-                    strength: coOccur >= 10 ? "strong" : coOccur >= 3 ? "medium" : "weak",
-                });
-                // Update connection counts
-                const nodeA = nodes.find(n => n.topic === topicA);
-                const nodeB = nodes.find(n => n.topic === topicB);
-                if (nodeA)
-                    nodeA.connections++;
-                if (nodeB)
-                    nodeB.connections++;
-            }
-        }
-    }
-    // Calculate centrality (simplified: connection count weighted by strength)
-    const maxConnections = Math.max(...nodes.map(n => n.connections), 1);
-    for (const node of nodes) {
-        node.centrality = Math.round((node.connections / maxConnections) * 100) / 100;
-    }
-    // Find path if requested
-    let path;
-    if (find_path) {
-        path = findTopicPath(find_path.from, find_path.to, edges, items);
-    }
-    // Identify clusters
-    const clusters = identifyClusters(nodes, edges);
-    // Central and isolated topics
-    const centralTopics = nodes
-        .filter(n => n.centrality >= 0.5)
-        .sort((a, b) => b.centrality - a.centrality)
-        .slice(0, 5)
-        .map(n => n.topic);
-    const isolatedTopics = nodes
-        .filter(n => n.connections === 0)
-        .map(n => n.topic);
-    // Generate insights
-    const insights = generateGraphInsights(nodes, edges, clusters);
-    const result = {
-        analysis_period: {
-            days,
-            items_analyzed: items.length,
-        },
-        nodes: nodes.sort((a, b) => b.mention_count - a.mention_count),
-        edges: edges.sort((a, b) => b.co_occurrences - a.co_occurrences),
-        path,
-        clusters,
-        central_topics: centralTopics,
-        isolated_topics: isolatedTopics,
-        insights,
-    };
-    // AI Graph Insights - the actual superpower
-    if (shouldSynthesize && canSynthesize(llmConfig)) {
-        try {
-            const context = db.getUserContext(true, true);
-            const graphData = {
-                nodes: result.nodes.slice(0, 15),
-                edges: result.edges.slice(0, 20),
-                clusters: result.clusters,
-                central_topics: result.central_topics,
-                isolated_topics: result.isolated_topics,
-                path: result.path,
-            };
-            const contextData = {
-                interests: context.interests.slice(0, 10),
-                tech_stack: context.tech_stack,
-                role: context.role,
-            };
-            const synthesis = await synthesize(llmConfig, {
-                system: SYNTHESIS_PROMPTS.topicConnections.system,
-                prompt: SYNTHESIS_PROMPTS.topicConnections.buildPrompt(graphData, contextData),
-                max_tokens: 400,
-                complexity: SYNTHESIS_PROMPTS.topicConnections.complexity,
-            });
-            // Parse the synthesis
-            const lines = synthesis.synthesis.split("\n").filter(l => l.trim());
-            const surprisingConnection = lines.find(l => l.toLowerCase().includes("surprising") ||
-                l.toLowerCase().includes("interesting") ||
-                l.toLowerCase().includes("unexpected")) || lines[0] || "";
-            const exploration = lines.find(l => l.toLowerCase().includes("explore") ||
-                l.toLowerCase().includes("investigate") ||
-                l.toLowerCase().includes("look into")) || "";
-            const hiddenPattern = lines.find(l => l.toLowerCase().includes("pattern") ||
-                l.toLowerCase().includes("reveals") ||
-                l.toLowerCase().includes("suggests")) || "";
-            result.ai_insights = {
-                graph_narrative: synthesis.synthesis,
-                surprising_connection: surprisingConnection,
-                exploration_suggestion: exploration || "Explore connections between central topics",
-                hidden_pattern: hiddenPattern || "No hidden patterns detected",
-                model_used: synthesis.model_used,
-            };
-        }
-        catch (error) {
-            console.error("AI graph insights failed:", error);
-        }
-    }
-    // Return compact or full result based on parameter
-    if (useCompact) {
-        return createTopicConnectionsCompact(result);
-    }
-    return result;
-}
-function findTopicPath(from, to, edges, items) {
-    // Direct connection
-    const directEdge = edges.find(e => (e.from === from && e.to === to) || (e.from === to && e.to === from));
-    if (directEdge) {
-        // Get connecting items
-        const connectingItems = items
-            .filter(i => {
-            const text = (i.title + " " + i.content).toLowerCase();
-            return text.includes(from.toLowerCase()) && text.includes(to.toLowerCase());
-        })
-            .slice(0, 3)
-            .map(i => ({ title: i.title, score: i.relevance_score }));
-        return {
-            from,
-            to,
-            path: [from, to],
-            direct_connection: true,
-            connecting_items: connectingItems,
-        };
-    }
-    // Two-hop path (simplified BFS)
-    for (const edge of edges) {
-        const intermediate = edge.from === from ? edge.to :
-            edge.to === from ? edge.from : null;
-        if (intermediate) {
-            const secondEdge = edges.find(e => (e.from === intermediate && e.to === to) ||
-                (e.to === intermediate && e.from === to));
-            if (secondEdge) {
-                const connectingItems = items
-                    .filter(i => {
-                    const text = (i.title + " " + i.content).toLowerCase();
-                    return text.includes(intermediate.toLowerCase());
-                })
-                    .slice(0, 3)
-                    .map(i => ({ title: i.title, score: i.relevance_score }));
-                return {
-                    from,
-                    to,
-                    path: [from, intermediate, to],
-                    direct_connection: false,
-                    connecting_items: connectingItems,
-                };
-            }
-        }
-    }
-    // No path found
-    return {
-        from,
-        to,
-        path: [],
-        direct_connection: false,
-        connecting_items: [],
-    };
-}
-function identifyClusters(nodes, edges) {
-    // Predefined cluster patterns
-    const clusterPatterns = [
-        { name: "Systems Programming", keywords: ["rust", "go", "async", "wasm", "performance"] },
-        { name: "AI & ML", keywords: ["ai", "llm", "embedding", "python", "ml"] },
-        { name: "Web Development", keywords: ["typescript", "javascript", "react", "frontend", "api"] },
-        { name: "Data & Storage", keywords: ["database", "sql", "sqlite", "redis", "postgres"] },
-    ];
-    const clusters = [];
-    for (const pattern of clusterPatterns) {
-        const matchingNodes = nodes.filter(n => pattern.keywords.includes(n.topic.toLowerCase()));
-        if (matchingNodes.length >= 2) {
-            // Calculate internal edge count for coherence
-            let internalEdges = 0;
-            const topics = matchingNodes.map(n => n.topic);
-            for (const edge of edges) {
-                if (topics.includes(edge.from) && topics.includes(edge.to)) {
-                    internalEdges++;
-                }
-            }
-            const maxEdges = (topics.length * (topics.length - 1)) / 2;
-            const coherence = maxEdges > 0 ? internalEdges / maxEdges : 0;
-            clusters.push({
-                name: pattern.name,
-                topics: matchingNodes.map(n => n.topic),
-                item_count: matchingNodes.reduce((sum, n) => sum + n.mention_count, 0),
-                coherence: Math.round(coherence * 100) / 100,
-            });
-        }
-    }
-    return clusters.sort((a, b) => b.item_count - a.item_count);
-}
-function generateGraphInsights(nodes, edges, clusters) {
-    const insights = [];
-    // Most central topic
-    const mostCentral = nodes.sort((a, b) => b.centrality - a.centrality)[0];
-    if (mostCentral) {
-        insights.push(`"${mostCentral.topic}" is your most connected topic (${mostCentral.connections} connections)`);
-    }
-    // Strongest connection
-    const strongestEdge = edges[0];
-    if (strongestEdge) {
-        insights.push(`Strongest connection: "${strongestEdge.from}" ↔ "${strongestEdge.to}" (${strongestEdge.co_occurrences} co-occurrences)`);
-    }
-    // Isolated topics
-    const isolated = nodes.filter(n => n.connections === 0);
-    if (isolated.length > 0) {
-        insights.push(`${isolated.length} isolated topic(s): ${isolated.map(n => n.topic).join(", ")} - consider exploring connections`);
-    }
-    // Cluster insight
-    const topCluster = clusters[0];
-    if (topCluster) {
-        insights.push(`"${topCluster.name}" is your strongest cluster with ${topCluster.topics.length} related topics`);
-    }
-    return insights;
-}
-//# sourceMappingURL=topic-connections.js.map

package/dist/tools/topic-connections.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"topic-connections.js","sourceRoot":"","sources":["../../src/tools/topic-connections.ts"],"names":[],"mappings":"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"}

package/dist/tools/trend-analysis.d.ts

@@ -1,105 +0,0 @@
-/**
- * Trend Analysis Tool
- *
- * Statistical analysis of patterns and trends over time.
- * This is a SUPERPOWER - it reveals what's rising, falling, and anomalous.
- *
- * With synthesize=true, uses LLM to interpret trends and make predictions.
- */
-import type { FourDADatabase } from "../db.js";
-import { type CompactResult, type TrendAnalysisKeyData } from "../output-manager.js";
-export declare const trendAnalysisTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            days: {
-                type: string;
-                description: string;
-            };
-            topic: {
-                type: string;
-                description: string;
-            };
-            detect_anomalies: {
-                type: string;
-                description: string;
-            };
-            synthesize: {
-                type: string;
-                description: string;
-            };
-            compact: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-};
-export interface TrendAnalysisParams {
-    days?: number;
-    topic?: string;
-    detect_anomalies?: boolean;
-    synthesize?: boolean;
-    compact?: boolean;
-}
-interface TopicTrend {
-    topic: string;
-    current_week: number;
-    previous_week: number;
-    change_percent: number;
-    trend: "rising" | "falling" | "stable";
-    avg_score: number;
-}
-interface VolumeAnomaly {
-    date: string;
-    volume: number;
-    expected: number;
-    z_score: number;
-    status: "spike" | "drop" | "normal";
-}
-interface SourceTrend {
-    source: string;
-    volume_trend: "up" | "down" | "stable";
-    quality_trend: "up" | "down" | "stable";
-    avg_score: number;
-    item_count: number;
-}
-interface TrendResult {
-    period: {
-        start: string;
-        end: string;
-        days: number;
-    };
-    summary: {
-        total_items: number;
-        avg_relevance: number;
-        volume_trend: string;
-        top_rising_topic: string | null;
-        top_falling_topic: string | null;
-    };
-    topic_trends: TopicTrend[];
-    volume_by_day: {
-        date: string;
-        count: number;
-    }[];
-    anomalies: VolumeAnomaly[];
-    source_trends: SourceTrend[];
-    correlations: {
-        topic_a: string;
-        topic_b: string;
-        co_occurrences: number;
-    }[];
-    predictions: string[];
-    ai_interpretation?: {
-        narrative: string;
-        key_signal: string;
-        forecast: string;
-        recommended_focus: string;
-        model_used: string;
-    };
-}
-export declare function executeTrendAnalysis(db: FourDADatabase, params: TrendAnalysisParams): Promise<TrendResult | CompactResult<TrendAnalysisKeyData>>;
-export {};
-//# sourceMappingURL=trend-analysis.d.ts.map

package/dist/tools/trend-analysis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trend-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/trend-analysis.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAA8B,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC7B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;CACrC;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,iBAAiB,CAAC,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAkJ5D"}