# `Insider.Finding`
[🔗](https://github.com/hiivemarkets/insider/blob/v0.1.0/lib/insider/finding.ex#L1)

A bounded detector-neutral finding with statically validated details.

Detector names remain strings at the trust boundary. Support is selected by
literal detector/version clauses; external data never selects a module or
creates an atom.

# `t`

```elixir
@type t() :: %Insider.Finding{
  confidence: term(),
  details: term(),
  detector: term(),
  detector_version: term(),
  evidence_event_ids: term(),
  fingerprint: term(),
  occurred_at_us: term(),
  schema: term(),
  severity: term(),
  trigger_event_id: term()
}
```

# `decode_map`

```elixir
@spec decode_map(term()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
```

# `evidence_event_fingerprint`

```elixir
@spec evidence_event_fingerprint(Insider.Event.t() | map()) ::
  {:ok, String.t()} | {:error, Insider.Protocol.Error.t()}
```

Returns the canonical digest that binds one exact evidence event to a finding.

# `new`

```elixir
@spec new(keyword()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
```

# `new!`

```elixir
@spec new!(keyword()) :: t()
```

# `to_wire_map`

```elixir
@spec to_wire_map(t()) :: map()
```

# `valid_wire?`

```elixir
@spec valid_wire?(term()) :: boolean()
```

# `validate`

```elixir
@spec validate(term()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
```

---

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