From c5c2d9832efcf3431c6e4fff0e6074590ee4ea30 Mon Sep 17 00:00:00 2001 From: Phil Date: Tue, 10 Nov 2026 14:24:43 -0700 Subject: [PATCH] docs: ADR-074: one configurable priority for all messages Co-Authored-By: Claude Opus 5.5 --- docs/decisions/ADR-074-notifications.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/docs/decisions/ADR-074-notifications.md b/docs/decisions/ADR-074-notifications.md index 0ae468b..5bbea23 100644 --- a/docs/decisions/ADR-074-notifications.md +++ b/docs/decisions/ADR-074-notifications.md @@ -56,19 +56,29 @@ show links; others get the text. - **Replies, mentions, quotes:** one message each. Title "↩ Reply from Ana Lima via Bluesky" (or "💬 Mention from …", "❝ Quote from …"); body the response text (plain, up to 300 characters), then a link to the note's - responses (`#responses`). Normal priority. + responses (`#responses`). - **Likes, reposts, bookmarks:** grouped per note and type in each pass: "♥ 3 new likes on 'Starpunk now supports…'", with up to five names and a - link to the note. Low priority. + link to the note. - **Awaiting moderation:** when `WEBMENTION_AUTO_APPROVE` is off, the title says so and the link goes to the admin webmention page instead. - **Problems:** "⚠ Crosspost to Bluesky failed" / "⚠ Backfeed for Threads stopped" with the error and a link to the note's edit page or the - Webmentions page. High priority. + Webmentions page. -Priority is passed per message where the service supports it (Gotify maps -low/normal/high to 0/5/8). Apprise's Gotify plugin has no click-through -link, so the link is in the text. +Apprise's Gotify plugin has no click-through link, so the link is in the +text. + +### 3a. Priority + +Every message is sent with the same priority, `NOTIFY_PRIORITY` (default +`normal`). Apprise takes priority as a `priority` argument in each service +URL, with values that differ by service, so StarPunk adds +`priority=` to each URL in `NOTIFY_URLS` that doesn't set +one itself; a URL can still set its own. Apprise's names (`low`, +`moderate`, `normal`, `high`, `emergency`) work for most services; Gotify +also takes 0–10 (it maps the names to 0, 3, 5, 8, 10). Different +priorities per event can come later. ### 4. Delivery @@ -110,6 +120,7 @@ link, so the link is in the text. |---|---|---| | `NOTIFY_URLS` | empty (off) | Apprise URLs, space- or comma-separated | | `NOTIFY_EVENTS` | `reply,mention,quote,problems` | which events are sent | +| `NOTIFY_PRIORITY` | `normal` | priority of every message, added to URLs that don't set one | Settings stay in the environment, like the rest of StarPunk's (ADR-052). URLs contain tokens and belong with the other secrets.