@4da/mcp-server 3.2.0

package/dist/output-manager.js

@@ -0,0 +1,156 @@
+/**
+ * Output Manager for Dynamic Context Discovery
+ *
+ * Reduces token usage by ~80% through:
+ * - Writing full results to files (referenced by path)
+ * - Returning compact summaries inline
+ * - Providing retrieval hints for common queries
+ *
+ * Full results stored at: ~/.local/share/4da/context/results/
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// Base directory for 4DA context files
+const CONTEXT_DIR = join(homedir(), ".local", "share", "4da", "context");
+const RESULTS_DIR = join(CONTEXT_DIR, "results");
+/**
+ * Ensure the context directories exist
+ */
+function ensureDirectories() {
+    if (!existsSync(CONTEXT_DIR)) {
+        mkdirSync(CONTEXT_DIR, { recursive: true });
+    }
+    if (!existsSync(RESULTS_DIR)) {
+        mkdirSync(RESULTS_DIR, { recursive: true });
+    }
+}
+/**
+ * Write full result to file and return the file path
+ */
+function writeResultFile(toolName, fullResult) {
+    ensureDirectories();
+    // Generate timestamped filename
+    const timestamp = Math.floor(Date.now() / 1000);
+    const filename = `${toolName}_${timestamp}.json`;
+    const filePath = join(RESULTS_DIR, filename);
+    // Write full result to file
+    writeFileSync(filePath, JSON.stringify(fullResult, null, 2), "utf-8");
+    return filePath;
+}
+/**
+ * Get the results directory path (for documentation)
+ */
+export function getResultsDir() {
+    return RESULTS_DIR;
+}
+export function createDailyBriefingCompact(result) {
+    const topTheme = result.themes[0]?.name || "general";
+    return {
+        summary: `${result.summary.total_items_analyzed} items analyzed, ${result.summary.high_relevance_count} high-priority. Top theme: ${topTheme}. ${result.ai_synthesis ? "AI synthesis included." : ""}`,
+        key_data: {
+            total_items: result.summary.total_items_analyzed,
+            high_priority: result.summary.high_relevance_count,
+            top_theme: result.themes[0]?.name || "none",
+            tldr: result.summary.tldr,
+            executive_brief: result.ai_synthesis?.executive_brief,
+        },
+        full_result_path: writeResultFile("daily_briefing", result),
+        retrieval_hints: [
+            "jq '.notable_items' - get high-priority items",
+            "jq '.themes' - get topic breakdown",
+            "jq '.recommendations' - get action items",
+            "jq '.ai_synthesis.executive_brief' - get AI summary",
+        ],
+    };
+}
+export function createTrendAnalysisCompact(result) {
+    const anomalyNote = result.anomalies.length > 0 ? ` ${result.anomalies.length} anomalies detected.` : "";
+    return {
+        summary: `Volume ${result.summary.volume_trend}. Rising: ${result.summary.top_rising_topic || "none"}. Falling: ${result.summary.top_falling_topic || "none"}.${anomalyNote}`,
+        key_data: {
+            total_items: result.summary.total_items,
+            volume_trend: result.summary.volume_trend,
+            top_rising: result.summary.top_rising_topic,
+            top_falling: result.summary.top_falling_topic,
+            anomaly_count: result.anomalies.length,
+            narrative: result.ai_interpretation?.narrative,
+        },
+        full_result_path: writeResultFile("trend_analysis", result),
+        retrieval_hints: [
+            "jq '.topic_trends' - get all topic trends",
+            "jq '.volume_by_day' - get daily volume data",
+            "jq '.anomalies' - get detected anomalies",
+            "jq '.ai_interpretation.forecast' - get predictions",
+        ],
+    };
+}
+export function createScoreAutopsyCompact(result) {
+    const topComponent = result.components.sort((a, b) => b.contribution - a.contribution)[0];
+    const assessment = result.ai_analysis?.score_assessment || "unanalyzed";
+    return {
+        summary: `"${result.item.title.substring(0, 40)}..." scored ${Math.round(result.final_score * 100)}%. Assessment: ${assessment}. Top contributor: ${topComponent?.name || "unknown"}.`,
+        key_data: {
+            item_title: result.item.title,
+            final_score: result.final_score,
+            score_assessment: result.ai_analysis?.score_assessment,
+            top_contributor: topComponent?.name || "unknown",
+            verdict: result.ai_analysis?.verdict,
+        },
+        full_result_path: writeResultFile("score_autopsy", result),
+        retrieval_hints: [
+            "jq '.components' - get score breakdown",
+            "jq '.matching_context' - get what matched",
+            "jq '.similar_items' - get comparison items",
+            "jq '.recommendations' - get improvement suggestions",
+        ],
+    };
+}
+export function createContextAnalysisCompact(result) {
+    const quality = Math.round(result.quality_score.overall * 100);
+    return {
+        summary: `Context quality: ${quality}%. ${result.context_summary.interests_count} interests, ${result.context_summary.tech_stack_count} tech. ${result.coverage_gaps.length} gaps found.`,
+        key_data: {
+            quality_score: result.quality_score.overall,
+            interests_count: result.context_summary.interests_count,
+            tech_count: result.context_summary.tech_stack_count,
+            gap_count: result.coverage_gaps.length,
+            top_recommendation: result.recommendations[0]?.action || "No recommendations",
+            personalized_advice: result.ai_advice?.personalized_recommendations,
+        },
+        full_result_path: writeResultFile("context_analysis", result),
+        retrieval_hints: [
+            "jq '.quality_score.dimensions' - get quality breakdown",
+            "jq '.coverage_gaps' - get what's missing",
+            "jq '.recommendations' - get all suggestions",
+            "jq '.top_affinities' - get learned preferences",
+        ],
+    };
+}
+export function createTopicConnectionsCompact(result) {
+    const topEdge = result.edges[0];
+    const connectionNote = topEdge
+        ? `Strongest: ${topEdge.from} ↔ ${topEdge.to}.`
+        : "No strong connections.";
+    return {
+        summary: `${result.nodes.length} topics, ${result.edges.length} connections. Central: ${result.central_topics.slice(0, 3).join(", ")}. ${connectionNote}`,
+        key_data: {
+            items_analyzed: result.analysis_period.items_analyzed,
+            node_count: result.nodes.length,
+            edge_count: result.edges.length,
+            central_topics: result.central_topics.slice(0, 5),
+            top_connection: topEdge
+                ? { from: topEdge.from, to: topEdge.to, strength: topEdge.co_occurrences }
+                : null,
+            graph_narrative: result.ai_insights?.graph_narrative,
+        },
+        full_result_path: writeResultFile("topic_connections", result),
+        retrieval_hints: [
+            "jq '.nodes' - get all topic nodes",
+            "jq '.edges' - get all connections",
+            "jq '.clusters' - get topic clusters",
+            "jq '.path' - get path between topics (if requested)",
+        ],
+    };
+}
+//# sourceMappingURL=output-manager.js.map

