@skillit/core 1.5.0

package/dist/llms-txt.js

@@ -0,0 +1,187 @@
+import { estimateTokens } from './tokens.js';
+/** Max description length in llms.txt summary */
+const SUMMARY_DESC_MAX = 150;
+/** Render llms.txt and llms-full.txt from extracted skills */
+export function renderLlmsTxt(skills, options) {
+    const summary = renderSummary(skills, options);
+    const full = renderFull(skills, options);
+    return {
+        summary,
+        full,
+        summaryTokens: estimateTokens(summary),
+        fullTokens: estimateTokens(full)
+    };
+}
+// ---------------------------------------------------------------------------
+// llms.txt — summary index
+// ---------------------------------------------------------------------------
+function renderSummary(skills, options) {
+    const lines = [];
+    lines.push(`# ${options.projectName}\n`);
+    if (options.projectDescription) {
+        lines.push(`> ${options.projectDescription}\n`);
+    }
+    if (skills.length > 1) {
+        for (const skill of skills) {
+            lines.push(`## ${skill.name}\n`);
+            if (skill.description) {
+                lines.push(`> ${truncateDescription(skill.description)}\n`);
+            }
+            renderSummarySections(skill, lines);
+        }
+    }
+    else if (skills.length === 1) {
+        renderSummarySections(skills[0], lines);
+    }
+    return lines.join('\n');
+}
+function renderSummarySections(skill, lines) {
+    const primary = [];
+    const optional = [];
+    // Functions
+    for (const fn of skill.functions) {
+        const desc = truncateDescription(fn.description);
+        primary.push(`- \`${fn.name}\`${desc ? `: ${desc}` : ''}`);
+    }
+    // Classes
+    for (const cls of skill.classes) {
+        const desc = truncateDescription(cls.description);
+        primary.push(`- \`${cls.name}\`${desc ? `: ${desc}` : ''}`);
+    }
+    // Variables
+    for (const v of skill.variables ?? []) {
+        const desc = truncateDescription(v.description);
+        primary.push(`- \`${v.name}\`${desc ? `: ${desc}` : ''}`);
+    }
+    // Types/Interfaces
+    for (const t of skill.types) {
+        const desc = truncateDescription(t.description);
+        optional.push(`- \`${t.name}\`${desc ? `: ${desc}` : ''}`);
+    }
+    // Enums
+    for (const e of skill.enums) {
+        const desc = truncateDescription(e.description);
+        optional.push(`- \`${e.name}\`${desc ? `: ${desc}` : ''}`);
+    }
+    if (primary.length > 0) {
+        lines.push('### API\n');
+        lines.push(...primary);
+        lines.push('');
+    }
+    if (optional.length > 0) {
+        lines.push('## Optional\n');
+        lines.push('### Types\n');
+        lines.push(...optional);
+        lines.push('');
+    }
+}
+// ---------------------------------------------------------------------------
+// llms-full.txt — complete API content
+// ---------------------------------------------------------------------------
+function renderFull(skills, options) {
+    const lines = [];
+    lines.push(`# ${options.projectName}\n`);
+    if (options.projectDescription) {
+        lines.push(`> ${options.projectDescription}\n`);
+    }
+    for (const skill of skills) {
+        if (skills.length > 1) {
+            lines.push(`## ${skill.name}\n`);
+            if (skill.description)
+                lines.push(`${skill.description}\n`);
+        }
+        // Functions
+        for (const fn of skill.functions) {
+            lines.push(`### ${fn.name}\n`);
+            if (fn.description)
+                lines.push(`${fn.description}\n`);
+            if (fn.signature) {
+                lines.push('```ts', fn.signature, '```\n');
+            }
+            if (fn.parameters.length > 0) {
+                lines.push('**Parameters:**');
+                for (const p of fn.parameters) {
+                    const opt = p.optional ? ' (optional)' : '';
+                    lines.push(`- \`${p.name}: ${p.type}\`${opt} — ${p.description || ''}`);
+                }
+                lines.push('');
+            }
+            if (fn.returnType && fn.returnType !== 'void') {
+                lines.push(`**Returns:** \`${fn.returnType}\`\n`);
+            }
+            if (fn.examples.length > 0) {
+                for (const ex of fn.examples) {
+                    lines.push(ex);
+                }
+                lines.push('');
+            }
+        }
+        // Classes
+        for (const cls of skill.classes) {
+            lines.push(`### ${cls.name}\n`);
+            if (cls.description)
+                lines.push(`${cls.description}\n`);
+            if (cls.constructorSignature) {
+                lines.push('```ts', cls.constructorSignature, '```\n');
+            }
+            if (cls.properties.length > 0) {
+                lines.push('**Properties:**');
+                for (const p of cls.properties) {
+                    lines.push(`- \`${p.name}: ${p.type}\` — ${p.description || ''}`);
+                }
+                lines.push('');
+            }
+            if (cls.methods.length > 0) {
+                lines.push('**Methods:**');
+                for (const m of cls.methods) {
+                    lines.push(`- \`${m.signature}\` — ${m.description || ''}`);
+                }
+                lines.push('');
+            }
+        }
+        // Types
+        for (const t of skill.types) {
+            lines.push(`### ${t.name}\n`);
+            if (t.description)
+                lines.push(`${t.description}\n`);
+            if (t.definition) {
+                lines.push('```ts', `type ${t.name} = ${t.definition}`, '```\n');
+            }
+        }
+        // Enums
+        for (const e of skill.enums) {
+            lines.push(`### ${e.name}\n`);
+            if (e.description)
+                lines.push(`${e.description}\n`);
+            for (const m of e.members) {
+                lines.push(`- \`${m.name}\` = \`${m.value}\` — ${m.description || ''}`);
+            }
+            lines.push('');
+        }
+        // Variables
+        for (const v of skill.variables ?? []) {
+            lines.push(`### ${v.name}\n`);
+            if (v.description)
+                lines.push(`${v.description}\n`);
+            const keyword = v.isConst ? 'const' : 'let';
+            lines.push('```ts', `${keyword} ${v.name}: ${v.type}`, '```\n');
+        }
+        if (skills.length > 1) {
+            lines.push('---\n');
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function truncateDescription(desc) {
+    if (!desc || desc.length <= SUMMARY_DESC_MAX)
+        return desc;
+    const firstSentence = desc.match(/^[^.!?]+[.!?]/)?.[0];
+    if (firstSentence && firstSentence.length <= SUMMARY_DESC_MAX) {
+        return firstSentence;
+    }
+    return desc.slice(0, SUMMARY_DESC_MAX - 3) + '...';
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/llms-txt.js.map

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

package/dist/markdown-parser.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedMarkdownDoc } from './markdown-types.js';
+/**
+ * Parse a markdown document string into a structured `ParsedMarkdownDoc`.
+ *
+ * @param markdown - Raw markdown source text.
+ * @param filePath - File path used for `relativePath`, title fallback, and order fallback.
+ *
+ * @category Parsing
+ */
+export declare function parseMarkdownDoc(markdown: string, filePath: string): ParsedMarkdownDoc;
+//# sourceMappingURL=markdown-parser.d.ts.map

package/dist/markdown-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../src/markdown-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,qBAAqB,CAAC;AA0N5E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAqCtF"}

package/dist/markdown-parser.js

@@ -0,0 +1,222 @@
+// ─── Frontmatter ──────────────────────────────────────────────────────────────
+/**
+ * Extract YAML frontmatter from the top of a markdown string.
+ * Returns the parsed key-value pairs and the remaining body, or undefined
+ * frontmatter when no frontmatter block is present.
+ */
+function extractFrontmatter(markdown) {
+    const FM_OPEN = /^---\r?\n/;
+    if (!FM_OPEN.test(markdown)) {
+        return { frontmatter: undefined, body: markdown };
+    }
+    const closeIdx = markdown.indexOf('\n---\n', 3);
+    if (closeIdx === -1) {
+        return { frontmatter: undefined, body: markdown };
+    }
+    const fmText = markdown.slice(4, closeIdx); // skip leading "---\n"
+    const body = markdown.slice(closeIdx + 5); // skip "\n---\n"
+    const frontmatter = {};
+    for (const line of fmText.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        if (!key)
+            continue;
+        let value = line.slice(colonIdx + 1).trim();
+        // Strip surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Coerce numeric
+        if (value !== '' && !Number.isNaN(Number(value))) {
+            frontmatter[key] = Number(value);
+        }
+        else {
+            frontmatter[key] = value;
+        }
+    }
+    return { frontmatter, body };
+}
+// ─── Title ────────────────────────────────────────────────────────────────────
+/** Convert a kebab-case basename (without extension) to Title Case. */
+function filenameToTitle(filePath) {
+    const basename = filePath.split('/').pop() ?? filePath;
+    const withoutExt = basename.replace(/\.[^.]+$/, '');
+    // Strip leading numeric prefix like "01-", "003-"
+    const stripped = withoutExt.replace(/^\d+-/, '');
+    return stripped
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/** Extract the text of the first `# heading` from a body string, or undefined. */
+function extractFirstH1(body) {
+    for (const line of body.split('\n')) {
+        const m = line.match(/^#\s+(.+)/);
+        if (m)
+            return m[1]?.trim();
+    }
+    return undefined;
+}
+// ─── Description ─────────────────────────────────────────────────────────────
+/**
+ * Extract the first prose paragraph that appears after the first `# heading`.
+ * Returns undefined when none found.
+ */
+function extractFirstParagraph(body) {
+    const lines = body.split('\n');
+    let pastFirstHeading = false;
+    const paraLines = [];
+    let inPara = false;
+    for (const line of lines) {
+        // Detect any heading
+        if (/^#{1,6}\s/.test(line)) {
+            if (!pastFirstHeading) {
+                pastFirstHeading = true;
+                continue;
+            }
+            // Any subsequent heading ends the paragraph search
+            if (inPara || pastFirstHeading)
+                break;
+            continue;
+        }
+        if (!pastFirstHeading)
+            continue;
+        const trimmed = line.trim();
+        if (trimmed === '') {
+            if (inPara)
+                break; // blank line ends paragraph
+            continue;
+        }
+        inPara = true;
+        paraLines.push(trimmed);
+    }
+    if (paraLines.length === 0)
+        return undefined;
+    return paraLines.join(' ');
+}
+// ─── Sections ─────────────────────────────────────────────────────────────────
+/** Return the heading level (number of leading `#`) or 0 if not a heading. */
+function headingLevel(line) {
+    const m = line.match(/^(#{1,6})\s/);
+    return m ? (m[1]?.length ?? 0) : 0;
+}
+/** Extract the heading text from a heading line. */
+function headingText(line) {
+    return line.replace(/^#{1,6}\s+/, '').trim();
+}
+/**
+ * Split content into a prose part and a list of fenced code blocks.
+ * Code blocks are stripped from the prose.
+ */
+function splitContentAndCode(raw) {
+    const codeBlocks = [];
+    const lines = raw.split('\n');
+    const proseLines = [];
+    let inCode = false;
+    let currentBlock = [];
+    for (const line of lines) {
+        if (!inCode && line.startsWith('```')) {
+            inCode = true;
+            currentBlock = [line];
+            continue;
+        }
+        if (inCode) {
+            if (/^```\s*$/.test(line)) {
+                currentBlock.push(line);
+                codeBlocks.push(currentBlock.join('\n'));
+                currentBlock = [];
+                inCode = false;
+            }
+            else {
+                currentBlock.push(line);
+            }
+            continue;
+        }
+        proseLines.push(line);
+    }
+    // Unclosed code block — treat as a code block anyway
+    if (inCode && currentBlock.length > 0) {
+        codeBlocks.push(currentBlock.join('\n'));
+    }
+    return { content: proseLines.join('\n').trim(), codeBlocks };
+}
+/**
+ * Extract all `##`+ level sections from a markdown body.
+ * Each section spans from its heading to the next heading of the same or
+ * higher level (lower number = higher level).
+ */
+function extractSections(body) {
+    const lines = body.split('\n');
+    const sections = [];
+    const headings = [];
+    for (let i = 0; i < lines.length; i++) {
+        const lvl = headingLevel(lines[i] ?? '');
+        if (lvl >= 2) {
+            headings.push({ idx: i, level: lvl, text: headingText(lines[i] ?? '') });
+        }
+    }
+    for (let h = 0; h < headings.length; h++) {
+        const current = headings[h];
+        // Find the next heading that is at the same or higher level
+        let endIdx = lines.length;
+        for (let k = h + 1; k < headings.length; k++) {
+            if (headings[k].level <= current.level) {
+                endIdx = headings[k].idx;
+                break;
+            }
+        }
+        const rawContent = lines.slice(current.idx + 1, endIdx).join('\n');
+        const { content, codeBlocks } = splitContentAndCode(rawContent);
+        sections.push({ heading: current.text, level: current.level, content, codeBlocks });
+    }
+    return sections;
+}
+// ─── Sort order ───────────────────────────────────────────────────────────────
+/** Derive sort order from filename numeric prefix, e.g. "03-setup.md" → 3. */
+function orderFromFilename(filePath) {
+    const basename = filePath.split('/').pop() ?? filePath;
+    const m = basename.match(/^(\d+)-/);
+    return m ? Number(m[1]) : Infinity;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Parse a markdown document string into a structured `ParsedMarkdownDoc`.
+ *
+ * @param markdown - Raw markdown source text.
+ * @param filePath - File path used for `relativePath`, title fallback, and order fallback.
+ *
+ * @category Parsing
+ */
+export function parseMarkdownDoc(markdown, filePath) {
+    const { frontmatter, body } = extractFrontmatter(markdown);
+    // Title: frontmatter.title > first # heading > filename
+    const fmTitle = frontmatter?.['title'] !== undefined && frontmatter['title'] !== ''
+        ? String(frontmatter['title'])
+        : undefined;
+    const title = fmTitle ?? extractFirstH1(body) ?? filenameToTitle(filePath);
+    // Description: frontmatter.description > first paragraph after first heading
+    const fmDescription = frontmatter?.['description'] !== undefined && frontmatter['description'] !== ''
+        ? String(frontmatter['description'])
+        : undefined;
+    const description = fmDescription ?? extractFirstParagraph(body);
+    // Sections
+    const sections = extractSections(body);
+    // Order: frontmatter.sidebar_position > filename prefix > Infinity
+    const fmOrder = frontmatter?.['sidebar_position'] !== undefined
+        ? Number(frontmatter['sidebar_position'])
+        : undefined;
+    const order = fmOrder !== undefined && !Number.isNaN(fmOrder) ? fmOrder : orderFromFilename(filePath);
+    return {
+        frontmatter,
+        title,
+        description,
+        relativePath: filePath,
+        sections,
+        rawContent: body,
+        order
+    };
+}
+//# sourceMappingURL=markdown-parser.js.map

package/dist/markdown-parser.js.map

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

package/dist/markdown-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A single section extracted from a markdown document, corresponding to one
+ * heading and all content that follows it until the next heading.
+ */
+export interface ParsedSection {
+    /** The text content of the section heading, without the `#` prefix characters */
+    heading: string;
+    /** The heading depth: 1 for `#`, 2 for `##`, 3 for `###`, etc. */
+    level: number;
+    /** All prose content within the section, excluding code blocks */
+    content: string;
+    /** Source text of every fenced code block found within the section */
+    codeBlocks: string[];
+}
+/**
+ * A fully parsed markdown document with structured metadata and sections.
+ */
+export interface ParsedMarkdownDoc {
+    /** Parsed YAML/TOML front-matter key-value pairs, or `undefined` if the document has none */
+    frontmatter: Record<string, unknown> | undefined;
+    /** Document title, typically derived from the first `#`-level heading or front-matter */
+    title: string;
+    /** Short description of the document, or `undefined` if none could be determined */
+    description: string | undefined;
+    /** File path to the document relative to the docs root directory */
+    relativePath: string;
+    /** Ordered list of sections extracted from the document body */
+    sections: ParsedSection[];
+    /** Original unmodified markdown source text of the document */
+    rawContent: string;
+    /** Zero-based sort order used to sequence this document within a collection */
+    order: number;
+}
+/**
+ * Configuration options that control how a docs directory is scanned and which
+ * markdown files are included in the extraction.
+ */
+export interface DocsExtractionOptions {
+    /** Absolute or relative path to the directory containing markdown documentation files */
+    docsDir: string;
+    /** Glob pattern selecting files to include; when `undefined` all `.md` files are included */
+    include: string | undefined;
+    /** Glob patterns for files to exclude from extraction; `undefined` means no exclusions */
+    exclude: string[] | undefined;
+    /** Maximum number of documents to return; `undefined` means no limit */
+    maxDocs: number | undefined;
+}
+//# sourceMappingURL=markdown-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-types.d.ts","sourceRoot":"","sources":["../src/markdown-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0FAA0F;IAC1F,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B"}

package/dist/markdown-types.js

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

package/dist/markdown-types.js.map

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

package/dist/readme-parser.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedReadme } from './audit-types.js';
+/**
+ * Parse a README markdown string and extract structured sections.
+ *
+ * Extraction rules:
+ * - **blockquote** – first `> …` line between `# title` and the first `## heading`.
+ * - **firstParagraph** – first prose lines before the first `## heading` that are
+ *   not a heading, badge (`[![`), image (`![`), blockquote, or blank.
+ *   Consecutive lines are joined with a single space.
+ * - **quickStart** – content under `## Quick Start`, `## Usage`, or `## Getting Started`.
+ * - **features** – content under `## Features`, `## Key Features`, or `## Highlights`.
+ * - **troubleshooting** – content under `## Troubleshooting`, `## Common Issues`, `## Common Errors`,
+ *   or `## FAQ`.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You need structured README sections for audit context or skill enrichment
+ * - The audit engine calls this to check for Features and Troubleshooting sections
+ */
+export declare function parseReadme(markdown: string): ParsedReadme;
+//# sourceMappingURL=readme-parser.d.ts.map

package/dist/readme-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-parser.d.ts","sourceRoot":"","sources":["../src/readme-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4CrD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuF1D"}