docs(hub): permission-hook — bypassPermissions-gate-caveat voor wait>0 (uit max2-uitrol) #153

Merged
janpeter merged 2 commits from fix/hub-hook-runbook into main 2026-08-12 11:09:42 +02:00
Owner

Runbook-aanvulling uit de max2-hook-uitrol (2026-08-12).

Toegevoegd

De bypassPermissions-gate dekt wait>0 niet volledig af. Met HUB_HOOK_WAIT_SECONDS>0 raadpleegt de hook de hub voor élke niet-allowlisted, niet-bypassPermissions tool-call. In job-config.ts draaien echter alleen TASK_IMPLEMENTATION en SPRINT_IMPLEMENTATION op bypassPermissions; andere kinds staan op acceptEdits/default, en acceptEdits slaat alleen edit-tools over — een Bash-call gaat gewoon naar de hub. Op een host waar autonome workers de host-settings lezen, hangt wait>0 dus de hele vloot op.

  • Waarschuwingsblok toegevoegd, met de max2-oplossing: container-isolatie (docker-workers met HOME=/home/agent, ~/.claude niet gemount → host-settings bereiken ze niet).
  • Fleet-host-bullet verduidelijkt: wait=120 mag op een fleet-host mits de workers de settings niet lezen; anders wait=0 of de hook naar een aparte interactieve settings-locatie scopen.

De env-export-fix (punt #1 uit de uitrol) stond al in het runbook.

Verificatie

npm run docs (INDEX + link-check) groen — 166 files, alle links valide.

🤖 Generated with Claude Code

Runbook-aanvulling uit de max2-hook-uitrol (2026-08-12). ## Toegevoegd De **bypassPermissions-gate dekt `wait>0` niet volledig af.** Met `HUB_HOOK_WAIT_SECONDS>0` raadpleegt de hook de hub voor élke niet-allowlisted, niet-`bypassPermissions` tool-call. In `job-config.ts` draaien echter alleen `TASK_IMPLEMENTATION` en `SPRINT_IMPLEMENTATION` op `bypassPermissions`; andere kinds staan op `acceptEdits`/`default`, en `acceptEdits` slaat alleen *edit*-tools over — een `Bash`-call gaat gewoon naar de hub. Op een host waar autonome workers de host-settings lezen, **hangt `wait>0` dus de hele vloot op**. - Waarschuwingsblok toegevoegd, met de max2-oplossing: **container-isolatie** (docker-workers met `HOME=/home/agent`, `~/.claude` niet gemount → host-settings bereiken ze niet). - Fleet-host-bullet verduidelijkt: `wait=120` mag op een fleet-host mits de workers de settings niet lezen; anders `wait=0` of de hook naar een aparte interactieve settings-locatie scopen. De env-export-fix (punt #1 uit de uitrol) stond al in het runbook. ## Verificatie `npm run docs` (INDEX + link-check) groen — 166 files, alle links valide. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(hub): permission-hook — wait>0 hangt vloot op zonder worker-isolatie
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m26s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
c8ceaf8b9a
Runbook-aanvulling uit de max2-uitrol (2026-08-12): de bypassPermissions-gate
dekt wait>0 niet volledig af — alleen TASK_/SPRINT_IMPLEMENTATION draaien op
bypassPermissions; andere kinds (acceptEdits/default) sturen Bash-calls gewoon
naar de hub. Op een host waar autonome workers de host-settings lezen, hangt
wait>0 dus de hele vloot op. Waarschuwing + de max2-oplossing (container-isolatie:
HOME=/home/agent, ~/.claude niet gemount) toegevoegd; fleet-host-bullet verduidelijkt
dat wait=120 mag mits de workers de settings niet lezen. INDEX geregenereerd.

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

Verdict: APPROVED

Geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden.

Findings

  • Geen blockerende of error-severity findings.

Toetsing

De PR is docs-only en verduidelijkt in docs/runbooks/hub-permission-hook.md:57 het risico van HUB_HOOK_WAIT_SECONDS>0 op fleet-hosts met autonome workers. De waarschuwing sluit aan op het bestaande runbookgedrag: wait=0 blijft de veilige default voor headless hosts, en interactieve wait>0 wordt alleen toegestaan wanneer worker-settings aantoonbaar geisoleerd zijn. De gegenereerde indexdatum in docs/INDEX.md:5 is passend bij een documentatie-update.

Tests zijn niet van toepassing voor deze docs-only wijziging.

# Verdict: APPROVED Geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ## Findings - Geen blockerende of error-severity findings. ## Toetsing De PR is docs-only en verduidelijkt in `docs/runbooks/hub-permission-hook.md:57` het risico van `HUB_HOOK_WAIT_SECONDS>0` op fleet-hosts met autonome workers. De waarschuwing sluit aan op het bestaande runbookgedrag: `wait=0` blijft de veilige default voor headless hosts, en interactieve `wait>0` wordt alleen toegestaan wanneer worker-settings aantoonbaar geisoleerd zijn. De gegenereerde indexdatum in `docs/INDEX.md:5` is passend bij een documentatie-update. Tests zijn niet van toepassing voor deze docs-only wijziging.
docs(hub): allowlist + immediate-effect + secret-hygiëne bij wait>0 (max2-nalevering)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m39s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
65a598e6c5
Vervolg op de max2-uitrol (info-berichten 2026-08-12):
- Hook geldt PER DIRECT in lopende sessies (niet pas een nieuwe) — gemeten op
  scrum4me-server (15× langs de hub, incl. queue_next/done) + max2. Plan de uitrol
  alsof hij onmiddellijk ingaat.
- Allowlist bij wait>0: user-scope gecureerde permissions.allow (hook kent geen
  defaultMode); nauwe Bash(<prefix>:*)-regels.
- Valkuilen: startsWith zonder woordgrens; kale toolnaam schakelt de hook uit;
  blanco Bash(sudo *) = stil gat in de hub.
- Hygiëne: allow-regels bewaren het volledige commando → geen secrets erin (restic-
  wachtwoord gevonden op max2); geen project-allowlist naar nieuwe workspace kopiëren.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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/Scrum4Me!153
No description provided.