@skillsmith/core 0.5.5 → 0.5.6

package/dist/matching/OverlapDetector.js

@@ -0,0 +1,218 @@
+/**
+ * @fileoverview Trigger phrase overlap detection for skills
+ * @module @skillsmith/core/matching/OverlapDetector
+ * @see SMI-604: Trigger phrase overlap detection
+ *
+ * Detects similarity between skill trigger phrases to prevent
+ * recommending skills that overlap too much with installed ones.
+ *
+ * @example
+ * const detector = new OverlapDetector({ useFallback: true });
+ * const overlap = await detector.detectOverlap(skill1, skill2);
+ * if (overlap.overlapScore > 0.8) {
+ *   console.log('Skills are too similar:', overlap.overlappingPhrases);
+ * }
+ */
+import { EmbeddingService } from '../embeddings/index.js';
+/**
+ * Detects overlap between skill trigger phrases.
+ *
+ * Uses semantic similarity to identify skills that respond to
+ * similar user inputs, preventing confusing recommendations.
+ *
+ * @example
+ * const detector = new OverlapDetector({ overlapThreshold: 0.7 });
+ * const result = await detector.filterByOverlap(candidates, installed);
+ * // Use result.accepted for recommendations
+ */
+export class OverlapDetector {
+    embeddingService;
+    phraseEmbeddings = new Map();
+    phraseThreshold;
+    overlapThreshold;
+    useExactMatch;
+    constructor(options = {}) {
+        this.embeddingService = new EmbeddingService(options);
+        this.phraseThreshold = options.phraseThreshold ?? 0.75;
+        this.overlapThreshold = options.overlapThreshold ?? 0.6;
+        this.useExactMatch = options.useExactMatch ?? true;
+    }
+    /**
+     * Check if detector is using fallback mode
+     */
+    isUsingFallback() {
+        return this.embeddingService.isUsingFallback();
+    }
+    /**
+     * Detect overlap between two skills.
+     *
+     * @param skill1 - First skill
+     * @param skill2 - Second skill
+     * @returns Detailed overlap analysis
+     */
+    async detectOverlap(skill1, skill2) {
+        const overlappingPhrases = [];
+        // Get embeddings for all phrases
+        for (const phrase1 of skill1.triggerPhrases) {
+            for (const phrase2 of skill2.triggerPhrases) {
+                // Check exact match first
+                if (this.useExactMatch && this.isExactMatch(phrase1, phrase2)) {
+                    overlappingPhrases.push({
+                        phrase1,
+                        phrase2,
+                        similarity: 1.0,
+                    });
+                    continue;
+                }
+                // Check semantic similarity
+                const embedding1 = await this.getPhraseEmbedding(phrase1);
+                const embedding2 = await this.getPhraseEmbedding(phrase2);
+                const similarity = this.embeddingService.cosineSimilarity(embedding1, embedding2);
+                if (similarity >= this.phraseThreshold) {
+                    overlappingPhrases.push({
+                        phrase1,
+                        phrase2,
+                        similarity: Math.round(similarity * 100) / 100,
+                    });
+                }
+            }
+        }
+        // Calculate overall overlap score based on unique phrases that overlap
+        // Count unique phrases from skill1 that have at least one match in skill2
+        const overlappingFromSkill1 = new Set(overlappingPhrases.map((p) => p.phrase1));
+        const overlappingFromSkill2 = new Set(overlappingPhrases.map((p) => p.phrase2));
+        // Calculate the overlap ratio for each skill
+        const ratio1 = skill1.triggerPhrases.length > 0
+            ? overlappingFromSkill1.size / skill1.triggerPhrases.length
+            : 0;
+        const ratio2 = skill2.triggerPhrases.length > 0
+            ? overlappingFromSkill2.size / skill2.triggerPhrases.length
+            : 0;
+        // Use the average of both ratios for a balanced score
+        const overlapScore = (ratio1 + ratio2) / 2;
+        return {
+            skillId1: skill1.id,
+            skillId2: skill2.id,
+            overlapScore: Math.round(overlapScore * 100) / 100,
+            overlappingPhrases,
+            isDuplicate: overlapScore >= this.overlapThreshold,
+        };
+    }
+    /**
+     * Check for exact string match (case-insensitive, normalized)
+     */
+    isExactMatch(phrase1, phrase2) {
+        const normalize = (s) => s.toLowerCase().trim().replace(/\s+/g, ' ');
+        return normalize(phrase1) === normalize(phrase2);
+    }
+    /**
+     * Get or compute embedding for a phrase
+     */
+    async getPhraseEmbedding(phrase) {
+        const cacheKey = phrase.toLowerCase().trim();
+        if (!this.phraseEmbeddings.has(cacheKey)) {
+            const embedding = await this.embeddingService.embed(phrase);
+            this.phraseEmbeddings.set(cacheKey, embedding);
+        }
+        return this.phraseEmbeddings.get(cacheKey);
+    }
+    /**
+     * Filter candidate skills by overlap with installed skills.
+     *
+     * Removes candidates that have too much trigger phrase overlap
+     * with already installed skills.
+     *
+     * @param candidates - Skills to consider for recommendation
+     * @param installed - Currently installed skills
+     * @returns Filtered results with accepted and rejected skills
+     *
+     * @example
+     * const result = await detector.filterByOverlap(candidates, installed);
+     * console.log(`Accepted: ${result.accepted.length}`);
+     * console.log(`Rejected: ${result.rejected.length}`);
+     */
+    async filterByOverlap(candidates, installed) {
+        const accepted = [];
+        const rejected = [];
+        for (const candidate of candidates) {
+            let highestOverlap = 0;
+            let overlapsWith = '';
+            // Check overlap with each installed skill
+            for (const installedSkill of installed) {
+                const overlap = await this.detectOverlap(candidate, installedSkill);
+                if (overlap.overlapScore > highestOverlap) {
+                    highestOverlap = overlap.overlapScore;
+                    overlapsWith = installedSkill.id;
+                }
+            }
+            // Also check overlap with already accepted candidates
+            for (const acceptedSkill of accepted) {
+                const overlap = await this.detectOverlap(candidate, acceptedSkill);
+                if (overlap.overlapScore > highestOverlap) {
+                    highestOverlap = overlap.overlapScore;
+                    overlapsWith = acceptedSkill.id;
+                }
+            }
+            if (highestOverlap >= this.overlapThreshold) {
+                rejected.push({
+                    skill: candidate,
+                    overlapsWith,
+                    overlapScore: highestOverlap,
+                });
+            }
+            else {
+                accepted.push(candidate);
+            }
+        }
+        return { accepted, rejected };
+    }
+    /**
+     * Find all overlapping skill pairs in a set.
+     *
+     * Useful for auditing a skill library for potential conflicts.
+     *
+     * @param skills - Skills to check for overlaps
+     * @returns List of overlapping pairs
+     */
+    async findAllOverlaps(skills) {
+        const overlaps = [];
+        for (let i = 0; i < skills.length; i++) {
+            for (let j = i + 1; j < skills.length; j++) {
+                const result = await this.detectOverlap(skills[i], skills[j]);
+                if (result.overlappingPhrases.length > 0) {
+                    overlaps.push(result);
+                }
+            }
+        }
+        // Sort by overlap score descending
+        overlaps.sort((a, b) => b.overlapScore - a.overlapScore);
+        return overlaps;
+    }
+    /**
+     * Get overlap threshold
+     */
+    getOverlapThreshold() {
+        return this.overlapThreshold;
+    }
+    /**
+     * Get phrase similarity threshold
+     */
+    getPhraseThreshold() {
+        return this.phraseThreshold;
+    }
+    /**
+     * Clear cached embeddings
+     */
+    clear() {
+        this.phraseEmbeddings.clear();
+    }
+    /**
+     * Close resources
+     */
+    close() {
+        this.embeddingService.close();
+        this.clear();
+    }
+}
+export default OverlapDetector;
+//# sourceMappingURL=OverlapDetector.js.map

