ai-debug-local-mcp/dist/utils/debugging-value-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

/**
 * Debugging Value Tracker
 *
 * Tracks the real value delivered by AI-Debug: context preservation,
 * time savings, automation benefits, and debugging efficiency.
 * NOT about token savings (which don't exist with sub-agents).
 */
export interface ContextPreservationMetrics {
    sessionId: string;
    timestamp: number;
    mainConversationLines: number;
    debuggingOutputLines: number;
    contextPreservedLines: number;
    contextPreservationRatio: number;
    subAgentDelegations: {
        agentType: string;
        taskDescription: string;
        outputLinesHandled: number;
        delegationTime: number;
    }[];
}
export interface TimeSavingsMetrics {
    sessionId: string;
    taskType: string;
    automatedSteps: string[];
    estimatedManualTimeMs: number;
    actualExecutionTimeMs: number;
    timeSavedMs: number;
    timeSavingsPercentage: number;
}
export interface DebuggingEfficiencyMetrics {
    sessionId: string;
    issuesIdentified: number;
    issuesResolved: number;
    successRate: number;
    toolsUsed: string[];
    automatedActions: number;
    debuggingDepth: 'surface' | 'moderate' | 'deep';
    outcomes: {
        type: string;
        severity: 'critical' | 'high' | 'medium' | 'low';
        resolutionTime: number;
        automated: boolean;
    }[];
}
export interface WorkflowAutomationMetrics {
    sessionId: string;
    workflowType: string;
    manualStepsEliminated: string[];
    automationLevel: number;
    cognitiveLoadReduction: 'low' | 'medium' | 'high';
    professionalCapabilities: string[];
}
export interface ValueDeliveredSummary {
    totalSessions: number;
    contextPreserved: {
        totalLinesKeptFromMain: number;
        averagePreservationRatio: number;
        cleanConversationScore: number;
    };
    timeEfficiency: {
        totalTimeSavedHours: number;
        averageSpeedupFactor: number;
        fastestResolutions: string[];
    };
    debuggingQuality: {
        totalIssuesFound: number;
        totalIssuesResolved: number;
        overallSuccessRate: number;
        criticalBugsCaught: number;
    };
    automationValue: {
        totalStepsAutomated: number;
        mostAutomatedWorkflows: string[];
        professionalFeaturesUsed: string[];
    };
    estimatedValueDelivered: {
        hoursSaved: number;
        dollarValue: number;
        productivityMultiplier: number;
    };
}
/**
 * Tracks real debugging value delivered to users
 */
export declare class DebuggingValueTracker {
    private contextMetrics;
    private timeMetrics;
    private efficiencyMetrics;
    private automationMetrics;
    private readonly PROFESSIONAL_CAPABILITIES;
    private readonly MANUAL_TIME_ESTIMATES;
    /**
     * Track context preservation from sub-agent delegation
     */
    trackContextPreservation(sessionId: string, mainConversationLines: number, subAgentOutput: {
        agentType: string;
        taskDescription: string;
        outputLines: number;
        executionTime: number;
    }): void;
    /**
     * Track time savings from automation
     */
    trackTimeSavings(sessionId: string, taskType: string, automatedSteps: string[], actualExecutionTimeMs: number): void;
    /**
     * Track debugging efficiency and outcomes
     */
    trackDebuggingEfficiency(sessionId: string, efficiency: Omit<DebuggingEfficiencyMetrics, 'sessionId' | 'successRate'>): void;
    /**
     * Track workflow automation value
     */
    trackWorkflowAutomation(sessionId: string, workflowType: string, manualStepsEliminated: string[], professionalCapabilities: string[]): void;
    /**
     * Get comprehensive value delivered summary
     */
    getValueDeliveredSummary(): ValueDeliveredSummary;
    /**
     * Get session-specific value metrics
     */
    getSessionValue(sessionId: string): {
        contextPreserved: number;
        timeSaved: number;
        efficiencyScore: number;
        automationLevel: number;
        estimatedValue: number;
    };
    private estimateManualTime;
    private calculateAutomationLevel;
    private assessCognitiveLoadReduction;
    /**
     * Generate value report for display
     */
    generateValueReport(): string;
}
//# sourceMappingURL=debugging-value-tracker.d.ts.map