tea-rags 0.9.0

package/build/mcp/tools/schemas.js

@@ -0,0 +1,260 @@
+/**
+ * Consolidated Zod schemas for all MCP tools
+ *
+ * Note: Schemas are exported as plain objects (not wrapped in z.object()) because
+ * McpServer.registerTool() expects schemas in this format. The SDK internally
+ * converts these to JSON Schema for the MCP protocol. Each property is a Zod
+ * field definition that gets composed into the final schema by the SDK.
+ *
+ * Search-related schemas (SemanticSearch, HybridSearch, SearchCode) are generated
+ * dynamically via createSearchSchemas(SchemaBuilder) to avoid hardcoded imports
+ * from domain/foundation layers. All other schemas remain static.
+ */
+import { z } from "zod";
+/** Coerce string→number for MCP params (agents sometimes send "5" instead of 5) */
+const coerceNumber = () => z.preprocess((v) => (typeof v === "string" ? Number(v) : v), z.number());
+/** Coerce string→boolean for MCP params (agents sometimes send "true" instead of true) */
+const coerceBoolean = () => z.preprocess((v) => (typeof v === "string" ? v === "true" : v), z.boolean());
+// ---------------------------------------------------------------------------
+// Collection management schemas (static)
+// ---------------------------------------------------------------------------
+export const CreateCollectionSchema = {
+    name: z.string().describe("Name of the collection"),
+    distance: z.enum(["Cosine", "Euclid", "Dot"]).optional().describe("Distance metric (default: Cosine)"),
+    enableHybrid: coerceBoolean().optional().describe("Enable hybrid search with sparse vectors (default: false)"),
+};
+export const DeleteCollectionSchema = {
+    name: z.string().describe("Name of the collection to delete"),
+};
+export const GetCollectionInfoSchema = {
+    name: z.string().describe("Name of the collection"),
+};
+// ---------------------------------------------------------------------------
+// Document operation schemas (static)
+// ---------------------------------------------------------------------------
+export const AddDocumentsSchema = {
+    collection: z.string().describe("Name of the collection"),
+    documents: z
+        .array(z.object({
+        id: z.union([z.string(), z.number()]).describe("Unique identifier for the document"),
+        text: z.string().describe("Text content to embed and store"),
+        metadata: z.record(z.any()).optional().describe("Optional metadata to store with the document"),
+    }))
+        .describe("Array of documents to add"),
+};
+export const DeleteDocumentsSchema = {
+    collection: z.string().describe("Name of the collection"),
+    ids: z.array(z.union([z.string(), z.number()])).describe("Array of document IDs to delete"),
+};
+// ---------------------------------------------------------------------------
+// Code indexing schemas (static)
+// ---------------------------------------------------------------------------
+export const IndexCodebaseSchema = {
+    path: z.string().describe("Absolute or relative path to codebase root directory"),
+    forceReindex: coerceBoolean().optional().describe("Force full re-index even if already indexed (default: false)"),
+    extensions: z.array(z.string()).optional().describe("Custom file extensions to index (e.g., ['.proto', '.graphql'])"),
+    ignorePatterns: z
+        .array(z.string())
+        .optional()
+        .describe("Additional patterns to ignore (e.g., ['**/test/**', '**/*.test.ts'])"),
+};
+export const ReindexChangesSchema = {
+    path: z.string().describe("Path to codebase"),
+};
+export const GetIndexStatusSchema = {
+    path: z.string().describe("Path to codebase"),
+};
+export const ClearIndexSchema = {
+    path: z.string().describe("Path to codebase"),
+};
+// ---------------------------------------------------------------------------
+// Search schemas (dynamic — generated from SchemaBuilder via DIP)
+// ---------------------------------------------------------------------------
+/**
+ * Shared fields for collection/path resolution used in semantic/hybrid search.
+ */
+function collectionPathFields() {
+    return {
+        collection: z.string().optional().describe("Name of the collection to search. Required if 'path' not provided."),
+        path: z
+            .string()
+            .optional()
+            .describe("Path to indexed codebase (alternative to 'collection'). " +
+            "Collection name is auto-resolved from path. Required if 'collection' not provided."),
+    };
+}
+/**
+ * Typed filter params shared across all search tools (semantic, hybrid, search_code, rank_chunks).
+ * These map 1:1 to TypedFilterParams in contracts/types/app.ts.
+ */
+function typedFilterFields() {
+    return {
+        language: z.string().optional().describe("Filter by programming language"),
+        fileExtension: z.string().optional().describe("Filter by file extension (e.g. '.ts')"),
+        chunkType: z.string().optional().describe("Filter by chunk type (function, class, interface, block)"),
+        isDocumentation: coerceBoolean().optional().describe("Include only documentation chunks"),
+        excludeDocumentation: coerceBoolean().optional().describe("Exclude documentation chunks from results"),
+        author: z
+            .string()
+            .optional()
+            .describe("Filter by dominant author (the author with most lines in chunk). " +
+            "Use for: code review, ownership questions, team onboarding, finding expert for code area. " +
+            "Example: 'John Doe'"),
+        modifiedAfter: z
+            .string()
+            .optional()
+            .describe("Filter code modified after this date. Use for: sprint review, release analysis, incident debugging. " +
+            "ISO format: '2024-01-01' or '2024-01-01T00:00:00Z'"),
+        modifiedBefore: z
+            .string()
+            .optional()
+            .describe("Filter code modified before this date. Use for: finding old code, historical debugging, compliance audits. " +
+            "ISO format: '2024-12-31'"),
+        minAgeDays: coerceNumber()
+            .optional()
+            .describe("Filter code older than N days (since last modification). " +
+            "Use for: finding legacy/stale code, tech debt assessment, documentation needs, refactoring candidates."),
+        maxAgeDays: coerceNumber()
+            .optional()
+            .describe("Filter code newer than N days (since last modification). " +
+            "Use for: recent changes review, sprint work, incident response, release notes."),
+        minCommitCount: coerceNumber()
+            .optional()
+            .describe("Filter by minimum number of commits touching the chunk (churn indicator). " +
+            "High churn = problematic areas, bugs, complex requirements. " +
+            "Use for: risk assessment, code quality issues, refactoring priorities."),
+        taskId: z
+            .string()
+            .optional()
+            .describe("Filter by task/issue ID from commit messages. Supports JIRA (TD-1234), GitHub (#567), Azure DevOps (AB#890). " +
+            "Use for: requirements tracing, impact analysis, audit, compliance, 'what code was written for this ticket?'"),
+    };
+}
+/**
+ * Shared fields for query, limit, filter, pathPattern used in semantic/hybrid search.
+ */
+function searchCommonFields() {
+    return {
+        query: z.string().describe("Search query text"),
+        limit: coerceNumber().optional().describe("Maximum number of results (default: 5)"),
+        filter: z
+            .record(z.any())
+            .optional()
+            .describe("Qdrant filter object with must/should/must_not conditions. " +
+            "Available fields for code chunks (index_codebase): " +
+            "relativePath (string), fileExtension (string), language (string), " +
+            "startLine (number), endLine (number), chunkIndex (number), " +
+            "isDocumentation (boolean), name (string), chunkType (string: function|class|interface|block), " +
+            "parentName (string), parentType (string), " +
+            "git.dominantAuthor (string), git.authors (string[]), " +
+            "git.lastModifiedAt (unix timestamp), git.firstCreatedAt (unix timestamp), " +
+            "git.commitCount (number), git.ageDays (number), git.taskIds (string[]), " +
+            "imports (string[] - file-level imports for structural signal). " +
+            "For generic documents (add_documents): user-defined metadata fields."),
+        pathPattern: z
+            .string()
+            .optional()
+            .describe("Glob pattern for filtering by file path (client-side via picomatch). " +
+            "Examples: '**/workflow/**', 'src/**/*.ts', '{models,services}/**'."),
+    };
+}
+/**
+ * Create dynamic search schemas from SchemaBuilder.
+ * Replaces hardcoded imports from trajectory/ and search/structural-signals.
+ */
+export function createSearchSchemas(schemaBuilder) {
+    const semanticSearchRerankSchema = schemaBuilder.buildRerankSchema("semantic_search");
+    const searchCodeRerankSchema = schemaBuilder.buildRerankSchema("search_code");
+    const SemanticSearchSchema = {
+        ...collectionPathFields(),
+        ...searchCommonFields(),
+        ...typedFilterFields(),
+        rerank: semanticSearchRerankSchema
+            .optional()
+            .describe("Reranking mode. Enum: 'relevance' | 'techDebt' | 'hotspots' | 'codeReview' | " +
+            "'onboarding' | 'securityAudit' | 'refactoring' | 'ownership' | 'recent' | 'stable' | {custom: weights}. " +
+            "relevance=default similarity, techDebt=old+churn, hotspots=churn+recent, " +
+            "codeReview=recent, onboarding=docs+stable, securityAudit=old+auth paths, " +
+            "refactoring=large+churn, ownership=single author, recent=boost new, stable=boost stable."),
+        metaOnly: coerceBoolean()
+            .optional()
+            .describe("For code analytics: return only metadata (path, lines, git info) without content. " +
+            "Use for: file discovery, codebase structure analysis, ownership reports, churn analysis. " +
+            "Significantly reduces response size. Default: false."),
+    };
+    const HybridSearchSchema = {
+        ...collectionPathFields(),
+        ...searchCommonFields(),
+        ...typedFilterFields(),
+        rerank: semanticSearchRerankSchema
+            .optional()
+            .describe("Reranking mode. Enum: 'relevance' | 'techDebt' | 'hotspots' | 'codeReview' | " +
+            "'onboarding' | 'securityAudit' | 'refactoring' | 'ownership' | 'recent' | 'stable' | {custom: weights}. " +
+            "relevance=default similarity, techDebt=old+churn, hotspots=churn+recent, " +
+            "codeReview=recent, onboarding=docs+stable, securityAudit=old+auth paths, " +
+            "refactoring=large+churn, ownership=single author, recent=boost new, stable=boost stable."),
+        metaOnly: coerceBoolean()
+            .optional()
+            .describe("For code analytics: return only metadata (path, lines, git info) without content. " +
+            "Use for: file discovery, codebase structure analysis, ownership reports, churn analysis. " +
+            "Significantly reduces response size. Default: false."),
+    };
+    const SearchCodeSchema = {
+        path: z.string().describe("Path to codebase (must be indexed first)"),
+        query: z.string().describe("Natural language search query (e.g., 'authentication logic')"),
+        limit: coerceNumber().optional().describe("Maximum number of results (default: 5, max: 100)"),
+        pathPattern: z
+            .string()
+            .optional()
+            .describe("Glob pattern for filtering by file path (client-side via picomatch). " +
+            "Examples: '**/workflow/**', 'src/**/*.ts', '{models,services}/**'."),
+        ...typedFilterFields(),
+        fileTypes: z.array(z.string()).optional().describe("Filter by file extensions (e.g., ['.ts', '.py'])"),
+        documentationOnly: coerceBoolean()
+            .optional()
+            .describe("Search only in documentation files (markdown, READMEs, etc.). " +
+            "Default: false (search in all files). Set to true to find information in docs only."),
+        rerank: searchCodeRerankSchema
+            .optional()
+            .describe("Reranking mode. Enum: 'relevance' | 'recent' | 'stable' | {custom: weights}. " +
+            "relevance=default similarity, recent=boost recently modified, stable=boost low-churn code."),
+    };
+    const rankChunksRerankSchema = schemaBuilder.buildRerankSchema("rank_chunks");
+    const RankChunksSchema = {
+        ...collectionPathFields(),
+        ...typedFilterFields(),
+        rerank: rankChunksRerankSchema.describe("Reranking mode (REQUIRED). Determines how chunks are scored and sorted. " +
+            "similarity weight is ignored (no vector search). " +
+            "Use decomposition for large chunks, techDebt for old+churned, " +
+            "hotspots for high-churn, refactoring for large+churned, ownership for single-author."),
+        level: z
+            .enum(["chunk", "file"])
+            .describe("Analysis level. 'chunk' for active work (decomposition, hotspots). " +
+            "'file' for tech debt and ownership analysis."),
+        limit: coerceNumber().optional().describe("Maximum number of results (default: 10)"),
+        filter: z
+            .record(z.any())
+            .optional()
+            .describe("Qdrant filter object with must/should/must_not conditions. " +
+            "Available fields: relativePath, fileExtension, language, chunkType, " +
+            "git.commitCount, git.ageDays, etc."),
+        pathPattern: z
+            .string()
+            .optional()
+            .describe("Glob pattern for filtering by file path (client-side via picomatch). " +
+            "Examples: 'src/core/ingest/**', '**/*.ts'"),
+        offset: z.coerce
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .default(0)
+            .describe("Skip first N results (for pagination). Default: 0."),
+        metaOnly: coerceBoolean()
+            .optional()
+            .default(true)
+            .describe("Return only metadata (path, lines, git info) without content. Default: true."),
+    };
+    return { SemanticSearchSchema, HybridSearchSchema, SearchCodeSchema, RankChunksSchema };
+}
+//# sourceMappingURL=schemas.js.map

