tea-rags 0.9.0

package/build/core/api/create-app.js

@@ -0,0 +1,56 @@
+/**
+ * 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 { CollectionOps } from "./collection-ops.js";
+import { DocumentOps } from "./document-ops.js";
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createApp(deps) {
+    const collectionOps = new CollectionOps(deps.qdrant, deps.embeddings);
+    const documentOps = new DocumentOps(deps.qdrant, deps.embeddings);
+    return {
+        // -- Search — delegate to ExploreFacade --
+        semanticSearch: async (req) => deps.explore.semanticSearch(req),
+        hybridSearch: async (req) => deps.explore.hybridSearch(req),
+        rankChunks: async (req) => deps.explore.rankChunks(req),
+        searchCode: async (req) => deps.explore.searchCode(req),
+        // -- Indexing — delegate to IngestFacade --
+        indexCodebase: async (path, options, progress) => deps.ingest.indexCodebase(path, options, progress),
+        reindexChanges: async (path, progress) => deps.ingest.reindexChanges(path, progress),
+        getIndexStatus: async (path) => deps.ingest.getIndexStatus(path),
+        clearIndex: async (path) => deps.ingest.clearIndex(path),
+        // -- Collections — delegate to CollectionOps --
+        createCollection: async (req) => collectionOps.create(req),
+        listCollections: async () => collectionOps.list(),
+        getCollectionInfo: async (name) => collectionOps.getInfo(name),
+        deleteCollection: async (name) => collectionOps.delete(name),
+        // -- Documents — delegate to DocumentOps --
+        addDocuments: async (req) => documentOps.add(req),
+        deleteDocuments: async (req) => documentOps.delete(req),
+        // -- Schema descriptors --
+        getSchemaDescriptors: () => {
+            const info = deps.reranker.getDescriptorInfo();
+            const tools = ["semantic_search", "hybrid_search", "search_code", "rank_chunks"];
+            const presetNames = {};
+            for (const tool of tools) {
+                presetNames[tool] = deps.reranker.getPresetNames(tool);
+            }
+            return {
+                presetNames,
+                signalDescriptors: info.map((d) => ({ name: d.name, description: d.description })),
+            };
+        },
+        // -- Drift monitoring --
+        checkSchemaDrift: async (ref) => {
+            if ("path" in ref)
+                return deps.schemaDriftMonitor.checkAndConsume(ref.path);
+            return deps.schemaDriftMonitor.checkByCollectionName(ref.collection);
+        },
+    };
+}
+//# sourceMappingURL=create-app.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Document add/delete 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 { AddDocumentsRequest, DeleteDocumentsRequest } from "./app.js";
+export declare class DocumentOps {
+    private readonly qdrant;
+    private readonly embeddings;
+    constructor(qdrant: QdrantManager, embeddings: EmbeddingProvider);
+    add(request: AddDocumentsRequest): Promise<{
+        count: number;
+    }>;
+    delete(request: DeleteDocumentsRequest): Promise<{
+        count: number;
+    }>;
+}
+//# sourceMappingURL=document-ops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-ops.d.ts","sourceRoot":"","sources":["../../../src/core/api/document-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE5E,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,iBAAiB;IAG1C,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgD7D,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAI1E"}

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

@@ -0,0 +1,57 @@
+/**
+ * Document add/delete operations — business logic extracted from MCP handlers.
+ */
+import { BM25SparseVectorGenerator } from "../adapters/qdrant/sparse.js";
+export class DocumentOps {
+    qdrant;
+    embeddings;
+    constructor(qdrant, embeddings) {
+        this.qdrant = qdrant;
+        this.embeddings = embeddings;
+    }
+    async add(request) {
+        const { collection, documents } = request;
+        // 1. Check collection exists
+        const exists = await this.qdrant.collectionExists(collection);
+        if (!exists) {
+            throw new Error(`Collection "${collection}" does not exist. Create it first using create_collection.`);
+        }
+        // 2. Get collection info for hybrid check
+        const collectionInfo = await this.qdrant.getCollectionInfo(collection);
+        // 3. Embed all document texts
+        const texts = documents.map((doc) => doc.text);
+        const embeddingResults = await this.embeddings.embedBatch(texts);
+        // 4. Add points — with or without sparse vectors
+        if (collectionInfo.hybridEnabled) {
+            const sparseGenerator = new BM25SparseVectorGenerator();
+            const points = documents.map((doc, index) => ({
+                id: doc.id,
+                vector: embeddingResults[index].embedding,
+                sparseVector: sparseGenerator.generate(doc.text),
+                payload: {
+                    text: doc.text,
+                    ...doc.metadata,
+                },
+            }));
+            await this.qdrant.addPointsWithSparse(collection, points);
+        }
+        else {
+            const points = documents.map((doc, index) => ({
+                id: doc.id,
+                vector: embeddingResults[index].embedding,
+                payload: {
+                    text: doc.text,
+                    ...doc.metadata,
+                },
+            }));
+            await this.qdrant.addPoints(collection, points);
+        }
+        // 5. Return count
+        return { count: documents.length };
+    }
+    async delete(request) {
+        await this.qdrant.deletePoints(request.collection, request.ids);
+        return { count: request.ids.length };
+    }
+}
+//# sourceMappingURL=document-ops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-ops.js","sourceRoot":"","sources":["../../../src/core/api/document-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,MAAM,OAAO,WAAW;IAEH;IACA;IAFnB,YACmB,MAAqB,EACrB,UAA6B;QAD7B,WAAM,GAAN,MAAM,CAAe;QACrB,eAAU,GAAV,UAAU,CAAmB;IAC7C,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,OAA4B;QACpC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAE1C,6BAA6B;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,4DAA4D,CAAC,CAAC;QACzG,CAAC;QAED,0CAA0C;QAC1C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAEvE,8BAA8B;QAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEjE,iDAAiD;QACjD,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC;YACjC,MAAM,eAAe,GAAG,IAAI,yBAAyB,EAAE,CAAC;YAExD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5C,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS;gBACzC,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAChD,OAAO,EAAE;oBACP,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,GAAG,CAAC,QAAQ;iBAChB;aACF,CAAC,CAAC,CAAC;YAEJ,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5C,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS;gBACzC,OAAO,EAAE;oBACP,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,GAAG,CAAC,QAAQ;iBAChB;aACF,CAAC,CAAC,CAAC;YAEJ,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,kBAAkB;QAClB,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA+B;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;CACF"}

