Changeset 30d0e2c in Klonkt for test/guardianship.test.js

Timestamp:

08/03/2026 06:38:16 AM (5 weeks ago)

Author:

Bart <bart@…>

Branches:

main

Children:

3d882bd

Parents:

69bd747

Message:

Een handshake blijft een week open, en faalt daarna onder zijn eigen naam

§4.2 leunt erop dat het uitstel begrensd is: als het venster sluit met de
controle nog onbeslist, faalt de beslissing dicht. Alleen had een
guardianship-offer in Klonkt helemaal geen venster, dus "uitgesteld" was
"voor altijd".

Nu een week. Lang genoeg dat niemand wordt opgejaagd — er moeten een ward, een
kandidaat en alle bestaande guardians antwoorden, en dat zijn mensen — en kort
genoeg dat een vergeten aanbod niet een maand in de wachtrij van een kind staat
alsof het nog een keuze is.

Twee eindtoestanden, want het zijn twee verschillende feiten:
'expired' (niemand heeft geantwoord; zegt niets over de kandidaat) en
'unverified' (iedereen heeft geantwoord, maar de kandidaat was nooit op te
halen). Geen van beide is 'void': de partijen mag niet verteld worden dat de
kandidaat geweigerd is, want dat is niet gebeurd — er heeft alleen nooit iemand
kunnen kijken.

Vervallen gebeurt bij het lezen, zoals een lapse dat ook doet: geen sweeper die
niemand draait. En het lezen van de wachtrij is meteen het moment waarop een
uitgestelde commit opnieuw wordt geprobeerd (§4.2 SHOULD) — nodig, want de
laatste Accept kan al binnen zijn en dan port niemand er ooit nog aan. Niet
awaited: een poll toont wat nu waar is.

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

File:

• test/guardianship.test.js (modified) (1 diff)

test/guardianship.test.js

@@ -187 +187 @@
   );
   assert.deepEqual(G.listGuardians('zed'), []);
+});
+
+test('an unreadable candidate defers the commit, and the window names that failure (§4.2)', async () => {
+  const offers = await import('../src/services/guardianship/offers.js');
+  const noor = site('s16', 'noor');
+  const NOOR = A('noor');
+  const MARA = 'https://elders.example/users/mara';   // remote; fetchActor returns null here
+  const offerId = `${MARA}/offers/m1`;
+
+  // The Offer arrives and is STORED: unreachable is not malformed, and
+  // refusing on a failed fetch would let any outage block an adoption.
+  const taken = await G.handleGuardianshipInbox(noor, {
+    id: offerId, type: 'Offer', actor: MARA, to: [NOOR],
+    object: { type: 'Relationship', subject: NOOR, relationship: 'shaer:Guardian', object: MARA },
+  });
+  assert.equal(taken, true);
+
+  // Noor accepts. Free ward + candidate's own offer = the tally is complete,
+  // so this WOULD commit — except the candidate cannot be read.
+  const done = await G.handleGuardianshipOutbox(noor, { type: 'Accept', object: offerId });
+  assert.equal(done.committed, false, 'not committed: nobody verified the candidate');
+  assert.ok(!done.refused, 'and not refused either — that would blame a candidate nobody could look at');
+  assert.deepEqual(G.listGuardians('noor'), []);
+  assert.equal(offers.getOffer('noor', offerId).status, 'pending', 'deferred, not decided');
+
+  // A week later the §3.5 window closes and it fails closed — under its own
+  // name. Not 'void': the parties must not be told the candidate was refused.
+  const later = Date.now() + offers.OFFER_WINDOW_MS + 1000;
+  offers.expireIfDue('noor', offerId, later);
+  assert.equal(offers.getOffer('noor', offerId).status, 'unverified');
+
+  const q = G.offersCollection(`${NOOR}/queues/offers`, 'noor', NOOR).orderedItems;
+  assert.deepEqual(q.filter((o) => o.id === offerId), [], 'and it stops looking like a live choice');
+});
+
+test('a handshake nobody finished expires under a different name (§3.5)', async () => {
+  const offers = await import('../src/services/guardianship/offers.js');
+  const finn = site('s17', 'finn');
+  const iris = site('s18', 'iris');
+  const [FINN, IRIS] = [A('finn'), A('iris')];
+
+  const off = await G.handleGuardianshipOutbox(finn, {
+    type: 'Offer', object: { type: 'Relationship', subject: IRIS, relationship: 'shaer:Guardian', object: FINN },
+  });
+  // Iris never answers. Reading the queue after the window settles it.
+  G.offersCollection(`${IRIS}/queues/offers`, 'iris', IRIS);          // still open now
+  assert.equal(offers.getOffer('iris', off.id).status, 'pending');
+  offers.listForParty('iris', IRIS, Date.now() + offers.OFFER_WINDOW_MS + 1000);
+  assert.equal(offers.getOffer('iris', off.id).status, 'expired',
+    'nobody answered — that says nothing about the candidate, so it is not "unverified"');
 });