tailwindcss-docs-mcp 1.0.0

package/dist/pipeline/embedder.js

@@ -0,0 +1,108 @@
+/**
+ * Build the embedding input string for a chunk.
+ *
+ * Prepends metadata to improve retrieval quality:
+ * - Library context ("Tailwind CSS: {docTitle}")
+ * - Section context (heading breadcrumb)
+ * - Actual content
+ */
+export function buildEmbeddingInput(docTitle, heading, content) {
+    return `Tailwind CSS: ${docTitle}\n\n${heading}\n\n${content}`;
+}
+/**
+ * Normalize a vector to unit length (L2 normalization).
+ */
+export function normalize(vector) {
+    let magnitude = 0;
+    for (let i = 0; i < vector.length; i++) {
+        magnitude += vector[i] * vector[i];
+    }
+    magnitude = Math.sqrt(magnitude);
+    if (magnitude === 0)
+        return vector;
+    const result = new Float32Array(vector.length);
+    for (let i = 0; i < vector.length; i++) {
+        result[i] = vector[i] / magnitude;
+    }
+    return result;
+}
+/**
+ * Build an Embedder from an already-loaded pipeline extractor.
+ * Extracted for reuse between createEmbedder and loadCachedEmbedder.
+ */
+function buildEmbedder(extractor, config) {
+    async function embed(text, options) {
+        const input = options?.isQuery ? `${config.queryPrefix}${text}` : text;
+        const output = await extractor(input, { pooling: "cls", normalize: false });
+        const list = output.tolist();
+        if (!Array.isArray(list) || !Array.isArray(list[0])) {
+            throw new Error(`Unexpected embedding output shape: expected number[][], got ${typeof list}`);
+        }
+        const data = list[0];
+        if (data.length !== config.embeddingDimensions) {
+            throw new Error(`Embedding dimension mismatch: expected ${config.embeddingDimensions}, got ${data.length}`);
+        }
+        return normalize(new Float32Array(data));
+    }
+    return {
+        embed,
+        async embedBatch(texts, options) {
+            const results = [];
+            for (const text of texts) {
+                results.push(await embed(text, options));
+            }
+            return results;
+        },
+        isReady: () => true,
+    };
+}
+/**
+ * Try to load the embedder from local cache only (no network).
+ * Returns null if the model is not cached or cache is corrupted.
+ *
+ * CONCURRENCY: This function and `createEmbedder` both mutate the shared
+ * `env` singleton from @huggingface/transformers. They must NOT be called
+ * concurrently — always await one before starting the other.
+ */
+export async function loadCachedEmbedder(config) {
+    const { pipeline, env } = await import("@huggingface/transformers");
+    env.cacheDir = config.modelCacheDir;
+    env.allowRemoteModels = false;
+    try {
+        const extractor = await pipeline("feature-extraction", config.embeddingModel, {
+            dtype: "fp32",
+        });
+        return buildEmbedder(extractor, config);
+    }
+    catch (error) {
+        console.error("[tailwindcss-docs-mcp] Cache load failed (will download):", error);
+        return null;
+    }
+    finally {
+        env.allowRemoteModels = true;
+    }
+}
+/**
+ * Create an embedder, downloading the model if needed.
+ *
+ * The model (snowflake-arctic-embed-xs) is downloaded on first use and cached locally.
+ * Subsequent calls load from cache (~27 MB model file).
+ *
+ * For search queries, the model requires prepending a specific prefix:
+ * "Represent this sentence for searching relevant passages: "
+ * This is handled automatically when `isQuery: true` is passed to embed().
+ *
+ * CONCURRENCY: This function and `loadCachedEmbedder` both mutate the shared
+ * `env` singleton from @huggingface/transformers. They must NOT be called
+ * concurrently — always await one before starting the other.
+ */
+export async function createEmbedder(config) {
+    const { pipeline, env } = await import("@huggingface/transformers");
+    env.cacheDir = config.modelCacheDir;
+    env.allowRemoteModels = true;
+    const extractor = await pipeline("feature-extraction", config.embeddingModel, {
+        dtype: "fp32",
+    });
+    return buildEmbedder(extractor, config);
+}
+//# sourceMappingURL=embedder.js.map

