Metadata-Version: 2.4
Name: sheafruntime
Version: 0.1.0a1
Summary: Explicit execution lifecycle state machines with immutable run receipts.
Project-URL: Repository, https://github.com/SheafLab/sheafruntime-python
Author: SheafLab
License: MIT
Keywords: execution,lifecycle,receipts,runtime,sheaflab
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 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.

```python
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.
