> ## Documentation Index
> Fetch the complete documentation index at: https://ctrlrun-docs-python-3-13-3-14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EffectState

> Where a logical effect stands (SPEC-v0.1 §5.2).

`ctrlrun.EffectState` — class, defined at `src/ctrlrun/effect.py:74`

```python theme={null}
from ctrlrun import EffectState
```

```python theme={null}
class EffectState(StrEnum)
    NEW
    RESERVED
    EXECUTING
    COMMITTED
    FAILED
    AMBIGUOUS
```

Where a logical effect stands (SPEC-v0.1 §5.2).

`NEW` is the state of a key nobody has reserved: it is never written to a store, which
reports it as no record at all. `AMBIGUOUS` never collapses to `FAILED`; only a human
moves a record out of it.

## Next

* [Python API index](/docs/reference/api/index).
* [Get started](/docs/get-started/quickstart) · [Why](/docs/why).