@4da/mcp-server 3.2.0

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

@@ -0,0 +1,108 @@
+/**
+ * Context Analysis Tool
+ *
+ * Analyze and optimize your local context for better relevance.
+ * This is a SUPERPOWER - it tells you how to make 4DA smarter about you.
+ *
+ * With synthesize=true, uses LLM to give personalized optimization advice.
+ */
+import type { FourDADatabase } from "../db.js";
+import { type CompactResult, type ContextAnalysisKeyData } from "../output-manager.js";
+export declare const contextAnalysisTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            include_recommendations: {
+                type: string;
+                description: string;
+            };
+            analyze_gaps: {
+                type: string;
+                description: string;
+            };
+            synthesize: {
+                type: string;
+                description: string;
+            };
+            compact: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface ContextAnalysisParams {
+    include_recommendations?: boolean;
+    analyze_gaps?: boolean;
+    synthesize?: boolean;
+    compact?: boolean;
+}
+interface ContextQualityScore {
+    overall: number;
+    dimensions: {
+        name: string;
+        score: number;
+        explanation: string;
+    }[];
+}
+interface CoverageGap {
+    area: string;
+    evidence: string;
+    recommendation: string;
+}
+interface ContextAnalysisResult {
+    context_summary: {
+        role: string | null;
+        tech_stack_count: number;
+        interests_count: number;
+        domains_count: number;
+        exclusions_count: number;
+        detected_tech_count: number;
+        active_topics_count: number;
+        learned_affinities_count: number;
+        anti_topics_count: number;
+    };
+    quality_score: ContextQualityScore;
+    tech_stack: string[];
+    interests: {
+        topic: string;
+        weight: number;
+    }[];
+    top_detected_tech: {
+        name: string;
+        confidence: number;
+    }[];
+    top_active_topics: {
+        topic: string;
+        weight: number;
+    }[];
+    top_affinities: {
+        topic: string;
+        score: number;
+    }[];
+    exclusions: string[];
+    coverage_gaps: CoverageGap[];
+    recommendations: {
+        priority: "high" | "medium" | "low";
+        action: string;
+        impact: string;
+    }[];
+    recent_items_breakdown: {
+        matched_by_interests: number;
+        matched_by_tech: number;
+        matched_by_ace: number;
+        matched_by_learned: number;
+        unmatched: number;
+    };
+    ai_advice?: {
+        personalized_recommendations: string;
+        highest_impact_change: string;
+        ideal_context_description: string;
+        model_used: string;
+    };
+}
+export declare function executeContextAnalysis(db: FourDADatabase, params: ContextAnalysisParams): Promise<ContextAnalysisResult | CompactResult<ContextAnalysisKeyData>>;
+export {};
+//# sourceMappingURL=context-analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/context-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAgC,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAErH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACL;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,eAAe,EAAE;QACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,wBAAwB,EAAE,MAAM,CAAC;QACjC,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,aAAa,EAAE,mBAAmB,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,iBAAiB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,sBAAsB,EAAE;QACtB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,SAAS,CAAC,EAAE;QACV,4BAA4B,EAAE,MAAM,CAAC;QACrC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,yBAAyB,EAAE,MAAM,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAuGxE"}

package/dist/tools/context-analysis.js

