Config actions now override message actions

Previously config actions were a fallback when message had no actions.
Now config actions take priority, allowing local scripts/URLs to always
appear regardless of what the message sender specified.

Also update README with click_url documentation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: laurentftech

README.md

@@ -180,6 +180,8 @@ servers:
 - `path` (required for script): Absolute path to script file
 - `url` (required for view): URL to open when clicked
 
+**Note**: Config-defined actions override any [actions](https://docs.ntfy.sh/publish/#action-buttons) sent with the ntfy message. This lets you define your own local scripts/URLs that always appear, regardless of what the message sender specified. Message actions are only used when no config actions are defined for the topic.
+
 ## CLI Commands
 
 ### serve

Sources/NotificationManager.swift

@@ -182,8 +182,16 @@ final class NotificationManager: NSObject, @unchecked Sendable {
             "messageId": message.id
         ]
 
-        // Handle actions from message (ntfy protocol)
-        if let messageActions = message.actions, !messageActions.isEmpty {
+        // Handle actions: config actions override message actions
+        if let actions = topicConfig.actions, !actions.isEmpty {
+            // Config actions take priority - use them instead of message actions
+            let categoryId = "topic-\(message.topic)-actions"
+            registerCategory(categoryId: categoryId, actions: actions)
+            content.categoryIdentifier = categoryId
+            print("Using \(actions.count) actions from config (overriding message actions)")
+            fflush(stdout)
+        } else if let messageActions = message.actions, !messageActions.isEmpty {
+            // No config actions - use message actions
             let categoryId = "msg-\(message.id)-actions"
             registerCategoryFromMessage(categoryId: categoryId, actions: messageActions)
             content.categoryIdentifier = categoryId
@@ -199,12 +207,6 @@ final class NotificationManager: NSObject, @unchecked Sendable {
             print("Registered \(messageActions.count) actions from message")
             fflush(stdout)
         }
-        // Handle actions from config (fallback)
-        else if let actions = topicConfig.actions, !actions.isEmpty {
-            let categoryId = "topic-\(message.topic)-actions"
-            registerCategory(categoryId: categoryId, actions: actions)
-            content.categoryIdentifier = categoryId
-        }
 
         content.userInfo = userInfo