From e03b2afd8ce640baad863c9b11e46999c2a4060a Mon Sep 17 00:00:00 2001 From: iomgaa Date: Tue, 25 Aug 2026 22:08:01 -0400 Subject: [PATCH] docs: record the human call to ship this as 1.3.1 The design argued for 1.4.0 because a broken deep-path import hidden behind a patch bump is a debt handed to downstream. The call is 1.3.1. Since the version number no longer carries the warning, the CHANGELOG has to: breaking items and their fixes go first in the entry, following the 1.3.0 read-this-first form. --- .../designs/2026-08-25-thinking-observability-design.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/research-wiki/designs/2026-08-25-thinking-observability-design.md b/research-wiki/designs/2026-08-25-thinking-observability-design.md index bded727..6b5ea0c 100644 --- a/research-wiki/designs/2026-08-25-thinking-observability-design.md +++ b/research-wiki/designs/2026-08-25-thinking-observability-design.md @@ -197,7 +197,9 @@ class ThinkingObservation(StrEnum): 本次含：`LLMResponse` 新增公共字段、新增模块 `thinking.py`、新增包根导出、遥测新增一列、`providers.py` 深路径 import 断裂。按语义化版本这是 **minor**。1.3.0 仅新增一个 `TelemetryStatus` 导出即定为 minor，本次变更面更大。 -**建议发 1.4.0 而非 1.3.1**：把"深路径 import 断裂"藏在 patch 版号里，本身就是一笔留给下游的技术债——下游看 1.3.0→1.3.1 不会去读 CHANGELOG。版号是给人读的第一份变更说明。 +曾建议 1.4.0，理由是把"深路径 import 断裂"藏在 patch 版号里等于留债——下游看 1.3.0→1.3.1 不会去读 CHANGELOG。 + +**人类 2026-08-25 决定：发 1.3.1。** 决定已记录，实施按此执行。既然版号不再承担预警职责，预警必须由 CHANGELOG 独立扛起：断裂项与改法置于本版条目**最前**，沿用 1.3.0"请先读这一条"的体例，不得只在中段一笔带过。 ## 14. 验收标准