claude-skills-cli 0.0.20 → 0.0.22

package/dist/validators/references-validator.js

@@ -1,155 +0,0 @@
-/**
- * References validation (Level 3 progressive disclosure)
- */
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-/**
- * Strip fenced code blocks from content to avoid parsing example links
- */
-function strip_code_blocks(content) {
-    // Remove fenced code blocks (``` or ~~~)
-    return content.replace(/```[\s\S]*?```|~~~[\s\S]*?~~~/g, '');
-}
-/**
- * Check nesting depth of reference files
- */
-function check_reference_nesting(skill_path, file_path, visited = new Set()) {
-    if (visited.has(file_path)) {
-        return { depth: 0, references: [] };
-    }
-    visited.add(file_path);
-    const full_path = join(skill_path, file_path);
-    if (!existsSync(full_path)) {
-        return { depth: 0, references: [] };
-    }
-    const content = readFileSync(full_path, 'utf-8');
-    // Strip code blocks to avoid parsing example links inside them
-    const content_without_code = strip_code_blocks(content);
-    const reference_pattern = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
-    const matches = [
-        ...content_without_code.matchAll(reference_pattern),
-    ];
-    const references = matches.map((m) => m[2]);
-    if (references.length === 0) {
-        return { depth: 1, references: [] };
-    }
-    // Recursively check nested references
-    let max_depth = 1;
-    for (const ref of references) {
-        const nested = check_reference_nesting(skill_path, ref, new Set(visited));
-        max_depth = Math.max(max_depth, 1 + nested.depth);
-    }
-    return { depth: max_depth, references };
-}
-/**
- * Validate references directory and links
- */
-export function validate_references(skill_path) {
-    const references_dir = join(skill_path, 'references');
-    const skill_md_path = join(skill_path, 'SKILL.md');
-    const files_found = [];
-    const files_referenced = [];
-    const missing_files = [];
-    const nesting_data = [];
-    const warnings = [];
-    const errors = [];
-    // Check references directory if it exists
-    if (existsSync(references_dir)) {
-        const files = readdirSync(references_dir);
-        const md_files = files.filter((f) => f.endsWith('.md'));
-        files_found.push(...md_files.map((f) => `references/${f}`));
-        if (md_files.length === 0) {
-            warnings.push({
-                type: 'empty_directory',
-                message: 'references/ directory exists but is empty',
-            });
-        }
-        // Check for references in SKILL.md
-        if (existsSync(skill_md_path)) {
-            const skill_content = readFileSync(skill_md_path, 'utf-8');
-            for (const md_file of md_files) {
-                if (!skill_content.includes(md_file)) {
-                    warnings.push({
-                        type: 'orphaned_file',
-                        message: `Reference file 'references/${md_file}' not mentioned in SKILL.md`,
-                    });
-                }
-            }
-        }
-    }
-    // Check root-level .md files (excluding SKILL.md)
-    if (existsSync(skill_path)) {
-        const root_files = readdirSync(skill_path);
-        const root_md_files = root_files.filter((f) => f.endsWith('.md') && f !== 'SKILL.md' && f !== 'README.md');
-        files_found.push(...root_md_files);
-        if (existsSync(skill_md_path)) {
-            const skill_content = readFileSync(skill_md_path, 'utf-8');
-            for (const md_file of root_md_files) {
-                if (!skill_content.includes(md_file)) {
-                    warnings.push({
-                        type: 'orphaned_file',
-                        message: `Root file '${md_file}' not mentioned in SKILL.md`,
-                    });
-                }
-            }
-        }
-    }
-    // Level 3 validation: Check that all referenced files exist
-    if (existsSync(skill_md_path)) {
-        const skill_content = readFileSync(skill_md_path, 'utf-8');
-        // Strip code blocks to avoid parsing example links inside them
-        const content_without_code = strip_code_blocks(skill_content);
-        // Extract markdown links to .md files (references/ or root-level)
-        // Matches: [text](file.md), [text](references/file.md), etc.
-        const reference_link_pattern = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
-        const matches = content_without_code.matchAll(reference_link_pattern);
-        for (const match of matches) {
-            const link_text = match[1];
-            const file_path = match[2]; // e.g., "references/examples.md"
-            const full_path = join(skill_path, file_path);
-            files_referenced.push(file_path);
-            if (!existsSync(full_path)) {
-                missing_files.push(file_path);
-                errors.push({
-                    type: 'missing_file',
-                    message: `Referenced file not found: ${file_path}\n` +
-                        `  → Linked from: [${link_text}]\n` +
-                        `  → Create the file or remove the broken link`,
-                });
-            }
-            else {
-                // Check nesting depth
-                const nesting = check_reference_nesting(skill_path, file_path);
-                let warning = null;
-                if (nesting.depth > 1) {
-                    warning = `File has depth ${nesting.depth} (recommended: 1). Keep references one level deep from SKILL.md.`;
-                    warnings.push({
-                        type: 'nesting_depth',
-                        message: `${file_path} has nesting depth ${nesting.depth} (recommended: 1)\n` +
-                            `  → Keep references one level deep from SKILL.md for clarity`,
-                    });
-                }
-                nesting_data.push({
-                    file: file_path,
-                    references: nesting.references,
-                    depth: nesting.depth,
-                    warning,
-                });
-            }
-        }
-    }
-    // Calculate orphaned files
-    const orphaned = files_found.filter((f) => !files_referenced.some((ref) => ref.includes(f)));
-    const validation = {
-        files_found,
-        files_referenced,
-        missing_files,
-        orphaned_files: orphaned,
-        nesting: nesting_data,
-        max_nesting_depth: nesting_data.length > 0
-            ? Math.max(...nesting_data.map((n) => n.depth))
-            : 0,
-    };
-    return { validation, warnings, errors };
-}
-//# sourceMappingURL=references-validator.js.map