package/dist/output-manager.js.map

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

package/dist/schema-registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Schema Registry for Dynamic Context Discovery
+ *
+ * Reduces tool listing from ~4500 tokens to ~500 tokens by:
+ * - Returning only one-liner summaries in list_tools
+ * - Storing full schemas as MCP Resources (lazy-loaded)
+ *
+ * Full schemas available at: 4da://schema/{tool_name}
+ */
+/**
+ * Slim tool registry - one-liner descriptions only
+ * Full schemas are stored in schemas/*.json and exposed as MCP Resources
+ */
+export declare const TOOL_REGISTRY: Record<string, {
+    summary: string;
+    schemaFile: string;
+}>;
+/**
+ * Get slim tool list for list_tools response
+ * Returns minimal schema (just type: object) - full schema via resources
+ */
+export declare function getSlimToolList(): Array<{
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+    };
+}>;
+/**
+ * Get list of schema resources for ListResources
+ */
+export declare function getSchemaResources(): Array<{
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}>;
+/**
+ * Check if a tool exists
+ */
+export declare function hasToolSchema(toolName: string): boolean;
+/**
+ * Get schema filename for a tool
+ */
+export declare function getSchemaFilename(toolName: string): string | null;
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../src/schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsFjF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;CACjC,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE"}

package/dist/schema-registry.js

