## Summary
Define when desktop activity suppresses otherwise eligible mobile
message notifications: a ten-minute inactivity window, short-lived
relay-owned suppression, and per-installation push preferences. Include
a shared glossary and renewal timing diagram. The gateway remains
unaware of suppression.
This is a design draft ready for review, not an implementation-ready
protocol. Wire format, synchronization, and several failure-handling
details remain explicitly open. Please also review the tension between
the agreed relay-confirmed preference changes and VISION_MOBILE.md's
requirement that stopping notifications must not depend on a relay
response.
### Related issue
Related: #3234 covers per-channel notification settings and push
filtering; this spec focuses on desktop-activity suppression. No
duplicate spec PR found.
### Testing
Documentation-only change. Local Markdown links and anchors resolve;
whitespace validation and commit hooks passed. The full local CI gate
could not complete: dependency compilation exhausted local disk space
(OS error 28). GitHub checks currently report no failures.
---------
Signed-off-by: Tom Brow <tomb@block.xyz>
Co-authored-by: Diem Nguyen <ngthuydiem@users.noreply.github.com>
## Summary
Add the Buzz Mobile vision covering intended experience, architecture,
shared client behavior, verification, release cadence, and critical
functionality. Link it from the mobile README; the existing agent
instruction to read relevant `VISION_*.md` documents makes it
discoverable during planning and review.
### Related issue
No duplicate issue or PR found.
### Testing
Documentation-only change. Diff checks and pre-push hooks passed.
Repository-wide `just ci` is running locally; Rust formatting has
passed.
---------
Signed-off-by: Tom Brow <tomb@block.xyz>