@skillsmith/mcp-server 0.1.0

package/dist/src/tools/suggest.js

@@ -0,0 +1,342 @@
+/**
+ * @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 { TriggerDetector, ContextScorer } from '@skillsmith/core';
+import { CodebaseAnalyzer } from '@skillsmith/core';
+import { SkillMatcher } from '@skillsmith/core';
+import { RateLimiter } from '@skillsmith/core';
+/**
+ * Zod schema for suggest tool input validation
+ */
+export const suggestInputSchema = z.object({
+    /** Root path of the project */
+    project_path: z.string().min(1),
+    /** Current file being edited (optional) */
+    current_file: z.string().optional(),
+    /** Recent terminal commands (last 5) */
+    recent_commands: z.array(z.string()).max(10).default([]),
+    /** Recent error message if any */
+    error_message: z.string().optional(),
+    /** Currently installed skill IDs */
+    installed_skills: z.array(z.string()).default([]),
+    /** Maximum suggestions to return (default 3) */
+    limit: z.number().min(1).max(10).default(3),
+    /** Session ID for rate limiting */
+    session_id: z.string().default('default'),
+});
+/**
+ * MCP tool schema definition for skill_suggest
+ */
+export const suggestToolSchema = {
+    name: 'skill_suggest',
+    description: 'Proactively suggest relevant skills based on current context (files, commands, errors, project structure). Rate-limited to max 1 per 5 minutes per session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_path: {
+                type: 'string',
+                description: 'Root path of the project to analyze',
+            },
+            current_file: {
+                type: 'string',
+                description: 'Current file being edited (e.g., "src/App.test.tsx")',
+            },
+            recent_commands: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Recent terminal commands (last 5, e.g., ["npm test", "git commit"])',
+            },
+            error_message: {
+                type: 'string',
+                description: 'Recent error message if any',
+            },
+            installed_skills: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Currently installed skill IDs (for filtering)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum suggestions to return (default 3, max 10)',
+                minimum: 1,
+                maximum: 10,
+                default: 3,
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID for rate limiting (default: "default")',
+                default: 'default',
+            },
+        },
+        required: ['project_path'],
+    },
+};
+/**
+ * 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':
+        default:
+            return 'unverified';
+    }
+}
+/**
+ * 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),
+        // Use tags as categories for filtering
+        categories: skill.tags,
+    };
+}
+/**
+ * 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);
+}
+// Rate limiter instance (singleton)
+let rateLimiter = null;
+/**
+ * Get or create the rate limiter
+ */
+function getRateLimiter() {
+    if (!rateLimiter) {
+        // Use STRICT preset: 10 requests per minute = ~1 per 6 seconds
+        // For suggestions, we want max 1 per 5 minutes, so we'll use custom config
+        rateLimiter = new RateLimiter({
+            maxTokens: 1, // Only 1 suggestion at a time
+            refillRate: 1 / 300, // 1 token per 300 seconds (5 minutes)
+            windowMs: 300000, // 5 minute window
+            keyPrefix: 'suggest',
+            failMode: 'open', // Allow on errors (graceful degradation)
+        });
+    }
+    return rateLimiter;
+}
+/**
+ * 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 async function executeSuggest(input, context) {
+    const startTime = performance.now();
+    // Validate input
+    const validated = suggestInputSchema.parse(input);
+    const { project_path, current_file, recent_commands, error_message, installed_skills, limit, session_id, } = validated;
+    // Check rate limit
+    const limiter = getRateLimiter();
+    const rateLimitResult = await limiter.checkLimit(session_id);
+    if (!rateLimitResult.allowed) {
+        return {
+            suggestions: [],
+            context_score: 0,
+            rate_limited: true,
+            next_suggestion_at: rateLimitResult.resetAt,
+            triggers_fired: [],
+            timing: {
+                totalMs: Math.round(performance.now() - startTime),
+            },
+        };
+    }
+    const analysisStart = performance.now();
+    // Analyze codebase (with timeout and caching)
+    let codebaseContext = null;
+    try {
+        const analyzer = new CodebaseAnalyzer();
+        codebaseContext = await analyzer.analyze(project_path, {
+            maxFiles: 500,
+            includeDevDeps: true,
+        });
+    }
+    catch (error) {
+        // Log error but continue with trigger detection
+        console.warn('CodebaseAnalyzer failed:', error);
+    }
+    const analysisMs = Math.round(performance.now() - analysisStart);
+    // Detect triggers
+    const detector = new TriggerDetector();
+    const triggers = detector.detectTriggers(codebaseContext, {
+        currentFile: current_file,
+        recentCommands: recent_commands,
+        errorMessage: error_message,
+        minConfidence: 0.5,
+    });
+    // Score context
+    const scorer = new ContextScorer();
+    const contextScore = scorer.scoreContext(triggers, codebaseContext);
+    // Check if we should suggest
+    if (!scorer.shouldSuggest(contextScore)) {
+        return {
+            suggestions: [],
+            context_score: contextScore.score,
+            rate_limited: false,
+            triggers_fired: contextScore.triggers,
+            timing: {
+                totalMs: Math.round(performance.now() - startTime),
+                analysisMs,
+            },
+        };
+    }
+    const matchingStart = performance.now();
+    // Load skills from database
+    const skillDatabase = await loadSkillsFromDatabase(context, 500);
+    // Filter skills by detected categories
+    const relevantCategories = new Set(contextScore.recommendedCategories);
+    const candidateSkills = skillDatabase.filter((skill) => {
+        // Skip already installed skills
+        if (installed_skills.some((id) => id.toLowerCase() === skill.id.toLowerCase())) {
+            return false;
+        }
+        // Check if skill matches any detected category
+        return skill.categories.some((cat) => relevantCategories.has(cat));
+    });
+    // Use SkillMatcher for semantic ranking
+    const matcher = new SkillMatcher({
+        useFallback: true,
+        minSimilarity: 0.3,
+        qualityWeight: 0.3,
+    });
+    // Build query from triggered categories
+    const query = contextScore.recommendedCategories.join(' ');
+    const matchResults = await matcher.findSimilarSkills(query, candidateSkills, limit);
+    const matchingMs = Math.round(performance.now() - matchingStart);
+    // Transform to response format
+    const suggestions = matchResults.map((result) => {
+        const skill = result.skill;
+        return {
+            skill_id: skill.id,
+            name: skill.name,
+            reason: result.matchReason,
+            confidence: contextScore.confidence,
+            trigger_types: contextScore.triggers,
+            trust_tier: skill.trustTier,
+            quality_score: skill.qualityScore,
+        };
+    });
+    matcher.close();
+    const totalMs = Math.round(performance.now() - startTime);
+    return {
+        suggestions,
+        context_score: contextScore.score,
+        rate_limited: false,
+        triggers_fired: contextScore.triggers,
+        timing: {
+            totalMs,
+            analysisMs,
+            matchingMs,
+        },
+    };
+}
+/**
+ * Format suggestions for terminal display
+ */
+export function formatSuggestions(response) {
+    const lines = [];
+    lines.push('\n=== Skill Suggestions ===\n');
+    if (response.rate_limited) {
+        lines.push('Rate limited. Please wait before requesting more suggestions.');
+        if (response.next_suggestion_at) {
+            lines.push(`Next suggestion available at: ${response.next_suggestion_at}`);
+        }
+        return lines.join('\n');
+    }
+    if (response.suggestions.length === 0) {
+        lines.push('No relevant suggestions at this time.');
+        lines.push('');
+        lines.push(`Context score: ${Math.round(response.context_score * 100)}%`);
+        lines.push(`Triggers: ${response.triggers_fired.join(', ') || 'none'}`);
+        return lines.join('\n');
+    }
+    lines.push(`Found ${response.suggestions.length} suggestion(s):\n`);
+    response.suggestions.forEach((sug, index) => {
+        const trustBadge = getTrustBadge(sug.trust_tier);
+        lines.push(`${index + 1}. ${sug.name} ${trustBadge}`);
+        lines.push(`   Confidence: ${Math.round(sug.confidence * 100)}%`);
+        lines.push(`   ${sug.reason}`);
+        lines.push(`   Triggers: ${sug.trigger_types.join(', ')}`);
+        lines.push(`   ID: ${sug.skill_id}`);
+        lines.push('');
+    });
+    lines.push('---');
+    lines.push(`Context score: ${Math.round(response.context_score * 100)}%`);
+    lines.push(`Triggers fired: ${response.triggers_fired.join(', ')}`);
+    lines.push(`Completed in ${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=suggest.js.map

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

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

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

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview MCP Uninstall Skill Tool for safely removing installed skills
+ * @module @skillsmith/mcp-server/tools/uninstall
+ * @see {@link https://github.com/wrsmith108/skillsmith|Skillsmith Repository}
+ *
+ * Provides skill uninstallation functionality with:
+ * - Manifest-based tracking of installed skills
+ * - Modification detection (warns if files changed since install)
+ * - Force removal option for modified or untracked skills
+ * - Clean removal from ~/.claude/skills/ directory
+ *
+ * @example
+ * // Uninstall a skill
+ * const result = await uninstallSkill({ skillName: 'commit' });
+ * if (result.success) {
+ *   console.log(result.message);
+ * }
+ *
+ * @example
+ * // Force uninstall modified skill
+ * const result = await uninstallSkill({
+ *   skillName: 'my-custom-skill',
+ *   force: true
+ * });
+ */
+import { z } from 'zod';
+import type { ToolContext } from '../context.js';
+export declare const uninstallInputSchema: z.ZodObject<{
+    skillName: z.ZodString;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force: boolean;
+    skillName: string;
+}, {
+    skillName: string;
+    force?: boolean | undefined;
+}>;
+export type UninstallInput = z.infer<typeof uninstallInputSchema>;
+export interface UninstallResult {
+    success: boolean;
+    skillName: string;
+    message: string;
+    removedPath?: string;
+    warning?: string;
+}
+/**
+ * Uninstall a skill from the local Claude Code skills directory.
+ *
+ * This function:
+ * 1. Loads the manifest to find the skill
+ * 2. Checks for local modifications (warns unless force=true)
+ * 3. Removes the skill directory from ~/.claude/skills/
+ * 4. Updates the manifest to remove the skill entry
+ *
+ * If the skill exists on disk but not in manifest, force=true is required.
+ *
+ * @param input - Uninstall parameters
+ * @param input.skillName - Name of the skill to uninstall
+ * @param input.force - Force removal even if modified (default: false)
+ * @returns Promise resolving to uninstall result with success status
+ *
+ * @example
+ * // Standard uninstall
+ * const result = await uninstallSkill({ skillName: 'jest-helper' });
+ * if (result.success) {
+ *   console.log(`Removed from ${result.removedPath}`);
+ * }
+ *
+ * @example
+ * // Handle modified skill
+ * const result = await uninstallSkill({ skillName: 'custom-skill' });
+ * if (!result.success && result.warning) {
+ *   console.log(result.warning); // 'Local modifications will be lost...'
+ *   // Ask user confirmation, then:
+ *   await uninstallSkill({ skillName: 'custom-skill', force: true });
+ * }
+ *
+ * @example
+ * // Check if skill is installed first
+ * const installed = await listInstalledSkills();
+ * if (installed.includes('my-skill')) {
+ *   await uninstallSkill({ skillName: 'my-skill' });
+ * }
+ */
+export declare function uninstallSkill(input: UninstallInput, _context?: ToolContext): Promise<UninstallResult>;
+/**
+ * List all skills currently installed via Skillsmith.
+ *
+ * Reads the manifest file and returns an array of skill names.
+ * This only includes skills tracked in the manifest, not skills
+ * manually placed in ~/.claude/skills/.
+ *
+ * @returns Promise resolving to array of installed skill names
+ *
+ * @example
+ * const skills = await listInstalledSkills();
+ * console.log(`${skills.length} skills installed:`);
+ * skills.forEach(s => console.log(`  - ${s}`));
+ */
+export declare function listInstalledSkills(): Promise<string[]>;
+/**
+ * MCP tool definition
+ */
+export declare const uninstallTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            skillName: {
+                type: string;
+                description: string;
+            };
+            force: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export default uninstallTool;
+//# sourceMappingURL=uninstall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/tools/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAGjE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAiFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,eAAe,CAAC,CAuF1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAG7D;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAiBzB,CAAA;AAED,eAAe,aAAa,CAAA"}