tea-rags 0.9.0

package/build/core/api/internal/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 "../../domains/explore/reranker.js";
+import { TrajectoryRegistry } from "../../domains/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/internal/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../../src/core/api/internal/composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,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/internal/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 "../../domains/explore/rerank/presets/index.js";
+import { Reranker } from "../../domains/explore/reranker.js";
+import { GitTrajectory } from "../../domains/trajectory/git.js";
+import { TrajectoryRegistry } from "../../domains/trajectory/index.js";
+import { StaticTrajectory } from "../../domains/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/internal/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../../src/core/api/internal/composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAU5E,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/internal/facades/explore-facade.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ExploreFacade — thin orchestrator for code exploration and search.
+ *
+ * Facade responsibilities (KEPT here):
+ *   validateCollectionExists, ensureStats, embed query, checkDrift
+ *
+ * Delegated to infra:
+ *   resolveCollection (infra/collection-name)
+ *
+ * Delegated to registry:
+ *   buildMergedFilter (TrajectoryRegistry)
+ *
+ * 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 "../../../domains/explore/reranker.js";
+import type { TrajectoryRegistry } from "../../../domains/trajectory/index.js";
+import { CollectionRefError } from "../../../infra/collection-name.js";
+import type { SchemaDriftMonitor } from "../../../infra/schema-drift-monitor.js";
+import type { StatsCache } from "../../../infra/stats-cache.js";
+import type { ExploreCodeRequest, ExploreResponse, HybridSearchRequest, RankChunksRequest, SemanticSearchRequest } from "../../public/dto/index.js";
+declare class CollectionNotFoundError extends Error {
+    constructor(collectionName: string, path?: string);
+}
+export interface ExploreFacadeDeps {
+    qdrant: QdrantManager;
+    embeddings: EmbeddingProvider;
+    reranker: Reranker;
+    registry: TrajectoryRegistry;
+    statsCache?: StatsCache;
+    schemaDriftMonitor?: SchemaDriftMonitor;
+    payloadSignals?: PayloadSignalDescriptor[];
+    essentialKeys?: 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(deps: ExploreFacadeDeps);
+    /** 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 validateCollectionExists;
+    private ensureStats;
+    private checkDrift;
+}
+export { CollectionRefError, CollectionNotFoundError };
+//# sourceMappingURL=explore-facade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore-facade.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/internal/facades/explore-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAMrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAInB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AAMnC,cAAM,uBAAwB,SAAQ,KAAK;gBAC7B,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAIlD;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,cAAc,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;gBAE7C,IAAI,EAAE,iBAAiB;IAkBnC,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;IAuBtE,uDAAuD;IACjD,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBvE,2EAA2E;YAC7D,cAAc;YAoBd,wBAAwB;YAOxB,WAAW;YAaX,UAAU;CAMzB;AAED,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}

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

@@ -0,0 +1,170 @@
+/**
+ * ExploreFacade — thin orchestrator for code exploration and search.
+ *
+ * Facade responsibilities (KEPT here):
+ *   validateCollectionExists, ensureStats, embed query, checkDrift
+ *
+ * Delegated to infra:
+ *   resolveCollection (infra/collection-name)
+ *
+ * Delegated to registry:
+ *   buildMergedFilter (TrajectoryRegistry)
+ *
+ * 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 "../../../domains/explore/strategies/index.js";
+import { CollectionRefError, resolveCollection, resolveCollectionName, validatePath, } from "../../../infra/collection-name.js";
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+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(deps) {
+        this.qdrant = deps.qdrant;
+        this.embeddings = deps.embeddings;
+        this.reranker = deps.reranker;
+        this.registry = deps.registry;
+        this.statsCache = deps.statsCache;
+        this.schemaDriftMonitor = deps.schemaDriftMonitor;
+        const signals = deps.payloadSignals ?? [];
+        const keys = deps.essentialKeys ?? [];
+        this.vectorStrategy = createExploreStrategy("vector", deps.qdrant, deps.reranker, signals, keys);
+        this.hybridStrategy = createExploreStrategy("hybrid", deps.qdrant, deps.reranker, signals, keys);
+        this.scrollRankStrategy = createExploreStrategy("scroll-rank", deps.qdrant, deps.reranker, signals, keys);
+    }
+    // =========================================================================
+    // Unified strategy pipeline
+    // =========================================================================
+    /** Semantic (dense vector) search over a collection. */
+    async semanticSearch(request) {
+        const { collectionName, path } = resolveCollection(request.collection, request.path);
+        const { embedding } = await this.embeddings.embed(request.query);
+        const filter = this.registry.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 } = resolveCollection(request.collection, request.path);
+        const { embedding } = await this.embeddings.embed(request.query);
+        const filter = this.registry.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 } = resolveCollection(request.collection, request.path);
+        const filter = this.registry.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.registry.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,
+        };
+    }
+    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
+            }
+        }
+    }
+    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/internal/facades/explore-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-facade.js","sourceRoot":"","sources":["../../../../../src/core/api/internal/facades/explore-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EACL,qBAAqB,GAGtB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,GACb,MAAM,mCAAmC,CAAC;AAW3C,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,uBAAwB,SAAQ,KAAK;IACzC,YAAY,cAAsB,EAAE,IAAa;QAC/C,KAAK,CAAC,eAAe,cAAc,oBAAoB,IAAI,CAAC,CAAC,CAAC,iBAAiB,IAAI,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnH,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAiBD,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,OAAO,aAAa;IACP,MAAM,CAAgB;IACtB,UAAU,CAAoB;IAC9B,QAAQ,CAAW;IACnB,QAAQ,CAAqB;IAC7B,UAAU,CAAc;IACxB,kBAAkB,CAAsB;IACxC,cAAc,CAAsB;IACpC,cAAc,CAAsB;IACpC,kBAAkB,CAAsB;IAEzD,YAAY,IAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjG,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjG,IAAI,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5G,CAAC;IAED,4EAA4E;IAC5E,4BAA4B;IAC5B,4EAA4E;IAE5E,wDAAwD;IACxD,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAA6C,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9G,OAAO,IAAI,CAAC,cAAc,CACxB,IAAI,CAAC,cAAc,EACnB;YACE,cAAc;YACd,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAA6C,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9G,OAAO,IAAI,CAAC,cAAc,CACxB,IAAI,CAAC,cAAc,EACnB;YACE,cAAc;YACd,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAC5C,OAA6C,EAC7C,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,CACd,CAAC;QACF,OAAO,IAAI,CAAC,cAAc,CACxB,IAAI,CAAC,kBAAkB,EACvB;YACE,cAAc;YACd,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,UAAU,CAAC,OAA2B;QAC1C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAA6C,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9G,OAAO,IAAI,CAAC,cAAc,CACxB,IAAI,CAAC,cAAc,EACnB;YACE,cAAc;YACd,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;YACzB,MAAM;YACN,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,EACD,YAAY,CACb,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E,2EAA2E;IACnE,KAAK,CAAC,cAAc,CAC1B,QAA6B,EAC7B,GAAmB,EACnB,IAAa;QAEb,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE;gBACd,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,cAAc,EAAE,CAAC,CAAC,cAAc;aACjC,CAAC,CAAC;YACH,YAAY;SACb,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,wBAAwB,CAAC,cAAsB,EAAE,IAAa;QAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,uBAAuB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,cAAsB;QAC9C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACnD,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAa,EAAE,cAAuB;QAC7D,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,cAAc;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}

