@skillsmith/mcp-server 0.3.1 → 0.3.2

package/dist/src/tools/recommend.js

@@ -0,0 +1,357 @@
+/**
+ * @fileoverview MCP Skill Recommend Tool for suggesting relevant skills
+ * @module @skillsmith/mcp-server/tools/recommend
+ * @see SMI-741: Add MCP Tool skill_recommend
+ * @see SMI-602: Integrate semantic matching with EmbeddingService
+ * @see SMI-604: Add trigger phrase overlap detection
+ *
+ * Provides skill recommendations based on:
+ * - Currently installed skills (semantic similarity)
+ * - Optional project context (semantic matching)
+ * - Codebase analysis (framework detection)
+ * - Overlap detection (avoid similar skills)
+ *
+ * @example
+ * // Basic recommendation
+ * const results = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   limit: 5
+ * }, toolContext);
+ *
+ * @example
+ * // Recommendation with project context
+ * const results = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   project_context: 'React frontend with Jest testing',
+ *   limit: 10
+ * }, toolContext);
+ */
+import { z } from 'zod';
+import { SkillMatcher, OverlapDetector, trackEvent, } from '@skillsmith/core';
+import { getInstalledSkills } from '../utils/installed-skills.js';
+import { mapTrustTierFromDb, getTrustBadge } from '../utils/validation.js';
+/**
+ * Zod schema for recommend tool input validation
+ */
+export const recommendInputSchema = z.object({
+    /** Currently installed skill IDs */
+    installed_skills: z.array(z.string()).min(0).default([]),
+    /** Optional project description for context-aware recommendations */
+    project_context: z.string().optional(),
+    /** Maximum recommendations to return (default 5) */
+    limit: z.number().min(1).max(50).default(5),
+    /** Enable overlap detection (default true) */
+    detect_overlap: z.boolean().default(true),
+    /** Minimum similarity threshold (0-1, default 0.3) */
+    min_similarity: z.number().min(0).max(1).default(0.3),
+});
+/**
+ * MCP tool schema definition for skill_recommend
+ */
+export const recommendToolSchema = {
+    name: 'skill_recommend',
+    description: 'Recommend skills based on currently installed skills and optional project context. Uses semantic similarity to find relevant skills. Auto-detects installed skills from ~/.claude/skills/ if not provided.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            installed_skills: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Currently installed skill IDs (e.g., ["anthropic/commit", "community/jest-helper"]). If empty, auto-detects from ~/.claude/skills/',
+            },
+            project_context: {
+                type: 'string',
+                description: 'Optional project description for context-aware recommendations (e.g., "React frontend with Jest testing")',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum recommendations to return (default 5, max 50)',
+                minimum: 1,
+                maximum: 50,
+                default: 5,
+            },
+            detect_overlap: {
+                type: 'boolean',
+                description: 'Enable overlap detection to filter similar skills (default true)',
+                default: true,
+            },
+            min_similarity: {
+                type: 'number',
+                description: 'Minimum similarity threshold (0-1, default 0.3)',
+                minimum: 0,
+                maximum: 1,
+                default: 0.3,
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Transform a database skill to SkillData format for matching
+ */
+function transformSkillToMatchData(skill) {
+    // Generate trigger phrases from name and first few tags
+    const triggerPhrases = [
+        skill.name,
+        `use ${skill.name}`,
+        `${skill.name} help`,
+        ...skill.tags.slice(0, 3).map((tag) => `${tag} ${skill.name}`),
+    ];
+    return {
+        id: skill.id,
+        name: skill.name,
+        description: skill.description || '',
+        triggerPhrases,
+        keywords: skill.tags,
+        qualityScore: Math.round((skill.qualityScore ?? 0.5) * 100),
+        trustTier: mapTrustTierFromDb(skill.trustTier),
+    };
+}
+/**
+ * Load skills from database via ToolContext
+ * Returns skills transformed to SkillData format for matching
+ */
+async function loadSkillsFromDatabase(context, limit = 500) {
+    const result = context.skillRepository.findAll(limit, 0);
+    return result.items.map(transformSkillToMatchData);
+}
+/**
+ * Execute skill recommendation based on installed skills and context.
+ *
+ * SMI-1183: Uses API as primary source with local fallback.
+ * - Tries live API first (api.skillsmith.app)
+ * - Falls back to local semantic matching if API is offline or fails
+ *
+ * @param input - Recommendation parameters
+ * @returns Promise resolving to recommendation response
+ * @throws {SkillsmithError} When validation fails
+ *
+ * @example
+ * const response = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   project_context: 'React TypeScript frontend',
+ *   limit: 5
+ * }, toolContext);
+ */
+export async function executeRecommend(input, context) {
+    const startTime = performance.now();
+    // Validate input with Zod
+    const validated = recommendInputSchema.parse(input);
+    let { installed_skills } = validated;
+    const { project_context, limit, detect_overlap, min_similarity } = validated;
+    // SMI-906: Auto-detect installed skills from ~/.claude/skills/ if not provided
+    const autoDetected = installed_skills.length === 0;
+    if (autoDetected) {
+        installed_skills = await getInstalledSkills();
+    }
+    // SMI-1183: Try API first, fall back to local semantic matching
+    if (!context.apiClient.isOffline()) {
+        try {
+            // Build stack from installed skill names and project context keywords
+            const stack = [...installed_skills.map((id) => id.split('/').pop() || id)];
+            if (project_context) {
+                // Extract key terms from project context (simple word split)
+                const contextWords = project_context
+                    .toLowerCase()
+                    .split(/\s+/)
+                    .filter((w) => w.length > 3)
+                    .slice(0, 5);
+                stack.push(...contextWords);
+            }
+            const apiResponse = await context.apiClient.getRecommendations({
+                stack: stack.slice(0, 10), // API limits to 10 stack items
+                limit,
+            });
+            const endTime = performance.now();
+            // Convert API results to response format
+            const recommendations = apiResponse.data.map((skill) => ({
+                skill_id: skill.id,
+                name: skill.name,
+                reason: `Matches your stack: ${stack.slice(0, 3).join(', ')}`,
+                similarity_score: 0.8, // API doesn't return similarity score, use default
+                trust_tier: mapTrustTierFromDb(skill.trust_tier),
+                quality_score: Math.round((skill.quality_score ?? 0.5) * 100),
+            }));
+            const response = {
+                recommendations,
+                candidates_considered: recommendations.length,
+                overlap_filtered: 0,
+                context: {
+                    installed_count: installed_skills.length,
+                    has_project_context: !!project_context,
+                    using_semantic_matching: true,
+                    auto_detected: autoDetected,
+                },
+                timing: {
+                    totalMs: Math.round(endTime - startTime),
+                },
+            };
+            // SMI-1184: Track recommend event (silent on failure)
+            if (context.distinctId) {
+                trackEvent(context.distinctId, 'skill_recommend', {
+                    result_count: response.recommendations.length,
+                    duration_ms: response.timing.totalMs,
+                    source: 'mcp',
+                });
+            }
+            return response;
+        }
+        catch (error) {
+            // Log and fall through to local semantic matching
+            console.warn('[skillsmith] API recommend failed, using local matching:', error.message);
+        }
+    }
+    // Fallback: Load skills from database and use local semantic matching
+    // Use 500 as default to balance coverage vs performance
+    const skillDatabase = await loadSkillsFromDatabase(context, 500);
+    // Initialize matcher with fallback mode for now (real embeddings in production)
+    const matcher = new SkillMatcher({
+        useFallback: true, // Use mock embeddings for consistent behavior
+        minSimilarity: min_similarity,
+        qualityWeight: 0.3,
+    });
+    // Get installed skill data
+    const installedSkillData = skillDatabase.filter((s) => installed_skills.some((id) => id.toLowerCase() === s.id.toLowerCase()));
+    // SMI-907: Extract installed skill names for name-based overlap detection
+    // This filters skills with semantically similar names (e.g., "docker" filters "docker-compose")
+    const installedNames = installed_skills.map((id) => {
+        // Extract the skill name from the ID (e.g., "community/docker" -> "docker")
+        const idName = id.split('/').pop()?.toLowerCase() || '';
+        // Also check if any installed skill data has a matching name
+        const skillData = installedSkillData.find((s) => s.id.toLowerCase() === id.toLowerCase());
+        return {
+            idName,
+            skillName: skillData?.name.toLowerCase() || idName,
+        };
+    });
+    // Filter out already installed skills AND semantically similar names from candidates
+    const candidates = skillDatabase.filter((s) => {
+        const skillName = s.name.toLowerCase();
+        const skillIdName = s.id.split('/').pop()?.toLowerCase() || '';
+        // Exclude if exact ID match (case-insensitive)
+        if (installed_skills.some((id) => id.toLowerCase() === s.id.toLowerCase())) {
+            return false;
+        }
+        // SMI-907: Exclude if name is contained in or contains installed skill name
+        // This prevents recommending "docker-compose" when "docker" is installed
+        for (const installed of installedNames) {
+            const { idName, skillName: installedSkillName } = installed;
+            if (!idName && !installedSkillName)
+                continue;
+            // Check name containment both ways
+            if ((installedSkillName && skillName.includes(installedSkillName)) ||
+                (installedSkillName && installedSkillName.includes(skillName)) ||
+                (idName && skillIdName.includes(idName)) ||
+                (idName && idName.includes(skillIdName))) {
+                return false;
+            }
+        }
+        return true;
+    });
+    let overlapFiltered = 0;
+    // Apply overlap detection if enabled and there are installed skills
+    let filteredCandidates = candidates;
+    if (detect_overlap && installedSkillData.length > 0) {
+        const overlapDetector = new OverlapDetector({
+            useFallback: true,
+            overlapThreshold: 0.6,
+            phraseThreshold: 0.75,
+        });
+        const filterResult = await overlapDetector.filterByOverlap(candidates, installedSkillData);
+        filteredCandidates = filterResult.accepted;
+        overlapFiltered = filterResult.rejected.length;
+        overlapDetector.close();
+    }
+    // Build query from installed skills and project context
+    let query = '';
+    if (installedSkillData.length > 0) {
+        query = installedSkillData
+            .map((s) => `${s.name} ${s.description} ${s.keywords?.join(' ') || ''}`)
+            .join(' ');
+    }
+    if (project_context) {
+        query = query ? `${query} ${project_context}` : project_context;
+    }
+    if (!query) {
+        query = 'general development productivity tools';
+    }
+    // Find similar skills using semantic matching
+    const matchResults = await matcher.findSimilarSkills(query, filteredCandidates, limit);
+    // Transform to response format
+    const recommendations = matchResults.map((result) => {
+        const skill = result.skill;
+        return {
+            skill_id: skill.id,
+            name: skill.name,
+            reason: result.matchReason,
+            similarity_score: result.similarityScore,
+            trust_tier: skill.trustTier,
+            quality_score: skill.qualityScore ?? 50,
+        };
+    });
+    const endTime = performance.now();
+    matcher.close();
+    const response = {
+        recommendations,
+        candidates_considered: candidates.length,
+        overlap_filtered: overlapFiltered,
+        context: {
+            installed_count: installed_skills.length,
+            has_project_context: !!project_context,
+            using_semantic_matching: true,
+            auto_detected: autoDetected,
+        },
+        timing: {
+            totalMs: Math.round(endTime - startTime),
+        },
+    };
+    // SMI-1184: Track recommend event (silent on failure)
+    if (context.distinctId) {
+        trackEvent(context.distinctId, 'skill_recommend', {
+            result_count: response.recommendations.length,
+            duration_ms: response.timing.totalMs,
+            source: 'mcp',
+        });
+    }
+    return response;
+}
+/**
+ * Format recommendations for terminal display
+ */
+export function formatRecommendations(response) {
+    const lines = [];
+    lines.push('\n=== Skill Recommendations ===\n');
+    if (response.recommendations.length === 0) {
+        lines.push('No recommendations found.');
+        lines.push('');
+        lines.push('Suggestions:');
+        lines.push('  - Try adding more installed skills for better matching');
+        lines.push('  - Provide a project context for more relevant results');
+    }
+    else {
+        lines.push(`Found ${response.recommendations.length} recommendation(s):\n`);
+        response.recommendations.forEach((rec, index) => {
+            const trustBadge = getTrustBadge(rec.trust_tier);
+            lines.push(`${index + 1}. ${rec.name} ${trustBadge}`);
+            lines.push(`   Score: ${rec.quality_score}/100 | Relevance: ${Math.round(rec.similarity_score * 100)}%`);
+            lines.push(`   ${rec.reason}`);
+            lines.push(`   ID: ${rec.skill_id}`);
+            lines.push('');
+        });
+    }
+    lines.push('---');
+    lines.push(`Candidates considered: ${response.candidates_considered}`);
+    if (response.overlap_filtered > 0) {
+        lines.push(`Filtered for overlap: ${response.overlap_filtered}`);
+    }
+    if (response.context.auto_detected) {
+        lines.push(`Installed skills: ${response.context.installed_count} (auto-detected from ~/.claude/skills/)`);
+    }
+    else {
+        lines.push(`Installed skills: ${response.context.installed_count}`);
+    }
+    lines.push(`Semantic matching: ${response.context.using_semantic_matching ? 'enabled' : 'disabled'}`);
+    lines.push(`Completed in ${response.timing.totalMs}ms`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=recommend.js.map

package/dist/src/tools/recommend.js.map

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

package/dist/src/tools/search.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview MCP Search Tool for Claude Code skill discovery
+ * @module @skillsmith/mcp-server/tools/search
+ * @see {@link https://github.com/wrsmith108/skillsmith|Skillsmith Repository}
+ * @see SMI-789: Wire search tool to SearchService
+ *
+ * Provides skill search functionality with support for:
+ * - Full-text search across skill names, descriptions, and authors
+ * - Category filtering (development, testing, devops, etc.)
+ * - Trust tier filtering (verified, community, experimental, unknown)
+ * - Minimum quality score filtering
+ *
+ * @example
+ * // Basic search with context
+ * const results = await executeSearch({ query: 'commit' }, context);
+ *
+ * @example
+ * // Search with filters
+ * const results = await executeSearch({
+ *   query: 'test',
+ *   category: 'testing',
+ *   trust_tier: 'verified',
+ *   min_score: 80
+ * }, context);
+ */
+import { type MCPSearchResponse as SearchResponse } from '@skillsmith/core';
+import type { ToolContext } from '../context.js';
+/**
+ * Search tool schema for MCP
+ */
+export declare const searchToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            trust_tier: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            min_score: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Input parameters for the search operation
+ * @interface SearchInput
+ */
+export interface SearchInput {
+    /** Search query string (minimum 2 characters) */
+    query: string;
+    /** Filter by skill category */
+    category?: string;
+    /** Filter by trust tier level */
+    trust_tier?: string;
+    /** Minimum quality score (0-100) */
+    min_score?: number;
+}
+/**
+ * Execute a search for Claude Code skills with optional filters.
+ *
+ * SMI-1183: Uses API as primary source with local DB fallback.
+ * - Tries live API first (api.skillsmith.app)
+ * - Falls back to local SearchService if API is offline or fails
+ *
+ * @param input - Search parameters including query and optional filters
+ * @param context - Tool context with API client and local services
+ * @returns Promise resolving to search response with results and timing
+ * @throws {SkillsmithError} When query is empty or less than 2 characters
+ * @throws {SkillsmithError} When min_score is outside 0-100 range
+ *
+ * @example
+ * // Search for commit-related skills
+ * const response = await executeSearch({ query: 'commit' }, context);
+ * console.log(`Found ${response.total} skills in ${response.timing.totalMs}ms`);
+ */
+export declare function executeSearch(input: SearchInput, context: ToolContext): Promise<SearchResponse>;
+/**
+ * Format search results for terminal/CLI display.
+ *
+ * Produces a human-readable string with skill listings including
+ * trust badges, scores, and timing information.
+ *
+ * @param response - Search response from executeSearch
+ * @returns Formatted string suitable for terminal output
+ *
+ * @example
+ * const response = await executeSearch({ query: 'test' });
+ * console.log(formatSearchResults(response));
+ * // Output:
+ * // === Search Results for "test" ===
+ * // Found 3 skill(s):
+ * // 1. jest-helper [COMMUNITY]
+ * //    Author: community | Score: 87/100
+ * //    Generate Jest test cases...
+ */
+export declare function formatSearchResults(response: SearchResponse): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/src/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAGL,KAAK,iBAAiB,IAAI,cAAc,EAMzC,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAQhD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CA4IzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAgCpE"}