@stacksfinder/mcp-server 1.1.0 → 1.2.1

package/dist/compatibility/scoring.d.ts

@@ -0,0 +1,54 @@
+/**
+ * MCP Compatibility Scoring
+ *
+ * Health score calculation based on conflicts, redundancies, and synergies.
+ */
+import type { CompatibilityReport, Grade, MatchedRule } from './types.js';
+import type { CompatibilityRule } from './types.js';
+/**
+ * Calculate the health score from matched rules.
+ *
+ * Formula:
+ * - Base: 100
+ * - -40 per conflict (critical)
+ * - -20 per conflict (warning)
+ * - -10 per redundant (warning)
+ * - -5 per redundant (info)
+ * - +5 per synergy (cap +15)
+ * - Clamp 0..100
+ *
+ * @param conflicts - Array of conflict rules
+ * @param redundancies - Array of redundancy rules
+ * @param synergies - Array of synergy rules
+ * @returns Score between 0 and 100
+ */
+export declare function calculateHealthScore(conflicts: MatchedRule[], redundancies: MatchedRule[], synergies: MatchedRule[]): number;
+/**
+ * Get grade from score.
+ *
+ * - A: 90-100
+ * - B: 75-89
+ * - C: 55-74
+ * - D: < 55
+ */
+export declare function getGrade(score: number): Grade;
+/**
+ * Generate a full compatibility report for a set of MCPs.
+ *
+ * @param mcps - Array of MCP IDs to analyze
+ * @param allRules - All compatibility rules (for suggestions)
+ * @returns Full compatibility report
+ */
+export declare function generateReport(mcps: string[], allRules: CompatibilityRule[]): CompatibilityReport;
+/**
+ * Format a compatibility report as Markdown.
+ *
+ * @param report - The compatibility report to format
+ * @returns Markdown string
+ */
+export declare function formatReportAsMarkdown(report: CompatibilityReport): string;
+/**
+ * Get a short summary line for the report.
+ */
+export declare function getReportSummaryLine(report: CompatibilityReport): string;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/compatibility/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/compatibility/scoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAEnB,KAAK,EACL,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0BpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,EAAE,EACxB,YAAY,EAAE,WAAW,EAAE,EAC3B,SAAS,EAAE,WAAW,EAAE,GACvB,MAAM,CA8BR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAK7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,mBAAmB,CAgCrB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8E1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CASxE"}

package/dist/compatibility/scoring.js

