1 +#
Quickshell Hypr Companions Phase 3 Notification Daemon 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:** Add a native Quickshell notification daemon with Mako-style popup rendering, controlled by IPC and disabled by default until tests stop Mako deliberately.
7 +**Architecture:** Keep Mako live by default. Quickshell only instantiates `NotificationServer` when IPC enables native notifications, avoiding DBus daemon competition during normal Phase 3 development. Popups are rendered as top-right overlay `PanelWindow`s using Nugu tokens and mirror Mako geometry/timeouts closely enough for controlled verification.
9 +**Tech Stack:** Quickshell 0.3.0, QML/QtQuick, `Quickshell.Services.Notifications`, `Quickshell.Wayland`, `notify-send`, Mako rollback via `systemctl --user restart mako.service`.
11 +**Roadmap:** `docs/super/roadmaps/2026-06-17-quickshell-hypr-companions-roadmap.md`
13 +**Phase:** Phase 3: Native notification daemon replacing Mako
21 +- Native `NotificationServer`, disabled by default.
22 +- Top-right popup stack, max 4 visible, Mako-like size/style.
23 +- Low/normal/critical timeout policy: 2500ms / 6500ms / persistent.
24 +- App, summary, body, optional image/icon placeholder, action buttons.
25 +- Left action invoke, middle/right dismiss.
26 +- History cap 80 and IPC restore/dismiss-all.
27 +- IPC enable/disable/count methods for controlled testing.
28 +- Verification record.
33 +- Hypr service manifest changes.
34 +- Hypr bind migration.
35 +- Full action test tooling beyond notify-send smoke tests.
40 +1. Create `quickshell/nugu/NotificationToast.qml` for one notification popup.
41 +2. Create `quickshell/nugu/NotificationDaemon.qml` with `NotificationServer`, history, restore, dismiss-all, timeout handling.
42 +3. Wire `NotificationDaemon` behind a `Loader` in `shell.qml`; add IPC methods `enableNativeNotifications`, `disableNativeNotifications`, `nativeNotificationCount`, `dismissNativeNotifications`, `restoreNativeNotification`.
43 +4. Parse-check with daemon disabled.
44 +5. Controlled live test: start temporary config, stop Mako, enable native notifications, send `notify-send` normal/low/critical, screenshot, dismiss, disable native notifications, restart Mako.
45 +6. Write `docs/super/inventory/2026-06-17-quickshell-phase-3-notification-verification.md`.
46 +7. Commit without modifying Mako service/manifests.
50 +- Before enabling native notifications, stop Mako only inside a test block with a trap that restarts it.
51 +- If Quickshell fails to start or receive notifications, immediately restart Mako.
52 +- Never leave two notification daemons competing except transiently during rollback.
53 +- Never mark Mako obsolete until Phase 3 verification passes and user approves retirement in a later commit.