@cyning/harness 2.12.0 → 2.13.0

package/CHANGELOG.md

@@ -4,6 +4,43 @@
 
 ## [Unreleased]
 
+## [2.13.0] - 2026-07-26
+
+### Added
+
+- **`lifecycle dry-run` 接线 `close_*`**：`--task` + `close` + `from=done` 时求值 `close_invoke` / `close_self_check` / `close_acceptance` / `close_slug` / `close_status` / `close_review`（与 `task close` 同语义 · 旁路 · 不 mv）。
+- `evaluateCloseChecks`（`lib/task-close.js`）：close 与 dry-run 共用检查；CLI 透传 `--allow-invoke-gap` / `--allow-unchecked`。
+
+### Changed
+
+- README / USER_GUIDE / ONBOARDING / docs 索引：对齐 **2.12–2.13**（invoke hats · dry-run close）。
+- `discipline-coverage.yaml` `as_of` → **2.13.0**。
+
+### Notes
+
+- SPEC：`docs/spec/SPEC-lifecycle-dry-run-close_v1.md`
+- minor · 仍无 `--apply` / G7；`to_00` 仍可 unevaluated
+- dry-run **不替代** `task close` 硬闸
+
+## [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）
+- **已发布**：`@cyning/harness@2.12.1`（npm `latest` · 2026-07-26）· tag `v2.12.1` 已推送
+
 ## [2.12.0] - 2026-07-26
 
 ### Added
@@ -15,14 +52,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/README.md

