agentsqripts/lib/static-bugs/qualityGradeProvider.js

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

/**
 * @file Code quality grade provider for standardized quality assessment
 * @description Single responsibility: Convert numeric quality scores into standardized letter grades
 * 
 * This provider implements a standardized grading system that translates numeric code quality
 * scores into intuitive letter grades (A, B, C, D, F) for easy interpretation by development
 * teams. It provides consistent quality assessment across different analysis modules and
 * enables tracking of code quality improvements over time.
 * 
 * Design rationale:
 * - Academic grading system provides intuitive quality interpretation for all stakeholders
 * - Standardized thresholds ensure consistent quality assessment across different modules
 * - Letter grades enable simple quality tracking and team communication
 * - Conservative grading approach sets high standards for code quality excellence
 * - Configurable thresholds support different quality standards for different project types
 * 
 * Grading methodology:
 * - A grade (90-100): Exceptional code quality with minimal issues requiring attention
 * - B grade (80-89): Good code quality with minor issues that should be addressed
 * - C grade (70-79): Acceptable quality with moderate issues requiring focused improvement
 * - D grade (60-69): Below average quality with significant issues needing immediate attention
 * - F grade (0-59): Poor quality with critical issues requiring comprehensive refactoring
 */

const { getLetterGrade } = require('../utils/gradeUtils');

/**
 * Gets quality grade based on score
 * @param {number} score - Quality score (0-100)
 * @returns {string} Quality grade (A-F)
 */
function getQualityGrade(score) {
  return getLetterGrade(score);
}

module.exports = {
  getQualityGrade
};