@agent-os/deploy
Purpose
Section titled “Purpose”Provider-neutral deploy proof and projection carrier.
Invariant
Section titled “Invariant”Deploy facts record symbolic preview, promotion, readback, and rollback proofs.
previewRef, deployRef, productionRef, readbackRef, and rollbackRef
are opaque symbolic refs, not provider URLs or handles. Provider response
bodies, live URLs, account IDs, route IDs, and deploy handles stay outside
ledger payloads and are recovered through resolver/materializer composition.
Minimal Usage
Section titled “Minimal Usage”Use deploy events and settlement helpers to anchor deployment facts. Keep
provider API calls in a backend package or app-owned execution layer.
Resolve a productionRef to a URL outside the deploy ledger projection.
Verification
Section titled “Verification”cd packages/carriers/deployvp test run