@skillsmith/core 0.5.4 → 0.5.6

package/dist/services/SkillDecomposer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SMI-1788: SkillDecomposer - Decompose large skills into sub-skills
+ *
+ * Transforms skills >500 lines into a main SKILL.md + sub-skills structure
+ * following the Skillsmith optimization standard:
+ * - Main SKILL.md: <500 lines, contains header + navigation + core content
+ * - Sub-skills: Extracted sections loaded on-demand
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+import type { SkillAnalysis } from './SkillAnalyzer.js';
+export type { DecompositionResult, DecomposedSkill, SubSkill, DecompositionStats, SkillMetadata, DecomposerOptions, } from './SkillDecomposer.types.js';
+import type { DecompositionResult, DecomposerOptions } from './SkillDecomposer.types.js';
+export { DEFAULT_EXTRACT_KEYWORDS, sanitizeFilename } from './SkillDecomposer.helpers.js';
+/**
+ * Decompose a skill into main + sub-skills based on analysis
+ *
+ * @param content - The original SKILL.md content
+ * @param analysis - Analysis from SkillAnalyzer
+ * @param options - Decomposition options
+ * @returns Decomposition result with main skill and sub-skills
+ */
+export declare function decomposeSkill(content: string, analysis: SkillAnalysis, options?: DecomposerOptions): DecompositionResult;
+/**
+ * Parallelize sequential Task() calls in skill content
+ *
+ * @param content - The skill content
+ * @returns Content with Task() calls batched for parallel execution
+ */
+export declare function parallelizeTaskCalls(content: string): string;
+declare const _default: {
+    decomposeSkill: typeof decomposeSkill;
+    parallelizeTaskCalls: typeof parallelizeTaskCalls;
+};
+export default _default;
+//# sourceMappingURL=SkillDecomposer.d.ts.map

package/dist/services/SkillDecomposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDecomposer.d.ts","sourceRoot":"","sources":["../../src/services/SkillDecomposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAexF,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEzF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,mBAAmB,CA6BrB;AAoCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2C5D;;;;;AAED,wBAAuD"}

package/dist/services/SkillDecomposer.helpers.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SMI-1788: SkillDecomposer Helpers
+ *
+ * Helper functions and constants for skill decomposition.
+ */
+import type { DecomposerOptions, ResolvedDecomposerOptions, SkillMetadata, ParsedSection, SubSkill, DecomposedSkill, DecompositionStats } from './SkillDecomposer.types.js';
+import type { ExtractableSection } from './SkillAnalyzer.types.js';
+/**
+ * Default keywords that indicate a section should be extracted as a sub-skill.
+ * These are used when no custom extractKeywords are provided.
+ */
+export declare const DEFAULT_EXTRACT_KEYWORDS: string[];
+/**
+ * Default decomposer options
+ */
+export declare const DEFAULT_OPTIONS: ResolvedDecomposerOptions;
+/**
+ * Merge user options with defaults
+ */
+export declare function resolveOptions(options?: DecomposerOptions): ResolvedDecomposerOptions;
+/**
+ * Parse skill content into metadata, frontmatter, and sections
+ */
+export declare function parseSkillContent(content: string): {
+    metadata: SkillMetadata;
+    frontmatter: string;
+    sections: ParsedSection[];
+};
+/**
+ * Determine which sections should be extracted as sub-skills
+ */
+export declare function determineSectionsToExtract(sections: ParsedSection[], extractableSections: ExtractableSection[], opts: ResolvedDecomposerOptions): ParsedSection[];
+/**
+ * SMI-1794: Sanitize and validate filename for sub-skill
+ * Prevents path traversal and invalid characters
+ */
+export declare function sanitizeFilename(name: string): string;
+/**
+ * Generate a filename for a sub-skill
+ * SMI-1794: Uses sanitized filename to prevent security issues
+ */
+export declare function generateSubSkillFilename(sectionTitle: string): string;
+/**
+ * Format sub-skill content with proper header
+ */
+export declare function formatSubSkillContent(section: ParsedSection, skillName: string): string;
+/**
+ * Create sub-skills from extracted sections
+ */
+export declare function createSubSkills(sections: ParsedSection[], skillName: string): SubSkill[];
+/**
+ * Generate navigation section linking to sub-skills
+ */
+export declare function generateSubSkillNavigation(subSkills: SubSkill[]): string;
+/**
+ * Generate attribution footer
+ */
+export declare function generateAttribution(): string;
+/**
+ * Add attribution to content without decomposition
+ */
+export declare function addAttributionToContent(content: string): string;
+/**
+ * Create the main skill content with remaining sections
+ */
+export declare function createMainSkill(frontmatter: string, allSections: ParsedSection[], extractedSections: ParsedSection[], subSkills: SubSkill[], opts: ResolvedDecomposerOptions): DecomposedSkill;
+/**
+ * Calculate decomposition statistics
+ */
+export declare function calculateStats(originalContent: string, mainSkill: DecomposedSkill, subSkills: SubSkill[]): DecompositionStats;
+/**
+ * Format multiple Task() calls as a batched operation
+ */
+export declare function formatBatchedTasks(tasks: string[]): string[];
+//# sourceMappingURL=SkillDecomposer.helpers.d.ts.map

