[ISS-1] Story-rollup promoveert nooit als één taak EXCLUDED is — 9 stories staan vast #256

Closed
opened 2026-09-24 21:01:51 +02:00 by janpeter · 1 comment
Owner

Beheerd door Scrum4Me — wijzigingen hier worden overschreven. Bron: https://thuis.jp-visser.nl/issues/cmufw54u8001jh37rh4bkxjns

Status: closed (fixed) · Severity: s4_minor · Gemeld door: scrum4me-server:claude · Occurrences: 1 (laatst: 2026-09-24T18:54:20.096Z) · Aangemaakt: 2026-09-24T18:54:20.096Z

Registratie

Waarneming

Een story met uitsluitend terminale taken promoveert niet naar DONE zodra één van die taken EXCLUDED is. De story blijft op IN_SPRINT (of OPEN) staan, ook al valt er niets meer te doen.

Gemeten 2026-09-24 op de productie-DB: 9 stories staan in precies die toestand — alle taken DONE of EXCLUDED, story zelf niet DONE. Verdeeld over vijf producten:

product story done / excluded
SC2 ST-040 0 / 2
SC2 ST-021 5 / 1
SCRUM4US ST-046 7 / 1
SCRUM4US ST-045 9 / 1
SCRUM4ME ST-1480 0 / 1
SCRUM4ME ST-1461 9 / 1
SCRAPE ST-001 1 / 1

(plus twee waarvan de titel een newline bevat en die in de tabel wegvielen; de telling van 9 komt uit een aparte count(*).)

Oorzaak

lib/tasks-status-update.ts:

const allTasksDone =
  siblings.length > 0 && siblings.every((s) => s.status === 'DONE')
...
const defaultActive: StoryStatus = story.sprint_id ? 'IN_SPRINT' : 'OPEN'
if (anyTaskFailed) nextStoryStatus = 'FAILED'
else if (allTasksDone) nextStoryStatus = 'DONE'
else nextStoryStatus = defaultActive

every(s => s.status === 'DONE') telt EXCLUDED als onafgerond. Een uitgesloten taak blokkeert de promotie dus permanent.

Tweede orde: een handmatige correctie wordt teruggedraaid

nextStoryStatus valt in dat geval terug op defaultActive, en de code schrijft dat weg zodra het afwijkt van de huidige status. Zet iemand de story met de hand op DONE, dan zet de eerstvolgende statuswijziging van welke taak dan ook in die story hem weer terug naar IN_SPRINT. Dat maakt het probleem niet alleen cosmetisch: de correctie is niet houdbaar.

Reproductie

  1. Maak een story met twee taken.
  2. Zet taak 1 op done, taak 2 op excluded.
  3. Story blijft IN_SPRINT. Zet taak 1 opnieuw op done — geen promotie (story_status_change: null).

Ter controle: dezelfde flow met beide taken op done geeft wél story_status_change: "promoted" (gezien bij ST-070 vandaag).

Voorgestelde richting

EXCLUDED meetellen als terminaal, bijvoorbeeld siblings.every(s => s.status === 'DONE' || s.status === 'EXCLUDED'), met de kanttekening dat een story waarvan alle taken excluded zijn waarschijnlijk niet DONE hoort te heten — ST-040 en ST-1480 hierboven zijn precies dat geval. Een aparte uitkomst voor "niets uitgevoerd" is daar misschien juister dan DONE.

Let op dat dezelfde every(... === 'DONE')-vorm ook op de twee niveaus daarboven staat (story→PBI op regel ~96, PBI→sprint op regel ~132). Daar speelt dit specifieke probleem niet, want StoryStatus kent geen EXCLUDED — alleen TaskStatus heeft die waarde. Wie het patroon aanpast, moet dus niet klakkeloos alle drie gelijktrekken.

Aanleiding

Kwam boven bij het sluiten van ST-071 (product PRODUCTION/scrum4me-server), die als achterhaald werd afgesloten met zes excluded taken en één done. De status is daar uiteindelijk rechtstreeks in de database gezet, omdat de MCP geen tool heeft om een story-status te zetten en de rollup de enige ondersteunde weg is.

Onderzoek


2026-09-24T20:07:12.356Z — scrum4me-server:claude

Fix ligt klaar — Scrum4Me PR #257

De oorzaak zat in lib/task-status-decisions.ts, niet in tasks-status-update.ts zoals ik in de oorspronkelijke melding schreef: die laatste roept sinds een refactor de gedeelde pure helper decideStoryStatus aan. De every(... === 'DONE')-vorm staat daar.

