feat(jobs): begrensde late-verdict-refetch voor verse QUEUE_REVIEW-jobs (IDEA-243 PR D) #150

Merged
janpeter merged 1 commit from feat/idea-243-late-verdict into main 2026-10-09 12:08:37 +02:00
Owner

feat(jobs): begrensde late-verdict-refetch (IDEA-243 inc. 2, PR D)

Plan: PLANS/idea-243-increment-2-plan rev 3 §D1 + Review record rev 4 (ronde 3, MINOR 1-3 en 5). Story ST-066, T-214, acceptatie 8′. Bouwt op PR C (#149, dispatchVerdict).

Wat

Het verdict van een QUEUE_REVIEW wordt pas ná DONE in de ops-DB geprojecteerd, waardoor de kaart op het model kon blijven staan. In hooks/use-jobs-realtime.ts:

  • Een verse DONE QUEUE_REVIEW zonder verdict krijgt hooguit twee refetches, op 5 s en 30 s. "Vers" betekent finishedAt ≤ 5 min oud; dat werkt ook op een ISO-string.
  • De keten wordt ingepland na elke upsert en na elke geslaagde resync. Zo wordt ook een DONE opgepakt die tijdens een disconnect is gemist.
  • Per job geldt eerst een stopcheck: heeft de job een verdict, is hij niet DONE of staat hij niet in de store, dan worden de timers gewist. Daarna volgt de guard: draait er al een keten of is het budget op, dan gebeurt er niets. De timer van 30 s zet exhausted synchroon, vóór zijn GET.
  • Alleen een echt SSE-event (handleJobPayload) reset het budget. De vervolgaanroepen voor de wachtrij, de retry, touched en resync resetten niets.
  • Bij unmount worden alle timers gewist. De signatuur fetchAndUpsert(jobId, attempt) is ongewijzigd.

Tests

De tien plangevallen zijn gedekt in __tests__/hooks/use-jobs-realtime.test.tsx, met fake timers en een JSON-roundtrip zodat finishedAt als string binnenkomt.

Mutatiecheck: voor elk van de volgende vier wijzigingen faalt minstens één test:

  • de exhausted-set verwijderd;
  • de resync-hook verwijderd;
  • de reset bij een event verwijderd;
  • de leeftijdsgrens uitgeschakeld.

Bewust geaccepteerd

  • Klokverschil tussen server en browser. Het venster van 5 minuten vangt een deel op, en het budget per job begrenst de kosten.
  • De garantie is voorwaardelijk: staat het verdict er niet uiterlijk bij de refetch van 30 s, dan verschijnt het bij het volgende event of de volgende resync.

Verificatie

npm run verify is groen: lint, typecheck en 2632 tests geslaagd (42 skipped).

🤖 Generated with Claude Code

## feat(jobs): begrensde late-verdict-refetch (IDEA-243 inc. 2, PR D) Plan: PLANS/idea-243-increment-2-plan rev 3 §D1 + Review record rev 4 (ronde 3, MINOR 1-3 en 5). Story ST-066, T-214, acceptatie 8′. Bouwt op PR C (#149, `dispatchVerdict`). ### Wat Het verdict van een QUEUE_REVIEW wordt pas ná DONE in de ops-DB geprojecteerd, waardoor de kaart op het model kon blijven staan. In `hooks/use-jobs-realtime.ts`: - Een verse DONE QUEUE_REVIEW zonder verdict krijgt hooguit twee refetches, op 5 s en 30 s. "Vers" betekent `finishedAt` ≤ 5 min oud; dat werkt ook op een ISO-string. - De keten wordt ingepland na elke upsert en na elke geslaagde resync. Zo wordt ook een DONE opgepakt die tijdens een disconnect is gemist. - Per job geldt eerst een stopcheck: heeft de job een verdict, is hij niet DONE of staat hij niet in de store, dan worden de timers gewist. Daarna volgt de guard: draait er al een keten of is het budget op, dan gebeurt er niets. De timer van 30 s zet `exhausted` synchroon, vóór zijn GET. - Alleen een echt SSE-event (`handleJobPayload`) reset het budget. De vervolgaanroepen voor de wachtrij, de retry, touched en resync resetten niets. - Bij unmount worden alle timers gewist. De signatuur `fetchAndUpsert(jobId, attempt)` is ongewijzigd. ### Tests De tien plangevallen zijn gedekt in `__tests__/hooks/use-jobs-realtime.test.tsx`, met fake timers en een JSON-roundtrip zodat `finishedAt` als string binnenkomt. Mutatiecheck: voor elk van de volgende vier wijzigingen faalt minstens één test: - de exhausted-set verwijderd; - de resync-hook verwijderd; - de reset bij een event verwijderd; - de leeftijdsgrens uitgeschakeld. ### Bewust geaccepteerd - Klokverschil tussen server en browser. Het venster van 5 minuten vangt een deel op, en het budget per job begrenst de kosten. - De garantie is voorwaardelijk: staat het verdict er niet uiterlijk bij de refetch van 30 s, dan verschijnt het bij het volgende event of de volgende resync. ### Verificatie `npm run verify` is groen: lint, typecheck en 2632 tests geslaagd (42 skipped). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(jobs): bounded late-verdict refetch for fresh DONE QUEUE_REVIEW jobs (IDEA-243 D1)
All checks were successful
CI / Verify (pull_request) Successful in 3m58s
00924c58c1
A dispatch verdict is projected into the ops DB after the job turns DONE, so the
card could stay on the model label. A fresh (<= 5 min) DONE QUEUE_REVIEW without a
verdict now gets at most two refetches (5 s and 30 s), scheduled after each upsert
and each successful resync. The budget per job is reset only by a real SSE event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-workers!150
No description provided.