Skip to main content

visual capture matrix

Per-feature visual capture of Tuna Desktop v1 from the frozen Wave 3 integration head. Every one of the 83 parity-ledger rows (docs/parity-ledger.md) and all 46 walkthrough entries (docs/walkthrough.tsv) maps below to the capture stage(s) that collect it, or to an explicit reason nested fixtures cannot show it. Checked by scripts/tuna-visual-capture --check-matrix in CI.

Frozen source​

  • Branch head: b1c929aa55b0f3286458035fbc81ecd62d168496 (#633 integration head).
  • PR #633 tested merge commit: 7b6c85922af14f4c239a4f958262b657adc6b03f. The two identities are distinct: per-run provenance.json pins the exact built tree from the checkout (built_head_sha, built_tree_sha) and records the event SHA separately as informational (never as the tested tree), and CI attempts are never merged into one capture session (audit provenance finding).
  • Capture tooling: scripts/tuna-visual-capture (stages) plus scripts/lib/tuna-visual-label.py (honest frame labels) and scripts/lib/tuna-visual-finalize.py (label-coupled verdicts); dispatchable workflow .github/workflows/visual-capture.yml.

Reading this matrix​

Status vocabulary (no whole-feature visual qualification is claimed anywhere in this document; the audit's 16 "observed subset" rows stay open until the gaps below close):

  • nested — stills of this state come from the named nested stage.
  • clip — a real x11grab transition clip (or timestamped still pair where recording is unavailable) comes from the named stage.
  • partial — nested capture shows a subset only; the gap column says what is still unproven.
  • nonvisual — behavior with no pixels of its own; evidence is consumer output or CI logs, not frames.
  • unsupported-in-nested — the state needs hardware, the installed image, or real services; see docs/visual-capture-corral-request.md.
  • missing-product — the behavior is unimplemented at this head, so there is nothing truthful to capture yet.
  • unproven — drivable in nested fixtures but no adequate capture reviewed yet (neither audit nor new stages cover it).

Audit column: the 2026-10-12 visual audit's verdict per row (Observed subset, No adequate capture, FAIL, or Transition clip required). Tour frames whose title cards still say Roost on TunaOS Marlin are labeled as observed and never presented as Tuna feature proof.

A capture failure is reported as a capture failure. A still labeled indistinguishable-from-baseline (or a missing still) does not assert the product is broken: the audit's still-vs-video finding (a wrong tour still beside a 28 s clip that does show quick settings) is why every state records its state observation next to its stills and clips.

Stages​

StageLedger rowsWalkthrough states
stage:panelP-PN-01, P-TR-01walkthrough:panel, walkthrough:tray
stage:calendarP-PN-02, P-NT-02walkthrough:calendar, walkthrough:notification-list
stage:quick-settingsP-PN-03, P-SY-07, P-ST-01walkthrough:quick-settings, walkthrough:wifi-menu, walkthrough:network-agent, walkthrough:wired-menu, walkthrough:bluetooth-menu, walkthrough:microphone, walkthrough:power-menu, walkthrough:osd-volume, walkthrough:osd-brightness
stage:windowsP-WM-02, P-WM-04, P-WM-05, P-WM-06walkthrough:windows, walkthrough:popover, walkthrough:tile-preview, walkthrough:window-menu
stage:x11P-SY-04walkthrough:x11
stage:scrollP-WM-07walkthrough:scroll-strip, walkthrough:scroll-follow, walkthrough:scroll-presets
stage:switcherP-WM-01walkthrough:switcher, walkthrough:switcher-thumbnails
stage:overviewP-OV-01, P-OV-02, P-OV-03, P-OV-06, P-WM-03walkthrough:overview, walkthrough:workspaces, walkthrough:overview-drag, walkthrough:workspace-popup
stage:search-appsP-OV-04, P-OV-05walkthrough:search, walkthrough:search-provider, walkthrough:app-grid, walkthrough:app-folder, walkthrough:app-grid-pages, walkthrough:folder-made, walkthrough:grid-reorder
stage:notificationsP-NT-01, P-NT-02walkthrough:banner, walkthrough:notification-list, walkthrough:do-not-disturb, walkthrough:notification-group, walkthrough:notification-group-expanded
stage:inputP-IN-01walkthrough:ime, walkthrough:ime-candidates
stage:systemP-SY-05, P-SY-07, P-LK-01, P-SY-03walkthrough:screenshot-ui, walkthrough:polkit, walkthrough:end-session, walkthrough:lock, walkthrough:unlock, walkthrough:scale
stage:settings-a11yP-ST-01, P-ST-08, P-A11Y-05, P-A11Y-07, P-AN-01(no walkthrough states; newer capabilities)
stage:transitionsP-AN-01, P-AN-02, P-AN-04, P-AN-05, P-AN-07, P-AN-09(clips; no walkthrough states)

Parity rows​

IDCapabilityCaptureAuditNested states / gap
P-OV-01Overview with live window previewsstage:overview nested + stage:transitions clipObserved subsetopen still + open/close clips; multi-output and focus variants open
P-OV-02Workspace strip; drag or click switchesstage:overview nestedNo adequate captureworkspaces + drag stills; click-switch and multi-workspace strips open
P-OV-03Dash with favorites and running appsstage:overview nestedObserved subsetdash visible in overview stills; favorites/running-dot variants open
P-OV-04Overview search, Enter launches top hitstage:search-apps nestedObserved subsetsearch + provider stills; launch moment unproven
P-OV-05App grid with pages and foldersstage:search-apps nestedFAIL (drag-cancel layout)grid/folder/pages/made/reorder stills plus peek + settled post-cancel frames and saved-layout diff; order persistence after cancel stays under review
P-OV-06Escape restores previously focused windowstage:transitions partialNo adequate capturesettled post-Escape stills only; no dedicated focus-restore frame
P-PN-01Top panelstage:panel nestedObserved subsetdesktop + panel stills; per-output panels need Corral
P-PN-02Clock opens calendar plus notification liststage:calendar nestedObserved subsetmenu + with-notification stills; event-launch and prefs variants open
P-NT-01Notification bannersstage:notifications nestedNo adequate capturebanner still; actions/dismissal/error variants open
P-NT-02Do Not Disturb and historystage:notifications nested + stage:calendar nestedNo adequate capturelist/DND/group/expanded stills; lock-screen privacy needs Corral (P-NT-03)
P-PN-03Quick settings gridstage:quick-settings nestedNo adequate capturegrid, wifi/wired/bt menus, agent dialog, mic, OSDs, power menu; absent-daemon and error variants open
P-WM-01Alt-Tab switcherstage:switcher nested + stage:transitions clipObserved subsetpopup + thumbnails stills + fade clip; keyboard-focus and overflow variants open
P-WM-02Maximize and half tilingstage:windows nested + stage:transitions clipObserved subsetmaximized/tiled stills + size-change clip
P-WM-03Dynamic workspaces and switchingstage:overview nested + stage:transitions clipNo adequate capturepopup + slide clip; Shift-move-window visuals open
P-WM-04Drag-to-move and resizestage:windows partialObserved subsettile-preview drag captured; explicit resize visuals unproven
P-WM-06App menus and popoversstage:windows nestedObserved subsetpopover still; outside-click dismissal unproven
P-WM-05Close, minimize, maximize decorationsstage:windows partialObserved subsetwindows + window-menu stills; minimize has no transition (see P-AN-03)
P-WM-07Scrollable tiling stripstage:scroll nestedObserved subsetstrip/follow/preset stills; wheel and multi-output strips open
P-LK-01Idle lock, password unlock, no leaksstage:system nestedObserved subsetlock/prompt/unlock stills; leak-across-transitions needs Corral
P-SY-01Session starts from the display managerunsupported-in-nestedObserved subsetDRM/KMS, GDM login, PAM/logout on hardware need Corral
P-SY-02Multi-monitor and hotplugunsupported-in-nestedNo adequate capturesingle nested output only; per-output panel/hotplug need Corral
P-SY-03Fractional scaling and mixed DPIstage:system partialNo adequate capture125% live-scale still; 150/200% and mixed-DPI hardware need Corral
P-SY-04XWayland apps by defaultstage:x11 nestedNo adequate captureX11 app still; physical GPU/VT needs Corral
P-SY-06Mutter protocols advertisednonvisualNo adequate captureno pixels; wayland-info consumer output lives in CI logs
P-SY-07End session dialogstage:quick-settings nested + stage:system nestedNo adequate capturepower menu + dialog stills; real suspend/restart/power-off need Corral
P-SY-05Portals capture and sharingstage:system partialNo adequate capturescreenshot-UI still; casts, recordings, consent UI need Corral + CI artifacts
P-A11Y-01Screen reader sees shell surfacesnonvisualNo adequate captureAT-SPI dumps ship in every stage artifact; spoken Orca is P-A11Y-06's speech proof
P-A11Y-02Keyboard equivalent for every pointer actionnonvisualNo adequate capturekeymap/journey behavior; no dedicated visual
P-IN-01IME composition in GTK appsstage:input nestedNo adequate capturepreedit + candidates stills; surrounding-text/cursor-move visuals open
P-IN-02Touchpad gesturesunsupported-in-nestedNo adequate capturephysical touchpad/libinput run needs Corral
P-ST-01GNOME Settings take effectstage:settings-a11y nested + stage:quick-settings nestedObserved subsetdark/clock/wallpaper/OSD stills; fonts, input, idle journeys in CI proofs
P-TR-01AppIndicator tray itemsstage:panel nestedObserved subsettray-menu still; icon-only and error variants open
P-WM-08Multitasking preferencesmissing-productNo adequate captureno consumer for fixed count/primary-only/tiling preference; nothing truthful to capture
P-WM-09Full WM shortcut list and focus policyunprovenNo adequate captureworking accelerators have no dedicated stills; unregistered keys unimplemented
P-SY-08Session save and restoreunprovenNo adequate capturexdg-session-management restores session windows across a nested compositor restart (G-SESSION-RESTORE checks geometry and workspace from compositor state, no stills); installed logout/reboot capture needs Corral
P-SY-09Remaining Mutter protocols and versionsnonvisualNo adequate captureno pixels; consumer output lives in CI logs
P-SY-10Screenshot-UI keyboard selectionstage:system partialNo adequate captureUI chrome captured; arrow/Alt/Shift/Ctrl/R selection visuals unproven
P-DS-01Night Lightstage:quick-settings partialNo adequate capturetile captured; no temperature transform exists to show (missing-product for the effect)
P-DS-02Modes, refresh, rotation, mirroringstage:system partialNo adequate capturescale/position captured; rotation/mirroring rejected and modes ignored, so Corral only after implementation
P-DS-03Colour management, HDRmissing-productNo adequate capturesRGB-only renderer; no profiles or HDR to show
P-DS-04Touchscreens and orientationmissing-productNo adequate captureno touch mapping or orientation lock consumer; Corral after implementation
P-IN-03Cursor themes, shapes, locate-pointermissing-productNo adequate capturecompositor draws a default arrow only; cursor lane owns the product work
P-IN-04Mouse/touchpad/stick settingsnonvisualNo adequate capturelibinput policy has no pixels; behavior in CI proofs
P-IN-05Graphics tablets and Wacom settingsmissing-productNo adequate capturetablet protocol and routing absent
P-IN-06Input-source policy, Num Lock, custom shortcutsnonvisualNo adequate capturelive sources/repeat in CI proofs; per-window/NumLock/custom keys have no consumer
P-NT-03Per-app notification prefs, lock privacymissing-productNo adequate captureglobal banners/DND captured under P-NT-02; per-app and lock-screen keys have no consumer
P-A11Y-03Magnifier and on-screen keyboardmissing-productNo adequate capturemagnifier applies to captures only (no live on-screen zoom); OSK keys ignored
P-A11Y-04Sticky/slow/bounce keys, Mouse Keys, dwellmissing-productNo adequate captureseat-level input policy absent
P-A11Y-05Reduced motion, focus visibility, a11y menustage:settings-a11y partialNo adequate capturea11y indicator/menu still; motion-preference transition variants unproven
P-A11Y-06Orca activation and spoken navigationnonvisualNo adequate capturespeech has no pixels; the nested speech proof (G-ORCA-SPEECH-*) logs what Orca says, activation on hardware is V-ORCA-ACTIVATION
P-A11Y-07Simulated secondary and hover click, click-type chooserstage:settings-a11y partialNo adequate capturedwell-chooser collects the real hover-click chooser; pie-timer intermediate frames and native pointer input remain outside these stills
P-SN-01Sound prefs, over-amplification, bellstage:quick-settings partialNo adequate capturevolume OSD captured; overdrive/feedback/audible-visual bell unproven
P-ST-02Wellbeing, screen time, breaksmissing-productNo adequate captureno consumer and no history file
P-ST-03Power panel and policiesstage:quick-settings partialNo adequate capturelogind backlight/OSD captured; Brightness interface and PowerSaveMode need installed-image Corral
P-ST-04Privacy device controlsmissing-productNo adequate capturecamera/mic/output/privacy-screen/USB keys have no consumer
P-ST-05Administrative lockdownmissing-productNo adequate captureno lockdown consumer
P-ST-06Remote desktop and RDP flowsunsupported-in-nestedNo adequate captureportal input nonvisual in CI; RDP sharing/control/login need Corral
P-ST-07Date/time, NTP, time zone on imageunsupported-in-nestedNo adequate captureweek-start visuals in CI proofs; timedate1/NTP/Geoclue need installed-image Corral
P-ST-08Background modes, shading, slideshowsstage:settings-a11y partialNo adequate capturestatic wallpaper captured; placement/shading/XML pixels are CI portal proofs (run 38878636595) and a 2026-10-30 Corral VM run with main sideloaded; no paired GNOME or multi-output capture
P-ST-09Apps panel: permissions, defaults, mediaunsupported-in-nestedNo adequate captureApps-panel journeys need installed-image Corral
P-ST-10Service-backed Settings panels on imageunsupported-in-nestedNo adequate capturenetwork/BT/accounts/printers/sharing/users/region/updates need installed-image Corral item-by-item
P-ST-11Legacy/app-owned settings classifiednonvisualNo adequate captureinventory disposition, checked by scripts/tuna-settings-inventory-check
P-LK-02Fingerprint, smartcard, multi-step loginmissing-productNo adequate captureone password entry only; distinct challenges need product work plus Corral hardware
P-AN-01Motion preferencesstage:transitions partialTransition clip requiredfull-speed clips captured; animations-off/reduced-motion/slowdown variants unproven
P-AN-02Window open/close animationsstage:transitions partialTransition clip requiredoverview/size clips captured; map/destroy/dialog intermediate frames unproven
P-AN-03Minimize toward dash iconmissing-productTransition clip requiredhide/restore is instant; no transition exists to film
P-AN-04Maximize/tile/fullscreen crossfadestage:transitions clipTransition clip requiredmaximize clip + settled stills; fullscreen and paired GNOME frames open
P-AN-05Workspace slide, swipe, popup, dotsstage:transitions clip + stage:overview nestedTransition clip requiredslide clip + popup stills; swipe/popup-fade/dots transitions unproven
P-AN-06Modal dialog parent dimunprovenTransition clip requiredno modal-dialog capture state; intermediate frames unproven
P-AN-07Overview transitionsstage:transitions clipTransition clip requiredopen/close + grid-morph clips; gesture/hover/thumbnail/drag/search/dash/panel transitions unproven
P-AN-08App grid animationsunprovenTransition clip requiredfolder zoom, launch zoom, page switch, page dots and arrows implemented and trace-gated (G-FOLDER-ZOOM, G-LAUNCH-ZOOM, G-GRID-PAGE-ANIM); no capture state or transition clip yet
P-AN-09Menu, OSD, banner, switcher transitionsstage:transitions clip + stage:notifications nestedTransition clip requiredswitcher-fade clip + banner stills; popover/submenu/OSD/banner/modal transitions unproven
P-AN-10Lock, flash, wallpaper, ripple transitionsstage:system partialTransition clip requiredlock stills only; curtain/flash/crossfade/ripple/startup transitions unproven
P-SY-11Clipboard kept after the copying app closesnonvisualNo adequate capturepasted bytes are checked by socketpair clients (tests/data_device.rs); a real-app journey needs installed-image Corral
P-WM-10Server-side frames on X11 windowsmissing-productNo adequate captureX11 windows map bare (walkthrough:x11); no frame exists to capture
P-WM-11"Not responding" dialogunprovenNo adequate capturedialog implemented; no capture state with a hung client yet
P-PN-04World Clocks and Weather in the calendarmissing-productNo adequate capturecalendar popover has neither section
P-NT-04Media players in the notification listmissing-productNo adequate captureno media section on main; lock-screen and calendar media are in open PRs
P-PN-05Airplane Mode and keyboard backlight togglesunprovenNo adequate capturetiles implemented; need gsd-rfkill and a keyboard backlight (fixture or hardware) to show
P-SY-12Switch Userunsupported-in-nestedNo adequate capturerow exists on hardware sessions only; needs GDM and two accounts on an installed image
P-SY-13InputCapture portal backendnonvisualNo adequate captureD-Bus and EIS behaviour; capture is wired on the DRM input path only
P-SY-14Thunderbolt authorisation noticesunsupported-in-nestedNo adequate captureneeds boltd and a Thunderbolt device or an emulated one (ADR 0008)
P-ST-12Captive-portal sign-inunprovenNo adequate capturenotification and helper launch need NetworkManager reporting a portal

Walkthrough states​

IDRequired proof frameCaptureAudit
walkthrough:panel01-panel.pngstage:panel nestedObserved subset
walkthrough:calendar02-calendar.pngstage:calendar nestedObserved subset
walkthrough:tray03b-tray-menu.pngstage:panel nestedObserved subset
walkthrough:quick-settings15-quick-settings-services.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:wifi-menu15b-wifi-menu.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:network-agent15d-network-agent.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:wired-menu15e-wired-menu.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:bluetooth-menu15c-bluetooth-menu.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:microphone16b-microphone.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:power-menu21-power-menu.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:osd-volume24b-osd.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:osd-brightness24c-brightness-osd.pngstage:quick-settings nestedMissing from GTK artifact
walkthrough:windows04-windows.pngstage:windows nestedObserved subset
walkthrough:popover07-app-popover.pngstage:windows nestedObserved subset
walkthrough:tile-preview08-tile-preview.pngstage:windows nestedObserved subset
walkthrough:window-menu24d-window-menu.pngstage:windows nestedMissing from GTK artifact
walkthrough:x1120-x11-app.pngstage:x11 nestedMissing from GTK artifact
walkthrough:scroll-strip24j-scroll-strip.pngstage:scroll nestedMissing from GTK artifact
walkthrough:scroll-follow24k-scroll-follow.pngstage:scroll nestedMissing from GTK artifact
walkthrough:scroll-presets24k-scroll-preset.pngstage:scroll nestedMissing from GTK artifact
walkthrough:switcher08b-switcher.pngstage:switcher nestedObserved subset
walkthrough:switcher-thumbnails08c-switcher-thumbnails.pngstage:switcher nestedObserved subset
walkthrough:overview05-overview.pngstage:overview nestedObserved subset
walkthrough:workspaces24g-workspace-thumbnails.pngstage:overview nestedMissing from GTK artifact
walkthrough:overview-drag24h-overview-drag.pngstage:overview nestedMissing from GTK artifact
walkthrough:workspace-popup24f-workspace-popup.pngstage:overview nestedMissing from GTK artifact
walkthrough:search10-search.pngstage:search-apps nestedObserved subset
walkthrough:search-provider10b-search-provider.pngstage:search-apps nestedMissing from GTK artifact
walkthrough:app-grid11-app-grid.pngstage:search-apps nestedMissing from GTK artifact
walkthrough:app-folder11b-app-folder.pngstage:search-apps nestedMissing from GTK artifact
walkthrough:app-grid-pages11c-app-grid-pages.pngstage:search-apps nestedObserved subset
walkthrough:folder-made11f-folder-dialog.pngstage:search-apps nestedMissing from GTK artifact
walkthrough:grid-reorder11g-grid-reordered.pngstage:search-apps nestedMissing from GTK artifact
walkthrough:banner12-banner.pngstage:notifications nestedMissing from GTK artifact
walkthrough:notification-list13-notification-list.pngstage:notifications nested + stage:calendar nestedMissing from GTK artifact
walkthrough:do-not-disturb14-dnd-list.pngstage:notifications nestedMissing from GTK artifact
walkthrough:notification-group14b-notification-group.pngstage:notifications nestedMissing from GTK artifact
walkthrough:notification-group-expanded14c-notification-group-expanded.pngstage:notifications nestedMissing from GTK artifact
walkthrough:ime24i-ime-preedit.pngstage:input nestedMissing from GTK artifact
walkthrough:ime-candidates24j-ime-candidates.pngstage:input nestedMissing from GTK artifact
walkthrough:screenshot-ui24e-screenshot-ui.pngstage:system nestedMissing from GTK artifact
walkthrough:polkit24g-polkit.pngstage:system nestedMissing from GTK artifact
walkthrough:end-session22-end-session.pngstage:system nestedMissing from GTK artifact
walkthrough:lock23-locked-after-suspend.pngstage:system nestedMissing from GTK artifact
walkthrough:unlock24-unlock-prompt.pngstage:system nestedMissing from GTK artifact
walkthrough:scale24-scale-125.pngstage:system nestedMissing from GTK artifact

Newer capabilities​

Settings, accessibility, privacy, Night Light, session restore, rotation, printing, network locations and fingerprint login, mapped to their ledger rows above:

  • settings: P-ST-01 (stage:settings-a11y + stage:quick-settings, partial), P-ST-03 (partial), P-ST-07/P-ST-09/P-ST-10 (unsupported-in-nested, installed image), P-ST-08 (partial), P-ST-11 (nonvisual).
  • a11y: P-A11Y-01/P-A11Y-06 (nonvisual), P-A11Y-05 (partial), P-A11Y-03/P-A11Y-04 (missing-product).
  • privacy: P-ST-04 (missing-product), P-NT-03 (missing-product).
  • nightlight: P-DS-01 (tile nested, transform missing-product).
  • session restore: P-SY-08 (unproven).
  • rotation: P-DS-02 (rejected, partial for scale/position), P-DS-04 (missing-product).
  • print: P-ST-10 (unsupported-in-nested, printers panel on image).
  • netloc: P-ST-10 (unsupported-in-nested, network locations and sharing panels on image).
  • fprint: P-LK-02 (missing-product).

Walkthrough freshness​

The checked-in docs/walkthrough/ images predate this pipeline and are STALE until a refresh lands; scripts/tuna-walkthrough freshness reports all 46 as such (exit 1) when no per-frame manifest exists, and the visual-capture workflow's manifest job prints that report on every run as a visible, non-gating step. CURRENT requires the bytes to match the recorded capture hash AND the recorded built tree to equal the expected identity for the reviewed head (explicit --expect-* flags, defaulting to the checkout); self-consistent but different-source manifests read STALE, except for adopt drift (trees differing only in the walkthrough's own paths). scripts/tuna-walkthrough refresh rebuilds images ONLY from exact successful artifacts (pinned run id, one attempt, all consumed stages ok, one built tree, hash-validated inputs, proven frames with preserved labels, baseline only for the desktop state), writing walkthrough/manifest.json with each frame's hash, capture outcome and source IDs (built head/tree, event SHA, branch, package/image IDs, run id, attempt). Map: docs/walkthrough-visual.tsv. Procedure and exact commands: docs/visual-capture-refresh.md. No refresh has been performed from any run yet. Behavioral coverage for the new subcommands lives in scripts/lib/tuna-walkthrough-freshness-tests.py (run by the visual-capture build job, not by any existing gate). The existing tuna-walkthrough check (markdown + existence) is unchanged.

Per-state validators and verdict coupling​

Generic screening ("differs from the desktop", "stage exited ok") is not named-state proof: every capture state declares a consumer+render validator (require_jq, require_cstate, require_frame_differs, require_nonempty_file, require_absent) that fails the state when the expected content did not render, and scripts/lib/tuna-visual-validators-tests.py fails if any driven state lacks one. As a second layer, scripts/lib/tuna-visual-finalize.py demotes any non-exempt state whose stills hold no feature frame (wallpaper-only, duplicates, or unverified) to failed, however its drive commands exited. Exemptions: panel/desktop (the desktop is the baseline), settings-a11y/clock (sub-threshold seconds digits; settings-key validated), and transitions/* (clip-led; gated by clips plus compositor end-states). Partial stages stay collectable (collector green) but are exposed per-state in stage.json, the merged manifest.json summary counts, and the CI merge report -- and refresh refuses them by name. Labeling and finalize behavior are covered by scripts/lib/tuna-visual-label-tests.py and scripts/lib/tuna-visual-finalize-tests.py; provenance pinning by scripts/lib/tuna-visual-provenance-tests.py.

Provenance identity​

Per-stage provenance.json pins the exact built tree from the checkout itself (built_head_sha, built_tree_sha, tree_diff_sha256); the triggering event's commit (event_sha, e.g. the PR merge ref) is recorded separately as informational and is never presented as the tested tree. Refresh validates a passed --merge-sha against every consumed provenance and fails closed on mismatch.

Known-blocker coverage​

  • The tour's T-app-grid, T-calendar, T-quick-settings (wallpaper only) and T-overview (dash without overview card) are replaced by state-confirmed nested captures: every still ships with its a11y or compositor-state observation, and the labeler marks any wallpaper-only frame indistinguishable-from-baseline instead of presenting it as proof.
  • The GTK proof's G-GRID-DRAG-CANCEL saved-layout failure aborts the monolithic proof and leaves later walkthrough states absent. The stage:search-apps drag-cancel state captures the same drag (peek frame, settled post-cancel frame, before/after app-picker-layout) inside try/continue isolation: its outcome can never block the other seven search-apps states, the other thirteen stages, or the merged manifest.