Wijziging: states.some(s => s === 'DONE') && states.every(s => s === 'DONE' || s === 'EXCLUDED').

EXCLUDED telt daarmee als terminaal, en de some(DONE)-eis houdt de andere kant dicht — een story waarin geen enkele taak is uitgevoerd heet niet DONE. ST-040 en ST-1480 zijn precies dat geval en blijven bewust staan.

Niet meegenomen: decidePbiStatus en decideSprintStatus. Ze dragen dezelfde vorm, maar EXCLUDED bestaat alleen in TaskStatus — geverifieerd tegen de enums op productie: StoryStatus = OPEN/IN_SPRINT/DONE/FAILED, PbiStatus = READY/BLOCKED/DONE/FAILED, SprintStatus = OPEN/CLOSED/ARCHIVED/FAILED. Die helpers krijgen de waarde nooit binnen.

Tests: vier groepen toegevoegd. Eén is aantoonbaar rood zonder de fix (['DONE','EXCLUDED'] gaf IN_SPRINT in plaats van DONE); de andere drie waren al groen en dienen als guard tegen een te brede fix — alles-EXCLUDED promoveert niet, een onvoltooide taak blokkeert nog steeds, FAILED wint ook van EXCLUDED. Na de fix 13/13 en 22/22 met de aanpalende suite. tsc --noEmit geeft 136 fouten, identiek aan de ongemodificeerde baseline.

Let op bij de merge: de negen vastzittende stories promoveren niet met terugwerkende kracht. De rollup draait pas bij de eerstvolgende taakstatuswijziging in zo'n story.

Oplossing


2026-09-25T12:13:05.080Z — scrum4me-server:claude

Code (beide rollup-kopieën): Scrum4Me #257 (webapp) en scrum4me-mcp #153 (agent-pad) — decideStoryStatus = some(DONE) && every(DONE‖EXCLUDED). Uitgerold met deploy/main-201f7eb5877e (redeploy_all 2026-09-25, 37/37).

Reparatie bestaande data (2026-09-25): script uit scrum4me-mcp #156, ingeperkt in #157 tot stories met ≥1 EXCLUDED-taak (dry-run 47 → 9 kandidaten). Toegepast op prod, beperkt tot stories waarvan de rollup geen gesloten sprint heropent:

  • ST-001, ST-021, ST-045, ST-046 → DONE via de normale rollup; PBI-1, PBI-16, PBI-17, PBI-18 → DONE; sprints ongewijzigd (CLOSED).
  • ST-1461 → DONE als story-only update (volledige rollup zou sprint S-2026-07-03-m17-deploy heropenen, want PBI-124 blijft READY door ST-1480).
  • Bewust ongemoeid: ST-006, ST-033, ST-040, ST-1480 (alleen EXCLUDED-taken → blijven IN_SPRINT volgens de regel op main).

Pre/post-diff: exact 9 rijen gewijzigd, alle 8 sprints (incl. completed_at) en 8 sprint-runs ongewijzigd. Evidence op scrum4me-srv: ~/work/iss1-{prestate,poststate}-2026-09-25.json, ~/work/iss1-apply-2026-09-25.txt.

Open vervolgvraag (niet in scope): welke eindstatus stories met uitsluitend EXCLUDED-taken moeten krijgen.

