feat(jobs): live jobstatus op /jobs — refetch per event, resync bij ready, retry (IDEA-243 inc. 1, PR B) #148

Merged
janpeter merged 4 commits from feat/idea-243-jobs-live into main 2026-10-09 11:22:19 +02:00
Owner

IDEA-243 increment 1, PR B: live jobstatus op /jobs (workers)

Companion to the scrum4me-mcp PR (notify on every visible status change and usage write). Plan rev 6 / Review record ronde 6 (rev 7), tasks T-206..T-209.

Wat

  • app/api/realtime/queue/route.ts: event: ready na LISTEN en handler-registratie (vervangt : connected). Geen ready bij mislukte connect/LISTEN.
  • hooks/use-jobs-realtime.ts:
    • Elk event leidt tot fetchAndUpsert(job_id); het patch-pad (buildRealtimeJobPatch, needsFullJob) is weg. Payload-velden komen nooit in de store. Serialisatie per job (inFlight/queuedFetches) blijft.
    • Resync bij elke ready (ook de eerste; onopen niet) via de server action fetchJobsPageData -> initJobs, daarna refetch van de aangeraakte ids (inFlight + queued bij start, plus events tijdens de resync). Geserialiseerd (resyncRunning/resyncAgain), mislukte resync herhaald na 1s/3s/10s, opruimen bij unmount.
    • Retry in fetchAndUpsert: netwerkfout of >= 500, 3 retries via geexporteerde RETRY_BACKOFF_MS = [1000, 3000, 10000]; 4xx geen retry; een timer per job; een event tijdens backoff annuleert de timer en haalt direct op.
  • components/jobs/sprint-sub-tasks-pane.tsx + job-detail-tabs.tsx: refetch op status/finishedAt (vergeleken op waarde), 15 s poll zolang de job actief is, vorige lijst blijft bij fout/non-ok/non-array, geen "Laden..." na de eerste load, geen remount.

Read-only-voorwaarde (bevestigd)

De resync via server action mag geen RSC-refresh veroorzaken:

  • lib/auth.ts (getWorkersSession/requireWorkersAdmin) roept geen session.save()/session.destroy() aan (grep: geen treffers; de enige "revalidates"-hit op regel 20 is commentaar).
  • actions/jobs-page.ts (fetchJobsPageData) roept geen revalidatePath/revalidateTag aan (grep: geen treffers).
  • Daardoor geen nieuwe RSC-props, het initial-effect van jobs-board.tsx draait niet opnieuw en selectedJobId blijft staan. Wordt dit ooit muterend, maak dan een read-only variant voor de hook.

Afwijking 4

Resync bij elke ready, dus ook bij de eerste verbinding (niet alleen bij reconnect), zodat een mislukte eerste verbinding niets verliest.

Tests

Uitgebreid __tests__/hooks/use-jobs-realtime.test.tsx (per-event GET, laat stale event, serialisatie, ready/resync, mislukte eerste verbinding, clobber, overlap, mislukte resync, retry), nieuw __tests__/components/jobs/sprint-sub-tasks-pane.test.tsx en __tests__/app/api/realtime-queue-route.test.ts. npm run verify groen (196 files passed, 2583 tests passed, 42 skipped; lint 0 errors). Review-fix 2fa54ba: een (retry-)GET die tijdens een resync start, wordt na initJobs opnieuw opgehaald (test + mutatiecheck).

Niet gedaan / voor de reviewer

Handmatige preview-check (SSE verbreken, ready + server-action-call in het netwerkpaneel, geen RSC-tree in de action-respons) is niet door de agent gedaan: die vereist inloggen met echte admin-credentials. Graag door JP in de preview of na deploy (T-210).

Verwijzingen: spec/plan IDEA-243 increment 1 (rev 6) en Review record ronde 6 (rev 7).

🤖 Generated with Claude Code