package/dist/services/SkillDecomposer.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDecomposer.helpers.d.ts","sourceRoot":"","sources":["../../src/services/SkillDecomposer.helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,eAAe,EACf,kBAAkB,EACnB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UASpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,yBAM7B,CAAA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,CAErF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,QAAQ,EAAE,aAAa,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B,CAuEA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EAAE,EACzB,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,IAAI,EAAE,yBAAyB,GAC9B,aAAa,EAAE,CAiCjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CASvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAyBxF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAUxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,aAAa,EAAE,EAC5B,iBAAiB,EAAE,aAAa,EAAE,EAClC,SAAS,EAAE,QAAQ,EAAE,EACrB,IAAI,EAAE,yBAAyB,GAC9B,eAAe,CA2BjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,eAAe,EAC1B,SAAS,EAAE,QAAQ,EAAE,GACpB,kBAAkB,CAkBpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAO5D"}

package/dist/services/SkillDecomposer.helpers.js

@@ -0,0 +1,277 @@
+/**
+ * SMI-1788: SkillDecomposer Helpers
+ *
+ * Helper functions and constants for skill decomposition.
+ */
+/**
+ * Default keywords that indicate a section should be extracted as a sub-skill.
+ * These are used when no custom extractKeywords are provided.
+ */
+export const DEFAULT_EXTRACT_KEYWORDS = [
+    'api',
+    'reference',
+    'example',
+    'usage',
+    'advanced',
+    'configuration',
+    'troubleshoot',
+    'appendix',
+];
+/**
+ * Default decomposer options
+ */
+export const DEFAULT_OPTIONS = {
+    maxMainSkillLines: 400,
+    minExtractableLines: 50,
+    addNavigation: true,
+    addAttribution: true,
+    extractKeywords: DEFAULT_EXTRACT_KEYWORDS,
+};
+/**
+ * Merge user options with defaults
+ */
+export function resolveOptions(options) {
+    return { ...DEFAULT_OPTIONS, ...options };
+}
+/**
+ * Parse skill content into metadata, frontmatter, and sections
+ */
+export function parseSkillContent(content) {
+    const lines = content.split('\n');
+    let frontmatter = '';
+    let contentStart = 0;
+    const metadata = {};
+    // Extract frontmatter
+    if (lines[0]?.trim() === '---') {
+        let frontmatterEnd = -1;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i]?.trim() === '---') {
+                frontmatterEnd = i;
+                break;
+            }
+        }
+        if (frontmatterEnd > 0) {
+            frontmatter = lines.slice(0, frontmatterEnd + 1).join('\n');
+            contentStart = frontmatterEnd + 1;
+            // Parse metadata from frontmatter
+            const yamlContent = lines.slice(1, frontmatterEnd).join('\n');
+            const nameMatch = yamlContent.match(/^name:\s*(.+)$/m);
+            const descMatch = yamlContent.match(/^description:\s*(.+)$/m);
+            if (nameMatch)
+                metadata.name = nameMatch[1].trim();
+            if (descMatch)
+                metadata.description = descMatch[1].trim();
+        }
+    }
+    // Parse sections
+    const sections = [];
+    let currentSection = null;
+    for (let i = contentStart; i < lines.length; i++) {
+        const line = lines[i];
+        const headerMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headerMatch) {
+            // Save previous section
+            if (currentSection) {
+                sections.push(currentSection);
+            }
+            currentSection = {
+                level: headerMatch[1].length,
+                title: headerMatch[2].trim(),
+                startLine: i,
+                lines: [line],
+            };
+        }
+        else if (currentSection) {
+            currentSection.lines.push(line);
+        }
+        else {
+            // Content before first header
+            if (!sections.length && line.trim()) {
+                currentSection = {
+                    level: 0,
+                    title: '_preamble',
+                    startLine: i,
+                    lines: [line],
+                };
+            }
+        }
+    }
+    // Save last section
+    if (currentSection) {
+        sections.push(currentSection);
+    }
+    return { metadata, frontmatter, sections };
+}
+/**
+ * Determine which sections should be extracted as sub-skills
+ */
+export function determineSectionsToExtract(sections, extractableSections, opts) {
+    const toExtract = [];
+    // Create a map of section names from analysis for quick lookup
+    const extractableNames = new Set(extractableSections.map((s) => s.name.toLowerCase()));
+    // Use configurable keywords (defaults provided via DEFAULT_OPTIONS)
+    const keywords = opts.extractKeywords ?? DEFAULT_EXTRACT_KEYWORDS;
+    for (const section of sections) {
+        const lineCount = section.lines.length;
+        const titleLower = section.title.toLowerCase();
+        // Skip preamble and very short sections
+        if (section.title === '_preamble' || lineCount < opts.minExtractableLines) {
+            continue;
+        }
+        // Extract if:
+        // 1. In analysis extractable list
+        // 2. Has extract keyword in title
+        // 3. Is a large section (>100 lines)
+        const shouldExtract = extractableNames.has(titleLower) ||
+            keywords.some((kw) => titleLower.includes(kw)) ||
+            lineCount > 100;
+        if (shouldExtract) {
+            toExtract.push(section);
+        }
+    }
+    return toExtract;
+}
+/**
+ * SMI-1794: Sanitize and validate filename for sub-skill
+ * Prevents path traversal and invalid characters
+ */
+export function sanitizeFilename(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-') // Only allow alphanumeric, dash, underscore
+        .replace(/-+/g, '-') // Collapse multiple dashes
+        .replace(/^-|-$/g, '') // Remove leading/trailing dashes
+        .slice(0, 64) || 'sub-skill'); // Limit length, provide default
+}
+/**
+ * Generate a filename for a sub-skill
+ * SMI-1794: Uses sanitized filename to prevent security issues
+ */
+export function generateSubSkillFilename(sectionTitle) {
+    const slug = sanitizeFilename(sectionTitle);
+    return `${slug}.md`;
+}
+/**
+ * Format sub-skill content with proper header
+ */
+export function formatSubSkillContent(section, skillName) {
+    const header = `---
+parent_skill: ${skillName}
+section: ${section.title}
+---
+
+`;
+    return header + section.lines.join('\n');
+}
+/**
+ * Create sub-skills from extracted sections
+ */
+export function createSubSkills(sections, skillName) {
+    return sections.map((section) => {
+        const filename = generateSubSkillFilename(section.title);
+        const content = formatSubSkillContent(section, skillName);
+        // Determine extraction reason
+        const titleLower = section.title.toLowerCase();
+        let reason = 'Large section suitable for on-demand loading';
+        if (titleLower.includes('api') || titleLower.includes('reference')) {
+            reason = 'API reference loaded on-demand to reduce initial context';
+        }
+        else if (titleLower.includes('example') || titleLower.includes('usage')) {
+            reason = 'Examples progressively disclosed when needed';
+        }
+        else if (titleLower.includes('advanced') || titleLower.includes('configuration')) {
+            reason = 'Advanced content loaded only when required';
+        }
+        return {
+            filename,
+            sectionName: section.title,
+            content,
+            lineCount: content.split('\n').length,
+            extractionReason: reason,
+        };
+    });
+}
+/**
+ * Generate navigation section linking to sub-skills
+ */
+export function generateSubSkillNavigation(subSkills) {
+    const links = subSkills.map((s) => `- [${s.sectionName}](./${s.filename})`).join('\n');
+    return `## Additional Resources
+
+The following sections are available as sub-skills for on-demand loading:
+
+${links}
+
+*Load these sections only when needed to optimize context usage.*`;
+}
+/**
+ * Generate attribution footer
+ */
+export function generateAttribution() {
+    return `---
+
+*Optimized by Skillsmith - Token usage reduced through intelligent decomposition*`;
+}
+/**
+ * Add attribution to content without decomposition
+ */
+export function addAttributionToContent(content) {
+    return content.trimEnd() + '\n\n' + generateAttribution();
+}
+/**
+ * Create the main skill content with remaining sections
+ */
+export function createMainSkill(frontmatter, allSections, extractedSections, subSkills, opts) {
+    const extractedTitles = new Set(extractedSections.map((s) => s.title));
+    // Build main content from non-extracted sections
+    const remainingSections = allSections.filter((s) => !extractedTitles.has(s.title));
+    let mainContent = remainingSections.map((s) => s.lines.join('\n')).join('\n\n');
+    // Add navigation to sub-skills if enabled
+    if (opts.addNavigation && subSkills.length > 0) {
+        const nav = generateSubSkillNavigation(subSkills);
+        mainContent = mainContent + '\n\n' + nav;
+    }
+    // Add attribution if enabled
+    if (opts.addAttribution) {
+        mainContent = mainContent + '\n\n' + generateAttribution();
+    }
+    // Combine frontmatter and content
+    const finalContent = frontmatter ? frontmatter + '\n\n' + mainContent : mainContent;
+    return {
+        filename: 'SKILL.md',
+        content: finalContent.trim(),
+        lineCount: finalContent.split('\n').length,
+        subSkillRefs: subSkills.map((s) => s.filename),
+    };
+}
+/**
+ * Calculate decomposition statistics
+ */
+export function calculateStats(originalContent, mainSkill, subSkills) {
+    const originalLines = originalContent.split('\n').length;
+    const mainSkillLines = mainSkill.lineCount;
+    const subSkillLines = subSkills.reduce((sum, s) => sum + s.lineCount, 0);
+    // Estimate token reduction
+    // Main skill is always loaded; sub-skills are loaded on-demand
+    // Assume 50% of sub-skill content would have been needed on average
+    const effectiveReduction = subSkillLines * 0.5;
+    const tokenReductionPercent = Math.round((effectiveReduction / originalLines) * 100);
+    return {
+        originalLines,
+        mainSkillLines,
+        subSkillLines,
+        subSkillCount: subSkills.length,
+        tokenReductionPercent,
+    };
+}
+/**
+ * Format multiple Task() calls as a batched operation
+ */
+export function formatBatchedTasks(tasks) {
+    if (tasks.length < 2) {
+        return tasks;
+    }
+    // Add comment about batching
+    return ['// Batched for parallel execution (Skillsmith optimization)', ...tasks];
+}
+//# sourceMappingURL=SkillDecomposer.helpers.js.map

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

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

