@4da/mcp-server 4.3.0 → 4.6.0

package/dist/tools/trend-analysis.js

@@ -1,296 +0,0 @@
-// SPDX-License-Identifier: FSL-1.1-Apache-2.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 { getLLMConfig, canSynthesize, synthesize, SYNTHESIS_PROMPTS } from "../llm.js";
-import { createTrendAnalysisCompact } from "../output-manager.js";
-export const trendAnalysisTool = {
-    name: "trend_analysis",
-    description: `Analyze patterns and trends in 4DA's content over time.
-
-With synthesize=true (recommended), uses AI to interpret trends and predict what matters.
-
-Returns:
-- Topic frequency trends (rising/falling)
-- Volume anomalies detected
-- Week-over-week comparisons
-- Source performance trends
-- AI predictions (when enabled)
-
-Use this to understand what's changing in your information landscape.`,
-    inputSchema: {
-        type: "object",
-        properties: {
-            days: {
-                type: "number",
-                description: "Analysis period in days (default: 30)",
-            },
-            topic: {
-                type: "string",
-                description: "Specific topic to analyze (optional)",
-            },
-            detect_anomalies: {
-                type: "boolean",
-                description: "Include anomaly detection (default: true)",
-            },
-            synthesize: {
-                type: "boolean",
-                description: "Use AI to interpret trends and predict (default: true if LLM configured)",
-            },
-            compact: {
-                type: "boolean",
-                description: "Return compact result with file reference (default: true for ~80% token reduction)",
-            },
-        },
-    },
-};
-export async function executeTrendAnalysis(db, params) {
-    const { days = 30, topic, detect_anomalies = true } = 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);
-    const endDate = new Date();
-    const startDate = new Date(endDate.getTime() - days * 24 * 60 * 60 * 1000);
-    // Volume by day
-    const volumeByDayStmt = dbInstance.prepare(`
-    SELECT date(created_at) as date, COUNT(*) as count
-    FROM source_items
-    WHERE datetime(created_at) >= datetime(?)
-    GROUP BY date(created_at)
-    ORDER BY date
-  `);
-    const volumeByDay = volumeByDayStmt.all(startDate.toISOString());
-    // Calculate statistics for anomaly detection
-    const volumes = volumeByDay.map(v => v.count);
-    const mean = volumes.reduce((a, b) => a + b, 0) / volumes.length || 0;
-    const stdDev = Math.sqrt(volumes.reduce((sum, v) => sum + Math.pow(v - mean, 2), 0) / volumes.length) || 1;
-    // Detect anomalies
-    const anomalies = detect_anomalies
-        ? volumeByDay
-            .map(v => ({
-            date: v.date,
-            volume: v.count,
-            expected: Math.round(mean),
-            z_score: Math.round(((v.count - mean) / stdDev) * 100) / 100,
-            status: (v.count - mean) / stdDev > 2 ? "spike" :
-                (v.count - mean) / stdDev < -2 ? "drop" : "normal",
-        }))
-            .filter(a => a.status !== "normal")
-        : [];
-    // Topic trends - compare this week vs last week
-    const topicTrends = getTopicTrends(dbInstance, topic);
-    // Source trends
-    const sourceTrends = getSourceTrends(dbInstance, days);
-    // Topic correlations (co-occurrence)
-    const correlations = getTopicCorrelations(dbInstance, days);
-    // Overall stats
-    const totalStmt = dbInstance.prepare(`
-    SELECT COUNT(*) as total, AVG(CASE WHEN url IS NOT NULL THEN 1 ELSE 0 END) as avg_has_url
-    FROM source_items
-    WHERE datetime(created_at) >= datetime(?)
-  `);
-    const totalStats = totalStmt.get(startDate.toISOString());
-    // Get relevant items for avg score
-    const relevantItems = db.getRelevantContent(0, undefined, 1000, days * 24);
-    const avgRelevance = relevantItems.length > 0
-        ? relevantItems.reduce((sum, i) => sum + i.relevance_score, 0) / relevantItems.length
-        : 0;
-    // Volume trend
-    const recentVolume = volumeByDay.slice(-7).reduce((sum, v) => sum + v.count, 0);
-    const olderVolume = volumeByDay.slice(-14, -7).reduce((sum, v) => sum + v.count, 0);
-    const volumeTrend = recentVolume > olderVolume * 1.1 ? "increasing" :
-        recentVolume < olderVolume * 0.9 ? "decreasing" : "stable";
-    // Generate predictions
-    const predictions = generatePredictions(topicTrends, volumeTrend, anomalies);
-    const result = {
-        period: {
-            start: startDate.toISOString().split("T")[0],
-            end: endDate.toISOString().split("T")[0],
-            days,
-        },
-        summary: {
-            total_items: totalStats.total,
-            avg_relevance: Math.round(avgRelevance * 100) / 100,
-            volume_trend: volumeTrend,
-            top_rising_topic: topicTrends.find(t => t.trend === "rising")?.topic || null,
-            top_falling_topic: topicTrends.find(t => t.trend === "falling")?.topic || null,
-        },
-        topic_trends: topicTrends,
-        volume_by_day: volumeByDay,
-        anomalies,
-        source_trends: sourceTrends,
-        correlations,
-        predictions,
-    };
-    // AI Interpretation - the actual superpower
-    if (shouldSynthesize && canSynthesize(llmConfig)) {
-        try {
-            const context = db.getUserContext(true, true);
-            const trendData = {
-                period: result.period,
-                summary: result.summary,
-                topic_trends: result.topic_trends.slice(0, 8),
-                anomalies: result.anomalies,
-                correlations: result.correlations,
-            };
-            const contextData = {
-                interests: context.interests.slice(0, 10),
-                tech_stack: context.tech_stack,
-                role: context.role,
-            };
-            const synthesis = await synthesize(llmConfig, {
-                system: SYNTHESIS_PROMPTS.trendAnalysis.system,
-                prompt: SYNTHESIS_PROMPTS.trendAnalysis.buildPrompt(trendData, contextData),
-                max_tokens: 400,
-                complexity: SYNTHESIS_PROMPTS.trendAnalysis.complexity,
-            });
-            // Parse the synthesis
-            const lines = synthesis.synthesis.split("\n").filter(l => l.trim());
-            const keySignal = lines[0] || "";
-            const forecast = lines.find(l => l.toLowerCase().includes("week") || l.toLowerCase().includes("expect") || l.toLowerCase().includes("predict")) || lines[1] || "";
-            const focus = lines.find(l => l.toLowerCase().includes("focus") || l.toLowerCase().includes("attention") || l.toLowerCase().includes("should")) || "";
-            result.ai_interpretation = {
-                narrative: synthesis.synthesis,
-                key_signal: keySignal,
-                forecast: forecast,
-                recommended_focus: focus || "Continue monitoring trends",
-                model_used: synthesis.model_used,
-            };
-        }
-        catch (error) {
-            console.error("AI interpretation failed:", error);
-        }
-    }
-    // Return compact or full result based on parameter
-    if (useCompact) {
-        return createTrendAnalysisCompact(result);
-    }
-    return result;
-}
-function getTopicTrends(db, filterTopic) {
-    // Define topics to track
-    const topics = filterTopic
-        ? [filterTopic]
-        : ["rust", "typescript", "python", "ai", "llm", "database", "security", "async", "wasm", "react"];
-    const trends = [];
-    for (const topic of topics) {
-        // This week
-        const thisWeekStmt = db.prepare(`
-      SELECT COUNT(*) as count, AVG(CASE WHEN url IS NOT NULL THEN 1 ELSE 0 END) as quality
-      FROM source_items
-      WHERE datetime(created_at) >= datetime('now', '-7 days')
-      AND (lower(title) LIKE ? OR lower(content) LIKE ?)
-    `);
-        const thisWeek = thisWeekStmt.all(`%${topic}%`, `%${topic}%`);
-        // Last week
-        const lastWeekStmt = db.prepare(`
-      SELECT COUNT(*) as count
-      FROM source_items
-      WHERE datetime(created_at) >= datetime('now', '-14 days')
-      AND datetime(created_at) < datetime('now', '-7 days')
-      AND (lower(title) LIKE ? OR lower(content) LIKE ?)
-    `);
-        const lastWeek = lastWeekStmt.all(`%${topic}%`, `%${topic}%`);
-        const current = thisWeek[0]?.count || 0;
-        const previous = lastWeek[0]?.count || 0;
-        const changePercent = previous > 0
-            ? Math.round(((current - previous) / previous) * 100)
-            : current > 0 ? 100 : 0;
-        trends.push({
-            topic,
-            current_week: current,
-            previous_week: previous,
-            change_percent: changePercent,
-            trend: changePercent > 15 ? "rising" : changePercent < -15 ? "falling" : "stable",
-            avg_score: thisWeek[0]?.quality || 0,
-        });
-    }
-    // Sort by absolute change
-    return trends.sort((a, b) => Math.abs(b.change_percent) - Math.abs(a.change_percent));
-}
-function getSourceTrends(db, days) {
-    const stmt = db.prepare(`
-    SELECT
-      source_type,
-      COUNT(*) as total,
-      SUM(CASE WHEN datetime(created_at) >= datetime('now', '-7 days') THEN 1 ELSE 0 END) as recent,
-      SUM(CASE WHEN datetime(created_at) >= datetime('now', '-14 days')
-               AND datetime(created_at) < datetime('now', '-7 days') THEN 1 ELSE 0 END) as older
-    FROM source_items
-    WHERE datetime(created_at) >= datetime('now', '-' || ? || ' days')
-    GROUP BY source_type
-  `);
-    const sources = stmt.all(days);
-    return sources.map(s => ({
-        source: s.source_type,
-        volume_trend: s.recent > s.older * 1.1 ? "up" :
-            s.recent < s.older * 0.9 ? "down" : "stable",
-        quality_trend: "stable", // Would need more data to compute
-        avg_score: 0.6, // Placeholder
-        item_count: s.total,
-    }));
-}
-function getTopicCorrelations(db, days) {
-    const topicPairs = [
-        ["rust", "async"],
-        ["ai", "llm"],
-        ["typescript", "react"],
-        ["database", "sql"],
-        ["security", "auth"],
-    ];
-    const correlations = [];
-    for (const [a, b] of topicPairs) {
-        const stmt = db.prepare(`
-      SELECT COUNT(*) as count
-      FROM source_items
-      WHERE datetime(created_at) >= datetime('now', '-' || ? || ' days')
-      AND (lower(title) LIKE ? OR lower(content) LIKE ?)
-      AND (lower(title) LIKE ? OR lower(content) LIKE ?)
-    `);
-        const result = stmt.all(days, `%${a}%`, `%${a}%`, `%${b}%`, `%${b}%`);
-        if (result[0]?.count > 0) {
-            correlations.push({
-                topic_a: a,
-                topic_b: b,
-                co_occurrences: result[0].count,
-            });
-        }
-    }
-    return correlations.sort((a, b) => b.co_occurrences - a.co_occurrences);
-}
-function generatePredictions(trends, volumeTrend, anomalies) {
-    const predictions = [];
-    // Rising topics
-    const rising = trends.filter(t => t.trend === "rising");
-    if (rising.length > 0) {
-        predictions.push(`"${rising[0].topic}" is trending up (+${rising[0].change_percent}%) - expect more content soon`);
-    }
-    // Falling topics
-    const falling = trends.filter(t => t.trend === "falling");
-    if (falling.length > 0) {
-        predictions.push(`"${falling[0].topic}" is declining (${falling[0].change_percent}%) - may stabilize or continue dropping`);
-    }
-    // Volume prediction
-    if (volumeTrend === "increasing") {
-        predictions.push("Overall content volume is increasing - more items to filter");
-    }
-    else if (volumeTrend === "decreasing") {
-        predictions.push("Content volume is decreasing - sources may need attention");
-    }
-    // Anomaly-based prediction
-    if (anomalies.filter(a => a.status === "spike").length > 2) {
-        predictions.push("Multiple volume spikes detected - possibly major news events");
-    }
-    if (predictions.length === 0) {
-        predictions.push("Patterns are stable - no significant changes predicted");
-    }
-    return predictions;
-}
-//# sourceMappingURL=trend-analysis.js.map