package/build/core/api/internal/facades/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 "../../../domains/explore/reranker.js";
+import { type SynchronizerTuning } from "../../../domains/ingest/factory.js";
+import type { PipelineTuning } from "../../../domains/ingest/pipeline/base.js";
+import type { DeletionConfig } from "../../../domains/ingest/sync/deletion-strategy.js";
+import type { StatsCache } from "../../../infra/stats-cache.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, snapshotDir?: string);
+    /** 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/internal/facades/ingest-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-facade.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/internal/facades/ingest-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAEvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAI/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AAIxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,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,EAC/B,WAAW,CAAC,EAAE,MAAM;IA2BtB,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/internal/facades/ingest-facade.js

@@ -0,0 +1,91 @@
+/**
+ * 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 { homedir } from "node:os";
+import { join } from "node:path";
+import { scrollAllPoints } from "../../../adapters/qdrant/scroll.js";
+import { computeCollectionStats } from "../../../domains/ingest/collection-stats.js";
+import { createIngestDependencies } from "../../../domains/ingest/factory.js";
+import { IndexPipeline } from "../../../domains/ingest/indexing.js";
+import { EnrichmentCoordinator } from "../../../domains/ingest/pipeline/enrichment/coordinator.js";
+import { StatusModule } from "../../../domains/ingest/pipeline/status-module.js";
+import { ReindexPipeline } from "../../../domains/ingest/reindexing.js";
+import { GitEnrichmentProvider } from "../../../domains/trajectory/git/provider.js";
+import { StaticPayloadBuilder } from "../../../domains/trajectory/static/provider.js";
+import { resolveCollectionName, validatePath } from "../../../infra/collection-name.js";
+export class IngestFacade {
+    qdrant;
+    statsCache;
+    allPayloadSignals;
+    reranker;
+    enrichment;
+    indexing;
+    status;
+    reindex;
+    constructor(qdrant, embeddings, ingestConfig, trajectoryConfig, statsCache, allPayloadSignals, reranker, deleteConfig, pipelineTuning, syncTuning, snapshotDir) {
+        this.qdrant = qdrant;
+        this.statsCache = statsCache;
+        this.allPayloadSignals = allPayloadSignals;
+        this.reranker = reranker;
+        /* v8 ignore next 2 -- fallback for backward compat */
+        const resolvedSnapshotDir = snapshotDir ?? join(process.env.TEA_RAGS_DATA_DIR ?? join(homedir(), ".tea-rags"), "snapshots");
+        const deps = createIngestDependencies(qdrant, resolvedSnapshotDir, 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, resolvedSnapshotDir);
+        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/internal/facades/ingest-facade.js.map

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

