0.29.7

docs/CACHE_DIAGNOSTICS.md

@@ -3,6 +3,24 @@
 This describes implemented source, not a verified Rust runtime. See
 [TEST_REPORT.md](TEST_REPORT.md).
 
+## 0.29.7: show diagnostic headers only on cache HIT
+
+Set `cache.expose_only_hits: true` globally (Settings > Cache) to emit
+`X-Cache`, `X-Cache-Hits`, `X-Cache-Reason`, `Cache-Status` and
+`X-Cache-Resident-Age` only when the response is actually served from
+RustProxy cache. MISS and BYPASS continue to be recorded in internal metrics
+and access logs but these diagnostic headers are absent from those responses.
+Cached stale/revalidated/range/conditional responses use the HIT outcome and
+continue to show cache diagnostics. Individual vhosts can override the global
+flag with `vhosts[].cache.expose_only_hits: true | false | null` (`null`
+inherits). Changing the flag alone does not purge cached objects.
+
+The independent `Via` proxy-chain header can still appear on MISS/BYPASS when
+`cache.via_header` is configured. Set it to `null` to turn off that header.
+Existing `expose_status`, `expose_hits`, `expose_cache_status` and
+`expose_resident_age` switches still select which individual HIT headers are
+emitted.
+
 ## 0.19.1 cache identity safety
 
 The frontend scheme is part of the primary cache identity. `http://host/path` and