# `Minga.Extension.Diagnostics`
[🔗](https://github.com/jsmestad/minga/blob/main/sdk/lib/minga/extension/diagnostics.ex#L1)

Sanctioned diagnostics surface for extensions.

Publish line-level findings (linters, analyzers, advisory agents) through
Minga's diagnostics pipeline (gutter signs, hover, navigation, picker)
without importing core internals. Findings are namespaced under the
extension's own source and clamped to `:hint` severity; they render as a
distinct amber `?` sign so users don't confuse advice with compiler output.

`uri` accepts either a `file://` URI or an absolute path.

This is a compile-time stub. At runtime, the real module in Minga's BEAM
VM provides the implementation.

# `finding`

```elixir
@type finding() :: %{line: non_neg_integer(), concern: String.t()}
```

A line-level finding: a zero-indexed `line` and the `concern` text to show.

# `clear`

```elixir
@spec clear(atom(), String.t()) :: :ok
```

# `clear_all`

```elixir
@spec clear_all(atom()) :: :ok
```

# `publish`

```elixir
@spec publish(atom(), String.t(), [finding()]) :: :ok
```

---

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