@skillsmith/mcp-server 0.1.0

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

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview MCP analyze_codebase Tool
+ * @module @skillsmith/mcp-server/tools/analyze
+ * @see SMI-600: Implement analyze_codebase MCP tool
+ *
+ * Analyzes a codebase to extract context for skill recommendations.
+ * Uses TypeScript/JavaScript analysis per ADR-010.
+ *
+ * @example
+ * // Analyze current directory
+ * const result = await executeAnalyze({ path: '.' });
+ * console.log(result.frameworks);
+ *
+ * @example
+ * // Analyze with options
+ * const result = await executeAnalyze({
+ *   path: '/path/to/project',
+ *   max_files: 500,
+ *   include_dev_deps: false
+ * });
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for analyze tool input validation
+ */
+export declare const analyzeInputSchema: z.ZodObject<{
+    /** Path to analyze (default: current directory) */
+    path: z.ZodDefault<z.ZodString>;
+    /** Maximum files to analyze (default: 1000) */
+    max_files: z.ZodDefault<z.ZodNumber>;
+    /** Directories to exclude */
+    exclude_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Include dev dependencies in analysis */
+    include_dev_deps: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    max_files: number;
+    include_dev_deps: boolean;
+    exclude_dirs?: string[] | undefined;
+}, {
+    path?: string | undefined;
+    max_files?: number | undefined;
+    exclude_dirs?: string[] | undefined;
+    include_dev_deps?: boolean | undefined;
+}>;
+/**
+ * Input type for analyze tool
+ */
+export type AnalyzeInput = z.input<typeof analyzeInputSchema>;
+/**
+ * Simplified framework info for response
+ */
+export interface AnalyzeFramework {
+    /** Framework name */
+    name: string;
+    /** Confidence level (0-100) */
+    confidence: number;
+}
+/**
+ * Simplified dependency info for response
+ */
+export interface AnalyzeDependency {
+    /** Package name */
+    name: string;
+    /** Whether this is a dev dependency */
+    is_dev: boolean;
+}
+/**
+ * Analysis response with codebase context
+ */
+export interface AnalyzeResponse {
+    /** Detected frameworks */
+    frameworks: AnalyzeFramework[];
+    /** Top dependencies */
+    dependencies: AnalyzeDependency[];
+    /** Unique import modules */
+    imports: string[];
+    /** File statistics */
+    stats: {
+        total_files: number;
+        total_lines: number;
+        file_types: Record<string, number>;
+    };
+    /** Summary for skill matching */
+    summary: string;
+    /** Analysis timing */
+    timing: {
+        duration_ms: number;
+    };
+}
+/**
+ * MCP tool schema definition for analyze_codebase
+ */
+export declare const analyzeToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            max_files: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+            exclude_dirs: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_dev_deps: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: never[];
+    };
+};
+/**
+ * Execute codebase analysis.
+ *
+ * Scans the specified directory for TypeScript/JavaScript files,
+ * extracts imports, detects frameworks, and returns context
+ * suitable for skill recommendations.
+ *
+ * @param input - Analysis parameters
+ * @returns Promise resolving to analysis response
+ * @throws {Error} When path doesn't exist or analysis fails
+ *
+ * @example
+ * const response = await executeAnalyze({
+ *   path: './my-project',
+ *   max_files: 500
+ * });
+ * console.log('Detected:', response.frameworks.map(f => f.name).join(', '));
+ */
+export declare function executeAnalyze(input: AnalyzeInput): Promise<AnalyzeResponse>;
+/**
+ * Format analysis results for terminal display
+ */
+export declare function formatAnalysisResults(response: AnalyzeResponse): string;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/tools/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,mDAAmD;;IAEnD,+CAA+C;;IAE/C,6BAA6B;;IAE7B,2CAA2C;;;;;;;;;;;;EAE3C,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,uBAAuB;IACvB,YAAY,EAAE,iBAAiB,EAAE,CAAA;IACjC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,sBAAsB;IACtB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,CAAA;IACD,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC7B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAclF;AAsDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAoEvE"}

