> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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}
class EffectState(StrEnum)
```

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](/reference/api/index).
* [Get started](/get-started/quickstart) · [Why](/why).


## Related topics

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