# Task State Manager

```{eval-rst}
.. automodule:: ccat_data_transfer.task_state_manager
   :members:
   :undoc-members:
   :show-inheritance:
   :special-members: __init__
```

## Overview

The Task State Manager manages task state transitions and persistence.

## Key Functions

- {py:meth}`~ccat_data_transfer.task_state_manager.TaskStateManager.register_task` - Register a new task in Redis
- {py:meth}`~ccat_data_transfer.task_state_manager.TaskStateManager.update_heartbeat` - Update task heartbeat
- {py:meth}`~ccat_data_transfer.task_state_manager.TaskStateManager.complete_task` - Mark task as completed
- {py:meth}`~ccat_data_transfer.task_state_manager.TaskStateManager.fail_task` - Mark task as failed
- {py:meth}`~ccat_data_transfer.task_state_manager.TaskStateManager.get_stalled_tasks` - Find tasks with expired heartbeats

## Related Documentation

- {doc}`../../philosophy` - System design principles
- {doc}`../../monitoring` - System monitoring and observability
- {doc}`../tasks/index` - Celery tasks documentation