package/dist/services/SkillDecomposer.js

@@ -0,0 +1,116 @@
+/**
+ * SMI-1788: SkillDecomposer - Decompose large skills into sub-skills
+ *
+ * Transforms skills >500 lines into a main SKILL.md + sub-skills structure
+ * following the Skillsmith optimization standard:
+ * - Main SKILL.md: <500 lines, contains header + navigation + core content
+ * - Sub-skills: Extracted sections loaded on-demand
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+import { resolveOptions, parseSkillContent, determineSectionsToExtract, createSubSkills, createMainSkill, calculateStats, addAttributionToContent, formatBatchedTasks, } from './SkillDecomposer.helpers.js';
+// Re-export helpers for testing and advanced usage
+export { DEFAULT_EXTRACT_KEYWORDS, sanitizeFilename } from './SkillDecomposer.helpers.js';
+/**
+ * Decompose a skill into main + sub-skills based on analysis
+ *
+ * @param content - The original SKILL.md content
+ * @param analysis - Analysis from SkillAnalyzer
+ * @param options - Decomposition options
+ * @returns Decomposition result with main skill and sub-skills
+ */
+export function decomposeSkill(content, analysis, options) {
+    const opts = resolveOptions(options);
+    // If skill doesn't need decomposition, return as-is with attribution
+    if (!analysis.shouldTransform || analysis.lineCount <= opts.maxMainSkillLines) {
+        return createNonDecomposedResult(content, analysis, opts);
+    }
+    // Parse the skill content
+    const { metadata, sections, frontmatter } = parseSkillContent(content);
+    // Determine which sections to extract
+    const sectionsToExtract = determineSectionsToExtract(sections, analysis.extractableSections, opts);
+    // Create sub-skills from extracted sections
+    const subSkills = createSubSkills(sectionsToExtract, metadata.name || 'skill');
+    // Create the main skill with remaining content
+    const mainSkill = createMainSkill(frontmatter, sections, sectionsToExtract, subSkills, opts);
+    // Calculate statistics
+    const stats = calculateStats(content, mainSkill, subSkills);
+    return {
+        mainSkill,
+        subSkills,
+        wasDecomposed: true,
+        stats,
+    };
+}
+/**
+ * Create result for skills that don't need decomposition
+ */
+function createNonDecomposedResult(content, analysis, opts) {
+    let finalContent = content;
+    // Add attribution if enabled
+    if (opts.addAttribution && !content.includes('Optimized by Skillsmith')) {
+        finalContent = addAttributionToContent(content);
+    }
+    return {
+        mainSkill: {
+            filename: 'SKILL.md',
+            content: finalContent,
+            lineCount: finalContent.split('\n').length,
+            subSkillRefs: [],
+        },
+        subSkills: [],
+        wasDecomposed: false,
+        stats: {
+            originalLines: analysis.lineCount,
+            mainSkillLines: finalContent.split('\n').length,
+            subSkillLines: 0,
+            subSkillCount: 0,
+            tokenReductionPercent: 0,
+        },
+    };
+}
+/**
+ * Parallelize sequential Task() calls in skill content
+ *
+ * @param content - The skill content
+ * @returns Content with Task() calls batched for parallel execution
+ */
+export function parallelizeTaskCalls(content) {
+    const lines = content.split('\n');
+    const result = [];
+    const taskBuffer = [];
+    let inCodeBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Track code blocks
+        if (line.trim().startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            // Flush task buffer before code blocks
+            if (taskBuffer.length > 0) {
+                result.push(...formatBatchedTasks(taskBuffer));
+                taskBuffer.length = 0;
+            }
+            result.push(line);
+            continue;
+        }
+        // In code blocks, look for sequential Task() calls
+        if (inCodeBlock && line.includes('Task(')) {
+            taskBuffer.push(line);
+            continue;
+        }
+        // Flush task buffer when we hit a non-Task line in code block
+        if (inCodeBlock && taskBuffer.length > 0 && !line.includes('Task(')) {
+            result.push(...formatBatchedTasks(taskBuffer));
+            taskBuffer.length = 0;
+        }
+        result.push(line);
+    }
+    // Flush any remaining tasks
+    if (taskBuffer.length > 0) {
+        result.push(...formatBatchedTasks(taskBuffer));
+    }
+    return result.join('\n');
+}
+export default { decomposeSkill, parallelizeTaskCalls };
+//# sourceMappingURL=SkillDecomposer.js.map