@@ -0,0 +1,133 @@
+/**
+ * Schema Registry for Dynamic Context Discovery
+ *
+ * Reduces tool listing from ~4500 tokens to ~500 tokens by:
+ * - Returning only one-liner summaries in list_tools
+ * - Storing full schemas as MCP Resources (lazy-loaded)
+ *
+ * Full schemas available at: 4da://schema/{tool_name}
+ */
+/**
+ * Slim tool registry - one-liner descriptions only
+ * Full schemas are stored in schemas/*.json and exposed as MCP Resources
+ */
+export const TOOL_REGISTRY = {
+    // Core Tools
+    get_relevant_content: {
+        summary: "Query filtered content by relevance, source, time",
+        schemaFile: "get-relevant-content.json",
+    },
+    get_context: {
+        summary: "Get user's interests, tech stack, learned affinities",
+        schemaFile: "get-context.json",
+    },
+    explain_relevance: {
+        summary: "Understand why an item scored the way it did",
+        schemaFile: "explain-relevance.json",
+    },
+    record_feedback: {
+        summary: "Teach 4DA what you like/dislike (click, save, dismiss)",
+        schemaFile: "record-feedback.json",
+    },
+    // Superpower Tools
+    score_autopsy: {
+        summary: "Deep forensic analysis of relevance scores (AI-powered)",
+        schemaFile: "score-autopsy.json",
+    },
+    trend_analysis: {
+        summary: "Statistical patterns, anomalies, and predictions (AI-powered)",
+        schemaFile: "trend-analysis.json",
+    },
+    daily_briefing: {
+        summary: "Executive summary of discoveries (AI-powered)",
+        schemaFile: "daily-briefing.json",
+    },
+    context_analysis: {
+        summary: "Optimize your context for better relevance (AI-powered)",
+        schemaFile: "context-analysis.json",
+    },
+    source_health: {
+        summary: "Diagnose source fetching and data quality issues",
+        schemaFile: "source-health.json",
+    },
+    topic_connections: {
+        summary: "Build knowledge graphs from content (AI-powered)",
+        schemaFile: "topic-connections.json",
+    },
+    config_validator: {
+        summary: "Validate configuration and detect issues",
+        schemaFile: "config-validator.json",
+    },
+    llm_status: {
+        summary: "Check LLM/Ollama configuration and availability",
+        schemaFile: "llm-status.json",
+    },
+    get_actionable_signals: {
+        summary: "Classify content into actionable signals with priority levels",
+        schemaFile: "get-actionable-signals.json",
+    },
+    // Innovation Feature Tools
+    export_context_packet: {
+        summary: "Generate portable context packet for session handoff",
+        schemaFile: "export-context.json",
+    },
+    knowledge_gaps: {
+        summary: "Detect knowledge gaps in your project dependencies",
+        schemaFile: "knowledge-gaps.json",
+    },
+    signal_chains: {
+        summary: "Get causal signal chains connecting related events over time",
+        schemaFile: "signal-chains.json",
+    },
+    semantic_shifts: {
+        summary: "Detect narrative shifts in topics you follow",
+        schemaFile: "semantic-shifts.json",
+    },
+    reverse_mentions: {
+        summary: "Find where your projects are mentioned in sources",
+        schemaFile: "reverse-mentions.json",
+    },
+    attention_report: {
+        summary: "Analyze attention allocation vs codebase needs",
+        schemaFile: "attention-report.json",
+    },
+    project_health: {
+        summary: "Project health radar for dependency freshness and security",
+        schemaFile: "project-health.json",
+    },
+};
+/**
+ * Get slim tool list for list_tools response
+ * Returns minimal schema (just type: object) - full schema via resources
+ */
+export function getSlimToolList() {
+    return Object.entries(TOOL_REGISTRY).map(([name, info]) => ({
+        name,
+        description: info.summary,
+        inputSchema: { type: "object" },
+    }));
+}
+/**
+ * Get list of schema resources for ListResources
+ */
+export function getSchemaResources() {
+    return Object.entries(TOOL_REGISTRY).map(([name, info]) => ({
+        uri: `4da://schema/${name}`,
+        name: `${name} schema`,
+        description: `Full JSON Schema for the ${name} tool`,
+        mimeType: "application/json",
+    }));
+}
+/**
+ * Check if a tool exists
+ */
+export function hasToolSchema(toolName) {
+    return toolName in TOOL_REGISTRY;
+}
+/**
+ * Get schema filename for a tool
+ */
+export function getSchemaFilename(toolName) {
+    return TOOL_REGISTRY[toolName]?.schemaFile || null;
+}
+//# sourceMappingURL=schema-registry.js.map

