repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

test(quickshell): smoke app replacement surfaces

f8acc330f37664172a05231d47c3984f574d7d60

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (6)

docs/super/inventory/2026-06-17-quickshell-scaffold-smoke-runner-verification.md

Modified
20 20 - initial `scaffoldState`
21 21 - diagnostics + bar visible after IPC
22 -- light mode switch
23 -- `reloadTheme` returns to live cached dark mode
22 +- dark/light/auto theme mode, mode-file watch, preview hold, token values
23 +- launcher open/visible/close IPC
24 +- clipboard picker open/visible/close IPC while storage remains `cliphist`
25 +- power menu open/visible plus dry-run confirmations for sleep/logout/reboot/poweroff
26 +- native notification loader enable/count/disable on the private smoke bus
27 +- OSD text/volume/brightness and suspend dry-run IPC
24 28 - `hideAll` closes Quickshell-owned surfaces
25 29 - `Configuration Loaded` appears
26 30 - common QML error patterns do not appear
45 49 ```text
46 50 PASS nugu quickshell scaffold smoke
47 -initial={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
48 -open={"theme":"light","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
49 -after_reload=dark
50 -hidden={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
51 +launcher_open={"theme":"dark","themeSource":"auto","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":true,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
52 +launcher_closed={"theme":"dark","themeSource":"auto","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
53 +clipboard_open={"theme":"dark","themeSource":"auto","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":true,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
54 +clipboard_closed={"theme":"dark","themeSource":"auto","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
55 +power_results= sleep=dry-run sleep logout=dry-run logout reboot=dry-run reboot poweroff=dry-run poweroff
56 +native_count=0
57 +osd_state={"theme":"dark","themeSource":"auto","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"Suspending","lastPower":"dry-run sleep"}
58 +hidden={"theme":"dark","themeSource":"auto","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"Suspending","lastPower":"dry-run sleep"}
51 59 smoke_exit=0
52 60 pgrep -a qs: empty

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

Modified
15 15 - required named-config files are present: `shell.qml`, `Theme.qml`, `nugu.json`, `README.md`, `COMPONENTS.md`, `IPC.md`, `EXTERNALS.md`, `TRANSITIONS.md`, `SERVICE.md`, `PARITY.md`, `HYPR_MIGRATION.md`, `audit.sh`, `smoke.sh`, `live-check.sh`.
16 16 - `README.md` links the required inventories, service/parity contracts, smoke/audit/live-check gates, named config command, and IPC command form.
17 17 - `live-check.sh` is executable and audited read-only: it must not link, start, stop, enable, disable, restart, or launch `qs -c nugu`.
18 -- `smoke.sh` is executable and audited for self-contained temp `HOME`/`XDG_CONFIG_HOME`, named config launch, cleanup trap, and no live link/service mutation.
18 +- `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.
19 19 - every QML component is listed in `COMPONENTS.md` with purpose and rollout status.
20 20 - every `nugu` IPC method from `shell.qml` is listed in `IPC.md` with purpose and rollout status.
21 21 - component, IPC, and external inventory rows reject duplicates, malformed names, thin text, and placeholder wording.
118 118 --- lingering qs ---
121 -The smoke runner now executes the audit before launching `qs -c nugu` with temporary `HOME` and `XDG_CONFIG_HOME`.
121 +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.
123 123 ## Boundary

quickshell/nugu/IPC.md

