docs(bug-history): BUG-1498 investigating — gate flake in daily starlanguage snapshot test

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/BUG_HISTORY.md

@@ -20462,3 +20462,19 @@
 - 关联：BUG-1136。
 - 复发自：无。
 - 修复版本：分支 `codex/rectification-recap-date-dup-20261028`。
+
+## BUG-1498 | staging 门禁 Python 快速门偶发失败：`test_daily_starlanguage_does_not_eat_yesterday_cache` 网关调用 0 次
+
+- 状态：investigating（只记录已确认事实与假设；未改代码）
+- 首次发现 / 最近更新：2026-10-28（BUG-1481 验证段首次提到）/ 2026-10-28（staging 门禁 run 2017）
+- 影响面：只影响 CI 门禁，不影响线上。`tests/test_vedastro_snapshot_cache.py::test_daily_starlanguage_does_not_eat_yesterday_cache`。
+- 现象：`assert calls["gateway"] == 1` 得到 `0 == 1`；同一轮其余 1094 项通过。run 2016（同一份 Python 代码）这一项通过；本机单独连跑 5 次全部通过。
+- 触发条件：整套快速门一起跑时偶发，单独跑不出现，跟测试先后顺序或机器负载有关。
+- 已排除：BUG-1481 当时认为是测试之间共用负缓存目录；`tests/conftest.py::_isolate_vedastro_snapshot_cache` 现在每个测试都另建快照目录和负缓存目录，这次复发不是那个原因。
+- 假设（未证实）：`scripts/vedastro_foreground.py` 的 `_FOREGROUND_VEDASTRO_EXECUTOR` 是模块级线程池，整个 pytest 进程共用，conftest 不清空它。前面的测试如果留下还在跑的任务占满线程，本测试的任务排在后面，前台 1.5 秒等待到期后被取消，网关一次都没调用。
+- 修复：未修。下一步：在 conftest 里每个测试后排空或重建这个线程池，或者本测试把等待时间设大，再在全套顺序下复跑确认。
+- 验证：未完成。
+- 防复发：未完成。
+- 关联：BUG-1481（第一次记录这个失败）。
+- 复发自：BUG-1481 记下的同一项失败。当时的处理（隔离负缓存目录）没拦住，因为根因很可能不在目录上。
+- 修复版本：无。