What problem does it solve?
It refreshes failing or stale golden test artifacts from a specified GitHub Actions workflow run and quantifies how much the updated goldens differ from what is currently checked into the repository.
Core Features & Use Cases
- Golden value refresh from workflow artifacts: Downloads and overwrites golden value JSON files produced by a given workflow run, with optional scope limited to failing/cancelled jobs.
- Per-metric relative-difference scoring: Computes a per-(file, metric) average normalized relative difference (avg_rel_diff) over shared steps and ranks changes by magnitude using absolute relative diff.
- PR-ready narrative output: Produces a structured summary that can be pasted into a pull request description, highlighting the metrics and buckets with the largest movement.
Quick Start
Run the update for a workflow run ID by refreshing only failing goldens, then paste the generated summary into your PR description: set the GitHub token via your authenticated gh CLI and execute the download and comparison flow using the workflow run ID you provide.