# `SquidSonar.Runs`
[🔗](https://github.com/ccarvalho-eng/squid_sonar/blob/main/lib/squid_sonar/runs.ex#L1)

Read boundary for Squid Mesh workflow runs.

LiveViews should call this module instead of calling `SquidMesh` directly.
That keeps runtime access, error handling, and view shaping in one place.

# `option`

```elixir
@type option() :: {:client, module()} | {:squid_mesh, keyword()}
```

# `get_run`

```elixir
@spec get_run(term(), [option()]) ::
  {:ok, SquidSonar.Runs.RunDetail.t()} | {:error, term()}
```

Fetches one run with history and diagnostic explanation.

# `list_runs`

```elixir
@spec list_runs(
  keyword(),
  [option()]
) :: {:ok, [SquidSonar.Runs.RunSummary.t()]} | {:error, term()}
```

Lists recent runs as UI-friendly summaries.

---

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