@ankh-studio/ai-enablement 1.0.0

package/dist/llm/response-processor.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * LLM Response Processor
+ *
+ * Handles structured parsing and validation of LLM responses
+ * for adversarial coalescing with deterministic analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseProcessor = void 0;
+class ResponseProcessor {
+    static parseCoalescingResponse(llmContent) {
+        const enhancedInsights = this.extractSection(llmContent, this.SECTION_PATTERNS.enhancedInsights);
+        const adversarialChallenges = this.extractSection(llmContent, this.SECTION_PATTERNS.adversarialChallenges);
+        const confidenceAssessment = this.extractSection(llmContent, this.SECTION_PATTERNS.confidenceAssessment);
+        return {
+            enhancedInsights,
+            adversarialChallenges,
+            confidenceAssessment: confidenceAssessment[0] || "",
+            rawContent: llmContent,
+        };
+    }
+    static parseValidationResponse(llmContent) {
+        const resultMatch = llmContent.match(this.VALIDATION_RESULT_PATTERN);
+        const notesMatch = llmContent.match(this.VALIDATION_NOTES_PATTERN);
+        const isValid = resultMatch ? resultMatch[1]?.toUpperCase() === "PASS" : false;
+        const notes = notesMatch ? notesMatch[1]?.trim() || "" : "";
+        const issues = this.extractIssues(notes);
+        const suggestions = this.extractSuggestions(notes);
+        const confidence = this.calculateValidationConfidence(isValid, issues.length);
+        return {
+            isValid,
+            confidence,
+            issues,
+            suggestions,
+        };
+    }
+    static processEnhancedInsights(enhancedTexts, deterministicInsights) {
+        const processedInsights = [];
+        enhancedTexts.forEach((enhancedText, index) => {
+            if (index < deterministicInsights.length && deterministicInsights[index]) {
+                const original = deterministicInsights[index];
+                const enhanced = this.createEnhancedInsight(original, enhancedText);
+                processedInsights.push(enhanced);
+            }
+            else {
+                // Create new insight from enhanced text
+                const newInsight = this.createNewInsight(enhancedText, index);
+                processedInsights.push(newInsight);
+            }
+        });
+        return processedInsights;
+    }
+    static validateResponseStructure(parsed) {
+        const issues = [];
+        const suggestions = [];
+        // Check required sections
+        if (parsed.enhancedInsights.length === 0) {
+            issues.push("No enhanced insights found");
+            suggestions.push("Add at least one enhanced insight");
+        }
+        if (parsed.adversarialChallenges.length === 0) {
+            issues.push("No adversarial challenges found");
+            suggestions.push("Add at least one adversarial challenge");
+        }
+        if (!parsed.confidenceAssessment) {
+            issues.push("No confidence assessment provided");
+            suggestions.push("Add confidence assessment section");
+        }
+        // Check content quality
+        if (parsed.enhancedInsights.some(insight => insight.length < 20)) {
+            issues.push("Some enhanced insights are too brief");
+            suggestions.push("Provide more detailed insights");
+        }
+        if (parsed.adversarialChallenges.some(challenge => challenge.length < 15)) {
+            issues.push("Some adversarial challenges are too brief");
+            suggestions.push("Provide more substantive challenges");
+        }
+        const confidence = this.calculateValidationConfidence(issues.length === 0, issues.length);
+        return {
+            isValid: issues.length === 0,
+            confidence,
+            issues,
+            suggestions,
+        };
+    }
+    static extractSection(content, pattern) {
+        const match = content.match(pattern);
+        if (!match || !match[1])
+            return [];
+        return match[1]
+            .split("\n")
+            .filter(line => line.trim().startsWith("-"))
+            .map(line => line.replace(/^-\s*/, "").trim())
+            .filter(line => line.length > 0);
+    }
+    static extractIssues(notes) {
+        if (!notes)
+            return [];
+        const issuePatterns = [
+            /missing/gi,
+            /not found/gi,
+            /incomplete/gi,
+            /unclear/gi,
+            /vague/gi,
+            /insufficient/gi,
+        ];
+        const issues = [];
+        issuePatterns.forEach(pattern => {
+            if (pattern.test(notes)) {
+                issues.push(notes);
+            }
+        });
+        return issues.length > 0 ? issues : [notes];
+    }
+    static extractSuggestions(notes) {
+        const suggestionPatterns = [
+            /should/gi,
+            /recommend/gi,
+            /consider/gi,
+            /add/gi,
+            /include/gi,
+            /provide/gi,
+        ];
+        const suggestions = [];
+        suggestionPatterns.forEach(pattern => {
+            if (pattern.test(notes)) {
+                suggestions.push(notes);
+            }
+        });
+        return suggestions.length > 0 ? suggestions : ["Review response structure"];
+    }
+    static calculateValidationConfidence(isValid, issueCount) {
+        let confidence = isValid ? 0.9 : 0.5;
+        confidence -= issueCount * 0.1;
+        return Math.max(0, Math.min(1, confidence));
+    }
+    static createEnhancedInsight(original, enhancedText) {
+        return {
+            ...original,
+            description: enhancedText,
+            confidence: Math.min(original.confidence + 5, 100), // Slight confidence boost
+        };
+    }
+    static createNewInsight(enhancedText, index) {
+        return {
+            id: `llm-enhanced-${Date.now()}-${index}`,
+            type: "analysis",
+            title: this.extractTitleFromText(enhancedText),
+            description: enhancedText,
+            evidence: [], // LLM should not add new evidence
+            confidence: 70, // Default confidence for new insights
+            priority: "medium",
+            category: "strategy",
+        };
+    }
+    static extractTitleFromText(text) {
+        // Extract first sentence or create title from first 50 characters
+        const sentences = text.split(/[.!?]/);
+        const firstSentence = sentences[0]?.trim() || "";
+        if (firstSentence.length <= 50) {
+            return firstSentence;
+        }
+        return text.substring(0, 50).trim() + "...";
+    }
+    static sanitizeResponse(content) {
+        // Remove any potentially harmful content
+        return content
+            .replace(/<script[^>]*>.*?<\/script>/gis, "")
+            .replace(/javascript:/gi, "")
+            .replace(/on\w+\s*=/gi, "")
+            .trim();
+    }
+    static extractMetrics(parsed) {
+        const insightCount = parsed.enhancedInsights.length;
+        const challengeCount = parsed.adversarialChallenges.length;
+        const averageInsightLength = insightCount > 0
+            ? parsed.enhancedInsights.reduce((sum, insight) => sum + insight.length, 0) / insightCount
+            : 0;
+        const averageChallengeLength = challengeCount > 0
+            ? parsed.adversarialChallenges.reduce((sum, challenge) => sum + challenge.length, 0) / challengeCount
+            : 0;
+        const hasConfidenceAssessment = parsed.confidenceAssessment.length > 0;
+        return {
+            insightCount,
+            challengeCount,
+            averageInsightLength,
+            averageChallengeLength,
+            hasConfidenceAssessment,
+        };
+    }
+    // Structured JSON parsing methods
+    static parseStructuredResponse(llmContent) {
+        try {
+            // Try to parse as JSON first
+            const jsonMatch = llmContent.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const structuredResponse = JSON.parse(jsonMatch[0]);
+                return {
+                    enhancedInsights: structuredResponse.insights.map(i => i.description),
+                    adversarialChallenges: structuredResponse.insights.map(i => i.adversarialChallenge),
+                    confidenceAssessment: `Confidence: ${(structuredResponse.confidence * 100).toFixed(1)}%`,
+                    rawContent: llmContent,
+                    structuredResponse,
+                };
+            }
+        }
+        catch (error) {
+            console.warn('Failed to parse structured JSON response:', error);
+        }
+        // Fallback to original parsing
+        return this.parseCoalescingResponse(llmContent);
+    }
+    static validateStructuredResponse(response) {
+        const issues = [];
+        // Validate basic structure
+        if (!response.insights || !Array.isArray(response.insights)) {
+            issues.push({
+                type: 'structure_invalid',
+                severity: 'error',
+                message: 'Missing or invalid insights array'
+            });
+        }
+        if (typeof response.confidence !== 'number' || response.confidence < 0 || response.confidence > 1) {
+            issues.push({
+                type: 'structure_invalid',
+                severity: 'error',
+                message: 'Invalid confidence value'
+            });
+        }
+        // Validate evidence grounding
+        if (response.evidenceValidation) {
+            const groundingScore = response.evidenceValidation.groundingScore;
+            if (groundingScore < 0.7) {
+                issues.push({
+                    type: 'evidence_missing',
+                    severity: 'warning',
+                    message: `Low evidence grounding score: ${(groundingScore * 100).toFixed(1)}%`
+                });
+            }
+        }
+        // Validate individual insights
+        response.insights?.forEach((insight, index) => {
+            if (!insight.evidenceIds || insight.evidenceIds.length === 0) {
+                issues.push({
+                    type: 'evidence_missing',
+                    severity: 'warning',
+                    message: `Insight ${index + 1} has no evidence citations`,
+                    insightId: insight.id
+                });
+            }
+            if (insight.confidence < 0.5) {
+                issues.push({
+                    type: 'confidence_low',
+                    severity: 'info',
+                    message: `Insight ${index + 1} has low confidence: ${(insight.confidence * 100).toFixed(1)}%`,
+                    insightId: insight.id
+                });
+            }
+        });
+        const isValid = issues.filter(i => i.severity === 'error').length === 0;
+        const confidence = isValid ? response.confidence : Math.max(0, response.confidence - 0.2);
+        return {
+            isValid,
+            confidence,
+            issues,
+            suggestions: this.generateSuggestions(issues),
+            processingTime: 0
+        };
+    }
+    static validateEvidenceGrounding(insights, availableEvidence) {
+        const totalInsights = insights.length;
+        const missingEvidence = [];
+        const invalidEvidence = [];
+        let groundedInsights = 0;
+        const evidenceSet = new Set(availableEvidence.map(e => e.id));
+        insights.forEach(insight => {
+            const hasValidEvidence = insight.evidenceIds.some((evidenceId) => {
+                if (!evidenceSet.has(evidenceId)) {
+                    if (!missingEvidence.includes(evidenceId)) {
+                        missingEvidence.push(evidenceId);
+                    }
+                    return false;
+                }
+                return true;
+            });
+            if (hasValidEvidence) {
+                groundedInsights++;
+            }
+        });
+        const groundingScore = totalInsights > 0 ? groundedInsights / totalInsights : 0;
+        return {
+            totalInsights,
+            groundedInsights,
+            missingEvidence,
+            invalidEvidence,
+            groundingScore
+        };
+    }
+    static generateSuggestions(issues) {
+        const suggestions = [];
+        if (issues.some(i => i.type === 'evidence_missing')) {
+            suggestions.push('Ensure all insights cite valid evidence IDs');
+        }
+        if (issues.some(i => i.type === 'confidence_low')) {
+            suggestions.push('Consider strengthening insights with more evidence');
+        }
+        if (issues.some(i => i.type === 'structure_invalid')) {
+            suggestions.push('Review JSON structure and required fields');
+        }
+        return suggestions;
+    }
+}
+exports.ResponseProcessor = ResponseProcessor;
+ResponseProcessor.SECTION_PATTERNS = {
+    enhancedInsights: /ENHANCED_INSIGHTS:\s*\n([\s\S]*?)(?=\n\n|\n[A-Z_]+:|$)/,
+    adversarialChallenges: /ADVERSARIAL_CHALLENGES:\s*\n([\s\S]*?)(?=\n\n|\n[A-Z_]+:|$)/,
+    confidenceAssessment: /CONFIDENCE_ASSESSMENT:\s*\n([\s\S]*?)(?=\n\n|\n[A-Z_]+:|$)/,
+};
+ResponseProcessor.VALIDATION_RESULT_PATTERN = /VALIDATION_RESULT:\s*(PASS|FAIL)/i;
+ResponseProcessor.VALIDATION_NOTES_PATTERN = /VALIDATION_NOTES:\s*\n([\s\S]*?)(?=\n\n|\n[A-Z_]+:|$)/;
+//# sourceMappingURL=response-processor.js.map

package/dist/llm/response-processor.js.map

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

package/dist/llm/structured-types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Structured Coalescing Types
+ *
+ * JSON schema definitions for structured LLM coalescing with evidence grounding
+ */
+export interface StructuredAdversarialResponse {
+    insights: AdversarialInsight[];
+    confidence: number;
+    evidenceValidation: EvidenceValidation;
+    processingTime: number;
+    metadata: ResponseMetadata;
+}
+export interface AdversarialInsight {
+    id: string;
+    title: string;
+    description: string;
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    confidence: number;
+    evidenceIds: string[];
+    adversarialChallenge: string;
+    strategicImplication: string;
+    category: 'strategy' | 'risk' | 'opportunity' | 'implementation';
+    timeframe: string;
+    effort: 'small' | 'medium' | 'large';
+}
+export interface EvidenceValidation {
+    totalInsights: number;
+    groundedInsights: number;
+    missingEvidence: string[];
+    invalidEvidence: string[];
+    groundingScore: number;
+}
+export interface ResponseMetadata {
+    model: string;
+    tokensUsed: number;
+    temperature: number;
+    reasoningEffort: string;
+    sessionId: string;
+    timestamp: number;
+}
+export interface StructuredCoalescingConfig {
+    enableStrictValidation: boolean;
+    requireEvidenceGrounding: boolean;
+    minGroundingScore: number;
+    maxInsights: number;
+    confidenceThreshold: number;
+    evidenceCategories: string[];
+}
+export interface CoalescingValidationResult {
+    isValid: boolean;
+    confidence: number;
+    issues: ValidationIssue[];
+    suggestions: string[];
+    processingTime: number;
+}
+export interface ValidationIssue {
+    type: 'evidence_missing' | 'evidence_invalid' | 'malformed_json' | 'confidence_low' | 'structure_invalid';
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    insightId?: string;
+    evidenceId?: string;
+}
+export interface EvidenceReference {
+    id: string;
+    content: string;
+    category: string;
+    confidence: number;
+    relevanceScore: number;
+}
+export declare const STRUCTURED_RESPONSE_SCHEMA: {
+    type: string;
+    required: string[];
+    properties: {
+        insights: {
+            type: string;
+            items: {
+                type: string;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                    };
+                    title: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    priority: {
+                        enum: string[];
+                    };
+                    confidence: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                    evidenceIds: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    adversarialChallenge: {
+                        type: string;
+                    };
+                    strategicImplication: {
+                        type: string;
+                    };
+                    category: {
+                        enum: string[];
+                    };
+                    timeframe: {
+                        type: string;
+                    };
+                    effort: {
+                        enum: string[];
+                    };
+                };
+            };
+        };
+        confidence: {
+            type: string;
+            minimum: number;
+            maximum: number;
+        };
+        evidenceValidation: {
+            type: string;
+            required: string[];
+            properties: {
+                totalInsights: {
+                    type: string;
+                };
+                groundedInsights: {
+                    type: string;
+                };
+                missingEvidence: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                invalidEvidence: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                groundingScore: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+        };
+        processingTime: {
+            type: string;
+        };
+        metadata: {
+            type: string;
+            required: string[];
+            properties: {
+                model: {
+                    type: string;
+                };
+                tokensUsed: {
+                    type: string;
+                };
+                temperature: {
+                    type: string;
+                };
+                reasoningEffort: {
+                    type: string;
+                };
+                sessionId: {
+                    type: string;
+                };
+                timestamp: {
+                    type: string;
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=structured-types.d.ts.map

package/dist/llm/structured-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-types.d.ts","sourceRoot":"","sources":["../../src/llm/structured-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,sBAAsB,EAAE,OAAO,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IAC1G,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDtC,CAAC"}

package/dist/llm/structured-types.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Structured Coalescing Types
+ *
+ * JSON schema definitions for structured LLM coalescing with evidence grounding
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRUCTURED_RESPONSE_SCHEMA = void 0;
+// JSON Schema for validation
+exports.STRUCTURED_RESPONSE_SCHEMA = {
+    type: 'object',
+    required: ['insights', 'confidence', 'evidenceValidation', 'processingTime', 'metadata'],
+    properties: {
+        insights: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['id', 'title', 'description', 'priority', 'confidence', 'evidenceIds', 'adversarialChallenge', 'strategicImplication', 'category', 'timeframe', 'effort'],
+                properties: {
+                    id: { type: 'string' },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    priority: { enum: ['critical', 'high', 'medium', 'low'] },
+                    confidence: { type: 'number', minimum: 0, maximum: 1 },
+                    evidenceIds: { type: 'array', items: { type: 'string' } },
+                    adversarialChallenge: { type: 'string' },
+                    strategicImplication: { type: 'string' },
+                    category: { enum: ['strategy', 'risk', 'opportunity', 'implementation'] },
+                    timeframe: { type: 'string' },
+                    effort: { enum: ['small', 'medium', 'large'] }
+                }
+            }
+        },
+        confidence: { type: 'number', minimum: 0, maximum: 1 },
+        evidenceValidation: {
+            type: 'object',
+            required: ['totalInsights', 'groundedInsights', 'missingEvidence', 'invalidEvidence', 'groundingScore'],
+            properties: {
+                totalInsights: { type: 'number' },
+                groundedInsights: { type: 'number' },
+                missingEvidence: { type: 'array', items: { type: 'string' } },
+                invalidEvidence: { type: 'array', items: { type: 'string' } },
+                groundingScore: { type: 'number', minimum: 0, maximum: 1 }
+            }
+        },
+        processingTime: { type: 'number' },
+        metadata: {
+            type: 'object',
+            required: ['model', 'tokensUsed', 'temperature', 'reasoningEffort', 'sessionId', 'timestamp'],
+            properties: {
+                model: { type: 'string' },
+                tokensUsed: { type: 'number' },
+                temperature: { type: 'number' },
+                reasoningEffort: { type: 'string' },
+                sessionId: { type: 'string' },
+                timestamp: { type: 'number' }
+            }
+        }
+    }
+};
+//# sourceMappingURL=structured-types.js.map

package/dist/llm/structured-types.js.map

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

package/dist/llm/validation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Evidence-Based Validation Layer
+ *
+ * Ensures LLM responses remain grounded in deterministic findings
+ * and prevents hallucination while maintaining adversarial value
+ */
+import { PersonaInsight } from "../types/persona";
+import { ParsedLLMResponse } from "./response-processor";
+export interface ValidationConfig {
+    evidenceThreshold: number;
+    confidenceThreshold: number;
+    maxNewInsights: number;
+    requireEvidenceGrounding: boolean;
+}
+export interface ValidationReport {
+    isValid: boolean;
+    score: number;
+    issues: ValidationIssue[];
+    metrics: ValidationMetrics;
+    recommendations: string[];
+}
+export interface ValidationIssue {
+    type: "evidence_drift" | "confidence_inflation" | "hallucination" | "priority_mismatch";
+    severity: "low" | "medium" | "high" | "critical";
+    description: string;
+    affectedInsights: string[];
+    suggestion: string;
+}
+export interface ValidationMetrics {
+    evidenceOverlap: number;
+    confidenceInflation: number;
+    priorityAlignment: number;
+    newInsightCount: number;
+    hallucinationRisk: number;
+}
+export declare class EvidenceValidator {
+    private config;
+    constructor(config?: Partial<ValidationConfig>);
+    validateLLMResponse(parsedResponse: ParsedLLMResponse, deterministicInsights: PersonaInsight[]): ValidationReport;
+    private validateEvidenceGrounding;
+    private validateConfidenceLevels;
+    private validatePriorityAlignment;
+    private detectHallucination;
+    private validateNewInsights;
+    private calculateMetrics;
+    private calculateEvidenceOverlap;
+    private calculateConfidenceInflation;
+    private calculatePriorityAlignment;
+    private calculateHallucinationRisk;
+    private calculateValidationScore;
+    private generateRecommendations;
+    private extractEvidenceFromText;
+    private parseConfidenceFromAssessment;
+    private countPriorityShifts;
+    private findContradictions;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/llm/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/llm/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,GAAG,eAAe,GAAG,mBAAmB,CAAC;IACxF,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAUlD,mBAAmB,CACjB,cAAc,EAAE,iBAAiB,EACjC,qBAAqB,EAAE,cAAc,EAAE,GACtC,gBAAgB;IAsDnB,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,wBAAwB;IA4BhC,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,4BAA4B;IAapC,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,0BAA0B;IAwBlC,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,uBAAuB;IA4B/B,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,6BAA6B;IAiBrC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,kBAAkB;CAkB3B"}