> ## Documentation Index
> Fetch the complete documentation index at: https://ctrlrun.dev/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).


## Related topics

- [Python API](/docs/reference/api/index.md)
- [StateStore](/docs/reference/api/StateStore.md)
- [SQLiteStateStore](/docs/reference/api/SQLiteStateStore.md)
- [PostgresStateStore](/docs/reference/api/postgres-PostgresStateStore.md)
- [EffectRecord](/docs/reference/api/EffectRecord.md)