Novolis Docs
novolis-governance / completed-plans/platform_95_coverage_87e94556.plan.md

Platform 95% Coverage via Novolis.Platform.slnx

Policies that keep the org coherent

dotnetgovernancenovolis

name: Platform 95 Coverage overview: Regenerate Novolis.Platform.slnx, add a ProjectReference-mode coverage path that evaluates against that solution, then raise and meet a 95% aggregate line-coverage gate across library repos (excluding standing repo excludes and ExcludeFromCodeCoverage platform packages). todos:

  • id: tooling-platform-mode

content: Add -PlatformSlnx/-RegenerateSlnx to get-coverage-report.ps1 (ProjectRef build + coverage against Platform.slnx test hosts, FailBelow 95) status: completed

  • id: docs-coverage

content: Update coverage-report.md; fix Get-ScopedCoverage.ps1 linesValid bug if used status: completed

  • id: baseline-run

content: Regenerate Platform.slnx and produce baseline SUMMARY.md under ProjectRef mode status: completed

  • id: fix-failing-hosts

content: "Fix failing test hosts blocking Cobertura (known: audio Live.Unit, rendering TwoD.Unit)" status: completed

  • id: close-gaps

content: Add tests and/or documented ExcludeFromCodeCoverage until aggregate line coverage >= 95% and gate exits 0 status: completed isProject: false

Locked decisions

  • Scope: All library projects in regenerated `Novolis.Platform.slnx`, minus standing skips in `coverage-excludes.txt` and assemblies already marked [assembly: ExcludeFromCodeCoverage] (native/UI/Docker — see `coverage-report.md`).
  • Evaluation: Build/test with ProjectReference mode against the platform slnx (local source), not NuGet-mode per-repo collection.
  • Gate: Aggregate line coverage ≥ 95% (-FailBelow 95). Any test failure fails the run.

Tooling (do this first)

Extend coverage collection rather than inventing a parallel stack.

  1. Regenerate before every evaluation:
pwsh -File d:\novolis\novolis-governance\build\Generate-Platform-Slnx.ps1
  1. Add a Platform mode to `get-coverage-report.ps1` (e.g. -PlatformSlnx):
  • Resolve solution: d:\novolis\novolis-governance\build\Novolis.Platform.slnx (after regen).
  • Optional -RegenerateSlnx to call Generate-Platform-Slnx.ps1 up front.
  • Set NovolisUseProjectReferences=true (solution name Novolis.Platform also auto-enables; keep the explicit property).
  • Build once: dotnet build on the platform slnx.
  • Collect coverage: run dotnet test --coverage on every MTP test host that appears in that slnx (or dotnet test on the slnx if stable under MTP). Prefer enumerating test projects from the slnx so parallel throttle still works and apps/excludes stay out.
  • Merge Cobertura with ReportGenerator as today → d:\novolis\artifacts\coverage\.
  • Default or document -FailBelow 95 for this mode.
  1. Keep existing NuGet/per-repo mode for single-repo debugging; Platform mode is the org gate.
  1. Fix `Get-ScopedCoverage.ps1` ($valid vs $linesValid) if used for assembly-scoped rollups.
  1. Update `coverage-report.md`: Platform.slnx regen + ProjectRef evaluation + 95% gate.
flowchart TD
  regen[Generate-Platform-Slnx]
  build[dotnet build Platform.slnx ProjectRef]
  test[dotnet test hosts plus coverage]
  merge[ReportGenerator merge]
  gate{line pct ge 95}
  regen --> build --> test --> merge --> gate

Baseline then close gaps

After tooling works, run:

pwsh -File d:\novolis\novolis-governance\build\Generate-Platform-Slnx.ps1
pwsh -File d:\novolis\novolis-governance\scripts\get-coverage-report.ps1 -PlatformSlnx -RegenerateSlnx:$false -FailBelow 95

Use SUMMARY.md / HTML to drive work in this order:

  1. Green tests — last slice failed novolis-audio / novolis-rendering unit hosts; fix those first so Cobertura is complete.
  2. Linkage gaps — from `artifacts/test-gaps/SUMMARY.md`: either add headless tests + ProjectReference, or (only for true platform/native hosts) add ExcludeFromCodeCoverage and document in coverage-report.md. Candidates still unlinked without that attribute include e.g. Novolis.Media.Rtc*, Novolis.Avalonia.Media, Novolis.Media.Capture.Windows.
  3. Lowest line-% assemblies — add TUnit coverage in the owning repo’s tests/ until aggregate ≥ 95%. Prefer exercising public API and branches; no Coverlet packages (MTP --coverage only).

Do not use local NuGet feeds; ProjectRef mode is the measurement path.

Done when

  • Platform slnx regenerated and used for the coverage run.
  • get-coverage-report.ps1 -PlatformSlnx -FailBelow 95 exits 0.
  • Docs describe the Platform evaluation path.
  • verify-nuget-only.ps1 still clean (no committed cross-repo ProjectReference).