agentsqripts/cli/lib/complexity/formatComplexitySummary.js

Comprehensive static code analysis toolkit for identifying technical debt, security vulnerabilities, performance issues, and code quality problems

/**
 * @file Format complexity analysis summary
 * @description Single responsibility: Summary output formatting for complexity analysis
 */

const path = require('path');

/**
 * Output complexity analysis summary
 * @param {Object} results - Analysis results
 * @param {Object} options - Output options
 */
function formatComplexitySummary(results, options) {
  console.log('📊 COMPLEXITY ANALYSIS SUMMARY\n');
  
  if (results.fileAnalysis) {
    const analysis = results.fileAnalysis;
    console.log(`📄 File: ${path.basename(analysis.file)}`);
    console.log(`🔄 Complexity: ${analysis.complexity}`);
    console.log(`📈 Maintainability: ${analysis.maintainabilityIndex}/100`);
    console.log(`⚠️  Issues: ${analysis.issues.length}`);
    
    if (analysis.issues.length > 0) {
      const highSeverityIssues = analysis.issues.filter(i => i.severity === 'HIGH');
      if (highSeverityIssues.length > 0) {
        console.log('\n🚨 High Priority Issues:');
        highSeverityIssues.forEach(issue => {
          console.log(`   - ${issue.type}: ${issue.recommendation}`);
        });
      }
    }
  }
  
  if (results.projectAnalysis) {
    const analysis = results.projectAnalysis;
    console.log(`📊 Overall Complexity: ${analysis.overallComplexity}`);
    console.log(`📄 Files Analyzed: ${analysis.analyzedFiles}`);
    console.log(`📈 Average Maintainability: ${Math.round(analysis.averageMaintainabilityIndex)}/100`);
    
    const problemFiles = analysis.complexityBreakdown.high + analysis.complexityBreakdown.critical;
    if (problemFiles > 0) {
      console.log(`⚠️  Problem Files: ${problemFiles}`);
    }
  }
  
  if (results.debtAnalysis) {
    const analysis = results.debtAnalysis;
    console.log(`💸 Technical Debt: ${analysis.priority} (${analysis.debtScore}/100)`);
    console.log(`📝 TODO Items: ${analysis.todoItems.length}`);
    console.log(`👃 Code Smells: ${analysis.codeSmells.length}`);
    console.log(`🧪 Has Tests: ${analysis.testCoverage.hasTests ? 'Yes' : 'No'}`);
  }
  
  console.log('\n🤖 AI Agent Guidance:');
  if (results.fileAnalysis) {
    const complexity = results.fileAnalysis.complexity;
    console.log(`   - SCOPE: Single file analysis (${complexity} complexity)`);
    console.log(`   - FOCUS: ${results.fileAnalysis.issues.length > 0 ? 'Function-level refactoring' : 'No issues detected'}`);
  }
  
  if (results.projectAnalysis) {
    const analysis = results.projectAnalysis;
    console.log(`   - SCOPE: Project-wide complexity analysis (${analysis.overallComplexity})`);
    console.log(`   - FILES_AFFECTED: ${analysis.complexityBreakdown.high + analysis.complexityBreakdown.critical} need attention`);
    console.log(`   - PRIORITY: ${analysis.recommendations.length > 0 ? analysis.recommendations[0].priority : 'LOW'}`);
  }
  
  if (results.debtAnalysis && results.debtAnalysis.priority !== 'LOW') {
    console.log(`   - DEBT_SCOPE: Technical debt cleanup needed (${results.debtAnalysis.priority})`);
    console.log(`   - DEBT_FOCUS: ${results.debtAnalysis.recommendations[0]?.type || 'General cleanup'}`);
  }
  
  console.log(`\n⏱️  Analysis completed at: ${new Date().toLocaleString()}`);
}

module.exports = formatComplexitySummary;