fix(dispatch): clean up prepared-sources staging in /run/sources (ISS-4) #118
No reviewers
Labels
No labels
severity/s2
severity/s3
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/scrum4me-docker!118
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "fix/iss4-prepared-sources-cleanup"
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?
Fixes ISS-4 (#117): the dispatch supervisor never removed its prepared-sources staging (
/run/sources/<attempt>and.pending/<attempt>). On 2026-10-08 that filled the/runtmpfs on scrum4me-server to 100%. Everydocker exec/runthen failed, and two review dispatches got stuck onUNCERTAIN.Changes
discardPreparedSourcesremoves both directories.releaseScopecalls it after the broker release, which covers every terminal path with a scope (accepted, late, closeUnstarted, recovery).closeClaimBoundcalls it too. It never runs while an answer is pending, while collection is pending (pending_artifacts) or while the attempt is uncertain, because code collection still reads the staged manifest. It is best-effort: on failure it only logsDISPATCH_PREPARED_SOURCES_DISCARD_FAILED.prepareSources(before the broker create) becomesDISPATCH_PREPARED_SOURCES_NO_SPACE, a pre-scope reason. The claim-bound close then frees the slot. The service already accepts any boundedDISPATCH_*reason on/attempts/claim-stop.Verification
npm run typecheck:dispatch: green.npx vitest run: 1301 passed, 8 skipped, 2 failed. The 2 failures are intranscript-retention.test.tsand are macOS-only: the script uses GNUchmod --reference. They fail identically onmaster. I did not run them in the Linux container..pendingnext to a fresh publish) is fixed inc052317.Out of scope
/runon scrum4me-server: ISS-57 on the scrum4me-server product.UNCERTAINdispatches. Those are operator work.After merge
Deploy to scrum4me-server. Then check that the number of directories in
/run/sourcesstays close to the number of running attempts, and close ISS-4.🤖 Generated with Claude Code
REQUEST_CHANGES
Findings:
error — lib/dispatch-source-staging.ts:183 — Verse pending retry wordt als wees verwijderd. De sweep gebruikt alleen de mtime van .pending/. stagePreparedSources maakt een retry onder het bestaande /; dat ververst de bovenliggende attempt-map niet. Als die map ouder is dan 48 uur, kan de sweep van een ander slot (zonder het journal van deze attempt) de actief beschreven retry verwijderen vóór publicatie. Gereproduceerd met een oude attempt-map en een nieuw run-directory: removed=1, verse run verdwenen. Bescherm recente activiteit in de onderliggende manifest/run-mappen of vernieuw een gedeelde activiteitsmarkering bij elke retry; voeg hiervoor een regressietest toe.
error — lib/dispatch-supervisor.ts:209 — Terminale late received-replay mist staging-cleanup. De nieuwe discard loopt uitsluitend via releaseScope, maar de received-branch retourneert bij een late submitResult direct, vóór releaseScope. Daardoor blijven de staging en het journal achter; de eigen sweep bewaart deze staging vervolgens onbeperkt omdat het journal bestaat. Gereproduceerd met een received-journal en late response: outcome=late, release=0, discard=0. Roep ook op dit terminale pad de best-effort cleanup aan en test de received-replay expliciet (de nieuwe late-test raakt alleen het hoofdpad).
Plan gekoppeld via pr_refs; references: T-82, T-83, T-84 (story ST-023). Er zijn geen omitted onderdelen. De ENOSPC-afhandeling en port-wiring volgen het plan, maar de twee findings verhinderen respectievelijk veilige wezen-detectie en cleanup na elke terminale afloop. De operator-documentatie is bijgewerkt; de genoemde randgevallen ontbreken in de toegevoegde tests.
Verificatie op commit
c0523178d7: diff en omliggende runtime-code beoordeeld tegen de beschikbare productstandaarden; dispatch-typecheck geslaagd na initialisatie van de gepinde submodule. Beide findings met directe runtime-reproducties bevestigd. De volledige Vitest-suite kon in deze reviewomgeving niet starten: /tmp is noexec en de native rolldown-module kan daardoor niet worden geladen; dit is een verificatiebeperking, geen bewezen PR-regressie.COMMENT
Geen blokkerende coderegressie gevonden. De terminale discard, behoud bij pending/uncertain en ENOSPC-afhandeling sluiten aan op het gekoppelde plan en de bestaande port- en bounded-logpatronen. Kleine opmerkingen en de verificatiebeperking hieronder verhinderen een onvoorwaardelijke goedkeuring.
Findings
AbortSignalblijft de interval actief: de later geregistreerde listener ontvangt het eerdere abort-event niet. Controleersignal.abortedbij het wapenen en dek dit af met een timer-test. Een tijdelijke reproductietest bevestigt één resterende timer naarmPreparedSourcesSweep(... AbortSignal.abort()).masterna PR #119 rond de received-replay release. Forgejo meldtmergeable=false;git merge-treebevestigt het conflict bij de toegevoegde comment. Werk de branch bij en behoud de release/discard-route en regressietests.Plan en documentatie
plan gekoppeld via pr_refs; references: T-82, T-83, T-84, story ST-023. Er is niets omitted of afgekapte planinhoud. De diff dekt deze drie taken; de extra controle van recente activiteit in onderliggende staging-mappen voorkomt verwijdering van een actieve retry. De operator-documentatie beschrijft cleanup, ENOSPC en de beperking voor oude attempts van andere slots. Product-docs zijn geraadpleegd; voor de actuele dispatch-details is tevens
docs/dispatch-runtime-operator.mdgelezen.Verificatie
Beoordeeld op commit
92f22e5f391f06d1cd7537833523bedf0e8144f9, met de gepinde shared-submodule. Typecheck groen; de vier gewijzigde testbestanden: 113 geslaagd. De tijdelijke timerreproductie slaagt en bevestigt de LOW-finding; er zijn geen bronwijzigingen achtergelaten.Volledige suite in deze Linux-runner: 1254 geslaagd, 8 overgeslagen, 51 gefaald. De oorspronkelijke basiscommit
ff00ae6heeft exact dezelfde 51 falende tests (1238 geslaagd, 8 overgeslagen). De failures zitten in ongewijzigde bestanden;/tmpisnoexec, wat onder meer uitvoerbare teststubs blokkeert. Vitest is gestart met een tijdelijke geheugenbestands-workaround voor zijn native dependencies. Geen nieuwe suite-failures gevonden, maar het acceptatiecriterium ‘volledige testsuite groen’ is hier niet bevestigd.COMMENT
bin/run-dispatch-attempt.ts:158: Bij een reeds geaborteerd signaal blijft de sweep-timer lopen: de later geregistreerde abort-listener ontvangt geen event meer. Controleersignal.abortedvoordat de periodieke timer wordt gestart. Gerichte reproductie met een vooraf geaborteerd signaal en een interval van 10 ms: vijf sweeps binnen 45 ms. De wiring-test gebruikt deze situatie maar controleert niet dat vervolgsweeps uitblijven.Plan gekoppeld via pr_refs: T-82, T-83, T-84 (ST-023). Geen omitted onderdelen. De terminale cleanup, bescherming van recente retrybestanden en ENOSPC-route sluiten inhoudelijk aan op het plan. De portstructuur en bounded best-effort logging volgen de bestaande patronen; de operator-documentatie beschrijft de wijziging en de beperking bij journals van andere slots.
Verificatie op
90751b5c7c361cbf4629904ad34d429bc3a4ca6c: dispatch-typecheck geslaagd na initialisatie van de gepinde shared-submodule. De volledige testsuite kon hier niet starten: de native Rolldown/Vitest-binding op/tmpfaalt metfailed to map segment from shared object. Dit is een verificatiebeperking, geen aangetoonde testregressie. Daarom geen APPROVED. Geen blokkerende codefinding vastgesteld.De PR is inmiddels gemerged; de actuele head-SHA komt overeen met de aangeleverde SHA.