@skillsmith/core 0.4.0 → 0.4.2

package/dist/src/services/TransformationService.js

@@ -0,0 +1,315 @@
+/**
+ * SMI-1788: TransformationService - Orchestrate skill optimization pipeline
+ *
+ * The central service for transforming community skills into optimized versions.
+ * Coordinates the full pipeline:
+ * 1. SkillAnalyzer - Analyze skill for optimization patterns
+ * 2. SkillDecomposer - Decompose large skills into sub-skills
+ * 3. SubagentGenerator - Generate companion subagent definitions
+ * 4. Caching - Cache transformed skills for reuse
+ *
+ * Implements the hybrid approach:
+ * - Hot skills (>100 installs): Pre-transformed, cached
+ * - Warm skills (10-100 installs): JIT on first install, cached
+ * - Cold skills (<10 installs): JIT on demand, short TTL
+ *
+ * Part of the Skillsmith Optimization Layer.
+ */
+import { createHash } from 'crypto';
+import { CacheRepository } from '../repositories/CacheRepository.js';
+import { analyzeSkill, quickTransformCheck } from './SkillAnalyzer.js';
+import { decomposeSkill, parallelizeTaskCalls, } from './SkillDecomposer.js';
+import { generateSubagent, } from './SubagentGenerator.js';
+const DEFAULT_OPTIONS = {
+    cacheTtl: 3600, // 1 hour
+    enableCache: true,
+    forceTransform: false,
+    version: '1.0.0',
+};
+/**
+ * SMI-1791: Maximum content length to process (2MB)
+ * Prevents DoS from extremely large inputs
+ */
+const MAX_CONTENT_LENGTH = 2 * 1024 * 1024;
+/** Cache key prefix for transformed skills */
+const CACHE_KEY_PREFIX = 'transform:';
+/** Attribution text added to optimized skills */
+const ATTRIBUTION = '\n\n---\n\n*Optimized by Skillsmith - Token usage reduced through intelligent decomposition*';
+/**
+ * TransformationService orchestrates the skill optimization pipeline
+ */
+export class TransformationService {
+    cache;
+    options;
+    /**
+     * Create a new TransformationService
+     *
+     * @param db - Database connection (optional, for caching)
+     * @param options - Service configuration
+     */
+    constructor(db, options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.cache = db && this.options.enableCache ? new CacheRepository(db) : null;
+    }
+    /**
+     * Transform a skill through the full optimization pipeline
+     *
+     * @param skillId - Unique identifier for the skill (for caching)
+     * @param skillName - Human-readable skill name
+     * @param description - Skill description
+     * @param content - The full SKILL.md content
+     * @returns Transformation result
+     */
+    async transform(skillId, skillName, description, content) {
+        const startTime = Date.now();
+        // SMI-1791: Validate content length to prevent DoS
+        if (content.length > MAX_CONTENT_LENGTH) {
+            throw new Error(`Content exceeds maximum length of ${MAX_CONTENT_LENGTH} bytes (got ${content.length})`);
+        }
+        // Check cache first (unless force transform)
+        if (!this.options.forceTransform && this.cache) {
+            const cached = this.getCachedTransformation(skillId, content);
+            if (cached) {
+                return cached;
+            }
+        }
+        // Quick check if transformation is needed
+        if (!quickTransformCheck(content)) {
+            // Still add attribution but skip full transformation
+            const result = this.createMinimalResult(content, startTime);
+            // Cache the result
+            if (this.cache) {
+                this.cacheTransformation(skillId, content, result);
+            }
+            return result;
+        }
+        // Full analysis
+        const analysis = analyzeSkill(content);
+        // Apply transformations
+        let transformedContent = content;
+        // 1. Parallelize Task() calls
+        let tasksParallelized = false;
+        if (analysis.taskPatterns.canBatch) {
+            transformedContent = parallelizeTaskCalls(transformedContent);
+            tasksParallelized = true;
+        }
+        // 2. Decompose if needed
+        const decomposition = decomposeSkill(transformedContent, analysis);
+        // 3. Generate subagent if beneficial
+        const subagentResult = generateSubagent(skillName, description, content, analysis);
+        // Build result
+        const result = this.buildResult(decomposition, subagentResult, analysis, tasksParallelized, startTime);
+        // Cache the result
+        if (this.cache) {
+            this.cacheTransformation(skillId, content, result);
+        }
+        return result;
+    }
+    /**
+     * Transform without caching (for testing or one-off transforms)
+     *
+     * SMI-1798: Note that this is NOT a synchronous I/O operation - the name
+     * indicates it runs without async cache operations.
+     *
+     * @param skillName - Human-readable skill name
+     * @param description - Skill description
+     * @param content - The full SKILL.md content
+     * @returns Transformation result
+     */
+    transformWithoutCache(skillName, description, content) {
+        const startTime = Date.now();
+        // SMI-1791: Validate content length to prevent DoS
+        if (content.length > MAX_CONTENT_LENGTH) {
+            throw new Error(`Content exceeds maximum length of ${MAX_CONTENT_LENGTH} bytes (got ${content.length})`);
+        }
+        // Quick check if transformation is needed
+        if (!quickTransformCheck(content)) {
+            return this.createMinimalResult(content, startTime);
+        }
+        // Full analysis
+        const analysis = analyzeSkill(content);
+        // Apply transformations
+        let transformedContent = content;
+        // 1. Parallelize Task() calls
+        let tasksParallelized = false;
+        if (analysis.taskPatterns.canBatch) {
+            transformedContent = parallelizeTaskCalls(transformedContent);
+            tasksParallelized = true;
+        }
+        // 2. Decompose if needed
+        const decomposition = decomposeSkill(transformedContent, analysis);
+        // 3. Generate subagent if beneficial
+        const subagentResult = generateSubagent(skillName, description, content, analysis);
+        return this.buildResult(decomposition, subagentResult, analysis, tasksParallelized, startTime);
+    }
+    /**
+     * Check if a skill would benefit from transformation without fully transforming
+     *
+     * @param content - The SKILL.md content
+     * @returns Analysis with transformation recommendations
+     */
+    analyze(content) {
+        return analyzeSkill(content);
+    }
+    /**
+     * Get cached transformation if available and valid
+     */
+    getCachedTransformation(skillId, content) {
+        if (!this.cache)
+            return null;
+        try {
+            const cacheKey = this.buildCacheKey(skillId);
+            const cached = this.cache.get(cacheKey);
+            if (!cached)
+                return null;
+            // Validate cache entry
+            const contentHash = this.hashContent(content);
+            if (cached.skillHash !== contentHash) {
+                // Content changed, invalidate cache
+                return null;
+            }
+            if (cached.version !== this.options.version) {
+                // Version mismatch, invalidate cache
+                return null;
+            }
+            return cached.result;
+        }
+        catch (error) {
+            // Log error but continue with fresh transformation
+            console.warn(`Cache read failed for ${skillId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Cache a transformation result
+     */
+    cacheTransformation(skillId, content, result) {
+        if (!this.cache)
+            return;
+        try {
+            const cacheKey = this.buildCacheKey(skillId);
+            const contentHash = this.hashContent(content);
+            const cacheEntry = {
+                result,
+                skillHash: contentHash,
+                cachedAt: new Date().toISOString(),
+                version: this.options.version,
+            };
+            this.cache.set(cacheKey, cacheEntry, this.options.cacheTtl);
+        }
+        catch (error) {
+            // Log error but continue - caching is non-critical
+            console.warn(`Cache write failed for ${skillId}:`, error);
+        }
+    }
+    /**
+     * Build cache key for a skill
+     */
+    buildCacheKey(skillId) {
+        return `${CACHE_KEY_PREFIX}${skillId}`;
+    }
+    /**
+     * SMI-1790: Compute SHA-256 hash for content comparison
+     * Uses cryptographic hash for reliable cache invalidation
+     */
+    hashContent(content) {
+        return createHash('sha256').update(content, 'utf8').digest('hex');
+    }
+    /**
+     * Create minimal result for skills that don't need transformation
+     */
+    createMinimalResult(content, startTime) {
+        const lineCount = content.split('\n').length;
+        // Add attribution if not present
+        let mainSkillContent = content;
+        if (!content.includes('Optimized by Skillsmith')) {
+            mainSkillContent = content.trimEnd() + ATTRIBUTION;
+        }
+        return {
+            transformed: false,
+            mainSkillContent,
+            subSkills: [],
+            stats: {
+                originalLines: lineCount,
+                optimizedLines: mainSkillContent.split('\n').length,
+                subSkillCount: 0,
+                tasksParallelized: false,
+                subagentGenerated: false,
+                tokenReductionPercent: 0,
+                transformDurationMs: Date.now() - startTime,
+            },
+            analysis: analyzeSkill(content),
+            attribution: ATTRIBUTION,
+        };
+    }
+    /**
+     * Build full transformation result
+     */
+    buildResult(decomposition, subagentResult, analysis, tasksParallelized, startTime) {
+        // Calculate token reduction
+        let tokenReductionPercent = decomposition.stats.tokenReductionPercent;
+        // Add savings from subagent context isolation
+        if (subagentResult.generated) {
+            tokenReductionPercent += 20; // Subagent provides ~20% additional savings
+        }
+        // Add savings from task parallelization
+        if (tasksParallelized) {
+            tokenReductionPercent += analysis.taskPatterns.batchSavingsPercent / 2;
+        }
+        // Cap at 80% (realistic maximum)
+        tokenReductionPercent = Math.min(80, Math.round(tokenReductionPercent));
+        return {
+            transformed: decomposition.wasDecomposed || subagentResult.generated || tasksParallelized,
+            mainSkillContent: decomposition.mainSkill.content,
+            subSkills: decomposition.subSkills.map((s) => ({
+                filename: s.filename,
+                content: s.content,
+            })),
+            subagent: subagentResult.subagent,
+            claudeMdSnippet: subagentResult.claudeMdSnippet,
+            stats: {
+                originalLines: decomposition.stats.originalLines,
+                optimizedLines: decomposition.mainSkill.lineCount,
+                subSkillCount: decomposition.subSkills.length,
+                tasksParallelized,
+                subagentGenerated: subagentResult.generated,
+                tokenReductionPercent,
+                transformDurationMs: Date.now() - startTime,
+            },
+            analysis,
+            attribution: ATTRIBUTION,
+        };
+    }
+    /**
+     * Clear transformation cache
+     */
+    clearCache() {
+        if (!this.cache)
+            return 0;
+        return this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            enabled: this.cache !== null,
+            ttl: this.options.cacheTtl,
+            version: this.options.version,
+        };
+    }
+}
+/**
+ * Create a standalone transformation (no caching)
+ *
+ * @param skillName - Human-readable skill name
+ * @param description - Skill description
+ * @param content - The full SKILL.md content
+ * @returns Transformation result
+ */
+export function transformSkill(skillName, description, content) {
+    const service = new TransformationService();
+    return service.transformWithoutCache(skillName, description, content);
+}
+export default TransformationService;
+//# sourceMappingURL=TransformationService.js.map

package/dist/src/services/TransformationService.js.map

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

package/dist/src/services/__tests__/SkillAnalyzer.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tests for SkillAnalyzer service
+ * Part of Skillsmith Optimization Layer
+ */
+export {};
+//# sourceMappingURL=SkillAnalyzer.test.d.ts.map

package/dist/src/services/__tests__/SkillAnalyzer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAnalyzer.test.d.ts","sourceRoot":"","sources":["../../../../src/services/__tests__/SkillAnalyzer.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/services/__tests__/SkillAnalyzer.test.js

@@ -0,0 +1,177 @@
+/**
+ * @fileoverview Tests for SkillAnalyzer service
+ * Part of Skillsmith Optimization Layer
+ */
+import { describe, it, expect } from 'vitest';
+import { analyzeSkill, quickTransformCheck } from '../SkillAnalyzer.js';
+describe('SkillAnalyzer', () => {
+    describe('analyzeSkill', () => {
+        it('should analyze a simple skill with low complexity', () => {
+            const content = `---
+name: simple-skill
+description: A simple skill for testing
+---
+
+# Simple Skill
+
+This is a simple skill with minimal content.
+
+## Usage
+
+Just use it normally.
+`;
+            const analysis = analyzeSkill(content);
+            expect(analysis.lineCount).toBeLessThan(500);
+            expect(analysis.shouldTransform).toBe(false);
+            expect(analysis.optimizationScore).toBeLessThan(30);
+        });
+        it('should detect large skills that need decomposition', () => {
+            // Create a skill with >500 lines
+            const sections = Array(100)
+                .fill(null)
+                .map((_, i) => `## Section ${i}\n\nContent for section ${i}.\n\n`.repeat(5))
+                .join('\n');
+            const content = `---
+name: large-skill
+description: A large skill that needs decomposition
+---
+
+# Large Skill
+
+${sections}
+`;
+            const analysis = analyzeSkill(content);
+            expect(analysis.lineCount).toBeGreaterThan(500);
+            expect(analysis.shouldTransform).toBe(true);
+            expect(analysis.recommendations.some((r) => r.type === 'decompose')).toBe(true);
+        });
+        it('should detect heavy tool usage suggesting subagent', () => {
+            const content = `---
+name: tool-heavy-skill
+description: A skill with heavy tool usage
+---
+
+# Tool Heavy Skill
+
+This skill uses many tools:
+- Run npm install
+- Execute git commands
+- Run docker build
+- Use npx to execute
+- Run yarn commands
+- Use pnpm for package management
+
+## Commands
+
+bash: npm run build
+bash: git status
+bash: docker compose up
+`;
+            const analysis = analyzeSkill(content);
+            expect(analysis.toolUsage.detectedTools).toContain('Bash');
+            expect(analysis.toolUsage.suggestsSubagent).toBe(true);
+            expect(analysis.recommendations.some((r) => r.type === 'subagent')).toBe(true);
+        });
+        it('should detect sequential Task() calls that can be parallelized', () => {
+            const content = `---
+name: task-skill
+description: A skill with sequential Task() calls
+---
+
+# Task Skill
+
+## Execution
+
+\`\`\`javascript
+Task("agent1", "do task 1")
+Task("agent2", "do task 2")
+Task("agent3", "do task 3")
+\`\`\`
+
+These tasks are independent and can run in parallel.
+`;
+            const analysis = analyzeSkill(content);
+            expect(analysis.taskPatterns.taskCallCount).toBeGreaterThanOrEqual(3);
+            expect(analysis.taskPatterns.canBatch).toBe(true);
+            expect(analysis.recommendations.some((r) => r.type === 'parallelize')).toBe(true);
+        });
+        it('should identify extractable sections', () => {
+            // Create content with large API reference section
+            const apiSection = Array(60).fill('- endpoint: /api/v1/resource').join('\n');
+            const content = `---
+name: api-skill
+description: A skill with large API reference
+---
+
+# API Skill
+
+## Overview
+
+Quick overview here.
+
+## API Reference
+
+${apiSection}
+
+## Examples
+
+Some examples here.
+`;
+            const analysis = analyzeSkill(content);
+            expect(analysis.extractableSections.length).toBeGreaterThan(0);
+            expect(analysis.extractableSections.some((s) => s.name.toLowerCase().includes('api') || s.name.toLowerCase().includes('reference'))).toBe(true);
+        });
+        it('should calculate optimization score based on multiple factors', () => {
+            // Skill with multiple optimization opportunities
+            const content = `---
+name: complex-skill
+description: A complex skill with multiple optimization opportunities
+---
+
+# Complex Skill
+
+This skill has multiple areas for optimization.
+
+## Heavy Commands
+
+Run npm install
+Run npx something
+Run git commands
+Run docker build
+Run yarn add
+Use bash terminal
+
+## Large Examples Section
+
+${'Example code here.\n'.repeat(250)}
+
+## API Reference
+
+${Array(60).fill('- endpoint').join('\n')}
+`;
+            const analysis = analyzeSkill(content);
+            // Score should reflect multiple optimization opportunities
+            expect(analysis.optimizationScore).toBeGreaterThan(20);
+            expect(analysis.recommendations.length).toBeGreaterThan(0);
+        });
+    });
+    describe('quickTransformCheck', () => {
+        it('should return false for small, simple skills', () => {
+            const content = `# Simple Skill\n\nJust a simple skill.`;
+            expect(quickTransformCheck(content)).toBe(false);
+        });
+        it('should return true for skills with >500 lines', () => {
+            const content = Array(600).fill('line content').join('\n');
+            expect(quickTransformCheck(content)).toBe(true);
+        });
+        it('should return true for skills with heavy tool patterns', () => {
+            const content = `# Skill\n\nnpm install\ngit status\ndocker build`;
+            expect(quickTransformCheck(content)).toBe(true);
+        });
+        it('should return true for skills with multiple Task() calls', () => {
+            const content = `# Skill\n\nTask("a", "b")\nTask("c", "d")`;
+            expect(quickTransformCheck(content)).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=SkillAnalyzer.test.js.map

package/dist/src/services/__tests__/SkillAnalyzer.test.js.map

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

package/dist/src/services/__tests__/SkillDecomposer.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tests for SkillDecomposer service
+ * Part of Skillsmith Optimization Layer
+ */
+export {};
+//# sourceMappingURL=SkillDecomposer.test.d.ts.map

package/dist/src/services/__tests__/SkillDecomposer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDecomposer.test.d.ts","sourceRoot":"","sources":["../../../../src/services/__tests__/SkillDecomposer.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}