# `PtcRunner.Kernel.ExecutionOutcome`
[🔗](https://github.com/andreasronge/ptc_runner/blob/main/lib/ptc_runner/kernel/execution_outcome.ex#L1)

Sealed, filesystem-path-free evidence captured at the one-shot execution
boundary.

The outcome freezes the effective result class, result-contract decision,
terminal canonical events, and optional sealed private inspection metadata while the
execution sinks are still live. Publication can therefore run after those
sinks stop without consulting a `PtcRunner.Kernel.RunConfig`, reopening an
execution resource, or re-deriving disclosure authority.

This is an in-VM construction attestation, not a security boundary against
trusted code running in the same VM.

# `inspection`

```elixir
@type inspection() :: :disabled | {:ok, map()} | {:error, :inspection_sink_error}
```

# `publication_evidence`

```elixir
@type publication_evidence() :: %{
  result: result(),
  result_class: result_class(),
  result_contract: result_contract(),
  terminal_batch: terminal_batch(),
  inspection: inspection()
}
```

# `result`

```elixir
@type result() ::
  {:ok, PtcRunner.Kernel.Result.t()} | {:error, PtcRunner.Kernel.Error.t()}
```

# `result_class`

```elixir
@type result_class() :: :normal | :private
```

# `result_contract`

```elixir
@type result_contract() :: :ok | {:error, {:result_contract_failed, map()}}
```

# `t`

```elixir
@opaque t()
```

# `terminal_batch`

```elixir
@type terminal_batch() :: {:ok, [map()]} | {:error, atom()}
```

# `valid?`

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

---

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