repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

feat(quickshell): add scaffold control ipc

46a6133d2b5f2859cc87ff08fc454fa6245c0f21

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (3)

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

Added
new file mode 100644
1 +# Quickshell Scaffold Control Verification — 2026-06-17
3 +## Scope
5 +Added and verified scaffold-control IPC for deterministic smoke tests:
7 +- `scaffoldState`
8 +- `hideAll`
10 +These help prove Quickshell surfaces can be opened for validation and then cleaned up without touching old live companions.
12 +## Implemented files
14 +- `quickshell/nugu/shell.qml`
15 +- `quickshell/nugu/README.md`
17 +## Design decision
19 +`scaffoldState` returns a compact JSON string with current Quickshell-owned surface state. `hideAll` closes every Quickshell-owned test surface and disables the opt-in native notification loader.
21 +`hideAll` does **not** touch:
23 +- Ironbar
24 +- Mako
25 +- Hyprland
26 +- user services
27 +- clipboard contents
28 +- power/session state
30 +This keeps smoke tests simple and safe while old companions remain authoritative.
32 +## IPC tested
34 +Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
36 +```sh
37 +qs ipc -c nugu call nugu scaffoldState
38 +qs ipc -c nugu call nugu showDiagnostics
39 +qs ipc -c nugu call nugu showBar
40 +qs ipc -c nugu call nugu openLauncher fire
41 +qs ipc -c nugu call nugu openClipboardPicker smoke
42 +qs ipc -c nugu call nugu openPowerMenu
43 +qs ipc -c nugu call nugu showOsd Smoke info
44 +qs ipc -c nugu call nugu scaffoldState
45 +qs ipc -c nugu call nugu hideAll
46 +qs ipc -c nugu call nugu scaffoldState
47 +```
49 +Observed state:
51 +```json
52 +state_initial={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
53 +state_open={"theme":"dark","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":true,"clipboardPicker":true,"powerMenu":true,"pendingPower":"","lastOsd":"","lastPower":""}
54 +state_hidden={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
55 +```
57 +Runtime output:
59 +```text
60 +INFO: Configuration Loaded
61 +```
63 +No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
65 +## Screenshots
67 +- `/tmp/nugu-qs-scaffold-control-open.png`
68 +- `/tmp/nugu-qs-scaffold-control-hidden.png`
70 +Vision checks confirmed:
72 +- open screenshot shows Quickshell diagnostics/bar/launcher-or-picker/power/OSD surfaces open
73 +- old Ironbar remains visible above the Quickshell test surfaces
74 +- hidden screenshot shows those Quickshell surfaces absent
75 +- old Ironbar remains visible
77 +## Boundary
79 +- Quickshell service remains inactive/not-found.
80 +- Mako/Ironbar services remain active.
81 +- This is a scaffold/test-control improvement, not parity completion.

quickshell/nugu/README.md

Modified
27 27 qs ipc -c nugu call nugu reloadTheme
28 28 qs ipc -c nugu call nugu setThemeMode light
29 29 qs ipc -c nugu call nugu setThemeMode dark
30 +qs ipc -c nugu call nugu scaffoldState
31 +qs ipc -c nugu call nugu hideAll
34 +`scaffoldState` returns a compact JSON string for smoke tests. `hideAll` closes
35 +all Quickshell-owned surfaces and disables the opt-in native notification loader;
36 +it does not touch Ironbar, Mako, Hyprland, or user services.
32 38 ## Phase 2A bar IPC
34 40 The bar is hidden by default while Ironbar remains the live bar.

quickshell/nugu/shell.qml

Modified
42 42 function themeMode(): string { return nuguTheme.mode }
44 + // Scaffold smoke needs one cheap truth source and one cleanup button. This
45 + // keeps test scripts brutal: show surfaces, assert state, hide everything.
46 + function scaffoldState(): string {
47 + return JSON.stringify({
48 + "theme": nuguTheme.mode,
49 + "diagnostics": root.diagnosticsVisible,
50 + "bar": root.barVisible,
51 + "nativeNotifications": root.nativeNotificationsEnabled,
52 + "launcher": launcher.open,
53 + "clipboardPicker": clipboardPicker.open,
54 + "powerMenu": powerMenu.open,
55 + "pendingPower": powerMenu.pendingAction,
56 + "lastOsd": commandBus.lastOsdAction,
57 + "lastPower": commandBus.lastPowerAction
58 + })
59 + }
60 + function hideAll(): void {
61 + root.diagnosticsVisible = false
62 + root.barVisible = false
63 + root.nativeNotificationsEnabled = false
64 + osd.hide()
65 + launcher.close()
66 + clipboardPicker.close()
67 + powerMenu.close()
68 + }
44 70 // Native notifications are opt-in while Mako is still live. Tests must stop
45 71 // Mako first, enable this daemon, then rollback by disabling and restarting Mako.
46 72 function enableNativeNotifications(): string {