package/dist/matching/OverlapDetector.js.map

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

package/dist/matching/SkillMatcher.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Semantic skill matching using embeddings
+ * @module @skillsmith/core/matching/SkillMatcher
+ * @see SMI-602: Implement recommend_skills MCP tool
+ *
+ * Provides semantic similarity matching between skills using
+ * the EmbeddingService for vector-based comparisons.
+ *
+ * @example
+ * const matcher = new SkillMatcher({ useFallback: true });
+ * const matches = await matcher.findSimilarSkills('react testing', skills, 5);
+ */
+import { type EmbeddingServiceOptions } from '../embeddings/index.js';
+/**
+ * Skill data for matching
+ */
+export interface MatchableSkill {
+    /** Unique skill identifier */
+    id: string;
+    /** Skill display name */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Optional trigger phrases for overlap detection */
+    triggerPhrases?: string[];
+    /** Optional keywords for keyword-based fallback */
+    keywords?: string[];
+    /** Optional quality score (0-100) */
+    qualityScore?: number;
+}
+/**
+ * Result of a skill match
+ */
+export interface SkillMatchResult {
+    /** Matched skill */
+    skill: MatchableSkill;
+    /** Semantic similarity score (0-1) */
+    similarityScore: number;
+    /** Why this skill matched */
+    matchReason: string;
+}
+/**
+ * Options for SkillMatcher
+ */
+export interface SkillMatcherOptions extends EmbeddingServiceOptions {
+    /** Minimum similarity threshold (0-1, default 0.3) */
+    minSimilarity?: number;
+    /** Quality score weight (0-1, default 0.3) */
+    qualityWeight?: number;
+}
+/**
+ * Semantic skill matcher using embeddings.
+ *
+ * Finds skills similar to a query using vector similarity,
+ * with optional quality score boosting.
+ *
+ * @example
+ * const matcher = new SkillMatcher({ useFallback: true });
+ * await matcher.initialize(skills);
+ * const results = await matcher.findSimilarSkills('react testing', skills);
+ */
+export declare class SkillMatcher {
+    private embeddingService;
+    private skillEmbeddings;
+    private initialized;
+    private readonly minSimilarity;
+    private readonly qualityWeight;
+    constructor(options?: SkillMatcherOptions);
+    /**
+     * Check if matcher is using fallback mode
+     */
+    isUsingFallback(): boolean;
+    /**
+     * Initialize skill embeddings for a set of skills.
+     * Call this before matching for best performance.
+     */
+    initialize(skills: MatchableSkill[]): Promise<void>;
+    /**
+     * Convert skill to text for embedding
+     */
+    private skillToText;
+    /**
+     * Find skills similar to a query string.
+     *
+     * @param query - Search query or context description
+     * @param skills - Pool of skills to search
+     * @param limit - Maximum results to return
+     * @returns Ranked list of matching skills
+     *
+     * @example
+     * const matches = await matcher.findSimilarSkills(
+     *   'React TypeScript frontend testing',
+     *   availableSkills,
+     *   5
+     * );
+     */
+    findSimilarSkills(query: string, skills: MatchableSkill[], limit?: number): Promise<SkillMatchResult[]>;
+    /**
+     * Find skills similar to a set of installed skills.
+     *
+     * @param installedSkills - Currently installed skills
+     * @param candidateSkills - Pool of skills to recommend from
+     * @param limit - Maximum results
+     * @returns Ranked list of recommended skills
+     */
+    findComplementarySkills(installedSkills: MatchableSkill[], candidateSkills: MatchableSkill[], limit?: number): Promise<SkillMatchResult[]>;
+    /**
+     * Generate a human-readable match reason
+     */
+    private generateMatchReason;
+    /**
+     * Get embedding dimension
+     */
+    getEmbeddingDimension(): number;
+    /**
+     * Clear cached embeddings
+     */
+    clear(): void;
+    /**
+     * Close resources
+     */
+    close(): void;
+}
+export default SkillMatcher;
+//# sourceMappingURL=SkillMatcher.d.ts.map

