fix(dispatch): claim-gebonden stop sluit een nooit-gestarte poging atomair af (ISS-2) #209
No reviewers
Labels
No labels
severity/s2
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/scrum4me-mcp!209
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "fix/iss-2-claim-bound-stop"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
fix(dispatch): claim-gebonden stop sluit een nooit-gestarte poging atomair af (ISS-2)
Issue: scrum4me-workers ISS-2 (janpeter/scrum4me-workers#145).
Plan:
docs/superpowers/plans/2026-10-09-iss-2-cancel-unstarted.mdrev 5. Codex gaf GO in ronde 4; het Review record staat in het plan.Taak: scrum4me-mcp ST-057 / T-176.
Probleem
De claim-gebonden stop van de supervisor bij een pre-scope-weigering (bron geweigerd, of
NO_SPACEzoals bij ISS-4) werd alleen geaccepteerd inCLAIMED. Daardoor bleven verzoeken met een bezette reservering hangen in deze gevallen:UNCERTAIN: de lease verliep tijdens prepare. Prepare heeft geen heartbeat, mag 300 s duren, en de lease is 120 s.CANCEL_REQUESTED: het verzoek werd tijdens prepare geannuleerd.stopped_atgezet is, slaan de lease-sweep, de orphan-sweep en recovery de poging over.Wijziging (één productiebestand:
src/dispatch/stop-evidence.ts)acceptClaimBoundStopInTransaction:CLAIMED,UNCERTAINenCANCEL_REQUESTED;submitClaimBoundStopsluit het verzoek in dezelfde transactie af:CLAIMED/UNCERTAIN:FAILED, met exact hetfailed-resultaat dat de supervisor zelf instuurt (claimBoundFailedResult). Zijn latere inzending is daardoor een geaccepteerde replay.CANCEL_REQUESTED:CANCELLEDviafinishStoppedCancellation.Scope-aanpassing tijdens de bouw (beslissing JP)
task_implementationis uitgesloten. Het sluiten van eentask_implementationgeeft de taakbinding vrij, en de DB-guardqueue_dispatch_guard_task()staat dat niet toe na eenclaim_bound_unscoped-stop. Dat geeftDISPATCH_TASK_RELEASE_REFUSEDen een rollback.closesAtStop).Bewust zo
cancel.ts,completion.ts,orphans.tsenrecovery.tszijn ongewijzigd, en de e2e-race en de ISS-12-tests zijn ongewijzigd.CLAIMED: de reservering komt nu vrij bij de stop, niet pas bij het resultaat daarna. De bestaande test is daarop aangepast.Buiten scope (vervolgpunten)
Tests
Nieuw in
attempts.integration.test.ts:UNCERTAINenCANCEL_REQUESTEDsluiten af;CLAIMEDsluit af, met een supervisor-replay inclusief usage;Verder:
claim-bound-stop.integration.test.ts: de bestaande test is aangepast aan atomaire afsluiting en replay.host-task.integration.test.ts: een managed Task houdt het gedrag van vóór ISS-2. Het verzoek blijftCLAIMED, en het resultaat en de taakbinding blijven ongewijzigd.completion.integration.test.ts: voorbereid, dan cancel, dan gescopete stop geeftCANCELLED.Verificatie
npm run typecheck,npm run typecheck:testsennpm testzijn groen (268 bestanden, 2634 tests).npm run test:dispatch): draait in CI. Lokaal is er geen Postgres-servercluster, dus deze PR-run is het bewijs.Uitrol
Na de merge een redeploy van de dispatch-service. Er is geen migratie.
🤖 Generated with Claude Code
REQUEST_CHANGES
Findings
src/dispatch/stop-evidence.ts:128(ook de cancellation-tak op regel 127): een claim-gebonden stop kan eentask_implementationniet afsluiten.finishResultprobeert opsrc/dispatch/lifecycle.ts:51de taakbinding te wissen, maarqueue_dispatch_guard_task()accepteert uitsluitendregistered_started_scope,prepared_created_nonlaunch,operator_attestedenruntime_rebootedals stopbewijs. Het nieuwe event heeft kindclaim_bound_unscoped, waardoor PostgresDISPATCH_TASK_RELEASE_REFUSEDgeeft. De volledige transactie rolt terug, inclusief stopbewijs, resultaat en release; het verzoek blijft hangen met bezette capaciteit. Reproduceerbaar met de nieuwe test op__tests__/dispatch/host-task.integration.test.ts:114. Stem het databasecontract, de gepinde testfixture en de uitrol af op dit stopbewijs, zonder de vrijgaveguard te omzeilen.Plan en standaarden
plan gekoppeld via pr_refs: T-176, ST-057,
docs/superpowers/plans/2026-10-09-iss-2-cancel-unstarted.md. Er zijn geen weggelaten onderdelen (omitted: []).De scope en het transactie-/replaypatroon volgen het plan: één productiebestand, cancel geeft zelf geen capaciteit vrij, replay sluit niet opnieuw af en het failed-resultaat komt overeen met de beschikbare supervisorbron. De task_implementation-afsluiting uit test 5e is echter niet werkend en acceptatiecriterium 5 (groene dispatch-suite) is niet gehaald. De aanname in plan/PR dat alleen een service-redeploy zonder migratie volstaat, moet tegen de databaseguard worden herzien. Bewust uitgesloten vervolgwerk is niet als tekortkoming beoordeeld.
Verificatie
Beoordeeld op commit
b3caa8cb47e46b9e214e719e8db810210dad1493, met relevante productdocs over architectuur en typecheck-scope.npm run typecheck: geslaagd.npm test(inclusief test-typecheck): 2634 geslaagd, 81 overgeslagen.npm run test:dispatchop geïsoleerde Postgres 17 met het voorgeschreven gepinde schema en overlays, database in UTC: 369 geslaagd, 1 gefaald. De enige fout is bovengenoemde nieuwe host-task-test. De eerste run had daarnaast twee bestaande worker-versheidsfouten door de lokale databasetijdzone; die verdwenen na UTC-configuratie.git diff --check: geslaagd; cancel/completion/orphans/recovery en de bestaande e2e-race zijn ongewijzigd.COMMENT
Geen blokkerende bevindingen in de gewijzigde code; één kleine documentatieopmerking.
FAILED, hiërarchie-projectie en een gewiste taakbinding; regel 55 bevat dezelfde oude claim. De expliciete scopebeslissing onderaan,closesAtStopen de nieuwe host-task-test sluitentask_implementationjuist uit. Werk deze actuele planpassages bij of markeer ze als vervallen. Dit is geen blokkerende planafwijking.Plan gekoppeld via pr_refs: T-176, ST-057 en
docs/superpowers/plans/2026-10-09-iss-2-cancel-unstarted.md. De expliciet vastgelegde scope-aanpassing tijdens de bouw is meegenomen: taken behouden het oude gedrag; de databaseguard volgt apart via Scrum4Me ISS-9. Het onderliggende incident is scrum4me-workers ISS-2. Geen weggelaten planonderdelen vermeld in de payload.De implementatie volgt de bestaande locking-, transactie- en lifecyclepatronen. Verse stops sluiten voor de opgenomen acties atomair af; stop-replays sluiten niet opnieuw af. Cancel/completion/orphan/recovery en de bestaande e2e-invariant zijn ongewijzigd. De resultaatvorm komt overeen met
closeClaimBoundin de beschikbare scrum4me-docker-bron.Verificatie op commit
37f30742583e7bf2f2c202732cda075f0d38206e:npm run typecheckgroen;npm testinclusief test-typecheck groen (2634 geslaagd, 81 overgeslagen);npm run test:dispatchgroen (370 geslaagd) tegen geïsoleerde PostgreSQL met de vastgepinde schemabron. De eerste dispatchrun had vier fouten in bestaande worker-versheidstests met de lokale Amsterdam-tijdzone; de volledige herhaling met Node en PostgreSQL op UTC slaagde.git diff --checkgroen.