package/build/core/api/explore-facade.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ExploreFacade — thin orchestrator for code exploration and search.
+ *
+ * Facade responsibilities (KEPT here):
+ *   resolveCollection, validateCollectionExists, ensureStats, embed query, checkDrift
+ *
+ * Business logic (DELEGATED to strategies):
+ *   fetchLimit, postProcess, metaOnly, BM25 generation, scroll+rank
+ *
+ * Cold-start: loads cached collection stats into reranker on first search.
+ */
+import type { EmbeddingProvider } from "../adapters/embeddings/base.js";
+import type { QdrantManager } from "../adapters/qdrant/client.js";
+import type { PayloadSignalDescriptor } from "../contracts/types/trajectory.js";
+import type { Reranker } from "../explore/reranker.js";
+import type { SchemaDriftMonitor } from "../infra/schema-drift-monitor.js";
+import type { StatsCache } from "../infra/stats-cache.js";
+import type { TrajectoryRegistry } from "../trajectory/index.js";
+import type { ExploreCodeRequest, ExploreResponse, HybridSearchRequest, RankChunksRequest, SemanticSearchRequest } from "./app.js";
+declare class CollectionRefError extends Error {
+    constructor();
+}
+declare class CollectionNotFoundError extends Error {
+    constructor(collectionName: string, path?: string);
+}
+export declare class ExploreFacade {
+    private readonly qdrant;
+    private readonly embeddings;
+    private readonly reranker;
+    private readonly registry?;
+    private readonly statsCache?;
+    private readonly schemaDriftMonitor?;
+    private readonly vectorStrategy;
+    private readonly hybridStrategy;
+    private readonly scrollRankStrategy;
+    constructor(qdrant: QdrantManager, embeddings: EmbeddingProvider, reranker: Reranker, registry?: TrajectoryRegistry | undefined, statsCache?: StatsCache | undefined, payloadSignals?: PayloadSignalDescriptor[], essentialKeys?: string[], schemaDriftMonitor?: SchemaDriftMonitor | undefined);
+    /** Semantic (dense vector) search over a collection. */
+    semanticSearch(request: SemanticSearchRequest): Promise<ExploreResponse>;
+    /** Hybrid (dense + BM25 sparse) search over a collection. */
+    hybridSearch(request: HybridSearchRequest): Promise<ExploreResponse>;
+    /** Rank all chunks by rerank signals without vector search. */
+    rankChunks(request: RankChunksRequest): Promise<ExploreResponse>;
+    /** Search code semantically (search_code MCP tool). */
+    searchCode(request: ExploreCodeRequest): Promise<ExploreResponse>;
+    /** Unified pipeline: validate → stats → strategy.execute → map → drift. */
+    private executeExplore;
+    private resolveCollection;
+    private validateCollectionExists;
+    private ensureStats;
+    /**
+     * Merge typed filter params (via registry) with raw Qdrant filter.
+     * Typed must/must_not are appended to raw filter's arrays.
+     * Raw filter's should is preserved untouched.
+     */
+    private buildMergedFilter;
+    private checkDrift;
+}
+export { CollectionRefError, CollectionNotFoundError };
+//# sourceMappingURL=explore-facade.d.ts.map