@@ -97,6 +97,22 @@ Inform-YAML：`npx @cyning/harness graph yaml compile|check --input docs/_tech_g
 HGM 过程轨：`npx @cyning/harness graph ingest|snapshot|axioms check --target /path/to/your-repo`（v2.0+）  
 Invoke 索引：`npx @cyning/harness sync index --target /path/to/your-repo`（不覆盖 S2 域）
 
+### 近期纪律闸（v2.5–2.13）
+
+| 能力 | 版本 | 命令 / 要点 |
+|------|------|-------------|
+| reviews 留档 | 2.5+ / 全量 2.9 | `verify` · `task close` 查 R\<n\> 审查文 |
+| `task lint` | 2.3+ · W6=2.12 | 结构闸；缺 `required_invoke_hats` / profile 提醒 |
+| `lifecycle show` / `dry-run` | 2.7 / 2.10+ | 登记真值；旁路资格报告（**不**替代 verify/close） |
+| dry-run `to_30` 守卫 | 2.11 | HG · reviews · D5 · lint |
+| 多帽 invoke 留档 | **2.12+** | close 硬闸缺省 `10,30,40`；`--allow-invoke-gap`；见 USER_GUIDE §6.0 |
+| dry-run `close_*` | **2.13** | 与 `task close` 同语义求值；仍无 `--apply` |
+
+```bash
+npx @cyning/harness lifecycle dry-run --transition close --from done --task docs/tasks/active/task_xxx.md
+npx @cyning/harness task close --file docs/tasks/active/task_xxx.md   # 硬闸归档
+```
+
 Node 仓可选：`npx @cyning/harness init --with-scripts` → `pnpm harness:verify`。  
 详见 [`docs/USER_GUIDE_v1.0_zh.md`](docs/USER_GUIDE_v1.0_zh.md) · [`docs/ONBOARDING.md`](docs/ONBOARDING.md) §2.2。
 
@@ -171,9 +187,11 @@ cyning-harness/
 
 | 项 | 值 |
 |----|-----|
-| 当前 | **v2.0.0** — HGM G1 · `graph ingest|snapshot|axioms` · Inform-YAML · ICVO audit · invoke_index · gate-check --graph · B2 证据 |
-| 上一档 | v1.1.0 — Inform-YAML · `graph yaml compile|check` · ICVO audit · invoke_index · gate-check --graph · B2 证据 |
-| 许可 | **MIT** · [`LICENSE`](LICENSE) · Release [`docs/RELEASE_v1.0.0.md`](docs/RELEASE_v1.0.0.md) |
+| 当前 npm | **`@cyning/harness@2.13.0`** — dry-run `close_*` · invoke hats 硬闸（2.12）· lifecycle / verify 扩面（2.9–2.11） |
+| 里程碑 | v2.0 — HGM G1 · Inform-YAML · ICVO audit · invoke_index |
+| 许可 | **MIT** · [`LICENSE`](LICENSE) · 变更 [`CHANGELOG.md`](CHANGELOG.md) |
+
+> README 历史「v2.0.0」表述为 HGM 里程碑标签；**以 `package.json` / npm `latest` / CHANGELOG 为准**。
 
 ---
 
@@ -183,7 +201,7 @@ cyning-harness/
 | --- | --- |
 | **总指引** | [`methodology/README.md`](docs/methodology/README.md) · [关系图](docs/methodology/DOCUMENT_MAP_v1_zh.md) · [路线 ROADMAP](docs/methodology/ROADMAP_v1_zh.md) |
 | **本体** | [DESIGN_ONTOLOGY v1.2](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
-| **使用** | [**USER_GUIDE v1.0**](docs/USER_GUIDE_v1.0_zh.md) · [P0 差距](docs/methodology/execution/P0_V0.2_GAP.md) · [金样验收](examples/demo_checkout/ACCEPTANCE.md) · [ETCLOVG 映射](docs/ETCLOVG_MAPPING_v1_zh.md) |
+| **使用** | [**USER_GUIDE v1.0**](docs/USER_GUIDE_v1.0_zh.md)（§6.0 invoke 留档 · lifecycle dry-run）· [金样验收](examples/demo_checkout/ACCEPTANCE.md) |
 | **远期** | [HGM 草案](docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md) |
 | **接入** | [ONBOARDING](docs/ONBOARDING.md) · [ARCHITECTURE](docs/ARCHITECTURE.md) |
 

package/docs/ONBOARDING.md

@@ -66,13 +66,20 @@ npx @cyning/harness verify --spec docs/spec/SPEC-xxx_v1.md \
 # 只读生命周期登记（方向二 · harness/lifecycle.yaml · 非引擎）
 npx @cyning/harness lifecycle show
 npx @cyning/harness lifecycle show --json
-# 转移资格 dry-run（v2.10+ · 旁路报告 · 不替代 verify）
-# v2.11+ to_30 已接线：HG-* · reviews · audit_D5 · task_lint（close_* 仍可 unevaluated）
+# 转移资格 dry-run（v2.10+ · 旁路报告 · 不替代 verify / task close）
+# v2.11+ to_30 已接线：HG-* · reviews · audit_D5 · task_lint
+# v2.13+ close_* 已接线（与 task close 同语义 · 仍无 --apply）
 npx @cyning/harness lifecycle dry-run --transition to_30 --from draft \
   --task docs/tasks/active/task_xxx.md
+npx @cyning/harness lifecycle dry-run --transition close --from done \
+  --task docs/tasks/active/task_xxx.md
 # 无 --task：仅结构 + 守卫清单 unevaluated
 npx @cyning/harness lifecycle dry-run --transition to_30 --from draft
 
+# 受闸归档（v2.12+ 多帽 invoke 集合 · 缺省 10,30,40 · 见 USER_GUIDE §6.0）
+npx @cyning/harness task close --file docs/tasks/active/task_xxx.md
+# 豁免示例：--allow-invoke-gap · --allow-unchecked · --allow-no-review
+
 # 机械化率资产只读（v2.11+ · SoT=discipline-coverage.yaml）
 npx @cyning/harness discipline show
 npx @cyning/harness discipline show --json
@@ -94,6 +101,7 @@ npx @cyning/harness sync index --target /path/to/your-repo
 | **D3** | 30 前置人闸 | 复用 `gate-check.sh`，HG-AUDIT-R1 非 approved 时 verify 非 0 |
 | **D5** | 改码任务测试声明 | 仅 `--task`：`test_strategy=required` 但无测试/CI 引用时 verify 非 0 |
 | **reviews** | R<n> 审查文存在 | `--task` 与全量（v2.9+）· 缺文 BLOCKED · `--allow-no-review` |
+| **invoke hats** | 多帽 invoke 集合 | `task close` 硬闸（v2.12+）· `verify --task` 仅 WARN · `lifecycle dry-run close` 旁路（v2.13） |
 | **active** | 任务发现 | 双路径 `docs/tasks/active` ∪ `docs/harness/tasks/active`（v2.9+） |
 | **S5** | Git 工作区干净 | dirty 时 warn（不直接 fail verify，但 apply 须 `--force`） |
 | **lint** | task 结构（仅 `--task`） | v2.7+ E 级 → `WARN: task lint`（不改 exit / `may_start_30`） |

package/docs/README.md

@@ -3,8 +3,9 @@
 | 项 | 内容 |
 | --- | --- |
 | **入口** | 本页 → **[方法论总指引](./methodology/README.md)** |
-| **接入** | [**USER_GUIDE v1.0**](./USER_GUIDE_v1.0_zh.md) · [`ONBOARDING.md`](./ONBOARDING.md) · [`../wizard/README.md`](../wizard/README.md) |
+| **接入** | [**USER_GUIDE v1.0**](./USER_GUIDE_v1.0_zh.md)（§6.0 invoke 留档 · lifecycle）· [`ONBOARDING.md`](./ONBOARDING.md) · [`../wizard/README.md`](../wizard/README.md) |
 | **架构** | [`ARCHITECTURE.md`](./ARCHITECTURE.md) |
+| **变更** | [`../CHANGELOG.md`](../CHANGELOG.md) · 当前包 **2.13.0** |
 
 ---
 
@@ -13,9 +14,16 @@
 | 读者 | 先读 |
 | --- | --- |
 | **新接入** | **USER_GUIDE v1.0** → ONBOARDING → [`methodology/execution/P0_V0.2_GAP.md`](./methodology/execution/P0_V0.2_GAP.md) |
-| **实现 / 扩展** | [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
+| **实现 / 扩展** | [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md) · [`spec/`](./spec/)（闸 SPEC） |
 | **战略 / 开源** | [`methodology/pointers/`](./methodology/pointers/README.md) → 工作区 STRATEGY_* |
-| **HGM 远期** | [`methodology/graph/`](./methodology/graph/README.md) |
+| **HGM 远期** | [`methodology/graph/`](./methodology/graph/README.md) · 愿景 [`ROADMAP_TO_AGENT_GOVERNANCE.md`](./ROADMAP_TO_AGENT_GOVERNANCE.md) |
+
+### 近期产品说明（2.12–2.13）
+
+| 主题 | 文档 |
+|------|------|
+| 多帽 invoke 留档硬闸 | USER_GUIDE §6.0 · [`SPEC-invoke-hats-retention-gate_v1.md`](./spec/SPEC-invoke-hats-retention-gate_v1.md) |
+| dry-run 接线 close | [`SPEC-lifecycle-dry-run-close_v1.md`](./spec/SPEC-lifecycle-dry-run-close_v1.md) · ONBOARDING §2.2 |
 
 ---
 
@@ -26,6 +34,8 @@ docs/
 ├── README.md                 # 本页
 ├── ARCHITECTURE.md           # 五轨 · 与业务仓关系
 ├── ONBOARDING.md             # 接入指南
+├── USER_GUIDE_v1.0_zh.md     # 陌生人手册
+├── spec/                     # 产品闸 SPEC（signed）
 ├── DESIGN_ONTOLOGY_v1_zh.md  # POINTER → methodology/product/
 ├── P0_V0.2_GAP.md            # POINTER → methodology/execution/
 ├── HARNESS_GRAPH_MODEL_*.md  # POINTER → methodology/graph/
@@ -35,4 +45,4 @@ docs/
     └── prompts/              # Agent 写作 / 讨论 Prompt
 ```
 
-**修订**：2026-06-15 · 方法论归集至 `methodology/`
+**修订**：2026-07-26 · 对齐 2.12–2.13 · 索引 SPEC

package/docs/ROADMAP_TO_AGENT_GOVERNANCE.md

@@ -31,23 +31,23 @@ cyning-harness 已经通过 HumanGate、AuditReview、InvokeSnapshot 等实体
 
 ## 2. 三阶段演进路径
 
-### 阶段 0：当前状态（v0.2 – v0.4）
+### 阶段 0：当前状态（纪律包 · npm 2.x）
 
 | 项 | 内容 |
 | --- | --- |
 | **形态** | 项目纪律包，需手动绑定到仓库，要求开发者遵循 SDD 帽链 |
+| **当前包** | `@cyning/harness@2.13+`（以 npm / CHANGELOG 为准；本文档为愿景，非 semver 承诺） |
 
-**能力**：
+**能力**（摘要）：
 
-- ProcessTrack + StarterHat（10/22/30/40）
-- HumanGate 与 AuditReview 落盘
-- Sync 机制（S1–S6）
-- 基础 ICVO 映射
+- ProcessTrack + StarterHat（10/20/30/40）+ HumanGate / AuditReview / InvokeSnapshot
+- Sync（S1–S6）· ICVO verify / audit · lifecycle dry-run（to_30 · close_*）
+- 多帽 invoke 留档硬闸（close · v2.12+）
 
 **限制**：
 
 - 必须有人参与闸门审批（HumanGate）
-- 未与 Agent 运行时集成
+- 未与 Agent 运行时集成；dry-run **无** `--apply` / G7 runner
 
 ---
 

package/docs/USER_GUIDE_v1.0_zh.md

