From ba623c67e6e8ad1d65b204f5842ffe0918763aba Mon Sep 17 00:00:00 2001
From: AAA <35992542+TNTcraftHIM@users.noreply.github.com>
Date: Sun, 23 Aug 2026 02:47:21 +0800
Subject: [PATCH] docs(media): bound H264 diagnostic evidence (#206)

---
 docs/research/realtime-quality-adaptation.md | 35 ++++++++++++--------
 1 file changed, 21 insertions(+), 14 deletions(-)

diff --git a/docs/research/realtime-quality-adaptation.md b/docs/research/realtime-quality-adaptation.md
index 491f313..c939d67 100644
--- a/docs/research/realtime-quality-adaptation.md
+++ b/docs/research/realtime-quality-adaptation.md
@@ -220,20 +220,27 @@ does not prove shared encode: separate browser PeerConnections may construct
 separate encoders, and the SFU still publishes only the configured `q,h`
 representations.
 
-The retained diagnostic keeps lifecycle and codec experiments orthogonal.
-Lifecycle runs fix `automatic`; each independently recreated affected state runs
-exactly one of observe, preview cycle, Host-peer rebuild, capture replacement,
-or Host reload. Codec A/B uses fresh Host/share/PeerConnection sessions for
-automatic, H.264, and VP8 and rejects an actual-codec mismatch. Quality claims
-require a headed run with the same real game, browser/driver, capture surface,
-and one wired direct Viewer. Capture A, sender B, and Viewer C samples must share
-the current generation and overlapping windows; identity polling must not
-advance their accumulators. Record actual codec/profile, configured/source/send/
-receive FPS, interval encoded frames/encode time, limitation reason, game FPS,
-and process-scoped GPU evidence. Missing implementation or power-efficiency
-fields remain unknown. No H.264 root cause or policy change is accepted until
-the controlled sample distinguishes capture starvation, software fallback,
-hardware queue/driver pressure, and congestion.
+The repository diagnostic is a mechanical single-machine preflight, not a
+quality runner. Lifecycle runs fix `automatic`; each fresh run performs exactly
+one of observe, preview cycle, Host-peer rebuild, capture replacement, or Host
+reload, keeps the actual codec/profile/parameters stable across that action, and
+rechecks the action budget after its two current-generation evidence windows.
+Codec preflight uses fresh Host/share/PeerConnection sessions for automatic,
+H.264, and VP8 and rejects an actual-codec mismatch. Reports retain only
+allowlisted failure stages and sanitized identifiers.
+
+Quality diagnosis remains a separately orchestrated headed matrix with the same
+real game, browser/driver, capture surface, and one external wired direct Viewer;
+the local loopback preflight cannot satisfy it. Capture A, sender B, and Viewer C
+samples must share the current generation and overlapping windows; identity
+polling must not advance their accumulators. Record actual codec/profile,
+configured/source/send/receive FPS, interval encoded frames/encode time,
+limitation reason, game FPS, and process-scoped GPU evidence. Missing
+implementation or power-efficiency fields remain unknown. Add a remote runner
+adapter only when that matrix has a current automated consumer. No H.264 root
+cause or policy change is accepted until the controlled sample distinguishes
+capture starvation, software fallback, hardware queue/driver pressure, and
+congestion.
 
 Open-source distribution is not itself a patent-license exemption. This Web
 change only requests a codec already implemented by the browser/LiveKit path and