repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

cleanup old docs

a875607f485ec7bb6343e486e5da5f22f7cba376

Oliver Krylow <o.krylow@isp-insoft.de> ·

SSH signature · not checked

Browse filesCompare with HEAD

Changed files (44)

README.md

Modified
8 8 init.lua
9 9 : main entry point
10 -\
11 11 lua/std
12 12 : standard lib. can only depend on itself and neovim apis.
13 -\
14 14 lua/bugabinga
15 15 : config modules. in aggregation, defines all of the config. can depend on itself, std and plugins.
16 -\
17 17 lua/bugabinga/plugins
18 18 : third party plugins and their config glue integrating it into the config.
19 -\
20 20 colors/nugu
21 21 : color theme
22 -\
23 23 ftplugin
24 24 : file type specific config
26 -----------
26 +---
28 28 # ai poem
35 35 ~ Shirou Emiya
37 ----------
37 +---
39 39 # todo
41 -* add fonts to dotfiles (how to keep size under control?)
42 -* write plugin to parse lsp settings locally and apply them
43 -* is there a use case for a plugin that parses local plugin configuration overrides?
44 -* kill custom lsp stuff in favor of lspconfig and try neoconf + nvim-java
45 -* does status bar fail to display if lsp fails to load?
46 -* pandoc with lua filters for diagrams for generating documents and previewing --> https://github.com/tex/vimpreviewpandoc
47 -* use gen.ai to generate docs
48 -* learn marks and refactor mark.lua
49 -* use ltex-ls for markdown, code comments and commit messages
50 -* create a floating window that shows plugins, that have commands, as reminder
51 -* setup DAP
52 -* add nu-check to nvim-lint
53 -* create facade over vim.api.nvim_create_user_command
54 -* create skeleton-plugin for default file content based on file type
55 -* add support for Java multi line string in autopairs
56 -* nvim spell for camel case words
41 +- learn marks and refactor mark.lua
42 +- add support for Java multi line string in autopairs
43 +- nvim spell for camel case words

codex/config.toml

Modified
147 147 [desktop]
148 148 followUpQueueMode = "steer"
150 +[hooks.state]
152 +[hooks.state."browser@openai-bundled:plugin.json#hooks[0]:stop:0:0"]
153 +trusted_hash = "sha256:317a07045dfc95aef2e80c55428a2f817e2768be867e3b1ef29a73da8636ae7f"

docs/super/inventory/2026-06-14-nugu-theme-current-state.md

Deleted
deleted file mode 100644
1 -# Nugu Theme Current-State Inventory — 2026-06-14
3 -Goal: build theme switching system with Nugu as source of truth.
5 -## Source of truth
7 -Nugu source files:
9 -- `nugu/base.toml` — seed colors + intent comments.
10 -- `nugu/nugu.nu` — palette generation + WCAG validation.
11 -- `nugu/palette.nu` — reads generated `nugu/output/dark.toml` and `nugu/output/light.toml`.
12 -- App generators:
13 - - `nugu/helix.nu`
14 - - `nugu/wezterm.nu`
15 - - `nugu/ghostty.nu`
16 - - `nugu/hypr.nu`
17 - - `nugu/linux_console.nu`
18 - - `nugu/mako.nu`
19 - - `nugu/ironbar.nu`
20 - - `nugu/yazi.nu`
21 - - `nugu/aerc.nu`
22 - - `nugu/neovim.nu`
23 - - `nugu/site.nu`
25 -Tools observed:
27 -- `nu 0.113.1`
28 -- `just 1.52.0`
29 -- `taplo 0.10.0`
30 -- `pastel 0.12.0`
32 -Nugu recipes from `nugu/justfile`:
34 -- `build` → `nugu/output/dark.toml`, `nugu/output/light.toml`.
35 -- `check` → format + WCAG validation.
36 -- `install` → helix + wezterm + ghostty + linux-console + hypr + mako + ironbar + aerc + yazi + nvim.
37 -- Per-app recipes: `helix`, `wezterm`, `nvim`, `ghostty`, `hypr`, `linux-console`, `mako`, `ironbar`, `yazi`, `aerc`.
39 -## Tracked generated Nugu outputs
41 -Tracked generated/theme consumers found by `git ls-files`:
43 -- `aerc/stylesets/nugu-dark`
44 -- `aerc/stylesets/nugu-light`
45 -- `bash/linux-console/nugu-dark.sh`
46 -- `bash/linux-console/nugu-light.sh`
47 -- `clipse/nugu.json`
48 -- `cmus/nugu.theme`
49 -- `ghostty/themes/nugu-dark`
50 -- `ghostty/themes/nugu-light`
51 -- `helix/themes/nugu-dark.toml`
52 -- `helix/themes/nugu-light.toml`
53 -- `hypr/generated/nugu.lua`
54 -- `ironbar/nugu.css`
55 -- `mako/nugu.conf`
56 -- `neovim/colors/nugu.lua`
57 -- `neovim/lua/bugabinga/nugu/init.lua`
58 -- `neovim/lua/bugabinga/nugu/palette.lua`
59 -- `wezterm/bugabinga/nugu/init.lua`
60 -- `wezterm/bugabinga/nugu/palette_dark.lua`
61 -- `wezterm/bugabinga/nugu/palette_light.lua`
62 -- `yazi/flavors/nugu-dark.yazi/flavor.toml`
63 -- `yazi/flavors/nugu-light.yazi/flavor.toml`
65 -## Current mode state
67 -Observed state paths:
69 -- `~/.cache/nugu/mode` exists and contained `dark`.
70 -- `~/.local/state/nugu/mode` missing.
71 -- `~/.local/state/nugu/themes/mako.conf` missing.
72 -- `~/.local/state/nugu/themes/ironbar.css` missing.
73 -- `~/.local/state/nugu/themes/hyprtoolkit.conf` missing.
75 -Current cache readers:
77 -- `hypr/generated/nugu.lua` reads `~/.cache/nugu/mode`.
78 -- `nugu/hypr.nu` generates that cache path.
79 -- `wezterm/bugabinga/theme.lua` reads `~/.cache/nugu/mode` before falling back to `wez.gui.get_appearance()`.
81 -Required contract change: move mode state to `${XDG_STATE_HOME:-~/.local/state}/nugu/mode`; update all cache readers.
83 -## Consumer inventory
85 -### Hyprland
87 -Files:
89 -- `hypr/generated/nugu.lua`
90 -- `hypr/modules/appearance.lua`
91 -- `hypr/modules/rules.lua`
92 -- `hypr/modules/hypr_osd.lua`
94 -State:
96 -- `generated/nugu.lua` contains both dark + light palettes.
97 -- `generated/nugu.lua` currently reads `~/.cache/nugu/mode`.
98 -- `modules/appearance.lua` calls `nugu.current()` at config evaluation and supports `M.apply(mode)`.
99 -- `modules/rules.lua` and `modules/hypr_osd.lua` bind colors at module load; reload/eval needed after switch.
101 -Reload path:
103 -- `hyprctl reload config-only` should refresh Lua config and Nugu colors.
105 -Gaps:
107 -- No tracked switch entrypoint exists now; old `hypr/scripts/theme.lua` is deleted in current worktree.
108 -- `hypr/generated/nugu.json` is deleted in current worktree but still referenced by `nugu/justfile` recipe.
110 -### Mako
112 -Files:
114 -- `mako/config`
115 -- `mako/nugu.conf`
116 -- `hypr/systemd/mako.service`
118 -State:
120 -- `mako/config` includes `~/.config/mako/nugu.conf`.
121 -- `mako/nugu.conf` is pure Nugu color/style fragment.
122 -- Behavior/layout remains in `mako/config`.
124 -Reload path:
126 -- `makoctl reload` available.
128 -Gap: current switch would need to rewrite tracked `mako/nugu.conf`; target design should include local-state theme fragment instead.
130 -### Ironbar
132 -Files:
134 -- `ironbar/style.css`
135 -- `ironbar/nugu.css`
136 -- `ironbar/config.json`
137 -- `ironbar/scripts/workspaces-watch.py`
138 -- `hypr/systemd/ironbar.service`
140 -State:
142 -- `ironbar/style.css` imports `nugu.css`.
143 -- `ironbar/nugu.css` is pure generated CSS vars.
144 -- `ironbar/config.json` is behavior/layout/modules.
145 -- `ironbar/scripts/workspaces-watch.py` reads `~/.config/ironbar/nugu.css` directly for colors.
147 -Reload path:
149 -- Ironbar docs/help: style changes hot-loaded; `ironbar reload` exists.
150 -- `ironbar --theme <path>` can select CSS path at start.
152 -Gaps:
154 -- Current import points at tracked `ironbar/nugu.css`.
155 -- `workspaces-watch.py` hard-codes `~/.config/ironbar/nugu.css`; switch design must update it to read local-state CSS vars or avoid direct color parsing.
157 -### Hyprtoolkit apps
159 -Files:
161 -- `hypr/hyprtoolkit.conf`
163 -State:
165 -- File contains colors + static appearance variables: rounding, font sizes, fonts, icon theme.
166 -- Hyprtoolkit package has no `hyprtoolkit` executable/manpage; it is a library used by `hyprlauncher`, `hyprpwcenter`, `hyprshutdown`, etc.
167 -- `hyprtoolkit 0.5.4` supports `source = <path>`.
168 -- Source inspection: it watches only main `~/.config/hypr/hyprtoolkit.conf` with `IN_MODIFY | IN_DONT_FOLLOW`; sourced files are parsed but not watched.
170 -Reload path:
172 -- Live color reload occurs internally after main config `IN_MODIFY`.
173 -- To live-switch sourced local-state colors: write sourced file, then rewrite main file bytes unchanged to trigger `IN_MODIFY` without lasting diff.
175 -Gap: split tracked main file = fallback + static vars + source directive; local-state file = colors only.
177 -### GTK/Qt/system preference
179 -State:
181 -- `org.gnome.desktop.interface color-scheme` exists.
182 -- Current value observed: `prefer-dark`.
183 -- Range: `default`, `prefer-dark`, `prefer-light`.
184 -- Portal services active: `xdg-desktop-portal`, `xdg-desktop-portal-gtk`, `xdg-desktop-portal-hyprland`.
186 -Reload path:
188 -- `gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'|'prefer-light'`.
190 -Gap: no Nugu switch command currently sets it.
192 -### Ghostty
194 -Files:
196 -- `ghostty/config`
197 -- `ghostty/themes/nugu-dark`
198 -- `ghostty/themes/nugu-light`
200 -State:
202 -- Config uses `theme = light:nugu-light,dark:nugu-dark`.
203 -- Already dual-theme and should follow system dark/light mode.
205 -Gap: none beyond setting system color-scheme.
207 -### WezTerm
209 -Files:
211 -- `wezterm/bugabinga/theme.lua`
212 -- `wezterm/bugabinga/nugu/init.lua`
213 -- `wezterm/bugabinga/nugu/palette_dark.lua`
214 -- `wezterm/bugabinga/nugu/palette_light.lua`
216 -State:
218 -- Generated palettes exist for both modes.
219 -- `theme.lua` prefers `~/.cache/nugu/mode`, then falls back to WezTerm GUI appearance.
221 -Gaps:
223 -- Update mode reader to local-state.
224 -- Need reload behavior decision; automatic reload not verified.
226 -### Neovim
228 -Files:
230 -- `neovim/init.lua`
231 -- `neovim/colors/nugu.lua`
232 -- `neovim/lua/bugabinga/nugu/palette.lua`
233 -- `neovim/lua/bugabinga/nugu/init.lua`
235 -State:
237 -- Uses colorscheme `nugu`.
238 -- Palette file contains dark + light GUI palette and TUI palette.
239 -- Active mode based on `vim.o.background`.
240 -- Existing autocommand reloads colorscheme on `SIGUSR1`.
242 -Gap: switch command can optionally signal running Neovim processes later; not required for Hypr desktop shell switch.
244 -### Helix
246 -Files:
248 -- `helix/config.toml`
249 -- `helix/themes/nugu-dark.toml`
250 -- `helix/themes/nugu-light.toml`
252 -State:
254 -- `helix/config.toml` hard-codes `theme = "nugu-dark"`.
256 -Gap: no dynamic switch currently.
258 -### Yazi
260 -Files:
262 -- `yazi/theme.toml`
263 -- `yazi/flavors/nugu-dark.yazi/flavor.toml`
264 -- `yazi/flavors/nugu-light.yazi/flavor.toml`
266 -State:
268 -- Nugu generated flavors are tracked.
269 -- `yazi/theme.toml` currently uses `noctalia` for both `dark` and `light`, not Nugu.
271 -Gap: generated Nugu flavors are not active.
273 -### Aerc
275 -Files:
277 -- `aerc/aerc.conf`
278 -- `aerc/stylesets/nugu-dark`
279 -- `aerc/stylesets/nugu-light`
281 -State:
283 -- `aerc/aerc.conf` hard-codes `styleset-name=nugu-dark`.
285 -Gap: no dynamic switch currently.
287 -### Linux console
289 -Files:
291 -- `bash/bashrc`
292 -- `bash/linux-console/nugu-dark.sh`
293 -- `bash/linux-console/nugu-light.sh`
295 -State:
297 -- Bash helper `_nugu_console_theme dark|light|toggle` sources generated shell fragments.
298 -- Bash startup currently calls `_nugu_console_theme light`.
300 -Gap: not integrated with global Nugu mode state.
302 -### Cmus / Clipse / tmux
304 -Files:
306 -- `cmus/nugu.theme`
307 -- `clipse/nugu.json`
308 -- `tmux/tmux.conf`
310 -State:
312 -- Tracked Nugu-related files exist.
313 -- No dynamic dark/light switch integration observed during this inventory.
315 -## Dirty work relevant to theme switch
317 -Observed earlier via `git -C .. status --short --ignore-submodules=dirty`:
319 -- Modified/deleted Hypr transition files, including deleted old `hypr/scripts/theme.lua` and `hypr/systemd/nugu-theme.service`.
320 -- `hypr/generated/nugu.json` deleted; `hypr/generated/nugu.lua` still tracked.
321 -- `ironbar/nugu.css`, `ironbar/style.css`, `ironbar/config.json`, `ironbar/scripts/workspaces-watch.py` modified.
322 -- `mako/nugu.conf` modified.
323 -- `nugu/ironbar.nu` modified.
325 -Do not broad-add. Stage exact files only.
327 -## Conclusions
329 -1. Nugu source-of-truth structure already exists and covers target app palettes.
330 -2. Runtime mode state is split today: Hypr + WezTerm read `~/.cache/nugu/mode`; target contract requires local state.
331 -3. Hypr/Mako/Ironbar/Hyprtoolkit are the core Hypr desktop shell switch targets.
332 -4. Ghostty already fits the system-preference model.
333 -5. Helix/Aerc/Linux console/Yazi are static or manually switchable today; include in longer-term switch contract, but they are not blockers for Hypr desktop shell switching.
334 -6. Ironbar has an extra direct color consumer: `ironbar/scripts/workspaces-watch.py`; any switch plan must update it.
335 -7. Local-state runtime theme fragments are currently absent; first implementation must create them before changing service/config includes.

docs/super/inventory/2026-06-17-quickshell-bar-current-validation.md

Deleted
deleted file mode 100644
1 -# Quickshell Current Bar Validation — 2026-06-17
3 -## Scope
5 -Revalidated current Phase 2C bar behavior after adding clipboard/tray/notification/inhibit/power/calendar surfaces.
7 -## Environment
9 -Current monitor inventory:
11 -```json
12 -[
13 - { "name": "LVDS-1", "width": 1366, "height": 768, "x": 0, "y": 0, "scale": 1.0 }
14 -]
15 -```
17 -Only one monitor is currently attached, so live multi-monitor parity cannot be proven beyond the existing `Variants { model: Quickshell.screens }` implementation and single-monitor runtime parse/start.
19 -Tray client inventory checked these commands and found none installed/present:
21 -```text
22 -nm-applet blueman-applet pasystray copyq udiskie flameshot nextcloud steam keepassxc qbittorrent syncthingtray nm-tray volumeicon
23 -```
25 -Tray menu behavior remains unverified until a real tray client is available.
27 -## Workspace click validation
29 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
31 -Click coordinates reflect the current Phase 2C layout where the clipboard button precedes workspace buttons.
33 -```text
34 -original=3
35 -clicked=1 active=1
36 -clicked=2 active=2
37 -clicked=3 active=3
38 -clicked=4 active=4
39 -clicked=5 active=5
40 -clicked=9 active=9
41 -restored active workspace=3
42 -```
44 -Relevant runtime output:
46 -```text
47 -INFO: Configuration Loaded
48 -```
50 -No QML errors and no Hyprland dispatch failures were logged.
52 -## Boundary
54 -- Ironbar remained active.
55 -- Mako remained active.
56 -- Quickshell service remained inactive/not live.
57 -- No lingering `qs` process remained after validation.
59 -## Still open before Ironbar retirement
61 -- Human visual approval for same/better style.
62 -- Volume/brightness wheel interactions remain unproven with `wdotool`.
63 -- Tray icon/menu validation needs a real tray client.
64 -- Full bar comparison with old services stopped has not been run.

docs/super/inventory/2026-06-17-quickshell-bar-wheel-validation-attempt.md

Deleted
deleted file mode 100644
1 -# Quickshell Bar Wheel Validation Attempt — 2026-06-17
3 -## Scope
5 -Attempted to close the Phase 2B gap for volume and brightness wheel interactions on the current Quickshell bar.
7 -## Setup
9 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
11 -Current bar screenshot:
13 -- `/tmp/nugu-qs-bar-locate.png`
15 -Vision/crop analysis found the visible Quickshell bar widget centers:
17 -```text
18 -volume ≈ 1178,52
19 -brightness ≈ 1254,52
20 -```
22 -Old Ironbar was visible above the Quickshell test bar; Quickshell bar was the lower bar and coordinates targeted the Quickshell widgets.
24 -## Commands attempted
26 -State was saved before testing and restored afterward:
28 -- PipeWire sink volume
29 -- PipeWire sink mute state
30 -- Backlight raw value
32 -Synthetic wheel input used `wdotool --backend wlr-protocols`:
34 -```sh
35 -wdotool --backend wlr-protocols mousemove 1178 52
36 -wdotool --backend wlr-protocols scroll 0 1
37 -wdotool --backend wlr-protocols scroll 0 -1
39 -wdotool --backend wlr-protocols mousemove 1254 52
40 -wdotool --backend wlr-protocols scroll 0 1
41 -wdotool --backend wlr-protocols scroll 0 -1
42 -```
44 -## Observed result
46 -Before attempting a code change:
48 -```text
49 -vol_before=Volume: 0.30 [MUTED]
50 -vol_after_down=Volume: 0.30 [MUTED]
51 -vol_after_up=Volume: 0.30 [MUTED]
52 -bright_before=96%
53 -bright_after_down=96%
54 -bright_after_up=96%
55 -```
57 -A hypothesis was tested that `WheelHandler` was not receiving synthetic layer-shell wheel events while the `MouseArea` owned the hit region. The minimal code change routed wheel handling through `MouseArea.onWheel`. Retest still produced no state change:
59 -```text
60 -vol_before=Volume: 0.30 [MUTED]
61 -vol_after_scroll_pos=Volume: 0.30 [MUTED]
62 -vol_after_scroll_neg=Volume: 0.30 [MUTED]
63 -bright_before=96%
64 -bright_after_scroll_pos=96%
65 -bright_after_scroll_neg=96%
66 -```
68 -The unproven code change was reverted.
70 -## Runtime output
72 -```text
73 -INFO: Configuration Loaded
74 -```
76 -No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
78 -PipeWire emitted rtkit/session-bus warnings from the agent shell, consistent with the existing agent DBus limitations, but `wpctl` state reads and explicit restores completed.
80 -## Conclusion
82 -Wheel parity remains **unverified**. Current evidence points to synthetic wheel injection not proving the behavior in this harness. Do not count this row as accepted until either:
84 -- a live manual wheel test is observed, or
85 -- a better automation path can deliver Wayland wheel events to the layer-shell widget and show state changes.
87 -## Boundary
89 -- Ironbar stayed active.
90 -- Mako stayed active.
91 -- Quickshell service stayed inactive/not live.
92 -- Volume, mute state, and brightness were restored after testing.

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

Deleted
deleted 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 nuguland
40 -qs ipc -c nuguland call nuguland themeMode
41 -qs ipc -c nuguland call nuguland showDiagnostics
42 -qs ipc -c nuguland call nuguland setThemeMode light
43 -qs ipc -c nuguland call nuguland reloadTheme
44 -qs ipc -c nuguland call nuguland setThemeMode dark
45 -qs ipc -c nuguland call nuguland 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/nuguland -> ~/.config/quickshell/nuguland
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/nuguland: 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.

docs/super/inventory/2026-06-17-quickshell-dbus-blocker-diagnosis.md

Deleted
deleted file mode 100644
1 -# Quickshell DBus Blocker Diagnosis — 2026-06-17
3 -## Scope
5 -Read-only diagnosis of the user-session DBus blocker that prevents live native notification parity and reliable media/MPRIS validation from the agent shell.
7 -## Why this matters
9 -Phase 3 native notifications need Quickshell to own/use `org.freedesktop.Notifications`. Phase 4 media parity needs MPRIS over DBus. Current agent-shell and live-service probes show the user bus is unhealthy, so notification/media parity cannot be honestly accepted.
11 -## Live service boundary
13 -Old companions remain active:
15 -```text
16 -ironbar.service active
17 -ironbar-workspaces.service active
18 -mako.service active
19 -```
21 -Quickshell remains not live:
23 -```text
24 -quickshell.service inactive/not-found
25 -pgrep -a qs: empty
26 -```
28 -## Environment and socket inventory
30 -```text
31 -XDG_RUNTIME_DIR=/run/user/1000
32 -DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus
33 -WAYLAND_DISPLAY=wayland-1
34 -HYPRLAND_INSTANCE_SIGNATURE=39d7e209c79d451efab1b21151d5938289da838d_1781295134_91246130
35 -```
37 -Sockets exist and listen:
39 -```text
40 -/run/user/1000/bus: socket exists
41 -/run/user/1000/systemd/private: socket exists
42 -ss shows /run/user/1000/bus LISTEN
43 -ss shows /run/user/1000/systemd/private LISTEN
44 -```
46 -Systemd user manager environment has the same DBus address.
48 -## Failing DBus clients
50 -Exact probes:
52 -```text
53 -busctl --user --list --no-pager
54 -→ Failed to list names: Transport endpoint is not connected
56 -dbus-send --session ... org.freedesktop.DBus.ListNames
57 -→ Failed to open connection to "session" message bus: Did not receive a reply...
59 -makoctl list
60 -→ Transport endpoint is not connected (System.Error.ENOTCONN)
62 -playerctl -l
63 -→ Error receiving data: Connection reset by peer
65 -notify-send ...
66 -→ Error receiving data: Connection reset by peer
67 -```
69 -These failures cover generic DBus listing, Mako notification control, MPRIS media listing, and notification sending.
71 -## Broker state
73 -User DBus units:
75 -```text
76 -dbus.socket active since Jun 12
77 -dbus-broker.service active since Jun 12
78 -```
80 -Broker process state:
82 -```text
83 -pid=1074
84 -FD count: 58
85 -FDSize: 128
86 -VmSize: 948688 kB
87 -VmRSS: 946820 kB
88 -Threads: 1
89 -```
91 -The broker RSS is extremely high for a user message bus. Recent service status included repeated broker messages:
93 -```text
94 -Peer :1.x is being disconnected as it does not have the resources to receive a reply or unicast signal it expects.
95 -```
97 -## Current Ironbar DBus fallout
99 -Live Ironbar is logging MPRIS DBus errors every second:
101 -```text
102 -ironbar::clients::music::mpris: D-Bus error getting MPRIS players:
103 -DBusError(TransportError(D-Bus error: Connection is closed
104 -(org.freedesktop.DBus.Error.Disconnected)))
105 -```
107 -The current Ironbar config contains the MPRIS music module:
109 -```json
111 - "type": "music",
112 - "player_type": "mpris",
113 - "format": "{title} / {artist}"
115 -```
117 -This does not prove Ironbar caused the bus failure. It proves the live bar is affected and is continuously hitting the failed bus.
119 -## Root-cause confidence
121 -High confidence:
123 -- The failure is not only a missing `DBUS_SESSION_BUS_ADDRESS`; the variable is set in both agent env and systemd user env.
124 -- The bus socket exists and listens.
125 -- The broker process is alive.
126 -- Multiple independent clients fail against the same user bus.
127 -- Broker memory is abnormally high and broker logs mention peer resource disconnections.
129 -Working hypothesis:
131 -> The user DBus broker/session bus is wedged or resource-exhausted. This blocks notification and MPRIS validation until the bus is recovered.
133 -## Not mutated
135 -No services were restarted. No `systemctl --user restart dbus-broker.service`, no Mako/Ironbar restart, no live Quickshell service activation.
137 -## Human recovery options
139 -These are intentionally not run by the agent because they mutate the live desktop session.
141 -Least focused recovery to try manually:
143 -```sh
144 -systemctl --user restart dbus-broker.service
145 -```
147 -Then verify:
149 -```sh
150 -busctl --user --list --no-pager | head
151 -notify-send 'DBus recovered' 'notification path works'
152 -makoctl list
153 -playerctl -l || true
154 -```
156 -If user services fail to reconnect cleanly, restart affected companions:
158 -```sh
159 -systemctl --user restart mako.service ironbar.service ironbar-workspaces.service
160 -```
162 -Only after DBus recovery should Phase 3 native notification parity be retried.

docs/super/inventory/2026-06-17-quickshell-hypr-companion-baseline.md

