docs(hub): 120 als wachttijd op interactieve hosts #166

Merged
janpeter merged 1 commit from docs/hook-wait-window into main 2026-08-14 16:21:51 +02:00
Owner

scrum4me-server staat nu op HUB_HOOK_WAIT_SECONDS=120 (was 30). Deze PR legt de reden vast.

De meting

Tijdens de M34-gate verliep de eerste "Weiger met aanwijzing" na 29 seconden — approval cmst02ux, status EXPIRED. Ontgrendelen, de actie kiezen én een zin dicteren past niet in dertig seconden. Met 120 slaagde dezelfde stap met acht seconden marge over.

Een verlopen approval is geen fout: de hook geeft dan geen besluit en de prompt valt terug naar de terminal. Maar je verliest de hub voor die call, en tijdens een gate kost het een verkeerde diagnose — ik dacht eerst aan een afleverprobleem.

De valkuil erbij

De timeout van de hook-entry in settings.json moet ruimer blijven dan de wachttijd. Staat die op 60 terwijl de wachttijd op 120 gaat, dan kapt Claude Code de hook halverwege af — met exact hetzelfde symptoom als een te korte wachttijd, bij een heel andere oorzaak. Op scrum4me-server stond de entry al op 150; de env liep dus uit de pas met zijn eigen hook-entry.

Stand per host

Host Wachttijd Waarom
scrum4me-server 120 interactief goedgekeurd, entry-timeout 150
max2 0 autonome workers — wait>0 zou de vloot ophangen
JP's Mac n.v.t. hook niet geregistreerd, geen env-bestand

Docs-only. npm run docs groen.

`scrum4me-server` staat nu op `HUB_HOOK_WAIT_SECONDS=120` (was 30). Deze PR legt de reden vast. ## De meting Tijdens de M34-gate verliep de eerste "Weiger met aanwijzing" na **29 seconden** — approval `cmst02ux`, status `EXPIRED`. Ontgrendelen, de actie kiezen én een zin dicteren past niet in dertig seconden. Met `120` slaagde dezelfde stap met acht seconden marge over. Een verlopen approval is geen fout: de hook geeft dan geen besluit en de prompt valt terug naar de terminal. Maar je verliest de hub voor die call, en tijdens een gate kost het een verkeerde diagnose — ik dacht eerst aan een afleverprobleem. ## De valkuil erbij De `timeout` van de hook-entry in `settings.json` moet ruimer blijven dan de wachttijd. Staat die op `60` terwijl de wachttijd op `120` gaat, dan kapt Claude Code de hook halverwege af — met exact hetzelfde symptoom als een te korte wachttijd, bij een heel andere oorzaak. Op `scrum4me-server` stond de entry al op `150`; de env liep dus uit de pas met zijn eigen hook-entry. ## Stand per host | Host | Wachttijd | Waarom | |---|---|---| | `scrum4me-server` | `120` | interactief goedgekeurd, entry-timeout 150 | | `max2` | `0` | autonome workers — `wait>0` zou de vloot ophangen | | JP's Mac | n.v.t. | hook niet geregistreerd, geen env-bestand | Docs-only. `npm run docs` groen.
docs(hub): 120 als wachttijd op interactieve hosts, met de meting erbij
All checks were successful
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m8s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
77a73bf25e
scrum4me-server stond op 30. Tijdens de M34-gate verliep de eerste "Weiger met
aanwijzing" na 29 seconden (approval cmst02ux, EXPIRED): ontgrendelen, de actie
kiezen en een zin dicteren past daar niet in. Met 120 slaagde dezelfde stap met
8 seconden marge over. De host staat nu op 120; max2 blijft op 0 omdat daar
autonome workers draaien.

Ook opgeschreven: de timeout van de hook-entry moet ruimer blijven dan de
wachttijd. Staat die te krap, dan kapt Claude Code de hook halverwege af en zie
je hetzelfde symptoom als een te korte wachttijd bij een heel andere oorzaak.
Op scrum4me-server stond die al op 150 — de env liep dus uit de pas met zijn
eigen hook-entry.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No labels
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!166
No description provided.