# Supervisor

Supervisor orchestrates digital worker execution with structured workflow management, step tracking, and telemetry.

## What It Does

- Tracks workflow steps and outcomes
- Generates run reports for debugging/auditing
- Streams status updates to Fabric/Empower
- Exports telemetry to observability backends

## Key Components

| Component | Description | Source |
|-----------|-------------|--------|
| `supervise()` | Main workflow context manager | [default_instances.py](default_instances.py) |
| `@step` | Step decorator for functions | [step_decorator_factory.py](step_decorator_factory.py) |
| `step_scope()` | Step context manager | [step_context.py](step_context.py) |
| `set_*_status()` | Status override functions | [default_instances.py](default_instances.py) |

## Telemetry

Supervisor integrates with [t_obs](https://pypi.org/project/t-obs/) for OpenTelemetry-based observability.

See [Telemetry Documentation](telemetry/README.md) for architecture details.

## Manifest

Workflows are defined in `manifest.yaml`. See [manifest.py](manifest.py) for the schema.
