# `GEPA.Telemetry`
[🔗](https://github.com/nshkrdotcom/gepa_ex/blob/v0.3.0/lib/gepa/telemetry.ex#L1)

Telemetry helpers for GEPA.

Provides a stable event schema for lifecycle, iteration, proposal, and
evaluation events. This keeps GEPA free of tracker-specific code while
allowing external handlers to attach and forward to W&B, MLflow, etc.

# `emit_baseline`

```elixir
@spec emit_baseline(GEPA.EvaluationBatch.t(), non_neg_integer()) :: :ok
```

Emit baseline evaluation for the seed program.

# `emit_evaluation_batch`

```elixir
@spec emit_evaluation_batch(
  non_neg_integer(),
  :train | :val,
  non_neg_integer(),
  integer(),
  [number()],
  non_neg_integer() | nil,
  String.t() | nil
) :: :ok
```

Emit evaluation batch event (train or val).

# `emit_iteration_start`

```elixir
@spec emit_iteration_start(non_neg_integer(), term()) :: :ok
```

Emit iteration start.

# `emit_iteration_stop`

```elixir
@spec emit_iteration_stop(
  GEPA.State.t(),
  non_neg_integer(),
  number(),
  boolean(),
  float(),
  float(),
  term(),
  [term()] | nil,
  [term()] | nil,
  integer()
) :: :ok
```

Emit iteration stop with performance metrics.

# `emit_proposal_decision`

```elixir
@spec emit_proposal_decision(
  GEPA.CandidateProposal.t() | nil,
  non_neg_integer(),
  boolean(),
  atom(),
  float(),
  [term()] | nil
) :: :ok
```

Emit proposal decision (accepted/rejected).

# `emit_proposal_generated`

```elixir
@spec emit_proposal_generated(GEPA.CandidateProposal.t(), non_neg_integer()) :: :ok
```

Emit proposal generation details.

# `emit_run_start`

```elixir
@spec emit_run_start(map()) :: :ok
```

Emit run start with sanitized config and schema version.

# `emit_run_stop`

```elixir
@spec emit_run_stop(GEPA.State.t(), integer()) :: :ok
```

Emit run stop summary.

# `emit_valset_update`

```elixir
@spec emit_valset_update(
  GEPA.State.t(),
  non_neg_integer(),
  non_neg_integer(),
  map()
) :: :ok
```

Emit valset update after accepting a program.

# `schema_version`

```elixir
@spec schema_version() :: String.t()
```

Schema version for telemetry metadata.

---

*Consult [api-reference.md](api-reference.md) for complete listing*