package/dist/src/tools/analyze.js

@@ -0,0 +1,205 @@
+/**
+ * @fileoverview MCP analyze_codebase Tool
+ * @module @skillsmith/mcp-server/tools/analyze
+ * @see SMI-600: Implement analyze_codebase MCP tool
+ *
+ * Analyzes a codebase to extract context for skill recommendations.
+ * Uses TypeScript/JavaScript analysis per ADR-010.
+ *
+ * @example
+ * // Analyze current directory
+ * const result = await executeAnalyze({ path: '.' });
+ * console.log(result.frameworks);
+ *
+ * @example
+ * // Analyze with options
+ * const result = await executeAnalyze({
+ *   path: '/path/to/project',
+ *   max_files: 500,
+ *   include_dev_deps: false
+ * });
+ */
+import { z } from 'zod';
+import { CodebaseAnalyzer } from '@skillsmith/core';
+/**
+ * Zod schema for analyze tool input validation
+ */
+export const analyzeInputSchema = z.object({
+    /** Path to analyze (default: current directory) */
+    path: z.string().default('.'),
+    /** Maximum files to analyze (default: 1000) */
+    max_files: z.number().min(1).max(10000).default(1000),
+    /** Directories to exclude */
+    exclude_dirs: z.array(z.string()).optional(),
+    /** Include dev dependencies in analysis */
+    include_dev_deps: z.boolean().default(true),
+});
+/**
+ * MCP tool schema definition for analyze_codebase
+ */
+export const analyzeToolSchema = {
+    name: 'analyze_codebase',
+    description: 'Analyze a codebase to understand its structure, frameworks, and dependencies. ' +
+        'Returns context useful for skill recommendations. ' +
+        'Supports TypeScript, JavaScript, TSX, and JSX files.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to the codebase to analyze (default: current directory)',
+                default: '.',
+            },
+            max_files: {
+                type: 'number',
+                description: 'Maximum files to analyze (default: 1000, max: 10000)',
+                minimum: 1,
+                maximum: 10000,
+                default: 1000,
+            },
+            exclude_dirs: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Directories to exclude (default: node_modules, dist, .git, coverage)',
+            },
+            include_dev_deps: {
+                type: 'boolean',
+                description: 'Include dev dependencies in analysis (default: true)',
+                default: true,
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Execute codebase analysis.
+ *
+ * Scans the specified directory for TypeScript/JavaScript files,
+ * extracts imports, detects frameworks, and returns context
+ * suitable for skill recommendations.
+ *
+ * @param input - Analysis parameters
+ * @returns Promise resolving to analysis response
+ * @throws {Error} When path doesn't exist or analysis fails
+ *
+ * @example
+ * const response = await executeAnalyze({
+ *   path: './my-project',
+ *   max_files: 500
+ * });
+ * console.log('Detected:', response.frameworks.map(f => f.name).join(', '));
+ */
+export async function executeAnalyze(input) {
+    // Validate input
+    const validated = analyzeInputSchema.parse(input);
+    const analyzer = new CodebaseAnalyzer();
+    const context = await analyzer.analyze(validated.path, {
+        maxFiles: validated.max_files,
+        excludeDirs: validated.exclude_dirs,
+        includeDevDeps: validated.include_dev_deps,
+    });
+    // Transform to response format
+    return transformContextToResponse(context, analyzer);
+}
+/**
+ * Transform CodebaseContext to AnalyzeResponse
+ */
+function transformContextToResponse(context, analyzer) {
+    // Get unique import modules (external only)
+    const uniqueImports = new Set();
+    for (const imp of context.imports) {
+        // Skip relative imports
+        if (!imp.module.startsWith('.') && !imp.module.startsWith('/')) {
+            // Get base package name (e.g., '@scope/pkg' or 'pkg')
+            const parts = imp.module.split('/');
+            const basePkg = imp.module.startsWith('@') ? `${parts[0]}/${parts[1]}` : parts[0];
+            uniqueImports.add(basePkg);
+        }
+    }
+    // Transform frameworks
+    const frameworks = context.frameworks
+        .slice(0, 10)
+        .map((f) => ({
+        name: f.name,
+        confidence: Math.round(f.confidence * 100),
+    }));
+    // Transform dependencies (top 20)
+    const dependencies = context.dependencies.slice(0, 20).map((d) => ({
+        name: d.name,
+        is_dev: d.isDev,
+    }));
+    // Get summary
+    const summary = analyzer.getSummary(context);
+    return {
+        frameworks,
+        dependencies,
+        imports: Array.from(uniqueImports).slice(0, 50),
+        stats: {
+            total_files: context.stats.totalFiles,
+            total_lines: context.stats.totalLines,
+            file_types: context.stats.filesByExtension,
+        },
+        summary,
+        timing: {
+            duration_ms: context.metadata.durationMs,
+        },
+    };
+}
+/**
+ * Format analysis results for terminal display
+ */
+export function formatAnalysisResults(response) {
+    const lines = [];
+    lines.push('\n=== Codebase Analysis ===\n');
+    // Stats
+    lines.push(`Files: ${response.stats.total_files} | Lines: ${response.stats.total_lines.toLocaleString()}`);
+    lines.push(`Duration: ${response.timing.duration_ms}ms`);
+    lines.push('');
+    // File types
+    const fileTypes = Object.entries(response.stats.file_types)
+        .sort((a, b) => b[1] - a[1])
+        .map(([ext, count]) => `${ext}: ${count}`)
+        .join(', ');
+    lines.push(`File types: ${fileTypes}`);
+    lines.push('');
+    // Frameworks
+    if (response.frameworks.length > 0) {
+        lines.push('Frameworks detected:');
+        for (const fw of response.frameworks.slice(0, 5)) {
+            lines.push(`  • ${fw.name} (${fw.confidence}% confidence)`);
+        }
+        lines.push('');
+    }
+    // Dependencies
+    if (response.dependencies.length > 0) {
+        const prodDeps = response.dependencies.filter((d) => !d.is_dev);
+        const devDeps = response.dependencies.filter((d) => d.is_dev);
+        if (prodDeps.length > 0) {
+            lines.push(`Dependencies (${prodDeps.length}):`);
+            lines.push(`  ${prodDeps
+                .slice(0, 10)
+                .map((d) => d.name)
+                .join(', ')}`);
+            if (prodDeps.length > 10) {
+                lines.push(`  ... and ${prodDeps.length - 10} more`);
+            }
+            lines.push('');
+        }
+        if (devDeps.length > 0) {
+            lines.push(`Dev dependencies (${devDeps.length}):`);
+            lines.push(`  ${devDeps
+                .slice(0, 10)
+                .map((d) => d.name)
+                .join(', ')}`);
+            if (devDeps.length > 10) {
+                lines.push(`  ... and ${devDeps.length - 10} more`);
+            }
+            lines.push('');
+        }
+    }
+    // Summary
+    lines.push('---');
+    lines.push(`Summary: ${response.summary}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=analyze.js.map

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

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

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

@@ -0,0 +1,149 @@
+/**
+ * @fileoverview MCP Skill Compare Tool for comparing two skills
+ * @module @skillsmith/mcp-server/tools/compare
+ * @see SMI-743: Add MCP Tool skill_compare
+ * @see SMI-791: Wire compare tool to SkillRepository
+ *
+ * Compares two skills across multiple dimensions:
+ * - Quality scores
+ * - Trust tiers
+ * - Features and capabilities
+ * - Dependencies
+ * - Size and complexity
+ *
+ * @example
+ * // Compare two skills with context
+ * const result = await executeCompare({
+ *   skill_a: 'community/jest-helper',
+ *   skill_b: 'community/vitest-helper'
+ * }, context);
+ * console.log(result.recommendation);
+ */
+import { z } from 'zod';
+import { type MCPTrustTier as TrustTier, type ScoreBreakdown } from '@skillsmith/core';
+import type { ToolContext } from '../context.js';
+/**
+ * Zod schema for compare tool input validation
+ */
+export declare const compareInputSchema: z.ZodObject<{
+    /** First skill ID to compare */
+    skill_a: z.ZodString;
+    /** Second skill ID to compare */
+    skill_b: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    skill_a: string;
+    skill_b: string;
+}, {
+    skill_a: string;
+    skill_b: string;
+}>;
+/**
+ * Input type derived from Zod schema
+ */
+export type CompareInput = z.infer<typeof compareInputSchema>;
+/**
+ * Summary of a skill for comparison
+ */
+export interface SkillSummary {
+    /** Skill identifier */
+    id: string;
+    /** Skill name */
+    name: string;
+    /** Brief description */
+    description: string;
+    /** Author */
+    author: string;
+    /** Quality score (0-100) */
+    quality_score: number;
+    /** Score breakdown by category */
+    score_breakdown: ScoreBreakdown | null;
+    /** Trust tier */
+    trust_tier: TrustTier;
+    /** Category */
+    category: string;
+    /** Tags */
+    tags: string[];
+    /** Version if available */
+    version: string | null;
+    /** Dependencies */
+    dependencies: string[];
+}
+/**
+ * Difference between skills
+ */
+export interface SkillDifference {
+    /** Field being compared */
+    field: string;
+    /** Value from skill A */
+    a_value: unknown;
+    /** Value from skill B */
+    b_value: unknown;
+    /** Winner if applicable */
+    winner?: 'a' | 'b' | 'tie';
+}
+/**
+ * Comparison response
+ */
+export interface CompareResponse {
+    /** Summaries of both skills */
+    comparison: {
+        a: SkillSummary;
+        b: SkillSummary;
+    };
+    /** List of differences between skills */
+    differences: SkillDifference[];
+    /** Recommendation text */
+    recommendation: string;
+    /** Overall winner if determinable */
+    winner: 'a' | 'b' | 'tie';
+    /** Performance timing */
+    timing: {
+        totalMs: number;
+    };
+}
+/**
+ * MCP tool schema definition for skill_compare
+ */
+export declare const compareToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            skill_a: {
+                type: string;
+                description: string;
+            };
+            skill_b: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute skill comparison.
+ *
+ * Uses SkillRepository to fetch skills from the database and compares them
+ * across multiple dimensions including quality scores, trust tiers, features,
+ * and dependencies.
+ *
+ * @param input - Comparison parameters with two skill IDs
+ * @param context - Tool context with database and services
+ * @returns Promise resolving to comparison response
+ * @throws {SkillsmithError} When skill IDs are invalid or not found
+ *
+ * @example
+ * const response = await executeCompare({
+ *   skill_a: 'community/jest-helper',
+ *   skill_b: 'community/vitest-helper'
+ * }, context);
+ * console.log(response.recommendation);
+ */
+export declare function executeCompare(input: CompareInput, context: ToolContext): Promise<CompareResponse>;
+/**
+ * Format comparison results for terminal display
+ */
+export declare function formatComparisonResults(response: CompareResponse): string;
+//# sourceMappingURL=compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/tools/compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAEL,KAAK,YAAY,IAAI,SAAS,EAC9B,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gCAAgC;;IAEhC,iCAAiC;;;;;;;;EAEjC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,kCAAkC;IAClC,eAAe,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC,iBAAiB;IACjB,UAAU,EAAE,SAAS,CAAA;IACrB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,mBAAmB;IACnB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,UAAU,EAAE;QACV,CAAC,EAAE,YAAY,CAAA;QACf,CAAC,EAAE,YAAY,CAAA;KAChB,CAAA;IACD,yCAAyC;IACzC,WAAW,EAAE,eAAe,EAAE,CAAA;IAC9B,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAA;IACzB,yBAAyB;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAkB7B,CAAA;AAgSD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAiF1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAoGzE"}