dotfiles bugabingas dorkfiles
owned by bugabinga
README Source History Refs Compare Notes Search test(quickshell): audit hypr migration coverage
08edcff857048eba4db7b56b23fc04a9fee02382
Oliver Jan Krylow <oliver@bugabinga.net > · 17 Jun 2026
unsigned
Browse files Compare 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.
78 78 hypr_migration_rows=21
80 81 rollout_boundary=ok
106 107 hypr_migration_rows=21
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}" )
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)}" )