tailwindcss-docs-mcp 1.0.0

package/dist/storage/search.d.ts

@@ -0,0 +1,84 @@
+import type { Embedder } from "../pipeline/embedder.js";
+import type { TailwindVersion } from "../utils/config.js";
+import { type ChunkRow, type Database } from "./database.js";
+/**
+ * Invalidate the in-process chunk embedding cache for a specific version,
+ * or all versions if none specified.
+ */
+export declare function invalidateChunkCache(version?: TailwindVersion): void;
+/**
+ * A search result with score and metadata.
+ */
+export interface SearchResult {
+    /** Combined relevance score, normalized so the top result = 1.0 */
+    score: number;
+    /** Chunk heading breadcrumb */
+    heading: string;
+    /** Chunk content (clean markdown) */
+    content: string;
+    /** Deep link to tailwindcss.com */
+    url: string;
+    /** Parent document title */
+    docTitle: string;
+}
+/**
+ * Options for search operations.
+ */
+export interface SearchOptions {
+    /** Search query string */
+    query: string;
+    /** Tailwind CSS version to search */
+    version: TailwindVersion;
+    /** Maximum number of results (default: 5) */
+    limit?: number;
+}
+/**
+ * Internal representation of a scored chunk during search.
+ */
+export interface ScoredChunk {
+    chunk: ChunkRow;
+    semanticScore: number;
+    keywordScore: number;
+    fusedScore: number;
+}
+/**
+ * Weights for reciprocal rank fusion.
+ * Default 1.0/1.0 produces standard unweighted RRF.
+ */
+export interface FusionWeights {
+    semantic: number;
+    keyword: number;
+}
+/**
+ * Perform hybrid semantic + keyword search across indexed documentation.
+ *
+ * Strategy:
+ * 1. Semantic search: embed query -> cosine similarity against all chunk embeddings
+ * 2. Keyword search: FTS5 query for exact class name matches
+ * 3. Merge and rank: combine results, dedup by chunk ID, sort by fused score
+ */
+export declare function hybridSearch(db: Database, embedder: Embedder, options: SearchOptions): Promise<SearchResult[]>;
+/**
+ * Perform semantic-only search using cosine similarity.
+ *
+ * Embeds the query with the snowflake-arctic-embed-xs query prefix,
+ * then computes cosine similarity against all stored chunk embeddings.
+ */
+export declare function semanticSearch(embedder: Embedder, chunks: ChunkRow[], query: string, limit: number): Promise<ScoredChunk[]>;
+/**
+ * Perform keyword-only search using SQLite FTS5.
+ *
+ * Useful for exact class name lookups (e.g., "px-4", "grid-cols-3").
+ */
+export declare function keywordSearch(db: Database, query: string, version: TailwindVersion, limit: number): ScoredChunk[];
+/**
+ * Fuse semantic and keyword scores into a single ranking.
+ *
+ * Uses reciprocal rank fusion (RRF) to combine results from
+ * both search strategies, deduplicating by chunk ID.
+ *
+ * Formula: score = w_s * 1/(k + rank_semantic) + w_k * 1/(k + rank_keyword)
+ * where k = 60 (standard RRF constant), w_s/w_k = strategy weights
+ */
+export declare function fuseResults(semanticResults: ScoredChunk[], keywordResults: ScoredChunk[], limit: number, weights?: FusionWeights): ScoredChunk[];
+//# sourceMappingURL=search.d.ts.map

package/dist/storage/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/storage/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAmB,MAAM,eAAe,CAAC;AAY9E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAMpE;AASD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,eAAe,CAAC;IACzB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkDzB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAmBxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CAWf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,eAAe,EAAE,WAAW,EAAE,EAC9B,cAAc,EAAE,WAAW,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAA+C,GACvD,WAAW,EAAE,CAoCf"}

package/dist/storage/search.js

