@skillsmith/core 0.1.0

package/dist/src/triggers/ContextScorer.js

@@ -0,0 +1,265 @@
+/**
+ * @fileoverview Context Scoring System for ranking skill suggestion relevance
+ * @module @skillsmith/core/triggers/ContextScorer
+ * @see Phase 4: Trigger System Architecture
+ *
+ * Scores the relevance of skill suggestions based on:
+ * - Number and type of triggers fired
+ * - Confidence levels of triggers
+ * - Recency of trigger events
+ * - User feedback history
+ *
+ * @example
+ * const scorer = new ContextScorer();
+ * const score = scorer.scoreContext(triggers, codebaseContext);
+ * if (score.score >= 0.6) {
+ *   // High relevance - suggest skills
+ * }
+ */
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('ContextScorer');
+/**
+ * Default scoring weights
+ */
+const DEFAULT_WEIGHTS = {
+    fileWeight: 0.4,
+    commandWeight: 0.3,
+    errorWeight: 0.2,
+    projectWeight: 0.3,
+};
+/**
+ * ContextScorer - Scores skill suggestion relevance
+ *
+ * Uses a weighted scoring algorithm to determine how relevant
+ * skill suggestions would be based on detected triggers.
+ */
+export class ContextScorer {
+    weights;
+    multiTriggerBoost;
+    multiTriggerMultiplier;
+    debug;
+    constructor(options = {}) {
+        this.weights = {
+            ...DEFAULT_WEIGHTS,
+            ...options.weights,
+        };
+        this.multiTriggerBoost = options.multiTriggerBoost ?? true;
+        this.multiTriggerMultiplier = options.multiTriggerMultiplier ?? 1.2;
+        this.debug = options.debug ?? false;
+        if (this.debug) {
+            log.info('ContextScorer initialized', {
+                weights: this.weights,
+                multiTriggerBoost: this.multiTriggerBoost,
+                multiTriggerMultiplier: this.multiTriggerMultiplier,
+            });
+        }
+    }
+    /**
+     * Score the context based on detected triggers
+     *
+     * @param triggers - Detected triggers from TriggerDetector
+     * @param codebaseContext - Optional codebase analysis
+     * @returns Context score with recommendations
+     */
+    scoreContext(triggers, codebaseContext) {
+        if (triggers.length === 0) {
+            return {
+                score: 0,
+                confidence: 0,
+                triggers: [],
+                reason: 'No triggers detected',
+                recommendedCategories: [],
+            };
+        }
+        // Group triggers by type
+        const triggersByType = this.groupTriggersByType(triggers);
+        // Calculate weighted score
+        let totalScore = 0;
+        let totalWeight = 0;
+        // File triggers
+        if (triggersByType.file.length > 0) {
+            const fileScore = this.calculateTypeScore(triggersByType.file);
+            totalScore += fileScore * this.weights.fileWeight;
+            totalWeight += this.weights.fileWeight;
+        }
+        // Command triggers
+        if (triggersByType.command.length > 0) {
+            const commandScore = this.calculateTypeScore(triggersByType.command);
+            totalScore += commandScore * this.weights.commandWeight;
+            totalWeight += this.weights.commandWeight;
+        }
+        // Error triggers
+        if (triggersByType.error.length > 0) {
+            const errorScore = this.calculateTypeScore(triggersByType.error);
+            totalScore += errorScore * this.weights.errorWeight;
+            totalWeight += this.weights.errorWeight;
+        }
+        // Project triggers
+        if (triggersByType.project.length > 0) {
+            const projectScore = this.calculateTypeScore(triggersByType.project);
+            totalScore += projectScore * this.weights.projectWeight;
+            totalWeight += this.weights.projectWeight;
+        }
+        // Normalize by total weight
+        let finalScore = totalWeight > 0 ? totalScore / totalWeight : 0;
+        // Apply multi-trigger boost
+        const uniqueTriggerTypes = Object.keys(triggersByType).filter((type) => triggersByType[type].length > 0);
+        if (this.multiTriggerBoost && uniqueTriggerTypes.length > 1) {
+            const boostFactor = Math.min(this.multiTriggerMultiplier, 1 + (uniqueTriggerTypes.length - 1) * 0.1);
+            finalScore = Math.min(1, finalScore * boostFactor);
+            if (this.debug) {
+                log.debug('Applied multi-trigger boost', {
+                    uniqueTriggerTypes: uniqueTriggerTypes.length,
+                    boostFactor,
+                    originalScore: totalScore / totalWeight,
+                    boostedScore: finalScore,
+                });
+            }
+        }
+        // Calculate confidence
+        const confidence = this.calculateConfidence(triggers, uniqueTriggerTypes.length, codebaseContext);
+        // Extract recommended categories
+        const recommendedCategories = this.extractRecommendedCategories(triggers);
+        // Generate reason
+        const reason = this.generateReason(triggers, triggersByType, finalScore);
+        return {
+            score: Math.round(finalScore * 100) / 100,
+            confidence: Math.round(confidence * 100) / 100,
+            triggers: uniqueTriggerTypes,
+            reason,
+            recommendedCategories,
+        };
+    }
+    /**
+     * Group triggers by type
+     */
+    groupTriggersByType(triggers) {
+        const grouped = {
+            file: [],
+            command: [],
+            error: [],
+            project: [],
+        };
+        for (const trigger of triggers) {
+            grouped[trigger.type].push(trigger);
+        }
+        return grouped;
+    }
+    /**
+     * Calculate score for a specific trigger type
+     */
+    calculateTypeScore(triggers) {
+        if (triggers.length === 0)
+            return 0;
+        // Take the maximum confidence from this type
+        const maxConfidence = Math.max(...triggers.map((t) => t.confidence));
+        // If multiple triggers of same type, boost slightly
+        const countBoost = triggers.length > 1 ? 1.1 : 1.0;
+        return Math.min(1, maxConfidence * countBoost);
+    }
+    /**
+     * Calculate confidence in the suggestion
+     */
+    calculateConfidence(triggers, uniqueTypeCount, codebaseContext) {
+        // Base confidence on average trigger confidence
+        const avgConfidence = triggers.reduce((sum, t) => sum + t.confidence, 0) / triggers.length;
+        // Boost for multiple trigger types
+        const diversityBoost = uniqueTypeCount > 1 ? 0.1 * (uniqueTypeCount - 1) : 0;
+        // Boost for codebase analysis
+        const contextBoost = codebaseContext && codebaseContext.frameworks.length > 0 ? 0.1 : 0;
+        return Math.min(1, avgConfidence + diversityBoost + contextBoost);
+    }
+    /**
+     * Extract recommended skill categories from triggers
+     */
+    extractRecommendedCategories(triggers) {
+        const categories = new Set();
+        for (const trigger of triggers) {
+            for (const category of trigger.categories) {
+                categories.add(category);
+            }
+        }
+        return Array.from(categories);
+    }
+    /**
+     * Generate human-readable reason for the score
+     */
+    generateReason(allTriggers, triggersByType, score) {
+        const parts = [];
+        if (triggersByType.file.length > 0) {
+            const fileNames = triggersByType.file
+                .map((t) => t.source?.split('/').pop() || 'files')
+                .slice(0, 2);
+            parts.push(`Working with ${fileNames.join(', ')}`);
+        }
+        if (triggersByType.command.length > 0) {
+            const commands = triggersByType.command
+                .map((t) => t.source?.split(' ')[0] || 'commands')
+                .slice(0, 2);
+            parts.push(`Running ${commands.join(', ')} commands`);
+        }
+        if (triggersByType.error.length > 0) {
+            parts.push('Encountered relevant errors');
+        }
+        if (triggersByType.project.length > 0) {
+            const frameworks = allTriggers
+                .filter((t) => t.type === 'project')
+                .flatMap((t) => t.categories)
+                .slice(0, 2);
+            parts.push(`Detected ${frameworks.join(', ')} in project`);
+        }
+        if (parts.length === 0) {
+            return 'Context analysis suggests relevant skills';
+        }
+        const contextSummary = parts.join('; ');
+        if (score >= 0.8) {
+            return `Strong match: ${contextSummary}`;
+        }
+        else if (score >= 0.6) {
+            return `Good match: ${contextSummary}`;
+        }
+        else if (score >= 0.4) {
+            return `Moderate match: ${contextSummary}`;
+        }
+        else {
+            return `Weak match: ${contextSummary}`;
+        }
+    }
+    /**
+     * Determine if score meets threshold for suggestion
+     *
+     * @param score - Context score result
+     * @returns Whether to suggest skills
+     */
+    shouldSuggest(score) {
+        // High relevance: always suggest
+        if (score.score >= 0.6) {
+            return true;
+        }
+        // Medium relevance: suggest if high confidence
+        if (score.score >= 0.4 && score.confidence >= 0.7) {
+            return true;
+        }
+        // Otherwise don't suggest
+        return false;
+    }
+    /**
+     * Get suggestion urgency level
+     *
+     * @param score - Context score result
+     * @returns Urgency level
+     */
+    getUrgency(score) {
+        if (score.score >= 0.8) {
+            return 'high';
+        }
+        else if (score.score >= 0.6) {
+            return 'medium';
+        }
+        else {
+            return 'low';
+        }
+    }
+}
+export default ContextScorer;
+//# sourceMappingURL=ContextScorer.js.map

package/dist/src/triggers/ContextScorer.js.map

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

package/dist/src/triggers/TriggerDetector.d.ts

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview Trigger Detection System for proactive skill suggestions
+ * @module @skillsmith/core/triggers/TriggerDetector
+ * @see Phase 4: Trigger System Architecture
+ *
+ * Detects contexts where skill suggestions would be relevant based on:
+ * - File patterns (*.test.ts → testing skills)
+ * - Command patterns (git commit → commit skills)
+ * - Error messages (ESLint error → linting skills)
+ * - Project structure (React detected → React skills)
+ *
+ * @example
+ * const detector = new TriggerDetector(analyzer);
+ * const triggers = await detector.detectTriggers('/path/to/project', {
+ *   currentFile: 'src/App.test.tsx',
+ *   recentCommands: ['npm test'],
+ * });
+ */
+import type { CodebaseContext } from '../analysis/CodebaseAnalyzer.js';
+/**
+ * Trigger types for skill suggestions
+ */
+export type TriggerType = 'file' | 'command' | 'error' | 'project';
+/**
+ * File pattern trigger configuration
+ */
+export interface FilePatternTrigger {
+    /** Pattern to match against file paths */
+    pattern: string | RegExp;
+    /** Skill categories this trigger suggests */
+    skillCategories: string[];
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Command pattern trigger configuration
+ */
+export interface CommandTrigger {
+    /** Pattern to match against commands */
+    command: string | RegExp;
+    /** Skill categories this trigger suggests */
+    skillCategories: string[];
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Error pattern trigger configuration
+ */
+export interface ErrorTrigger {
+    /** Pattern to match against error messages */
+    errorPattern: RegExp;
+    /** Skill categories this trigger suggests */
+    skillCategories: string[];
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Project structure trigger configuration
+ */
+export interface ProjectTrigger {
+    /** Function to detect if trigger applies to codebase */
+    detector: (context: CodebaseContext) => boolean;
+    /** Skill categories this trigger suggests */
+    skillCategories: string[];
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Detected trigger with metadata
+ */
+export interface DetectedTrigger {
+    /** Type of trigger */
+    type: TriggerType;
+    /** Skill categories suggested */
+    categories: string[];
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Why this trigger fired */
+    reason: string;
+    /** Source that caused the trigger (file path, command, etc.) */
+    source?: string;
+}
+/**
+ * Options for trigger detection
+ */
+export interface TriggerDetectionOptions {
+    /** Current file being edited */
+    currentFile?: string;
+    /** Recent terminal commands (last 5) */
+    recentCommands?: string[];
+    /** Recent error message if any */
+    errorMessage?: string;
+    /** Minimum confidence threshold (default: 0.5) */
+    minConfidence?: number;
+}
+/**
+ * Default file pattern triggers
+ */
+export declare const DEFAULT_FILE_TRIGGERS: FilePatternTrigger[];
+/**
+ * Default command triggers
+ */
+export declare const DEFAULT_COMMAND_TRIGGERS: CommandTrigger[];
+/**
+ * Default error triggers
+ */
+export declare const DEFAULT_ERROR_TRIGGERS: ErrorTrigger[];
+/**
+ * Default project structure triggers
+ */
+export declare const DEFAULT_PROJECT_TRIGGERS: ProjectTrigger[];
+/**
+ * TriggerDetector - Detects contexts for skill suggestions
+ *
+ * Analyzes file patterns, commands, errors, and project structure
+ * to identify relevant skill recommendation opportunities.
+ */
+export declare class TriggerDetector {
+    private filePatterns;
+    private commandPatterns;
+    private errorPatterns;
+    private projectPatterns;
+    constructor(fileTriggers?: FilePatternTrigger[], commandTriggers?: CommandTrigger[], errorTriggers?: ErrorTrigger[], projectTriggers?: ProjectTrigger[]);
+    /**
+     * Detect all applicable triggers for the current context
+     *
+     * @param codebaseContext - Analysis of the project structure
+     * @param options - Current context (file, commands, errors)
+     * @returns Array of detected triggers
+     */
+    detectTriggers(codebaseContext: CodebaseContext | null, options?: TriggerDetectionOptions): DetectedTrigger[];
+    /**
+     * Detect file pattern triggers
+     */
+    private detectFilePatternTriggers;
+    /**
+     * Detect command pattern triggers
+     */
+    private detectCommandTriggers;
+    /**
+     * Detect error pattern triggers
+     */
+    private detectErrorTriggers;
+    /**
+     * Detect project structure triggers
+     */
+    private detectProjectTriggers;
+    /**
+     * Deduplicate triggers and rank by confidence
+     */
+    private deduplicateAndRank;
+    /**
+     * Add custom file pattern trigger
+     */
+    addFilePattern(trigger: FilePatternTrigger): void;
+    /**
+     * Add custom command trigger
+     */
+    addCommandPattern(trigger: CommandTrigger): void;
+    /**
+     * Add custom error trigger
+     */
+    addErrorPattern(trigger: ErrorTrigger): void;
+    /**
+     * Add custom project trigger
+     */
+    addProjectPattern(trigger: ProjectTrigger): void;
+}
+export default TriggerDetector;
+//# sourceMappingURL=TriggerDetector.d.ts.map

package/dist/src/triggers/TriggerDetector.d.ts.map

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