Performance Assurance in Pull-Request CI: An Operational Method and Evaluation Framework
Description
Software can remain functionally correct while becoming slower, more memory-intensive, or more expensive to operate. This paper considers the narrow problem of evaluating an individual change early enough to inform a pull-request decision. It specializes established Performance Assurance practice by connecting versioned workloads and data, controlled measurement, reference selection, comparability, effect estimation, minimum effects of interest (MEIs), and CI policy. It documents Perfgate 0.1.0, a Ruby gem that compares independent samples with a historical stored baseline, uses deterministic bootstrap intervals for differences in medians, and separates evidence from advisory-by-default policy. A frozen case study completed 126 comparisons for one Rails application on GitHub-hosted workers. Among 30 A/A comparisons, no regression FAIL occurred. At metric level, 598 of 600 decisions were PASS and two were INCONCLUSIVE. Cross-worker compatibility reservations caused 28 otherwise passing comparisons to be reported as overall WARN. The 95% Wilson upper bound for the false-FAIL proportion was 11.4%. All 96 comparisons containing one of eight fixed source regressions produced FAIL evidence, but their unknown, nonrandomized effect sizes make this a detection result rather than a power estimate at an MEI. Two of 63 preassigned rerun pairs reversed between WARN and INCONCLUSIVE. The study did not evaluate same-worker blocks, paired estimation, application-level interval coverage, or direct merge blocking.
Technical info (English)
The checksum-verified calibration artifact reported in this paper is publicly available as Perfgate Micropost Calibration v1: https://github.com/a11ejandro/perfgate-evaluation/releases/tag/perfgate-micropost-calibration-v1
Archive SHA-256: 9fe7b797ba95075a740e71691b7e0dcd26b0f4bfcef867cd11fa468f4101c1f4
The artifact contains the frozen calibration plan, configuration, schemas, 252 raw arm bundles, 126 comparison evidence documents, normalized tables, audits, simulations, analysis, checksums, and pinned source snapshots. The reported study is descriptive calibration rather than held-out validation and does not establish fitness for direct merge blocking.
Files
performance-assurance-in-pull-request-ci-v1.0-source.zip
Additional details
Related works
- Documents
- Software: https://github.com/a11ejandro/perfgate/tree/405dfb42265d96890302d7a719f384c050983ec5 (URL)
- Is supplemented by
- Dataset: https://github.com/a11ejandro/perfgate-evaluation/releases/tag/perfgate-micropost-calibration-v1 (URL)
Dates
- Submitted
-
2026-09-20