package/dist/services/SkillDecomposer.js.map

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

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

@@ -0,0 +1,104 @@
+/**
+ * SMI-1788: SkillDecomposer Types
+ *
+ * Type definitions for skill decomposition into sub-skills.
+ * Used by the Skillsmith Optimization Layer for transforming
+ * large skills into more performant versions.
+ */
+/**
+ * Result of skill decomposition
+ */
+export interface DecompositionResult {
+    /** The optimized main SKILL.md content */
+    mainSkill: DecomposedSkill;
+    /** Extracted sub-skills */
+    subSkills: SubSkill[];
+    /** Whether decomposition was applied */
+    wasDecomposed: boolean;
+    /** Statistics about the decomposition */
+    stats: DecompositionStats;
+}
+/**
+ * The main skill after decomposition
+ */
+export interface DecomposedSkill {
+    /** Filename (always SKILL.md) */
+    filename: string;
+    /** The optimized content */
+    content: string;
+    /** Line count after optimization */
+    lineCount: number;
+    /** References to sub-skills */
+    subSkillRefs: string[];
+}
+/**
+ * An extracted sub-skill
+ */
+export interface SubSkill {
+    /** Filename (e.g., api.md, examples.md) */
+    filename: string;
+    /** Original section name */
+    sectionName: string;
+    /** The extracted content */
+    content: string;
+    /** Line count */
+    lineCount: number;
+    /** Why this section was extracted */
+    extractionReason: string;
+}
+/**
+ * Statistics about the decomposition
+ */
+export interface DecompositionStats {
+    /** Original line count */
+    originalLines: number;
+    /** Main skill line count after decomposition */
+    mainSkillLines: number;
+    /** Total lines in sub-skills */
+    subSkillLines: number;
+    /** Number of sub-skills created */
+    subSkillCount: number;
+    /** Estimated token reduction percentage */
+    tokenReductionPercent: number;
+}
+/**
+ * Metadata extracted from SKILL.md frontmatter
+ */
+export interface SkillMetadata {
+    name?: string;
+    description?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Configuration for decomposition behavior
+ */
+export interface DecomposerOptions {
+    /** Maximum lines for main skill (default: 400) */
+    maxMainSkillLines?: number;
+    /** Minimum lines for a section to be extracted (default: 50) */
+    minExtractableLines?: number;
+    /** Whether to add navigation links to main skill (default: true) */
+    addNavigation?: boolean;
+    /** Whether to add "Optimized by Skillsmith" attribution (default: true) */
+    addAttribution?: boolean;
+    /**
+     * Keywords that indicate a section should be extracted as a sub-skill.
+     * Sections with titles containing these keywords will be candidates for extraction.
+     * @default ['api', 'reference', 'example', 'usage', 'advanced', 'configuration', 'troubleshoot', 'appendix']
+     */
+    extractKeywords?: string[];
+}
+/**
+ * Parsed section from skill content (internal)
+ */
+export interface ParsedSection {
+    level: number;
+    title: string;
+    startLine: number;
+    lines: string[];
+}
+/**
+ * Resolved decomposer options with all required fields
+ */
+export type ResolvedDecomposerOptions = Required<DecomposerOptions>;
+//# sourceMappingURL=SkillDecomposer.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDecomposer.types.d.ts","sourceRoot":"","sources":["../../src/services/SkillDecomposer.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,SAAS,EAAE,eAAe,CAAA;IAE1B,2BAA2B;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAA;IAErB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAA;IAEtB,yCAAyC;IACzC,KAAK,EAAE,kBAAkB,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAEhB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IAEf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IAEjB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAEhB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IAEnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IAEf,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IAEjB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAA;IAErB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAA;IAEtB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAA;IAErB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;IAErB,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAA"}

package/dist/services/SkillDecomposer.types.js

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

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

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