codebase-health-dashboard

Codebase Health Dashboard

Point this at a .NET repo and get back a single scored report card: one overall health score, eight category scores, the findings behind each score, and the highest-leverage fixes. It is the "run everything and tell me where I stand" tool.

Input - point it at your project

Works on a target: a project/solution or a GitHub URL (git clone --depth 1 <url> then scan). Find the surface first:

find <target> -name "*.sln" -o -name "*.csproj" | grep -vi "/obj/\|/bin/"

Workflow

1. Run the relevant auditors on the repo and collect their findings. Use the installed tools if present, otherwise apply their checklists directly:
   • Security - aspnetcore-security-auditor, secrets-config-auditor
   • Architecture - dotnet-architecture-reviewer
   • EF / Database - db-performance-auditor, ef-core-query-optimizer
   • Performance - async-await-auditor, memory-allocation-analyzer
   • Observability - observability-gap-finder
   • Testing - test-coverage-gap-finder
   • Dependencies - dependency-vuln-scanner, nuget-dependency-analyzer
   • Code Quality - dotnet-code-reviewer
2. Score each category with the fixed rubric below (deterministic, so re-runs are comparable).
3. Fill the template references/health-dashboard-template.html - replace /*__HEALTH_DATA__*/ with the JSON object (shape below) and write it to health-dashboard/index.html.
4. Save a history record to health/health-<YYYY-MM-DD>.json with the same data, so the score can be tracked over time.
5. Tell the user the overall score and the top 3 actions to raise it the fastest.

Scoring rubric (deterministic)

Each category starts at 100. Subtract per finding by severity, floor at 0:

• critical: -25
• high: -12
• medium: -5
• low: -2

If a category genuinely has no applicable surface (e.g. no messaging, so some observability checks do not apply), score what exists and note it - do not invent findings to fill it.