ai-debug-local-mcp/dist/utils/test-expectation-tracker.d.ts

🎯 ENHANCED AI GUIDANCE v4.1.2: Dramatically improved tool descriptions help AI users choose the right tools instead of 'close enough' options. Ultra-fast keyboard automation (10x speed), universal recording, multi-ecosystem debugging support, and compreh

/**
 * Test Expectation Tracker
 * Compares test expectations vs actual UI rendering
 * Based on Cycle 22 user feedback - widget key comparison
 */
export interface TestExpectation {
    key: string;
    type: 'exact' | 'pattern' | 'count' | 'conditional';
    description: string;
    criticality: 'must_have' | 'should_have' | 'nice_to_have';
    dependencies: string[];
    testFile?: string;
    testFunction?: string;
}
export interface ActualRenderingState {
    renderedKeys: string[];
    missingKeys: string[];
    extraKeys: string[];
    elementCounts: Map<string, number>;
    renderingTimestamp: number;
    errorMessages: string[];
}
export interface ExpectationComparison {
    expectation: TestExpectation;
    status: 'met' | 'partially_met' | 'not_met' | 'error';
    actualElements: string[];
    expectedElements: string[];
    gap: string;
    recommendation: string;
    implementationHint: string;
}
export interface ExpectationTrackingResult {
    overallStatus: 'passing' | 'partial' | 'failing';
    totalExpectations: number;
    metExpectations: number;
    comparisons: ExpectationComparison[];
    implementationPlan: ImplementationStep[];
    criticalGaps: string[];
}
export interface ImplementationStep {
    order: number;
    action: string;
    target: string;
    code: string;
    reason: string;
    dependencies: string[];
    estimatedEffort: 'small' | 'medium' | 'large';
}
export declare class TestExpectationTracker {
    private static instance;
    static getInstance(): TestExpectationTracker;
    private expectations;
    private trackingHistory;
    constructor();
    /**
     * Initialize common expectations from Cycle 22 success pattern
     */
    private initializeCommonExpectations;
    /**
     * Track test expectations against actual rendering
     */
    trackExpectations(sessionId: string, page?: any): Promise<ExpectationTrackingResult>;
    /**
     * Capture actual rendering state from the page
     */
    private captureActualRenderingState;
    /**
     * Compare expectation with actual rendering state
     */
    private compareExpectationWithActual;
    /**
     * Evaluate conditional expectations
     */
    private evaluateConditionalExpectation;
    /**
     * Generate gap analysis
     */
    private generateGapAnalysis;
    /**
     * Generate recommendation
     */
    private generateRecommendation;
    /**
     * Generate implementation hint
     */
    private generateImplementationHint;
    /**
     * Determine overall status
     */
    private determineOverallStatus;
    /**
     * Generate implementation plan
     */
    private generateImplementationPlan;
    /**
     * Generate implementation code
     */
    private generateImplementationCode;
    /**
     * Estimate implementation effort
     */
    private estimateImplementationEffort;
    /**
     * Identify critical gaps
     */
    private identifyCriticalGaps;
    /**
     * Add custom expectation
     */
    addExpectation(expectation: TestExpectation): void;
    /**
     * Get expectation by key
     */
    getExpectation(key: string): TestExpectation | undefined;
    /**
     * Get tracking history
     */
    getTrackingHistory(sessionId: string): ExpectationTrackingResult | undefined;
    /**
     * Clear expectations (for testing)
     */
    clearExpectations(): void;
    /**
     * Get all expectations
     */
    getAllExpectations(): TestExpectation[];
}
//# sourceMappingURL=test-expectation-tracker.d.ts.map