@skillsmith/mcp-server 0.1.0

package/dist/src/tools/search.js

@@ -0,0 +1,249 @@
+/**
+ * @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, standard, unverified)
+ * - 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 { SkillsmithError, ErrorCodes, } from '@skillsmith/core';
+import { extractCategoryFromTags } from '../utils/validation.js';
+/**
+ * Map MCP trust tier to database trust tier
+ * MCP: verified, community, standard, unverified
+ * DB:  verified, community, experimental, unknown
+ */
+function mapTrustTierToDb(mcpTier) {
+    switch (mcpTier) {
+        case 'verified':
+            return 'verified';
+        case 'community':
+            return 'community';
+        case 'standard':
+            return 'experimental';
+        case 'unverified':
+            return 'unknown';
+    }
+}
+/**
+ * Map database trust tier to MCP trust tier
+ */
+function mapTrustTierFromDb(dbTier) {
+    switch (dbTier) {
+        case 'verified':
+            return 'verified';
+        case 'community':
+            return 'community';
+        case 'experimental':
+            return 'standard';
+        case 'unknown':
+            return 'unverified';
+    }
+}
+/**
+ * Search tool schema for MCP
+ */
+export const searchToolSchema = {
+    name: 'search',
+    description: 'Search for Claude Code skills by query with optional filters',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query for finding skills',
+            },
+            category: {
+                type: 'string',
+                description: 'Filter by skill category',
+                enum: [
+                    'development',
+                    'testing',
+                    'documentation',
+                    'devops',
+                    'database',
+                    'security',
+                    'productivity',
+                    'integration',
+                    'ai-ml',
+                    'other',
+                ],
+            },
+            trust_tier: {
+                type: 'string',
+                description: 'Filter by trust tier level',
+                enum: ['verified', 'community', 'standard', 'unverified'],
+            },
+            min_score: {
+                type: 'number',
+                description: 'Minimum quality score (0-100)',
+                minimum: 0,
+                maximum: 100,
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Execute a search for Claude Code skills with optional filters.
+ *
+ * Uses SearchService with FTS5/BM25 ranking for relevance-based results.
+ * Results are sorted by BM25 rank and limited to specified count.
+ *
+ * @param input - Search parameters including query and optional filters
+ * @param context - Tool context with database and 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`);
+ *
+ * @example
+ * // Search with multiple filters
+ * const response = await executeSearch({
+ *   query: 'react',
+ *   category: 'testing',
+ *   min_score: 85
+ * }, context);
+ */
+export async function executeSearch(input, context) {
+    const startTime = performance.now();
+    // Validate query
+    if (!input.query || input.query.trim().length < 2) {
+        throw new SkillsmithError(ErrorCodes.SEARCH_QUERY_EMPTY, 'Search query must be at least 2 characters');
+    }
+    const filters = {};
+    // Apply category filter
+    if (input.category) {
+        filters.category = input.category;
+    }
+    // Apply trust tier filter
+    if (input.trust_tier) {
+        filters.trustTier = input.trust_tier;
+    }
+    // Apply minimum score filter (convert 0-100 to 0-1 for database)
+    if (input.min_score !== undefined) {
+        if (input.min_score < 0 || input.min_score > 100) {
+            throw new SkillsmithError(ErrorCodes.VALIDATION_OUT_OF_RANGE, 'min_score must be between 0 and 100', { details: { min_score: input.min_score } });
+        }
+        filters.minScore = input.min_score / 100; // Convert to 0-1 scale for DB
+    }
+    const searchStart = performance.now();
+    // Map MCP trust tier to DB trust tier if provided
+    const dbTrustTier = filters.trustTier ? mapTrustTierToDb(filters.trustTier) : undefined;
+    // Use SearchService for FTS5 search with BM25 ranking
+    const searchResults = context.searchService.search({
+        query: input.query.trim(),
+        limit: 10,
+        offset: 0,
+        trustTier: dbTrustTier,
+        minQualityScore: filters.minScore,
+        category: filters.category,
+    });
+    const searchEnd = performance.now();
+    // Convert SearchResult to SkillSearchResult format
+    const results = searchResults.items.map((item) => ({
+        id: item.skill.id,
+        name: item.skill.name,
+        description: item.skill.description || '',
+        author: item.skill.author || 'unknown',
+        category: extractCategoryFromTags(item.skill.tags),
+        trustTier: mapTrustTierFromDb(item.skill.trustTier),
+        score: Math.round((item.skill.qualityScore ?? 0) * 100), // Convert 0-1 to 0-100
+    }));
+    const endTime = performance.now();
+    return {
+        results,
+        total: searchResults.total,
+        query: input.query,
+        filters,
+        timing: {
+            searchMs: Math.round(searchEnd - searchStart),
+            totalMs: Math.round(endTime - startTime),
+        },
+    };
+}
+/**
+ * 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 function formatSearchResults(response) {
+    const lines = [];
+    lines.push('\n=== Search Results for "' + response.query + '" ===\n');
+    if (response.results.length === 0) {
+        lines.push('No skills found matching your query.');
+        lines.push('');
+        lines.push('Suggestions:');
+        lines.push('  - Try different keywords');
+        lines.push('  - Remove filters to broaden the search');
+        lines.push('  - Check spelling');
+    }
+    else {
+        lines.push('Found ' + response.total + ' skill(s):\n');
+        response.results.forEach((skill, index) => {
+            const trustBadge = getTrustBadge(skill.trustTier);
+            lines.push(index + 1 + '. ' + skill.name + ' ' + trustBadge);
+            lines.push('   Author: ' + skill.author + ' | Score: ' + skill.score + '/100');
+            lines.push('   ' + skill.description);
+            lines.push('   ID: ' + skill.id);
+            lines.push('');
+        });
+    }
+    // Add timing info
+    lines.push('---');
+    lines.push('Search: ' + response.timing.searchMs + 'ms | Total: ' + response.timing.totalMs + 'ms');
+    return lines.join('\n');
+}
+/**
+ * Get trust badge for display
+ */
+function getTrustBadge(tier) {
+    switch (tier) {
+        case 'verified':
+            return '[VERIFIED]';
+        case 'community':
+            return '[COMMUNITY]';
+        case 'standard':
+            return '[STANDARD]';
+        case 'unverified':
+            return '[UNVERIFIED]';
+        default:
+            return '[UNKNOWN]';
+    }
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,181 @@
+/**
+ * @fileoverview MCP Skill Suggest Tool for proactive skill recommendations
+ * @module @skillsmith/mcp-server/tools/suggest
+ * @see Phase 4: Trigger System Architecture
+ *
+ * Provides proactive skill suggestions based on user context including:
+ * - Current file being edited
+ * - Recent terminal commands
+ * - Error messages
+ * - Project structure analysis
+ *
+ * Features:
+ * - Rate limiting (max 1 suggestion per 5 minutes per session)
+ * - Context scoring to filter low-relevance suggestions
+ * - Integration with CodebaseAnalyzer
+ * - Semantic skill matching
+ *
+ * @example
+ * // Client calls suggest when user is working
+ * const result = await executeSuggest({
+ *   project_path: '/path/to/project',
+ *   current_file: 'src/App.test.tsx',
+ *   recent_commands: ['npm test'],
+ *   installed_skills: ['anthropic/commit']
+ * }, toolContext);
+ */
+import { z } from 'zod';
+import type { ToolContext } from '../context.js';
+import type { MCPTrustTier as TrustTier } from '@skillsmith/core';
+/**
+ * Zod schema for suggest tool input validation
+ */
+export declare const suggestInputSchema: z.ZodObject<{
+    /** Root path of the project */
+    project_path: z.ZodString;
+    /** Current file being edited (optional) */
+    current_file: z.ZodOptional<z.ZodString>;
+    /** Recent terminal commands (last 5) */
+    recent_commands: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Recent error message if any */
+    error_message: z.ZodOptional<z.ZodString>;
+    /** Currently installed skill IDs */
+    installed_skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Maximum suggestions to return (default 3) */
+    limit: z.ZodDefault<z.ZodNumber>;
+    /** Session ID for rate limiting */
+    session_id: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    installed_skills: string[];
+    limit: number;
+    project_path: string;
+    recent_commands: string[];
+    session_id: string;
+    current_file?: string | undefined;
+    error_message?: string | undefined;
+}, {
+    project_path: string;
+    installed_skills?: string[] | undefined;
+    limit?: number | undefined;
+    current_file?: string | undefined;
+    recent_commands?: string[] | undefined;
+    error_message?: string | undefined;
+    session_id?: string | undefined;
+}>;
+/**
+ * Input type (before parsing)
+ */
+export type SuggestInput = z.input<typeof suggestInputSchema>;
+/**
+ * Individual skill suggestion
+ */
+export interface SkillSuggestion {
+    /** Skill identifier */
+    skill_id: string;
+    /** Skill name */
+    name: string;
+    /** Why this skill is being suggested */
+    reason: string;
+    /** Confidence in this suggestion (0-1) */
+    confidence: number;
+    /** Trigger types that fired */
+    trigger_types: string[];
+    /** Trust tier */
+    trust_tier: TrustTier;
+    /** Quality score */
+    quality_score: number;
+}
+/**
+ * Suggest response with metadata
+ */
+export interface SuggestResponse {
+    /** List of suggested skills */
+    suggestions: SkillSuggestion[];
+    /** Overall context relevance score (0-1) */
+    context_score: number;
+    /** Whether request was rate limited */
+    rate_limited: boolean;
+    /** When next suggestion is allowed (ISO timestamp) */
+    next_suggestion_at?: string;
+    /** Which triggers fired */
+    triggers_fired: string[];
+    /** Performance timing */
+    timing: {
+        totalMs: number;
+        analysisMs?: number;
+        matchingMs?: number;
+    };
+}
+/**
+ * MCP tool schema definition for skill_suggest
+ */
+export declare const suggestToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_path: {
+                type: string;
+                description: string;
+            };
+            current_file: {
+                type: string;
+                description: string;
+            };
+            recent_commands: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            error_message: {
+                type: string;
+                description: string;
+            };
+            installed_skills: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+            session_id: {
+                type: string;
+                description: string;
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute skill suggestion based on context.
+ *
+ * @param input - Suggestion parameters
+ * @param context - Tool context with database access
+ * @returns Promise resolving to suggestion response
+ *
+ * @example
+ * const response = await executeSuggest({
+ *   project_path: '/path/to/project',
+ *   current_file: 'src/App.test.tsx',
+ *   recent_commands: ['npm test'],
+ *   installed_skills: ['anthropic/commit'],
+ *   limit: 3
+ * }, toolContext);
+ */
+export declare function executeSuggest(input: SuggestInput, context: ToolContext): Promise<SuggestResponse>;
+/**
+ * Format suggestions for terminal display
+ */
+export declare function formatSuggestions(response: SuggestResponse): string;
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,+BAA+B;;IAE/B,2CAA2C;;IAE3C,wCAAwC;;IAExC,kCAAkC;;IAElC,oCAAoC;;IAEpC,gDAAgD;;IAEhD,mCAAmC;;;;;;;;;;;;;;;;;;EAEnC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,iBAAiB;IACjB,UAAU,EAAE,SAAS,CAAA;IACrB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,WAAW,EAAE,eAAe,EAAE,CAAA;IAC9B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAA;IACrB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,2BAA2B;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,yBAAyB;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C7B,CAAA;AA2GD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAuI1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAuCnE"}