tea-rags 0.9.0

package/build/core/domains/trajectory/static/rerank/derived-signals/index.js

@@ -0,0 +1,21 @@
+import { ChunkDensitySignal } from "./chunk-density.js";
+import { ChunkSizeSignal } from "./chunk-size.js";
+import { DocumentationSignal } from "./documentation.js";
+import { ImportsSignal } from "./imports.js";
+import { PathRiskSignal } from "./path-risk.js";
+import { SimilaritySignal } from "./similarity.js";
+export { ChunkDensitySignal } from "./chunk-density.js";
+export { ChunkSizeSignal } from "./chunk-size.js";
+export { DocumentationSignal } from "./documentation.js";
+export { ImportsSignal } from "./imports.js";
+export { PathRiskSignal } from "./path-risk.js";
+export { SimilaritySignal } from "./similarity.js";
+export const staticDerivedSignals = [
+    new SimilaritySignal(),
+    new ChunkSizeSignal(),
+    new ChunkDensitySignal(),
+    new DocumentationSignal(),
+    new ImportsSignal(),
+    new PathRiskSignal(),
+];
+//# sourceMappingURL=index.js.map

package/build/core/domains/trajectory/static/rerank/derived-signals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/derived-signals/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,MAAM,oBAAoB,GAA8B;IAC7D,IAAI,gBAAgB,EAAE;IACtB,IAAI,eAAe,EAAE;IACrB,IAAI,kBAAkB,EAAE;IACxB,IAAI,mBAAmB,EAAE;IACzB,IAAI,aAAa,EAAE;IACnB,IAAI,cAAc,EAAE;CACrB,CAAC"}

package/build/core/domains/trajectory/static/rerank/derived-signals/path-risk.d.ts

