Skip to content

docs(rfc): RFC 0005 - Sandbox Egress Middleware (draft)#1738

Draft
pimlock wants to merge 2 commits into
mainfrom
rfc-0005-sandbox-egress-middleware
Draft

docs(rfc): RFC 0005 - Sandbox Egress Middleware (draft)#1738
pimlock wants to merge 2 commits into
mainfrom
rfc-0005-sandbox-egress-middleware

Conversation

@pimlock
Copy link
Copy Markdown
Collaborator

@pimlock pimlock commented Jun 4, 2026

Summary

Draft of RFC 0005 - Sandbox Egress Middleware. Proposes hooks in the supervisor proxy that can inspect, transform, allow/deny, and annotate outbound sandbox requests based on their content, via an operator-registered external middleware service. Privacy Guard is the motivating use case.

This is an early draft for feedback. The main README.md holds the high-level proposal; detailed alternatives and schemas move to appendices over time. TRACKER.md is the working/drafting document.

Related Issue

Changes

  • Add rfc/0005-sandbox-egress-middleware/README.md - Summary, Motivation, Privacy Guard use case, Non-goals, and the Proposal (architecture, hook placement, contract, registration/delivery, policy integration, ordering, metadata, OCSF audit/logging).
  • Add rfc/0005-sandbox-egress-middleware/TRACKER.md - drafting tracker.
  • Add rfc/0005-sandbox-egress-middleware/appendices/deployment-options.md - deployment-mode decision and future options.

Note: RFC numbering conflict

This RFC uses number 0005, which already collides with other RFCs that are in-progress.

Potential solution: reserve RFC numbers and explicitly allow non-continuous numbering. Gaps in the sequence are fine; what matters is that a number is uniquely claimed once an RFC is in progress. Reserving numbers makes it easier to talk about in-flight RFCs - e.g. "someone proposed X in RFC 4", or "RFC 4 and RFC 6 are both in progress and overlap on X" - without two documents fighting over the same identifier.

Happy to renumber this RFC to whatever the next reserved value should be.

Testing

N/A - documentation only.

Checklist

  • Docs-only change
  • RFC content finalized (draft; Implementation plan, Risks, Alternatives still TODO)

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented Jun 4, 2026

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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the split here, otherwise the README gets quite long and the intent gets lost in the details. Is this part of the RFC skill now?

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.

2 participants