perf-baseline-manager

Store one baseline JSON per version at {state-dir}/perf/baselines/<version>.json to prevent baseline drift across environments and releases.

Compare performance across versions by loading stored baseline JSON files and analyzing recorded metrics alongside environment metadata to identify regressions or improvements.

Record environment metadata alongside metrics within the versioned baseline JSON to support reproducibility and auditing during performance benchmarking across test environments.

Apply this baseline management to performance testing pipelines where baselines are generated, stored, and automatically compared across versions and environments.

Baseline drift happens when multiple unmanaged baseline files exist for a release; prevent it by enforcing one versioned baseline JSON per version in a dedicated state directory.