tea-rags 0.9.0

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

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

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

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

package/build/core/api/public/app.d.ts

@@ -0,0 +1,58 @@
+/**
+ * App — unified public API contract for tea-rags.
+ *
+ * Contains:
+ * - App interface (the contract MCP/CLI consumers depend on)
+ * - AppDeps interface (what bootstrap provides to create an App)
+ * - createApp() factory (assembles internal classes into an App)
+ *
+ * To add a new endpoint:
+ * 1. Add DTO to public/dto/<domain>.ts
+ * 2. Add method to App interface below
+ * 3. Implement in internal/facades/ or internal/ops/
+ * 4. Wire in createApp() below — map App method to internal class
+ * 5. Register MCP tool in src/mcp/tools/
+ */
+import type { EmbeddingProvider } from "../../adapters/embeddings/base.js";
+import type { QdrantManager } from "../../adapters/qdrant/client.js";
+import type { Reranker } from "../../domains/explore/reranker.js";
+import type { SchemaDriftMonitor } from "../../infra/schema-drift-monitor.js";
+import type { ExploreFacade } from "../internal/facades/explore-facade.js";
+import type { IngestFacade } from "../internal/facades/ingest-facade.js";
+import type { AddDocumentsRequest, ChangeStats, CollectionInfo, CreateCollectionRequest, DeleteDocumentsRequest, ExploreCodeRequest, ExploreResponse, HybridSearchRequest, IndexOptions, IndexStats, IndexStatus, PresetDescriptors, ProgressCallback, RankChunksRequest, SemanticSearchRequest } from "./dto/index.js";
+export interface App {
+    semanticSearch: (request: SemanticSearchRequest) => Promise<ExploreResponse>;
+    hybridSearch: (request: HybridSearchRequest) => Promise<ExploreResponse>;
+    rankChunks: (request: RankChunksRequest) => Promise<ExploreResponse>;
+    searchCode: (request: ExploreCodeRequest) => Promise<ExploreResponse>;
+    indexCodebase: (path: string, options?: IndexOptions, progress?: ProgressCallback) => Promise<IndexStats>;
+    reindexChanges: (path: string, progress?: ProgressCallback) => Promise<ChangeStats>;
+    getIndexStatus: (path: string) => Promise<IndexStatus>;
+    clearIndex: (path: string) => Promise<void>;
+    createCollection: (request: CreateCollectionRequest) => Promise<CollectionInfo>;
+    listCollections: () => Promise<string[]>;
+    getCollectionInfo: (name: string) => Promise<CollectionInfo>;
+    deleteCollection: (name: string) => Promise<void>;
+    addDocuments: (request: AddDocumentsRequest) => Promise<{
+        count: number;
+    }>;
+    deleteDocuments: (request: DeleteDocumentsRequest) => Promise<{
+        count: number;
+    }>;
+    getSchemaDescriptors: () => PresetDescriptors;
+    checkSchemaDrift: (ref: {
+        path: string;
+    } | {
+        collection: string;
+    }) => Promise<string | null>;
+}
+export interface AppDeps {
+    qdrant: QdrantManager;
+    embeddings: EmbeddingProvider;
+    ingest: IngestFacade;
+    explore: ExploreFacade;
+    reranker: Reranker;
+    schemaDriftMonitor: SchemaDriftMonitor;
+}
+export declare function createApp(deps: AppDeps): App;
+//# sourceMappingURL=app.d.ts.map

package/build/core/api/public/app.d.ts.map

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

package/build/core/api/public/app.js

