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
    scored_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
    static_crates: int
    smart_crates: int
    unknown_crates: int
    dynamic_references_excluded: int

    @property
    def score_basis(self) -> str:
        return "Resolved non-dynamic references / non-dynamic references scored"