package/build/core/api/internal/infra/schema-builder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SchemaBuilder — dynamic MCP schema generation via Reranker API (DIP).
+ *
+ * MCP layer imports SchemaBuilder from api/, never touches domain/foundation directly.
+ * All signal descriptors and preset names come from Reranker.getDescriptorInfo()
+ * and Reranker.getPresetNames(), which aggregate data from registered trajectories.
+ */
+import { z } from "zod";
+import type { Reranker } from "../../../domains/explore/reranker.js";
+export declare class SchemaBuilder {
+    private readonly reranker;
+    constructor(reranker: Reranker);
+    /**
+     * Build Zod schema for custom scoring weights.
+     * Each derived signal becomes an optional numeric field with its description.
+     */
+    buildScoringWeightsSchema(): z.ZodObject<Record<string, z.ZodOptional<z.ZodNumber>>>;
+    /**
+     * Build Zod enum schema for preset names by tool.
+     * Throws if the tool has no registered presets (z.enum requires >= 1 element).
+     */
+    buildPresetSchema(tool: string): z.ZodEnum<[string, ...string[]]>;
+    /**
+     * Build the full rerank union schema: preset enum | { custom: weights }.
+     * Used directly in SemanticSearchSchema, HybridSearchSchema, SearchCodeSchema.
+     */
+    buildRerankSchema(tool: string): z.ZodUnion<[z.ZodEnum<[string, ...string[]]>, z.ZodObject<{
+        custom: z.ZodObject<Record<string, z.ZodOptional<z.ZodNumber>>, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: number | undefined;
+        }, {
+            [x: string]: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        custom: {
+            [x: string]: number | undefined;
+        };
+    }, {
+        custom: {
+            [x: string]: number | undefined;
+        };
+    }>]>;
+}
+//# sourceMappingURL=schema-builder.d.ts.map

package/build/core/api/internal/infra/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/internal/infra/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAE/C;;;OAGG;IACH,yBAAyB,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAQpF;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAQjE;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;CAK/B"}

package/build/core/api/internal/infra/schema-builder.js

@@ -0,0 +1,46 @@
+/**
+ * SchemaBuilder — dynamic MCP schema generation via Reranker API (DIP).
+ *
+ * MCP layer imports SchemaBuilder from api/, never touches domain/foundation directly.
+ * All signal descriptors and preset names come from Reranker.getDescriptorInfo()
+ * and Reranker.getPresetNames(), which aggregate data from registered trajectories.
+ */
+import { z } from "zod";
+export class SchemaBuilder {
+    reranker;
+    constructor(reranker) {
+        this.reranker = reranker;
+    }
+    /**
+     * Build Zod schema for custom scoring weights.
+     * Each derived signal becomes an optional numeric field with its description.
+     */
+    buildScoringWeightsSchema() {
+        const shape = {};
+        for (const d of this.reranker.getDescriptorInfo()) {
+            shape[d.name] = z.number().optional().describe(d.description);
+        }
+        return z.object(shape);
+    }
+    /**
+     * Build Zod enum schema for preset names by tool.
+     * Throws if the tool has no registered presets (z.enum requires >= 1 element).
+     */
+    buildPresetSchema(tool) {
+        const names = this.reranker.getPresetNames(tool);
+        if (names.length === 0) {
+            throw new Error(`No presets registered for tool "${tool}"`);
+        }
+        return z.enum(names);
+    }
+    /**
+     * Build the full rerank union schema: preset enum | { custom: weights }.
+     * Used directly in SemanticSearchSchema, HybridSearchSchema, SearchCodeSchema.
+     */
+    buildRerankSchema(tool) {
+        const presetSchema = this.buildPresetSchema(tool);
+        const weightsSchema = this.buildScoringWeightsSchema();
+        return z.union([presetSchema, z.object({ custom: weightsSchema })]);
+    }
+}
+//# sourceMappingURL=schema-builder.js.map

package/build/core/api/internal/infra/schema-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../../../../src/core/api/internal/infra/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD;;;OAGG;IACH,yBAAyB;QACvB,MAAM,KAAK,GAA+C,EAAE,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAClD,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,GAAG,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,IAAY;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;CACF"}

package/build/core/api/internal/ops/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 "../../public/dto/index.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/internal/ops/collection-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-ops.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/internal/ops/collection-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzF,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/internal/ops/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/internal/ops/collection-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-ops.js","sourceRoot":"","sources":["../../../../../src/core/api/internal/ops/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/internal/ops/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 "../../public/dto/index.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/internal/ops/document-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-ops.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/internal/ops/document-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAE7F,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"}