Changeset f06ed56 in Klonkt for src/assets/js/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/assets/js/guardian.js (modified) (3 diffs)

src/assets/js/guardian.js

@@ -355 +355 @@
   // and are grouped into the panels by ward, so they are cached here rather
   // than rendered into a section of their own.
-  var FEED = [], FOLLOWS = [];
+  var FEED = [], FOLLOWS = [], EVENTS = [];
 
   function sectionInto(panel, title, items, empty, build) {
@@ -984 +984 @@
     return card;
   }
+  /**
+   * Het logboek. Apart geladen en apart getoond: dit is geschiedenis, geen
+   * wachtrij. Faalt hij, dan blijft de sectie gewoon weg -- een guardian mist
+   * er niets door dat om hem vraagt.
+   */
+  function loadEvents() {
+    return fetch('/guardian/api/events?site=' + encodeURIComponent(S.site))
+      .then(function (r) { return r.json(); })
+      .then(function (d) { if (d && !d.error) { EVENTS = d.items || []; renderLog(); } })
+      .catch(function () { /* geen logboek is geen storing */ });
+  }
+
+  /** Een regel per gebeurtenis: wat er gebeurde, om wie, en waarom. */
+  function eventLine(e) {
+    var wie = e.candidate || e.guardian || e.ward || e.follower || e.target || '';
+    var stuk = (T['ev_' + e.kind] || e.kind);
+    if (wie) stuk += ' - ' + handleOf(wie, wie);
+    // De REDEN is waarvoor dit logboek bestaat: zonder haar merkte een ward een
+    // weigering alleen doordat er iets uit een lijst verdween.
+    if (e.reason) stuk += ' (' + (T['evr_' + e.reason] || e.reason) + ')';
+    var row = el('div', 'g-card');
+    row.appendChild(el('span', 'who grow', stuk));
+    row.appendChild(el('span', 'when', when(e, e.created)));
+    return row;
+  }
+
+  function renderLog() {
+    var host = document.getElementById('g-log');
+    if (!host) return;
+    host.textContent = '';
+    if (!EVENTS.length) return;
+    var lijst = el('div', 'g-gates');
+    lijst.hidden = !S._logOpen;
+    EVENTS.forEach(function (e) { lijst.appendChild(eventLine(e)); });
+    var kop = el('button', 'quiet small g-gates-toggle');
+    var zet = function () {
+      kop.textContent = (lijst.hidden ? (T.log_show || 'Show history') : (T.log_hide || 'Hide history'))
+        + ' (' + EVENTS.length + ')';
+    };
+    zet();
+    kop.addEventListener('click', function () {
+      lijst.hidden = !lijst.hidden; S._logOpen = !lijst.hidden; zet();
+    });
+    host.appendChild(kop); host.appendChild(lijst);
+  }
+
   function loadFollowReqs() {
     return fetch('/guardian/api/follow-requests?site=' + encodeURIComponent(S.site))
@@ -1138 +1184 @@
   });
 
-  renderAll(); pushState(); loadFeed(); loadFollowReqs();
+  renderAll(); pushState(); loadFeed(); loadFollowReqs(); loadEvents();
 
   // De push die de melding brengt is meteen het teken dat de staat veranderd is.