Skip to content

Security claim ledger

This ledger is the docs-facing rule for strong claims. A page can describe a behavior as a product guarantee only when the relevant row is Shipped and links to implementation evidence.

For sandbox-parity claims, the detailed status table lives in Sandbox parity status. This page adds the docs relaunch-specific claims around mvm, SDKs, Nix, OCI, and tutorials.

ClaimStatusEvidence required before stronger language
mvm-runtime-boundaryShippedArchitecture docs and code paths show local runtime ownership of backend launch, guest protocol, builder VM dispatch, signed plan admission, and local audit.
decorator-sdk-static-compilePreviewStatic compile docs and tests prove declarations can emit Workload IR without importing user modules for supported syntax.
runtime-sdk-lifecyclePlannedPython, TypeScript, and Rust lifecycle APIs pass shared create/exec/files/logs/snapshot/stop tests.
secure-sandbox-product-parityPlannedPlan 114 tracks parity capability by capability without copying another product’s runtime architecture.
builder-vm-secure-buildsShippedBuilder VM documents host-orchestrated Linux builds; source-checkout cache reuse and bootstrap policy are covered by current CLI behavior.
persistent-builder-dxPreviewLow-level persistent-builder controls and build routing exist; top-level cargo run -- dev up and cargo run -- build docs must match the actual command behavior before this becomes Shipped.
cold-mode-snapshot-recoveryPreviewFirecracker sealed pause/resume, Vz save/restore, and pool Sleeping/Running paths exist, but docs must name backend support and restore semantics.
platform-linux-macosShippedLocal docs name Linux execution and macOS as the supported targets and keep Windows in the future/issue-tracked bucket.
platform-windowsPlannedWindows docs link mvm#428 and avoid implying shipped local runtime support.
nix-first-auditabilityPreviewBuilder VM docs, flake pinning docs, artifact provenance, and signed plan admission are linked from the guide.
oci-compatibilityPreviewOCI pull/materialization commands, digest verification, mutable-tag policy, cache isolation, and audit events are documented and tested.
secure-agent-tutorialsPlannedAgent, LLM, browser, file, and service tutorials name network, secret, filesystem, persistence, and audit boundaries.
  • If a claim is Planned, examples may describe the intended shape but must label it Planned.
  • If a claim is Preview, examples must name backend, platform, or feature limitations.
  • If a claim is Shipped, examples must link to CLI, SDK, test, or ADR evidence.
  • Pages should avoid broad security language when a narrower statement is more accurate.

The docs lint already gates a small set of high-risk phrases for OCI, secret, and latency claims. New pages should avoid introducing equivalent language without adding a gate.

Examples of safer wording:

AvoidPrefer
”Run every registry image without limits""Run supported OCI inputs after digest resolution and verification."
"Secrets are impossible to leak""Secret references are designed to keep plaintext out of default guest-facing paths when the managed-ref flow ships."
"Instant boot""Measured boot and readiness numbers are published per backend and artifact.”

Tutorials and SDK pages should link to at least one of: