@jterrats/smart-deployment 1.0.3

package/lib/ai/prompt-builder.js

@@ -0,0 +1,180 @@
+/**
+ * AI Prompt Builder - US-058
+ * Build effective AI prompts with context and token optimization
+ *
+ * @ac US-058-AC-1: Context-aware prompt generation
+ * @ac US-058-AC-2: Include relevant metadata snippets
+ * @ac US-058-AC-3: Optimize token usage
+ * @ac US-058-AC-4: Template-based prompts
+ * @ac US-058-AC-5: Version prompts
+ * @ac US-058-AC-6: A/B test prompts
+ * @issue #58
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('PromptBuilder');
+/**
+ * @ac US-058-AC-4: Template-based prompts
+ * Predefined prompt templates
+ */
+const PROMPT_TEMPLATES = {
+    'dependency-inference': {
+        name: 'Dependency Inference',
+        version: '1.0.0',
+        systemPrompt: 'You are an expert Salesforce metadata analyzer specialized in finding implicit dependencies.',
+        userPromptTemplate: `Analyze these components and infer non-obvious dependencies:
+
+Components: {{components}}
+
+Look for dynamic references, implicit dependencies, and business logic relationships.
+Return JSON array of dependencies with confidence scores.`,
+        maxTokens: 2000,
+        temperature: 0.2,
+    },
+    'wave-validation': {
+        name: 'Wave Validation',
+        version: '1.0.0',
+        systemPrompt: 'You are a Salesforce deployment architect expert in wave optimization.',
+        userPromptTemplate: `Validate these deployment waves for issues:
+
+Waves: {{waves}}
+
+Identify business logic issues, performance concerns, and risks.
+Return JSON with issues, optimizations, and risk assessments.`,
+        maxTokens: 3000,
+        temperature: 0.1,
+    },
+    'priority-analysis': {
+        name: 'Priority Analysis',
+        version: '1.0.0',
+        systemPrompt: 'You are a Salesforce architect expert in deployment prioritization.',
+        userPromptTemplate: `Analyze component priorities for deployment:
+
+Components: {{components}}
+Organization Type: {{orgType}}
+Industry: {{industry}}
+
+Consider business criticality and failure impact.
+Return JSON array of priority recommendations.`,
+        maxTokens: 2000,
+        temperature: 0.3,
+    },
+};
+/**
+ * @ac US-058-AC-1: Context-aware prompt generation
+ * @ac US-058-AC-2: Include relevant metadata snippets
+ */
+export class PromptBuilder {
+    constructor(maxTokenEstimate = 4000) {
+        logger.debug('Prompt builder initialized', { maxTokenEstimate });
+    }
+    /**
+     * @ac US-058-AC-1: Context-aware prompt generation
+     * Build prompt from template and context
+     */
+    buildPrompt(options) {
+        const template = PROMPT_TEMPLATES[options.template];
+        if (!template) {
+            throw new Error(`Template '${options.template}' not found`);
+        }
+        logger.debug('Building prompt', {
+            template: options.template,
+            variant: options.variant,
+        });
+        // Get variant-specific template if A/B testing
+        const userTemplate = this.getTemplateVariant(template, options.variant);
+        // Optimize context for token usage
+        const optimizedContext = this.optimizeContext(options.context);
+        // Replace placeholders
+        let userPrompt = userTemplate;
+        for (const [key, value] of Object.entries(optimizedContext)) {
+            const placeholder = `{{${key}}}`;
+            const replacement = typeof value === 'string' ? value : JSON.stringify(value, null, 2);
+            userPrompt = userPrompt.replaceAll(placeholder, replacement);
+        }
+        // Estimate tokens
+        const estimatedTokens = this.estimateTokens(template.systemPrompt + userPrompt);
+        logger.info('Prompt built', {
+            template: template.name,
+            version: template.version,
+            estimatedTokens,
+        });
+        return {
+            systemPrompt: template.systemPrompt,
+            userPrompt,
+            estimatedTokens,
+        };
+    }
+    /**
+     * @ac US-058-AC-6: A/B test prompts
+     * Get template variant for A/B testing
+     */
+    getTemplateVariant(template, variant) {
+        if (!variant || variant === 'A') {
+            return template.userPromptTemplate;
+        }
+        // Variant B: more concise version (remove extra line breaks, simplify language)
+        return template.userPromptTemplate
+            .replace(/\n\n/g, '\n')
+            .replace(/Look for dynamic references, implicit dependencies, and business logic relationships\.\n/, '');
+    }
+    /**
+     * @ac US-058-AC-3: Optimize token usage
+     * Optimize context to reduce token count
+     */
+    optimizeContext(context) {
+        const optimized = {};
+        const limits = context.limits ?? {};
+        // Limit components
+        if (context.components) {
+            const maxComponents = limits.maxComponents ?? 20;
+            optimized.components = Array.isArray(context.components)
+                ? context.components.slice(0, maxComponents)
+                : context.components;
+        }
+        // Limit waves
+        if (context.waves) {
+            optimized.waves = Array.isArray(context.waves) ? context.waves.slice(0, 10) : context.waves;
+        }
+        // Limit dependencies
+        if (context.dependencies) {
+            optimized.dependencies = Array.isArray(context.dependencies)
+                ? context.dependencies.slice(0, 30)
+                : context.dependencies;
+        }
+        // Include other metadata as-is
+        if (context.metadata) {
+            for (const [key, value] of Object.entries(context.metadata)) {
+                optimized[key] = value;
+            }
+        }
+        return optimized;
+    }
+    /**
+     * @ac US-058-AC-3: Optimize token usage
+     * Estimate token count (rough approximation)
+     */
+    estimateTokens(text) {
+        // Rough estimate: 1 token ≈ 4 characters
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Get available templates
+     */
+    getTemplates() {
+        return Object.keys(PROMPT_TEMPLATES);
+    }
+    /**
+     * Get template details
+     */
+    getTemplate(name) {
+        return PROMPT_TEMPLATES[name];
+    }
+    /**
+     * @ac US-058-AC-5: Version prompts
+     * Get template version
+     */
+    getTemplateVersion(name) {
+        return PROMPT_TEMPLATES[name]?.version;
+    }
+}
+//# sourceMappingURL=prompt-builder.js.map

package/lib/ai/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../src/ai/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AA4B1C;;;GAGG;AACH,MAAM,gBAAgB,GAAmC;IACvD,sBAAsB,EAAE;QACtB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,8FAA8F;QAC5G,kBAAkB,EAAE;;;;;0DAKkC;QACtD,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,wEAAwE;QACtF,kBAAkB,EAAE;;;;;8DAKsC;QAC1D,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB;IAED,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,qEAAqE;QACnF,kBAAkB,EAAE;;;;;;;+CAOuB;QAC3C,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB,YAAmB,mBAA2B,IAAI;QAChD,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,OAA2B;QAK5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,QAAQ,aAAa,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,+CAA+C;QAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAExE,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/D,uBAAuB;QACvB,IAAI,UAAU,GAAG,YAAY,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5D,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC;YACjC,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvF,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/D,CAAC;QAED,kBAAkB;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC;QAEhF,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;YAC1B,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,eAAe;SAChB,CAAC,CAAC;QAEH,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,UAAU;YACV,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,QAAwB,EAAE,OAAmB;QACtE,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC,kBAAkB,CAAC;QACrC,CAAC;QAED,gFAAgF;QAChF,OAAO,QAAQ,CAAC,kBAAkB;aAC/B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;aACtB,OAAO,CAAC,0FAA0F,EAAE,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,OAAsB;QAC5C,MAAM,SAAS,GAA4B,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAEpC,mBAAmB;QACnB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;YACjD,SAAS,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBACtD,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;gBAC5C,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACzB,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAC9F,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC1D,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACnC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,+BAA+B;QAC/B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5D,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,IAAY;QACjC,yCAAyC;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,IAAY;QAC7B,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,IAAY;QACpC,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACzC,CAAC;CACF"}

package/lib/ai/response-parser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * AI Response Parser - US-059
+ * Parse AI responses reliably and extract actionable information
+ *
+ * @ac US-059-AC-1: Parse JSON responses
+ * @ac US-059-AC-2: Handle malformed responses
+ * @ac US-059-AC-3: Extract structured data
+ * @ac US-059-AC-4: Validate response schema
+ * @ac US-059-AC-5: Handle AI hallucinations
+ * @ac US-059-AC-6: Confidence scoring
+ * @issue #59
+ */
+export type ParsedResponse<T> = {
+    success: boolean;
+    data?: T;
+    confidence: number;
+    warnings: string[];
+    errors: string[];
+    rawContent: string;
+    hallucinationDetected: boolean;
+};
+export type SchemaValidationResult = {
+    valid: boolean;
+    errors: string[];
+    missingFields: string[];
+    invalidTypes: string[];
+};
+/**
+ * @ac US-059-AC-1: Parse JSON responses
+ * @ac US-059-AC-2: Handle malformed responses
+ */
+export declare class ResponseParser {
+    /**
+     * @ac US-059-AC-1: Parse JSON responses
+     * Parse AI response into structured data
+     */
+    parse<T>(content: string, schema?: Record<string, unknown>): ParsedResponse<T>;
+    /**
+     * @ac US-059-AC-2: Handle malformed responses
+     * Extract JSON from potentially malformed response
+     */
+    private extractJSON;
+    /**
+     * @ac US-059-AC-4: Validate response schema
+     * Validate parsed data against schema
+     */
+    private validateSchema;
+    /**
+     * @ac US-059-AC-5: Handle AI hallucinations
+     * Detect potential hallucinations in AI response
+     */
+    private detectHallucinations;
+    /**
+     * @ac US-059-AC-6: Confidence scoring
+     * Calculate confidence score for parsed response
+     */
+    private calculateConfidence;
+    /**
+     * @ac US-059-AC-3: Extract structured data
+     * Parse array of items from response
+     */
+    parseArray<T>(content: string): ParsedResponse<T[]>;
+    /**
+     * Format parsing report
+     */
+    formatReport<T>(result: ParsedResponse<T>): string;
+}

package/lib/ai/response-parser.js

@@ -0,0 +1,234 @@
+/**
+ * AI Response Parser - US-059
+ * Parse AI responses reliably and extract actionable information
+ *
+ * @ac US-059-AC-1: Parse JSON responses
+ * @ac US-059-AC-2: Handle malformed responses
+ * @ac US-059-AC-3: Extract structured data
+ * @ac US-059-AC-4: Validate response schema
+ * @ac US-059-AC-5: Handle AI hallucinations
+ * @ac US-059-AC-6: Confidence scoring
+ * @issue #59
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('ResponseParser');
+/**
+ * @ac US-059-AC-1: Parse JSON responses
+ * @ac US-059-AC-2: Handle malformed responses
+ */
+export class ResponseParser {
+    /**
+     * @ac US-059-AC-1: Parse JSON responses
+     * Parse AI response into structured data
+     */
+    parse(content, schema) {
+        const result = {
+            success: false,
+            confidence: 0,
+            warnings: [],
+            errors: [],
+            rawContent: content,
+            hallucinationDetected: false,
+        };
+        try {
+            // Extract JSON from response
+            const json = this.extractJSON(content);
+            if (!json) {
+                result.errors.push('No JSON found in response');
+                return result;
+            }
+            // Parse JSON
+            const parsed = JSON.parse(json);
+            // Validate schema if provided
+            if (schema) {
+                const validation = this.validateSchema(parsed, schema);
+                if (!validation.valid) {
+                    result.errors.push(...validation.errors);
+                    result.warnings.push(...validation.missingFields.map((f) => `Missing field: ${f}`));
+                    result.success = false; // Mark as failed if schema validation fails
+                    return result;
+                }
+            }
+            // Check for hallucinations
+            const hallucinationCheck = this.detectHallucinations(content, parsed);
+            if (hallucinationCheck.detected) {
+                result.hallucinationDetected = true;
+                result.warnings.push(...hallucinationCheck.warnings);
+            }
+            // Calculate confidence
+            result.confidence = this.calculateConfidence(parsed, schema, result.warnings.length);
+            result.data = parsed;
+            result.success = true;
+            logger.debug('Response parsed successfully', {
+                confidence: result.confidence,
+                warnings: result.warnings.length,
+            });
+            return result;
+        }
+        catch (error) {
+            result.errors.push(error instanceof Error ? error.message : String(error));
+            logger.error('Failed to parse response', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return result;
+        }
+    }
+    /**
+     * @ac US-059-AC-2: Handle malformed responses
+     * Extract JSON from potentially malformed response
+     */
+    extractJSON(content) {
+        // Try to find JSON block with code fences
+        const codeBlockMatch = /```json\s*([\s\S]*?)\s*```/.exec(content);
+        if (codeBlockMatch) {
+            return codeBlockMatch[1];
+        }
+        // Try to find JSON array first (before objects, as arrays can contain objects)
+        const arrayMatch = /\[[\s\S]*\]/.exec(content);
+        if (arrayMatch) {
+            return arrayMatch[0];
+        }
+        // Try to find raw JSON object
+        const jsonMatch = /\{[\s\S]*\}/.exec(content);
+        if (jsonMatch) {
+            return jsonMatch[0];
+        }
+        return null;
+    }
+    /**
+     * @ac US-059-AC-4: Validate response schema
+     * Validate parsed data against schema
+     */
+    validateSchema(data, schema) {
+        const result = {
+            valid: true,
+            errors: [],
+            missingFields: [],
+            invalidTypes: [],
+        };
+        if (typeof data !== 'object' || data === null) {
+            result.valid = false;
+            result.errors.push('Data is not an object');
+            return result;
+        }
+        const dataObj = data;
+        // Check required fields
+        for (const [field, expectedType] of Object.entries(schema)) {
+            if (!(field in dataObj)) {
+                result.missingFields.push(field);
+                result.valid = false;
+                continue;
+            }
+            // Basic type checking
+            const actualType = Array.isArray(dataObj[field]) ? 'array' : typeof dataObj[field];
+            if (expectedType !== actualType && expectedType !== 'any') {
+                result.invalidTypes.push(`${field}: expected ${String(expectedType)}, got ${actualType}`);
+                result.valid = false;
+            }
+        }
+        return result;
+    }
+    /**
+     * @ac US-059-AC-5: Handle AI hallucinations
+     * Detect potential hallucinations in AI response
+     */
+    detectHallucinations(content, parsed) {
+        const warnings = [];
+        // Check for common hallucination patterns
+        const hallucinationPatterns = [
+            /I apologize|I'm sorry|I cannot|I don't have/i,
+            /As an AI|As a language model/i,
+            /hypothetical|example|placeholder/i,
+        ];
+        for (const pattern of hallucinationPatterns) {
+            if (pattern.test(content)) {
+                warnings.push(`Possible hallucination detected: ${pattern.source}`);
+            }
+        }
+        // Check for suspiciously generic data
+        if (typeof parsed === 'object' && parsed !== null) {
+            const dataObj = parsed;
+            for (const [key, value] of Object.entries(dataObj)) {
+                if (typeof value === 'string' &&
+                    (value.toLowerCase().includes('example') ||
+                        value.toLowerCase().includes('placeholder') ||
+                        value.toLowerCase().includes('todo'))) {
+                    warnings.push(`Suspicious generic value in field "${key}": ${value}`);
+                }
+            }
+        }
+        return {
+            detected: warnings.length > 0,
+            warnings,
+        };
+    }
+    /**
+     * @ac US-059-AC-6: Confidence scoring
+     * Calculate confidence score for parsed response
+     */
+    calculateConfidence(data, schema, warningCount = 0) {
+        let confidence = 1.0;
+        // Reduce confidence for schema validation issues
+        if (schema) {
+            const validation = this.validateSchema(data, schema);
+            confidence -= validation.missingFields.length * 0.1;
+            confidence -= validation.invalidTypes.length * 0.15;
+        }
+        // Reduce confidence for warnings
+        confidence -= warningCount * 0.05;
+        // Check data completeness
+        if (typeof data === 'object' && data !== null) {
+            const dataObj = data;
+            const emptyFields = Object.values(dataObj).filter((v) => v === null || v === undefined || v === '').length;
+            confidence -= emptyFields * 0.05;
+        }
+        return Math.max(0, Math.min(1, confidence));
+    }
+    /**
+     * @ac US-059-AC-3: Extract structured data
+     * Parse array of items from response
+     */
+    parseArray(content) {
+        const result = this.parse(content);
+        if (result.success && result.data && !Array.isArray(result.data)) {
+            result.success = false;
+            result.errors.push('Response is not an array');
+            result.data = undefined;
+        }
+        return result;
+    }
+    /**
+     * Format parsing report
+     */
+    formatReport(result) {
+        const lines = [];
+        lines.push('📝 AI Response Parse Report');
+        lines.push('═══════════════════════════════════════');
+        if (result.success) {
+            lines.push(`✅ Success: Confidence ${(result.confidence * 100).toFixed(0)}%`);
+        }
+        else {
+            lines.push('❌ Failed to parse response');
+        }
+        if (result.errors.length > 0) {
+            lines.push('');
+            lines.push('❌ Errors:');
+            for (const error of result.errors) {
+                lines.push(`   - ${error}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            lines.push('');
+            lines.push('⚠️  Warnings:');
+            for (const warning of result.warnings) {
+                lines.push(`   - ${warning}`);
+            }
+        }
+        if (result.hallucinationDetected) {
+            lines.push('');
+            lines.push('🔍 Hallucination detected - review data carefully');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=response-parser.js.map

package/lib/ai/response-parser.js.map

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

package/lib/ai/wave-validation-service.d.ts

@@ -0,0 +1,111 @@
+/**
+ * AI Wave Validation Service - US-056
+ * Uses Agentforce to validate deployment waves for business logic issues
+ *
+ * @ac US-056-AC-1: Send wave structure to Agentforce
+ * @ac US-056-AC-2: Receive validation feedback
+ * @ac US-056-AC-3: Identify potential issues
+ * @ac US-056-AC-4: Suggest optimizations
+ * @ac US-056-AC-5: Risk assessment per wave
+ * @ac US-056-AC-6: Apply AI suggestions (optional)
+ * @issue #56
+ */
+import type { Wave } from '../waves/wave-builder.js';
+import type { LLMProvider } from './llm-provider.js';
+export type WaveValidationIssue = {
+    waveNumber: number;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    category: 'dependency' | 'business-logic' | 'performance' | 'risk';
+    message: string;
+    affectedComponents: string[];
+    suggestion?: string;
+};
+export type WaveOptimization = {
+    waveNumber: number;
+    type: 'merge' | 'split' | 'reorder' | 'add-component' | 'remove-component';
+    description: string;
+    confidence: number;
+    estimatedImprovement: string;
+};
+export type WaveRiskAssessment = {
+    waveNumber: number;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    riskFactors: string[];
+    mitigation: string[];
+    recommendedActions: string[];
+};
+export type WaveValidationResult = {
+    isValid: boolean;
+    issues: WaveValidationIssue[];
+    optimizations: WaveOptimization[];
+    riskAssessments: WaveRiskAssessment[];
+    overallRisk: 'low' | 'medium' | 'high' | 'critical';
+    executionTime: number;
+    aiAnalyzed: boolean;
+};
+export type WaveValidationServiceOptions = {
+    baseDir?: string;
+};
+/**
+ * @ac US-056-AC-1: Send wave structure to Agentforce
+ * @ac US-056-AC-2: Receive validation feedback
+ */
+export declare class WaveValidationService {
+    private readonly llmProvider;
+    constructor(llmProviderOrOptions?: LLMProvider | WaveValidationServiceOptions);
+    private resolveProvider;
+    /**
+     * @ac US-056-AC-1: Send wave structure to Agentforce
+     * Validate deployment waves using AI
+     */
+    validateWaves(waves: Wave[]): Promise<WaveValidationResult>;
+    /**
+     * Build validation prompt
+     */
+    private buildValidationPrompt;
+    /**
+     * @ac US-056-AC-2: Receive validation feedback
+     * @ac US-056-AC-3: Identify potential issues
+     * @ac US-056-AC-4: Suggest optimizations
+     * @ac US-056-AC-5: Risk assessment per wave
+     */
+    private parseValidationResponse;
+    /**
+     * Parse issues from AI response
+     */
+    private parseIssues;
+    /**
+     * Parse optimizations from AI response
+     */
+    private parseOptimizations;
+    /**
+     * Parse risk assessments from AI response
+     */
+    private parseRiskAssessments;
+    /**
+     * Get mock validation (fallback when AI unavailable)
+     */
+    private getMockValidation;
+    /**
+     * Calculate overall risk from individual assessments
+     */
+    private calculateOverallRisk;
+    /**
+     * @ac US-056-AC-6: Apply AI suggestions (optional)
+     * Apply optimization suggestions to waves
+     */
+    applyOptimizations(waves: Wave[], optimizations: WaveOptimization[]): Wave[];
+    getProviderConfig(): Readonly<ReturnType<LLMProvider['getConfig']>>;
+    /**
+     * Format validation report
+     */
+    formatValidationReport(result: WaveValidationResult): string;
+    /**
+     * Get risk level icon
+     */
+    private getRiskIcon;
+    /**
+     * Get severity icon
+     */
+    private getSeverityIcon;
+}