tea-rags 0.9.0

package/build/core/explore/strategies/base.js

@@ -0,0 +1,79 @@
+/**
+ * BaseExploreStrategy — abstract base for all explore strategies.
+ *
+ * Template Method pattern:
+ *   execute() = applyDefaults() → executeExplore() → postProcess()
+ *
+ * Concrete strategies implement only `executeExplore()` and `type`.
+ */
+import { calculateFetchLimit, filterResultsByGlob } from "../../adapters/qdrant/filters/index.js";
+import { filterMetaOnly } from "../post-process.js";
+export class BaseExploreStrategy {
+    qdrant;
+    reranker;
+    payloadSignals;
+    essentialKeys;
+    constructor(qdrant, reranker, payloadSignals, essentialKeys) {
+        this.qdrant = qdrant;
+        this.reranker = reranker;
+        this.payloadSignals = payloadSignals;
+        this.essentialKeys = essentialKeys;
+    }
+    /** Main entry point: apply defaults → execute search → post-process. */
+    async execute(ctx) {
+        const prepared = this.applyDefaults(ctx);
+        const rawResults = await this.executeExplore(prepared);
+        return this.postProcess(rawResults, ctx);
+    }
+    /**
+     * Apply defaults to context before passing to executeExplore.
+     * - Enforces minimum limit of 5
+     * - Computes overfetch limit when pathPattern or non-relevance rerank present
+     * Returns a new context with adjusted limit (fetchLimit for Qdrant).
+     */
+    applyDefaults(ctx) {
+        const requestedLimit = Math.max(ctx.limit ?? 0, 5);
+        const rerank = ctx.rerank;
+        const needsOverfetch = Boolean(ctx.pathPattern) || Boolean(rerank && rerank !== "relevance");
+        const fetchLimit = calculateFetchLimit(requestedLimit, needsOverfetch);
+        return { ...ctx, limit: fetchLimit };
+    }
+    /**
+     * Post-process raw results:
+     *   1. Glob filter (if pathPattern present)
+     *   2. Rerank (if non-relevance preset)
+     *   3. Trim to requested limit
+     *   4. metaOnly formatting (if ctx.metaOnly)
+     */
+    postProcess(results, originalCtx) {
+        const requestedLimit = Math.max(originalCtx.limit ?? 0, 5);
+        const rerank = originalCtx.rerank;
+        // 1. Glob filter
+        let filtered = originalCtx.pathPattern
+            ? filterResultsByGlob(results, originalCtx.pathPattern)
+            : results;
+        // 2. Rerank
+        if (rerank && rerank !== "relevance") {
+            filtered = this.reranker.rerank(filtered, rerank, "semantic_search");
+        }
+        // 3. Trim to requested limit
+        filtered = filtered.slice(0, requestedLimit);
+        // 4. metaOnly formatting
+        if (originalCtx.metaOnly) {
+            return this.applyMetaOnly(filtered);
+        }
+        return filtered;
+    }
+    /**
+     * Apply metaOnly formatting: strip raw content, keep metadata from payloadSignals.
+     * Wraps filterMetaOnly output back as ExploreResult[].
+     */
+    applyMetaOnly(results) {
+        const metaResults = filterMetaOnly(results, this.payloadSignals, this.essentialKeys);
+        return metaResults.map((meta) => ({
+            score: meta.score,
+            payload: meta,
+        }));
+    }
+}
+//# sourceMappingURL=base.js.map

