Change evidence report

PR evidence reviewer interface refactor

PR 1979 turns the evidence archive into a compact review ledger and moves every standalone report onto the same restrained visual system. Report provenance now remains visible on desktop, mobile, and print. Before-and-after panels stay side by side until their content container requires stacking, while code and tables remain keyboard-scrollable without widening the page.

Range
9d8fdc955 (merge-base with main)…78ce06621 (captured implementation head)
Source state
feat/1946-evidence-ui at 78ce06621, pushed as draft PR #1979; this report is the following evidence-only commit
Generated

Reviewer brief

Outcome and scope

Reviewers reach the report content faster without losing context

The archive removes a single-purpose desktop sidebar and duplicated calls to action in favor of a dense, keyboard-aware report ledger. Standalone reports retain a useful section rail, move source metadata into the document itself, and share one stylesheet with the archive. The resulting pages keep strict CSP, deterministic static generation, dark and light schemes, narrow-screen navigation, and printable provenance.

What this report proves

Matched captures compare the same checked-in archive data and PR 1800 sample report at the 1440 by 1000 desktop viewport and the 390 by 844 mobile viewport. Live Chromium measurements cover navigation, overflow, responsive comparison layout, standalone styling, disclosure behavior, color schemes, and print output. The report does not prove the post-merge production promotion or replace CI and reviewer approval.

Claim map

Evidence coverage

Each material changed behavior or state maps to direct evidence or an explicit gap.

Behavior or claimEvidenceStatus
The archive is organized as a compact, scan-first report ledgerMatched 1440 by 1000 archive screenshots with the same seven reportsCovered
Standalone reports keep useful section navigation while provenance remains part of the documentMatched 1440 by 1000 PR 1800 report screenshots plus five rendered report factsCovered
Narrow reports retain identity, navigation, provenance, and reading width without page overflowMatched 390 by 844 PR 1800 screenshots and live width measurementsCovered
Tables and code preserve keyboard-controlled horizontal scrolling without clipping their containersFocusable overflow regions, preserved code width, and symmetric 25px table insets measured in ChromiumCovered
Standalone rendering, CSP, source escaping, and the publishing build remain compatibleFocused renderer tests, typecheck, report validation, and a production Vite buildCovered
The canonical evidence site is republished after mergeProduction promotion occurs only after this pull request merges and the release workflow succeedsGap

Observed change

Review evidence

Evidence is grouped by the reviewer question each item addresses.

Evidence archive

Screenshot

The archive becomes a quiet review ledger

Same seven checked-in reports at 1440 by 1000. The base spends a permanent rail on one destination and repeats each internal report target. The candidate uses a compact product header, one internal title link, one external pull request link, and flat rows optimized for date and title scanning.

Base: a permanent archive rail and stacked cards consume review width.Before
Base evidence archive with a left utility sidebar and stacked report cards
Candidate: a compact header and seven-row ledger keep reports visible above the fold.After
Refactored evidence archive with a compact header and dense report ledger

Desktop report

Screenshot

Report navigation stays useful while provenance joins the document

Same PR 1800 report at 1440 by 1000. The section rail remains, but repository, scope, revision range, source state, and publication time move into the report header so mobile and printed output retain them.

Base: report metadata is confined to the utility rail.Before
Base report with section links and all source metadata in a wide left sidebar
Candidate: the rail is reserved for navigation and provenance is visible in the report body.After
Refactored report with a compact section rail and source facts under the report summary

Mobile report

Screenshot

The narrow layout keeps identity and provenance in view

Same PR 1800 report at 390 by 844. Both versions retain sticky section navigation. The candidate adds a persistent PR identifier, keeps the full source facts in the document, and reserves horizontal scrolling for the controls and evidence that require it.

Base: source metadata disappears when the desktop rail condenses.Before
Base mobile report with a sticky product header and report content without visible source facts
Candidate: PR identity and source facts survive the narrow layout.After
Refactored mobile report with a sticky PR identifier, section links, and source facts

Live browser measurements

Table

The built static UI preserves navigation and overflow boundaries

Measurements came from the production Vite build served locally in Chromium.

ScenarioObserved result
Archive at 1440 by 10007 report rows, 7 internal report links, 7 external PR links, one loaded stylesheet, and no horizontal page overflow
Standalone PR 1903 report5 report facts, 4 state-labelled panels, 2 focusable tables, 3 focusable code regions, no external stylesheet, no unresolved marker, and no horizontal page overflow
PR 1903 at 390 by 844Document width equalled the 390px viewport; the comparison stacked to one 356px column; code retained 614px scroll width inside a 356px region; the 411px TOC scrolled inside 374px
Mobile evidence tableLeft and right insets both measured 25px and document width remained 390px after the independent review fix
Print emulationNavigation was hidden, report facts remained a grid, the first evidence block stayed with its section heading, later blocks paginated, and Chromium rendered a 462,739-byte A4 PDF

Confidence

Validation

Pass

Focused evidence tests

33 pass, 0 fail, 167 assertions across renderer, notifier, workflow, and archive tests

Pass

Evidence package typecheck

bun run --filter @sauna-crm/pr-evidence typecheck exited 0

Pass

Production evidence build

Vite 6.4.3 built the archive, shared stylesheet, and seven standalone report pages successfully

Pass

Desktop, mobile, color-scheme, and print checks

Live Chromium checks covered 1440 by 1000 and 390 by 844 layouts, dark and light schemes, navigation, disclosure state, overflow regions, container-query stacking, and A4 print output

Pass

Independent regression review

The reviewer found one clipped table-margin calculation. The corrected auto width produced symmetric 25px insets and the focused follow-up found no remaining material issue.

Limits

Known issues, risks, and gaps

One intentional interaction limit and one deployment boundary remain

Section links do not track scroll position Reports remain self-contained and script-free. Section links navigate correctly, but the current section is not highlighted while scrolling. Avoiding a client runtime preserves deterministic rendering and the restrictive Content Security Policy.

Production promotion follows merge This report proves the local production build and live browser behavior. The canonical evidence URL remains on the previously published UI until the pull request merges and the trusted release workflow promotes and byte-compares the new deployment.