Deleted
deleted file mode 100644
1 -# Quickshell Hypr Companion Baseline Inventory — 2026-06-17
3 -Goal source: reimplement Hypr companion apps in Quickshell with same features, same style/integration, dark/light mode, simpler Hypr config, better perf/looks, and retire obsolete apps only after verified parity.
5 -## Evidence collected
7 -Commands run:
9 -- `git status --short`
10 -- `hyprctl version`
11 -- `hyprctl monitors -j`
12 -- `hyprctl binds -j`
13 -- `hyprctl configerrors`
14 -- `systemctl --user status ironbar.service ironbar-workspaces.service mako.service cliphist.service wl-clip-persist.service`
15 -- `ironbar --validate-config -c ~/.config/ironbar/config.json -t ~/.config/ironbar/style.css`
16 -- `ps -eo pid,pcpu,rss,comm,args | grep ...`
18 -Current repo state before inventory write:
20 -- Branch `trunk`, ahead 7.
21 -- Existing unrelated dirty/untracked state: `../Notes`, `../pi-ext`, `../pi/agent/settings.json`.
22 -- Do not overwrite/clean those.
24 -Installed/live baseline:
26 -- Hyprland `0.55.2`.
27 -- Quickshell `0.3.0-2` installed as `qs`/`quickshell`.
28 -- Ironbar `0.19.0-2` live and config validates.
29 -- Mako `1.11.0-1` live.
30 -- One monitor: `LVDS-1`, `1366x768`, scale `1`, active workspace `3` during inventory.
31 -- `hyprctl configerrors` empty.
33 -Live recheck on 2026-06-17 after planning commits:
35 -- `qs --version`: `Quickshell 0.3.0 (revision , distributed by Arch Linux)`.
36 -- `hyprctl configerrors`: empty.
37 -- `ironbar --validate-config -c ~/.config/ironbar/config.json -t ~/.config/ironbar/style.css`: exit `0`.
38 -- Active services: `ironbar.service`, `ironbar-workspaces.service`, `mako.service`, `cliphist.service`, `wl-clip-persist.service`.
39 -- Missing/not yet linked: `quickshell.service` (`Unit quickshell.service could not be found`). Phase 1 must create/link it; current baseline has no Quickshell live service.
40 -- `ironbar.service`: ~250 MiB systemd memory, still logging repeated MPRIS DBus closed errors.
41 -- `ironbar-workspaces.service`: ~28.7 MiB systemd memory; process tree can include a transient `ironbar var set ...` child while updating labels.
42 -- `mako.service`: ~5.4 MiB systemd memory.
43 -- `cliphist.service`: ~404 KiB systemd memory.
44 -- `wl-clip-persist.service`: ~3.5 MiB systemd memory.
46 -Current companion processes:
48 -| Process | RSS observed | Notes |
49 -| --- | ---: | --- |
50 -| `ironbar` | ~297660 KiB RSS in `ps`; systemd reports ~246.5 MiB current | High baseline target to beat. Logs show repeated MPRIS DBus closed errors. |
51 -| `workspaces-watch.py` | ~16420 KiB RSS; systemd reports ~23.7 MiB | Exists only to feed Ironbar workspace labels. Quickshell should delete this process. |
52 -| `mako` | ~23772 KiB RSS; systemd reports ~5.7 MiB | Notification daemon to replace after parity. |
53 -| `cliphist` watcher | ~424 KiB systemd | Keep storage daemon unless Quickshell also stores history. Frontend replacement is separate. |
54 -| `wl-clip-persist` | ~3.5 MiB systemd | Keep unless a Quickshell clipboard owner fully replaces it. |
55 -| `hyprlauncher --dmenu` | ~228380 KiB RSS while open | Launcher/dmenu frontend replacement target. |
57 -## Current tracked companion files
59 -Hypr:
61 -- `hypr/hyprland.lua` loads modules.
62 -- `hypr/modules/apps.lua` defines app commands.
63 -- `hypr/modules/binds.lua` binds keys.
64 -- `hypr/modules/hypr_osd.lua` wraps control commands in `hyprctl notify`.
65 -- `hypr/modules/commands.lua` exposes app/workspace helpers for Ironbar actions.
66 -- `hypr/modules/workspaces.lua` defines workspaces `1..5` plus Ironbar uses `9`.
67 -- `hypr/scripts/theme.nu` switches Nugu mode and rewrites Mako/Ironbar runtime theme files.
68 -- `hypr/hyprtoolkit.conf` themes Hyprtoolkit apps (`hyprlauncher`, `hyprshutdown`, etc.).
69 -- `hypr/systemd/{ironbar,ironbar-workspaces,mako,cliphist,wl-clip-persist}.service` starts companion services.
71 -Ironbar:
73 -- `ironbar/config.json` defines bar layout, widgets, clicks, popups.
74 -- `ironbar/style.css` defines GTK CSS and Nugu semantic styling.
75 -- `ironbar/nugu.css` is generated current palette CSS vars.
76 -- `ironbar/scripts/workspaces-watch.py` tracks Hypr socket2 and feeds Ironbar vars.
77 -- `ironbar/scripts/mako-status.sh` polls Mako count.
78 -- `ironbar/scripts/wifi-status.sh` polls iwd status.
80 -Mako:
82 -- `mako/config` defines notification behavior/layout and includes `mako/nugu.conf`.
83 -- `mako/nugu.conf` is generated Nugu color/style fragment.
85 -Nugu:
87 -- `nugu/hypr.nu` generates `hypr/generated/nugu.{json,lua}`.
88 -- `nugu/ironbar.nu` generates Ironbar CSS vars.
89 -- `nugu/mako.nu` generates Mako theme fragment.
90 -- `nugu/justfile` currently generates but does not copy Mako/Ironbar output in its `mako`/`ironbar` recipes.
92 -## Exact Ironbar extraction
94 -Extracted from `ironbar/config.json` with `jq` on 2026-06-17.
96 -### Workspace labels
98 -| Var | Label |
99 -| --- | --- |
100 -| `ws1` | `1 󰖟` |
101 -| `ws2` | `2 󰅨` |
102 -| `ws3` | `3 󰆍` |
103 -| `ws4` | `4 󰭹` |
104 -| `ws5` | `5 󰎆` |
105 -| `ws9` | `9 󰉋` |
107 -### Bar modules and actions
109 -| Section | Type/name | Format | Tooltip | Left/click | Middle | Right | Scroll up | Scroll down |
110 -| --- | --- | --- | --- | --- | --- | --- | --- | --- |
111 -| start | `custom workspace-switcher` | buttons from `ws1..ws5,ws9` | Workspaces: web code term chat media misc | `hyprctl eval 'require("modules.commands").workspace("N")'` per button | | | | |
112 -| start | `clipboard` | max 5, truncate end 30 | | builtin popup/select | | | | |
113 -| start | `bindmode` | truncate end 20 | | builtin display | | | | |
114 -| center | `music` | `{title} / {artist}` | | builtin MPRIS | | | | |
115 -| center | `clock` | `%H:%M` | | builtin calendar popup | | | | |
116 -| end | `script mako-status` | `󰂚` or `󰂞 N` | Notifications: left restores last, right dismisses all | `makoctl restore` | | `makoctl dismiss --all` | | |
117 -| end | `script wifi` | `󰖩` or `󰖪 off` | WiFi: left/middle opens impala | `hyprctl eval 'require("modules.commands").app("wifi")'` | same | | | |
118 -| end | `bluetooth` | `󰂲`, `󰂯`, `󰂱`, `󰂱 {device_battery_percent}%` | Bluetooth: left/middle opens bluetui | `hyprctl eval 'require("modules.commands").app("bluetooth")'` | same | | | |
119 -| end | `tray` | icon size 14 | | builtin tray menu | | | | |
120 -| end | `sys_info` | ` {cpu_percent:1}%` | System monitor: left/middle opens btm | `hyprctl eval 'require("modules.commands").app("system_monitor")'` | same | | | |
121 -| end | `volume` | builtin | Volume: scroll adjusts, right mutes, middle opens wiremix | | `hyprctl eval 'require("modules.commands").app("audio_mixer")'` | `wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle` | `wpctl set-volume -l 1 @DEFAULT_AUDIO_SINK@ 2%+` | `wpctl set-volume @DEFAULT_AUDIO_SINK@ 2%-` |
122 -| end | `brightness` | `󰃠 {percentage}%` | Brightness: scroll adjusts display | builtin | | | builtin smooth scroll | builtin smooth scroll |
123 -| end | `battery` | `󰁹 {percentage}%` | Battery: left/middle opens upower | `hyprctl eval 'require("modules.commands").app("battery")'` | same | | | |
124 -| end | `inhibit` | on `󰅶 {duration}`, off `󰛊 {duration}` | Inhibit: left toggles, right cycles duration | builtin toggle | | builtin cycle | | |
125 -| end | `custom power-menu` | `󰐥` | Power menu | popup toggle | | | | |
127 -### Power popup actions
129 -| Label | Command |
130 -| --- | --- |
131 -| `󰐥 off` | `!hyprshutdown --post-cmd "systemctl poweroff"` |
132 -| `󰜉 reboot` | `!hyprshutdown --post-cmd "systemctl reboot"` |
133 -| `󰍃 out` | `!hyprshutdown` |
134 -| `󰤄 sleep` | `!loginctl lock-session && systemctl suspend` |
135 -| `󰌾 lock` | `!hyprlock` |
137 -## Exact Mako extraction
139 -Extracted from `mako/config` on 2026-06-17.
141 -| Key | Value |
142 -| --- | --- |
143 -| `font` | `IBM Plex Sans 10` |
144 -| `border-size` | `2` |
145 -| `border-radius` | `12` |
146 -| `padding` | `12,14` |
147 -| `margin` | `8` |
148 -| `outer-margin` | `14` |
149 -| `anchor` | `top-right` |
150 -| `layer` | `overlay` |
151 -| `width` | `360` |
152 -| `height` | `160` |
153 -| `max-visible` | `4` |
154 -| `max-history` | `80` |
155 -| `sort` | `-priority` |
156 -| `icons` | `1` |
157 -| `max-icon-size` | `48` |
158 -| `icon-border-radius` | `7` |
159 -| `markup` | `1` |
160 -| `actions` | `1` |
161 -| `history` | `1` |
162 -| `ignore-timeout` | `1` |
163 -| `default-timeout` | `6500` |
164 -| `format` | `%a\\n<b>%s</b>\\n%b` |
165 -| `on-button-left` | `invoke-default-action` |
166 -| `on-button-middle` | `dismiss-group` |
167 -| `on-button-right` | `dismiss` |
168 -| `[urgency=low] default-timeout` | `2500` |
169 -| `[urgency=normal] default-timeout` | `6500` |
170 -| `[urgency=critical] border-size` | `3` |
171 -| `[urgency=critical] default-timeout` | `0` |
172 -| `[grouped] format` | `%a · %g\\n<b>%s</b>\\n%b` |
173 -| `[hidden] format` | `+%h more notifications` |
175 -## Hypr binds that touch companion apps
177 -| Bind | Current action | Replacement target |
178 -| --- | --- | --- |
179 -| `SUPER+Space` | `hyprlauncher` | Quickshell launcher IPC/window. |
180 -| `SUPER+V` | `cliphist list | hyprlauncher --dmenu | cliphist decode | wl-copy` | Quickshell clipboard picker using `cliphist` backend or native history. |
181 -| `CTRL+ALT+Delete` | `hyprshutdown --dry-run` | Quickshell power/logout window; keep dry-run semantics until explicit destructive action. |
182 -| `SUPER+ALT+L` | `hyprctl notify` then `hyprlock` | Quickshell OSD/notification then existing lock, or later Quickshell lock. |
183 -| `SUPER+ALT+S` | `hyprctl notify`, `loginctl lock-session`, `systemctl suspend` | Quickshell OSD/session action wrapper. |
184 -| `SUPER+SHIFT+R` | `hyprctl reload` then `hyprctl notify` | Quickshell reload toast/OSD. |
185 -| `SUPER+Escape` | `makoctl dismiss --all; hyprctl dismissnotify` | Quickshell notification dismiss-all plus Hypr notify clear during transition. |
186 -| `XF86Audio*` | `wpctl`/`playerctl` plus `hyprctl notify` | Quickshell Pipewire/MPRIS OSD and direct service writes where possible. |
187 -| `XF86MonBrightness*` | `brightnessctl` plus `hyprctl notify` | Quickshell brightness OSD; command boundary may stay `brightnessctl`. |
188 -| `Print` variants | `hyprshot`/`satty`/`hyprpicker` plus `hyprctl notify` | Keep external capture tools; replace notification wrapper. |
190 -Core compositor/workspace/window binds are not companion-app scope and should stay in Hypr unless Quickshell global shortcuts prove cleaner.
192 -## Ironbar feature parity matrix
194 -| Surface | Current source | Current behavior | Quickshell parity requirement | Verification |
195 -| --- | --- | --- | --- | --- |
196 -| Bar shell | `ironbar/config.json`, `style.css` | Top bar, height `30`, transparent bg, `2px` accent bottom border, `20px` horizontal padding. | Per-monitor `PanelWindow`, top anchored, exclusive zone, IBM Plex Mono, same sizing/border/radius. | Screenshot compare dark/light; windows reserve top space. |
197 -| Workspaces | `custom` widget + `workspaces-watch.py` | Buttons for `1 web`, `2 code`, `3 term`, `4 chat`, `5 media`, `9 misc`; active = important-global, occupied = fg, empty = muted; click focuses workspace via Hypr Lua. | Use `Quickshell.Hyprland` or Hypr socket service, no Python/Ironbar vars, same labels/colors/clicks. Include workspace `9` even though Hypr module list omits it. | Switch/open/move windows; active/occupied update instantly. |
198 -| Clipboard bar item | Ironbar `clipboard` module | Shows clipboard menu, max 5, truncates 30 chars. | Clipboard picker popup/window. Backend decision: keep `cliphist` for storage first; frontend in Quickshell. | Copy items, open picker, select item to `wl-copy`, delete if current behavior supports deletion. |
199 -| Bind mode | Ironbar `bindmode` | Shows current Hypr bind mode, truncates 20. | Hypr IPC/event state display if bind modes are used; otherwise match hidden/empty behavior. | Enter any bind mode if configured; visual appears. |
200 -| Music | Ironbar `music`, MPRIS | Center text `{title} / {artist}`, truncate 42. Current live logs show repeated MPRIS DBus closed errors. | Use `Quickshell.Services.Mpris`; display active player title/artist; no 1Hz DBus error loop. | Play/pause media; title changes; idle hidden/empty cleanly; no log spam. |
201 -| Clock | Ironbar `clock` | Center `%H:%M`, bold accent, calendar popup styled. | `SystemClock`, same text; popup calendar with readable Nugu styling. | Time update; popup readable in dark/light. |
202 -| Notification status | `mako-status.sh` poll 5s | Icon `󰂚` when none; `󰂞 N` when active/history reports notifications; left restore last, right dismiss all. | Integrated notification daemon/status. No shell poll. Restore/history behavior must match or consciously supersede. | Send/restore/dismiss notifications. |
203 -| WiFi status | `wifi-status.sh` poll 30s | Uses `iwctl station wlan0 show`; connected `󰖩`, disconnected `󰖪 off`; left/middle opens `impala`. | For first parity, process adapter or iwd/DBus adapter; same icon/action. Avoid NetworkManager dependency. | Toggle/disconnect/connected states; clicks open `impala`. |
204 -| Bluetooth | Ironbar `bluetooth` | Status-only; disabled popup; left/middle opens `bluetui`; formats not_found/disabled/enabled/connected/battery. | Use `Quickshell.Services.Bluetooth`; same status and click actions; no ugly builtin popup. | Bluetooth off/on/connected/battery visible; clicks open `bluetui`. |
205 -| Tray | Ironbar `tray` | Icon size 14; native tray popovers styled. | `Quickshell.Services.SystemTray` with menus via DBusMenu/QsMenuOpener, same icon sizing. | Existing tray icons render; menus work/readable. |
206 -| CPU | Ironbar `sys_info` | ` {cpu_percent:1}%`, 2s interval; left/middle opens `btm`. | Lightweight CPU sampler every 2s; same display/click. | CPU value changes; click opens `btm`. |
207 -| Volume | Ironbar `volume` | Scroll `wpctl` +/-2%, right mute, middle `wiremix`, no source display, tooltip. | Pipewire service state, scroll/click parity, maybe OSD sharing; middle opens `wiremix`. | Scroll changes volume; mute state; click opens `wiremix`; OSD if integrated. |
208 -| Brightness | Ironbar `brightness` | `󰃠 {percentage}%`; systemd backlight `intel_backlight`; smooth scroll. | Backlight adapter, same display/scroll. `brightnessctl` boundary acceptable first. | Scroll/keys update; value matches system. |
209 -| Battery | Ironbar `battery` | `󰁹 {percentage}%`; hidden if no BAT; warning <=20; critical <=5 discharging; click opens upower terminal. | UPower display device, same warning/critical/hidden behavior; click opens battery command or native popup. | Battery visible on X230; warning classes simulated or inspected. |
210 -| Inhibit | Ironbar `inhibit` | Durations `30m/1h/2h/inf`, default `inf`, format on/off; left toggles, right cycles. | Quickshell idle inhibitor with duration cycle and visible countdown/state. | Toggle inhibits Hypr idle; duration cycles; sleep does not trigger while on. |
211 -| Power menu | Ironbar custom popup | Button `󰐥`; popup actions poweroff/reboot/logout/sleep/lock; uptime line. | Quickshell popup/window with same actions and safer confirmation if needed; retain command semantics. | Open menu; non-destructive lock/sleep tested; destructive buttons dry-run or user-confirmed only. |
213 -## Mako notification parity matrix
215 -| Current Mako behavior | Requirement in Quickshell notification daemon |
216 -| --- | --- |
217 -| Top-right overlay, layer overlay, width `360`, height `160`, margin/outer-margin. | Same placement and size on `LVDS-1`, multi-monitor sane. |
218 -| Font `IBM Plex Sans 10`; border `2`, radius `12`, padding `12,14`; icon max `48`, icon radius `7`. | Same typography and geometry using Nugu tokens. |
219 -| `max-visible=4`, `max-history=80`, `sort=-priority`. | Same visible cap and history cap/order. |
220 -| `markup=1`, `actions=1`, `history=1`, `ignore-timeout=1`. | Render markup safely; expose actions; retain history; notification timeout behavior equal. |
221 -| `default-timeout=6500`; low `2500`; critical `0`. | Same expiration policy. |
222 -| Format `%a\n<b>%s</b>\n%b`; grouped `%a · %g\n<b>%s</b>\n%b`; hidden `+%h more notifications`. | Same text content and grouped/overflow indicator. |
223 -| Mouse: left invoke default action, middle dismiss group, right dismiss. | Same pointer actions. |
224 -| Semantic colors from `mako/nugu.conf`: normal, low, critical, summary regex error/warn/info. | Same Nugu semantic mapping, dark/light live. |
225 -| `makoctl dismiss --all`, `makoctl restore` used from binds/bar. | Quickshell IPC replacements for dismiss-all and restore-last/history. |
227 -## Launcher/clipboard/power parity matrix
229 -| Current app | Current use | Quickshell replacement boundary |
230 -| --- | --- | --- |
231 -| `hyprlauncher` | App launcher on `SUPER+Space`; dmenu frontend for clipboard. Theme from `hyprtoolkit.conf`. | Quickshell launcher must handle desktop app launching and dmenu-like list selection before removing `hyprlauncher` usage. |
232 -| `cliphist` | Storage daemon and list/decode backend. | Keep daemon initially. Replace only frontend first. Full native clipboard history can be later if it beats `cliphist` without more complexity. |
233 -| `hyprshutdown` | Graceful logout/power menu; dry-run in keybind, real commands in Ironbar popup. | Quickshell power menu can call `systemctl`/`hyprctl` directly. Use confirmation/dry-run while validating. |
234 -| `hyprtoolkit.conf` | Theme for Hyprtoolkit apps. | Becomes obsolete when `hyprlauncher`/`hyprshutdown` are gone. Do not delete before then. |
236 -## Nugu dark/light parity
238 -Current state:
240 -- `hypr/generated/nugu.lua` reads `~/.cache/nugu/mode` and falls back to `dark`.
241 -- `hypr/scripts/theme.nu` supports `dark`, `light`, `toggle`, `auto`, `current`, `watch`.
242 -- Auto mode: light from `07:00` to `19:00`, dark otherwise; `~/.cache/nugu/auto` disables/enables.
243 -- Runtime theme writer paths from `hypr/scripts/theme.nu`:
244 - - mode: `~/.cache/nugu/mode`
245 - - auto flag: `~/.cache/nugu/auto`
246 - - palette input: `~/.config/hypr/generated/nugu.json`
247 - - Mako runtime colors: `~/.config/mako/nugu.conf`
248 - - Ironbar runtime colors: `~/.config/ironbar/nugu.css`
249 - - Hyprtoolkit writer target: `~/.config/hypr/hyprtoolkit.conf`, but call is currently disabled/commented due Hyprtoolkit live rewrite busy-loop risk.
250 -- `mako/config` currently includes `~/.config/mako/nugu.conf`.
251 -- `ironbar/style.css` currently imports `nugu.css`.
252 -- `ironbar/scripts/workspaces-watch.py` currently reads `$XDG_CONFIG_HOME/ironbar/nugu.css` directly for workspace markup colors.
253 -- Switcher writes:
254 - - `~/.cache/nugu/mode`
255 - - GTK `org.gnome.desktop.interface color-scheme`
256 - - `~/.config/mako/nugu.conf`
257 - - `~/.config/ironbar/nugu.css`
258 - - Hyprpaper wallpaper path `~/.config/hypr/wallpapers/nugu-{mode}.png`
259 - - `hyprctl reload`
260 - - restarts Mako and Ironbar
261 - - optional `notify-send`.
263 -Quickshell requirements:
265 -- Single Nugu theme service reads both palettes and mode state.
266 -- Use same semantic token names as Nugu/hypr/ironbar/mako now: `ui.*`, `content.*`, `error`, `warning`, `info`, `debug`.
267 -- Live switch all Quickshell surfaces without Ironbar/Mako restart.
268 -- Continue setting GTK color-scheme and Hyprland palette reload while Hypr config still uses Nugu.
269 -- Remove Ironbar/Mako theme generation only after their services are retired.
271 -Open simplification target:
273 -- Move mode state from `~/.cache/nugu` to `${XDG_STATE_HOME:-~/.local/state}/nugu` only if done across all consumers in one planned step.
275 -## Current style contract to preserve
277 -- Fonts: IBM Plex family exclusively in Hypr desktop configs.
278 - - Bar/status mono: `IBM Plex Mono`.
279 - - Notifications/toolkit UI sans: `IBM Plex Sans`.
280 -- Active UI: bg `ui.focus`, fg `content.backdrop`.
281 -- Hover/accent UI: bg `ui.accent`, fg `content.backdrop`.
282 -- Muted UI text: `ui.minor` over `ui.backdrop`.
283 -- Borders/accent lines: `ui.accent`.
284 -- Bar: compact brutal 30px top strip, no shadows/images, transparent-ish bg, accent bottom line.
285 -- Rounded corners: small `7px`, notification/popup large `12px`.
287 -## Retirement candidates and gate
289 -Do not retire until corresponding parity tests pass live.
291 -| Candidate | Can retire after |
292 -| --- | --- |
293 -| `ironbar.service` | Quickshell bar passes all Ironbar feature rows and screenshot review. |
294 -| `ironbar-workspaces.service` | Quickshell workspace widget updates active/occupied instantly without Python/Ironbar vars. |
295 -| `mako.service` | Quickshell notification daemon owns DBus notifications, actions, history, timeouts, styling, dismiss/restore IPC. |
296 -| `hyprlauncher` usage | Quickshell launcher and dmenu/clipboard picker pass parity. |
297 -| `hyprshutdown` usage | Quickshell power menu/logout actions pass parity. |
298 -| `hyprtoolkit.conf` | No remaining Hyprtoolkit apps are bound/used. |
299 -| `hyprctl notify` helpers in `hypr_osd.lua` | Quickshell OSD/notification IPC replaces all status toasts. |
300 -| `hypr/scripts/theme.nu` Ironbar/Mako writes | Ironbar/Mako are retired or generation is removed from switcher. |
302 -Not immediate retirement targets without explicit design/confirmation:
304 -- `hyprlock` lockscreen.
305 -- `hypridle` idle policy.
306 -- `hyprsunset` blue-light filtering.
307 -- `hyprpolkitagent`.
308 -- `hyprpaper`/wallpaper handling.
309 -- `cliphist` storage daemon and `wl-clip-persist`.
311 -## Architecture implied by the inventory
313 -One named Quickshell config, likely `~/.config/quickshell/nuguland`, should own:
315 -- Bar windows per monitor.
316 -- Notification daemon and notification history.
317 -- Launcher/dmenu/clipboard/power popups.
318 -- OSD windows for audio/brightness/media/session/screenshot status.
319 -- Shared services:
320 - - `ThemeService`: Nugu palette + mode + IPC switch/toggle.
321 - - `HyprService`: workspaces, clients, bind mode, dispatch helper.
322 - - `CommandService`: controlled process boundaries for `wezterm`, `impala`, `bluetui`, `btm`, `wiremix`, `hyprshot`, `satty`, `hyprpicker`, lock/suspend.
323 - - `ClipboardService`: `cliphist` adapter first.
324 - - `NotificationService`: Quickshell `NotificationServer` wrapper.
326 -Hypr Lua should later shrink to compositor config plus binds that call Quickshell IPC for companion surfaces.
328 -## Open questions for next design step
330 -1. Does `same feature as now` require replacing `hyprlock`/`hyprpaper`/`hypridle`, or are those compositor/session primitives allowed to remain?
331 -2. Should clipboard storage stay `cliphist` permanently, or is native Quickshell history desired if it stays simpler?
332 -3. Is launcher parity desktop-app launching only, or also arbitrary command/run mode?
333 -4. Destructive power actions: require confirmation UI, or mirror current single-click Ironbar buttons?
335 -## Next concrete subgoal
337 -Create the Quickshell implementation design from this matrix, then build in safe phases:
339 -1. Scaffold named config with ThemeService + shared style tokens + empty bar.
340 -2. Replace Ironbar bar first while Mako/Hyprlauncher remain live.
341 -3. Replace Mako notifications second.
342 -4. Replace launcher/clipboard/power/OSD.
343 -5. Only then simplify Hypr binds and retire old services.

docs/super/inventory/2026-06-17-quickshell-live-readiness-check.md

Deleted
deleted file mode 100644
1 -# Quickshell live readiness check
3 -Date: 2026-06-17
5 -## Scope
7 -Add a read-only gate for final rollout readiness. This does not link config,
8 -enable/start/stop services, restart DBus, simplify Hypr, or retire Ironbar/Mako.
9 -It also reports old Hypr companion refs so a documented migration map cannot be
10 -mistaken for an applied simplification. The static audit now rejects mutating
11 -rollout commands in this script.
13 -## Command
15 -```sh
16 -cd /home/oli/Workspace/dotfiles
17 -quickshell/nuguland/live-check.sh
18 -```
20 -## Observed
22 -```text
23 -OK command:qs
24 -OK command:systemctl
25 -OK command:systemd-analyze
26 -OK command:busctl
27 -OK command:hyprctl
28 -OK static_audit
29 -OK quickshell_service_unit_verify
30 -BLOCK config_link:not_linked
31 -BLOCK service_link:not_linked
32 -BLOCK service:quickshell.service:inactive expected:active
33 -BLOCK service:ironbar.service:active expected:inactive
34 -BLOCK service:ironbar-workspaces.service:active expected:inactive
35 -BLOCK service:mako.service:active expected:inactive
36 -BLOCK qs_process_absent
37 -BLOCK user_dbus_busctl_failed
38 -OK hypr_config_errors_empty
39 -BLOCK hypr_legacy_companion_refs_present:8
40 -INFO blocks=9
41 -live_check_exit=0
42 -strict_exit=1
43 -```
45 -Default mode exits `0` so it can be used as a status report while rollout is
46 -intentionally incomplete. `--strict` is available for the final gate and exits
47 -nonzero while any block remains; current strict exit is `1` because rollout is
48 -not complete.
50 -## Boundary
52 -These blockers are expected now. They prove the goal is still incomplete:
54 -- live dorkfiles links are absent;
55 -- `quickshell.service` is inactive;
56 -- Ironbar and Mako remain authoritative;
57 -- no `qs` process is live;
58 -- user DBus is still unhealthy for notification/MPRIS parity;
59 -- Hypr still contains old companion helper refs.

docs/super/inventory/2026-06-17-quickshell-parity-checklist.md

Deleted
deleted file mode 100644
1 -# Quickshell Hypr Companion Parity Checklist — 2026-06-17
3 -Purpose: executable acceptance checklist for proving Quickshell parity before retiring Ironbar, Mako, Hyprlauncher/Hyprshutdown usage, or Hypr `hyprctl notify` helpers.
5 -Baseline: [`2026-06-17-quickshell-hypr-companion-baseline.md`](2026-06-17-quickshell-hypr-companion-baseline.md)
6 -Architecture: [`../specs/2026-06-17-quickshell-hypr-companions-architecture.md`](../specs/2026-06-17-quickshell-hypr-companions-architecture.md)
8 -## Rules
10 -- Do not mark a row PASS from code inspection alone.
11 -- Do not retire old apps unless all rows in the relevant section PASS with old app stopped where applicable.
12 -- Screenshots need both dark and light mode unless the row is nonvisual.
13 -- If a row cannot be automated, record the manual observation and why automation is not available.
14 -- Destructive poweroff/reboot tests must use confirmation UI or dry-run only unless the user explicitly approves real execution.
16 -## Baseline snapshot commands
18 -Run before testing a replacement:
20 -```sh
21 -git status --short
22 -qs --version
23 -hyprctl version
24 -hyprctl monitors -j
25 -hyprctl configerrors
26 -systemctl --user --no-pager --plain status ironbar.service ironbar-workspaces.service mako.service cliphist.service wl-clip-persist.service
27 -ps -eo pid,pcpu,rss,comm,args | grep -E 'ironbar|mako|workspaces-watch|hyprlauncher|hyprshutdown|qs|quickshell' | grep -v grep || true
28 -```
30 -Expected baseline before migration:
32 -- Existing unrelated dirty work may exist and must be preserved.
33 -- `hyprctl configerrors` empty.
34 -- Ironbar/Mako services active until their specific retirement tests.
35 -- Quickshell may be active only after Phase 1.
37 -## Phase 1 foundation acceptance
39 -| Check | Command/action | PASS condition |
40 -| --- | --- | --- |
41 -| Direct parse/start | `timeout 3s qs -p quickshell/nuguland/shell.qml` | Exit `124`; stderr has no QML parse/type errors. |
42 -| Service syntax | `systemd-analyze --user verify hypr/systemd/quickshell.service` | Exit `0`, no output. |
43 -| Named config IPC | `qs ipc -c nuguland call nuguland showDiagnostics` | Diagnostics panel appears without replacing Ironbar/Mako. |
44 -| Theme light | `qs ipc -c nuguland call nuguland setThemeMode light` | Diagnostics colors switch to light Nugu palette. |
45 -| Theme dark | `qs ipc -c nuguland call nuguland setThemeMode dark` | Diagnostics colors switch to dark Nugu palette. |
46 -| Hide diagnostics | `qs ipc -c nuguland call nuguland hideDiagnostics` | Diagnostics panel disappears. |
47 -| Old services untouched | `systemctl --user is-active ironbar.service mako.service` | Both still active unless user explicitly approved otherwise. |
49 -## Bar parity acceptance
51 -Run with Ironbar still available for rollback. Capture old/new screenshots with the same workspace and apps if possible.
53 -### Visual shell
55 -| Check | Command/action | PASS condition |
56 -| --- | --- | --- |
57 -| Top bar placement | Start Quickshell bar on `LVDS-1`. | Bar anchored top, full width, reserves space. |
58 -| Height | Screenshot or geometry inspection. | Visual height matches Ironbar `30px`. |
59 -| Padding | Screenshot compare. | Left/right content aligns like Ironbar `20px` padded bar. |
60 -| Border | Screenshot compare. | Bottom border is `2px` Nugu `ui.accent`. |
61 -| Font | Visual inspect. | Bar/status text uses `IBM Plex Mono`. |
62 -| Dark mode | Set Nugu dark, screenshot. | Colors match semantic Ironbar dark variables. |
63 -| Light mode | Set Nugu light, screenshot. | Colors remain readable and match semantic Nugu variables. |
64 -| Hover/active colors | Hover/click buttons. | Hover uses `ui.accent` over `content.backdrop`; active uses documented active color. |
66 -### Workspace widget
68 -| Check | Command/action | PASS condition |
69 -| --- | --- | --- |
70 -| Labels | Inspect bar. | Shows `1 󰖟`, `2 󰅨`, `3 󰆍`, `4 󰭹`, `5 󰎆`, `9 󰉋`. |
71 -| Active highlight | `hyprctl dispatch workspace 1`, repeat for `2..5`. | Active workspace changes immediately and uses `ui.important_global` equivalent. |
72 -| Occupied state | Open a window on a workspace, switch away. | Occupied but inactive workspace uses normal fg. |
73 -| Empty state | Use an empty workspace. | Empty workspace uses muted color. |
74 -| Click focus | Click each workspace button. | Hypr focuses clicked workspace. |
75 -| No watcher | `ps -eo args | grep workspaces-watch.py` after retirement test. | No Python watcher when Ironbar retired. |
77 -### Clipboard entry point
79 -| Check | Command/action | PASS condition |
80 -| --- | --- | --- |
81 -| Open picker | Click clipboard widget or call Quickshell IPC. | Picker opens and is styled with Nugu. |
82 -| List recent text | Copy several text snippets. | Picker shows recent history, max 5 in compact context where applicable. |
83 -| Truncation | Copy text longer than 30 chars. | Display truncates end around current Ironbar behavior. |
84 -| Select item | Choose older item. | Item is decoded and written to clipboard via `wl-copy`; paste returns selected item. |
85 -| Empty state | Clear/test empty history if safe. | Empty state is visible and non-crashing. |
87 -### Bind mode
89 -| Check | Command/action | PASS condition |
90 -| --- | --- | --- |
91 -| Normal state | Inspect bar during normal operation. | Hidden/empty if no bind mode active, matching Ironbar behavior. |
92 -| Mode state | Trigger a Hypr bind mode if one exists. | Bar shows mode name, truncated at 20 if needed. |
94 -### Music/MPRIS
96 -| Check | Command/action | PASS condition |
97 -| --- | --- | --- |
98 -| Idle | No MPRIS player. | Widget hidden/empty cleanly; no log spam loop. |
99 -| Playing | Start an MPRIS player. | Center shows `{title} / {artist}`, truncates around 42 chars. |
100 -| Metadata update | Change track. | Text updates without restart. |
101 -| Controls unaffected | Use media keys/OSD phase if present. | MPRIS state remains correct. |
103 -### Clock/calendar
105 -| Check | Command/action | PASS condition |
106 -| --- | --- | --- |
107 -| Time text | Inspect center. | Shows `%H:%M`, bold/accent like Ironbar. |
108 -| Minute update | Wait minute boundary. | Time updates. |
109 -| Calendar popup | Click clock. | Popup opens and is readable. |
110 -| Calendar dark/light | Toggle mode. | Calendar colors remain readable in both modes. |
112 -### Notification status bridge/native
114 -| Check | Command/action | PASS condition |
115 -| --- | --- | --- |
116 -| No notifications | Clear notifications. | Shows `󰂚` or final chosen equivalent. |
117 -| Count | Send notifications. | Shows `󰂞 N` or final chosen equivalent. |
118 -| Restore | Left click. | Restores last notification while Mako bridge is active or native equivalent after Phase 3. |
119 -| Dismiss all | Right click. | Dismisses all visible notifications. |
120 -| No shell poll after native | Inspect implementation/processes. | Phase 3 native path has no `mako-status.sh` polling. |
122 -### WiFi
124 -| Check | Command/action | PASS condition |
125 -| --- | --- | --- |
126 -| Connected state | Normal connected iwd state. | Shows `󰖩`. |
127 -| Disconnected state | Safe disconnect/test or mock adapter in dev plan. | Shows `󰖪 off`. |
128 -| Left click | Click widget. | Opens `impala` via existing terminal policy. |
129 -| Middle click | Middle click widget. | Opens `impala`. |
130 -| No NetworkManager dependency | Inspect deps/commands. | Uses iwd/process adapter; does not require NetworkManager. |
132 -### Bluetooth
134 -| Check | Command/action | PASS condition |
135 -| --- | --- | --- |
136 -| Not found/disabled/enabled | Toggle adapter only if safe. | Icons match current behavior: empty/`󰂲`/`󰂯`. |
137 -| Connected | Connect paired device if available. | Shows `󰂱`; battery percent if available. |
138 -| Left click | Click widget. | Opens `bluetui`. |
139 -| Middle click | Middle click widget. | Opens `bluetui`. |
140 -| No ugly popup | Click behavior. | Does not show the old unwanted GTK Bluetooth popup. |
142 -### Tray
144 -| Check | Command/action | PASS condition |
145 -| --- | --- | --- |
146 -| Icons | Start normal tray apps. | Existing tray icons render at about `14px`. |
147 -| Menus | Open tray item menu. | Menu opens and is readable/clickable. |
148 -| Passive/attention state | Observe available tray items. | Passive dims/attention visible if service exposes state. |
150 -### CPU/system monitor
152 -| Check | Command/action | PASS condition |
153 -| --- | --- | --- |
154 -| Display | Inspect bar. | Shows ` N%`. |
155 -| Update interval | Watch for >2s. | Value updates around 2s cadence, not per-frame. |
156 -| Left/middle click | Click widget. | Opens `btm` via existing terminal policy. |
158 -### Volume
160 -| Check | Command/action | PASS condition |
161 -| --- | --- | --- |
162 -| Display | Inspect bar. | Shows current sink volume/mute state. |
163 -| Scroll up | Scroll over widget. | Volume increases by about 2%, max 100/1.0 unless current overdrive policy says otherwise. |
164 -| Scroll down | Scroll over widget. | Volume decreases by about 2%. |
165 -| Right click | Right click widget. | Toggles mute. |
166 -| Middle click | Middle click widget. | Opens `wiremix`. |
167 -| Pipewire state | Change volume externally with `wpctl`. | Widget updates without restart. |
169 -### Brightness
171 -| Check | Command/action | PASS condition |
172 -| --- | --- | --- |
173 -| Display | Inspect bar. | Shows `󰃠 N%`. |
174 -| Scroll up/down | Scroll over widget. | Backlight changes similarly to Ironbar. |
175 -| External update | `brightnessctl` if safe. | Widget updates. |
176 -| Device | Inspect implementation. | Uses X230 `intel_backlight` or robust detected backlight. |
178 -### Battery
180 -| Check | Command/action | PASS condition |
181 -| --- | --- | --- |
182 -| Display | Inspect X230. | Shows `󰁹 N%`. |
183 -| Hidden desktop case | If no battery environment is available. | Hidden when no `BAT*`, matching Ironbar `show_if`. |
184 -| Warning | Simulate or inspect threshold logic. | <=20% warning color. |
185 -| Critical | Simulate or inspect threshold logic. | <=5% and discharging uses critical icon/color. |
186 -| Click | Left/middle click. | Opens current battery/upower terminal or native equivalent. |
188 -### Inhibit
190 -| Check | Command/action | PASS condition |
191 -| --- | --- | --- |
192 -| Initial | Inspect widget. | Shows off state `󰛊 inf` or matching default duration. |
193 -| Toggle | Left click. | Shows on state `󰅶 {duration}` and inhibits idle. |
194 -| Cycle | Right click repeatedly. | Cycles `30m`, `1h`, `2h`, `inf`. |
195 -| Timeout | Let short duration expire if implemented. | Inhibit turns off after duration. |
197 -### Power menu
199 -| Check | Command/action | PASS condition |
200 -| --- | --- | --- |
201 -| Open | Click `󰐥`. | Popup opens, styled with Nugu. |
202 -| Uptime | Inspect popup. | Shows uptime line equivalent to `up ...`. |
203 -| Lock | Click lock. | Runs `hyprlock` or dry-run in safe test; no crash. |
204 -| Sleep | Use only with approval or dry-run. | Runs lock+suspend path when approved. |
205 -| Logout | Dry-run or confirmation. | Equivalent to `hyprshutdown` logout semantics. |
206 -| Poweroff/reboot | Confirmation only unless explicitly approved. | No accidental destructive action. |
208 -## Notification daemon parity acceptance
210 -Before native test:
212 -```sh
213 -systemctl --user stop mako.service
214 -```
216 -Rollback:
218 -```sh
219 -systemctl --user restart mako.service
220 -```
222 -| Check | Command/action | PASS condition |
223 -| --- | --- | --- |
224 -| DBus ownership | Stop Mako, start Quickshell notifications, run `notify-send hello body`. | Quickshell receives and displays notification. |
225 -| Placement | Send normal notification. | Top-right overlay, width 360, height <=160, margin/outer-margin visually match. |
226 -| Typography | Visual inspect. | `IBM Plex Sans 10`, summary bold, body readable. |
227 -| Icon | `notify-send -i dialog-information hello body`. | Icon shown max 48px with rounded corners. |
228 -| Normal timeout | Send normal notification. | Expires after about 6500ms. |
229 -| Low timeout | `notify-send -u low hello body`. | Expires after about 2500ms. |
230 -| Critical timeout | `notify-send -u critical hello body`. | Persists until dismissed. |
231 -| Max visible | Send 6 notifications. | 4 visible max, overflow indicator shown. |
232 -| History cap | Send >80 in controlled test. | History does not grow unbounded; cap 80. |
233 -| Left click | Send notification with default action. | Invokes default action. |
234 -| Middle click | Send grouped notifications. | Dismisses group. |
235 -| Right click | Send notification. | Dismisses notification. |
236 -| Actions | Send action notification via a test tool. | Action buttons invoke correct actions. |
237 -| Markup | Send markup body. | Markup renders safely. |
238 -| Error regex | Summary contains `Error`/`Failed`/`Crash`. | Error color/border. |
239 -| Warning regex | Summary contains `Warn`/`Warning`. | Warning color/border. |
240 -| Info regex | Summary contains `Info`/`Notice`. | Info color/border. |
241 -| Restore IPC | Call `qs ipc -c nuguland call nuguland restoreNotification`. | Last/history notification restored. |
242 -| Dismiss IPC | Call `qs ipc -c nuguland call nuguland dismissNotifications`. | Visible notifications dismissed. |
244 -## Launcher/clipboard/power/OSD parity acceptance
246 -| Check | Command/action | PASS condition |
247 -| --- | --- | --- |
248 -| Launcher bind | Press `SUPER+Space`. | Quickshell launcher opens, not Hyprlauncher. |
249 -| Search app | Type app name. | Matching desktop entries filter live. |
250 -| Launch app | Select app. | App launches and launcher closes. |
251 -| Escape | Press Escape. | Launcher closes without side effects. |
252 -| Clipboard bind | Press `SUPER+V`. | Quickshell clipboard picker opens. |
253 -| Clipboard select | Select old clip. | Clipboard contains selected decoded value. |
254 -| Power bind | Press `CTRL+ALT+Delete`. | Quickshell power/logout surface opens; no immediate destructive action. |
255 -| Volume keys | Press XF86 volume up/down/mute. | Volume changes and Quickshell OSD appears. |
256 -| Mic mute | Press mic mute key if available. | Mic mute toggles and OSD appears. |
257 -| Brightness keys | Press XF86 brightness up/down. | Brightness changes and OSD appears. |
258 -| Media keys | Press play/next/prev. | MPRIS action fires and OSD/status appears. |
259 -| Lock bind | Press `SUPER+ALT+L`. | Quickshell status appears, then existing lock path works. |
260 -| Reload bind | Press `SUPER+SHIFT+R`. | Hypr reloads; Quickshell status appears. |
261 -| Screenshot region | Press `Print`. | Region capture still works; Quickshell status appears. |
262 -| Screenshot annotate | Press `SUPER+Print`. | Satty annotation path still works; status appears. |
263 -| Color pick | Press `SUPER+SHIFT+Print`. | Color is copied; status appears. |
265 -## Dark/light acceptance
267 -| Check | Command/action | PASS condition |
268 -| --- | --- | --- |
269 -| Dark switch | Run Nugu switcher to dark. | Hypr, Quickshell bar, popups, notifications, launcher, OSD all dark. |
270 -| Light switch | Run Nugu switcher to light. | Same surfaces light and readable. |
271 -| Auto mode | Enable/watch current auto behavior. | Quickshell follows mode change without requiring Ironbar/Mako restart. |
272 -| GTK scheme | `gsettings get org.gnome.desktop.interface color-scheme`. | Matches `prefer-dark`/`prefer-light`. |
273 -| Contrast | Use `pastel` or visual check on critical pairs. | Small text fg/bg pairs meet target contrast or are consciously adjusted. |
275 -## Retirement acceptance
277 -Run only after all relevant parity rows pass.
279 -| Candidate | Stop command | PASS condition before disabling in dotfiles |
280 -| --- | --- | --- |
281 -| Ironbar | `systemctl --user stop ironbar.service ironbar-workspaces.service` | Quickshell bar covers all bar rows; no missing interaction. |
282 -| Mako | `systemctl --user stop mako.service` | Quickshell owns notifications and covers all notification rows. |
283 -| Hyprlauncher usage | Remove/replace binds in test branch. | `grep -R hyprlauncher hypr ironbar quickshell` finds no live-path usage except docs/history. |
284 -| Hyprshutdown usage | Replace with Quickshell power IPC. | `grep -R hyprshutdown hypr ironbar quickshell` finds no live-path usage except docs/history. |
285 -| Hyprtoolkit config | Remove after no Hyprtoolkit apps remain. | No remaining live bindings/apps consume `hyprtoolkit.conf`. |
286 -| `hyprctl notify` helpers | Replace OSD/status. | `grep -R 'hyprctl notify' hypr quickshell` finds no live helper use. |
288 -## Final resource comparison
290 -Collect after old services stopped and Quickshell settled for at least 60s:
292 -```sh
293 -ps -eo pid,pcpu,rss,comm,args | grep -E 'ironbar|mako|workspaces-watch|hyprlauncher|hyprshutdown|qs|quickshell' | grep -v grep || true
294 -systemctl --user --no-pager --plain status quickshell.service
295 -systemctl --user --no-pager --plain status ironbar.service ironbar-workspaces.service mako.service || true
296 -```
298 -PASS condition:
300 -- Old retired services inactive/disabled as intended.
301 -- Quickshell service active.
302 -- Process count is lower for companion UI.
303 -- CPU/log spam is not worse than baseline.
304 -- RSS is lower than old combined steady-state or any increase is explicitly justified by replaced functionality.

docs/super/inventory/2026-06-17-quickshell-phase-1-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 1 Verification — 2026-06-17
3 -## Commands
5 -- `dbus-run-session -- sh -lc "cd /home/oli/Workspace/dotfiles && timeout 3s qs -p quickshell/nuguland/shell.qml"`
6 -- `systemd-analyze --user verify hypr/systemd/quickshell.service`
7 -- temporary `XDG_CONFIG_HOME` named config with `qs -c nuguland`
8 -- `qs ipc -c nuguland call nuguland showDiagnostics`
9 -- `qs ipc -c nuguland call nuguland setThemeMode light`
10 -- `qs ipc -c nuguland call nuguland setThemeMode dark`
11 -- `qs ipc -c nuguland call nuguland hideDiagnostics`
12 -- `grim -g "0,0 430x170" /tmp/nugu-qs-phase1-diagnostics.png`
14 -## Results
16 -### Direct parse/start
18 -- Result: PASS. Exit `124` from timeout; config loaded; no QML parse/type errors.
19 -- Note: direct agent environment can crash Quickshell in Qt DBus before QML; known-good Quickshell examples reproduce that. Validation used `dbus-run-session` to isolate the agent DBus environment.
21 -### Direct parse stdout relevant lines
23 -```text
24 -[LOG] | Got interf INFO: Configuration Loaded
25 - WARN qt.dbus.integration: QDBusConnection: name 'org.freedesktop.portal.Desktop' had owner '' but we thought it was ':1.1'
26 - WARN qt.qpa.services: Failed to register with host portal QDBusError("org.freedesktop.portal.Error.Failed", "Could not register app ID: Connection already associated with an application ID")
27 - WARN qt.qpa.services: Failed to register with host portal QDBusError("org.freedesktop.portal.Error.Failed", "Could not register app ID: Connection already associated with an application ID")
29 -```
31 -### Direct parse stderr relevant lines
33 -```text
34 -dbus-daemon[2110678]: [session uid=1000 pid=2110678 pidfd=5] Activated service 'org.freedesktop.systemd1' failed: Process org.freedesktop.systemd1 exited with status 1
35 -dbus-daemon[2110678]: [session uid=1000 pid=2110678 pidfd=5] Activated service 'org.freedesktop.systemd1' failed: Process org.freedesktop.systemd1 exited with status 1
36 -** (xdg-desktop-portal-gtk:2110726): WARNING **: 04:13:34.466: AT-SPI: Could not obtain desktop path or name
37 -dbus-daemon[2110678]: [session uid=1000 pid=2110678 pidfd=5] Activated service 'org.freedesktop.systemd1' failed: Process org.freedesktop.systemd1 exited with status 1
38 -** (xdg-desktop-portal-gtk:2110726): WARNING **: 04:13:34.469: atk-bridge: GetRegisteredEvents returned message with unknown signature
39 -** (xdg-desktop-portal-gtk:2110726): WARNING **: 04:13:34.470: atk-bridge: get_device_events_reply: unknown signature
41 -```
43 -### Service syntax
45 -- Result: PASS. `systemd-analyze --user verify hypr/systemd/quickshell.service` exited `0` with no output.
47 -### IPC
49 -- Result: PASS. Temporary named config under temporary `XDG_CONFIG_HOME` accepted show/hide/reload/theme IPC calls; command wrapper exited `0`.
50 -- No `~/.config/quickshell` mutation was used for this validation.
52 -### IPC stderr
54 -```text
56 -```
58 -### Visual diagnostics screenshot
60 -- Result: PASS. Screenshot crop `/tmp/nugu-qs-phase1-diagnostics.png` showed the diagnostics panel.
61 -- Vision check: panel text `Quickshell Nugu · dark`, dark background, pink border, seven Nugu color swatches.
63 -### Old service status
65 -```text
66 -active
67 -active
68 -active
69 -active
70 -active
72 -```
74 -## Notes
76 -- Ironbar remained active.
77 -- Mako remained active.
78 -- Quickshell service was created in the repo but not linked/enabled live.
79 -- Temporary Quickshell processes were stopped; `pgrep -a qs` was empty after tests.
81 -## IPC syntax correction recheck
83 -During Phase 2A, the correct CLI shape was confirmed as `qs ipc -c nuguland call ...`; `qs -c nuguland ipc call ...` can launch a config instead of selecting the IPC subcommand. This record has been corrected to show the valid command shape.
85 -Recheck with temporary `XDG_CONFIG_HOME` passed:
87 -```text
88 -showDiagnostics: ok
89 -setThemeMode light: returned light
90 -setThemeMode dark: returned dark
91 -hideDiagnostics: ok
92 -pgrep -a qs: empty after cleanup
93 -```

docs/super/inventory/2026-06-17-quickshell-phase-2a-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 2A Verification — 2026-06-17
3 -## Scope
5 -Phase 2A implemented the hidden Quickshell bar shell, workspace buttons, and HH:mm clock. Ironbar/Mako remain live; no retirement happened.
7 -## Commands
9 -- `dbus-run-session -- timeout 3s qs -p quickshell/nuguland/shell.qml`
10 -- `qs ipc -c nuguland call nuguland showBar`
11 -- `qs ipc -c nuguland call nuguland setThemeMode light`
12 -- `qs ipc -c nuguland call nuguland setThemeMode dark`
13 -- `qs ipc -c nuguland call nuguland hideBar`
14 -- automated `wdotool --backend wlr-protocols` clicks on workspaces `1`, `2`, `3`, `4`, `5`, `9`
15 -- `systemctl --user --no-pager --plain is-active ironbar.service ironbar-workspaces.service mako.service`
17 -## Parse validation
19 -`qs -p quickshell/nuguland/shell.qml` under `dbus-run-session` exited `124` via timeout and printed `Configuration Loaded`.
21 -Relevant output:
23 -```text
24 -INFO: Configuration Loaded
25 -```
27 -No QML parse/type errors, no missing component errors, no `SystemClock.Minutes` errors, no `Hyprland.workspaces.values` errors.
29 -## IPC validation
31 -The correct Quickshell IPC syntax is:
33 -```sh
34 -qs ipc -c nuguland call nuguland <function>
35 -```
37 -The earlier `qs -c nuguland ipc call ...` form launches a config instead of selecting the IPC subcommand and was corrected in docs/config comments.
39 -Mode IPC returned the expected values:
41 -```text
42 -theme-initial=dark
43 -theme-light=light
44 -theme-dark=dark
45 -```
47 -Screenshots captured:
49 -- `/tmp/nugu-qs-2a-bar-dark.png`
50 -- `/tmp/nugu-qs-2a-bar-light.png`
52 -Visual check confirmed:
54 -- dark bar visible below/near Ironbar with workspaces `1`, `2`, `3`, `4`, `5`, `9`
55 -- light bar switched to light Nugu palette and remained readable
56 -- active workspace highlight visible
57 -- clock displayed `HH:mm`
58 -- Ironbar remained visible during overlap testing
60 -## Workspace click validation
62 -Automated click test output:
64 -```text
65 -original=3 cursor=487,659
66 -clicked=1 active=1
67 -clicked=2 active=2
68 -clicked=3 active=3
69 -clicked=4 active=4
70 -clicked=5 active=5
71 -clicked=9 active=9
72 -```
74 -Finding fixed during validation:
76 -- `Hyprland.dispatch("workspace N")` fails on this desktop because Hyprland is running in Lua mode.
77 -- Quickshell must dispatch Lua object syntax there: `hl.dsp.focus({ workspace = "N" })`.
78 -- `WorkspaceWidget.qml` now branches on `Hyprland.usingLua` and keeps normal dispatcher syntax for non-Lua Hyprland.
80 -## Legacy service boundary
82 -```text
83 -ironbar.service active
84 -ironbar-workspaces.service active
85 -mako.service active
86 -quickshell.service inactive/not installed live
87 -```
89 -No lingering `qs` processes remained after validation. Current workspace restored to `3` after click testing.

docs/super/inventory/2026-06-17-quickshell-phase-2b-service-api-inventory.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 2B Service/API Inventory — 2026-06-17
3 -Purpose: freeze the local API/runtime facts for Phase 2B bar status widgets before writing implementation code.
5 -Related:
7 -- [`2026-06-17-quickshell-hypr-companion-baseline.md`](2026-06-17-quickshell-hypr-companion-baseline.md)
8 -- [`2026-06-17-quickshell-parity-checklist.md`](2026-06-17-quickshell-parity-checklist.md)
9 -- [`../plans/2026-06-17-quickshell-hypr-companions-phase-2a-bar-shell.md`](../plans/2026-06-17-quickshell-hypr-companions-phase-2a-bar-shell.md)
11 -## Local runtime snapshot
13 -Commands run on the live system, non-mutating:
15 -```sh
16 -wpctl get-volume @DEFAULT_AUDIO_SINK@
17 -brightnessctl -m
18 -upower -i /org/freedesktop/UPower/devices/DisplayDevice
19 -iwctl station wlan0 show
20 -bluetoothctl show
21 -```
23 -Observed:
25 -```text
26 -wpctl: Volume: 0.30 [MUTED]
27 -brightness: intel_backlight,backlight,4261,96%,4437
28 -upower display:
29 - state: fully-charged
30 - energy-rate: 0 W
31 - percentage: 98%
32 -iwctl station wlan0 show:
33 - State connected
34 - Connected network wlan.bugabinga.net
35 - IPv4 address 192.168.178.20
36 -bluetooth show:
37 - Powered: yes
38 - Pairable: no
39 - Discovering: no
40 -```
42 -Implications:
44 -- Volume widget can validate muted state immediately.
45 -- Brightness widget should target/detect `intel_backlight` and current percent parsing is available from `brightnessctl -m`.
46 -- Battery widget can validate a visible X230 battery state immediately.
47 -- WiFi widget must use iwd, not NetworkManager.
48 -- Bluetooth widget can validate adapter-powered state immediately; connected device/battery requires paired device availability.
50 -## Quickshell ObjectModel rule
52 -Quickshell `ObjectModel` exposes a reactive list through `.values`.
54 -Use:
56 -```qml
57 -SomeService.items.values.find(item => ...)
58 -SomeService.items.values.length
59 -```
61 -Avoid assuming raw `model[index]` is reactive.
63 -## MPRIS widget API
65 -Module:
67 -```qml
68 -import Quickshell.Services.Mpris
69 -```
71 -Relevant singleton/property:
73 -- `Mpris.players`: `ObjectModel<MprisPlayer>`.
75 -Relevant `MprisPlayer` properties:
77 -- `trackTitle`: current title or `""`.
78 -- `trackArtist`: current artist or `""`.
79 -- `isPlaying`: true when playback state is playing.
80 -- `playbackState`: enum state.
81 -- `position`: seconds; not continuously reactive unless explicitly prodded, so do not poll for Phase 2B text-only widget.
82 -- `length`: track length seconds.
83 -- `volume`: player volume, not system sink volume.
84 -- `canGoNext`, `canGoPrevious`, `canTogglePlaying` for controls later.
86 -Relevant functions:
88 -- `next()`
89 -- `previous()`
90 -- `togglePlaying()`
91 -- `play()`
92 -- `pause()`
94 -Phase 2B display rule:
96 -```qml
97 -const player = Mpris.players.values.find(p => p.isPlaying) || Mpris.players.values[0] || null
98 -const text = player ? `${player.trackTitle} / ${player.trackArtist}` : ""
99 -```
101 -Current Ironbar parity:
103 -- Center text format: `{title} / {artist}`.
104 -- Truncate around 42 chars.
105 -- Idle hidden/empty.
106 -- Must avoid the current Ironbar 1Hz DBus error loop.
108 -## Pipewire volume widget API
110 -Module:
112 -```qml
113 -import Quickshell.Services.Pipewire
114 -```
116 -Relevant singleton/properties:
118 -- `Pipewire.defaultAudioSink`: default output node or `null` briefly.
119 -- `Pipewire.defaultAudioSource`: default input node or `null` briefly.
120 -- `Pipewire.nodes`: all nodes.
121 -- `Pipewire.ready`: initial sync complete.
123 -Hard requirement:
125 -```qml
126 -PwObjectTracker { objects: [ Pipewire.defaultAudioSink, Pipewire.defaultAudioSource ] }
127 -```
129 -Without a tracker, `PwNodeAudio` properties are invalid.
131 -Relevant `PwNodeAudio` properties:
133 -- `volume`: average volume; writable; real, normally `0.0..1.0` for this setup.
134 -- `muted`: writable boolean.
135 -- `volumes`: per-channel volumes.
137 -Phase 2B display/action rule:
139 -- Display current default sink volume as percent.
140 -- If muted, use muted visual state.
141 -- Scroll up: set `audio.volume = Math.min(1.0, volume + 0.02)`.
142 -- Scroll down: set `audio.volume = Math.max(0.0, volume - 0.02)`.
143 -- Right click: `audio.muted = !audio.muted`.
144 -- Middle click: open `wiremix` through command adapter.
146 -Keep external `wpctl` only as fallback if Quickshell direct writes fail in live verification.
148 -## Brightness widget API/boundary
150 -Quickshell has no documented stable backlight service in the current skill/API inventory.
152 -Use process adapter initially:
154 -- Read: `brightnessctl -m`
155 -- Parse CSV: `device,class,current,percent,max`
156 -- Current live shape: `intel_backlight,backlight,4261,96%,4437`
157 -- Scroll up: `brightnessctl -e4 -n2 set 5%+`
158 -- Scroll down: `brightnessctl -e4 -n2 set 5%-`
160 -Phase 2B requirements:
162 -- Use one polling process or timer, not per-frame.
163 -- Update after scroll commands.
164 -- Display `󰃠 {percentage}%`.
165 -- Match current Ironbar smooth-ish behavior as close as possible.
167 -## UPower battery widget API
169 -Module:
171 -```qml
172 -import Quickshell.Services.UPower
173 -```
175 -Relevant singleton/properties:
177 -- `UPower.displayDevice`: aggregate display device; may exist before ready.
178 -- `UPower.devices`: physical devices.
179 -- `UPower.onBattery`: true when discharging/running on battery.
181 -Relevant `UPowerDevice` properties:
183 -- `ready`: display device initialized.
184 -- `percentage`: percent value.
185 -- `state`: enum state.
186 -- `isLaptopBattery`: true for physical laptop battery entries in `UPower.devices`.
187 -- `timeToEmpty`, `timeToFull`: seconds.
188 -- `iconName`: system icon name.
190 -Phase 2B display/action rule:
192 -- Show only when a battery exists; X230 currently does.
193 -- Display `󰁹 {percentage}%`.
194 -- Warning <=20%.
195 -- Critical <=5% and discharging.
196 -- Left/middle click opens existing upower terminal command until a native popup is planned.
198 -## WiFi widget API/boundary
200 -Do not use Quickshell `Networking` for Phase 2B because it is NetworkManager-backed and the machine uses iwd + systemd-networkd.
202 -Use process adapter initially:
204 -- Read: `iwctl station wlan0 show`
205 -- Strip ANSI.
206 -- Connected state if line `State connected`.
207 -- Current connected network can be parsed from `Connected network` but current Ironbar only shows icon.
209 -Phase 2B display/action rule:
211 -- Connected: `󰖩`.
212 -- Disconnected/off: `󰖪 off`.
213 -- Poll interval around current Ironbar `30000ms`, or event source if later discovered.
214 -- Left/middle click opens `impala` through command adapter.
215 -- No NetworkManager dependency.
217 -## Bluetooth widget API
219 -Module:
221 -```qml
222 -import Quickshell.Bluetooth
223 -```
225 -Relevant singleton/properties:
227 -- `Bluetooth.defaultAdapter`: default adapter.
228 -- `Bluetooth.adapters`: all adapters.
229 -- `Bluetooth.devices`: all connected devices across adapters.
231 -Relevant `BluetoothAdapter` properties:
233 -- `enabled`: adapter powered/enabled.
234 -- `state`: detailed state.
235 -- `devices`: devices connected to this adapter.
236 -- `adapterId`: e.g. `hci0`.
237 -- `name`: system adapter name.
239 -Relevant `BluetoothDevice` properties:
241 -- `connected`: current connection state; writable but Phase 2B should not toggle.
242 -- `batteryAvailable`: true if battery is reported.
243 -- `battery`: `0.0..1.0` when available.
244 -- `name`, `deviceName`: display name.
245 -- `icon`: system icon.
246 -- `paired`, `trusted`, `blocked` for future management UI.
248 -Phase 2B display/action rule:
250 -- No adapter: empty string (Ironbar `not_found`).
251 -- Adapter disabled: `󰂲`.
252 -- Adapter enabled no connected devices: `󰂯`.
253 -- Connected device without battery: `󰂱`.
254 -- Connected device with battery: `󰂱 {percent}%`.
255 -- Left/middle click opens `bluetui` through command adapter.
256 -- Do not show a Bluetooth popup in Phase 2B.
258 -## CPU widget API/boundary
260 -Quickshell has no built-in CPU service in the current inventory.
262 -Use process adapter initially:
264 -- Prefer reading `/proc/stat` from QML/Process or a timer-backed `Process` command.
265 -- Update interval: current Ironbar `2s`.
266 -- Display: ` {cpu_percent:1}%`.
267 -- Left/middle click opens `btm` through command adapter.
269 -Implementation caution:
271 -- Avoid shelling out every frame.
272 -- A 2s timer with one lightweight read is acceptable.
274 -## Command adapter calls needed by Phase 2B
276 -Use one shared command service rather than per-widget shell strings.
278 -Methods needed:
280 -- `openWifi()` -> existing `wezterm start --class impala -- impala` policy.
281 -- `openBluetooth()` -> existing `wezterm start --class bluetui -- bluetui` policy.
282 -- `openSystemMonitor()` -> existing `wezterm start --class btm -- btm` policy.
283 -- `openAudioMixer()` -> existing `wezterm start --class wiremix -- wiremix` policy.
284 -- `openBattery()` -> existing upower loop command from `hypr/modules/apps.lua` until replaced.
286 -Keep exact process boundary centralized so Hypr Lua gets simpler later.
288 -## Phase 2B implementation order recommendation
290 -1. Add `CommandRunner.qml`/`Commands.qml` for external app launch boundaries.
291 -2. Add `StatusText.qml` or reuse `BarButton.qml` for compact text widgets.
292 -3. Add MPRIS widget first: no process boundary, direct Quickshell service.
293 -4. Add Pipewire volume widget: direct service and scroll/click writes.
294 -5. Add UPower battery widget: direct service.
295 -6. Add Bluetooth widget: direct service.
296 -7. Add WiFi widget: process adapter for iwd.
297 -8. Add CPU widget: timer/process adapter.
298 -9. Add brightness widget: process adapter and scroll commands.
299 -10. Validate all widgets with Ironbar still live.
301 -## Self-review
303 -- NetworkManager is explicitly excluded for WiFi.
304 -- `Quickshell.Bluetooth`, not `Quickshell.Services.Bluetooth`, is the correct Bluetooth import for v0.3.0.
305 -- Pipewire writes require `PwObjectTracker`.
306 -- MPRIS display does not need continuous position polling.
307 -- Brightness and CPU need bounded polling/process adapters because no stable Quickshell-native service was identified.

docs/super/inventory/2026-06-17-quickshell-phase-2b-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 2B Verification — 2026-06-17
3 -## Scope
5 -Phase 2B added hidden-bar status widgets for MPRIS, WiFi, Bluetooth, CPU, volume, brightness, and battery. Ironbar/Mako remain live. This is progress toward bar parity, not full companion-app parity.
7 -## Commands
9 -- `dbus-run-session -- timeout 3s qs -p quickshell/nuguland/shell.qml`
10 -- temporary `XDG_CONFIG_HOME` named config with `qs -c nuguland`
11 -- `qs ipc -c nuguland call nuguland showBar`
12 -- `qs ipc -c nuguland call nuguland setThemeMode light`
13 -- `qs ipc -c nuguland call nuguland setThemeMode dark`
14 -- `qs ipc -c nuguland call nuguland hideBar`
15 -- `wpctl get-volume @DEFAULT_AUDIO_SINK@`
16 -- `brightnessctl -m`
17 -- `upower -i /org/freedesktop/UPower/devices/battery_BAT0`
18 -- `iwctl station wlan0 show`
19 -- `bluetoothctl show`
20 -- `wdotool --backend wlr-protocols` right-click/scroll attempts
22 -## Parse validation
24 -Final parse/start validation under `dbus-run-session` exited `124` via timeout and printed `Configuration Loaded`.
26 -Relevant output:
28 -```text
29 -INFO: Configuration Loaded
30 -```
32 -No QML parse/type errors, no required-property errors, no binding loops, and no service import errors remained after fixes.
34 -Fixes found during validation:
36 -- `Commands.qml` cannot be a `QtObject` with `Process` children; it is now an invisible `Item`.
37 -- `commands: commands` in a `Variants` delegate shadowed itself; the root command object is now `commandBus`.
38 -- `StatusItem` subclasses must not redeclare inherited required `theme`; duplicate declarations caused required-property failures.
39 -- UPower `device.percentage` was normalized (`0.98`) on this host; `BatteryWidget` now normalizes `0..1` and `0..100` inputs.
41 -## Baselines
43 -```text
44 -Volume: 0.30 [MUTED]
45 -intel_backlight,backlight,4261,96%,4437
46 -battery state: fully-charged
47 -battery percentage: 98%
48 -iwd State: connected
49 -iwd Connected network: wlan.bugabinga.net
50 -bluetooth Powered: yes
51 -```
53 -## Visual validation
55 -Screenshots captured:
57 -- `/tmp/nugu-qs-2b-bar-dark.png`
58 -- `/tmp/nugu-qs-2b-bar-light.png`
59 -- `/tmp/nugu-qs-2b-battery-crop.png`
61 -Vision checks confirmed:
63 -- workspaces `1`, `2`, `3`, `4`, `5`, `9` still visible
64 -- clock visible in `HH:mm`
65 -- WiFi icon visible for connected iwd state
66 -- Bluetooth icon visible for powered adapter
67 -- CPU percent visible (`30%` at capture time)
68 -- volume visible as muted `30%`, matching `wpctl`
69 -- brightness visible as `96%`, matching `brightnessctl -m`
70 -- battery visible as `98%` after normalization fix, matching `upower`
71 -- light mode switched the Quickshell bar to a readable light Nugu palette
72 -- Ironbar remained visible above the Quickshell test bar
74 -No active MPRIS media player was visible during validation, so the media widget correctly collapsed to empty.
76 -## Interaction validation
78 -Automated pointer tests with `wdotool --backend wlr-protocols` showed:
80 -```text
81 -orig_volume=Volume: 0.30 [MUTED]
82 -after_volume_right=Volume: 0.30
83 -after_volume_right_restore=Volume: 0.30 [MUTED]
84 -```
86 -So right-click mute toggle works and was restored.
88 -Wheel verification is **not complete**:
90 -```text
91 -after_volume_scroll_-120=Volume: 0.30
92 -after_volume_scroll_120=Volume: 0.30
93 -after_brightness_scroll_-120=intel_backlight,backlight,4261,96%,4437
94 -after_brightness_scroll_120=intel_backlight,backlight,4261,96%,4437
95 -```
97 -The widget now uses `WheelHandler`, but `wdotool` did not produce effective wheel changes against the layer-shell bar in this agent session. This must be manually verified or retested with a different input tool before Phase 2B is considered fully accepted.
99 -All test changes were restored:
101 -```text
102 -Volume: 0.30 [MUTED]
103 -intel_backlight,backlight,4261,96%,4437
104 -```
106 -## Legacy service boundary
108 -```text
109 -ironbar.service active
110 -ironbar-workspaces.service active
111 -mako.service active
112 -quickshell.service inactive/not installed live
113 -```
115 -No lingering `qs` processes remained after validation.

