Skip to content

docs(windows): add runtime architecture overview - #3575

Merged
shailendra-nv merged 3 commits into
NVIDIA:windowsfrom
shailendra-nv:windows-architecture/ss
Sep 23, 2026
Merged

shailendra-nv merged 3 commits into
NVIDIA:windowsfrom
shailendra-nv:windows-architecture/ss

Conversation

@shailendra-nv

@shailendra-nv shailendra-nv commented Sep 23, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Add a canonical Windows architecture overview for the native OpenShell gateway and Microsoft MXC runtime. Consolidate stable runtime and build boundaries in that page, place human build instructions in CONTRIBUTING.md, and retire the misplaced standalone MSVC build architecture page.

Related Issue

No issue required: documentation-only correction and consolidation of behavior already implemented on the windows branch; this PR changes no runtime behavior, public API, or architecture decision.

Changes

  • Document the Windows gateway and in-process MXC control and data paths
  • Compare ProcessContainer and IsolationSession lifecycle and enforcement semantics
  • Describe create-time policy mapping, governed egress, provider credential handling, relay forwarding, ETW/OCSF auditing, and restart limitations
  • Make architecture/windows.md the single canonical Windows architecture page
  • Move contributor-facing Windows build and validation guidance into CONTRIBUTING.md
  • Remove architecture/windows-msvc-build.md and synchronize the architecture index and Windows build skill references
  • Correct the canonical overview for driver-controlled runtimes and the MXC relay configuration comment

Testing

  • mise run pre-commit passes
  • Agent-infrastructure inventory and stale-reference audit passes
  • Unit tests added/updated (not applicable: documentation-only)
  • E2E tests added/updated (not applicable: documentation-only)

Checklist

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

Signed-off-by: Shailendra Singh <shailendras@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 23, 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: Shailendra Singh <shailendras@nvidia.com>
Signed-off-by: Shailendra Singh <shailendras@nvidia.com>
@shailendra-nv

Copy link
Copy Markdown
Collaborator Author

/ok to test 63108db

@shailendra-nv
shailendra-nv merged commit a749bc8 into NVIDIA:windows Sep 23, 2026
63 checks passed
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