@@ -0,0 +1,9 @@
+import type { DerivedSignalDescriptor } from "../../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../../contracts/types/trajectory.js";
+export declare class PathRiskSignal implements DerivedSignalDescriptor {
+    readonly name = "pathRisk";
+    readonly description = "Security-sensitive path pattern match (1 if matches, 0 otherwise)";
+    readonly sources: string[];
+    extract(rawSignals: Record<string, unknown>, _ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=path-risk.d.ts.map

package/build/core/domains/trajectory/static/rerank/derived-signals/path-risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-risk.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/derived-signals/path-risk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAcnF,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,uEAAuE;IAC3F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAChC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM;CAI5E"}

package/build/core/domains/trajectory/static/rerank/derived-signals/path-risk.js

@@ -0,0 +1,21 @@
+const RISKY_PATH_PATTERNS = [
+    "auth",
+    "security",
+    "crypto",
+    "password",
+    "secret",
+    "token",
+    "credential",
+    "permission",
+    "access",
+];
+export class PathRiskSignal {
+    name = "pathRisk";
+    description = "Security-sensitive path pattern match (1 if matches, 0 otherwise)";
+    sources = [];
+    extract(rawSignals, _ctx) {
+        const path = (rawSignals.relativePath || "").toLowerCase();
+        return RISKY_PATH_PATTERNS.some((p) => path.includes(p)) ? 1 : 0;
+    }
+}
+//# sourceMappingURL=path-risk.js.map

package/build/core/domains/trajectory/static/rerank/derived-signals/path-risk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-risk.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/derived-signals/path-risk.ts"],"names":[],"mappings":"AAGA,MAAM,mBAAmB,GAAG;IAC1B,MAAM;IACN,UAAU;IACV,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,QAAQ;CACT,CAAC;AAEF,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,mEAAmE,CAAC;IAClF,OAAO,GAAa,EAAE,CAAC;IAChC,OAAO,CAAC,UAAmC,EAAE,IAAqB;QAChE,MAAM,IAAI,GAAG,CAAE,UAAU,CAAC,YAAuB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACvE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;CACF"}

package/build/core/domains/trajectory/static/rerank/derived-signals/similarity.d.ts

@@ -0,0 +1,9 @@
+import type { DerivedSignalDescriptor } from "../../../../../contracts/types/reranker.js";
+import type { ExtractContext } from "../../../../../contracts/types/trajectory.js";
+export declare class SimilaritySignal implements DerivedSignalDescriptor {
+    readonly name = "similarity";
+    readonly description = "Base semantic similarity score from vector search";
+    readonly sources: string[];
+    extract(rawSignals: Record<string, unknown>, _ctx?: ExtractContext): number;
+}
+//# sourceMappingURL=similarity.d.ts.map

package/build/core/domains/trajectory/static/rerank/derived-signals/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/derived-signals/similarity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAEnF,qBAAa,gBAAiB,YAAW,uBAAuB;IAC9D,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,uDAAuD;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAChC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM;CAG5E"}

package/build/core/domains/trajectory/static/rerank/derived-signals/similarity.js

@@ -0,0 +1,9 @@
+export class SimilaritySignal {
+    name = "similarity";
+    description = "Base semantic similarity score from vector search";
+    sources = [];
+    extract(rawSignals, _ctx) {
+        return rawSignals._score ?? rawSignals.score ?? 0;
+    }
+}
+//# sourceMappingURL=similarity.js.map

package/build/core/domains/trajectory/static/rerank/derived-signals/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/derived-signals/similarity.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,mDAAmD,CAAC;IAClE,OAAO,GAAa,EAAE,CAAC;IAChC,OAAO,CAAC,UAAmC,EAAE,IAAqB;QAChE,OAAQ,UAAU,CAAC,MAAiB,IAAK,UAAU,CAAC,KAAgB,IAAI,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/build/core/domains/trajectory/static/rerank/presets/decomposition.d.ts

@@ -0,0 +1,11 @@
+import type { ScoringWeights } from "../../../../../contracts/types/provider.js";
+import type { OverlayMask, RerankPreset } from "../../../../../contracts/types/reranker.js";
+export declare class DecompositionPreset implements RerankPreset {
+    readonly name = "decomposition";
+    readonly description = "Find large, dense methods and blocks \u2014 candidates for decomposition";
+    readonly tools: string[];
+    readonly weights: ScoringWeights;
+    readonly overlayMask: OverlayMask;
+    readonly groupBy = "parentName";
+}
+//# sourceMappingURL=decomposition.d.ts.map

package/build/core/domains/trajectory/static/rerank/presets/decomposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposition.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/decomposition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE5F,qBAAa,mBAAoB,YAAW,YAAY;IACtD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,8EAAyE;IAC7F,QAAQ,CAAC,KAAK,WAAuD;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAI9B;IACF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAE/B;IACF,QAAQ,CAAC,OAAO,gBAAgB;CACjC"}

package/build/core/domains/trajectory/static/rerank/presets/decomposition.js

@@ -0,0 +1,15 @@
+export class DecompositionPreset {
+    name = "decomposition";
+    description = "Find large, dense methods and blocks — candidates for decomposition";
+    tools = ["semantic_search", "hybrid_search", "rank_chunks"];
+    weights = {
+        similarity: 0.4,
+        chunkSize: 0.4,
+        chunkDensity: 0.2,
+    };
+    overlayMask = {
+        derived: ["chunkSize", "chunkDensity"],
+    };
+    groupBy = "parentName";
+}
+//# sourceMappingURL=decomposition.js.map

package/build/core/domains/trajectory/static/rerank/presets/decomposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposition.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/decomposition.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,qEAAqE,CAAC;IACpF,KAAK,GAAG,CAAC,iBAAiB,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IAC5D,OAAO,GAAmB;QACjC,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,GAAG;KAClB,CAAC;IACO,WAAW,GAAgB;QAClC,OAAO,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;KACvC,CAAC;IACO,OAAO,GAAG,YAAY,CAAC;CACjC"}

package/build/core/domains/trajectory/static/rerank/presets/index.d.ts

@@ -0,0 +1,5 @@
+import type { RerankPreset } from "../../../../../contracts/types/reranker.js";
+export { DecompositionPreset } from "./decomposition.js";
+export { RelevancePreset } from "./relevance.js";
+export declare const STATIC_PRESETS: RerankPreset[];
+//# sourceMappingURL=index.d.ts.map

package/build/core/domains/trajectory/static/rerank/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAI/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,eAAO,MAAM,cAAc,EAAE,YAAY,EAAuD,CAAC"}

package/build/core/domains/trajectory/static/rerank/presets/index.js

@@ -0,0 +1,6 @@
+import { DecompositionPreset } from "./decomposition.js";
+import { RelevancePreset } from "./relevance.js";
+export { DecompositionPreset } from "./decomposition.js";
+export { RelevancePreset } from "./relevance.js";
+export const STATIC_PRESETS = [new RelevancePreset(), new DecompositionPreset()];
+//# sourceMappingURL=index.js.map

package/build/core/domains/trajectory/static/rerank/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAmB,CAAC,IAAI,eAAe,EAAE,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC"}

package/build/core/domains/trajectory/static/rerank/presets/relevance.d.ts

@@ -0,0 +1,10 @@
+import type { ScoringWeights } from "../../../../../contracts/types/provider.js";
+import type { OverlayMask, RerankPreset } from "../../../../../contracts/types/reranker.js";
+export declare class RelevancePreset implements RerankPreset {
+    readonly name = "relevance";
+    readonly description = "Pure semantic similarity ranking";
+    readonly tools: string[];
+    readonly weights: ScoringWeights;
+    readonly overlayMask: OverlayMask;
+}
+//# sourceMappingURL=relevance.d.ts.map

package/build/core/domains/trajectory/static/rerank/presets/relevance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevance.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/relevance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE5F,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,sCAAsC;IAC1D,QAAQ,CAAC,KAAK,WAAuD;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAuB;IACvD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAM;CACxC"}

package/build/core/domains/trajectory/static/rerank/presets/relevance.js

@@ -0,0 +1,8 @@
+export class RelevancePreset {
+    name = "relevance";
+    description = "Pure semantic similarity ranking";
+    tools = ["semantic_search", "hybrid_search", "search_code"];
+    weights = { similarity: 1.0 };
+    overlayMask = {};
+}
+//# sourceMappingURL=relevance.js.map

package/build/core/domains/trajectory/static/rerank/presets/relevance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevance.js","sourceRoot":"","sources":["../../../../../../../src/core/domains/trajectory/static/rerank/presets/relevance.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,kCAAkC,CAAC;IACjD,KAAK,GAAG,CAAC,iBAAiB,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IAC5D,OAAO,GAAmB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAC9C,WAAW,GAAgB,EAAE,CAAC;CACxC"}

package/build/core/explore/post-process.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Post-processing module for search results.
+ *
+ * Extracted from MCP search-pipeline.ts. Contains:
+ * - computeFetchLimit: determine Qdrant fetch limit with overfetch
+ * - postProcess: apply glob filter + reranking + limit
+ * - filterMetaOnly: format results for metaOnly mode
+ *
+ * NOTE: explore/ cannot import from trajectory/ (layer rule).
+ * BASE_PAYLOAD_SIGNALS is injected via payloadSignals parameter.
+ */
+import type { RankingOverlay } from "../contracts/types/reranker.js";
+import type { PayloadSignalDescriptor } from "../contracts/types/trajectory.js";
+import type { Reranker, RerankMode } from "./reranker.js";
+export interface SearchResult {
+    id?: string | number;
+    score: number;
+    payload?: Record<string, unknown>;
+    rankingOverlay?: RankingOverlay;
+}
+export interface FetchLimits {
+    requestedLimit: number;
+    fetchLimit: number;
+}
+export interface PostProcessOptions {
+    pathPattern?: string;
+    rerank?: RerankMode<string>;
+    limit: number;
+    reranker: Reranker;
+}
+/**
+ * Compute fetch limit for Qdrant queries, accounting for overfetch
+ * needed by client-side glob filtering and reranking.
+ */
+export declare function computeFetchLimit(requestedLimit: number | undefined, pathPattern?: string, rerank?: RerankMode<string>): FetchLimits;
+/**
+ * Apply post-processing pipeline: glob filter → rerank → trim to limit.
+ */
+export declare function postProcess(results: SearchResult[], options: PostProcessOptions): SearchResult[];
+/**
+ * Format results for metaOnly mode: extract metadata + overlay signals,
+ * exclude raw content. Returns null if metaOnly is falsy (caller should
+ * use full results instead).
+ *
+ * @param payloadSignals - Base payload signal descriptors (injected, not imported from trajectory)
+ * @param essentialTrajectoryFields - Keys like "git.file.ageDays" to include without overlay
+ */
+export declare function filterMetaOnly(results: SearchResult[], payloadSignals: PayloadSignalDescriptor[], essentialTrajectoryFields: string[]): Record<string, unknown>[];
+//# sourceMappingURL=post-process.d.ts.map

package/build/core/explore/post-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-process.d.ts","sourceRoot":"","sources":["../../../src/core/explore/post-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM1D,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GAC1B,WAAW,CAIb;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAQhG;AA+CD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EAAE,EACvB,cAAc,EAAE,uBAAuB,EAAE,EACzC,yBAAyB,EAAE,MAAM,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAyB3B"}

package/build/core/explore/post-process.js

@@ -0,0 +1,114 @@
+/**
+ * Post-processing module for search results.
+ *
+ * Extracted from MCP search-pipeline.ts. Contains:
+ * - computeFetchLimit: determine Qdrant fetch limit with overfetch
+ * - postProcess: apply glob filter + reranking + limit
+ * - filterMetaOnly: format results for metaOnly mode
+ *
+ * NOTE: explore/ cannot import from trajectory/ (layer rule).
+ * BASE_PAYLOAD_SIGNALS is injected via payloadSignals parameter.
+ */
+import { calculateFetchLimit, filterResultsByGlob } from "../adapters/qdrant/filters/index.js";
+// ---------------------------------------------------------------------------
+// computeFetchLimit
+// ---------------------------------------------------------------------------
+/**
+ * Compute fetch limit for Qdrant queries, accounting for overfetch
+ * needed by client-side glob filtering and reranking.
+ */
+export function computeFetchLimit(requestedLimit, pathPattern, rerank) {
+    const limit = requestedLimit || 5;
+    const needsOverfetch = Boolean(pathPattern) || Boolean(rerank && rerank !== "relevance");
+    return { requestedLimit: limit, fetchLimit: calculateFetchLimit(limit, needsOverfetch) };
+}
+// ---------------------------------------------------------------------------
+// postProcess
+// ---------------------------------------------------------------------------
+/**
+ * Apply post-processing pipeline: glob filter → rerank → trim to limit.
+ */
+export function postProcess(results, options) {
+    let filtered = options.pathPattern ? filterResultsByGlob(results, options.pathPattern) : results;
+    if (options.rerank && options.rerank !== "relevance") {
+        filtered = options.reranker.rerank(filtered, options.rerank, "semantic_search");
+    }
+    return filtered.slice(0, options.limit);
+}
+// ---------------------------------------------------------------------------
+// filterMetaOnly — metaOnly formatting
+// ---------------------------------------------------------------------------
+/** Check if overlay has any meaningful data. */
+function hasOverlayData(overlay) {
+    return Boolean((overlay.file && Object.keys(overlay.file).length > 0) ||
+        (overlay.chunk && Object.keys(overlay.chunk).length > 0) ||
+        (overlay.derived && Object.keys(overlay.derived).length > 0));
+}
+/** Build git object from ranking overlay raw signals. */
+function buildGitFromOverlay(overlay) {
+    const git = {};
+    if (overlay.file && Object.keys(overlay.file).length > 0)
+        git.file = overlay.file;
+    if (overlay.chunk && Object.keys(overlay.chunk).length > 0)
+        git.chunk = overlay.chunk;
+    return git;
+}
+/** Filter full git payload to only essential trajectory fields. */
+function filterGitByEssential(fullGit, essentialKeys) {
+    const git = {};
+    for (const level of ["file", "chunk"]) {
+        const levelData = fullGit[level];
+        if (!levelData)
+            continue;
+        const filtered = {};
+        for (const key of essentialKeys) {
+            const parts = key.split(".");
+            if (parts.length === 3 && parts[0] === "git" && parts[1] === level) {
+                const field = parts[2];
+                if (levelData[field] !== undefined) {
+                    filtered[field] = levelData[field];
+                }
+            }
+        }
+        if (Object.keys(filtered).length > 0)
+            git[level] = filtered;
+    }
+    return git;
+}
+/**
+ * Format results for metaOnly mode: extract metadata + overlay signals,
+ * exclude raw content. Returns null if metaOnly is falsy (caller should
+ * use full results instead).
+ *
+ * @param payloadSignals - Base payload signal descriptors (injected, not imported from trajectory)
+ * @param essentialTrajectoryFields - Keys like "git.file.ageDays" to include without overlay
+ */
+export function filterMetaOnly(results, payloadSignals, essentialTrajectoryFields) {
+    return results.map((r) => {
+        const meta = { score: r.score };
+        for (const signal of payloadSignals) {
+            if (r.payload?.[signal.key] !== undefined) {
+                meta[signal.key] = r.payload[signal.key];
+            }
+        }
+        const overlay = r.rankingOverlay;
+        const fullGit = r.payload?.git;
+        if (overlay && hasOverlayData(overlay)) {
+            const gitFromOverlay = buildGitFromOverlay(overlay);
+            if (Object.keys(gitFromOverlay).length > 0)
+                meta.git = gitFromOverlay;
+            if (overlay.derived && Object.keys(overlay.derived).length > 0)
+                meta.derived = overlay.derived;
+            meta.preset = overlay.preset;
+        }
+        else if (fullGit) {
+            const filtered = filterGitByEssential(fullGit, essentialTrajectoryFields);
+            if (Object.keys(filtered).length > 0)
+                meta.git = filtered;
+            if (overlay?.preset)
+                meta.preset = overlay.preset;
+        }
+        return meta;
+    });
+}
+//# sourceMappingURL=post-process.js.map

package/build/core/explore/post-process.js.map

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

package/build/core/explore/rank-module.d.ts

@@ -0,0 +1,45 @@
+/**
+ * RankModule — scroll-based chunk ranking without vector search.
+ *
+ * Scatter-gather: resolve order_by fields from preset weights → parallel scroll → merge → rerank.
+ */
+import type { DerivedSignalDescriptor, RerankableResult } from "../contracts/types/reranker.js";
+import type { Reranker } from "./reranker.js";
+interface OrderByField {
+    key: string;
+    direction: "asc" | "desc";
+}
+type ScrollFn = (collectionName: string, orderBy: OrderByField, limit: number, filter?: Record<string, unknown>) => Promise<{
+    id: string | number;
+    payload: Record<string, unknown>;
+}[]>;
+type EnsureIndexFn = (collectionName: string, fieldName: string) => Promise<void>;
+export interface RankOptions {
+    weights: Record<string, number>;
+    level: "chunk" | "file";
+    limit: number;
+    scrollFn: ScrollFn;
+    ensureIndexFn?: EnsureIndexFn;
+    filter?: Record<string, unknown>;
+    /** Original preset name — passed to reranker for overlay mask resolution. */
+    presetName?: string;
+}
+export declare class RankModule {
+    private readonly reranker;
+    private readonly descriptors;
+    private readonly descriptorMap;
+    constructor(reranker: Reranker, descriptors: DerivedSignalDescriptor[]);
+    /**
+     * Resolve order_by fields from preset weights + descriptor sources + inverted flag.
+     */
+    resolveOrderByFields(weights: Record<string, number>, level: "chunk" | "file"): OrderByField[];
+    /**
+     * Rank chunks: scatter-gather → merge → rerank → top-N.
+     */
+    rankChunks(collectionName: string, options: RankOptions): Promise<RerankableResult[]>;
+    private resolvePayloadField;
+    private removeAndNormalize;
+    private mergeAndDeduplicate;
+}
+export {};
+//# sourceMappingURL=rank-module.d.ts.map

package/build/core/explore/rank-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank-module.d.ts","sourceRoot":"","sources":["../../../src/core/explore/rank-module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,KAAK,QAAQ,GAAG,CACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,CAAC,CAAC;AAE1E,KAAK,aAAa,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;gBAGlD,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,uBAAuB,EAAE;IAQzD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,EAAE;IAqB9F;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwC3F,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,mBAAmB;CAe5B"}

package/build/core/explore/rank-module.js

@@ -0,0 +1,113 @@
+/**
+ * RankModule — scroll-based chunk ranking without vector search.
+ *
+ * Scatter-gather: resolve order_by fields from preset weights → parallel scroll → merge → rerank.
+ */
+const OVERFETCH_FACTOR = 3;
+export class RankModule {
+    reranker;
+    descriptors;
+    descriptorMap;
+    constructor(reranker, descriptors) {
+        this.reranker = reranker;
+        this.descriptors = descriptors;
+        this.descriptorMap = new Map();
+        for (const d of descriptors) {
+            this.descriptorMap.set(d.name, d);
+        }
+    }
+    /**
+     * Resolve order_by fields from preset weights + descriptor sources + inverted flag.
+     */
+    resolveOrderByFields(weights, level) {
+        const fields = [];
+        for (const [key, weight] of Object.entries(weights)) {
+            if (key === "similarity" || !weight)
+                continue;
+            const desc = this.descriptorMap.get(key);
+            if (!desc)
+                continue;
+            const payloadField = this.resolvePayloadField(desc.sources, level);
+            if (!payloadField)
+                continue;
+            fields.push({
+                key: payloadField,
+                direction: desc.inverted ? "asc" : "desc",
+            });
+        }
+        return fields;
+    }
+    /**
+     * Rank chunks: scatter-gather → merge → rerank → top-N.
+     */
+    async rankChunks(collectionName, options) {
+        const { weights, level, limit, scrollFn, ensureIndexFn, filter, presetName } = options;
+        // Remove similarity and re-normalize
+        const cleanWeights = this.removeAndNormalize(weights);
+        // Resolve order_by fields
+        const orderByFields = this.resolveOrderByFields(cleanWeights, level);
+        if (orderByFields.length === 0)
+            return [];
+        // Ensure payload indexes exist for order_by fields (Qdrant requires range index)
+        if (ensureIndexFn) {
+            await Promise.all(orderByFields.map(async (field) => ensureIndexFn(collectionName, field.key)));
+        }
+        // Parallel scroll (scatter)
+        const fetchLimit = limit * OVERFETCH_FACTOR;
+        const scrollResults = await Promise.all(orderByFields.map(async (field) => scrollFn(collectionName, field, fetchLimit, filter)));
+        // Merge + deduplicate (gather)
+        const merged = this.mergeAndDeduplicate(scrollResults);
+        if (merged.length === 0)
+            return [];
+        // Convert to RerankableResult (score=0, no similarity)
+        const rerankable = merged.map((p) => ({
+            score: 0,
+            payload: p.payload,
+        }));
+        // Rerank: use cleaned weights (no similarity) with preset overlay mask
+        const rerankMode = presetName ? { custom: cleanWeights, preset: presetName } : { custom: cleanWeights };
+        const reranked = this.reranker.rerank(rerankable, rerankMode, "rank_chunks");
+        return reranked.slice(0, limit);
+    }
+    // -- Private --
+    resolvePayloadField(sources, level) {
+        // 1. Try level-prefixed source (e.g. "chunk.commitCount" → "git.chunk.commitCount")
+        const levelSource = sources.find((s) => s.startsWith(`${level}.`));
+        if (levelSource)
+            return `git.${levelSource}`;
+        // 2. Try unprefixed source (e.g. "methodLines")
+        const unprefixed = sources.find((s) => !s.includes("."));
+        if (unprefixed)
+            return unprefixed;
+        // 3. Fallback: first source with git prefix
+        return sources[0] ? `git.${sources[0]}` : undefined;
+    }
+    removeAndNormalize(weights) {
+        const clean = {};
+        let total = 0;
+        for (const [key, weight] of Object.entries(weights)) {
+            if (key === "similarity" || !weight)
+                continue;
+            clean[key] = weight;
+            total += weight;
+        }
+        if (total === 0)
+            return clean;
+        for (const key of Object.keys(clean)) {
+            clean[key] = clean[key] / total;
+        }
+        return clean;
+    }
+    mergeAndDeduplicate(scrollResults) {
+        const seen = new Map();
+        for (const results of scrollResults) {
+            for (const point of results) {
+                if (!seen.has(point.id)) {
+                    seen.set(point.id, point);
+                }
+            }
+        }
+        return [...seen.values()];
+    }
+}
+//# sourceMappingURL=rank-module.js.map

package/build/core/explore/rank-module.js.map

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

package/build/core/explore/rerank/presets/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Preset resolution infrastructure — merges presets from 2-level hierarchy:
+ *   1. Registry presets (from all registered trajectories)
+ *   2. Composite (future — combines multiple trajectories, overrides by key)
+ *
+ * Resolution rule: later levels override earlier by (name, tool) key.
+ */
+import type { ScoringWeights } from "../../../contracts/types/provider.js";
+import type { RerankPreset } from "../../../contracts/types/reranker.js";
+export type { RerankPreset } from "../../../contracts/types/reranker.js";
+/**
+ * Resolve presets by 2-level hierarchy: registry -> composite.
+ * Later levels override earlier by (name, tool) key.
+ * Multi-tool presets are indexed for each tool they support.
+ */
+export declare function resolvePresets(registry: RerankPreset[], composite: RerankPreset[]): RerankPreset[];
+/** Get preset names for a specific tool. */
+export declare function getPresetNames(presets: RerankPreset[], tool: string): string[];
+/** Get preset weights by name + tool. */
+export declare function getPresetWeights(presets: RerankPreset[], name: string, tool: string): ScoringWeights | undefined;
+//# sourceMappingURL=index.d.ts.map

package/build/core/explore/rerank/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/explore/rerank/presets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,YAAY,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAQlG;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9E;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhH"}

package/build/core/explore/rerank/presets/index.js

@@ -0,0 +1,30 @@
+/**
+ * Preset resolution infrastructure — merges presets from 2-level hierarchy:
+ *   1. Registry presets (from all registered trajectories)
+ *   2. Composite (future — combines multiple trajectories, overrides by key)
+ *
+ * Resolution rule: later levels override earlier by (name, tool) key.
+ */
+/**
+ * Resolve presets by 2-level hierarchy: registry -> composite.
+ * Later levels override earlier by (name, tool) key.
+ * Multi-tool presets are indexed for each tool they support.
+ */
+export function resolvePresets(registry, composite) {
+    const map = new Map();
+    for (const preset of [...registry, ...composite]) {
+        for (const t of preset.tools) {
+            map.set(`${t}:${preset.name}`, preset);
+        }
+    }
+    return [...new Set(map.values())];
+}
+/** Get preset names for a specific tool. */
+export function getPresetNames(presets, tool) {
+    return presets.filter((p) => p.tools.includes(tool)).map((p) => p.name);
+}
+/** Get preset weights by name + tool. */
+export function getPresetWeights(presets, name, tool) {
+    return presets.find((p) => p.name === name && p.tools.includes(tool))?.weights;
+}
+//# sourceMappingURL=index.js.map

package/build/core/explore/rerank/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/explore/rerank/presets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAwB,EAAE,SAAyB;IAChF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,OAAuB,EAAE,IAAY;IAClE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,OAAuB,EAAE,IAAY,EAAE,IAAY;IAClF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC;AACjF,CAAC"}