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

Sealed V1 private inspection artifact publication and path contract.

A `.ptcins` artifact contains one fixed header, deterministic length-framed
JSON evidence, and one fixed footer. Production writes evidence directly to
a missing-destination reservation as records are emitted; no complete record
list or complete artifact binary is retained. Publication hard-links only a
synchronized, sealed staging file and never replaces an existing path.

Readers pin one opened file, independently admit every frame against its
paired canonical trace, and keep only bounded derived ETS metadata. Queries
read and digest-check the payload ranges required for returned content.

# `seal`

```elixir
@type seal() :: %{
  artifact_digest: binary(),
  file_digest: binary(),
  evidence_bytes: non_neg_integer(),
  record_count: non_neg_integer(),
  total_bytes: pos_integer()
}
```

# `max_artifact_bytes`

```elixir
@spec max_artifact_bytes() :: pos_integer()
```

# `preflight_destination`

```elixir
@spec preflight_destination(term()) :: :ok | {:error, atom()}
```

# `suffix`

```elixir
@spec suffix() :: binary()
```

---

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