> Beheerd door Scrum4Me — wijzigingen hier worden overschreven. Bron: https://thuis.jp-visser.nl/issues/cmufw54u8001jh37rh4bkxjns Status: closed (fixed) · Severity: s4_minor · Gemeld door: scrum4me-server:claude · Occurrences: 1 (laatst: 2026-09-24T18:54:20.096Z) · Aangemaakt: 2026-09-24T18:54:20.096Z ## Registratie ## Waarneming Een story met uitsluitend terminale taken promoveert niet naar `DONE` zodra één van die taken `EXCLUDED` is. De story blijft op `IN_SPRINT` (of `OPEN`) staan, ook al valt er niets meer te doen. Gemeten 2026-09-24 op de productie-DB: **9 stories** staan in precies die toestand — alle taken `DONE` of `EXCLUDED`, story zelf niet `DONE`. Verdeeld over vijf producten: | product | story | done / excluded | |---|---|---| | SC2 | ST-040 | 0 / 2 | | SC2 | ST-021 | 5 / 1 | | SCRUM4US | ST-046 | 7 / 1 | | SCRUM4US | ST-045 | 9 / 1 | | SCRUM4ME | ST-1480 | 0 / 1 | | SCRUM4ME | ST-1461 | 9 / 1 | | SCRAPE | ST-001 | 1 / 1 | (plus twee waarvan de titel een newline bevat en die in de tabel wegvielen; de telling van 9 komt uit een aparte `count(*)`.) ## Oorzaak `lib/tasks-status-update.ts`: ```ts const allTasksDone = siblings.length > 0 && siblings.every((s) => s.status === 'DONE') ... const defaultActive: StoryStatus = story.sprint_id ? 'IN_SPRINT' : 'OPEN' if (anyTaskFailed) nextStoryStatus = 'FAILED' else if (allTasksDone) nextStoryStatus = 'DONE' else nextStoryStatus = defaultActive ``` `every(s => s.status === 'DONE')` telt `EXCLUDED` als onafgerond. Een uitgesloten taak blokkeert de promotie dus permanent. ## Tweede orde: een handmatige correctie wordt teruggedraaid `nextStoryStatus` valt in dat geval terug op `defaultActive`, en de code schrijft dat weg zodra het afwijkt van de huidige status. Zet iemand de story met de hand op `DONE`, dan zet de eerstvolgende statuswijziging van welke taak dan ook in die story hem weer terug naar `IN_SPRINT`. Dat maakt het probleem niet alleen cosmetisch: de correctie is niet houdbaar. ## Reproductie 1. Maak een story met twee taken. 2. Zet taak 1 op `done`, taak 2 op `excluded`. 3. Story blijft `IN_SPRINT`. Zet taak 1 opnieuw op `done` — geen promotie (`story_status_change: null`). Ter controle: dezelfde flow met beide taken op `done` geeft wél `story_status_change: "promoted"` (gezien bij ST-070 vandaag). ## Voorgestelde richting `EXCLUDED` meetellen als terminaal, bijvoorbeeld `siblings.every(s => s.status === 'DONE' || s.status === 'EXCLUDED')`, met de kanttekening dat een story waarvan **alle** taken excluded zijn waarschijnlijk niet `DONE` hoort te heten — ST-040 en ST-1480 hierboven zijn precies dat geval. Een aparte uitkomst voor "niets uitgevoerd" is daar misschien juister dan `DONE`. Let op dat dezelfde `every(... === 'DONE')`-vorm ook op de twee niveaus daarboven staat (story→PBI op regel ~96, PBI→sprint op regel ~132). Daar speelt dit specifieke probleem niet, want `StoryStatus` kent geen `EXCLUDED` — alleen `TaskStatus` heeft die waarde. Wie het patroon aanpast, moet dus niet klakkeloos alle drie gelijktrekken. ## Aanleiding Kwam boven bij het sluiten van ST-071 (product PRODUCTION/scrum4me-server), die als achterhaald werd afgesloten met zes `excluded` taken en één `done`. De status is daar uiteindelijk rechtstreeks in de database gezet, omdat de MCP geen tool heeft om een story-status te zetten en de rollup de enige ondersteunde weg is. ## Onderzoek --- *2026-09-24T20:07:12.356Z — scrum4me-server:claude* ## Fix ligt klaar — Scrum4Me PR #257 De oorzaak zat in `lib/task-status-decisions.ts`, niet in `tasks-status-update.ts` zoals ik in de oorspronkelijke melding schreef: die laatste roept sinds een refactor de gedeelde pure helper `decideStoryStatus` aan. De `every(... === 'DONE')`-vorm staat daar. **Wijziging:** `states.some(s => s === 'DONE') && states.every(s => s === 'DONE' || s === 'EXCLUDED')`. `EXCLUDED` telt daarmee als terminaal, en de `some(DONE)`-eis houdt de andere kant dicht — een story waarin geen enkele taak is uitgevoerd heet niet DONE. ST-040 en ST-1480 zijn precies dat geval en blijven bewust staan. **Niet meegenomen:** `decidePbiStatus` en `decideSprintStatus`. Ze dragen dezelfde vorm, maar `EXCLUDED` bestaat alleen in `TaskStatus` — geverifieerd tegen de enums op productie: `StoryStatus` = OPEN/IN_SPRINT/DONE/FAILED, `PbiStatus` = READY/BLOCKED/DONE/FAILED, `SprintStatus` = OPEN/CLOSED/ARCHIVED/FAILED. Die helpers krijgen de waarde nooit binnen. **Tests:** vier groepen toegevoegd. Eén is aantoonbaar rood zonder de fix (`['DONE','EXCLUDED']` gaf `IN_SPRINT` in plaats van `DONE`); de andere drie waren al groen en dienen als guard tegen een te brede fix — alles-EXCLUDED promoveert niet, een onvoltooide taak blokkeert nog steeds, FAILED wint ook van EXCLUDED. Na de fix 13/13 en 22/22 met de aanpalende suite. `tsc --noEmit` geeft 136 fouten, identiek aan de ongemodificeerde baseline. **Let op bij de merge:** de negen vastzittende stories promoveren niet met terugwerkende kracht. De rollup draait pas bij de eerstvolgende taakstatuswijziging in zo'n story. ## Oplossing --- *2026-09-25T12:13:05.080Z — scrum4me-server:claude* **Code (beide rollup-kopieën):** Scrum4Me #257 (webapp) en scrum4me-mcp #153 (agent-pad) — `decideStoryStatus` = `some(DONE) && every(DONE‖EXCLUDED)`. Uitgerold met `deploy/main-201f7eb5877e` (redeploy_all 2026-09-25, 37/37). **Reparatie bestaande data (2026-09-25):** script uit scrum4me-mcp #156, ingeperkt in #157 tot stories met ≥1 EXCLUDED-taak (dry-run 47 → 9 kandidaten). Toegepast op prod, beperkt tot stories waarvan de rollup geen gesloten sprint heropent: - ST-001, ST-021, ST-045, ST-046 → DONE via de normale rollup; PBI-1, PBI-16, PBI-17, PBI-18 → DONE; sprints ongewijzigd (CLOSED). - ST-1461 → DONE als story-only update (volledige rollup zou sprint S-2026-07-03-m17-deploy heropenen, want PBI-124 blijft READY door ST-1480). - Bewust ongemoeid: ST-006, ST-033, ST-040, ST-1480 (alleen EXCLUDED-taken → blijven IN_SPRINT volgens de regel op main). Pre/post-diff: exact 9 rijen gewijzigd, alle 8 sprints (incl. `completed_at`) en 8 sprint-runs ongewijzigd. Evidence op scrum4me-srv: `~/work/iss1-{prestate,poststate}-2026-09-25.json`, `~/work/iss1-apply-2026-09-25.txt`. Open vervolgvraag (niet in scope): welke eindstatus stories met uitsluitend EXCLUDED-taken moeten krijgen. <!-- s4m:issue:cmufw54u8001jh37rh4bkxjns -->
Author
Owner

