from dataclasses import dataclass
from typing import Optional


@dataclass(frozen=True)
class HealthReport:
    """Transparent aggregate findings from a read-only library analysis."""

    score: Optional[float]
    total_references: int
    healthy_references: int
    missing_references: int
    unique_missing_filenames: int
    disk_tracks: int
    duplicate_filename_groups: int
    duplicate_files: int
    unused_tracks: int
    suggested_matches: int

    @property
    def score_basis(self) -> str:
        return "Resolved crate references / total crate references"