@cyning/harness 2.10.0 → 2.11.1

package/CHANGELOG.md

@@ -4,6 +4,35 @@
 
 ## [Unreleased]
 
+## [2.11.1] - 2026-07-25
+
+### Fixed
+
+- **F1 · `upgrade` 自绊 S5（ops-desk-web dogfood）**：`local.json` 改为 **sync apply 成功后** 写入（compare-before-write）。避免 npx 缓存路径变化时先脏工作区再被 git-clean 中止。
+- **F2 · manifest 静默丢字段**：`write_manifest_upgrade` 重写前对 schema 外字段与 `ide` 裁剪打 **WARN** 清单（知情）；**仍不**合并保留（`additionalProperties: false`）。
+
+### Notes
+
+- 摩擦报告：`Projects/docs/harness/guides/ANALYSIS_upgrade_wizard_friction_20260725_v1_zh.md`
+- patch · 2.3+ manifest 仅五字段：`version` / `preset` / `ide` / `from_version` / `upgraded_at`（`name` / `tech_graph_dir` / `tasks_dir` / `hooks` 等已废弃）
+
+## [2.11.0] - 2026-07-25
+
+### Added
+
+- **`discipline show [--json]`（Post-2.10 Epic E）**：只读展示 `harness/discipline-coverage.yaml`（镜像 `lifecycle show`）。**无** `audit --discipline` UI。
+
+### Changed
+
+- **`lifecycle dry-run` 守卫扩面（Post-2.10 Epic A）**：`--task` + `to_30` 增接 `HG-TASK-DRAFT` · `audit_D5` · `task_lint`（与既有 `HG-AUDIT-R1` / `reviews_retention`）。`task_lint` 仍为 yaml **warn**；`--allow-lint-fail` 可将 fail 豁免为 warn。`close_*` 仍 `unevaluated`。**无** `--apply` / G7 / N2-C。
+
+### Notes
+
+- SPEC：`docs/spec/SPEC-lifecycle-guard-expand_v1.md` · `docs/spec/SPEC-discipline-show_v1.md`
+- minor · `lifecycle show` / verify 硬闸语义不变
+- `discipline-coverage.yaml` `as_of_package_version` → **2.11.0**
+- **已发布**：`@cyning/harness@2.11.0`（npm `latest` · 2026-07-25）· tag `v2.11.0` 已推送
+
 ## [2.10.0] - 2026-07-25
 
 ### Added
@@ -19,8 +48,8 @@
 ### Notes
 
 - SPEC：`docs/spec/SPEC-lifecycle-engine-min_v1.md` · `docs/spec/SPEC-discipline-coverage-yaml_v1.md`
-- Epic 统一发版窗 · 维护者 publish 前复检
 - minor · `lifecycle show` 行为不变
+- **已发布**：`@cyning/harness@2.10.0`（npm `latest` · 2026-07-25）· tag `v2.10.0` 已推送
 
 ## [2.9.0] - 2026-07-25
 

package/docs/ARCHITECTURE.md

@@ -68,5 +68,5 @@ CLI/Worker 与模板 **同一仓库** 演进，避免多仓割裂。
 Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.3**）。  
 **帽链流程（人读）**：[`methodology/product/SDD_HAT_FLOW_v2_zh.md`](./methodology/product/SDD_HAT_FLOW_v2_zh.md)  
 **方法论总指引**：[`methodology/README.md`](./methodology/README.md) · 关系图 [`methodology/DOCUMENT_MAP_v1_zh.md`](./methodology/DOCUMENT_MAP_v1_zh.md)  
-远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（HGM · **v2.0+** 提案 · v1.0 后）。  
+远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（**PIP（过程实例投影）** · **v2.0+** · v1.0 后）。  
 与 **战略本体**（工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_*`）分层：本文件描述 **产品如何实现**，战略文档描述 **对外演进**。

package/docs/ONBOARDING.md

@@ -26,6 +26,10 @@ npx @cyning/harness check    # 仅检查是否有新版本
 写入 `.cyning-harness/manifest.json`（钉版本 · preset · ide）与 `profile.json`。  
 Schema：[`schema/manifest.v1.schema.json`](../schema/manifest.v1.schema.json)
 
+**manifest（2.3+）仅五字段**：`version` / `preset` / `ide` / `from_version` / `upgraded_at`（`additionalProperties: false`）。  
+旧字段 `name` / `harness_version` / `tech_graph_dir` / `tasks_dir` / `hooks` 已废弃且无消费方；`upgrade` 会整体重写并（v2.11.1+）对将被移除的字段打 WARN，**不会**合并保留。  
+`upgrade` 的 `local.json` 簿记在 sync apply **成功之后**写入（v2.11.1+），避免自绊 S5 git-clean。
+
 **维护者 / 离线 · clone 路径：**
 
 ```bash
@@ -63,11 +67,16 @@ npx @cyning/harness verify --spec docs/spec/SPEC-xxx_v1.md \
 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）
 npx @cyning/harness lifecycle dry-run --transition to_30 --from draft \
   --task docs/tasks/active/task_xxx.md
 # 无 --task：仅结构 + 守卫清单 unevaluated
 npx @cyning/harness lifecycle dry-run --transition to_30 --from draft
 
+# 机械化率资产只读（v2.11+ · SoT=discipline-coverage.yaml）
+npx @cyning/harness discipline show
+npx @cyning/harness discipline show --json
+
 # 仅人工闸
 npx @cyning/harness gate-check --target /path/to/your-repo
 npx @cyning/harness gate-check --graph --target /path/to/your-repo