package/build/mcp/tools/schemas.js.map

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

package/build/mcp/tools/search.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Search tools registration
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { EmbeddingProvider } from "../../core/adapters/embeddings/base.js";
+import type { QdrantManager } from "../../core/adapters/qdrant/client.js";
+import type { SchemaBuilder } from "../../core/api/schema-builder.js";
+import type { SchemaDriftMonitor } from "../../core/api/schema-drift-monitor.js";
+import type { Reranker } from "../../core/search/reranker.js";
+export interface SearchToolDependencies {
+    qdrant: QdrantManager;
+    embeddings: EmbeddingProvider;
+    reranker: Reranker;
+    schemaBuilder: SchemaBuilder;
+    essentialTrajectoryFields: string[];
+    schemaDriftMonitor: SchemaDriftMonitor;
+}
+export declare function registerSearchTools(server: McpServer, deps: SearchToolDependencies): void;
+//# sourceMappingURL=search.d.ts.map

package/build/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAI1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAU9D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAYD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,GAAG,IAAI,CA0LzF"}

package/build/mcp/tools/search.js

@@ -0,0 +1,176 @@
+/**
+ * Search tools registration
+ */
+import { filterResultsByGlob } from "../../core/adapters/qdrant/filters/index.js";
+import { scrollOrderedBy } from "../../core/adapters/qdrant/scroll.js";
+import { BM25SparseVectorGenerator } from "../../core/adapters/qdrant/sparse.js";
+import { RankModule } from "../../core/search/rank-module.js";
+import { applyPostProcessing, formatSearchResults, getSearchFetchLimit, resolveCollectionName, validateCollectionExists, } from "./formatters/search-pipeline.js";
+import { createSearchSchemas } from "./schemas.js";
+function appendDriftWarning(result, driftWarning) {
+    if (!driftWarning || result.content.length === 0)
+        return result;
+    const last = result.content[result.content.length - 1];
+    last.text += `\n\n${driftWarning}`;
+    return result;
+}
+export function registerSearchTools(server, deps) {
+    const { qdrant, embeddings, schemaDriftMonitor } = deps;
+    const searchSchemas = createSearchSchemas(deps.schemaBuilder);
+    // semantic_search
+    server.registerTool("semantic_search", {
+        title: "Semantic Search",
+        description: "Search for documents using natural language queries. Returns the most semantically similar documents.",
+        inputSchema: searchSchemas.SemanticSearchSchema,
+    }, async ({ collection, path, query, limit, filter, pathPattern, rerank, metaOnly }) => {
+        const resolved = resolveCollectionName(collection, path);
+        if ("error" in resolved)
+            return resolved.error;
+        const collectionError = await validateCollectionExists(qdrant, resolved.collectionName, path);
+        if (collectionError)
+            return collectionError;
+        const { embedding } = await embeddings.embed(query);
+        const limits = getSearchFetchLimit(limit, pathPattern, rerank);
+        const results = await qdrant.search(resolved.collectionName, embedding, limits.fetchLimit, filter);
+        const processed = applyPostProcessing(results, {
+            pathPattern,
+            rerank,
+            limit: limits.requestedLimit,
+            reranker: deps.reranker,
+        });
+        const result = formatSearchResults(processed, metaOnly, deps.essentialTrajectoryFields);
+        const driftWarning = path
+            ? await schemaDriftMonitor.checkAndConsume(path)
+            : schemaDriftMonitor.checkByCollectionName(resolved.collectionName);
+        return appendDriftWarning(result, driftWarning);
+    });
+    // hybrid_search
+    server.registerTool("hybrid_search", {
+        title: "Hybrid Search",
+        description: "Perform hybrid search combining semantic vector search with keyword search using BM25. This provides better results by combining the strengths of both approaches. The collection must be created with enableHybrid set to true.",
+        inputSchema: searchSchemas.HybridSearchSchema,
+    }, async ({ collection, path, query, limit, filter, pathPattern, rerank, metaOnly }) => {
+        const resolved = resolveCollectionName(collection, path);
+        if ("error" in resolved)
+            return resolved.error;
+        const collectionError = await validateCollectionExists(qdrant, resolved.collectionName, path);
+        if (collectionError)
+            return collectionError;
+        // Check hybrid support
+        const collectionInfo = await qdrant.getCollectionInfo(resolved.collectionName);
+        if (!collectionInfo.hybridEnabled) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Collection "${resolved.collectionName}" does not have hybrid search enabled. Create a new collection with enableHybrid set to true.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { embedding } = await embeddings.embed(query);
+        const sparseGenerator = new BM25SparseVectorGenerator();
+        const sparseVector = sparseGenerator.generate(query);
+        const limits = getSearchFetchLimit(limit, pathPattern, rerank);
+        const results = await qdrant.hybridSearch(resolved.collectionName, embedding, sparseVector, limits.fetchLimit, filter);
+        const processed = applyPostProcessing(results, {
+            pathPattern,
+            rerank,
+            limit: limits.requestedLimit,
+            reranker: deps.reranker,
+        });
+        const result = formatSearchResults(processed, metaOnly, deps.essentialTrajectoryFields);
+        const driftWarning = path
+            ? await schemaDriftMonitor.checkAndConsume(path)
+            : schemaDriftMonitor.checkByCollectionName(resolved.collectionName);
+        return appendDriftWarning(result, driftWarning);
+    });
+    // rank_chunks
+    const rankModule = new RankModule(deps.reranker, deps.reranker.getDescriptors());
+    server.registerTool("rank_chunks", {
+        title: "Rank Chunks",
+        description: "Rank all chunks in a collection by rerank signals without vector search. " +
+            "Use for: finding decomposition candidates, tech debt analysis, hotspot detection, " +
+            "ownership reports — any analysis where you need top-N chunks by signal, not by query similarity.",
+        inputSchema: searchSchemas.RankChunksSchema,
+    }, async ({ collection, path, rerank, level, limit, offset, filter, pathPattern, metaOnly }) => {
+        const resolved = resolveCollectionName(collection, path);
+        if ("error" in resolved)
+            return resolved.error;
+        const collectionError = await validateCollectionExists(qdrant, resolved.collectionName, path);
+        if (collectionError)
+            return collectionError;
+        // Resolve weights from preset or custom
+        let sourceWeights;
+        if (typeof rerank === "string") {
+            const preset = deps.reranker.getPreset(rerank, "rank_chunks");
+            if (!preset) {
+                return {
+                    content: [{ type: "text", text: `Error: Unknown preset "${rerank}" for rank_chunks.` }],
+                    isError: true,
+                };
+            }
+            sourceWeights = preset;
+        }
+        else {
+            sourceWeights = rerank.custom;
+        }
+        const weights = Object.fromEntries(Object.entries(sourceWeights).filter((e) => typeof e[1] === "number"));
+        const scrollFn = async (col, orderBy, lim, f) => scrollOrderedBy(qdrant, col, orderBy, lim, f);
+        const ensureIndexFn = async (col, fieldName) => {
+            // Determine field type: git fields with counts/days are integer, others are float
+            const isInteger = /count|days|lines/i.test(fieldName);
+            await qdrant.ensurePayloadIndex(col, fieldName, isInteger ? "integer" : "float");
+        };
+        try {
+            const effectiveOffset = offset || 0;
+            const fetchLimit = (limit || 10) + effectiveOffset;
+            // Exclude documentation from reranked results
+            const effectiveFilter = excludeDocumentation(filter);
+            let results = await rankModule.rankChunks(resolved.collectionName, {
+                weights,
+                level,
+                limit: fetchLimit,
+                scrollFn,
+                ensureIndexFn,
+                filter: effectiveFilter,
+                presetName: typeof rerank === "string" ? rerank : undefined,
+            });
+            // Apply pathPattern client-side
+            if (pathPattern) {
+                results = filterResultsByGlob(results, pathPattern);
+            }
+            // Apply offset
+            if (effectiveOffset > 0) {
+                results = results.slice(effectiveOffset);
+            }
+            const result = formatSearchResults(results, metaOnly, deps.essentialTrajectoryFields);
+            const driftWarning = path
+                ? await schemaDriftMonitor.checkAndConsume(path)
+                : schemaDriftMonitor.checkByCollectionName(resolved.collectionName);
+            return appendDriftWarning(result, driftWarning);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error in rank_chunks: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Exclude documentation chunks from reranked results using must_not.
+ * Uses must_not because code chunks don't have isDocumentation field at all —
+ * Qdrant can't match {value: false} on a missing field.
+ */
+function excludeDocumentation(filter) {
+    const docExclusion = { key: "isDocumentation", match: { value: true } };
+    if (!filter) {
+        return { must_not: [docExclusion] };
+    }
+    const mustNot = Array.isArray(filter.must_not) ? [...filter.must_not, docExclusion] : [docExclusion];
+    return { ...filter, must_not: mustNot };
+}
+//# sourceMappingURL=search.js.map

package/build/mcp/tools/search.js.map

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

package/package.json

@@ -0,0 +1,121 @@
+{
+  "name": "tea-rags",
+  "version": "0.9.0",
+  "description": "MCP server for semantic search using local Qdrant and Ollama (default) with support for OpenAI, Cohere, and Voyage AI",
+  "type": "module",
+  "bin": {
+    "tea-rags": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:providers": "node scripts/verify-providers.js",
+    "type-check": "tsc --noEmit",
+    "postinstall": "node scripts/postinstall.js",
+    "prepare": "husky",
+    "test-integration": "node tests/integration/index.mjs",
+    "tune": "node benchmarks/tune.mjs",
+    "benchmark-embeddings": "node benchmarks/benchmark-embeddings.mjs",
+    "benchmark-cpu": "node benchmarks/benchmark-cpu.mjs",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint --fix src/ tests/",
+    "docs:dev": "cd website && npm start",
+    "docs:build": "cd website && npm run build",
+    "docs:deploy": "cd website && npm run deploy"
+  },
+  "keywords": [
+    "mcp",
+    "qdrant",
+    "vector-search",
+    "semantic-search",
+    "embeddings"
+  ],
+  "author": "mhalder",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0 <24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/artk0de/TeaRAGs-MCP.git"
+  },
+  "files": [
+    "build/",
+    "scripts/postinstall.js",
+    "prompts.json"
+  ],
+  "publishConfig": {
+    "provenance": true
+  },
+  "overrides": {
+    "tree-sitter": "^0.25.0"
+  },
+  "optionalDependencies": {
+    "@huggingface/transformers": "^4.0.0-next.6"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@qdrant/js-client-rest": "^1.16.2",
+    "bottleneck": "^2.19.5",
+    "cohere-ai": "^7.20.0",
+    "diff": "^8.0.3",
+    "express": "^5.2.1",
+    "ignore": "^7.0.5",
+    "isomorphic-git": "^1.36.3",
+    "openai": "^4.104.0",
+    "picomatch": "^4.0.3",
+    "remark": "^15.0.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-bash": "^0.25.1",
+    "tree-sitter-go": "^0.25.0",
+    "tree-sitter-java": "^0.23.5",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-ruby": "^0.23.1",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@eslint/js": "^9.39.2",
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@types/diff": "^7.0.2",
+    "@types/express": "^5.0.6",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^22.19.7",
+    "@types/picomatch": "^4.0.2",
+    "@vitest/coverage-v8": "^4.0.17",
+    "@vitest/ui": "^4.0.17",
+    "eslint": "^9.39.2",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "semantic-release": "^25.0.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.55.0",
+    "vitest": "^4.0.17"
+  },
+  "lint-staged": {
+    "*.{ts,js,mts,mjs}": [
+      "eslint --no-warn-ignored --max-warnings 0 --fix",
+      "prettier --write"
+    ],
+    "*.{md,json,yaml,yml,css}": [
+      "prettier --write"
+    ]
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+async function main() {
+  try {
+    const { isBinaryUpToDate, downloadQdrant, QDRANT_VERSION, getPlatformAsset } =
+      await import("../build/core/adapters/qdrant/embedded/download.js");
+
+    if (isBinaryUpToDate()) {
+      console.error(`[tea-rags] Qdrant v${QDRANT_VERSION} binary already present`);
+      return;
+    }
+
+    const asset = getPlatformAsset(process.platform, process.arch);
+    console.error(`[tea-rags] Downloading Qdrant v${QDRANT_VERSION} (${asset})...`);
+    await downloadQdrant();
+    console.error(`[tea-rags] Qdrant binary ready`);
+  } catch (err) {
+    console.error(`[tea-rags] Postinstall: ${err.message}`);
+    console.error(`[tea-rags] Binary will be downloaded on first startup`);
+  }
+}
+main();