@thoughtflow/core 0.1.2

package/dist/libs/codebase/knowledge/markdown-extractor.js

@@ -0,0 +1,273 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownExtractor = void 0;
+const fs = __importStar(require("node:fs"));
+class MarkdownExtractor {
+    extract(filePath, content) {
+        const text = content ?? this.readFile(filePath);
+        const lines = text.split("\n");
+        const frontmatter = this.parseFrontmatter(lines);
+        const sections = this.parseSections(lines);
+        const docType = this.classifyDocType(filePath, frontmatter.data, text);
+        const references = this.extractReferences(text);
+        const codeRefs = this.extractCodeReferences(text);
+        const qualityScore = this.calculateQuality(frontmatter, sections, text, filePath);
+        const isStale = this.checkStaleness(frontmatter);
+        return {
+            id: this.slugify(filePath),
+            filePath,
+            title: frontmatter.data.title ?? this.extractTitle(lines),
+            docType,
+            sections,
+            frontmatter: frontmatter.data,
+            references,
+            codeReferences: codeRefs,
+            qualityScore,
+            isStale,
+        };
+    }
+    extractAll(filePaths, rootPath) {
+        return filePaths
+            .map((fp) => {
+            const fullPath = rootPath + "/" + fp;
+            try {
+                return this.extract(fullPath);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((d) => d !== null);
+    }
+    readFile(filePath) {
+        return fs.readFileSync(filePath, "utf8");
+    }
+    parseFrontmatter(lines) {
+        const data = {};
+        let endLine = -1;
+        if (lines.length === 0 || lines[0].trim() !== "---") {
+            return { data, endLine };
+        }
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i].trim() === "---") {
+                endLine = i;
+                break;
+            }
+        }
+        if (endLine === -1)
+            return { data, endLine };
+        for (let i = 1; i < endLine; i++) {
+            const line = lines[i].trim();
+            const colonIdx = line.indexOf(":");
+            if (colonIdx === -1)
+                continue;
+            const key = line.slice(0, colonIdx).trim();
+            const value = line.slice(colonIdx + 1).trim();
+            if (value.startsWith("[") && value.endsWith("]")) {
+                data[key] = value.slice(1, -1).split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
+            }
+            else if (value === "true" || value === "false") {
+                data[key] = value === "true";
+            }
+            else if (/^-?\d+(\.\d+)?$/.test(value)) {
+                data[key] = parseFloat(value);
+            }
+            else {
+                data[key] = value.replace(/^["']|["']$/g, "");
+            }
+        }
+        return { data, endLine };
+    }
+    parseSections(lines) {
+        const sections = [];
+        let currentHeading = "";
+        let currentLevel = 0;
+        let currentLines = [];
+        let currentStart = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const match = lines[i].match(/^(#{1,6})\s+(.+)/);
+            if (match) {
+                if (currentLines.length > 0) {
+                    sections.push({
+                        heading: currentHeading,
+                        level: currentLevel,
+                        content: currentLines.join("\n").trim(),
+                        startLine: currentStart + 1,
+                    });
+                }
+                currentHeading = match[2].trim();
+                currentLevel = match[1].length;
+                currentLines = [];
+                currentStart = i + 1;
+            }
+            else {
+                currentLines.push(lines[i]);
+            }
+        }
+        if (currentLines.length > 0 || currentHeading) {
+            sections.push({
+                heading: currentHeading || "root",
+                level: currentLevel,
+                content: currentLines.join("\n").trim(),
+                startLine: currentStart + 1,
+            });
+        }
+        return sections;
+    }
+    extractTitle(lines) {
+        for (const line of lines) {
+            const match = line.match(/^#\s+(.+)/);
+            if (match)
+                return match[1].trim();
+        }
+        return "untitled";
+    }
+    classifyDocType(filePath, frontmatter, content) {
+        const fp = filePath.toLowerCase();
+        const txt = content.toLowerCase();
+        if (fp.includes("architecture") || fp.includes("arch/") || txt.includes("architecture decision"))
+            return "architecture";
+        if (fp.includes("decision") || fp.includes("adr") || txt.includes("decision record"))
+            return "decision";
+        if (fp.includes("business") || fp.includes("biznes") || fp.includes("bp-") || fp.includes("business_plan"))
+            return "business";
+        if (fp.includes("api") || fp.includes("spec") || fp.includes("openapi") || txt.includes("api specification"))
+            return "technical";
+        if (fp.includes("audit"))
+            return "audit";
+        if (fp.includes("guideline") || fp.includes("guide") || fp.includes("standard") || fp.includes("convention") || fp.includes("instruction"))
+            return "guideline";
+        if (fp.includes("readme") || fp.includes("contributing"))
+            return "technical";
+        const fmType = frontmatter.type;
+        if (fmType) {
+            const t = fmType.toLowerCase();
+            if (["architecture", "decision", "business", "technical", "audit", "guideline"].includes(t)) {
+                return t;
+            }
+        }
+        return "unknown";
+    }
+    extractReferences(text) {
+        const refs = [];
+        const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+        let match;
+        while ((match = linkPattern.exec(text)) !== null) {
+            const target = match[2];
+            if (target && !target.startsWith("http") && !target.startsWith("#")) {
+                refs.push(target);
+            }
+        }
+        return [...new Set(refs)];
+    }
+    extractCodeReferences(text) {
+        const refs = [];
+        const codeRefPattern = /`([^`]+\.(?:ts|tsx|js|jsx|py|go|rs|java))`/g;
+        let match;
+        while ((match = codeRefPattern.exec(text)) !== null) {
+            refs.push(match[1]);
+        }
+        const commentRefPattern = /\/\/\s*(?:@feature|@ref|@see|PROJECT-MCP):\s*(\S+)/g;
+        while ((match = commentRefPattern.exec(text)) !== null) {
+            refs.push(match[1]);
+        }
+        return [...new Set(refs)];
+    }
+    calculateQuality(frontmatter, sections, text, filePath) {
+        let score = 0;
+        if (frontmatter.endLine > -1)
+            score += 0.1;
+        if (frontmatter.data.title)
+            score += 0.1;
+        if (frontmatter.data.tags)
+            score += 0.05;
+        if (frontmatter.data.date || frontmatter.data.updated)
+            score += 0.05;
+        if (sections.length >= 3)
+            score += 0.1;
+        if (sections.length >= 5)
+            score += 0.05;
+        const refs = this.extractReferences(text);
+        const codeRefs = this.extractCodeReferences(text);
+        if (refs.length > 0)
+            score += 0.1;
+        if (codeRefs.length > 0)
+            score += 0.1;
+        const wordCount = text.split(/\s+/).length;
+        if (wordCount > 200)
+            score += 0.1;
+        if (wordCount > 500)
+            score += 0.05;
+        const autoGenPatterns = [
+            /generated by/i, /auto-generated/i, /do not edit/i,
+            /this file is automatically/i, /created with/i,
+        ];
+        if (autoGenPatterns.some((p) => p.test(text)))
+            score -= 0.2;
+        const chatPatterns = [
+            /^> /m, /^user:/im, /^assistant:/im, /^system:/im,
+            /conversation history/i, /token count/i,
+        ];
+        if (chatPatterns.some((p) => p.test(text)))
+            score -= 0.3;
+        if (wordCount < 50)
+            score -= 0.2;
+        return Math.max(0, Math.min(1, score));
+    }
+    checkStaleness(frontmatter) {
+        const dateStr = (frontmatter.data.date ?? frontmatter.data.updated ?? frontmatter.data.lastModified);
+        if (!dateStr)
+            return false;
+        try {
+            const date = new Date(dateStr);
+            const now = new Date();
+            const monthsOld = (now.getTime() - date.getTime()) / (1000 * 60 * 60 * 24 * 30);
+            return monthsOld > 6;
+        }
+        catch {
+            return false;
+        }
+    }
+    slugify(filePath) {
+        return filePath
+            .replace(/\.md$/, "")
+            .replace(/[^a-z0-9]+/gi, "-")
+            .replace(/^-+|-+$/g, "")
+            .toLowerCase();
+    }
+}
+exports.MarkdownExtractor = MarkdownExtractor;
+//# sourceMappingURL=markdown-extractor.js.map

package/dist/libs/codebase/knowledge/markdown-extractor.js.map

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

package/dist/libs/codebase/knowledge/summarizer.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export interface SummarizerConfig {
+    maxTokensPerChunk?: number;
+    concurrency?: number;
+}
+export interface SummarizedChunk {
+    chunkId: string;
+    summary: string;
+}
+export declare class Summarizer {
+    private callLLM;
+    private readonly maxTokens;
+    private readonly concurrency;
+    constructor(callLLM: (prompt: string, schema: z.ZodType) => Promise<Record<string, unknown>>, config?: SummarizerConfig);
+    summarizeChunks(chunks: Array<{
+        id: string;
+        text: string;
+        type: string;
+    }>): Promise<Map<string, string>>;
+    summarizeDocument(title: string, sections: Array<{
+        heading: string;
+        content: string;
+    }>): Promise<string>;
+}
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/libs/codebase/knowledge/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../../src/libs/codebase/knowledge/summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAU;IAKnB,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAG3B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxF,MAAM,GAAE,gBAAqB;IAMzB,eAAe,CACnB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACxD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAoCzB,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC;CAmBnB"}

package/dist/libs/codebase/knowledge/summarizer.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Summarizer = void 0;
+const zod_1 = require("zod");
+class Summarizer {
+    callLLM;
+    maxTokens;
+    concurrency;
+    constructor(callLLM, config = {}) {
+        this.callLLM = callLLM;
+        this.maxTokens = config.maxTokensPerChunk ?? 200;
+        this.concurrency = config.concurrency ?? 3;
+    }
+    async summarizeChunks(chunks) {
+        const summaries = new Map();
+        const schema = zod_1.z.object({
+            summary: zod_1.z.string().max(this.maxTokens),
+        });
+        for (let i = 0; i < chunks.length; i += this.concurrency) {
+            const batch = chunks.slice(i, i + this.concurrency);
+            const results = await Promise.all(batch.map(async (chunk) => {
+                const context = chunk.type === "documentation"
+                    ? "Summarize this documentation section in 1-2 sentences. Focus on the key information it conveys."
+                    : "Summarize this code fragment in 1 sentence. What does it do? Be specific about its purpose.";
+                const prompt = `${context}\n\n\`\`\`\n${chunk.text.slice(0, 2000)}\n\`\`\``;
+                try {
+                    const result = await this.callLLM(prompt, schema);
+                    return { id: chunk.id, summary: result.summary ?? "" };
+                }
+                catch {
+                    return { id: chunk.id, summary: "" };
+                }
+            }));
+            for (const result of results) {
+                if (result.summary) {
+                    summaries.set(result.id, result.summary);
+                }
+            }
+        }
+        return summaries;
+    }
+    async summarizeDocument(title, sections) {
+        const schema = zod_1.z.object({
+            summary: zod_1.z.string().max(500),
+        });
+        const sectionList = sections
+            .slice(0, 10)
+            .map((s) => `## ${s.heading}\n${s.content.slice(0, 500)}`)
+            .join("\n\n");
+        const prompt = `Summarize this document titled "${title}" in 1 paragraph. Cover the main topics and purpose.\n\n${sectionList}`;
+        try {
+            const result = await this.callLLM(prompt, schema);
+            return result.summary ?? "";
+        }
+        catch {
+            return "";
+        }
+    }
+}
+exports.Summarizer = Summarizer;
+//# sourceMappingURL=summarizer.js.map

