docs: report spawn worker delegation scope

This commit is contained in:
2026-08-01 18:34:32 +09:00
parent ec262f0238
commit ecd5751a67
@@ -0,0 +1,24 @@
# SpawnWorker rejects a workspace subdirectory inside the parent write boundary
Date: 2026-07-30
## Symptom
While implementing the multiplexer protocol foundation, the parent Worker could write the checkout but could not delegate `crates/protocol` to a spawned Coder:
```text
Invalid argument: requested child scope .../checkout/crates/protocol Write is outside this Worker's delegation scope grant
```
The requested child scope was a recursive subdirectory of the checkout advertised as writable in the parent instructions. No child was created.
## Impact
The parent had to implement and review the protocol slice serially. This removed useful parallel review and made the long Runtime/Server protocol change more interruption-prone.
## Suggested improvement
- Make the effective delegation grant visible separately from the Worker's direct filesystem write scope.
- Validate and explain which ancestor rule prevents delegation.
- When a requested child scope is a strict subset of a writable/delegable checkout, accept it consistently.
- Distinguish “parent may write but may not delegate” from a malformed/out-of-bound scope error.