From 7ccb25e8f12223519947618e42c37b12890c0492 Mon Sep 17 00:00:00 2001 From: iomgaa Date: Fri, 31 Jul 2026 06:54:55 -0400 Subject: [PATCH] docs: record the human approval of the design decisions --- .../2026-07-31-response-observability-fields-design.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/research-wiki/designs/2026-07-31-response-observability-fields-design.md b/research-wiki/designs/2026-07-31-response-observability-fields-design.md index 3503e42..d284099 100644 --- a/research-wiki/designs/2026-07-31-response-observability-fields-design.md +++ b/research-wiki/designs/2026-07-31-response-observability-fields-design.md @@ -2,7 +2,7 @@ - **日期**: 2026-07-31 - **来源**: Gitea Issue #3(下游 dissect 审计需求) -- **状态**: 待人类审批 +- **状态**: 已批准(2026-07-31,人类逐条确认 A2 / B1 / C1 / D1) - **触发档位**: 强制(变更 `types.py` 公共类型 + `ports.py` 端口签名 + 遥测持久化 schema) ## 1. 目标与非目标 @@ -149,8 +149,8 @@ Issue 称「两者的数据都已经存在于 `TransportResult.raw` 里」。核 | Wiki 站 + `CHANGELOG.md` | 按 `docs-convention.md` §2 清单同步(公共行为变更,版本 bump 不得裸发) | | `.env.example:56` | 该行内联注释是仓内**唯一**的价格表格式说明(无独立模板文件,`config/prices.json` 是未入库的本地文件),补 `cached_input_per_1m` 可选档 | -## 10. 待人类确认 +## 10. 审批记录 -1. 本设计整体是否批准进入 `writing-plans`。 -2. 决策 B(缓存命中原样回放 + 度量口径带 `cache_hit = false`)是否认可——这是唯一一处「语义可争论」的选择。 -3. 版本号定为 `1.1.0`(纯增字段但触及端口签名与表结构)是否合适。 +2026-07-31 人类逐条确认: **A2**(TransportResult 强类型字段)、**B1**(缓存命中原样回放 + 度量口径带 `cache_hit = false`)、**C1**(ModelPrice 可选缓存单价档)、**D1**(DDL 加列 + 初始化期幂等补列)。设计获批,进入 `writing-plans`。 + +版本号按 `1.1.0` 推进(纯增字段不破坏下游,但触及端口签名与表结构,minor 位比 patch 位更能提示下游);发版前若人类另有指示以指示为准。