tea-rags 0.9.0

package/build/core/contracts/types/config.d.ts

@@ -0,0 +1,41 @@
+export interface EmbeddingTuneConfig {
+    batchSize: number;
+    minBatchSize?: number;
+    batchTimeoutMs: number;
+    maxRequestsPerMinute?: number;
+    retryAttempts: number;
+    retryDelayMs: number;
+}
+export interface EmbeddingConfig {
+    provider: "ollama" | "openai" | "cohere" | "voyage" | "onnx";
+    model?: string;
+    dimensions?: number;
+    device: string;
+    baseUrl?: string;
+    ollamaLegacyApi: boolean;
+    ollamaNumGpu: number;
+    openaiApiKey?: string;
+    cohereApiKey?: string;
+    voyageApiKey?: string;
+    tune: EmbeddingTuneConfig;
+}
+export interface TrajectoryGitConfig {
+    enabled: boolean;
+    logMaxAgeMonths: number;
+    logTimeoutMs: number;
+    chunkConcurrency: number;
+    chunkMaxAgeMonths: number;
+    chunkTimeoutMs: number;
+    chunkMaxFileLines: number;
+    squashAwareSessions: boolean;
+    sessionGapMinutes: number;
+}
+export interface QdrantTuneConfig {
+    upsertBatchSize: number;
+    upsertFlushIntervalMs: number;
+    upsertOrdering: "weak" | "medium" | "strong";
+    deleteBatchSize: number;
+    deleteConcurrency: number;
+    deleteFlushTimeoutMs: number;
+}
+//# sourceMappingURL=config.d.ts.map

package/build/core/contracts/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/build/core/contracts/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/build/core/contracts/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/core/contracts/types/config.ts"],"names":[],"mappings":""}

package/build/core/contracts/types/provider.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared provider contracts — domain interfaces for trajectory system.
+ * Lives in contracts/ for DIP: trajectory, ingest, search all import from here.
+ *
+ * EnrichmentProvider is the single interface that every trajectory provider
+ * must implement. It covers both the ingest side (buildFileSignals,
+ * buildChunkSignals) and the query side (signals, filters, presets).
+ */
+import type { QdrantFilterCondition } from "../../adapters/qdrant/types.js";
+import type { ChunkLookupEntry } from "../../types.js";
+import type { DerivedSignalDescriptor, RerankPreset } from "./reranker.js";
+import type { PayloadSignalDescriptor } from "./trajectory.js";
+/** Base type for file-level signal payload. All providers extend this. */
+export interface FileSignalOverlay {
+    [key: string]: unknown;
+}
+/** Base type for chunk-level signal payload. All providers extend this. */
+export interface ChunkSignalOverlay {
+    [key: string]: unknown;
+}
+export interface ScoringWeights {
+    [signal: string]: number | undefined;
+}
+/** Payload level for level-aware filters ("file" or "chunk"). */
+export type FilterLevel = "file" | "chunk";
+/** Result of converting a user param to Qdrant filter conditions. */
+export interface FilterConditionResult {
+    must?: QdrantFilterCondition[];
+    must_not?: QdrantFilterCondition[];
+}
+export interface FilterDescriptor {
+    /** Parameter name exposed to users (e.g. "author", "minAgeDays") */
+    param: string;
+    /** Human-readable description */
+    description: string;
+    /** Parameter type for schema generation */
+    type: "string" | "number" | "boolean" | "string[]";
+    /** Convert user param value to Qdrant filter condition(s) */
+    toCondition: (value: unknown, level?: FilterLevel) => FilterConditionResult;
+}
+export type FileSignalTransform = (data: FileSignalOverlay, maxEndLine: number) => FileSignalOverlay;
+/** Builds the base Qdrant payload from a chunk. Injected into the pipeline. */
+export interface PayloadBuilder {
+    buildPayload: (chunk: {
+        content: string;
+        startLine: number;
+        endLine: number;
+        metadata: Record<string, unknown>;
+    }, codebasePath: string) => Record<string, unknown>;
+}
+export interface EnrichmentProvider {
+    /** Namespace key for Qdrant payload: { [key].file: ..., [key].chunk: ... } */
+    readonly key: string;
+    /** Payload signal descriptors (raw payload field docs for MCP schema generation) */
+    readonly signals: PayloadSignalDescriptor[];
+    /** Derived signal descriptors for reranking (normalized transforms of raw signals) */
+    readonly derivedSignals: DerivedSignalDescriptor[];
+    /** Typed filter parameters → Qdrant conditions */
+    readonly filters: FilterDescriptor[];
+    /** Trajectory-owned presets (weight configurations) */
+    readonly presets: RerankPreset[];
+    /** Resolve the effective root for this provider (e.g. git repo root). */
+    resolveRoot: (absolutePath: string) => string;
+    /** Optional per-file transform applied at write time. */
+    readonly fileSignalTransform?: FileSignalTransform;
+    /** File-level signal enrichment (prefetch at T=0, or backfill for specific paths) */
+    buildFileSignals: (root: string, options?: {
+        paths?: string[];
+    }) => Promise<Map<string, FileSignalOverlay>>;
+    /** Chunk-level signal enrichment (post-flush) */
+    buildChunkSignals: (root: string, chunkMap: Map<string, ChunkLookupEntry[]>) => Promise<Map<string, Map<string, ChunkSignalOverlay>>>;
+}
+export type { ChunkLookupEntry } from "../../types.js";
+//# sourceMappingURL=provider.d.ts.map