package/build/core/explore/strategies/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElG,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,OAAgB,mBAAmB;IAIlB;IACA;IACF;IACA;IAJnB,YACqB,MAAqB,EACrB,QAAkB,EACpB,cAAyC,EACzC,aAAuB;QAHrB,WAAM,GAAN,MAAM,CAAe;QACrB,aAAQ,GAAR,QAAQ,CAAU;QACpB,mBAAc,GAAd,cAAc,CAA2B;QACzC,kBAAa,GAAb,aAAa,CAAU;IACvC,CAAC;IAEJ,wEAAwE;IACxE,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAKD;;;;;OAKG;IACO,aAAa,CAAC,GAAmB;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAwC,CAAC;QAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,WAAW,CAAC,CAAC;QAC7F,MAAM,UAAU,GAAG,mBAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACO,WAAW,CAAC,OAAwB,EAAE,WAA2B;QACzE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,MAAwC,CAAC;QAEpE,iBAAiB;QACjB,IAAI,QAAQ,GAAoB,WAAW,CAAC,WAAW;YACrD,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC;YACvD,CAAC,CAAC,OAAO,CAAC;QAEZ,YAAY;QACZ,IAAI,MAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACrC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACvE,CAAC;QAED,6BAA6B;QAC7B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAE7C,yBAAyB;QACzB,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACO,aAAa,CAAC,OAAwB;QAC9C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACrF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,KAAe;YAC3B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/build/core/explore/strategies/factory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Explore strategy factory — creates the appropriate strategy for a search type.
+ */
+import type { QdrantManager } from "../../adapters/qdrant/client.js";
+import type { PayloadSignalDescriptor } from "../../contracts/types/trajectory.js";
+import type { Reranker } from "../reranker.js";
+import type { BaseExploreStrategy } from "./base.js";
+export type ExploreStrategyType = "vector" | "hybrid" | "scroll-rank";
+export declare function createExploreStrategy(type: ExploreStrategyType, qdrant: QdrantManager, reranker: Reranker, payloadSignals: PayloadSignalDescriptor[], essentialKeys: string[]): BaseExploreStrategy;
+//# sourceMappingURL=factory.d.ts.map

package/build/core/explore/strategies/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAKrD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,uBAAuB,EAAE,EACzC,aAAa,EAAE,MAAM,EAAE,GACtB,mBAAmB,CAWrB"}

package/build/core/explore/strategies/factory.js

