repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

test(quickshell): audit hypr migration coverage

08edcff857048eba4db7b56b23fc04a9fee02382

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (3)

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

Modified
23 23 - every `transitional` external command is listed in `TRANSITIONS.md` with current role and removal gate; stale transition rows fail.
24 24 - future service rollout is documented in `SERVICE.md`; `hypr/systemd/quickshell.service` must start `qs -c nugu`, and `x230.symlinks` must link both config and service.
25 25 - 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.
26 -- Hypr simplification is documented in `HYPR_MIGRATION.md`; rows must cover old helper markers and point only at existing `nugu` IPC methods.
26 +- 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.
27 27 - QML imports are limited to Qt, Quickshell, and local `import "."`.
28 28 - every QML component has an early decision/why comment, not just a generic file description.
29 29 - QML comments do not contain unresolved TODO/stub/placeholder markers; rollout status belongs in inventories.
76 76 parity_matrix=ok
77 77 parity_rows=12
78 78 hypr_migration_rows=21
79 +hypr_current_refs=8
79 80 hypr_migration=ok
80 81 rollout_boundary=ok
81 82 contrast_pairs=12
104 105 parity_matrix=ok
105 106 parity_rows=12
106 107 hypr_migration_rows=21
108 +hypr_current_refs=8
107 109 hypr_migration=ok
108 110 rollout_boundary=ok
109 111 contrast_pairs=12

quickshell/nugu/HYPR_MIGRATION.md

Modified
8 8 | Current bind/tool | Current path | Future Quickshell target | Migration gate |
9 9 | --- | --- | --- | --- |
10 -| `SUPER + Space` / `hyprlauncher` | `apps.launcher` | `qs ipc -c nugu call nugu openLauncher` | Launcher live bind, keyboard, mouse, app-launch, and screenshot parity verified. |
10 +| `SUPER + Space` / `hyprlauncher` | `apps.launcher` / `launcher: hyprlauncher` | `qs ipc -c nugu call nugu openLauncher` | Launcher live bind, keyboard, mouse, app-launch, and screenshot parity verified. |
11 11 | `SUPER + V` / `cliphist plus hyprlauncher --dmenu` | `apps.clipboard` | `qs ipc -c nugu call nugu openClipboardPicker` | Clipboard picker live bind, selection, copy, keyboard, mouse, and storage decision verified. |
12 12 | `CTRL + ALT + Delete` / `hyprshutdown` | `apps.logout` | `qs ipc -c nugu call nugu openPowerMenu` | Confirmed power UI accepted; lock/sleep/logout/reboot/poweroff gates approved. |
13 13 | `SUPER + SHIFT + R` / `hyprctl notify` reload wrapper | `osd.session.reload` | `qs ipc -c nugu call nugu osdReloadHypr` | Reload action produces Quickshell OSD and Hypr config still has no errors. |

quickshell/nugu/audit.sh

Modified
336 336 hypr_migration_doc = config_dir / "HYPR_MIGRATION.md"
337 337 hypr_migration_rows = []
338 +hypr_current_refs = []
338 339 if hypr_migration_doc.exists():
339 340 migration_source = hypr_migration_doc.read_text()
340 341 migration_text = migration_source.lower()
387 388 if re.search(r"\b(TODO|FIXME|XXX|HACK|stub|placeholder)\b", " ".join(cells), re.I):
388 389 errors.append(f"HYPR_MIGRATION.md:{number}: unresolved placeholder wording")
389 390 hypr_migration_rows.append(cells)
391 + current_ref_checks = (
392 + ("hypr/modules/apps.lua", "hyprlauncher", "apps.launcher"),
393 + ("hypr/modules/apps.lua", "hyprlauncher --dmenu", "apps.clipboard"),
394 + ("hypr/modules/apps.lua", "cliphist", "apps.clipboard"),
395 + ("hypr/modules/apps.lua", "hyprshutdown", "apps.logout"),
396 + ("hypr/modules/hypr_osd.lua", "hyprctl notify", "osd.session.reload"),
397 + ("hypr/modules/hypr_osd.lua", "makoctl", "osd.notifications.clear_all"),
398 + ("hypr/modules/binds.lua", "launcher: hyprlauncher", "SUPER + Space"),
399 + ("hypr/modules/binds.lua", "hyprpicker", "osd.capture.color"),
401 + for rel_path, old_marker, migration_path in current_ref_checks:
402 + source_path = repo_dir / rel_path
403 + if not source_path.exists():
404 + errors.append(f"missing current Hypr source {rel_path}")
405 + continue
406 + source_text = source_path.read_text()
407 + if old_marker in source_text:
408 + hypr_current_refs.append(old_marker)
409 + if old_marker.lower() not in migration_text:
410 + errors.append(f"HYPR_MIGRATION.md missing current Hypr marker {old_marker!r} from {rel_path}")
411 + if migration_path.lower() not in migration_text:
412 + errors.append(f"HYPR_MIGRATION.md missing migration path {migration_path!r} for current marker {old_marker!r}")
413 + if len(hypr_current_refs) < 8:
414 + errors.append(f"HYPR_MIGRATION.md checked only {len(hypr_current_refs)} current Hypr refs; expected old-helper coverage")
390 415 if len(hypr_migration_rows) < 20:
391 416 errors.append(f"HYPR_MIGRATION.md has only {len(hypr_migration_rows)} migration rows; expected old bind coverage")
482 507 print("parity_matrix=ok")
483 508 print(f"parity_rows={len(parity_rows)}")
484 509 print(f"hypr_migration_rows={len(hypr_migration_rows)}")
510 +print(f"hypr_current_refs={len(hypr_current_refs)}")
485 511 print("hypr_migration=ok")
486 512 print("rollout_boundary=ok")
487 513 print(f"contrast_pairs={len(contrast_pairs)}")