@eucoder/rag 0.2.0

package/dist/corrective-rag.js

@@ -0,0 +1,85 @@
+const DEFAULT_MAX_REWRITES = 1;
+const DEFAULT_MIN_GOOD_HITS = 2;
+const DEFAULT_MIN_SCORE = 0.3;
+const DEFAULT_TOP_K = 8;
+export class CorrectiveRag {
+    retriever;
+    grader;
+    rewriter;
+    maxRewrites;
+    minGoodHits;
+    minScore;
+    webFallback;
+    constructor(options) {
+        this.retriever = options.retriever;
+        this.grader = options.grader;
+        this.rewriter = options.rewriter;
+        this.maxRewrites = options.maxRewrites ?? DEFAULT_MAX_REWRITES;
+        this.minGoodHits = options.minGoodHits ?? DEFAULT_MIN_GOOD_HITS;
+        this.minScore = options.minScore ?? DEFAULT_MIN_SCORE;
+        this.webFallback = options.webFallback;
+    }
+    async answer(query) {
+        const steps = [];
+        let currentQuery = query;
+        let rewrites = 0;
+        steps.push(`Initial query: "${query}"`);
+        let hits = await this.retriever.search(currentQuery, DEFAULT_TOP_K);
+        steps.push(`Retrieved ${hits.length} candidates`);
+        let goodHits = await this.gradeHits(currentQuery, hits);
+        steps.push(`Graded: ${goodHits.length} relevant hits (min score: ${this.minScore})`);
+        while (goodHits.length < this.minGoodHits && rewrites < this.maxRewrites) {
+            rewrites++;
+            steps.push(`Rewriting query (attempt ${rewrites}/${this.maxRewrites})`);
+            const context = goodHits.map((h) => h.text).join("\n");
+            currentQuery = await this.rewriter.rewrite(currentQuery, context);
+            steps.push(`Rewritten query: "${currentQuery}"`);
+            hits = await this.retriever.search(currentQuery, DEFAULT_TOP_K);
+            steps.push(`Retrieved ${hits.length} candidates after rewrite`);
+            goodHits = await this.gradeHits(currentQuery, hits);
+            steps.push(`Graded: ${goodHits.length} relevant hits`);
+        }
+        if (goodHits.length < this.minGoodHits && this.webFallback) {
+            steps.push(`Falling back to web search`);
+            const webHits = await this.webFallback(currentQuery);
+            goodHits = [...goodHits, ...webHits];
+            steps.push(`Added ${webHits.length} web results`);
+        }
+        const citations = goodHits.map((hit) => ({
+            path: hit.path,
+            startLine: hit.startLine,
+            endLine: hit.endLine,
+            text: hit.text,
+        }));
+        const text = this.formatAnswer(currentQuery, goodHits);
+        return {
+            text,
+            citations,
+            steps,
+            rewrites,
+        };
+    }
+    async gradeHits(query, hits) {
+        const graded = await Promise.all(hits.map(async (hit) => {
+            const result = await this.grader.grade(query, hit);
+            return { hit, result };
+        }));
+        return graded
+            .filter(({ result }) => result.relevant && result.score >= this.minScore)
+            .map(({ hit }) => hit);
+    }
+    formatAnswer(query, hits) {
+        if (hits.length === 0) {
+            return `No relevant results found for: "${query}"`;
+        }
+        const sections = hits.map((hit, i) => {
+            const location = `${hit.path}:${hit.startLine}-${hit.endLine}`;
+            return `## Result ${i + 1} (${location})\n\n${hit.text}`;
+        });
+        return sections.join("\n\n---\n\n");
+    }
+}
+export function createCorrectiveRag(options) {
+    return new CorrectiveRag(options);
+}
+//# sourceMappingURL=corrective-rag.js.map

