## 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