docs/super/inventory/2026-06-17-quickshell-phase-2c-surface-api-inventory.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 2C Surface/API Inventory — 2026-06-17
3 -Purpose: freeze API/runtime facts for the last Ironbar-parity slice: tray, clipboard entry point, bind mode, notification bridge, inhibit, power popup, calendar popup, and full visual comparison.
5 -Related:
7 -- [`2026-06-17-quickshell-hypr-companion-baseline.md`](2026-06-17-quickshell-hypr-companion-baseline.md)
8 -- [`2026-06-17-quickshell-parity-checklist.md`](2026-06-17-quickshell-parity-checklist.md)
9 -- [`../plans/2026-06-17-quickshell-hypr-companions-phase-2a-bar-shell.md`](../plans/2026-06-17-quickshell-hypr-companions-phase-2a-bar-shell.md)
10 -- [`../plans/2026-06-17-quickshell-hypr-companions-phase-2b-status-widgets.md`](../plans/2026-06-17-quickshell-hypr-companions-phase-2b-status-widgets.md)
12 -## Local runtime snapshot
14 -Non-mutating commands run:
16 -```sh
17 -makoctl list | grep -c '^Notification '
18 -cliphist list | wc -l
19 -uptime -p | cut -d ' ' -f2-
20 -hyprctl instances -j
21 -hyprctl binds -j | jq 'submap check'
22 -rg 'submap|bindmode|mode' hypr/modules
23 -ps tray-ish grep
24 -```
26 -Observed:
28 -```text
29 -mako count: 0
30 -cliphist sample count: 224
31 -uptime: 4 days, 5 hours, 55 minutes
32 -hypr raw events available: yes
33 -hypr binds with submap: none
34 -hypr/modules submap/bindmode refs: none
35 -system tray-ish processes: none found by loose grep
36 -```
38 -Implications:
40 -- Notification bridge can validate zero-count state immediately; restore/dismiss need test notifications or existing history.
41 -- Clipboard picker has plenty of current `cliphist` history to test list/select.
42 -- Bind mode widget likely remains hidden/empty because no Hypr submaps are configured.
43 -- Tray implementation still matters for parity, but current live process grep did not reveal obvious tray clients; test may need a known tray app.
44 -- Inhibit duration display can be tested without changing `hypridle.conf`.
45 -- Power popup must use dry-run/confirmation for destructive actions.
47 -## System tray API
49 -Module:
51 -```qml
52 -import Quickshell.Services.SystemTray
53 -import Quickshell.Widgets
54 -```
56 -Relevant singleton/property:
58 -- `SystemTray.items`: `ObjectModel<SystemTrayItem>`.
60 -Relevant `SystemTrayItem` properties:
62 -- `id`: unique app-ish name.
63 -- `title`: application label.
64 -- `icon`: image source string usable in `Image` or `IconImage`-like display.
65 -- `status`: active/passive/attention enum.
66 -- `tooltipTitle`, `tooltipDescription`.
67 -- `hasMenu`: menu availability.
68 -- `onlyMenu`: activation does nothing; menu is primary.
69 -- `menu`: menu handle usable with `QsMenuAnchor`/`QsMenuOpener`.
71 -Relevant functions:
73 -- `activate()` for left click.
74 -- `secondaryActivate()` for middle click.
75 -- `display(parentWindow, relativeX, relativeY)` for native menu display.
76 -- `scroll(delta, horizontal)` for tray scroll forwarding.
78 -Implementation recommendation:
80 -- Phase 2C should first use `SystemTrayItem.display(barWindow, x, y)` for right-click/menu behavior because it is direct and documented.
81 -- If native menu display is ugly or insufficient, explore `QsMenuOpener`/custom menu in a later targeted task.
82 -- Icon size target: current Ironbar `14px`.
84 -## QsMenuOpener API note
86 -`QsMenuOpener` exposes `children` for a `QsMenuHandle`. The fetched v0.3.0 page describes it as a child retriever, not a direct popup opener despite the name.
88 -Properties:
90 -- `menu`: `QsMenuHandle`.
91 -- `children`: `ObjectModel<QsMenuEntry>`.
93 -Decision:
95 -- Do not assume `QsMenuOpener` opens menus by itself.
96 -- Prefer `SystemTrayItem.display(...)` for Phase 2C parity unless a custom menu is explicitly needed.
98 -## Clipboard entry/picker boundary
100 -Current Ironbar clipboard module:
102 -- Bar entry in start section.
103 -- Max items `5`.
104 -- Truncate end length `30`.
106 -Current Hypr bind frontend:
108 -```sh
109 -cliphist list | hyprlauncher --dmenu | cliphist decode | wl-copy
110 -```
112 -Phase 2C bar parity:
114 -- Add a compact clipboard entry point to the bar.
115 -- For bar parity, opening a Quickshell picker/popup is enough; full launcher/dmenu replacement is Phase 4.
116 -- Use `cliphist list` as backend.
117 -- Use `cliphist decode` + `wl-copy` to restore selected text.
119 -Backend facts:
121 -- `cliphist list` currently returns 224 rows.
122 -- Do not clear history during tests.
124 -Implementation recommendation:
126 -- Phase 2C should implement a tiny popup/panel with first 5 rows and 30-char end truncation.
127 -- Phase 4 can generalize this into the `SUPER+V` picker.
129 -## Bind mode surface
131 -Current Ironbar has a `bindmode` module, but current Hypr Lua config has no submaps/bind modes.
133 -Observed:
135 -- `hyprctl binds -j` showed no non-empty `submap` rows.
136 -- `hypr/modules/*.lua` has no `submap`/`bindmode` references.
138 -Quickshell API:
140 -- `Hyprland.rawEvent(event)` emits `HyprlandEvent` with `name`, `data`, and `parse(argumentCount)`.
142 -Decision:
144 -- Phase 2C should add a bind-mode widget that is hidden/empty by default.
145 -- It can listen for raw `submap` events if present later.
146 -- Since there is no current bind mode, parity is hidden state.
148 -## Notification status bridge
150 -Current Ironbar bridge:
152 -- Script every 5s:
153 - - `makoctl list | grep -c '^Notification '`
154 - - `0` => `󰂚`
155 - - `N > 0` => `󰂞 N`
156 -- Left click: `makoctl restore`.
157 -- Right click: `makoctl dismiss --all`.
159 -Phase 2C decision:
161 -- Keep Mako as notification daemon.
162 -- Implement a Quickshell bridge widget with bounded `makoctl` polling while Mako is still authoritative.
163 -- Native notification status without polling belongs to Phase 3.
165 -Current observed count: `0`.
167 -Validation:
169 -- With no notifications: `󰂚`.
170 -- After `notify-send`: count should become `󰂞 N` after poll.
171 -- Left click restore, right click dismiss all.
173 -## Idle inhibit API
175 -Module:
177 -```qml
178 -import Quickshell.Wayland
179 -```
181 -Type:
183 -- `IdleInhibitor`
185 -Properties:
187 -- `window`: associated window; must be non-null to enable.
188 -- `enabled`: boolean.
190 -Docs note:
192 -- Compositor usually considers a `PanelWindow` important.
193 -- Requires idle-inhibit protocol support.
195 -Current Ironbar inhibit behavior:
197 -- Durations: `00:30:00`, `01:00:00`, `02:00:00`, `inf`.
198 -- Default duration: `inf`.
199 -- On format: `󰅶 {duration}`.
200 -- Off format: `󰛊 {duration}`.
201 -- Left toggles, right cycles.
203 -Phase 2C implementation recommendation:
205 -- Attach `IdleInhibitor` to the bar `PanelWindow`.
206 -- Keep state in an `InhibitController`/widget property.
207 -- Use a `Timer` for finite durations.
208 -- Do not modify `hypridle.conf`.
210 -Validation:
212 -- Display state and duration cycle can be tested immediately.
213 -- Actual idle blocking needs a controlled short timeout or manual wait; do not change idle config just for this phase.
215 -## Power popup surface
217 -Current Ironbar popup actions:
219 -| Label | Current command |
220 -| --- | --- |
221 -| `󰐥 off` | `hyprshutdown --post-cmd "systemctl poweroff"` |
222 -| `󰜉 reboot` | `hyprshutdown --post-cmd "systemctl reboot"` |
223 -| `󰍃 out` | `hyprshutdown` |
224 -| `󰤄 sleep` | `loginctl lock-session && systemctl suspend` |
225 -| `󰌾 lock` | `hyprlock` |
227 -Architecture decision already made:
229 -- Poweroff/reboot require confirmation in Quickshell by default.
230 -- Lock can run `hyprlock`.
231 -- Sleep/logout/destructive actions must be dry-run or explicitly approved during verification.
233 -Uptime source:
235 -- Current Ironbar popup shows `up {{30000:uptime -p | cut -d ' ' -f2-}}`.
236 -- Observed uptime text: `4 days, 5 hours, 55 minutes`.
238 -Phase 2C recommendation:
240 -- Add popup with same labels and uptime line.
241 -- Use Nugu popup style and `IBM Plex Mono`/Sans as appropriate.
242 -- Use `Commands` service methods for lock/sleep/logout/poweroff/reboot dry-run/confirm boundaries.
244 -## Clock calendar popup
246 -Current Ironbar clock:
248 -- Center text `%H:%M`.
249 -- Calendar popup styled through GTK CSS.
251 -Phase 2C target:
253 -- Add popup on clock click.
254 -- Preserve existing center text.
255 -- Calendar can be a compact QML month grid if QtQuick Controls calendar is not desirable.
256 -- Must be readable in dark and light mode.
258 -Validation:
260 -- Popup opens on clock click.
261 -- Today/current/other-month/day-name colors follow Nugu semantics.
262 -- Dark/light screenshots.
264 -## Full visual comparison
266 -Phase 2C is the end of Ironbar bar parity before retirement. Required outputs:
268 -- Screenshot of current Ironbar dark mode.
269 -- Screenshot of Quickshell bar dark mode.
270 -- Screenshot of current Ironbar light mode if safely switchable.
271 -- Screenshot of Quickshell bar light mode.
272 -- Notes for deviations: either fixed or explicitly accepted.
274 -Do not stop Ironbar permanently in Phase 2C. Use temporary stop only if needed to capture Quickshell without overlap, then restart Ironbar immediately.
276 -## Phase 2C implementation order recommendation
278 -1. Add popup primitive anchored to bar buttons.
279 -2. Add clock calendar popup.
280 -3. Add clipboard entry popup backed by `cliphist` first 5 rows.
281 -4. Add bind-mode hidden widget / raw-event listener.
282 -5. Add Mako notification bridge widget.
283 -6. Add tray widget using `SystemTray.items` and `item.display(...)`.
284 -7. Add inhibit widget + `IdleInhibitor` attached to bar.
285 -8. Add power popup with confirmation/dry-run boundaries.
286 -9. Run full Ironbar-vs-Quickshell visual/interaction comparison.
287 -10. Record Phase 2C verification.
289 -## Self-review
291 -- Tray menu opening should use `SystemTrayItem.display(...)`; `QsMenuOpener` is not assumed to open menus.
292 -- Bind mode parity is hidden state because no current bind modes exist.
293 -- Notification status remains a Mako bridge until Phase 3; this keeps daemon ownership simple.
294 -- Clipboard storage remains `cliphist`.
295 -- Poweroff/reboot are confirmation-only by default.
296 -- Ironbar remains live through Phase 2C; retirement is Phase 5 only.

docs/super/inventory/2026-06-17-quickshell-phase-2c-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 2C Verification — 2026-06-17
3 -## Scope
5 -Phase 2C added remaining Ironbar bar surfaces while keeping Ironbar and Mako live: tray placeholder/forwarder, clipboard entry popup, bind-mode widget, Mako notification bridge, idle inhibit, power popup, and calendar popup.
7 -This is **not** final companion parity. Native notifications, launcher, full clipboard picker bind, OSDs, Hypr bind migration, service retirement, and Hypr config simplification remain later phases.
9 -## Commands
11 -- `dbus-run-session -- timeout 3s qs -p quickshell/nuguland/shell.qml`
12 -- temporary `XDG_CONFIG_HOME` named config with `qs -c nuguland`
13 -- `qs ipc -c nuguland call nuguland showBar`
14 -- `qs ipc -c nuguland call nuguland setThemeMode light`
15 -- `notify-send 'Nugu Phase 2C test' 'notification bridge count test'`
16 -- `makoctl dismiss --all`
17 -- `wdotool --backend wlr-protocols` for click validation
18 -- `systemctl --user --no-pager --plain is-active ironbar.service ironbar-workspaces.service mako.service`
20 -## Parse validation
22 -Final parse/start validation under `dbus-run-session` exited `124` via timeout and printed `Configuration Loaded`.
24 -Relevant output:
26 -```text
27 -INFO: Configuration Loaded
28 -```
30 -No QML parse/type errors, no required-property errors, no binding loops, and no missing component errors remained.
32 -## Fixes found during validation
34 -- Clipboard/calendar/power popovers initially used nested `PanelWindow`. Buttons toggled active state, but popups rendered behind/through app content or were not visible. Fixed by using anchored `PopupWindow` tied to the bar button and parent bar window.
35 -- Clipboard popup initially used nested `StatusItem` rows over a translucent background, causing poor readability. Fixed with opaque popup background and fixed-height clipped rows.
36 -- Calendar date numbers initially used a `QColor`/string comparison for highlight state, making non-current date contrast wrong. Fixed with explicit `highlighted` bool.
37 -- Automated clock click target shifted left after right-side widgets grew; verified calendar at actual clock position around x=540.
39 -## Visual validation
41 -Screenshots captured:
43 -- `/tmp/nugu-qs-2c-bar-dark.png`
44 -- `/tmp/nugu-qs-2c-bar-light.png`
45 -- `/tmp/nugu-qs-2c-clipboard-popup.png`
46 -- `/tmp/nugu-qs-2c-calendar-popup.png`
47 -- `/tmp/nugu-qs-2c-power-popup.png`
48 -- `/tmp/nugu-qs-2c-inhibit-on.png`
49 -- `/tmp/nugu-qs-2c-inhibit-cycle.png`
50 -- `/tmp/nugu-qs-2c-notification-count.png`
51 -- `/tmp/nugu-qs-2c-notification-empty.png`
53 -Vision checks confirmed:
55 -- dark/light bars readable with Ironbar still visible above
56 -- clipboard popup opens, shows five `cliphist` rows, and is readable with intended 30-char truncation
57 -- calendar popup opens, shows `June 2026`, weekday labels, date grid, and highlighted current day with good contrast
58 -- power popup opens, shows uptime and labels `lock`, `sleep`, `out`, `reboot`, `off`; destructive/session actions are visually muted/critical and implemented as dry-run except lock
59 -- inhibit toggles from `󰛊 inf` to active `󰅶 inf` and right-click cycles to `30m`
60 -- notification bridge shows nonzero `󰂞 1` after `notify-send` and returns to empty bell after `makoctl dismiss --all`
61 -- bind mode stays hidden because current Hypr Lua config has no submaps
62 -- tray area stays hidden because no tray clients were present during validation
64 -## Known gaps
66 -- Human visual approval is still required before Ironbar retirement.
67 -- Phase 2B wheel interactions for volume/brightness remain unproven with `wdotool`; manual or alternate input-tool verification is still required.
68 -- Tray menus need validation with a real tray client; no tray client was present during this run.
69 -- Clipboard popup is a five-row bar entry, not the full `SUPER+V` dmenu replacement; that belongs to Phase 4.
70 -- Power popup destructive actions intentionally dry-run; final logout/sleep/poweroff/reboot semantics belong to Phase 4 and require confirmation behavior.
72 -## Legacy service boundary
74 -```text
75 -ironbar.service active
76 -ironbar-workspaces.service active
77 -mako.service active
78 -quickshell.service inactive/not installed live
79 -```
81 -No lingering `qs` processes remained after validation.

docs/super/inventory/2026-06-17-quickshell-phase-3-notification-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 3 Notification Verification — 2026-06-17
3 -## Scope
5 -Phase 3 native notification daemon implementation was added, disabled by default. This phase is **not accepted** yet because live DBus ownership could not be verified from the agent shell.
7 -## Implemented files
9 -- `quickshell/nuguland/NotificationDaemon.qml`
10 -- `quickshell/nuguland/NotificationToast.qml`
11 -- `quickshell/nuguland/shell.qml` IPC loader wiring
12 -- `docs/super/plans/2026-06-17-quickshell-hypr-companions-phase-3-notification-daemon.md`
14 -## Commands
16 -- `dbus-run-session -- timeout 3s qs -p quickshell/nuguland/shell.qml`
17 -- temporary named config with `qs -c nuguland`
18 -- `qs ipc -c nuguland call nuguland enableNativeNotifications`
19 -- `notify-send 'Nugu normal' 'normal notification body'`
20 -- `qs ipc -c nuguland call nuguland nativeNotificationCount`
21 -- guarded real-session attempt with `systemctl --user stop mako.service` and cleanup trap to restart Mako
23 -## Parse validation
25 -Result: PASS.
27 -```text
28 -exit=124
29 -INFO: Configuration Loaded
30 -```
32 -The daemon is behind a disabled `Loader`, so normal Quickshell startup does not claim `org.freedesktop.Notifications` and does not fight Mako.
34 -## Isolated DBus test
36 -Result: BLOCKED.
38 -Inside `dbus-run-session`, enabling the native daemon returned `enabled`, but Quickshell could not register the notification service:
40 -```text
41 -quickshell.service.notifications: Could not register notification server at org.freedesktop.Notifications, presumably because one is already registered.
42 -Registration will be attempted again if the active service is unregistered.
43 -count1=0
44 -count3=0
45 -```
47 -## Real-session guarded test
49 -Result: BLOCKED.
51 -A guarded script stopped Mako, started temporary Quickshell, enabled native notifications, and sent `notify-send`. Cleanup restarted Mako.
53 -Quickshell failed to connect to the user DBus from this agent shell:
55 -```text
56 -quickshell.service.notifications: Could not connect to DBus. Notification service will not work.
57 -Failed to show notification: Error receiving data: Connection reset by peer
58 -```
60 -Subsequent agent-shell DBus probes also failed:
62 -```text
63 -busctl --user --list: Connection reset by peer
64 -dbus-send --session ... ListNames: org.freedesktop.DBus.Error.Disconnected
65 -notify-send: The connection is closed
66 -```
68 -The systemd user environment still advertises:
70 -```text
71 -DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus
72 -WAYLAND_DISPLAY=wayland-1
73 -XDG_CURRENT_DESKTOP=Hyprland
74 -```
76 -## Rollback / service boundary
78 -Rollback succeeded; Mako and old bar services are active:
80 -```text
81 -mako.service active
82 -ironbar.service active
83 -ironbar-workspaces.service active
84 -```
86 -No `qs` process remains.
88 -## Known gaps before Phase 3 acceptance
90 -- Need a working live user DBus test environment for Quickshell to own `org.freedesktop.Notifications` after stopping Mako.
91 -- Need `notify-send` normal/low/critical screenshots rendered by Quickshell.
92 -- Need timeout verification: low ~2500ms, normal ~6500ms, critical persistent.
93 -- Need action button/default-action tests.
94 -- Need dismiss-all and restore-history IPC verification.
95 -- Only after those pass can Mako retirement be planned.

docs/super/inventory/2026-06-17-quickshell-phase-4a-osd-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4A OSD Verification — 2026-06-17
3 -## Scope
5 -Added an independent Quickshell OSD surface and IPC methods. This is the first Phase 4 replacement target for current `hyprctl notify` wrappers, but Hypr binds are **not** migrated yet.
7 -## Implemented files
9 -- `quickshell/nuguland/Osd.qml`
10 -- `quickshell/nuguland/shell.qml` IPC wiring
11 -- `quickshell/nuguland/README.md` usage notes
13 -## Design decision
15 -The OSD is separate from the native notification daemon so Phase 4 can progress while Phase 3 live notification ownership is blocked by the agent shell DBus problem. The surface is hidden unless IPC explicitly shows it.
17 -## IPC tested
19 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
21 -```sh
22 -qs ipc -c nuguland call nuguland showOsd 'Hyprland reloaded' info
23 -qs ipc -c nuguland call nuguland showVolumeOsd 42%
24 -qs ipc -c nuguland call nuguland showBrightnessOsd 77%
25 -qs ipc -c nuguland call nuguland hideOsd
26 -```
28 -Observed returns:
30 -```text
31 -show=Hyprland reloaded
32 -volume=Volume 42%
33 -brightness=Brightness 77%
34 -```
36 -Runtime output:
38 -```text
39 -INFO: Configuration Loaded
40 -```
42 -No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
44 -## Screenshots
46 -- `/tmp/nugu-qs-osd-info.png`
47 -- `/tmp/nugu-qs-osd-volume.png`
48 -- `/tmp/nugu-qs-osd-brightness.png`
50 -Vision checks confirmed:
52 -- `Hyprland reloaded` OSD renders with dark translucent background and cyan/info border.
53 -- `Volume 42%` OSD renders clearly with Nugu dark style.
54 -- `Brightness 77%` OSD renders clearly with warning/yellow border.
56 -## Still open
58 -- Migrate `hypr/modules/hypr_osd.lua` only after OSD command wrappers are wired and tested against real key events.
59 -- Add launcher, full clipboard picker, and final power confirmation flow.
60 -- Do not retire `hyprctl notify` or old companion apps yet.

docs/super/inventory/2026-06-17-quickshell-phase-4b-launcher-app-launch-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4B Launcher App Launch Verification — 2026-06-17
3 -## Scope
5 -Verified that the native Quickshell launcher can execute a selected desktop entry via Enter. This closes the safe app-launch validation gap without launching a real app and without migrating Hypr binds.
7 -## Test design
9 -A temporary `XDG_DATA_HOME` contained a synthetic desktop entry:
11 -```ini
12 -[Desktop Entry]
13 -Type=Application
14 -Name=Nugu Launcher Smoke
15 -Comment=Temporary Quickshell launcher smoke test
16 -Exec=/tmp/.../nugu-launcher-smoke.sh
17 -Icon=utilities-terminal
18 -Terminal=false
19 -NoDisplay=false
20 -Categories=Utility;
21 -```
23 -The script only wrote `launched` to a temporary marker file. Both the desktop entry and marker were removed after validation.
25 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
27 -## Commands
29 -```sh
30 -XDG_CONFIG_HOME=<tmp-config> XDG_DATA_HOME=<tmp-data> qs -c nuguland
31 -qs ipc -c nuguland call nuguland openLauncher 'Nugu Launcher Smoke'
32 -qs ipc -c nuguland call nuguland launcherMatchCount
33 -qs ipc -c nuguland call nuguland launcherFirstMatchName
34 -wdotool --backend wlr-protocols key Return
35 -qs ipc -c nuguland call nuguland launcherVisible
36 -```
38 -Observed returns:
40 -```text
41 -open=Nugu Launcher Smoke
42 -count=1
43 -first=Nugu Launcher Smoke
44 -visible_after_enter=false
45 -launched=1
46 -```
48 -`launched=1` means the selected `.desktop` entry executed and wrote the expected marker.
50 -Runtime output:
52 -```text
53 -INFO: Configuration Loaded
54 -```
56 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
58 -## Screenshot
60 -- `/tmp/nugu-qs-launcher-app-smoke.png`
62 -Vision check confirmed:
64 -- search field contains `Nugu Launcher Smoke`
65 -- the single result is the synthetic smoke entry
66 -- style/readability are acceptable
68 -## Still open before replacing `SUPER+Space`
70 -- Live Hypr bind migration once Quickshell service is active/recoverable.
71 -- Human approval that launcher appearance is same/better than current `hyprlauncher`.

docs/super/inventory/2026-06-17-quickshell-phase-4b-launcher-keyboard-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4B Launcher Keyboard Verification — 2026-06-17
3 -## Scope
5 -Verified keyboard focus/input/escape behavior for the native Quickshell launcher. This closes part of the launcher parity gap without launching apps or migrating Hypr binds.
7 -## Test
9 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
11 -```sh
12 -qs ipc -c nuguland call nuguland openLauncher ''
13 -wdotool --backend wlr-protocols type fire
14 -qs ipc -c nuguland call nuguland launcherMatchCount
15 -qs ipc -c nuguland call nuguland launcherFirstMatchName
16 -wdotool --backend wlr-protocols key Escape
17 -qs ipc -c nuguland call nuguland launcherVisible
18 -```
20 -Observed returns:
22 -```text
23 -open=
24 -count=1
25 -first=Firefox
26 -visible_after_escape=false
27 -```
29 -Runtime output:
31 -```text
32 -INFO: Configuration Loaded
33 -```
35 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
37 -## Screenshot
39 -- `/tmp/nugu-qs-launcher-key-fire.png`
41 -Vision check confirmed:
43 -- search field contains `fire`
44 -- result is `Firefox`
45 -- launcher styling/readability are acceptable
47 -## Still open before replacing `SUPER+Space`
49 -- App launch with Enter/click needs a safe real-session validation.
50 -- Up/down keyboard selection needs validation with a query producing multiple results.
51 -- Live Hypr bind migration waits until Quickshell service is active/recoverable.

docs/super/inventory/2026-06-17-quickshell-phase-4b-launcher-navigation-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4B Launcher Navigation Verification — 2026-06-17
3 -## Scope
5 -Verified native Quickshell launcher keyboard Up/Down navigation with multiple desktop-entry results. This does not launch apps and does not migrate Hypr binds.
7 -## Test
9 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
11 -```sh
12 -qs ipc -c nuguland call nuguland openLauncher ''
13 -qs ipc -c nuguland call nuguland launcherMatchCount
14 -wdotool --backend wlr-protocols key Down
15 -wdotool --backend wlr-protocols key Up
16 -wdotool --backend wlr-protocols key Escape
17 -qs ipc -c nuguland call nuguland launcherVisible
18 -```
20 -Observed returns:
22 -```text
23 -open=
24 -count=12
25 -visible_after_escape=false
26 -```
28 -Runtime output:
30 -```text
31 -INFO: Configuration Loaded
32 -```
34 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
36 -## Screenshots
38 -- `/tmp/nugu-qs-launcher-nav-initial.png`
39 -- `/tmp/nugu-qs-launcher-nav-down.png`
40 -- `/tmp/nugu-qs-launcher-nav-up.png`
42 -Vision checks confirmed:
44 -- initial selection highlighted the first visible result
45 -- pressing Down moved highlight to the second result
46 -- pressing Up returned highlight to the first result
47 -- multiple launcher results were visible and readable
49 -## Still open before replacing `SUPER+Space`
51 -- Safe app-launch validation by Enter/click.
52 -- Live Hypr bind migration once Quickshell service is active/recoverable.

docs/super/inventory/2026-06-17-quickshell-phase-4b-launcher-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4B Launcher Verification — 2026-06-17
3 -## Scope
5 -Added a hidden native launcher surface backed by Quickshell `DesktopEntries`. This is the future `SUPER+Space` replacement for `hyprlauncher`, but the Hypr bind remains unchanged until app launch and real keyboard navigation are proven.
7 -## Implemented files
9 -- `quickshell/nuguland/Launcher.qml`
10 -- `quickshell/nuguland/shell.qml` IPC wiring
11 -- `quickshell/nuguland/README.md` usage notes
13 -## API probe
15 -Throwaway probes showed:
17 -- `DesktopEntries.applications` itself is an `UntypedObjectModel`; direct `Variants.model` use logs `Non list data ... assigned to Variants.model`.
18 -- `DesktopEntries.applications.values` works as the app list and can be filtered/sliced for `ScriptModel`.
20 -## IPC tested
22 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
24 -```sh
25 -qs ipc -c nuguland call nuguland openLauncher fire
26 -qs ipc -c nuguland call nuguland launcherVisible
27 -qs ipc -c nuguland call nuguland launcherMatchCount
28 -qs ipc -c nuguland call nuguland launcherFirstMatchName
29 -qs ipc -c nuguland call nuguland closeLauncher
30 -```
32 -Observed returns:
34 -```text
35 -open=fire
36 -visible=true
37 -count=1
38 -first=Firefox
39 -visible_after=false
40 -```
42 -Runtime output:
44 -```text
45 -INFO: Configuration Loaded
46 -```
48 -No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
50 -## Screenshot
52 -- `/tmp/nugu-qs-launcher-fire.png`
54 -Vision check confirmed:
56 -- launcher popup is visible with Nugu border/background
57 -- search field contains `fire`
58 -- filtered result shows `Firefox`
59 -- text is readable
61 -The screenshot also shows a white square near the bottom edge. Vision classified it as likely underlying/redacted background content rather than a launcher result icon or cursor.
63 -## Still open before replacing `hyprlauncher`
65 -- Real keyboard navigation: type, up/down, escape, enter.
66 -- Safe app-launch validation without disrupting the desktop.
67 -- Arbitrary command mode only if current `hyprlauncher` setup actually depends on it.
68 -- Hypr `SUPER+Space` bind migration after Quickshell service is live and recoverable.

docs/super/inventory/2026-06-17-quickshell-phase-4c-clipboard-keyboard-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4C Clipboard Keyboard Verification — 2026-06-17
3 -## Scope
5 -Verified keyboard typing and Enter selection for the full Quickshell clipboard picker. This extends the earlier IPC-only clipboard picker verification.
7 -## Test
9 -A synthetic non-secret clipboard entry was inserted for the test. The previous clipboard text was saved to a temporary file and restored afterward without printing it.
11 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
13 -```sh
14 -qs ipc -c nuguland call nuguland openClipboardPicker ''
15 -wdotool --backend wlr-protocols type <synthetic-query>
16 -qs ipc -c nuguland call nuguland clipboardPickerMatchCount
17 -qs ipc -c nuguland call nuguland clipboardPickerFirstPreview
18 -wdotool --backend wlr-protocols key Return
19 -qs ipc -c nuguland call nuguland clipboardPickerVisible
20 -```
22 -Observed returns, redacted:
24 -```text
25 -open=
26 -count=1
27 -first=[synthetic-clipboard-entry]
28 -visible_after_enter=false
29 -chosen_ok=1
30 -```
32 -`chosen_ok=1` means `wl-paste --no-newline` matched the synthetic entry after pressing Enter.
34 -Runtime output:
36 -```text
37 -INFO: Configuration Loaded
38 -```
40 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
42 -## Screenshot
44 -- `/tmp/nugu-qs-clipboard-key-filter.png`
46 -Vision check confirmed:
48 -- search field contains the synthetic query
49 -- exactly one matching synthetic row is visible and highlighted
50 -- text is readable
51 -- Nugu dark popup styling is intact
53 -## Still open before replacing `SUPER+V`
55 -- Up/down navigation with multiple clipboard matches.
56 -- Escape close behavior for the full clipboard picker.
57 -- Live Hypr bind migration once Quickshell service is active/recoverable.

docs/super/inventory/2026-06-17-quickshell-phase-4c-clipboard-navigation-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4C Clipboard Navigation Verification — 2026-06-17
3 -## Scope
5 -Verified full Quickshell clipboard picker Up/Down selection, Enter selection, and Escape close behavior with multiple matches. This extends earlier clipboard IPC and keyboard typing verification.
7 -## Test
9 -Two synthetic non-secret clipboard entries with a shared prefix were inserted:
11 -- newer synthetic entry
12 -- older synthetic entry
14 -The previous clipboard text was saved to a temporary file and restored afterward without printing it.
16 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
18 -## Commands
20 -```sh
21 -qs ipc -c nuguland call nuguland openClipboardPicker <synthetic-prefix>
22 -qs ipc -c nuguland call nuguland clipboardPickerMatchCount
23 -qs ipc -c nuguland call nuguland clipboardPickerFirstPreview
24 -wdotool --backend wlr-protocols key Down
25 -wdotool --backend wlr-protocols key Return
26 -qs ipc -c nuguland call nuguland clipboardPickerVisible
27 -qs ipc -c nuguland call nuguland openClipboardPicker <synthetic-prefix>
28 -wdotool --backend wlr-protocols key Escape
29 -qs ipc -c nuguland call nuguland clipboardPickerVisible
30 -```
32 -Observed returns, redacted:
34 -```text
35 -open=[synthetic-clipboard-entry]
36 -count=2
37 -first=[synthetic-clipboard-entry]
38 -visible_after_enter=false
39 -open2=[synthetic-clipboard-entry]
40 -visible_after_escape=false
41 -selected_expected=1
42 -```
44 -`selected_expected=1` means pressing Down then Enter selected the expected second synthetic row, and `wl-paste --no-newline` matched it.
46 -Runtime output:
48 -```text
49 -INFO: Configuration Loaded
50 -```
52 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
54 -## Screenshots
56 -- `/tmp/nugu-qs-clipboard-nav-initial.png`
57 -- `/tmp/nugu-qs-clipboard-nav-down.png`
59 -Vision checks confirmed:
61 -- two matching synthetic rows are visible
62 -- first row is highlighted initially
63 -- pressing Down moves highlight to the second row
65 -## Still open before replacing `SUPER+V`
67 -- Live Hypr bind migration once Quickshell service is active/recoverable.
68 -- Human approval that picker appearance is same/better than current `hyprlauncher --dmenu`.

docs/super/inventory/2026-06-17-quickshell-phase-4c-clipboard-picker-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4C Clipboard Picker Verification — 2026-06-17
3 -## Scope
5 -Added a full Quickshell clipboard picker IPC surface. This replaces the `hyprlauncher --dmenu` frontend path later, while keeping `cliphist` as the clipboard storage backend.
7 -## Implemented files
9 -- `quickshell/nuguland/ClipboardPicker.qml`
10 -- `quickshell/nuguland/shell.qml` IPC wiring
11 -- `quickshell/nuguland/ClipboardWidget.qml` copy input fix
12 -- `quickshell/nuguland/README.md` usage notes
14 -## Design decision
16 -Current Hypr bind uses:
18 -```sh
19 -cliphist list | hyprlauncher --dmenu | cliphist decode | wl-copy
20 -```
22 -The new picker keeps `cliphist list`, `cliphist decode`, and `wl-copy`. Only the picker frontend changes.
24 -Validation showed `cliphist decode` needs the full selected `cliphist list` line. Passing only the numeric id does not decode correctly:
26 -```text
27 -found=1 id_decode=0 line_decode=1
28 -```
30 -So both the bar clipboard popup and the full picker now pass the full selected line to `Commands.copyClipboardEntry()`.
32 -## IPC tested
34 -A synthetic non-secret clipboard entry was inserted for the test. The previous clipboard text was saved to a temporary file and restored afterward without printing it.
36 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
38 -```sh
39 -qs ipc -c nuguland call nuguland openClipboardPicker <synthetic-query>
40 -qs ipc -c nuguland call nuguland clipboardPickerVisible
41 -qs ipc -c nuguland call nuguland clipboardPickerMatchCount
42 -qs ipc -c nuguland call nuguland chooseClipboardIndex 0
43 -qs ipc -c nuguland call nuguland clipboardPickerVisible
44 -```
46 -Observed returns, redacted:
48 -```text
49 -open=[synthetic-clipboard-entry]
50 -visible=true
51 -count=1
52 -choose=[synthetic-clipboard-entry]
53 -visible_after=false
54 -chosen_ok=1
55 -```
57 -`chosen_ok=1` means `wl-paste --no-newline` matched the synthetic entry after selecting index 0.
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 after the fix.
67 -## Screenshot
69 -- `/tmp/nugu-qs-clipboard-picker.png`
71 -Vision check confirmed:
73 -- Nugu clipboard picker popup is visible.
74 -- Search field is visible.
75 -- One matching synthetic row is shown and highlighted.
76 -- Border/background style matches the other Nugu popups.
77 -- Text is readable.
79 -## Still open before replacing the live clipboard bind
81 -- Real keyboard navigation: type, up/down, escape, enter.
82 -- Live Hypr bind migration once Quickshell service is active/recoverable.
83 -- Empty-history behavior with a temporary isolated `cliphist` database if supported.