@@ -0,0 +1,300 @@
+/**
+ * Context Analysis Tool
+ *
+ * Analyze and optimize your local context for better relevance.
+ * This is a SUPERPOWER - it tells you how to make 4DA smarter about you.
+ *
+ * With synthesize=true, uses LLM to give personalized optimization advice.
+ */
+import { getLLMConfig, canSynthesize, synthesize, SYNTHESIS_PROMPTS } from "../llm.js";
+import { createContextAnalysisCompact } from "../output-manager.js";
+export const contextAnalysisTool = {
+    name: "context_analysis",
+    description: `Analyze your 4DA context and get optimization recommendations.
+
+With synthesize=true (recommended), uses AI for personalized optimization advice.
+
+Returns:
+- Current context summary (tech stack, interests, topics)
+- Context quality score
+- Coverage gaps (what you care about but isn't tracked)
+- AI-powered personalized recommendations (when enabled)
+
+Use this to tune 4DA for better personalization.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            include_recommendations: {
+                type: "boolean",
+                description: "Include optimization recommendations (default: true)",
+            },
+            analyze_gaps: {
+                type: "boolean",
+                description: "Analyze coverage gaps (default: true)",
+            },
+            synthesize: {
+                type: "boolean",
+                description: "Use AI for personalized advice (default: true if LLM configured)",
+            },
+            compact: {
+                type: "boolean",
+                description: "Return compact result with file reference (default: true for ~80% token reduction)",
+            },
+        },
+    },
+};
+export async function executeContextAnalysis(db, params) {
+    const { include_recommendations = true, analyze_gaps = true } = params;
+    const useCompact = params.compact !== false; // Default to compact=true
+    // Check LLM availability
+    const dbInstance = db.db;
+    const llmConfig = getLLMConfig(dbInstance);
+    const shouldSynthesize = params.synthesize ?? canSynthesize(llmConfig);
+    // Get full context
+    const context = db.getUserContext(true, true);
+    // Get recent items to analyze matching patterns
+    const recentItems = db.getRelevantContent(0, undefined, 100, 168); // Last week
+    // Calculate quality score
+    const qualityScore = calculateQualityScore(context);
+    // Analyze recent items breakdown
+    const itemsBreakdown = analyzeItemsBreakdown(db, recentItems);
+    // Find coverage gaps
+    const coverageGaps = analyze_gaps ? findCoverageGaps(context, recentItems) : [];
+    // Generate recommendations
+    const recommendations = include_recommendations
+        ? generateRecommendations(context, qualityScore, coverageGaps, itemsBreakdown)
+        : [];
+    const result = {
+        context_summary: {
+            role: context.role,
+            tech_stack_count: context.tech_stack.length,
+            interests_count: context.interests.length,
+            domains_count: context.domains.length,
+            exclusions_count: context.exclusions.length,
+            detected_tech_count: context.ace?.detected_tech.length || 0,
+            active_topics_count: context.ace?.active_topics.length || 0,
+            learned_affinities_count: context.learned?.topic_affinities.length || 0,
+            anti_topics_count: context.learned?.anti_topics.length || 0,
+        },
+        quality_score: qualityScore,
+        tech_stack: context.tech_stack,
+        interests: context.interests.map(i => ({ topic: i.topic, weight: i.weight })),
+        top_detected_tech: (context.ace?.detected_tech || [])
+            .slice(0, 10)
+            .map(t => ({ name: t.name, confidence: t.confidence })),
+        top_active_topics: (context.ace?.active_topics || [])
+            .slice(0, 10)
+            .map(t => ({ topic: t.topic, weight: t.weight })),
+        top_affinities: (context.learned?.topic_affinities || [])
+            .filter(a => a.affinity_score > 0)
+            .slice(0, 10)
+            .map(a => ({ topic: a.topic, score: a.affinity_score })),
+        exclusions: context.exclusions,
+        coverage_gaps: coverageGaps,
+        recommendations,
+        recent_items_breakdown: itemsBreakdown,
+    };
+    // AI Personalized Advice - the actual superpower
+    if (shouldSynthesize && canSynthesize(llmConfig)) {
+        try {
+            const analysisData = {
+                context_summary: result.context_summary,
+                quality_score: result.quality_score,
+                coverage_gaps: result.coverage_gaps,
+                recommendations: result.recommendations,
+                recent_items_breakdown: result.recent_items_breakdown,
+            };
+            const synthesis = await synthesize(llmConfig, {
+                system: SYNTHESIS_PROMPTS.contextAnalysis.system,
+                prompt: SYNTHESIS_PROMPTS.contextAnalysis.buildPrompt(analysisData),
+                max_tokens: 350,
+                complexity: SYNTHESIS_PROMPTS.contextAnalysis.complexity,
+            });
+            // Parse the synthesis
+            const lines = synthesis.synthesis.split("\n").filter(l => l.trim());
+            const highestImpact = lines.find(l => l.toLowerCase().includes("highest") ||
+                l.toLowerCase().includes("most important") ||
+                l.toLowerCase().includes("first")) || lines[0] || "";
+            result.ai_advice = {
+                personalized_recommendations: synthesis.synthesis,
+                highest_impact_change: highestImpact,
+                ideal_context_description: lines[lines.length - 1] || "",
+                model_used: synthesis.model_used,
+            };
+        }
+        catch (error) {
+            console.error("AI advice failed:", error);
+        }
+    }
+    // Return compact or full result based on parameter
+    if (useCompact) {
+        return createContextAnalysisCompact(result);
+    }
+    return result;
+}
+function calculateQualityScore(context) {
+    const dimensions = [];
+    // Explicit signals (tech stack + interests)
+    const explicitScore = Math.min(1, (context.tech_stack.length + context.interests.length) / 10);
+    dimensions.push({
+        name: "Explicit Signals",
+        score: Math.round(explicitScore * 100) / 100,
+        explanation: explicitScore >= 0.7
+            ? "Good coverage of explicit interests and tech"
+            : "Consider adding more interests and tech stack items",
+    });
+    // ACE coverage
+    const aceScore = context.ace
+        ? Math.min(1, (context.ace.detected_tech.length + context.ace.active_topics.length) / 20)
+        : 0;
+    dimensions.push({
+        name: "ACE Detection",
+        score: Math.round(aceScore * 100) / 100,
+        explanation: aceScore >= 0.5
+            ? "ACE is detecting your work context well"
+            : aceScore > 0
+                ? "ACE has some detection - consider adding more watched directories"
+                : "ACE not active - add directories to watch",
+    });
+    // Learned preferences
+    const learnedScore = context.learned
+        ? Math.min(1, context.learned.topic_affinities.filter(a => a.affinity_score > 0).length / 15)
+        : 0;
+    dimensions.push({
+        name: "Learned Preferences",
+        score: Math.round(learnedScore * 100) / 100,
+        explanation: learnedScore >= 0.5
+            ? "Good learning from your feedback"
+            : "Give more feedback to help 4DA learn your preferences",
+    });
+    // Diversity
+    const diversity = new Set([
+        ...context.tech_stack,
+        ...context.interests.map(i => i.topic),
+        ...context.domains,
+    ]).size;
+    const diversityScore = Math.min(1, diversity / 15);
+    dimensions.push({
+        name: "Diversity",
+        score: Math.round(diversityScore * 100) / 100,
+        explanation: diversityScore >= 0.6
+            ? "Good topic diversity"
+            : "Consider broadening your declared interests",
+    });
+    const overall = dimensions.reduce((sum, d) => sum + d.score, 0) / dimensions.length;
+    return {
+        overall: Math.round(overall * 100) / 100,
+        dimensions,
+    };
+}
+function analyzeItemsBreakdown(db, items) {
+    let interests = 0;
+    let tech = 0;
+    let ace = 0;
+    let learned = 0;
+    let unmatched = 0;
+    // Sample up to 20 items for detailed analysis
+    const sample = items.slice(0, 20);
+    for (const item of sample) {
+        const explanation = db.explainRelevance(item.id, item.source_type);
+        if (!explanation) {
+            unmatched++;
+            continue;
+        }
+        const mc = explanation.matching_context;
+        if (mc.matching_interests.length > 0)
+            interests++;
+        else if (mc.matching_tech.length > 0)
+            tech++;
+        else if (mc.matching_topics.length > 0)
+            ace++;
+        else if (mc.matching_affinities.length > 0)
+            learned++;
+        else
+            unmatched++;
+    }
+    return {
+        matched_by_interests: interests,
+        matched_by_tech: tech,
+        matched_by_ace: ace,
+        matched_by_learned: learned,
+        unmatched,
+    };
+}
+function findCoverageGaps(context, items) {
+    const gaps = [];
+    // Find high-scoring items that don't match explicit context
+    const unmatchedHighScorers = items
+        .filter(i => i.relevance_score >= 0.6)
+        .filter(i => {
+        const text = (i.title + " " + i.content).toLowerCase();
+        const matchesExplicit = context.tech_stack.some(t => text.includes(t.toLowerCase())) ||
+            context.interests.some(int => text.includes(int.topic.toLowerCase()));
+        return !matchesExplicit;
+    })
+        .slice(0, 5);
+    for (const item of unmatchedHighScorers) {
+        // Extract potential topic
+        const words = item.title.toLowerCase().split(/\s+/).filter(w => w.length > 4);
+        const potentialTopic = words[0] || "unidentified topic";
+        gaps.push({
+            area: potentialTopic,
+            evidence: `Item "${item.title.substring(0, 50)}..." scored ${Math.round(item.relevance_score * 100)}% without explicit interest match`,
+            recommendation: `Consider adding "${potentialTopic}" as an explicit interest`,
+        });
+    }
+    // Check for ACE gaps
+    if (!context.ace || context.ace.active_topics.length === 0) {
+        gaps.push({
+            area: "Local Context",
+            evidence: "No active topics detected from local files",
+            recommendation: "Ensure ACE is scanning your active project directories",
+        });
+    }
+    return gaps.slice(0, 5);
+}
+function generateRecommendations(context, quality, gaps, breakdown) {
+    const recommendations = [];
+    // Low quality score
+    if (quality.overall < 0.5) {
+        recommendations.push({
+            priority: "high",
+            action: "Add more explicit interests and tech stack items",
+            impact: "Will significantly improve relevance scoring",
+        });
+    }
+    // No ACE
+    if (!context.ace || context.ace.detected_tech.length === 0) {
+        recommendations.push({
+            priority: "high",
+            action: "Configure watched directories for ACE scanning",
+            impact: "Enables automatic context detection from your code",
+        });
+    }
+    // Low learned preferences
+    if (!context.learned || context.learned.topic_affinities.filter(a => a.affinity_score > 0).length < 5) {
+        recommendations.push({
+            priority: "medium",
+            action: "Provide more feedback on items (click, save, dismiss)",
+            impact: "Helps 4DA learn your preferences over time",
+        });
+    }
+    // Coverage gaps
+    for (const gap of gaps.slice(0, 2)) {
+        recommendations.push({
+            priority: "medium",
+            action: gap.recommendation,
+            impact: `Would improve matching for "${gap.area}" content`,
+        });
+    }
+    // High unmatched rate
+    if (breakdown.unmatched > 10) {
+        recommendations.push({
+            priority: "low",
+            action: "Review your exclusions - may be too aggressive",
+            impact: "Could be filtering out relevant content",
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=context-analysis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-analysis.js","sourceRoot":"","sources":["../../src/tools/context-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAmD,MAAM,sBAAsB,CAAC;AAErH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;iDAUkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,uBAAuB,EAAE;gBACvB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sDAAsD;aACpE;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uCAAuC;aACrD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kEAAkE;aAChF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oFAAoF;aAClG;SACF;KACF;CACF,CAAC;AAiEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAkB,EAClB,MAA6B;IAE7B,MAAM,EAAE,uBAAuB,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,0BAA0B;IAEvE,yBAAyB;IACzB,MAAM,UAAU,GAAI,EAAgG,CAAC,EAAE,CAAC;IACxH,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IAEvE,mBAAmB;IACnB,MAAM,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE9C,gDAAgD;IAChD,MAAM,WAAW,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY;IAE/E,0BAA0B;IAC1B,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAEpD,iCAAiC;IACjC,MAAM,cAAc,GAAG,qBAAqB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAE9D,qBAAqB;IACrB,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhF,2BAA2B;IAC3B,MAAM,eAAe,GAAG,uBAAuB;QAC7C,CAAC,CAAC,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,CAAC;QAC9E,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,MAAM,GAA0B;QACpC,eAAe,EAAE;YACf,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;YAC3C,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACzC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;YACrC,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;YAC3C,mBAAmB,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,IAAI,CAAC;YAC3D,mBAAmB,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,IAAI,CAAC;YAC3D,wBAAwB,EAAE,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,IAAI,CAAC;YACvE,iBAAiB,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC;SAC5D;QACD,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,iBAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,IAAI,EAAE,CAAC;aAClD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACzD,iBAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,IAAI,EAAE,CAAC;aAClD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,cAAc,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,IAAI,EAAE,CAAC;aACtD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1D,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,YAAY;QAC3B,eAAe;QACf,sBAAsB,EAAE,cAAc;KACvC,CAAC;IAEF,iDAAiD;IACjD,IAAI,gBAAgB,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG;gBACnB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;aACtD,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE;gBAC5C,MAAM,EAAE,iBAAiB,CAAC,eAAe,CAAC,MAAM;gBAChD,MAAM,EAAE,iBAAiB,CAAC,eAAe,CAAC,WAAW,CAAC,YAAY,CAAC;gBACnE,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,iBAAiB,CAAC,eAAe,CAAC,UAAU;aACzD,CAAC,CAAC;YAEH,sBAAsB;YACtB,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACnC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAC1C,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAClC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEpB,MAAM,CAAC,SAAS,GAAG;gBACjB,4BAA4B,EAAE,SAAS,CAAC,SAAS;gBACjD,qBAAqB,EAAE,aAAa;gBACpC,yBAAyB,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;gBACxD,UAAU,EAAE,SAAS,CAAC,UAAU;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAM9B;IACC,MAAM,UAAU,GAA2D,EAAE,CAAC;IAE9E,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/F,UAAU,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG;QAC5C,WAAW,EAAE,aAAa,IAAI,GAAG;YAC/B,CAAC,CAAC,8CAA8C;YAChD,CAAC,CAAC,qDAAqD;KAC1D,CAAC,CAAC;IAEH,eAAe;IACf,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG;QAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACzF,CAAC,CAAC,CAAC,CAAC;IACN,UAAU,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,GAAG;QACvC,WAAW,EAAE,QAAQ,IAAI,GAAG;YAC1B,CAAC,CAAC,yCAAyC;YAC3C,CAAC,CAAC,QAAQ,GAAG,CAAC;gBACZ,CAAC,CAAC,mEAAmE;gBACrE,CAAC,CAAC,2CAA2C;KAClD,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO;QAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC;QAC7F,CAAC,CAAC,CAAC,CAAC;IACN,UAAU,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG;QAC3C,WAAW,EAAE,YAAY,IAAI,GAAG;YAC9B,CAAC,CAAC,kCAAkC;YACpC,CAAC,CAAC,uDAAuD;KAC5D,CAAC,CAAC;IAEH,YAAY;IACZ,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACxB,GAAG,OAAO,CAAC,UAAU;QACrB,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACtC,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC,CAAC,IAAI,CAAC;IACR,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;IACnD,UAAU,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG;QAC7C,WAAW,EAAE,cAAc,IAAI,GAAG;YAChC,CAAC,CAAC,sBAAsB;YACxB,CAAC,CAAC,6CAA6C;KAClD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAEpF,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG;QACxC,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,EAAkB,EAClB,KAAqE;IAQrE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,8CAA8C;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,WAAW,CAAC,gBAAgB,CAAC;QACxC,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,EAAE,CAAC;aAC7C,IAAI,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,EAAE,CAAC;aACxC,IAAI,EAAE,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,EAAE,CAAC;aACzC,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;;YACjD,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,OAAO;QACL,oBAAoB,EAAE,SAAS;QAC/B,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,GAAG;QACnB,kBAAkB,EAAE,OAAO;QAC3B,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,OAIC,EACD,KAAoE;IAEpE,MAAM,IAAI,GAAkB,EAAE,CAAC;IAE/B,4DAA4D;IAC5D,MAAM,oBAAoB,GAAG,KAAK;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC;SACrC,MAAM,CAAC,CAAC,CAAC,EAAE;QACV,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,eAAe,GACnB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,eAAe,CAAC;IAC1B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,0BAA0B;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9E,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC;QAExD,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,mCAAmC;YACtI,cAAc,EAAE,oBAAoB,cAAc,2BAA2B;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,4CAA4C;YACtD,cAAc,EAAE,wDAAwD;SACzE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAKC,EACD,OAA4B,EAC5B,IAAmB,EACnB,SAAgC;IAEhC,MAAM,eAAe,GAA8E,EAAE,CAAC;IAEtG,oBAAoB;IACpB,IAAI,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;QAC1B,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,kDAAkD;YAC1D,MAAM,EAAE,8CAA8C;SACvD,CAAC,CAAC;IACL,CAAC;IAED,SAAS;IACT,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,gDAAgD;YACxD,MAAM,EAAE,oDAAoD;SAC7D,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtG,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,uDAAuD;YAC/D,MAAM,EAAE,4CAA4C;SACrD,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACnC,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,GAAG,CAAC,cAAc;YAC1B,MAAM,EAAE,+BAA+B,GAAG,CAAC,IAAI,WAAW;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,IAAI,SAAS,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,gDAAgD;YACxD,MAAM,EAAE,yCAAyC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/tools/daily-briefing.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Daily Briefing Tool
+ *
+ * Generate an executive summary of 4DA's discoveries.
+ * This is a SUPERPOWER - it synthesizes noise into actionable intelligence.
+ *
+ * With synthesize=true, uses LLM to generate genuine insights.
+ */
+import type { FourDADatabase } from "../db.js";
+import { type CompactResult, type DailyBriefingKeyData } from "../output-manager.js";
+export declare const dailyBriefingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            hours: {
+                type: string;
+                description: string;
+            };
+            min_score: {
+                type: string;
+                description: string;
+            };
+            max_items: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            synthesize: {
+                type: string;
+                description: string;
+            };
+            compact: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface DailyBriefingParams {
+    hours?: number;
+    min_score?: number;
+    max_items?: number;
+    format?: "full" | "brief" | "actionable";
+    synthesize?: boolean;
+    compact?: boolean;
+}
+interface Theme {
+    name: string;
+    item_count: number;
+    avg_score: number;
+    top_items: {
+        title: string;
+        score: number;
+        url: string | null;
+    }[];
+    insight: string;
+}
+interface BriefingResult {
+    period: {
+        start: string;
+        end: string;
+        hours: number;
+    };
+    summary: {
+        total_items_analyzed: number;
+        high_relevance_count: number;
+        avg_score: number;
+        tldr: string;
+    };
+    themes: Theme[];
+    notable_items: {
+        id: number;
+        title: string;
+        url: string | null;
+        source: string;
+        score: number;
+        why_notable: string;
+    }[];
+    recommendations: {
+        priority: "high" | "medium" | "low";
+        action: string;
+        reasoning: string;
+    }[];
+    trends: {
+        rising: string[];
+        falling: string[];
+    };
+    ai_synthesis?: {
+        executive_brief: string;
+        key_insight: string;
+        action_item: string;
+        model_used: string;
+    };
+}
+export declare function executeDailyBriefing(db: FourDADatabase, params: DailyBriefingParams): Promise<BriefingResult | CompactResult<DailyBriefingKeyData>>;
+export {};
+//# sourceMappingURL=daily-briefing.d.ts.map

package/dist/tools/daily-briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-briefing.d.ts","sourceRoot":"","sources":["../../src/tools/daily-briefing.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C7B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE;QACP,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,aAAa,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IACJ,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF,YAAY,CAAC,EAAE;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAuH/D"}