package/dist/validators/references-validator.js.map

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

package/dist/validators/text-analysis.js

@@ -1,71 +0,0 @@
-/**
- * Text analysis utilities for skill validation
- */
-/**
- * Extract body content from SKILL.md (excluding YAML frontmatter)
- */
-export function extract_body(content) {
-    const parts = content.split('---\n');
-    return parts.length >= 3
-        ? parts.slice(2).join('---\n').trim()
-        : content;
-}
-/**
- * Count words in text
- */
-export function count_words(text) {
-    return text
-        .trim()
-        .split(/\s+/)
-        .filter((w) => w.length > 0).length;
-}
-/**
- * Estimate tokens (rough approximation: 1 word ≈ 1.3 tokens for English)
- */
-export function estimate_tokens(word_count) {
-    return Math.round(word_count * 1.3);
-}
-/**
- * Estimate tokens for a string by counting words and applying ratio
- */
-export function estimate_string_tokens(text) {
-    const word_count = count_words(text);
-    return estimate_tokens(word_count);
-}
-/**
- * Remove HTML comments from content (for line counting)
- */
-export function strip_html_comments(text) {
-    return text.replace(/<!--[\s\S]*?-->/g, '');
-}
-/**
- * Extract keywords from text (simplified extraction)
- */
-export function extract_keywords(text) {
-    const words = text
-        .toLowerCase()
-        .replace(/[^\w\s-]/g, ' ')
-        .split(/\s+/)
-        .filter((w) => w.length > 3);
-    const unique = [...new Set(words)];
-    return unique.filter((w) => ![
-        'this',
-        'that',
-        'with',
-        'from',
-        'have',
-        'will',
-        'when',
-        'what',
-        'where',
-        'which',
-        'their',
-        'them',
-        'then',
-        'than',
-        'these',
-        'those',
-        'there',
-    ].includes(w));
-}
-//# sourceMappingURL=text-analysis.js.map

package/dist/validators/text-analysis.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text-analysis.js","sourceRoot":"","sources":["../../src/validators/text-analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC;QACvB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;QACrC,CAAC,CAAC,OAAO,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI;SACT,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI;SAChB,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,EAAE,CACL,CAAC;QACA,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;KACP,CAAC,QAAQ,CAAC,CAAC,CAAC,CACd,CAAC;AACH,CAAC"}