Skip to content

Site Hosting Protocol

Stages and atomically manages immutable Site deployments through exact host-selected targets.

Site Hosting Protocol

Stages and atomically manages immutable Site deployments through exact host-selected targets.

FieldValue
Protocol IDaster.site-hosting
Version1.0.0
Compatibility range^1.0.0
Requirement helperaster.site-hosting.require(settings?) via the protocol module
Provider helperAvailable through Protocol.provide(...).

Settings

DefaultProtocolSettingsSchema (Record<string, unknown> | null).

Operations

OperationSummaryRequestResponse
validateValidate one exact provider target without selecting it.Effect Schema (Objects)Effect Schema (Objects)
stageStage one exact immutable SiteVersion bundle.Effect Schema (Objects)Effect Schema (Objects)
publishPolicyPublish one host-selected access-policy generation.Effect Schema (Objects)Effect Schema (Objects)
activateActivate one exact staged version and routing generation.Effect Schema (Objects)Effect Schema (Objects)
inspectInspect observed deployment health and exact generations.Effect Schema (Objects)Effect Schema (Objects)
rollbackRoll back to one exact host-selected staged version.Effect Schema (Objects)Effect Schema (Objects)
suspendSuspend ingress for one exact routing generation.Effect Schema (Objects)Effect Schema (Objects)
destroyDestroy one exact provider deployment.Effect Schema (Objects)Effect Schema (Objects)

Conformance Expectations

  • Register with aster.site-hosting at 1.0.0 inside ^1.0.0.
  • Implement every operation: validate, stage, publishPolicy, activate, inspect, rollback, suspend, destroy.
  • Decode requests and responses against the operation schemas listed above.
  • Run the protocol conformance kit where one exists: No named kit yet; providers are still expected to satisfy the registry schemas..

Declared Authority

[
{
"kind": "network",
"hosts": [
"*"
]
},
{
"kind": "secret",
"scope": "site-hosting"
},
{
"kind": "provider_right",
"protocol": "aster.site-hosting"
}
]