@fxri/toolkit 1.12.0 → 1.12.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 方弦工具集
 
+## 1.12.2
+
+> 2026-10-16 发布
+
+### 📝 文档更新
+
+- 修正历史日志块的条目前缀残留与错挂归组——1.9.2 块一处子项剥离遗留的 `修复：` 前缀，1.9.0 块两处独立修复由父项缩进子项拆为顶层条目
+
+## 1.12.1
+
+> 2026-10-16 发布
+
+### ✨ 新增功能
+
+- `toolkit tasks check` 增报变更集「未加 `- ` 列表标记」的裸行（含首个行号与本文件行数），与既有「缺类型前缀」检测并列
+
+### 🐛 问题修复
+
+- 修复变更集裸行写法漏检——以往多条裸行会被 changesets 并入相邻条目作缩进续行、致整段塌成单一条目，只有首行参与归类与前缀剥离
+
 ## 1.12.0
 
 > 2026-10-16 发布
@@ -7,27 +27,39 @@
 ### ✨ 新增功能
 
 - 规范载体升 v3——`.tasks/conventions/` 按读面拆「常驻索引 / 按需分册 / 归档」三分区，新增 `retired.md` 退休台账承载作废条目（冻结退休时语义并记录后继与条文去向），条目作废走三层清理（索引行迁出、分册小节物理删除、外部单一事实源同步收敛），从源头抑制常驻读面的规范膨胀
