Plan step 21: Werkdock extraction and the managed-webspace install path
Records where the bwrap work (PR #4) drifted from the intent of ADR 0006 — the webspace self-build instead of local-build-plus-install — and breaks the correction into four sessions: close step 17's open ends, bootstrap Werkdock, let Werkator consume it, replace the self-build with the bundle install path. The extracted sandbox tool is named Werkdock (decided after three naming rounds, rationale and dropped candidates in the step file). It grows in the werkdock/ subdirectory, seeded here with its README, and moves to its own repository once it stands on its own. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,17 @@
|
|||||||
|
# Werkdock
|
||||||
|
|
||||||
|
A docker-like sandbox CLI over `bwrap` — filesystem isolation only.
|
||||||
|
A dock is the enclosed basin in which ships are built: the dock gate controls what passes, the water outside is shared with the whole harbor.
|
||||||
|
Accordingly, network, uid, `/proc`, `/dev`, and `/tmp` come from the host by contract; that is what makes Werkdock work without root on a Hostsharing Managed Webspace.
|
||||||
|
|
||||||
|
Semantics:
|
||||||
|
|
||||||
|
- An *image* is a rootfs archive.
|
||||||
|
- An *instance* is an unpacked, writable directory tree.
|
||||||
|
- `werkdock run <instance> -- <command>` executes in the sandbox with uid 0 mapped to the calling user.
|
||||||
|
- `werkdock doctor` checks the host: user-namespace capability, disk and quota headroom.
|
||||||
|
|
||||||
|
Status: bootstrap.
|
||||||
|
Werkdock grows in this subdirectory of the Werkator repository and moves to its own repository once it stands on its own.
|
||||||
|
It must stay self-contained: no imports from Werkator code, no Gradle coupling to the Werkator build.
|
||||||
|
The roadmap is session B of [docs/plan/21-werkdock-extraction-and-webspace-install.md](../docs/plan/21-werkdock-extraction-and-webspace-install.md).
|
||||||
Reference in New Issue
Block a user