Files
Chronos/tests/visual/baselines
Alby96andClaude Opus 5.5 a89ec10ebf
CI / Build and test (pull_request) Successful in 11m47s
CI / Windows tests and installer (pull_request) Skipped
CI / YAML check (pull_request) Successful in 12s
CI / PostgreSQL 16 integration (pull_request) Successful in 10m37s
CI / PostgreSQL 17 integration (pull_request) Successful in 9m56s
CI / Docker image (pull_request) Successful in 1m48s
fix(jobs): show job log times in local time and give the Type column room; 1.1.1
The Windows hands-on test of 1.1.0 found two things in Jobs. The log under a job showed UTC times (12:35) next to rows
in local time (13:35): the stored log keeps UTC, so a server's jobs read right anywhere, and the desktop now dates the
lines backwards from the job's end and shows them in local time. The Type column cut "Analisi approfondita" at a
0.7* share; a 1* share (90-170 px) fits it in a 1440 px window and still gives way at the 1200 px minimum.

Builds without a release tag say 1.1.1; CHANGELOG [1.1.1], STATUS and DECISIONS updated.

Refs #70

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 14:26:21 +01:00
..

Screenshot baselines

The approved look of every screen, one PNG per --capture screenshot (<screen>-<theme>.png, as Chronos.exe, Chronos.Uploader.exe and Chronos.Setup.exe --capture <dir> write them). CI compares each new screenshot with the file of the same name here (BRIEF §20.2, visual regression with a pixel-diff tolerance):

dotnet run --project src/Chronos.Tools -- screenshots diff out/screenshots --out out/screenshot-diff
  • A pixel differs when one of its channels moves by more than --tolerance (default 8 of 255); a screen fails when more than --max-diff of its pixels differ (default 0.0005, that is 0.05 %), when its size changed, or when a baseline here has no screenshot any more.
  • A screenshot without a baseline fails as soon as this folder holds any PNG: a pull request that adds a screen adds its baselines too.
  • While this folder holds no PNG nothing is compared: the step passes, with a warning in the log saying that no visual change can fail it.
  • out/screenshot-diff gets <screen>-diff.png for every screen with differing pixels (the baseline faded to grey, the differences magenta) and summary.md; they stay in the work folder of the Windows runner (Gitea Actions keeps no artifacts here), and the job log lists every screen that failed.

The pictures are reproducible

The capture runs on sample data whose clock stands at SampleData.Now (2026-10-02 10:18 UTC), in English with English formats and with animations off, so the same code draws the same pixels on any day. What the screens measure on the machine is shown as fixed sample values while the clock is frozen (AppClock): free space (1.2 TB), the server's response time (12 ms) and the time and duration of the last sync comparison. The capture's data folder is a new one in the machine's temporary folder, but the screens show it as a sample user's (C:\Users\Studio\AppData\Local\Chronos, its sample archive as D:\ChronosArchive: AppEnvironment.Shown; the videos folder is set to D:\Videos\Chronos), so neither the temporary folder nor the user name reaches a picture; a path typed over a shown one goes back to the temporary folder (AppEnvironment.Actual), so the capture writes nowhere else. Two captures made with different TEMP folders are identical. Two things still come from the machine: the time zone (times are shown in local time; the baselines are made in the development PC's, Europe/Rome, which the Windows runner must share) and the fonts and scaling of Windows itself.

Adding or updating baselines

Capture them on the development PC, the one where the Windows runner is registered (fonts, scaling and the time zone differ per machine), from a Release build of the branch that changes the screens:

dotnet build Chronos.slnx -c Release
src/Chronos.App/bin/Release/net10.0-windows/Chronos.exe --capture out/screenshots
src/Chronos.Uploader/bin/Release/net10.0-windows/Chronos.Uploader.exe --capture out/screenshots
src/Chronos.Setup/bin/Release/net10.0-windows/Chronos.Setup.exe --capture out/screenshots
dotnet run --project src/Chronos.Tools -- screenshots diff out/screenshots
dotnet run --project src/Chronos.Tools -- screenshots accept out/screenshots

screenshots accept <dir> copies every PNG of <dir> here. Commit only the screens whose change is intended, and delete the baseline of a screen that no longer exists. If the Windows runner is ever registered on another PC, accept a new set captured there in one commit.

The first baselines

The first set (156 screens) was captured on the development PC on 2026-11-04 (owner review 3, R2), at SampleData.Now, and is committed with the ports fix of v0.1.0-rc.9. Until a Windows runner is registered, CI skips the windows job and nothing compares them: run screenshots diff locally before a pull request that touches a screen.