fix(scan): een gewone scan wacht op een bezet verwijderslot in plaats van te stoppen #105

Merged
janpeter merged 2 commits from fix/scan-waits-on-delete-slot into main 2026-10-07 03:04:32 +02:00
Owner

Waarom

Een gewone scan (manual/scheduled) die queued stond terwijl een delete het verwijderslot van de mount hield, werd toch geclaimd. Hij eindigde dan bij de vroege slotcontrole als stopped. Geen enkele mount heeft een scaninterval, dus zo ging ook de herscan verloren die de delete-worker sinds PR #104 na een ENOENT aanvraagt.

Wat

Alleen in src/lib/mount-index/job-runner.ts (claimNext):

  • de kandidaatquery slaat een mount over waarvan het slot held of slot_stale is, ook bij een verlopen lease; die verzoent de launcher;
  • onder de 212-advisory-lock volgt de beslissende hercontrole, vóór de running-write.

claimSlot is de enige schrijver van held, neemt dezelfde lock en weigert bij een running scan. De race is daarmee dicht en een requeue is niet nodig. De vroege slotcontrole in de scanner blijft ongewijzigd een defensieve stopped. trash_inventory en identify blijven ongewijzigd.

De kandidaatfilter houdt een wachtende mount ook buiten de 212-transactie per kandidaat. Pollen strijdt dus niet met de delete-worker om die lock.

Tijdsgedrag (gekwalificeerd): een beschikbare scan-worker claimt de job bij een volgende poll (standaard 2 s) nadat het slot vrij is. Is de worker met een andere mount bezig, dan later. Een verlopen of verweesd slot verzoent de launcher bij een tick die de container-mutex passeert. Een houder die niet bewezen weg is, blijft bewust blokkeren (fail-closed).

Ontwerp en review

ProductDoc specs/2026-10-07-scan-waits-on-delete-slot, revisie 2 (sha256 02f29ff2…63ca). GO van mac:codex en van scrum4me-server:claude. Het requeue-vangnet uit revisie 1 is na review geschrapt (de race bestaat niet). De codex-MINOR, een gerichte racetest, is hieronder verwerkt.

Tests

Nieuw: src/lib/mount-index/scan-wait.db.test.ts (11 tests, met de queue afgebakend tot de eigen mounts, dus veilig in de gewone suite):

  • manual én scheduled × held / held met verlopen lease / slot_stale: niet geclaimd, de job blijft byte-gelijk. Een scan op een andere mount wordt wel geclaimd;
  • een vrij slot: geclaimd, en de scan loopt echt tot done;
  • geen lus: 50 polls geven 0 claims, 0 wijzigingen en 0 claimtransacties;
  • race met een barrière na de echte kandidaatquery, waarin een andere verbinding de echte claimSlot doet: geen claim, de job blijft ongewijzigd;
  • invariant: is de scan running, dan geeft claimSlot false en eindigt de scan done;
  • de vroege controle bij een handmatig gezet slot blijft stopped.

Mutatiechecks:

  • zonder kandidaatfilter faalt de no-loop-test;
  • zonder de innerlijke hercontrole faalt de racetest;
  • zonder de running-voorwaarde in mountNotBusy faalt de invarianttest.

Verse wegwerp-Postgres per stap: gewone suite 1924 pass / 16 fail; geïsoleerde stap 31 pass / 8 fail. Beide failure-sets zijn identiek aan main @ c75bd3e. eslint is schoon; tsc geeft geen nieuwe fouten.

Scrum4Me: PBI-36 / ST-069 / T-247. De uitrol en praktijkproef volgen in T-248.

🤖 Generated with Claude Code

