Skip to main content

Security and evidence model

Persisting does not compress security into one safe or sandboxed label. Every Run reports guarantees by capability dimension. pVisor owns admission and runtime enforcement. Placement and recovery mechanisms do not upgrade a pVisor evidence level. Configured pChronicle capture preserves lifecycle facts and only the Evidence carried by Gateway or lifecycle event records. The full Run Bundle evidence inventory remains local unless moved separately.

DimensionExample mechanismEvidence question
Filesystem readsynthetic root, allowlisted projectionWhich host paths were visible?
Filesystem writestaged OverlayFS, Landlock, SeatbeltWhere could the process tree write?
Networkprivate namespace, virtio-net, proxy policyCould direct sockets bypass policy?
Processnamespace, sandbox profile, inherited-FD cleanupWhich descendants shared the boundary?
CredentialsRun-scoped delivery and expiryWhich identity received and used the secret?
Effectsstage, promotion decision, compensation recordWhich consequences reached the real system?

Evidence has four useful levels:

  1. Declared — configuration requested a boundary.
  2. Mediated — an Agent-facing path passed through a control point.
  3. Enforced — bypass paths in the stated threat model were blocked.
  4. Attested — enforcement evidence is bound to the exact Run and provider.

A strong guarantee in one dimension does not upgrade another dimension. A staged workspace is not proof of network isolation, and captured traffic is not proof that unobserved sockets were impossible.

The end-to-end chain is:

requested capability
→ admission decision
→ installed mechanism
→ provider evidence
→ observed Effect
→ terminal result
→ configured event-carried history

This final event path is narrower than the Run Bundle: it does not currently publish the complete Artifact, lineage, filesystem Effect, AgentCtl/network/resource Evidence, output, or metrics inventory.

Read Capabilities and evidence for the user model, pVisor isolation design and OverlayNet for mechanisms, and Facts and projections for the history boundary.