@4da/mcp-server 3.2.0

package/dist/tools/knowledge-gaps.js

@@ -0,0 +1,76 @@
+/**
+ * knowledge_gaps tool
+ *
+ * Detect knowledge gaps - dependencies with relevant content you haven't engaged with.
+ */
+export const knowledgeGapsTool = {
+    name: "knowledge_gaps",
+    description: `Detect knowledge gaps by cross-referencing your project dependencies with source items you haven't engaged with. Identifies things you should know about but might have missed.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            min_severity: {
+                type: "string",
+                enum: ["critical", "high", "medium", "low"],
+                description: "Minimum gap severity to include. Default: medium",
+                default: "medium",
+            },
+        },
+    },
+};
+export function executeKnowledgeGaps(db, params) {
+    const rawDb = db.getRawDb();
+    // Get all tracked dependencies
+    const deps = rawDb
+        .prepare("SELECT package_name, version, project_path, language FROM project_dependencies")
+        .all();
+    if (deps.length === 0) {
+        return {
+            gaps: [],
+            summary: "No project dependencies tracked. Add context directories to enable knowledge gap detection.",
+        };
+    }
+    const gaps = [];
+    for (const dep of deps) {
+        // Find source items mentioning this dependency
+        const pattern = `%${dep.package_name}%`;
+        const mentionedItems = rawDb
+            .prepare(`SELECT si.id, si.title, si.url, si.source_type, si.created_at
+        FROM source_items si
+        WHERE (si.title LIKE ? OR si.content LIKE ?)
+        AND si.id NOT IN (SELECT source_item_id FROM interactions WHERE action IN ('click', 'save'))
+        ORDER BY si.created_at DESC LIMIT 5`)
+            .all(pattern, pattern);
+        if (mentionedItems.length > 0) {
+            // Check if any are security-related
+            const hasSecurityMention = mentionedItems.some((item) => item.title?.toLowerCase().includes("cve") ||
+                item.title?.toLowerCase().includes("security") ||
+                item.title?.toLowerCase().includes("vulnerability"));
+            const severity = hasSecurityMention
+                ? "critical"
+                : mentionedItems.length >= 3
+                    ? "high"
+                    : "medium";
+            gaps.push({
+                dependency: dep.package_name,
+                version: dep.version,
+                project_path: dep.project_path,
+                language: dep.language,
+                missed_items: mentionedItems,
+                gap_severity: severity,
+                missed_count: mentionedItems.length,
+            });
+        }
+    }
+    // Filter by severity
+    const severityOrder = { critical: 4, high: 3, medium: 2, low: 1 };
+    const minLevel = severityOrder[params.min_severity || "medium"] || 2;
+    const filtered = gaps.filter((g) => (severityOrder[g.gap_severity] || 0) >= minLevel);
+    return {
+        gaps: filtered.sort((a, b) => (severityOrder[b.gap_severity] || 0) - (severityOrder[a.gap_severity] || 0)),
+        total_dependencies: deps.length,
+        gaps_found: filtered.length,
+        summary: `${filtered.length} knowledge gaps across ${deps.length} tracked dependencies`,
+    };
+}
+//# sourceMappingURL=knowledge-gaps.js.map

package/dist/tools/knowledge-gaps.js.map

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

package/dist/tools/llm-status.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LLM Status Tool
+ *
+ * Check the status of the LLM configuration and Ollama availability.
+ * Helps diagnose why AI synthesis might not be working.
+ */
+import type { FourDADatabase } from "../db.js";
+export declare const llmStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            check_ollama: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface LLMStatusParams {
+    check_ollama?: boolean;
+}
+interface LLMStatusResult {
+    provider: string | null;
+    can_synthesize: boolean;
+    config: {
+        model: string | null;
+        model_light: string | null;
+        model_heavy: string | null;
+        ollama_url: string | null;
+    };
+    ollama?: {
+        available: boolean;
+        models: string[];
+        has_recommended: boolean;
+        missing_models: string[];
+        error?: string;
+    };
+    recommendations: string[];
+    setup_commands?: string[];
+}
+export declare function executeLLMStatus(db: FourDADatabase, params: LLMStatusParams): Promise<LLMStatusResult>;
+export {};
+//# sourceMappingURL=llm-status.d.ts.map

package/dist/tools/llm-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-status.d.ts","sourceRoot":"","sources":["../../src/tools/llm-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAS/C,eAAO,MAAM,aAAa;;;;;;;;;;;;CAoBzB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,MAAM,CAAC,EAAE;QACP,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAsE1B"}

package/dist/tools/llm-status.js

@@ -0,0 +1,92 @@
+/**
+ * LLM Status Tool
+ *
+ * Check the status of the LLM configuration and Ollama availability.
+ * Helps diagnose why AI synthesis might not be working.
+ */
+import { getLLMConfig, canSynthesize, checkOllamaStatus, DEFAULT_OLLAMA_MODELS, RECOMMENDED_MODELS, } from "../llm.js";
+export const llmStatusTool = {
+    name: "llm_status",
+    description: `Check LLM configuration and availability.
+Returns:
+- Current LLM provider configuration
+- Ollama status (if configured)
+- Available models
+- Recommended models for your hardware
+- Configuration recommendations
+
+Use this to diagnose AI synthesis issues.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            check_ollama: {
+                type: "boolean",
+                description: "Check Ollama connectivity (default: true)",
+            },
+        },
+    },
+};
+export async function executeLLMStatus(db, params) {
+    const { check_ollama = true } = params;
+    const dbInstance = db.db;
+    const config = getLLMConfig(dbInstance);
+    const result = {
+        provider: config.provider,
+        can_synthesize: canSynthesize(config),
+        config: {
+            model: config.model || null,
+            model_light: config.model_light || null,
+            model_heavy: config.model_heavy || null,
+            ollama_url: config.ollama_url || null,
+        },
+        recommendations: [],
+    };
+    // Check Ollama if configured
+    if (config.provider === "ollama" && check_ollama) {
+        const ollamaUrl = config.ollama_url || "http://localhost:11434";
+        const status = await checkOllamaStatus(ollamaUrl);
+        const recommendedModels = [
+            DEFAULT_OLLAMA_MODELS.light,
+            DEFAULT_OLLAMA_MODELS.medium,
+            DEFAULT_OLLAMA_MODELS.heavy,
+        ];
+        const missingModels = recommendedModels.filter(m => !status.models.some(installed => installed.startsWith(m.split(":")[0])));
+        result.ollama = {
+            available: status.available,
+            models: status.models,
+            has_recommended: missingModels.length === 0,
+            missing_models: missingModels,
+            error: status.error,
+        };
+        // Generate recommendations
+        if (!status.available) {
+            result.recommendations.push("Ollama is not running. Start it with: ollama serve");
+            result.setup_commands = ["ollama serve"];
+        }
+        else if (status.models.length === 0) {
+            result.recommendations.push("No models installed. Pull recommended models.");
+            result.setup_commands = [
+                RECOMMENDED_MODELS["16GB_VRAM"].install,
+                `ollama pull ${DEFAULT_OLLAMA_MODELS.light}`,
+            ];
+        }
+        else if (missingModels.length > 0) {
+            result.recommendations.push(`Missing recommended models: ${missingModels.join(", ")}`);
+            result.setup_commands = missingModels.map(m => `ollama pull ${m}`);
+        }
+        else {
+            result.recommendations.push("Ollama is properly configured with recommended models.");
+        }
+    }
+    else if (!config.provider) {
+        result.recommendations.push("No LLM provider configured. Set llm_provider to 'ollama', 'anthropic', or 'openai' in settings.");
+    }
+    else if (config.provider === "anthropic" && !config.anthropic_api_key) {
+        result.recommendations.push("Anthropic selected but no API key configured.");
+    }
+    else if (config.provider === "openai" && !config.openai_api_key) {
+        result.recommendations.push("OpenAI selected but no API key configured.");
+    }
+    return result;
+}
+//# sourceMappingURL=llm-status.js.map