package/dist/corrective-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrective-rag.js","sourceRoot":"","sources":["../src/corrective-rag.ts"],"names":[],"mappings":"AASA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,OAAO,aAAa;IAChB,SAAS,CAAY;IACrB,MAAM,CAAS;IACf,QAAQ,CAAgB;IACxB,WAAW,CAAS;IACpB,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,WAAW,CAAqC;IAExD,YAAY,OAA6B;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC/D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;QAChE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;QACtD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,GAAG,CAAC,CAAC;QAExC,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,aAAa,CAAC,CAAC;QAElD,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,8BAA8B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAErF,OAAO,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACzE,QAAQ,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,4BAA4B,QAAQ,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YAExE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,qBAAqB,YAAY,GAAG,CAAC,CAAC;YAEjD,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,2BAA2B,CAAC,CAAC;YAEhE,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,gBAAgB,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YACrD,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,SAAS,GAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAEvD,OAAO;YACL,IAAI;YACJ,SAAS;YACT,KAAK;YACL,QAAQ;SACT,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,IAAW;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACzB,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC;aACxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEO,YAAY,CAAC,KAAa,EAAE,IAAW;QAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,mCAAmC,KAAK,GAAG,CAAC;QACrD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnC,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC/D,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,QAAQ,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/corrective-rag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=corrective-rag.test.d.ts.map

package/dist/corrective-rag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrective-rag.test.d.ts","sourceRoot":"","sources":["../src/corrective-rag.test.ts"],"names":[],"mappings":""}

package/dist/corrective-rag.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect } from "vitest";
+import { CorrectiveRag } from "./corrective-rag.js";
+class MockRetriever {
+    hits;
+    constructor(hits) {
+        this.hits = hits;
+    }
+    async search(_query, _topK) {
+        return this.hits;
+    }
+}
+class MockGrader {
+    relevantIds;
+    constructor(relevantIds) {
+        this.relevantIds = relevantIds;
+    }
+    async grade(_query, hit) {
+        const relevant = this.relevantIds.has(hit.id);
+        return {
+            relevant,
+            score: relevant ? 0.9 : 0.1,
+        };
+    }
+}
+class MockRewriter {
+    async rewrite(query, _context) {
+        return `${query} (rewritten)`;
+    }
+}
+function createHit(id, path, text) {
+    return {
+        id,
+        path,
+        startLine: 1,
+        endLine: 10,
+        text,
+        score: 0.5,
+    };
+}
+describe("CorrectiveRag", () => {
+    it("returns relevant hits without rewriting when enough good hits", async () => {
+        const hits = [
+            createHit("1", "src/auth.ts", "function login() { ... }"),
+            createHit("2", "src/auth.ts", "function logout() { ... }"),
+            createHit("3", "src/billing.ts", "function charge() { ... }"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set(["1", "2"])),
+            rewriter: new MockRewriter(),
+            minGoodHits: 2,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.citations).toHaveLength(2);
+        expect(result.rewrites).toBe(0);
+        expect(result.steps).toContain("Initial query: \"authentication\"");
+    });
+    it("rewrites query when not enough relevant hits", async () => {
+        const hits = [
+            createHit("1", "src/auth.ts", "function login() { ... }"),
+            createHit("2", "src/billing.ts", "function charge() { ... }"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set(["1"])),
+            rewriter: new MockRewriter(),
+            minGoodHits: 2,
+            maxRewrites: 1,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.rewrites).toBe(1);
+        expect(result.steps.some((s) => s.includes("Rewriting query"))).toBe(true);
+    });
+    it("respects maxRewrites limit", async () => {
+        const hits = [
+            createHit("1", "src/billing.ts", "function charge() { ... }"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set()),
+            rewriter: new MockRewriter(),
+            minGoodHits: 2,
+            maxRewrites: 2,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.rewrites).toBe(2);
+    });
+    it("formats answer with citations", async () => {
+        const hits = [
+            createHit("1", "src/auth.ts", "function login() { return true; }"),
+            createHit("2", "src/auth.ts", "function logout() { return false; }"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set(["1", "2"])),
+            rewriter: new MockRewriter(),
+            minGoodHits: 2,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.text).toContain("src/auth.ts:1-10");
+        expect(result.citations).toHaveLength(2);
+        expect(result.citations[0].path).toBe("src/auth.ts");
+    });
+    it("returns empty answer when no relevant hits found", async () => {
+        const hits = [
+            createHit("1", "src/billing.ts", "function charge() { ... }"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set()),
+            rewriter: new MockRewriter(),
+            minGoodHits: 1,
+            maxRewrites: 0,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.citations).toHaveLength(0);
+        expect(result.text).toContain("No relevant results found");
+    });
+    it("uses web fallback when configured", async () => {
+        const hits = [
+            createHit("1", "src/billing.ts", "function charge() { ... }"),
+        ];
+        const webHits = [
+            createHit("web1", "https://example.com", "Web result about auth"),
+        ];
+        const rag = new CorrectiveRag({
+            retriever: new MockRetriever(hits),
+            grader: new MockGrader(new Set()),
+            rewriter: new MockRewriter(),
+            minGoodHits: 1,
+            maxRewrites: 0,
+            webFallback: async (_query) => webHits,
+        });
+        const result = await rag.answer("authentication");
+        expect(result.citations).toHaveLength(1);
+        expect(result.citations[0].path).toBe("https://example.com");
+        expect(result.steps.some((s) => s.includes("Falling back to web search"))).toBe(true);
+    });
+});
+//# sourceMappingURL=corrective-rag.test.js.map

