benchmark-readme-sync

name	benchmark-readme-sync
description	Use when a user wants to refresh benchmark results in `README.md` from the latest successful GitHub Actions `Benchmark` workflow run for the current repository. Use a robust `gh` and shell workflow to find the newest successful run, extract final Markdown tables from job logs, and update the README run URL, date, versions, and tables.

Benchmark README Sync

When to use

• Update README.md benchmark results from GitHub Actions.
• Replace stale benchmark tables, versions, run links, or dates.
• The user does not need to provide an Actions URL.

Workflow

1. Read README.md and .github/workflows/benchmark.yml to confirm the benchmark cases and the current results layout.
2. Resolve the canonical GitHub repository and default branch with gh repo view, then find the latest successful Benchmark workflow run on that branch unless the user gave a specific run ID.
3. List the jobs for that run and map each matrix case to its job ID before touching README.md.
4. For each case job, extract only the final benchmark tables from the log using the robust shell pipeline below.
5. Update README.md carefully:
   • Replace the GitHub Actions run URL with the latest run URL.
   • Replace the date with today's local date.
   • Replace each case table with the extracted table from the matching job.
   • Preserve the case heading, prose, command block, and the final --- separator before ## Run locally.
   • Do not recalculate rankings or rewrite the numbers manually.
6. Validation is required after the edit:
   • Every case in the workflow matrix is represented in README.md.