@unlimiting/qsc 0.1.0

package/dist/search/index.js.map

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

package/dist/search/reranker.d.ts

@@ -0,0 +1,18 @@
+import type { LLMProvider } from "../llm/index.js";
+import type { FusedResult } from "./fusion.js";
+export interface RerankedResult extends FusedResult {
+    scores: FusedResult["scores"] & {
+        rerank?: number;
+    };
+}
+/**
+ * Rerank fused results using an LLM for relevance scoring.
+ * If no LLM is provided, returns the input results unchanged.
+ *
+ * Uses position-aware blending: top-ranked items keep more of their RRF score,
+ * while lower-ranked items rely more on the reranker score.
+ */
+export declare function rerank(query: string, results: FusedResult[], llm?: LLMProvider, options?: {
+    topN?: number;
+}): Promise<RerankedResult[]>;
+//# sourceMappingURL=reranker.d.ts.map

package/dist/search/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../src/search/reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EAAE,EACtB,GAAG,CAAC,EAAE,WAAW,EACjB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAuD3B"}

package/dist/search/reranker.js

@@ -0,0 +1,56 @@
+/**
+ * Rerank fused results using an LLM for relevance scoring.
+ * If no LLM is provided, returns the input results unchanged.
+ *
+ * Uses position-aware blending: top-ranked items keep more of their RRF score,
+ * while lower-ranked items rely more on the reranker score.
+ */
+export async function rerank(query, results, llm, options = {}) {
+    if (!llm || results.length === 0) {
+        return results.map((r) => ({ ...r }));
+    }
+    const topN = options.topN ?? results.length;
+    const toRerank = results.slice(0, topN);
+    const rest = results.slice(topN);
+    try {
+        // Use LLM rerank API: pass documents and get relevance scores
+        const documents = toRerank.map((r) => {
+            const header = r.name
+                ? `[${r.chunkType ?? "chunk"}] ${r.name} (${r.filePath})`
+                : `[${r.chunkType ?? "chunk"}] ${r.filePath}`;
+            return `${header}\n${r.content}`;
+        });
+        const scores = await llm.rerank(query, documents);
+        // Normalize rerank scores to 0–1
+        const maxScore = Math.max(...scores, 1);
+        const normalizedScores = scores.map((s) => Math.max(0, s / maxScore));
+        // Position-aware blending: blend RRF and rerank scores
+        const reranked = toRerank.map((r, i) => {
+            const rerankScore = normalizedScores[i] ?? 0;
+            // Weight shifts from RRF to rerank as position increases
+            const position = i / Math.max(toRerank.length - 1, 1);
+            const rrfWeight = 1 - position * 0.5; // 1.0 at top, 0.5 at bottom
+            const rerankWeight = 0.5 + position * 0.5; // 0.5 at top, 1.0 at bottom
+            const blendedScore = (rrfWeight * r.score + rerankWeight * rerankScore) /
+                (rrfWeight + rerankWeight);
+            return {
+                ...r,
+                score: blendedScore,
+                scores: {
+                    ...r.scores,
+                    rerank: rerankScore,
+                },
+            };
+        });
+        // Sort by blended score
+        reranked.sort((a, b) => b.score - a.score);
+        // Append non-reranked items
+        const restMapped = rest.map((r) => ({ ...r }));
+        return [...reranked, ...restMapped];
+    }
+    catch {
+        // LLM failure: graceful fallback to original ordering
+        return results.map((r) => ({ ...r }));
+    }
+}
+//# sourceMappingURL=reranker.js.map

package/dist/search/reranker.js.map

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

package/dist/search/vector.d.ts

@@ -0,0 +1,23 @@
+import type { Store } from "../store.js";
+import type { Embedder } from "../embedder/index.js";
+export interface VectorSearchResult {
+    chunkId: number;
+    fileId: number;
+    filePath: string;
+    content: string;
+    startLine: number | null;
+    endLine: number | null;
+    chunkType: string | null;
+    name: string | null;
+    score: number;
+}
+/**
+ * Perform vector similarity search.
+ * Embeds the query text using the provided Embedder, then searches via Store.searchVector.
+ */
+export declare function searchVector(store: Store, embedder: Embedder, query: string, limit?: number): Promise<VectorSearchResult[]>;
+/**
+ * Perform vector search with a pre-computed embedding.
+ */
+export declare function searchVectorWithEmbedding(store: Store, embedding: number[], limit?: number): VectorSearchResult[];
+//# sourceMappingURL=vector.d.ts.map

package/dist/search/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/search/vector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkB/B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,SAAK,GACT,kBAAkB,EAAE,CAetB"}

package/dist/search/vector.js

