CLI reference / Operations and recovery

CLI reference

Operations and recovery

wiele operation and wiele upload: inspect, cancel and recover server operations.

Pushes, merges and branch creation run as operations on the server. Most people never need these commands: wiele status names the fix for a stuck checkout. Use them when a command prints an operation ID and you want to follow or cancel it.

wiele operation show

Show the state of a push, branch creation or merge.

wiele operation show [flags] <operation>
Argument Description
<operation> Operation ID from a command's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.

wiele operation cancel

Cancel an operation that has not committed yet.

wiele operation cancel [flags] <operation>
Argument Description
<operation> Operation ID from a command's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.
--version integer Required. The operation's current version, from wiele operation show.
--idempotency-key string UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout.

wiele operation incident

Show the recovery state of a blocked publication.

wiele operation incident [flags] <operation>
Argument Description
<operation> Operation ID from a command's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.

wiele operation fence

Request an audited recovery fence for a blocked publication; positive Git observation determines the result.

wiele operation fence [flags] <operation>
Argument Description
<operation> Operation ID from a command's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.
--version integer Required. The operation's current version, from wiele operation show.
--permit-epoch integer Required. Permit epoch, from wiele operation incident.
--permit-admitted-at integer Required. Permit admission time, from wiele operation incident.
--reason string Required. Why you fence, kept in the audit log.
--idempotency-key string UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout.

wiele upload show

Show the verification state of an uploaded file.

wiele upload show [flags] <candidate>
Argument Description
<candidate> Upload candidate ID from an operation's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.

wiele upload retry-verification

Resume budget-paused verification of sealed bytes. Hash mismatches cannot be retried.

wiele upload retry-verification [flags] <candidate>
Argument Description
<candidate> Upload candidate ID from an operation's output.
Flag Description
--workspace string Required. Workspace ID, such as ws_..., from wiele workspace list. This command does not look up names or slugs.
--org string Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use.
--generation integer Required. The candidate's current generation, from wiele upload show.
--reason string Required. Why you retry, kept in the audit log.
--idempotency-key string UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout.