@cyning/harness 2.12.0 → 2.12.1

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+## [2.12.1] - 2026-07-26
+
+### Fixed
+
+- **invoke 文件名 hat 扫描**：改为日期后的**前缀 hat run**；slug 中的 `10`/`40` 等不再误计为已覆盖；去掉整名 `/CLOSE/i` 裸匹配。
+- `lifecycle.yaml`：删除 `invoke_hats_retention` 别名守卫，仅保留 `close_invoke`。
+
+### Changed
+
+- `verify` / 单测收紧：缺口 WARN 用例断言 exit 0；补误计负例与 lint **W6**。
+- USER_GUIDE §6.0 · TEMPLATE_invoke 命名约束 · 10-task 提及 W6。
+- `discipline-coverage.yaml` `as_of` → **2.12.1**。
+
+### Notes
+
+- patch · 对规范命名无影响；依赖 slug 误计的畸形文件名 close 可能新 BLOCK
+- 迁移指引：[`docs/USER_GUIDE_v1.0_zh.md`](docs/USER_GUIDE_v1.0_zh.md) §6.0（不另造 RUNBOOK）
+- **已发布**：tag `v2.12.1` 已推送（2026-07-26）· npm publish 后将 `@cyning/harness@2.12.1` 标为 `latest`
+
 ## [2.12.0] - 2026-07-26
 
 ### Added
@@ -15,14 +34,15 @@
 
 ### Changed
 
-- `lifecycle.yaml` close 守卫登记 `invoke_hats_retention`；`discipline-coverage.yaml` `as_of` → **2.12.0** · gaps `INVOKE-HATS`。
+- `lifecycle.yaml` close 守卫升级 `close_invoke`（集合覆盖）；`discipline-coverage.yaml` `as_of` → **2.12.0** · gaps `INVOKE-HATS`。
 - TASK_TEMPLATE / TEMPLATE_invoke / 10·20·30 帽文同步字段与纪律。
 
 ### Notes
 
 - SPEC：`docs/spec/SPEC-invoke-hats-retention-gate_v1.md`
 - **破坏性（close）**：无字段时按 default 要求 10+30+40；存量仅 30 的 active 须补档、改 `minimal` 或 `--allow-invoke-gap`
-- minor · 建议业务仓 upgrade 后按 RUNBOOK 勾选 invoke 集合
+- minor · 建议业务仓 upgrade 后按 [`USER_GUIDE` §6.0](docs/USER_GUIDE_v1.0_zh.md) 勾选 invoke 集合
+- **已发布**：`@cyning/harness@2.12.0`（npm `latest` · 2026-07-26）· tag `v2.12.0` 已推送
 
 ## [2.11.1] - 2026-07-25
 

package/docs/USER_GUIDE_v1.0_zh.md

