sheafruntime 0.1.0a1

Explicit execution lifecycle state machines with immutable run receipts.

sheafruntime

sheafruntime is a dependency-free lifecycle core for a bounded sequence of execution stages. It does not run arbitrary work itself. Instead, it makes stage transitions explicit, prevents invalid ordering, and records a compact, immutable receipt for inspection or persistence.

from sheafruntime import Runtime

run = Runtime("image-ingest", ("fetch", "decode", "store"))
run.start("fetch")
run.succeed("fetch", output="sha256:abc")

run.start("decode")
run.succeed("decode")

assert run.receipt().completed == ("fetch", "decode")

Only the next pending stage may start. A started stage may succeed or fail; once a run fails, no subsequent state transition is permitted. This makes the library suitable as a small control boundary around workers, agent actions, or pipeline adapters without introducing a scheduler or framework.