package/dist/schema-registry.js.map

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

package/dist/schemas/config-validator.json

@@ -0,0 +1,18 @@
+{
+  "name": "config_validator",
+  "description": "Validate 4DA configuration and detect issues.\nReturns:\n- Schema validation results\n- Missing required fields\n- Invalid values detected\n- Cross-field consistency checks\n- Recommendations for fixes\n\nUse this when things aren't working as expected.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "section": {
+        "type": "string",
+        "enum": ["all", "sources", "embedding", "llm", "ace", "digest", "ui"],
+        "description": "Config section to validate (default: all)"
+      },
+      "fix_suggestions": {
+        "type": "boolean",
+        "description": "Include fix suggestions (default: true)"
+      }
+    }
+  }
+}

package/dist/schemas/context-analysis.json

@@ -0,0 +1,25 @@
+{
+  "name": "context_analysis",
+  "description": "Analyze your 4DA context and get optimization recommendations.\n\nWith synthesize=true (recommended), uses AI for personalized optimization advice.\n\nReturns:\n- Current context summary (tech stack, interests, topics)\n- Context quality score\n- Coverage gaps (what you care about but isn't tracked)\n- AI-powered personalized recommendations (when enabled)\n\nUse 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)"
+      }
+    }
+  }
+}

package/dist/schemas/daily-briefing.json

@@ -0,0 +1,34 @@
+{
+  "name": "daily_briefing",
+  "description": "Generate an executive briefing from 4DA's recent discoveries.\n\nWith synthesize=true (recommended), uses AI to generate genuine insights tailored to your context.\n\nReturns:\n- TL;DR summary (AI-generated when synthesize=true)\n- Key themes with item counts\n- Notable high-scoring items\n- Actionable recommendations\n- Trend highlights\n- AI synthesis (when enabled)\n\nUse this for your daily/weekly content review.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "hours": {
+        "type": "number",
+        "description": "Hours to look back (default: 24)"
+      },
+      "min_score": {
+        "type": "number",
+        "description": "Minimum relevance score (default: 0.5)"
+      },
+      "max_items": {
+        "type": "number",
+        "description": "Maximum items to analyze (default: 50)"
+      },
+      "format": {
+        "type": "string",
+        "enum": ["full", "brief", "actionable"],
+        "description": "Output format (default: full)"
+      },
+      "synthesize": {
+        "type": "boolean",
+        "description": "Use AI to generate genuine insights (default: true if LLM configured)"
+      },
+      "compact": {
+        "type": "boolean",
+        "description": "Return compact result with file reference (default: true for ~80% token reduction)"
+      }
+    }
+  }
+}

package/dist/schemas/explain-relevance.json

@@ -0,0 +1,19 @@
+{
+  "name": "explain_relevance",
+  "description": "Explain why a content item was considered relevant.\n\nProvides a detailed breakdown of:\n- Score components (static match, ACE context, learned preferences, penalties)\n- Matching context elements (interests, tech, topics, affinities)\n- Human-readable explanation\n\nUse this to understand how 4DA scored a particular item.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "item_id": {
+        "type": "number",
+        "description": "The database ID of the item to explain"
+      },
+      "source_type": {
+        "type": "string",
+        "description": "The source type: \"hackernews\", \"arxiv\", or \"reddit\"",
+        "enum": ["hackernews", "arxiv", "reddit"]
+      }
+    },
+    "required": ["item_id", "source_type"]
+  }
+}

package/dist/schemas/get-actionable-signals.json

@@ -0,0 +1,29 @@
+{
+  "name": "get_actionable_signals",
+  "description": "Classify content into actionable signal types (security_alert, breaking_change, tool_discovery, tech_trend, learning, competitive_intel) with priority levels. Cross-references against user's tech stack.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "priority_filter": {
+        "type": "string",
+        "description": "Filter by priority level",
+        "enum": ["critical", "high", "medium", "low"]
+      },
+      "signal_type": {
+        "type": "string",
+        "description": "Filter by signal type",
+        "enum": ["security_alert", "breaking_change", "tool_discovery", "tech_trend", "learning", "competitive_intel"]
+      },
+      "limit": {
+        "type": "number",
+        "description": "Maximum signals to return (default: 20, max: 100)",
+        "default": 20
+      },
+      "since_hours": {
+        "type": "number",
+        "description": "Only include items from last N hours (default: 48)",
+        "default": 48
+      }
+    }
+  }
+}