docs/super/inventory/2026-06-17-quickshell-phase-4d-power-dryrun-matrix.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4D Power Dry-Run Matrix — 2026-06-17
3 -## Scope
5 -Verified all non-lock Quickshell power menu actions remain two-step and dry-run by default. This extends earlier reboot-only power verification.
7 -## Test
9 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
11 -Actions tested:
13 -- sleep
14 -- logout
15 -- reboot
16 -- poweroff
17 -- cancel/close path
19 -Commands used the IPC surface:
21 -```sh
22 -qs ipc -c nuguland call nuguland requestPowerAction <action>
23 -qs ipc -c nuguland call nuguland pendingPowerAction
24 -qs ipc -c nuguland call nuguland confirmPowerAction
25 -qs ipc -c nuguland call nuguland lastPowerAction
26 -qs ipc -c nuguland call nuguland powerMenuVisible
27 -qs ipc -c nuguland call nuguland closePowerMenu
28 -```
30 -## Observed returns
32 -```text
33 -request_sleep=sleep
34 -pending_sleep=sleep
35 -confirm_sleep=dry-run sleep
36 -last_sleep=dry-run sleep
37 -visible_sleep=false
39 -request_logout=logout
40 -pending_logout=logout
41 -confirm_logout=dry-run logout
42 -last_logout=dry-run logout
43 -visible_logout=false
45 -request_reboot=reboot
46 -pending_reboot=reboot
47 -confirm_reboot=dry-run reboot
48 -last_reboot=dry-run reboot
49 -visible_reboot=false
51 -request_poweroff=poweroff
52 -pending_poweroff=poweroff
53 -confirm_poweroff=dry-run poweroff
54 -last_poweroff=dry-run poweroff
55 -visible_poweroff=false
57 -request_cancel=reboot
58 -pending_cancel_before=reboot
59 -visible_cancel_after=false
60 -pending_cancel_after=
61 -```
63 -Destructive process sanity check:
65 -```text
66 -pgrep -a systemctl | grep -E 'suspend|reboot|poweroff': empty
67 -pgrep -a hyprctl | grep 'dispatch exit': empty
68 -```
70 -Runtime output:
72 -```text
73 -INFO: Configuration Loaded
74 -```
76 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
78 -## Screenshot
80 -- `/tmp/nugu-qs-power-confirm-poweroff.png`
82 -Vision check confirmed:
84 -- confirmation state says `Confirm power off`
85 -- destructive/error styling is visible
86 -- cancel and confirm controls are visible
87 -- text is readable and style matches Nugu surfaces
89 -## Conclusion
91 -Power/session replacement is safe at the current gate: non-lock actions require confirmation and still dry-run. No real logout, suspend, reboot, or poweroff happened.
93 -## Still open
95 -- Live `CTRL+ALT+Delete` bind migration after Quickshell service is active/recoverable.
96 -- Real action execution, if ever enabled, requires explicit user approval and separate destructive-action validation.

docs/super/inventory/2026-06-17-quickshell-phase-4d-power-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4D Power Confirmation Verification — 2026-06-17
3 -## Scope
5 -Added a standalone Quickshell power menu IPC surface. This is the future `CTRL+ALT+Delete` replacement for `hyprshutdown --dry-run` and the Ironbar power popup. Live Hypr binds are not migrated yet.
7 -## Implemented files
9 -- `quickshell/nuguland/PowerMenu.qml`
10 -- `quickshell/nuguland/Commands.qml` confirmed power boundary
11 -- `quickshell/nuguland/shell.qml` IPC wiring
12 -- `quickshell/nuguland/README.md` usage notes
14 -## Design decision
16 -The menu includes the current action set:
18 -- lock
19 -- sleep
20 -- logout / out
21 -- reboot
22 -- poweroff / off
24 -Actions are two-step through `requestPowerAction(...)` then `confirmPowerAction()`. Confirmed non-lock actions remain dry-run by default through `Commands.executeConfirmedPowerActions: false`. This prevents accidental logout/suspend/reboot/poweroff during validation and keeps destructive execution behind explicit future approval.
26 -## IPC tested
28 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
30 -```sh
31 -qs ipc -c nuguland call nuguland openPowerMenu
32 -qs ipc -c nuguland call nuguland powerMenuVisible
33 -qs ipc -c nuguland call nuguland requestPowerAction reboot
34 -qs ipc -c nuguland call nuguland pendingPowerAction
35 -qs ipc -c nuguland call nuguland confirmPowerAction
36 -qs ipc -c nuguland call nuguland lastPowerAction
37 -qs ipc -c nuguland call nuguland powerMenuVisible
38 -```
40 -Observed returns:
42 -```text
43 -open=open
44 -visible=true
45 -request=reboot
46 -pending=reboot
47 -confirm=dry-run reboot
48 -last=dry-run reboot
49 -visible_after=false
50 -```
52 -Safety check:
54 -```text
55 -pgrep -a systemctl | grep -E 'reboot|poweroff|suspend': empty
56 -```
58 -Runtime output:
60 -```text
61 -INFO: Configuration Loaded
62 -```
64 -No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
66 -## Screenshots
68 -- `/tmp/nugu-qs-power-menu.png`
69 -- `/tmp/nugu-qs-power-confirm-reboot.png`
71 -Vision checks confirmed:
73 -- Nugu power menu shows `lock`, `sleep`, `out`, `reboot`, `off`.
74 -- Dry-run notice is visible and readable.
75 -- Reboot confirmation state shows `cancel` and `confirm reboot`.
76 -- Destructive/error styling is visible for reboot confirmation.
78 -## Still open before replacing `hyprshutdown`
80 -- Real keybind migration after Quickshell service is live/recoverable.
81 -- Decide with user when, if ever, `executeConfirmedPowerActions` may become true.
82 -- If enabled, verify logout/sleep/reboot/poweroff semantics carefully; destructive actions need explicit approval.

docs/super/inventory/2026-06-17-quickshell-phase-4e-osd-actions-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4E OSD Action Verification — 2026-06-17
3 -## Scope
5 -Added Quickshell IPC wrappers for the current `hypr/modules/hypr_osd.lua` actions. Hypr binds are not migrated yet; this creates the replacement target for later simplification.
7 -## Implemented files
9 -- `quickshell/nuguland/Commands.qml` action wrappers and `osdRequested` signal
10 -- `quickshell/nuguland/shell.qml` IPC methods and command-to-OSD connection
11 -- `quickshell/nuguland/README.md` usage notes
13 -## New IPC surface
15 -Controls:
17 -```sh
18 -qs ipc -c nuguland call nuguland osdVolumeUp
19 -qs ipc -c nuguland call nuguland osdVolumeDown
20 -qs ipc -c nuguland call nuguland osdMuteAudio
21 -qs ipc -c nuguland call nuguland osdMuteMic
22 -qs ipc -c nuguland call nuguland osdBrightnessUp
23 -qs ipc -c nuguland call nuguland osdBrightnessDown
24 -```
26 -Media/session/capture:
28 -```sh
29 -qs ipc -c nuguland call nuguland osdMediaNext
30 -qs ipc -c nuguland call nuguland osdMediaToggle
31 -qs ipc -c nuguland call nuguland osdMediaPrev
32 -qs ipc -c nuguland call nuguland osdReloadHypr
33 -qs ipc -c nuguland call nuguland osdSessionLock
34 -qs ipc -c nuguland call nuguland osdSessionSuspendDryRun
35 -qs ipc -c nuguland call nuguland osdCaptureRegion
36 -qs ipc -c nuguland call nuguland osdCaptureWindow
37 -qs ipc -c nuguland call nuguland osdCaptureOutput
38 -qs ipc -c nuguland call nuguland osdCaptureAnnotate
39 -qs ipc -c nuguland call nuguland osdPickColor
40 -```
42 -## Verification run
44 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
46 -State saved/restored:
48 -- Sink volume restored to original value.
49 -- Sink mute state restored to original value.
50 -- Backlight raw value restored to original value.
52 -Tested IPC:
54 -```text
55 -osdVolumeUp
56 -osdVolumeDown
57 -osdBrightnessDown
58 -osdBrightnessUp
59 -osdReloadHypr
60 -lastOsdAction
61 -```
63 -Observed output:
65 -```text
66 -vol_up=<command string>
67 -last1=Volume 0.32 [MUTED]
68 -vol_down=<command string>
69 -last2=Volume 0.30 [MUTED]
70 -bright_down=<command string>
71 -last3=Brightness 78%
72 -bright_up=<command string>
73 -last4=Brightness 96%
74 -reload=Hyprland reloaded
75 -last=Hyprland reloaded
76 -```
78 -After the first reload test, `hyprctl reload` stdout (`ok`) overwrote the intended OSD message. Fixed `shellOsd()` to suppress command stdout and only print the fixed OSD label on success. Retest passed:
80 -```text
81 -reload=Hyprland reloaded
82 -last=Hyprland reloaded
83 -```
85 -Runtime output:
87 -```text
88 -INFO: Configuration Loaded
89 -```
91 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
93 -## Screenshots
95 -- `/tmp/nugu-qs-osdcmd-volume.png`
96 -- `/tmp/nugu-qs-osdcmd-brightness.png`
97 -- `/tmp/nugu-qs-osdcmd-reload-fixed.png`
99 -Vision checks confirmed:
101 -- Volume OSD is compact and Nugu-styled.
102 -- Brightness OSD is compact with warning/yellow border.
103 -- Reload OSD says `Hyprland reloaded` and is readable.
105 -## Not yet accepted for bind migration
107 -- Real hardware key events not tested yet.
108 -- Media wrappers need a live MPRIS player for parity proof.
109 -- Capture/color wrappers use interactive tools and need manual/interactive validation.
110 -- `osdSessionLock` would start `hyprlock`; not run in this verification.
111 -- `osdSessionSuspendDryRun` intentionally does not suspend.

docs/super/inventory/2026-06-17-quickshell-phase-4e-osd-failure-handling-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4E OSD Failure Handling Verification — 2026-06-17
3 -## Scope
5 -Hardened OSD action IPC wrappers so failed external commands do not look like successful OSD actions. This matters for media/capture/color parity because those wrappers depend on external programs and live session state.
7 -## Implemented files
9 -- `quickshell/nuguland/Commands.qml`
10 -- `quickshell/nuguland/README.md`
12 -## Change
14 -Before this change, fixed-message wrappers set `lastOsdAction` to the intended success label before the process completed. If `playerctl` or another external command failed, `lastOsdAction` could still look successful.
16 -Now wrappers set a pending value first and update to:
18 -```text
19 -failed <action>
20 -```
22 -when the external process exits nonzero.
24 -## Verification
26 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
28 -Commands:
30 -```sh
31 -qs ipc -c nuguland call nuguland osdReloadHypr
32 -qs ipc -c nuguland call nuguland lastOsdAction
33 -qs ipc -c nuguland call nuguland osdMediaToggle
34 -qs ipc -c nuguland call nuguland lastOsdAction
35 -```
37 -Observed:
39 -```text
40 -reload=Hyprland reloaded
41 -last_reload=Hyprland reloaded
42 -media=Play/pause
43 -last_media=failed Play/pause
44 -```
46 -This is expected because no live MPRIS player is available in the validation session. Reload still succeeds and shows the intended OSD.
48 -Runtime output:
50 -```text
51 -INFO: Configuration Loaded
52 -```
54 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
56 -Screenshot:
58 -- `/tmp/nugu-qs-osd-fail-reload.png`
60 -## Boundary
62 -- This does not prove media parity; it proves failed media commands are observable instead of silently treated as success.
63 -- Media parity still needs a live MPRIS player.
64 -- Capture/color wrappers still need interactive validation.

docs/super/inventory/2026-06-17-quickshell-phase-4e-session-osd-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Phase 4E Session OSD Verification — 2026-06-17
3 -## Scope
5 -Verified the existing Quickshell session suspend dry-run OSD wrapper. This does not test real suspend and does not migrate Hypr binds.
7 -## Test
9 -Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
11 -Command:
13 -```sh
14 -qs ipc -c nuguland call nuguland osdSessionSuspendDryRun
15 -qs ipc -c nuguland call nuguland lastOsdAction
16 -qs ipc -c nuguland call nuguland lastPowerAction
17 -```
19 -Observed returns:
21 -```text
22 -suspend=Suspending
23 -last_osd=Suspending
24 -last_power=dry-run sleep
25 -power_state_marker_before=freeze,mem,disk after=freeze,mem,disk
26 -```
28 -`last_power=dry-run sleep` confirms the wrapper did not call the real suspend command. The power state marker is not a suspend detector by itself, but the command path is explicitly dry-run and no `systemctl suspend`/`loginctl lock-session` was invoked by this wrapper.
30 -Runtime output:
32 -```text
33 -INFO: Configuration Loaded
34 -```
36 -No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
38 -## Screenshot
40 -- `/tmp/nugu-qs-session-suspend-dryrun.png`
42 -Vision check confirmed:
44 -- compact Nugu OSD says `Suspending`
45 -- OSD is readable and styled consistently
46 -- this is a dry-run visual, not proof of real suspend execution
48 -## Still open
50 -- Real `SUPER+ALT+S` bind migration waits until Quickshell service is live/recoverable.
51 -- Real suspend execution needs explicit user approval and rollback expectations.
52 -- `osdSessionLock` would start `hyprlock`; it remains untested in this automated run.

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

Deleted
deleted 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/nuguland/shell.qml`
15 -- `quickshell/nuguland/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 nuguland call nuguland scaffoldState
38 -qs ipc -c nuguland call nuguland showDiagnostics
39 -qs ipc -c nuguland call nuguland showBar
40 -qs ipc -c nuguland call nuguland openLauncher fire
41 -qs ipc -c nuguland call nuguland openClipboardPicker smoke
42 -qs ipc -c nuguland call nuguland openPowerMenu
43 -qs ipc -c nuguland call nuguland showOsd Smoke info
44 -qs ipc -c nuguland call nuguland scaffoldState
45 -qs ipc -c nuguland call nuguland hideAll
46 -qs ipc -c nuguland call nuguland 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.

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

Deleted
deleted file mode 100644
1 -# Quickshell Scaffold Smoke Recheck — 2026-06-17
3 -## Scope
5 -Closed the explicit scaffold/theme verification gap from goal control data. This rechecks the current Quickshell config after Phase 2/3 work without mutating live `~/.config/quickshell`.
7 -## Commands
9 -Temporary named config setup used:
11 -```sh
12 -tmp="$(mktemp -d /tmp/nugu-qs-scaffold-smoke.XXXXXX)"
13 -mkdir -p "$tmp/quickshell"
14 -ln -s "$PWD/quickshell/nuguland" "$tmp/quickshell/nuguland"
15 -dbus-run-session -- sh /tmp/nugu-qs-scaffold-smoke-run.sh "$tmp"
16 -```
18 -IPC calls inside that session:
20 -```sh
21 -qs ipc -c nuguland call nuguland themeMode
22 -qs ipc -c nuguland call nuguland showDiagnostics
23 -qs ipc -c nuguland call nuguland setThemeMode light
24 -qs ipc -c nuguland call nuguland reloadTheme
25 -qs ipc -c nuguland call nuguland setThemeMode dark
26 -qs ipc -c nuguland call nuguland hideDiagnostics
27 -```
29 -## Results
31 -```text
32 -exit=0
33 -mode_initial=dark
34 -mode_light=light
35 -mode_after_reload=dark
36 -mode_dark=dark
37 -Configuration Loaded
38 -pgrep -a qs: empty after cleanup
39 -```
41 -Screenshots:
43 -- `/tmp/nugu-qs-scaffold-diagnostics-dark.png`
44 -- `/tmp/nugu-qs-scaffold-diagnostics-light.png`
46 -Vision checks confirmed:
48 -- diagnostics panel says `Quickshell Nugu · dark` in dark mode
49 -- diagnostics panel says `Quickshell Nugu · light` in light mode
50 -- light text/background is readable
51 -- dark panel has dark translucent background and magenta border
52 -- Ironbar remains visible above the diagnostics panel
54 -## Notes
56 -- `reloadTheme` returned to `dark` because the live Nugu cache mode is dark; this is expected.
57 -- Quickshell native notifications remain disabled by default and were not enabled for this scaffold smoke.
58 -- This does not close bar parity, notification parity, launcher/clipboard/power/OSD parity, or retirement acceptance.

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

Deleted
deleted file mode 100644
1 -# Quickshell Scaffold Smoke Runner Verification — 2026-06-17
3 -## Scope
5 -Added a self-contained scaffold smoke runner for the Nugu Quickshell config.
7 -## Implemented files
9 -- `quickshell/nuguland/smoke.sh`
10 -- `quickshell/nuguland/README.md`
12 -## Design decision
14 -The runner deliberately uses a temporary `XDG_CONFIG_HOME` and symlinks only `quickshell/nuguland` into it. That proves the config works as a named Quickshell config without mutating live `~/.config/quickshell` or requiring dorkfiles links to be installed.
16 -By default the runner wraps itself in `dbus-run-session`. This avoids the currently broken live user bus during scaffold checks while preserving Wayland display access. Set `NUGU_QS_NO_DBUS_RUN_SESSION=1` to use the caller's session bus instead.
18 -The runner verifies:
20 -- initial `scaffoldState`
21 -- diagnostics + bar visible after IPC
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
28 -- `hideAll` closes Quickshell-owned surfaces
29 -- `Configuration Loaded` appears
30 -- common QML error patterns do not appear
31 -- its own `qs` process is cleaned up
33 -It does not touch:
35 -- Ironbar
36 -- Mako
37 -- Hyprland service state
38 -- live Quickshell links
39 -- systemd units
41 -## Command
43 -```sh
44 -quickshell/nuguland/smoke.sh
45 -```
47 -## Result
49 -```text
50 -PASS nugu quickshell scaffold smoke
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"}
59 -smoke_exit=0
60 -pgrep -a qs: empty
61 -```
63 -DBus/portal startup warnings from the isolated `dbus-run-session` were present but did not affect the scaffold assertions.
65 -## Boundary after verification
67 -```text
68 -ironbar.service active
69 -ironbar-workspaces.service active
70 -mako.service active
71 -quickshell.service inactive/not-found
72 -```
74 -No Hypr config errors were present.

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

