@spec capture_output() :: String.t()

Captures compile + test warning output for inventory and ratchet checks.

Runs in capture mode (no WAE) so warnings can be measured even when the suite fails.

@spec classify([map()]) :: [map()]

Classifies parsed warning maps with cluster, lane, and ratchet metadata.

@spec cleanup_transient_tmp!() :: :ok

Removes transient entries under test/tmp/ after ratchet capture (not the directory itself).

@spec cluster_counts([map()]) :: %{required(atom()) => non_neg_integer()}

Summarizes classified rows by cluster id count.

@spec dedupe_key(map(), atom()) :: {atom(), String.t(), String.t()}

Builds a stable dedupe key for inventory rows.

@spec ensure_clean_tmp!() :: :ok

Ensures test/tmp/ is empty before warning inventory or ratchet capture runs.

@spec join_baseline(
  [map()],
  keyword()
) :: [map()]

Joins baseline owner/expiry metadata onto classified rows by surface name.

@spec lane_ids_for_file(String.t()) :: [atom()]

Returns lane ids associated with a file path.

@spec parse_output(String.t()) :: [map()]

Parses captured mix output into warning maps.

@spec ratchet_tier(atom()) :: atom()

Maps cluster ids to Phase 67 ratchet ordering tiers.