@skillsmith/core 0.5.4 → 0.5.6

package/dist/services/SkillAnalyzer.helpers.js

@@ -0,0 +1,237 @@
+/**
+ * SMI-1788: SkillAnalyzer Helpers
+ *
+ * Tool detection patterns, thresholds, and utility functions
+ * for skill analysis and optimization.
+ */
+/**
+ * Tool detection patterns for analyzing skill content
+ */
+export const TOOL_PATTERNS = {
+    Read: {
+        patterns: ['read file', 'read the file', 'examine', 'view file', 'cat ', 'Read tool'],
+        weight: 1,
+    },
+    Write: {
+        patterns: [
+            'write file',
+            'create file',
+            'save to',
+            'output to file',
+            'Write tool',
+            'write the file',
+        ],
+        weight: 2,
+    },
+    Edit: {
+        patterns: ['edit file', 'modify file', 'update file', 'patch', 'Edit tool', 'replace in'],
+        weight: 2,
+    },
+    Bash: {
+        patterns: [
+            'bash',
+            'npm ',
+            'npx ',
+            'git ',
+            'docker',
+            'yarn ',
+            'pnpm ',
+            'execute command',
+            'run command',
+            'terminal',
+            'shell',
+            'Bash tool',
+        ],
+        weight: 3,
+    },
+    Grep: {
+        patterns: ['grep', 'search for', 'find text', 'pattern match', 'Grep tool'],
+        weight: 1,
+    },
+    Glob: {
+        patterns: ['glob', 'find file', 'file pattern', 'list files', 'Glob tool'],
+        weight: 1,
+    },
+    WebFetch: {
+        patterns: ['fetch', 'http', 'api call', 'url', 'WebFetch', 'download', 'request'],
+        weight: 2,
+    },
+    WebSearch: {
+        patterns: ['web search', 'search online', 'lookup online', 'WebSearch'],
+        weight: 2,
+    },
+    Task: {
+        patterns: ['Task(', 'Task tool', 'spawn agent', 'delegate to', 'subagent'],
+        weight: 3,
+    },
+};
+/**
+ * Thresholds for optimization decisions
+ */
+export const THRESHOLDS = {
+    /** Maximum lines before recommending decomposition */
+    maxLinesBeforeDecompose: 500,
+    /** Minimum lines for an extractable section */
+    minSectionLines: 50,
+    /** Heavy tool usage count that suggests subagent */
+    heavyToolUsageCount: 5,
+    /** Sequential Task() calls that should be parallelized */
+    sequentialTaskThreshold: 2,
+    /** Minimum optimization score to recommend transformation */
+    minTransformScore: 30,
+    /** Large examples section threshold */
+    largeExamplesThreshold: 200,
+};
+/**
+ * Escape special regex characters in a string
+ * @param str - String to escape
+ * @returns Escaped string safe for use in RegExp
+ */
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Determine confidence level based on match count
+ * @param matchCount - Number of detected tools
+ * @returns Confidence level
+ */
+export function getConfidenceLevel(matchCount) {
+    if (matchCount >= 4)
+        return 'high';
+    if (matchCount >= 2)
+        return 'medium';
+    return 'low';
+}
+/**
+ * Estimate examples lines by looking for code blocks
+ * @param content - Full skill content
+ * @returns Estimated number of lines in code blocks
+ */
+export function estimateExamplesLines(content) {
+    const codeBlockMatches = content.match(/```[\s\S]*?```/g) || [];
+    let totalLines = 0;
+    for (const block of codeBlockMatches) {
+        totalLines += block.split('\n').length;
+    }
+    return totalLines;
+}
+/**
+ * Detect tools in content
+ * @param content - Skill content to analyze
+ * @returns Object with detected tools and total weight
+ */
+export function detectTools(content) {
+    const detectedTools = [];
+    let totalWeight = 0;
+    for (const [tool, config] of Object.entries(TOOL_PATTERNS)) {
+        for (const pattern of config.patterns) {
+            // Use word-boundary regex to avoid false positives
+            const regex = new RegExp(`\\b${escapeRegex(pattern)}\\b`, 'i');
+            if (regex.test(content)) {
+                if (!detectedTools.includes(tool)) {
+                    detectedTools.push(tool);
+                    totalWeight += config.weight;
+                }
+                break;
+            }
+        }
+    }
+    return { tools: detectedTools, totalWeight };
+}
+/**
+ * Count specific command patterns in content
+ * @param content - Skill content to analyze
+ * @returns Counts for bash, read, and write commands
+ */
+export function countCommandPatterns(content) {
+    const bashCommandCount = (content.match(/\b(npm|npx|git|docker|yarn|pnpm)\s/gi) || []).length;
+    const fileReadCount = (content.match(/\b(read|cat|head|tail|grep|find)\s/gi) || []).length;
+    const fileWriteCount = (content.match(/\b(write|edit|modify|create)\s+file/gi) || []).length;
+    return { bashCommandCount, fileReadCount, fileWriteCount };
+}
+/**
+ * Determine if tool usage suggests a subagent would be beneficial
+ * @param bashCount - Number of bash commands
+ * @param fileOpCount - Total file operations (read + write)
+ * @param totalWeight - Total tool weight
+ * @returns Whether subagent is suggested
+ */
+export function shouldSuggestSubagent(bashCount, fileOpCount, totalWeight) {
+    return (bashCount >= THRESHOLDS.heavyToolUsageCount ||
+        fileOpCount >= THRESHOLDS.heavyToolUsageCount ||
+        totalWeight >= 10);
+}
+/**
+ * Count sequential Task() calls in content
+ * @param content - Skill content to analyze
+ * @returns Count of sequential Task calls
+ */
+export function countSequentialTaskCalls(content) {
+    const lines = content.split('\n');
+    let sequentialCalls = 0;
+    let consecutiveTaskLines = 0;
+    for (const line of lines) {
+        if (line.includes('Task(') || line.includes('Task (')) {
+            consecutiveTaskLines++;
+        }
+        else if (consecutiveTaskLines > 0) {
+            if (consecutiveTaskLines >= THRESHOLDS.sequentialTaskThreshold) {
+                sequentialCalls += consecutiveTaskLines;
+            }
+            consecutiveTaskLines = 0;
+        }
+    }
+    // Check for final sequence
+    if (consecutiveTaskLines >= THRESHOLDS.sequentialTaskThreshold) {
+        sequentialCalls += consecutiveTaskLines;
+    }
+    return sequentialCalls;
+}
+/**
+ * Calculate batch savings percentage
+ * @param sequentialCalls - Number of sequential Task calls
+ * @returns Estimated savings percentage
+ */
+export function calculateBatchSavings(sequentialCalls) {
+    // Batching reduces context overhead by ~30-50%
+    return sequentialCalls >= THRESHOLDS.sequentialTaskThreshold
+        ? Math.min(50, sequentialCalls * 10)
+        : 0;
+}
+/**
+ * Determine extraction reason for a section
+ * @param sectionName - Name of the section
+ * @param lineCount - Number of lines in section
+ * @returns Human-readable extraction reason
+ */
+export function getExtractionReason(sectionName, lineCount) {
+    const lowerName = sectionName.toLowerCase();
+    if (lowerName.includes('api') || lowerName.includes('reference')) {
+        return 'API reference sections can be loaded on-demand';
+    }
+    if (lowerName.includes('example') || lowerName.includes('usage')) {
+        return 'Examples can be progressively disclosed';
+    }
+    if (lowerName.includes('advanced') || lowerName.includes('configuration')) {
+        return 'Advanced topics are rarely needed in initial context';
+    }
+    if (lineCount > 100) {
+        return 'Large section suitable for sub-skill extraction';
+    }
+    return 'Section size suggests separate loading benefit';
+}
+/**
+ * Calculate extraction priority based on size ratio
+ * @param lineCount - Section line count
+ * @param totalLines - Total document lines
+ * @returns Priority (1 = highest, 3 = lowest)
+ */
+export function calculateExtractionPriority(lineCount, totalLines) {
+    const sizeRatio = lineCount / totalLines;
+    if (sizeRatio > 0.3)
+        return 1;
+    if (sizeRatio > 0.15)
+        return 2;
+    return 3;
+}
+//# sourceMappingURL=SkillAnalyzer.helpers.js.map

package/dist/services/SkillAnalyzer.helpers.js.map

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

package/dist/services/SkillAnalyzer.js

@@ -0,0 +1,270 @@
+/**
+ * SMI-1788: SkillAnalyzer - Analyze skills for optimization patterns
+ *
+ * Detects optimization opportunities based on:
+ * - Line count (>500 lines suggests decomposition)
+ * - Tool usage patterns (heavy tool usage suggests subagent)
+ * - Sequential Task() calls (can be parallelized)
+ * - Large examples sections (can use progressive disclosure)
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+import { THRESHOLDS, detectTools, countCommandPatterns, shouldSuggestSubagent, getConfidenceLevel, estimateExamplesLines, countSequentialTaskCalls, calculateBatchSavings, getExtractionReason, calculateExtractionPriority, } from './SkillAnalyzer.helpers.js';
+// Re-export helpers for testing and advanced usage
+export { TOOL_PATTERNS, THRESHOLDS, escapeRegex, getConfidenceLevel, } from './SkillAnalyzer.helpers.js';
+/**
+ * Analyze a skill's content for optimization opportunities
+ *
+ * @param content - The full SKILL.md content
+ * @returns Analysis of optimization potential
+ * @remarks The lineCount for an empty string returns 1, matching standard
+ * String.split('\n') behavior where ''.split('\n') yields ['']
+ */
+export function analyzeSkill(content) {
+    const lines = content.split('\n');
+    const lineCount = lines.length;
+    // Analyze sections
+    const { mainContentLines, examplesLines, sections } = analyzeSections(content);
+    // Analyze tool usage
+    const toolUsage = analyzeToolUsage(content);
+    // Analyze Task() patterns
+    const taskPatterns = analyzeTaskPatterns(content);
+    // Find extractable sections
+    const extractableSections = findExtractableSections(sections, lineCount);
+    // Generate recommendations
+    const recommendations = generateRecommendations(lineCount, examplesLines, toolUsage, taskPatterns, extractableSections);
+    // Calculate optimization score
+    const optimizationScore = calculateOptimizationScore(lineCount, toolUsage, taskPatterns, recommendations);
+    return {
+        lineCount,
+        mainContentLines,
+        examplesLines,
+        toolUsage,
+        taskPatterns,
+        extractableSections,
+        recommendations,
+        optimizationScore,
+        shouldTransform: optimizationScore >= THRESHOLDS.minTransformScore,
+    };
+}
+/**
+ * Analyze sections within the skill content
+ */
+function analyzeSections(content) {
+    const lines = content.split('\n');
+    const sections = [];
+    let currentSection = null;
+    let examplesStartLine = -1;
+    let examplesEndLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headerMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headerMatch) {
+            // Save previous section
+            if (currentSection) {
+                sections.push({
+                    name: currentSection.name,
+                    startLine: currentSection.startLine,
+                    endLine: i - 1,
+                    content: currentSection.lines.join('\n'),
+                });
+            }
+            currentSection = {
+                name: headerMatch[2].trim(),
+                startLine: i,
+                lines: [],
+            };
+            // Track examples section
+            const sectionName = headerMatch[2].toLowerCase();
+            if (sectionName.includes('example') || sectionName.includes('usage')) {
+                examplesStartLine = i;
+            }
+        }
+        if (currentSection) {
+            currentSection.lines.push(line);
+        }
+    }
+    // Save last section
+    if (currentSection) {
+        sections.push({
+            name: currentSection.name,
+            startLine: currentSection.startLine,
+            endLine: lines.length - 1,
+            content: currentSection.lines.join('\n'),
+        });
+        if (examplesStartLine >= 0 && examplesEndLine < 0) {
+            examplesEndLine = lines.length - 1;
+        }
+    }
+    // Calculate line counts
+    const examplesLines = examplesStartLine >= 0
+        ? examplesEndLine - examplesStartLine + 1
+        : estimateExamplesLines(content);
+    const mainContentLines = lines.length - examplesLines;
+    return { mainContentLines, examplesLines, sections };
+}
+/**
+ * Analyze tool usage patterns in the content
+ */
+function analyzeToolUsage(content) {
+    const { tools: detectedTools, totalWeight } = detectTools(content);
+    const { bashCommandCount, fileReadCount, fileWriteCount } = countCommandPatterns(content);
+    const suggestsSubagent = shouldSuggestSubagent(bashCommandCount, fileReadCount + fileWriteCount, totalWeight);
+    const confidence = getConfidenceLevel(detectedTools.length);
+    return {
+        detectedTools,
+        bashCommandCount,
+        fileReadCount,
+        fileWriteCount,
+        suggestsSubagent,
+        confidence,
+    };
+}
+/**
+ * Analyze Task() call patterns
+ */
+function analyzeTaskPatterns(content) {
+    const taskCalls = content.match(/Task\s*\([^)]+\)/g) || [];
+    const taskCallCount = taskCalls.length;
+    const sequentialCalls = countSequentialTaskCalls(content);
+    const canBatch = sequentialCalls >= THRESHOLDS.sequentialTaskThreshold;
+    const batchSavingsPercent = calculateBatchSavings(sequentialCalls);
+    return {
+        taskCallCount,
+        sequentialCalls,
+        canBatch,
+        batchSavingsPercent,
+    };
+}
+/**
+ * Find sections that could be extracted as sub-skills
+ */
+function findExtractableSections(sections, totalLines) {
+    const extractable = [];
+    for (const section of sections) {
+        const lineCount = section.endLine - section.startLine + 1;
+        // Skip small sections
+        if (lineCount < THRESHOLDS.minSectionLines) {
+            continue;
+        }
+        const priority = calculateExtractionPriority(lineCount, totalLines);
+        const reason = getExtractionReason(section.name, lineCount);
+        extractable.push({
+            name: section.name,
+            startLine: section.startLine,
+            endLine: section.endLine,
+            lineCount,
+            priority,
+            reason,
+        });
+    }
+    // Sort by priority
+    return extractable.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Generate optimization recommendations
+ */
+function generateRecommendations(lineCount, examplesLines, toolUsage, taskPatterns, extractableSections) {
+    const recommendations = [];
+    // Recommend decomposition for large skills
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        const sectionNames = extractableSections.slice(0, 3).map((s) => s.name);
+        recommendations.push({
+            type: 'decompose',
+            description: `Skill has ${lineCount} lines (threshold: ${THRESHOLDS.maxLinesBeforeDecompose}). Decompose into main SKILL.md + sub-skills.`,
+            estimatedSavings: Math.min(70, Math.floor((lineCount - 400) / 10)),
+            priority: 1,
+            affectedAreas: sectionNames.length > 0 ? sectionNames : ['full-content'],
+        });
+    }
+    // Recommend subagent for heavy tool usage
+    if (toolUsage.suggestsSubagent) {
+        recommendations.push({
+            type: 'subagent',
+            description: `Heavy tool usage detected (${toolUsage.bashCommandCount} bash, ${toolUsage.fileReadCount} reads). Generate companion subagent for context isolation.`,
+            estimatedSavings: 40,
+            priority: 2,
+            affectedAreas: toolUsage.detectedTools,
+        });
+    }
+    // Recommend parallelization for sequential Task() calls
+    if (taskPatterns.canBatch) {
+        recommendations.push({
+            type: 'parallelize',
+            description: `${taskPatterns.sequentialCalls} sequential Task() calls detected. Batch into single message for parallel execution.`,
+            estimatedSavings: taskPatterns.batchSavingsPercent,
+            priority: 2,
+            affectedAreas: ['Task-calls'],
+        });
+    }
+    // Recommend progressive disclosure for large examples
+    if (examplesLines > THRESHOLDS.largeExamplesThreshold) {
+        recommendations.push({
+            type: 'progressive-disclosure',
+            description: `Large examples section (${examplesLines} lines). Move to sub-skill for on-demand loading.`,
+            estimatedSavings: Math.min(60, Math.floor(examplesLines / 5)),
+            priority: 3,
+            affectedAreas: ['examples'],
+        });
+    }
+    // Sort by priority
+    return recommendations.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Calculate overall optimization score
+ */
+function calculateOptimizationScore(lineCount, toolUsage, taskPatterns, recommendations) {
+    let score = 0;
+    // Line count factor (0-40 points)
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        score += Math.min(40, Math.floor((lineCount - 400) / 10));
+    }
+    else if (lineCount > 300) {
+        score += Math.floor((lineCount - 300) / 20);
+    }
+    // Tool usage factor (0-30 points)
+    if (toolUsage.suggestsSubagent) {
+        score += 20;
+    }
+    score += Math.min(10, toolUsage.detectedTools.length * 2);
+    // Task pattern factor (0-20 points)
+    if (taskPatterns.canBatch) {
+        score += Math.min(20, taskPatterns.sequentialCalls * 5);
+    }
+    // Recommendation impact (0-10 points)
+    score += Math.min(10, recommendations.length * 3);
+    return Math.min(100, score);
+}
+/**
+ * Quick check if a skill needs transformation without full analysis
+ *
+ * @param content - The full SKILL.md content
+ * @returns Whether quick transformation check passed
+ */
+export function quickTransformCheck(content) {
+    const lineCount = content.split('\n').length;
+    // Quick checks that indicate transformation needed
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        return true;
+    }
+    // Check for heavy tool usage patterns
+    const heavyToolPatterns = ['npm ', 'npx ', 'git ', 'docker', 'Bash('];
+    let heavyToolCount = 0;
+    for (const pattern of heavyToolPatterns) {
+        if (content.includes(pattern)) {
+            heavyToolCount++;
+        }
+    }
+    if (heavyToolCount >= 3) {
+        return true;
+    }
+    // Check for sequential Task() calls
+    const taskMatches = content.match(/Task\s*\(/g) || [];
+    if (taskMatches.length >= THRESHOLDS.sequentialTaskThreshold) {
+        return true;
+    }
+    return false;
+}
+export default { analyzeSkill, quickTransformCheck };
+//# sourceMappingURL=SkillAnalyzer.js.map

