Changeset f06ed56 in Klonkt for src/routes/guardian.js

Timestamp:

08/10/2026 03:42:31 AM (4 weeks ago)

Author:

Bart <bart@…>

Branches:

main

Children:

7e53594

Parents:

8064da1

Message:

Een logboek, zodat de reden ergens blijft staan

Guardianship-events waren vluchtig: onGuardianshipEvent wekte de long-poll,
zocht in een tabel van zeven soorten of er een push bij hoorde, en liet de rest
vallen. Elf van de achttien soorten verdwenen spoorloos, met hun inhoud. Een
weigering droeg reason: 'not_a_teapot' tot precies daar en niet verder --
terwijl §4.2 eist dat de ward en zijn guardians die reden te HOREN krijgen, en
niet dat ze hem afleiden uit een aanbod dat opeens weg is.

Vastleggen en melden zijn nu twee dingen. Alles komt in ap_guardian_events;
welke gebeurtenis een mens wakker maakt blijft de aparte, korte lijst die het
altijd al was.

Ingeklapt en onderaan, want hier vraagt niets om een antwoord. Zou dit tussen
de wachtrijen staan, dan wordt "moet ik iets doen" onleesbaar -- dezelfde reden
waarom de afgehandelde hulpvragen daar al staan.

200 per account, jongste eerst. Een logboek dat oneindig groeit wordt er een
die niemand opent, en afkappen aan de verkeerde kant zou hem onbruikbaar maken
op het moment dat er juist iets gebeurt. Schrijffouten worden geslikt: het
logboek is bijzaak en mag de commit of de weigering zelf nooit meesleuren.

Onbekende soorten vallen in de PWA terug op hun ruwe naam. Zichtbaar en lelijk
is beter dan netjes en afwezig.

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

File:

• src/routes/guardian.js (modified) (2 diffs)

src/routes/guardian.js

@@ -74 +74 @@
   'warn_reversible', 'warn_irreversible', 'warn_unknown', 'warn_tally_elsewhere', 'warn_decides', 'warn_not_last', 'warn_go', 'warn_back',
     'help_archive', 'help_archive_hide', 'panel_history',
+    // Het logboek (§4.2): onbekende soorten vallen terug op hun ruwe naam.
+    'log_show', 'log_hide', 'evr_not_a_teapot',
+    'ev_offer_rejected', 'ev_offer_refused', 'ev_committed', 'ev_guardian_left',
+    'ev_coguardian_left', 'ev_gated_outcome', 'ev_lapse_opened',
     'gate_propose_open', 'gate_propose_close', 'gate_default_off',
     'gate_images', 'gate_messages', 'gate_compose', 'gate_replies', 'gate_music', 'gate_quoteCards', 'gate_asked',
@@ -317 +321 @@
 });
 
+// Het logboek (§4.2): wat er is gebeurd, met de reden erbij. GEEN wachtrij --
+// hier staat niets dat om een antwoord vraagt, en daarom hoort het ingeklapt.
+// Het bestaat omdat een weigering anders alleen te merken was doordat er iets
+// uit een lijst verdween, en "het is weg" vertelt een ward niet waarom.
+router.get('/api/events', requireAuth, (req, res) => {
+  const site = siteForUser(req);
+  if (!site) return res.status(404).json({ error: 'no_site' });
+  res.json({ items: AP.listGuardianEvents(site.slug, 50) });
+});
+
 router.post('/api/follow/:id', requireAuth, express.json({ limit: '4kb' }), async (req, res) => {
   const site = siteForUser(req);