package/build/core/contracts/types/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/types/provider.ts"],"names":[],"mappings":"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"}

package/build/core/contracts/types/provider.js

@@ -0,0 +1,10 @@
+/**
+ * Shared provider contracts — domain interfaces for trajectory system.
+ * Lives in contracts/ for DIP: trajectory, ingest, search all import from here.
+ *
+ * EnrichmentProvider is the single interface that every trajectory provider
+ * must implement. It covers both the ingest side (buildFileSignals,
+ * buildChunkSignals) and the query side (signals, filters, presets).
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/build/core/contracts/types/provider.js.map

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

package/build/core/contracts/types/reranker.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Reranker contract types — shared by search layer and consumers.
+ */
+import type { ScoringWeights } from "./provider.js";
+import type { DampeningConfig, ExtractContext } from "./trajectory.js";
+/**
+ * Derived signal descriptor — defines how to compute a normalized signal
+ * from raw payload data. Used by reranker for scoring and ranking overlay.
+ */
+export interface DerivedSignalDescriptor {
+    /** Derived signal name (weight key in presets) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Raw signal names this derived signal reads from (enables ranking overlay) */
+    sources: string[];
+    /** Extract normalized value (0-1) from raw signal data.
+     *  Optional `ctx.bounds` provides per-source adaptive bounds for normalization. */
+    extract: (rawSignals: Record<string, unknown>, ctx?: ExtractContext) => number;
+    /** Default upper bound for normalization */
+    defaultBound?: number;
+    /** Dampening source: which collection stat to use as confidence threshold. */
+    dampeningSource?: DampeningConfig;
+    /** Whether this signal inverts the raw value (1 - normalize pattern).
+     *  Used by rank_chunks to determine scroll direction: inverted=true → asc. */
+    inverted?: boolean;
+}
+export interface RerankableResult {
+    score: number;
+    payload?: {
+        relativePath?: string;
+        startLine?: number;
+        endLine?: number;
+        language?: string;
+        isDocumentation?: boolean;
+        chunkType?: string;
+        imports?: string[];
+        exports?: string[];
+        git?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+}
+/** Curates which raw signals appear in the ranking overlay for a preset. */
+export interface OverlayMask {
+    readonly file?: string[];
+    readonly chunk?: string[];
+    readonly derived?: string[];
+}
+/** Typed preset definition with description for schema generation and DI. */
+export interface RerankPreset {
+    readonly name: string;
+    readonly description: string;
+    readonly tools: string[];
+    readonly weights: ScoringWeights;
+    readonly overlayMask: OverlayMask;
+    /** Payload field to group results by (keep highest-scored per group). Used by rank_chunks. */
+    readonly groupBy?: string;
+}
+export type RerankMode<T extends string> = T | {
+    custom: ScoringWeights;
+    preset?: T;
+};
+/** Ranking overlay attached to each reranked result — explains WHY it scored this way. */
+export interface RankingOverlay {
+    preset: string;
+    file?: Record<string, unknown>;
+    chunk?: Record<string, unknown>;
+    derived?: Record<string, number>;
+}
+/** Search result with ranking overlay from reranker. */
+export interface RerankedResult extends RerankableResult {
+    rankingOverlay?: RankingOverlay;
+}
+//# sourceMappingURL=reranker.d.ts.map

package/build/core/contracts/types/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/types/reranker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;uFACmF;IACnF,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC;IAC/E,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEtF,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC"}

package/build/core/contracts/types/reranker.js

@@ -0,0 +1,5 @@
+/**
+ * Reranker contract types — shared by search layer and consumers.
+ */
+export {};
+//# sourceMappingURL=reranker.js.map

package/build/core/contracts/types/reranker.js.map

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

package/build/core/contracts/types/trajectory.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Trajectory type system — payload signal descriptors, stats, and extraction context.
+ */
+import type { EnrichmentProvider, FilterDescriptor } from "./provider.js";
+import type { DerivedSignalDescriptor, RerankPreset } from "./reranker.js";
+/** What statistics to compute for this signal at collection level. */
+export interface SignalStatsRequest {
+    /** Which percentiles to compute (e.g. [25, 50, 75, 95]) */
+    percentiles?: number[];
+    /** Compute arithmetic mean */
+    mean?: boolean;
+    /** Compute standard deviation */
+    stddev?: boolean;
+}
+/** Raw Qdrant payload field descriptor — key + type + description. */
+export interface PayloadSignalDescriptor {
+    /** Full Qdrant payload path (e.g. "git.file.commitCount") */
+    key: string;
+    /** Data type */
+    type: "string" | "number" | "boolean" | "string[]" | "timestamp";
+    /** Human-readable description */
+    description: string;
+    /** Optional: declare what collection-level stats to compute for this signal */
+    stats?: SignalStatsRequest;
+    /** Include in metaOnly results even without overlay mask. Default: false. */
+    essential?: boolean;
+}
+/** Computed statistics for a single signal across the collection. */
+export interface SignalStats {
+    count: number;
+    /** Keyed by percentile number: { 25: 4.2, 50: 8.1, 75: 15.3, 95: 42.0 } */
+    percentiles?: Record<number, number>;
+    mean?: number;
+    stddev?: number;
+}
+/** Collection-wide signal statistics, cached between reindexes. */
+export interface CollectionSignalStats {
+    perSignal: Map<string, SignalStats>;
+    computedAt: number;
+}
+/** Context passed to DerivedSignalDescriptor.extract() for adaptive normalization. */
+export interface ExtractContext {
+    /** Per-source adaptive bounds keyed by source name (e.g. "file.ageDays" → 365) */
+    bounds?: Record<string, number>;
+    /** Confidence dampening threshold resolved by Reranker from collection stats. */
+    dampeningThreshold?: number;
+    /** Collection-level signal statistics for signals needing specific percentiles (p50, p25, etc.) */
+    collectionStats?: CollectionSignalStats;
+}
+/**
+ * Declares which collection-level statistic to use as confidence dampening threshold.
+ * Each trajectory provides its own dampening config (e.g., git uses commitCount p25).
+ */
+export interface DampeningConfig {
+    /** Full Qdrant payload key (e.g. "git.file.commitCount") */
+    readonly key: string;
+    /** Which percentile to use as threshold (e.g. 25) */
+    readonly percentile: number;
+}
+/**
+ * Trajectory — unified entry point for a trajectory module.
+ *
+ * Aggregates all query-side (signals, reranking, filters, presets)
+ * and ingest-side (enrichment provider) capabilities under a single key.
+ */
+export interface Trajectory {
+    readonly key: string;
+    readonly name: string;
+    readonly description: string;
+    readonly payloadSignals: PayloadSignalDescriptor[];
+    readonly derivedSignals: DerivedSignalDescriptor[];
+    readonly filters: FilterDescriptor[];
+    readonly presets: RerankPreset[];
+    readonly enrichment?: EnrichmentProvider;
+}
+//# sourceMappingURL=trajectory.d.ts.map

package/build/core/contracts/types/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../../../src/core/contracts/types/trajectory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3E,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IACjE,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mGAAmG;IACnG,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,cAAc,EAAE,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAEjC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C"}

package/build/core/contracts/types/trajectory.js

@@ -0,0 +1,5 @@
+/**
+ * Trajectory type system — payload signal descriptors, stats, and extraction context.
+ */
+export {};
+//# sourceMappingURL=trajectory.js.map

package/build/core/contracts/types/trajectory.js.map

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

package/build/core/domains/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/domains/explore/post-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-process.d.ts","sourceRoot":"","sources":["../../../../src/core/domains/explore/post-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,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/domains/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/domains/explore/post-process.js.map

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

package/build/core/domains/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/domains/explore/rank-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank-module.d.ts","sourceRoot":"","sources":["../../../../src/core/domains/explore/rank-module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACnG,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"}