Published September 20, 2026 | Version 1.0

Performance Assurance in Pull-Request CI: An Operational Method and Evaluation Framework

Authors/Creators

  • 1. Independent Researcher

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

Files (627.2 kB)

Name Size
md5:93a1f8bfe0d720533321031b96022c33
27.6 kB Preview Download
md5:4b155c81b44784be588b4757f1dae0e4
599.7 kB Preview Download

Additional details

Dates

Submitted
2026-09-20