package/dist/tools/trend-analysis.js.map

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

package/dist/tools/trust-summary.d.ts

@@ -1,38 +0,0 @@
-/**
- * trust_summary tool
- *
- * Returns intelligence quality metrics from the trust ledger —
- * precision, action rate, false positive rate, preemption wins.
- * Helps agents assess how reliable 4DA's intelligence is.
- */
-import type { FourDADatabase } from "../db.js";
-export interface TrustSummaryParams {
-    days?: number;
-}
-export declare const trustSummaryTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            days: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-    };
-};
-export declare function executeTrustSummary(db: FourDADatabase, params: TrustSummaryParams): {
-    period_days: number;
-    total_surfaced: number;
-    acted_on: number;
-    dismissed: number;
-    false_positives: number;
-    precision: number;
-    action_conversion_rate: number;
-    preemption_wins: number;
-    avg_lead_time_hours: number | null;
-    reliability_assessment: string;
-};
-//# sourceMappingURL=trust-summary.d.ts.map

package/dist/tools/trust-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trust-summary.d.ts","sourceRoot":"","sources":["../../src/tools/trust-summary.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAc5B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,kBAAkB;;;;;;;;;;;EA8E3B"}

package/dist/tools/trust-summary.js

@@ -1,89 +0,0 @@
-// SPDX-License-Identifier: FSL-1.1-Apache-2.0
-/**
- * trust_summary tool
- *
- * Returns intelligence quality metrics from the trust ledger —
- * precision, action rate, false positive rate, preemption wins.
- * Helps agents assess how reliable 4DA's intelligence is.
- */
-export const trustSummaryTool = {
-    name: "trust_summary",
-    description: "Get intelligence quality metrics — precision, action conversion rate, false positive rate, and preemption wins. Use this to assess how reliable 4DA's signals are before acting on them.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            days: {
-                type: "number",
-                description: "Number of days to analyze. Default: 30",
-                default: 30,
-            },
-        },
-    },
-};
-export function executeTrustSummary(db, params) {
-    const rawDb = db.getRawDb();
-    const days = params.days ?? 30;
-    const offset = `-${days} days`;
-    // Count events by type
-    let counts = [];
-    try {
-        counts = rawDb
-            .prepare(`SELECT event_type, COUNT(*) as cnt
-       FROM trust_events
-       WHERE created_at >= datetime('now', ?)
-       GROUP BY event_type`)
-            .all(offset);
-    }
-    catch {
-        /* trust_events table may not exist yet */
-    }
-    const getCount = (type) => counts.find((c) => c.event_type === type)?.cnt ?? 0;
-    const surfaced = getCount("surfaced");
-    const acted_on = getCount("acted_on");
-    const dismissed = getCount("dismissed");
-    const false_positives = getCount("false_positive");
-    const validated = getCount("validated");
-    const true_positives = acted_on + validated;
-    const precision = true_positives + false_positives > 0
-        ? true_positives / (true_positives + false_positives)
-        : 1.0;
-    const action_rate = surfaced > 0 ? acted_on / surfaced : 0;
-    // Preemption wins
-    let preemption_wins = 0;
-    let avg_lead_time_hours = null;
-    try {
-        const winRow = rawDb
-            .prepare(`SELECT COUNT(*) as wins, AVG(lead_time_hours) as avg_lead
-       FROM preemption_wins
-       WHERE verified = 1 AND created_at >= datetime('now', ?)`)
-            .get(offset);
-        if (winRow) {
-            preemption_wins = winRow.wins;
-            avg_lead_time_hours = winRow.avg_lead;
-        }
-    }
-    catch {
-        /* table may not exist yet */
-    }
-    return {
-        period_days: days,
-        total_surfaced: surfaced,
-        acted_on,
-        dismissed,
-        false_positives,
-        precision: Math.round(precision * 1000) / 1000,
-        action_conversion_rate: Math.round(action_rate * 1000) / 1000,
-        preemption_wins,
-        avg_lead_time_hours: avg_lead_time_hours
-            ? Math.round(avg_lead_time_hours * 10) / 10
-            : null,
-        reliability_assessment: precision >= 0.8
-            ? "high"
-            : precision >= 0.6
-                ? "moderate"
-                : precision >= 0.3
-                    ? "developing"
-                    : "insufficient_data",
-    };
-}
-//# sourceMappingURL=trust-summary.js.map

package/dist/tools/trust-summary.js.map

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