-  新增：`toolkit conventions upgrade` 支持 v1 / v2 → v3 链式升级——v2 升级自动删除索引表「状态」「确立来源任务」两列、把作废条目迁入 `retired.md` 并物理删除分册对应小节，`--dry-run` 可预演
-  新增：载体支持分类标签分册（如 `build.md` 等非端分册），归属取已存在的分册名即合法
-  修改：`toolkit conventions status` 新增校验——退休台账可定位性、退休 ID 与活跃 ID 重叠、common 归属却语义提及端名
-  修改：任务 `scope` 字段校验新增路径分隔符软告警（`/` 与 `\`）
-  优化：跨平台兼容补强——新增 macOS CI job、统一路径大小写归一口径（覆盖 macOS）、补 `.gitattributes` 统一换行符
-  修复：`toolkit conventions upgrade` 与 `status` 判定稳定 ID 时容忍行内代码包裹（`` `C-4` `` 不再误判为「首列仍为规则名」「不合稳定 ID 形态」）——对齐规范「引用一律行内代码包裹」的合法写法
-  修复：`toolkit conventions status` 的 common 下沉提示改为大小写不敏感、判据收窄为「语义含端限定语（仅 / 只 / 专属 / 适用于）且提及端名」，消除举例式提及的假阳性并补上大写端名的漏报
-  修改：`toolkit conventions upgrade` 新增 `index.md` 正文 v2 措辞复核——表外自由文本残留「确立来源任务」「状态改为已废弃」等表述时列入 `reviews`（只报不改）
-  修改：`toolkit tasks check` 与 `toolkit conventions status` 新增演进记录首列形态校验——v3 载体的 `history.md` 数据行首列须记为行内代码包裹的稳定 ID `C-<n>`，检出规则名等非 ID 首列时软告警（只报不改，历史行只追加故补齐须人工确认）
-  修改：规范载体三表表头统一为稳定 ID `ID`——索引表（`| ID | 规则 | 当前语义 | 归属 | 单一事实源 |`）、`history.md`（`| ID | 修订内容 | 修订来源任务 |`）、`retired.md` 首格同归一；表头与分隔行由列名常量单源派生，杜绝列集合形态漂移
-  修复：`toolkit init` 生成的 `conventions/index.md` 骨架此前残留 v2 列结构，改为按 v3 五列生成
-  修改：`toolkit conventions upgrade` 的 v2→v3 升级新增 `history.md` 表头首格归一为稳定 ID `ID`
-  修改：`toolkit tasks check` 与 `toolkit conventions status` 新增表形态速检——v3 载体索引表残留 v2 独有列（「状态」「确立来源任务」）或 `history.md` / `retired.md` 表头首格非 `ID` 时软告警（只报不改）
-  修改：表形态校验从「速检」升级为完整比对——v3 索引表列集合须恰为 `ID | 规则 | 当前语义 | 归属 | 单一事实源` 五列（列名与次序逐格一致，多列 / 少列 / 换序均检出）、`history.md` / `retired.md` 表头整行逐格比对、载体各文件（`index.md`、分册、`history.md`、`retired.md`）表头行与紧随分隔行列数须相等（跳过 fenced code block）；检出统一为软告警（只报不改，须人工确认后按规范归一）
-  文档：`conventions-spec` 补齐形态与迁移措辞——索引表五列固定、`history.md` / `retired.md` 表头固定逐格一致、表列数自洽、入口壳版本沿革（壳标记独立演进、当前 `v2`、从未有过 `v1` 壳）、不得显式书写 `v1` 标记、手工迁 v2 与 `toolkit conventions upgrade` 链式直达 v3 的落点差异
-  新增：`conventions-spec` 新增 §13「载体文风与模板」（T1–T6）——索引头注固定两行、用法说明固定「载体形态 → 本项目约定（可选）→ 读写与维护」三段骨架、「单一事实源」列按载体内 / 外二分写法（载体分册用相对链接、载体外文件用行内代码）、分册条文固定「要求 → 反例 → 理由 → 配套」四子项且不写「确立来源」、规范词按 `须` / `应` / `可` / `不得` 分级、标识符与路径一律行内代码
-  修改：`toolkit tasks check` 与 `toolkit conventions status` 新增分册残留「确立来源」子项检测——v3 载体的分册（`index.md` 除外）内出现行首「确立来源」子项时软告警（跳过 fenced code block、只报不改）
-  修改：`conventions-spec` 补齐演进记录措辞规则——§3.2 规定「修订内容」列只记该条自身语义（新立条目直接写其语义、语义变更写「旧语义」→「新语义」），禁自指套话（如「（本次起入表）」「新立条目：」）与重复 `index.md` 索引列的条文去向（如「条文全文落 X」，违反不变量 I4），并确立「措辞归一例外」（属 §9 同类的措辞层归一可原地改写旧行、不入留痕）；§8 补新立条目写法、§12 自查清单同步新增一项
-  修改：`toolkit tasks check` 与 `toolkit conventions status` 新增演进记录「修订内容」列禁用语料检测——v3 载体的 `history.md` 该列出现自指套话或重复索引列的条文去向时软告警（报首个命中行与「另有 N 处」、只报不改，改写须人工确认）
-  修改：`toolkit init` / `toolkit conventions upgrade` 写入 `history.md` 的元规则引语同步为「修订内容新立条目直接写其语义、语义变更写『旧语义』→『新语义』」，与 `conventions-spec` §3.2 模板同源
-  修改：规范载体文风模板（§13）微调——T6 中英文混排空格由硬性要求放宽为随仓库既有排版习惯；样板与索引内引用的 skill 路径由短名改为完整路径（样板处用 `skills/<技能名>/references/…` 占位）；检测实现注释里的表形态检测代号由 `T1–T5` 收敛为 `S1–S5`，与文风模板编号 `T1–T6` 区分（仅注释，无行为变化）
+- `toolkit conventions upgrade` 支持 v1 / v2 → v3 链式升级——v2 升级自动删除索引表「状态」「确立来源任务」两列、把作废条目迁入 `retired.md` 并物理删除分册对应小节，`--dry-run` 可预演
+- 载体支持分类标签分册（如 `build.md` 等非端分册），归属取已存在的分册名即合法
+- `conventions-spec` 新增 §13「载体文风与模板」（T1–T6）——索引头注固定两行、用法说明固定「载体形态 → 本项目约定（可选）→ 读写与维护」三段骨架、「单一事实源」列按载体内 / 外二分写法（载体分册用相对链接、载体外文件用行内代码）、分册条文固定「要求 → 反例 → 理由 → 配套」四子项且不写「确立来源」、规范词按 `须` / `应` / `可` / `不得` 分级、标识符与路径一律行内代码
+
+### 🔧 功能调整
+
+- `toolkit conventions status` 新增校验——退休台账可定位性、退休 ID 与活跃 ID 重叠、common 归属却语义提及端名
+- 任务 `scope` 字段校验新增路径分隔符软告警（`/` 与 `\`）
+- `toolkit conventions upgrade` 新增 `index.md` 正文 v2 措辞复核——表外自由文本残留「确立来源任务」「状态改为已废弃」等表述时列入 `reviews`（只报不改）
+- `toolkit tasks check` 与 `toolkit conventions status` 新增演进记录首列形态校验——v3 载体的 `history.md` 数据行首列须记为行内代码包裹的稳定 ID `C-<n>`，检出规则名等非 ID 首列时软告警（只报不改，历史行只追加故补齐须人工确认）
+- 规范载体三表表头统一为稳定 ID `ID`——索引表（`| ID | 规则 | 当前语义 | 归属 | 单一事实源 |`）、`history.md`（`| ID | 修订内容 | 修订来源任务 |`）、`retired.md` 首格同归一；表头与分隔行由列名常量单源派生，杜绝列集合形态漂移
+- `toolkit conventions upgrade` 的 v2→v3 升级新增 `history.md` 表头首格归一为稳定 ID `ID`
+- `toolkit tasks check` 与 `toolkit conventions status` 新增表形态速检——v3 载体索引表残留 v2 独有列（「状态」「确立来源任务」）或 `history.md` / `retired.md` 表头首格非 `ID` 时软告警（只报不改）
+- 表形态校验从「速检」升级为完整比对——v3 索引表列集合须恰为 `ID | 规则 | 当前语义 | 归属 | 单一事实源` 五列（列名与次序逐格一致，多列 / 少列 / 换序均检出）、`history.md` / `retired.md` 表头整行逐格比对、载体各文件（`index.md`、分册、`history.md`、`retired.md`）表头行与紧随分隔行列数须相等（跳过 fenced code block）；检出统一为软告警（只报不改，须人工确认后按规范归一）
+- `toolkit tasks check` 与 `toolkit conventions status` 新增分册残留「确立来源」子项检测——v3 载体的分册（`index.md` 除外）内出现行首「确立来源」子项时软告警（跳过 fenced code block、只报不改）
+- `conventions-spec` 补齐演进记录措辞规则——§3.2 规定「修订内容」列只记该条自身语义（新立条目直接写其语义、语义变更写「旧语义」→「新语义」），禁自指套话（如「（本次起入表）」「新立条目：」）与重复 `index.md` 索引列的条文去向（如「条文全文落 X」，违反不变量 I4），并确立「措辞归一例外」（属 §9 同类的措辞层归一可原地改写旧行、不入留痕）；§8 补新立条目写法、§12 自查清单同步新增一项
+- `toolkit tasks check` 与 `toolkit conventions status` 新增演进记录「修订内容」列禁用语料检测——v3 载体的 `history.md` 该列出现自指套话或重复索引列的条文去向时软告警（报首个命中行与「另有 N 处」、只报不改，改写须人工确认）
+- `toolkit init` / `toolkit conventions upgrade` 写入 `history.md` 的元规则引语同步为「修订内容新立条目直接写其语义、语义变更写『旧语义』→『新语义』」，与 `conventions-spec` §3.2 模板同源
+- 规范载体文风模板（§13）微调——T6 中英文混排空格由硬性要求放宽为随仓库既有排版习惯；样板与索引内引用的 skill 路径由短名改为完整路径（样板处用 `skills/<技能名>/references/…` 占位）；检测实现注释里的表形态检测代号由 `T1–T5` 收敛为 `S1–S5`，与文风模板编号 `T1–T6` 区分（仅注释，无行为变化）
+
+### ⚡ 优化改进
+
+- 跨平台兼容补强——新增 macOS CI job、统一路径大小写归一口径（覆盖 macOS）、补 `.gitattributes` 统一换行符
+
+### 🐛 问题修复
+
+- `toolkit conventions upgrade` 与 `status` 判定稳定 ID 时容忍行内代码包裹（`` `C-4` `` 不再误判为「首列仍为规则名」「不合稳定 ID 形态」）——对齐规范「引用一律行内代码包裹」的合法写法
+- `toolkit conventions status` 的 common 下沉提示改为大小写不敏感、判据收窄为「语义含端限定语（仅 / 只 / 专属 / 适用于）且提及端名」，消除举例式提及的假阳性并补上大写端名的漏报
+- `toolkit init` 生成的 `conventions/index.md` 骨架此前残留 v2 列结构，改为按 v3 五列生成
+
+### 📝 文档更新
+
+- `conventions-spec` 补齐形态与迁移措辞——索引表五列固定、`history.md` / `retired.md` 表头固定逐格一致、表列数自洽、入口壳版本沿革（壳标记独立演进、当前 `v2`、从未有过 `v1` 壳）、不得显式书写 `v1` 标记、手工迁 v2 与 `toolkit conventions upgrade` 链式直达 v3 的落点差异
 
 ## 1.11.8
 
@@ -433,7 +465,7 @@
   - 历史版本块保留当时口径，`changelog format` 不追溯改写；前缀识别与输出语言解耦（全局前缀表全语言共用），变更集条目语言与输出语言不一致时仍正确归组
   - 自定义语言新增可选 `groups`（`[{ slot, title, prefixes? }]`）声明本语言标题与自有前缀；未声明时退化为纯替换，既有配置无需改动
   - ⚠️ 对外契约变化：`--lang en` 的组标题文本变化（如 `### ✨ Minor Changes` → `### ✨ Added`）；`--warn` / `FX_CHECK_WARN` / `check.warnings` 适用范围由任务校验告警扩为「任务校验告警 + 变更集条目缺类型前缀告警」，同一开关一并开关闭；新增公共导出 `SLOT_PREFIXES` / `SemanticSlot`