package/dist/tools/llm-status.js.map

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

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

@@ -0,0 +1,41 @@
+/**
+ * project_health tool
+ *
+ * Get project health summary across all tracked projects.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface ProjectHealthParams {
+    project_path?: string;
+}
+export declare const projectHealthTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_path: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare function executeProjectHealth(db: FourDADatabase, params: ProjectHealthParams): {
+    projects: {
+        project_path: any;
+        project_name: any;
+        dependency_count: any;
+        dependencies: {
+            name: any;
+            version: any;
+            language: any;
+        }[];
+        health: {
+            security_score: number;
+            security_issues: number;
+        };
+    }[];
+    total_projects: number;
+    summary: string;
+};
+//# sourceMappingURL=project-health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-health.d.ts","sourceRoot":"","sources":["../../src/tools/project-health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;EA+D5B"}

package/dist/tools/project-health.js

@@ -0,0 +1,71 @@
+/**
+ * project_health tool
+ *
+ * Get project health summary across all tracked projects.
+ */
+export const projectHealthTool = {
+    name: "project_health",
+    description: `Get project health radar - dependency freshness, security exposure, ecosystem momentum, and community signals for your tracked projects.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            project_path: {
+                type: "string",
+                description: "Specific project path to check. Omit for all projects.",
+            },
+        },
+    },
+};
+export function executeProjectHealth(db, params) {
+    const rawDb = db.getRawDb();
+    // Get all projects with their dependency counts
+    let query = `SELECT project_path, COUNT(*) as dep_count,
+                      GROUP_CONCAT(package_name, ', ') as packages
+               FROM project_dependencies`;
+    const queryParams = [];
+    if (params.project_path) {
+        query += " WHERE project_path = ?";
+        queryParams.push(params.project_path);
+    }
+    query += " GROUP BY project_path";
+    const projects = rawDb.prepare(query).all(...queryParams);
+    const healthReports = projects.map((proj) => {
+        // Get dependencies for this project
+        const deps = rawDb
+            .prepare("SELECT package_name, version, language, is_dev FROM project_dependencies WHERE project_path = ?")
+            .all(proj.project_path);
+        // Check for security-related source items mentioning these deps
+        let securityIssues = 0;
+        for (const dep of deps.slice(0, 20)) {
+            const pattern = `%${dep.package_name}%`;
+            const securityMentions = rawDb
+                .prepare(`SELECT COUNT(*) as cnt FROM source_items
+           WHERE (title LIKE ? OR content LIKE ?)
+           AND (signal_type = 'security_alert' OR title LIKE '%CVE%' OR title LIKE '%vulnerability%')`)
+                .get(pattern, pattern);
+            if (securityMentions.cnt > 0)
+                securityIssues++;
+        }
+        const securityScore = deps.length > 0 ? 1.0 - securityIssues / deps.length : 1.0;
+        return {
+            project_path: proj.project_path,
+            project_name: proj.project_path.split(/[/\\]/).pop() || proj.project_path,
+            dependency_count: proj.dep_count,
+            dependencies: deps.slice(0, 20).map((d) => ({
+                name: d.package_name,
+                version: d.version,
+                language: d.language,
+            })),
+            health: {
+                security_score: Math.max(0, securityScore),
+                security_issues: securityIssues,
+            },
+        };
+    });
+    return {
+        projects: healthReports,
+        total_projects: healthReports.length,
+        summary: `${healthReports.length} project${healthReports.length !== 1 ? "s" : ""} tracked`,
+    };
+}
+//# sourceMappingURL=project-health.js.map

package/dist/tools/project-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-health.js","sourceRoot":"","sources":["../../src/tools/project-health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,0IAA0I;IACvJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,EAAkB,EAClB,MAA2B;IAE3B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE5B,gDAAgD;IAChD,IAAI,KAAK,GAAG;;yCAE2B,CAAC;IAExC,MAAM,WAAW,GAAU,EAAE,CAAC;IAC9B,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,IAAI,yBAAyB,CAAC;QACnC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,IAAI,wBAAwB,CAAC;IAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,WAAW,CAAU,CAAC;IAEnE,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;QAC/C,oCAAoC;QACpC,MAAM,IAAI,GAAG,KAAK;aACf,OAAO,CACN,iGAAiG,CAClG;aACA,GAAG,CAAC,IAAI,CAAC,YAAY,CAAU,CAAC;QAEnC,gEAAgE;QAChE,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC;YACxC,MAAM,gBAAgB,GAAG,KAAK;iBAC3B,OAAO,CACN;;sGAE4F,CAC7F;iBACA,GAAG,CAAC,OAAO,EAAE,OAAO,CAAQ,CAAC;YAChC,IAAI,gBAAgB,CAAC,GAAG,GAAG,CAAC;gBAAE,cAAc,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QAEjF,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY;YACzE,gBAAgB,EAAE,IAAI,CAAC,SAAS;YAChC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,EAAE,CAAC,CAAC,YAAY;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC;YACH,MAAM,EAAE;gBACN,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC;gBAC1C,eAAe,EAAE,cAAc;aAChC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,cAAc,EAAE,aAAa,CAAC,MAAM;QACpC,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,WAAW,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU;KAC3F,CAAC;AACJ,CAAC"}

package/dist/tools/record-feedback.d.ts

@@ -0,0 +1,39 @@
+/**
+ * record_feedback tool
+ *
+ * Record user feedback on an item for learning.
+ */
+import type { FourDADatabase } from "../db.js";
+import type { RecordFeedbackParams, FeedbackResult } from "../types.js";
+/**
+ * Tool definition for MCP registration
+ */
+export declare const recordFeedbackTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            item_id: {
+                type: string;
+                description: string;
+            };
+            source_type: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            action: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute the record_feedback tool
+ */
+export declare function executeRecordFeedback(db: FourDADatabase, params: RecordFeedbackParams): FeedbackResult;
+//# sourceMappingURL=record-feedback.d.ts.map

package/dist/tools/record-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-feedback.d.ts","sourceRoot":"","sources":["../../src/tools/record-feedback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CA+B9B,CAAC;AAIF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAgBhB"}

package/dist/tools/record-feedback.js

@@ -0,0 +1,60 @@
+/**
+ * record_feedback tool
+ *
+ * Record user feedback on an item for learning.
+ */
+/**
+ * Tool definition for MCP registration
+ */
+export const recordFeedbackTool = {
+    name: "record_feedback",
+    description: `Record user feedback on a content item.
+
+Feedback actions:
+- "click": User clicked/opened the item (moderate positive signal)
+- "save": User saved/bookmarked the item (strong positive signal)
+- "dismiss": User dismissed the item (weak negative signal)
+- "mark_irrelevant": User marked item as not relevant (strong negative signal)
+
+This feedback helps 4DA learn user preferences over time.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            item_id: {
+                type: "number",
+                description: "The database ID of the item",
+            },
+            source_type: {
+                type: "string",
+                description: 'The source type: "hackernews", "arxiv", or "reddit"',
+                enum: ["hackernews", "arxiv", "reddit"],
+            },
+            action: {
+                type: "string",
+                description: 'The feedback action: "click", "save", "dismiss", or "mark_irrelevant"',
+                enum: ["click", "save", "dismiss", "mark_irrelevant"],
+            },
+        },
+        required: ["item_id", "source_type", "action"],
+    },
+};
+const validActions = ["click", "save", "dismiss", "mark_irrelevant"];
+/**
+ * Execute the record_feedback tool
+ */
+export function executeRecordFeedback(db, params) {
+    if (!params.item_id || !params.source_type || !params.action) {
+        return {
+            success: false,
+            message: "item_id, source_type, and action are required",
+        };
+    }
+    if (!validActions.includes(params.action)) {
+        return {
+            success: false,
+            message: `Invalid action: ${params.action}. Valid actions: ${validActions.join(", ")}`,
+        };
+    }
+    return db.recordFeedback(params.item_id, params.source_type, params.action);
+}
+//# sourceMappingURL=record-feedback.js.map