package/dist/schemas/get-context.json

@@ -0,0 +1,17 @@
+{
+  "name": "get_context",
+  "description": "Get the user's context - what 4DA knows about them.\n\nReturns information about:\n- Static Identity: User-declared role, tech stack, domains, interests, and exclusions\n- ACE Context (optional): Auto-detected technologies and active topics from recent activity\n- Learned Preferences (optional): Topic affinities learned from user behavior\n\nUse this to understand what the user is working on and interested in.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "include_ace": {
+        "type": "boolean",
+        "description": "Include ACE-detected context (detected tech, active topics). Default: true"
+      },
+      "include_learned": {
+        "type": "boolean",
+        "description": "Include learned preferences (topic affinities, anti-topics). Default: true"
+      }
+    }
+  }
+}

package/dist/schemas/get-relevant-content.json

@@ -0,0 +1,26 @@
+{
+  "name": "get_relevant_content",
+  "description": "Get filtered relevant content from 4DA's personalized feed.\n\nReturns content items that match the user's interests, tech stack, and learned preferences.\nItems are scored based on:\n- Explicit interests declared by the user\n- Tech stack and domains\n- ACE-detected context (recent files, projects, git activity)\n- Learned preferences from past interactions\n\nUse this to find content relevant to the user's current context.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "min_score": {
+        "type": "number",
+        "description": "Minimum relevance score (0.0-1.0). Default: 0.35"
+      },
+      "source_type": {
+        "type": "string",
+        "description": "Filter by source type: \"hackernews\", \"arxiv\", or \"reddit\". Leave empty for all sources.",
+        "enum": ["hackernews", "arxiv", "reddit"]
+      },
+      "limit": {
+        "type": "number",
+        "description": "Maximum number of items to return. Default: 20, max: 100"
+      },
+      "since_hours": {
+        "type": "number",
+        "description": "Only include items discovered in the last N hours. Default: 24"
+      }
+    }
+  }
+}

package/dist/schemas/llm-status.json

@@ -0,0 +1,13 @@
+{
+  "name": "llm_status",
+  "description": "Check LLM configuration and availability.\nReturns:\n- Current LLM provider configuration\n- Ollama status (if configured)\n- Available models\n- Recommended models for your hardware\n- Configuration recommendations\n\nUse this to diagnose AI synthesis issues.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "check_ollama": {
+        "type": "boolean",
+        "description": "Check Ollama connectivity (default: true)"
+      }
+    }
+  }
+}

package/dist/schemas/record-feedback.json

@@ -0,0 +1,24 @@
+{
+  "name": "record_feedback",
+  "description": "Record user feedback on a content item.\n\nFeedback actions:\n- \"click\": User clicked/opened the item (moderate positive signal)\n- \"save\": User saved/bookmarked the item (strong positive signal)\n- \"dismiss\": User dismissed the item (weak negative signal)\n- \"mark_irrelevant\": User marked item as not relevant (strong negative signal)\n\nThis 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"]
+  }
+}

package/dist/schemas/score-autopsy.json

@@ -0,0 +1,30 @@
+{
+  "name": "score_autopsy",
+  "description": "Perform a complete forensic analysis of why an item scored the way it did.\n\nWith synthesize=true (recommended), uses AI to explain whether the score seems correct.\n\nReturns:\n- Component-by-component score breakdown\n- Matching context (interests, tech, topics)\n- Comparison with similar items\n- Recommendations for improving relevance\n- AI analysis (when enabled)\n\nUse 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"]
+  }
+}

package/dist/schemas/source-health.json

@@ -0,0 +1,17 @@
+{
+  "name": "source_health",
+  "description": "Diagnose the health of 4DA's content sources.\nReturns:\n- Per-source status (healthy/degraded/failing)\n- Recent fetch statistics\n- Data quality metrics\n- Error patterns detected\n- Recommendations for fixes\n\nUse this when content seems stale or sources aren't working.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "source": {
+        "type": "string",
+        "description": "Specific source to analyze (optional, all if not specified)"
+      },
+      "hours": {
+        "type": "number",
+        "description": "Hours to analyze (default: 24)"
+      }
+    }
+  }
+}