@neurynae/toolcairn-mcp 0.1.0

package/dist/tools/compare-tools.js

@@ -0,0 +1,178 @@
+import { MemgraphToolRepository } from '@toolpilot/graph';
+import { enqueueIndexJob } from '@toolpilot/queue';
+import pino from 'pino';
+import { errResult, okResult } from '../utils.js';
+const logger = pino({ name: '@toolpilot/mcp-server:compare-tools' });
+const repo = new MemgraphToolRepository();
+// Relationship types that indicate good/bad compatibility
+const POSITIVE_EDGE_TYPES = new Set(['COMPATIBLE_WITH', 'INTEGRATES_WITH', 'POPULAR_WITH']);
+const NEGATIVE_EDGE_TYPES = new Set(['CONFLICTS_WITH', 'BREAKS_FROM']);
+const SUPERCESSION_TYPES = new Set(['REPLACES']);
+function buildComparison(tool, useCase) {
+    return {
+        name: tool.name,
+        display_name: tool.display_name,
+        description: tool.description,
+        github_url: tool.github_url,
+        health: {
+            stars: tool.health.stars,
+            maintenance_score: Math.round(tool.health.maintenance_score * 100) / 100,
+            last_commit_date: tool.health.last_commit_date,
+            open_issues: tool.health.open_issues,
+            contributor_count: tool.health.contributor_count,
+        },
+        fit_score: useCase ? Math.round(tool.health.maintenance_score * 100) / 100 : undefined,
+    };
+}
+function computeRecommendation(toolA, toolB, edgeTypes) {
+    // If one replaces the other, prefer the replacement
+    const aReplacesB = edgeTypes.some((e) => e === 'REPLACES');
+    if (aReplacesB)
+        return 'tool_b'; // b is the newer one being recommended
+    const scoreDiff = toolA.health.maintenance_score - toolB.health.maintenance_score;
+    const starsDiff = toolA.health.stars - toolB.health.stars;
+    if (Math.abs(scoreDiff) < 0.1 && Math.abs(starsDiff) < 5000)
+        return 'either';
+    if (scoreDiff > 0)
+        return 'tool_a';
+    if (scoreDiff < 0)
+        return 'tool_b';
+    return starsDiff >= 0 ? 'tool_a' : 'tool_b';
+}
+export async function handleCompareTools(args) {
+    try {
+        logger.info({ tool_a: args.tool_a, tool_b: args.tool_b }, 'compare_tools called');
+        const [resultA, resultB] = await Promise.all([
+            repo.findByName(args.tool_a),
+            repo.findByName(args.tool_b),
+        ]);
+        const toolAFound = resultA.ok && resultA.data != null;
+        const toolBFound = resultB.ok && resultB.data != null;
+        // Neither indexed — trigger indexing for both
+        if (!toolAFound && !toolBFound) {
+            await Promise.allSettled([enqueueIndexJob(args.tool_a, 2), enqueueIndexJob(args.tool_b, 2)]);
+            return okResult({
+                status: 'not_indexed',
+                tool_a: args.tool_a,
+                tool_b: args.tool_b,
+                async_index_triggered: true,
+                agent_instructions: [
+                    `Neither "${args.tool_a}" nor "${args.tool_b}" is in the ToolPilot index.`,
+                    'Indexing has been triggered for both — results will be available in ~2 minutes.',
+                    'In the meantime, search GitHub for both tools to gather basic information for comparison.',
+                    'Use search_tools to find alternatives if these tools are not found.',
+                ].join(' '),
+            });
+        }
+        // One not indexed — trigger indexing for the missing one
+        if (!toolAFound || !toolBFound) {
+            const missingName = !toolAFound ? args.tool_a : args.tool_b;
+            const indexedData = toolAFound
+                ? resultA.ok
+                    ? resultA.data
+                    : null
+                : resultB.ok
+                    ? resultB.data
+                    : null;
+            const indexedTool = indexedData;
+            await enqueueIndexJob(missingName, 2);
+            return okResult({
+                status: 'partial',
+                indexed_tool: buildComparison(indexedTool, args.use_case),
+                unindexed_tool: {
+                    name: missingName,
+                    status: 'not_in_index',
+                    message: `"${missingName}" is not in the ToolPilot index yet.`,
+                },
+                async_index_triggered: true,
+                agent_instructions: [
+                    `"${missingName}" is not indexed. Indexing has been triggered — retry compare_tools in ~2 minutes.`,
+                    `Meanwhile, "${indexedTool.name}" data is available above.`,
+                    `Search GitHub for "${missingName}" to gather basic health information for a manual comparison.`,
+                ].join(' '),
+            });
+        }
+        // Both indexed — full comparison
+        const toolA = resultA.data;
+        const toolB = resultB.data;
+        const edgesResult = await repo.getDirectEdges(args.tool_a, args.tool_b);
+        const edges = edgesResult.ok ? edgesResult.data : [];
+        const compatibilitySignal = edges.some((e) => POSITIVE_EDGE_TYPES.has(e.edgeType))
+            ? 'compatible'
+            : edges.some((e) => NEGATIVE_EDGE_TYPES.has(e.edgeType))
+                ? 'conflicts'
+                : edges.some((e) => SUPERCESSION_TYPES.has(e.edgeType))
+                    ? 'one_replaces_other'
+                    : 'unknown';
+        const recommendation = computeRecommendation(toolA, toolB, edges.map((e) => e.edgeType));
+        const comparisonDimensions = [
+            {
+                dimension: 'Maintenance',
+                tool_a: toolA.health.maintenance_score,
+                tool_b: toolB.health.maintenance_score,
+                winner: toolA.health.maintenance_score >= toolB.health.maintenance_score
+                    ? args.tool_a
+                    : args.tool_b,
+                note: 'Composite score across commits, stars velocity, issue resolution, PR response',
+            },
+            {
+                dimension: 'Community',
+                tool_a: toolA.health.stars,
+                tool_b: toolB.health.stars,
+                winner: toolA.health.stars >= toolB.health.stars ? args.tool_a : args.tool_b,
+                note: 'GitHub stars',
+            },
+            {
+                dimension: 'Activity',
+                tool_a: toolA.health.commit_velocity_30d ?? 0,
+                tool_b: toolB.health.commit_velocity_30d ?? 0,
+                winner: (toolA.health.commit_velocity_30d ?? 0) >= (toolB.health.commit_velocity_30d ?? 0)
+                    ? args.tool_a
+                    : args.tool_b,
+                note: 'Commits in last 30 days',
+            },
+            {
+                dimension: 'Contributors',
+                tool_a: toolA.health.contributor_count,
+                tool_b: toolB.health.contributor_count,
+                winner: toolA.health.contributor_count >= toolB.health.contributor_count
+                    ? args.tool_a
+                    : args.tool_b,
+                note: 'Total contributor count',
+            },
+        ];
+        const winnerCounts = comparisonDimensions.reduce((acc, d) => {
+            acc[d.winner] = (acc[d.winner] ?? 0) + 1;
+            return acc;
+        }, {});
+        const dominantWinner = Object.entries(winnerCounts).sort((a, b) => b[1] - a[1])[0]?.[0] ?? 'either';
+        return okResult({
+            status: 'complete',
+            tool_a: buildComparison(toolA, args.use_case),
+            tool_b: buildComparison(toolB, args.use_case),
+            graph_relationship: {
+                edges: edges.map((e) => ({
+                    type: e.edgeType,
+                    direction: e.direction,
+                    confidence: Math.round(e.confidence * 100) / 100,
+                    effective_weight: Math.round(e.effective_weight * 100) / 100,
+                })),
+                compatibility_signal: compatibilitySignal,
+            },
+            dimensions: comparisonDimensions,
+            recommendation,
+            dominant_winner: dominantWinner,
+            confidence: edges.length > 0 ? 0.9 : 0.7,
+            decision_guide: {
+                accept_recommendation: `Call update_project_config with action: "add_tool", tool_name: "${recommendation === 'tool_a' ? args.tool_a : args.tool_b}"`,
+                override_recommendation: `Call update_project_config with action: "add_tool", tool_name: "<user_choice>" to persist the override`,
+                add_both_to_consider: `Call update_project_config with action: "add_evaluation" for each to track in pending_evaluation`,
+            },
+        });
+    }
+    catch (e) {
+        logger.error({ err: e }, 'compare_tools failed');
+        return errResult('compare_error', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=compare-tools.js.map

package/dist/tools/compare-tools.js.map

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

package/dist/tools/format-results.d.ts

@@ -0,0 +1,44 @@
+import type { ToolNode } from '@toolpilot/core';
+export interface FormattedResult {
+    type: 'stable' | 'emerging';
+    tool: string;
+    display_name: string;
+    description: string;
+    fit_score: number;
+    reason: string;
+    github_url: string;
+    docs: {
+        readme: string | null;
+        official: string | null;
+        api: string | null;
+        changelog: string | null;
+    };
+    trust_hierarchy: string[];
+    prompt_hint: string;
+    health: {
+        stars: number;
+        maintenance_score: number;
+        last_commit_date: string;
+    };
+    deprecation_warning: string | null;
+}
+export declare function formatResults(results: Array<{
+    tool: ToolNode;
+    score: number;
+}>, isTwoOption: boolean): FormattedResult[];
+export interface NonIndexedGuidance {
+    message: string;
+    agent_instructions: string;
+    suggest_manual_add: boolean;
+    proprietary_prone: boolean;
+}
+/**
+ * Build non-indexed guidance when results are empty or low-confidence.
+ * Returns null when results are confident and complete.
+ */
+export declare function buildNonIndexedGuidance(results: FormattedResult[], query: string): NonIndexedGuidance | null;
+/**
+ * Check if any results have very low star counts (credibility check).
+ */
+export declare function buildLowCredibilityWarning(results: FormattedResult[]): string | null;
+//# sourceMappingURL=format-results.d.ts.map

package/dist/tools/format-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-results.d.ts","sourceRoot":"","sources":["../../src/tools/format-results.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAiChD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,WAAW,EAAE,OAAO,GACnB,eAAe,EAAE,CAqCnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,EAAE,MAAM,GACZ,kBAAkB,GAAG,IAAI,CAuC3B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,GAAG,IAAI,CAIpF"}

package/dist/tools/format-results.js

@@ -0,0 +1,114 @@
+// Shared result formatter for search_tools and search_tools_respond.
+// Adds deprecation warnings, non-OSS guidance, and health signals.
+const MAINTENANCE_SCORE_DEPRECATED = 0.2;
+const LAST_COMMIT_STALE_DAYS = 180;
+const STARS_MINIMUM_CREDIBLE = 100;
+// Categories where proprietary alternatives are common
+const PROPRIETARY_PRONE_CATEGORIES = new Set(['monitoring', 'devops', 'auth']);
+function daysSince(isoDate) {
+    if (!isoDate)
+        return 0;
+    return (Date.now() - new Date(isoDate).getTime()) / (1000 * 60 * 60 * 24);
+}
+function buildDeprecationWarning(tool) {
+    const reasons = [];
+    if (tool.health.maintenance_score < MAINTENANCE_SCORE_DEPRECATED) {
+        reasons.push(`maintenance score is very low (${Math.round(tool.health.maintenance_score * 100)}%)`);
+    }
+    const daysSinceCommit = daysSince(tool.health.last_commit_date);
+    if (daysSinceCommit > LAST_COMMIT_STALE_DAYS) {
+        reasons.push(`last commit was ${Math.round(daysSinceCommit / 30)} months ago`);
+    }
+    if (reasons.length === 0)
+        return null;
+    return `⚠ This tool may be unmaintained: ${reasons.join(' and ')}. Consider checking for active alternatives via search_tools.`;
+}
+export function formatResults(results, isTwoOption) {
+    return results.map((r, idx) => {
+        const type = isTwoOption && idx === 1 ? 'emerging' : 'stable';
+        const parts = [];
+        if (r.tool.license)
+            parts.push(`${r.tool.license} license`);
+        if (r.tool.language)
+            parts.push(`${r.tool.language}`);
+        if (r.tool.health.maintenance_score > 0.7)
+            parts.push('actively maintained');
+        if (r.tool.health.stars > 10_000)
+            parts.push(`${Math.round(r.tool.health.stars / 1000)}k stars`);
+        const reason = parts.join(', ') || 'Best match for your query';
+        const docsUrl = r.tool.docs.docs_url ?? r.tool.docs.readme_url ?? r.tool.github_url;
+        const deprecationWarning = buildDeprecationWarning(r.tool);
+        return {
+            type,
+            tool: r.tool.name,
+            display_name: r.tool.display_name,
+            description: r.tool.description,
+            fit_score: Math.round(r.score * 100) / 100,
+            reason,
+            github_url: r.tool.github_url,
+            docs: {
+                readme: r.tool.docs.readme_url ?? null,
+                official: r.tool.docs.docs_url ?? null,
+                api: r.tool.docs.api_url ?? null,
+                changelog: r.tool.docs.changelog_url ?? null,
+            },
+            trust_hierarchy: ['official_docs', 'changelog', 'readme', 'training_data'],
+            prompt_hint: `Refer to ${docsUrl} for current API. Check changelog for breaking changes. Prefer official docs over training data.`,
+            health: {
+                stars: r.tool.health.stars,
+                maintenance_score: Math.round(r.tool.health.maintenance_score * 100) / 100,
+                last_commit_date: r.tool.health.last_commit_date,
+            },
+            deprecation_warning: deprecationWarning,
+        };
+    });
+}
+/**
+ * Build non-indexed guidance when results are empty or low-confidence.
+ * Returns null when results are confident and complete.
+ */
+export function buildNonIndexedGuidance(results, query) {
+    // No results — something is definitely missing
+    if (results.length === 0) {
+        return {
+            message: 'No tools found for this query in the ToolPilot index. The tool you need may be proprietary, niche, or recently released.',
+            agent_instructions: [
+                'Search GitHub directly for the tool category described in the query.',
+                'If you find a relevant tool, add it to .toolpilot/config.json with source: "non_oss" or source: "manual".',
+                'Optionally call suggest_graph_update with suggestion_type: "new_tool" to add it to the ToolPilot index.',
+            ].join(' '),
+            suggest_manual_add: true,
+            proprietary_prone: false,
+        };
+    }
+    // Low max score — results exist but confidence is low
+    const maxScore = Math.max(...results.map((r) => r.fit_score));
+    if (maxScore < 0.4) {
+        const queryLower = query.toLowerCase();
+        const isProprietaryProne = Array.from(PROPRIETARY_PRONE_CATEGORIES).some((cat) => queryLower.includes(cat));
+        return {
+            message: `Results found but with low confidence (best match: ${Math.round(maxScore * 100)}%). There may be better proprietary or niche alternatives not in the index.`,
+            agent_instructions: [
+                'Review the results above critically.',
+                isProprietaryProne
+                    ? 'This category often has proprietary options (e.g., Auth0, Datadog, Sentry) — consider asking the user if a paid option is acceptable.'
+                    : 'Consider searching GitHub for additional options.',
+                'Add any chosen tool to .toolpilot/config.json with update_project_config.',
+            ].join(' '),
+            suggest_manual_add: true,
+            proprietary_prone: isProprietaryProne,
+        };
+    }
+    // Results are confident — no guidance needed
+    return null;
+}
+/**
+ * Check if any results have very low star counts (credibility check).
+ */
+export function buildLowCredibilityWarning(results) {
+    const lowCred = results.filter((r) => r.health.stars < STARS_MINIMUM_CREDIBLE);
+    if (lowCred.length === 0)
+        return null;
+    return `Note: ${lowCred.map((r) => r.tool).join(', ')} ${lowCred.length === 1 ? 'has' : 'have'} fewer than ${STARS_MINIMUM_CREDIBLE} stars — verify these are production-ready before recommending.`;
+}
+//# sourceMappingURL=format-results.js.map

package/dist/tools/format-results.js.map

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

package/dist/tools/generate-tracker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generate the standalone tracker.html content.
+ * Called by toolpilot_init to produce the HTML file content.
+ * The agent writes the returned content to .toolpilot/tracker.html
+ */
+export declare function generateTrackerHtml(eventsPath: string): string;
+//# sourceMappingURL=generate-tracker.d.ts.map

package/dist/tools/generate-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tracker.d.ts","sourceRoot":"","sources":["../../src/tools/generate-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiZ9D"}