@@ -0,0 +1,64 @@
+/**
+ * App — unified public API contract for tea-rags.
+ *
+ * Contains:
+ * - App interface (the contract MCP/CLI consumers depend on)
+ * - AppDeps interface (what bootstrap provides to create an App)
+ * - createApp() factory (assembles internal classes into an App)
+ *
+ * To add a new endpoint:
+ * 1. Add DTO to public/dto/<domain>.ts
+ * 2. Add method to App interface below
+ * 3. Implement in internal/facades/ or internal/ops/
+ * 4. Wire in createApp() below — map App method to internal class
+ * 5. Register MCP tool in src/mcp/tools/
+ */
+import { CollectionOps } from "../internal/ops/collection-ops.js";
+import { DocumentOps } from "../internal/ops/document-ops.js";
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createApp(deps) {
+    const collectionOps = new CollectionOps(deps.qdrant, deps.embeddings);
+    const documentOps = new DocumentOps(deps.qdrant, deps.embeddings);
+    return {
+        // -- Search — delegate to ExploreFacade --
+        semanticSearch: async (req) => deps.explore.semanticSearch(req),
+        hybridSearch: async (req) => deps.explore.hybridSearch(req),
+        rankChunks: async (req) => deps.explore.rankChunks(req),
+        searchCode: async (req) => deps.explore.searchCode(req),
+        // -- Indexing — delegate to IngestFacade --
+        indexCodebase: async (path, options, progress) => deps.ingest.indexCodebase(path, options, progress),
+        reindexChanges: async (path, progress) => deps.ingest.reindexChanges(path, progress),
+        getIndexStatus: async (path) => deps.ingest.getIndexStatus(path),
+        clearIndex: async (path) => deps.ingest.clearIndex(path),
+        // -- Collections — delegate to CollectionOps --
+        createCollection: async (req) => collectionOps.create(req),
+        listCollections: async () => collectionOps.list(),
+        getCollectionInfo: async (name) => collectionOps.getInfo(name),
+        deleteCollection: async (name) => collectionOps.delete(name),
+        // -- Documents — delegate to DocumentOps --
+        addDocuments: async (req) => documentOps.add(req),
+        deleteDocuments: async (req) => documentOps.delete(req),
+        // -- Schema descriptors --
+        getSchemaDescriptors: () => {
+            const info = deps.reranker.getDescriptorInfo();
+            const tools = ["semantic_search", "hybrid_search", "search_code", "rank_chunks"];
+            const presetNames = {};
+            for (const tool of tools) {
+                presetNames[tool] = deps.reranker.getPresetNames(tool);
+            }
+            return {
+                presetNames,
+                signalDescriptors: info.map((d) => ({ name: d.name, description: d.description })),
+            };
+        },
+        // -- Drift monitoring --
+        checkSchemaDrift: async (ref) => {
+            if ("path" in ref)
+                return deps.schemaDriftMonitor.checkAndConsume(ref.path);
+            return deps.schemaDriftMonitor.checkByCollectionName(ref.collection);
+        },
+    };
+}
+//# sourceMappingURL=app.js.map

package/build/core/api/public/app.js.map

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

package/build/core/api/public/dto/collection.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Collection domain DTOs — collection CRUD types.
+ */
+export interface CreateCollectionRequest {
+    name: string;
+    distance?: "Cosine" | "Euclid" | "Dot";
+    enableHybrid?: boolean;
+}
+export interface CollectionInfo {
+    name: string;
+    vectorSize: number;
+    pointsCount: number;
+    distance: "Cosine" | "Euclid" | "Dot";
+    hybridEnabled?: boolean;
+}
+//# sourceMappingURL=collection.d.ts.map

package/build/core/api/public/dto/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/public/dto/collection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/build/core/api/public/dto/collection.js

@@ -0,0 +1,5 @@
+/**
+ * Collection domain DTOs — collection CRUD types.
+ */
+export {};
+//# sourceMappingURL=collection.js.map

package/build/core/api/public/dto/collection.js.map

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

package/build/core/api/public/dto/document.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Document domain DTOs — document add/delete types.
+ */
+export interface AddDocumentsRequest {
+    collection: string;
+    documents: {
+        id: string | number;
+        text: string;
+        metadata?: Record<string, unknown>;
+    }[];
+}
+export interface DeleteDocumentsRequest {
+    collection: string;
+    ids: (string | number)[];
+}
+//# sourceMappingURL=document.d.ts.map

package/build/core/api/public/dto/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/public/dto/document.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,EAAE,CAAC;CACL;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC1B"}

package/build/core/api/public/dto/document.js

@@ -0,0 +1,5 @@
+/**
+ * Document domain DTOs — document add/delete types.
+ */
+export {};
+//# sourceMappingURL=document.js.map

