From 3423ec0a10b4a2aaa81e425bd805370910b67ddf Mon Sep 17 00:00:00 2001
From: Diego Rodrigues de Sa e Souza
 <8016841+diegosouzapw@users.noreply.github.com>
Date: Tue, 18 Aug 2026 09:10:47 -0300
Subject: [PATCH] docs(env): document OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM
 in .env.example

Documented in docs/reference/ENVIRONMENT.md but missing from .env.example,
caught by the env-doc-sync gate when combined with other PRs in the
release merge-train.
---
 .env.example | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.env.example b/.env.example
index adfad634ad..a4831a6913 100644
--- a/.env.example
+++ b/.env.example
@@ -375,6 +375,11 @@ ALLOW_API_KEY_REVEAL=false
 # is only shed with a retryable 503 when the heap is ALSO under this much pressure — on a
 # healthy heap it is admitted instead. Range (0, 1]. Default 0.75.
 # OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO=0.75
+# Bounded extra capacity for the healthy-heap fast path above OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT
+# (#10437): once this many concurrent leases are active through the healthy-heap bypass,
+# further busy requests fall through to the same bounded-wait/shed path used under real heap
+# pressure. 0 disables the bypass entirely. Default 1.
+# OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM=1
 # Message count that classifies an otherwise small body as heavyweight. Default 200.
 # OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT=200
 # Tool count that classifies an otherwise small body as heavyweight. Default 64.