repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(quickshell): record current scaffold gate

49add7130cb1d628212e3fabbaefa958532090ea

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/super/inventory/2026-06-17-quickshell-current-scaffold-gate.md

Added
new file mode 100644
1 +# Quickshell Current Scaffold Gate — 2026-06-17
3 +## Scope
5 +Current smoke for the standing subgoal: Quickshell project scaffold. This rechecks diagnostics IPC, dark/light mode, reload behavior, clean shutdown, service wiring, and live service boundary after Phase 4 work.
7 +## Repo/live boundary before test
9 +Unrelated dirty work preserved:
11 +```text
12 +? Notes
13 +M pi-ext
14 +M pi/agent/settings.json
15 +```
17 +Old services remain live:
19 +```text
20 +ironbar.service active
21 +ironbar-workspaces.service active
22 +mako.service active
23 +```
25 +Quickshell is not live:
27 +```text
28 +quickshell.service inactive/not-found
29 +pgrep -a qs: empty
30 +```
32 +## Scaffold/theme smoke
34 +Temporary `XDG_CONFIG_HOME` named config was used; no live `~/.config/quickshell` mutation.
36 +Commands exercised:
38 +```sh
39 +qs -c nugu
40 +qs ipc -c nugu call nugu themeMode
41 +qs ipc -c nugu call nugu showDiagnostics
42 +qs ipc -c nugu call nugu setThemeMode light
43 +qs ipc -c nugu call nugu reloadTheme
44 +qs ipc -c nugu call nugu setThemeMode dark
45 +qs ipc -c nugu call nugu hideDiagnostics
46 +```
48 +Observed returns:
50 +```text
51 +exit=0
52 +mode_initial=dark
53 +set_light=light
54 +mode_after_reload=dark
55 +set_dark=dark
56 +hidden_ok=dark
57 +```
59 +Runtime output:
61 +```text
62 +INFO: Configuration Loaded
63 +```
65 +No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
67 +Screenshots:
69 +- `/tmp/nugu-qs-scaffold-current-dark.png`
70 +- `/tmp/nugu-qs-scaffold-current-light.png`
72 +Vision checks confirmed:
74 +- diagnostics panel says `Quickshell Nugu · dark` in dark mode
75 +- diagnostics panel says `Quickshell Nugu · light` in light mode
76 +- both modes are readable
77 +- old Ironbar remains visible above the diagnostics panel
79 +## Service wiring check
81 +Tracked service file syntax is valid:
83 +```text
84 +systemd-analyze --user verify hypr/systemd/quickshell.service
85 +verify_exit=0
86 +```
88 +Dorkfiles manifest contains the links:
90 +```text
91 +quickshell/nugu -> ~/.config/quickshell/nugu
92 +hypr/systemd/quickshell.service -> ~/.config/systemd/user/quickshell.service
93 +```
95 +Bootstripper check passes:
97 +```text
98 +bootstripper_check_exit=0
99 +OK bootstripper check passed.
100 +```
102 +Live home is not linked yet:
104 +```text
105 +~/.config/quickshell/nugu: missing
106 +~/.config/systemd/user/quickshell.service: missing
107 +systemctl --user list-unit-files 'quickshell*': 0 unit files listed
108 +```
110 +This is expected until the user explicitly approves running dorkfiles link/setup or manually linking these files. Do not start/enable `quickshell.service` while the live unit/config are missing.
112 +## DBus sanity
114 +Agent-shell user DBus is still broken:
116 +```text
117 +busctl --user --list: Transport endpoint is not connected
118 +notify-send: Error receiving data: Connection reset by peer
119 +```
121 +This keeps Phase 3 native notification live parity blocked from the agent shell. Mako remains active and recoverable; do not retire it.
123 +## Conclusion
125 +The self-contained Quickshell scaffold passes current diagnostics/theme IPC smoke through a temporary named config. Live activation is intentionally not done because the dorkfiles links are not installed in `$HOME` and old services remain authoritative.