@eucoder/rag 0.2.0

package/dist/metrics.d.ts

@@ -0,0 +1,26 @@
+import type { RagFeedback, RagMetrics } from "./feedback.js";
+/**
+ * Calcola metriche aggregate da un array di feedback
+ */
+export declare class MetricsCalculator {
+    /**
+     * Calcola le metriche per una strategia specifica
+     */
+    static calculateMetrics(feedbacks: RagFeedback[], strategy: string): RagMetrics;
+    /**
+     * Calcola la deviazione standard per una metrica specifica
+     */
+    static calculateStandardDeviation(feedbacks: RagFeedback[], metric: "rating" | "relevance" | "completeness" | "citationsQuality"): number;
+    /**
+     * Calcola l'intervallo di confidenza al 95%
+     */
+    static calculateConfidenceInterval(feedbacks: RagFeedback[], metric: "rating" | "relevance" | "completeness" | "citationsQuality"): {
+        lower: number;
+        upper: number;
+    };
+    /**
+     * Identifica trend nei feedback (miglioramento o peggioramento)
+     */
+    static identifyTrend(feedbacks: RagFeedback[], windowSize?: number): "improving" | "declining" | "stable";
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAqD/E;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,kBAAkB,GACnE,MAAM;IAWT;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAChC,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,kBAAkB,GACnE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAiBnC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,UAAU,GAAE,MAAW,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ;CAe9G"}

package/dist/metrics.js

@@ -0,0 +1,100 @@
+/**
+ * Calcola metriche aggregate da un array di feedback
+ */
+export class MetricsCalculator {
+    /**
+     * Calcola le metriche per una strategia specifica
+     */
+    static calculateMetrics(feedbacks, strategy) {
+        if (feedbacks.length === 0) {
+            return {
+                strategy,
+                totalQueries: 0,
+                averageRating: 0,
+                averageRelevance: 0,
+                averageCompleteness: 0,
+                averageCitationsQuality: 0,
+                overallScore: 0,
+                confidence: 0,
+            };
+        }
+        const totalQueries = feedbacks.length;
+        // Calcola medie
+        const sumRating = feedbacks.reduce((sum, f) => sum + f.rating, 0);
+        const sumRelevance = feedbacks.reduce((sum, f) => sum + f.relevance, 0);
+        const sumCompleteness = feedbacks.reduce((sum, f) => sum + f.completeness, 0);
+        const sumCitationsQuality = feedbacks.reduce((sum, f) => sum + f.citationsQuality, 0);
+        const averageRating = sumRating / totalQueries;
+        const averageRelevance = sumRelevance / totalQueries;
+        const averageCompleteness = sumCompleteness / totalQueries;
+        const averageCitationsQuality = sumCitationsQuality / totalQueries;
+        // Overall score: media pesata
+        // Rating (30%), Relevance (30%), Completeness (25%), Citations (15%)
+        const normalizedRating = averageRating / 5; // Normalizza a 0-1
+        const overallScore = normalizedRating * 0.30 +
+            averageRelevance * 0.30 +
+            averageCompleteness * 0.25 +
+            averageCitationsQuality * 0.15;
+        // Confidence: basato sul numero di sample
+        // Minimo 10 sample per avere confidence > 0.5
+        // Massimo confidence a 50+ sample
+        const confidence = Math.min(1, totalQueries / 50);
+        return {
+            strategy,
+            totalQueries,
+            averageRating,
+            averageRelevance,
+            averageCompleteness,
+            averageCitationsQuality,
+            overallScore,
+            confidence,
+        };
+    }
+    /**
+     * Calcola la deviazione standard per una metrica specifica
+     */
+    static calculateStandardDeviation(feedbacks, metric) {
+        if (feedbacks.length < 2)
+            return 0;
+        const values = feedbacks.map((f) => f[metric]);
+        const mean = values.reduce((sum, v) => sum + v, 0) / values.length;
+        const squaredDiffs = values.map((v) => Math.pow(v - mean, 2));
+        const variance = squaredDiffs.reduce((sum, v) => sum + v, 0) / (values.length - 1);
+        return Math.sqrt(variance);
+    }
+    /**
+     * Calcola l'intervallo di confidenza al 95%
+     */
+    static calculateConfidenceInterval(feedbacks, metric) {
+        if (feedbacks.length < 2) {
+            const value = feedbacks.length === 1 ? feedbacks[0][metric] : 0;
+            return { lower: value, upper: value };
+        }
+        const values = feedbacks.map((f) => f[metric]);
+        const mean = values.reduce((sum, v) => sum + v, 0) / values.length;
+        const stdDev = this.calculateStandardDeviation(feedbacks, metric);
+        const marginOfError = 1.96 * (stdDev / Math.sqrt(values.length)); // 95% confidence
+        return {
+            lower: Math.max(0, mean - marginOfError),
+            upper: Math.min(metric === "rating" ? 5 : 1, mean + marginOfError),
+        };
+    }
+    /**
+     * Identifica trend nei feedback (miglioramento o peggioramento)
+     */
+    static identifyTrend(feedbacks, windowSize = 10) {
+        if (feedbacks.length < windowSize * 2)
+            return "stable";
+        const recent = feedbacks.slice(-windowSize);
+        const older = feedbacks.slice(-windowSize * 2, -windowSize);
+        const recentAvg = recent.reduce((sum, f) => sum + f.relevance, 0) / recent.length;
+        const olderAvg = older.reduce((sum, f) => sum + f.relevance, 0) / older.length;
+        const diff = recentAvg - olderAvg;
+        if (diff > 0.05)
+            return "improving";
+        if (diff < -0.05)
+            return "declining";
+        return "stable";
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/optimizer.d.ts

@@ -0,0 +1,52 @@
+import type { FeedbackStorage, OptimizationSuggestion } from "./feedback.js";
+/**
+ * Parametri ottimizzabili per strategie RAG
+ */
+export interface OptimizableParams {
+    minGoodHits?: number;
+    minScore?: number;
+    maxRewrites?: number;
+    semanticWeight?: number;
+    keywordWeight?: number;
+    rrfK?: number;
+    maxIterations?: number;
+    enableSelfReflection?: boolean;
+    enableChainOfThought?: boolean;
+    topK?: number;
+}
+/**
+ * Ottimizzatore automatico per parametri RAG
+ */
+export declare class ParameterOptimizer {
+    private storage;
+    constructor(storage?: FeedbackStorage);
+    /**
+     * Analizza i feedback e suggerisce ottimizzazioni
+     */
+    analyzeAndSuggest(strategy: string, currentParams: OptimizableParams): Promise<OptimizationSuggestion[]>;
+    /**
+     * Analizza problemi di relevance
+     */
+    private analyzeRelevance;
+    /**
+     * Analizza problemi di completeness
+     */
+    private analyzeCompleteness;
+    /**
+     * Analizza problemi di citations quality
+     */
+    private analyzeCitationsQuality;
+    /**
+     * Analizza trend temporale
+     */
+    private analyzeTrend;
+    /**
+     * Applica automaticamente le ottimizzazioni suggerite
+     */
+    applySuggestions(currentParams: OptimizableParams, suggestions: OptimizationSuggestion[], minConfidence?: number): OptimizableParams;
+    /**
+     * Genera report di ottimizzazione
+     */
+    generateReport(strategy: string, currentParams: OptimizableParams): Promise<string>;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../src/optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAI1F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAG/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,CAAC,EAAE,eAAe;IAIrC;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAoCpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkDxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,gBAAgB,CACd,aAAa,EAAE,iBAAiB,EAChC,WAAW,EAAE,sBAAsB,EAAE,EACrC,aAAa,GAAE,MAAY,GAC1B,iBAAiB;IAYpB;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,MAAM,CAAC;CAgCnB"}

package/dist/optimizer.js

@@ -0,0 +1,228 @@
+import { InMemoryFeedbackStorage } from "./feedback.js";
+import { MetricsCalculator } from "./metrics.js";
+/**
+ * Ottimizzatore automatico per parametri RAG
+ */
+export class ParameterOptimizer {
+    storage;
+    constructor(storage) {
+        this.storage = storage || new InMemoryFeedbackStorage();
+    }
+    /**
+     * Analizza i feedback e suggerisce ottimizzazioni
+     */
+    async analyzeAndSuggest(strategy, currentParams) {
+        const feedbacks = await this.storage.getFeedback(strategy);
+        if (feedbacks.length < 10) {
+            return [{
+                    type: "strategy",
+                    target: "data_collection",
+                    current: feedbacks.length,
+                    suggested: 50,
+                    expectedImprovement: 0,
+                    confidence: 1,
+                    reasoning: `Raccogli almeno 50 feedback per analisi affidabile (attualmente: ${feedbacks.length})`,
+                }];
+        }
+        const suggestions = [];
+        // Analizza problemi di relevance
+        const relevanceSuggestions = this.analyzeRelevance(feedbacks, currentParams);
+        suggestions.push(...relevanceSuggestions);
+        // Analizza problemi di completeness
+        const completenessSuggestions = this.analyzeCompleteness(feedbacks, currentParams);
+        suggestions.push(...completenessSuggestions);
+        // Analizza problemi di citations quality
+        const citationsSuggestions = this.analyzeCitationsQuality(feedbacks, currentParams);
+        suggestions.push(...citationsSuggestions);
+        // Analizza trend temporale
+        const trendSuggestions = this.analyzeTrend(feedbacks, currentParams);
+        suggestions.push(...trendSuggestions);
+        return suggestions;
+    }
+    /**
+     * Analizza problemi di relevance
+     */
+    analyzeRelevance(feedbacks, params) {
+        const suggestions = [];
+        const avgRelevance = feedbacks.reduce((sum, f) => sum + f.relevance, 0) / feedbacks.length;
+        // Se relevance è bassa, suggerisci di aumentare minScore o topK
+        if (avgRelevance < 0.6) {
+            if (params.minScore !== undefined && params.minScore < 0.5) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "minScore",
+                    current: params.minScore,
+                    suggested: Math.min(0.7, params.minScore + 0.1),
+                    expectedImprovement: 0.15,
+                    confidence: 0.8,
+                    reasoning: `Relevance media bassa (${avgRelevance.toFixed(2)}). Aumenta minScore per filtrare risultati meno rilevanti.`,
+                });
+            }
+            if (params.topK !== undefined && params.topK < 10) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "topK",
+                    current: params.topK,
+                    suggested: Math.min(15, params.topK + 3),
+                    expectedImprovement: 0.1,
+                    confidence: 0.7,
+                    reasoning: `Relevance media bassa (${avgRelevance.toFixed(2)}). Aumenta topK per avere più candidati da cui scegliere.`,
+                });
+            }
+        }
+        // Se relevance è molto alta, potresti essere troppo conservativo
+        if (avgRelevance > 0.9 && params.minScore !== undefined && params.minScore > 0.7) {
+            suggestions.push({
+                type: "parameter",
+                target: "minScore",
+                current: params.minScore,
+                suggested: Math.max(0.5, params.minScore - 0.1),
+                expectedImprovement: 0.05,
+                confidence: 0.6,
+                reasoning: `Relevance molto alta (${avgRelevance.toFixed(2)}) ma potresti perdere risultati utili. Riduci minScore per aumentare recall.`,
+            });
+        }
+        return suggestions;
+    }
+    /**
+     * Analizza problemi di completeness
+     */
+    analyzeCompleteness(feedbacks, params) {
+        const suggestions = [];
+        const avgCompleteness = feedbacks.reduce((sum, f) => sum + f.completeness, 0) / feedbacks.length;
+        // Se completeness è bassa, suggerisci di abilitare self-reflection o aumentare iterazioni
+        if (avgCompleteness < 0.6) {
+            if (params.enableSelfReflection === false) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "enableSelfReflection",
+                    current: false,
+                    suggested: true,
+                    expectedImprovement: 0.2,
+                    confidence: 0.85,
+                    reasoning: `Completeness bassa (${avgCompleteness.toFixed(2)}). Abilita self-reflection per migliorare qualità risposte.`,
+                });
+            }
+            if (params.maxIterations !== undefined && params.maxIterations < 3) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "maxIterations",
+                    current: params.maxIterations,
+                    suggested: Math.min(5, params.maxIterations + 1),
+                    expectedImprovement: 0.15,
+                    confidence: 0.75,
+                    reasoning: `Completeness bassa (${avgCompleteness.toFixed(2)}). Aumenta maxIterations per permettere più tentativi di miglioramento.`,
+                });
+            }
+            if (params.enableChainOfThought === false) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "enableChainOfThought",
+                    current: false,
+                    suggested: true,
+                    expectedImprovement: 0.18,
+                    confidence: 0.8,
+                    reasoning: `Completeness bassa (${avgCompleteness.toFixed(2)}). Abilita chain-of-thought per risposte più strutturate.`,
+                });
+            }
+        }
+        return suggestions;
+    }
+    /**
+     * Analizza problemi di citations quality
+     */
+    analyzeCitationsQuality(feedbacks, params) {
+        const suggestions = [];
+        const avgCitations = feedbacks.reduce((sum, f) => sum + f.citationsQuality, 0) / feedbacks.length;
+        // Se citations quality è bassa, suggerisci di migliorare hybrid search
+        if (avgCitations < 0.6) {
+            if (params.semanticWeight !== undefined && params.semanticWeight < 0.6) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "semanticWeight",
+                    current: params.semanticWeight,
+                    suggested: Math.min(0.7, params.semanticWeight + 0.1),
+                    expectedImprovement: 0.12,
+                    confidence: 0.7,
+                    reasoning: `Citations quality bassa (${avgCitations.toFixed(2)}). Aumenta semanticWeight per risultati più semanticamente rilevanti.`,
+                });
+            }
+            if (params.rrfK !== undefined && params.rrfK > 80) {
+                suggestions.push({
+                    type: "parameter",
+                    target: "rrfK",
+                    current: params.rrfK,
+                    suggested: Math.max(50, params.rrfK - 20),
+                    expectedImprovement: 0.1,
+                    confidence: 0.65,
+                    reasoning: `Citations quality bassa (${avgCitations.toFixed(2)}). Riduci rrfK per dare più peso ai risultati top-ranked.`,
+                });
+            }
+        }
+        return suggestions;
+    }
+    /**
+     * Analizza trend temporale
+     */
+    analyzeTrend(feedbacks, _params) {
+        const suggestions = [];
+        const trend = MetricsCalculator.identifyTrend(feedbacks);
+        if (trend === "declining") {
+            suggestions.push({
+                type: "strategy",
+                target: "overall_strategy",
+                current: "current",
+                suggested: "review",
+                expectedImprovement: 0.1,
+                confidence: 0.7,
+                reasoning: `Trend in declino negli ultimi feedback. Considera di rivedere la strategia o raccogliere feedback qualitativi per capire cosa non funziona.`,
+            });
+        }
+        return suggestions;
+    }
+    /**
+     * Applica automaticamente le ottimizzazioni suggerite
+     */
+    applySuggestions(currentParams, suggestions, minConfidence = 0.7) {
+        const optimized = { ...currentParams };
+        for (const suggestion of suggestions) {
+            if (suggestion.confidence >= minConfidence && suggestion.type === "parameter") {
+                optimized[suggestion.target] = suggestion.suggested;
+            }
+        }
+        return optimized;
+    }
+    /**
+     * Genera report di ottimizzazione
+     */
+    async generateReport(strategy, currentParams) {
+        const feedbacks = await this.storage.getFeedback(strategy);
+        const metrics = MetricsCalculator.calculateMetrics(feedbacks, strategy);
+        const suggestions = await this.analyzeAndSuggest(strategy, currentParams);
+        let report = `# Report Ottimizzazione: ${strategy}\n\n`;
+        report += `## Metriche Attuali\n`;
+        report += `- **Total Queries**: ${metrics.totalQueries}\n`;
+        report += `- **Overall Score**: ${metrics.overallScore.toFixed(3)}\n`;
+        report += `- **Average Relevance**: ${metrics.averageRelevance.toFixed(3)}\n`;
+        report += `- **Average Completeness**: ${metrics.averageCompleteness.toFixed(3)}\n`;
+        report += `- **Average Citations Quality**: ${metrics.averageCitationsQuality.toFixed(3)}\n`;
+        report += `- **Confidence**: ${(metrics.confidence * 100).toFixed(0)}%\n\n`;
+        report += `## Suggerimenti di Ottimizzazione\n\n`;
+        if (suggestions.length === 0) {
+            report += `Nessun suggerimento. I parametri attuali sembrano ottimali.\n`;
+        }
+        else {
+            for (const suggestion of suggestions) {
+                report += `### ${suggestion.target}\n`;
+                report += `- **Tipo**: ${suggestion.type}\n`;
+                report += `- **Valore attuale**: ${JSON.stringify(suggestion.current)}\n`;
+                report += `- **Valore suggerito**: ${JSON.stringify(suggestion.suggested)}\n`;
+                report += `- **Miglioramento atteso**: +${(suggestion.expectedImprovement * 100).toFixed(1)}%\n`;
+                report += `- **Confidence**: ${(suggestion.confidence * 100).toFixed(0)}%\n`;
+                report += `- **Ragionamento**: ${suggestion.reasoning}\n\n`;
+            }
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=optimizer.js.map

package/dist/optimizer.js.map

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

package/dist/optimizer.test.d.ts

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

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

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

package/dist/optimizer.test.js

@@ -0,0 +1,201 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { ParameterOptimizer } from "./optimizer.js";
+import { InMemoryFeedbackStorage } from "./feedback.js";
+describe("ParameterOptimizer", () => {
+    let optimizer;
+    let storage;
+    beforeEach(() => {
+        storage = new InMemoryFeedbackStorage();
+        optimizer = new ParameterOptimizer(storage);
+    });
+    it("should suggest collecting more data when feedback is insufficient", async () => {
+        const params = {
+            minScore: 0.5,
+            topK: 5,
+        };
+        // Add only 5 feedback (not enough)
+        for (let i = 0; i < 5; 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 suggestions = await optimizer.analyzeAndSuggest("strategy-a", params);
+        expect(suggestions).toHaveLength(1);
+        expect(suggestions[0]?.type).toBe("strategy");
+        expect(suggestions[0]?.target).toBe("data_collection");
+    });
+    it("should suggest increasing minScore when relevance is low", async () => {
+        const params = {
+            minScore: 0.3,
+            topK: 10,
+        };
+        // Add 20 feedback with low relevance
+        for (let i = 0; i < 20; i++) {
+            await storage.saveFeedback({
+                id: `test-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 3,
+                relevance: 0.5,
+                completeness: 0.6,
+                citationsQuality: 0.7,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const suggestions = await optimizer.analyzeAndSuggest("strategy-a", params);
+        const minScoreSuggestion = suggestions.find(s => s.target === "minScore");
+        expect(minScoreSuggestion).toBeDefined();
+        expect(minScoreSuggestion?.suggested).toBeGreaterThan(params.minScore);
+    });
+    it("should suggest enabling self-reflection when completeness is low", async () => {
+        const params = {
+            enableSelfReflection: false,
+            maxIterations: 2,
+        };
+        // Add 20 feedback with low completeness
+        for (let i = 0; i < 20; i++) {
+            await storage.saveFeedback({
+                id: `test-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 3,
+                relevance: 0.7,
+                completeness: 0.5,
+                citationsQuality: 0.8,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const suggestions = await optimizer.analyzeAndSuggest("strategy-a", params);
+        const selfReflectionSuggestion = suggestions.find(s => s.target === "enableSelfReflection");
+        expect(selfReflectionSuggestion).toBeDefined();
+        expect(selfReflectionSuggestion?.suggested).toBe(true);
+    });
+    it("should suggest increasing semanticWeight when citations quality is low", async () => {
+        const params = {
+            semanticWeight: 0.5,
+            keywordWeight: 0.5,
+        };
+        // Add 20 feedback with low citations quality
+        for (let i = 0; i < 20; i++) {
+            await storage.saveFeedback({
+                id: `test-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 3,
+                relevance: 0.7,
+                completeness: 0.7,
+                citationsQuality: 0.5,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const suggestions = await optimizer.analyzeAndSuggest("strategy-a", params);
+        const semanticWeightSuggestion = suggestions.find(s => s.target === "semanticWeight");
+        expect(semanticWeightSuggestion).toBeDefined();
+        expect(semanticWeightSuggestion?.suggested).toBeGreaterThan(params.semanticWeight);
+    });
+    it("should apply suggestions with sufficient confidence", () => {
+        const currentParams = {
+            minScore: 0.3,
+            topK: 5,
+            enableSelfReflection: false,
+        };
+        const suggestions = [
+            {
+                type: "parameter",
+                target: "minScore",
+                current: 0.3,
+                suggested: 0.5,
+                expectedImprovement: 0.15,
+                confidence: 0.8,
+                reasoning: "Test suggestion",
+            },
+            {
+                type: "parameter",
+                target: "topK",
+                current: 5,
+                suggested: 10,
+                expectedImprovement: 0.1,
+                confidence: 0.6, // Below threshold
+                reasoning: "Test suggestion",
+            },
+        ];
+        const optimized = optimizer.applySuggestions(currentParams, suggestions, 0.7);
+        expect(optimized.minScore).toBe(0.5);
+        expect(optimized.topK).toBe(5); // Not applied due to low confidence
+        expect(optimized.enableSelfReflection).toBe(false);
+    });
+    it("should generate report", async () => {
+        const params = {
+            minScore: 0.5,
+            topK: 10,
+        };
+        // Add 15 feedback
+        for (let i = 0; i < 15; i++) {
+            await storage.saveFeedback({
+                id: `test-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 4,
+                relevance: 0.7,
+                completeness: 0.6,
+                citationsQuality: 0.8,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const report = await optimizer.generateReport("strategy-a", params);
+        expect(report).toContain("Report Ottimizzazione: strategy-a");
+        expect(report).toContain("Metriche Attuali");
+        expect(report).toContain("Total Queries");
+        expect(report).toContain("15");
+    });
+    it("should detect declining trend", async () => {
+        const params = {
+            minScore: 0.5,
+        };
+        // Add older feedback with high relevance
+        for (let i = 0; i < 10; i++) {
+            await storage.saveFeedback({
+                id: `old-${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(Date.now() - 1000000),
+                strategy: "strategy-a",
+            });
+        }
+        // Add recent feedback with low relevance
+        for (let i = 0; i < 10; i++) {
+            await storage.saveFeedback({
+                id: `new-${i}`,
+                query: `query ${i}`,
+                answer: { text: `answer ${i}`, citations: [], steps: [], rewrites: 0 },
+                rating: 2,
+                relevance: 0.4,
+                completeness: 0.4,
+                citationsQuality: 0.4,
+                timestamp: new Date(),
+                strategy: "strategy-a",
+            });
+        }
+        const suggestions = await optimizer.analyzeAndSuggest("strategy-a", params);
+        const trendSuggestion = suggestions.find(s => s.target === "overall_strategy");
+        expect(trendSuggestion).toBeDefined();
+        expect(trendSuggestion?.reasoning).toContain("declino");
+    });
+});
+//# sourceMappingURL=optimizer.test.js.map