package/build/core/api/public/dto/document.js.map

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

package/build/core/api/public/dto/explore.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Explore domain DTOs — search request/response types.
+ */
+import type { RankingOverlay } from "../../../contracts/types/reranker.js";
+/**
+ * Identifies a collection by name or by codebase path (resolved to collection name internally).
+ * At least one of collection or path must be provided. Runtime validation enforces this.
+ */
+export interface CollectionRef {
+    collection?: string;
+    path?: string;
+}
+/** Typed filter params resolved via TrajectoryRegistry.buildFilter(). */
+export interface TypedFilterParams {
+    language?: string;
+    fileExtension?: string;
+    chunkType?: string;
+    isDocumentation?: boolean;
+    excludeDocumentation?: boolean;
+    fileTypes?: string[];
+    documentationOnly?: boolean;
+    author?: string;
+    modifiedAfter?: string | Date;
+    modifiedBefore?: string | Date;
+    minAgeDays?: number;
+    maxAgeDays?: number;
+    minCommitCount?: number;
+    taskId?: string;
+}
+/**
+ * Semantic (dense vector) search request.
+ * Intentionally separate from HybridSearchRequest to allow future divergence
+ * (e.g., hybrid may gain fusionWeight, sparse boosting params).
+ */
+export interface SemanticSearchRequest extends CollectionRef, TypedFilterParams {
+    query: string;
+    limit?: number;
+    filter?: Record<string, unknown>;
+    pathPattern?: string;
+    rerank?: string | {
+        custom: Record<string, number>;
+    };
+    metaOnly?: boolean;
+}
+/**
+ * Hybrid (dense + BM25 sparse) search request.
+ * Intentionally separate from SemanticSearchRequest to allow future divergence
+ * (e.g., fusionWeight, sparse boosting params).
+ */
+export interface HybridSearchRequest extends CollectionRef, TypedFilterParams {
+    query: string;
+    limit?: number;
+    filter?: Record<string, unknown>;
+    pathPattern?: string;
+    rerank?: string | {
+        custom: Record<string, number>;
+    };
+    metaOnly?: boolean;
+}
+export interface RankChunksRequest extends CollectionRef, TypedFilterParams {
+    rerank: string | {
+        custom: Record<string, number>;
+    };
+    level: "chunk" | "file";
+    limit?: number;
+    offset?: number;
+    filter?: Record<string, unknown>;
+    pathPattern?: string;
+    metaOnly?: boolean;
+}
+export interface ExploreCodeRequest extends TypedFilterParams {
+    path: string;
+    query: string;
+    limit?: number;
+    pathPattern?: string;
+    rerank?: string | {
+        custom: Record<string, number>;
+    };
+    filter?: Record<string, unknown>;
+}
+export interface SearchResult {
+    id: string | number;
+    score: number;
+    payload?: Record<string, unknown>;
+    rankingOverlay?: RankingOverlay;
+}
+export interface ExploreResponse {
+    results: SearchResult[];
+    driftWarning: string | null;
+}
+export interface SignalDescriptor {
+    name: string;
+    description: string;
+}
+export interface PresetDescriptors {
+    /** Preset names keyed by tool name (e.g. { semantic_search: ["relevance", "techDebt"] }) */
+    presetNames: Record<string, string[]>;
+    /** All derived signal descriptors available for custom weights */
+    signalDescriptors: SignalDescriptor[];
+}
+//# sourceMappingURL=explore.d.ts.map

package/build/core/api/public/dto/explore.d.ts.map

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

package/build/core/api/public/dto/explore.js

@@ -0,0 +1,5 @@
+/**
+ * Explore domain DTOs — search request/response types.
+ */
+export {};
+//# sourceMappingURL=explore.js.map

