Skip to content

feat(isolation): add RFC 0012 backend contract - #2941

Draft
drew wants to merge 1 commit into
mainfrom
codex/1737-rfc12-contract
Draft

feat(isolation): add RFC 0012 backend contract#2941
drew wants to merge 1 commit into
mainfrom
codex/1737-rfc12-contract

Conversation

@drew

@drew drew commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Define RFC 0012's runtime-selectable Isolation Backend contract and its security invariants. This is PR 1 of 2 in the draft stack and introduces no runtime activation. PR #2943 is an unstacked follow-on prototype.

Stack: this PRcodex/1737-rfc12-supervisor-primitives. Unstacked follow-on: #2943.

Review-only prototype: The original code author is @jganoff, and the original implementation source is jganoff/OpenShell:jganoff/rfc-0012-impl. This reconstructed stack is for reviewing and prototyping RFC 0012; we do not intend to merge these PRs. The stack is rebased onto current main and integrated with the current canonical process and networking architecture.

Related Issue

Part of #1737. The final PR in this stack closes the issue.

Changes

  • Add the RFC 0012 proposal, codebase grounding, and topology matrix.
  • Add the openshell-isolation crate with consuming BoundReadyRunning lifecycle states.
  • Add exact descriptor/backend/version resolution with no fallback.
  • Add placement-neutral process, exec, terminal, port-forward, and network-mediation contracts.
  • Add contract conformance and fail-closed behavior tests.

Testing

  • cargo test -p openshell-isolation — 21 passed
  • Integrated stack compiles across sandbox, supervisor, and affected drivers
  • Privileged/socket tests require an environment that permits namespace and socket creation

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (RFC and architecture inventory)

@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.

Signed-off-by: Drew Newberry <385+drew@users.noreply.github.com>
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