Chio/Docs
LOGIN · JOIN

chio recovery

Inspect a recovery workflow, read its signed explanation, and resume it after approval, with unknown outcomes never dispatched again.

Reference chio@5f63e6e

On this page

All command families · Global flags

chio recovery

Inspect, explain, and resume recovery workflows.

Command synopsistext
chio recovery [OPTIONS] <COMMAND>
  • chio recovery inspect Read a recovery workflow’s state and its exact preview under current approval authority.
  • chio recovery explain Read the signed, audience-safe explanation of a recovery workflow and the offers it carries.
  • chio recovery resume Resume a workflow after its approval; the kernel rechecks current facts before dispatch.

chio recovery inspect

Read a recovery workflow’s state and its exact preview under current approval authority.

Command synopsistext
chio recovery inspect [OPTIONS] --capability <CAPABILITY> --workflow-id <WORKFLOW_ID>
  • --endpoint <ENDPOINT> Recovery host endpoint: an https:// URL for a remote host, or unix:///path/to/host.sock for a process host on this machine. Exactly one of --endpoint and --state is required.
  • --state <STATE> Process host state directory; the endpoint is the host socket recorded there.
  • --capability <CAPABILITY> Capability token file that authorizes this operation. Required.
  • --workflow-id <WORKFLOW_ID> Recovery workflow identifier. Required.
Additional behavior

States include WaitingForApproval, WaitingForOutcome, CompletedWithEffects, CommitUnknown, and ReconciliationRequired.

chio recovery explain

Read the signed, audience-safe explanation of a recovery workflow and the offers it carries.

Command synopsistext
chio recovery explain [OPTIONS] --capability <CAPABILITY> --workflow-id <WORKFLOW_ID>
  • --endpoint <ENDPOINT> Recovery host endpoint: an https:// URL for a remote host, or unix:///path/to/host.sock for a process host on this machine. Exactly one of --endpoint and --state is required.
  • --state <STATE> Process host state directory; the endpoint is the host socket recorded there.
  • --capability <CAPABILITY> Capability token file that authorizes this operation. Required.
  • --workflow-id <WORKFLOW_ID> Recovery workflow identifier. Required.

chio recovery resume

Resume a workflow after its approval; the kernel rechecks current facts before dispatch.

Command synopsistext
chio recovery resume [OPTIONS] --capability <CAPABILITY> --workflow-id <WORKFLOW_ID>
  • --endpoint <ENDPOINT> Recovery host endpoint: an https:// URL for a remote host, or unix:///path/to/host.sock for a process host on this machine. Exactly one of --endpoint and --state is required.
  • --state <STATE> Process host state directory; the endpoint is the host socket recorded there.
  • --capability <CAPABILITY> Capability token file that authorizes this operation. Required.
  • --workflow-id <WORKFLOW_ID> Recovery workflow identifier. Required.
Additional behavior

An unknown outcome stays unknown until it is resolved and is never dispatched again.

Read more in Recover an operation.

PreviousCLI task index