package/build/core/api/public/dto/explore.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * DTO barrel — re-exports all domain DTOs.
+ */
+export type { CollectionRef, TypedFilterParams, SemanticSearchRequest, HybridSearchRequest, RankChunksRequest, ExploreCodeRequest, SearchResult, ExploreResponse, SignalDescriptor, PresetDescriptors, } from "./explore.js";
+export type { IndexOptions, IndexStats, IndexStatus, ChangeStats, ProgressCallback, } from "./ingest.js";
+export type { CreateCollectionRequest, CollectionInfo, } from "./collection.js";
+export type { AddDocumentsRequest, DeleteDocumentsRequest, } from "./document.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/public/dto/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAEV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAEV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,uBAAuB,EACvB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAEV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/build/core/api/public/dto/index.js

@@ -0,0 +1,5 @@
+/**
+ * DTO barrel — re-exports all domain DTOs.
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

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

package/build/core/api/public/dto/ingest.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Ingest domain DTOs — indexing request/response types.
+ *
+ * App-facing types only. Internal pipeline types stay in core/types.ts.
+ */
+import type { ChunkEnrichmentInfo, EnrichmentInfo, IndexingStatus, ProgressUpdate } from "../../../types.js";
+export interface IndexOptions {
+    forceReindex?: boolean;
+    extensions?: string[];
+    ignorePatterns?: string[];
+}
+export interface IndexStats {
+    filesScanned: number;
+    filesIndexed: number;
+    chunksCreated: number;
+    durationMs: number;
+    status: "completed" | "partial" | "failed";
+    errors?: string[];
+    /** Git enrichment status */
+    enrichmentStatus?: "completed" | "partial" | "skipped" | "background";
+    enrichmentDurationMs?: number;
+}
+export interface ChangeStats {
+    filesAdded: number;
+    filesModified: number;
+    filesDeleted: number;
+    chunksAdded: number;
+    chunksDeleted: number;
+    durationMs: number;
+    status: "completed" | "partial" | "failed";
+    /** Git enrichment status */
+    enrichmentStatus?: "completed" | "partial" | "skipped" | "background";
+    enrichmentDurationMs?: number;
+}
+export interface IndexStatus {
+    /** @deprecated Use `status` instead. True only when status is 'indexed'. */
+    isIndexed: boolean;
+    /** Current indexing status: 'not_indexed', 'indexing', or 'indexed' */
+    status: IndexingStatus;
+    collectionName?: string;
+    filesCount?: number;
+    chunksCount?: number;
+    lastUpdated?: Date;
+    languages?: string[];
+    /** Background git enrichment progress (file-level) */
+    enrichment?: EnrichmentInfo;
+    /** Background chunk-level git enrichment progress */
+    chunkEnrichment?: ChunkEnrichmentInfo;
+}
+export type ProgressCallback = (progress: ProgressUpdate) => void;
+//# sourceMappingURL=ingest.d.ts.map

package/build/core/api/public/dto/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../../src/core/api/public/dto/ingest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM7G,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAMD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/build/core/api/public/dto/ingest.js

@@ -0,0 +1,7 @@
+/**
+ * Ingest domain DTOs — indexing request/response types.
+ *
+ * App-facing types only. Internal pipeline types stay in core/types.ts.
+ */
+export {};
+//# sourceMappingURL=ingest.js.map

package/build/core/api/public/dto/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../../src/core/api/public/dto/ingest.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,7 @@
+/**
+ * Public API barrel — exports App contract and all DTOs.
+ */
+export { createApp } from "./app.js";
+export type { App, AppDeps } from "./app.js";
+export type { CollectionRef, TypedFilterParams, SemanticSearchRequest, HybridSearchRequest, RankChunksRequest, ExploreCodeRequest, SearchResult, ExploreResponse, SignalDescriptor, PresetDescriptors, IndexOptions, IndexStats, IndexStatus, ChangeStats, ProgressCallback, CreateCollectionRequest, CollectionInfo, AddDocumentsRequest, DeleteDocumentsRequest, } from "./dto/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/api/public/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE7C,YAAY,EAEV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAEjB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAEhB,uBAAuB,EACvB,cAAc,EAEd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Public API barrel — exports App contract and all DTOs.
+ */
+export { createApp } from "./app.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/api/public/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

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

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

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

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

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

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

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

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

package/build/core/api/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/api/schema-drift-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-drift-monitor.d.ts","sourceRoot":"","sources":["../../../src/core/api/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"}