@@ -0,0 +1,19 @@
+/**
+ * Explore strategy factory — creates the appropriate strategy for a search type.
+ */
+import { HybridSearchStrategy } from "./hybrid.js";
+import { ScrollRankStrategy } from "./scroll-rank.js";
+import { VectorSearchStrategy } from "./vector.js";
+export function createExploreStrategy(type, qdrant, reranker, payloadSignals, essentialKeys) {
+    switch (type) {
+        case "vector":
+            return new VectorSearchStrategy(qdrant, reranker, payloadSignals, essentialKeys);
+        case "hybrid":
+            return new HybridSearchStrategy(qdrant, reranker, payloadSignals, essentialKeys);
+        case "scroll-rank":
+            return new ScrollRankStrategy(qdrant, reranker, payloadSignals, essentialKeys);
+        default:
+            throw new Error(`Unknown search strategy type: ${type}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/build/core/explore/strategies/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,UAAU,qBAAqB,CACnC,IAAyB,EACzB,MAAqB,EACrB,QAAkB,EAClB,cAAyC,EACzC,aAAuB;IAEvB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACnF,KAAK,QAAQ;YACX,OAAO,IAAI,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACnF,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACjF;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAc,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/build/core/explore/strategies/hybrid.d.ts

@@ -0,0 +1,14 @@
+/**
+ * HybridSearchStrategy — combined dense + sparse (BM25) vector search.
+ *
+ * Validates that the collection has hybrid search enabled,
+ * generates sparse vector from query, and executes hybrid search.
+ * Extracted from MCP search.ts hybrid_search handler.
+ */
+import { BaseExploreStrategy } from "./base.js";
+import { type ExploreContext, type ExploreResult } from "./types.js";
+export declare class HybridSearchStrategy extends BaseExploreStrategy {
+    readonly type: "hybrid";
+    protected executeExplore(ctx: ExploreContext): Promise<ExploreResult[]>;
+}
+//# sourceMappingURL=hybrid.d.ts.map

package/build/core/explore/strategies/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/hybrid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAyB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5F,qBAAa,oBAAqB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;cAElB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAc9E"}

package/build/core/explore/strategies/hybrid.js

@@ -0,0 +1,25 @@
+/**
+ * HybridSearchStrategy — combined dense + sparse (BM25) vector search.
+ *
+ * Validates that the collection has hybrid search enabled,
+ * generates sparse vector from query, and executes hybrid search.
+ * Extracted from MCP search.ts hybrid_search handler.
+ */
+import { BM25SparseVectorGenerator } from "../../adapters/qdrant/sparse.js";
+import { BaseExploreStrategy } from "./base.js";
+import { HybridNotEnabledError } from "./types.js";
+export class HybridSearchStrategy extends BaseExploreStrategy {
+    type = "hybrid";
+    async executeExplore(ctx) {
+        if (!ctx.embedding) {
+            throw new Error("HybridSearchStrategy requires an embedding in the context.");
+        }
+        const collectionInfo = await this.qdrant.getCollectionInfo(ctx.collectionName);
+        if (!collectionInfo.hybridEnabled) {
+            throw new HybridNotEnabledError(ctx.collectionName);
+        }
+        const sparseVector = ctx.sparseVector ?? BM25SparseVectorGenerator.generateSimple(ctx.query ?? "");
+        return this.qdrant.hybridSearch(ctx.collectionName, ctx.embedding, sparseVector, ctx.limit, ctx.filter);
+    }
+}
+//# sourceMappingURL=hybrid.js.map

package/build/core/explore/strategies/hybrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/hybrid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAA2C,MAAM,YAAY,CAAC;AAE5F,MAAM,OAAO,oBAAqB,SAAQ,mBAAmB;IAClD,IAAI,GAAG,QAAiB,CAAC;IAExB,KAAK,CAAC,cAAc,CAAC,GAAmB;QAChD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC/E,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,yBAAyB,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAEnG,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1G,CAAC;CACF"}

package/build/core/explore/strategies/index.d.ts

@@ -0,0 +1,9 @@
+export { createExploreStrategy } from "./factory.js";
+export type { ExploreStrategyType } from "./factory.js";
+export { HybridSearchStrategy } from "./hybrid.js";
+export { ScrollRankStrategy } from "./scroll-rank.js";
+export { BaseExploreStrategy } from "./base.js";
+export { HybridNotEnabledError } from "./types.js";
+export type { ExploreContext, ExploreResult, ExploreStrategy } from "./types.js";
+export { VectorSearchStrategy } from "./vector.js";
+//# sourceMappingURL=index.d.ts.map

package/build/core/explore/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/build/core/explore/strategies/index.js

@@ -0,0 +1,7 @@
+export { createExploreStrategy } from "./factory.js";
+export { HybridSearchStrategy } from "./hybrid.js";
+export { ScrollRankStrategy } from "./scroll-rank.js";
+export { BaseExploreStrategy } from "./base.js";
+export { HybridNotEnabledError } from "./types.js";
+export { VectorSearchStrategy } from "./vector.js";
+//# sourceMappingURL=index.js.map

package/build/core/explore/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/build/core/explore/strategies/scroll-rank.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ScrollRankStrategy — scroll-based chunk ranking without vector search.
+ *
+ * Overrides applyDefaults (metaOnly=true, offset, weights resolution)
+ * and postProcess (offset slicing, own limit logic — no overfetch).
+ */
+import { BaseExploreStrategy } from "./base.js";
+import type { ExploreContext, ExploreResult } from "./types.js";
+export declare class ScrollRankStrategy extends BaseExploreStrategy {
+    readonly type: "scroll-rank";
+    private readonly rankModule;
+    constructor(...args: ConstructorParameters<typeof BaseExploreStrategy>);
+    protected applyDefaults(ctx: ExploreContext): ExploreContext;
+    protected executeExplore(ctx: ExploreContext): Promise<ExploreResult[]>;
+    protected postProcess(results: ExploreResult[], originalCtx: ExploreContext): ExploreResult[];
+}
+//# sourceMappingURL=scroll-rank.d.ts.map

package/build/core/explore/strategies/scroll-rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-rank.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/scroll-rank.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,kBAAmB,SAAQ,mBAAmB;IACzD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,mBAAmB,CAAC;cAKnD,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc;cAgCrD,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;cAkC1D,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,cAAc,GAAG,aAAa,EAAE;CAqBvG"}

package/build/core/explore/strategies/scroll-rank.js

@@ -0,0 +1,89 @@
+/**
+ * ScrollRankStrategy — scroll-based chunk ranking without vector search.
+ *
+ * Overrides applyDefaults (metaOnly=true, offset, weights resolution)
+ * and postProcess (offset slicing, own limit logic — no overfetch).
+ */
+import { filterResultsByGlob } from "../../adapters/qdrant/filters/index.js";
+import { scrollOrderedBy } from "../../adapters/qdrant/scroll.js";
+import { RankModule } from "../rank-module.js";
+import { BaseExploreStrategy } from "./base.js";
+export class ScrollRankStrategy extends BaseExploreStrategy {
+    type = "scroll-rank";
+    rankModule;
+    constructor(...args) {
+        super(...args);
+        this.rankModule = new RankModule(this.reranker, this.reranker.getDescriptors());
+    }
+    applyDefaults(ctx) {
+        const metaOnly = ctx.metaOnly !== false; // defaults to true for rank_chunks
+        const effectiveOffset = ctx.offset || 0;
+        const requestedLimit = ctx.limit || 10;
+        const fetchLimit = requestedLimit + effectiveOffset;
+        // Resolve preset → weights (Reranker is Information Expert)
+        let { weights } = ctx;
+        let { presetName } = ctx;
+        if (!weights && ctx.rerank) {
+            if (typeof ctx.rerank === "string") {
+                const preset = this.reranker.getPreset(ctx.rerank, "rank_chunks");
+                if (!preset)
+                    throw new Error(`Unknown preset "${ctx.rerank}" for rank_chunks.`);
+                weights = Object.fromEntries(Object.entries(preset).filter((e) => typeof e[1] === "number"));
+                presetName = ctx.rerank;
+            }
+            else if (typeof ctx.rerank === "object" && ctx.rerank !== null && "custom" in ctx.rerank) {
+                weights = ctx.rerank.custom;
+            }
+        }
+        return {
+            ...ctx,
+            limit: fetchLimit,
+            filter: ctx.filter,
+            metaOnly,
+            offset: effectiveOffset,
+            weights,
+            presetName,
+        };
+    }
+    async executeExplore(ctx) {
+        const { weights } = ctx;
+        if (!weights || Object.keys(weights).length === 0) {
+            throw new Error("ScrollRankStrategy requires weights in the context.");
+        }
+        const scrollFn = async (col, orderBy, lim, f) => scrollOrderedBy(this.qdrant, col, orderBy, lim, f);
+        const ensureIndexFn = async (col, fieldName) => {
+            const isInteger = /count|days|lines/i.test(fieldName);
+            await this.qdrant.ensurePayloadIndex(col, fieldName, isInteger ? "integer" : "float");
+        };
+        const results = await this.rankModule.rankChunks(ctx.collectionName, {
+            weights,
+            level: ctx.level ?? "chunk",
+            limit: ctx.limit,
+            scrollFn,
+            ensureIndexFn,
+            filter: ctx.filter,
+            presetName: ctx.presetName,
+        });
+        return results.map((r) => ({
+            score: r.score,
+            payload: r.payload,
+        }));
+    }
+    postProcess(results, originalCtx) {
+        let processed = results;
+        if (originalCtx.pathPattern) {
+            processed = filterResultsByGlob(processed, originalCtx.pathPattern);
+        }
+        const effectiveOffset = originalCtx.offset || 0;
+        if (effectiveOffset > 0) {
+            processed = processed.slice(effectiveOffset);
+        }
+        processed = processed.slice(0, originalCtx.limit || 10);
+        const metaOnly = originalCtx.metaOnly !== false;
+        if (metaOnly) {
+            return this.applyMetaOnly(processed);
+        }
+        return processed;
+    }
+}
+//# sourceMappingURL=scroll-rank.js.map

package/build/core/explore/strategies/scroll-rank.js.map

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

package/build/core/explore/strategies/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Explore strategy types — shared interface for all explore execution strategies.
+ *
+ * Strategies encapsulate the business logic of how an explore operation is executed
+ * (vector, hybrid, scroll-rank) while keeping the MCP layer thin.
+ */
+import type { RankingOverlay } from "../../contracts/types/reranker.js";
+export interface ExploreContext {
+    collectionName: string;
+    query?: string;
+    embedding?: number[];
+    sparseVector?: {
+        indices: number[];
+        values: number[];
+    };
+    limit: number;
+    filter?: Record<string, unknown>;
+    weights?: Record<string, number>;
+    level?: "chunk" | "file";
+    presetName?: string;
+    offset?: number;
+    pathPattern?: string;
+    rerank?: unknown;
+    metaOnly?: boolean;
+}
+export interface ExploreResult<P = Record<string, unknown>> {
+    id?: string | number;
+    score: number;
+    payload?: P;
+    rankingOverlay?: RankingOverlay;
+}
+export interface ExploreStrategy {
+    readonly type: "vector" | "hybrid" | "scroll-rank";
+    execute: (ctx: ExploreContext) => Promise<ExploreResult[]>;
+}
+/**
+ * Error thrown when hybrid search is attempted on a collection
+ * that does not have hybrid search enabled.
+ */
+export declare class HybridNotEnabledError extends Error {
+    constructor(collectionName: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/build/core/explore/strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IACnD,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,cAAc,EAAE,MAAM;CAMnC"}

package/build/core/explore/strategies/types.js

@@ -0,0 +1,17 @@
+/**
+ * Explore strategy types — shared interface for all explore execution strategies.
+ *
+ * Strategies encapsulate the business logic of how an explore operation is executed
+ * (vector, hybrid, scroll-rank) while keeping the MCP layer thin.
+ */
+/**
+ * Error thrown when hybrid search is attempted on a collection
+ * that does not have hybrid search enabled.
+ */
+export class HybridNotEnabledError extends Error {
+    constructor(collectionName) {
+        super(`Collection "${collectionName}" does not have hybrid search enabled. Create a new collection with enableHybrid set to true.`);
+        this.name = "HybridNotEnabledError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/build/core/explore/strategies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,cAAsB;QAChC,KAAK,CACH,eAAe,cAAc,+FAA+F,CAC7H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/build/core/explore/strategies/vector.d.ts

@@ -0,0 +1,13 @@
+/**
+ * VectorSearchStrategy — semantic vector search via Qdrant.
+ *
+ * Executes a dense vector search against a collection.
+ * Extracted from MCP search.ts semantic_search handler.
+ */
+import { BaseExploreStrategy } from "./base.js";
+import type { ExploreContext, ExploreResult } from "./types.js";
+export declare class VectorSearchStrategy extends BaseExploreStrategy {
+    readonly type: "vector";
+    protected executeExplore(ctx: ExploreContext): Promise<ExploreResult[]>;
+}
+//# sourceMappingURL=vector.d.ts.map

package/build/core/explore/strategies/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../../src/core/explore/strategies/vector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,oBAAqB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;cAElB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAM9E"}

package/build/core/explore/strategies/vector.js

@@ -0,0 +1,17 @@
+/**
+ * VectorSearchStrategy — semantic vector search via Qdrant.
+ *
+ * Executes a dense vector search against a collection.
+ * Extracted from MCP search.ts semantic_search handler.
+ */
+import { BaseExploreStrategy } from "./base.js";
+export class VectorSearchStrategy extends BaseExploreStrategy {
+    type = "vector";
+    async executeExplore(ctx) {
+        if (!ctx.embedding) {
+            throw new Error("VectorSearchStrategy requires an embedding in the context.");
+        }
+        return this.qdrant.search(ctx.collectionName, ctx.embedding, ctx.limit, ctx.filter);
+    }
+}
+//# sourceMappingURL=vector.js.map

package/build/core/explore/strategies/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../../../src/core/explore/strategies/vector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD,MAAM,OAAO,oBAAqB,SAAQ,mBAAmB;IAClD,IAAI,GAAG,QAAiB,CAAC;IAExB,KAAK,CAAC,cAAc,CAAC,GAAmB;QAChD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtF,CAAC;CACF"}

package/build/core/infra/collection-name.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Collection name resolution and path validation utilities.
+ *
+ * Foundation layer — stateless pure functions used by all layers.
+ * Moved from ingest/collection.ts to fix layer violations.
+ */
+export declare class CollectionRefError extends Error {
+    constructor();
+}
+/**
+ * Validate path — resolves to realpath if exists, absolute path otherwise.
+ */
+export declare function validatePath(path: string): Promise<string>;
+/**
+ * Generate deterministic collection name from codebase path.
+ */
+export declare function resolveCollectionName(path: string): string;
+/**
+ * Resolve collection name from either explicit name or path.
+ * @throws CollectionRefError if neither is provided.
+ */
+export declare function resolveCollection(collection?: string, path?: string): {
+    collectionName: string;
+    path?: string;
+};
+//# sourceMappingURL=collection-name.d.ts.map

package/build/core/infra/collection-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name.d.ts","sourceRoot":"","sources":["../../../src/core/infra/collection-name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAI/G"}

package/build/core/infra/collection-name.js

@@ -0,0 +1,46 @@
+/**
+ * Collection name resolution and path validation utilities.
+ *
+ * Foundation layer — stateless pure functions used by all layers.
+ * Moved from ingest/collection.ts to fix layer violations.
+ */
+import { createHash } from "node:crypto";
+import { promises as fs } from "node:fs";
+import { resolve } from "node:path";
+export class CollectionRefError extends Error {
+    constructor() {
+        super("Either 'collection' or 'path' parameter is required.");
+        this.name = "CollectionRefError";
+    }
+}
+/**
+ * Validate path — resolves to realpath if exists, absolute path otherwise.
+ */
+export async function validatePath(path) {
+    const absolutePath = resolve(path);
+    try {
+        return await fs.realpath(absolutePath);
+    }
+    catch {
+        return absolutePath;
+    }
+}
+/**
+ * Generate deterministic collection name from codebase path.
+ */
+export function resolveCollectionName(path) {
+    const absolutePath = resolve(path);
+    const hash = createHash("md5").update(absolutePath).digest("hex");
+    return `code_${hash.substring(0, 8)}`;
+}
+/**
+ * Resolve collection name from either explicit name or path.
+ * @throws CollectionRefError if neither is provided.
+ */
+export function resolveCollection(collection, path) {
+    if (!collection && !path)
+        throw new CollectionRefError();
+    const collectionName = collection || resolveCollectionName(path);
+    return { collectionName, path };
+}
+//# sourceMappingURL=collection-name.js.map

package/build/core/infra/collection-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name.js","sourceRoot":"","sources":["../../../src/core/infra/collection-name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAmB,EAAE,IAAa;IAClE,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;IACzD,MAAM,cAAc,GAAG,UAAU,IAAI,qBAAqB,CAAC,IAAc,CAAC,CAAC;IAC3E,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/build/core/infra/runtime.d.ts

@@ -0,0 +1,3 @@
+export declare function setDebug(value: boolean): void;
+export declare function isDebug(): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/build/core/infra/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/core/infra/runtime.ts"],"names":[],"mappings":"AAMA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC"}

package/build/core/infra/runtime.js

@@ -0,0 +1,12 @@
+/**
+ * Runtime config — set once at startup, read many times.
+ * Avoids passing debug flag through every function signature.
+ */
+let _debug = false;
+export function setDebug(value) {
+    _debug = value;
+}
+export function isDebug() {
+    return _debug;
+}
+//# sourceMappingURL=runtime.js.map

package/build/core/infra/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/core/infra/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/core/infra/schema-drift-monitor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SchemaDriftMonitor — detects payload schema changes between server version and indexed data.
+ *
+ * Emits a warning ONCE per session (per instance). Shared across all MCP tools.
+ * Lazy: drift check triggers on first tool call that provides a collection path.
+ */
+import { StatsCache, type SchemaDrift } from "./stats-cache.js";
+export declare class SchemaDriftMonitor {
+    private readonly statsCache;
+    private readonly currentPayloadKeys;
+    private _warned;
+    private readonly _checkedCollections;
+    constructor(statsCache: StatsCache, currentPayloadKeys: string[]);
+    /**
+     * Check drift for a path and return warning (once per session).
+     * Returns null if already warned, no drift, or no cached keys.
+     */
+    checkAndConsume(path: string): Promise<string | null>;
+    /** Check drift synchronously when collection name is already known. */
+    checkByCollectionName(collectionName: string): string | null;
+    /** Expose drift detection for testing. */
+    static detectDrift(cachedKeys: string[] | undefined, currentKeys: string[]): SchemaDrift | null;
+}
+//# sourceMappingURL=schema-drift-monitor.d.ts.map

package/build/core/infra/schema-drift-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-drift-monitor.d.ts","sourceRoot":"","sources":["../../../src/core/infra/schema-drift-monitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhE,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IALrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAGtC,UAAU,EAAE,UAAU,EACtB,kBAAkB,EAAE,MAAM,EAAE;IAG/C;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqB3D,uEAAuE;IACvE,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe5D,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,IAAI;CAGhG"}