repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

test(quickshell): audit parity matrix rows

709f3eb106c614a6eb264119d0880144f19986bc

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
19 19 - component, IPC, and external inventory rows reject duplicates, malformed names, thin text, and placeholder wording.
20 20 - every approved executable boundary is listed in `EXTERNALS.md` with status and reason, and stale unused rows fail.
21 21 - 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.
22 -- replacement scope is documented in `PARITY.md`, including old companion retirement targets and human approval.
22 +- replacement scope is documented in `PARITY.md`, including old companion retirement targets, non-thin row statuses/gates, valid QML replacement references, and human approval.
23 23 - QML imports are limited to Qt, Quickshell, and local `import "."`.
24 24 - every QML component has an early decision/why comment, not just a generic file description.
25 25 - QML comments do not contain unresolved TODO/stub/placeholder markers; rollout status belongs in inventories.
64 64 inventory_tables=ok
65 65 service_contract=ok
66 66 parity_matrix=ok
67 +parity_rows=12
67 68 contrast_pairs=12
68 69 contrast_min=5.50
69 70 required_files=shell.qml,Theme.qml,nugu.json,README.md,COMPONENTS.md,IPC.md,EXTERNALS.md,SERVICE.md,PARITY.md,audit.sh,smoke.sh
83 84 inventory_tables=ok
84 85 service_contract=ok
85 86 parity_matrix=ok
87 +parity_rows=12
86 88 contrast_pairs=12
87 89 contrast_min=5.50
88 90 required_files=shell.qml,Theme.qml,nugu.json,README.md,COMPONENTS.md,IPC.md,EXTERNALS.md,SERVICE.md,PARITY.md,audit.sh,smoke.sh

quickshell/nugu/PARITY.md

Modified
8 8 | --- | --- | --- | --- |
9 9 | `ironbar.service` top bar | `Bar.qml` plus status widgets | Implemented hidden-by-default. | Multi-monitor, wheel, click, tray, screenshots, perf, and human style approval. |
10 10 | `ironbar-workspaces.service` | `WorkspaceWidget.qml` | Implemented in the bar. | Live workspace click/scroll parity and same-workspace screenshots. |
11 -| Ironbar tray module | `TrayWidget.qml` | Implemented. | Real tray client and menu forwarding validation. |
11 +| Ironbar tray module | `TrayWidget.qml` | Implemented in bar, pending real client. | Real tray client and menu forwarding validation. |
12 12 | Ironbar notification count/actions | `NotificationBridgeWidget.qml` | Transitional Mako bridge. | Native notification history/actions replace bridge. |
13 13 | `mako.service` notification daemon | `NotificationDaemon.qml` and `NotificationToast.qml` | Implemented but disabled by default. | Healthy user DBus, urgency, timeout, dismiss, action, restore, and rollback tests. |
14 14 | `makoctl` notification controls | Native notification IPC plus bar widgets | Transitional bridge remains. | Audit no longer warns about `makoctl`, and Mako is approved for retirement. |
16 16 | `hyprlauncher --dmenu` clipboard picker | `ClipboardPicker.qml` | Frontend implemented. | Storage decision made; `cliphist` bridge either accepted or removed before old launcher retirement. |
17 17 | `cliphist` clipboard storage/actions | `ClipboardWidget.qml` and `ClipboardPicker.qml` | Transitional backend remains. | Audit no longer warns about `cliphist`, or storage bridge is explicitly approved as retained infrastructure. |
18 18 | `hyprshutdown` power UI | `PowerMenu.qml` and `PowerWidget.qml` | Dry-run matrix verified; destructive actions gated. | Lock/sleep/logout/reboot/poweroff parity with explicit destructive-action approval. |
19 -| `hyprctl notify` OSD wrappers | `Osd.qml` and OSD IPC/action methods | Implemented. | Real Hypr keybind validation for audio, brightness, media, capture, color, lock, and reload actions. |
19 +| `hyprctl notify` OSD wrappers | `Osd.qml` and OSD IPC/action methods | Implemented as Quickshell IPC surface. | Real Hypr keybind validation for audio, brightness, media, capture, color, lock, and reload actions. |
20 20 | Hypr companion binds | `qs ipc -c nugu call nugu ...` | IPC surface documented. | Quickshell service live/recoverable, then Hypr config simplified and old references removed. |
22 22 ## Non-negotiable rollout boundary

quickshell/nugu/audit.sh

Modified
232 232 errors.append("missing x230.symlinks")
234 234 parity_doc = config_dir / "PARITY.md"
235 +parity_rows = []
235 236 if parity_doc.exists():
236 - parity_text = parity_doc.read_text().lower()
237 + parity_source = parity_doc.read_text()
238 + parity_text = parity_source.lower()
237 239 required_parity_markers = (
238 240 "ironbar.service",
239 241 "ironbar-workspaces.service",
251 253 for marker in required_parity_markers:
252 254 if marker not in parity_text:
253 255 errors.append(f"PARITY.md missing replacement marker {marker!r}")
257 + seen_current = set()
258 + actual_qml = {path.name for path in qml_files}
259 + for number, line in enumerate(parity_source.splitlines(), 1):
260 + if not line.startswith("|") or "---" in line:
261 + continue
262 + cells = [cell.strip() for cell in line.strip().strip("|").split("|")]
263 + if not cells or cells[0] == "Current companion surface/tool":
264 + continue
265 + if len(cells) != 4:
266 + errors.append(f"PARITY.md:{number}: parity row needs current, replacement, status, and retirement gate columns")
267 + continue
268 + current, replacement, status, gate = cells
269 + key = "".join(ch for ch in current if ch != chr(96)).lower()
270 + if key in seen_current:
271 + errors.append(f"PARITY.md:{number}: duplicate current companion row {current!r}")
272 + seen_current.add(key)
273 + if len(status) < 16:
274 + errors.append(f"PARITY.md:{number}: thin current status for {current!r}")
275 + if len(gate) < 24:
276 + errors.append(f"PARITY.md:{number}: thin retirement gate for {current!r}")
277 + if re.search(r"\b(TODO|FIXME|XXX|HACK|stub|placeholder)\b", " ".join(cells), re.I):
278 + errors.append(f"PARITY.md:{number}: unresolved placeholder wording")
279 + for qml_name in re.findall(r"`([^`]+\.qml)`", replacement):
280 + if qml_name not in actual_qml:
281 + errors.append(f"PARITY.md:{number}: replacement references missing QML file {qml_name}")
282 + parity_rows.append(cells)
283 + if len(parity_rows) < 12:
284 + errors.append(f"PARITY.md has only {len(parity_rows)} parity rows; expected current companion coverage")
255 286 errors.append("missing PARITY.md")
323 354 print("inventory_tables=ok")
324 355 print("service_contract=ok")
325 356 print("parity_matrix=ok")
357 +print(f"parity_rows={len(parity_rows)}")
326 358 print(f"contrast_pairs={len(contrast_pairs)}")
327 359 if contrast_pairs:
328 360 print(f"contrast_min={min(ratio for _mode, _label, ratio in contrast_pairs):.2f}")