Jannis Braun
e35b44c05f
docs(systems): outbound peering gate documentation across federation, db, api, ws, admin, client-federation
...
- federation.md: Outbound Peering Gate subsection (gate, intent contract,
gate-but-don't-queue split, lifecycle invariant on onPeerActivated)
- database.md: peer_approval_requests direction + nullable hmac_secret +
UNIQUE relaxation + CHECK; new peer_approval_subscribers + peer_approval_
notifications tables
- api.md: /approval-requests direction-branched approve/deny + extended GET
response; new peering-subscriptions and peering-notifications endpoints
- websocket.md: peering_subscription_changed, peering_notification_received
events; federation_approval_request_received fires for outbound too
- admin.md: outbound row rendering with subscriber list
- client-federation.md: 'admin_required' status, peer_pending_local_admin
error code, new Connections surfaces, federationStore slice
Spec §11 closes the Approve-button investigation finding.
2026-04-26 22:59:27 +02:00
Jannis Braun
94294c64b9
docs(systems): document approval token mechanism
...
federation.md: new 'Approval Token Verification' subsection covering
issuance (queue path generates token, returns in 202), storage on
initiator (federation_peers.approval_token), forwarding from /approve,
verification on receiver's awaiting_approval branch, single-use lifecycle,
backward compatibility, and threat-model boundary (sender-side outbound
gating tracked separately).
database.md: approval_token column documented on both federation_peers
and peer_approval_requests with cross-references to federation.md.
api.md: /peer/accept request + 202 response now show optional
approvalToken field with pointer to the federation spec.
2026-04-26 11:53:54 +02:00
Jannis Braun
e15661e1bc
docs(systems): S2S friend-add — social/client-federation/federation/api
...
Reflects what shipped on feat/s2s-friend-add (T1-T22 verified live):
- social.md: rewrite §6 outbound friend_request_create flow (sender's
home is now the queueing instance for native users); §8 sendFriendRequest
collapsed to single home-API call; §12 drops ConnectInstanceModal
trigger; new "Failure Handling" subsection covers rollback path;
relayMessageId schema note added.
- client-federation.md: split paragraph clarifying friend/DM = S2S,
spaces = client-federated; §1 clarifies federated accounts are now
spaces-only; new API-client error contract subsection (err.message
carries the code, not err.body — caught + fixed in fe969a7
2026-04-25 23:33:13 +02:00
Jannis Braun
a023c85cad
docs: document S2S profile sync relay and write-protection guard
2026-04-07 14:01:44 +02:00
Jannis Braun
b8ab162570
fix(server): add registry size/duplicate validation; update database and API docs
2026-04-01 18:25:24 +02:00
Jannis Braun
a3a7527c9e
chore: add system docs, specs, and misc updates from other sessions
...
- Add complete docs/systems/ reference (18 system docs)
- Add federation relay status doc and prior spec/plan docs
- Remove superseded docs/federation-dm-s2s.md (replaced by docs/systems/federation.md)
- CLAUDE.md updates
- Minor fixes in social.ts, types.ts, AddDmMemberModal, NewDmModal, UserSettings
2026-03-31 03:40:34 +02:00
Jannis Braun