@@ -90,6 +99,7 @@ npx @cyning/harness sync index --target /path/to/your-repo
 | **lint** | task 结构（仅 `--task`） | v2.7+ E 级 → `WARN: task lint`（不改 exit / `may_start_30`） |
 
 生命周期真值：[`harness/lifecycle.yaml`](../harness/lifecycle.yaml)（`lifecycle show` 只读 · `lifecycle dry-run` 资格判定 v2.10+）。
+机械化率资产：[`harness/discipline-coverage.yaml`](../harness/discipline-coverage.yaml)（`discipline show` 只读 · v2.11+）。
 
 机械化率覆盖资产（Starter）：[`harness/discipline-coverage.yaml`](../harness/discipline-coverage.yaml)（SoT · 随版本改 statements/gaps；**无** audit UI）。
 

package/docs/USER_GUIDE_v1.0_zh.md

@@ -133,6 +133,7 @@ npx @cyning/harness verify --target . \
 # 只读生命周期登记（方向二 · harness/lifecycle.yaml · 登记真值）
 npx @cyning/harness lifecycle show [--json]
 # 转移资格 dry-run（v2.10+ · 引擎消费 yaml · 旁路报告 · 非 runner / 非 G7）
+# v2.11+ to_30 已接线 HG-* / reviews / audit_D5 / task_lint（close_* 仍可 unevaluated）
 npx @cyning/harness lifecycle dry-run --transition to_30 --from draft \
   [--task docs/tasks/active/task_xxx.md] [--json] [--allow-no-review]
 
