@skillit/core 1.5.0

package/dist/audit.js

@@ -0,0 +1,567 @@
+const GENERIC_KEYWORDS = new Set([
+    'typescript',
+    'javascript',
+    'node',
+    'nodejs',
+    'npm',
+    'library',
+    'package',
+    'utils',
+    'utility',
+    'helper',
+    'tool',
+    'framework'
+]);
+function issue(severity, code, file, line, symbol, message, suggestion) {
+    return { severity, code, file, line, symbol, message, suggestion };
+}
+function pass(code, message, detail) {
+    return { code, message, detail };
+}
+// ---------------------------------------------------------------------------
+// F1: package.json description must exist and be >10 chars
+// ---------------------------------------------------------------------------
+function checkF1(context, issues, passing) {
+    const desc = context.packageDescription?.trim() ?? '';
+    if (!desc || desc.length <= 10) {
+        issues.push(issue('fatal', 'F1', 'package.json', null, 'description', desc
+            ? `package.json description is too short (${desc.length} chars, needs >10)`
+            : 'package.json description is missing', 'Add to package.json: "description": "[One sentence: what problem this library solves for the caller]"'));
+    }
+    else {
+        passing.push(pass('F1', 'package.json description exists and is meaningful', desc));
+    }
+}
+// ---------------------------------------------------------------------------
+// F2: keywords — 5+ entries, at least 3 non-generic
+// ---------------------------------------------------------------------------
+function checkF2(context, issues, passing) {
+    const keywords = context.keywords ?? [];
+    const domainKeywords = keywords.filter((k) => !GENERIC_KEYWORDS.has(k.toLowerCase()));
+    if (keywords.length < 5 || domainKeywords.length < 3) {
+        issues.push(issue('fatal', 'F2', 'package.json', null, 'keywords', keywords.length < 5
+            ? `Only ${keywords.length} keyword(s) found (need ≥5)`
+            : `Only ${domainKeywords.length} domain-specific keyword(s) (need ≥3 non-generic)`, 'Add to package.json: "keywords": ["[domain-verb]", "[domain-noun]", "[use-case]", "[integration]", "[pattern]"]'));
+    }
+    else {
+        passing.push(pass('F2', 'Keywords meet requirements', `${keywords.length} total, ${domainKeywords.length} domain-specific`));
+    }
+}
+// ---------------------------------------------------------------------------
+// F3: README description — blockquote or firstParagraph must exist, >20 chars
+// ---------------------------------------------------------------------------
+function checkF3(context, issues, passing) {
+    const readme = context.readme;
+    const text = (readme?.blockquote?.trim() ?? '') || (readme?.firstParagraph?.trim() ?? '');
+    if (!text || text.length <= 20) {
+        issues.push(issue('fatal', 'F3', 'README.md', null, 'description', text
+            ? `README description is too short (${text.length} chars, needs >20)`
+            : 'README is missing a description (blockquote or first paragraph)', 'Add after title: > [One sentence: what this library does and why someone would use it]'));
+    }
+    else {
+        passing.push(pass('F3', 'README description exists and is meaningful', text.slice(0, 60)));
+    }
+}
+// ---------------------------------------------------------------------------
+// F4: JSDoc on exports — every function/class/type/enum/variable must have non-empty description
+// ---------------------------------------------------------------------------
+function checkF4(skill, issues, passing) {
+    let allGood = true;
+    for (const fn of skill.functions) {
+        if (!fn.description?.trim()) {
+            allGood = false;
+            issues.push(issue('fatal', 'F4', `${fn.sourceModule ?? skill.name}.ts`, null, fn.name, `Function '${fn.name}' is missing a JSDoc description`, `Add: /** [One sentence: what problem ${fn.name} solves for the caller] */`));
+        }
+    }
+    for (const cls of skill.classes) {
+        if (!cls.description?.trim()) {
+            allGood = false;
+            issues.push(issue('fatal', 'F4', `${cls.sourceModule ?? skill.name}.ts`, null, cls.name, `Class '${cls.name}' is missing a JSDoc description`, `Add: /** [One sentence: what problem ${cls.name} solves for the caller] */`));
+        }
+    }
+    for (const typ of skill.types) {
+        if (!typ.description?.trim()) {
+            allGood = false;
+            issues.push(issue('fatal', 'F4', `${typ.sourceModule ?? skill.name}.ts`, null, typ.name, `Type '${typ.name}' is missing a JSDoc description`, `Add: /** [One sentence: what problem ${typ.name} solves for the caller] */`));
+        }
+    }
+    for (const enm of skill.enums) {
+        if (!enm.description?.trim()) {
+            allGood = false;
+            issues.push(issue('fatal', 'F4', `${enm.sourceModule ?? skill.name}.ts`, null, enm.name, `Enum '${enm.name}' is missing a JSDoc description`, `Add: /** [One sentence: what problem ${enm.name} solves for the caller] */`));
+        }
+    }
+    for (const variable of skill.variables) {
+        if (!variable.description?.trim()) {
+            allGood = false;
+            issues.push(issue('fatal', 'F4', `${variable.sourceModule ?? skill.name}.ts`, null, variable.name, `Variable '${variable.name}' is missing a JSDoc description`, `Add: /** [One sentence: what problem ${variable.name} solves for the caller] */`));
+        }
+    }
+    if (allGood) {
+        passing.push(pass('F4', 'All exported symbols have JSDoc descriptions'));
+    }
+}
+// ---------------------------------------------------------------------------
+// E1: @param prose — every parameter must have non-empty description
+//     that doesn't trivially restate the name or type
+// ---------------------------------------------------------------------------
+function isTrivialParamDesc(desc, paramName) {
+    // "The options" for param named "options" — but only check if description IS non-empty
+    const normalized = desc
+        .trim()
+        .toLowerCase()
+        .replace(/^the\s+/, '');
+    return normalized === paramName.toLowerCase();
+}
+/** Check if a parameter is self-documenting from its name + type */
+function isSelfDocumenting(name, type) {
+    const lowerName = name.toLowerCase();
+    const lowerType = type.toLowerCase().replace(/[<>[\]|&? ]/g, '');
+    // Name matches or contains the type name: texture: Texture, renderer: Renderer
+    if (lowerType &&
+        lowerName.includes(lowerType.replace(/partial|readonly|array/gi, '').toLowerCase()))
+        return true;
+    if (lowerType && lowerType.includes(lowerName))
+        return true;
+    // Well-known options/config pattern: options: SpriteOptions, config: AppConfig
+    if (/^(options|config|settings|props|params|args)$/i.test(name) &&
+        /options|config|settings|props/i.test(type))
+        return true;
+    // Common positional/dimensional names with numeric types
+    if (/^(x|y|z|w|h|width|height|depth|index|count|length|size|offset|start|end|min|max|top|left|right|bottom|radius|angle|alpha|scale|rotation|delta|time|duration|delay|speed|priority)$/i.test(name) &&
+        /number|float|int/i.test(type))
+        return true;
+    // Boolean flags where name implies meaning: visible, enabled, active, force
+    if (/boolean/i.test(type) &&
+        /^(is|has|can|should|will|force|enable|disable|visible|active|readonly|optional|required|recursive|deep|strict|lazy|async|sync|auto|skip|include|exclude)/.test(lowerName))
+        return true;
+    // Callback/handler pattern: callback: () => void, handler: EventHandler
+    if (/^(callback|handler|listener|fn|func|predicate|comparator|reducer|mapper|filter|resolver|reject|resolve)$/i.test(name))
+        return true;
+    return false;
+}
+function checkE1(skill, issues, passing) {
+    let allGood = true;
+    const checkParams = (fnName, sourceModule, params) => {
+        for (const param of params) {
+            if (!param.description?.trim() && !isSelfDocumenting(param.name, param.type)) {
+                allGood = false;
+                issues.push(issue('error', 'E1', `${sourceModule ?? skill.name}.ts`, null, `${fnName}#${param.name}`, `Parameter '${param.name}' in '${fnName}' is missing a description`, `Add: @param ${param.name} — [What the caller controls with this parameter — not the type, but the effect]`));
+            }
+        }
+    };
+    for (const fn of skill.functions) {
+        checkParams(fn.name, fn.sourceModule, fn.parameters);
+    }
+    for (const cls of skill.classes) {
+        for (const method of cls.methods) {
+            checkParams(`${cls.name}.${method.name}`, cls.sourceModule, method.parameters);
+        }
+    }
+    if (allGood) {
+        passing.push(pass('E1', 'All parameters have prose descriptions'));
+    }
+}
+// ---------------------------------------------------------------------------
+// E2: @returns — every function where returnType !== 'void' must have returnsDescription
+// ---------------------------------------------------------------------------
+function checkE2(skill, issues, passing) {
+    let allGood = true;
+    const checkFn = (fn, context, sourceModule) => {
+        if (fn.returnType && fn.returnType !== 'void' && !fn.returnsDescription?.trim()) {
+            // Skip self-documenting returns: type matches function name, boolean predicates, this-returns
+            const rt = fn.returnType.toLowerCase();
+            const fnName = fn.name.toLowerCase();
+            const isSelfDoc = rt.includes(fnName) ||
+                fnName.includes(rt.replace(/[[\]<>|& ?]/g, '')) ||
+                (rt === 'boolean' &&
+                    /^(is|has|can|should|contains|includes|equals|matches)/.test(fnName)) ||
+                rt === 'this' ||
+                rt === 'promise<void>';
+            if (isSelfDoc)
+                return;
+            allGood = false;
+            issues.push(issue('error', 'E2', `${sourceModule ?? skill.name}.ts`, null, context, `'${context}' returns '${fn.returnType}' but has no @returns description`, 'Add: @returns [What the caller gets back and what they do with it]'));
+        }
+    };
+    for (const fn of skill.functions) {
+        checkFn(fn, fn.name, fn.sourceModule);
+    }
+    for (const cls of skill.classes) {
+        for (const method of cls.methods) {
+            checkFn(method, `${cls.name}.${method.name}`, cls.sourceModule);
+        }
+    }
+    if (allGood) {
+        passing.push(pass('E2', 'All non-void functions have @returns descriptions'));
+    }
+}
+// ---------------------------------------------------------------------------
+// E3: Interface property JSDoc — every property in types[].properties must have description
+// ---------------------------------------------------------------------------
+function checkE3(skill, issues, passing) {
+    let allGood = true;
+    for (const typ of skill.types) {
+        if (!typ.properties)
+            continue;
+        for (const prop of typ.properties) {
+            if (!prop.description?.trim()) {
+                allGood = false;
+                issues.push(issue('error', 'E3', `${typ.sourceModule ?? skill.name}.ts`, null, `${typ.name}.${prop.name}`, `Property '${prop.name}' in type '${typ.name}' is missing a JSDoc description`, 'Add: /** [What this property controls — one phrase] */'));
+            }
+        }
+    }
+    if (allGood) {
+        passing.push(pass('E3', 'All interface/type properties have JSDoc descriptions'));
+    }
+}
+// ---------------------------------------------------------------------------
+// E4: @example exists — skill.examples.length > 0 OR any function has examples
+// ---------------------------------------------------------------------------
+function checkE4(skill, issues, passing) {
+    const hasSkillExamples = skill.examples.length > 0;
+    const hasFunctionExamples = skill.functions.some((fn) => fn.examples.length > 0);
+    if (!hasSkillExamples && !hasFunctionExamples) {
+        issues.push(issue('error', 'E4', `${skill.name}.ts`, null, skill.name, 'No @example tags found anywhere in the package', 'Add @example with: import statement, setup, call, assertion/output'));
+    }
+    else {
+        passing.push(pass('E4', 'At least one @example exists in the package'));
+    }
+}
+// ---------------------------------------------------------------------------
+// E5: Repository — context.repository must be non-empty
+// ---------------------------------------------------------------------------
+function checkE5(context, issues, passing) {
+    if (!context.repository?.trim()) {
+        issues.push(issue('error', 'E5', 'package.json', null, 'repository', 'package.json is missing a repository URL', 'Add to package.json: "repository": { "type": "git", "url": "[repo-url]" }'));
+    }
+    else {
+        passing.push(pass('E5', 'Repository URL is present', context.repository));
+    }
+}
+// ---------------------------------------------------------------------------
+// W1: @packageDocumentation — skill.description must be >50 chars
+// ---------------------------------------------------------------------------
+function checkW1(skill, issues, passing) {
+    const desc = skill.description?.trim() ?? '';
+    if (desc.length <= 50) {
+        issues.push(issue('warning', 'W1', `${skill.name}.ts`, null, skill.name, desc
+            ? `Module-level description is too short (${desc.length} chars, needs >50)`
+            : 'Module-level @packageDocumentation JSDoc is missing', 'Add a /** @packageDocumentation */ comment with a detailed description (>50 chars)'));
+    }
+    else {
+        passing.push(pass('W1', 'Module-level description is sufficiently detailed', `${desc.length} chars`));
+    }
+}
+// ---------------------------------------------------------------------------
+// W2: Per-function @example — every function should have examples
+// ---------------------------------------------------------------------------
+function checkW2(skill, issues, passing) {
+    let allGood = true;
+    for (const fn of skill.functions) {
+        if (fn.examples.length === 0) {
+            allGood = false;
+            issues.push(issue('warning', 'W2', `${fn.sourceModule ?? skill.name}.ts`, null, fn.name, `Function '${fn.name}' has no @example`, `Add an @example code block to the JSDoc for '${fn.name}'`));
+        }
+    }
+    if (allGood) {
+        passing.push(pass('W2', 'Every function has at least one @example'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W3: Tag usage — at least one function should have a non-empty value in tags
+// ---------------------------------------------------------------------------
+const NOTABLE_TAGS = new Set(['deprecated', 'since', 'throws', 'see']);
+function checkW3(skill, issues, passing) {
+    const hasTaggedFn = skill.functions.some((fn) => Object.entries(fn.tags).some(([key, val]) => NOTABLE_TAGS.has(key) && val.trim()));
+    if (!hasTaggedFn) {
+        issues.push(issue('warning', 'W3', `${skill.name}.ts`, null, skill.name, 'No functions use @deprecated, @since, @throws, or @see tags', 'Add relevant JSDoc tags to document version info, deprecations, errors thrown, or related links'));
+    }
+    else {
+        passing.push(pass('W3', 'At least one function uses notable JSDoc tags'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W4: 10+ keywords — domain-specific keyword count >= 10
+// ---------------------------------------------------------------------------
+function checkW4(context, issues, passing) {
+    const keywords = context.keywords ?? [];
+    const domainKeywords = keywords.filter((k) => !GENERIC_KEYWORDS.has(k.toLowerCase()));
+    if (domainKeywords.length < 10) {
+        issues.push(issue('warning', 'W4', 'package.json', null, 'keywords', `Only ${domainKeywords.length} domain-specific keyword(s) (recommended ≥10 for discoverability)`, 'Add more domain-specific keywords to improve discoverability'));
+    }
+    else {
+        passing.push(pass('W4', 'Excellent keyword coverage', `${domainKeywords.length} domain-specific keywords`));
+    }
+}
+// ---------------------------------------------------------------------------
+// W5: README Features — context.readme?.features must exist
+// ---------------------------------------------------------------------------
+function checkW5(context, skill, issues, passing) {
+    if (!context.readme?.features?.trim()) {
+        const hasRemarks = !!skill.remarks;
+        issues.push(issue('warning', 'W5', hasRemarks ? `${skill.name}.ts` : 'README.md', null, 'features', 'README is missing a Features section', hasRemarks
+            ? 'README ## Features is a secondary source — already have @packageDocumentation @remarks as primary'
+            : 'Add "## Features" to README.md, or add @packageDocumentation @remarks with capabilities overview (primary source, takes priority)'));
+    }
+    else {
+        passing.push(pass('W5', 'README has a Features section'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W6: README Troubleshooting — context.readme?.troubleshooting must exist
+// ---------------------------------------------------------------------------
+function checkW6(context, skill, issues, passing) {
+    if (!context.readme?.troubleshooting?.trim()) {
+        const hasNever = (skill.pitfalls ?? []).length > 0;
+        issues.push(issue('warning', 'W6', hasNever ? `${skill.name}.ts` : 'README.md', null, 'troubleshooting', 'README is missing a Troubleshooting section', hasNever
+            ? 'README ## Troubleshooting is a secondary source — already have @never tags as primary anti-patterns'
+            : 'Add "## Troubleshooting" to README.md, or add @never tags to key exports with NEVER + Fix patterns (primary source)'));
+    }
+    else {
+        passing.push(pass('W6', 'README has a Troubleshooting section'));
+    }
+}
+// ---------------------------------------------------------------------------
+// Routing-tag credit: @useWhen/@avoidWhen/@never may live at the top level
+// (MCP/TypeDoc skills) OR on a CLI configSurface (CLI skills correlate them onto
+// `configSurfaces[].useWhen` etc.). Credit guidance found in either place.
+// ---------------------------------------------------------------------------
+function hasRoutingTag(skill, tag) {
+    if ((skill[tag] ?? []).length > 0)
+        return true;
+    return (skill.configSurfaces ?? []).some((surface) => (surface[tag] ?? []).length > 0);
+}
+// ---------------------------------------------------------------------------
+// W7: @useWhen on at least one export
+// ---------------------------------------------------------------------------
+function checkW7(skill, issues, passing) {
+    const hasUseWhen = hasRoutingTag(skill, 'useWhen');
+    if (!hasUseWhen) {
+        issues.push(issue('warning', 'W7', `${skill.name}.ts`, null, skill.name, 'No exports have a @useWhen tag', 'Add @useWhen to 3-5 key exports: @useWhen - [Scenario where the caller should reach for this — include non-obvious expert knowledge]'));
+    }
+    else {
+        passing.push(pass('W7', 'At least one export has a @useWhen tag'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W8: @avoidWhen on at least one export
+// ---------------------------------------------------------------------------
+function checkW8(skill, issues, passing) {
+    const hasAvoidWhen = hasRoutingTag(skill, 'avoidWhen');
+    if (!hasAvoidWhen) {
+        issues.push(issue('warning', 'W8', `${skill.name}.ts`, null, skill.name, 'No exports have an @avoidWhen tag', 'Add @avoidWhen: @avoidWhen - [When NOT to use this — name the alternative]'));
+    }
+    else {
+        passing.push(pass('W8', 'At least one export has an @avoidWhen tag'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W9: @never on at least one export
+// ---------------------------------------------------------------------------
+function checkW9(skill, issues, passing) {
+    const hasPitfalls = hasRoutingTag(skill, 'pitfalls');
+    if (!hasPitfalls) {
+        issues.push(issue('warning', 'W9', `${skill.name}.ts`, null, skill.name, 'No exports have a @never tag', 'Add @never: @never - NEVER [action] — [non-obvious reason]. Fix: [recovery path]'));
+    }
+    else {
+        passing.push(pass('W9', 'At least one export has a @never tag'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W10: @remarks on complex functions — functions with 3+ params should have @remarks
+// ---------------------------------------------------------------------------
+function checkW10(skill, issues, passing) {
+    let allGood = true;
+    for (const fn of skill.functions) {
+        if (fn.parameters.length >= 3 && !fn.remarks?.trim()) {
+            allGood = false;
+            issues.push(issue('warning', 'W10', `${fn.sourceModule ?? skill.name}.ts`, null, fn.name, `Function '${fn.name}' has ${fn.parameters.length} parameters but no @remarks`, `Add @remarks to '${fn.name}' to explain parameter interactions and usage nuances`));
+        }
+    }
+    if (allGood) {
+        passing.push(pass('W10', 'All complex functions (3+ params) have @remarks'));
+    }
+}
+// ---------------------------------------------------------------------------
+// W11: @category for intentional grouping — at least one export should have @category
+// ---------------------------------------------------------------------------
+function checkW11(skill, issues, passing) {
+    const hasCategory = skill.functions.some((fn) => fn.category?.trim()) ||
+        skill.classes.some((cls) => cls.category?.trim()) ||
+        skill.types.some((typ) => typ.category?.trim()) ||
+        skill.enums.some((enm) => enm.category?.trim()) ||
+        skill.variables.some((v) => v.category?.trim());
+    if (!hasCategory) {
+        issues.push(issue('warning', 'W11', `${skill.name}.ts`, null, skill.name, 'No exports have a @category tag', 'Add @category <group> to exported symbols to enable intentional grouping in documentation'));
+    }
+    else {
+        passing.push(pass('W11', 'At least one export has a @category tag'));
+    }
+}
+// ---------------------------------------------------------------------------
+// A1: Generic keywords — for each generic keyword present, emit alert
+// ---------------------------------------------------------------------------
+function checkA1(context, issues, passing) {
+    const keywords = context.keywords ?? [];
+    const genericFound = keywords.filter((k) => GENERIC_KEYWORDS.has(k.toLowerCase()));
+    for (const kw of genericFound) {
+        issues.push(issue('alert', 'A1', 'package.json', null, `keywords[${kw}]`, `Keyword '${kw}' is too generic and adds little discoverability value`, `Replace '${kw}' with a more specific, domain-relevant keyword`));
+    }
+    if (genericFound.length === 0) {
+        passing.push(pass('A1', 'No generic keywords found'));
+    }
+}
+// ---------------------------------------------------------------------------
+// A2: @param restates type — description that is just "The {type}" or "The {name}"
+//     (only when description IS non-empty — E1 catches empty ones)
+// ---------------------------------------------------------------------------
+function checkA2(skill, issues, passing) {
+    let anyRestating = false;
+    const checkParams = (fnName, sourceModule, params) => {
+        for (const param of params) {
+            const desc = param.description?.trim();
+            if (!desc)
+                continue; // E1 handles empty — skip here
+            if (isTrivialParamDesc(desc, param.name)) {
+                anyRestating = true;
+                issues.push(issue('alert', 'A2', `${sourceModule ?? skill.name}.ts`, null, `${fnName}#${param.name}`, `Parameter '${param.name}' description trivially restates the name: "${desc}"`, `Replace the description with meaningful prose explaining the purpose of '${param.name}'`));
+            }
+        }
+    };
+    for (const fn of skill.functions) {
+        checkParams(fn.name, fn.sourceModule, fn.parameters);
+    }
+    for (const cls of skill.classes) {
+        for (const method of cls.methods) {
+            checkParams(`${cls.name}.${method.name}`, cls.sourceModule, method.parameters);
+        }
+    }
+    if (!anyRestating) {
+        passing.push(pass('A2', 'No parameters trivially restate their name'));
+    }
+}
+// ---------------------------------------------------------------------------
+// A3: Trivial @example — example is a single line with no import, no assignment, no comment
+// ---------------------------------------------------------------------------
+function isTrivialExample(example) {
+    const lines = example
+        .trim()
+        .split('\n')
+        .filter((l) => l.trim());
+    if (lines.length !== 1)
+        return false;
+    const line = (lines[0] ?? '').trim();
+    if (line.startsWith('import ') || line.startsWith('//') || line.includes('='))
+        return false;
+    return true;
+}
+function checkA3(skill, issues, passing) {
+    let anyTrivial = false;
+    const checkExamples = (symbol, sourceModule, examples) => {
+        for (const ex of examples) {
+            if (isTrivialExample(ex)) {
+                anyTrivial = true;
+                issues.push(issue('alert', 'A3', `${sourceModule ?? skill.name}.ts`, null, symbol, `'${symbol}' has a trivial @example (single line, no import/assignment/comment)`, `Expand the example to show a realistic usage pattern with imports and context`));
+            }
+        }
+    };
+    for (const fn of skill.functions) {
+        checkExamples(fn.name, fn.sourceModule, fn.examples);
+    }
+    for (const ex of skill.examples) {
+        if (isTrivialExample(ex)) {
+            anyTrivial = true;
+            issues.push(issue('alert', 'A3', `${skill.name}.ts`, null, skill.name, `Package-level example is trivial (single line, no import/assignment/comment)`, `Expand the example to show a realistic usage pattern with imports and context`));
+        }
+    }
+    if (!anyTrivial) {
+        passing.push(pass('A3', 'All examples are non-trivial'));
+    }
+}
+// ---------------------------------------------------------------------------
+// A4: Quick Start quality — recommend @example when README fallback is too long
+// ---------------------------------------------------------------------------
+function checkA4(context, skill, issues, passing) {
+    const quickStart = context.readme?.quickStart;
+    const hasCodeExample = skill.functions.some((f) => f.examples.length > 0);
+    // If README Quick Start is long and no @example exists, recommend the primary source
+    if (quickStart && !hasCodeExample) {
+        const quickStartLines = quickStart.split('\n').length;
+        if (quickStartLines > 20) {
+            issues.push(issue('warning', 'A4', `${skill.name}.ts`, null, 'quickStart', `README Quick Start is ${quickStartLines} lines — too long for inline SKILL.md rendering`, 'Add @example to a key exported function with a focused 5-10 line snippet. @example takes priority over README Quick Start and produces a leaner SKILL.md'));
+            return;
+        }
+    }
+    if (!quickStart) {
+        passing.push(pass('A4', 'No Quick Start section to check'));
+        return;
+    }
+    // Find code blocks and check their line counts
+    const codeBlockRegex = /```[\s\S]*?```/g;
+    const blocks = quickStart.match(codeBlockRegex) ?? [];
+    let anyVerbose = false;
+    for (const block of blocks) {
+        const lines = block.split('\n').length;
+        if (lines > 15) {
+            anyVerbose = true;
+            issues.push(issue('alert', 'A4', 'README.md', null, 'quickStart', `Quick Start code block is ${lines} lines (recommended ≤15)`, 'Add @example to a key export with a focused snippet — @example trumps README Quick Start'));
+        }
+    }
+    if (!anyVerbose) {
+        passing.push(pass('A4', 'Quick Start code blocks are concise'));
+    }
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Run the documentation audit on a single extracted skill.
+ *
+ * Executes 20+ checks across fatal/error/warning/alert severity levels and returns
+ * a structured result with issues, passing checks, and summary counts.
+ *
+ * @category Audit
+ * @useWhen
+ * - You want programmatic quality feedback on JSDoc coverage before publishing skills
+ * - Building a CI gate that blocks PRs with undocumented exports
+ * @avoidWhen
+ * - Rapid local iteration where audit noise slows you down — use the skillsAudit: false option instead
+ */
+export function auditSkill(skill, context) {
+    const issues = [];
+    const passing = [];
+    // Fatal checks
+    checkF1(context, issues, passing);
+    checkF2(context, issues, passing);
+    checkF3(context, issues, passing);
+    checkF4(skill, issues, passing);
+    // Error checks
+    checkE1(skill, issues, passing);
+    checkE2(skill, issues, passing);
+    checkE3(skill, issues, passing);
+    checkE4(skill, issues, passing);
+    checkE5(context, issues, passing);
+    // Warning checks
+    checkW1(skill, issues, passing);
+    checkW2(skill, issues, passing);
+    checkW3(skill, issues, passing);
+    checkW4(context, issues, passing);
+    checkW5(context, skill, issues, passing);
+    checkW6(context, skill, issues, passing);
+    checkW7(skill, issues, passing);
+    checkW8(skill, issues, passing);
+    checkW9(skill, issues, passing);
+    checkW10(skill, issues, passing);
+    checkW11(skill, issues, passing);
+    // Alert checks
+    checkA1(context, issues, passing);
+    checkA2(skill, issues, passing);
+    checkA3(skill, issues, passing);
+    checkA4(context, skill, issues, passing);
+    const summary = { fatal: 0, error: 0, warning: 0, alert: 0 };
+    for (const iss of issues)
+        summary[iss.severity]++;
+    return { package: skill.name, summary, issues, passing };
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/canonical.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Canonicalization pass — deterministic post-render normalization.
+ *
+ * Operates on `RenderedSkill` (string content), NOT on the `ExtractedSkill` IR.
+ *
+ * Division of responsibility (see specs/001-mcp-extract-bundle/research.md §2):
+ *   - Array ordering of tools/resources/prompts is the ADAPTER's job. Each
+ *     adapter emits items in sorted order directly from the IR. We do NOT
+ *     parse rendered markdown sections and reorder entries here — that would
+ *     be the wrong layer.
+ *   - This module handles the post-render invariants that any adapter's
+ *     output should satisfy to be content-identical across runs:
+ *       1. YAML frontmatter key sort
+ *       2. Line endings normalized to LF
+ *       3. Trailing whitespace trimmed per line
+ *       4. Runs of 2+ blank lines collapsed to 1
+ *       5. Optional regex-based pattern stripping (e.g., timestamps)
+ *
+ * Must be idempotent: `canonicalize(canonicalize(x))` equals `canonicalize(x)`.
+ *
+ * @module canonical
+ */
+import type { RenderedSkill } from './types.js';
+export interface CanonicalizeOptions {
+    /** Regex patterns whose matches are stripped from prose content (e.g. timestamps, PIDs). */
+    stripPatterns?: RegExp[];
+}
+/**
+ * Normalize a `RenderedSkill` so repeat runs produce content-identical output.
+ *
+ * @param skill - rendered skill to normalize; input is not mutated
+ * @param opts - optional pattern list for stripping nondeterministic prose fragments
+ * @returns new `RenderedSkill` with canonicalized content
+ */
+export declare function canonicalize(skill: RenderedSkill, opts?: CanonicalizeOptions): RenderedSkill;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAK5F"}