Changeset dc4aa08 in Klonkt for docs

Timestamp:

07/22/2026 07:12:11 AM (7 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

ad10715

Parents:

8b07c12

git-author:

Robin <roboburr@…> (07/22/2026 06:56:39 AM)

git-committer:

Robin <roboburr@…> (07/22/2026 07:12:11 AM)

Message:

Docs: web-push design (slice 0)

The build reference for background notifications: RFC 8030 Web Push + VAPID,
Mastodon's model on Klonkt conventions. Decisions: web-push dependency
(lazy import, boot-safe), VAPID keys env-wins-else-storage/.vapid (never
regenerate), minimal payloads, subscriptions tied to the logged-in owner,
S2S-inbox triggers (follow/reply/like/boost/DM). FEP-3ab2 (SSE) noted as the
live-while-open counterpart that doesn't fit cookie-less Klonkt.

New file:
docs/webpush-design.md

• decisions, data model, flow, trigger points, caveats, slices

-robo
Co-Authored-By: Claude Opus 4.8 <noreply@…>

File:

• docs/webpush-design.md (added)