## IDEA-243 increment 1, PR B: live jobstatus op /jobs (workers) Companion to the scrum4me-mcp PR (notify on every visible status change and usage write). Plan rev 6 / Review record ronde 6 (rev 7), tasks T-206..T-209. ### Wat - `app/api/realtime/queue/route.ts`: `event: ready` na LISTEN en handler-registratie (vervangt `: connected`). Geen `ready` bij mislukte connect/LISTEN. - `hooks/use-jobs-realtime.ts`: - Elk event leidt tot `fetchAndUpsert(job_id)`; het patch-pad (`buildRealtimeJobPatch`, `needsFullJob`) is weg. Payload-velden komen nooit in de store. Serialisatie per job (inFlight/queuedFetches) blijft. - Resync bij elke `ready` (ook de eerste; `onopen` niet) via de server action `fetchJobsPageData` -> `initJobs`, daarna refetch van de aangeraakte ids (inFlight + queued bij start, plus events tijdens de resync). Geserialiseerd (resyncRunning/resyncAgain), mislukte resync herhaald na 1s/3s/10s, opruimen bij unmount. - Retry in `fetchAndUpsert`: netwerkfout of >= 500, 3 retries via geexporteerde `RETRY_BACKOFF_MS = [1000, 3000, 10000]`; 4xx geen retry; een timer per job; een event tijdens backoff annuleert de timer en haalt direct op. - `components/jobs/sprint-sub-tasks-pane.tsx` + `job-detail-tabs.tsx`: refetch op status/`finishedAt` (vergeleken op waarde), 15 s poll zolang de job actief is, vorige lijst blijft bij fout/non-ok/non-array, geen "Laden..." na de eerste load, geen remount. ### Read-only-voorwaarde (bevestigd) De resync via server action mag geen RSC-refresh veroorzaken: - `lib/auth.ts` (`getWorkersSession`/`requireWorkersAdmin`) roept geen `session.save()`/`session.destroy()` aan (grep: geen treffers; de enige "revalidates"-hit op regel 20 is commentaar). - `actions/jobs-page.ts` (`fetchJobsPageData`) roept geen `revalidatePath`/`revalidateTag` aan (grep: geen treffers). - Daardoor geen nieuwe RSC-props, het initial-effect van `jobs-board.tsx` draait niet opnieuw en `selectedJobId` blijft staan. Wordt dit ooit muterend, maak dan een read-only variant voor de hook. ### Afwijking 4 Resync bij elke `ready`, dus ook bij de eerste verbinding (niet alleen bij reconnect), zodat een mislukte eerste verbinding niets verliest. ### Tests Uitgebreid `__tests__/hooks/use-jobs-realtime.test.tsx` (per-event GET, laat stale event, serialisatie, ready/resync, mislukte eerste verbinding, clobber, overlap, mislukte resync, retry), nieuw `__tests__/components/jobs/sprint-sub-tasks-pane.test.tsx` en `__tests__/app/api/realtime-queue-route.test.ts`. `npm run verify` groen (196 files passed, 2583 tests passed, 42 skipped; lint 0 errors). Review-fix 2fa54ba: een (retry-)GET die tijdens een resync start, wordt na `initJobs` opnieuw opgehaald (test + mutatiecheck). ### Niet gedaan / voor de reviewer Handmatige preview-check (SSE verbreken, `ready` + server-action-call in het netwerkpaneel, geen RSC-tree in de action-respons) is niet door de agent gedaan: die vereist inloggen met echte admin-credentials. Graag door JP in de preview of na deploy (T-210). Verwijzingen: spec/plan IDEA-243 increment 1 (rev 6) en Review record ronde 6 (rev 7). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
The patch path could write a stale payload over a fresher row; every event
now refetches the actual row (serialized per job). The SSE route sends a
ready frame after LISTEN and the hook resyncs the lists on every ready,
so a failed first connection or a reconnect loses nothing. Failed
refetches (network/5xx) and failed resyncs retry on 1s/3s/10s.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
A batch sprint job stays RUNNING while its sub-task executions change and
no notify goes out, so the pane refetches on status/finishedAt change and
every 15s while the job is active; previous list is kept on errors.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Pins the stale-event, serialization, clobber, overlap, failed first
connection and backoff cases so the client never ends on an older
status or usage.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
fix(jobs): refetch retry GETs started during a resync after initJobs
All checks were successful
CI / Verify (pull_request) Successful in 4m21s
2fa54ba4c4
A backoff-timer retry that began during a resync was not in the touched
set, so an older response could land after the snapshot and overwrite it.
Every fetchAndUpsert during a resync is now tracked.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

Verdict: COMMENT

