Bounded, portable provenance for incident evidence.
Provenance has five fixed components: code, configuration, dependencies,
runtime, and target. Callers describe each component as {:available, map},
{:unavailable, reason}, or {:redacted, policy_fingerprint}. Available
attributes must already be safe to export; this module bounds and fingerprints
them but does not turn a digest into redaction.
capture/1 collects stable, low-risk BEAM runtime and target facts. It never
shells out, reads the working tree, walks loaded applications, or captures
environment variables. Build systems may explicitly supply sanitized code,
dependency, and configuration facts.
Summary
Functions
Captures stable public runtime and machine-class facts.
Constructs provenance from exactly one descriptor for every v1 component.
Types
Functions
@spec canonical_binary(term()) :: {:ok, binary()} | {:error, Insider.Protocol.Error.t()}
@spec capture(keyword()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
Captures stable public runtime and machine-class facts.
Omitted build-controlled components remain explicitly unavailable. Supplying
:runtime is intentionally unsupported here; use new/1 for decoding,
fixtures, or another trusted collector.
@spec decode_map(term()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
@spec new(keyword()) :: {:ok, t()} | {:error, Insider.Protocol.Error.t()}
Constructs provenance from exactly one descriptor for every v1 component.