chore: keep widget sources only

2026-09-17 23:29:09 +03:00
commit e0404617d2
125 changed files with 8935 additions and 0 deletions
@@ -0,0 +1,25 @@
+---
+name: shd-notifications
+description: Use when the user asks to inspect SHD notifications, notification modules, read state or preferences, or mark notifications read.
+---
+
+# SHD notifications
+
+See `references/notification-contract.md` for read-state and preference
+boundaries.
+
+## Read
+
+- Use `shd_list_notifications` with bounded filters and preserve notification
+  IDs and timestamps.
+- Use module, read-state and preference tools only for the authenticated user
+  or the explicitly authorized scope.
+- Distinguish unread, read, muted and unavailable data; do not invent a missing
+  notification source.
+
+## State changes
+
+Marking one or more notifications read or changing preferences changes user
+state. Do it only when explicitly requested, use the returned IDs, and report
+the number and final state. Never mark a whole feed read merely because it was
+displayed or summarized.