-  - 修复：发布日期行识别由硬编码「发布/released」改为「当前语言 `released` ∪ 全部内置语言 `released`」后缀集合——自定义语言（日文等）按自身 `released` 识别，内置 zh / en 互跑（如中文日志用 `--lang en` 输出）也不再重复追加日期行
+  - 发布日期行识别由硬编码「发布/released」改为「当前语言 `released` ∪ 全部内置语言 `released`」后缀集合——自定义语言（日文等）按自身 `released` 识别，内置 zh / en 互跑（如中文日志用 `--lang en` 输出）也不再重复追加日期行
 - 技能版本可视化，旧会话可自校验技能内容是否过期
 
   - `toolkit skills status` 常驻打印包内各技能真源版本，`--format json` 新增 `skillVersions` 字段与逐项 `version`，作为磁盘基准值；`toolkit skills install` 报告同样逐项带版本
@@ -485,14 +517,14 @@
   - 自愈改为一次列目录取现场条目类型，不再逐条 `lstatSync`，稳态开销明显下降
   - `toolkit skills status` 末尾汇总按型给出指引：缺失 / 悬空 / 指向错误 / 副本漂移用 `install` 补齐，同名冲突用 `install --force` 覆盖
   - 收窄状态分类口径：同名实体目录只有登记为本包副本时才算「副本已漂移」（裸 `install` 即可刷新），未登记的属用户 / 上游产物，报「同名冲突」并需 `--force` 覆盖
-  - 修复自愈「重建失败」时状态记录被静默写掉的问题：失败条目保留在 `~/.agents/.toolkit-skills.json`，下次运行仍会重试
 
 ### 🐛 问题修复
 
+- 修复自愈「重建失败」时状态记录被静默写掉的问题：失败条目保留在 `~/.agents/.toolkit-skills.json`，下次运行仍会重试
 - 诊断提示污染机器可读输出：链接自愈提示与升级提示改走 stderr，stdout 保持纯 JSON
 
   - `toolkit tasks --format json` 等机器可读输出不再被追加提示文本，可安全 `JSON.parse` 与管道消费
-  - `updateCheck` 的缓存文件带 BOM 时不再误判为损坏而重复联网（与配置文件、技能状态文件同口径剥离 BOM）
+- `updateCheck` 的缓存文件带 BOM 时不再误判为损坏而重复联网（与配置文件、技能状态文件同口径剥离 BOM）
 
 ## 1.8.3