@@ -190,7 +190,7 @@ Schema：[`schema/verify_result.v1.schema.json`](../schema/verify_result.v1.sche
 | `npx @cyning/harness verify` | 全量：双路径 + reviews（v2.9+）；`--task`：30 前聚合 + invoke hats WARN（v2.12+）；`--spec`：SPEC→00（v2.8+ · 互斥） |
 | `npx @cyning/harness task close` | 受闸归档；v2.12+ 按 `required_invoke_hats` / `invoke_retention_profile` 校验多帽 invoke（缺省 `10,30,40`；`--allow-invoke-gap`） |
 | `npx @cyning/harness lifecycle show` | 只读展示 `harness/lifecycle.yaml`（登记 · v2.7+） |
-| `npx @cyning/harness lifecycle dry-run` | 转移资格判定（引擎消费 yaml · v2.10+ · 旁路 · 非 G7） |
+| `npx @cyning/harness lifecycle dry-run` | 转移资格判定（v2.10+ · `to_30` v2.11 · **`close_*` v2.13** · 旁路 · 非 G7） |
 | `npx @cyning/harness discipline show` | 只读展示 `harness/discipline-coverage.yaml`（v2.11+ · 非 audit UI） |
 | `npx @cyning/harness gate-check` | 仅人工闸（`--graph` / `--json`） |
 | `npx @cyning/harness audit` | ICVO 机械审计（D3/D5/S5） |
@@ -207,6 +207,27 @@ 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。
+
+归档前可用旁路资格报告（**不** mv、**不**替代 `task close`）：
+
+```bash
+npx @cyning/harness lifecycle dry-run --transition close --from done --task docs/tasks/active/task_xxx.md
+# 可选：--allow-invoke-gap · --allow-unchecked · --allow-no-review
+```
+
 ### 6.1 SDD-Compliance bench（维护者 · 可选）
 
 > **业务仓日常不必跑**；用于验证 `gate-check` / `sync` 公理行为，或对照 README「试点证据」中的 bench 数字。

package/docs/spec/SPEC-lifecycle-dry-run-close_v1.md

@@ -0,0 +1,63 @@
+# SPEC：lifecycle dry-run 接线 close_*（v1）
+
+> **状态**：`signed`  
+> **track**：`feature`  
+> **前置**：`@cyning/harness@2.12.1`（invoke hats 硬闸）· dry-run 骨架 `2.10` · to_30 扩面 `2.11`  
+> **下游**：30 实现 → 测试 → docs → **2.13.0**  
+> **关联**：[`SPEC-lifecycle-guard-expand_v1.md`](./SPEC-lifecycle-guard-expand_v1.md) residual · [`SPEC-invoke-hats-retention-gate_v1.md`](./SPEC-invoke-hats-retention-gate_v1.md)
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **spec_slug** | `lifecycle-dry-run-close` |
+| **test_strategy** | `required` |
+| **test_strategy_note** | close 转移各 close_* 守卫 pass/fail/warn；豁免旗；无 --apply |
+| **skip_spec_audit** | `true` |
+
+---
+
+## 1. 背景与目标
+
+`lifecycle dry-run` 对 `close` 转移的 `close_*` 仍全部 `unevaluated`，与 `task close` 硬闸脱节。  
+**一句话**：`--task` + `close` + `from=done` 时，把 yaml 登记的 close 守卫接到与 `task close` **同语义**的薄 adapter（旁路报告 · 不 mv · 无 `--apply`）。
+
+---
+
+## 2. 范围
+
+| guard id | 语义 | allow |
+|----------|------|-------|
+| `close_invoke` | invoke hats 集合覆盖（v2.12+） | `--allow-invoke-gap` |
+| `close_self_check` | 自检结论已回填 | — |
+| `close_acceptance` | 验收勾选 | `--allow-unchecked` |
+| `close_slug` | task_slug 与文件名一致 | — |
+| `close_status` | 状态 done/completed | — |
+| `close_review` | R\<n\> 审查文存在 | `--allow-no-review` |
+
+- 复用 `task-close` 检查逻辑（抽 `evaluateCloseChecks`，禁止复制分叉）
+- CLI `lifecycle dry-run` 透传上述 allow 旗
+- CHANGELOG **2.13.0** · README / USER_GUIDE / ONBOARDING / docs 索引同步
+
+---
+
+## 3. 非范围
+
+- `--apply` / 写盘 / G7 runner
+- 改 `task close` / `verify` 硬闸语义
+- N2-C · `to_00` 接线 · `audit --discipline` UI
+
+---
+
+## 4. 验收
+
+- [x] `close` + 齐全 fixture → 全部 close_* 非 `unevaluated` · `unevaluated_count=0` · exit 0
+- [x] 仅缺 invoke hats → `close_invoke=fail` · blocked
+- [x] `--allow-invoke-gap` → `close_invoke=warn` · 不 block
+- [x] 状态非 done → `close_status=fail`
+- [x] 无 `--task`：仍 unevaluated
+- [x] `npm test` 全绿 · README 版本表与 CLI 说明已更新
+
+> **实现**：`@cyning/harness@2.13.0` · `evaluateCloseChecks` + lifecycle adapters。

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.13.0"
 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

@@ -3,7 +3,8 @@
 # 登记真值：状态 / 转移 / 守卫。yaml 本身不是引擎。
 # 由 `lifecycle dry-run` 引擎消费（v2.10+ · 资格判定旁路报告 · 不写盘）。
 # v2.11+ to_30 已接线：HG-AUDIT-R1 · HG-TASK-DRAFT · reviews_retention · audit_D5 · task_lint
-#   （close_* / 可选 to_00 仍可 unevaluated）
+# v2.13+ close 已接线：close_invoke · close_self_check · close_acceptance · close_slug · close_status · close_review
+#   （to_00 / spec_reviews_retention 仍可 unevaluated）
 # 只读展示：npx @cyning/harness lifecycle show [--json]
 # Schema：schema/lifecycle.v1.schema.json
 
@@ -69,11 +70,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/cli.js

@@ -531,9 +531,10 @@ async function cmdLifecycle(args) {
   npx @cyning/harness lifecycle show [--json]
   npx @cyning/harness lifecycle dry-run --transition ID --from STATE [--task PATH] [--json]
        [--allow-no-review] [--allow-lint-fail] [--allow-no-spec-review]
+       [--allow-invoke-gap] [--allow-unchecked]
 
 show     · 只读展示 harness/lifecycle.yaml（登记真值 · v2.7+）
-dry-run  · 转移资格判定（引擎消费 yaml · v2.10+ · 旁路报告 · 非 runner / 非 G7）
+dry-run  · 转移资格判定（引擎消费 yaml · v2.10+ · to_30 v2.11+ · close_* v2.13+ · 旁路 · 非 G7）
 `);
     return;
   }
@@ -567,12 +568,16 @@ dry-run  · 转移资格判定（引擎消费 yaml · v2.10+ · 旁路报告 ·
     const allowNoReview = remaining.includes('--allow-no-review');
     const allowLintFail = remaining.includes('--allow-lint-fail');
     const allowNoSpecReview = remaining.includes('--allow-no-spec-review');
+    const allowInvokeGap = remaining.includes('--allow-invoke-gap');
+    const allowUnchecked = remaining.includes('--allow-unchecked');
     remaining = remaining.filter(
       (a) =>
         a !== '--json' &&
         a !== '--allow-no-review' &&
         a !== '--allow-lint-fail' &&
-        a !== '--allow-no-spec-review',
+        a !== '--allow-no-spec-review' &&
+        a !== '--allow-invoke-gap' &&
+        a !== '--allow-unchecked',
     );
     if (remaining.length > 0) {
       const err = new Error(`lifecycle dry-run 未知参数: ${remaining.join(' ')}`);
@@ -591,7 +596,13 @@ dry-run  · 转移资格判定（引擎消费 yaml · v2.10+ · 旁路报告 ·
       transitionId,
       fromState,
       taskPath,
-      flags: { allowNoReview, allowLintFail, allowNoSpecReview },
+      flags: {
+        allowNoReview,
+        allowLintFail,
+        allowNoSpecReview,
+        allowInvokeGap,
+        allowUnchecked,
+      },
       cwd: process.cwd(),
     });
 

package/lib/lifecycle.js

@@ -5,6 +5,7 @@ import { runTestCheck } from './audit.js';
 import { resolveHarnessRoot } from './paths.js';
 import { findReview, parseHumanGates } from './task-meta.js';
 import { lintTaskFile } from './task-lint.js';
+import { evaluateCloseChecks } from './task-close.js';
 
 const SEVERITIES = new Set(['block', 'warn']);
 
@@ -123,13 +124,19 @@ export function formatLifecycleShow(data) {
   return lines.join('\n').trimEnd();
 }
 
-/** 已接线的守卫（未登记者 → unevaluated；close_* 本波仍未接线） */
+/** 已接线的守卫（未登记者 → unevaluated） */
 const GUARD_ADAPTERS = {
   'HG-AUDIT-R1': evaluateHgGate('HG-AUDIT-R1'),
   'HG-TASK-DRAFT': evaluateHgGate('HG-TASK-DRAFT'),
   reviews_retention: evaluateReviewsRetention,
   audit_D5: evaluateAuditD5,
   task_lint: evaluateTaskLint,
+  close_invoke: evaluateCloseGuard('close_invoke'),
+  close_self_check: evaluateCloseGuard('close_self_check'),
+  close_acceptance: evaluateCloseGuard('close_acceptance'),
+  close_slug: evaluateCloseGuard('close_slug'),
+  close_status: evaluateCloseGuard('close_status'),
+  close_review: evaluateCloseGuard('close_review'),
 };
 
 function findRepoRootFromTask(absTask) {
@@ -146,6 +153,8 @@ function flagsAllow(flags, allowFlag) {
   if (allowFlag === '--allow-no-review') return Boolean(flags.allowNoReview);
   if (allowFlag === '--allow-lint-fail') return Boolean(flags.allowLintFail);
   if (allowFlag === '--allow-no-spec-review') return Boolean(flags.allowNoSpecReview);
+  if (allowFlag === '--allow-invoke-gap') return Boolean(flags.allowInvokeGap);
+  if (allowFlag === '--allow-unchecked') return Boolean(flags.allowUnchecked);
   return false;
 }
 
@@ -207,6 +216,19 @@ function evaluateTaskLint({ taskPath, target }) {
   }
 }
 
+/** close_* · 复用 evaluateCloseChecks（与 task close 同语义） */
+function evaluateCloseGuard(checkId) {
+  return ({ taskPath, closeEval, target, cwd }) => {
+    const ev =
+      closeEval ?? evaluateCloseChecks(taskPath, { cwd: target ?? cwd });
+    const c = ev.checks[checkId];
+    if (!c) {
+      return { status: 'fail', detail: `未知 close 检查: ${checkId}` };
+    }
+    return { status: c.status, detail: c.detail };
+  };
+}
+
 /**
  * 转移 dry-run（引擎最小骨架 · v2.10+）。
  * 默认不写盘；无 --apply。
@@ -216,7 +238,13 @@ function evaluateTaskLint({ taskPath, target }) {
  *   fromState: string,
  *   taskPath?: string,
  *   harnessRoot?: string,
- *   flags?: { allowNoReview?: boolean, allowLintFail?: boolean, allowNoSpecReview?: boolean },
+ *   flags?: {
+ *     allowNoReview?: boolean,
+ *     allowLintFail?: boolean,
+ *     allowNoSpecReview?: boolean,
+ *     allowInvokeGap?: boolean,
+ *     allowUnchecked?: boolean,
+ *   },
  *   cwd?: string,
  * }} options
  */
@@ -282,6 +310,10 @@ export function dryRunTransition(options = {}) {
 
   const canEval = Boolean(absTask);
   const target = absTask ? findRepoRootFromTask(absTask) ?? cwd : cwd;
+  const closeEval =
+    canEval && transition.id === 'close'
+      ? evaluateCloseChecks(absTask, { cwd: target })
+      : null;
   const guards = [];
 
   for (const g of transition.guards) {
@@ -303,6 +335,7 @@ export function dryRunTransition(options = {}) {
       flags,
       guard: g,
       cwd,
+      closeEval,
     });
 
     let status = evaluated.status;

package/lib/task-close.js

@@ -14,95 +14,108 @@ import {
 } from './task-meta.js';
 
 /**
- * task close 机械校验 + 归档执行。
- * 任一校验失败 → ok:false + blockers[]，绝不 mv。
- * 默认 dry-run（只检不 mv）；yes=true 才执行归档。
+ * close 机械校验（结构化 · 供 task close 与 lifecycle dry-run 共用）。
+ * 不应用 --allow-*（豁免由调用方处理）；不 mv。
+ *
+ * @returns {{
+ *   file: string,
+ *   slug: string|null,
+ *   fileSlug: string,
+ *   repoRoot: string|null,
+ *   inActive: boolean,
+ *   invoke_hats: object|null,
+ *   checks: Record<string, { status: 'pass'|'fail', detail: string }>,
+ * }}
  */
-export function closeTaskFile(filePath, options = {}) {
-  const {
-    yes = false,
-    target: targetArg,
-    allowUnchecked = false,
-    allowNoReview = false,
-    allowInvokeGap = false,
-    cwd = process.cwd(),
-  } = options;
-
+export function evaluateCloseChecks(filePath, options = {}) {
+  const { cwd = process.cwd() } = options;
   const abs = path.resolve(cwd, filePath);
-  const blockers = [];
-  const warnings = [];
+
+  const emptyFail = (detail) => ({
+    file: abs,
+    slug: null,
+    fileSlug: extractTaskSlug(abs),
+    repoRoot: null,
+    inActive: false,
+    invoke_hats: null,
+    checks: {
+      close_invoke: { status: 'fail', detail },
+      close_self_check: { status: 'fail', detail },
+      close_acceptance: { status: 'fail', detail },
+      close_slug: { status: 'fail', detail },
+      close_status: { status: 'fail', detail },
+      close_review: { status: 'fail', detail },
+    },
+  });
 
   if (!fs.existsSync(abs)) {
-    return {
-      ok: false,
-      blockers: [`task 文件不存在: ${filePath}`],
-      warnings,
-      file: abs,
-      slug: extractTaskSlug(abs),
-      dest: null,
-      dryRun: !yes,
-      moved: false,
-    };
+    return emptyFail(`task 文件不存在: ${filePath}`);
   }
 
   const content = fs.readFileSync(abs, 'utf8');
   const meta = parseHarnessMeta(content);
   const fileSlug = extractTaskSlug(abs);
   const slug = meta.task_slug ?? null;
+  const activeDir = path.dirname(abs);
+  const inActive = path.basename(activeDir) === 'active';
+  const repoRoot = findRepoRoot(activeDir);
+
+  const checks = {};
 
-  // 检查 4 · task_slug 一致（下划线/连字符惯例等价）
+  // close_slug
   if (!slug) {
-    blockers.push('Harness 元信息表缺 task_slug');
+    checks.close_slug = { status: 'fail', detail: 'Harness 元信息表缺 task_slug' };
   } else if (normalizeSlug(slug) !== normalizeSlug(fileSlug)) {
-    blockers.push(`slug 不一致: 文件名 ${fileSlug} ≠ 元信息 task_slug ${slug}`);
+    checks.close_slug = {
+      status: 'fail',
+      detail: `slug 不一致: 文件名 ${fileSlug} ≠ 元信息 task_slug ${slug}`,
+    };
+  } else {
+    checks.close_slug = { status: 'pass', detail: `slug=${slug}` };
   }
 
-  // 布局推导：active/ 同级 done/ · repo root（docs 祖先）
-  const activeDir = path.dirname(abs);
-  const inActive = path.basename(activeDir) === 'active';
-  const repoRoot = findRepoRoot(activeDir);
-
-  // 检查 1 · invoke 留档（v2.12+：按 required_invoke_hats / profile 集合覆盖）
+  // close_invoke
   let invokeHatsEval = null;
   if (!repoRoot) {
-    blockers.push(`无法定位 repo root（${activeDir} 无 docs 祖先）`);
-  } else if (slug) {
-    const invokeDir = path.join(
-      repoRoot,
-      'docs/harness/invokes/by-task',
-      slug,
-    );
+    checks.close_invoke = {
+      status: 'fail',
+      detail: `无法定位 repo root（${activeDir} 无 docs 祖先）`,
+    };
+  } else if (!slug) {
+    checks.close_invoke = { status: 'fail', detail: '无 task_slug · 无法解析 invoke 目录' };
+  } else {
+    const invokeDir = path.join(repoRoot, 'docs/harness/invokes/by-task', slug);
     invokeHatsEval = evaluateInvokeHatsRetention(meta, invokeDir);
     const relDir = path.relative(repoRoot, invokeDir).replace(/\\/g, '/');
     if (invokeHatsEval.missingDir || invokeHatsEval.files.length === 0) {
-      const msg = `missing invoke snapshots: ${relDir} 不存在或无 .md（要求 hats: ${invokeHatsEval.required.join(',')})`;
-      if (allowInvokeGap) {
-        warnings.push(`warn: ${msg}（--allow-invoke-gap 豁免 · 留痕）`);
-      } else {
-        blockers.push(msg);
-      }
+      checks.close_invoke = {
+        status: 'fail',
+        detail: `missing invoke snapshots: ${relDir} 不存在或无 .md（要求 hats: ${invokeHatsEval.required.join(',')})`,
+      };
     } else if (invokeHatsEval.missing.length > 0) {
-      const msg =
-        `missing invoke hats: ${invokeHatsEval.missing.join(',')} ` +
-        `（要求 ${invokeHatsEval.required.join(',')} · 已有 ${invokeHatsEval.covered.join(',') || '∅'} · ` +
-        `source=${invokeHatsEval.resolution.source}` +
-        `${invokeHatsEval.resolution.unknown_profile ? ` · unknown_profile=${invokeHatsEval.resolution.unknown_profile}` : ''}）`;
-      if (allowInvokeGap) {
-        warnings.push(`warn: ${msg}（--allow-invoke-gap 豁免 · 留痕）`);
-      } else {
-        blockers.push(msg);
-      }
-    } else if (invokeHatsEval.resolution.unknown_profile) {
-      warnings.push(
-        `warn: unknown invoke_retention_profile '${invokeHatsEval.resolution.unknown_profile}' · 已回退 default`,
-      );
+      checks.close_invoke = {
+        status: 'fail',
+        detail:
+          `missing invoke hats: ${invokeHatsEval.missing.join(',')} ` +
+          `（要求 ${invokeHatsEval.required.join(',')} · 已有 ${invokeHatsEval.covered.join(',') || '∅'} · ` +
+          `source=${invokeHatsEval.resolution.source}` +
+          `${invokeHatsEval.resolution.unknown_profile ? ` · unknown_profile=${invokeHatsEval.resolution.unknown_profile}` : ''}）`,
+      };
+    } else {
+      const note = invokeHatsEval.resolution.unknown_profile
+        ? ` · unknown_profile=${invokeHatsEval.resolution.unknown_profile} 已回退 default`
+        : '';
+      checks.close_invoke = {
+        status: 'pass',
+        detail: `hats ok · ${invokeHatsEval.required.join(',')}${note}`,
+      };
     }
   }
 
-  // 检查 2 · 自检结论回填
+  // close_self_check
   const selfCheck = extractSection(content, '### 自检结论', '\n##');
   if (!selfCheck) {
-    blockers.push('缺 ### 自检结论 节');
+    checks.close_self_check = { status: 'fail', detail: '缺 ### 自检结论 节' };
   } else {
     const bodyLines = selfCheck
       .split('\n')
@@ -111,53 +124,146 @@ export function closeTaskFile(filePath, options = {}) {
       .filter(Boolean);
     const substantive = bodyLines.filter((l) => !PLACEHOLDER_RE.test(l));
     if (substantive.length === 0) {
-      blockers.push('自检结论未回填（空或纯占位符）');
+      checks.close_self_check = {
+        status: 'fail',
+        detail: '自检结论未回填（空或纯占位符）',
+      };
+    } else {
+      checks.close_self_check = { status: 'pass', detail: '自检结论已回填' };
     }
   }
 
-  // 检查 3 · 验收标准勾选
+  // close_acceptance
   const acceptance = extractSection(content, '## 验收标准', '\n##');
   if (!acceptance) {
-    blockers.push('缺 ## 验收标准 节');
+    checks.close_acceptance = { status: 'fail', detail: '缺 ## 验收标准 节' };
   } else {
-    const unchecked = acceptance
-      .split('\n')
-      .filter((l) => UNCHECKED_RE.test(l));
+    const unchecked = acceptance.split('\n').filter((l) => UNCHECKED_RE.test(l));
     if (unchecked.length > 0) {
-      if (allowUnchecked) {
-        warnings.push(`warn: 验收标准 ${unchecked.length} 项未勾选（--allow-unchecked 豁免）`);
-      } else {
-        blockers.push(
-          `验收标准 ${unchecked.length} 项未勾选（或 --allow-unchecked 显式豁免）`,
-        );
-      }
+      checks.close_acceptance = {
+        status: 'fail',
+        detail: `验收标准 ${unchecked.length} 项未勾选`,
+      };
+    } else {
+      checks.close_acceptance = { status: 'pass', detail: '验收标准已勾选' };
     }
   }
 
-  // 检查 5 · 状态字段
+  // close_status
   const statusLine = content.split('\n').find((l) => STATUS_RE.test(l));
   const status = statusLine ? statusLine.match(STATUS_RE)[1].toLowerCase() : null;
   if (!status) {
-    blockers.push('未找到 > **状态** 行');
+    checks.close_status = { status: 'fail', detail: '未找到 > **状态** 行' };
   } else if (!CLOSE_STATUSES.has(status)) {
-    blockers.push(`状态非 done/completed（当前: ${status}）`);
+    checks.close_status = {
+      status: 'fail',
+      detail: `状态非 done/completed（当前: ${status}）`,
+    };
+  } else {
+    checks.close_status = { status: 'pass', detail: `status=${status}` };
   }
 
-  // 检查 6 · R<n> 审查文留档（G2 · v2.5+）
-  if (repoRoot) {
+  // close_review
+  if (!repoRoot) {
+    checks.close_review = {
+      status: 'fail',
+      detail: '无法定位 repo root · 无法查 reviews',
+    };
+  } else {
     const review = findReview(repoRoot, abs);
-    if (!review.found) {
-      if (allowNoReview) {
-        warnings.push('warn: missing R<n> review（--allow-no-review 豁免 · 留痕）');
-      } else {
-        blockers.push(
-          'missing R<n> review（docs/harness/reviews/ 无该 task 的 _audit_R 文件 · 或 --allow-no-review）',
+    if (review.found) {
+      checks.close_review = { status: 'pass', detail: review.latest };
+    } else {
+      checks.close_review = { status: 'fail', detail: 'missing R<n> review' };
+    }
+  }
+
+  return {
+    file: abs,
+    slug: slug ?? fileSlug,
+    fileSlug,
+    repoRoot,
+    inActive,
+    invoke_hats: invokeHatsEval
+      ? {
+          required: invokeHatsEval.required,
+          covered: invokeHatsEval.covered,
+          missing: invokeHatsEval.missing,
+          source: invokeHatsEval.resolution.source,
+        }
+      : null,
+    checks,
+  };
+}
+
+/**
+ * task close 机械校验 + 归档执行。
+ * 任一校验失败 → ok:false + blockers[]，绝不 mv。
+ * 默认 dry-run（只检不 mv）；yes=true 才执行归档。
+ */
+export function closeTaskFile(filePath, options = {}) {
+  const {
+    yes = false,
+    target: targetArg,
+    allowUnchecked = false,
+    allowNoReview = false,
+    allowInvokeGap = false,
+    cwd = process.cwd(),
+  } = options;
+
+  const abs = path.resolve(cwd, filePath);
+  const blockers = [];
+  const warnings = [];
+
+  if (!fs.existsSync(abs)) {
+    return {
+      ok: false,
+      blockers: [`task 文件不存在: ${filePath}`],
+      warnings,
+      file: abs,
+      slug: extractTaskSlug(abs),
+      dest: null,
+      dryRun: !yes,
+      moved: false,
+    };
+  }
+
+  const evaluated = evaluateCloseChecks(filePath, { cwd });
+  const { checks, inActive, slug, fileSlug, invoke_hats: invokeHats } = evaluated;
+
+  const pushCheck = (id, allow, allowLabel) => {
+    const c = checks[id];
+    if (!c) return;
+    if (c.status === 'pass') {
+      if (id === 'close_invoke' && /unknown_profile=/.test(c.detail)) {
+        warnings.push(
+          `warn: unknown invoke_retention_profile（已回退 default）· ${c.detail}`,
         );
       }
+      return;
     }
-  }
+    if (allow) {
+      warnings.push(`warn: ${c.detail}（${allowLabel} 豁免 · 留痕）`);
+    } else {
+      blockers.push(
+        id === 'close_acceptance'
+          ? `${c.detail}（或 --allow-unchecked 显式豁免）`
+          : id === 'close_review'
+            ? 'missing R<n> review（docs/harness/reviews/ 无该 task 的 _audit_R 文件 · 或 --allow-no-review）'
+            : c.detail,
+      );
+    }
+  };
 
-  // 归档目标
+  pushCheck('close_slug', false);
+  pushCheck('close_invoke', allowInvokeGap, '--allow-invoke-gap');
+  pushCheck('close_self_check', false);
+  pushCheck('close_acceptance', allowUnchecked, '--allow-unchecked');
+  pushCheck('close_status', false);
+  pushCheck('close_review', allowNoReview, '--allow-no-review');
+
+  // 归档目标（布局约束 · 非 yaml 守卫）
+  const activeDir = path.dirname(abs);
   let dest = null;
   if (targetArg) {
     dest = path.resolve(cwd, targetArg);
@@ -187,14 +293,7 @@ export function closeTaskFile(filePath, options = {}) {
     dest,
     dryRun: !yes,
     moved,
-    invoke_hats: invokeHatsEval
-      ? {
-          required: invokeHatsEval.required,
-          covered: invokeHatsEval.covered,
-          missing: invokeHatsEval.missing,
-          source: invokeHatsEval.resolution.source,
-        }
-      : null,
+    invoke_hats: invokeHats,
   };
 }
 

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.13.0",
   "description": "cyning-harness discipline package · init / upgrade / check CLI",
   "license": "MIT",
   "type": "module",