Files
PolyGateway/research-wiki/log.md
T
iomgaa e7caa500e2 docs: plan the telemetry pool lifecycle rework for issue 15
The design traces the incident to four stacked defects rather than one bad
default: the pool is the only resource in the library that pre-allocates,
the kill switch keys off which step failed instead of what failed, the
degraded state can neither recover nor be observed, and the ownership rules
make the sanctioned sharing path unusable.

The plan sequences the tracker ahead of the pool and failure work so every
commit stays green, and records two facts the implementer needs up front:
the pool-construction path has zero test coverage today, and the commit
gate runs the full suite plus a complexity ceiling.
2026-08-24 08:17:37 -04:00

12 KiB

Wiki 变更日志

  • [2026-07-20 09:55 UTC] Wiki 初始化完成
  • [2026-07-20 09:55 UTC] 重建索引: 2 篇页面
  • [2026-07-20 10:18 UTC] 新增 plan: M1 核心里程碑实现计划 (plan:m1-core-plan)
  • [2026-07-20 10:18 UTC] 新增边: plan:m1-core-plan --implements--> design:m1-core-design
  • [2026-07-20 10:18 UTC] 重建索引: 4 篇页面
  • [2026-07-20 11:11 UTC] 新增 schema: 表结构: llm_calls(遥测 18 字段) (schema:llm-calls)
  • [2026-07-20 11:11 UTC] 新增 metric: 每次调用必录覆盖率(含缓存命中/失败/取消) (metric:call-telemetry-coverage)
  • [2026-07-20 11:11 UTC] 新增边: metric:call-telemetry-coverage --measures--> schema:llm-calls
  • [2026-07-20 11:11 UTC] 新增边: schema:llm-calls --implements--> design:m1-core-design
  • [2026-07-20 11:11 UTC] 重建索引: 6 篇页面
  • [2026-07-21 02:27 UTC] 新增 finding: M2 真实数据压测: 场景矩阵与数据清单 (finding:m2-soak-workload)
  • [2026-07-21 02:27 UTC] 重建索引: 8 篇页面
  • [2026-07-21 02:59 UTC] 新增 design: M2 分布式:Redis 治理后端+背压+Postgres 遥测+pricing+Embedding+压测 harness (design:m2-distributed)
  • [2026-07-21 02:59 UTC] 重建索引: 10 篇页面
  • [2026-07-21 03:46 UTC] 新增 plan: M2 分布式实现计划 (plan:m2-distributed)
  • [2026-07-21 03:46 UTC] 新增边: plan:m2-distributed --implements--> design:m2-distributed
  • [2026-07-21 03:46 UTC] 重建索引: 12 篇页面
  • [2026-07-21 06:00 UTC] 新增 finding: M2 verifier 三项 Important 补齐(不变量接线/网关保护/P3 验收) (finding:m2-verifier-fixes)
  • [2026-07-21 06:00 UTC] 重建索引: 13 篇页面
  • [2026-07-21 11:19 UTC] 新增 finding: P6 混合浸泡首跑基线与记分板三重伪击穿修复 (finding:p6-soak-baseline)
  • [2026-07-21 11:19 UTC] 重建索引: 15 篇页面
  • [2026-07-21 12:26 UTC] 新增 design: M2.5 治理韧性: 半死源隔离与健康感知调度 (design:m25-resilience)
  • [2026-07-21 12:26 UTC] 重建索引: 17 篇页面
  • [2026-07-21 12:30 UTC] 新增 plan: M2.5 治理韧性实现计划 (plan:m25-resilience)
  • [2026-07-21 12:30 UTC] 新增边: plan:m25-resilience --implements--> design:m25-resilience
  • [2026-07-21 12:30 UTC] 重建索引: 19 篇页面
  • [2026-07-21 21:34 UTC] 新增 finding: M2.5 验收: P6 同场景 58.1% → 98.96% (finding:m25-acceptance)
  • [2026-07-21 21:34 UTC] 重建索引: 21 篇页面
  • [2026-07-22 01:37 UTC] 新增 design: M3 OCR 端口族设计 (design:m3-ocr)
  • [2026-07-22 01:37 UTC] 重建索引: 23 篇页面
  • [2026-07-22 02:05 UTC] 新增 metric: OCR 治理调用成功率与错误分类分布 (metric:ocr-call-success)
  • [2026-07-22 02:05 UTC] 新增边: metric:ocr-call-success --measures--> schema:llm-calls
  • [2026-07-22 02:05 UTC] 新增边: schema:llm-calls --implements--> design:m3-ocr
  • [2026-07-22 02:05 UTC] 重建索引: 24 篇页面
  • [2026-07-22 02:09 UTC] 新增 plan: M3 OCR 实现计划 (plan:m3-ocr)
  • [2026-07-22 02:09 UTC] 新增边: plan:m3-ocr --implements--> design:m3-ocr
  • [2026-07-22 02:09 UTC] 重建索引: 26 篇页面
  • [2026-07-22 05:33 UTC] 新增 finding: P7 OCR soak 验收: 99.73% 与 13 不变量全 PASS (finding:p7-ocr-soak)
  • [2026-07-22 05:33 UTC] 重建索引: 28 篇页面
  • [2026-07-22 08:58 UTC] 新增 design: M4 迁移验证设计(GovDoc→CHS,发 v1.0) (design:m4-migration)
  • [2026-07-22 08:58 UTC] 重建索引: 30 篇页面
  • [2026-07-22 09:33 UTC] 新增 plan: M4 迁移实现计划(T0-T14) (plan:m4-migration)
  • [2026-07-22 09:33 UTC] 新增边: plan:m4-migration --implements--> design:m4-migration
  • [2026-07-22 09:33 UTC] 重建索引: 32 篇页面
  • [2026-07-22 14:36 UTC] 新增 finding: M4 迁移验收(GovDoc+CHS) (finding:m4-acceptance)
  • [2026-07-22 14:36 UTC] 重建索引: 34 篇页面
  • [2026-07-30 03:44 UTC] 新增 design: GatewaySettings 跨字段不变量守卫的生效范围 (design:settings-invariant-guards)
  • [2026-07-30 03:44 UTC] 重建索引: 36 篇页面
  • [2026-07-30 04:44 UTC] 新增 design: GatewaySettings 装配校验补齐(第二轮) (design:settings-invariants-round-2)
  • [2026-07-30 04:44 UTC] 重建索引: 38 篇页面
  • [2026-07-30 09:32 UTC] 新增 design: est_tokens 解耦: 拆分限流预扣与遥测用量兜底(issue #2) (design:est-tokens-decoupling)
  • [2026-07-30 09:33 UTC] 重建索引: 40 篇页面
  • [2026-07-30 09:33 UTC] 新增边: design:est-tokens-decoupling --refines--> design:m1-core-design
  • [2026-07-30 09:33 UTC] 重建索引: 40 篇页面
  • [2026-07-30 09:39 UTC] 新增 plan: est_tokens 解耦实施计划 (plan:est-tokens-decoupling)
  • [2026-07-30 09:39 UTC] 新增边: plan:est-tokens-decoupling --implements--> design:est-tokens-decoupling
  • [2026-07-30 09:39 UTC] 重建索引: 42 篇页面
  • [2026-07-31 08:35 UTC] 新增 design: 响应可观测字段扩展(Issue #3) (design:response-observability-fields)
  • [2026-07-31 08:37 UTC] 重建索引: 44 篇页面
  • [2026-07-31 11:10 UTC] 新增 plan: 响应可观测字段扩展实现计划 (plan:response-observability-fields)
  • [2026-07-31 11:10 UTC] 新增边: plan:response-observability-fields --implements--> design:response-observability-fields
  • [2026-07-31 11:10 UTC] 重建索引: 46 篇页面
  • [2026-07-31 11:11 UTC] 重建索引: 46 篇页面
  • [2026-07-31 12:25 UTC] 重建索引: 46 篇页面
  • [2026-07-31 15:57 UTC] 新增 design: 采样参数透传设计(issue #4) (design:sampling-params)
  • [2026-07-31 15:57 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:00 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:31 UTC] 重建索引: 48 篇页面
  • [2026-07-31 16:59 UTC] 新增 plan: 采样参数透传实现计划(issue #4) (plan:sampling-params-plan)
  • [2026-07-31 16:59 UTC] 新增边: plan:sampling-params-plan --implements--> design:sampling-params
  • [2026-07-31 16:59 UTC] 重建索引: 50 篇页面
  • [2026-07-31 17:01 UTC] 重建索引: 50 篇页面
  • [2026-08-01 01:58 UTC] 重建索引: 50 篇页面
  • [2026-08-02 09:38 UTC] 重建索引: 52 篇页面
  • [2026-08-02 09:38 UTC] 新增边: finding:2026-08-02-thinking-switch-and-reasoning-tokens --supports--> design:2026-08-02-thinking-capability-design
  • [2026-08-02 09:38 UTC] 新增 finding: 推理开关与 reasoning_tokens 供应商实测与业界做法 (finding:2026-08-02-thinking-switch-and-reasoning-tokens)
  • [2026-08-02 09:38 UTC] 新增 design: 推理开关能力建模与 reasoning_tokens 采集 issue #5+#6 (design:2026-08-02-thinking-capability-design)
  • [2026-08-02 09:39 UTC] 重建 Query Pack: 29 字符
  • [2026-08-02 09:49 UTC] 重建索引: 53 篇页面
  • [2026-08-02 09:49 UTC] 新增边: plan:2026-08-02-thinking-capability --implements--> design:2026-08-02-thinking-capability-design
  • [2026-08-02 09:49 UTC] 新增 plan: 推理开关能力建模与 reasoning_tokens 采集实施计划 (plan:2026-08-02-thinking-capability)
  • [2026-08-02 09:49 UTC] 重建索引: 53 篇页面
  • [2026-08-02 10:55 UTC] 重建索引: 53 篇页面
  • [2026-08-02 10:55 UTC] 更新 finding: 补 §2.5 输出长度不是有效判别量(e2e 各 15 轮实测)
  • [2026-08-06 06:37 UTC] 新增 design: 治理后端故障归位为 scope 级不可用(Issue #7) (design:governance-backend-error)
  • [2026-08-06 06:38 UTC] 重建索引: 55 篇页面
  • [2026-08-06 08:08 UTC] 新增 plan: 实现计划: 治理后端故障归位为 scope 级不可用(Issue #7) (plan:governance-backend-error)
  • [2026-08-06 08:08 UTC] 新增边: plan:governance-backend-error --implements--> design:governance-backend-error
  • [2026-08-06 08:08 UTC] 重建索引: 57 篇页面
  • [2026-08-06 08:11 UTC] 重建索引: 57 篇页面
  • [2026-08-06 14:57 UTC] 新增 design: stall 判定改为非生产性等待口径 (design:issue8-stall-budget)
  • [2026-08-06 14:58 UTC] 新增 plan: issue #8 实施计划: stall 非生产性等待口径 (plan:issue8-stall-budget-plan)
  • [2026-08-06 14:58 UTC] 新增边: plan:issue8-stall-budget-plan --implements--> design:issue8-stall-budget
  • [2026-08-06 14:58 UTC] 重建索引: 61 篇页面
  • [2026-08-07 15:20 UTC] 新增 design: 建表前先探测,判死只认「确定写不进去」 (design:issue9-telemetry-ddl-probe)
  • [2026-08-07 15:20 UTC] 重建索引: 62 篇页面
  • [2026-08-07 15:11 UTC] 重建索引: 62 篇页面
  • [2026-08-16 09:09 UTC] 新增 design: HTTP 错误响应体留存(Issue #10) (design:issue10-error-body-retention)
  • [2026-08-16 09:12 UTC] 重建索引: 64 篇页面
  • [2026-08-16 09:50 UTC] 新增 plan: 实现计划: HTTP 错误响应体留存(Issue #10) (plan:issue10-error-body-retention-plan)
  • [2026-08-16 09:50 UTC] 新增边: plan:issue10-error-body-retention-plan --implements--> design:issue10-error-body-retention
  • [2026-08-16 09:50 UTC] 重建索引: 66 篇页面
  • [2026-08-17 09:53 UTC] 重建索引: 68 篇页面
  • [2026-08-17 10:09 UTC] 新增 plan: 调用方自定义维度实现计划(issue #11) (plan:issue11-caller-dimensions)
  • [2026-08-17 10:09 UTC] 新增边: plan:issue11-caller-dimensions --implements--> design:issue11-caller-dimensions
  • [2026-08-17 10:09 UTC] 重建索引: 70 篇页面
  • [2026-08-19 12:44 UTC] 新增 design: issue #13: 遥测 schema 自动 ALTER 降级为按后端不对称的显式档位 (design:issue13-schema-mode)
  • [2026-08-19 12:44 UTC] 新增 design: issue #12: 遥测表的正文体量、保留期与访问控制 (design:issue12-telemetry-retention)
  • [2026-08-19 12:45 UTC] 重建索引: 74 篇页面
  • [2026-08-19 13:10 UTC] 新增 plan: 实现计划: issue13-schema-mode (plan:plan-issue13-schema-mode)
  • [2026-08-19 13:10 UTC] 新增边: plan:plan-issue13-schema-mode --implements--> design:issue13-schema-mode
  • [2026-08-19 13:10 UTC] 新增 plan: 实现计划: issue12-telemetry-retention (plan:plan-issue12-telemetry-retention)
  • [2026-08-19 13:10 UTC] 新增边: plan:plan-issue12-telemetry-retention --implements--> design:issue12-telemetry-retention
  • [2026-08-19 13:10 UTC] 重建索引: 78 篇页面
  • [2026-08-20 03:29 UTC] 新增 design: 熔断拒绝补齐等待档(issue #14) (design:issue14-admission-wait-policy)
  • [2026-08-20 03:30 UTC] 新增 plan: 实现计划: 熔断拒绝补齐等待档(issue #14) (plan:issue14-admission-wait-policy)
  • [2026-08-20 03:30 UTC] 新增边: plan:issue14-admission-wait-policy --implements--> design:issue14-admission-wait-policy
  • [2026-08-20 03:30 UTC] 重建索引: 82 篇页面
  • [2026-08-20 03:30 UTC] 重建索引: 80 篇页面
  • [2026-08-20 05:01 UTC] 新增边: review:issue14-branch-review --informs--> plan:plan-issue14-admission-wait-policy
  • [2026-08-20 05:01 UTC] 重建索引: 80 篇页面
  • [2026-08-20 05:01 UTC] 新增 review: 整分支审查: issue #14 熔断等待档 (review:issue14-branch-review)
  • [2026-08-20 05:01 UTC] 重建索引: 81 篇页面
  • [2026-08-24 05:49 UTC] 新增 design: issue #15: 遥测连接池的资源语义与生命周期 (design:issue15-telemetry-pool-lifecycle)
  • [2026-08-24 05:50 UTC] 重建索引: 83 篇页面
  • [2026-08-24 05:50 UTC] 新增边: design:issue15-telemetry-pool-lifecycle --refines--> design:issue9-telemetry-ddl-probe
  • [2026-08-24 05:50 UTC] 新增边: design:issue15-telemetry-pool-lifecycle --depends_on--> design:issue12-telemetry-retention
  • [2026-08-24 05:50 UTC] 重建索引: 83 篇页面
  • [2026-08-24 10:14 UTC] 重建索引: 83 篇页面
  • [2026-08-24 10:15 UTC] design:issue15-telemetry-pool-lifecycle 经 Codex 审查: 3 阻断+3 应改+1 可选,核实后 6 采纳 1 改判,正文补 §9 审查留痕
  • [2026-08-24 10:20 UTC] 最低 Python 提到 3.12(pyproject/ruff/README/CLAUDE.md 四处);design:issue15 §6 版本取舍消解,§7 补两项实施前置
  • [2026-08-24 10:32 UTC] Python 3.12 迁移执行完毕: 环境重建 3.12.13、补装 build/twine、UP047 三处改 PEP 695;make check 绿、973 passed 覆盖率 94%
  • [2026-08-24 12:05 UTC] 新增 plan: 实现计划: 遥测连接池的资源语义与生命周期(issue #15) (plan:plan-issue15-telemetry-pool-lifecycle)
  • [2026-08-24 12:05 UTC] 新增边: plan:plan-issue15-telemetry-pool-lifecycle --implements--> design:issue15-telemetry-pool-lifecycle
  • [2026-08-24 12:05 UTC] 重建索引: 85 篇页面
  • [2026-08-24 12:10 UTC] plan:issue15 经 Codex 审: 2 阻断已修(20 处构造点须同批改、application_name 改走 DSN 查询参数)、_failed 计数修正