Modified
27 27 | `themeState` | Return mode/source plus key loaded Nugu tokens. | Token smoke verified. |
28 28 | `scaffoldState` | Return one compact JSON snapshot for smoke tests. | Smoke verified. |
29 29 | `hideAll` | Close Quickshell surfaces and disable gated native notifications. | Smoke verified. |
30 -| `enableNativeNotifications` | Opt in to native notification daemon while Mako is stopped. | Implemented; DBus parity blocked. |
31 -| `disableNativeNotifications` | Disable native notification daemon for rollback. | Implemented; rollback path pending live DBus. |
32 -| `nativeNotificationCount` | Report tracked native notification count. | Implemented; DBus parity blocked. |
30 +| `enableNativeNotifications` | Opt in to native notification daemon while Mako is stopped. | Private-bus smoke verified; live DBus parity blocked. |
31 +| `disableNativeNotifications` | Disable native notification daemon for rollback. | Private-bus smoke verified; rollback path pending live DBus. |
32 +| `nativeNotificationCount` | Report tracked native notification count. | Private-bus smoke verified empty; live DBus parity blocked. |
33 33 | `dismissNativeNotifications` | Dismiss all native notification toasts. | Implemented; DBus parity blocked. |
34 34 | `restoreNativeNotification` | Restore last native notification. | Implemented; DBus parity blocked. |
35 35 | `showOsd` | Show arbitrary OSD text with a semantic tone. | Scaffold verified. |

quickshell/nugu/README.md

Modified
52 52 The smoke runner creates a temporary `HOME` and `XDG_CONFIG_HOME`, symlinks only
53 53 this config as `quickshell/nugu`, runs the audit, starts `qs -c nugu`, checks
54 -Diagnostics/bar/theme/hideAll IPC, and cleans up its own `qs` process. When
55 -`NUGU_QS_SMOKE_SCREENSHOT_DIR` is set it saves cropped, non-empty dark/light
54 +Diagnostics/bar/theme/hideAll IPC, opens and closes launcher/clipboard/power
55 +surfaces, confirms non-lock power actions stay dry-run, toggles the native
56 +notification loader on the private bus, probes OSD IPC, and cleans up its own
57 +`qs` process. When `NUGU_QS_SMOKE_SCREENSHOT_DIR` is set it saves cropped, non-empty dark/light
56 58 scaffold screenshots from the focused monitor and fails if they are identical;
57 59 the crop is limited to the top-left rollout region to avoid full-desktop leakage.

quickshell/nugu/audit.sh

Modified
40 40 "ln -s \"$config_dir\" \"$tmp/quickshell/nugu\"",
41 41 "qs -c nugu",
42 42 "qs ipc -c nugu call nugu",
43 + "openLauncher",
44 + "openClipboardPicker",
45 + "openPowerMenu",
46 + "confirmPowerAction",
47 + "enableNativeNotifications",
48 + "osdSessionSuspendDryRun",
43 49 "hideAll",
44 50 "trap cleanup EXIT INT TERM",
45 51 "kill \"$qs_pid\"",

quickshell/nugu/smoke.sh