Opgelost en afgesloten in Scrum4Me als ISS-1 (CLOSED / FIXED).

  • Code: Scrum4Me #257 (webapp) en scrum4me-mcp #153 (agent-pad), uitgerold met deploy/main-201f7eb5877e.
  • Reparatie bestaande data (2026-09-25) via scrum4me-mcp #156 + #157: ST-001, ST-021, ST-045, ST-046 → DONE via rollup (PBI-1/16/17/18 → DONE); ST-1461 → DONE als story-only update, zodat sprint m17-deploy gesloten blijft. ST-006, ST-033, ST-040 en ST-1480 (alleen EXCLUDED-taken) bewust ongemoeid.
  • Vóór/na-vergelijking: exact 9 rijen gewijzigd; alle sprints en sprint-runs ongewijzigd.

Details staan in de resolutie van ISS-1.

Opgelost en afgesloten in Scrum4Me als ISS-1 (CLOSED / FIXED). - Code: Scrum4Me #257 (webapp) en scrum4me-mcp #153 (agent-pad), uitgerold met `deploy/main-201f7eb5877e`. - Reparatie bestaande data (2026-09-25) via scrum4me-mcp #156 + #157: ST-001, ST-021, ST-045, ST-046 → DONE via rollup (PBI-1/16/17/18 → DONE); ST-1461 → DONE als story-only update, zodat sprint m17-deploy gesloten blijft. ST-006, ST-033, ST-040 en ST-1480 (alleen EXCLUDED-taken) bewust ongemoeid. - Vóór/na-vergelijking: exact 9 rijen gewijzigd; alle sprints en sprint-runs ongewijzigd. Details staan in de resolutie van ISS-1.
Sign in to join this conversation.
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#256
No description provided.