tea-rags 0.9.0

package/build/core/adapters/qdrant/schema-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migration.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/schema-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAexC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;OAGG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB/D;;OAEG;YACW,mBAAmB;IAqCjC;;;OAGG;IACG,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoDjF;;;OAGG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU9D"}

package/build/core/adapters/qdrant/schema-migration.js

@@ -0,0 +1,148 @@
+/**
+ * Schema Migration for Qdrant Collections
+ *
+ * Handles automatic migration of collection schema (payload indexes, etc.)
+ * when new versions are deployed.
+ *
+ * Schema versions:
+ * - v1-v3: No payload indexes (implicit)
+ * - v4: Added keyword index on `relativePath` for faster filter-based deletes
+ */
+/** Current schema version */
+export const CURRENT_SCHEMA_VERSION = 4;
+/** Reserved ID for storing schema metadata in the collection */
+const SCHEMA_METADATA_ID = "__schema_metadata__";
+/**
+ * SchemaManager - Handles collection schema versioning and migrations
+ */
+export class SchemaManager {
+    qdrant;
+    constructor(qdrant) {
+        this.qdrant = qdrant;
+    }
+    /**
+     * Get current schema version from collection metadata
+     * Returns 0 if no schema metadata exists (pre-v4 collections)
+     */
+    async getSchemaVersion(collectionName) {
+        try {
+            const point = await this.qdrant.getPoint(collectionName, SCHEMA_METADATA_ID);
+            if (point?.payload?._type === "schema_metadata") {
+                return point.payload.schemaVersion || 0;
+            }
+            // No metadata point - check if collection has relativePath index
+            // If yes, it was manually migrated; treat as current version
+            const hasIndex = await this.qdrant.hasPayloadIndex(collectionName, "relativePath");
+            if (hasIndex) {
+                return CURRENT_SCHEMA_VERSION;
+            }
+            return 0; // Pre-v4 collection
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Store schema metadata in collection
+     */
+    async storeSchemaMetadata(collectionName, version, indexes) {
+        try {
+            // Get collection info to create appropriate zero vector
+            const info = await this.qdrant.getCollectionInfo(collectionName);
+            const zeroVector = new Array(info.vectorSize).fill(0);
+            const payload = {
+                _type: "schema_metadata",
+                schemaVersion: version,
+                migratedAt: new Date().toISOString(),
+                indexes,
+            };
+            if (info.hybridEnabled) {
+                await this.qdrant.addPointsWithSparse(collectionName, [
+                    {
+                        id: SCHEMA_METADATA_ID,
+                        vector: zeroVector,
+                        sparseVector: { indices: [], values: [] },
+                        payload: payload,
+                    },
+                ]);
+            }
+            else {
+                await this.qdrant.addPoints(collectionName, [
+                    {
+                        id: SCHEMA_METADATA_ID,
+                        vector: zeroVector,
+                        payload: payload,
+                    },
+                ]);
+            }
+        }
+        catch (error) {
+            // Non-fatal: log but don't fail
+            console.error("Failed to store schema metadata:", error);
+        }
+    }
+    /**
+     * Ensure collection schema is at current version
+     * Applies migrations if needed
+     */
+    async ensureCurrentSchema(collectionName) {
+        const currentVersion = await this.getSchemaVersion(collectionName);
+        const migrationsApplied = [];
+        if (currentVersion >= CURRENT_SCHEMA_VERSION) {
+            return {
+                success: true,
+                fromVersion: currentVersion,
+                toVersion: currentVersion,
+                migrationsApplied: [],
+            };
+        }
+        try {
+            // Apply migrations sequentially
+            const indexes = [];
+            // v4: Add relativePath keyword index
+            if (currentVersion < 4) {
+                const created = await this.qdrant.ensurePayloadIndex(collectionName, "relativePath", "keyword");
+                if (created) {
+                    migrationsApplied.push("v4: Created keyword index on relativePath");
+                    indexes.push("relativePath");
+                }
+                else {
+                    migrationsApplied.push("v4: relativePath index already exists");
+                    indexes.push("relativePath");
+                }
+            }
+            // Future migrations can be added here:
+            // if (currentVersion < 5) { ... }
+            // Store updated schema metadata
+            await this.storeSchemaMetadata(collectionName, CURRENT_SCHEMA_VERSION, indexes);
+            return {
+                success: true,
+                fromVersion: currentVersion,
+                toVersion: CURRENT_SCHEMA_VERSION,
+                migrationsApplied,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                fromVersion: currentVersion,
+                toVersion: CURRENT_SCHEMA_VERSION,
+                migrationsApplied,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Initialize schema for a new collection
+     * Creates all required indexes upfront
+     */
+    async initializeSchema(collectionName) {
+        const indexes = [];
+        // Create relativePath keyword index for fast filter-based operations
+        await this.qdrant.createPayloadIndex(collectionName, "relativePath", "keyword");
+        indexes.push("relativePath");
+        // Store schema metadata
+        await this.storeSchemaMetadata(collectionName, CURRENT_SCHEMA_VERSION, indexes);
+    }
+}
+//# sourceMappingURL=schema-migration.js.map

package/build/core/adapters/qdrant/schema-migration.js.map

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

package/build/core/adapters/qdrant/scroll.d.ts

@@ -0,0 +1,14 @@
+import type { QdrantManager } from "./client.js";
+/** Scroll all points from a collection, payload only (no vectors). */
+export declare function scrollAllPoints(qdrant: QdrantManager, collectionName: string): Promise<{
+    payload: Record<string, unknown>;
+}[]>;
+/** Scroll points ordered by a payload field. Delegates to QdrantManager.scrollOrdered. */
+export declare function scrollOrderedBy(qdrant: QdrantManager, collectionName: string, orderBy: {
+    key: string;
+    direction: "asc" | "desc";
+}, limit: number, filter?: Record<string, unknown>): Promise<{
+    id: string | number;
+    payload: Record<string, unknown>;
+}[]>;
+//# sourceMappingURL=scroll.d.ts.map

package/build/core/adapters/qdrant/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/scroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuBjD,sEAAsE;AACtE,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,CAAC,CAoBjD;AAED,0FAA0F;AAC1F,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,EACnD,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,CAAC,CAEtE"}

package/build/core/adapters/qdrant/scroll.js

@@ -0,0 +1,26 @@
+const PAGE_SIZE = 1000;
+/** Scroll all points from a collection, payload only (no vectors). */
+export async function scrollAllPoints(qdrant, collectionName) {
+    const points = [];
+    let offset = null;
+    do {
+        const result = await qdrant.client.scroll(collectionName, {
+            limit: PAGE_SIZE,
+            offset: offset ?? undefined,
+            with_payload: true,
+            with_vector: false,
+        });
+        for (const point of result.points) {
+            if (point.payload) {
+                points.push({ payload: point.payload });
+            }
+        }
+        offset = result.next_page_offset ?? null;
+    } while (offset !== null);
+    return points;
+}
+/** Scroll points ordered by a payload field. Delegates to QdrantManager.scrollOrdered. */
+export async function scrollOrderedBy(qdrant, collectionName, orderBy, limit, filter) {
+    return qdrant.scrollOrdered(collectionName, orderBy, limit, filter);
+}
+//# sourceMappingURL=scroll.js.map

package/build/core/adapters/qdrant/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/scroll.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,IAAI,CAAC;AAqBvB,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,cAAsB;IAEtB,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,IAAI,MAAM,GAA2B,IAAI,CAAC;IAE1C,GAAG,CAAC;QACF,MAAM,MAAM,GAAG,MAAO,MAAkC,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE;YACrF,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,MAAM,IAAI,SAAS;YAC3B,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3C,CAAC,QAAQ,MAAM,KAAK,IAAI,EAAE;IAE1B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,cAAsB,EACtB,OAAmD,EACnD,KAAa,EACb,MAAgC;IAEhC,OAAO,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC"}

package/build/core/adapters/qdrant/sparse.d.ts

@@ -0,0 +1,40 @@
+/**
+ * BM25 Sparse Vector Generator
+ *
+ * This module provides a simple BM25-like sparse vector generation for keyword search.
+ * For production use, consider using a proper BM25 implementation or Qdrant's built-in
+ * sparse vector generation via FastEmbed.
+ */
+import type { SparseVector } from "../qdrant/client.js";
+export declare class BM25SparseVectorGenerator {
+    private readonly vocabulary;
+    private readonly idfScores;
+    private documentCount;
+    private readonly k1;
+    private readonly b;
+    constructor(k1?: number, b?: number);
+    /**
+     * Tokenize text into words (simple whitespace tokenization + lowercase)
+     */
+    private tokenize;
+    /**
+     * Calculate term frequency for a document
+     */
+    private getTermFrequency;
+    /**
+     * Build vocabulary from training documents (optional pre-training step)
+     * In a simple implementation, we can skip this and use on-the-fly vocabulary
+     */
+    train(documents: string[]): void;
+    /**
+     * Generate sparse vector for a query or document
+     * Returns indices and values for non-zero dimensions
+     */
+    generate(text: string, avgDocLength?: number): SparseVector;
+    /**
+     * Simple static method for generating sparse vectors without training
+     * Useful for quick implementation
+     */
+    static generateSimple(text: string): SparseVector;
+}
+//# sourceMappingURL=sparse.d.ts.map

package/build/core/adapters/qdrant/sparse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/sparse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,EAAE,SAAM,EAAE,CAAC,SAAO;IAQ9B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAwBhC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,YAAY;IAoCvD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;CAIlD"}

package/build/core/adapters/qdrant/sparse.js

@@ -0,0 +1,107 @@
+/**
+ * BM25 Sparse Vector Generator
+ *
+ * This module provides a simple BM25-like sparse vector generation for keyword search.
+ * For production use, consider using a proper BM25 implementation or Qdrant's built-in
+ * sparse vector generation via FastEmbed.
+ */
+export class BM25SparseVectorGenerator {
+    vocabulary;
+    idfScores;
+    documentCount;
+    k1;
+    b;
+    constructor(k1 = 1.2, b = 0.75) {
+        this.vocabulary = new Map();
+        this.idfScores = new Map();
+        this.documentCount = 0;
+        this.k1 = k1;
+        this.b = b;
+    }
+    /**
+     * Tokenize text into words (simple whitespace tokenization + lowercase)
+     */
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, " ")
+            .split(/\s+/)
+            .filter((token) => token.length > 0);
+    }
+    /**
+     * Calculate term frequency for a document
+     */
+    getTermFrequency(tokens) {
+        const tf = {};
+        for (const token of tokens) {
+            tf[token] = (tf[token] || 0) + 1;
+        }
+        return tf;
+    }
+    /**
+     * Build vocabulary from training documents (optional pre-training step)
+     * In a simple implementation, we can skip this and use on-the-fly vocabulary
+     */
+    train(documents) {
+        this.documentCount = documents.length;
+        const documentFrequency = new Map();
+        // Calculate document frequency for each term
+        for (const doc of documents) {
+            const tokens = this.tokenize(doc);
+            const uniqueTokens = new Set(tokens);
+            for (const token of uniqueTokens) {
+                if (!this.vocabulary.has(token)) {
+                    this.vocabulary.set(token, this.vocabulary.size);
+                }
+                documentFrequency.set(token, (documentFrequency.get(token) || 0) + 1);
+            }
+        }
+        // Calculate IDF scores
+        for (const [token, df] of documentFrequency.entries()) {
+            const idf = Math.log((this.documentCount - df + 0.5) / (df + 0.5) + 1.0);
+            this.idfScores.set(token, idf);
+        }
+    }
+    /**
+     * Generate sparse vector for a query or document
+     * Returns indices and values for non-zero dimensions
+     */
+    generate(text, avgDocLength = 50) {
+        const tokens = this.tokenize(text);
+        const tf = this.getTermFrequency(tokens);
+        const docLength = tokens.length;
+        const indices = [];
+        const values = [];
+        // Calculate BM25 score for each term
+        for (const [token, freq] of Object.entries(tf)) {
+            // Ensure token is in vocabulary
+            if (!this.vocabulary.has(token)) {
+                // For unseen tokens, add them to vocabulary dynamically
+                this.vocabulary.set(token, this.vocabulary.size);
+            }
+            const index = this.vocabulary.get(token);
+            if (index === undefined)
+                continue;
+            // Use a default IDF if not trained
+            const idf = this.idfScores.get(token) || 1.0;
+            // BM25 formula
+            const numerator = freq * (this.k1 + 1);
+            const denominator = freq + this.k1 * (1 - this.b + this.b * (docLength / avgDocLength));
+            const score = idf * (numerator / denominator);
+            if (score > 0) {
+                indices.push(index);
+                values.push(score);
+            }
+        }
+        return { indices, values };
+    }
+    /**
+     * Simple static method for generating sparse vectors without training
+     * Useful for quick implementation
+     */
+    static generateSimple(text) {
+        const generator = new BM25SparseVectorGenerator();
+        return generator.generate(text);
+    }
+}
+//# sourceMappingURL=sparse.js.map

package/build/core/adapters/qdrant/sparse.js.map

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

package/build/core/adapters/qdrant/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Qdrant filter primitives.
+ *
+ * These are infrastructure-level types describing the shape of
+ * Qdrant filter conditions. Domain code (trajectory, search, etc.)
+ * imports from here rather than defining its own duplicates.
+ */
+export interface QdrantMatchCondition {
+    key: string;
+    match: {
+        value: unknown;
+    } | {
+        any: unknown[];
+    };
+}
+export interface QdrantRangeCondition {
+    key: string;
+    range: {
+        gte?: number;
+        lte?: number;
+    };
+}
+export type QdrantFilterCondition = QdrantMatchCondition | QdrantRangeCondition;
+export interface QdrantFilter {
+    must?: QdrantFilterCondition[];
+    should?: QdrantFilterCondition[];
+    must_not?: QdrantFilterCondition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/core/adapters/qdrant/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC"}

package/build/core/adapters/qdrant/types.js

@@ -0,0 +1,9 @@
+/**
+ * Qdrant filter primitives.
+ *
+ * These are infrastructure-level types describing the shape of
+ * Qdrant filter conditions. Domain code (trajectory, search, etc.)
+ * imports from here rather than defining its own duplicates.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/core/adapters/qdrant/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/adapters/qdrant/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/build/core/api/app.d.ts

@@ -0,0 +1,40 @@
+/**
+ * App interface — unified public API contract for tea-rags.
+ *
+ * MCP layer and any external consumer imports ONLY this interface.
+ * The composition root (api/) provides the concrete implementation.
+ *
+ * DTOs live in contracts/types/app.ts (shared across layers).
+ * Domain types (IndexOptions, IndexStats, etc.) are re-exported from ../types.js.
+ */
+import type { AddDocumentsRequest, CollectionInfo, CreateCollectionRequest, DeleteDocumentsRequest, ExploreCodeRequest, ExploreResponse, HybridSearchRequest, PresetDescriptors, RankChunksRequest, SemanticSearchRequest } from "../contracts/types/app.js";
+import type { ChangeStats, IndexOptions, IndexStats, IndexStatus, ProgressCallback } from "../types.js";
+export interface App {
+    semanticSearch: (request: SemanticSearchRequest) => Promise<ExploreResponse>;
+    hybridSearch: (request: HybridSearchRequest) => Promise<ExploreResponse>;
+    rankChunks: (request: RankChunksRequest) => Promise<ExploreResponse>;
+    searchCode: (request: ExploreCodeRequest) => Promise<ExploreResponse>;
+    indexCodebase: (path: string, options?: IndexOptions, progress?: ProgressCallback) => Promise<IndexStats>;
+    reindexChanges: (path: string, progress?: ProgressCallback) => Promise<ChangeStats>;
+    getIndexStatus: (path: string) => Promise<IndexStatus>;
+    clearIndex: (path: string) => Promise<void>;
+    createCollection: (request: CreateCollectionRequest) => Promise<CollectionInfo>;
+    listCollections: () => Promise<string[]>;
+    getCollectionInfo: (name: string) => Promise<CollectionInfo>;
+    deleteCollection: (name: string) => Promise<void>;
+    addDocuments: (request: AddDocumentsRequest) => Promise<{
+        count: number;
+    }>;
+    deleteDocuments: (request: DeleteDocumentsRequest) => Promise<{
+        count: number;
+    }>;
+    getSchemaDescriptors: () => PresetDescriptors;
+    checkSchemaDrift: (ref: {
+        path: string;
+    } | {
+        collection: string;
+    }) => Promise<string | null>;
+}
+export type { AddDocumentsRequest, CollectionInfo, CollectionRef, CreateCollectionRequest, DeleteDocumentsRequest, ExploreCodeRequest, ExploreResponse, HybridSearchRequest, PresetDescriptors, RankChunksRequest, SearchResult, SemanticSearchRequest, SignalDescriptor, TypedFilterParams, } from "../contracts/types/app.js";
+export type { ChangeStats, IndexOptions, IndexStats, IndexStatus, ProgressCallback };
+//# sourceMappingURL=app.d.ts.map

package/build/core/api/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/core/api/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMxG,MAAM,WAAW,GAAG;IAElB,cAAc,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,YAAY,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACzE,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACrE,UAAU,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAGtE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1G,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpF,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5C,gBAAgB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAChF,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7D,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAGlD,YAAY,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,eAAe,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGjF,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;IAG9C,gBAAgB,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9F;AAGD,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/build/core/api/app.js

@@ -0,0 +1,11 @@
+/**
+ * App interface — unified public API contract for tea-rags.
+ *
+ * MCP layer and any external consumer imports ONLY this interface.
+ * The composition root (api/) provides the concrete implementation.
+ *
+ * DTOs live in contracts/types/app.ts (shared across layers).
+ * Domain types (IndexOptions, IndexStats, etc.) are re-exported from ../types.js.
+ */
+export {};
+//# sourceMappingURL=app.js.map

package/build/core/api/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/core/api/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/build/core/api/collection-ops.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Collection CRUD operations — business logic extracted from MCP handlers.
+ */
+import type { EmbeddingProvider } from "../adapters/embeddings/base.js";
+import type { QdrantManager } from "../adapters/qdrant/client.js";
+import type { CollectionInfo, CreateCollectionRequest } from "./app.js";
+export declare class CollectionOps {
+    private readonly qdrant;
+    private readonly embeddings;
+    constructor(qdrant: QdrantManager, embeddings: EmbeddingProvider);
+    create(request: CreateCollectionRequest): Promise<CollectionInfo>;
+    list(): Promise<string[]>;
+    getInfo(name: string): Promise<CollectionInfo>;
+    delete(name: string): Promise<void>;
+}
+//# sourceMappingURL=collection-ops.d.ts.map

package/build/core/api/collection-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-ops.d.ts","sourceRoot":"","sources":["../../../src/core/api/collection-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExE,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,iBAAiB;IAG1C,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAejE,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/build/core/api/collection-ops.js

@@ -0,0 +1,33 @@
+/**
+ * Collection CRUD operations — business logic extracted from MCP handlers.
+ */
+export class CollectionOps {
+    qdrant;
+    embeddings;
+    constructor(qdrant, embeddings) {
+        this.qdrant = qdrant;
+        this.embeddings = embeddings;
+    }
+    async create(request) {
+        const vectorSize = this.embeddings.getDimensions();
+        const enableHybrid = request.enableHybrid || false;
+        await this.qdrant.createCollection(request.name, vectorSize, request.distance, enableHybrid);
+        return {
+            name: request.name,
+            vectorSize,
+            pointsCount: 0,
+            distance: request.distance || "Cosine",
+            hybridEnabled: enableHybrid,
+        };
+    }
+    async list() {
+        return this.qdrant.listCollections();
+    }
+    async getInfo(name) {
+        return this.qdrant.getCollectionInfo(name);
+    }
+    async delete(name) {
+        await this.qdrant.deleteCollection(name);
+    }
+}
+//# sourceMappingURL=collection-ops.js.map

package/build/core/api/collection-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-ops.js","sourceRoot":"","sources":["../../../src/core/api/collection-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,MAAqB,EACrB,UAA6B;QAD7B,WAAM,GAAN,MAAM,CAAe;QACrB,eAAU,GAAV,UAAU,CAAmB;IAC7C,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,OAAgC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAEnD,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAE7F,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU;YACV,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ;YACtC,aAAa,EAAE,YAAY;SAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/build/core/api/composition.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Composition root — assembles the full application graph from trajectories.
+ *
+ * Uses TrajectoryRegistry to aggregate payloadSignals, derivedSignals,
+ * filters, and presets from all registered trajectories. The only place
+ * that knows which trajectories exist.
+ */
+import type { DerivedSignalDescriptor, RerankPreset } from "../contracts/types/reranker.js";
+import type { PayloadSignalDescriptor } from "../contracts/types/trajectory.js";
+import { Reranker } from "../explore/reranker.js";
+import { TrajectoryRegistry } from "../trajectory/index.js";
+export interface CompositionResult {
+    registry: TrajectoryRegistry;
+    reranker: Reranker;
+    allPayloadSignalDescriptors: PayloadSignalDescriptor[];
+    allDerivedSignals: DerivedSignalDescriptor[];
+    resolvedPresets: RerankPreset[];
+}
+export declare function createComposition(): CompositionResult;
+//# sourceMappingURL=composition.d.ts.map

package/build/core/api/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../src/core/api/composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,2BAA2B,EAAE,uBAAuB,EAAE,CAAC;IACvD,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;IAC7C,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAED,wBAAgB,iBAAiB,IAAI,iBAAiB,CAWrD"}

package/build/core/api/composition.js

@@ -0,0 +1,23 @@
+/**
+ * Composition root — assembles the full application graph from trajectories.
+ *
+ * Uses TrajectoryRegistry to aggregate payloadSignals, derivedSignals,
+ * filters, and presets from all registered trajectories. The only place
+ * that knows which trajectories exist.
+ */
+import { resolvePresets } from "../explore/rerank/presets/index.js";
+import { Reranker } from "../explore/reranker.js";
+import { GitTrajectory } from "../trajectory/git.js";
+import { TrajectoryRegistry } from "../trajectory/index.js";
+import { StaticTrajectory } from "../trajectory/static/index.js";
+export function createComposition() {
+    const registry = new TrajectoryRegistry();
+    registry.register(new StaticTrajectory());
+    registry.register(new GitTrajectory());
+    const allPayloadSignalDescriptors = registry.getAllPayloadSignalDescriptors();
+    const allDerivedSignals = registry.getAllDerivedSignals();
+    const resolvedPresets = resolvePresets(registry.getAllPresets(), []);
+    const reranker = new Reranker(allDerivedSignals, resolvedPresets, allPayloadSignalDescriptors);
+    return { registry, reranker, allPayloadSignalDescriptors, allDerivedSignals, resolvedPresets };
+}
+//# sourceMappingURL=composition.js.map

package/build/core/api/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../src/core/api/composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;IAEvC,MAAM,2BAA2B,GAAG,QAAQ,CAAC,8BAA8B,EAAE,CAAC;IAC9E,MAAM,iBAAiB,GAAG,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IAC1D,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,iBAAiB,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;IAE/F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AACjG,CAAC"}

package/build/core/api/create-app.d.ts

@@ -0,0 +1,24 @@
+/**
+ * createApp() — factory that assembles an App implementation from domain dependencies.
+ *
+ * Wires together ExploreFacade, IngestFacade, CollectionOps, DocumentOps,
+ * Reranker (for schema descriptors), and SchemaDriftMonitor into a single
+ * unified App object.
+ */
+import type { EmbeddingProvider } from "../adapters/embeddings/base.js";
+import type { QdrantManager } from "../adapters/qdrant/client.js";
+import type { Reranker } from "../explore/reranker.js";
+import type { SchemaDriftMonitor } from "../infra/schema-drift-monitor.js";
+import type { App } from "./app.js";
+import type { ExploreFacade } from "./explore-facade.js";
+import type { IngestFacade } from "./ingest-facade.js";
+export interface AppDeps {
+    qdrant: QdrantManager;
+    embeddings: EmbeddingProvider;
+    ingest: IngestFacade;
+    explore: ExploreFacade;
+    reranker: Reranker;
+    schemaDriftMonitor: SchemaDriftMonitor;
+}
+export declare function createApp(deps: AppDeps): App;
+//# sourceMappingURL=create-app.d.ts.map

package/build/core/api/create-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../../src/core/api/create-app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CA+C5C"}