## ADDED Requirements ### Requirement: Code health grades The system SHALL return A–F code health scores per file and aggregate per project. #### Scenario: File health score - **WHEN** a file is analyzed for code health - **THEN** it SHALL receive a score from 10.0 (optimal) to 1.0 (worst) - **THEN** the score SHALL be mapped to A–F grade ### Requirement: Hotspot detection The system SHALL identify technical debt hotspots — files with high revision count and low code health. #### Scenario: Hotspots listed - **WHEN** a project is scanned for hotspots - **THEN** files with high churn and low health SHALL be ranked