v0.34.0_1

scripts/performance/README.md

@@ -6,6 +6,26 @@ controllable test **upstream**, used to verify streaming, non-replayable writes,
 headers, cache policy and WebSocket frames. Performance measurements use nginx
 as the shared upstream instead of Python.
 
+## Reverse-proxy optimization revision 0.34.0
+
+After compiling the refreshed candidate, measure the same unmodified 0.33.8
+binary and nginx reference as before, without turning off logging, request
+IDs, ACL, cache-policy enforcement or LB health. Profile request-size 1,040 B
+first. Before RPS runs execute full proxy, LB, transport and concurrency
+regressions (including single-member capacity, recovery, sticky cookies,
+replays on safe methods, rejected non-replayable writes and H2 connection
+shutdown). Treat `--max-idle` tuning and recycles as separately labelled
+experiments rather than mixing them into the primary comparison. There are no
+new measured RPS figures in the source candidate.
+
+## Offline cache-retention model for 0.34.0
+
+`python3 scripts/performance/simulate_cache_034.py` compares cache invalidation
+policies under a deterministic synthetic sequence of vhost saves and uniform
+cacheable GETs. The model contains **no RustProxy server**, no timing and no
+network traffic; its percentages are **not measured RPS gains**. See
+`docs/TEST_REPORT_0.34.0.md` for assumptions and the live acceptance gap.
+
 ## Requirements
 
 - Linux with readable `/proc`, Python 3.10+, executable RustProxy binaries.
@@ -274,3 +294,16 @@ are not presented as proven server-side cancellations.
 Memory trend is descriptive: switching caching and allocator retention affect
 RSS. This is a 30-minute resource gate, not a 24-hour leak proof. A short
 `--exploratory --duration ...` sanity run stays explicitly outside that gate.
+
+## 0.34.0 hypothesis-only sendfile/nginx gap simulator
+
+```bash
+python3 scripts/performance/simulate_nginx_gap_034.py --output /tmp/nginx-gap.json
+```
+
+This is **not** a benchmark of RustProxy 0.34.0. It reproduces measured
+0.33.8/nginx medians with cache OFF and applies explicitly hypothetical
+Amdahl service-time reductions (WWW and reverse proxy separately). A real
+RustProxy binary is required to validate the code path, detect regressions
+and measure latency/RPS against nginx under identical conditions.
+