## Waarom Een gewone scan (`manual`/`scheduled`) die `queued` stond terwijl een delete het verwijderslot van de mount hield, werd toch geclaimd. Hij eindigde dan bij de vroege slotcontrole als `stopped`. Geen enkele mount heeft een scaninterval, dus zo ging ook de herscan verloren die de delete-worker sinds PR #104 na een ENOENT aanvraagt. ## Wat Alleen in `src/lib/mount-index/job-runner.ts` (`claimNext`): - de kandidaatquery slaat een mount over waarvan het slot `held` of `slot_stale` is, ook bij een verlopen lease; die verzoent de launcher; - onder de 212-advisory-lock volgt de beslissende hercontrole, vóór de `running`-write. `claimSlot` is de enige schrijver van `held`, neemt dezelfde lock en weigert bij een `running` scan. De race is daarmee dicht en een requeue is niet nodig. De vroege slotcontrole in de scanner blijft ongewijzigd een defensieve `stopped`. `trash_inventory` en `identify` blijven ongewijzigd. De kandidaatfilter houdt een wachtende mount ook buiten de 212-transactie per kandidaat. Pollen strijdt dus niet met de delete-worker om die lock. **Tijdsgedrag (gekwalificeerd):** een beschikbare scan-worker claimt de job bij een volgende poll (standaard 2 s) nadat het slot vrij is. Is de worker met een andere mount bezig, dan later. Een verlopen of verweesd slot verzoent de launcher bij een tick die de container-mutex passeert. Een houder die niet bewezen weg is, blijft bewust blokkeren (fail-closed). ## Ontwerp en review ProductDoc `specs/2026-10-07-scan-waits-on-delete-slot`, revisie 2 (sha256 `02f29ff2…63ca`). GO van `mac:codex` en van `scrum4me-server:claude`. Het requeue-vangnet uit revisie 1 is na review geschrapt (de race bestaat niet). De codex-MINOR, een gerichte racetest, is hieronder verwerkt. ## Tests Nieuw: `src/lib/mount-index/scan-wait.db.test.ts` (11 tests, met de queue afgebakend tot de eigen mounts, dus veilig in de gewone suite): - `manual` én `scheduled` × `held` / `held` met verlopen lease / `slot_stale`: niet geclaimd, de job blijft byte-gelijk. Een scan op een andere mount wordt wel geclaimd; - een vrij slot: geclaimd, en de scan loopt echt tot `done`; - geen lus: 50 polls geven 0 claims, 0 wijzigingen en **0 claimtransacties**; - race met een barrière na de echte kandidaatquery, waarin een andere verbinding de echte `claimSlot` doet: geen claim, de job blijft ongewijzigd; - invariant: is de scan `running`, dan geeft `claimSlot` `false` en eindigt de scan `done`; - de vroege controle bij een handmatig gezet slot blijft `stopped`. Mutatiechecks: - zonder kandidaatfilter faalt de no-loop-test; - zonder de innerlijke hercontrole faalt de racetest; - zonder de `running`-voorwaarde in `mountNotBusy` faalt de invarianttest. Verse wegwerp-Postgres per stap: gewone suite 1924 pass / 16 fail; geïsoleerde stap 31 pass / 8 fail. Beide failure-sets zijn identiek aan `main` @ c75bd3e. eslint is schoon; tsc geeft geen nieuwe fouten. Scrum4Me: PBI-36 / ST-069 / T-247. De uitrol en praktijkproef volgen in T-248. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
fix(scan): a normal scan waits while the mount's delete slot is busy
Some checks failed
CI / test (historical-bootstrap) (pull_request) Successful in 1m35s
CI / test (empty-trash) (pull_request) Failing after 1m49s
CI / test (video-migration) (pull_request) Successful in 1m5s
CI / docker-build (pull_request) Successful in 2m54s
CI / test (suite) (pull_request) Failing after 4m51s
c189769817
A queued manual/scheduled scan was claimed even while a delete held the
mount's slot, and then ended 'stopped' at the early slot check. With no
scan interval on any mount, that silently lost the rescan the delete worker
requests after an ENOENT (PR #104).

The job claim now skips such a mount while its slot is held or slot_stale
(also with a lapsed lease; the launcher reconciles those), both in the
unlocked candidate read and in the recheck under the 212 admission lock
before the running write. claimSlot is the only writer of 'held', takes the
same lock and refuses while a scan is running, so the race is closed and no
requeue is needed. The scanner's early slot check stays a defensive
'stopped'. The candidate filter also keeps a waiting mount out of the
per-candidate 212 transaction, so polling never contends for that lock.

Spec: ProductDoc specs/2026-10-07-scan-waits-on-delete-slot rev. 2
(GO mac:codex, GO scrum4me-server:claude). ST-069 / T-247

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

COMMENT

Geen blokkerende codebevindingen gevonden; één kleine testopmerking en beperkte onafhankelijke runtime-verificatie.

Findings

  • MINOR — src/lib/mount-index/scan-wait.db.test.ts:54: na het vrijgeven van het bezette slot eindigt de test. De vrije-slot-test begint met een nieuwe job. Voeg voor manual en scheduled een vervolg toe dat dezelfde wachtende job claimt en via runJob tot done met doorloop brengt; daarmee wordt acceptatiecriterium 2 rechtstreeks bewezen.

Code, architectuur en plan

plan gekoppeld via pr_refs; references: T-247, T-248, ST-069. Er zijn geen omitted onderdelen.

De diff en PR-head zijn gecontroleerd tegen c18976981755b79b1cf72beea5ec4af17a008348. De kandidaatfilter en beslissende hercontrole onder mountlock 212 volgen ProductDoc specs/2026-10-07-scan-waits-on-delete-slot, revisie 2. claimSlot neemt dezelfde lock en weigert bij een running scan: beide toelatingsvolgordes zijn afgedekt zonder requeue. identify, trash_inventory, scanner en finishJob blijven intact. De oorspronkelijke story-AC over requeue is expliciet vervangen door het bindende taakplan/revisie 2; dit is geen planstrijdigheid.

De PR rondt alleen T-247 af en vermeldt T-248 (uitrol/praktijkproef) als vervolg. Die praktijkproef ontbreekt hier terecht en blokkeert deze PR niet. De ontwerpdocumentatie en gekwalificeerde timing in de PR-beschrijving passen bij de implementatie.

Verificatie

ESLint op beide gewijzigde bestanden en git diff --check slagen. Typecheck rapporteert dezelfde drie ontbrekende @s4m-kit/index-imports met de oorspronkelijke en gewijzigde job-runner; geen nieuwe typefouten. De gerichte runtime-tests konden niet starten: esbuild krijgt EACCES doordat /tmp noexec is; bovendien is geen lokale PostgreSQL-testomgeving beschikbaar. De suite- en mutatieresultaten in de PR-beschrijving zijn dus niet onafhankelijk gereproduceerd. Daarom COMMENT, geen goedkeuring met onbevestigde runtime-verificatie.

# COMMENT Geen blokkerende codebevindingen gevonden; één kleine testopmerking en beperkte onafhankelijke runtime-verificatie. ## Findings - **MINOR — src/lib/mount-index/scan-wait.db.test.ts:54:** na het vrijgeven van het bezette slot eindigt de test. De vrije-slot-test begint met een nieuwe job. Voeg voor `manual` en `scheduled` een vervolg toe dat dezelfde wachtende job claimt en via `runJob` tot `done` met doorloop brengt; daarmee wordt acceptatiecriterium 2 rechtstreeks bewezen. ## Code, architectuur en plan plan gekoppeld via pr_refs; references: T-247, T-248, ST-069. Er zijn geen omitted onderdelen. De diff en PR-head zijn gecontroleerd tegen `c18976981755b79b1cf72beea5ec4af17a008348`. De kandidaatfilter en beslissende hercontrole onder mountlock 212 volgen ProductDoc `specs/2026-10-07-scan-waits-on-delete-slot`, revisie 2. `claimSlot` neemt dezelfde lock en weigert bij een running scan: beide toelatingsvolgordes zijn afgedekt zonder requeue. `identify`, `trash_inventory`, scanner en finishJob blijven intact. De oorspronkelijke story-AC over requeue is expliciet vervangen door het bindende taakplan/revisie 2; dit is geen planstrijdigheid. De PR rondt alleen T-247 af en vermeldt T-248 (uitrol/praktijkproef) als vervolg. Die praktijkproef ontbreekt hier terecht en blokkeert deze PR niet. De ontwerpdocumentatie en gekwalificeerde timing in de PR-beschrijving passen bij de implementatie. ## Verificatie ESLint op beide gewijzigde bestanden en `git diff --check` slagen. Typecheck rapporteert dezelfde drie ontbrekende `@s4m-kit/index`-imports met de oorspronkelijke en gewijzigde job-runner; geen nieuwe typefouten. De gerichte runtime-tests konden niet starten: esbuild krijgt EACCES doordat `/tmp` noexec is; bovendien is geen lokale PostgreSQL-testomgeving beschikbaar. De suite- en mutatieresultaten in de PR-beschrijving zijn dus niet onafhankelijk gereproduceerd. Daarom COMMENT, geen goedkeuring met onbevestigde runtime-verificatie.
test(scan): prove the same waiting job completes once the slot is free
Some checks failed
CI / test (historical-bootstrap) (pull_request) Successful in 1m39s
CI / test (empty-trash) (pull_request) Failing after 1m43s
CI / test (video-migration) (pull_request) Successful in 1m2s
CI / docker-build (pull_request) Successful in 2m55s
CI / test (suite) (pull_request) Failing after 4m54s
615906cc6a
Review on PR #105: the wait tests ended after freeing the slot. For both
manual and scheduled they now claim that same queued job and walk it to
done, which proves acceptance criterion 2 directly.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No labels
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/Media-Organizer!105
No description provided.