@@ -184,12 +185,12 @@ Schema：[`schema/verify_result.v1.schema.json`](../schema/verify_result.v1.sche
 | 命令 | 用途 |
 | --- | --- |
 | `npx @cyning/harness init` | 首次安装模板与 manifest（可选 `--with-scripts`） |
-| `npx @cyning/harness upgrade` | 同步产品包更新（可加 `--gate-check` 先 audit） |
+| `npx @cyning/harness upgrade` | 同步产品包更新（可加 `--gate-check`）；v2.11.1+：`local.json` 在 apply 后写入；manifest 重写前 WARN 非标准字段（2.3+ 仅五字段） |
 | `npx @cyning/harness check` | 检查是否有新版本 |
 | `npx @cyning/harness verify` | 全量：双路径 + reviews（v2.9+）；`--task`：30 前聚合；`--spec`：SPEC→00（v2.8+ · 互斥） |
 | `npx @cyning/harness lifecycle show` | 只读展示 `harness/lifecycle.yaml`（登记 · v2.7+） |
 | `npx @cyning/harness lifecycle dry-run` | 转移资格判定（引擎消费 yaml · v2.10+ · 旁路 · 非 G7） |
-| 机械化率资产 | 包内 `harness/discipline-coverage.yaml`（SoT · v2.10+ · 无 audit UI） |
+| `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） |
 | `npx @cyning/harness sync index` | 生成 `.cyning-harness/invoke_index.json` |
@@ -283,9 +284,9 @@ npm run harness -- check --target /tmp/foo
 | --- | --- | --- | --- |
 | **MD 人类轨** | `docs/_tech_graph/*.md` | 代码审阅、README 引用、Mermaid 渲染 | v1.0+ |
 | **YAML 编辑源** | `docs/_tech_graph/*.graph.yaml` | 结构化编辑、diff、CI 校验 | **v1.1+** |
-| **HGM 过程轨** | `.cyning-harness/events/*.jsonl` | Task / Gate / Review 实例与事件史 | **v2.0+** |
+| **PIP（过程实例投影）过程轨** | `.cyning-harness/events/*.jsonl` | Task / Gate / Review 实例与事件史 | **v2.0+** |
 
-**原则**：YAML 为 Inform 编辑源，HGM 为过程事件图；YAML **不替代** task/review 真值，HGM **不替代** YAML/MD Inform 正文。
+**原则**：YAML 为 Inform 编辑源，PIP（过程实例投影）为过程事件图；YAML **不替代** task/review 真值，PIP（过程实例投影）**不替代** YAML/MD Inform 正文。
 
 ### 10.2 最小工作流
 
@@ -326,9 +327,9 @@ npx @cyning/harness graph yaml check --all --input docs/_tech_graph
 | bench `100` | [SDD-Compliance](../examples/compliance_bench/README.md) 五场景合规率 · 见上文 §6.1 |
 | Extended 帽 | 00/50/链式 PROMPT 不在 Starter 默认包 · 见 [`harness/prompts/README.md`](../harness/prompts/README.md) |
 | Inform-YAML | **v1.1+** · 可选编辑源 · 须 `graph yaml check` 与 `graph.json` 一致 |
-| HGM / 图数据库 | **v2.0+ 已实现** `graph ingest|snapshot|axioms` · 本地 JSONL + snapshot；Neo4j / 远端同步 **仍提案** |
+| PIP（过程实例投影）/ 图数据库 | **v2.0+ 已实现** `graph ingest|snapshot|axioms` · 本地 JSONL + snapshot；Neo4j / 远端同步 **仍提案** |
 | Agent-shell | 研究轨 #9，非 npm 功能 |
-| rejected→draft | **v2.0.1+** bench S5 + HGM axioms 事件流精确匹配 |
+| rejected→draft | **v2.0.1+** bench S5 + PIP（过程实例投影）axioms 事件流精确匹配 |
 
 ---
 
@@ -349,21 +350,21 @@ A：不会（S2 域）。若 prompts 模板有更新，apply 会更新 **模板
 **Q：如何编辑 Inform 架构图？**  
 A：v1.1+ 可选 `docs/_tech_graph/*.graph.yaml` 作为编辑源，运行 `npx @cyning/harness graph yaml compile|check` 生成 MD / 校验 graph.json。
 
-**Q：HGM 与 Inform-YAML 是什么关系？**  
-A：Inform-YAML 是 **架构图谱** 的编辑源；HGM（v2.0+）是 **过程协作** 的事件图。二者并列，HGM 通过 `InformArtifact` 节点引用 Inform 产物，但不覆盖其正文。
+**Q：PIP（过程实例投影）与 Inform-YAML 是什么关系？**  
+A：Inform-YAML 是 **架构图谱** 的编辑源；PIP（过程实例投影，v2.0+）是 **过程协作** 的事件图。二者并列，PIP（过程实例投影）通过 `InformArtifact` 节点引用 Inform 产物，但不覆盖其正文。
 
 **Q：如何贡献或报 issue？**  
 A：GitHub [Cyning12/cyning-harness](https://github.com/Cyning12/cyning-harness) · MIT。
 
 ---
 
-## 13. HGM 过程轨（v2.0+）
+## 13. PIP（过程实例投影）过程轨（v2.0+）
 
-Harness Graph Model（HGM）把 task、gate、review、invoke、sync 等过程实例变成 **append-only 事件流** 与 **可重放图快照**，用于机械检查 SDD 公理。
+PIP（过程实例投影；Process Instance Projection）把 task、gate、review、invoke、sync 等过程实例变成 **append-only 事件流** 与 **可重放图快照**，用于机械检查 SDD 公理。
 
 ### 13.1 事件文件
 
-HGM 事件写入 `.cyning-harness/events/YYYY-MM.jsonl`，修正 = 追加 `CorrectionEvent`，**禁止删改历史**。
+PIP（过程实例投影） 事件写入 `.cyning-harness/events/YYYY-MM.jsonl`，修正 = 追加 `CorrectionEvent`，**禁止删改历史**。
 
 ### 13.2 CLI
 
@@ -396,7 +397,7 @@ chmod +x .git/hooks/pre-commit
 
 - `InformArtifact` 节点 ID：`inform:{repo_rel_path}`
 - Task → InformArtifact 边：`MUST_READ`
-- HGM **不存储** Inform 正文，只存路径指针与 schema 版本
+- PIP（过程实例投影）**不存储** Inform 正文，只存路径指针与 schema 版本
 
 ### 13.5 局限
 
@@ -431,4 +432,4 @@ chmod +x .git/hooks/pre-commit
 | 2026-06-16 | v1.0.1：verify / gate-check / sync index CLI · `--with-scripts` · QUICKREF |
 | 2026-06-17 | v1.1.0：新增 §10 Inform-YAML · `graph yaml compile|check` · 三轨边界说明 |
 | 2026-06-17 | v2.0.1：D4-a axioms · rejected→draft 精确化 · S5 bench · optional pre-commit hook |
-| 2026-06-17 | v2.0.0：新增 §13 HGM 过程轨 · `graph ingest|snapshot|axioms` · InformArtifact 与 MUST_READ 边 |
+| 2026-06-17 | v2.0.0：新增 §13 PIP（过程实例投影）过程轨 · `graph ingest|snapshot|axioms` · InformArtifact 与 MUST_READ 边 |

package/docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md

@@ -1,4 +1,6 @@
-# Harness Graph Model (HGM) · 设计草案 v0
+# PIP（过程实例投影；Process Instance Projection）· 设计草案 v0
+
+> 文件名历史：`HARNESS_GRAPH_MODEL_*`（路径兼容）。
 
 
 | 项        | 内容                                                                                                                               |
@@ -20,7 +22,7 @@
 ### 0.1 一句话
 
 ```text
-Harness Graph Model (HGM)
+PIP（过程实例投影）
   = OOP 的结构化对象（本体 Class 的实例）
   + 显式带类型的边（ObjectProperty · HatRef · 基数）
   + 不可变事件历史（append-only · 可重放投影）

package/docs/methodology/graph/README.md

@@ -1,6 +1,8 @@
-# graph · Harness Graph Model (HGM)
+# graph · PIP（过程实例投影；Process Instance Projection）
 
-> **Track G · G1 / v2.0+**：HGM 为 **v1.0 公理稳定后的可选增强**（proposal · 未实现）· 详见 [`../ROADMAP_v1_zh.md`](../ROADMAP_v1_zh.md) §2.0 · §2.2。
+> **对外名**：PIP（过程实例投影）。对内历史文件名可含 `HGM` / `hgm_*`（路径兼容，正文不用曾称括注）。
+
+> **Track G · G1 / v2.0+**：PIP（过程实例投影）为 **v1.0 公理稳定后的可选增强**（proposal · 未实现）· 详见 [`../ROADMAP_v1_zh.md`](../ROADMAP_v1_zh.md) §2.0 · §2.2。
 
 | 文档 | 状态 | 说明 |
 | --- | --- | --- |
@@ -10,7 +12,7 @@
 | [`HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md`](./HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md) | archive | 对话参考 · **非真值** |
 
 ```text
-HGM = 结构化对象 + 显式带类型的边 + 不可变事件历史 + 可推理的公理
+PIP（过程实例投影） = 结构化对象 + 显式带类型的边 + 不可变事件历史 + 可推理的公理
 ```
 
 **勿混淆**：
@@ -19,6 +21,6 @@ HGM = 结构化对象 + 显式带类型的边 + 不可变事件历史 + 可推
 | --- | --- |
 | **GraphTrack** | `docs/_tech_graph/` · Inform 架构地图 |
 | **gate-check --graph** | Inform 模块依赖图（Q3 · v1.0） |
-| **HGM** | Process 实例图 · Task / Gate / Review 时序 |
+| **PIP（过程实例投影）** | Process 实例图 · Task / Gate / Review 时序 |
 
 **依赖**：[`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) v1.2

package/docs/spec/SPEC-discipline-show_v1.md

@@ -0,0 +1,89 @@
+# SPEC：discipline show CLI（Post-2.10 Epic E）（v1）
+
+> **状态**：`signed`（维护者签收 2026-07-25 · 对话「签收 A+E」）  
+> **track**：`feature`  
+> **上游**：Epic [`EPIC_post_210_menu_serial_a_e_j_v1_zh.md`](../../../docs/harness/guides/EPIC_post_210_menu_serial_a_e_j_v1_zh.md) · RETRO 候选 **E** · T3 SPEC [`SPEC-discipline-coverage-yaml_v1.md`](./SPEC-discipline-coverage-yaml_v1.md)（资产已落地 · 本波补发现性）  
+> **前置**：`@cyning/harness@2.10.0` · Epic **A CLOSE** 后方可进本棒 30（串行）  
+> **下游**：人签 → 00 draft task（可与 A 签收同批起草，**30 仍串行**）→ … → 30  
+> **目标版本**：与 A 统一 **`2.11.0`**
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **spec_slug** | `discipline-show` |
+| **invoke_slug** | `cyning-harness-discipline-show` |
+| **test_strategy** | `required` |
+| **test_strategy_note** | show 人读/JSON · 非法 yaml exit · 与 loadDisciplineCoverage 同源；lifecycle show 回归 |
+| **Open Folder（实现）** | `cyning-harness/` |
+| **epic_serial** | E（J → A → **本棒**） |
+
+---
+
+## 1. 背景与目标
+
+T3 已落盘 `harness/discipline-coverage.yaml` + schema + `npm test`，但 **无 CLI**，发现性弱（T3 residual）。
+
+**一句话目标**：提供 **`discipline show [--json]`**，镜像 `lifecycle show` 的只读体验，不引入 `audit --discipline` 大 UI。
+
+---
+
+## 2. 范围
+
+### D1 · CLI
+
+- `npx @cyning/harness discipline show [--json]`
+- 人读：摘要 `version` · `as_of_package_version` · `scope` · statements 计数按 status · gaps 计数按 status；可选短表（id/status/summary 截断）
+- `--json`：输出 `loadDisciplineCoverage` 校验后的数据对象（或稳定包装 `{ ok, data }`——30 选一并写进测试；**推荐直接 dump data** 对齐 lifecycle show）
+- 非法 / 缺失 yaml → exit **1**（与 lifecycle 风格一致）
+
+### D2 · 库
+
+- 扩展 `lib/discipline-coverage.js`：`formatDisciplineShow(data)`（或等价）
+- 复用既有 `loadDisciplineCoverage` / `validateDisciplineCoverage`；**不**改 schema 必填
+
+### D3 · 文档 / 测试 / 版本
+
+- help / USER_GUIDE / ONBOARDING 挂点；CHANGELOG **2.11.0**
+- 单测：包内 yaml show 成功；损坏 fixture exit ≠0
+
+---
+
+## 3. 非范围
+
+- `audit --discipline` 交互视图 / 过滤 UI / HTML  
+- 全量人工重盘周 / 改 statements 真值内容（除非 show 发现明显自相矛盾且 A 波已改——默认 **不**改矩阵正文）  
+- A 的守卫扩面（不得同未 CLOSE 的 A 抢 PR；本棒 30 在 A CLOSE 后）  
+- apply / G7 / N2-C
+
+---
+
+## 4. 验收清单
+
+- [ ] `discipline show` 与 `discipline show --json` 对包内 yaml 成功
+- [ ] 人读含 version / as_of / 计数；JSON 可被 `JSON.parse`
+- [ ] help 列出 `discipline show`
+- [ ] `npm test` 全绿 · lifecycle show 不回归
+- [ ] 文档一句说明 SoT 仍为 yaml，show 只读
+
+---
+
+## 5. 思考轮控制表（摘要）
+
+| 字段 | 值 |
+| --- | --- |
+| `actual_last_round` | R1 |
+| `early_stop` | yes |
+| `early_stop_reason` | 与 lifecycle show 同构；T3 已预留「下波 mirror」 |
+| `residual_risks` | ① 人读表格过长需截断；② 与 audit 子命令命名空间未来冲突——本波用顶级 `discipline`，不做 audit 子命令 |
+
+---
+
+## 8. 下一棒 Prompt（人签后 · A CLOSE 后 30）
+
+```text
+【30】cyning-harness-discipline-show · 实现 discipline show [--json]
+约束：只读；无 audit UI；A 已 CLOSE；目标进 2.11.0 CHANGELOG
+```

package/docs/spec/SPEC-lifecycle-guard-expand_v1.md

@@ -0,0 +1,100 @@
+# SPEC：lifecycle dry-run 守卫扩面（Post-2.10 Epic A）（v1）
+
+> **状态**：`signed`（维护者签收 2026-07-25 · 对话「签收 A+E」）  
+> **track**：`feature`  
+> **上游**：Epic [`EPIC_post_210_menu_serial_a_e_j_v1_zh.md`](../../../docs/harness/guides/EPIC_post_210_menu_serial_a_e_j_v1_zh.md) · RETRO [`RETRO_post_210_next_menu_v1_zh.md`](../../../docs/harness/guides/RETRO_post_210_next_menu_v1_zh.md) 候选 **A**  
+> **前置**：`@cyning/harness@2.10.0`（dry-run 骨架）· Epic **J CLOSE ✅**  
+> **下游**：人签 → 00 draft task → 20-task-audit → HG-AUDIT-R1 → 30  
+> **目标版本**：Epic 统一 **`2.11.0`**（与 E 同窗）
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **spec_slug** | `lifecycle-guard-expand` |
+| **invoke_slug** | `cyning-harness-lifecycle-guard-expand` |
+| **test_strategy** | `required` |
+| **test_strategy_note** | to_30 新 adapter 的 pass/fail/warn/unevaluated；既有 HG-AUDIT-R1 / reviews 回归；CLI dry-run exit；无 apply |
+| **Open Folder（实现）** | `cyning-harness/` |
+| **epic_serial** | A（J → **本棒** → E） |
+
+---
+
+## 1. 背景与目标
+
+T2（v2.10）已落地 `lifecycle dry-run`，但 `to_30` 仅接线 **`HG-AUDIT-R1`** 与 **`reviews_retention`**；`HG-TASK-DRAFT` · `audit_D5` · `task_lint` 及 `to_00` / `close_*` 仍为 **`unevaluated`**，报告易被误读。
+
+**一句话目标**：在**仍无 `--apply` / 仍非 runner / 仍非 G7** 的前提下，把 **`to_30` 剩余守卫**（及可选 `to_00`）接到薄 adapter，降低 unevaluated 面。
+
+---
+
+## 2. 范围
+
+### D1 · 必须接线（`--task` + `to_30`）
+
+| guard id | 语义（对齐既有） | 说明 |
+| --- | --- | --- |
+| `HG-TASK-DRAFT` | human_gate 表 `approved` | 同 HG-AUDIT-R1 解析路径 |
+| `audit_D5` | test_strategy vs 测试文件存在 | 复用 audit/verify 既有判定，禁止盲 spawn 全量 verify |
+| `task_lint` | `lintTaskFile`；severity=**warn** | fail→报告 `warn` 或 `fail` 按 yaml severity；`--allow-lint-fail` 抑制为非 block（本波 lint 仍非 block） |
+
+既有 `HG-AUDIT-R1` / `reviews_retention` **行为不得回归**。
+
+### D2 · 可选同波（若成本低）
+
+- `to_00` · `spec_reviews_retention`（复用 `findSpecReview` / verify `--spec` 语义）  
+- 若 30 评估成本高 → 记 residual，**不**阻塞 CLOSE
+
+### D3 · 仍允许 unevaluated
+
+- 全部 `close_*` 守卫（本波不扩 close 转移，除非顺手且单测充分）  
+- 无 `--task` 时：除结构外全部 unevaluated（语义同 T2）
+
+### D4 · 文档 / 测试 / 版本
+
+- CHANGELOG **2.11.0** 条目；USER_GUIDE / ONBOARDING 一句：扩面守卫列表  
+- 单测覆盖新 adapter 三态 + unevaluated 计数下降（相对 T2 fixture）  
+- **无** schema 必填扩张（除非缺字段阻塞）
+
+---
+
+## 3. 非范围
+
+- `--apply` / 写回 task status / 事件溯源（候选 B）  
+- G7 / `harness run` / 完整 runner  
+- N2-C · lint severity 升 **block**（候选 D；J 已测 FAIL≈93%）  
+- 改变 `verify` / `close` 硬闸语义（dry-run 仍旁路）  
+- E · `discipline show`（下一棒）
+
+---
+
+## 4. 验收清单
+
+- [ ] `to_30` + fixture：`HG-TASK-DRAFT` · `audit_D5` · `task_lint` 均出现非 `unevaluated` 的 `pass|fail|warn`
+- [ ] 既有两 adapter 回归绿
+- [ ] `--allow-lint-fail` 对 `task_lint` 行为可测
+- [ ] 无 `--task`：unevaluated 语义不变
+- [ ] `npm test` 全绿 · 文档列出已接线守卫
+- [ ] **无** `--apply` 旗
+
+---
+
+## 5. 思考轮控制表（摘要）
+
+| 字段 | 值 |
+| --- | --- |
+| `actual_last_round` | R2 |
+| `early_stop` | yes |
+| `early_stop_reason` | 扩面集合由 yaml to_30 未接线项冻结；与 T2 SPEC 方案 B 同构，争议面小 |
+| `residual_risks` | ① D5 与 verify 路径细微漂移；② close_* 仍 unevaluated 须文档标明；③ 与 E 同窗发版叙述勿漏 |
+
+---
+
+## 8. 下一棒 Prompt（人签后）
+
+```text
+【00】draft task · slug cyning-harness-lifecycle-guard-expand · Open Folder cyning-harness/
+约束：本 SPEC D1 必须接线；无 apply；无 N2-C；E 不得同 PR 抢做
+```

package/harness/discipline-coverage.yaml

@@ -6,7 +6,7 @@
 # 禁止：把本文件当「每周全量重盘」流程；不做 audit --discipline UI（本波）
 
 version: "1"
-as_of_package_version: "2.10.0"
+as_of_package_version: "2.11.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 刷新（非第二轮通读盘点）"
 

package/harness/lifecycle.yaml

@@ -2,6 +2,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）
 # 只读展示：npx @cyning/harness lifecycle show [--json]
 # Schema：schema/lifecycle.v1.schema.json
 

package/lib/audit.js

@@ -45,7 +45,11 @@ function runGateCheck(target, taskFile) {
   };
 }
 
-function runTestCheck(target, taskFile) {
+/**
+ * D5 · test_strategy vs 测试/CI 制品（供 audit / lifecycle dry-run 复用）。
+ * @returns {{ ok: boolean, skipped?: boolean, reason: string }}
+ */
+export function runTestCheck(target, taskFile) {
   // 未指定 task 文件时，D5 跳过（在 active task 上跑 gate-check 已覆盖 D3）
   if (!taskFile) {
     return { ok: true, skipped: true, reason: '未指定 --task，跳过 D5' };

package/lib/cli.js

@@ -43,6 +43,7 @@ function usage(version = 'unknown') {
   npx @cyning/harness gate-check [--target PATH] [--task FILE] [--graph] [--json]
   npx @cyning/harness verify [--target PATH] [--task FILE | --spec FILE] [--graph] [--json] [--agent-hint] [--workspace-root PATH]
   npx @cyning/harness lifecycle show [--json]
+  npx @cyning/harness discipline show [--json]
   npx @cyning/harness sync index [--target PATH]
   npx @cyning/harness task check --file PATH [--no-circular] [--registry DIR]...
   npx @cyning/harness task close --file PATH [--target PATH] [--yes] [--allow-unchecked]
@@ -63,7 +64,8 @@ function usage(version = 'unknown') {
   audit       ICVO 机械审计：复用 gate-check · D5 测试声明检查 · S5 git-clean 提醒
   gate-check  调用 wizard/gate-check.sh（业务仓无需 clone 即可用）
   verify      30 前聚合（--task）或 SPEC→00 审查文闸（--spec · v2.8+）
-  lifecycle   只读展示 harness/lifecycle.yaml（状态/转移/守卫 · v2.7+）
+  lifecycle   只读展示 harness/lifecycle.yaml（状态/转移/守卫 · v2.7+；dry-run v2.10+）
+  discipline  只读展示 harness/discipline-coverage.yaml（机械化率资产 · v2.11+）
   sync index  生成 .cyning-harness/invoke_index.json
   task check  校验 task.harness.v1.json sidecar · --no-circular 检测 depends_on 环
   task close  受闸归档：5 项机械校验（invoke/自检结论/勾选/slug/状态）后 mv active→done（v2.2+）
@@ -134,6 +136,10 @@ export async function runCli(argv) {
     await cmdLifecycle(rest);
     return;
   }
+  if (cmd === 'discipline') {
+    await cmdDiscipline(rest);
+    return;
+  }
   if (cmd === 'sync') {
     await cmdSync(rest);
     return;
@@ -599,6 +605,44 @@ dry-run  · 转移资格判定（引擎消费 yaml · v2.10+ · 旁路报告 ·
   throw err;
 }
 
+async function cmdDiscipline(args) {
+  const { loadDisciplineCoverage, formatDisciplineShow } = await import(
+    './discipline-coverage.js'
+  );
+  const [sub, ...rest] = args;
+  if (!sub || sub === '--help' || sub === '-h' || args.includes('--help') || args.includes('-h')) {
+    console.log(`用法:
+  npx @cyning/harness discipline show [--json]
+
+show  · 只读展示 harness/discipline-coverage.yaml（机械化率资产 · v2.11+ · 非 audit UI）
+`);
+    return;
+  }
+
+  if (sub === 'show') {
+    const json = rest.includes('--json');
+    const unknown = rest.filter((a) => a !== '--json');
+    if (unknown.length > 0) {
+      const err = new Error(`discipline show 未知参数: ${unknown.join(' ')}`);
+      err.exitCode = 1;
+      throw err;
+    }
+    const { data } = loadDisciplineCoverage();
+    if (json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      console.log(formatDisciplineShow(data));
+    }
+    return;
+  }
+
+  const err = new Error(
+    `discipline 子命令未知: ${sub ?? '(空)'}\n用法: discipline show [--json]`,
+  );
+  err.exitCode = 1;
+  throw err;
+}
+
 async function cmdSync(args) {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`用法: npx @cyning/harness sync index [--target PATH]`);

package/lib/discipline-coverage.js

@@ -94,3 +94,55 @@ export function loadDisciplineCoverage(options = {}) {
 
   return { data, filePath, harnessRoot };
 }
+
+/**
+ * 人读摘要（镜像 lifecycle show · 只读）。
+ */
+export function formatDisciplineShow(data) {
+  const byStatus = {};
+  for (const s of data.statements ?? []) {
+    byStatus[s.status] = (byStatus[s.status] ?? 0) + 1;
+  }
+  const gapBy = {};
+  for (const g of data.gaps ?? []) {
+    gapBy[g.status] = (gapBy[g.status] ?? 0) + 1;
+  }
+
+  const lines = [
+    `discipline-coverage v${data.version}`,
+    `as_of: ${data.as_of_package_version}`,
+    `scope: ${data.scope}`,
+    '',
+    `## statements (${data.statements?.length ?? 0})`,
+    ...Object.entries(byStatus)
+      .sort(([a], [b]) => a.localeCompare(b))
+      .map(([k, n]) => `- ${k}: ${n}`),
+    '',
+    `## gaps (${data.gaps?.length ?? 0})`,
+  ];
+  if ((data.gaps?.length ?? 0) === 0) {
+    lines.push('- （无）');
+  } else {
+    lines.push(
+      ...Object.entries(gapBy)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, n]) => `- ${k}: ${n}`),
+    );
+  }
+
+  lines.push('', '## sample statements（最多 12）');
+  for (const s of (data.statements ?? []).slice(0, 12)) {
+    const sum =
+      s.summary.length > 72 ? `${s.summary.slice(0, 69)}…` : s.summary;
+    lines.push(`- [${s.status}] ${s.id}: ${sum}`);
+  }
+  if ((data.statements?.length ?? 0) > 12) {
+    lines.push(`- … +${data.statements.length - 12} more`);
+  }
+
+  lines.push(
+    '',
+    '注: SoT = harness/discipline-coverage.yaml · show 只读 · 非 audit --discipline UI',
+  );
+  return lines.join('\n');
+}

package/lib/lifecycle.js

@@ -1,8 +1,10 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import yaml from 'js-yaml';
+import { runTestCheck } from './audit.js';
 import { resolveHarnessRoot } from './paths.js';
 import { findReview, parseHumanGates } from './task-meta.js';
+import { lintTaskFile } from './task-lint.js';
 
 const SEVERITIES = new Set(['block', 'warn']);
 
@@ -121,10 +123,13 @@ export function formatLifecycleShow(data) {
   return lines.join('\n').trimEnd();
 }
 
-/** 本波已接线的守卫（其余 unevaluated） */
+/** 已接线的守卫（未登记者 → unevaluated；close_* 本波仍未接线） */
 const GUARD_ADAPTERS = {
-  'HG-AUDIT-R1': evaluateHgAuditR1,
+  'HG-AUDIT-R1': evaluateHgGate('HG-AUDIT-R1'),
+  'HG-TASK-DRAFT': evaluateHgGate('HG-TASK-DRAFT'),
   reviews_retention: evaluateReviewsRetention,
+  audit_D5: evaluateAuditD5,
+  task_lint: evaluateTaskLint,
 };
 
 function findRepoRootFromTask(absTask) {
@@ -144,19 +149,21 @@ function flagsAllow(flags, allowFlag) {
   return false;
 }
 
-function evaluateHgAuditR1({ taskPath }) {
-  const content = fs.readFileSync(taskPath, 'utf8');
-  const gates = parseHumanGates(content);
-  const audit = gates.find((g) => g.id === 'HG-AUDIT-R1');
-  if (!audit) {
-    return { status: 'fail', detail: '闸表无 HG-AUDIT-R1 行' };
-  }
-  if (audit.status === 'approved') {
-    return { status: 'pass', detail: 'HG-AUDIT-R1=approved' };
-  }
-  return {
-    status: 'fail',
-    detail: `HG-AUDIT-R1=${audit.status}（须 approved）`,
+function evaluateHgGate(gateId) {
+  return ({ taskPath }) => {
+    const content = fs.readFileSync(taskPath, 'utf8');
+    const gates = parseHumanGates(content);
+    const row = gates.find((g) => g.id === gateId);
+    if (!row) {
+      return { status: 'fail', detail: `闸表无 ${gateId} 行` };
+    }
+    if (row.status === 'approved') {
+      return { status: 'pass', detail: `${gateId}=approved` };
+    }
+    return {
+      status: 'fail',
+      detail: `${gateId}=${row.status}（须 approved）`,
+    };
   };
 }
 
@@ -174,6 +181,32 @@ function evaluateReviewsRetention({ taskPath, target, flags }) {
   return { status: 'fail', detail: 'missing R<n> review' };
 }
 
+function evaluateAuditD5({ taskPath, target }) {
+  const result = runTestCheck(target, taskPath);
+  if (result.ok) {
+    return {
+      status: 'pass',
+      detail: result.skipped
+        ? `D5 skipped · ${result.reason}`
+        : result.reason,
+    };
+  }
+  return { status: 'fail', detail: result.reason };
+}
+
+function evaluateTaskLint({ taskPath, target }) {
+  try {
+    const result = lintTaskFile(taskPath, { cwd: target });
+    if (result.ok) {
+      return { status: 'pass', detail: 'task lint PASS' };
+    }
+    const rules = (result.errors ?? []).map((e) => e.rule).join(',') || 'errors';
+    return { status: 'fail', detail: `task lint FAIL · ${rules}` };
+  } catch (err) {
+    return { status: 'fail', detail: `task lint 异常: ${err.message}` };
+  }
+}
+
 /**
  * 转移 dry-run（引擎最小骨架 · v2.10+）。
  * 默认不写盘；无 --apply。

package/package.json

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

package/wizard/lib/common.sh

@@ -198,6 +198,23 @@ profile_ide_cursor_rel() {
   echo "$rel"
 }
 
+# 写入 .cyning-harness/local.json（compare-before-write · 内容不变则跳过）
+# 供 upgrade post-apply 簿记；避免在 sync apply 前改已跟踪文件触发 S5
+write_local_json_if_changed() {
+  local target="$1" root="$2"
+  local dir="$target/.cyning-harness"
+  local path="$dir/local.json"
+  local payload
+  payload="$(printf '%s\n' "{\"cyning_harness_root\":\"$root\"}")"
+  mkdir -p "$dir"
+  if [[ -f "$path" ]] && [[ "$(cat "$path")" == "$payload" ]]; then
+    echo "local.json 未变（跳过写入）→ cyning_harness_root=$root"
+    return 0
+  fi
+  printf '%s\n' "$payload" > "$path"
+  echo "已更新 local.json → cyning_harness_root=$root"
+}
+
 # 从 CLAUDE.md / AGENTS.md 剥离 Harness marker 块；若仅剩空文件则删除
 # S5 · sync/apply 前检测 Git 工作区干净（v0.3+）
 # 非 git 仓跳过；--force 或 HARNESS_SYNC_FORCE=1 跳过

package/wizard/lib/manifest.sh

@@ -77,6 +77,38 @@ EOF
   echo "已写入 manifest: $mf"
 }
 
+# upgrade 重写前：对 schema 外字段 / ide 裁剪打 warning（知情而非静默）
+# 标准五字段：version / preset / ide / from_version / upgraded_at（additionalProperties: false）
+warn_manifest_upgrade_drops() {
+  local mf="$1" new_ide_json="$2"
+  [[ -f "$mf" ]] || return 0
+  if ! command -v node >/dev/null 2>&1; then
+    echo "WARN: 未找到 node，跳过 manifest 字段变更预检" >&2
+    return 0
+  fi
+  node -e '
+const fs = require("fs");
+const mf = process.argv[1];
+const newIde = JSON.parse(process.argv[2]);
+const schema = new Set(["version", "preset", "ide", "from_version", "upgraded_at"]);
+let old;
+try { old = JSON.parse(fs.readFileSync(mf, "utf8")); } catch { process.exit(0); }
+const extra = Object.keys(old).filter((k) => !schema.has(k));
+if (extra.length) {
+  console.log(
+    "WARN: manifest 以下非标准字段将被移除（2.3+ 仅五字段 · 见 ONBOARDING）: " +
+      extra.join(", "),
+  );
+}
+const oldIde = old.ide;
+const oldS = JSON.stringify(oldIde ?? null);
+const newS = JSON.stringify(newIde);
+if (oldS !== newS) {
+  console.log("WARN: manifest.ide 将从 profile 重算: " + oldS + " → " + newS);
+}
+' "$mf" "$new_ide_json"
+}
+
 # upgrade apply 后更新 manifest
 write_manifest_upgrade() {
   local target="$1" version="$2"
@@ -96,6 +128,8 @@ write_manifest_upgrade() {
     preset="$(grep '"preset"' "$mf" | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/' || echo "$preset")"
   fi
 
+  warn_manifest_upgrade_drops "$mf" "$ide_json"
+
   mkdir -p "$target/.cyning-harness"
   cat > "$mf" <<EOF
 {

package/wizard/upgrade.sh

@@ -101,10 +101,8 @@ echo "preset: $(profile_preset_name "$PROFILE_FILE")"
 echo "当前 IDE: $(profile_ide_summary "$PROFILE_FILE")"
 echo ""
 
-# 始终刷新 local.json，避免路径漂移（如 Desktop → Projects）
-printf '%s\n' "{\"cyning_harness_root\":\"$CYNING_HARNESS\"}" > "$TARGET/.cyning-harness/local.json"
-echo "已更新 local.json → cyning_harness_root=$CYNING_HARNESS"
-echo ""
+# 注意：local.json / manifest 簿记放在 sync apply **成功之后**（F1）。
+# 勿在 apply 前改已跟踪的 .cyning-harness/local.json，否则 S5 git-clean 自绊。
 
 if [[ -z "$IDE_LIST" ]] && [[ "$ASSUME_YES" -eq 0 ]]; then
   if prompt_yes_no "是否更新 IDE 勾选（cursor / claude / agents）？" "n"; then
@@ -140,14 +138,16 @@ if [[ "$DO_APPLY" -eq 1 ]]; then
   SYNC_ARGS=(apply --target "$TARGET")
   [[ "$SYNC_FORCE" -eq 1 ]] && SYNC_ARGS+=(--force)
   "$SCRIPT_DIR/harness-sync.sh" "${SYNC_ARGS[@]}"
+  # post-sync 簿记：apply 失败则不落（set -e 已中止）
+  write_local_json_if_changed "$TARGET" "$CYNING_HARNESS"
   write_manifest_upgrade "$TARGET" "$VERSION"
   cp "$CYNING_HARNESS/harness/templates/QUICKREF_v1_zh.md" "$TARGET/.cyning-harness/QUICKREF.md"
-echo ""
-echo "升级完成。"
-echo "常用命令:"
-echo "  npx @cyning/harness verify --target $TARGET"
-echo "  npx @cyning/harness gate-check --target $TARGET"
-echo "  npx @cyning/harness upgrade --target $TARGET --yes"
+  echo ""
+  echo "升级完成。"
+  echo "常用命令:"
+  echo "  npx @cyning/harness verify --target $TARGET"
+  echo "  npx @cyning/harness gate-check --target $TARGET"
+  echo "  npx @cyning/harness upgrade --target $TARGET --yes"
 else
   echo "已取消 apply（仅预览）。"
   exit 0