package/dist/tools/record-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-feedback.js","sourceRoot":"","sources":["../../src/tools/record-feedback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;0DAQ2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;gBAClE,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC;aACxC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;gBACpF,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,CAAC;aACtD;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC;KAC/C;CACF,CAAC;AAEF,MAAM,YAAY,GAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAkB,EAClB,MAA4B;IAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,+CAA+C;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,mBAAmB,MAAM,CAAC,MAAM,oBAAoB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACvF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9E,CAAC"}

package/dist/tools/reverse-mentions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * reverse_mentions tool
+ *
+ * Detect when your projects/packages are mentioned in sources.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface ReverseMentionsParams {
+    limit?: number;
+}
+export declare const reverseMentionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+export declare function executeReverseMentions(db: FourDADatabase, params: ReverseMentionsParams): {
+    mentions: {
+        source_item_id: any;
+        title: any;
+        url: any;
+        source_type: any;
+        mentioned_project: any;
+        mention_context: any;
+        discovered_at: any;
+    }[];
+    total: number;
+    tracked_projects: any[];
+    summary: string;
+};
+//# sourceMappingURL=reverse-mentions.d.ts.map

package/dist/tools/reverse-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse-mentions.d.ts","sourceRoot":"","sources":["../../src/tools/reverse-mentions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAa/B,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,qBAAqB;;;;;;;;;;;;;EA2C9B"}

