fix(dispatch): claim-gebonden stop sluit een nooit-gestarte poging atomair af (ISS-2) #209

Merged
janpeter merged 5 commits from fix/iss-2-claim-bound-stop into main 2026-10-09 13:52:09 +02:00
Owner

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.md rev 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_SPACE zoals bij ISS-4) werd alleen geaccepteerd in CLAIMED. 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.
  • Elke state, al aanwezig op main: de stop werd geaccepteerd, maar het resultaat kwam nooit binnen. Zodra stopped_at gezet is, slaan de lease-sweep, de orphan-sweep en recovery de poging over.

Wijziging (één productiebestand: src/dispatch/stop-evidence.ts)

  • acceptClaimBoundStopInTransaction:
    • accepteert CLAIMED, UNCERTAIN en CANCEL_REQUESTED;
    • beantwoordt een replay read-only, vóór de state-checks;
    • weigert een verzoek dat al een resultaat heeft;
    • controleert expliciet dat de generatie van request en candidate gelijk is.
  • submitClaimBoundStop sluit het verzoek in dezelfde transactie af:
    • CLAIMED/UNCERTAIN: FAILED, met exact het failed-resultaat dat de supervisor zelf instuurt (claimBoundFailedResult). Zijn latere inzending is daardoor een geaccepteerde replay.
    • CANCEL_REQUESTED: CANCELLED via finishStoppedCancellation.

Scope-aanpassing tijdens de bouw (beslissing JP)

task_implementation is uitgesloten. Het sluiten van een task_implementation geeft de taakbinding vrij, en de DB-guard queue_dispatch_guard_task() staat dat niet toe na een claim_bound_unscoped-stop. Dat geeft DISPATCH_TASK_RELEASE_REFUSED en een rollback.

  • Een managed Task houdt daarom exact het gedrag van vóór deze PR (closesAtStop).
  • De guard is vastgepind in het DB-access-adoptiemanifest van Scrum4Me en verandert via een eigen transitie: Scrum4Me ISS-9.
  • Op main werkt dit pad voor taken al niet; deze PR verandert daar niets aan.

Bewust zo

  • De ontwerpregel blijft gelden (beslissing JP): capaciteit komt pas vrij na geaccepteerd stopbewijs. Cancel zelf geeft niets vrij. cancel.ts, completion.ts, orphans.ts en recovery.ts zijn ongewijzigd, en de e2e-race en de ISS-12-tests zijn ongewijzigd.
  • Gedragswijziging in CLAIMED: de reservering komt nu vrij bij de stop, niet pas bij het resultaat daarna. De bestaande test is daarop aangepast.
  • Vertrouwensgrens: de claim-gebonden stop is een geauthenticeerde verklaring van de gebonden supervisor, net als voorheen. Alleen de geaccepteerde states zijn verruimd.
  • Usage bij replay wordt niet opgeslagen. Bij een pre-scope-weigering heeft geen model gedraaid.

Buiten scope (vervolgpunten)

  • dubbelzinnige pre-scope-fouten (prepare-time-out, een fout bij de broker-create);
  • een heartbeat tijdens prepare;
  • rijen "stop zonder resultaat" van vóór de deploy;
  • de herstel-dialoog in workers (IP-13).

Tests

Nieuw in attempts.integration.test.ts:

  • UNCERTAIN en CANCEL_REQUESTED sluiten af;
  • CLAIMED sluit af, met een supervisor-replay inclusief usage;
  • geen resultaat na de stop, per state, met de lease-sweep en de orphan-tick erna;
  • eerst de orphan-sweep, daarna de stop;
  • een read-only replay en afwijkende bytes;
  • een afwijkende generatie;
  • een gestarte poging wordt geweigerd;
  • een start na de stop wordt geweigerd.

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 blijft CLAIMED, en het resultaat en de taakbinding blijven ongewijzigd.
  • completion.integration.test.ts: voorbereid, dan cancel, dan gescopete stop geeft CANCELLED.

Verificatie

  • Lokaal: npm run typecheck, npm run typecheck:tests en npm test zijn groen (268 bestanden, 2634 tests).
  • Dispatch-integratiesuite (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

## 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.md` rev 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_SPACE` zoals bij ISS-4) werd alleen geaccepteerd in `CLAIMED`. 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. - **Elke state, al aanwezig op main:** de stop werd geaccepteerd, maar het resultaat kwam nooit binnen. Zodra `stopped_at` gezet is, slaan de lease-sweep, de orphan-sweep en recovery de poging over. ### Wijziging (één productiebestand: `src/dispatch/stop-evidence.ts`) - `acceptClaimBoundStopInTransaction`: - accepteert `CLAIMED`, `UNCERTAIN` en `CANCEL_REQUESTED`; - beantwoordt een replay read-only, vóór de state-checks; - weigert een verzoek dat al een resultaat heeft; - controleert expliciet dat de generatie van request en candidate gelijk is. - `submitClaimBoundStop` sluit het verzoek in dezelfde transactie af: - **`CLAIMED`/`UNCERTAIN`:** `FAILED`, met exact het `failed`-resultaat dat de supervisor zelf instuurt (`claimBoundFailedResult`). Zijn latere inzending is daardoor een geaccepteerde replay. - **`CANCEL_REQUESTED`:** `CANCELLED` via `finishStoppedCancellation`. ### Scope-aanpassing tijdens de bouw (beslissing JP) **`task_implementation` is uitgesloten.** Het sluiten van een `task_implementation` geeft de taakbinding vrij, en de DB-guard `queue_dispatch_guard_task()` staat dat niet toe na een `claim_bound_unscoped`-stop. Dat geeft `DISPATCH_TASK_RELEASE_REFUSED` en een rollback. - Een managed Task houdt daarom exact het gedrag van vóór deze PR (`closesAtStop`). - De guard is vastgepind in het DB-access-adoptiemanifest van Scrum4Me en verandert via een eigen transitie: Scrum4Me **ISS-9**. - Op main werkt dit pad voor taken al niet; deze PR verandert daar niets aan. ### Bewust zo - **De ontwerpregel blijft gelden (beslissing JP):** capaciteit komt pas vrij na geaccepteerd stopbewijs. Cancel zelf geeft niets vrij. `cancel.ts`, `completion.ts`, `orphans.ts` en `recovery.ts` zijn ongewijzigd, en de e2e-race en de ISS-12-tests zijn ongewijzigd. - **Gedragswijziging in `CLAIMED`:** de reservering komt nu vrij bij de stop, niet pas bij het resultaat daarna. De bestaande test is daarop aangepast. - **Vertrouwensgrens:** de claim-gebonden stop is een geauthenticeerde verklaring van de gebonden supervisor, net als voorheen. Alleen de geaccepteerde states zijn verruimd. - **Usage bij replay** wordt niet opgeslagen. Bij een pre-scope-weigering heeft geen model gedraaid. ### Buiten scope (vervolgpunten) - dubbelzinnige pre-scope-fouten (prepare-time-out, een fout bij de broker-create); - een heartbeat tijdens prepare; - rijen "stop zonder resultaat" van vóór de deploy; - de herstel-dialoog in workers (IP-13). ### Tests Nieuw in `attempts.integration.test.ts`: - `UNCERTAIN` en `CANCEL_REQUESTED` sluiten af; - `CLAIMED` sluit af, met een supervisor-replay inclusief usage; - geen resultaat na de stop, per state, met de lease-sweep en de orphan-tick erna; - eerst de orphan-sweep, daarna de stop; - een read-only replay en afwijkende bytes; - een afwijkende generatie; - een gestarte poging wordt geweigerd; - een start na de stop wordt geweigerd. 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 blijft `CLAIMED`, en het resultaat en de taakbinding blijven ongewijzigd. - `completion.integration.test.ts`: voorbereid, dan cancel, dan gescopete stop geeft `CANCELLED`. ### Verificatie - **Lokaal:** `npm run typecheck`, `npm run typecheck:tests` en `npm test` zijn groen (268 bestanden, 2634 tests). - **Dispatch-integratiesuite (`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](https://claude.com/claude-code)
The claim-bound stop was accepted only in CLAIMED, so an attempt whose lease ran
out during prepare (UNCERTAIN) or that was cancelled meanwhile (CANCEL_REQUESTED)
hung with its reservation held. Once stopped_at is set the lease sweep, the
orphan sweep and recovery all skip the attempt, so an accepted stop whose result
never arrived hung in every state. The stop is now accepted in all three states
and closes the request in the same transaction: FAILED with the supervisor's own
failed result (its later submission is a replay), or CANCELLED. A replay is
read-only. Capacity is still released only after accepted stop evidence.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(plan): ISS-2 plan rev 5 with review record (GO in round 4)
Some checks failed
CI / Final merge attestation and immutable publication (pull_request) Has been skipped
CI / PR candidate (never published) (pull_request) Failing after 3m57s
b3caa8cb47
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Findings

  • ERROR (blokkerend) — src/dispatch/stop-evidence.ts:128 (ook de cancellation-tak op regel 127): een claim-gebonden stop kan een task_implementation niet afsluiten. finishResult probeert op src/dispatch/lifecycle.ts:51 de taakbinding te wissen, maar queue_dispatch_guard_task() accepteert uitsluitend registered_started_scope, prepared_created_nonlaunch, operator_attested en runtime_rebooted als stopbewijs. Het nieuwe event heeft kind claim_bound_unscoped, waardoor Postgres DISPATCH_TASK_RELEASE_REFUSED geeft. 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:dispatch op 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.
# REQUEST_CHANGES ## Findings - **ERROR (blokkerend)** — `src/dispatch/stop-evidence.ts:128` (ook de cancellation-tak op regel 127): een claim-gebonden stop kan een `task_implementation` niet afsluiten. `finishResult` probeert op `src/dispatch/lifecycle.ts:51` de taakbinding te wissen, maar `queue_dispatch_guard_task()` accepteert uitsluitend `registered_started_scope`, `prepared_created_nonlaunch`, `operator_attested` en `runtime_rebooted` als stopbewijs. Het nieuwe event heeft kind `claim_bound_unscoped`, waardoor Postgres `DISPATCH_TASK_RELEASE_REFUSED` geeft. 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:dispatch` op 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.
fix(dispatch): keep task_implementation on the pre-ISS-2 claim-bound path (ISS-2)
All checks were successful
CI / Final merge attestation and immutable publication (pull_request) Has been skipped
CI / PR candidate (never published) (pull_request) Successful in 8m0s
37f3074258
Releasing a managed Task binding after a claim_bound_unscoped stop is refused by
the database guard queue_dispatch_guard_task(), which is pinned by the DB-access
adoption manifest. Until that guard changes through its own transition, a
task_implementation keeps the old behaviour: claim-bound stop in CLAIMED only,
closed by the supervisor's result. Every other action closes at the stop.

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

COMMENT

Geen blokkerende bevindingen in de gewijzigde code; één kleine documentatieopmerking.

  • MINOR — docs/superpowers/plans/2026-10-09-iss-2-cancel-unstarted.md:105: test 5e verwacht nog taak FAILED, hiërarchie-projectie en een gewiste taakbinding; regel 55 bevat dezelfde oude claim. De expliciete scopebeslissing onderaan, closesAtStop en de nieuwe host-task-test sluiten task_implementation juist 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 closeClaimBound in de beschikbare scrum4me-docker-bron.

Verificatie op commit 37f30742583e7bf2f2c202732cda075f0d38206e: npm run typecheck groen; npm test inclusief test-typecheck groen (2634 geslaagd, 81 overgeslagen); npm run test:dispatch groen (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 --check groen.

# COMMENT Geen blokkerende bevindingen in de gewijzigde code; één kleine documentatieopmerking. - **MINOR — docs/superpowers/plans/2026-10-09-iss-2-cancel-unstarted.md:105:** test 5e verwacht nog taak `FAILED`, hiërarchie-projectie en een gewiste taakbinding; regel 55 bevat dezelfde oude claim. De expliciete scopebeslissing onderaan, `closesAtStop` en de nieuwe host-task-test sluiten `task_implementation` juist 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 `closeClaimBound` in de beschikbare scrum4me-docker-bron. Verificatie op commit `37f30742583e7bf2f2c202732cda075f0d38206e`: `npm run typecheck` groen; `npm test` inclusief test-typecheck groen (2634 geslaagd, 81 overgeslagen); `npm run test:dispatch` groen (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 --check` groen.
docs(plan): ISS-2 — mark task_implementation expectations as superseded
Some checks failed
CI / PR candidate (never published) (pull_request) Failing after 18s
CI / Final merge attestation and immutable publication (pull_request) Has been skipped
dcf9064dae
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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-mcp!209
No description provided.