@@ -0,0 +1,209 @@
+/**
+ * MCP Compatibility Scoring
+ *
+ * Health score calculation based on conflicts, redundancies, and synergies.
+ */
+import { checkAllPairs, getSuggestions, canonicalizeMcpId } from './utils.js';
+/**
+ * Scoring constants
+ */
+const SCORE_PENALTIES = {
+    conflict_critical: -40,
+    conflict_warning: -20,
+    redundant_warning: -10,
+    redundant_info: -5,
+};
+const SCORE_BONUSES = {
+    synergy: 5,
+    synergy_cap: 15,
+};
+/**
+ * Grade thresholds
+ */
+const GRADE_THRESHOLDS = {
+    A: 90,
+    B: 75,
+    C: 55,
+};
+/**
+ * Calculate the health score from matched rules.
+ *
+ * Formula:
+ * - Base: 100
+ * - -40 per conflict (critical)
+ * - -20 per conflict (warning)
+ * - -10 per redundant (warning)
+ * - -5 per redundant (info)
+ * - +5 per synergy (cap +15)
+ * - Clamp 0..100
+ *
+ * @param conflicts - Array of conflict rules
+ * @param redundancies - Array of redundancy rules
+ * @param synergies - Array of synergy rules
+ * @returns Score between 0 and 100
+ */
+export function calculateHealthScore(conflicts, redundancies, synergies) {
+    let score = 100;
+    // Apply conflict penalties
+    for (const matched of conflicts) {
+        if (matched.rule.severity === 'critical') {
+            score += SCORE_PENALTIES.conflict_critical;
+        }
+        else if (matched.rule.severity === 'warning') {
+            score += SCORE_PENALTIES.conflict_warning;
+        }
+    }
+    // Apply redundancy penalties
+    for (const matched of redundancies) {
+        if (matched.rule.severity === 'warning') {
+            score += SCORE_PENALTIES.redundant_warning;
+        }
+        else if (matched.rule.severity === 'info') {
+            score += SCORE_PENALTIES.redundant_info;
+        }
+    }
+    // Apply synergy bonuses (capped)
+    const synergyBonus = Math.min(synergies.length * SCORE_BONUSES.synergy, SCORE_BONUSES.synergy_cap);
+    score += synergyBonus;
+    // Clamp to 0..100
+    return Math.max(0, Math.min(100, score));
+}
+/**
+ * Get grade from score.
+ *
+ * - A: 90-100
+ * - B: 75-89
+ * - C: 55-74
+ * - D: < 55
+ */
+export function getGrade(score) {
+    if (score >= GRADE_THRESHOLDS.A)
+        return 'A';
+    if (score >= GRADE_THRESHOLDS.B)
+        return 'B';
+    if (score >= GRADE_THRESHOLDS.C)
+        return 'C';
+    return 'D';
+}
+/**
+ * Generate a full compatibility report for a set of MCPs.
+ *
+ * @param mcps - Array of MCP IDs to analyze
+ * @param allRules - All compatibility rules (for suggestions)
+ * @returns Full compatibility report
+ */
+export function generateReport(mcps, allRules) {
+    // Check all pairs
+    const { conflicts, redundancies, synergies } = checkAllPairs(mcps);
+    // Calculate score and grade
+    const score = calculateHealthScore(conflicts, redundancies, synergies);
+    const grade = getGrade(score);
+    // Get suggestions based on synergies
+    const suggestions = getSuggestions(mcps, allRules);
+    // Build summary
+    const summary = {
+        total: mcps.length,
+        conflicts: conflicts.length,
+        redundancies: redundancies.length,
+        synergies: synergies.length,
+        score,
+        grade,
+    };
+    // Get canonical IDs for analyzed MCPs
+    const analyzedMcps = [...new Set(mcps.map(canonicalizeMcpId))];
+    return {
+        summary,
+        conflicts,
+        redundancies,
+        synergies,
+        suggestions,
+        analyzedMcps,
+    };
+}
+/**
+ * Format a compatibility report as Markdown.
+ *
+ * @param report - The compatibility report to format
+ * @returns Markdown string
+ */
+export function formatReportAsMarkdown(report) {
+    const lines = [];
+    // Header
+    lines.push('## MCP Compatibility Report\n');
+    lines.push(`**Health Score: ${report.summary.score}/100 (Grade ${report.summary.grade})**\n`);
+    // Summary table
+    lines.push('### Summary');
+    lines.push('| Metric | Count |');
+    lines.push('|--------|-------|');
+    lines.push(`| MCPs Analyzed | ${report.summary.total} |`);
+    lines.push(`| 🔴 Conflicts | ${report.summary.conflicts} |`);
+    lines.push(`| 🟡 Redundancies | ${report.summary.redundancies} |`);
+    lines.push(`| 🟢 Synergies | ${report.summary.synergies} |`);
+    lines.push('');
+    // Conflicts
+    if (report.conflicts.length > 0) {
+        lines.push('### 🔴 Conflicts');
+        for (const matched of report.conflicts) {
+            const { rule, inputA, inputB } = matched;
+            lines.push(`\n**${inputA} ⚡ ${inputB}** (${rule.severity})`);
+            lines.push(`- Category: ${rule.category}`);
+            lines.push(`- Reason: ${rule.reason}`);
+            if (rule.solution) {
+                lines.push(`- Solution: ${rule.solution}`);
+            }
+        }
+        lines.push('');
+    }
+    // Redundancies
+    if (report.redundancies.length > 0) {
+        lines.push('### 🟡 Redundancies');
+        for (const matched of report.redundancies) {
+            const { rule, inputA, inputB } = matched;
+            lines.push(`\n**${inputA} ↔ ${inputB}** (${rule.severity})`);
+            lines.push(`- Category: ${rule.category}`);
+            lines.push(`- Reason: ${rule.reason}`);
+            if (rule.solution) {
+                lines.push(`- Solution: ${rule.solution}`);
+            }
+        }
+        lines.push('');
+    }
+    // Synergies
+    if (report.synergies.length > 0) {
+        lines.push('### 🟢 Synergies');
+        for (const matched of report.synergies) {
+            const { rule, inputA, inputB } = matched;
+            lines.push(`\n**${inputA} + ${inputB}**`);
+            lines.push(`- ${rule.reason}`);
+        }
+        lines.push('');
+    }
+    // Suggestions
+    if (report.suggestions.length > 0) {
+        lines.push('### 💡 Suggestions');
+        for (const suggestion of report.suggestions) {
+            lines.push(`- Consider adding \`${suggestion.mcp}\` - ${suggestion.reason} (pairs with ${suggestion.basedOn})`);
+        }
+        lines.push('');
+    }
+    // No issues
+    if (report.conflicts.length === 0 &&
+        report.redundancies.length === 0 &&
+        report.synergies.length === 0) {
+        lines.push('\n✅ No compatibility issues found between the analyzed MCPs.');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Get a short summary line for the report.
+ */
+export function getReportSummaryLine(report) {
+    const { summary } = report;
+    const issues = summary.conflicts + summary.redundancies;
+    if (issues === 0) {
+        return `✅ All ${summary.total} MCPs are compatible (Score: ${summary.score}/100)`;
+    }
+    return `⚠️ Found ${summary.conflicts} conflicts, ${summary.redundancies} redundancies among ${summary.total} MCPs (Score: ${summary.score}/100, Grade ${summary.grade})`;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/compatibility/scoring.js.map

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

package/dist/compatibility/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * MCP Compatibility Types
+ *
+ * Single source of truth for compatibility matrix types.
+ * Used by both the MCP server and web application.
+ */
+/**
+ * MCP category types - typed enum for validation
+ */
+export declare const MCP_CATEGORIES: readonly ["database", "orm", "auth", "payments", "deployment", "monitoring", "email", "storage", "ai", "version-control", "communication", "testing", "documentation", "general"];
+export type MCPCategory = (typeof MCP_CATEGORIES)[number];
+/**
+ * Compatibility status between two MCPs
+ */
+export type CompatibilityStatus = 'compatible' | 'conflict' | 'redundant' | 'synergy' | 'conditional';
+/**
+ * Severity levels for compatibility issues
+ */
+export type Severity = 'critical' | 'warning' | 'info';
+/**
+ * A single compatibility rule between two MCPs
+ */
+export interface CompatibilityRule {
+    /** Unique rule identifier (e.g., 'db-001', 'orm-002') */
+    id: string;
+    /**
+     * First MCP in the pair (canonical ID).
+     * Must be alphabetically less than mcpB after canonicalization.
+     */
+    mcpA: string;
+    /**
+     * Second MCP in the pair (canonical ID).
+     * Must be alphabetically greater than mcpA after canonicalization.
+     */
+    mcpB: string;
+    /** Compatibility status */
+    status: CompatibilityStatus;
+    /** Category this rule belongs to */
+    category: MCPCategory;
+    /** Severity of the issue (for conflicts/redundancies) */
+    severity: Severity;
+    /** Human-readable explanation */
+    reason: string;
+    /** Suggested solution for conflicts/redundancies */
+    solution?: string;
+    /**
+     * Which MCP is recommended when there's a conflict/redundancy
+     * - 'A': Recommend mcpA
+     * - 'B': Recommend mcpB
+     * - 'either': Both are fine, pick one
+     * - 'both': Keep both (for synergies or conditional)
+     */
+    recommendation?: 'A' | 'B' | 'either' | 'both';
+    /**
+     * For synergy rules: suggest these MCPs if the synergy partner is missing.
+     * E.g., if user has stripe-mcp, suggest resend-mcp
+     */
+    suggestWhenMissing?: string[];
+}
+/**
+ * A rule matched against user's MCPs
+ */
+export interface MatchedRule {
+    /** The compatibility rule that was matched */
+    rule: CompatibilityRule;
+    /** The actual MCP ID from user input (before canonicalization) */
+    inputA: string;
+    /** The actual MCP ID from user input (before canonicalization) */
+    inputB: string;
+}
+/**
+ * A suggestion based on synergy rules
+ */
+export interface Suggestion {
+    /** MCP to suggest */
+    mcp: string;
+    /** Why it's suggested */
+    reason: string;
+    /** Which installed MCP triggered this suggestion */
+    basedOn: string;
+}
+/**
+ * Grade based on health score
+ */
+export type Grade = 'A' | 'B' | 'C' | 'D';
+/**
+ * Summary statistics for a compatibility report
+ */
+export interface CompatibilitySummary {
+    /** Total MCPs analyzed */
+    total: number;
+    /** Number of conflicts found */
+    conflicts: number;
+    /** Number of redundancies found */
+    redundancies: number;
+    /** Number of synergies found */
+    synergies: number;
+    /**
+     * Health score (0-100)
+     * Formula:
+     * - Base: 100
+     * - -40 per conflict (critical)
+     * - -20 per conflict (warning)
+     * - -10 per redundant (warning)
+     * - -5 per redundant (info)
+     * - +5 per synergy (cap +15)
+     * - Clamp 0..100
+     */
+    score: number;
+    /**
+     * Grade based on score
+     * - A: 90-100
+     * - B: 75-89
+     * - C: 55-74
+     * - D: < 55
+     */
+    grade: Grade;
+}
+/**
+ * Full compatibility report
+ */
+export interface CompatibilityReport {
+    /** Summary statistics */
+    summary: CompatibilitySummary;
+    /** All conflicts found */
+    conflicts: MatchedRule[];
+    /** All redundancies found */
+    redundancies: MatchedRule[];
+    /** All synergies found */
+    synergies: MatchedRule[];
+    /** Suggestions based on synergies */
+    suggestions: Suggestion[];
+    /** MCPs that were analyzed (canonical IDs) */
+    analyzedMcps: string[];
+}
+/**
+ * Output format for MCP tool
+ */
+export interface CompatibilityToolOutput {
+    /** Markdown-formatted report for display */
+    text: string;
+    /** Structured data for programmatic use */
+    data: CompatibilityReport;
+    /** Whether an error occurred */
+    isError: boolean;
+}
+/**
+ * Conflict found between a recommendation and installed MCPs
+ */
+export interface RecommendationConflict {
+    /** The recommended MCP that conflicts */
+    recommended: string;
+    /** The installed MCP it conflicts with */
+    conflictsWith: string;
+    /** The rule that was matched */
+    rule: CompatibilityRule;
+}
+/**
+ * Excluded recommendation with reason
+ */
+export interface ExcludedRecommendation {
+    /** The MCP that was excluded */
+    mcp: string;
+    /** Why it was excluded */
+    excludedBecause: string;
+}
+/**
+ * Enhanced output for analyze_repo_mcps integration
+ */
+export interface AnalyzeRepoCompatibility {
+    /** Report for currently installed MCPs */
+    installedReport: CompatibilityReport;
+    /** Conflicts between recommendations and installed MCPs */
+    recommendationConflicts: RecommendationConflict[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compatibility/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compatibility/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,mLAejB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,UAAU,GACV,WAAW,GACX,SAAS,GACT,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,MAAM,EAAE,mBAAmB,CAAC;IAE5B,oCAAoC;IACpC,QAAQ,EAAE,WAAW,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,EAAE,QAAQ,CAAC;IAEnB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE/C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,iBAAiB,CAAC;IAExB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IAEZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IAErB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,OAAO,EAAE,oBAAoB,CAAC;IAE9B,0BAA0B;IAC1B,SAAS,EAAE,WAAW,EAAE,CAAC;IAEzB,6BAA6B;IAC7B,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,SAAS,EAAE,WAAW,EAAE,CAAC;IAEzB,qCAAqC;IACrC,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,IAAI,EAAE,mBAAmB,CAAC;IAE1B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,gCAAgC;IAChC,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,eAAe,EAAE,mBAAmB,CAAC;IAErC,2DAA2D;IAC3D,uBAAuB,EAAE,sBAAsB,EAAE,CAAC;CACnD"}

package/dist/compatibility/types.js

@@ -0,0 +1,26 @@
+/**
+ * MCP Compatibility Types
+ *
+ * Single source of truth for compatibility matrix types.
+ * Used by both the MCP server and web application.
+ */
+/**
+ * MCP category types - typed enum for validation
+ */
+export const MCP_CATEGORIES = [
+    'database',
+    'orm',
+    'auth',
+    'payments',
+    'deployment',
+    'monitoring',
+    'email',
+    'storage',
+    'ai',
+    'version-control',
+    'communication',
+    'testing',
+    'documentation',
+    'general',
+];
+//# sourceMappingURL=types.js.map

package/dist/compatibility/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compatibility/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU;IACV,KAAK;IACL,MAAM;IACN,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,OAAO;IACP,SAAS;IACT,IAAI;IACJ,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,eAAe;IACf,SAAS;CACD,CAAC"}

package/dist/compatibility/utils.d.ts

@@ -0,0 +1,82 @@
+/**
+ * MCP Compatibility Utilities
+ *
+ * Canonical matching utilities for consistent MCP identification.
+ */
+import type { CompatibilityRule, MatchedRule } from './types.js';
+/**
+ * Aliases map for common MCP name variations.
+ * Keys are normalized (lowercase, trimmed), values are canonical IDs.
+ */
+export declare const MCP_ALIASES: Record<string, string>;
+/**
+ * Canonicalize an MCP ID to a consistent format.
+ *
+ * @param id - The MCP ID to canonicalize (e.g., "supabase", "@supabase/mcp")
+ * @returns The canonical ID (e.g., "supabase-mcp")
+ */
+export declare function canonicalizeMcpId(id: string): string;
+/**
+ * Generate a consistent pair key for two MCPs.
+ * The key is ordered alphabetically to ensure A/B and B/A produce the same key.
+ *
+ * @param a - First MCP ID
+ * @param b - Second MCP ID
+ * @returns Pair key in format "mcpA::mcpB" (alphabetically ordered)
+ */
+export declare function pairKey(a: string, b: string): string;
+/**
+ * Initialize the rules index from an array of rules.
+ * Must be called before using findRule().
+ *
+ * @param rules - Array of compatibility rules
+ */
+export declare function initRulesIndex(rules: CompatibilityRule[]): void;
+/**
+ * Get the rules index (for testing).
+ */
+export declare function getRulesIndex(): Map<string, CompatibilityRule>;
+/**
+ * Find a compatibility rule for two MCPs.
+ * Order doesn't matter: findRule(A, B) === findRule(B, A)
+ *
+ * @param a - First MCP ID (can be any alias)
+ * @param b - Second MCP ID (can be any alias)
+ * @returns The matching rule, or undefined if no rule exists
+ */
+export declare function findRule(a: string, b: string): CompatibilityRule | undefined;
+/**
+ * Generate all unique pairs from an array of MCPs.
+ * Used to check all nC2 combinations.
+ *
+ * @param mcps - Array of MCP IDs
+ * @returns Array of [mcpA, mcpB] pairs
+ */
+export declare function generatePairs(mcps: string[]): [string, string][];
+/**
+ * Check all pairs of MCPs for compatibility issues.
+ *
+ * @param mcps - Array of MCP IDs to check
+ * @returns Object with categorized matched rules
+ */
+export declare function checkAllPairs(mcps: string[]): {
+    conflicts: MatchedRule[];
+    redundancies: MatchedRule[];
+    synergies: MatchedRule[];
+    conditionals: MatchedRule[];
+};
+/**
+ * Get suggestions based on synergy rules.
+ * If user has MCP A and rule says A+B is a synergy,
+ * suggest B if user doesn't have it.
+ *
+ * @param mcps - Array of installed MCP IDs
+ * @param allRules - All compatibility rules
+ * @returns Array of suggestions
+ */
+export declare function getSuggestions(mcps: string[], allRules: CompatibilityRule[]): {
+    mcp: string;
+    reason: string;
+    basedOn: string;
+}[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/compatibility/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/compatibility/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsG9C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpD;AAQD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAM/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAQhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAC7C,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAoCA;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAiDpD"}