@skillsmith/core 0.4.0 → 0.4.1

package/dist/src/services/SubagentGenerator.js

@@ -0,0 +1,319 @@
+/**
+ * SMI-XXX: SubagentGenerator - Generate companion subagent definitions
+ *
+ * Creates subagent definitions for skills that benefit from parallel
+ * execution with context isolation. Subagents enable:
+ * - 37-97% token savings through context isolation
+ * - Parallel execution of heavy operations
+ * - Specialized tool access per agent
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+/**
+ * Tool detection patterns for analyzing skill content
+ */
+const TOOL_PATTERNS = {
+    Read: {
+        patterns: ['read file', 'read the', 'examine', 'view file', 'Read tool', 'check file'],
+        priority: 1,
+    },
+    Write: {
+        patterns: ['write file', 'create file', 'save to', 'output to', 'Write tool', 'generate file'],
+        priority: 2,
+    },
+    Edit: {
+        patterns: [
+            'edit file',
+            'modify',
+            'update file',
+            'patch',
+            'Edit tool',
+            'change file',
+            'refactor',
+        ],
+        priority: 2,
+    },
+    Bash: {
+        patterns: [
+            'bash',
+            'npm',
+            'npx',
+            'git',
+            'docker',
+            'yarn',
+            'pnpm',
+            'terminal',
+            'shell',
+            'command',
+        ],
+        priority: 3,
+    },
+    Grep: {
+        patterns: ['grep', 'search for', 'find text', 'pattern match', 'Grep tool', 'search in'],
+        priority: 1,
+    },
+    Glob: {
+        patterns: ['glob', 'find file', 'file pattern', 'list files', 'Glob tool', 'locate'],
+        priority: 1,
+    },
+    WebFetch: {
+        patterns: ['fetch', 'http', 'api call', 'url', 'WebFetch', 'download', 'request'],
+        priority: 2,
+    },
+    WebSearch: {
+        patterns: ['web search', 'search online', 'lookup online', 'WebSearch', 'search the web'],
+        priority: 2,
+    },
+};
+/**
+ * Minimum tools that most subagents need
+ */
+const BASE_TOOLS = ['Read'];
+/**
+ * Generate tool usage guidelines for a subagent
+ */
+function generateToolGuidelines(tools) {
+    const guidelines = [];
+    if (tools.includes('Read')) {
+        guidelines.push('- **Read**: Use to examine files before modifications');
+    }
+    if (tools.includes('Write')) {
+        guidelines.push('- **Write**: Use for creating new files only');
+    }
+    if (tools.includes('Edit')) {
+        guidelines.push('- **Edit**: Use for modifying existing files');
+    }
+    if (tools.includes('Bash')) {
+        guidelines.push('- **Bash**: Use for command execution, prefer non-destructive commands');
+    }
+    if (tools.includes('Grep')) {
+        guidelines.push('- **Grep**: Use for searching file contents');
+    }
+    if (tools.includes('Glob')) {
+        guidelines.push('- **Glob**: Use for finding files by pattern');
+    }
+    if (tools.includes('WebFetch')) {
+        guidelines.push('- **WebFetch**: Use for fetching web content');
+    }
+    if (tools.includes('WebSearch')) {
+        guidelines.push('- **WebSearch**: Use for searching the web');
+    }
+    return guidelines.length > 0 ? guidelines.join('\n') : '- Use tools minimally and efficiently';
+}
+/**
+ * Generate subagent markdown content
+ */
+function generateSubagentContent(name, description, triggerPhrases, tools, model) {
+    const triggerString = triggerPhrases.length > 0
+        ? triggerPhrases.map((p) => `"${p}"`).join(', ')
+        : '[describe trigger conditions]';
+    const toolGuidelines = generateToolGuidelines(tools);
+    return `---
+name: ${name}
+description: ${description} Use when ${triggerString}.
+skills: ${name.replace('-specialist', '')}
+tools: ${tools.join(', ')}
+model: ${model}
+---
+
+## Operating Protocol
+
+1. Execute the ${name.replace('-specialist', '')} skill for the delegated task
+2. Process all intermediate results internally
+3. Return ONLY a structured summary to the orchestrator
+
+## Output Format
+
+- **Task:** [what was requested]
+- **Actions:** [what you did]
+- **Results:** [key outcomes, max 3-5 bullet points]
+- **Artifacts:** [file paths or outputs created]
+
+Keep response under 500 tokens unless explicitly requested otherwise.
+
+## Tool Usage Guidelines
+
+${toolGuidelines}
+
+## Error Handling
+
+If the task cannot be completed:
+- Report specific blocking issue
+- Suggest alternative approaches
+- Do not retry indefinitely
+
+---
+
+*Generated by Skillsmith Optimization Layer*
+`;
+}
+/**
+ * Generate CLAUDE.md integration snippet
+ */
+function generateClaudeMdSnippet(skillName, description, triggerPhrases, tools, model) {
+    const triggerPatterns = triggerPhrases.length > 0
+        ? triggerPhrases.map((p) => `- "${p}"`).join('\n')
+        : '- [add trigger patterns]';
+    const exampleTask = triggerPhrases.length > 0 ? triggerPhrases[0] : `execute ${skillName} task`;
+    return `
+### Subagent Delegation: ${skillName}
+
+When tasks match ${skillName} triggers, delegate to the ${skillName}-specialist
+subagent instead of executing directly. This provides context isolation and
+~37-97% token savings.
+
+**Trigger Patterns:**
+${triggerPatterns}
+
+**Delegation Example:**
+\`\`\`
+Task("${skillName}-specialist", "${exampleTask}", "${skillName}-specialist")
+\`\`\`
+
+**Model:** ${model}
+**Tools:** ${tools.join(', ')}
+`;
+}
+/**
+ * Extract trigger phrases from skill description and content
+ */
+function extractTriggerPhrases(description, content) {
+    const phrases = [];
+    // Common trigger phrase patterns
+    const patterns = [
+        /when\s+(?:you\s+)?(?:need\s+to\s+)?(.+?)(?:[.,]|$)/gi,
+        /use\s+(?:this\s+)?(?:when|for)\s+(.+?)(?:[.,]|$)/gi,
+        /(?:helps?\s+(?:you\s+)?(?:to\s+)?)?(.+?)(?:\s+tasks?|\s+operations?)/gi,
+    ];
+    const textToSearch = description + ' ' + content.slice(0, 2000); // Search first 2000 chars
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(textToSearch)) !== null) {
+            const phrase = match[1].trim().toLowerCase();
+            if (phrase.length >= 5 && phrase.length <= 50 && !phrases.includes(phrase)) {
+                phrases.push(phrase);
+            }
+        }
+    }
+    // Extract from "trigger" or "invoke" mentions
+    const triggerMatch = content.match(/trigger[s]?\s*[:=]\s*["`']([^"`']+)["`']/gi);
+    if (triggerMatch) {
+        for (const match of triggerMatch) {
+            const phrase = match.replace(/trigger[s]?\s*[:=]\s*["`']/i, '').replace(/["`']$/, '');
+            if (!phrases.includes(phrase.toLowerCase())) {
+                phrases.push(phrase.toLowerCase());
+            }
+        }
+    }
+    return phrases.slice(0, 5); // Limit to 5 phrases
+}
+/**
+ * Determine optimal model for subagent
+ */
+function determineModel(toolUsage, lineCount) {
+    // Haiku for simple, fast operations
+    if (toolUsage.detectedTools.length <= 2 && lineCount < 200) {
+        return 'haiku';
+    }
+    // Opus for complex, reasoning-heavy tasks
+    if (toolUsage.bashCommandCount > 5 ||
+        (toolUsage.fileReadCount > 3 && toolUsage.fileWriteCount > 3)) {
+        return 'opus';
+    }
+    // Sonnet for balanced workloads (default)
+    return 'sonnet';
+}
+/**
+ * Detect tools needed from skill content
+ */
+function detectTools(content) {
+    const lowerContent = content.toLowerCase();
+    const detectedTools = new Set(BASE_TOOLS);
+    for (const [tool, config] of Object.entries(TOOL_PATTERNS)) {
+        for (const pattern of config.patterns) {
+            if (lowerContent.includes(pattern.toLowerCase())) {
+                detectedTools.add(tool);
+                break;
+            }
+        }
+    }
+    return Array.from(detectedTools);
+}
+/**
+ * Generate a companion subagent for a skill
+ *
+ * @param skillName - The name of the skill
+ * @param description - The skill's description
+ * @param content - The full SKILL.md content
+ * @param analysis - Analysis from SkillAnalyzer
+ * @returns Subagent generation result
+ */
+export function generateSubagent(skillName, description, content, analysis) {
+    // Check if subagent is recommended
+    if (!analysis.toolUsage.suggestsSubagent && analysis.lineCount < 300) {
+        return {
+            generated: false,
+            reason: 'Skill does not have heavy tool usage or complexity that would benefit from a subagent',
+        };
+    }
+    // Detect tools from content (supplement analysis)
+    const detectedTools = detectTools(content);
+    const allTools = Array.from(new Set([...analysis.toolUsage.detectedTools, ...detectedTools]));
+    // Extract trigger phrases
+    const triggerPhrases = extractTriggerPhrases(description, content);
+    // Determine model
+    const model = determineModel(analysis.toolUsage, analysis.lineCount);
+    // Generate subagent name
+    const subagentName = `${skillName}-specialist`;
+    // Generate subagent description
+    const subagentDescription = description || `Specialist agent for ${skillName} operations`;
+    // Generate content
+    const subagentContent = generateSubagentContent(subagentName, subagentDescription, triggerPhrases, allTools, model);
+    // Generate CLAUDE.md snippet
+    const claudeMdSnippet = generateClaudeMdSnippet(skillName, subagentDescription, triggerPhrases, allTools, model);
+    return {
+        generated: true,
+        subagent: {
+            name: subagentName,
+            description: subagentDescription,
+            triggerPhrases,
+            tools: allTools,
+            model,
+            content: subagentContent,
+        },
+        claudeMdSnippet,
+    };
+}
+/**
+ * Generate a minimal subagent for skills that don't need full analysis
+ *
+ * @param skillName - The name of the skill
+ * @param description - The skill's description
+ * @param content - The full SKILL.md content
+ * @returns Subagent generation result
+ */
+export function generateMinimalSubagent(skillName, description, content) {
+    const detectedTools = detectTools(content);
+    const triggerPhrases = extractTriggerPhrases(description, content);
+    // Default to sonnet for minimal subagents
+    const model = 'sonnet';
+    const subagentName = `${skillName}-specialist`;
+    const subagentDescription = description || `Specialist agent for ${skillName} operations`;
+    const subagentContent = generateSubagentContent(subagentName, subagentDescription, triggerPhrases, detectedTools, model);
+    const claudeMdSnippet = generateClaudeMdSnippet(skillName, subagentDescription, triggerPhrases, detectedTools, model);
+    return {
+        generated: true,
+        subagent: {
+            name: subagentName,
+            description: subagentDescription,
+            triggerPhrases,
+            tools: detectedTools,
+            model,
+            content: subagentContent,
+        },
+        claudeMdSnippet,
+    };
+}
+export default { generateSubagent, generateMinimalSubagent };
+//# sourceMappingURL=SubagentGenerator.js.map

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

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

package/dist/src/services/TransformationService.d.ts

@@ -0,0 +1,163 @@
+/**
+ * SMI-XXX: 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 type { Database as DatabaseType } from 'better-sqlite3';
+import { type SkillAnalysis } from './SkillAnalyzer.js';
+import { type SubagentDefinition } from './SubagentGenerator.js';
+/**
+ * Full transformation result for a skill
+ */
+export interface TransformationResult {
+    /** Whether transformation was applied */
+    transformed: boolean;
+    /** The optimized main SKILL.md content */
+    mainSkillContent: string;
+    /** Sub-skills (if decomposed) */
+    subSkills: Array<{
+        filename: string;
+        content: string;
+    }>;
+    /** Companion subagent (if generated) */
+    subagent?: SubagentDefinition;
+    /** CLAUDE.md integration snippet */
+    claudeMdSnippet?: string;
+    /** Transformation statistics */
+    stats: TransformationStats;
+    /** Analysis that informed the transformation */
+    analysis: SkillAnalysis;
+    /** Attribution footer added to content */
+    attribution: string;
+}
+/**
+ * Statistics about the transformation
+ */
+export interface TransformationStats {
+    /** Original content line count */
+    originalLines: number;
+    /** Optimized main skill line count */
+    optimizedLines: number;
+    /** Number of sub-skills extracted */
+    subSkillCount: number;
+    /** Whether Task() calls were parallelized */
+    tasksParallelized: boolean;
+    /** Whether subagent was generated */
+    subagentGenerated: boolean;
+    /** Estimated token reduction percentage */
+    tokenReductionPercent: number;
+    /** Transformation duration in ms */
+    transformDurationMs: number;
+}
+/**
+ * Configuration for TransformationService
+ */
+export interface TransformationServiceOptions {
+    /** Cache TTL in seconds (default: 3600 = 1 hour) */
+    cacheTtl?: number;
+    /** Enable caching (default: true) */
+    enableCache?: boolean;
+    /** Force re-transformation even if cached (default: false) */
+    forceTransform?: boolean;
+    /** Transformation version for cache invalidation */
+    version?: string;
+}
+/**
+ * TransformationService orchestrates the skill optimization pipeline
+ */
+export declare class TransformationService {
+    private cache;
+    private options;
+    /**
+     * Create a new TransformationService
+     *
+     * @param db - Database connection (optional, for caching)
+     * @param options - Service configuration
+     */
+    constructor(db?: DatabaseType, options?: TransformationServiceOptions);
+    /**
+     * 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
+     */
+    transform(skillId: string, skillName: string, description: string, content: string): Promise<TransformationResult>;
+    /**
+     * Quick transform without caching (for testing or one-off transforms)
+     *
+     * @param skillName - Human-readable skill name
+     * @param description - Skill description
+     * @param content - The full SKILL.md content
+     * @returns Transformation result
+     */
+    transformSync(skillName: string, description: string, content: string): TransformationResult;
+    /**
+     * Check if a skill would benefit from transformation without fully transforming
+     *
+     * @param content - The SKILL.md content
+     * @returns Analysis with transformation recommendations
+     */
+    analyze(content: string): SkillAnalysis;
+    /**
+     * Get cached transformation if available and valid
+     */
+    private getCachedTransformation;
+    /**
+     * Cache a transformation result
+     */
+    private cacheTransformation;
+    /**
+     * Build cache key for a skill
+     */
+    private buildCacheKey;
+    /**
+     * Simple hash function for content comparison
+     */
+    private hashContent;
+    /**
+     * Create minimal result for skills that don't need transformation
+     */
+    private createMinimalResult;
+    /**
+     * Build full transformation result
+     */
+    private buildResult;
+    /**
+     * Clear transformation cache
+     */
+    clearCache(): number;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        enabled: boolean;
+        ttl: number;
+        version: string;
+    };
+}
+/**
+ * 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 declare function transformSkill(skillName: string, description: string, content: string): TransformationResult;
+export default TransformationService;
+//# sourceMappingURL=TransformationService.d.ts.map

package/dist/src/services/TransformationService.d.ts.map

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