@skillit/core 1.5.0

package/dist/audit-score.js

@@ -0,0 +1,490 @@
+// ---------------------------------------------------------------------------
+// Dimension maxima
+// ---------------------------------------------------------------------------
+const MAX_D1 = 20;
+const MAX_D2 = 15;
+const MAX_D3 = 15;
+const MAX_D4 = 15;
+const MAX_D5 = 15;
+const MAX_D6 = 15;
+const MAX_D7 = 10;
+const MAX_D8 = 15;
+const MAX_TOTAL = MAX_D1 + MAX_D2 + MAX_D3 + MAX_D4 + MAX_D5 + MAX_D6 + MAX_D7 + MAX_D8; // 120
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function passes(audit, code) {
+    return audit.passing.some((p) => p.code === code);
+}
+function hasFatalCode(audit, code) {
+    return audit.issues.some((i) => i.code === code && i.severity === 'fatal');
+}
+function clamp(value, max) {
+    return Math.min(Math.max(0, value), max);
+}
+// ---------------------------------------------------------------------------
+// Core estimator
+// ---------------------------------------------------------------------------
+/**
+ * Estimate the 8-dimension skill-judge score from an {@link AuditResult}.
+ *
+ * Each dimension starts at a baseline and adds/deducts based on which audit
+ * checks pass or fail. Dimensions are capped at their respective maxima.
+ *
+ * @param audit - The completed audit result to score
+ * @param skill - Optional extracted skill; when provided, improvements include specific file/export targets
+ * @returns A {@link SkillJudgeEstimate} with dimension breakdown, total, grade, and improvements
+ *
+ * @category Audit
+ * @useWhen
+ * - You want a quick human-readable quality rating after running an audit
+ * - Building dashboards that track skill quality over time
+ * @avoidWhen
+ * - Using as a hard CI gate — prefer explicit audit codes (F1, E4, etc.) for gating
+ */
+export function estimateSkillJudgeScore(audit, skill) {
+    // --- D1: Knowledge Delta /20 ---
+    let d1 = 14;
+    if (passes(audit, 'W10'))
+        d1 += 3; // @remarks on complex functions
+    if (passes(audit, 'W1'))
+        d1 += 3; // @packageDocumentation >50 chars
+    if (hasFatalCode(audit, 'F4'))
+        d1 -= 5; // missing JSDoc on exports
+    d1 = clamp(d1, MAX_D1);
+    // --- D2: Procedures /15 ---
+    let d2 = 5;
+    if (passes(audit, 'W7'))
+        d2 += 5; // @useWhen
+    if (passes(audit, 'W8'))
+        d2 += 3; // @avoidWhen
+    if (passes(audit, 'E4'))
+        d2 += 2; // @example
+    d2 = clamp(d2, MAX_D2);
+    // --- D3: Anti-Patterns /15 ---
+    let d3 = 2;
+    if (passes(audit, 'W9'))
+        d3 += 8; // @never
+    if (passes(audit, 'W3'))
+        d3 += 3; // notable tags
+    if (passes(audit, 'W6'))
+        d3 += 2; // README troubleshooting
+    d3 = clamp(d3, MAX_D3);
+    // --- D4: Description /15 ---
+    let d4 = 5;
+    if (passes(audit, 'F1'))
+        d4 += 4; // package.json description
+    if (passes(audit, 'F3'))
+        d4 += 3; // README description
+    if (passes(audit, 'F2'))
+        d4 += 2; // keywords
+    if (passes(audit, 'E5'))
+        d4 += 1; // repository URL
+    d4 = clamp(d4, MAX_D4);
+    // --- D5: Progressive Disclosure /15 ---
+    let d5 = 10;
+    if (passes(audit, 'W11'))
+        d5 += 3; // @category
+    if (passes(audit, 'W5'))
+        d5 += 2; // README Features
+    d5 = clamp(d5, MAX_D5);
+    // --- D6: Freedom /15 ---
+    let d6 = 12;
+    if (passes(audit, 'W8'))
+        d6 += 3; // @avoidWhen
+    d6 = clamp(d6, MAX_D6);
+    // --- D7: Pattern /10 ---
+    let d7 = 5;
+    if (passes(audit, 'W11'))
+        d7 += 3; // @category
+    if (passes(audit, 'W7'))
+        d7 += 2; // @useWhen
+    d7 = clamp(d7, MAX_D7);
+    // --- D8: Usability /15 ---
+    let d8 = 5;
+    if (passes(audit, 'E1'))
+        d8 += 3; // @param
+    if (passes(audit, 'E2'))
+        d8 += 3; // @returns
+    if (passes(audit, 'E3'))
+        d8 += 2; // property JSDoc
+    if (passes(audit, 'E4'))
+        d8 += 2; // @example
+    d8 = clamp(d8, MAX_D8);
+    const total = d1 + d2 + d3 + d4 + d5 + d6 + d7 + d8;
+    const percentage = Math.round((total / MAX_TOTAL) * 1000) / 10;
+    const grade = percentageToGrade(percentage);
+    const improvements = buildImprovements(audit, {
+        d1,
+        d2,
+        d3,
+        d4,
+        d5,
+        d6,
+        d7,
+        d8
+    }, skill);
+    return {
+        dimensions: {
+            d1_knowledgeDelta: d1,
+            d2_procedures: d2,
+            d3_antiPatterns: d3,
+            d4_description: d4,
+            d5_progressiveDisclosure: d5,
+            d6_freedom: d6,
+            d7_pattern: d7,
+            d8_usability: d8
+        },
+        total,
+        percentage,
+        grade,
+        improvements
+    };
+}
+// ---------------------------------------------------------------------------
+// Grade calculation
+// ---------------------------------------------------------------------------
+function percentageToGrade(pct) {
+    if (pct >= 90)
+        return 'A';
+    if (pct >= 80)
+        return 'B';
+    if (pct >= 70)
+        return 'C';
+    if (pct >= 60)
+        return 'D';
+    return 'F';
+}
+function fileForModule(sourceModule) {
+    if (!sourceModule)
+        return 'src/';
+    return `src/${sourceModule}`;
+}
+/** Depth in source tree — fewer segments = higher priority (top-level exports first). */
+function sourceDepth(sourceModule) {
+    if (!sourceModule)
+        return 0; // no source info = treat as top-level
+    return sourceModule.split('/').length;
+}
+/** Classes and functions missing a given tag, sorted by source tree depth (top-level first). */
+function targetsForMissingTag(skill, tag, maxClasses = 5, maxFunctions = 3) {
+    const classTargets = skill.classes
+        .filter((c) => !c.tags[tag])
+        .sort((a, b) => sourceDepth(a.sourceModule) - sourceDepth(b.sourceModule))
+        .slice(0, maxClasses)
+        .map((c) => ({ file: fileForModule(c.sourceModule), name: c.name, kind: 'class' }));
+    const fnTargets = skill.functions
+        .filter((f) => !f.tags[tag])
+        .sort((a, b) => sourceDepth(a.sourceModule) - sourceDepth(b.sourceModule))
+        .slice(0, maxFunctions)
+        .map((f) => ({ file: fileForModule(f.sourceModule), name: f.name, kind: 'function' }));
+    // CLI command surfaces also carry useWhen / avoidWhen / pitfalls.
+    // Only emit targets for the tags that ExtractedConfigSurface actually holds.
+    const CLI_SURFACE_TAGS = new Set(['useWhen', 'avoidWhen', 'pitfalls']);
+    const cliTargets = CLI_SURFACE_TAGS.has(tag)
+        ? (skill.configSurfaces ?? [])
+            // Empty array = no content = a gap, so treat it the same as a missing tag.
+            .filter((s) => s.sourceType === 'cli' && !s[tag]?.length)
+            .slice(0, maxFunctions)
+            .map((s) => ({ file: '', name: s.name, kind: 'command' }))
+        : [];
+    return [...classTargets, ...fnTargets, ...cliTargets];
+}
+/** Functions with 3+ parameters missing @remarks, sorted by source tree depth. */
+function targetsForRemarks(skill) {
+    return skill.functions
+        .filter((f) => f.parameters.length >= 3 && !f.tags['remarks'])
+        .sort((a, b) => sourceDepth(a.sourceModule) - sourceDepth(b.sourceModule))
+        .slice(0, 5)
+        .map((f) => ({
+        file: fileForModule(f.sourceModule),
+        name: f.name,
+        kind: `function, ${f.parameters.length} params`
+    }));
+}
+/**
+ * For each dimension below 80% of its max, suggest the audit fix that would
+ * help most. Return the top 3 by potential point gain.
+ */
+function buildImprovements(audit, dims, skill) {
+    const suggestions = [];
+    // D1: highest single-fix gain is W10 (+3) or W1 (+3)
+    if (dims.d1 < MAX_D1 * 0.8) {
+        if (!passes(audit, 'W10')) {
+            const targets = skill ? targetsForRemarks(skill) : undefined;
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @remarks to complex functions (3+ params) (+3 on D1)',
+                    points: 3,
+                    dimension: 'D1',
+                    targets: targets && targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'W1')) {
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add detailed @packageDocumentation description >50 chars (+3 on D1)',
+                    points: 3,
+                    dimension: 'D1'
+                }
+            });
+        }
+    }
+    // D2: highest gain is W7 (+5)
+    if (dims.d2 < MAX_D2 * 0.8) {
+        if (!passes(audit, 'W7')) {
+            const targets = skill ? targetsForMissingTag(skill, 'useWhen') : undefined;
+            suggestions.push({
+                gain: 5,
+                imp: {
+                    suggestion: 'Add @useWhen to key exports (+5 on D2)',
+                    points: 5,
+                    dimension: 'D2',
+                    targets: targets && targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'W8')) {
+            const targets = skill ? targetsForMissingTag(skill, 'avoidWhen') : undefined;
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @avoidWhen to key exports (+3 on D2)',
+                    points: 3,
+                    dimension: 'D2',
+                    targets: targets && targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'E4')) {
+            suggestions.push({
+                gain: 2,
+                imp: {
+                    suggestion: 'Add @example code blocks (+2 on D2)',
+                    points: 2,
+                    dimension: 'D2'
+                }
+            });
+        }
+    }
+    // D3: highest gain is W9 (+8)
+    if (dims.d3 < MAX_D3 * 0.8) {
+        if (!passes(audit, 'W9')) {
+            const targets = skill ? targetsForMissingTag(skill, 'pitfalls') : undefined;
+            suggestions.push({
+                gain: 8,
+                imp: {
+                    suggestion: 'Add @pitfalls (never-do) annotation to key exports (+8 on D3)',
+                    points: 8,
+                    dimension: 'D3',
+                    targets: targets && targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'W3')) {
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @deprecated/@since/@throws/@see tags (+3 on D3)',
+                    points: 3,
+                    dimension: 'D3'
+                }
+            });
+        }
+        if (!passes(audit, 'W6')) {
+            suggestions.push({
+                gain: 2,
+                imp: {
+                    suggestion: 'Add README Troubleshooting section (+2 on D3)',
+                    points: 2,
+                    dimension: 'D3'
+                }
+            });
+        }
+    }
+    // D4: highest gain is F1 (+4)
+    if (dims.d4 < MAX_D4 * 0.8) {
+        if (!passes(audit, 'F1')) {
+            suggestions.push({
+                gain: 4,
+                imp: {
+                    suggestion: 'Add meaningful package.json description (+4 on D4)',
+                    points: 4,
+                    dimension: 'D4'
+                }
+            });
+        }
+        if (!passes(audit, 'F3')) {
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add README description/blockquote (+3 on D4)',
+                    points: 3,
+                    dimension: 'D4'
+                }
+            });
+        }
+        if (!passes(audit, 'F2')) {
+            suggestions.push({
+                gain: 2,
+                imp: {
+                    suggestion: 'Add 5+ domain-specific keywords (+2 on D4)',
+                    points: 2,
+                    dimension: 'D4'
+                }
+            });
+        }
+        if (!passes(audit, 'E5')) {
+            suggestions.push({
+                gain: 1,
+                imp: {
+                    suggestion: 'Add repository URL to package.json (+1 on D4)',
+                    points: 1,
+                    dimension: 'D4'
+                }
+            });
+        }
+    }
+    // D5: highest gain is W11 (+3)
+    if (dims.d5 < MAX_D5 * 0.8) {
+        if (!passes(audit, 'W11')) {
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @category for grouping (+3 on D5, +3 on D7)',
+                    points: 3,
+                    dimension: 'D5'
+                }
+            });
+        }
+        if (!passes(audit, 'W5')) {
+            suggestions.push({
+                gain: 2,
+                imp: {
+                    suggestion: 'Add README Features section (+2 on D5)',
+                    points: 2,
+                    dimension: 'D5'
+                }
+            });
+        }
+    }
+    // D6: only W8 (+3) — but D6 base is 12 so below 80% (12) rarely triggers unless W8 missing
+    if (dims.d6 < MAX_D6 * 0.8) {
+        if (!passes(audit, 'W8')) {
+            const targets = skill ? targetsForMissingTag(skill, 'avoidWhen') : undefined;
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @avoidWhen to key exports (+3 on D6)',
+                    points: 3,
+                    dimension: 'D6',
+                    targets: targets && targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+    }
+    // D7: W11 (+3), W7 (+2)
+    if (dims.d7 < MAX_D7 * 0.8) {
+        if (!passes(audit, 'W11')) {
+            // Avoid duplicate if already added from D5
+            const alreadySuggested = suggestions.some((s) => s.imp.suggestion.includes('@category for grouping'));
+            if (!alreadySuggested) {
+                suggestions.push({
+                    gain: 3,
+                    imp: {
+                        suggestion: 'Add @category for grouping (+3 on D5, +3 on D7)',
+                        points: 3,
+                        dimension: 'D7'
+                    }
+                });
+            }
+        }
+        if (!passes(audit, 'W7')) {
+            const alreadySuggested = suggestions.some((s) => s.imp.suggestion.includes('@useWhen to key exports'));
+            if (!alreadySuggested) {
+                const targets = skill ? targetsForMissingTag(skill, 'useWhen') : undefined;
+                suggestions.push({
+                    gain: 2,
+                    imp: {
+                        suggestion: 'Add @useWhen to key exports (+2 on D7)',
+                        points: 2,
+                        dimension: 'D7',
+                        targets: targets && targets.length > 0 ? targets : undefined
+                    }
+                });
+            }
+        }
+    }
+    // D8: E1 (+3), E2 (+3), E3 (+2), E4 (+2)
+    if (dims.d8 < MAX_D8 * 0.8) {
+        if (!passes(audit, 'E1')) {
+            // Use audit issues to find specific symbols missing @param
+            const targets = audit.issues
+                .filter((i) => i.code === 'E1')
+                .slice(0, 5)
+                .map((i) => ({ file: i.file, name: i.symbol ?? '(unknown)', kind: 'function' }));
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @param descriptions to all parameters (+3 on D8)',
+                    points: 3,
+                    dimension: 'D8',
+                    targets: targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'E2')) {
+            const targets = audit.issues
+                .filter((i) => i.code === 'E2')
+                .slice(0, 5)
+                .map((i) => ({ file: i.file, name: i.symbol ?? '(unknown)', kind: 'function' }));
+            suggestions.push({
+                gain: 3,
+                imp: {
+                    suggestion: 'Add @returns descriptions to non-void functions (+3 on D8)',
+                    points: 3,
+                    dimension: 'D8',
+                    targets: targets.length > 0 ? targets : undefined
+                }
+            });
+        }
+        if (!passes(audit, 'E3')) {
+            suggestions.push({
+                gain: 2,
+                imp: {
+                    suggestion: 'Add JSDoc to all interface/type properties (+2 on D8)',
+                    points: 2,
+                    dimension: 'D8'
+                }
+            });
+        }
+        if (!passes(audit, 'E4')) {
+            const alreadySuggested = suggestions.some((s) => s.imp.suggestion.includes('@example code blocks'));
+            if (!alreadySuggested) {
+                suggestions.push({
+                    gain: 2,
+                    imp: {
+                        suggestion: 'Add @example code blocks (+2 on D8)',
+                        points: 2,
+                        dimension: 'D8'
+                    }
+                });
+            }
+        }
+    }
+    // Sort by gain desc, deduplicate by suggestion text, take top 3
+    suggestions.sort((a, b) => b.gain - a.gain);
+    const seen = new Set();
+    const top = [];
+    for (const s of suggestions) {
+        if (!seen.has(s.imp.suggestion) && top.length < 3) {
+            seen.add(s.imp.suggestion);
+            top.push(s.imp);
+        }
+    }
+    return top;
+}
+//# sourceMappingURL=audit-score.js.map