package/dist/services/SkillAnalyzer.js.map

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

package/dist/services/SkillAnalyzer.types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * SMI-1788: SkillAnalyzer Types
+ *
+ * Type definitions for skill analysis and optimization detection.
+ * Used by the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+/**
+ * Analysis result for a skill's optimization potential
+ */
+export interface SkillAnalysis {
+    /** Total line count of the skill content */
+    lineCount: number;
+    /** Number of lines in the main content (excluding examples) */
+    mainContentLines: number;
+    /** Number of lines in examples section */
+    examplesLines: number;
+    /** Tools detected in the skill content */
+    toolUsage: ToolUsageAnalysis;
+    /** Task() call patterns detected */
+    taskPatterns: TaskPatternAnalysis;
+    /** Sections that could be extracted as sub-skills */
+    extractableSections: ExtractableSection[];
+    /** Recommended optimizations to apply */
+    recommendations: OptimizationRecommendation[];
+    /** Overall optimization score (0-100) */
+    optimizationScore: number;
+    /** Whether this skill would benefit from transformation */
+    shouldTransform: boolean;
+}
+/**
+ * Tool usage analysis result
+ */
+export interface ToolUsageAnalysis {
+    /** List of detected tools */
+    detectedTools: string[];
+    /** Number of Bash commands detected */
+    bashCommandCount: number;
+    /** Number of file reads detected (Read/Glob/Grep) */
+    fileReadCount: number;
+    /** Number of file writes detected (Write/Edit) */
+    fileWriteCount: number;
+    /** Whether heavy tool usage suggests subagent */
+    suggestsSubagent: boolean;
+    /** Confidence in tool detection */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Task() call pattern analysis
+ */
+export interface TaskPatternAnalysis {
+    /** Total number of Task() calls detected */
+    taskCallCount: number;
+    /** Number of sequential Task() calls that could be parallelized */
+    sequentialCalls: number;
+    /** Whether Task() calls can be batched */
+    canBatch: boolean;
+    /** Estimated token savings from batching (percentage) */
+    batchSavingsPercent: number;
+}
+/**
+ * Section that could be extracted as a sub-skill
+ */
+export interface ExtractableSection {
+    /** Section name/title */
+    name: string;
+    /** Start line number */
+    startLine: number;
+    /** End line number */
+    endLine: number;
+    /** Number of lines */
+    lineCount: number;
+    /** Extraction priority (1 = highest) */
+    priority: number;
+    /** Reason for extraction recommendation */
+    reason: string;
+}
+/**
+ * Optimization recommendation
+ */
+export interface OptimizationRecommendation {
+    /** Recommendation type */
+    type: 'decompose' | 'parallelize' | 'subagent' | 'progressive-disclosure';
+    /** Human-readable description */
+    description: string;
+    /** Estimated token savings (percentage) */
+    estimatedSavings: number;
+    /** Priority (1 = highest) */
+    priority: number;
+    /** Affected sections or patterns */
+    affectedAreas: string[];
+}
+/**
+ * Parsed section from skill content
+ */
+export interface ParsedSection {
+    /** Section name/title */
+    name: string;
+    /** Start line number */
+    startLine: number;
+    /** End line number */
+    endLine: number;
+    /** Full section content */
+    content: string;
+}
+/**
+ * Confidence level type
+ */
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+//# sourceMappingURL=SkillAnalyzer.types.d.ts.map

package/dist/services/SkillAnalyzer.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAnalyzer.types.d.ts","sourceRoot":"","sources":["../../src/services/SkillAnalyzer.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IAEjB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAA;IAExB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAA;IAErB,0CAA0C;IAC1C,SAAS,EAAE,iBAAiB,CAAA;IAE5B,oCAAoC;IACpC,YAAY,EAAE,mBAAmB,CAAA;IAEjC,qDAAqD;IACrD,mBAAmB,EAAE,kBAAkB,EAAE,CAAA;IAEzC,yCAAyC;IACzC,eAAe,EAAE,0BAA0B,EAAE,CAAA;IAE7C,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IAEzB,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAA;IAEvB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAA;IAExB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAA;IAErB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAA;IAEtB,iDAAiD;IACjD,gBAAgB,EAAE,OAAO,CAAA;IAEzB,mCAAmC;IACnC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAA;IAErB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAA;IAEvB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAA;IAEjB,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IAEZ,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAA;IAEjB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAA;IAEf,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAA;IAEjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAEhB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,wBAAwB,CAAA;IAEzE,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IAEnB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAA;IAExB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAEhB,oCAAoC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IAEZ,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAA;IAEjB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAA;IAEf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA"}

package/dist/services/SkillAnalyzer.types.js

@@ -0,0 +1,9 @@
+/**
+ * SMI-1788: SkillAnalyzer Types
+ *
+ * Type definitions for skill analysis and optimization detection.
+ * Used by the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+export {};
+//# sourceMappingURL=SkillAnalyzer.types.js.map

package/dist/services/SkillAnalyzer.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAnalyzer.types.js","sourceRoot":"","sources":["../../src/services/SkillAnalyzer.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}