@@ -0,0 +1,47 @@
+/**
+ * Convert cosine distance to similarity score (0–1, higher is better).
+ */
+function distanceToScore(distance) {
+    return Math.max(0, 1 - distance);
+}
+/**
+ * Perform vector similarity search.
+ * Embeds the query text using the provided Embedder, then searches via Store.searchVector.
+ */
+export async function searchVector(store, embedder, query, limit = 20) {
+    const [embedding] = await embedder.embed([query]);
+    if (!embedding || embedding.length === 0)
+        return [];
+    const float32 = new Float32Array(embedding);
+    const raw = store.searchVector(float32, limit);
+    return raw.map((r) => ({
+        chunkId: r.chunk_id,
+        fileId: r.file_id,
+        filePath: r.file_path,
+        content: r.content,
+        startLine: r.start_line,
+        endLine: r.end_line,
+        chunkType: r.chunk_type,
+        name: r.name,
+        score: distanceToScore(r.distance),
+    }));
+}
+/**
+ * Perform vector search with a pre-computed embedding.
+ */
+export function searchVectorWithEmbedding(store, embedding, limit = 20) {
+    const float32 = new Float32Array(embedding);
+    const raw = store.searchVector(float32, limit);
+    return raw.map((r) => ({
+        chunkId: r.chunk_id,
+        fileId: r.file_id,
+        filePath: r.file_path,
+        content: r.content,
+        startLine: r.start_line,
+        endLine: r.end_line,
+        chunkType: r.chunk_type,
+        name: r.name,
+        score: distanceToScore(r.distance),
+    }));
+}
+//# sourceMappingURL=vector.js.map

package/dist/search/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../src/search/vector.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAY,EACZ,QAAkB,EAClB,KAAa,EACb,KAAK,GAAG,EAAE;IAEV,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAmB,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE/D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC;KACnC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAY,EACZ,SAAmB,EACnB,KAAK,GAAG,EAAE;IAEV,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAmB,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE/D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,OAAO,EAAE,CAAC,CAAC,QAAQ;QACnB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC;KACnC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,119 @@
+export interface RepositoryRow {
+    id: string;
+    path: string;
+    last_commit?: string | null;
+    indexed_at?: string | null;
+    config?: string | null;
+}
+export interface FileRow {
+    id: number;
+    repo_id: string;
+    path: string;
+    hash: string;
+    language?: string | null;
+    active: number;
+    indexed_at?: string | null;
+}
+export interface ChunkInput {
+    hash: string;
+    seq: number;
+    start_line?: number | null;
+    end_line?: number | null;
+    chunk_type?: string | null;
+    name?: string | null;
+    content: string;
+    metadata?: string | null;
+}
+export interface ChunkRow {
+    id: number;
+    file_id: number;
+    hash: string;
+    seq: number;
+    start_line: number | null;
+    end_line: number | null;
+    chunk_type: string | null;
+    name: string | null;
+    content: string;
+    metadata: string | null;
+}
+export interface UnembeddedChunk {
+    chunk_id: number;
+    content: string;
+    name: string | null;
+    chunk_type: string | null;
+    file_path: string;
+    language: string | null;
+    repo_id: string;
+}
+export interface EmbeddingInput {
+    chunk_id: number;
+    embedding: Float32Array;
+    model: string;
+}
+export interface BM25Result {
+    chunk_id: number;
+    file_id: number;
+    content: string;
+    name: string | null;
+    chunk_type: string | null;
+    start_line: number | null;
+    end_line: number | null;
+    file_path: string;
+    repo_id: string;
+    rank: number;
+}
+export interface VectorResult {
+    chunk_id: number;
+    file_id: number;
+    content: string;
+    name: string | null;
+    chunk_type: string | null;
+    start_line: number | null;
+    end_line: number | null;
+    file_path: string;
+    repo_id: string;
+    distance: number;
+}
+export interface StoreStats {
+    repositories: number;
+    files: number;
+    active_files: number;
+    chunks: number;
+    embedded_chunks: number;
+    pending_chunks: number;
+}
+export interface Store {
+    initDb(dimensions: number): void;
+    upsertRepository(repo: RepositoryRow): void;
+    upsertFile(file: Omit<FileRow, "id">): {
+        id: number;
+        changed: boolean;
+    };
+    insertChunks(fileId: number, chunks: ChunkInput[]): number[];
+    getUnembeddedChunks(limit?: number): UnembeddedChunk[];
+    insertEmbeddings(embeddings: EmbeddingInput[]): void;
+    searchBM25(query: string, limit?: number): BM25Result[];
+    searchVector(embedding: Float32Array, limit?: number): VectorResult[];
+    deactivateFiles(repoId: string, paths: string[]): void;
+    cleanup(): {
+        deletedChunks: number;
+        deletedVectors: number;
+    };
+    getStats(): StoreStats;
+    getRepository(repoId: string): RepositoryRow | undefined;
+    getActiveFiles(repoId: string): FileRow[];
+    getFileByPath(repoId: string, path: string): FileRow | undefined;
+    getChunksByFileId(fileId: number): ChunkRow[];
+    close(): void;
+}
+/**
+ * Format a chunk with contextual metadata for embedding.
+ * The resulting string includes file path, language, chunk type, and name
+ * as a prefix before the actual code content, so that the embedding model
+ * captures contextual information alongside the raw code.
+ *
+ * Format: "file: <path> | language: <lang> | type: <type> | name: <name> | code: <content>"
+ */
+export declare function formatChunkForEmbedding(chunk: UnembeddedChunk): string;
+export declare function createStore(dbPath: string): Store;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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