fix(deploy-advice): dry-run-venster op hele seconden (IDEA-275, ST-082) #300

Merged
janpeter merged 1 commit from fix/deploy-advice-window-precision into main 2026-10-22 08:58:59 +02:00
Owner

Sporadische 409 op POST /api/flows/deploy-scrum4me/advise (plan does not belong to this dry-run (generated_at outside its window)), gevonden in het ST-082-hostbewijs (dry-run cmvj677n0000001piv9soxhal, started_at 06:38:54.060Z, plan generated_at 06:38:54Z).

Oorzaak. scrum4me-deploy-plan.sh stempelt generated_at met date -u +%FT%TZ (hele seconden); de route vergeleek met FlowRun.started_at in milliseconden. Landt de planstap in dezelfde seconde als de run-start, dan ligt het plan schijnbaar vóór het venster.

Fix. De ondergrens van het venster is de start afgerond naar beneden op de seconde (Math.floor(started_at / 1000) * 1000). Bovengrens (ended_at of nu) en de 30-minutengrens zijn ongewijzigd; een plan uit de seconde vóór de start blijft 409.

Test. test/deploy-advice-advise-route.test.ts: plan op de startseconde → 200, plan op de seconde ervoor → 409 (faalde vóór de fix met 409 i.p.v. 200). Lokaal: 16/16 in dat bestand, 49/49 in test/deploy-advice*, tsc --noEmit 0 fouten.

Na merge: update_ops_dashboard draaien; geen migratie, ops-agent ongewijzigd.

🤖 Generated with Claude Code

Sporadische 409 op `POST /api/flows/deploy-scrum4me/advise` (`plan does not belong to this dry-run (generated_at outside its window)`), gevonden in het ST-082-hostbewijs (dry-run `cmvj677n0000001piv9soxhal`, started_at 06:38:54.060Z, plan `generated_at` 06:38:54Z). **Oorzaak.** `scrum4me-deploy-plan.sh` stempelt `generated_at` met `date -u +%FT%TZ` (hele seconden); de route vergeleek met `FlowRun.started_at` in milliseconden. Landt de planstap in dezelfde seconde als de run-start, dan ligt het plan schijnbaar vóór het venster. **Fix.** De ondergrens van het venster is de start afgerond naar beneden op de seconde (`Math.floor(started_at / 1000) * 1000`). Bovengrens (`ended_at` of nu) en de 30-minutengrens zijn ongewijzigd; een plan uit de seconde vóór de start blijft 409. **Test.** `test/deploy-advice-advise-route.test.ts`: plan op de startseconde → 200, plan op de seconde ervoor → 409 (faalde vóór de fix met 409 i.p.v. 200). Lokaal: 16/16 in dat bestand, 49/49 in `test/deploy-advice*`, `tsc --noEmit` 0 fouten. Na merge: `update_ops_dashboard` draaien; geen migratie, ops-agent ongewijzigd. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
fix(deploy-advice): dry-run-venster op hele seconden (IDEA-275, ST-082)
All checks were successful
CI / Select checks (pull_request) Successful in 35s
CI / Ops-agent checks (pull_request) Successful in 41s
CI / DB access operator (pull_request) Successful in 1m15s
CI / Deploy artifact checks (pull_request) Successful in 35s
CI / Docker image build (pull_request) Successful in 1m26s
CI / Mac foundation hermetic checks (pull_request) Successful in 2m2s
CI / Root app checks (pull_request) Successful in 7m48s
CI / Required checks (pull_request) Successful in 35s
fa52e932a8
De planner schrijft generated_at met date -u +%FT%TZ (hele seconden); de
advise-route vergeleek met FlowRun.started_at in milliseconden. Valt de
planstap in dezelfde seconde als de run-start, dan lag generated_at vóór
started_at en gaf /advise 409 "plan does not belong to this dry-run"
(hostbewijs ST-082, dry-run cmvj677n0000001piv9soxhal, start 06:38:54.060Z,
plan 06:38:54Z). De ondergrens van het venster is nu de start afgerond naar
beneden op de seconde; de bovengrens en de 30-minutengrens zijn ongewijzigd.
Test: plan op de startseconde → 200, plan op de seconde ervoor → 409.

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

COMMENT

Findings:

  • LOW — app/api/flows/deploy-scrum4me/advise/route.ts:103 — De ondergrens wordt terecht naar de startseconde afgerond omdat de planner geen milliseconden schrijft. De productdocs specs/idea-275-spec (Dashboard: adviseur, opslag en route) en plans/idea-275-plan beschrijven echter nog de strikte eis started_at ≤ generated_at. Werk die beschrijving bij naar floor(started_at / 1000) * 1000 ≤ generated_at, met de precisiereden en de ongewijzigde bovengrens. Dit is een niet-blokkerende documentatie-afwijking.

Geen blokkerende codebevindingen: de wijziging is klein, volgt het bestaande routepatroon en de regressietest controleert zowel acceptatie van de startseconde als afwijzing van de voorafgaande seconde.

Plan gekoppeld via pr_refs; references: ST-082 (Hostbewijs op scrum4me-server, increment 2), taak T-218. Deze PR claimt uitsluitend de tijdvensterfix, geen volledige afronding van het hostbewijs. De overige rollout-, queue-, override- en runbookbewijzen vallen buiten deze diff en zijn geen blokkerende finding. Er zijn geen omitted-items in de aangeleverde plankoppeling.

Verificatie op fa52e932a8f1dfa60081d94fab915802f423e819: npm test -- test/deploy-advice — 49/49 geslaagd; npm run typecheck — geslaagd na Prisma-generatie, initialisatie van submodules en installatie van root- en ops-agent-dependencies. Plannerprecisie gecontroleerd in deploy/ops-agent/scripts/scrum4me-deploy-plan.sh:174. Geen live hostbewijs uitgevoerd.

# COMMENT Findings: - **LOW — app/api/flows/deploy-scrum4me/advise/route.ts:103** — De ondergrens wordt terecht naar de startseconde afgerond omdat de planner geen milliseconden schrijft. De productdocs `specs/idea-275-spec` (Dashboard: adviseur, opslag en route) en `plans/idea-275-plan` beschrijven echter nog de strikte eis `started_at ≤ generated_at`. Werk die beschrijving bij naar `floor(started_at / 1000) * 1000 ≤ generated_at`, met de precisiereden en de ongewijzigde bovengrens. Dit is een niet-blokkerende documentatie-afwijking. Geen blokkerende codebevindingen: de wijziging is klein, volgt het bestaande routepatroon en de regressietest controleert zowel acceptatie van de startseconde als afwijzing van de voorafgaande seconde. Plan gekoppeld via pr_refs; references: ST-082 (Hostbewijs op scrum4me-server, increment 2), taak T-218. Deze PR claimt uitsluitend de tijdvensterfix, geen volledige afronding van het hostbewijs. De overige rollout-, queue-, override- en runbookbewijzen vallen buiten deze diff en zijn geen blokkerende finding. Er zijn geen omitted-items in de aangeleverde plankoppeling. Verificatie op `fa52e932a8f1dfa60081d94fab915802f423e819`: `npm test -- test/deploy-advice` — 49/49 geslaagd; `npm run typecheck` — geslaagd na Prisma-generatie, initialisatie van submodules en installatie van root- en ops-agent-dependencies. Plannerprecisie gecontroleerd in `deploy/ops-agent/scripts/scrum4me-deploy-plan.sh:174`. Geen live hostbewijs uitgevoerd.
janpeter scheduled this pull request to auto merge when all checks succeed 2026-10-22 08:57:22 +02:00
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/Ops-dashboard!300
No description provided.