httk.workflow.errors

Define exceptions raised by httk.workflow.

Exceptions

WorkflowError	Base class for workflow protocol failures.
ResolutionMiss	A name did not resolve, without indicating malformed configuration.
FormatError	A workspace, job, journal frame, outcome, or request is malformed.
WorkspaceUnavailableError	The workspace cannot currently provide a coherent protocol view.
WorkspaceCorruptionError	The authoritative filesystem state is internally inconsistent.
TransitionLostError	Another actor committed a transition from the expected marker.
UnsupportedExtensionError	A workspace requires an extension this implementation does not support.
TransactionError	A transactional-data manifest cannot be safely replayed.
RunnerResolutionError	A shared runner cannot be resolved, staged, or verified.

Module Contents

exception httk.workflow.errors.WorkflowError

Bases: Exception

Base class for workflow protocol failures.

exception httk.workflow.errors.ResolutionMiss

Bases: ValueError

A name did not resolve, without indicating malformed configuration.

exception httk.workflow.errors.FormatError

Bases: WorkflowError, ValueError

A workspace, job, journal frame, outcome, or request is malformed.

exception httk.workflow.errors.WorkspaceUnavailableError

Bases: WorkflowError

The workspace cannot currently provide a coherent protocol view.

exception httk.workflow.errors.WorkspaceCorruptionError

Bases: WorkflowError

The authoritative filesystem state is internally inconsistent.

exception httk.workflow.errors.TransitionLostError

Bases: WorkflowError

Another actor committed a transition from the expected marker.

exception httk.workflow.errors.UnsupportedExtensionError

Bases: WorkflowError

A workspace requires an extension this implementation does not support.

exception httk.workflow.errors.TransactionError

Bases: WorkflowError

A transactional-data manifest cannot be safely replayed.

exception httk.workflow.errors.RunnerResolutionError(code, message)

Bases: WorkflowError

A shared runner cannot be resolved, staged, or verified.

The failure carries the exact protocol failure code the manager records, so an unresolvable runner (runner_unavailable), a runner whose staged bytes disagree with the digest the job pinned (runner_mismatch), a missing registration (runner_not_built), and a failed foreground build (runner_build_failed) stay distinguishable to an operator.

Parameters:

• code (str) – Protocol failure code recorded by the manager.

• message (str) – Human-readable failure description.

code