httk.workflow.errors¶

Define exceptions raised by httk.workflow.

Exceptions¶

`SealedError`	An action was refused because the subject, or its enclosure, is sealed.
`SealError`	A seal cannot be written or verified.
`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 or verified.

Module Contents¶

exception httk.workflow.errors.SealedError¶

Bases: RuntimeError

An action was refused because the subject, or its enclosure, is sealed.

Changing a project’s members while the project is sealed is refused rather than silently allowed: a seal a project commits to must not change beneath it.

exception httk.workflow.errors.SealError¶

Bases: RuntimeError

A seal cannot be written or verified.

This is the cannot proceed failure: no signing key is available, or a member a project seal must cover is itself unsealed or has no handler. It never means an action was refused because something was already sealed; that is SealedError.

exception httk.workflow.errors.WorkflowError¶

Bases: RuntimeError

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 or verified.

The failure carries the exact protocol failure code the manager records, so an unresolvable runner (runner_unavailable), a runner whose 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¶