Skip to content

feat(isolation): define the RFC 0012 boundary contract - #2941

Open
drew wants to merge 11 commits into
mainfrom
codex/1737-rfc12-contract
Open

feat(isolation): define the RFC 0012 boundary contract#2941
drew wants to merge 11 commits into
mainfrom
codex/1737-rfc12-contract

Conversation

@drew

@drew drew commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Define the base RFC 0012 isolation contract for separating the trusted supervisor from the in-workload sandbox runtime. The contract is intentionally breaking: drivers must provide an authenticated protected channel, lifecycle ownership, process control, binary identity, TCP mediation, and DNS mediation.

General application UDP mediation is not part of this stack. DNS may use UDP or TCP internally, but both paths remain mediated by the supervisor.

Related Issue

Part of #1737.

Changes

  • Define backend-neutral sandbox lifecycle, process, identity, and network contracts.
  • Require fail-closed startup confirmation before untrusted workload execution.
  • Define the supervisor/sandbox trust boundary and protected-channel responsibilities.
  • Narrow the network contract to TCP plus DNS; remove connected, unconnected, and raw UDP APIs.
  • Document capability-free sandbox requirements and driver-owned outer egress fences.

Testing

  • mise run pre-commit passes
  • Full unit and E2E validation delegated to remote CI

Checklist

  • Follows Conventional Commits
  • Authored commits are signed off (DCO)

Review remediation

  • Clarify that unavailable or stale DNS process identity is never an authorization grant; DNS remains hostname-policy mediated by the supervisor.

Stack

  1. feat(isolation): define the RFC 0012 boundary contract #2941 — contract (this PR)
  2. feat(isolation): add boundary protocol and Linux primitives #2942 — shared interface and primitives
  3. feat(isolation): split supervisor and sandbox runtimes #3151 — supervisor and sandbox runtimes
  4. feat(vm): run the supervisor outside the guest workload #2945 — VM driver
  5. feat(docker): isolate workloads behind the host supervisor #2965 — Docker driver
  6. feat(kubernetes): add proxy-pod isolation topology #3144 — Kubernetes proxy-pod topology
  7. feat(podman): isolate workloads behind the host supervisor #3230 — Podman driver
  8. perf(isolation): add TCP and DNS benchmark harnesses #3229 — performance harnesses

@copy-pr-bot

copy-pr-bot Bot commented Aug 26, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@copy-pr-bot

copy-pr-bot Bot commented Aug 31, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Label test:e2e applied for a5dc6db. Open the existing run and click Re-run all jobs to execute with the label set. The run will execute the standard E2E suite after building the required gateway and supervisor images once. The matching required CI gate status on this PR will flip green automatically once the run finishes.

@drew
drew force-pushed the codex/1737-rfc12-contract branch from a5dc6db to 05a961b Compare September 5, 2026 16:08
@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

2 similar comments
@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@drew
drew force-pushed the codex/1737-rfc12-contract branch from 7eb8e06 to 05a961b Compare September 8, 2026 22:32
@drew drew changed the title feat(isolation): add RFC 0012 backend contract feat(isolation): define the RFC 0012 boundary contract Sep 8, 2026
@drew
drew removed this pull request from stack #3152 September 9, 2026 04:42
@drew
drew added this pull request to stack #3231 September 9, 2026 04:42
drew and others added 3 commits September 8, 2026 21:46
Signed-off-by: Drew Newberry <385+drew@users.noreply.github.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
drew added 8 commits September 8, 2026 21:46
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
…tions

Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@drew
drew force-pushed the codex/1737-rfc12-contract branch from daf3da9 to 24514b0 Compare September 9, 2026 04:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

test:e2e Requires end-to-end coverage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant