repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

test(quickshell): audit screenshot smoke contract

373ebe7e44590dbfddc3ea1bdbaf6babe453dd6f

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (3)

docs/super/inventory/2026-06-17-quickshell-self-contained-audit.md

Modified
17 17 - `MANIFEST.md` must list every direct file in `quickshell/nugu`; orphaned or stale manifest rows fail the audit.
18 18 - `SCRIPTS.md` must inventory every `*.sh` file; each script must be executable and start with `#!/bin/sh` plus `set -eu`.
19 19 - `live-check.sh` is executable and audited read-only: it must not link, start, stop, enable, disable, restart, or launch `qs -c nugu`.
20 -- `smoke.sh` is executable and audited for self-contained temp `HOME`/`XDG_CONFIG_HOME`, named config launch, launcher/clipboard/power/native-notification/OSD IPC probes, cleanup trap, and no live link/service mutation.
20 +- `smoke.sh` is executable and audited for self-contained temp `HOME`/`XDG_CONFIG_HOME`, named config launch, launcher/clipboard/power/native-notification/OSD IPC probes, optional cropped dark/light screenshot checks, cleanup trap, and no live link/service mutation.
21 21 - `gate.sh` is executable and audited as the read-only/self-contained verification chain: audit, unit verify, smoke, live-check, optional strict live-check.
22 22 - every QML component is listed in `COMPONENTS.md` with purpose and rollout status.
23 23 - every `nugu` IPC method from `shell.qml` is listed in `IPC.md` with purpose and rollout status.
81 81 live_check=ok
82 82 live_check_readonly=ok
83 83 smoke_contract=ok
84 +screenshot_smoke_contract=ok
84 85 gate_contract=ok
85 86 inventory_tables=ok
86 87 transition_bridges=2
122 123 live_check=ok
123 124 live_check_readonly=ok
124 125 smoke_contract=ok
126 +screenshot_smoke_contract=ok
125 127 gate_contract=ok
126 128 inventory_tables=ok
127 129 transition_bridges=2
146 148 WARN transitional external bridge still present: cliphist
147 149 WARN transitional external bridge still present: makoctl
148 150 gate_exit=0
151 +screenshot_smoke_exit=0
152 +screenshot_dark=/tmp/nugu-qs-theme-smoke.XltyXR/nugu-qs-dark.png 23123 bytes
153 +screenshot_light=/tmp/nugu-qs-theme-smoke.XltyXR/nugu-qs-light.png 21914 bytes
149 154 --- lingering qs ---
152 -The smoke runner now executes the audit before launching `qs -c nugu` with temporary `HOME` and `XDG_CONFIG_HOME`. It also opens/closes launcher and clipboard surfaces, verifies power confirmations stay dry-run, toggles the native notification loader only on the private smoke bus, and probes non-destructive OSD IPC. `gate.sh` now wraps audit, unit verification, smoke, and live readiness in one non-mutating command. The rollout runbook is audited as documentation only; it does not authorize live mutation.
157 +The smoke runner now executes the audit before launching `qs -c nugu` with temporary `HOME` and `XDG_CONFIG_HOME`. It also opens/closes launcher and clipboard surfaces, verifies power confirmations stay dry-run, toggles the native notification loader only on the private smoke bus, probes non-destructive OSD IPC, and can save cropped non-empty dark/light screenshots that must differ. `gate.sh` now wraps audit, unit verification, smoke, and live readiness in one non-mutating command. The rollout runbook is audited as documentation only; it does not authorize live mutation.
154 159 ## Boundary

quickshell/nugu/SCRIPTS.md

Modified
7 7 | Script | Purpose | Mutation boundary |
8 8 | --- | --- | --- |
9 9 | `audit.sh` | Static repository guard for inventories, QML self-containment, Nugu style, rollout contracts, and stale dependency rows. | Read-only; checks files and exits without touching live HOME, services, DBus, or Hypr state. |
10 -| `smoke.sh` | Named-config scaffold runner using temporary `HOME` and `XDG_CONFIG_HOME` to prove Quickshell surfaces and IPC load without live links. | May create and remove only its own temp directory and its own temporary `qs` process. |
10 +| `smoke.sh` | Named-config scaffold runner using temporary `HOME` and `XDG_CONFIG_HOME` to prove Quickshell surfaces, IPC, and optional cropped screenshots load without live links. | May create and remove only its own temp directory, optional screenshot output directory contents requested by the caller, and its own temporary `qs` process. |
11 11 | `live-check.sh` | Read-only live readiness reporter for links, services, DBus health, Hypr config errors, and old helper refs. | Reports blockers only; never starts, stops, enables, disables, links, reloads, or launches `qs -c nugu`. |
12 12 | `gate.sh` | One-command verification chain for audit, user unit verification, smoke, live readiness, and optional strict live readiness. | Delegates only to audited non-mutating/self-contained gates; never performs rollout actions itself. |

quickshell/nugu/audit.sh

Modified
49 49 "confirmPowerAction",
50 50 "enableNativeNotifications",
51 51 "osdSessionSuspendDryRun",
52 + "NUGU_QS_SMOKE_SCREENSHOT_DIR",
53 + "top-left scaffold region",
54 + "hyprctl monitors -j",
55 + "grim -g \"$geometry\"",
56 + "cmp -s",
57 + "dark and light screenshots are identical",
52 58 "hideAll",
53 59 "trap cleanup EXIT INT TERM",
54 60 "kill \"$qs_pid\"",
762 768 print("live_check=ok")
763 769 print("live_check_readonly=ok")
764 770 print("smoke_contract=ok")
771 +print("screenshot_smoke_contract=ok")
765 772 print("gate_contract=ok")
766 773 print("inventory_tables=ok")
767 774 print(f"transition_bridges={len(transition_rows)}")