package/dist/libs/codebase/knowledge/summarizer.js.map

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

package/dist/libs/codebase/search/bm25.d.ts

@@ -0,0 +1,23 @@
+export declare class Bm25Index {
+    private docs;
+    private docFreq;
+    private avgDocLength;
+    private totalTokens;
+    private readonly k1;
+    private readonly b;
+    addDocument(id: string, text: string): void;
+    addDocuments(docs: Array<{
+        id: string;
+        text: string;
+    }>): void;
+    removeDocument(id: string): void;
+    search(query: string, limit?: number): Array<{
+        id: string;
+        score: number;
+    }>;
+    clear(): void;
+    get size(): number;
+    private scoreDocument;
+    private tokenize;
+}
+//# sourceMappingURL=bm25.d.ts.map

package/dist/libs/codebase/search/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../../../src/libs/codebase/search/bm25.ts"],"names":[],"mappings":"AAMA,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAQ;IAE1B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAiB3C,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAM7D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAqBhC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAevE,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/libs/codebase/search/bm25.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bm25Index = void 0;
+class Bm25Index {
+    docs = [];
+    docFreq = new Map();
+    avgDocLength = 0;
+    totalTokens = 0;
+    k1 = 1.5;
+    b = 0.75;
+    addDocument(id, text) {
+        const tokens = this.tokenize(text);
+        const doc = { id, tokens, text };
+        this.docs.push(doc);
+        const seenTokens = new Set();
+        for (const token of tokens) {
+            if (!seenTokens.has(token)) {
+                this.docFreq.set(token, (this.docFreq.get(token) ?? 0) + 1);
+                seenTokens.add(token);
+            }
+        }
+        this.totalTokens += tokens.length;
+        this.avgDocLength = this.totalTokens / this.docs.length;
+    }
+    addDocuments(docs) {
+        for (const doc of docs) {
+            this.addDocument(doc.id, doc.text);
+        }
+    }
+    removeDocument(id) {
+        const idx = this.docs.findIndex((d) => d.id === id);
+        if (idx === -1)
+            return;
+        const doc = this.docs[idx];
+        const seenTokens = new Set(doc.tokens);
+        for (const token of seenTokens) {
+            const freq = (this.docFreq.get(token) ?? 1) - 1;
+            if (freq <= 0) {
+                this.docFreq.delete(token);
+            }
+            else {
+                this.docFreq.set(token, freq);
+            }
+        }
+        this.totalTokens -= doc.tokens.length;
+        this.docs.splice(idx, 1);
+        this.avgDocLength = this.totalTokens / Math.max(1, this.docs.length);
+    }
+    search(query, limit = 10) {
+        const queryTokens = this.tokenize(query);
+        const results = [];
+        for (const doc of this.docs) {
+            const score = this.scoreDocument(doc, queryTokens);
+            if (score > 0) {
+                results.push({ id: doc.id, score });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    clear() {
+        this.docs = [];
+        this.docFreq.clear();
+        this.avgDocLength = 0;
+        this.totalTokens = 0;
+    }
+    get size() {
+        return this.docs.length;
+    }
+    scoreDocument(doc, queryTokens) {
+        const N = this.docs.length;
+        const docLen = doc.tokens.length;
+        return queryTokens.reduce((sum, qt) => {
+            const tf = doc.tokens.filter((t) => t === qt).length;
+            if (tf === 0)
+                return sum;
+            const df = this.docFreq.get(qt) ?? 1;
+            const idf = Math.log((N - df + 0.5) / (df + 0.5) + 1);
+            const numerator = tf * (this.k1 + 1);
+            const denominator = tf + this.k1 * (1 - this.b + this.b * (docLen / this.avgDocLength));
+            return sum + idf * (numerator / denominator);
+        }, 0);
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9_\s]/g, " ")
+            .split(/\s+/)
+            .filter((t) => t.length >= 2);
+    }
+}
+exports.Bm25Index = Bm25Index;
+//# sourceMappingURL=bm25.js.map

package/dist/libs/codebase/search/bm25.js.map

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

package/dist/libs/codebase/search/hybrid-search.d.ts

@@ -0,0 +1,22 @@
+import type { IVectorStore, IEmbeddingProvider, VectorSearchOptions, VectorSearchResult } from "../../../contracts/vector-store.types";
+export interface HybridSearchOptions extends VectorSearchOptions {
+    rrfK?: number;
+    vectorWeight?: number;
+    keywordWeight?: number;
+}
+export declare class HybridSearch {
+    private vectorStore;
+    private embeddingProvider;
+    private bm25;
+    private initialized;
+    constructor(vectorStore: IVectorStore, embeddingProvider: IEmbeddingProvider);
+    indexDocuments(docs: Array<{
+        id: string;
+        text: string;
+    }>): void;
+    removeDocument(id: string): void;
+    search(query: string, options?: HybridSearchOptions): Promise<VectorSearchResult[]>;
+    clear(): void;
+    private fuseScore;
+}
+//# sourceMappingURL=hybrid-search.d.ts.map

package/dist/libs/codebase/search/hybrid-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.d.ts","sourceRoot":"","sources":["../../../../src/libs/codebase/search/hybrid-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAe,MAAM,uCAAuC,CAAC;AAGpJ,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IAKrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,iBAAiB;IAL3B,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,WAAW,CAAS;gBAGlB,WAAW,EAAE,YAAY,EACzB,iBAAiB,EAAE,kBAAkB;IAG/C,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAK/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI1B,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA0DhC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,SAAS;CAelB"}

package/dist/libs/codebase/search/hybrid-search.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridSearch = void 0;
+const bm25_1 = require("./bm25");
+class HybridSearch {
+    vectorStore;
+    embeddingProvider;
+    bm25 = new bm25_1.Bm25Index();
+    initialized = false;
+    constructor(vectorStore, embeddingProvider) {
+        this.vectorStore = vectorStore;
+        this.embeddingProvider = embeddingProvider;
+    }
+    indexDocuments(docs) {
+        this.bm25.addDocuments(docs);
+        this.initialized = true;
+    }
+    removeDocument(id) {
+        this.bm25.removeDocument(id);
+    }
+    async search(query, options) {
+        const rrfK = options?.rrfK ?? 60;
+        const vectorWeight = options?.vectorWeight ?? 0.5;
+        const keywordWeight = options?.keywordWeight ?? 0.5;
+        const queryVector = await this.embeddingProvider.embedQuery(query);
+        const [vectorResults, keywordResults] = await Promise.all([
+            this.vectorStore.search(queryVector, {
+                limit: options?.limit ?? 20,
+                filter: options?.filter,
+            }),
+            Promise.resolve(this.bm25.search(query, options?.limit ?? 20)),
+        ]);
+        const fusedScores = new Map();
+        for (let i = 0; i < vectorResults.length; i++) {
+            fusedScores.set(vectorResults[i].item.id, {
+                vectorRank: i + 1,
+                keywordRank: Infinity,
+                item: vectorResults[i].item,
+            });
+        }
+        const keywordIndex = new Map();
+        for (let i = 0; i < keywordResults.length; i++) {
+            keywordIndex.set(i + 1, keywordResults[i].id);
+            const existing = fusedScores.get(keywordResults[i].id);
+            if (existing) {
+                existing.keywordRank = i + 1;
+                const score = this.fuseScore(rrfK, { vector: existing.vectorRank, keyword: i + 1 }, vectorWeight, keywordWeight);
+                keywordIndex.set(i + 1, keywordResults[i].id);
+            }
+        }
+        const fused = [];
+        for (const [id, data] of fusedScores) {
+            const score = this.fuseScore(rrfK, { vector: data.vectorRank, keyword: data.keywordRank }, vectorWeight, keywordWeight);
+            fused.push({ id, score, item: data.item });
+        }
+        fused.sort((a, b) => b.score - a.score);
+        const limit = options?.limit ?? 10;
+        const offset = options?.offset ?? 0;
+        return fused.slice(offset, offset + limit).map((r) => ({
+            item: r.item,
+            score: r.score,
+        }));
+    }
+    clear() {
+        this.bm25.clear();
+        this.initialized = false;
+    }
+    fuseScore(k, ranks, vectorWeight, keywordWeight) {
+        let score = 0;
+        if (ranks.vector < Infinity) {
+            score += vectorWeight * (1 / (k + ranks.vector));
+        }
+        if (ranks.keyword < Infinity) {
+            score += keywordWeight * (1 / (k + ranks.keyword));
+        }
+        return score;
+    }
+}
+exports.HybridSearch = HybridSearch;
+//# sourceMappingURL=hybrid-search.js.map

package/dist/libs/codebase/search/hybrid-search.js.map

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