Pennington.Tui.PageDiagnosticsCollector

namespace Pennington.Tui;

/// Per-URL snapshot of the most recent Diagnostics captured by TuiDiagnosticsCaptureMiddleware as the user navigates the site. Replaces the crawl-based BuildReport model — diagnostics fill in on demand as pages are rendered, not ahead of time.
public class PageDiagnosticsCollector
{
    /// Upsert the latest diagnostics snapshot for path.
    
public void Record(string path, DateTimeOffset at, ImmutableArray<Diagnostic> diagnostics);

    /// Snapshot of every page that's been visited, ordered so problems float to the top: errors first, then warnings, then info-only, then clean pages. Within a severity bucket, most recently captured first.
    
public IReadOnlyList<PageDiagnosticsEntry> Snapshot();
}