@@ -0,0 +1,165 @@
+import { expandQuery } from "../utils/query-expansion.js";
+import { cosineSimilarity } from "../utils/similarity.js";
+import { blobToEmbedding } from "./database.js";
+/** Log a performance warning when brute-force search exceeds this many chunks. */
+const BRUTE_FORCE_WARN_THRESHOLD = 5000;
+/**
+ * In-process cache for chunk embeddings, keyed by version.
+ * Avoids reloading all BLOB data from SQLite on every search request.
+ * Call `invalidateChunkCache()` after indexing to pick up new data.
+ */
+const chunkCache = new Map();
+/**
+ * Invalidate the in-process chunk embedding cache for a specific version,
+ * or all versions if none specified.
+ */
+export function invalidateChunkCache(version) {
+    if (version) {
+        chunkCache.delete(version);
+    }
+    else {
+        chunkCache.clear();
+    }
+}
+/** Multiplier applied to the requested limit for each search strategy.
+ *  Fetching more candidates from each strategy improves fusion quality. */
+const CANDIDATE_MULTIPLIER = 3;
+/** Standard RRF constant. Higher values reduce the impact of rank differences. */
+const RRF_K = 60;
+/**
+ * Perform hybrid semantic + keyword search across indexed documentation.
+ *
+ * Strategy:
+ * 1. Semantic search: embed query -> cosine similarity against all chunk embeddings
+ * 2. Keyword search: FTS5 query for exact class name matches
+ * 3. Merge and rank: combine results, dedup by chunk ID, sort by fused score
+ */
+export async function hybridSearch(db, embedder, options) {
+    const { query, version, limit = 5 } = options;
+    if (!query.trim())
+        return [];
+    // Expand query: map class prefixes to CSS property names (e.g., text-lg → font size)
+    const expandedQuery = expandQuery(query);
+    let chunks = chunkCache.get(version);
+    if (!chunks) {
+        chunks = db.getAllChunksWithEmbeddings(version);
+        chunkCache.set(version, chunks);
+    }
+    if (chunks.length > BRUTE_FORCE_WARN_THRESHOLD) {
+        console.warn(`[tailwindcss-docs-mcp] ${chunks.length} chunks loaded for brute-force semantic search. Consider optimizing for large corpora.`);
+    }
+    if (chunks.length === 0)
+        return [];
+    const fetchLimit = limit * CANDIDATE_MULTIPLIER;
+    // keywordSearch is synchronous but wrapped in Promise.all alongside the async
+    // semanticSearch for uniform destructuring. No performance impact — sync
+    // functions in Promise.all resolve in the same microtask.
+    const [semantic, keyword] = await Promise.all([
+        semanticSearch(embedder, chunks, expandedQuery, fetchLimit),
+        keywordSearch(db, expandedQuery, version, fetchLimit),
+    ]);
+    // Boost keyword weight when query contains Tailwind class names (e.g., text-lg, pt-6)
+    const hasClassNames = /\b[a-z]+(?:-[a-z0-9]+)+\b/.test(query);
+    const weights = hasClassNames
+        ? { semantic: 1.0, keyword: 1.5 }
+        : { semantic: 1.0, keyword: 1.0 };
+    const fused = fuseResults(semantic, keyword, limit, weights);
+    // Normalize fused scores to 0-1 range (top result = 1.0)
+    const maxScore = fused[0]?.fusedScore ?? 1;
+    return fused.map((scored) => {
+        const doc = db.getDocById(scored.chunk.doc_id);
+        return {
+            score: maxScore > 0 ? scored.fusedScore / maxScore : 0,
+            heading: scored.chunk.heading,
+            content: scored.chunk.content,
+            url: scored.chunk.url,
+            docTitle: doc?.title ?? "",
+        };
+    });
+}
+/**
+ * Perform semantic-only search using cosine similarity.
+ *
+ * Embeds the query with the snowflake-arctic-embed-xs query prefix,
+ * then computes cosine similarity against all stored chunk embeddings.
+ */
+export async function semanticSearch(embedder, chunks, query, limit) {
+    const queryEmbedding = await embedder.embed(query, { isQuery: true });
+    return chunks
+        .flatMap((chunk) => {
+        if (chunk.embedding === null)
+            return [];
+        const chunkEmbedding = blobToEmbedding(chunk.embedding);
+        const score = cosineSimilarity(queryEmbedding, chunkEmbedding);
+        return [
+            {
+                chunk,
+                semanticScore: score,
+                keywordScore: 0,
+                fusedScore: score,
+            },
+        ];
+    })
+        .sort((a, b) => b.semanticScore - a.semanticScore)
+        .slice(0, limit);
+}
+/**
+ * Perform keyword-only search using SQLite FTS5.
+ *
+ * Useful for exact class name lookups (e.g., "px-4", "grid-cols-3").
+ */
+export function keywordSearch(db, query, version, limit) {
+    const ftsChunks = db.searchFts(query, version, limit);
+    return ftsChunks.map((chunk, index) => ({
+        chunk,
+        semanticScore: 0,
+        // keywordScore reflects FTS5 rank order for inspection/debugging.
+        // It is NOT used in fusion — RRF uses position-based ranks instead.
+        keywordScore: 1 / (index + 1),
+        fusedScore: 0,
+    }));
+}
+/**
+ * Fuse semantic and keyword scores into a single ranking.
+ *
+ * Uses reciprocal rank fusion (RRF) to combine results from
+ * both search strategies, deduplicating by chunk ID.
+ *
+ * Formula: score = w_s * 1/(k + rank_semantic) + w_k * 1/(k + rank_keyword)
+ * where k = 60 (standard RRF constant), w_s/w_k = strategy weights
+ */
+export function fuseResults(semanticResults, keywordResults, limit, weights = { semantic: 1.0, keyword: 1.0 }) {
+    const chunkMap = new Map();
+    // Assign semantic RRF scores (1-indexed ranks)
+    for (let i = 0; i < semanticResults.length; i++) {
+        const rank = i + 1;
+        const rrf = weights.semantic * (1 / (RRF_K + rank));
+        const { chunk } = semanticResults[i];
+        const entry = chunkMap.get(chunk.id) ?? {
+            chunk,
+            semanticScore: 0,
+            keywordScore: 0,
+            fusedScore: 0,
+        };
+        entry.fusedScore += rrf;
+        entry.semanticScore = semanticResults[i].semanticScore;
+        chunkMap.set(chunk.id, entry);
+    }
+    // Assign keyword RRF scores
+    for (let i = 0; i < keywordResults.length; i++) {
+        const rank = i + 1;
+        const rrf = weights.keyword * (1 / (RRF_K + rank));
+        const { chunk } = keywordResults[i];
+        const entry = chunkMap.get(chunk.id) ?? {
+            chunk,
+            semanticScore: 0,
+            keywordScore: 0,
+            fusedScore: 0,
+        };
+        entry.fusedScore += rrf;
+        entry.keywordScore = keywordResults[i].keywordScore;
+        chunkMap.set(chunk.id, entry);
+    }
+    return [...chunkMap.values()].sort((a, b) => b.fusedScore - a.fusedScore).slice(0, limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/storage/search.js.map

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

package/dist/tools/check-status.d.ts

@@ -0,0 +1,35 @@
+import type { EmbedderStatus } from "../server.js";
+import type { Database, IndexStatus } from "../storage/database.js";
+import type { TailwindVersion } from "../utils/config.js";
+/**
+ * Input parameters for the check_status MCP tool.
+ */
+export interface CheckStatusInput {
+    /** Check specific version. Omit to check all. */
+    version?: TailwindVersion;
+}
+/**
+ * Result of the check_status operation.
+ */
+export interface CheckStatusResult {
+    /** Whether any version is indexed */
+    indexed: boolean;
+    /** Status for each requested version */
+    versions: IndexStatus[];
+    /** Current embedder loading status */
+    embedderStatus: EmbedderStatus;
+    /** Human-readable status message */
+    message: string;
+}
+/**
+ * Handle the `check_status` MCP tool call.
+ *
+ * Reports the current index state without triggering any work.
+ * Returns doc/chunk counts, embedding model used, and last indexed timestamp.
+ */
+export declare function handleCheckStatus(input: CheckStatusInput, db: Database, embedderStatus: EmbedderStatus): CheckStatusResult;
+/**
+ * Format the status as markdown for LLM consumption.
+ */
+export declare function formatStatus(indexed: boolean, versions: IndexStatus[], embedderStatus: EmbedderStatus): string;
+//# sourceMappingURL=check-status.d.ts.map

package/dist/tools/check-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-status.d.ts","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sCAAsC;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,cAAc,GAC7B,iBAAiB,CAOnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,WAAW,EAAE,EACvB,cAAc,EAAE,cAAc,GAC7B,MAAM,CA2BR"}

package/dist/tools/check-status.js

@@ -0,0 +1,40 @@
+/**
+ * Handle the `check_status` MCP tool call.
+ *
+ * Reports the current index state without triggering any work.
+ * Returns doc/chunk counts, embedding model used, and last indexed timestamp.
+ */
+export function handleCheckStatus(input, db, embedderStatus) {
+    const versions = db.getIndexStatus(input.version);
+    const indexed = versions.length > 0;
+    const message = formatStatus(indexed, versions, embedderStatus);
+    return { indexed, versions, embedderStatus, message };
+}
+/**
+ * Format the status as markdown for LLM consumption.
+ */
+export function formatStatus(indexed, versions, embedderStatus) {
+    const lines = ["# Tailwind CSS Documentation Index Status\n"];
+    // Embedding model status
+    const statusLabels = {
+        pending: "initializing",
+        downloading: "downloading (~27 MB)",
+        ready: "ready",
+        failed: "failed to load",
+    };
+    lines.push(`**Embedding model**: ${statusLabels[embedderStatus]}\n`);
+    if (!indexed) {
+        lines.push("Not indexed. Run fetch_docs to index Tailwind CSS documentation.");
+        return lines.join("\n");
+    }
+    for (const v of versions) {
+        lines.push(`## ${v.version}`);
+        lines.push(`- **Documents**: ${v.doc_count}`);
+        lines.push(`- **Chunks**: ${v.chunk_count}`);
+        lines.push(`- **Model**: ${v.embedding_model} (${v.embedding_dimensions} dimensions)`);
+        lines.push(`- **Last indexed**: ${v.indexed_at}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=check-status.js.map

package/dist/tools/check-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-status.js","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AA0BA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAuB,EACvB,EAAY,EACZ,cAA8B;IAE9B,MAAM,QAAQ,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEhE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,QAAuB,EACvB,cAA8B;IAE9B,MAAM,KAAK,GAAa,CAAC,6CAA6C,CAAC,CAAC;IAExE,yBAAyB;IACzB,MAAM,YAAY,GAAmC;QACnD,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,sBAAsB;QACnC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,gBAAgB;KACzB,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,wBAAwB,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAErE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,eAAe,KAAK,CAAC,CAAC,oBAAoB,cAAc,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/fetch-docs.d.ts

@@ -0,0 +1,42 @@
+import type { Embedder } from "../pipeline/embedder.js";
+import type { Database } from "../storage/database.js";
+import type { Config, TailwindVersion } from "../utils/config.js";
+/**
+ * Input parameters for the fetch_docs MCP tool.
+ */
+export interface FetchDocsInput {
+    /** Tailwind CSS major version (default: "v4") */
+    version?: TailwindVersion;
+    /** Force re-download and re-index even if already cached (default: false) */
+    force?: boolean;
+}
+/**
+ * Result of the fetch_docs operation.
+ */
+export interface FetchDocsResult {
+    /** Status message describing what happened */
+    message: string;
+    /** Number of documents processed */
+    docCount: number;
+    /** Number of chunks created */
+    chunkCount: number;
+    /** Time taken in milliseconds */
+    durationMs: number;
+}
+/**
+ * Handle the `fetch_docs` MCP tool call.
+ *
+ * Orchestrates the full pipeline:
+ * 1. Fetch MDX files from GitHub (or use cache)
+ * 2. Parse MDX into clean markdown
+ * 3. Chunk documents by headings
+ * 4. Generate embeddings via ONNX
+ * 5. Store chunks and embeddings in SQLite
+ *
+ * Uses content hashing (SHA-256) for incremental re-indexing:
+ * unchanged chunks are not re-embedded.
+ *
+ * Serialized: concurrent calls are queued to prevent data corruption.
+ */
+export declare function handleFetchDocs(input: FetchDocsInput, config: Config, db: Database, embedder: Embedder): Promise<FetchDocsResult>;
+//# sourceMappingURL=fetch-docs.d.ts.map

package/dist/tools/fetch-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-docs.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-docs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/dist/tools/fetch-docs.js

@@ -0,0 +1,98 @@
+import { chunkDocument } from "../pipeline/chunker.js";
+import { buildEmbeddingInput } from "../pipeline/embedder.js";
+import { fetchDocs, readCachedDocs } from "../pipeline/fetcher.js";
+import { parseMdx } from "../pipeline/parser.js";
+import { invalidateChunkCache } from "../storage/search.js";
+/**
+ * Mutex to serialize concurrent fetch_docs calls.
+ * Prevents deleteOrphanedChunks from racing with inserts from another call.
+ */
+let fetchLock = Promise.resolve();
+/**
+ * Handle the `fetch_docs` MCP tool call.
+ *
+ * Orchestrates the full pipeline:
+ * 1. Fetch MDX files from GitHub (or use cache)
+ * 2. Parse MDX into clean markdown
+ * 3. Chunk documents by headings
+ * 4. Generate embeddings via ONNX
+ * 5. Store chunks and embeddings in SQLite
+ *
+ * Uses content hashing (SHA-256) for incremental re-indexing:
+ * unchanged chunks are not re-embedded.
+ *
+ * Serialized: concurrent calls are queued to prevent data corruption.
+ */
+export async function handleFetchDocs(input, config, db, embedder) {
+    let releaseLock;
+    const acquired = new Promise((resolve) => {
+        releaseLock = resolve;
+    });
+    const prev = fetchLock;
+    fetchLock = acquired;
+    await prev;
+    try {
+        return await doFetchDocs(input, config, db, embedder);
+    }
+    finally {
+        releaseLock();
+    }
+}
+async function doFetchDocs(input, config, db, embedder) {
+    const start = Date.now();
+    const version = input.version ?? config.defaultVersion;
+    const force = input.force ?? false;
+    // Step 1: Fetch from GitHub (or use cache)
+    const fetchResult = await fetchDocs(config, { version, force });
+    // Step 1b: Read cached files
+    const rawFiles = readCachedDocs(config, version);
+    if (rawFiles.length === 0) {
+        return {
+            message: "No documentation files found.",
+            docCount: 0,
+            chunkCount: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+    let totalChunks = 0;
+    // Process each document
+    for (const file of rawFiles) {
+        // Step 2: Parse MDX → clean markdown
+        const doc = parseMdx(file.content, file.slug, version);
+        // Step 3: Upsert document
+        const docId = db.upsertDoc(doc);
+        // Step 4: Chunk
+        const chunks = chunkDocument(doc);
+        const validHashes = new Set();
+        for (const chunk of chunks) {
+            const hash = chunk.id; // chunk.id is the content hash
+            validHashes.add(hash);
+            // Check if chunk already exists with same hash (skip re-embedding)
+            const existing = db.getChunkByHash(hash, docId);
+            if (existing?.embedding && !force) {
+                continue;
+            }
+            // Step 5: Embed
+            const embeddingInput = buildEmbeddingInput(doc.title, chunk.heading, chunk.content);
+            const embedding = await embedder.embed(embeddingInput);
+            // Step 6: Store
+            db.upsertChunk(chunk, docId, embedding);
+        }
+        // Clean up orphaned chunks
+        db.deleteOrphanedChunks(docId, validHashes);
+        totalChunks += chunks.length;
+    }
+    // Update index status
+    db.updateIndexStatus(version, config.embeddingModel, config.embeddingDimensions);
+    // Invalidate search cache so the next query picks up new embeddings
+    invalidateChunkCache(version);
+    const durationMs = Date.now() - start;
+    const partial = fetchResult.skipped > 0 ? ` (${fetchResult.skipped} files failed to fetch)` : "";
+    return {
+        message: `Indexed ${rawFiles.length} documents with ${totalChunks} chunks in ${durationMs}ms.${partial}`,
+        docCount: rawFiles.length,
+        chunkCount: totalChunks,
+        durationMs,
+    };
+}
+//# sourceMappingURL=fetch-docs.js.map

package/dist/tools/fetch-docs.js.map

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

package/dist/tools/list-utilities.d.ts

@@ -0,0 +1,49 @@
+import type { Database } from "../storage/database.js";
+import type { TailwindVersion } from "../utils/config.js";
+/**
+ * Input parameters for the list_utilities MCP tool.
+ */
+export interface ListUtilitiesInput {
+    /** Filter by category name (e.g., "layout", "spacing", "typography"). Omit to list all. */
+    category?: string;
+    /** Tailwind CSS major version (default: "v4") */
+    version?: TailwindVersion;
+}
+/**
+ * A utility entry in the list response.
+ */
+export interface UtilityEntry {
+    /** Document title */
+    title: string;
+    /** Document description */
+    description: string;
+    /** URL to the documentation page */
+    url: string;
+    /** Category this utility belongs to */
+    category: string;
+}
+/**
+ * Result of the list_utilities operation.
+ */
+export interface ListUtilitiesResult {
+    /** Grouped utility entries */
+    categories: Array<{
+        name: string;
+        description: string;
+        utilities: UtilityEntry[];
+    }>;
+}
+/**
+ * Handle the `list_utilities` MCP tool call.
+ *
+ * Lists all Tailwind CSS utility categories and their documentation pages.
+ * Optionally filters by category name (case-insensitive).
+ * Returns category metadata from the static mapping, enriched with
+ * indexed document titles and descriptions when available.
+ */
+export declare function handleListUtilities(input: ListUtilitiesInput, db: Database, defaultVersion: TailwindVersion): ListUtilitiesResult;
+/**
+ * Format the utility list as markdown for LLM consumption.
+ */
+export declare function formatUtilitiesList(result: ListUtilitiesResult): string;
+//# sourceMappingURL=list-utilities.d.ts.map

package/dist/tools/list-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-utilities.d.ts","sourceRoot":"","sources":["../../src/tools/list-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,eAAe,GAC9B,mBAAmB,CA0BrB;AAYD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAoBvE"}

package/dist/tools/list-utilities.js

@@ -0,0 +1,63 @@
+import { UTILITY_CATEGORIES, findCategory } from "../utils/categories.js";
+/**
+ * Handle the `list_utilities` MCP tool call.
+ *
+ * Lists all Tailwind CSS utility categories and their documentation pages.
+ * Optionally filters by category name (case-insensitive).
+ * Returns category metadata from the static mapping, enriched with
+ * indexed document titles and descriptions when available.
+ */
+export function handleListUtilities(input, db, defaultVersion) {
+    const version = input.version ?? defaultVersion;
+    let categories;
+    if (input.category) {
+        const match = findCategory(input.category);
+        categories = match ? [match] : [];
+    }
+    else {
+        categories = UTILITY_CATEGORIES;
+    }
+    return {
+        categories: categories.map((cat) => ({
+            name: cat.name,
+            description: cat.description,
+            utilities: cat.slugs.map((slug) => {
+                const doc = db.getDoc(slug, version);
+                return {
+                    title: doc?.title ?? slugToTitle(slug),
+                    description: doc?.description ?? "",
+                    url: doc?.url ?? `https://tailwindcss.com/docs/${slug}`,
+                    category: cat.name,
+                };
+            }),
+        })),
+    };
+}
+/**
+ * Convert a slug to a human-readable title as fallback.
+ */
+function slugToTitle(slug) {
+    return slug
+        .split("-")
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Format the utility list as markdown for LLM consumption.
+ */
+export function formatUtilitiesList(result) {
+    if (result.categories.length === 0) {
+        return "No matching utility categories found.";
+    }
+    const lines = ["# Tailwind CSS Utility Categories\n"];
+    for (const cat of result.categories) {
+        lines.push(`## ${cat.name}`);
+        lines.push(`${cat.description}\n`);
+        for (const util of cat.utilities) {
+            lines.push(`- [${util.title}](${util.url})${util.description ? ` — ${util.description}` : ""}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=list-utilities.js.map

package/dist/tools/list-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-utilities.js","sourceRoot":"","sources":["../../src/tools/list-utilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAwB,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAuChG;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAyB,EACzB,EAAY,EACZ,cAA+B;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC;IAEhD,IAAI,UAA6B,CAAC;IAClC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,kBAAkB,CAAC;IAClC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChC,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACrC,OAAO;oBACL,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC;oBACtC,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,EAAE;oBACnC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,gCAAgC,IAAI,EAAE;oBACvD,QAAQ,EAAE,GAAG,CAAC,IAAI;iBACnB,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,uCAAuC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,qCAAqC,CAAC,CAAC;IAEhE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACpF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}