package/build/core/api/explore-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-facade.d.ts","sourceRoot":"","sources":["../../../src/core/api/explore-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EAEtB,MAAM,UAAU,CAAC;AAMlB,cAAM,kBAAmB,SAAQ,KAAK;;CAKrC;AAED,cAAM,uBAAwB,SAAQ,KAAK;gBAC7B,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAIlD;AAMD,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAG5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAZtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;gBAGtC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC7B,UAAU,CAAC,EAAE,UAAU,YAAA,EACxC,cAAc,CAAC,EAAE,uBAAuB,EAAE,EAC1C,aAAa,CAAC,EAAE,MAAM,EAAE,EACP,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAa1D,wDAAwD;IAClD,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB9E,6DAA6D;IACvD,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB1E,+DAA+D;IACzD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBtE,uDAAuD;IACjD,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBvE,2EAA2E;YAC7D,cAAc;IAoB5B,OAAO,CAAC,iBAAiB;YAQX,wBAAwB;YAOxB,WAAW;IAazB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YA0BX,UAAU;CAMzB;AAED,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}

package/build/core/api/explore-facade.js

@@ -0,0 +1,203 @@
+/**
+ * ExploreFacade — thin orchestrator for code exploration and search.
+ *
+ * Facade responsibilities (KEPT here):
+ *   resolveCollection, validateCollectionExists, ensureStats, embed query, checkDrift
+ *
+ * Business logic (DELEGATED to strategies):
+ *   fetchLimit, postProcess, metaOnly, BM25 generation, scroll+rank
+ *
+ * Cold-start: loads cached collection stats into reranker on first search.
+ */
+import { createExploreStrategy } from "../explore/strategies/index.js";
+import { resolveCollectionName, validatePath } from "../ingest/collection.js";
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+class CollectionRefError extends Error {
+    constructor() {
+        super("Either 'collection' or 'path' parameter is required.");
+        this.name = "CollectionRefError";
+    }
+}
+class CollectionNotFoundError extends Error {
+    constructor(collectionName, path) {
+        super(`Collection "${collectionName}" does not exist.${path ? ` Codebase at "${path}" may not be indexed.` : ""}`);
+        this.name = "CollectionNotFoundError";
+    }
+}
+// ---------------------------------------------------------------------------
+// ExploreFacade
+// ---------------------------------------------------------------------------
+export class ExploreFacade {
+    qdrant;
+    embeddings;
+    reranker;
+    registry;
+    statsCache;
+    schemaDriftMonitor;
+    vectorStrategy;
+    hybridStrategy;
+    scrollRankStrategy;
+    constructor(qdrant, embeddings, reranker, registry, statsCache, payloadSignals, essentialKeys, schemaDriftMonitor) {
+        this.qdrant = qdrant;
+        this.embeddings = embeddings;
+        this.reranker = reranker;
+        this.registry = registry;
+        this.statsCache = statsCache;
+        this.schemaDriftMonitor = schemaDriftMonitor;
+        const signals = payloadSignals ?? [];
+        const keys = essentialKeys ?? [];
+        this.vectorStrategy = createExploreStrategy("vector", qdrant, reranker, signals, keys);
+        this.hybridStrategy = createExploreStrategy("hybrid", qdrant, reranker, signals, keys);
+        this.scrollRankStrategy = createExploreStrategy("scroll-rank", qdrant, reranker, signals, keys);
+    }
+    // =========================================================================
+    // Unified strategy pipeline
+    // =========================================================================
+    /** Semantic (dense vector) search over a collection. */
+    async semanticSearch(request) {
+        const { collectionName, path } = this.resolveCollection(request.collection, request.path);
+        const { embedding } = await this.embeddings.embed(request.query);
+        const filter = this.buildMergedFilter(request, request.filter);
+        return this.executeExplore(this.vectorStrategy, {
+            collectionName,
+            query: request.query,
+            embedding,
+            limit: request.limit ?? 10,
+            filter,
+            pathPattern: request.pathPattern,
+            rerank: request.rerank,
+            metaOnly: request.metaOnly,
+        }, path);
+    }
+    /** Hybrid (dense + BM25 sparse) search over a collection. */
+    async hybridSearch(request) {
+        const { collectionName, path } = this.resolveCollection(request.collection, request.path);
+        const { embedding } = await this.embeddings.embed(request.query);
+        const filter = this.buildMergedFilter(request, request.filter);
+        return this.executeExplore(this.hybridStrategy, {
+            collectionName,
+            query: request.query,
+            embedding,
+            limit: request.limit ?? 10,
+            filter,
+            pathPattern: request.pathPattern,
+            rerank: request.rerank,
+            metaOnly: request.metaOnly,
+        }, path);
+    }
+    /** Rank all chunks by rerank signals without vector search. */
+    async rankChunks(request) {
+        const { collectionName, path } = this.resolveCollection(request.collection, request.path);
+        const filter = this.buildMergedFilter(request, request.filter, request.level);
+        return this.executeExplore(this.scrollRankStrategy, {
+            collectionName,
+            limit: request.limit ?? 10,
+            offset: request.offset,
+            level: request.level,
+            filter,
+            pathPattern: request.pathPattern,
+            rerank: request.rerank,
+            metaOnly: request.metaOnly,
+        }, path);
+    }
+    /** Search code semantically (search_code MCP tool). */
+    async searchCode(request) {
+        const absolutePath = await validatePath(request.path);
+        const collectionName = resolveCollectionName(absolutePath);
+        const { embedding } = await this.embeddings.embed(request.query);
+        const filter = this.buildMergedFilter(request, request.filter);
+        return this.executeExplore(this.vectorStrategy, {
+            collectionName,
+            query: request.query,
+            embedding,
+            limit: request.limit ?? 5,
+            filter,
+            pathPattern: request.pathPattern,
+            rerank: request.rerank,
+        }, absolutePath);
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /** Unified pipeline: validate → stats → strategy.execute → map → drift. */
+    async executeExplore(strategy, ctx, path) {
+        await this.validateCollectionExists(ctx.collectionName, path);
+        await this.ensureStats(ctx.collectionName);
+        const results = await strategy.execute(ctx);
+        const driftWarning = await this.checkDrift(path, ctx.collectionName);
+        return {
+            results: results.map((r) => ({
+                id: r.id ?? "",
+                score: r.score,
+                payload: r.payload,
+                rankingOverlay: r.rankingOverlay,
+            })),
+            driftWarning,
+        };
+    }
+    resolveCollection(collection, path) {
+        if (!collection && !path) {
+            throw new CollectionRefError();
+        }
+        const collectionName = collection || resolveCollectionName(path);
+        return { collectionName, path };
+    }
+    async validateCollectionExists(collectionName, path) {
+        const exists = await this.qdrant.collectionExists(collectionName);
+        if (!exists) {
+            throw new CollectionNotFoundError(collectionName, path);
+        }
+    }
+    async ensureStats(collectionName) {
+        if (this.statsCache && !this.reranker.hasCollectionStats) {
+            try {
+                const stats = this.statsCache.load(collectionName);
+                if (stats) {
+                    this.reranker.setCollectionStats(stats);
+                }
+            }
+            catch {
+                // Stats loading failure should not prevent search
+            }
+        }
+    }
+    /**
+     * Merge typed filter params (via registry) with raw Qdrant filter.
+     * Typed must/must_not are appended to raw filter's arrays.
+     * Raw filter's should is preserved untouched.
+     */
+    buildMergedFilter(typedParams, rawFilter, level = "chunk") {
+        const typedFilter = this.registry?.buildFilter(typedParams, level);
+        if (!typedFilter && !rawFilter)
+            return undefined;
+        if (!typedFilter)
+            return rawFilter;
+        if (!rawFilter)
+            return typedFilter;
+        const merged = { ...rawFilter };
+        const rawMust = Array.isArray(rawFilter.must) ? rawFilter.must : [];
+        const typedMust = Array.isArray(typedFilter.must) ? typedFilter.must : [];
+        if (rawMust.length > 0 || typedMust.length > 0) {
+            merged.must = [...rawMust, ...typedMust];
+        }
+        const rawMustNot = Array.isArray(rawFilter.must_not) ? rawFilter.must_not : [];
+        const typedMustNot = Array.isArray(typedFilter.must_not) ? typedFilter.must_not : [];
+        if (rawMustNot.length > 0 || typedMustNot.length > 0) {
+            merged.must_not = [...rawMustNot, ...typedMustNot];
+        }
+        return merged;
+    }
+    async checkDrift(path, collectionName) {
+        if (!this.schemaDriftMonitor)
+            return null;
+        if (path)
+            return this.schemaDriftMonitor.checkAndConsume(path);
+        if (collectionName)
+            return this.schemaDriftMonitor.checkByCollectionName(collectionName);
+        return null;
+    }
+}
+export { CollectionRefError, CollectionNotFoundError };
+//# sourceMappingURL=explore-facade.js.map

package/build/core/api/explore-facade.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * API barrel — unified entry point for all api/ exports.
+ *
+ * External consumers import from here. Internal structure is hidden.
+ */
+export { createApp } from "./public/app.js";
+export type { App, AppDeps } from "./public/app.js";
+export type { CollectionRef, TypedFilterParams, SemanticSearchRequest, HybridSearchRequest, RankChunksRequest, ExploreCodeRequest, SearchResult, ExploreResponse, SignalDescriptor, PresetDescriptors, IndexOptions, IndexStats, IndexStatus, ChangeStats, ProgressCallback, CreateCollectionRequest, CollectionInfo, AddDocumentsRequest, DeleteDocumentsRequest, } from "./public/dto/index.js";
+export { SchemaBuilder } from "./internal/infra/schema-builder.js";
+export { createComposition } from "./internal/composition.js";
+export type { CompositionResult } from "./internal/composition.js";
+export { ExploreFacade } from "./internal/facades/explore-facade.js";
+export type { ExploreFacadeDeps } from "./internal/facades/explore-facade.js";
+export { IngestFacade } from "./internal/facades/ingest-facade.js";
+export { CollectionRefError } from "./internal/facades/explore-facade.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAEV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAEjB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAEhB,uBAAuB,EACvB,cAAc,EAEd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}

package/build/core/api/index.js

@@ -0,0 +1,15 @@
+/**
+ * API barrel — unified entry point for all api/ exports.
+ *
+ * External consumers import from here. Internal structure is hidden.
+ */
+// Public surface (App contract + DTOs)
+export { createApp } from "./public/app.js";
+// Internal exports for bootstrap/MCP (not part of App contract)
+export { SchemaBuilder } from "./internal/infra/schema-builder.js";
+export { createComposition } from "./internal/composition.js";
+// Internal exports needed by bootstrap/factory.ts for DI wiring
+export { ExploreFacade } from "./internal/facades/explore-facade.js";
+export { IngestFacade } from "./internal/facades/ingest-facade.js";
+export { CollectionRefError } from "./internal/facades/explore-facade.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA4B5C,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}

package/build/core/api/ingest-facade.d.ts

@@ -0,0 +1,42 @@
+/**
+ * IngestFacade - Public API for codebase indexing operations.
+ *
+ * Delegates to:
+ * - IndexPipeline: full codebase indexing from scratch
+ * - ReindexPipeline: incremental re-indexing of changed files
+ * - StatusModule: index status queries and cleanup
+ * - EnrichmentCoordinator: background trajectory metadata enrichment
+ *
+ * Post-index: recomputes collection stats and saves to cache.
+ */
+import type { EmbeddingProvider } from "../adapters/embeddings/base.js";
+import type { QdrantManager } from "../adapters/qdrant/client.js";
+import type { PayloadSignalDescriptor } from "../contracts/types/trajectory.js";
+import type { Reranker } from "../explore/reranker.js";
+import type { StatsCache } from "../infra/stats-cache.js";
+import { type SynchronizerTuning } from "../ingest/factory.js";
+import type { PipelineTuning } from "../ingest/pipeline/base.js";
+import type { DeletionConfig } from "../ingest/sync/deletion-strategy.js";
+import type { ChangeStats, IndexOptions, IndexStats, IndexStatus, IngestCodeConfig, ProgressCallback, TrajectoryIngestConfig } from "../types.js";
+export declare class IngestFacade {
+    private readonly qdrant;
+    private readonly statsCache?;
+    private readonly allPayloadSignals?;
+    private readonly reranker?;
+    private readonly enrichment;
+    private readonly indexing;
+    private readonly status;
+    private readonly reindex;
+    constructor(qdrant: QdrantManager, embeddings: EmbeddingProvider, ingestConfig: IngestCodeConfig, trajectoryConfig: TrajectoryIngestConfig, statsCache?: StatsCache | undefined, allPayloadSignals?: PayloadSignalDescriptor[] | undefined, reranker?: Reranker | undefined, deleteConfig?: DeletionConfig, pipelineTuning?: PipelineTuning, syncTuning?: SynchronizerTuning);
+    /** Index a codebase from scratch or force re-index */
+    indexCodebase(path: string, options?: IndexOptions, progressCallback?: ProgressCallback): Promise<IndexStats>;
+    /** Incrementally re-index only changed files */
+    reindexChanges(path: string, progressCallback?: ProgressCallback): Promise<ChangeStats>;
+    /** Get indexing status for a codebase */
+    getIndexStatus(path: string): Promise<IndexStatus>;
+    /** Clear all indexed data for a codebase */
+    clearIndex(path: string): Promise<void>;
+    /** Recompute collection stats from Qdrant and save to cache. */
+    private refreshStats;
+}
+//# sourceMappingURL=ingest-facade.d.ts.map

package/build/core/api/ingest-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-facade.d.ts","sourceRoot":"","sources":["../../../src/core/api/ingest-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAG1E,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAIvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAZ5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAGvB,MAAM,EAAE,aAAa,EACtC,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,gBAAgB,EAC9B,gBAAgB,EAAE,sBAAsB,EACvB,UAAU,CAAC,EAAE,UAAU,YAAA,EACvB,iBAAiB,CAAC,EAAE,uBAAuB,EAAE,YAAA,EAC7C,QAAQ,CAAC,EAAE,QAAQ,YAAA,EACpC,YAAY,CAAC,EAAE,cAAc,EAC7B,cAAc,CAAC,EAAE,cAAc,EAC/B,UAAU,CAAC,EAAE,kBAAkB;IAyBjC,sDAAsD;IAChD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMnH,gDAAgD;IAC1C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7F,yCAAyC;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxD,4CAA4C;IACtC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,gEAAgE;YAClD,YAAY;CAe3B"}

package/build/core/api/ingest-facade.js

@@ -0,0 +1,89 @@
+/**
+ * IngestFacade - Public API for codebase indexing operations.
+ *
+ * Delegates to:
+ * - IndexPipeline: full codebase indexing from scratch
+ * - ReindexPipeline: incremental re-indexing of changed files
+ * - StatusModule: index status queries and cleanup
+ * - EnrichmentCoordinator: background trajectory metadata enrichment
+ *
+ * Post-index: recomputes collection stats and saves to cache.
+ */
+import { snapshotsDir } from "../../bootstrap/config/paths.js";
+import { scrollAllPoints } from "../adapters/qdrant/scroll.js";
+import { computeCollectionStats } from "../ingest/collection-stats.js";
+import { resolveCollectionName, validatePath } from "../ingest/collection.js";
+import { createIngestDependencies } from "../ingest/factory.js";
+import { IndexPipeline } from "../ingest/indexing.js";
+import { EnrichmentCoordinator } from "../ingest/pipeline/enrichment/coordinator.js";
+import { StatusModule } from "../ingest/pipeline/status-module.js";
+import { ReindexPipeline } from "../ingest/reindexing.js";
+import { GitEnrichmentProvider } from "../trajectory/git/provider.js";
+import { StaticPayloadBuilder } from "../trajectory/static/provider.js";
+export class IngestFacade {
+    qdrant;
+    statsCache;
+    allPayloadSignals;
+    reranker;
+    enrichment;
+    indexing;
+    status;
+    reindex;
+    constructor(qdrant, embeddings, ingestConfig, trajectoryConfig, statsCache, allPayloadSignals, reranker, deleteConfig, pipelineTuning, syncTuning) {
+        this.qdrant = qdrant;
+        this.statsCache = statsCache;
+        this.allPayloadSignals = allPayloadSignals;
+        this.reranker = reranker;
+        const snapshotDir = snapshotsDir();
+        const deps = createIngestDependencies(qdrant, snapshotDir, new StaticPayloadBuilder(), syncTuning);
+        const squashOpts = trajectoryConfig.squashAwareSessions
+            ? { squashAwareSessions: true, sessionGapMinutes: trajectoryConfig.sessionGapMinutes ?? 30 }
+            : undefined;
+        const providers = trajectoryConfig.enableGitMetadata
+            ? [new GitEnrichmentProvider(trajectoryConfig.trajectoryGit ?? undefined, squashOpts)]
+            : [];
+        this.enrichment = new EnrichmentCoordinator(qdrant, providers);
+        this.indexing = new IndexPipeline(qdrant, embeddings, ingestConfig, this.enrichment, deps, pipelineTuning);
+        this.status = new StatusModule(qdrant);
+        this.reindex = new ReindexPipeline(qdrant, embeddings, ingestConfig, this.enrichment, deps, deleteConfig, pipelineTuning);
+    }
+    /** Index a codebase from scratch or force re-index */
+    async indexCodebase(path, options, progressCallback) {
+        const result = await this.indexing.indexCodebase(path, options, progressCallback);
+        await this.refreshStats(path);
+        return result;
+    }
+    /** Incrementally re-index only changed files */
+    async reindexChanges(path, progressCallback) {
+        const result = await this.reindex.reindexChanges(path, progressCallback);
+        await this.refreshStats(path);
+        return result;
+    }
+    /** Get indexing status for a codebase */
+    async getIndexStatus(path) {
+        return this.status.getIndexStatus(path);
+    }
+    /** Clear all indexed data for a codebase */
+    async clearIndex(path) {
+        return this.status.clearIndex(path);
+    }
+    /** Recompute collection stats from Qdrant and save to cache. */
+    async refreshStats(path) {
+        if (!this.statsCache || !this.allPayloadSignals)
+            return;
+        try {
+            const absolutePath = await validatePath(path);
+            const collectionName = resolveCollectionName(absolutePath);
+            const points = await scrollAllPoints(this.qdrant, collectionName);
+            const stats = computeCollectionStats(points, this.allPayloadSignals);
+            const payloadFieldKeys = this.allPayloadSignals.map((d) => d.key);
+            this.statsCache.save(collectionName, stats, payloadFieldKeys);
+            this.reranker?.invalidateStats();
+        }
+        catch (error) {
+            // Stats refresh failure should not fail the indexing operation
+            console.error("[StatsCache] Failed to refresh collection stats:", error);
+        }
+    }
+}
+//# sourceMappingURL=ingest-facade.js.map

package/build/core/api/ingest-facade.js.map

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