Geen blokkerende codefouten gevonden. De implementatie volgt de bestaande admin-guard, Zustand-store en gedeelde terminale statusgroepen. Per-job serialisatie, resync-overlap, retry/backoff en subtakenverversing passen bij het workers-plan.

Findings:

  • MINOR — tests/app/api/realtime-queue-route.test.ts:54: de test controleert LISTEN vóór handlerregistratie, maar legt het verstuurmoment van ready niet vast. Een regressie die ready vóór LISTEN verstuurt kan deze test nog laten slagen. Maak LISTEN deferred en assert dat er vóór voltooiing geen ready is, of neem enqueue op in dezelfde tijdlijn.
  • MINOR — hooks/use-jobs-realtime.ts:110: het browserbewijs uit T-209/B5 ontbreekt volgens de PR-beschrijving. De read-only-voorwaarde is in lib/auth.ts en actions/jobs-page.ts bevestigd; een echte reconnect met server-action-call, respons zonder RSC-refresh en behouden selectie is nog niet aangetoond. Dit blijft een verificatiepunt, geen bewezen codefout.

Plan gekoppeld via pr_refs; references: T-206, T-209, T-210 (story ST-065). De PR rondt het workers-increment af en claimt de ontbrekende previewcheck niet als uitgevoerd. T-210 betreft praktijkbewijs na merge/deploy; de MCP-notificaties en latere kaart/verdict-wijzigingen vallen buiten deze PR en zijn geen blokkade. De bewuste planafwijkingen van de spec (elke ready, 15s subtakenpolling en uitgestelde late-verdict-refetch) zijn gerespecteerd.

Verificatie op head 2fa54ba4c442c2b8ec09a351a498c6a3000fa7cc: onafhankelijk npm ci en npm run verify uitgevoerd. Exitcode 0: lint 0 errors (één bestaande warning buiten de diff), typecheck geslaagd, 196 testbestanden / 2583 tests geslaagd; 3 bestanden / 42 tests overgeslagen. Productarchitectuur, IDEA-243-spec en uitvoeringsplan geraadpleegd. Geen inline-comments.

# Verdict: COMMENT Geen blokkerende codefouten gevonden. De implementatie volgt de bestaande admin-guard, Zustand-store en gedeelde terminale statusgroepen. Per-job serialisatie, resync-overlap, retry/backoff en subtakenverversing passen bij het workers-plan. Findings: - **MINOR — __tests__/app/api/realtime-queue-route.test.ts:54:** de test controleert LISTEN vóór handlerregistratie, maar legt het verstuurmoment van `ready` niet vast. Een regressie die `ready` vóór LISTEN verstuurt kan deze test nog laten slagen. Maak LISTEN deferred en assert dat er vóór voltooiing geen `ready` is, of neem enqueue op in dezelfde tijdlijn. - **MINOR — hooks/use-jobs-realtime.ts:110:** het browserbewijs uit T-209/B5 ontbreekt volgens de PR-beschrijving. De read-only-voorwaarde is in `lib/auth.ts` en `actions/jobs-page.ts` bevestigd; een echte reconnect met server-action-call, respons zonder RSC-refresh en behouden selectie is nog niet aangetoond. Dit blijft een verificatiepunt, geen bewezen codefout. Plan gekoppeld via pr_refs; references: T-206, T-209, T-210 (story ST-065). De PR rondt het workers-increment af en claimt de ontbrekende previewcheck niet als uitgevoerd. T-210 betreft praktijkbewijs na merge/deploy; de MCP-notificaties en latere kaart/verdict-wijzigingen vallen buiten deze PR en zijn geen blokkade. De bewuste planafwijkingen van de spec (elke `ready`, 15s subtakenpolling en uitgestelde late-verdict-refetch) zijn gerespecteerd. Verificatie op head `2fa54ba4c442c2b8ec09a351a498c6a3000fa7cc`: onafhankelijk `npm ci` en `npm run verify` uitgevoerd. Exitcode 0: lint 0 errors (één bestaande warning buiten de diff), typecheck geslaagd, 196 testbestanden / 2583 tests geslaagd; 3 bestanden / 42 tests overgeslagen. Productarchitectuur, IDEA-243-spec en uitvoeringsplan geraadpleegd. Geen inline-comments.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
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!148
No description provided.