27 lines
919 B
Markdown
27 lines
919 B
Markdown
---
|
|
name: shd-notifications
|
|
description: Use when the user asks to inspect SHD notifications, notification modules, read state or preferences, or mark notifications read.
|
|
metadata: modules=notifications
|
|
---
|
|
|
|
# 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.
|