package/dist/audit-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-score.js","sourceRoot":"","sources":["../src/audit-score.ts"],"names":[],"mappings":"AA4DA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,MAAM,GAAG,EAAE,CAAC;AAClB,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM;AAE/F,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,MAAM,CAAC,KAAkB,EAAE,IAAY;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,KAAkB,EAAE,IAAY;IACpD,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAkB,EAClB,KAAsB;IAEtB,kCAAkC;IAClC,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,gCAAgC;IACnE,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;IACpE,IAAI,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,2BAA2B;IACnE,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,6BAA6B;IAC7B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;IAC/C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,gCAAgC;IAChC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS;IAC3C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,eAAe;IACjD,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,yBAAyB;IAC3D,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,8BAA8B;IAC9B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,2BAA2B;IAC7D,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,qBAAqB;IACvD,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB;IACnD,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,yCAAyC;IACzC,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY;IAC/C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB;IACpD,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,0BAA0B;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;IAC/C,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,0BAA0B;IAC1B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY;IAC/C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,4BAA4B;IAC5B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS;IAC3C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB;IACnD,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAC7C,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEvB,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/D,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAE5C,MAAM,YAAY,GAAG,iBAAiB,CACpC,KAAK,EACL;QACE,EAAE;QACF,EAAE;QACF,EAAE;QACF,EAAE;QACF,EAAE;QACF,EAAE;QACF,EAAE;QACF,EAAE;KACH,EACD,KAAK,CACN,CAAC;IAEF,OAAO;QACL,UAAU,EAAE;YACV,iBAAiB,EAAE,EAAE;YACrB,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE;YACnB,cAAc,EAAE,EAAE;YAClB,wBAAwB,EAAE,EAAE;YAC5B,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,EAAE;YACd,YAAY,EAAE,EAAE;SACjB;QACD,KAAK;QACL,UAAU;QACV,KAAK;QACL,YAAY;KACb,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC;AAuBD,SAAS,aAAa,CAAC,YAAgC;IACrD,IAAI,CAAC,YAAY;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,OAAO,YAAY,EAAE,CAAC;AAC/B,CAAC;AAED,yFAAyF;AACzF,SAAS,WAAW,CAAC,YAAgC;IACnD,IAAI,CAAC,YAAY;QAAE,OAAO,CAAC,CAAC,CAAC,sCAAsC;IACnE,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAED,gGAAgG;AAChG,SAAS,oBAAoB,CAC3B,KAAqB,EACrB,GAAW,EACX,UAAU,GAAG,CAAC,EACd,YAAY,GAAG,CAAC;IAEhB,MAAM,YAAY,GAAwB,KAAK,CAAC,OAAO;SACpD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;SACzE,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAEtF,MAAM,SAAS,GAAwB,KAAK,CAAC,SAAS;SACnD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;SACzE,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAEzF,kEAAkE;IAClE,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC,CAAC;IAGhF,MAAM,UAAU,GAAwB,gBAAgB,CAAC,GAAG,CAAC,GAAa,CAAC;QACzE,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;YAC1B,2EAA2E;aAC1E,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,IAAI,CAAE,CAAC,CAAC,GAAa,CAA0B,EAAE,MAAM,CACrF;aACA,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,KAAqB;IAC9C,OAAO,KAAK,CAAC,SAAS;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;SAC7D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;SACzE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,aAAa,CAAC,CAAC,UAAU,CAAC,MAAM,SAAS;KAChD,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CACxB,KAAkB,EAClB,IAAe,EACf,KAAsB;IAEtB,MAAM,WAAW,GAAwD,EAAE,CAAC;IAE5E,qDAAqD;IACrD,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7D,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,0DAA0D;oBACtE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,qEAAqE;oBACjF,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,wCAAwC;oBACpD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,0CAA0C;oBACtD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,qCAAqC;oBACjD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,+DAA+D;oBAC3E,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,qDAAqD;oBACjE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,+CAA+C;oBAC3D,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,oDAAoD;oBAChE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,8CAA8C;oBAC1D,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,4CAA4C;oBACxD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,+CAA+C;oBAC3D,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,iDAAiD;oBAC7D,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,wCAAwC;oBACpD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,2FAA2F;IAC3F,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,0CAA0C;oBACtD,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAC7D;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1B,2CAA2C;YAC3C,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CACpD,CAAC;YACF,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,CAAC;oBACP,GAAG,EAAE;wBACH,UAAU,EAAE,iDAAiD;wBAC7D,MAAM,EAAE,CAAC;wBACT,SAAS,EAAE,IAAI;qBAChB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CACrD,CAAC;YACF,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC3E,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,CAAC;oBACP,GAAG,EAAE;wBACH,UAAU,EAAE,wCAAwC;wBACpD,MAAM,EAAE,CAAC;wBACT,SAAS,EAAE,IAAI;wBACf,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBAC7D;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,2DAA2D;YAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM;iBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;iBAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YACnF,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,sDAAsD;oBAClE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAClD;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM;iBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;iBAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YACnF,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,4DAA4D;oBACxE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;iBAClD;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE;oBACH,UAAU,EAAE,uDAAuD;oBACnE,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAClD,CAAC;YACF,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,CAAC;oBACP,GAAG,EAAE;wBACH,UAAU,EAAE,qCAAqC;wBACjD,MAAM,EAAE,CAAC;wBACT,SAAS,EAAE,IAAI;qBAChB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/audit-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Severity levels for audit issues, ordered from most to least severe.
+ * - `fatal`: Disqualifying problems that prevent the skill from being used safely
+ * - `error`: Serious problems that significantly degrade skill quality
+ * - `warning`: Moderate problems that reduce skill effectiveness
+ * - `alert`: Minor issues or suggestions for improvement
+ */
+export type AuditSeverity = 'fatal' | 'error' | 'warning' | 'alert';
+/**
+ * A single audit finding that identifies a problem in the skill package.
+ */
+export interface AuditIssue {
+    /** Severity level of this issue */
+    severity: AuditSeverity;
+    /** Short rule code, e.g. "F1", "E2", "W3", "A1" */
+    code: string;
+    /** Relative path to the file containing the issue */
+    file: string;
+    /** Line number within the file, or null if not applicable */
+    line: number | null;
+    /** Name of the function, class, or property related to the issue */
+    symbol: string;
+    /** Human-readable description of the problem */
+    message: string;
+    /** Actionable suggestion for how to fix the issue */
+    suggestion: string;
+}
+/**
+ * A check that the audit engine ran and the skill package passed.
+ */
+export interface AuditPass {
+    /** Short rule code corresponding to the passed check */
+    code: string;
+    /** Human-readable description of what was checked */
+    message: string;
+    /** Optional additional detail about the passing result */
+    detail?: string;
+}
+/**
+ * Contextual metadata about the package being audited, used to evaluate
+ * relevance and quality of skill content.
+ */
+export interface AuditContext {
+    /** Description field from package.json */
+    packageDescription?: string;
+    /** Keywords from package.json */
+    keywords?: string[];
+    /** Repository URL from package.json */
+    repository?: string;
+    /** Parsed sections of the package README */
+    readme?: ParsedReadme;
+}
+/**
+ * Structured representation of key sections extracted from a package README.
+ */
+export interface ParsedReadme {
+    /** Leading blockquote, often used as a one-liner summary */
+    blockquote?: string;
+    /** First prose paragraph after any heading or blockquote */
+    firstParagraph?: string;
+    /** Quick-start or getting-started section content */
+    quickStart?: string;
+    /** Features or capabilities section content */
+    features?: string;
+    /** Troubleshooting, common issues, or FAQ section content */
+    troubleshooting?: string;
+}
+/**
+ * The complete output of an audit run against a single skill package.
+ */
+export interface AuditResult {
+    /** Package name being audited */
+    package: string;
+    /** Count of issues found at each severity level */
+    summary: Record<AuditSeverity, number>;
+    /** All issues found during the audit */
+    issues: AuditIssue[];
+    /** All checks that the package passed */
+    passing: AuditPass[];
+}
+//# sourceMappingURL=audit-types.d.ts.map

package/dist/audit-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-types.d.ts","sourceRoot":"","sources":["../src/audit-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvC,wCAAwC;IACxC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,yCAAyC;IACzC,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB"}

package/dist/audit-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-types.js.map

package/dist/audit-types.js.map

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

package/dist/audit.d.ts

@@ -0,0 +1,17 @@
+import type { ExtractedSkill } from './types.js';
+import type { AuditContext, AuditResult } from './audit-types.js';
+/**
+ * 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 declare function auditSkill(skill: ExtractedSkill, context: AuditContext): AuditResult;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EAEZ,MAAM,kBAAkB,CAAC;AAg7B1B;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,CAwCpF"}