@@ -207,6 +207,20 @@ Schema：[`schema/verify_result.v1.schema.json`](../schema/verify_result.v1.sche
 
 Audit **不替代** 维护者判断；22 内容质量仍须人读 review。详见 [`ONBOARDING.md`](./ONBOARDING.md) §2.2。
 
+### 6.0 多帽 invoke 留档（v2.12+）
+
+`task close` 按 task 元信息校验 `by-task/<slug>/` 下 invoke 文件名所覆盖的 **hat 集合**（缺省要求 `10,30,40`）。
+
+| 字段 / 手段 | 说明 |
+| --- | --- |
+| `invoke_retention_profile` | `default`=`10,30,40` · `minimal`=`30` · `full`=`00,10,20,30,40,CLOSE` |
+| `required_invoke_hats` | 显式列表，**优先于** profile |
+| 命名 | `invoke_YYYYMMDD_<hat>[_<hat>...]_<slug>.md`；hat 只在日期后连续前缀（例 `30_40` 可双计）；**slug 段勿夹** `10`/`40` 等（v2.12.1 起不误计） |
+| `--allow-invoke-gap` | close / `verify --task` 缺帽豁免并留痕 |
+| 存量仅 30 | upgrade 后：补 `10`/`40` 档、或改 `minimal`、或显式 `--allow-invoke-gap` |
+
+`verify --task` 对缺口仅 **WARN**，不挡 `may_start_30`；硬闸在 close。
+
 ### 6.1 SDD-Compliance bench（维护者 · 可选）
 
 > **业务仓日常不必跑**；用于验证 `gate-check` / `sync` 公理行为，或对照 README「试点证据」中的 bench 数字。

package/harness/discipline-coverage.yaml

@@ -6,7 +6,7 @@
 # 禁止：把本文件当「每周全量重盘」流程；不做 audit --discipline UI（本波）
 
 version: "1"
-as_of_package_version: "2.12.0"
+as_of_package_version: "2.12.1"
 scope: "Starter · harness/prompts （10/22/30/40 + FRAGMENT）+ TEMPLATE_invoke"
 source_audit: "rethink/2026-07-mechanization-rate · 02 转录 + 03 聚合 · 状态已按 G1–G4/N1–N4 刷新（非第二轮通读盘点）"
 
@@ -114,7 +114,7 @@ statements:
     status: mechanical
     mechanism: "M5 close evaluateInvokeHatsRetention + M6 lint-done"
     gap: null
-    notes: "v2.12.0 默认 10,30,40；profile minimal/full；--allow-invoke-gap"
+    notes: "v2.12.0 默认 10,30,40；profile minimal/full；--allow-invoke-gap；v2.12.1 前缀 hat run"
     mechanism_quality: null
   - id: A7
     source: 30-execute-code.md
@@ -274,7 +274,7 @@ statements:
     status: mechanical
     mechanism: "M5 evaluateInvokeHatsRetention / M6"
     gap: null
-    notes: "v2.12.0 文件名 hat token · 合并 30_40 可双计"
+    notes: "v2.12.0+ 文件名 hat token · 合并 30_40 可双计 · v2.12.1 前缀 run 防 slug 误计"
     mechanism_quality: null
   - id: F2
     source: TEMPLATE_invoke.md

package/harness/invokes/TEMPLATE_invoke.md

@@ -45,7 +45,7 @@
 | 打回重开 | 新文件或 `_r2` 后缀 |
 | 与 reviews 分工 | reviews = 结论；invoke = **当时指令** |
 | close 机械闸 | `harness task close` 按 task 元信息 `required_invoke_hats` / `invoke_retention_profile` 校验帽集合覆盖（v2.12+；缺省 `10,30,40`；文件名含 `30_40` 可双计；`--allow-invoke-gap` 豁免） |
-| 命名 | `invoke_YYYYMMDD_<hat>_<slug>.md` 或 `invoke_YYYYMMDD_30_40_<slug>.md` |
+| 命名 | `invoke_YYYYMMDD_<hat>[_<hat>...]_<slug>.md`（hat token **仅**在日期后、slug 前连续段；slug 勿夹 `10`/`40` 等白名单段 · v2.12.1） |
 | commit | 落盘 + task 回填后再 commit（见 HANDOFF） |
 
 ---

package/harness/lifecycle.yaml

@@ -69,11 +69,7 @@ transitions:
         command_or_check: "task close 检查1 · invoke hats 集合覆盖（required_invoke_hats / profile · v2.12+）"
         severity: block
         allow_flag: "--allow-invoke-gap"
-        note: "缺省 default=10,30,40；minimal=30；full 含 CLOSE；40 可与 30 合并文件名"
-      - id: invoke_hats_retention
-        command_or_check: "evaluateInvokeHatsRetention · 同 close_invoke（登记别名）"
-        severity: block
-        allow_flag: "--allow-invoke-gap"
+        note: "缺省 default=10,30,40；minimal=30；full 含 CLOSE；40 可与 30 合并文件名；v2.12.1 去掉 invoke_hats_retention 别名"
       - id: close_self_check
         command_or_check: "task close 检查2 · 自检结论已回填"
         severity: block

package/harness/prompts/10-task-requirements.md

@@ -33,7 +33,7 @@
 ## 交接物
 
 - 可粘贴进 `docs/tasks/active/task_*.md` 的正文块；并注明建议 `test_strategy`。
-- 产出 task 须 `npx @cyning/harness task lint --file <task>` PASS（v2.3+ · 结构闸 E1–E7 / W1–W3）。
+- 产出 task 须 `npx @cyning/harness task lint --file <task>` PASS（v2.3+ · 结构闸 E1–E7 / W1+；v2.12+ 含 **W6** invoke 留档字段提醒）。
 - 承接 **20-task-audit 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task。
 
 ## OSS 阶段 C · 思考轮（Starter 摘要）

package/lib/task-meta.js

@@ -456,18 +456,15 @@ export function resolveRequiredInvokeHats(meta = {}) {
 }
 
 /**
- * 从 invoke 文件名提取 hat token 集合。
+ * 从 invoke 文件名提取 hat token 集合（v2.12.1+：前缀 hat run）。
  * 兼容：invoke_YYYYMMDD_30_slug.md · invoke_YYYYMMDD_30_40_slug.md · invoke_*_CLOSE_*.md
+ * 只消费日期后的**连续前缀** hat token；遇第一个非 hat 段即停（其后为 slug，不误计）。
  * 亦认 22→20（V2 改名等价，计为 20）。
  */
 export function extractHatsFromInvokeFilename(fileName) {
   const base = path.basename(fileName, '.md');
   const hats = new Set();
 
-  if (/CLOSE/i.test(base)) {
-    hats.add('CLOSE');
-  }
-
   // 去 invoke_ 前缀与可选日期段
   let rest = base.replace(/^invoke[_-]?/i, '');
   rest = rest.replace(/^\d{8}[_-]?/, '');
@@ -482,7 +479,10 @@ export function extractHatsFromInvokeFilename(fileName) {
     }
     if (KNOWN_INVOKE_HAT_TOKENS.has(p)) {
       hats.add(normalizeHatToken(p));
+      continue;
     }
+    // 首个非 hat 段起视为 slug · 停止扫描（防 slug 含 10/40 误计）
+    break;
   }
 
   // V2：22 与 20 等价（审 task）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyning/harness",
-  "version": "2.12.0",
+  "version": "2.12.1",
   "description": "cyning-harness discipline package · init / upgrade / check CLI",
   "license": "MIT",
   "type": "module",