@4da/mcp-server 3.2.0

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

@@ -0,0 +1,105 @@
+/**
+ * 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

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

package/dist/tools/trend-analysis.js

@@ -0,0 +1,295 @@
+/**
+ * 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

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

package/dist/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Type definitions for 4DA MCP Server
+ *
+ * These types mirror the 4DA database schema for read operations.
+ */
+/**
+ * A content item from any source (HN, arXiv, Reddit, etc.)
+ */
+export interface SourceItem {
+    id: number;
+    source_type: string;
+    source_id: string;
+    url: string | null;
+    title: string;
+    content: string;
+    content_hash: string;
+    created_at: string;
+    last_seen: string;
+}
+/**
+ * A relevant content item with computed score
+ */
+export interface RelevantItem {
+    id: number;
+    source_type: string;
+    source_id: string;
+    url: string | null;
+    title: string;
+    content: string;
+    relevance_score: number;
+    created_at: string;
+    discovered_ago: string;
+}
+/**
+ * Explicit user interest
+ */
+export interface Interest {
+    id: number;
+    topic: string;
+    weight: number;
+    source: "explicit" | "github" | "import" | "inferred";
+}
+/**
+ * Detected technology from ACE
+ */
+export interface DetectedTech {
+    name: string;
+    category: string;
+    confidence: number;
+    source: string;
+}
+/**
+ * Active topic from ACE
+ */
+export interface ActiveTopic {
+    topic: string;
+    weight: number;
+    confidence: number;
+    source: string;
+    last_seen: string;
+}
+/**
+ * Learned topic affinity
+ */
+export interface TopicAffinity {
+    topic: string;
+    affinity_score: number;
+    confidence: number;
+    positive_signals: number;
+    negative_signals: number;
+    total_exposures: number;
+}
+/**
+ * Anti-topic (learned exclusion)
+ */
+export interface AntiTopic {
+    topic: string;
+    rejection_count: number;
+    confidence: number;
+    auto_detected: boolean;
+    user_confirmed: boolean;
+}
+/**
+ * Complete user context returned by get_context
+ */
+export interface UserContext {
+    role: string | null;
+    tech_stack: string[];
+    domains: string[];
+    interests: Interest[];
+    exclusions: string[];
+    ace?: {
+        detected_tech: DetectedTech[];
+        active_topics: ActiveTopic[];
+    };
+    learned?: {
+        topic_affinities: TopicAffinity[];
+        anti_topics: AntiTopic[];
+    };
+}
+/**
+ * Score breakdown for explain_relevance
+ */
+export interface ScoreBreakdown {
+    embedding_similarity: number | null;
+    static_match_score: number;
+    ace_match_score: number;
+    learned_affinity_score: number;
+    anti_penalty: number;
+    final_score: number;
+}
+/**
+ * Matching context elements
+ */
+export interface MatchingContext {
+    matching_interests: string[];
+    matching_tech: string[];
+    matching_topics: string[];
+    matching_affinities: string[];
+}
+/**
+ * Full relevance explanation
+ */
+export interface RelevanceExplanation {
+    item_id: number;
+    source_type: string;
+    title: string;
+    score_breakdown: ScoreBreakdown;
+    matching_context: MatchingContext;
+    explanation: string;
+}
+/**
+ * Valid feedback action types
+ */
+export type FeedbackAction = "click" | "save" | "dismiss" | "mark_irrelevant";
+/**
+ * Feedback recording result
+ */
+export interface FeedbackResult {
+    success: boolean;
+    message: string;
+    interaction_id?: number;
+}
+export interface GetRelevantContentParams {
+    min_score?: number;
+    source_type?: string;
+    limit?: number;
+    since_hours?: number;
+}
+export interface GetContextParams {
+    include_ace?: boolean;
+    include_learned?: boolean;
+}
+export interface ExplainRelevanceParams {
+    item_id: number;
+    source_type: string;
+}
+export interface RecordFeedbackParams {
+    item_id: number;
+    source_type: string;
+    action: FeedbackAction;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for 4DA MCP Server
+ *
+ * These types mirror the 4DA database schema for read operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@4da/mcp-server",
+  "version": "3.2.0",
+  "description": "MCP server for 4DA — plug your personalized developer intelligence feed into Claude Code, Cursor, or any MCP host. 13 tools for content filtering, signals, briefings, and knowledge gap detection.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "4da-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && pnpm run copy-schemas",
+    "copy-schemas": "node -e \"const fs=require('fs');const path=require('path');const src='src/schemas';const dst='dist/schemas';if(!fs.existsSync(dst))fs.mkdirSync(dst,{recursive:true});fs.readdirSync(src).filter(f=>f.endsWith('.json')).forEach(f=>fs.copyFileSync(path.join(src,f),path.join(dst,f)))\"",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "pnpm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "4da",
+    "developer-tools",
+    "ai-agent",
+    "content-filtering",
+    "relevance",
+    "intelligence",
+    "claude-code",
+    "cursor",
+    "hacker-news",
+    "arxiv",
+    "developer-productivity"
+  ],
+  "author": "4DA",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runyourempire/4da-v3.git",
+    "directory": "mcp-4da-server"
+  },
+  "homepage": "https://github.com/runyourempire/4da-v3#mcp-integration",
+  "bugs": {
+    "url": "https://github.com/runyourempire/4da-v3/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}