lambdust 0.1.1

A Scheme dialect with gradual typing and effect systems
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

//! Detection results for performance regression analysis.
//!
//! This module contains the result structures and data types
//! for reporting performance regressions, improvements, and comparisons.

use std::collections::HashMap;
use std::time::SystemTime;
use serde::{Deserialize, Serialize};
use super::regression_detector::RegressionDetectionConfig;
use super::baseline_manager::BaselineStatistics;
use super::trend_analyzer::TrendAnalysis;
use super::anomaly_detector::PerformanceAnomaly;
use super::analysis_support::{OverallAssessment, ActionRecommendation, SuspectedCause, ImprovementCause};

/// Comprehensive results from performance regression analysis.
/// 
/// Contains all detected regressions, improvements, trends, and anomalies
/// with recommendations for addressing performance issues.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RegressionDetectionResult {
    /// Timestamp of analysis
    pub timestamp: SystemTime,
    /// Configuration used
    pub config: RegressionDetectionConfig,
    /// Detected regressions
    pub regressions: Vec<PerformanceRegression>,
    /// Detected improvements
    pub improvements: Vec<PerformanceImprovement>,
    /// Trend analysis results
    pub trends: HashMap<String, TrendAnalysis>,
    /// Anomaly detection results
    pub anomalies: Vec<PerformanceAnomaly>,
    /// Overall assessment
    pub overall_assessment: OverallAssessment,
    /// Recommendations for action
    pub recommendations: Vec<ActionRecommendation>,
}

/// Detected performance regression with detailed analysis.
/// 
/// Represents a statistically significant performance degradation
/// with severity assessment and suspected root causes.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceRegression {
    /// Test identifier
    pub test_id: String,
    /// Implementation affected
    pub implementation: String,
    /// Performance degradation percentage
    pub degradation_percent: f64,
    /// Statistical significance
    pub statistical_significance: StatisticalSignificance,
    /// Severity level
    pub severity: RegressionSeverity,
    /// Current vs baseline comparison
    pub current_vs_baseline: PerformanceComparison,
    /// Suspected causes
    pub suspected_causes: Vec<SuspectedCause>,
    /// First detected timestamp
    pub first_detected: SystemTime,
    /// Confidence in detection
    pub confidence: f64,
}

/// Detected performance improvement with analysis details.
/// 
/// Represents a statistically significant performance improvement
/// with likely contributing factors and impact assessment.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceImprovement {
    /// Test identifier
    pub test_id: String,
    /// Implementation improved
    pub implementation: String,
    /// Performance improvement percentage
    pub improvement_percent: f64,
    /// Statistical significance
    pub statistical_significance: StatisticalSignificance,
    /// Current vs baseline comparison
    pub current_vs_baseline: PerformanceComparison,
    /// Likely causes
    pub likely_causes: Vec<ImprovementCause>,
    /// First detected timestamp
    pub first_detected: SystemTime,
    /// Confidence in detection
    pub confidence: f64,
}

/// Statistical significance assessment for performance changes.
/// 
/// Provides statistical test results and effect size measurements
/// to validate the reliability of detected performance changes.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StatisticalSignificance {
    /// P-value from statistical test
    pub p_value: f64,
    /// Whether statistically significant
    pub is_significant: bool,
    /// Type of test used
    pub test_method: String,
    /// Effect size
    pub effect_size: f64,
}

/// Severity of performance regression
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum RegressionSeverity {
    /// Minor performance regression (5-15% degradation)
    Minor,      // 5-15% degradation
    /// Moderate performance regression (15-30% degradation)
    Moderate,   // 15-30% degradation
    /// Major performance regression (30-50% degradation)
    Major,      // 30-50% degradation
    /// Critical performance regression (>50% degradation)
    Critical,   // >50% degradation
}

/// Comparison between current and baseline performance
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PerformanceComparison {
    /// Baseline statistics
    pub baseline: BaselineStatistics,
    /// Current measurements
    pub current_values: Vec<f64>,
    /// Current statistics
    pub current_statistics: BaselineStatistics,
    /// Difference metrics
    pub difference: DifferenceMetrics,
}

/// Metrics describing the difference between baseline and current
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DifferenceMetrics {
    /// Mean difference (current - baseline)
    pub mean_difference: f64,
    /// Percentage change
    pub percent_change: f64,
    /// Standard error of difference
    pub standard_error: f64,
    /// Cohen's d effect size
    pub effect_size: f64,
    /// Confidence interval for difference
    pub confidence_interval: (f64, f64),
}