Modified
215 215 assert_contains "$mode_after_auto_return" 'dark' theme-auto-return-dark
216 216 assert_theme_state dark auto "$theme_auto_return_state" auto-return-theme-state
218 +# Exercise future companion surfaces through IPC while still isolated from live
219 +# Hypr binds. These checks prove the named config exposes the app replacement
220 +# doors that later make hypr/modules/*.lua smaller.
221 +launcher_open=$(ipc openLauncher "")
222 +state_launcher_open=$(ipc scaffoldState)
223 +launcher_visible=$(ipc launcherVisible)
224 +assert_contains "$state_launcher_open" '"launcher":true' launcher-open-state
225 +assert_contains "$launcher_visible" 'true' launcher-visible
226 +ipc closeLauncher >/dev/null
227 +state_launcher_closed=$(ipc scaffoldState)
228 +assert_contains "$state_launcher_closed" '"launcher":false' launcher-closed-state
230 +clipboard_open=$(ipc openClipboardPicker "")
231 +state_clipboard_open=$(ipc scaffoldState)
232 +clipboard_visible=$(ipc clipboardPickerVisible)
233 +assert_contains "$state_clipboard_open" '"clipboardPicker":true' clipboard-open-state
234 +assert_contains "$clipboard_visible" 'true' clipboard-visible
235 +ipc closeClipboardPicker >/dev/null
236 +state_clipboard_closed=$(ipc scaffoldState)
237 +assert_contains "$state_clipboard_closed" '"clipboardPicker":false' clipboard-closed-state
239 +power_open=$(ipc openPowerMenu)
240 +state_power_open=$(ipc scaffoldState)
241 +power_visible=$(ipc powerMenuVisible)
242 +assert_contains "$power_open" 'open' power-open
243 +assert_contains "$state_power_open" '"powerMenu":true' power-open-state
244 +assert_contains "$power_visible" 'true' power-visible
245 +power_results=
246 +for action in sleep logout reboot poweroff; do
247 + requested=$(ipc requestPowerAction "$action")
248 + pending=$(ipc pendingPowerAction)
249 + result=$(ipc confirmPowerAction)
250 + state_power_after=$(ipc scaffoldState)
251 + assert_contains "$requested" "$action" power-request-$action
252 + assert_contains "$pending" "$action" power-pending-$action
253 + assert_contains "$result" "dry-run $action" power-result-$action
254 + assert_contains "$state_power_after" '"powerMenu":false' power-after-$action
255 + assert_contains "$state_power_after" '"pendingPower":""' power-after-$action
256 + power_results="$power_results $action=$result"
257 +done
259 +native_enable=$(ipc enableNativeNotifications)
260 +state_native_enabled=$(ipc scaffoldState)
261 +native_count=$(ipc nativeNotificationCount)
262 +native_disable=$(ipc disableNativeNotifications)
263 +state_native_disabled=$(ipc scaffoldState)
264 +assert_contains "$native_enable" 'enabled' native-enable
265 +assert_contains "$state_native_enabled" '"nativeNotifications":true' native-enabled-state
266 +assert_contains "$native_count" '0' native-count
267 +assert_contains "$native_disable" 'disabled' native-disable
268 +assert_contains "$state_native_disabled" '"nativeNotifications":false' native-disabled-state
270 +osd_text=$(ipc showOsd "Smoke OSD" "debug")
271 +volume_osd=$(ipc showVolumeOsd "42%")
272 +brightness_osd=$(ipc showBrightnessOsd "73%")
273 +suspend_osd=$(ipc osdSessionSuspendDryRun)
274 +state_after_osd=$(ipc scaffoldState)
275 +assert_contains "$osd_text" 'Smoke OSD' osd-text
276 +assert_contains "$volume_osd" 'Volume 42%' volume-osd
277 +assert_contains "$brightness_osd" 'Brightness 73%' brightness-osd
278 +assert_contains "$suspend_osd" 'Suspending' suspend-osd
279 +assert_contains "$state_after_osd" '"lastOsd":"Suspending"' osd-state
280 +assert_contains "$state_after_osd" '"lastPower":"dry-run sleep"' osd-power-state
218 282 ipc hideAll >/dev/null
219 283 state_hidden=$(ipc scaffoldState)
220 284 assert_contains "$state_hidden" '"themeSource":"auto"' hidden-state
255 319 printf 'auto_return=%s\n' "$mode_auto_return"
256 320 printf 'after_auto_return=%s\n' "$mode_after_auto_return"
257 321 printf 'auto_return_theme_state=%s\n' "$theme_auto_return_state"
322 +printf 'launcher_open=%s\n' "$state_launcher_open"
323 +printf 'launcher_closed=%s\n' "$state_launcher_closed"
324 +printf 'clipboard_open=%s\n' "$state_clipboard_open"
325 +printf 'clipboard_closed=%s\n' "$state_clipboard_closed"
326 +printf 'power_open=%s\n' "$state_power_open"
327 +printf 'power_results=%s\n' "$power_results"
328 +printf 'native_enabled=%s\n' "$state_native_enabled"
329 +printf 'native_count=%s\n' "$native_count"
330 +printf 'native_disabled=%s\n' "$state_native_disabled"
331 +printf 'osd_state=%s\n' "$state_after_osd"
258 332 printf 'hidden=%s\n' "$state_hidden"
259 333 if [ -n "$screenshot_dir" ]; then
260 334 printf 'screenshot_dark=%s\n' "$screenshot_dir/nugu-qs-dark.png"