pmat 3.15.0

PMAT - Zero-config AI context generation and code quality toolkit (CLI, MCP, HTTP)
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

#![cfg_attr(coverage_nightly, coverage(off))]
//! TDG explain mode: function-level complexity breakdown
//!
//! Issue #78: Detailed explanation mode with per-function analysis
//! and actionable recommendations.

use super::display::format_explain_output;
use super::formatting::write_tdg_output;
use super::quality_gates::execute_tdg_analysis;
use super::TdgCommandConfig;
use crate::tdg::TdgAnalyzer;
use anyhow::Result;

/// Handle TDG explain mode with function-level complexity breakdown (Issue #78)
pub(super) async fn handle_explain_mode(
    analyzer: &TdgAnalyzer,
    config: &TdgCommandConfig,
) -> Result<()> {
    use crate::tdg::explain::ExplainedTDGScore;

    // First get the base TDG score
    let score = execute_tdg_analysis(analyzer, config).await?;

    // Create explained score
    let mut explained = ExplainedTDGScore::new(score.clone());

    // Analyze function-level complexity (only for single files, requires rust-ast)
    #[cfg(feature = "rust-ast")]
    if config.path.is_file() && config.path.extension().is_some_and(|e| e == "rs") {
        use crate::tdg::function_analyzer::FunctionAnalyzer;
        use crate::tdg::recommendation_engine::generate_recommendations;
        let mut func_analyzer = FunctionAnalyzer::new()?;
        let functions = func_analyzer.analyze_file(&config.path)?;

        for func in functions {
            explained.add_function(func);
        }

        // Apply threshold filter
        explained.filter_functions_by_threshold(config.threshold);
        explained.sort_functions_by_impact();

        // Generate recommendations
        let recommendations = generate_recommendations(&explained);
        for rec in recommendations {
            explained.add_recommendation(rec);
        }
        explained.sort_recommendations();
    }

    // Format and output
    let output_str = format_explain_output(&explained, config)?;
    write_tdg_output(&output_str, config)?;

    Ok(())
}