Changeset f3a58a4 in Klonkt for docs

Timestamp:

08/02/2026 06:22:37 PM (5 weeks ago)

Author:

Bart <bart@…>

Branches:

main

Children:

04d5aeb

Parents:

af035e6

Message:

Ontwerp uitgaande follows: gecorrigeerd en aan de beads gehangen

De aanleiding klopte niet: guardians worden wel degelijk ingelicht als hun ward
iemand gaat volgen (1a2f206, een directe note per guardian). Alleen is dat
informeren en geen gate, precies zoals shaer-p729 het stelt. De deur staat al
open als het bericht aankomt.

Gehangen aan shaer-p729 (bouwen) en shaer-yeo5 (de spec-vraag). Raakvlakken met
shaer-3kp opgeschreven: "following approve" staat daar al als gated feature, dus
het beleid hoort in dat instellingen-object en niet in een eigen mechaniek.

Plus een losse constatering: ap_pending_follows.quorum wordt nooit meegegeven,
dus alles is 'any'. shaer-hxg is gesloten met any/all als opgeleverd en de test
slaagt omdat hij de waarde zelf zet.

Co-Authored-By: Claude Opus 5 <claude@…>

File:

• docs/ward-outbound-follows-design.md (modified) (2 diffs)

docs/ward-outbound-follows-design.md

@@ -1 +1 @@
 # Uitgaande follows van een ward — ontwerp
 
+Bijbehorende beads: **shaer-p729** (bouwen) en **shaer-yeo5** (de spec-vraag:
+informeren of gaten?). Dit document beantwoordt yeo5 en beschrijft wat p729
+inhoudt.
+
 FEP-633c §5.3 houdt follows *naar* een ward tegen tot de guardians beslissen.
-Follows *van* een ward gaan ongehinderd de deur uit. `ingestOutboxActivity`
-roept bij `case 'Follow'` meteen `followActor()` aan: geen ward-check, geen
-guardian, geen wachtrij. `mee` heeft een vastgelegde guardian en kan vandaag
-iedereen op de fediverse volgen zonder dat iemand het ziet.
+Follows *van* een ward gaan ongehinderd de deur uit: `ingestOutboxActivity`
+roept bij `case 'Follow'` meteen `followActor()` aan, zonder ward-check en
+zonder wachtrij.
+
+De guardians blijven niet in het duister. Sinds 1a2f206 krijgt elke guardian een
+directe note zodra zijn ward iemand gaat volgen. Maar dat is Robins constatering
+van 31-7 in één zin: **dat is informeren, geen gate.** De deur is al open op het
+moment dat het bericht aankomt, en een guardian die te laat kijkt kan alleen nog
+achteraf iets vinden van iets dat al gebeurd is.
 
 De asymmetrie is half te verdedigen. `Block` (Shaers "Orbit") is uitgaand ook
 ongated, en dat is de veilige richting: een kind dat zijn eigen wereld kleiner
 maakt heeft geen toestemming nodig. Volgen is de richting die hem opent.
-
-Er staat hierover niets in de docs of de FEP-notities. Dit is dus een gat in het
-ontwerp, niet een ongeschreven stuk implementatie.
 
 ## De regel
@@ -105 +111 @@
    guardianship eindigt? Automatisch goedkeuren of laten vervallen.
 
+## Raakvlakken met andere beads
+
+- **shaer-3kp** (gated features, guardian-overeengekomen instellingen) noemt
+  "following approve" al met zoveel woorden. Dat is de plek waar het beleid
+  hoort te wonen: één instellingen-object op de ward met de server als bron van
+  waarheid. Dit ontwerp moet daar een veld in zijn, geen eigen mechaniek ernaast.
+- **shaer-h6u** (lokale guardian via de lijn i.p.v. de gedeelde database) raakt
+  de bezorgweg die hier ook gebruikt wordt.
+- **shaer-zjt** bouwt het guardian-dashboard mét quorumteller; de nieuwe
+  wachtrij moet daar meteen in passen.
+
+### De quorum-kolom is nooit aangesloten
+
+Los van dit ontwerp, en niet in een bead gevonden: `ap_pending_follows.quorum`
+wordt door de aanroep in `ActivityPubService.js` nooit meegegeven, dus alles
+valt terug op de default `'any'`. `'all'` bestaat alleen in de vergelijking in
+`decide()` en wordt nergens geschreven; `'none'` heeft helemaal geen tak en zou
+zich als `'any'` gedragen in plaats van als "open". shaer-hxg is gesloten met
+"quorum any/all" als opgeleverd, en `test/follow-gating.test.js` slaagt omdat de
+test de waarde zelf meegeeft — precies het pad dat productie nooit neemt.
+
+Gevolg: een ward met drie guardians gaat vandaag open op één goedkeuring, ook
+als iemand dacht `all` te hebben ingesteld. Verdient een eigen bead, en de
+oplossing hangt samen met shaer-3kp: als het beleid daar komt te wonen, is dat
+meteen de plek waar de inkomende kant zijn quorum vandaan haalt.
+
 ## Daemon-pariteit