package/dist/matching/SkillMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillMatcher.d.ts","sourceRoot":"","sources":["../../src/matching/SkillMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAEvF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAA;IACrB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAE1B,OAAO,GAAE,mBAAwB;IAM7C;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6C9B;;;;;;;OAOG;IACG,uBAAuB,CAC3B,eAAe,EAAE,cAAc,EAAE,EACjC,eAAe,EAAE,cAAc,EAAE,EACjC,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAe,YAAY,CAAA"}

package/dist/matching/SkillMatcher.js

@@ -0,0 +1,206 @@
+/**
+ * @fileoverview Semantic skill matching using embeddings
+ * @module @skillsmith/core/matching/SkillMatcher
+ * @see SMI-602: Implement recommend_skills MCP tool
+ *
+ * Provides semantic similarity matching between skills using
+ * the EmbeddingService for vector-based comparisons.
+ *
+ * @example
+ * const matcher = new SkillMatcher({ useFallback: true });
+ * const matches = await matcher.findSimilarSkills('react testing', skills, 5);
+ */
+import { EmbeddingService } from '../embeddings/index.js';
+/**
+ * Semantic skill matcher using embeddings.
+ *
+ * Finds skills similar to a query using vector similarity,
+ * with optional quality score boosting.
+ *
+ * @example
+ * const matcher = new SkillMatcher({ useFallback: true });
+ * await matcher.initialize(skills);
+ * const results = await matcher.findSimilarSkills('react testing', skills);
+ */
+export class SkillMatcher {
+    embeddingService;
+    skillEmbeddings = new Map();
+    initialized = false;
+    minSimilarity;
+    qualityWeight;
+    constructor(options = {}) {
+        this.embeddingService = new EmbeddingService(options);
+        this.minSimilarity = options.minSimilarity ?? 0.3;
+        this.qualityWeight = options.qualityWeight ?? 0.3;
+    }
+    /**
+     * Check if matcher is using fallback mode
+     */
+    isUsingFallback() {
+        return this.embeddingService.isUsingFallback();
+    }
+    /**
+     * Initialize skill embeddings for a set of skills.
+     * Call this before matching for best performance.
+     */
+    async initialize(skills) {
+        const texts = skills.map((skill) => ({
+            id: skill.id,
+            text: this.skillToText(skill),
+        }));
+        const results = await this.embeddingService.embedBatch(texts);
+        for (const result of results) {
+            this.skillEmbeddings.set(result.skillId, result.embedding);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Convert skill to text for embedding
+     */
+    skillToText(skill) {
+        const parts = [skill.name, skill.description];
+        if (skill.triggerPhrases && skill.triggerPhrases.length > 0) {
+            parts.push(skill.triggerPhrases.join(' '));
+        }
+        if (skill.keywords && skill.keywords.length > 0) {
+            parts.push(skill.keywords.join(' '));
+        }
+        return parts.join(' ').slice(0, 1000);
+    }
+    /**
+     * Find skills similar to a query string.
+     *
+     * @param query - Search query or context description
+     * @param skills - Pool of skills to search
+     * @param limit - Maximum results to return
+     * @returns Ranked list of matching skills
+     *
+     * @example
+     * const matches = await matcher.findSimilarSkills(
+     *   'React TypeScript frontend testing',
+     *   availableSkills,
+     *   5
+     * );
+     */
+    async findSimilarSkills(query, skills, limit = 10) {
+        // Ensure skills are initialized
+        if (!this.initialized) {
+            await this.initialize(skills);
+        }
+        // Get query embedding
+        const queryEmbedding = await this.embeddingService.embed(query);
+        // Score all skills
+        const scored = [];
+        for (const skill of skills) {
+            const skillEmbedding = this.skillEmbeddings.get(skill.id);
+            if (!skillEmbedding) {
+                // Skill not in cache, compute on-the-fly
+                const text = this.skillToText(skill);
+                const embedding = await this.embeddingService.embed(text);
+                this.skillEmbeddings.set(skill.id, embedding);
+            }
+            const embedding = this.skillEmbeddings.get(skill.id);
+            const semanticScore = this.embeddingService.cosineSimilarity(queryEmbedding, embedding);
+            // Apply quality boost
+            const qualityBoost = skill.qualityScore ? (skill.qualityScore / 100) * this.qualityWeight : 0;
+            const finalScore = semanticScore * (1 - this.qualityWeight) + qualityBoost;
+            if (finalScore >= this.minSimilarity) {
+                scored.push({
+                    skill,
+                    similarityScore: Math.round(finalScore * 100) / 100,
+                    matchReason: this.generateMatchReason(skill, query, semanticScore),
+                });
+            }
+        }
+        // Sort by score descending
+        scored.sort((a, b) => b.similarityScore - a.similarityScore);
+        return scored.slice(0, limit);
+    }
+    /**
+     * Find skills similar to a set of installed skills.
+     *
+     * @param installedSkills - Currently installed skills
+     * @param candidateSkills - Pool of skills to recommend from
+     * @param limit - Maximum results
+     * @returns Ranked list of recommended skills
+     */
+    async findComplementarySkills(installedSkills, candidateSkills, limit = 10) {
+        if (installedSkills.length === 0) {
+            // No installed skills, return top quality candidates
+            return candidateSkills
+                .map((skill) => ({
+                skill,
+                similarityScore: skill.qualityScore ? skill.qualityScore / 100 : 0.5,
+                matchReason: 'High-quality skill for your toolkit',
+            }))
+                .sort((a, b) => b.similarityScore - a.similarityScore)
+                .slice(0, limit);
+        }
+        // Build combined query from installed skills
+        const installedTexts = installedSkills.map((s) => this.skillToText(s));
+        const combinedQuery = installedTexts.join(' ');
+        // Filter out already installed
+        const installedIds = new Set(installedSkills.map((s) => s.id.toLowerCase()));
+        const candidates = candidateSkills.filter((s) => !installedIds.has(s.id.toLowerCase()));
+        return this.findSimilarSkills(combinedQuery, candidates, limit);
+    }
+    /**
+     * Generate a human-readable match reason
+     */
+    generateMatchReason(skill, query, semanticScore) {
+        const queryLower = query.toLowerCase();
+        const skillNameLower = skill.name.toLowerCase();
+        // Check for direct keyword matches
+        if (skill.keywords) {
+            const matchingKeywords = skill.keywords.filter((k) => queryLower.includes(k.toLowerCase()));
+            if (matchingKeywords.length > 0) {
+                return `Matches your ${matchingKeywords.slice(0, 2).join(' and ')} needs`;
+            }
+        }
+        // Check category from description
+        const descLower = skill.description.toLowerCase();
+        if (queryLower.includes('test') && descLower.includes('test')) {
+            return 'Supports your testing workflow';
+        }
+        if (queryLower.includes('react') && descLower.includes('react')) {
+            return 'Enhances your React development';
+        }
+        if (queryLower.includes('docker') && descLower.includes('docker')) {
+            return 'Helps with containerization';
+        }
+        if (queryLower.includes('api') && descLower.includes('api')) {
+            return 'Useful for API development';
+        }
+        // High semantic match
+        if (semanticScore > 0.7) {
+            return `Highly relevant to "${skillNameLower}"`;
+        }
+        // Default based on quality
+        if (skill.qualityScore && skill.qualityScore >= 90) {
+            return 'Top-rated skill in this category';
+        }
+        return 'Complements your existing skills';
+    }
+    /**
+     * Get embedding dimension
+     */
+    getEmbeddingDimension() {
+        return 384;
+    }
+    /**
+     * Clear cached embeddings
+     */
+    clear() {
+        this.skillEmbeddings.clear();
+        this.initialized = false;
+    }
+    /**
+     * Close resources
+     */
+    close() {
+        this.embeddingService.close();
+        this.clear();
+    }
+}
+export default SkillMatcher;
+//# sourceMappingURL=SkillMatcher.js.map

package/dist/matching/SkillMatcher.js.map

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

package/dist/matching/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill Matching Module
+ * @module @skillsmith/core/matching
+ *
+ * Provides semantic skill matching and overlap detection.
+ *
+ * @see SMI-602: Recommend skills based on codebase analysis
+ * @see SMI-604: Trigger phrase overlap detection
+ */
+export { SkillMatcher, default as DefaultSkillMatcher } from './SkillMatcher.js';
+export type { MatchableSkill, SkillMatchResult, SkillMatcherOptions } from './SkillMatcher.js';
+export { OverlapDetector, default as DefaultOverlapDetector } from './OverlapDetector.js';
+export type { TriggerPhraseSkill, OverlapResult, FilteredSkillsResult, OverlapDetectorOptions, } from './OverlapDetector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/matching/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAChF,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE9F,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AACzF,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA"}

package/dist/matching/index.js

@@ -0,0 +1,12 @@
+/**
+ * Skill Matching Module
+ * @module @skillsmith/core/matching
+ *
+ * Provides semantic skill matching and overlap detection.
+ *
+ * @see SMI-602: Recommend skills based on codebase analysis
+ * @see SMI-604: Trigger phrase overlap detection
+ */
+export { SkillMatcher, default as DefaultSkillMatcher } from './SkillMatcher.js';
+export { OverlapDetector, default as DefaultOverlapDetector } from './OverlapDetector.js';
+//# sourceMappingURL=index.js.map

package/dist/matching/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGhF,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/pipeline/DailyIndexPipeline.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Daily Index Generation Pipeline (SMI-593)
+ *
+ * Orchestrates the daily skill indexing process across multiple sources.
+ *
+ * @see pipeline-types.ts for type definitions
+ */
+import { type ISkillParser, type ISkillRepository } from '../sources/SourceIndexer.js';
+export type { PipelineStatus, PipelineSourceConfig, PipelineConfig, PipelineProgress, SourceResult, PipelineResult, PipelineSummary, } from './pipeline-types.js';
+import type { PipelineSourceConfig, PipelineConfig, PipelineProgress, PipelineResult } from './pipeline-types.js';
+/**
+ * Daily Index Pipeline
+ *
+ * Orchestrates skill indexing across multiple sources with:
+ * - Concurrent source processing
+ * - Progress tracking and callbacks
+ * - Error handling and recovery
+ * - Run state management
+ */
+export declare class DailyIndexPipeline {
+    private currentRun;
+    private scorer;
+    get isRunning(): boolean;
+    get currentRunId(): string | null;
+    run(config: PipelineConfig): Promise<PipelineResult>;
+    cancel(): boolean;
+    getProgress(): PipelineProgress | null;
+    private processSource;
+    private emitProgress;
+    private buildResult;
+    private generateRunId;
+}
+export declare function createScheduledPipeline(config: Omit<PipelineConfig, 'runId'>, options: {
+    intervalMs: number;
+    runImmediately?: boolean;
+    onRunComplete?: (result: PipelineResult) => void;
+}): {
+    start: () => void;
+    stop: () => void;
+    isRunning: () => boolean;
+    getLastResult: () => PipelineResult | null;
+};
+export declare function runDailyIndex(sources: PipelineSourceConfig[], parser: ISkillParser, repository: ISkillRepository, options?: {
+    continueOnError?: boolean;
+    maxConcurrentSources?: number;
+    onProgress?: (progress: PipelineProgress) => void;
+}): Promise<PipelineResult>;
+//# sourceMappingURL=DailyIndexPipeline.d.ts.map

package/dist/pipeline/DailyIndexPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DailyIndexPipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/DailyIndexPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAA;AAIpC,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAEV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAEhB,cAAc,EACf,MAAM,qBAAqB,CAAA;AAE5B;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CASH;IAEf,OAAO,CAAC,MAAM,CAAsB;IAEpC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAEK,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA4E1D,MAAM,IAAI,OAAO;IAQjB,WAAW,IAAI,gBAAgB,GAAG,IAAI;YA0BxB,aAAa;IAgD3B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,aAAa;CAOtB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;CACjD,GACA;IACD,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,aAAa,EAAE,MAAM,cAAc,GAAG,IAAI,CAAA;CAC3C,CAmCA;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAClD,GACA,OAAO,CAAC,cAAc,CAAC,CAGzB"}