package/dist/tools/reverse-mentions.js

@@ -0,0 +1,57 @@
+/**
+ * reverse_mentions tool
+ *
+ * Detect when your projects/packages are mentioned in sources.
+ */
+export const reverseMentionsTool = {
+    name: "reverse_mentions",
+    description: `Detect when your projects or packages are mentioned in sources. Finds discussions about your work in HN, Reddit, etc.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Maximum mentions to return. Default: 20",
+                default: 20,
+            },
+        },
+    },
+};
+export function executeReverseMentions(db, params) {
+    const rawDb = db.getRawDb();
+    const limit = params.limit || 20;
+    // Get project identifiers from item_relationships
+    const mentions = rawDb
+        .prepare(`SELECT ir.source_item_id, ir.related_item_id, ir.metadata, ir.created_at,
+              si.title, si.url, si.source_type
+       FROM item_relationships ir
+       JOIN source_items si ON ir.source_item_id = si.id
+       WHERE ir.relationship_type = 'mentions_project'
+       ORDER BY ir.created_at DESC
+       LIMIT ?`)
+        .all(limit);
+    const results = mentions.map((m) => {
+        const metadata = m.metadata ? JSON.parse(m.metadata) : {};
+        return {
+            source_item_id: m.source_item_id,
+            title: m.title,
+            url: m.url,
+            source_type: m.source_type,
+            mentioned_project: metadata.project_name || "unknown",
+            mention_context: metadata.context || "",
+            discovered_at: m.created_at,
+        };
+    });
+    // Also check for mentions via text search of project names from dependencies
+    const projectNames = rawDb
+        .prepare("SELECT DISTINCT package_name FROM project_dependencies LIMIT 10")
+        .all()
+        .map((r) => r.package_name);
+    return {
+        mentions: results,
+        total: results.length,
+        tracked_projects: projectNames,
+        summary: `${results.length} mention${results.length !== 1 ? "s" : ""} found across ${projectNames.length} tracked projects`,
+    };
+}
+//# sourceMappingURL=reverse-mentions.js.map

package/dist/tools/reverse-mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse-mentions.js","sourceRoot":"","sources":["../../src/tools/reverse-mentions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,uHAAuH;IACpI,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAE,EAAE;aACZ;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,sBAAsB,CACpC,EAAkB,EAClB,MAA6B;IAE7B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAEjC,kDAAkD;IAClD,MAAM,QAAQ,GAAG,KAAK;SACnB,OAAO,CACN;;;;;;eAMS,CACV;SACA,GAAG,CAAC,KAAK,CAAU,CAAC;IAEvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO;YACL,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,iBAAiB,EAAE,QAAQ,CAAC,YAAY,IAAI,SAAS;YACrD,eAAe,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;YACvC,aAAa,EAAE,CAAC,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,MAAM,YAAY,GAAG,KAAK;SACvB,OAAO,CAAC,iEAAiE,CAAC;SAC1E,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAEnC,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,gBAAgB,EAAE,YAAY;QAC9B,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,iBAAiB,YAAY,CAAC,MAAM,mBAAmB;KAC5H,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,93 @@
+/**
+ * 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 type { FourDADatabase } from "../db.js";
+import { type CompactResult, type ScoreAutopsyKeyData } from "../output-manager.js";
+export declare const scoreAutopsyTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            item_id: {
+                type: string;
+                description: string;
+            };
+            source_type: {
+                type: string;
+                description: string;
+            };
+            compare_count: {
+                type: string;
+                description: string;
+            };
+            synthesize: {
+                type: string;
+                description: string;
+            };
+            compact: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ScoreAutopsyParams {
+    item_id: number;
+    source_type: string;
+    compare_count?: number;
+    synthesize?: boolean;
+    compact?: boolean;
+}
+interface ScoreComponent {
+    name: string;
+    raw_value: number;
+    weight: number;
+    contribution: number;
+    explanation: string;
+}
+interface SimilarItem {
+    id: number;
+    title: string;
+    score: number;
+    score_difference: number;
+    key_difference: string;
+}
+interface AutopsyResult {
+    item: {
+        id: number;
+        title: string;
+        url: string | null;
+        source_type: string;
+        created_at: string;
+        age_hours: number;
+    };
+    final_score: number;
+    components: ScoreComponent[];
+    matching_context: {
+        interests: string[];
+        tech_stack: string[];
+        active_topics: string[];
+        learned_affinities: string[];
+        exclusions_hit: string[];
+    };
+    similar_items: SimilarItem[];
+    recommendations: string[];
+    narrative: string;
+    ai_analysis?: {
+        verdict: string;
+        score_assessment: "accurate" | "too_high" | "too_low" | "uncertain";
+        reasoning: string;
+        suggested_action: string;
+        model_used: string;
+    };
+}
+export declare function executeScoreAutopsy(db: FourDADatabase, params: ScoreAutopsyParams): Promise<AutopsyResult | CompactResult<ScoreAutopsyKeyData>>;
+export {};
+//# sourceMappingURL=score-autopsy.d.ts.map