Skip to content

docs(architecture): update 0.1.0 runtime overview - #3541

Draft
drew wants to merge 1 commit into
mainfrom
codex/update-0-1-architecture-docs
Draft

drew wants to merge 1 commit into
mainfrom
codex/update-0-1-architecture-docs

Conversation

@drew

@drew drew commented Sep 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Update the published architecture overview to match the OpenShell 0.1.0 runtime model. The page now documents the external supervisor, capability-free workload boundary, high-availability gateway relays, and negotiated extension contracts.

Related Issue

No issue required: this docs-only change corrects the architecture page to reflect behavior already implemented for 0.1.0.

Changes

  • Redraw the architecture diagram around the gateway, supervisor, sandbox runtime, and outer network fence.
  • Document the current trust, isolation, credential, and network boundaries.
  • Add runtime placement details for Docker, Podman, Kubernetes, VM, and Windows MXC.
  • Describe multi-replica gateway session ownership and extension protocol negotiation.
  • Add links to detailed runtime, policy, Kubernetes, and extension documentation.

Testing

  • mise run docs passes.
  • mise run pre-commit passes.
  • Unit tests added/updated (not applicable to a documentation-only change).
  • E2E tests added/updated (not applicable to a documentation-only change).

Checklist

  • Follows Conventional Commits.
  • Commits are signed off (DCO).
  • Architecture docs updated (if applicable).

Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 22, 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

Copy link
Copy Markdown

@drew drew changed the title docs(architecture): update 0.1 runtime overview docs(architecture): update 0.1.0 runtime overview Sep 22, 2026
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