package/dist/pipeline/embedder.js.map

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

package/dist/pipeline/fetcher.d.ts

@@ -0,0 +1,63 @@
+import type { Config, TailwindVersion } from "../utils/config.js";
+/**
+ * Options for fetching documentation from GitHub.
+ */
+export interface FetchOptions {
+    /** Tailwind CSS major version (maps to branch: master for v3, next for v4) */
+    version: TailwindVersion;
+    /** Force re-fetch even if cached locally */
+    force: boolean;
+}
+/**
+ * Result of a fetch operation.
+ */
+export interface FetchResult {
+    /** Number of MDX files fetched */
+    fileCount: number;
+    /** Directory where raw files were saved */
+    outputDir: string;
+    /** Whether files were fetched from network or loaded from cache */
+    cached: boolean;
+    /** Number of files skipped due to fetch errors (0 when cached) */
+    skipped: number;
+}
+/**
+ * A single raw MDX file fetched from the repository.
+ */
+export interface RawMdxFile {
+    /** Filename without extension (e.g., "padding") */
+    slug: string;
+    /** Raw MDX content */
+    content: string;
+    /** File path relative to docs directory */
+    path: string;
+}
+/**
+ * Fetch Tailwind CSS documentation MDX files from the GitHub repository.
+ *
+ * Uses the GitHub REST API (2 calls) for file discovery, then downloads
+ * raw content from raw.githubusercontent.com (no rate limits, no auth needed).
+ * Files are cached on disk at `~/.tailwindcss-docs-mcp/raw/{version}/`.
+ * Subsequent calls return cached files unless `force: true`.
+ */
+export declare function fetchDocs(config: Config, options: FetchOptions): Promise<FetchResult>;
+/** Maximum concurrent file downloads. */
+export declare const FETCH_CONCURRENCY = 10;
+/** Maximum consecutive fetch failures before aborting. */
+export declare const MAX_CONSECUTIVE_FAILURES = 5;
+/**
+ * Fetch raw file content from raw.githubusercontent.com in parallel batches.
+ * Aborts after MAX_CONSECUTIVE_FAILURES consecutive failures.
+ * Returns counts of successfully fetched and skipped files.
+ */
+export declare function fetchRawFiles(branch: string, files: {
+    path?: string;
+}[], outputDir: string): Promise<{
+    fetched: number;
+    skipped: number;
+}>;
+/**
+ * Read cached MDX files from disk for a given version.
+ */
+export declare function readCachedDocs(config: Config, version: TailwindVersion): RawMdxFile[];
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/pipeline/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/pipeline/fetcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,OAAO,EAAE,eAAe,CAAC;IACzB,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAmCD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2C3F;AAED,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAkC1C;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,UAAU,EAAE,CAYrF"}

package/dist/pipeline/fetcher.js

@@ -0,0 +1,128 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { GITHUB_REPO, VERSION_BRANCH_MAP } from "../utils/config.js";
+const GITHUB_API_BASE = "https://api.github.com";
+const RAW_CONTENT_BASE = "https://raw.githubusercontent.com";
+/**
+ * Fetch JSON from the GitHub REST API with proper headers and optional auth.
+ */
+async function githubApiFetch(path) {
+    const url = `${GITHUB_API_BASE}${path}`;
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "tailwindcss-docs-mcp",
+    };
+    const token = process.env.GITHUB_TOKEN;
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`GitHub API error ${response.status}: ${url}`);
+    }
+    return response.json();
+}
+/**
+ * Fetch Tailwind CSS documentation MDX files from the GitHub repository.
+ *
+ * Uses the GitHub REST API (2 calls) for file discovery, then downloads
+ * raw content from raw.githubusercontent.com (no rate limits, no auth needed).
+ * Files are cached on disk at `~/.tailwindcss-docs-mcp/raw/{version}/`.
+ * Subsequent calls return cached files unless `force: true`.
+ */
+export async function fetchDocs(config, options) {
+    const { version, force } = options;
+    const outputDir = join(config.rawDir, version);
+    // Check cache: if directory exists and has .mdx files, skip unless force
+    if (!force && existsSync(outputDir)) {
+        const cached = readdirSync(outputDir).filter((f) => f.endsWith(".mdx"));
+        if (cached.length > 0) {
+            return { fileCount: cached.length, outputDir, cached: true, skipped: 0 };
+        }
+    }
+    mkdirSync(outputDir, { recursive: true });
+    const branch = VERSION_BRANCH_MAP[version];
+    // Step 1: Get the git tree recursively to list all files (2 API calls)
+    const refData = await githubApiFetch(`/repos/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/git/ref/heads/${branch}`);
+    const commitSha = refData.object.sha;
+    const treeData = await githubApiFetch(`/repos/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/git/trees/${commitSha}?recursive=true`);
+    // Step 2: Filter for MDX files under the docs path
+    const mdxFiles = treeData.tree.filter((item) => item.type === "blob" &&
+        item.path?.startsWith(`${GITHUB_REPO.docsPath}/`) &&
+        item.path.endsWith(".mdx"));
+    // Step 3: Fetch raw file content in parallel batches
+    const blobResult = await fetchRawFiles(branch, mdxFiles, outputDir);
+    return {
+        fileCount: blobResult.fetched,
+        outputDir,
+        cached: false,
+        skipped: blobResult.skipped,
+    };
+}
+/** Maximum concurrent file downloads. */
+export const FETCH_CONCURRENCY = 10;
+/** Maximum consecutive fetch failures before aborting. */
+export const MAX_CONSECUTIVE_FAILURES = 5;
+/** Fetch a single raw file and return its path + content. */
+async function fetchOneRawFile(branch, filePath) {
+    const url = `${RAW_CONTENT_BASE}/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/${branch}/${filePath}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}: ${filePath}`);
+    return { path: filePath, content: await res.text() };
+}
+/** Process settled batch results, writing files and tracking failures. */
+function processBatchResults(results, outputDir, state) {
+    for (const result of results) {
+        if (result.status === "fulfilled") {
+            writeFileSync(join(outputDir, basename(result.value.path)), result.value.content, "utf-8");
+            state.fetched++;
+            state.consecutiveFailures = 0;
+        }
+        else {
+            state.skipped++;
+            state.consecutiveFailures++;
+            const msg = result.reason instanceof Error ? result.reason.message : String(result.reason);
+            console.warn(`[tailwindcss-docs-mcp] Failed to fetch: ${msg}`);
+            if (state.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES)
+                break;
+        }
+    }
+}
+/**
+ * Fetch raw file content from raw.githubusercontent.com in parallel batches.
+ * Aborts after MAX_CONSECUTIVE_FAILURES consecutive failures.
+ * Returns counts of successfully fetched and skipped files.
+ */
+export async function fetchRawFiles(branch, files, outputDir) {
+    const validFiles = files.filter((f) => !!f.path);
+    const state = { fetched: 0, skipped: 0, consecutiveFailures: 0 };
+    for (let i = 0; i < validFiles.length; i += FETCH_CONCURRENCY) {
+        if (state.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
+            console.warn(`[tailwindcss-docs-mcp] Aborting: ${MAX_CONSECUTIVE_FAILURES} consecutive fetch failures.`);
+            break;
+        }
+        const batch = validFiles.slice(i, i + FETCH_CONCURRENCY);
+        const results = await Promise.allSettled(batch.map((file) => fetchOneRawFile(branch, file.path)));
+        processBatchResults(results, outputDir, state);
+    }
+    if (state.skipped > 0) {
+        console.warn(`[tailwindcss-docs-mcp] Skipped ${state.skipped} of ${validFiles.length} files due to fetch errors.`);
+    }
+    return { fetched: state.fetched, skipped: state.skipped };
+}
+/**
+ * Read cached MDX files from disk for a given version.
+ */
+export function readCachedDocs(config, version) {
+    const dir = join(config.rawDir, version);
+    if (!existsSync(dir))
+        return [];
+    const files = readdirSync(dir).filter((f) => f.endsWith(".mdx"));
+    return files.map((filename) => ({
+        slug: basename(filename, ".mdx"),
+        content: readFileSync(join(dir, filename), "utf-8"),
+        path: `${GITHUB_REPO.docsPath}/${filename}`,
+    }));
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/pipeline/fetcher.js.map

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

package/dist/pipeline/parser.d.ts

@@ -0,0 +1,73 @@
+/**
+ * A parsed and cleaned document ready for chunking.
+ */
+export interface CleanDocument {
+    /** URL slug (e.g., "padding", "flex-direction", "dark-mode") */
+    slug: string;
+    /** Document title from frontmatter */
+    title: string;
+    /** Document description from frontmatter */
+    description: string;
+    /** Clean markdown content (JSX and imports stripped) */
+    content: string;
+    /** Full URL to the documentation page */
+    url: string;
+    /** Tailwind CSS version */
+    version: string;
+}
+/**
+ * Frontmatter extracted from an MDX file.
+ */
+export interface Frontmatter {
+    title: string;
+    description: string;
+    [key: string]: unknown;
+}
+/**
+ * Parse raw MDX content into a clean markdown document.
+ *
+ * Processing pipeline:
+ * 1. stripFrontmatter — extract title, description into metadata
+ * 2. stripImportStatements — remove `import ... from ...` lines
+ * 3. stripJsxComponents — remove <Component> tags, keep inner text
+ * 4. normalizeCodeBlocks — strip `{{ filename: '...' }}` metadata
+ * 5. preserveMarkdownStructure — keep headings, lists, code, links
+ */
+export declare function parseMdx(raw: string, slug: string, version: string): CleanDocument;
+/**
+ * Extract frontmatter from raw MDX content.
+ *
+ * Parses YAML frontmatter between `---` delimiters.
+ * Returns the frontmatter data and the remaining content.
+ */
+export declare function stripFrontmatter(raw: string): {
+    frontmatter: Frontmatter;
+    content: string;
+};
+/**
+ * Remove ES module import statements from MDX content.
+ *
+ * Handles both single-line and multi-line imports:
+ * - `import { Tip } from '@/components/Tip'`
+ * - `import utilities from 'utilities?plugin=padding'`
+ */
+export declare function stripImportStatements(content: string): string;
+/**
+ * Remove JSX component tags, optionally preserving inner text content.
+ *
+ * - Self-closing tags: `<TipGood />` -> removed entirely
+ * - Wrapper tags: `<TipGood>Use padding</TipGood>` -> `Use padding`
+ * - Nested tags: `<SnippetGroup><Snippet>...</Snippet></SnippetGroup>` -> content only
+ */
+export declare function stripJsxComponents(content: string): string;
+/**
+ * Normalize code block metadata syntax.
+ *
+ * Strips `{{ filename: '...' }}` annotations from fenced code blocks
+ * while preserving the language identifier and code content.
+ *
+ * Input:  ` ```js {{ filename: 'tailwind.config.js' }} `
+ * Output: ` ```js `
+ */
+export declare function normalizeCodeBlocks(content: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/pipeline/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/pipeline/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAgBlF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,CAuBA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM7D;AAoBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuB1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/pipeline/parser.js

@@ -0,0 +1,127 @@
+/**
+ * Parse raw MDX content into a clean markdown document.
+ *
+ * Processing pipeline:
+ * 1. stripFrontmatter — extract title, description into metadata
+ * 2. stripImportStatements — remove `import ... from ...` lines
+ * 3. stripJsxComponents — remove <Component> tags, keep inner text
+ * 4. normalizeCodeBlocks — strip `{{ filename: '...' }}` metadata
+ * 5. preserveMarkdownStructure — keep headings, lists, code, links
+ */
+export function parseMdx(raw, slug, version) {
+    const { frontmatter, content: afterFrontmatter } = stripFrontmatter(raw);
+    let content = stripImportStatements(afterFrontmatter);
+    content = stripExportStatements(content);
+    content = stripJsxComponents(content);
+    content = normalizeCodeBlocks(content);
+    content = collapseBlankLines(content);
+    return {
+        slug,
+        title: frontmatter.title,
+        description: frontmatter.description,
+        content: content.trim(),
+        url: `https://tailwindcss.com/docs/${slug}`,
+        version,
+    };
+}
+/**
+ * Extract frontmatter from raw MDX content.
+ *
+ * Parses YAML frontmatter between `---` delimiters.
+ * Returns the frontmatter data and the remaining content.
+ */
+export function stripFrontmatter(raw) {
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n?/);
+    if (!match) {
+        return {
+            frontmatter: { title: "", description: "" },
+            content: raw,
+        };
+    }
+    const yamlBlock = match[1];
+    const frontmatter = { title: "", description: "" };
+    for (const line of yamlBlock.split("\n")) {
+        const kvMatch = line.match(/^(\w+):\s*"?(.*?)"?\s*$/);
+        if (kvMatch) {
+            frontmatter[kvMatch[1]] = kvMatch[2];
+        }
+    }
+    return {
+        frontmatter,
+        content: raw.slice(match[0].length),
+    };
+}
+/**
+ * Remove ES module import statements from MDX content.
+ *
+ * Handles both single-line and multi-line imports:
+ * - `import { Tip } from '@/components/Tip'`
+ * - `import utilities from 'utilities?plugin=padding'`
+ */
+export function stripImportStatements(content) {
+    // Single-line imports
+    let result = content.replace(/^import\s+.*from\s+['"].*['"];?\s*$/gm, "");
+    // Default/namespace imports without from
+    result = result.replace(/^import\s+['"].*['"];?\s*$/gm, "");
+    return result;
+}
+/**
+ * Remove ES module export statements from MDX content.
+ *
+ * Handles:
+ * - `export const classes = { ... }`
+ * - Multi-line export blocks
+ */
+function stripExportStatements(content) {
+    // Multi-line export blocks: export const ... = { ... }
+    let result = content.replace(/^export\s+(?:const|let|var|function)\s+[\s\S]*?(?:\n\}|\n\);?)\s*$/gm, "");
+    // Single-line exports
+    result = result.replace(/^export\s+.*$/gm, "");
+    return result;
+}
+/**
+ * Remove JSX component tags, optionally preserving inner text content.
+ *
+ * - Self-closing tags: `<TipGood />` -> removed entirely
+ * - Wrapper tags: `<TipGood>Use padding</TipGood>` -> `Use padding`
+ * - Nested tags: `<SnippetGroup><Snippet>...</Snippet></SnippetGroup>` -> content only
+ */
+export function stripJsxComponents(content) {
+    // Protect code blocks from JSX stripping
+    const codeBlocks = [];
+    let result = content.replace(/```[\s\S]*?```/g, (match) => {
+        codeBlocks.push(match);
+        return `__CODE_BLOCK_${codeBlocks.length - 1}__`;
+    });
+    // Remove self-closing JSX tags: <Component /> or <Component prop="val" />
+    result = result.replace(/<[A-Z][a-zA-Z]*(?:\s+[^>]*)?\s*\/>/g, "");
+    // Remove JSX wrapper tags, keeping inner text (handle nested by repeating)
+    let prev = "";
+    while (prev !== result) {
+        prev = result;
+        // Tags with text content: <Component ...>text</Component>
+        result = result.replace(/<([A-Z][a-zA-Z]*)[^>]*>([\s\S]*?)<\/\1>/g, "$2");
+    }
+    // Restore code blocks
+    result = result.replace(/__CODE_BLOCK_(\d+)__/g, (_, idx) => codeBlocks[Number(idx)]);
+    return result;
+}
+/**
+ * Normalize code block metadata syntax.
+ *
+ * Strips `{{ filename: '...' }}` annotations from fenced code blocks
+ * while preserving the language identifier and code content.
+ *
+ * Input:  ` ```js {{ filename: 'tailwind.config.js' }} `
+ * Output: ` ```js `
+ */
+export function normalizeCodeBlocks(content) {
+    return content.replace(/(```\w*(?:-\w+)*)\s*\{\{[\s\S]*?\}\}/g, "$1");
+}
+/**
+ * Collapse runs of 3+ blank lines into 2.
+ */
+function collapseBlankLines(content) {
+    return content.replace(/\n{3,}/g, "\n\n");
+}
+//# sourceMappingURL=parser.js.map

package/dist/pipeline/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/pipeline/parser.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe;IACjE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzE,IAAI,OAAO,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACtD,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEtC,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACvB,GAAG,EAAE,gCAAgC,IAAI,EAAE;QAC3C,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAI1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC3C,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,WAAW,GAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAEhE,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACtD,IAAI,OAAO,EAAE,CAAC;YACZ,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW;QACX,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,sBAAsB;IACtB,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IAC1E,yCAAyC;IACzC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,uDAAuD;IACvD,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAC1B,sEAAsE,EACtE,EAAE,CACH,CAAC;IACF,sBAAsB;IACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,yCAAyC;IACzC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,gBAAgB,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IAEnE,2EAA2E;IAC3E,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,IAAI,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,GAAG,MAAM,CAAC;QACd,0DAA0D;QAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,0CAA0C,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,sBAAsB;IACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEtF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,OAAO,CAAC,OAAO,CAAC,uCAAuC,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,47 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { Embedder } from "./pipeline/embedder.js";
+import type { Database } from "./storage/database.js";
+import type { Config } from "./utils/config.js";
+/**
+ * MCP tool names exposed by this server.
+ */
+export declare const TOOL_NAMES: {
+    readonly FETCH_DOCS: "fetch_docs";
+    readonly SEARCH_DOCS: "search_docs";
+    readonly LIST_UTILITIES: "list_utilities";
+    readonly CHECK_STATUS: "check_status";
+};
+/**
+ * Embedder loading status for observability.
+ */
+export type EmbedderStatus = "pending" | "downloading" | "ready" | "failed";
+/**
+ * Server dependencies injected at startup.
+ * Embedder may be null if the model is still downloading.
+ */
+export interface ServerDeps {
+    config: Config;
+    db: Database;
+    embedder: Embedder | null;
+}
+/**
+ * Handle returned by createServer for post-initialization updates.
+ */
+export interface ServerHandle {
+    /** Set the embedder once it finishes loading in the background. */
+    setEmbedder(embedder: Embedder): void;
+    /** Update the embedder loading status for observability. */
+    setEmbedderStatus(status: EmbedderStatus): void;
+    /** Get the current embedder loading status. */
+    getEmbedderStatus(): EmbedderStatus;
+}
+export declare const EMBEDDER_STATUS_MESSAGES: Record<EmbedderStatus, string>;
+/**
+ * Create and configure the MCP server with all tool handlers.
+ *
+ * The server starts immediately even if the embedder is not yet available.
+ * Tools that require the embedder (fetch_docs, search_docs) will throw
+ * an error if called before the model has finished loading.
+ */
+export declare function createServer(deps: ServerDeps, transport?: Transport): Promise<ServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,4DAA4D;IAC5D,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,+CAA+C;IAC/C,iBAAiB,IAAI,cAAc,CAAC;CACrC;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKnE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAyIjG"}