Skip to content

workspace: CoW fork from a materialize-once base cache#129

Merged
vu1n merged 2 commits into
mainfrom
brief/cow-workspace-fork
Jul 3, 2026
Merged

workspace: CoW fork from a materialize-once base cache#129
vu1n merged 2 commits into
mainfrom
brief/cow-workspace-fork

Conversation

@vu1n

@vu1n vu1n commented Jul 3, 2026

Copy link
Copy Markdown
Owner

What

k dispatch workers fork one bookmark near-free: materialize the snapshot once into a content-addressed base cache (base_cache.rs), then CoW-clone per worker (cow.rs — APFS clonefile / Linux FICLONE reflink, degrading to a reported byte copy where reflink is unavailable). --from-bookmark without --workspace now warms the base cache and leaves cwd untouched; the --workspace and no-bookmark paths are unchanged.

Governance (brief) — the process this PR exercises

First governed PR under brief:

  • New decision doc://pillbox/workspace-cow-fork (status: draft) captures the fork mechanism, scoped via related_code to base_cache.rs / cow.rs; both files point back with a // Context: ref.
  • Conforms sign-offs: the libkrun integration touches three active decisions — libkrun-is-the-backend, libkrun-env-fork-substrate, workspace-ingest-sovereignty — each signed conforms in .brief/SIGNOFF (implementation, no decision moved).
  • CI gate: .github/workflows/brief.yml runs brief check on this PR's diff and blocks if governed code changes without a conforms/amend-proposed sign-off.

When the mechanism is firm: flip workspace-cow-fork to active + brief publish — from then its files are enforced.

vu1n added 2 commits July 3, 2026 11:37
k dispatch workers fork one bookmark near-free: materialize the snapshot once into a
content-addressed base cache (base_cache.rs), then CoW-clone per worker (cow.rs; APFS
clonefile / Linux FICLONE). --from-bookmark without --workspace now warms the base
cache and leaves cwd untouched.

Governance (brief): adds decision doc://pillbox/workspace-cow-fork (draft) + code refs;
libkrun edits signed conforms in .brief/SIGNOFF; adds the brief CI gate.
@vu1n
vu1n merged commit 83b619f into main Jul 3, 2026
4 checks passed
@vu1n
vu1n deleted the brief/cow-workspace-fork branch July 3, 2026 05:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant