← Commit history

Delete skills/hd-notifications-mac/SKILL.md

Kyle Bergstedt ·b2a86ba158 · ·parent 12aadab
1 file changed −48
skills/hd-notifications-mac/SKILL.mddeleted−48
@@ -1,48 +0,0 @@-----name: hd-notifications-mac-description: >-  macOS platform companion to hd-notifications — the Apple-specific half of how-  Hydrogen Desktop reaches the user outside the window. The generic notify handler,-  payload shape, levels, and /ui/toast live in hd-notifications (adom/hd-bootstrap);-  THIS skill carries only the macOS delivery mechanics: Notification Center toasts,-  the emergency Dock-icon attention bounce, and the System Settings → Notifications-  grant. Mirror of hd-notifications-windows (WinRT/AUMID). Trigger words — macos-  notification, notification center, dock bounce, request attention macos, allow-  notifications macos, toast on mac.------# hd-notifications (macOS) — Notification Center + Dock attention--This is the **macOS half** of `hd-notifications`. The cross-platform contract — the-`notify` message, the `NotifyPayload` (`title`/`body`/`level`/`actions`), the levels-`info|warning|error|emergency`, and the in-app `POST /ui/toast` — is identical on-every host and lives in the generic **hd-notifications** skill. Read that first; this-skill only documents what's Apple-specific.--## Delivery--- **Toasts → macOS Notification Center.** A `notify` surfaces as a system-  notification (short for `info`, long-duration for `warning`/`error`/`emergency`),-  rendered by `notifications.rs` → `show_toast`.-- **`emergency` → persistent Dock-icon bounce.** On top of the toast, HD calls-  `request_user_attention(Critical)` on the main window and shows/unminimizes it. On-  macOS this **bounces HD's Dock icon persistently** and keeps demanding attention-  until the user clicks through themselves — a programmatic focus does NOT clear it.-- **Identity.** Toasts surface under the **"Adom"** title (HD prefixes `title` with-  `"Adom: "` unless it already starts with "Adom"), and the notification is attributed-  to HD's **app bundle** — not via a Start-Menu-shortcut AUMID (that's the Windows-  path; see hd-notifications-windows).--## macOS gotcha — the Notifications grant--macOS gates notifications per-app: the user must allow **Hydrogen Desktop** under-**System Settings → Notifications**. If toasts never appear (but the in-app-`/ui/toast` works), that grant is the first thing to check — there's no Windows-style-"always works" toast. Unlike Screen Recording / Accessibility, HD does not block setup-on it; it's best-effort.--## NOT here (lives in the Windows companion)--WinRT toast templates, the Start-Menu-shortcut **AUMID** wiring, and taskbar flash are-the Windows delivery — see `hd-notifications-windows`. Do not apply that machinery on-macOS.