package/dist/corrective-rag.test.js.map

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

package/dist/feedback.d.ts

@@ -0,0 +1,77 @@
+import type { RagAnswer } from "./types.js";
+/**
+ * Feedback per una risposta RAG
+ */
+export interface RagFeedback {
+    id: string;
+    query: string;
+    answer: RagAnswer;
+    rating: number;
+    relevance: number;
+    completeness: number;
+    citationsQuality: number;
+    comments?: string;
+    timestamp: Date;
+    strategy?: string;
+}
+/**
+ * Metriche aggregate per una strategia RAG
+ */
+export interface RagMetrics {
+    strategy: string;
+    totalQueries: number;
+    averageRating: number;
+    averageRelevance: number;
+    averageCompleteness: number;
+    averageCitationsQuality: number;
+    overallScore: number;
+    confidence: number;
+}
+/**
+ * Risultato A/B test
+ */
+export interface ABTestResult {
+    strategyA: string;
+    strategyB: string;
+    winner: "A" | "B" | "tie";
+    metricsA: RagMetrics;
+    metricsB: RagMetrics;
+    improvement: number;
+    statisticalSignificance: number;
+    recommendation: string;
+}
+/**
+ * Suggerimento di ottimizzazione
+ */
+export interface OptimizationSuggestion {
+    type: "parameter" | "strategy" | "prompt";
+    target: string;
+    current: unknown;
+    suggested: unknown;
+    expectedImprovement: number;
+    confidence: number;
+    reasoning: string;
+}
+/**
+ * Storage per feedback e metriche
+ */
+export interface FeedbackStorage {
+    saveFeedback(feedback: RagFeedback): Promise<void>;
+    getFeedback(strategy?: string, limit?: number): Promise<RagFeedback[]>;
+    getMetrics(strategy: string): Promise<RagMetrics | null>;
+    saveMetrics(metrics: RagMetrics): Promise<void>;
+    clearFeedback(strategy?: string): Promise<void>;
+}
+/**
+ * In-memory implementation di FeedbackStorage
+ */
+export declare class InMemoryFeedbackStorage implements FeedbackStorage {
+    private feedbacks;
+    private metrics;
+    saveFeedback(feedback: RagFeedback): Promise<void>;
+    getFeedback(strategy?: string, limit?: number): Promise<RagFeedback[]>;
+    getMetrics(strategy: string): Promise<RagMetrics | null>;
+    saveMetrics(metrics: RagMetrics): Promise<void>;
+    clearFeedback(strategy?: string): Promise<void>;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzD,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,OAAO,CAAsC;IAE/C,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAetE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIxD,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAStD"}

package/dist/feedback.js

@@ -0,0 +1,44 @@
+/**
+ * In-memory implementation di FeedbackStorage
+ */
+export class InMemoryFeedbackStorage {
+    feedbacks = new Map();
+    metrics = new Map();
+    async saveFeedback(feedback) {
+        const strategy = feedback.strategy || "default";
+        if (!this.feedbacks.has(strategy)) {
+            this.feedbacks.set(strategy, []);
+        }
+        this.feedbacks.get(strategy).push(feedback);
+    }
+    async getFeedback(strategy, limit) {
+        if (strategy) {
+            const feedbacks = this.feedbacks.get(strategy) || [];
+            return limit ? feedbacks.slice(-limit) : feedbacks;
+        }
+        // Tutti i feedback
+        const all = [];
+        for (const feedbacks of this.feedbacks.values()) {
+            all.push(...feedbacks);
+        }
+        all.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+        return limit ? all.slice(-limit) : all;
+    }
+    async getMetrics(strategy) {
+        return this.metrics.get(strategy) || null;
+    }
+    async saveMetrics(metrics) {
+        this.metrics.set(metrics.strategy, metrics);
+    }
+    async clearFeedback(strategy) {
+        if (strategy) {
+            this.feedbacks.delete(strategy);
+            this.metrics.delete(strategy);
+        }
+        else {
+            this.feedbacks.clear();
+            this.metrics.clear();
+        }
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAsEA;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,SAAS,GAA+B,IAAI,GAAG,EAAE,CAAC;IAClD,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAErD,KAAK,CAAC,YAAY,CAAC,QAAqB;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,SAAS,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAiB,EAAE,KAAc;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrD,CAAC;QAED,mBAAmB;QACnB,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAmB;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAiB;QACnC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/feedback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=feedback.test.d.ts.map

package/dist/feedback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.test.d.ts","sourceRoot":"","sources":["../src/feedback.test.ts"],"names":[],"mappings":""}

package/dist/feedback.test.js

@@ -0,0 +1,202 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { InMemoryFeedbackStorage } from "./feedback.js";
+import { MetricsCalculator } from "./metrics.js";
+describe("InMemoryFeedbackStorage", () => {
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryFeedbackStorage();
+    });
+    it("should save and retrieve feedback", async () => {
+        const feedback = {
+            id: "test-1",
+            query: "test query",
+            answer: {
+                text: "test answer",
+                citations: [],
+                steps: [],
+                rewrites: 0,
+            },
+            rating: 4,
+            relevance: 0.8,
+            completeness: 0.7,
+            citationsQuality: 0.9,
+            timestamp: new Date(),
+            strategy: "strategy-a",
+        };
+        await storage.saveFeedback(feedback);
+        const retrieved = await storage.getFeedback("strategy-a");
+        expect(retrieved).toHaveLength(1);
+        expect(retrieved[0]?.id).toBe("test-1");
+    });
+    it("should filter feedback by strategy", async () => {
+        const feedback1 = {
+            id: "test-1",
+            query: "query 1",
+            answer: { text: "answer 1", citations: [], steps: [], rewrites: 0 },
+            rating: 4,
+            relevance: 0.8,
+            completeness: 0.7,
+            citationsQuality: 0.9,
+            timestamp: new Date(),
+            strategy: "strategy-a",
+        };
+        const feedback2 = {
+            id: "test-2",
+            query: "query 2",
+            answer: { text: "answer 2", citations: [], steps: [], rewrites: 0 },
+            rating: 5,
+            relevance: 0.9,
+            completeness: 0.8,
+            citationsQuality: 0.95,
+            timestamp: new Date(),
+            strategy: "strategy-b",
+        };
+        await storage.saveFeedback(feedback1);
+        await storage.saveFeedback(feedback2);
+        const retrievedA = await storage.getFeedback("strategy-a");
+        const retrievedB = await storage.getFeedback("strategy-b");
+        expect(retrievedA).toHaveLength(1);
+        expect(retrievedB).toHaveLength(1);
+        expect(retrievedA[0]?.strategy).toBe("strategy-a");
+        expect(retrievedB[0]?.strategy).toBe("strategy-b");
+    });
+    it("should limit feedback results", async () => {
+        for (let i = 0; i < 10; i++) {
+            await storage.saveFeedback({
+                id: `test-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 4,
+                relevance: 0.8,
+                completeness: 0.7,
+                citationsQuality: 0.9,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const retrieved = await storage.getFeedback("strategy-a", 5);
+        expect(retrieved).toHaveLength(5);
+    });
+    it("should clear feedback", async () => {
+        await storage.saveFeedback({
+            id: "test-1",
+            query: "query 1",
+            answer: { text: "answer 1", citations: [], steps: [], rewrites: 0 },
+            rating: 4,
+            relevance: 0.8,
+            completeness: 0.7,
+            citationsQuality: 0.9,
+            timestamp: new Date(),
+            strategy: "strategy-a",
+        });
+        await storage.clearFeedback("strategy-a");
+        const retrieved = await storage.getFeedback("strategy-a");
+        expect(retrieved).toHaveLength(0);
+    });
+});
+describe("MetricsCalculator", () => {
+    it("should calculate metrics from feedback", () => {
+        const feedbacks = [
+            {
+                id: "test-1",
+                query: "query 1",
+                answer: { text: "answer 1", citations: [], steps: [], rewrites: 0 },
+                rating: 4,
+                relevance: 0.8,
+                completeness: 0.7,
+                citationsQuality: 0.9,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            },
+            {
+                id: "test-2",
+                query: "query 2",
+                answer: { text: "answer 2", citations: [], steps: [], rewrites: 0 },
+                rating: 5,
+                relevance: 0.9,
+                completeness: 0.8,
+                citationsQuality: 0.95,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            },
+        ];
+        const metrics = MetricsCalculator.calculateMetrics(feedbacks, "strategy-a");
+        expect(metrics.strategy).toBe("strategy-a");
+        expect(metrics.totalQueries).toBe(2);
+        expect(metrics.averageRating).toBe(4.5);
+        expect(metrics.averageRelevance).toBeCloseTo(0.85, 10);
+        expect(metrics.averageCompleteness).toBeCloseTo(0.75, 10);
+        expect(metrics.averageCitationsQuality).toBeCloseTo(0.925, 10);
+        expect(metrics.overallScore).toBeGreaterThan(0);
+        expect(metrics.confidence).toBeGreaterThan(0);
+    });
+    it("should return zero metrics for empty feedback", () => {
+        const metrics = MetricsCalculator.calculateMetrics([], "strategy-a");
+        expect(metrics.totalQueries).toBe(0);
+        expect(metrics.averageRating).toBe(0);
+        expect(metrics.overallScore).toBe(0);
+        expect(metrics.confidence).toBe(0);
+    });
+    it("should calculate standard deviation", () => {
+        const feedbacks = [
+            {
+                id: "test-1",
+                query: "query 1",
+                answer: { text: "answer 1", citations: [], steps: [], rewrites: 0 },
+                rating: 3,
+                relevance: 0.6,
+                completeness: 0.5,
+                citationsQuality: 0.7,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            },
+            {
+                id: "test-2",
+                query: "query 2",
+                answer: { text: "answer 2", citations: [], steps: [], rewrites: 0 },
+                rating: 5,
+                relevance: 0.9,
+                completeness: 0.8,
+                citationsQuality: 0.95,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            },
+        ];
+        const stdDev = MetricsCalculator.calculateStandardDeviation(feedbacks, "relevance");
+        expect(stdDev).toBeGreaterThan(0);
+    });
+    it("should identify trend", () => {
+        const feedbacks = [];
+        // Older feedback with lower relevance
+        for (let i = 0; i < 10; i++) {
+            feedbacks.push({
+                id: `old-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 3,
+                relevance: 0.5,
+                completeness: 0.5,
+                citationsQuality: 0.5,
+                timestamp: new Date(Date.now() - 1000000),
+                strategy: "strategy-a",
+            });
+        }
+        // Recent feedback with higher relevance
+        for (let i = 0; i < 10; i++) {
+            feedbacks.push({
+                id: `new-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 5,
+                relevance: 0.9,
+                completeness: 0.9,
+                citationsQuality: 0.9,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const trend = MetricsCalculator.identifyTrend(feedbacks, 10);
+        expect(trend).toBe("improving");
+    });
+});
+//# sourceMappingURL=feedback.test.js.map

package/dist/feedback.test.js.map

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

package/dist/hybrid-search.d.ts

@@ -0,0 +1,14 @@
+import type { HybridSearchOptions, HybridSearchResult } from "./types.js";
+/**
+ * Hybrid Search RAG - Combina semantic search e keyword search usando RRF (Reciprocal Rank Fusion)
+ *
+ * RRF Formula: score(d) = Σ 1/(k + rank_i(d))
+ * dove k è una costante (tipicamente 60) e rank_i è la posizione del documento nella lista i
+ */
+export declare class HybridSearchRag {
+    private options;
+    constructor(options: HybridSearchOptions);
+    search(query: string, topK?: number): Promise<HybridSearchResult>;
+    private reciprocalRankFusion;
+}
+//# sourceMappingURL=hybrid-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search.d.ts","sourceRoot":"","sources":["../src/hybrid-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgC;gBAEnC,OAAO,EAAE,mBAAmB;IAUlC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBvE,OAAO,CAAC,oBAAoB;CAwC7B"}