Deleted
deleted file mode 100644
1 -# Quickshell self-contained audit verification
3 -Date: 2026-06-17
5 -## Scope
7 -Add and verify a static guard for the self-contained documented Nugu Quickshell config.
9 -No live links, user services, Ironbar, Mako, Hyprland binds, or `~/.config/quickshell` were changed.
11 -## What the audit checks
13 -`quickshell/nuguland/audit.sh` checks repository state only:
15 -- required named-config files are present: `shell.qml`, `Theme.qml`, `nugu.json`, `README.md`, `MANIFEST.md`, `COMPONENTS.md`, `IPC.md`, `EXTERNALS.md`, `TRANSITIONS.md`, `SERVICE.md`, `PARITY.md`, `HYPR_MIGRATION.md`, `ROLLOUT.md`, `PERF.md`, `STYLE.md`, `SCRIPTS.md`, `audit.sh`, `smoke.sh`, `live-check.sh`, `gate.sh`.
16 -- `README.md` links the required inventories, service/parity contracts, smoke/audit/live-check gates, named config command, and IPC command form.
17 -- `MANIFEST.md` must list every direct file in `quickshell/nuguland`; orphaned or stale manifest rows fail the audit.
18 -- `SCRIPTS.md` must inventory every `*.sh` file; each script must be executable and start with `#!/bin/sh` plus `set -eu`.
19 -- `live-check.sh` is executable and audited read-only: it must not link, start, stop, enable, disable, restart, or launch `qs -c nuguland`.
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 -- `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 -- every QML component is listed in `COMPONENTS.md` with purpose and rollout status.
23 -- every `nugu` IPC method from `shell.qml` is listed in `IPC.md` with purpose and rollout status.
24 -- component, IPC, and external inventory rows reject duplicates, malformed names, thin text, and placeholder wording.
25 -- every approved executable boundary is listed in `EXTERNALS.md` with status and reason, and stale unused rows fail.
26 -- every `transitional` external command is listed in `TRANSITIONS.md` with current role and removal gate; stale transition rows fail.
27 -- future service rollout is documented in `SERVICE.md`; `hypr/systemd/quickshell.service` must start `qs -c nuguland`, and `x230.symlinks` must link both config and service.
28 -- `ROLLOUT.md` must keep approval-only cutover, rollback, DBus, old-service, and final-completion boundaries visible.
29 -- `PERF.md` must document every current polling/action process budget and the future live performance evidence gate.
30 -- `STYLE.md` must document Nugu semantic roles, IBM Plex-only fonts, no hard-coded component hex colors, and the human visual approval boundary.
31 -- replacement scope is documented in `PARITY.md`, including old companion retirement targets, non-thin row statuses/gates, valid QML replacement references, human approval, and the explicit “not complete / old tools remain authoritative” boundary.
32 -- Hypr simplification is documented in `HYPR_MIGRATION.md`; rows must cover old helper markers from the current Hypr modules and point only at existing `nugu` IPC methods.
33 -- QML imports are limited to Qt, Quickshell, and local `import "."`.
34 -- every QML component has an early decision/why comment, not just a generic file description.
35 -- QML comments do not contain unresolved TODO/stub/placeholder markers; rollout status belongs in inventories.
36 -- local resource references are audited; currently only bundled `nugu.json` is allowed via `Qt.resolvedUrl`.
37 -- live/repo path markers such as `../`, `~/.config`, and `~/.local` fail the audit.
38 -- `quickshell/nuguland/nugu.json` exists and matches `hypr/generated/nugu.json`.
39 -- critical Nugu dark/light foreground/background pairs keep at least 4.5 contrast.
40 -- executable code does not call retired companion app markers:
41 - - `hyprlauncher`
42 - - `hyprshutdown`
43 - - `hyprctl notify`
44 -- external executable dependencies are inventoried and unknown direct process-launch commands fail the audit.
45 -- transitional bridges are explicitly reported as warnings, not hidden:
46 - - `cliphist`
47 - - `makoctl`
49 -These warnings are expected during rollout and must disappear before final companion retirement.
51 -## Commands
53 -```sh
54 -cd /home/oli/Workspace/dotfiles
55 -quickshell/nuguland/audit.sh
56 -systemd-analyze --user verify hypr/systemd/quickshell.service
57 -sh -n quickshell/nuguland/smoke.sh
58 -sh -n quickshell/nuguland/live-check.sh
59 -sh -n quickshell/nuguland/gate.sh
60 -quickshell/nuguland/gate.sh
61 -pgrep -a qs || true
62 -```
64 -Observed:
66 -```text
67 -PASS nugu quickshell audit
68 -qml_files=29
69 -documented_components=29
70 -decision_comments=29
71 -ipc_methods=58
72 -documented_ipc=58
73 -documented_external_commands=25
74 -detected_external_commands=25
75 -docs_index=ok
76 -manifest_files=47
77 -manifest=ok
78 -script_files=4
79 -script_rows=4
80 -script_contract=ok
81 -live_check=ok
82 -live_check_readonly=ok
83 -smoke_contract=ok
84 -screenshot_smoke_contract=ok
85 -gate_contract=ok
86 -inventory_tables=ok
87 -transition_bridges=2
88 -transition_contract=ok
89 -service_contract=ok
90 -parity_matrix=ok
91 -parity_rows=12
92 -perf_rows=12
93 -perf_budget=ok
94 -style_font_refs=23
95 -style_hex_refs=20
96 -style_contract=ok
97 -rollout_runbook=ok
98 -hypr_migration_rows=21
99 -hypr_current_refs=8
100 -hypr_migration=ok
101 -rollout_boundary=ok
102 -contrast_pairs=12
103 -contrast_min=5.50
104 -required_files=shell.qml,Theme.qml,nugu.json,README.md,MANIFEST.md,COMPONENTS.md,IPC.md,EXTERNALS.md,TRANSITIONS.md,SERVICE.md,PARITY.md,HYPR_MIGRATION.md,ROLLOUT.md,PERF.md,STYLE.md,SCRIPTS.md,audit.sh,smoke.sh,live-check.sh,gate.sh
105 -external_commands=awk,brightnessctl,cliphist,cut,grep,head,hyprctl,hyprlock,hyprpicker,hyprshot,iwctl,loginctl,makoctl,nu,playerctl,satty,sed,sh,systemctl,upower,uptime,uwsm,wezterm,wl-copy,wpctl
106 -WARN transitional external bridge still present: cliphist
107 -WARN transitional external bridge still present: makoctl
108 -PASS nugu quickshell scaffold smoke
109 -PASS nugu quickshell audit
110 -qml_files=29
111 -documented_components=29
112 -decision_comments=29
113 -ipc_methods=58
114 -documented_ipc=58
115 -documented_external_commands=25
116 -detected_external_commands=25
117 -docs_index=ok
118 -manifest_files=47
119 -manifest=ok
120 -script_files=4
121 -script_rows=4
122 -script_contract=ok
123 -live_check=ok
124 -live_check_readonly=ok
125 -smoke_contract=ok
126 -screenshot_smoke_contract=ok
127 -gate_contract=ok
128 -inventory_tables=ok
129 -transition_bridges=2
130 -transition_contract=ok
131 -service_contract=ok
132 -parity_matrix=ok
133 -parity_rows=12
134 -perf_rows=12
135 -perf_budget=ok
136 -style_font_refs=23
137 -style_hex_refs=20
138 -style_contract=ok
139 -rollout_runbook=ok
140 -hypr_migration_rows=21
141 -hypr_current_refs=8
142 -hypr_migration=ok
143 -rollout_boundary=ok
144 -contrast_pairs=12
145 -contrast_min=5.50
146 -required_files=shell.qml,Theme.qml,nugu.json,README.md,MANIFEST.md,COMPONENTS.md,IPC.md,EXTERNALS.md,TRANSITIONS.md,SERVICE.md,PARITY.md,HYPR_MIGRATION.md,ROLLOUT.md,PERF.md,STYLE.md,SCRIPTS.md,audit.sh,smoke.sh,live-check.sh,gate.sh
147 -external_commands=awk,brightnessctl,cliphist,cut,grep,head,hyprctl,hyprlock,hyprpicker,hyprshot,iwctl,loginctl,makoctl,nu,playerctl,satty,sed,sh,systemctl,upower,uptime,uwsm,wezterm,wl-copy,wpctl
148 -WARN transitional external bridge still present: cliphist
149 -WARN transitional external bridge still present: makoctl
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
154 ---- lingering qs ---
155 -```
157 -The smoke runner now executes the audit before launching `qs -c nuguland` 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.
159 -## Boundary
161 -This improves the self-contained documented config gate only. Overall companion parity remains incomplete:
163 -- `quickshell.service` is still not live.
164 -- Ironbar and Mako remain active.
165 -- `cliphist` and `makoctl` are still known transitional bridges.
166 -- Hypr binds are not simplified until replacement IPC is proven live and approved.

docs/super/inventory/2026-06-17-quickshell-service-slice-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Service Slice Verification — 2026-06-17
3 -## Scope
5 -Adjusted the tracked future Quickshell user service before it is live. This does not link, enable, or start `quickshell.service`.
7 -## Change
9 -`hypr/systemd/quickshell.service` now uses:
11 -```ini
12 -Slice=session-graphical.slice
13 -```
15 -instead of generic `session.slice`.
17 -Reason: Quickshell will own interactive desktop companion surfaces, so it belongs with latency-sensitive session UI helpers and the existing dorkfiles `session-graphical.slice` resource policy:
19 -```ini
20 -[Slice]
21 -CPUWeight=1000
22 -IOWeight=1000
23 -MemoryLow=768M
24 -```
26 -The unit includes a comment documenting this decision.
28 -## Verification
30 -```sh
31 -cd hypr
32 -systemd-analyze --user verify systemd/quickshell.service
33 -```
35 -Result:
37 -```text
38 -verify_exit=0
39 -```
41 -Live boundary remains unchanged:
43 -```text
44 -ironbar.service active
45 -ironbar-workspaces.service active
46 -mako.service active
47 -quickshell.service inactive/not-found
48 -pgrep -a qs: empty
49 -```
51 -## Still open
53 -The live home links are still absent until explicit dorkfiles link/setup approval:
55 -- `~/.config/quickshell/nuguland`
56 -- `~/.config/systemd/user/quickshell.service`
58 -Do not enable/start the service until those links exist and the user approves live activation.

docs/super/inventory/2026-06-17-quickshell-theme-auto-verification.md

Deleted
deleted file mode 100644
1 -# Quickshell Nugu theme auto verification
3 -Date: 2026-06-17
5 -## Scope
7 -Verify the self-contained Quickshell Nugu theme can switch dark/light and return to automatic mode by reading Nugu's shared mode cache.
9 -No live services were linked, started, stopped, disabled, or retired.
11 -## Changes verified
13 -- `setThemeMode auto` now reloads from `~/.cache/nugu/mode`.
14 -- `quickshell/nuguland/smoke.sh` runs with a temporary `HOME`, `XDG_CONFIG_HOME`, and temp `~/.cache/nugu/mode`.
15 -- Status warning/critical items use semantic signal colors as pill fills with readable `content.backdrop` text. This avoids the light-mode warning text contrast failure without forking the Nugu palette.
17 -## Commands
19 -```sh
20 -cd /home/oli/Workspace/dotfiles
21 -quickshell/nuguland/smoke.sh
22 -```
24 -Observed:
26 -```text
27 -PASS nugu quickshell scaffold smoke
28 -initial={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
29 -open={"theme":"light","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
30 -auto_light=light
31 -after_reload=dark
32 -hidden={"theme":"dark","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
33 -smoke_exit=0
34 ---- lingering qs ---
35 -```
37 -No lingering `qs` process remained.
39 -## Contrast check
41 -Checked the actual status-item foreground/background pairs from `quickshell/nuguland/nugu.json` with WCAG contrast math.
43 -All checked pairs passed >= 4.5:1:
45 -- default status text
46 -- muted status text
47 -- active status fill
48 -- hover status fill
49 -- critical status fill
50 -- warning status fill
51 -- info signal text
53 -Light warning text over `ui.backdrop` would be 3.98:1, so Quickshell does not render warning status as bare text in that state.
55 -## Boundary
57 -Still not complete for the overall migration:
59 -- `quickshell.service` remains not live.
60 -- Ironbar/Mako remain active.
61 -- Hypr binds still reference old companion tools until live parity is approved.

docs/super/inventory/2026-06-17-quickshell-theme-screenshot-smoke.md

Deleted
deleted file mode 100644
1 -# Quickshell Nugu theme screenshot smoke
3 -Date: 2026-06-17
5 -## Scope
7 -Extend the existing self-contained scaffold smoke so dark/light diagnostics screenshots can be captured repeatably without linking live config or starting `quickshell.service`.
9 -No live services were started, stopped, enabled, disabled, linked, or retired.
11 -## Change
13 -`quickshell/nuguland/smoke.sh` now:
15 -- starts with temporary `HOME` and `XDG_CONFIG_HOME`, preserving live `~/.config/quickshell` and live `~/.cache/nugu/mode`;
16 -- verifies `quickshell/nuguland/nugu.json` matches `hypr/generated/nugu.json` so the self-contained palette copy cannot silently drift;
17 -- explicitly renders the scaffold in dark mode and light mode;
18 -- still verifies `setThemeMode auto` from the temp Nugu mode cache;
19 -- verifies `themeSource` reports `auto` while following the mode file and `preview` during manual dark/light previews;
20 -- verifies `themeState` exposes actual loaded Nugu token values and compares them against `quickshell/nuguland/nugu.json` in dark, light, preview, and auto states;
21 -- verifies dark/light previews are stable and not overwritten by mode-file watches until `auto` is selected again;
22 -- verifies `FileView.watchChanges` by changing the temp mode file and waiting for `themeMode` to update without explicit `reloadTheme` while source is `auto`;
23 -- applies watched mode changes from `FileView.onLoaded`, not directly from `onFileChanged`, because a minimal probe showed `text()` can still contain the old file content inside `onFileChanged` immediately after `reload()`;
24 -- optionally captures cropped scaffold screenshots when `NUGU_QS_SMOKE_SCREENSHOT_DIR` is set;
25 -- fails if either requested screenshot is empty;
26 -- fails if the dark and light screenshots are byte-identical;
27 -- crops only the focused monitor's top-left rollout region to avoid full-desktop screenshot leakage.
29 -## Commands
31 -Palette source check:
33 -```sh
34 -cd /home/oli/Workspace/dotfiles
35 -cmp -s quickshell/nuguland/nugu.json hypr/generated/nugu.json
36 -```
38 -Observed: `cmp` exit `0`.
40 -Default gate:
42 -```sh
43 -cd /home/oli/Workspace/dotfiles
44 -sh -n quickshell/nuguland/smoke.sh
45 -quickshell/nuguland/smoke.sh
46 -pgrep -a qs || true
47 -```
49 -Observed:
51 -```text
52 -PASS nugu quickshell scaffold smoke
53 -initial={"theme":"dark","themeSource":"auto","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
54 -dark_open={"theme":"dark","themeSource":"preview","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
55 -light_open={"theme":"light","themeSource":"preview","diagnostics":true,"bar":true,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
56 -auto_request=light
57 -auto_light=light
58 -auto_light_source=auto
59 -auto_watch_dark=dark
60 -auto_dark_source=auto
61 -preview_dark=dark
62 -preview_dark_source=preview
63 -preview_hold_dark=dark
64 -preview_light=light
65 -after_preview_reload=light
66 -auto_return=dark
67 -after_auto_return=dark
68 -hidden={"theme":"dark","themeSource":"auto","diagnostics":false,"bar":false,"nativeNotifications":false,"launcher":false,"clipboardPicker":false,"powerMenu":false,"pendingPower":"","lastOsd":"","lastPower":""}
69 -smoke_exit=0
70 ---- lingering qs ---
71 -```
73 -The same run printed `dark_theme_state`, `light_theme_state`, `auto_light_theme_state`, `auto_dark_theme_state`, and `auto_return_theme_state`; the smoke runner compared each exposed token against the self-contained `quickshell/nuguland/nugu.json` before reporting PASS.
75 -Screenshot gate:
77 -```sh
78 -rm -rf /tmp/nugu-qs-theme-smoke
79 -NUGU_QS_SMOKE_SCREENSHOT_DIR=/tmp/nugu-qs-theme-smoke quickshell/nuguland/smoke.sh
80 -ls -l /tmp/nugu-qs-theme-smoke
81 -cmp -s /tmp/nugu-qs-theme-smoke/nugu-qs-dark.png /tmp/nugu-qs-theme-smoke/nugu-qs-light.png; echo "cmp_exit=$?"
82 -pgrep -a qs || true
83 -```
85 -Observed:
87 -```text
88 -PASS nugu quickshell scaffold smoke
89 -auto_request=light
90 -auto_light=light
91 -auto_light_source=auto
92 -auto_watch_dark=dark
93 -auto_dark_source=auto
94 -preview_dark=dark
95 -preview_dark_source=preview
96 -preview_hold_dark=dark
97 -preview_light=light
98 -after_preview_reload=light
99 -auto_return=dark
100 -after_auto_return=dark
101 -screenshot_dark=/tmp/nugu-qs-theme-smoke/nugu-qs-dark.png
102 -screenshot_light=/tmp/nugu-qs-theme-smoke/nugu-qs-light.png
103 -smoke_exit=0
104 ---- screenshots ---
105 --rw-r--r-- 1 oli oli 26554 Jun 17 06:57 nugu-qs-dark.png
106 --rw-r--r-- 1 oli oli 25201 Jun 17 06:57 nugu-qs-light.png
107 ---- screenshot cmp ---
108 -cmp_exit=1
109 ---- lingering qs ---
110 -```
112 -Cropped image inspection confirmed both screenshots show the Nugu Quickshell top bar plus Diagnostics swatches, with visible dark/light mode text.
114 -## Boundary
116 -This only closes repeatable scaffold/theme validation. It does not prove full companion parity:
118 -- `quickshell.service` remains inactive/not linked.
119 -- Ironbar and Mako remain the live services.
120 -- Hypr binds still point at old companion helpers until replacement IPC is live/recoverable and approved.

docs/super/plans/2026-07-08-zed-nugu-theme-verification.md

Deleted
deleted file mode 100644
1 -# Zed Nugu Theme Verification Implementation Plan
3 -> **For agentic workers:** REQUIRED SUB-SKILL: Use /skill:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
5 -**Goal:** Verify and iterate `nugu/zed.nu` until Zed dark and light themes are semantically Nugu, schema-complete, pixel-verified, and text-legible.
7 -**Architecture:** Treat the official Zed theme schema as the complete list of themeable color slots, then verify live Zed screenshots cover each slot family. Use `zed.nu` as the sole source for Zed mappings and regenerate `zed/themes/nugu.json` through `just zed`; never edit generated JSON directly.
9 -**Tech Stack:** Nushell, `just`, Zed CLI, Windows PowerShell driving through `win32-drive.ps1`, ImageMagick `magick`, `pastel`, Node one-off audit scripts.
11 -**Roadmap:** None
13 -**Phase:** Single-plan implementation
15 ----
17 -## File Map
19 -- Modify: `nugu/zed.nu` — semantic mapping from Nugu palette roles to Zed theme keys.
20 -- Generated: `zed/themes/nugu.json` — created by `just zed`; do not hand-edit.
21 -- Generated evidence: `nugu/output/zed/*.json`, `nugu/output/zed-ui-*.png`, `nugu/output/zed-ui-contact-sheet.png` — rebuildable evidence.
22 -- Temporary only: `%TEMP%/zed-post-*.ps1`, `%TEMP%/zed-schema-audit.mjs`, `%TEMP%/zed-contrast-audit.mjs` — delete after use.
24 -## Task 1: Baseline build health
26 -**Files:**
28 -- Read: `nugu/zed.nu`
29 -- Generate: `nugu/output/zed/nugu.json`
30 -- Generate: `zed/themes/nugu.json`
32 -- [ ] **Step 1: Check git state before work**
34 -Run from `nugu/`:
36 -```bash
37 -git status --short
38 -```
40 -Expected: existing unrelated dirty files are visible and not touched. Known unrelated dirty entries may include `../zed/settings.json`, `../pi/...`, and current `zed.nu` / generated theme work.
42 -- [ ] **Step 2: Run lint**
44 -```bash
45 -just lint
46 -```
48 -Expected: all `nu-check` commands print `true`; command exits `0`.
50 -- [ ] **Step 3: Run base palette checks**
52 -```bash
53 -just check
54 -```
56 -Expected:
58 -```text
59 -WCAG AA: dark theme
60 - ✓ all colors pass
62 -WCAG AA: light theme
63 - ✓ all colors pass
64 -```
66 -- [ ] **Step 4: Regenerate the Zed theme**
68 -```bash
69 -just zed
70 -```
72 -Expected: command exits `0` and writes both:
74 -```text
75 -output/zed/nugu.json
76 -../zed/themes/nugu.json
77 -```
79 -## Task 2: Official Zed schema coverage
81 -**Files:**
83 -- Read: `output/zed/nugu.json`
84 -- Fetch: `https://zed.dev/schema/themes/v0.2.0.json`
85 -- Modify if needed: `zed.nu`
87 -- [ ] **Step 1: Run schema-key audit**
89 -Create `%TEMP%/zed-schema-audit.mjs` with this content:
91 -```javascript
92 -import fs from 'node:fs';
93 -import https from 'node:https';
95 -const get = (url) => new Promise((resolve, reject) => {
96 - https.get(url, (response) => {
97 - let body = '';
98 - response.setEncoding('utf8');
99 - response.on('data', (chunk) => body += chunk);
100 - response.on('end', () => resolve(body));
101 - }).on('error', reject);
102 -});
104 -const schema = JSON.parse(await get('https://zed.dev/schema/themes/v0.2.0.json'));
105 -const generated = JSON.parse(fs.readFileSync('output/zed/nugu.json', 'utf8'));
106 -const properties = schema.definitions.ThemeStyleContent.properties;
107 -const skip = new Set(['accents', 'background.appearance', 'players', 'syntax']);
108 -const schemaColorKeys = Object.entries(properties)
109 - .filter(([key, value]) => !skip.has(key) && JSON.stringify(value).includes('"string"'))
110 - .map(([key]) => key)
111 - .sort();
113 -let failed = false;
114 -for (const theme of generated.themes) {
115 - const keys = new Set(Object.keys(theme.style)
116 - .filter((key) => !skip.has(key) && key !== 'players' && key !== 'syntax'));
117 - const missing = schemaColorKeys.filter((key) => !keys.has(key));
118 - const extra = [...keys].filter((key) => !schemaColorKeys.includes(key)).sort();
119 - console.log(`${theme.name}: schema color keys=${schemaColorKeys.length} present=${keys.size} missing=${missing.length} extra=${extra.length}`);
120 - for (const key of missing) console.log(`missing ${key}`);
121 - for (const key of extra) console.log(`extra ${key}`);
122 - failed ||= missing.length > 0 || extra.length > 0;
124 -process.exit(failed ? 1 : 0);
125 -```
127 -Run:
129 -```bash
130 -node "$TEMP/zed-schema-audit.mjs"
131 -```
133 -Expected:
135 -```text
136 -Nugu Dark: schema color keys=138 present=138 missing=0 extra=0
137 -Nugu Light: schema color keys=138 present=138 missing=0 extra=0
138 -```
140 -- [ ] **Step 2: Fix missing keys semantically**
142 -If missing keys exist, edit `zed.nu` only. Map them by Nugu semantics:
144 -```text
145 -editor/document local focus -> content.focus or ui.accent with alpha
146 -panel structure -> ui.unfocus/ui.minor/ui.accent
147 -terminal background -> content.backdrop
148 -hidden/ignored -> content.minor/ui.unfocus with subdued alpha
149 -pane/group borders -> ui.unfocus or ui.accent for focus
150 -```
152 -Then rerun:
154 -```bash
155 -just zed
156 -node "$TEMP/zed-schema-audit.mjs"
157 -```
159 -Expected: no missing or extra schema color keys.
161 -## Task 3: Pastel legibility audit
163 -**Files:**
165 -- Read: `output/zed/nugu.json`
166 -- Modify if needed: `zed.nu`
168 -- [ ] **Step 1: Run focused contrast audit**
170 -Create `%TEMP%/zed-contrast-audit.mjs` with this content:
172 -```javascript
173 -import fs from 'node:fs';
174 -import { execFileSync } from 'node:child_process';
176 -const theme = JSON.parse(fs.readFileSync('output/zed/nugu.json', 'utf8'));
177 -const luminanceCache = new Map();
178 -const isHex = (color) => typeof color === 'string' && /^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/.test(color);
179 -const rgb = (color) => [1, 3, 5].map((index) => parseInt(color.slice(index, index + 2), 16));
180 -const blend = (foreground, background) => {
181 - if (!isHex(foreground) || !isHex(background)) return foreground;
182 - const alpha = foreground.length === 9 ? parseInt(foreground.slice(7, 9), 16) / 255 : 1;
183 - const fg = rgb(foreground);
184 - const bg = rgb(background);
185 - return '#' + fg
186 - .map((value, index) => Math.round(value * alpha + bg[index] * (1 - alpha)).toString(16).padStart(2, '0'))
187 - .join('');
188 -};
189 -const luminance = (color) => {
190 - color = color.slice(0, 7).toLowerCase();
191 - if (!luminanceCache.has(color)) {
192 - luminanceCache.set(color, Number(execFileSync('pastel', ['format', 'luminance', color], { encoding: 'utf8' }).trim()));
193 - }
194 - return luminanceCache.get(color);
195 -};
196 -const contrast = (foreground, background) => {
197 - const effectiveForeground = blend(foreground, background);
198 - const a = luminance(effectiveForeground);
199 - const b = luminance(background);
200 - return (Math.max(a, b) + 0.05) / (Math.min(a, b) + 0.05);
201 -};
203 -let failed = false;
204 -for (const themeEntry of theme.themes) {
205 - const style = themeEntry.style;
206 - const uiBase = style['panel.background'];
207 - const editorBase = style['editor.background'];
208 - const terminalBase = style['terminal.background'];
209 - const checks = [];
211 - for (const foreground of ['text', 'text.muted', 'text.placeholder', 'text.disabled', 'text.accent', 'icon', 'icon.muted', 'icon.disabled', 'icon.placeholder', 'icon.accent']) {
212 - for (const background of ['background', 'surface.background', 'elevated_surface.background', 'panel.background', 'toolbar.background', 'tab_bar.background', 'status_bar.background']) {
213 - checks.push([foreground, style[foreground], background, style[background]]);
214 - }
215 - }
217 - for (const background of ['element.hover', 'element.active', 'element.selected', 'ghost_element.hover', 'ghost_element.active', 'ghost_element.selected']) {
218 - checks.push(['text', style.text, background, blend(style[background], uiBase)]);
219 - }
221 - const editorBackgrounds = [
222 - ['editor', editorBase],
223 - ['editor.active_line', blend(style['editor.active_line.background'], editorBase)],
224 - ['editor.highlighted_line', blend(style['editor.highlighted_line.background'], editorBase)],
225 - ];
226 - const editorForegrounds = [
227 - ['editor.foreground', style['editor.foreground']],
228 - ['editor.line_number', style['editor.line_number']],
229 - ['editor.active_line_number', style['editor.active_line_number']],
230 - ...Object.entries(style.syntax).map(([key, value]) => [`syntax.${key}`, value.color]),
231 - ];
232 - for (const [foregroundName, foreground] of editorForegrounds) {
233 - for (const [backgroundName, background] of editorBackgrounds) {
234 - checks.push([foregroundName, foreground, backgroundName, background]);
235 - }
236 - }
238 - for (const [key, value] of Object.entries(style)) {
239 - const isTerminalText = ['terminal.foreground', 'terminal.bright_foreground', 'terminal.dim_foreground'].includes(key)
240 - || (key.startsWith('terminal.ansi.') && key !== 'terminal.ansi.background');
241 - if (isHex(value) && isTerminalText) checks.push([key, value, 'terminal', terminalBase]);
242 - }
244 - const failures = [];
245 - let minimum = [999, '', '', '', ''];
246 - for (const [foregroundName, foreground, backgroundName, background] of checks) {
247 - if (!isHex(foreground) || !isHex(background)) continue;
248 - const ratio = contrast(foreground, background);
249 - if (ratio < minimum[0]) minimum = [ratio, foregroundName, foreground, backgroundName, background];
250 - if (ratio < 4.5) failures.push([ratio, foregroundName, foreground, backgroundName, background]);
251 - }
253 - console.log(`${themeEntry.name}: checks=${checks.length} failures=${failures.length} min=${minimum[0].toFixed(2)} ${minimum[1]} ${minimum[2]} on ${minimum[3]} ${minimum[4]}`);
254 - for (const failure of failures) {
255 - console.log(`FAIL ${failure[0].toFixed(2)} ${failure[1]} ${failure[2]} on ${failure[3]} ${failure[4]}`);
256 - }
257 - failed ||= failures.length > 0;
259 -process.exit(failed ? 1 : 0);
260 -```
262 -Run:
264 -```bash
265 -node "$TEMP/zed-contrast-audit.mjs"
266 -```
268 -Expected: both themes report `failures=0`; minimum ratio must be at least `4.50`.
270 -- [ ] **Step 2: Fix contrast failures semantically**
272 -If failures appear, edit `zed.nu` only. Prefer changing alpha or existing semantic role selection over adding custom color literals. Regenerate and rerun:
274 -```bash
275 -just zed
276 -node "$TEMP/zed-contrast-audit.mjs"
277 -```
279 -Expected: no focused text-placement contrast failures.
281 -## Task 4: Drive Zed dark and light UI state matrix
283 -**Files:**
285 -- Generate screenshots in `nugu/output/`
286 -- Do not modify user files from inside Zed.
288 -- [ ] **Step 1: Create direct-message helper scripts**
290 -Create three temporary PowerShell helpers in `%TEMP%`:
292 -`%TEMP%/zed-post-f1.ps1`:
294 -```powershell
295 -param([int64]$Hwnd)
296 -Add-Type -Namespace W -Name U -MemberDefinition @'
297 -[DllImport("user32.dll")] public static extern bool PostMessage(IntPtr hWnd, uint Msg, UIntPtr wParam, IntPtr lParam);
298 -'@
299 -$h=[IntPtr]$Hwnd; $wp=[UIntPtr]::new([uint64]0x70)
300 -[W.U]::PostMessage($h,0x0100,$wp,[IntPtr]0x003B0001)|Out-Null; Start-Sleep -Milliseconds 80; [W.U]::PostMessage($h,0x0101,$wp,[IntPtr]0xC03B0001)|Out-Null
301 -```
303 -`%TEMP%/zed-post-esc.ps1`:
305 -```powershell
306 -param([int64]$Hwnd)
307 -Add-Type -Namespace W -Name U -MemberDefinition @'
308 -[DllImport("user32.dll")] public static extern bool PostMessage(IntPtr hWnd, uint Msg, UIntPtr wParam, IntPtr lParam);
309 -'@
310 -$h=[IntPtr]$Hwnd; $wp=[UIntPtr]::new([uint64]0x1B)
311 -[W.U]::PostMessage($h,0x0100,$wp,[IntPtr]0x00010001)|Out-Null; Start-Sleep -Milliseconds 80; [W.U]::PostMessage($h,0x0101,$wp,[IntPtr]0xC0010001)|Out-Null
312 -```
314 -`%TEMP%/zed-post-text.ps1`:
316 -```powershell
317 -param([int64]$Hwnd, [string]$Text, [switch]$Enter)
318 -Add-Type -Namespace W -Name U -MemberDefinition @'
319 -[DllImport("user32.dll")] public static extern bool PostMessage(IntPtr hWnd, uint Msg, UIntPtr wParam, IntPtr lParam);
320 -'@
321 -$h=[IntPtr]$Hwnd
322 -foreach ($ch in $Text.ToCharArray()) { [W.U]::PostMessage($h,0x0102,[UIntPtr]::new([uint64][int][char]$ch),[IntPtr]1)|Out-Null; Start-Sleep -Milliseconds 15 }
323 -if ($Enter) { $wp=[UIntPtr]::new([uint64]0x0D); [W.U]::PostMessage($h,0x0100,$wp,[IntPtr]0x001C0001)|Out-Null; Start-Sleep -Milliseconds 80; [W.U]::PostMessage($h,0x0101,$wp,[IntPtr]0xC01C0001)|Out-Null }
324 -```
326 -- [ ] **Step 2: Open a disposable Zed verification window**
328 -```bash
329 -zed -n C:/Users/okr/Workspace/dotfiles/nugu/zed.nu >/tmp/zed-nugu-verification.log 2>&1 &
330 -sleep 3
331 -powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/okr/.pi/agent/skills/win32-drive/scripts/win32-drive.ps1 list
332 -```
334 -Expected: a Zed window with title containing `zed.nu` appears. Store its HWND in a shell variable for later commands.
336 -- [ ] **Step 3: Capture dark state matrix**
338 -For mode `dark`, capture these files:
340 -```text
341 -output/zed-ui-dark-editor-content.png
342 -output/zed-ui-dark-project.png
343 -output/zed-ui-dark-command-palette.png
344 -output/zed-ui-dark-file-finder.png
345 -output/zed-ui-dark-terminal.png
346 -output/zed-ui-dark-buffer-search.png
347 -output/zed-ui-dark-diagnostics.png
348 -output/zed-ui-dark-git-panel.png
349 -output/zed-ui-dark-outline-panel.png
350 -output/zed-ui-dark-theme-selector.png
351 -output/zed-ui-dark-context-menu.png
352 -```
354 -Use command palette queries for the named surfaces:
356 -```text
357 -file finder toggle
358 -terminal panel toggle
359 -buffer search deploy
360 -diagnostics deploy
361 -git panel toggle focus
362 -outline panel toggle focus
363 -theme selector toggle
364 -editor open context menu
365 -```
367 -After each capture, dismiss transient UI with `%TEMP%/zed-post-esc.ps1` before opening the next state. If a command name does not exist in Zed 1.9, record the screenshot showing the no-match command palette and add the exact missing command to the final report.
369 -- [ ] **Step 4: Capture light state matrix**
371 -Repeat Step 3 with Windows app theme set to light and write the same filenames with `light` replacing `dark`.
373 -- [ ] **Step 5: Restore host state**
375 -```bash
376 -powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/okr/.pi/agent/skills/win32-drive/scripts/win32-drive.ps1 theme -Mode light -Scope apps
377 -powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:/Users/okr/.pi/agent/skills/win32-drive/scripts/win32-drive.ps1 window -Hwnd "$HWND" -Action close
378 -rm -f "$TEMP/zed-post-f1.ps1" "$TEMP/zed-post-esc.ps1" "$TEMP/zed-post-text.ps1"
379 -```
381 -Expected: temporary Zed window closes; the user's pre-existing Zed window remains.
383 -## Task 5: Pixel sampling and visual evidence
385 -**Files:**
387 -- Read screenshots from `nugu/output/zed-ui-*.png`
388 -- Generate: `nugu/output/zed-ui-contact-sheet.png`
390 -- [ ] **Step 1: Sample representative pixels**
392 -For every screenshot captured in Task 4, sample these coordinates:
394 -```bash
395 -for img in output/zed-ui-*.png; do
396 - echo "$img"
397 - for p in '500,200' '30,80' '1300,85' '1300,118' '1440,84' '2400,1380'; do
398 - printf '%s ' "$p"
399 - magick "$img" -format "%[pixel:p{$p}]\n" info:
400 - done
401 -done
402 -```
404 -Expected: dark screenshots use Nugu dark semantic backgrounds (`#121212`, `#242424`, focused blends); light screenshots use Nugu light semantic backgrounds (`#ededed`, `#dbdbdb`, focused blends). No light screenshot should show dark terminal/editor backgrounds, and no dark screenshot should show light terminal/editor backgrounds.
406 -- [ ] **Step 2: Create contact sheet**
408 -```bash
409 -magick montage output/zed-ui-dark-*.png output/zed-ui-light-*.png \
410 - -thumbnail 640x348 -tile 4x -geometry +8+8 -background '#000000' \
411 - output/zed-ui-contact-sheet.png
412 -```
414 -Expected: a readable contact sheet with all captured dark/light states.
416 -- [ ] **Step 3: Review screenshots visually**
418 -Read `output/zed-ui-contact-sheet.png` and each screenshot that looks suspicious. Concrete failures requiring iteration:
420 -```text
421 -mode mismatch: a light screenshot uses dark editor/terminal/panel backgrounds or reverse
422 -illegible text: visible labels cannot be read at normal screenshot size
423 -semantic mismatch: errors/warnings/info/success/focus use wrong Nugu semantic family
424 -flat UI failure: elevated menus cannot be distinguished from the underlying surface
425 -```
427 -If a failure appears, return to Task 3 Step 2 or Task 4 Step 3 after editing `zed.nu`.
429 -## Task 6: Final verification and cleanup
431 -**Files:**
433 -- Read: `zed.nu`, `zed/themes/nugu.json`, `output/zed/nugu.json`
435 -- [ ] **Step 1: Run final build checks without deleting screenshot evidence**
437 -Do not run `just zed` after Task 4, because that recipe rebuilds `output/` and deletes screenshot evidence. `just zed` already ran before screenshot capture. Run:
439 -```bash
440 -just lint
441 -just check
442 -node "$TEMP/zed-schema-audit.mjs"
443 -node "$TEMP/zed-contrast-audit.mjs"
444 -```
446 -Expected: all commands exit `0`; schema coverage reports `missing=0 extra=0`; contrast audit reports `failures=0`.
448 -- [ ] **Step 2: Check for accidental injected text**
450 -```bash
451 -! grep -n 'Stashed changes\|>>>>>>>' zed.nu ../zed/themes/nugu.json
452 -```
454 -Expected: no matches.
456 -- [ ] **Step 3: Remove temporary scripts**
458 -```bash
459 -rm -f "$TEMP/zed-schema-audit.mjs" "$TEMP/zed-contrast-audit.mjs" "$TEMP/zed-post-f1.ps1" "$TEMP/zed-post-esc.ps1" "$TEMP/zed-post-text.ps1"
460 -```
462 -Expected: no temporary audit/drive scripts remain.
464 -- [ ] **Step 4: Record final git state**
466 -```bash
467 -git status --short
468 -```
470 -Expected: only intended `nugu/zed.nu` and generated `zed/themes/nugu.json` changes are attributable to this goal; unrelated dirty files remain untouched.
472 -- [ ] **Step 5: Report evidence, not completion**
474 -Report:
476 -```text
477 -changed files
478 -schema audit result
479 -pastel contrast audit result
480 -screenshot list
481 -pixel-sample summary
482 -remaining subjective concerns or missing Zed commands
483 -```
485 -Do not call the standing goal complete unless a judge review confirms the objective is satisfied.
487 -## Current open visual review findings
489 -These are not completion criteria reductions; they are concrete blockers observed after expanded dark/light Zed driving:
491 -- Done in current iteration: semantic role split from Nugu roles, without hardcoded app colors: selection/navigation = `ui.focus`, primary/action/accent = `ui.accent`, content syntax accent = `content.accent`, git/diff/diagnostic remain status roles (`created`, `modified`, `deleted`, `warning`, `error`).
492 -- Done in current iteration: focused dark/light Git diff, gutter, minimap screenshots and pixel samples were captured after final `just zed`.
493 -- Done in current iteration: stronger structural borders now use `ui.minor`; active line moved to panel alpha `34`; status/diff backgrounds use mode-specific low alpha (`10` dark, `06` light) so syntax over diff/status backgrounds remains WCAG-legible.
494 -- Done in current iteration: strict generated audit now includes syntax tokens over conflict/created/deleted/error/hint/info/modified/renamed/success/warning backgrounds; current result is 444 checks per theme, 0 failures.
495 -- Done in current iteration: hierarchy pass strengthened `border.transparent` to alpha `80`, dark elevated surface to `ui.minor` alpha `34`, dark active line to panel alpha `40`, and active line number to the selection/focus semantic role.
496 -- Done in current iteration: scrollbar roles now use UI semantics (`ui.unfocus` thumb, `ui.minor` hover, `ui.minor` borders) instead of content-muted text roles.
497 -- Done in current iteration: light elevated surface increased to max contrast-safe `ui.minor` alpha `28`; dark stays `34`. Accent/text contrast over elevated surfaces remains >= 4.5.
498 -- Done in current iteration: `border.transparent` reduced to alpha `60` after visual review showed Zed reuses it as filled diff/hunk surface; this reduces non-border wash while preserving stronger structure than the old `40`.
499 -- Done in current iteration: dark active-line background increased to contrast-safe panel alpha `80`; light active-line background stayed at `34` because alpha `40+` fails strict syntax-over-active-line contrast.
500 -- Done in current iteration: active-line number moved from `ui.focus` to `ui.important_local`, improving cursor-line salience while staying semantic UI Nugu.
501 -- Done in current iteration: strict generated audit includes syntax over active-line/status/diff backgrounds; current result is 434 checks per theme, 0 failures, min dark 4.53 and light 4.52.
502 -- Done in current iteration: live Zed v0.2 schema search confirmed no `notification`, `minimap`, `diff`, `hunk`, or `git` color keys; only `editor.gutter.background`, shared status roles, and `scrollbar.*` are available for those visual areas.
503 -- Done in current iteration: scrollbar roles were made solid UI-semantic values (`ui.unfocus` thumb, `ui.minor` hover/border, `ui.minor` alpha `60` track border) instead of translucent approximations; focused review says scrollbar/minimap boundary is now legible in both modes.
504 -- Done in current iteration: added targeted elevated-surface audit for status/action foregrounds over `elevated_surface.background`; old elevated alphas failed (`error/deleted` in dark; `error/deleted/warning/info/hint` in light).
505 -- Done in current iteration: elevated surface changed to the contrast-safe semantic ceiling: dark `ui.minor` alpha `2c`, light `ui.minor` alpha `04`; targeted elevated status/action audit now passes.
506 -- Done in current iteration: established strict audit still passes after the elevated adjustment: 434 checks per theme, 0 failures, min dark 4.53 and light 4.52.
507 -- Done in current iteration: `border.transparent` reduced from semantic `ui.minor` alpha `60` to alpha `20`, while `border.disabled` remains alpha `60`; RED audit verifies transparent border is weaker than disabled border.
508 -- Done in current iteration: schema + strict contrast + elevated action checks still pass after the `border.transparent` reduction: 446 checks per theme, 0 failures, min dark 4.53 and light 4.52.
509 -- Done in current iteration: focused visual review says the alpha `20` transparent border is a clear win for dense diff/status row clarity and notification action separation.
510 -- Done in current iteration: `border.transparent` moved from alpha `20` to true alpha `00`; RED audit verifies transparent border is fully transparent and weaker than disabled border.
511 -- Done in current iteration: active-line number moved one semantic step stronger from `ui.important_local` to `ui.important_global` to recover cursor/row findability after true-transparent borders.
512 -- Done in current iteration: schema + strict contrast + elevated action checks still pass after the `border.transparent=00` and active-line-number changes: 446 checks per theme, 0 failures, min dark 4.53 and light 4.52.
513 -- Done in current iteration: focused visual review says true-transparent borders improve dense diff/status row grouping and the stronger active-line number recovers row findability.
514 -- Done in current iteration: inactive editor line numbers now use `ui.minor` instead of `content.minor`, because editor gutters are UI chrome; RED audit verifies line numbers no longer reuse content comment/muted syntax color.
515 -- Done in current iteration: schema + strict contrast + elevated action checks still pass after the line-number semantic change: 446 checks per theme, 0 failures, min dark 4.53 and light 4.52.
516 -- Done in current iteration: focused visual review says inactive gutter quietness and active-line-number hierarchy are improved in both modes.
517 -- Done in current iteration: schema audit proves Zed v0.2 has no dedicated `git`, `diff`, `source`, `scm`, `hunk`, `minimap`, `counter`, `added`, or `removed` color keys; exposed related knobs are only `editor.gutter.background`, shared status roles, `scrollbar.*`, and `status_bar.background`.
518 -- Done in current iteration: scrollbar thumb background moved from `ui.unfocus` to `ui.minor` because a visible scrollbar/minimap thumb is active UI chrome, not merely unfocused decoration; RED audit verifies dark `#9d9d9d`, light `#292929`.
519 -- Done in current iteration: active-line background alpha moved to the contrast-safe semantic panel ceiling: dark `#242424cd`, light `#dbdbdb3f`; RED audit verifies generated values.
520 -- Done in current iteration: schema + strict contrast + elevated action checks still pass after scrollbar and active-line changes: 446 checks per theme, 0 failures, min dark 4.53 and light 4.52.
521 -- Done in current iteration: fresh driven screenshots/pixels were recaptured after final `just zed`; sampled values include dark active line `#202020`, light active line `#e9e9e9`, dark scrollbar thumb `#9d9d9d`, and light scrollbar thumb `#292929`.
522 -- Focused visual review says scrollbar/minimap separation and active/current-line visibility are improved, with source-control diff counters legible in the final capture.
523 -- Done in current iteration: rebuilt baseline remained green (`just lint`, `just check`, `just zed`) before further changes.
524 -- Done in current iteration: recaptured current dark/light editor, notification, SCM, and focused diff screenshots after rebuild; `output/` had been wiped by `just zed` so old screenshots were not reused.
525 -- Done in current iteration: current screenshot review disproved two earlier blockers: notification parity now has proper dark/light themed surface/text, and SCM file/subpath hierarchy is readable in both modes.
526 -- Done in current iteration: expanded pastel audit found a concrete light-mode AA failure for Zed `modified`/`renamed` foregrounds on panel surfaces when they reused global `warning` (`#6e6c10` on `#dbdbdb`, contrast 3.97).
527 -- Done in current iteration: `modified` and `renamed` now use semantic `ui.important_local` instead of diagnostic `warning`; Git modified/renamed are local UI state, not warnings. RED audit verifies dark `#c9b6eb`, light `#604980`, and >= 4.5 contrast on panel surfaces.
528 -- Done in current iteration: schema + strict contrast + modified/renamed panel checks pass after the remap: schema 138/138, 0 missing/extra; strict audit 464 checks per theme, 0 failures, min dark 4.53 and light 4.52.
529 -- Done in current iteration: fresh post-remap screenshots and pixel samples show modified gutter markers now use dark `#c9b6eb` and light `#604980`, while created/deleted keep status roles.
530 -- Done in current iteration: baseline/build subgoal was rerun before new work: `git status --short`, `just lint`, `just check`, and `just zed`.
531 -- Done in current iteration: created a disposable conflict/diagnostic workspace under `output/zed-diagnostics-workspace` with an actual unresolved git merge conflict plus invalid `broken.json`; used it only for screenshots/pixel probes.
532 -- Done in current iteration: drove Zed dark/light on conflict and invalid JSON files, including command palette filtered to `diagnostic`; captured `output/zed-ui-diagnostics-conflict-contact-sheet.png` plus dark/light conflict and broken-json screenshots.
533 -- Done in current iteration: pixel/pastel checks showed conflict band text was AA in both modes: sampled dark green/blue bands were 6.27/6.32 with light text; sampled light green/blue bands were 9.38/9.00 with dark text.
534 -- Done in current iteration: found a concrete light-mode elevated-surface bleed-through issue: command palette over conflict content sampled `#68777b`, giving only 4.04 contrast with light normal text.
535 -- Done in current iteration: changed light `elevated_surface.background` from translucent `ui.minor04` to opaque semantic `surface.background` (`#ededed`), keeping dark elevated surface unchanged. RED audit verifies light elevated surface equals opaque surface.
536 -- Done in current iteration: schema + strict contrast + elevated/action checks pass after the elevated-surface fix: schema 138/138, 0 missing/extra; strict audit 464 checks per theme, 0 failures, min dark 4.53 and light 4.52.
537 -- Done in current iteration: recaptured final dark/light conflict and invalid JSON diagnostic screenshots after the final `just zed`; focused visual review says conflict markers, invalid JSON diagnostics, and diagnostic command palette are legible in both modes with no concrete blocker remaining in this coverage area.
538 -- Done in current iteration: baseline/build subgoal was rerun again before new work: `git status --short`, `just lint`, `just check`, and `just zed` all passed.
539 -- Done in current iteration: recaptured broad post-elevated-surface Zed coverage after `just zed`: editor/project, command palette, file finder, settings/keymap/assistant/diff command states, terminal, git panel, focused git diff, notification commands, extensions commands, theme selector, and focused editor/gutter/minimap crops in dark and light.
540 -- Done in current iteration: broad screenshot/pixel review found a concrete selected-row text issue: command/file-finder selected rows can contain `text.accent`/match text, but the old `ui.focus80` row background failed contrast with accent/muted text.
541 -- Done in current iteration: added selected-row text audit covering `text`, `text.muted`, and `text.accent` over `element.active`, `element.selected`, and `ghost_element.selected`; RED audit failed on the old generated theme.
542 -- Done in current iteration: lowered selected row fill to contrast-safe semantic `ui.focus` alpha: dark `0a`, light `2b`. Fresh pixels: dark selected row effective `#2e2f2f`, light selected row effective `#c9cecf`.
543 -- Done in current iteration: schema + strict contrast + selected-row text checks pass after selected-row alpha change: schema 138/138, 0 missing/extra; strict audit 473 checks per theme, 0 failures, min dark 4.53 and light 4.52.
544 -- Done in current iteration: fresh screenshots after the final `just zed` show command palette/file finder selected rows remain visible and accent/match text no longer collapses by audit.
545 -- Done in current iteration: baseline/build subgoal was rerun again before new work: `git status --short`, `just lint`, `just check`, and `just zed` all passed.
546 -- Done in current iteration: generated values exposed a concrete light hover bug after the opaque elevated-surface change: light `element.hover` and `ghost_element.active` both resolved to the same effective pixel as `elevated_surface.background` (`#ededed`), so hover had no visible pixel change.
547 -- Done in current iteration: added hover visibility audit; RED audit failed for light `element.hover` and `ghost_element.active` because max pixel delta from elevated surface was zero.
548 -- Done in current iteration: expanded selected/hover text audit showed old dark hover (`#3e3e3e` effective) failed for `text.muted` and `text.accent`, so hover also needed the text-safe focus tint in dark.
549 -- Done in current iteration: `element.hover` and `ghost_element.active` now use the same semantic `ui.focus` alpha as selected rows in both modes: dark `#9aabae0a` effective `#2e2f2f`, light `#15333b2b` effective `#c9cecf`.
550 -- Done in current iteration: hover visibility audit and selected/hover text audit now pass; schema + strict contrast pass after the hover change: schema 138/138, 0 missing/extra; strict audit 479 checks per theme, 0 failures, min dark 4.53 and light 4.52.
551 -- Done in current iteration: fresh screenshots after final `just zed` cover dark/light command palette, file finder, settings/keymap/assistant/diff command states, terminal, git panel/diff, notifications, extensions, theme selector, and focused editor/gutter/minimap crops.
552 -- Remaining visual blocker after focused review: hover/selection rows are now text-safe but deliberately subtle; continue judge/human review for subjective affordance strength.
553 -- Remaining visual blocker after focused review: broad image review still flags subjective light-mode hierarchy concerns around elevated/menu edge clarity, minimap lane strength, diff-gutter hierarchy, and notification/title weight; these need targeted pixel validation before any further semantic changes.
554 -- Next iteration should target those remaining hierarchy concerns one by one with falsifiable pixel samples, not broad visual impressions, preserving selected/hover text contrast >= WCAG AA.

docs/super/roadmaps/2026-06-17-quickshell-hypr-companions-roadmap.md

Deleted
deleted file mode 100644
1 -# Quickshell Hypr Companions Roadmap
3 -> **For agentic workers:** Use /skill:writing-plans to create one detailed implementation plan per phase. Start with Phase 1 and proceed sequentially unless the user explicitly changes the order.
5 -**Goal:** Reimplement the current Hypr companion app surface in one Quickshell config with verified feature parity, same Nugu style/dark-light behavior, simpler Hypr Lua config, and obsolete Ironbar/Mako/Hyprtoolkit frontends retired only after proof.
7 -**Design Spec:** [`docs/super/specs/2026-06-17-quickshell-hypr-companions-architecture.md`](../specs/2026-06-17-quickshell-hypr-companions-architecture.md)
9 -**Baseline Inventory:** [`docs/super/inventory/2026-06-17-quickshell-hypr-companion-baseline.md`](../inventory/2026-06-17-quickshell-hypr-companion-baseline.md)
11 -**Planning Strategy:** This is a multi-daemon desktop shell migration. Splitting by live-retirable surfaces keeps the current desktop usable after every phase: first create a Quickshell shell that changes nothing, then replace Ironbar, then Mako, then launchers/OSDs, then simplify Hypr and retire services. Each phase has a live parity gate before any old app is removed.
13 ----
15 -## Phase 1: Quickshell Foundation and Nugu Theme Service
17 -**Outcome:** A named Quickshell config exists and runs safely beside the current desktop. It has shared Nugu theme tokens, config layout, IPC skeleton, logging conventions, and one harmless visible/hidden diagnostic surface.
19 -**Why now:** Every later phase depends on shared theme, IPC, service boundaries, and a repeatable validation loop.
21 -**Scope:**
23 -- Create `quickshell/nuguland/` config in the repo and symlink manifest entry.
24 -- Add a user systemd service for Quickshell, but do not replace Ironbar/Mako yet.
25 -- Implement the Nugu theme loader for dark/light palettes and current mode.
26 -- Establish shared dimensions/fonts/colors matching current Ironbar/Mako styling.
27 -- Add Quickshell IPC namespace for future calls from Hypr binds.
28 -- Add validation commands and screenshot procedure.
30 -**Out of scope:**
32 -- Replacing any live bar, notification daemon, launcher, lockscreen, wallpaper, idle, or polkit agent.
33 -- Removing Ironbar/Mako/Hyprtoolkit files.
35 -**Key files/areas likely affected:**
37 -- `quickshell/nuguland/shell.qml`: Quickshell entry point.
38 -- `quickshell/nuguland/services/Theme.qml`: Nugu palette/mode state.
39 -- `quickshell/nuguland/components/`: shared UI primitives.
40 -- `hypr/systemd/quickshell.service`: user service.
41 -- `x230.symlinks`: link Quickshell config and service.
42 -- `enable_user_services.nu`: enable Quickshell when installed.
44 -**Dependencies:**
46 -- Quickshell `0.3.0` installed.
47 -- Existing Nugu palette files in `hypr/generated/nugu.json` or new generated Quickshell-friendly palette file.
49 -**Verification:**
51 -- `qs -p quickshell/nuguland/shell.qml` starts without QML errors.
52 -- User service starts and stops without impacting Ironbar/Mako.
53 -- Dark/light tokens render a tiny diagnostic surface or logged values correctly.
54 -- No new long-running process replaces existing services yet.
56 -**Phase boundary health:** The live desktop remains exactly as before except for an optional inert Quickshell process. Old services still own bar/notifications.
58 -**Risks:**
60 -- QML import/API mismatch on Quickshell `0.3.0`; mitigate by validating each component with `qs -p` before service enable.
61 -- Palette duplication; mitigate by generating or reading one source format and using semantic names unchanged.
63 -**Context notes:** Keep files small. Avoid shell wrapper scripts. Do not use `childrenRect` for container sizing.
65 -## Phase 2: Ironbar Bar Parity in Quickshell
67 -**Outcome:** Quickshell renders a top bar matching current Ironbar layout, widgets, actions, style, and dark/light behavior while Ironbar remains available for rollback.
69 -**Why now:** Ironbar is the largest resource consumer and most obvious simplification target. It also deletes the separate Python workspace watcher.
71 -**Scope:**
73 -- Implement top per-monitor `PanelWindow` with same 30px height, IBM Plex Mono typography, accent bottom border, padding, radius, hover/focus colors.
74 -- Implement widgets: workspaces, clipboard entry point, bind mode, MPRIS, clock/calendar, notification status bridge, WiFi, Bluetooth, tray, CPU, volume, brightness, battery, inhibit, power menu.
75 -- Match current click/middle/right/scroll actions.
76 -- Use Quickshell services where stable: Hyprland, Pipewire, MPRIS, SystemTray, UPower, Bluetooth.
77 -- Use narrow process adapters where simpler: `iwctl`, `brightnessctl`, `wezterm` app launchers.
78 -- Keep Mako as notification daemon during this phase; notification status can call `makoctl` until Phase 3.
80 -**Out of scope:**
82 -- Owning notification DBus name.
83 -- Replacing `hyprlauncher` app launcher or clipboard dmenu flow beyond the bar clipboard entry point.
84 -- Stopping Ironbar services automatically.
86 -**Key files/areas likely affected:**
88 -- `quickshell/nuguland/bar/Bar.qml`: panel layout.
89 -- `quickshell/nuguland/bar/widgets/*.qml`: each widget isolated.
90 -- `quickshell/nuguland/services/Hypr.qml`: workspace and bind mode state.
91 -- `quickshell/nuguland/services/Commands.qml`: launch helpers.
92 -- `quickshell/nuguland/services/Inhibit.qml`: idle inhibit state/durations.
93 -- `hypr/systemd/quickshell.service`: service stabilization.
95 -**Dependencies:**
97 -- Phase 1.
98 -- Current Ironbar matrix from baseline inventory.
100 -**Verification:**
102 -- Side-by-side screenshots against Ironbar in dark and light mode.
103 -- Interaction matrix: workspace click, tray menu, volume scroll/mute, brightness scroll, battery click, WiFi/Bluetooth clicks, inhibit cycle, power popup opens.
104 -- Resource comparison after settling: Quickshell bar vs `ironbar` + `workspaces-watch.py`.
105 -- No QML log spam comparable to current Ironbar MPRIS DBus error loop.
107 -**Phase boundary health:** Both bars may be run alternately. If Quickshell bar fails, Ironbar remains enabled and unchanged.
109 -**Risks:**
111 -- System tray menus are hard; mitigate by validating DBusMenu/QsMenuOpener early in the phase plan.
112 -- Inhibit parity may require Wayland idle inhibitor behavior checks; keep current idle config untouched until proven.
113 -- WiFi is iwd, not NetworkManager; do not add NetworkManager.
115 -**Context notes:** This phase can end with Ironbar still running. Retirement happens in Phase 5 after final visual/interaction approval.
117 -**Detailed execution split:** Phase 2 is too large for one safe task-level plan. Keep the Phase 2 outcome unchanged, but write and execute it as:
119 -- Phase 2A: bar shell, shared bar primitives, workspace widget, clock widget, safe show/hide IPC.
120 -- Phase 2B: status/service widgets for MPRIS, WiFi, Bluetooth, CPU, volume, brightness, battery.
121 -- Phase 2C: tray, clipboard entry point, bind mode, notification bridge, inhibit, power popup, full dark/light visual comparison.
123 -Ironbar remains live and enabled through all Phase 2 subplans. No retirement happens until Phase 5.
125 -## Phase 3: Quickshell Notification Daemon Replacing Mako
127 -**Outcome:** Quickshell owns notifications with Mako-equivalent placement, style, actions, grouping/overflow, history, restore, dismiss-all, and dark/light colors.
129 -**Why now:** The bar's notification status and global dismiss/restore semantics need a native notification model before Mako can be retired.
131 -**Scope:**
133 -- Implement `NotificationServer` and notification popup stack.
134 -- Match Mako geometry: top-right, overlay, width 360, height 160, max visible 4, history 80.
135 -- Match Mako timeouts: low 2500ms, normal 6500ms, critical persistent.
136 -- Render app name, summary, body, icons, actions, grouped/overflow indicator, urgency colors, regex semantic colors.
137 -- Provide IPC for dismiss-all, restore-last/history, and notification status count.
138 -- Wire bar notification widget to native service instead of `makoctl`.
140 -**Out of scope:**
142 -- Replacing Hyprland `hyprctl notify` OSD helpers; Phase 4 handles OSDs.
143 -- Removing Mako files/services before live DBus ownership is verified.
145 -**Key files/areas likely affected:**
147 -- `quickshell/nuguland/notifications/*.qml`: daemon and popup UI.
148 -- `quickshell/nuguland/services/Notifications.qml`: history/actions/status.
149 -- `hypr/modules/hypr_osd.lua`: only transitional dismiss command may change after verification.
150 -- `hypr/systemd/mako.service`: retirement only at phase end if parity passes.
151 -- `enable_user_services.nu`, `x230.symlinks`: Mako retirement only after proof.
153 -**Dependencies:**
155 -- Phase 1.
156 -- Phase 2 if the bar status should be switched in the same phase.
158 -**Verification:**
160 -- `notify-send` normal/low/critical with body/icon/action tests.
161 -- Timeout measurements and critical persistence.
162 -- Mouse actions: left default action, middle dismiss group, right dismiss.
163 -- History restore and dismiss-all via Quickshell IPC.
164 -- Dark/light screenshots.
165 -- `mako.service` stopped manually for test; Quickshell receives notifications; rollback by restarting Mako.
167 -**Phase boundary health:** End either with Mako still enabled and no retirement, or with Quickshell notifications proven and Mako disabled in a reversible commit.
169 -**Risks:**
171 -- Notification action semantics may differ from Mako. Mitigate by explicit action test notifications.
172 -- Two notification daemons compete for DBus. Mitigate by only stopping Mako in controlled verification steps.
174 -**Context notes:** Never leave the system without a notification daemon unless the test explicitly requires it and Mako rollback is one command.
176 -## Phase 4: Launcher, Clipboard Picker, Power Menu, and OSD IPC
178 -**Outcome:** Hypr companion keybind frontends are Quickshell IPC calls instead of Hyprtoolkit apps or `hyprctl notify` wrappers.
180 -**Why now:** These surfaces depend on the foundation, theme, command service, and notification/OSD UI.
182 -**Scope:**
184 -- Implement Quickshell launcher for `SUPER+Space` with desktop app search/launch parity.
185 -- Implement dmenu-like list picker sufficient for clipboard history selection.
186 -- Keep `cliphist` storage initially; replace `hyprlauncher --dmenu` frontend.
187 -- Implement power/logout popup/window matching current Ironbar/hyprshutdown actions.
188 -- Implement OSDs for volume, mic mute, brightness, media, lock/suspend/reload, screenshot, color pick.
189 -- Add Quickshell IPC methods and migrate relevant Hypr binds to `qs ipc -c nuguland call ...`.
191 -**Out of scope:**
193 -- Native clipboard storage replacing `cliphist`.
194 -- Replacing `hyprlock`, `hypridle`, `hyprpaper`, `hyprsunset`, or `hyprpolkitagent`.
195 -- Destructive power action execution without explicit confirmation behavior.
197 -**Key files/areas likely affected:**
199 -- `quickshell/nuguland/launcher/*.qml`.
200 -- `quickshell/nuguland/clipboard/*.qml`.
201 -- `quickshell/nuguland/power/*.qml`.
202 -- `quickshell/nuguland/osd/*.qml`.
203 -- `quickshell/nuguland/services/Ipc.qml` or equivalent IPC handlers.
204 -- `hypr/modules/apps.lua`: replace `hyprlauncher`/`hyprshutdown`/clipboard commands.
205 -- `hypr/modules/binds.lua`: call Quickshell IPC for companion surfaces.
206 -- `hypr/modules/hypr_osd.lua`: shrink or delete after all helpers migrate.
208 -**Dependencies:**
210 -- Phase 1.
211 -- Phase 3 for notification/OSD visual infrastructure, unless OSD is implemented as separate popup service.
213 -**Verification:**
215 -- Launcher opens, filters, launches apps, closes on selection/escape.
216 -- Clipboard picker lists recent text, selects to clipboard, handles empty history.
217 -- Power menu lock/logout/sleep dry-run or confirmed behavior; no accidental poweroff/reboot.
218 -- Hardware media keys update state and show Quickshell OSD.
219 -- Screenshot/color actions still run and show Quickshell confirmation.
220 -- Hypr binds list shows simpler companion command targets.
222 -**Phase boundary health:** Old commands remain recoverable from git and packages. `cliphist` daemon remains live, so clipboard storage is not disrupted.
224 -**Risks:**
226 -- Launcher parity can grow large. Mitigate with desktop-app launching and clipboard dmenu parity first; arbitrary command mode only if current setup actually has it.
227 -- IPC command quoting can become messy. Mitigate by one stable helper command pattern and tests.
229 -**Context notes:** Prefer Quickshell IPC over adding scripts. Hypr Lua should only dispatch stable command strings.
231 -## Phase 5: Service Retirement and Hypr Config Simplification
233 -**Outcome:** Obsolete services/apps are disabled or removed from manifests only after parity proof. Hypr config is smaller and no longer carries companion-app implementation details.
235 -**Why now:** Retirement before parity risks breaking the live desktop. After Phases 2–4, old apps should be unused.
237 -**Scope:**
239 -- Disable/remove `ironbar.service` and `ironbar-workspaces.service` from symlink manifests and enable script after Quickshell bar passes approval.
240 -- Disable/remove `mako.service` after Quickshell notifications pass approval.
241 -- Remove `hyprlauncher` and `hyprshutdown` usage after launcher/power parity.
242 -- Remove or simplify `hypr/hyprtoolkit.conf` once no Hyprtoolkit apps remain in binds/bar.
243 -- Delete obsolete Ironbar workspace watcher/service and generated Ironbar/Mako theme writes only after no consumer remains.
244 -- Simplify `hypr/modules/apps.lua`, `hypr/modules/binds.lua`, `hypr/modules/hypr_osd.lua` to compositor binds plus Quickshell IPC calls.
246 -**Out of scope:**
248 -- Package uninstallation. That can be a separate manual cleanup after a stable period.
249 -- Replacing lock/wallpaper/idle/polkit unless Phase 6 approves it.
251 -**Key files/areas likely affected:**
253 -- `x230.symlinks`.
254 -- `enable_user_services.nu`.
255 -- `hypr/systemd/*` old service files.
256 -- `ironbar/`, `mako/` directories.
257 -- `hypr/modules/apps.lua`, `hypr/modules/binds.lua`, `hypr/modules/hypr_osd.lua`.
258 -- `hypr/scripts/theme.nu`, `nugu/ironbar.nu`, `nugu/mako.nu`, `nugu/justfile`.
260 -**Dependencies:**
262 -- Phase 2 approval for bar.
263 -- Phase 3 approval for notifications.
264 -- Phase 4 approval for launcher/clipboard/power/OSD.
266 -**Verification:**
268 -- `systemctl --user --type=service` shows Quickshell active and old retired services inactive/disabled as intended.
269 -- `grep` proves no remaining `hyprlauncher`, `hyprshutdown`, `ironbar`, `makoctl`, `hyprctl notify` usage in live paths except documented transitional/rollback docs.
270 -- Full interaction matrix passes with old services stopped.
271 -- Resource comparison shows fewer processes and lower or justified memory/CPU.
272 -- `just check` or relevant repo tests pass.
274 -**Phase boundary health:** The desktop has one Quickshell companion service plus still-valid compositor/session helpers. Removed services are no longer referenced.
276 -**Risks:**
278 -- Hidden references in scripts/docs/manifests. Mitigate with repo-wide grep and live service checks.
279 -- Generated Nugu recipes may still produce old files. Mitigate by updating recipes only when consumers are removed.
281 -**Context notes:** Preserve old files until replacements are proven. Deletion can be last commit of the phase.
283 -## Phase 6: Optional Deep Replacements Review
285 -**Outcome:** Decide explicitly whether Quickshell should also replace deeper Hypr ecosystem tools: lockscreen, wallpaper, idle integration, polkit agent, clipboard storage, or wallpaper/theme automation.
287 -**Why now:** The original objective says companion apps broadly, but replacing security/session primitives is riskier than replacing UI frontends. Make the decision only after the primary migration is stable.
289 -**Scope:**
291 -- Evaluate `hyprlock`, `hypridle`, `hyprpaper`, `hyprsunset`, `hyprpolkitagent`, `cliphist`, `wl-clip-persist` against the goal: simplification, better performance, better looks.
292 -- For each candidate, choose keep/replace/defer with evidence.
293 -- If replacing any candidate, create a separate roadmap/plan.
295 -**Out of scope:**
297 -- Implementing replacements in this phase.
298 -- Weakening lock/session/polkit safety.
300 -**Key files/areas likely affected:**
302 -- `hypr/hyprlock.conf`, `hypr/hypridle.conf`, `hypr/hyprsunset.conf`.
303 -- `hypr/systemd/cliphist.service`, `hypr/systemd/wl-clip-persist.service`.
304 -- `polkit/` and user service manifests if polkit is considered.
305 -- Quickshell lock/polkit/clipboard docs/examples if a later phase is approved.
307 -**Dependencies:**
309 -- Phases 1–5 complete and stable.
310 -- Explicit user approval for security/session replacements.
312 -**Verification:**
314 -- Written decision matrix with measured process/resource impact and risk.
315 -- If all are kept, document why they are no longer considered obsolete companion apps.
316 -- If any are selected for replacement, a new spec/roadmap starts before code.
318 -**Phase boundary health:** No system behavior changes. This is a decision phase.
320 -**Risks:**
322 -- Scope creep. Mitigate by forbidding implementation in this phase.
323 -- Security regressions from lock/polkit replacement. Mitigate by explicit separate approval and rollback path.
325 -**Context notes:** Keeping a small, correct Hypr helper may be simpler than recreating it in Quickshell. The goal is simplification, not maximal replacement.

docs/superpowers/plans/2026-05-30-yazi-nugu-dotfiles.md

Deleted
deleted file mode 100644
1 -# Yazi Nugu Dotfiles Implementation Plan
3 -> **For agentic workers:** REQUIRED SUB-SKILL: Use /skill:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
5 -**Goal:** Build a dotfiles-managed Yazi config that uses generated Nugu flavors, tasteful Yazi-native key overrides, and a small managed plugin set.
7 -**Architecture:** Add `yazi/` as a managed dotfiles directory, generated Nugu dark/light Yazi flavors from `nugu/yazi.nu`, and minimal Yazi TOML/Lua config. Plugins are installed and locked by `ya pkg`; installed plugin directories are ignored and not vendored.
9 -**Tech Stack:** Yazi 26.5.6, `ya pkg`, Nushell, Just, TOML, Lua, dotfiles symlink manifests.
11 -**Roadmap:** None
13 -**Phase:** Single-plan implementation
15 ----
17 -## File structure
19 -Create or modify these files:
21 -- Create `nugu/yazi.nu`: generator from Nugu semantic palette to Yazi flavor TOML.
22 -- Modify `nugu/justfile`: add `yazi` recipe and include it in `install`.
23 -- Create `yazi/theme.toml`: selects generated Nugu flavors.
24 -- Create `yazi/yazi.toml`: minimal manager/open/preview/plugin rules.
25 -- Create `yazi/keymap.toml`: prepend-only key overrides.
26 -- Create `yazi/init.lua`: plugin setup.
27 -- Create `yazi/package.toml`: generated by `ya pkg add`; plugin lock source of truth.
28 -- Create `yazi/flavors/nugu-dark.yazi/flavor.toml`: generated artifact.
29 -- Create `yazi/flavors/nugu-light.yazi/flavor.toml`: generated artifact.
30 -- Modify `.gitignore`: ignore installed `yazi/plugins/` artifacts.
31 -- Modify `desktop.symlinks`, `fedora.symlinks`, `x230.symlinks`: map `yazi` to `~/.config/yazi`.
33 -Do not touch or add `yazi/plugins/`. Existing untracked `pi/research/**` noise must not be staged.
35 ----
37 -### Task 1: Add dotfiles ownership, ignore rules, and live symlink
39 -**Files:**
40 -- Modify: `/home/me/Workspace/dotfiles/.gitignore`
41 -- Modify: `/home/me/Workspace/dotfiles/desktop.symlinks`
42 -- Modify: `/home/me/Workspace/dotfiles/fedora.symlinks`
43 -- Modify: `/home/me/Workspace/dotfiles/x230.symlinks`
44 -- Create: `/home/me/Workspace/dotfiles/yazi/.gitkeep` temporarily if needed before config files exist
45 -- Live target: `/home/me/.config/yazi`
47 -- [ ] **Step 1: Add Yazi installed plugin ignore rule**
49 -Append this block to `/home/me/Workspace/dotfiles/.gitignore` near the other local runtime/package caches:
51 -```gitignore
52 -# Yazi package manager installs plugin repos here; package.toml is source of truth.
53 -yazi/plugins/
54 -```
56 -- [ ] **Step 2: Add Yazi to `desktop.symlinks`**
58 -In `/home/me/Workspace/dotfiles/desktop.symlinks`, insert this pair after the existing `pi` mapping:
60 -```text
61 -yazi
62 -~/.config/yazi
63 -```
65 -The beginning of the file should become:
67 -```text
68 -forgejo-cli
69 -~/.config/forgejo-cli
71 -pi
72 -~/.pi
74 -yazi
75 -~/.config/yazi
77 -Notes
78 -~/Notes
79 -```
81 -- [ ] **Step 3: Add Yazi to `fedora.symlinks`**
83 -In `/home/me/Workspace/dotfiles/fedora.symlinks`, insert this pair after the `Notes` mapping:
85 -```text
86 -yazi
87 -~/.config/yazi
88 -```
90 -The beginning of the file should become:
92 -```text
93 -Notes
94 -~/Notes
96 -yazi
97 -~/.config/yazi
99 -git/gitconfig
100 -~/.config/git/config
101 -```
103 -- [ ] **Step 4: Add Yazi to `x230.symlinks`**
105 -In `/home/me/Workspace/dotfiles/x230.symlinks`, insert this pair after the `Notes` mapping:
107 -```text
108 -yazi
109 -~/.config/yazi
110 -```
112 -The beginning of the file should become:
114 -```text
115 -Notes
116 -~/Notes
118 -yazi
119 -~/.config/yazi
121 -git/gitconfig
122 -~/.config/git/config
123 -```
125 -- [ ] **Step 5: Create Yazi directory skeleton**
127 -Run:
129 -```bash
130 -cd /home/me/Workspace/dotfiles
131 -mkdir -p yazi/flavors/nugu-dark.yazi yazi/flavors/nugu-light.yazi
132 -touch yazi/.gitkeep
133 -```
135 -Expected: directories exist. Verify:
137 -```bash
138 -test -d yazi/flavors/nugu-dark.yazi && test -d yazi/flavors/nugu-light.yazi && test -f yazi/.gitkeep && echo ok
139 -```
141 -Expected output:
143 -```text
144 -ok
145 -```
147 -- [ ] **Step 6: Back up existing live Yazi config now**
149 -Run:
151 -```bash
152 -if [ -e /home/me/.config/yazi ] && [ ! -L /home/me/.config/yazi ]; then
153 - mv /home/me/.config/yazi /home/me/.config/yazi.noctalia-backup-$(date +%Y%m%d%H%M%S)
154 -fi
155 -```
157 -Expected: existing non-symlink config is moved aside; no output on success.
159 -- [ ] **Step 7: Bootstrap live symlink now**
161 -Run:
163 -```bash
164 -cd /home/me/Workspace/dotfiles
165 -java bootstripper.java bootstrap
166 -```
168 -Expected: bootstrap exits 0 and creates `/home/me/.config/yazi` symlink.
170 -- [ ] **Step 8: Verify live symlink target**
172 -Run:
174 -```bash
175 -realpath /home/me/.config/yazi
176 -```
178 -Expected output:
180 -```text
181 -/home/me/Workspace/dotfiles/yazi
182 -```
184 -- [ ] **Step 9: Run dotfiles manifest check**
186 -Run:
188 -```bash
189 -cd /home/me/Workspace/dotfiles
190 -java bootstripper.java check
191 -```
193 -Expected: `OK bootstripper check passed.`
195 -- [ ] **Step 10: Commit ownership changes**
197 -Run:
199 -```bash
200 -cd /home/me/Workspace/dotfiles
201 -git add .gitignore desktop.symlinks fedora.symlinks x230.symlinks yazi/.gitkeep
202 -git commit -m "chore: manage yazi dotfiles"
203 -```
205 -Expected: commit succeeds. `yazi/.gitkeep` is removed in Task 3 after real config files exist.
207 ----
209 -### Task 2: Add Nugu-to-Yazi flavor generator
211 -**Files:**
212 -- Create: `/home/me/Workspace/dotfiles/nugu/yazi.nu`
213 -- Modify: `/home/me/Workspace/dotfiles/nugu/justfile`
215 -- [ ] **Step 1: Create `nugu/yazi.nu`**
217 -Write this file to `/home/me/Workspace/dotfiles/nugu/yazi.nu`:
219 -```nu
220 -use palette.nu
222 -# Generate a Yazi flavor.toml from the Nugu semantic palette.
223 -export def flavor [mode: string] {
224 - let nugu = (palette nugu $mode)
225 - let p = $nugu.palette
227 - let theme = {
228 - mgr: {
229 - cwd: { fg: $p.content.normal }
230 - find_keyword: { fg: $p.content.accent, bold: true, italic: true, underline: true }
231 - find_position: { fg: $p.content.accent, bold: true }
232 - symlink_target: { fg: $p.content.minor }
234 - marker_copied: { fg: $p.content.focus, bg: $p.content.focus }
235 - marker_cut: { fg: $p.warning, bg: $p.warning }
236 - marker_marked: { fg: $p.content.accent, bg: $p.content.accent }
237 - marker_selected: { fg: $p.ui.important_local, bg: $p.ui.important_local }
239 - count_copied: { fg: $p.content.backdrop, bg: $p.content.focus, bold: true }
240 - count_cut: { fg: $p.content.backdrop, bg: $p.warning, bold: true }
241 - count_selected: { fg: $p.ui.backdrop, bg: $p.ui.important_local, bold: true }
243 - border_symbol: "│"
244 - border_style: { fg: $p.ui.unfocus }
245 - }
247 - status: {
248 - overall: { fg: $p.ui.normal, bg: $p.ui.backdrop }
249 - sep_left: { open: "", close: "" }
250 - sep_right: { open: "", close: "" }
251 - perm_type: { fg: $p.content.important_global }
252 - perm_read: { fg: $p.content.focus }
253 - perm_write: { fg: $p.warning }
254 - perm_exec: { fg: $p.error }
255 - perm_sep: { fg: $p.content.minor }
256 - progress_label: { fg: $p.content.normal, bold: true }
257 - progress_normal: { fg: $p.ui.accent, bg: $p.ui.backdrop }
258 - progress_error: { fg: $p.error, bg: $p.ui.backdrop }
259 - }
261 - mode: {
262 - normal_main: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
263 - normal_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
264 - select_main: { fg: $p.ui.backdrop, bg: $p.ui.important_local, bold: true }
265 - select_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
266 - unset_main: { fg: $p.content.backdrop, bg: $p.warning, bold: true }
267 - unset_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
268 - }
270 - tabs: {
271 - active: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
272 - inactive: { fg: $p.ui.minor, bg: $p.ui.backdrop }
273 - sep_inner: { open: "", close: "" }
274 - sep_outer: { open: "", close: "" }
275 - }
277 - which: {
278 - cols: 3
279 - mask: { bg: $p.ui.backdrop }
280 - cand: { fg: $p.ui.accent, bold: true }
281 - rest: { fg: $p.ui.minor }
282 - desc: { fg: $p.ui.normal }
283 - separator: " → "
284 - separator_style: { fg: $p.ui.minor }
285 - }
287 - input: {
288 - border: { fg: $p.ui.unfocus }
289 - title: { fg: $p.ui.accent, bold: true }
290 - value: { fg: $p.content.normal }
291 - selected: { fg: $p.content.backdrop, bg: $p.content.focus }
292 - }
294 - confirm: {
295 - border: { fg: $p.warning }
296 - title: { fg: $p.warning, bold: true }
297 - body: { fg: $p.content.normal }
298 - list: { fg: $p.content.normal }
299 - btn_yes: { fg: $p.content.backdrop, bg: $p.error, bold: true }
300 - btn_no: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
301 - btn_labels: ["yes", "no"]
302 - }
304 - spot: {
305 - border: { fg: $p.ui.unfocus }
306 - title: { fg: $p.ui.accent, bold: true }
307 - tbl_col: { fg: $p.content.normal }
308 - tbl_cell: { fg: $p.content.backdrop, bg: $p.content.focus }
309 - }
311 - pick: {
312 - border: { fg: $p.ui.unfocus }
313 - active: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
314 - inactive: { fg: $p.ui.normal }
315 - }
317 - cmp: {
318 - border: { fg: $p.ui.unfocus }
319 - active: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
320 - inactive: { fg: $p.ui.normal }
321 - }
323 - tasks: {
324 - border: { fg: $p.ui.unfocus }
325 - title: { fg: $p.ui.accent, bold: true }
326 - hovered: { fg: $p.content.focus, bold: true }
327 - }
329 - help: {
330 - on: { fg: $p.ui.accent, bold: true }
331 - run: { fg: $p.content.important_local }
332 - desc: { fg: $p.content.normal }
333 - hovered: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
334 - footer: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
335 - }
337 - notify: {
338 - title_info: { fg: $p.info, bold: true }
339 - title_warn: { fg: $p.warning, bold: true }
340 - title_error: { fg: $p.error, bold: true }
341 - }
343 - filetype: {
344 - rules: [
345 - { mime: "image/*", fg: $p.content.focus }
346 - { mime: "{audio,video}/*", fg: $p.content.important_local }
347 - { mime: "application/{zip,rar,7z*,tar,gzip,xz,zstd,bzip*,lzma,compress,archive,cpio,arj,xar,ms-cab*}", fg: $p.content.accent }
348 - { mime: "application/{pdf,doc,rtf}", fg: $p.content.important_global }
349 - { mime: "*", is: "orphan", fg: $p.content.backdrop, bg: $p.error, bold: true }
350 - { mime: "application/*exec*", fg: $p.error }
351 - { url: "*/", fg: $p.ui.accent, bold: true }
352 - { url: "*", fg: $p.content.normal }
353 - ]
354 - }
356 - git: {
357 - unknown: { fg: $p.content.minor }
358 - modified: { fg: $p.warning, bold: true }
359 - added: { fg: $p.content.focus, bold: true }
360 - untracked: { fg: $p.content.accent, bold: true }
361 - ignored: { fg: $p.content.minor }
362 - deleted: { fg: $p.error, bold: true }
363 - updated: { fg: $p.warning, bold: true }
364 - clean: { fg: $p.content.minor }
365 - unknown_sign: ""
366 - modified_sign: "M "
367 - added_sign: "A "
368 - untracked_sign: "? "
369 - ignored_sign: "I "
370 - deleted_sign: "D "
371 - updated_sign: "U "
372 - clean_sign: ""
373 - }
374 - }
376 - $theme | to toml
378 -```
380 -- [ ] **Step 2: Check the new Nushell module parses**
382 -Run:
384 -```bash
385 -cd /home/me/Workspace/dotfiles/nugu
386 -open yazi.nu | nu-check --as-module --debug yazi.nu
387 -```
389 -Expected: `nu-check` exits 0.
391 -- [ ] **Step 3: Add `yazi` recipe to `nugu/justfile`**
393 -Add this recipe after the `ghostty` recipe:
395 -```just
396 -yazi: build
397 - rm --force --recursive {{output}}/yazi
398 - mkdir {{output}}/yazi
399 - mkdir {{output}}/yazi/nugu-dark.yazi
400 - mkdir {{output}}/yazi/nugu-light.yazi
401 - use yazi.nu; yazi flavor dark | save --raw {{output}}/yazi/nugu-dark.yazi/flavor.toml
402 - use yazi.nu; yazi flavor light | save --raw {{output}}/yazi/nugu-light.yazi/flavor.toml
403 - mkdir ../yazi/flavors
404 - mkdir ../yazi/flavors/nugu-dark.yazi
405 - mkdir ../yazi/flavors/nugu-light.yazi
406 - cp {{output}}/yazi/nugu-dark.yazi/flavor.toml ../yazi/flavors/nugu-dark.yazi/flavor.toml
407 - cp {{output}}/yazi/nugu-light.yazi/flavor.toml ../yazi/flavors/nugu-light.yazi/flavor.toml
408 -```
410 -- [ ] **Step 4: Include Yazi in Nugu install recipe**
412 -Change the final recipe in `/home/me/Workspace/dotfiles/nugu/justfile` from:
414 -```just
415 -install: helix wezterm ghostty
416 -```
418 -to:
420 -```just
421 -install: helix wezterm ghostty yazi
422 -```
424 -- [ ] **Step 5: Generate Yazi flavors**
426 -Run:
428 -```bash
429 -cd /home/me/Workspace/dotfiles/nugu
430 -just yazi
431 -```
433 -Expected files:
435 -```text
436 -/home/me/Workspace/dotfiles/yazi/flavors/nugu-dark.yazi/flavor.toml
437 -/home/me/Workspace/dotfiles/yazi/flavors/nugu-light.yazi/flavor.toml
438 -```
440 -Verify:
442 -```bash
443 -test -s /home/me/Workspace/dotfiles/yazi/flavors/nugu-dark.yazi/flavor.toml && \
444 -test -s /home/me/Workspace/dotfiles/yazi/flavors/nugu-light.yazi/flavor.toml && \
445 -echo ok
446 -```
448 -Expected output:
450 -```text
451 -ok
452 -```
454 -- [ ] **Step 6: Commit Nugu generator**
456 -Run:
458 -```bash
459 -cd /home/me/Workspace/dotfiles
460 -git add nugu/yazi.nu nugu/justfile yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
461 -git commit -m "feat: generate yazi nugu flavors"
462 -```
464 -Expected: commit succeeds.
466 ----
468 -### Task 3: Add base Yazi config files
470 -**Files:**
471 -- Create: `/home/me/Workspace/dotfiles/yazi/theme.toml`
472 -- Create: `/home/me/Workspace/dotfiles/yazi/yazi.toml`
473 -- Create: `/home/me/Workspace/dotfiles/yazi/keymap.toml`
474 -- Create: `/home/me/Workspace/dotfiles/yazi/init.lua`
476 -- [ ] **Step 1: Create `yazi/theme.toml`**
478 -Write this file:
480 -```toml
481 -[flavor]
482 -dark = "nugu-dark"
483 -light = "nugu-light"
484 -```
486 -- [ ] **Step 2: Create `yazi/yazi.toml`**
488 -Write this file:
490 -```toml
491 -# A TOML linter such as Tombi can use this schema to validate your config.
492 -#:schema https://yazi-rs.github.io/schemas/yazi.json
494 -[mgr]
495 -show_hidden = true
496 -sort_by = "natural"
497 -sort_dir_first = true
498 -linemode = "none"
500 -[opener]
501 -edit = [
502 - { run = 'nvim %s', desc = "nvim", block = true, for = "unix" },
504 -play = [
505 - { run = 'mpv %s', desc = "mpv", orphan = true, for = "unix" },
507 -open = [
508 - { run = 'xdg-open %s1', desc = "Open", for = "linux" },
510 -extract = [
511 - { run = 'ouch d -y %s', desc = "Extract here with ouch", for = "unix" },
514 -[open]
515 -prepend_rules = [
516 - { mime = "text/*", use = [ "edit", "reveal" ] },
517 - { mime = "application/{json,ndjson,javascript,wine-extension-ini}", use = [ "edit", "reveal" ] },
520 -[plugin]
521 -prepend_fetchers = [
522 - { url = "*", run = "git", group = "git" },
523 - { url = "*/", run = "git", group = "git" },
525 -prepend_previewers = [
526 - { url = "*.md", mime = "text/markdown", run = 'piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dark "$1"' },
527 - { mime = "application/{*zip,tar,bzip2,7z*,rar,xz,zstd,java-archive}", run = "ouch" },
529 -append_previewers = [
530 - { url = "*", run = 'piper -- hexyl --border=none --terminal-width=$w "$1"' },
532 -```
534 -- [ ] **Step 3: Create `yazi/keymap.toml`**
536 -Write this file:
538 -```toml
539 -# A TOML linter such as Tombi can use this schema to validate your config.
540 -#:schema https://yazi-rs.github.io/schemas/keymap.json
542 -[[mgr.prepend_keymap]]
543 -on = "l"
544 -run = "plugin smart-enter"
545 -desc = "Enter directory or open file"
547 -[[mgr.prepend_keymap]]
548 -on = "<Enter>"
549 -run = "plugin smart-enter"
550 -desc = "Enter directory or open file"
552 -[[mgr.prepend_keymap]]
553 -on = "p"
554 -run = "plugin smart-paste"
555 -desc = "Paste into hovered directory or CWD"
557 -[[mgr.prepend_keymap]]
558 -on = "f"
559 -run = "plugin smart-filter"
560 -desc = "Smart filter"
562 -[[mgr.prepend_keymap]]
563 -on = "T"
564 -run = "plugin toggle-pane min-preview"
565 -desc = "Show or hide preview pane"
567 -[[mgr.prepend_keymap]]
568 -on = "F"
569 -run = "plugin toggle-pane max-preview"
570 -desc = "Maximize or restore preview pane"
572 -[[mgr.prepend_keymap]]
573 -on = [ "c", "m" ]
574 -run = "plugin chmod"
575 -desc = "Chmod selected files"
577 -[[mgr.prepend_keymap]]
578 -on = [ "c", "D" ]
579 -run = "plugin diff"
580 -desc = "Diff selected file with hovered file"
582 -[[mgr.prepend_keymap]]
583 -on = "!"
584 -for = "unix"
585 -run = 'shell "$SHELL" --block'
586 -desc = "Open shell here"
588 -[[mgr.prepend_keymap]]
589 -on = [ "g", "w" ]
590 -run = "cd ~/Workspace"
591 -desc = "Go ~/Workspace"
593 -[[mgr.prepend_keymap]]
594 -on = [ "g", "k" ]
595 -run = "cd ~/Workspace/dotfiles"
596 -desc = "Go dotfiles"
598 -[[mgr.prepend_keymap]]
599 -on = [ "g", "n" ]
600 -run = "cd ~/Notes"
601 -desc = "Go notes"
603 -[[mgr.prepend_keymap]]
604 -on = [ "g", "y" ]
605 -run = "cd ~/.config/yazi"
606 -desc = "Go Yazi config"
608 -[[mgr.prepend_keymap]]
609 -on = [ "g", "r" ]
610 -run = 'shell -- ya emit cd "$(git rev-parse --show-toplevel 2>/dev/null || jj root 2>/dev/null || pwd)"'
611 -desc = "Go repository root"
613 -[[input.prepend_keymap]]
614 -on = "<Esc>"
615 -run = "close"
616 -desc = "Cancel input"
617 -```
619 -- [ ] **Step 4: Create `yazi/init.lua`**
621 -Write this file:
623 -```lua
624 -require("full-border"):setup { type = ui.Border.PLAIN }
625 -require("git"):setup { order = 1500 }
626 -require("yaziline"):setup { separator_style = "liney" }
627 -```
629 -- [ ] **Step 5: Remove temporary `yazi/.gitkeep` if it exists**
631 -Run:
633 -```bash
634 -cd /home/me/Workspace/dotfiles
635 -rm -f yazi/.gitkeep
636 -```
638 -Expected: command exits 0.
640 -- [ ] **Step 6: Commit base Yazi config**
642 -Run:
644 -```bash
645 -cd /home/me/Workspace/dotfiles
646 -git add yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua
647 -git commit -m "feat: add yazi config"
648 -```
650 -Expected: commit succeeds.
652 ----
654 -### Task 4: Install and lock Yazi plugins
656 -**Files:**
657 -- Create: `/home/me/Workspace/dotfiles/yazi/package.toml`
658 -- Generated but ignored: `/home/me/Workspace/dotfiles/yazi/plugins/`
660 -- [ ] **Step 1: Install selected plugins with `ya pkg`**
662 -Run:
664 -```bash
665 -cd /home/me/.config/yazi
666 -ya pkg add \
667 - yazi-rs/plugins:full-border \
668 - yazi-rs/plugins:toggle-pane \
669 - yazi-rs/plugins:smart-enter \
670 - yazi-rs/plugins:smart-filter \
671 - yazi-rs/plugins:smart-paste \
672 - yazi-rs/plugins:git \
673 - yazi-rs/plugins:chmod \
674 - yazi-rs/plugins:diff \
675 - yazi-rs/plugins:piper \
676 - ndtoan96/ouch \
677 - llanosrocas/yaziline
678 -```
680 -Expected:
682 -- `/home/me/Workspace/dotfiles/yazi/package.toml` exists through the live symlink.
683 -- `/home/me/Workspace/dotfiles/yazi/plugins/` exists and is ignored.
684 -- The command exits 0.
686 -- [ ] **Step 2: Verify installed plugin dirs are ignored**
688 -Run:
690 -```bash
691 -cd /home/me/Workspace/dotfiles
692 -git status --short yazi/package.toml yazi/plugins
693 -```
695 -Expected output includes `?? yazi/package.toml` and does not list individual files under `yazi/plugins/`.
697 -- [ ] **Step 3: Verify package lock lists all plugin deps**
699 -Run:
701 -```bash
702 -cd /home/me/Workspace/dotfiles
703 -for dep in \
704 - 'yazi-rs/plugins:full-border' \
705 - 'yazi-rs/plugins:toggle-pane' \
706 - 'yazi-rs/plugins:smart-enter' \
707 - 'yazi-rs/plugins:smart-filter' \
708 - 'yazi-rs/plugins:smart-paste' \
709 - 'yazi-rs/plugins:git' \
710 - 'yazi-rs/plugins:chmod' \
711 - 'yazi-rs/plugins:diff' \
712 - 'yazi-rs/plugins:piper' \
713 - 'ndtoan96/ouch' \
714 - 'llanosrocas/yaziline'; do
715 - grep -F "use = \"$dep\"" yazi/package.toml >/dev/null || { echo "missing $dep"; exit 1; }
716 -done
717 -echo ok
718 -```
720 -Expected output:
722 -```text
723 -ok
724 -```
726 -- [ ] **Step 4: Commit package lock**
728 -Run:
730 -```bash
731 -cd /home/me/Workspace/dotfiles
732 -git add yazi/package.toml
733 -git commit -m "feat: lock yazi plugins"
734 -```
736 -Expected: commit succeeds and `yazi/plugins/` remains untracked/ignored.
738 ----
740 -### Task 5: Validate generated Nugu and Yazi config
742 -**Files:**
743 -- Verify: `/home/me/Workspace/dotfiles/nugu/yazi.nu`
744 -- Verify: `/home/me/Workspace/dotfiles/yazi/*.toml`
745 -- Verify: `/home/me/Workspace/dotfiles/yazi/init.lua`
747 -- [ ] **Step 1: Run Nugu checks**
749 -Run:
751 -```bash
752 -cd /home/me/Workspace/dotfiles/nugu
753 -just check
754 -```
756 -Expected: `just check` exits 0 and reports Nugu color contrast results.
758 -- [ ] **Step 2: Regenerate Yazi flavors and check drift**
760 -Run:
762 -```bash
763 -cd /home/me/Workspace/dotfiles/nugu
764 -just yazi
765 -cd /home/me/Workspace/dotfiles
766 -git diff -- yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
767 -```
769 -Expected: no diff.
771 -- [ ] **Step 3: Validate Yazi can print debug config**
773 -Run:
775 -```bash
776 -yazi --debug >/tmp/yazi-debug.txt
777 -head -40 /tmp/yazi-debug.txt
778 -```
780 -Expected:
782 -- Command exits 0.
783 -- Output contains Yazi debug information.
784 -- No TOML parse error appears.
786 -- [ ] **Step 4: Verify plugin restore from lock works**
788 -Run:
790 -```bash
791 -cd /home/me/.config/yazi
792 -ya pkg install
793 -```
795 -Expected: command exits 0.
797 -- [ ] **Step 5: Run dotfiles pre-commit check**
799 -Run:
801 -```bash
802 -cd /home/me/Workspace/dotfiles
803 -just pre-commit
804 -```
806 -Expected: command exits 0 with no leaked secrets or manifest failures.
808 -- [ ] **Step 6: Commit validation fixups if any**
810 -If any validation step required fixes, run:
812 -```bash
813 -cd /home/me/Workspace/dotfiles
814 -git add .gitignore desktop.symlinks fedora.symlinks x230.symlinks nugu/yazi.nu nugu/justfile yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua yazi/package.toml yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
815 -git commit -m "fix: validate yazi nugu config"
816 -```
818 -Expected: commit succeeds only if there were fixups. If there were no changes, skip this step.
820 ----
822 -### Task 6: Smoke-test live config interactively
824 -**Files:**
825 -- Live target: `/home/me/.config/yazi`
826 -- Source: `/home/me/Workspace/dotfiles/yazi`
828 -- [ ] **Step 1: Verify live config is already symlinked**
830 -Run:
832 -```bash
833 -realpath /home/me/.config/yazi
834 -```
836 -Expected output:
838 -```text
839 -/home/me/Workspace/dotfiles/yazi
840 -```
842 -- [ ] **Step 2: Install locked plugins in live config**
844 -Run:
846 -```bash
847 -cd /home/me/.config/yazi
848 -ya pkg install
849 -```
851 -Expected: command exits 0.
853 -- [ ] **Step 3: Launch Yazi smoke session**
855 -Run:
857 -```bash
858 -YAZI_LOG=debug yazi /home/me/Workspace/dotfiles
859 -```
861 -In Yazi, verify manually:
863 -- Hidden files are visible immediately.
864 -- `~` or `<F1>` opens help and custom bindings appear.
865 -- `l` and `<Enter>` enter dirs/open files through smart-enter.
866 -- `p` runs smart-paste behavior.
867 -- `f` opens smart-filter.
868 -- `T` hides/shows preview.
869 -- `F` maximizes/restores preview.
870 -- `c m` opens chmod plugin.
871 -- `c D` opens diff plugin when a file is selected and another is hovered.
872 -- `!` opens `$SHELL` and returns to Yazi when the shell exits.
873 -- `g w`, `g k`, `g n`, `g y`, `g r` navigate to the expected directories.
874 -- Markdown files preview through glow.
875 -- Archives preview through ouch.
876 -- Git signs appear in the file list inside the dotfiles repo.
877 -- Yaziline statusline uses liney separators.
878 -- Plain full border is visible.
880 -Quit with `q`.
882 -- [ ] **Step 4: Inspect Yazi log if smoke test fails**
884 -Run:
886 -```bash
887 -tail -200 /home/me/.local/state/yazi/yazi.log
888 -```
890 -Expected: no Lua stack traces for configured plugins after any needed fixes.
892 -- [ ] **Step 5: Commit smoke-test fixes if any**
894 -If the smoke test required config changes, run:
896 -```bash
897 -cd /home/me/Workspace/dotfiles
898 -git add yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua yazi/package.toml yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml nugu/yazi.nu nugu/justfile
899 -git commit -m "fix: smoke test yazi config"
900 -```
902 -Expected: commit succeeds only if there were fixes. If there were no changes, skip this step.
904 ----
906 -### Task 7: Final repository verification
908 -**Files:**
909 -- Verify all changed files from previous tasks.
911 -- [ ] **Step 1: Check concise Git status**
913 -Run:
915 -```bash
916 -cd /home/me/Workspace/dotfiles
917 -git status --short .gitignore desktop.symlinks fedora.symlinks x230.symlinks nugu/yazi.nu nugu/justfile yazi docs/superpowers/specs/2026-05-30-yazi-nugu-dotfiles-design.md docs/superpowers/plans/2026-05-30-yazi-nugu-dotfiles.md
918 -```
920 -Expected: no unstaged changes for these paths. `yazi/plugins/` must not appear.
922 -- [ ] **Step 2: Run full dotfiles check**
924 -Run:
926 -```bash
927 -cd /home/me/Workspace/dotfiles
928 -just check
929 -```
931 -Expected: command exits 0.
933 -- [ ] **Step 3: Record final notes**
935 -If all validation passes, add a short note to the final response:
937 -```text
938 -Implemented Yazi dotfiles config with generated Nugu flavors, managed plugin lock, Yazi-native key overrides, and live symlink install. Deferred jj plugin/lazygit/bookmarks/sessions as planned.
939 -```
941 -No file change is required for this step.

docs/superpowers/specs/2026-05-30-yazi-nugu-dotfiles-design.md

Deleted
deleted file mode 100644
1 -# Yazi Nugu dotfiles design
3 -Date: 2026-05-30
5 -## Goal
7 -Make Yazi a first-class, dotfiles-managed terminal file manager configuration that uses the personal Nugu theme and integrates tastefully with existing tools. The result should feel native to the rest of the dotfiles without turning Yazi into a large plugin project.
9 -## Non-goals
11 -- Do not vendor third-party plugin repositories into dotfiles.
12 -- Do not add bookmarks or session/autosession plugins.
13 -- Do not replace Yazi defaults wholesale.
14 -- Do not add a Space leader layer; keep Space for selection.
15 -- Do not implement Jujutsu (`jj`) Yazi plugin support in v1.
16 -- Do not add heavyweight statusline alternatives beyond the chosen minimal statusline plugin.
18 -## Current context
20 -- Live Yazi config currently lives in `~/.config/yazi` and contains only:
21 - - `theme.toml`, selecting the `noctalia` flavor.
22 - - `flavors/noctalia.yazi/flavor.toml`.
23 -- Dotfiles do not currently manage `~/.config/yazi`.
24 -- Nugu already provides generated themes for Ghostty, Helix, and WezTerm.
25 -- Existing dotfiles favor declarative config, Nushell automation, generated theme artifacts, and symlink manifests.
26 -- Relevant available tools include `nvim`, `git`, `jj`, `glow`, `bat`, `mpv`, `wl-copy`, `fzf`, `zoxide`, `fd`, `rg`, `jq`, `7z`, `ffmpeg`, `magick`, `resvg`, `pdftoppm`, `ouch`, and `hexyl`.
28 -## Architecture
30 -### Dotfiles ownership
32 -Create a new `yazi/` directory in the dotfiles repository. It will be symlinked to `~/.config/yazi` through the host symlink manifests, consistent with other applications.
34 -Planned files:
36 -```text
37 -yazi/
38 -├── theme.toml
39 -├── yazi.toml
40 -├── keymap.toml
41 -├── init.lua
42 -├── package.toml
43 -└── flavors/
44 - ├── nugu-dark.yazi/
45 - │ └── flavor.toml
46 - └── nugu-light.yazi/
47 - └── flavor.toml
48 -```
50 -The symlink manifest should map:
52 -```text
53 -yazi
54 -~/.config/yazi
55 -```
57 -Linux desktop host manifests should receive this mapping: `desktop.symlinks`, `fedora.symlinks`, and `x230.symlinks`. `termux.symlinks` and Windows manifests can be added later if Yazi is used there.
59 -### Plugin package hygiene
61 -Yazi plugins will be managed with `ya pkg`. The committed source of truth is `yazi/package.toml`, not the installed plugin directories.
63 -- Commit `package.toml`.
64 -- Ignore `yazi/plugins/`.
65 -- Do not vendor plugin repositories.
66 -- Restore plugins on a new machine with `ya pkg install`.
68 -The generated Nugu flavors are not third-party plugin clutter. They are first-party generated artifacts and should be committed.
70 -### Nugu integration
72 -Add a `nugu/yazi.nu` generator that maps Nugu palette roles to Yazi's flavor schema.
74 -Extend `nugu/justfile` with a `yazi` recipe that:
76 -1. Builds or reads the Nugu palette.
77 -2. Generates dark and light flavor files under `output/yazi/` or directly writes `../yazi/flavors/nugu-{dark,light}.yazi/flavor.toml`.
78 -3. Keeps generated Yazi flavor output reproducible.
80 -Extend `nugu/justfile install` to include the Yazi generation step.
82 -`yazi/theme.toml` will select Nugu:
84 -```toml
85 -[flavor]
86 -dark = "nugu-dark"
87 -light = "nugu-light"
88 -```
90 -Yazi will use separate generated Nugu dark and light flavors so terminal light/dark switching has matching colors.
92 -## Theme mapping
94 -The Yazi flavor should use Nugu semantic palette roles rather than raw arbitrary colors.
96 -Suggested role mapping:
98 -- App/status backgrounds: `ui.backdrop`.
99 -- Main text: `content.normal`.
100 -- File manager borders: `ui.unfocus` or `ui.minor`.
101 -- Active UI elements: `ui.accent` and `ui.important_local`.
102 -- Selected counts/markers: `content.focus` and `ui.important_local`.
103 -- Warnings/errors: `warning` and `error`.
104 -- Git signs:
105 - - modified: `warning`
106 - - added: `content.focus`
107 - - untracked: `content.accent`
108 - - deleted: `error`
109 - - ignored: `content.minor`
111 -The initial flavor should style enough of Yazi to feel intentionally Nugu without duplicating the full Noctalia icon table. Existing Yazi default icons can remain unless they clash visually.
113 -## Yazi behavior config
115 -`yazi/yazi.toml` should be minimal and override defaults only where the dotfiles imply a preference.
117 -Planned manager settings:
119 -```toml
120 -[mgr]
121 -show_hidden = true
122 -sort_by = "natural"
123 -sort_dir_first = true
124 -linemode = "none"
125 -```
127 -Use default pane ratio `[1, 4, 3]` unless testing shows preview feels cramped.
129 -Preview/opening behavior:
131 -- Keep built-in JSON, PDF, image, video, and archive previews where they work well.
132 -- Use `piper` selectively for tools already present:
133 - - Markdown preview via `glow`.
134 - - Fallback binary preview via `hexyl`.
135 -- Use `ouch` for archive preview/extract behavior where it improves over defaults.
136 -- Use `nvim` as blocking editor.
137 -- Use `mpv` for media.
138 -- Use `xdg-open` for general open behavior.
140 -Git integration:
142 -- Configure `git.yazi` fetchers for files and directories.
143 -- Do not configure `vcs-files` in v1.
144 -- Do not attempt inline `jj` status in v1.
146 -## Lua initialization
148 -`yazi/init.lua` should only initialize selected plugins and avoid custom UI rewrites.
150 -Planned setup:
152 -```lua
153 -require("full-border"):setup { type = ui.Border.PLAIN }
154 -require("git"):setup { order = 1500 }
155 -require("yaziline"):setup { separator_style = "liney" }
156 -```
158 -Additional plugin setup can be added only if required by the chosen plugin's documented API. Avoid overriding core Yazi UI build functions.
160 -## Keymap design
162 -Use `[[mgr.prepend_keymap]]` only. Preserve Yazi defaults and add targeted improvements.
164 -Principles:
166 -- Space remains selection.
167 -- `g`, `t`, `c`, and existing Yazi prefix groups remain native Yazi-style groups.
168 -- No full keymap replacement.
169 -- Avoid terminal-fragile Alt bindings when a normal sequence is available.
171 -Planned bindings:
173 -| Key | Action |
174 -| --- | --- |
175 -| `l` | `plugin smart-enter` |
176 -| `<Enter>` | `plugin smart-enter` |
177 -| `p` | `plugin smart-paste` |
178 -| `f` | `plugin smart-filter` |
179 -| `T` | `plugin toggle-pane min-preview` |
180 -| `F` | `plugin toggle-pane max-preview` |
181 -| `c m` | `plugin chmod` |
182 -| `c D` | `plugin diff` |
183 -| `!` | blocking `$SHELL` in current directory |
184 -| `g w` | `cd ~/Workspace` |
185 -| `g k` | `cd ~/Workspace/dotfiles` |
186 -| `g n` | `cd ~/Notes` |
187 -| `g y` | `cd ~/.config/yazi` |
188 -| `g r` | change to repo root using `git rev-parse --show-toplevel` or `jj root` |
190 -Input behavior:
192 -- Override input `<Esc>` to close the input immediately, avoiding Yazi input's vi-normal mode when the intent is simple cancellation.
194 -## Plugin set
196 -Install and lock these plugins in `yazi/package.toml`:
198 -- `yazi-rs/plugins:full-border`
199 -- `yazi-rs/plugins:toggle-pane`
200 -- `yazi-rs/plugins:smart-enter`
201 -- `yazi-rs/plugins:smart-filter`
202 -- `yazi-rs/plugins:smart-paste`
203 -- `yazi-rs/plugins:git`
204 -- `yazi-rs/plugins:chmod`
205 -- `yazi-rs/plugins:diff`
206 -- `yazi-rs/plugins:piper`
207 -- `ndtoan96/ouch`
208 -- `llanosrocas/yaziline`
210 -Deferred plugins and integrations:
212 -- Custom `jj` plugin.
213 -- `vcs-files` and `git-files`.
214 -- Bookmark plugins.
215 -- Session/autosession plugins.
216 -- `lazygit` plugin until the `lazygit` binary is installed.
217 -- `starship`, `yatline`, `simple-status`, and other statusline alternatives.
218 -- `mount`, `sudo`, and clipboard plugins.
220 -## Validation strategy
222 -Functional validation:
224 -1. Generate Nugu Yazi flavor.
225 -2. Run `ya pkg install` from the Yazi config directory.
226 -3. Run `yazi --debug` to inspect merged config and schema issues.
227 -4. Launch Yazi with `YAZI_LOG=debug` if plugin errors occur.
228 -5. Check keybindings in Yazi help.
229 -6. Smoke-test:
230 - - hidden files visible by default
231 - - `l`/Enter smart-enter behavior
232 - - `p` smart-paste behavior
233 - - `f` smart-filter behavior
234 - - `T` and `F` pane behavior
235 - - `c m` chmod prompt
236 - - `c D` diff behavior
237 - - Markdown preview via glow
238 - - archive handling via ouch
239 - - git signs in a Git repo
241 -Repo validation:
243 -1. Ensure `yazi/plugins/` is ignored.
244 -2. Ensure `yazi/flavors/nugu-dark.yazi/flavor.toml` and `yazi/flavors/nugu-light.yazi/flavor.toml` are tracked.
245 -3. Ensure symlink manifest tests still pass.
246 -4. Ensure regenerating Nugu Yazi flavor produces no unexpected diff.
248 -## Implementation phases
250 -1. Add Yazi dotfiles skeleton and symlink manifest entries.
251 -2. Add Nugu Yazi generator and generated flavor.
252 -3. Add Yazi config files (`theme.toml`, `yazi.toml`, `keymap.toml`, `init.lua`).
253 -4. Install and lock selected plugins via `ya pkg`.
254 -5. Add ignore rules for installed plugin artifacts.
255 -6. Validate with Yazi, Nugu generation, and dotfiles checks.
257 -## Open follow-ups after v1
259 -- Add a local custom Yazi plugin for `jj` changed files or inline status signs.
260 -- Consider adding a `just yazi` or root-level dotfiles recipe for Yazi validation.
261 -- Consider adding `lazygit` integration if the binary is installed later.

pi/agent/themes/terminal.json

Modified
43 43 "scrollbarThumb": "uiFocus",
44 44 "searchMatchBg": "green",
45 45 "searchMatchText": "black",
46 - "userMessageBg": "uiFocus",
46 + "userMessageBg": "magenta",
47 47 "userMessageText": "uiBackdrop",
48 48 "customMessageBg": "uiBackdrop",
49 - "customMessageText": "",
49 + "customMessageText": "fg",
50 50 "customMessageLabel": "brightMagenta",
51 51 "toolPendingBg": "uiBackdrop",
52 52 "toolSuccessBg": "uiBackdrop",
53 53 "toolErrorBg": "uiBackdrop",
54 54 "toolTitle": "brightMagenta",
55 - "toolOutput": "",
55 + "toolOutput": "fg",
56 56 "mdHeading": "brightWhite",
57 57 "mdLink": "magenta",
58 58 "mdLinkUrl": "brightBlack",

topgrade/update-wezterm-nightly.ps1

Deleted
deleted file mode 100644
1 -$ErrorActionPreference = 'Stop'
3 -if (Get-Process -Name 'wezterm-gui', 'OpenConsole' -ErrorAction SilentlyContinue) {
4 - Write-Output 'Skipping WezTerm update because WezTerm is running.'
5 - exit 0
6 -}
8 -$winget = Join-Path $env:LOCALAPPDATA 'Microsoft\WindowsApps\winget.exe'
9 -if (-not (Test-Path -LiteralPath $winget -PathType Leaf)) {
10 - throw "WinGet not found at $winget"
11 -}
13 -& $winget upgrade `
14 - --id wez.wezterm.nightly `
15 - --exact `
16 - --source winget `
17 - --silent `
18 - --disable-interactivity `
19 - --accept-package-agreements `
20 - --accept-source-agreements
21 -exit $LASTEXITCODE

topgrade/win32.toml

Modified
20 20 [commands]
21 21 "WSL ArchLinux-dev" = "wsl --distribution ArchLinux-dev --exec /usr/sbin/topgrade -y"
22 22 "Windows Update" = "powershell -NoProfile -Command 'Get-WindowsUpdate -MicrosoftUpdate -UpdateType Software -AcceptAll -Install -IgnoreReboot'"
23 +"WezTerm Nightly" = "winget install --id wez.wezterm.nightly --exact --source winget --accept-package-agreements --accept-source-agreements"
23 24 "WSL Cgroup Workaround" = '& "C:\Users\okr\Workspace\dotfiles\topgrade\sync-wsl-cgroup-workaround.ps1"'
25 26 [containers]