@4da/mcp-server 3.2.0

package/dist/tools/score-autopsy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-autopsy.d.ts","sourceRoot":"","sources":["../../src/tools/score-autopsy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAA6B,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/G,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;QACpE,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAsL7D"}

package/dist/tools/score-autopsy.js

@@ -0,0 +1,288 @@
+/**
+ * Score Autopsy Tool
+ *
+ * Deep forensic analysis of why content scored the way it did.
+ * This is a SUPERPOWER - it reveals the complete scoring breakdown.
+ *
+ * With synthesize=true, uses LLM to explain whether the score makes sense.
+ */
+import { getLLMConfig, canSynthesize, synthesize, SYNTHESIS_PROMPTS } from "../llm.js";
+import { createScoreAutopsyCompact } from "../output-manager.js";
+export const scoreAutopsyTool = {
+    name: "score_autopsy",
+    description: `Perform a complete forensic analysis of why an item scored the way it did.
+
+With synthesize=true (recommended), uses AI to explain whether the score seems correct.
+
+Returns:
+- Component-by-component score breakdown
+- Matching context (interests, tech, topics)
+- Comparison with similar items
+- Recommendations for improving relevance
+- AI analysis (when enabled)
+
+Use this when you need to understand or debug relevance scores.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            item_id: {
+                type: "number",
+                description: "The item ID to analyze",
+            },
+            source_type: {
+                type: "string",
+                description: "Source type (e.g., 'hackernews', 'arxiv')",
+            },
+            compare_count: {
+                type: "number",
+                description: "Number of similar items to compare (default: 5)",
+            },
+            synthesize: {
+                type: "boolean",
+                description: "Use AI to analyze if the score makes sense (default: true if LLM configured)",
+            },
+            compact: {
+                type: "boolean",
+                description: "Return compact result with file reference (default: true for ~80% token reduction)",
+            },
+        },
+        required: ["item_id", "source_type"],
+    },
+};
+export async function executeScoreAutopsy(db, params) {
+    const { item_id, source_type, compare_count = 5 } = 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 the item
+    const item = db.getSourceItem(item_id, source_type);
+    if (!item) {
+        throw new Error(`Item ${item_id} of type ${source_type} not found`);
+    }
+    // Get full context
+    const context = db.getUserContext(true, true);
+    // Get detailed explanation
+    const explanation = db.explainRelevance(item_id, source_type);
+    if (!explanation) {
+        throw new Error("Failed to compute relevance explanation");
+    }
+    // Calculate age
+    const createdAt = new Date(item.created_at.replace(" ", "T") + "Z");
+    const ageHours = Math.round((Date.now() - createdAt.getTime()) / (1000 * 60 * 60));
+    // Build component breakdown
+    const components = [
+        {
+            name: "Interest Match",
+            raw_value: explanation.matching_context.matching_interests.length > 0 ? 0.8 : 0,
+            weight: 0.30,
+            contribution: explanation.score_breakdown.static_match_score * 0.5,
+            explanation: explanation.matching_context.matching_interests.length > 0
+                ? `Matches interests: ${explanation.matching_context.matching_interests.join(", ")}`
+                : "No direct interest matches",
+        },
+        {
+            name: "Tech Stack Match",
+            raw_value: explanation.matching_context.matching_tech.length > 0 ? 0.7 : 0,
+            weight: 0.20,
+            contribution: explanation.matching_context.matching_tech.length * 0.2,
+            explanation: explanation.matching_context.matching_tech.length > 0
+                ? `Matches tech: ${explanation.matching_context.matching_tech.join(", ")}`
+                : "No tech stack matches",
+        },
+        {
+            name: "Active Topics (ACE)",
+            raw_value: explanation.score_breakdown.ace_match_score,
+            weight: 0.15,
+            contribution: explanation.score_breakdown.ace_match_score,
+            explanation: explanation.matching_context.matching_topics.length > 0
+                ? `Recent work topics: ${explanation.matching_context.matching_topics.join(", ")}`
+                : "No active topic matches",
+        },
+        {
+            name: "Learned Affinities",
+            raw_value: explanation.score_breakdown.learned_affinity_score,
+            weight: 0.15,
+            contribution: explanation.score_breakdown.learned_affinity_score,
+            explanation: explanation.matching_context.matching_affinities.length > 0
+                ? `Learned preferences: ${explanation.matching_context.matching_affinities.join(", ")}`
+                : "No learned affinity matches",
+        },
+        {
+            name: "Recency Boost",
+            raw_value: ageHours < 24 ? 0.9 : ageHours < 72 ? 0.6 : 0.3,
+            weight: 0.10,
+            contribution: ageHours < 24 ? 0.09 : ageHours < 72 ? 0.06 : 0.03,
+            explanation: ageHours < 24
+                ? `Fresh content (${ageHours}h old)`
+                : `Older content (${Math.round(ageHours / 24)}d old)`,
+        },
+        {
+            name: "Anti-Penalty",
+            raw_value: -explanation.score_breakdown.anti_penalty,
+            weight: 1.0,
+            contribution: -explanation.score_breakdown.anti_penalty,
+            explanation: explanation.score_breakdown.anti_penalty > 0
+                ? "Score reduced due to exclusions or anti-topics"
+                : "No penalties applied",
+        },
+    ];
+    // Get similar items for comparison
+    const similarItems = getSimilarItems(db, item, source_type, compare_count);
+    // Generate recommendations
+    const recommendations = generateRecommendations(explanation.score_breakdown, explanation.matching_context, context, item);
+    // Generate narrative explanation
+    const narrative = generateNarrative(item, explanation.score_breakdown.final_score, explanation.matching_context, ageHours);
+    const result = {
+        item: {
+            id: item.id,
+            title: item.title,
+            url: item.url,
+            source_type: item.source_type,
+            created_at: item.created_at,
+            age_hours: ageHours,
+        },
+        final_score: explanation.score_breakdown.final_score,
+        components,
+        matching_context: {
+            interests: explanation.matching_context.matching_interests,
+            tech_stack: explanation.matching_context.matching_tech,
+            active_topics: explanation.matching_context.matching_topics,
+            learned_affinities: explanation.matching_context.matching_affinities,
+            exclusions_hit: explanation.score_breakdown.anti_penalty > 0
+                ? ["Exclusion or anti-topic triggered"]
+                : [],
+        },
+        similar_items: similarItems,
+        recommendations,
+        narrative,
+    };
+    // AI Analysis - the actual superpower
+    if (shouldSynthesize && canSynthesize(llmConfig)) {
+        try {
+            const autopsyData = {
+                item: { title: item.title, content: item.content?.substring(0, 500) },
+                final_score: result.final_score,
+                components: result.components,
+                matching_context: result.matching_context,
+            };
+            const contextData = {
+                interests: context.interests.slice(0, 10),
+                tech_stack: context.tech_stack,
+                role: context.role,
+            };
+            const synthesis = await synthesize(llmConfig, {
+                system: SYNTHESIS_PROMPTS.scoreAutopsy.system,
+                prompt: SYNTHESIS_PROMPTS.scoreAutopsy.buildPrompt(autopsyData, contextData),
+                max_tokens: 350,
+                complexity: SYNTHESIS_PROMPTS.scoreAutopsy.complexity,
+            });
+            // Parse the synthesis to extract structured assessment
+            const text = synthesis.synthesis.toLowerCase();
+            let scoreAssessment = "uncertain";
+            if (text.includes("too high") || text.includes("overscored") || text.includes("inflated")) {
+                scoreAssessment = "too_high";
+            }
+            else if (text.includes("too low") || text.includes("underscored") || text.includes("should be higher")) {
+                scoreAssessment = "too_low";
+            }
+            else if (text.includes("makes sense") || text.includes("accurate") || text.includes("correct") || text.includes("appropriate")) {
+                scoreAssessment = "accurate";
+            }
+            result.ai_analysis = {
+                verdict: synthesis.synthesis,
+                score_assessment: scoreAssessment,
+                reasoning: synthesis.synthesis.split("\n")[0] || "",
+                suggested_action: recommendations[0] || "No specific action needed",
+                model_used: synthesis.model_used,
+            };
+        }
+        catch (error) {
+            console.error("AI analysis failed:", error);
+        }
+    }
+    // Return compact or full result based on parameter
+    if (useCompact) {
+        return createScoreAutopsyCompact(result);
+    }
+    return result;
+}
+function getSimilarItems(db, item, sourceType, count) {
+    // Get recent items from same source to compare
+    const recentItems = db.getRelevantContent(0, sourceType, count * 2, 168); // Last week
+    return recentItems
+        .filter((ri) => ri.id !== item.id)
+        .slice(0, count)
+        .map((ri) => {
+        const scoreDiff = ri.relevance_score - db.explainRelevance(item.id, sourceType).score_breakdown.final_score;
+        return {
+            id: ri.id,
+            title: ri.title,
+            score: ri.relevance_score,
+            score_difference: Math.round(scoreDiff * 100) / 100,
+            key_difference: scoreDiff > 0
+                ? "Higher: likely more keyword matches"
+                : "Lower: fewer context matches",
+        };
+    });
+}
+function generateRecommendations(scores, matching, context, item) {
+    const recommendations = [];
+    // Low interest match
+    if (matching.matching_interests.length === 0 && scores.static_match_score < 0.2) {
+        // Extract potential keywords from item
+        const words = item.title.toLowerCase().split(/\s+/).filter(w => w.length > 4);
+        const topWord = words[0] || "this topic";
+        recommendations.push(`Add "${topWord}" as an explicit interest to boost similar content`);
+    }
+    // Low tech match
+    if (matching.matching_tech.length === 0 && context.tech_stack.length > 0) {
+        recommendations.push("Item doesn't mention your tech stack - relevance may improve if content aligns with: " +
+            context.tech_stack.slice(0, 3).join(", "));
+    }
+    // Low ACE match
+    if (scores.ace_match_score < 0.05) {
+        recommendations.push("No recent work context matches - ensure ACE is scanning your active projects");
+    }
+    // Low learned score
+    if (scores.learned_affinity_score < 0.05) {
+        recommendations.push("Give feedback on similar items to help 4DA learn your preferences");
+    }
+    // General recommendation if score is decent
+    if (recommendations.length === 0) {
+        recommendations.push("Score looks healthy - continue providing feedback to refine");
+    }
+    return recommendations;
+}
+function generateNarrative(item, score, matching, ageHours) {
+    const parts = [];
+    // Score assessment
+    if (score >= 0.8) {
+        parts.push(`"${item.title}" is highly relevant to you (${Math.round(score * 100)}% match).`);
+    }
+    else if (score >= 0.5) {
+        parts.push(`"${item.title}" has moderate relevance (${Math.round(score * 100)}% match).`);
+    }
+    else {
+        parts.push(`"${item.title}" has low relevance (${Math.round(score * 100)}% match).`);
+    }
+    // Why
+    const matches = [
+        ...matching.matching_interests.map(i => `interest "${i}"`),
+        ...matching.matching_tech.map(t => `tech "${t}"`),
+        ...matching.matching_topics.map(t => `recent work on "${t}"`),
+    ];
+    if (matches.length > 0) {
+        parts.push(`It matches your ${matches.slice(0, 2).join(" and ")}.`);
+    }
+    else {
+        parts.push("No strong matches to your declared interests or recent work.");
+    }
+    // Recency
+    if (ageHours < 24) {
+        parts.push("The freshness boost helps (published within 24 hours).");
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=score-autopsy.js.map

package/dist/tools/score-autopsy.js.map

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

package/dist/tools/semantic-shifts.d.ts

@@ -0,0 +1,37 @@
+/**
+ * semantic_shifts tool
+ *
+ * Detect how topic narratives shift over time.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface SemanticShiftsParams {
+    period_days?: number;
+    min_magnitude?: number;
+}
+export declare const semanticShiftsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            period_days: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            min_magnitude: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+export declare function executeSemanticShifts(db: FourDADatabase, params: SemanticShiftsParams): {
+    shifts: any[];
+    total: number;
+    period_days: number;
+    topics_tracked: number;
+    summary: string;
+};
+//# sourceMappingURL=semantic-shifts.d.ts.map

package/dist/tools/semantic-shifts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-shifts.d.ts","sourceRoot":"","sources":["../../src/tools/semantic-shifts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;CAkB9B,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,oBAAoB;;;;;;EAuD7B"}

package/dist/tools/semantic-shifts.js

@@ -0,0 +1,73 @@
+/**
+ * semantic_shifts tool
+ *
+ * Detect how topic narratives shift over time.
+ */
+export const semanticShiftsTool = {
+    name: "semantic_shifts",
+    description: `Detect narrative shifts in topics you follow. Instead of "new post about X", see "the conversation about X shifted from A to B."`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            period_days: {
+                type: "number",
+                description: "Look-back period in days. Default: 7",
+                default: 7,
+            },
+            min_magnitude: {
+                type: "number",
+                description: "Minimum drift magnitude (0-1). Default: 0.1",
+                default: 0.1,
+            },
+        },
+    },
+};
+export function executeSemanticShifts(db, params) {
+    const rawDb = db.getRawDb();
+    const periodDays = params.period_days || 7;
+    const rows = rawDb
+        .prepare(`SELECT id, subject, data, created_at
+       FROM temporal_events
+       WHERE event_type = 'topic_centroid'
+       AND created_at >= datetime('now', '-' || ? || ' days')
+       ORDER BY created_at DESC`)
+        .all(periodDays);
+    // Group centroids by subject (topic)
+    const byTopic = new Map();
+    for (const row of rows) {
+        const existing = byTopic.get(row.subject) || [];
+        existing.push({
+            data: JSON.parse(row.data),
+            created_at: row.created_at,
+        });
+        byTopic.set(row.subject, existing);
+    }
+    // Detect shifts where we have at least 2 snapshots
+    const shifts = [];
+    for (const [topic, snapshots] of byTopic) {
+        if (snapshots.length < 2)
+            continue;
+        const latest = snapshots[0];
+        const earliest = snapshots[snapshots.length - 1];
+        const magnitude = latest.data.drift_magnitude || 0;
+        if (magnitude >= (params.min_magnitude || 0.1)) {
+            shifts.push({
+                topic,
+                drift_magnitude: magnitude,
+                direction: latest.data.direction || "unknown",
+                period: `last ${periodDays} days`,
+                snapshots: snapshots.length,
+                detected_at: latest.created_at,
+            });
+        }
+    }
+    shifts.sort((a, b) => b.drift_magnitude - a.drift_magnitude);
+    return {
+        shifts,
+        total: shifts.length,
+        period_days: periodDays,
+        topics_tracked: byTopic.size,
+        summary: `${shifts.length} narrative shift${shifts.length !== 1 ? "s" : ""} detected across ${byTopic.size} topics`,
+    };
+}
+//# sourceMappingURL=semantic-shifts.js.map

package/dist/tools/semantic-shifts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-shifts.js","sourceRoot":"","sources":["../../src/tools/semantic-shifts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,kIAAkI;IAC/I,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;gBACnD,OAAO,EAAE,CAAC;aACX;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;gBAC1D,OAAO,EAAE,GAAG;aACb;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,EAAkB,EAClB,MAA4B;IAE5B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,KAAK;SACf,OAAO,CACN;;;;gCAI0B,CAC3B;SACA,GAAG,CAAC,UAAU,CAAU,CAAC;IAE5B,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,mDAAmD;IACnD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEjD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QACnD,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,eAAe,EAAE,SAAS;gBAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,SAAS;gBAC7C,MAAM,EAAE,QAAQ,UAAU,OAAO;gBACjC,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,WAAW,EAAE,MAAM,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,WAAW,EAAE,UAAU;QACvB,cAAc,EAAE,OAAO,CAAC,IAAI;QAC5B,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,mBAAmB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,oBAAoB,OAAO,CAAC,IAAI,SAAS;KACpH,CAAC;AACJ,CAAC"}

package/dist/tools/signal-chains.d.ts

@@ -0,0 +1,45 @@
+/**
+ * signal_chains tool
+ *
+ * Get active signal chains - connected signals that form causal narratives over time.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface SignalChainsParams {
+    resolution?: string;
+    min_priority?: string;
+}
+export declare const signalChainsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resolution: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            min_priority: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+    };
+};
+export declare function executeSignalChains(db: FourDADatabase, params: SignalChainsParams): {
+    chains: {
+        id: any;
+        chain_name: any;
+        links: any;
+        overall_priority: any;
+        resolution: any;
+        suggested_action: any;
+        created_at: any;
+    }[];
+    total: number;
+    summary: string;
+};
+//# sourceMappingURL=signal-chains.d.ts.map

package/dist/tools/signal-chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-chains.d.ts","sourceRoot":"","sources":["../../src/tools/signal-chains.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,kBAAkB;;;;;;;;;;;;EAyC3B"}

package/dist/tools/signal-chains.js

@@ -0,0 +1,60 @@
+/**
+ * signal_chains tool
+ *
+ * Get active signal chains - connected signals that form causal narratives over time.
+ */
+export const signalChainsTool = {
+    name: "signal_chains",
+    description: `Get active signal chains - connected signals that form causal narratives over time. E.g., "CVE found Monday + your dep uses it Tuesday + patch released today = act now."`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            resolution: {
+                type: "string",
+                enum: ["open", "resolved", "expired", "all"],
+                description: "Filter by chain resolution status. Default: open",
+                default: "open",
+            },
+            min_priority: {
+                type: "string",
+                enum: ["critical", "high", "medium", "low"],
+                description: "Minimum chain priority to include. Default: low",
+                default: "low",
+            },
+        },
+    },
+};
+export function executeSignalChains(db, params) {
+    const rawDb = db.getRawDb();
+    const resolution = params.resolution || "open";
+    let query = `SELECT id, event_type, subject, data, created_at
+    FROM temporal_events
+    WHERE event_type = 'signal_chain'`;
+    if (resolution !== "all") {
+        query += ` AND json_extract(data, '$.resolution') = '${resolution}'`;
+    }
+    query += " ORDER BY created_at DESC LIMIT 50";
+    const rows = rawDb.prepare(query).all();
+    const chains = rows.map((row) => {
+        const data = JSON.parse(row.data);
+        return {
+            id: row.id,
+            chain_name: data.chain_name || row.subject,
+            links: data.links || [],
+            overall_priority: data.overall_priority || "medium",
+            resolution: data.resolution || "open",
+            suggested_action: data.suggested_action || "",
+            created_at: row.created_at,
+        };
+    });
+    // Filter by priority
+    const priorityOrder = { critical: 4, high: 3, medium: 2, low: 1 };
+    const minLevel = priorityOrder[params.min_priority || "low"] || 1;
+    const filtered = chains.filter((c) => (priorityOrder[c.overall_priority] || 0) >= minLevel);
+    return {
+        chains: filtered,
+        total: filtered.length,
+        summary: `${filtered.length} signal chain${filtered.length !== 1 ? "s" : ""} (${resolution})`,
+    };
+}
+//# sourceMappingURL=signal-chains.js.map

package/dist/tools/signal-chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-chains.js","sourceRoot":"","sources":["../../src/tools/signal-chains.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,2KAA2K;IACxL,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC;gBAC5C,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,MAAM;aAChB;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;gBAC3C,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,KAAK;aACf;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,EAAkB,EAClB,MAA0B;IAE1B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC;IAE/C,IAAI,KAAK,GAAG;;sCAEwB,CAAC;IAErC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,8CAA8C,UAAU,GAAG,CAAC;IACvE,CAAC;IACD,KAAK,IAAI,oCAAoC,CAAC;IAE9C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAW,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,OAAO;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,QAAQ;YACnD,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YAC7C,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,aAAa,GAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC1F,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAC5D,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,gBAAgB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,GAAG;KAC9F,CAAC;AACJ,CAAC"}

package/dist/tools/source-health.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Source Health Tool
+ *
+ * Diagnose source fetching, parsing, and data flow issues.
+ * This is a SUPERPOWER - it reveals pipeline problems before they become mysteries.
+ */
+import type { FourDADatabase } from "../db.js";
+export declare const sourceHealthTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            source: {
+                type: string;
+                description: string;
+            };
+            hours: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface SourceHealthParams {
+    source?: string;
+    hours?: number;
+}
+interface SourceStatus {
+    source: string;
+    status: "healthy" | "degraded" | "failing" | "unknown";
+    last_item_at: string | null;
+    hours_since_last: number | null;
+    items_24h: number;
+    items_7d: number;
+    avg_items_per_day: number;
+    quality_metrics: {
+        has_url_rate: number;
+        has_content_rate: number;
+        avg_content_length: number;
+    };
+    issues: string[];
+    recommendations: string[];
+}
+interface SourceHealthResult {
+    analysis_period: {
+        start: string;
+        end: string;
+        hours: number;
+    };
+    overall_status: "healthy" | "degraded" | "critical";
+    sources: SourceStatus[];
+    summary: {
+        total_sources: number;
+        healthy: number;
+        degraded: number;
+        failing: number;
+        total_items_24h: number;
+    };
+    global_recommendations: string[];
+}
+export declare function executeSourceHealth(db: FourDADatabase, params: SourceHealthParams): SourceHealthResult;
+export {};
+//# sourceMappingURL=source-health.d.ts.map

package/dist/tools/source-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-health.d.ts","sourceRoot":"","sources":["../../src/tools/source-health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAwB5B,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,UAAU,kBAAkB;IAC1B,eAAe,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACpD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CA8DpB"}