@skillsmith/cli 0.3.0 → 0.3.2

package/dist/src/commands/merge.js

@@ -0,0 +1,160 @@
+/**
+ * SMI-1455: CLI command for safe skill database merging
+ *
+ * Provides a user-friendly interface to merge skill databases using
+ * the merge tooling from @skillsmith/core (SMI-1448).
+ *
+ * Usage:
+ *   skillsmith merge <source-db> [target-db]
+ *   sklx merge <source-db> --strategy keep_newer --dry-run
+ */
+import { Command } from 'commander';
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+import { mergeSkillDatabases, checkSchemaCompatibility, } from '@skillsmith/core';
+import { getDefaultDbPath } from '../config.js';
+/**
+ * Format merge result for display
+ */
+function formatMergeResult(result) {
+    const lines = [
+        '',
+        '╔══════════════════════════════════════════════════════════════╗',
+        '║                    Merge Results                             ║',
+        '╠══════════════════════════════════════════════════════════════╣',
+        `║  Skills added:    ${result.skillsAdded.toString().padStart(8)}                           ║`,
+        `║  Skills updated:  ${result.skillsUpdated.toString().padStart(8)}                           ║`,
+        `║  Skills skipped:  ${result.skillsSkipped.toString().padStart(8)}                           ║`,
+        `║  Conflicts:       ${result.conflicts.length.toString().padStart(8)}                           ║`,
+        `║  Duration:        ${(result.duration / 1000).toFixed(2).padStart(8)}s                          ║`,
+        '╚══════════════════════════════════════════════════════════════╝',
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Create the merge command
+ */
+export function createMergeCommand() {
+    const command = new Command('merge')
+        .description('Merge skills from one database into another')
+        .argument('<source>', 'Source database path to merge from')
+        .argument('[target]', 'Target database path (default: local skills.db)')
+        .option('-s, --strategy <strategy>', 'Merge strategy: keep_target, keep_source, keep_newer, merge_fields', 'keep_newer')
+        .option('-d, --dry-run', 'Preview changes without applying them', false)
+        .option('-v, --verbose', 'Show detailed conflict information', false)
+        .option('-q, --quiet', 'Only output errors', false)
+        .option('--force', 'Skip compatibility checks', false)
+        .action(async (sourcePath, targetPath, options) => {
+        const { strategy, dryRun, verbose, quiet, force } = options;
+        // Validate strategy
+        const validStrategies = [
+            'keep_target',
+            'keep_source',
+            'keep_newer',
+            'merge_fields',
+        ];
+        if (!validStrategies.includes(strategy)) {
+            console.error(`Invalid strategy: ${strategy}`);
+            console.error(`Valid strategies: ${validStrategies.join(', ')}`);
+            process.exit(1);
+        }
+        // Resolve paths
+        const resolvedSource = resolve(sourcePath);
+        const resolvedTarget = targetPath ? resolve(targetPath) : getDefaultDbPath();
+        // Check source exists
+        if (!existsSync(resolvedSource)) {
+            console.error(`Source database not found: ${resolvedSource}`);
+            process.exit(1);
+        }
+        // Check target exists (or will be created)
+        if (!existsSync(resolvedTarget)) {
+            console.error(`Target database not found: ${resolvedTarget}`);
+            console.error('Create a new database first with: skillsmith init');
+            process.exit(1);
+        }
+        if (!quiet) {
+            console.log('╔══════════════════════════════════════════════════════════════╗');
+            console.log('║              Skillsmith Database Merge                       ║');
+            console.log('╠══════════════════════════════════════════════════════════════╣');
+            console.log(`║  Source:   ${resolvedSource.slice(-48).padEnd(48)} ║`);
+            console.log(`║  Target:   ${resolvedTarget.slice(-48).padEnd(48)} ║`);
+            console.log(`║  Strategy: ${strategy.padEnd(48)} ║`);
+            console.log(`║  Dry Run:  ${(dryRun ? 'Yes' : 'No').padEnd(48)} ║`);
+            console.log('╚══════════════════════════════════════════════════════════════╝');
+            console.log('');
+        }
+        // Open databases
+        let sourceDb = null;
+        let targetDb = null;
+        try {
+            sourceDb = new Database(resolvedSource, { readonly: true });
+            targetDb = new Database(resolvedTarget);
+            // Check schema compatibility
+            if (!force) {
+                const sourceCompat = checkSchemaCompatibility(sourceDb);
+                const targetCompat = checkSchemaCompatibility(targetDb);
+                if (!sourceCompat.isCompatible) {
+                    console.error(`Source database: ${sourceCompat.message}`);
+                    process.exit(1);
+                }
+                if (!targetCompat.isCompatible) {
+                    console.error(`Target database: ${targetCompat.message}`);
+                    process.exit(1);
+                }
+                if (!quiet && sourceCompat.action !== 'none') {
+                    console.log(`Source: ${sourceCompat.message}`);
+                }
+                if (!quiet && targetCompat.action !== 'none') {
+                    console.log(`Target: ${targetCompat.message}`);
+                }
+            }
+            // Configure merge options
+            const mergeOptions = {
+                strategy: strategy,
+                dryRun,
+                skipInvalid: true,
+                ...(verbose && {
+                    onConflict: (conflict) => {
+                        console.log(`  Conflict: ${conflict.skillId} (${conflict.reason})`);
+                        return strategy;
+                    },
+                }),
+            };
+            // Perform merge
+            if (!quiet) {
+                console.log('Merging databases...');
+            }
+            const result = mergeSkillDatabases(targetDb, sourceDb, mergeOptions);
+            // Display results
+            if (!quiet) {
+                console.log(formatMergeResult(result));
+                if (dryRun) {
+                    console.log('⚠️  DRY RUN: No changes were made to the target database.');
+                    console.log('   Remove --dry-run to apply these changes.');
+                }
+                else {
+                    console.log('✅ Merge complete!');
+                }
+            }
+            // Exit with error if there were issues
+            if (result.skillsAdded === 0 && result.skillsUpdated === 0) {
+                if (!quiet) {
+                    console.log('\nNo new skills to merge.');
+                }
+            }
+        }
+        catch (error) {
+            console.error('Merge failed:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+        finally {
+            sourceDb?.close();
+            targetDb?.close();
+        }
+    });
+    return command;
+}
+export default createMergeCommand;
+//# sourceMappingURL=merge.js.map

package/dist/src/commands/merge.js.map

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

package/dist/src/commands/recommend.d.ts

@@ -3,12 +3,9 @@
  *
  * Analyzes a codebase and recommends relevant skills based on detected
  * frameworks, dependencies, and patterns.
- *
- * References:
- * - SMI-1283 (analyze command pattern)
- * - packages/mcp-server/src/tools/recommend.ts (recommendation logic)
  */
 import { Command } from 'commander';
+export type { SkillRecommendation, RecommendResponse, InstalledSkill } from './recommend.types.js';
 /**
  * Create recommend command
  */

package/dist/src/commands/recommend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/commands/recommend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA0lBnC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA+BhD;AAED,eAAe,sBAAsB,CAAA"}
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/commands/recommend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAsKlG;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAkDhD;AAED,eAAe,sBAAsB,CAAA"}

package/dist/src/commands/recommend.helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SMI-1299: CLI Recommend Command Helpers
+ * @module @skillsmith/cli/commands/recommend.helpers
+ */
+import type { TrustTier, CodebaseContext, SkillRole } from '@skillsmith/core';
+import type { SkillRecommendation, RecommendResponse, InstalledSkill } from './recommend.types.js';
+/**
+ * Validate and normalize trust tier from API response (SMI-1354)
+ */
+export declare function validateTrustTier(tier: unknown): TrustTier;
+/**
+ * Check if error is a network-related error (SMI-1355)
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Get trust badge for display (SMI-1357)
+ */
+export declare function getTrustBadge(tier: TrustTier): string;
+/**
+ * Format recommendations for terminal display
+ */
+export declare function formatRecommendations(response: RecommendResponse, context: CodebaseContext | null): string;
+/**
+ * Format recommendations as JSON
+ */
+export declare function formatAsJson(response: RecommendResponse, context: CodebaseContext | null): string;
+/**
+ * Format offline analysis results (SMI-1355)
+ */
+export declare function formatOfflineResults(context: CodebaseContext, json: boolean): string;
+/**
+ * Build stack from codebase analysis
+ */
+export declare function buildStackFromAnalysis(context: CodebaseContext): string[];
+/**
+ * Read installed skills from ~/.claude/skills/ directory (SMI-1358)
+ */
+export declare function getInstalledSkills(): InstalledSkill[];
+/**
+ * SMI-1631: Infer skill roles from tags when not explicitly set
+ */
+export declare function inferRolesFromTags(tags: string[]): SkillRole[];
+/**
+ * Normalize a skill name for comparison (SMI-1358)
+ */
+export declare function normalizeSkillName(name: string): string;
+/**
+ * Check if two skills overlap in functionality (SMI-1358)
+ */
+export declare function skillsOverlap(installed: InstalledSkill, recommended: SkillRecommendation): boolean;
+/**
+ * Filter recommendations to remove overlaps with installed skills (SMI-1358)
+ */
+export declare function filterOverlappingSkills(recommendations: SkillRecommendation[], installedSkills: InstalledSkill[]): {
+    filtered: SkillRecommendation[];
+    overlapCount: number;
+};
+//# sourceMappingURL=recommend.helpers.d.ts.map

package/dist/src/commands/recommend.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/recommend.helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,SAAS,EAGV,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOlG;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CActD;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAYrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,eAAe,GAAG,IAAI,GAC9B,MAAM,CAsFR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CA+BjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAyDpF;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAczE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CA0DrD;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAqE9D;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAqBT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,mBAAmB,EAAE,EACtC,eAAe,EAAE,cAAc,EAAE,GAChC;IAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAkB3D"}

package/dist/src/commands/recommend.helpers.js

@@ -0,0 +1,428 @@
+/**
+ * SMI-1299: CLI Recommend Command Helpers
+ * @module @skillsmith/cli/commands/recommend.helpers
+ */
+import chalk from 'chalk';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { VALID_TRUST_TIERS } from './recommend.types.js';
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validate and normalize trust tier from API response (SMI-1354)
+ */
+export function validateTrustTier(tier) {
+    if (typeof tier === 'string' && VALID_TRUST_TIERS.includes(tier)) {
+        return tier;
+    }
+    return 'unknown';
+}
+/**
+ * Check if error is a network-related error (SMI-1355)
+ */
+export function isNetworkError(error) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('fetch failed') ||
+            message.includes('network') ||
+            message.includes('enotfound') ||
+            message.includes('econnrefused') ||
+            message.includes('timeout') ||
+            message.includes('socket') ||
+            error.name === 'AbortError');
+    }
+    return false;
+}
+// ============================================================================
+// Display Helpers
+// ============================================================================
+/**
+ * Get trust badge for display (SMI-1357)
+ */
+export function getTrustBadge(tier) {
+    switch (tier) {
+        case 'verified':
+            return chalk.green('[VERIFIED]');
+        case 'community':
+            return chalk.blue('[COMMUNITY]');
+        case 'experimental':
+            return chalk.yellow('[EXPERIMENTAL]');
+        case 'unknown':
+        default:
+            return chalk.gray('[UNKNOWN]');
+    }
+}
+/**
+ * Format recommendations for terminal display
+ */
+export function formatRecommendations(response, context) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.blue('=== Skill Recommendations ==='));
+    lines.push('');
+    if (context) {
+        if (context.frameworks.length > 0) {
+            const frameworks = context.frameworks
+                .slice(0, 3)
+                .map((f) => f.name)
+                .join(', ');
+            lines.push(chalk.dim(`Detected: ${frameworks}`));
+            lines.push('');
+        }
+    }
+    if (response.recommendations.length === 0) {
+        lines.push(chalk.yellow('No recommendations found.'));
+        lines.push('');
+        lines.push('Suggestions:');
+        lines.push('  - Ensure the project has a package.json');
+        lines.push('  - Try a project with more dependencies');
+        lines.push('  - Use --context to provide additional context');
+        if (response.context.role_filter) {
+            lines.push(`  - Try removing the --role filter (currently: ${response.context.role_filter})`);
+        }
+    }
+    else {
+        lines.push(`Found ${chalk.bold(response.recommendations.length)} recommendation(s):`);
+        lines.push('');
+        response.recommendations.forEach((rec, index) => {
+            const trustBadge = getTrustBadge(rec.trust_tier);
+            const qualityColor = rec.quality_score >= 80 ? chalk.green : rec.quality_score >= 50 ? chalk.yellow : chalk.red;
+            let relevanceDisplay;
+            if (rec.similarity_score < 0) {
+                relevanceDisplay = chalk.gray('N/A');
+            }
+            else {
+                const relevanceColor = rec.similarity_score >= 0.7
+                    ? chalk.green
+                    : rec.similarity_score >= 0.4
+                        ? chalk.yellow
+                        : chalk.gray;
+                relevanceDisplay = relevanceColor(`${Math.round(rec.similarity_score * 100)}%`);
+            }
+            const rolesDisplay = rec.roles?.length ? chalk.cyan(` [${rec.roles.join(', ')}]`) : '';
+            lines.push(`${chalk.bold(`${index + 1}.`)} ${chalk.bold(rec.name)} ${trustBadge}${rolesDisplay}`);
+            lines.push(`   Score: ${qualityColor(`${rec.quality_score}/100`)} | Relevance: ${relevanceDisplay}`);
+            lines.push(`   ${chalk.dim(rec.reason)}`);
+            lines.push(`   ${chalk.dim(`ID: ${rec.skill_id}`)}`);
+            lines.push('');
+        });
+    }
+    lines.push(chalk.dim('---'));
+    lines.push(chalk.dim(`Candidates considered: ${response.candidates_considered}`));
+    if (response.overlap_filtered > 0) {
+        lines.push(chalk.dim(`Filtered for overlap: ${response.overlap_filtered}`));
+    }
+    if (response.role_filtered > 0) {
+        lines.push(chalk.dim(`Filtered for role: ${response.role_filtered}`));
+    }
+    if (response.context.role_filter) {
+        lines.push(chalk.dim(`Role filter: ${response.context.role_filter}`));
+    }
+    if (response.context.auto_detected) {
+        lines.push(chalk.dim(`Installed skills: ${response.context.installed_count} (auto-detected from ~/.claude/skills/)`));
+    }
+    else {
+        lines.push(chalk.dim(`Installed skills: ${response.context.installed_count}`));
+    }
+    lines.push(chalk.dim(`Completed in ${response.timing.totalMs}ms`));
+    return lines.join('\n');
+}
+/**
+ * Format recommendations as JSON
+ */
+export function formatAsJson(response, context) {
+    const output = {
+        recommendations: response.recommendations,
+        analysis: context
+            ? {
+                frameworks: context.frameworks.slice(0, 10).map((f) => ({
+                    name: f.name,
+                    confidence: Math.round(f.confidence * 100),
+                })),
+                dependencies: context.dependencies.slice(0, 20).map((d) => ({
+                    name: d.name,
+                    is_dev: d.isDev,
+                })),
+                stats: {
+                    total_files: context.stats.totalFiles,
+                    total_lines: context.stats.totalLines,
+                },
+            }
+            : null,
+        meta: {
+            candidates_considered: response.candidates_considered,
+            overlap_filtered: response.overlap_filtered,
+            role_filtered: response.role_filtered,
+            role_filter: response.context.role_filter ?? null,
+            installed_count: response.context.installed_count,
+            auto_detected: response.context.auto_detected,
+            timing_ms: response.timing.totalMs,
+        },
+    };
+    return JSON.stringify(output, null, 2);
+}
+/**
+ * Format offline analysis results (SMI-1355)
+ */
+export function formatOfflineResults(context, json) {
+    if (json) {
+        return JSON.stringify({
+            offline: true,
+            analysis: {
+                frameworks: context.frameworks.slice(0, 10).map((f) => ({
+                    name: f.name,
+                    confidence: Math.round(f.confidence * 100),
+                })),
+                dependencies: context.dependencies.slice(0, 20).map((d) => ({
+                    name: d.name,
+                    is_dev: d.isDev,
+                })),
+                stats: {
+                    total_files: context.stats.totalFiles,
+                    total_lines: context.stats.totalLines,
+                },
+            },
+            message: 'Unable to reach Skillsmith API. Showing analysis-only results.',
+        }, null, 2);
+    }
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.yellow('⚠ Unable to reach Skillsmith API. Showing analysis-only results.'));
+    lines.push('');
+    lines.push(chalk.bold.blue('=== Codebase Analysis ==='));
+    lines.push('');
+    if (context.frameworks.length > 0) {
+        lines.push(chalk.bold('Detected Frameworks:'));
+        context.frameworks.slice(0, 5).forEach((f) => {
+            lines.push(`  - ${f.name} (${Math.round(f.confidence * 100)}% confidence)`);
+        });
+        lines.push('');
+    }
+    if (context.dependencies.length > 0) {
+        const prodDeps = context.dependencies.filter((d) => !d.isDev).slice(0, 10);
+        if (prodDeps.length > 0) {
+            lines.push(chalk.bold('Key Dependencies:'));
+            prodDeps.forEach((d) => lines.push(`  - ${d.name}`));
+            lines.push('');
+        }
+    }
+    lines.push(chalk.dim('---'));
+    lines.push(chalk.dim(`Files analyzed: ${context.stats.totalFiles}`));
+    lines.push(chalk.dim(`Total lines: ${context.stats.totalLines.toLocaleString()}`));
+    lines.push('');
+    lines.push(chalk.cyan('To get skill recommendations, ensure network connectivity and retry.'));
+    return lines.join('\n');
+}
+// ============================================================================
+// Stack Building
+// ============================================================================
+/**
+ * Build stack from codebase analysis
+ */
+export function buildStackFromAnalysis(context) {
+    const stack = [];
+    for (const fw of context.frameworks.slice(0, 5)) {
+        stack.push(fw.name.toLowerCase());
+    }
+    for (const dep of context.dependencies.slice(0, 10)) {
+        if (!dep.isDev) {
+            stack.push(dep.name.toLowerCase());
+        }
+    }
+    return [...new Set(stack)].slice(0, 10);
+}
+// ============================================================================
+// Installed Skills Detection
+// ============================================================================
+/**
+ * Read installed skills from ~/.claude/skills/ directory (SMI-1358)
+ */
+export function getInstalledSkills() {
+    const skillsDir = join(homedir(), '.claude', 'skills');
+    if (!existsSync(skillsDir)) {
+        return [];
+    }
+    const installedSkills = [];
+    try {
+        const entries = readdirSync(skillsDir);
+        for (const entry of entries) {
+            const skillPath = join(skillsDir, entry);
+            const stat = statSync(skillPath);
+            if (!stat.isDirectory())
+                continue;
+            const skill = {
+                name: entry.toLowerCase(),
+                directory: entry,
+                tags: [],
+                category: null,
+            };
+            const skillMdPath = join(skillPath, 'SKILL.md');
+            if (existsSync(skillMdPath)) {
+                try {
+                    const content = readFileSync(skillMdPath, 'utf-8');
+                    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+                    const frontmatter = frontmatterMatch?.[1];
+                    if (frontmatter) {
+                        const tagsMatch = frontmatter.match(/tags:\s*\[(.*?)\]/);
+                        const tagsContent = tagsMatch?.[1];
+                        if (tagsContent) {
+                            skill.tags = tagsContent
+                                .split(',')
+                                .map((t) => t.trim().replace(/['"]/g, '').toLowerCase())
+                                .filter(Boolean);
+                        }
+                        const categoryMatch = frontmatter.match(/category:\s*["']?([^"'\n]+)["']?/);
+                        const categoryContent = categoryMatch?.[1];
+                        if (categoryContent) {
+                            skill.category = categoryContent.trim().toLowerCase();
+                        }
+                    }
+                }
+                catch {
+                    // Ignore read errors
+                }
+            }
+            installedSkills.push(skill);
+        }
+    }
+    catch {
+        return [];
+    }
+    return installedSkills;
+}
+// ============================================================================
+// Role Inference
+// ============================================================================
+/**
+ * SMI-1631: Infer skill roles from tags when not explicitly set
+ */
+export function inferRolesFromTags(tags) {
+    const roleMapping = {
+        lint: 'code-quality',
+        linting: 'code-quality',
+        format: 'code-quality',
+        formatting: 'code-quality',
+        prettier: 'code-quality',
+        eslint: 'code-quality',
+        'code-review': 'code-quality',
+        review: 'code-quality',
+        refactor: 'code-quality',
+        refactoring: 'code-quality',
+        'code-style': 'code-quality',
+        test: 'testing',
+        testing: 'testing',
+        jest: 'testing',
+        vitest: 'testing',
+        mocha: 'testing',
+        playwright: 'testing',
+        cypress: 'testing',
+        e2e: 'testing',
+        unit: 'testing',
+        integration: 'testing',
+        tdd: 'testing',
+        docs: 'documentation',
+        documentation: 'documentation',
+        readme: 'documentation',
+        jsdoc: 'documentation',
+        typedoc: 'documentation',
+        changelog: 'documentation',
+        api: 'documentation',
+        git: 'workflow',
+        commit: 'workflow',
+        pr: 'workflow',
+        'pull-request': 'workflow',
+        ci: 'workflow',
+        cd: 'workflow',
+        'ci-cd': 'workflow',
+        deploy: 'workflow',
+        deployment: 'workflow',
+        automation: 'workflow',
+        workflow: 'workflow',
+        security: 'security',
+        audit: 'security',
+        vulnerability: 'security',
+        cve: 'security',
+        secrets: 'security',
+        authentication: 'security',
+        auth: 'security',
+        ai: 'development-partner',
+        assistant: 'development-partner',
+        helper: 'development-partner',
+        copilot: 'development-partner',
+        productivity: 'development-partner',
+        scaffold: 'development-partner',
+        generator: 'development-partner',
+    };
+    const inferredRoles = new Set();
+    for (const tag of tags) {
+        const normalizedTag = tag.toLowerCase().replace(/[-_]/g, '');
+        for (const [keyword, role] of Object.entries(roleMapping)) {
+            if (normalizedTag.includes(keyword.replace(/[-_]/g, ''))) {
+                inferredRoles.add(role);
+            }
+        }
+    }
+    return [...inferredRoles];
+}
+// ============================================================================
+// Overlap Detection
+// ============================================================================
+/**
+ * Normalize a skill name for comparison (SMI-1358)
+ */
+export function normalizeSkillName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[-_]/g, '')
+        .replace(/^skill/, '')
+        .replace(/skill$/, '')
+        .replace(/^helper/, '')
+        .replace(/helper$/, '')
+        .trim();
+}
+/**
+ * Check if two skills overlap in functionality (SMI-1358)
+ */
+export function skillsOverlap(installed, recommended) {
+    const installedName = normalizeSkillName(installed.name);
+    const recommendedName = normalizeSkillName(recommended.name);
+    const recommendedId = recommended.skill_id.toLowerCase();
+    if (installedName === recommendedName)
+        return true;
+    if (recommendedId.includes(installed.name))
+        return true;
+    if (installedName.includes(recommendedName) || recommendedName.includes(installedName)) {
+        if (installedName.length >= 4 && recommendedName.length >= 4)
+            return true;
+    }
+    if (installed.tags.length > 0) {
+        const recommendedNameParts = recommended.name.toLowerCase().split(/[-_\s]+/);
+        const hasTagOverlap = installed.tags.some((tag) => recommendedNameParts.includes(tag) || recommendedName.includes(tag));
+        if (hasTagOverlap)
+            return true;
+    }
+    return false;
+}
+/**
+ * Filter recommendations to remove overlaps with installed skills (SMI-1358)
+ */
+export function filterOverlappingSkills(recommendations, installedSkills) {
+    if (installedSkills.length === 0) {
+        return { filtered: recommendations, overlapCount: 0 };
+    }
+    const filtered = [];
+    let overlapCount = 0;
+    for (const rec of recommendations) {
+        const hasOverlap = installedSkills.some((installed) => skillsOverlap(installed, rec));
+        if (hasOverlap) {
+            overlapCount++;
+        }
+        else {
+            filtered.push(rec);
+        }
+    }
+    return { filtered, overlapCount };
+}
+//# sourceMappingURL=recommend.helpers.js.map