@cyning/harness 2.0.3 → 2.1.0

package/AGENTS.md

@@ -5,9 +5,10 @@
 ## 阅读顺序
 
 1. [`README.md`](README.md)
-2. [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
-3. [`docs/ONBOARDING.md`](docs/ONBOARDING.md)
-4. 按任务进入 `harness/templates/` 或 `wizard/`
+2. [`docs/methodology/product/SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md) · 帽链流程
+3. [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
+4. [`docs/ONBOARDING.md`](docs/ONBOARDING.md)
+5. 按任务进入 `harness/templates/` 或 `wizard/`
 
 ## 修改纪律
 

package/CHANGELOG.md

@@ -4,6 +4,45 @@
 
 ## [Unreleased]
 
+## [2.1.0] - 2026-06-30
+
+### Added
+
+- **YAML-first 图谱模板**：`graph/templates/00_main.graph.yaml`、`10_flow_MAIN.graph.yaml`
+- **编译脚本**：`scripts/graph_yaml_compile.js`（Node.js · `js-yaml`）从 `.graph.yaml` 生成 `.md`
+- **校验脚本**：`scripts/verify-template-compile.sh` — 校验同步、无残留 `.ai.md`、生成物齐全
+- **模板 v0.2**：`graph/templates/README.md` 更新复制流程；`99_mermaid_protocol.md` 升级 v3 YAML-first
+
+### Changed
+
+- **图谱模板**：删除 `graph/templates/00_main.ai.md`、`10_flow_MAIN.ai.md`；`00_main.md`、`10_flow_MAIN.md` 改为生成物
+- **版本**：`package.json` → **2.1.0**
+
+### Notes
+
+- **HG-RELEASE**：待维护者 publish `@cyning/harness@2.1.0` · tag `v2.1.0`
+- docs-only minor · 无 CLI breaking · `npm test` 预期通过
+
+## [2.0.4] - 2026-06-21
+
+### Added
+
+- **[`SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md)**：V2 标准帽链真值（10-spec/10-task · 20-spec-audit/20-task-audit · 30⇄40 同 Agent · 50/CLOSE 打回）
+- **复查落盘**：[`docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md`](docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md)
+
+### Changed
+
+- **[`DESIGN_ONTOLOGY_v1_zh.md`](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md)** → **v1.3** · §3.2 / §4.1 / §8 与 V2 对齐
+- **[`ontology.yaml`](ontology.yaml)**：`version: "1.3"` · `starter_hats` / `extended_hats` / D1·D2 公理
+- **Starter prompts**：[`harness/prompts/README.md`](harness/prompts/README.md) · [`30-execute-code.md`](harness/prompts/30-execute-code.md) · [`40-self-check.md`](harness/prompts/40-self-check.md) · 30→40 同 Agent 闭环纪律
+- **入口文档**：[`README.md`](README.md) · [`AGENTS.md`](AGENTS.md) · [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) 链 V2 流程
+- **版本**：`package.json` · `ontology.yaml` `product_semver` → **2.0.4**
+
+### Notes
+
+- **HG-RELEASE**：待维护者 publish `@cyning/harness@2.0.4` · tag `v2.0.4`
+- docs-only patch · 无 CLI breaking · `npm test` 72/72
+
 ## [2.0.2] - 2026-06-18
 
 ### Added

package/README.md

@@ -54,20 +54,22 @@ git clone git@github.com:Cyning12/cyning-harness.git && cd cyning-harness
 /path/to/cyning-harness/wizard/harness-sync.sh apply --target /path/to/your-repo
 ```
 
-**P0 金样（10→22→30）：** [`examples/demo_checkout/README.md`](examples/demo_checkout/README.md) · [`docs/methodology/execution/P0_V0.2_GAP.md`](docs/methodology/execution/P0_V0.2_GAP.md)
+**P0 金样：** [`examples/demo_checkout/README.md`](examples/demo_checkout/README.md) · 完整帽链见 [`docs/methodology/product/SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md)
 
 **Kimi Code fork：** `--preset oss-fork-meta` 或 [`wizard/bootstrap-oss-fork-meta.sh`](wizard/bootstrap-oss-fork-meta.sh) · 过程轨不进上游 PR。
 
 ---
 
-## 典型工作流
+## 典型工作流（V2）
 
 ```text
-install / adopt  →  harness-sync plan/apply  →  @ task + prompts（10→22→30）
-                      ↑ 产品包 git pull 后 upgrade.sh
-30 前：npx @cyning/harness verify  ·  HG-AUDIT-R1 = approved
+人 + 00 大纲 → 10-spec → 20-spec-audit + HG-SPEC-SIGNOFF
+  → 00 起草 task → 10-task → 20-task-audit + HG-AUDIT-R1
+  → 30（含 40 自检闭环）→ [50] → CLOSE
 ```
 
+Starter 包：`10-task` · `20-task-audit` · `30` · `40` · 30 前 `npx @cyning/harness verify` · **HG-AUDIT-R1 = approved**
+
 1. 阅读 [`docs/ONBOARDING.md`](docs/ONBOARDING.md)  
 2. [`npx @cyning/harness init`](docs/USER_GUIDE_v1.0_zh.md) 或 [`wizard/install.sh`](wizard/install.sh) / [`adopt-existing.sh`](wizard/adopt-existing.sh)  
 3. 产品包更新：`npx @cyning/harness upgrade` 或 [`wizard/upgrade.sh`](wizard/upgrade.sh) / [`harness-sync.sh`](wizard/harness-sync.sh) `apply`  

package/docs/ARCHITECTURE.md

@@ -65,7 +65,8 @@ CLI/Worker 与模板 **同一仓库** 演进，避免多仓割裂。
 
 ## 7. 产品设计本体
 
-Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.2**）。  
+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 后）。  
 与 **战略本体**（工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_*`）分层：本文件描述 **产品如何实现**，战略文档描述 **对外演进**。

package/docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md

@@ -1,10 +1,12 @@
 # 一致性审计报告 · 2026-06-15
 
-| 项 | 内容 |
-| --- | --- |
-| **状态** | `closed` · 后续任务已落盘 |
-| **触发** | [`prompts/PROMPT_doc_consistency_audit_v1_zh.md`](./prompts/PROMPT_doc_consistency_audit_v1_zh.md) |
-| **真值层** | L2 `docs/methodology/` |
+
+| 项       | 内容                                                                                                 |
+| ------- | -------------------------------------------------------------------------------------------------- |
+| **状态**  | `closed` · 后续任务已落盘                                                                                 |
+| **触发**  | `[prompts/PROMPT_doc_consistency_audit_v1_zh.md](./prompts/PROMPT_doc_consistency_audit_v1_zh.md)` |
+| **真值层** | L2 `docs/methodology/`                                                                             |
+
 
 ---
 
@@ -16,20 +18,22 @@ L2 真值链大体自洽，但存在 semver（v0.5 HGM 晚于 v1.0 闸门）、H
 
 ## 问题清单（按严重程度）
 
-| 级别 | ID | 问题 | 影响读者 | 建议改法 | 涉及文件 | 状态 |
-| --- | --- | --- | --- | --- | --- | --- |
-| P0 | SEM-01 | v0.5.x 在 semver 表位于 v1.0 后，数字易误读 | 以为 HGM 是 v1.0 前产品版 | Track G 子表 + 对外脚注 | `ROADMAP_v1_zh.md` 等 | ✅ → **SEM-02 改 v2.x** |
-| P0 | SEM-02 | SEM-01 脚注仍不足 · v0.5/v0.6 像主轨续号 | 问「0.5 在哪」 | HGM 改 **v2.0+ / v2.1+** · ROADMAP §2.0 | 全 L2 链 | ✅ 2026-06-15 |
-| P0 | ICV-01 | 公众 ICV 三支柱 vs 产品 ICVO 四支柱 | 续篇自相矛盾 | ICVO 升级说明 + 地图 v1.0.3 脚注 | 本体 · README · 公众稿 | ✅ |
-| P0 | IMPL-01 | A0「已完成」vs P0 进行中 | 过度承诺 v0.2 | 拆 A0a/A0b | `STRATEGY_MASTER` | ✅ |
-| P0 | IMPL-02 | HGM/jsonl/npx 未标 proposal | 以为已实现 | 统一 `proposal · 未实现` | HGM · README §5.3 | ✅ |
-| P1 | MIX-01 | HGM §5 写 gate-check --graph @ v0.4 | 与 ROADMAP v1.0 冲突 | 校正为 v1.0 Inform | `HARNESS_GRAPH_MODEL_design_v0_zh.md` | ✅ |
-| P1 | MAP-01 | DOCUMENT_MAP §4 README v1.0 滞后 | 锚点误报 | 更新 §4 | `DOCUMENT_MAP_v1_zh.md` | ✅ |
-| P1 | MAP-02 | README §6 缺 v1.1 修订行 | 版本不一致 | 补修订记录 | `methodology/README.md` | ✅ |
-| P1 | MIX-02 | Harness Engineering vs 纪律包 | 误解为 Runtime | STRATEGY §1.1 澄清 | `STRATEGY_MASTER` | ✅ |
-| P1 | STRAT-01 | §4 无 Track G / ICVO D 轨 | L1 读者漏 G 轨 | 增 §4.9 | `STRATEGY_MASTER` | ✅ |
-| P2 | VER-01 | invoke_index v0.4+ vs v1.0 | 排期歧义 | 统一 v1.0 | `DESIGN_ONTOLOGY` §6 | ✅ |
-| P2 | PILOT-01 | 试点 vs P0 ACCEPTANCE 边界 | 对外泛化 | PILOT 边界句 | `PILOT_kimi_code_fork` | ✅ |
+
+| 级别  | ID       | 问题                                 | 影响读者               | 建议改法                                   | 涉及文件                                  | 状态                    |
+| --- | -------- | ---------------------------------- | ------------------ | -------------------------------------- | ------------------------------------- | --------------------- |
+| P0  | SEM-01   | v0.5.x 在 semver 表位于 v1.0 后，数字易误读   | 以为 HGM 是 v1.0 前产品版 | Track G 子表 + 对外脚注                      | `ROADMAP_v1_zh.md` 等                  | ✅ → **SEM-02 改 v2.x** |
+| P0  | SEM-02   | SEM-01 脚注仍不足 · v0.5/v0.6 像主轨续号     | 问「0.5 在哪」          | HGM 改 **v2.0+ / v2.1+** · ROADMAP §2.0 | 全 L2 链                                | ✅ 2026-06-15          |
+| P0  | ICV-01   | 公众 ICV 三支柱 vs 产品 ICVO 四支柱          | 续篇自相矛盾             | ICVO 升级说明 + 地图 v1.0.3 脚注               | 本体 · README · 公众稿                     | ✅                     |
+| P0  | IMPL-01  | A0「已完成」vs P0 进行中                   | 过度承诺 v0.2          | 拆 A0a/A0b                              | `STRATEGY_MASTER`                     | ✅                     |
+| P0  | IMPL-02  | HGM/jsonl/npx 未标 proposal          | 以为已实现              | 统一 `proposal · 未实现`                    | HGM · README §5.3                     | ✅                     |
+| P1  | MIX-01   | HGM §5 写 gate-check --graph @ v0.4 | 与 ROADMAP v1.0 冲突  | 校正为 v1.0 Inform                        | `HARNESS_GRAPH_MODEL_design_v0_zh.md` | ✅                     |
+| P1  | MAP-01   | DOCUMENT_MAP §4 README v1.0 滞后     | 锚点误报               | 更新 §4                                  | `DOCUMENT_MAP_v1_zh.md`               | ✅                     |
+| P1  | MAP-02   | README §6 缺 v1.1 修订行               | 版本不一致              | 补修订记录                                  | `methodology/README.md`               | ✅                     |
+| P1  | MIX-02   | Harness Engineering vs 纪律包         | 误解为 Runtime        | STRATEGY §1.1 澄清                       | `STRATEGY_MASTER`                     | ✅                     |
+| P1  | STRAT-01 | §4 无 Track G / ICVO D 轨            | L1 读者漏 G 轨         | 增 §4.9                                 | `STRATEGY_MASTER`                     | ✅                     |
+| P2  | VER-01   | invoke_index v0.4+ vs v1.0         | 排期歧义               | 统一 v1.0                                | `DESIGN_ONTOLOGY` §6                  | ✅                     |
+| P2  | PILOT-01 | 试点 vs P0 ACCEPTANCE 边界             | 对外泛化               | PILOT 边界句                              | `PILOT_kimi_code_fork`                | ✅                     |
+
 
 ---
 
@@ -65,7 +69,10 @@ L2 真值链大体自洽，但存在 semver（v0.5 HGM 晚于 v1.0 闸门）、H
 
 ## 修订记录
 
-| 日期 | 说明 |
-| --- | --- |
-| 2026-06-15 | 初版审计 · 同日落盘修复 |
+
+| 日期         | 说明                              |
+| ---------- | ------------------------------- |
+| 2026-06-15 | 初版审计 · 同日落盘修复                   |
 | 2026-06-15 | SEM-02：HGM semver **v2.x** 全链回填 |
+
+

package/docs/methodology/README.md

@@ -80,6 +80,7 @@ HGM = 结构化对象 + 显式带类型的边 + 不可变事件历史 + 可推
 | ----------------------------------------------------------- | ------------------------------------ |
 | `[HARNESS_V2_PLAN.md](./pointers/HARNESS_V2_PLAN_v1_zh.md)` | Ink 工作区 Harness 规划 · task 字段 · CI 批次 |
 | `[SDD_HAT_FLOW.md](./pointers/SDD_HAT_FLOW_v1_zh.md)`       | 历史帽编号 · Starter 以产品仓 prompts 为准      |
+| `[HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md](./pointers/HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md)` | 帽子链 V2 对外摘要 · 双 20 · 人闸 · 50 可选 |
 | 工作区 `docs/harness/prompts/`                                 | **Extended** 全量帽 · 不默认复制进产品包         |
 
 

package/docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md

@@ -0,0 +1,136 @@
+# cyning-harness · V2 帽链复查 + 小版本升级 Prompt
+
+> **Open Folder**：**`cyning-harness/`**（产品仓根 · **非** `Projects/` 工作区根）  
+> **角色**：维护者 Agent · **文档/纪律包**复查 · 可选 **patch 发版**  
+> **触发提交**：`b868671` · `docs(product): V2 帽链 SDD_HAT_FLOW_v2 与本体/Starter 对齐`  
+> **当前版本**：`package.json` → **2.0.3**
+
+| 项 | 值 |
+|----|-----|
+| **task_slug** | `cyning-harness-v2-hat-flow-review` |
+| **auditor_hat** | 自检 + 维护者 CLOSE（**非** 工作区 20-task-audit） |
+| **目标版本（若通过）** | **2.0.4**（docs-only patch · 无 CLI breaking） |
+| **HG-RELEASE** | npm publish / GitHub Release **须人签** · Agent **仅** bump + CHANGELOG + tag + push（若用户授权 push） |
+
+---
+
+## 用法
+
+1. Cursor **Open Folder** → `cyning-harness/`  
+2. **新对话** · 复制下方 **§ 可复制 Prompt 正文**  
+3. Agent 落盘复查结论 → 无阻塞则执行 **2.0.4** 升级清单  
+
+---
+
+## 复查范围（须逐项 pass / fail）
+
+### A · 帽链真值一致性
+
+| # | 核对项 | 路径 |
+|---|--------|------|
+| A1 | **标准流程** 与人描述一致（00→10-spec→20-spec→HG-SPEC-SIGNOFF→00 task→10-task→20-task→HG-AUDIT→30⇄40→50→CLOSE） | [`../product/SDD_HAT_FLOW_v2_zh.md`](../product/SDD_HAT_FLOW_v2_zh.md) |
+| A2 | §3.2 / §4.1 / §8 与 A1 **无矛盾** | [`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) |
+| A3 | `ontology.yaml` **version 1.3** · `starter_hats` / `extended_hats` / D1·D2 与 A1 一致 | [`../../../ontology.yaml`](../../../ontology.yaml) |
+| A4 | `harness/prompts/README` + **30/40** 写明 **同 Agent 闭环** | [`../../../harness/prompts/`](../../../harness/prompts/README.md) |
+| A5 | 入口文档链到 V2 流程 | [`../../../README.md`](../../../README.md) · [`../../../AGENTS.md`](../../../AGENTS.md) · [`../../ARCHITECTURE.md`](../../ARCHITECTURE.md) |
+
+### B · 残留旧编号（应为别名或已更新）
+
+| # | 核对项 |
+|---|--------|
+| B1 | 无 **唯一真值**仍写「10→22→30 金样」且无 V2 上下文 |
+| B2 | `22-task-audit` / `10-requirements` 文件 **HEADER** 标明 V2 hat_id |
+| B3 | `lib/` · `test/` · `golden/` · `examples/demo_checkout/` · `docs/USER_GUIDE*.md` 中 **blocks 30 / D2** 语义仍正确（pending gate 禁 30） |
+| B4 | [`../pointers/SDD_HAT_FLOW_v1_zh.md`](../pointers/SDD_HAT_FLOW_v1_zh.md) 指向 **SDD_HAT_FLOW_v2** |
+
+### C · 机械验证（须跑命令 · 贴退出码）
+
+```bash
+cd /path/to/cyning-harness
+npm test
+node bin/harness.js check --target examples/demo_checkout 2>/dev/null || true
+npm pack --dry-run 2>&1 | head -20
+```
+
+| # | 通过标准 |
+|---|----------|
+| C1 | `npm test` 全绿 |
+| C2 | `harness check` 无新增 error（warn 须列出） |
+| C3 | `npm pack` 无 `_sandbox` / `.env` / 密钥路径 |
+
+---
+
+## 落盘（必须）
+
+路径：`docs/methodology/execution/reviews/review_v2_hat_flow_YYYYMMDD.md`
+
+文内结构：
+
+1. 元信息（base commit · 审查 Agent · 日期）  
+2. **A/B/C 核对表**（每项 pass / fail + 一行证据）  
+3. **阻塞 / 非阻塞** 清单  
+4. **结论**：`ready_for_2.0.4` | `needs_fix`（附修复文件列表）  
+
+---
+
+## 若无阻塞 · 2.0.4 升级清单（顺序执行）
+
+> **范围**：仅 docs/ontology/prompts/版本号 · **不改** CLI 行为除非测试失败迫使修 bug。
+
+- [ ] `package.json` → `"version": "2.0.4"`  
+- [ ] `ontology.yaml` → `product_semver: "2.0.4"`（若字段存在）  
+- [ ] `CHANGELOG.md`：将 [`Unreleased`] 下写入 **2.0.4** 节（Added/Changed · 链 `SDD_HAT_FLOW_v2` · DESIGN_ONTOLOGY v1.3 · 30⇄40 纪律）  
+- [ ] 修复 B 节发现的 **阻塞** 文档漂移（若有）  
+- [ ] `npm test` 再跑一遍  
+- [ ] `git commit`（type: `docs(release)` 或 `chore(release)`）  
+- [ ] `git tag v2.0.4` · **仅当用户明确要求 push 时** `git push origin main && git push origin v2.0.4`  
+- [ ] **npm publish**：**禁止 Agent 自动执行** · 输出 [`TEMPLATE_HG_RELEASE_v1_zh.md`](./TEMPLATE_HG_RELEASE_v1_zh.md) 勾选提醒给人  
+
+---
+
+## 禁止什么
+
+- **Open 工作区根**改 Ink `docs/harness/`（本 Prompt 只动 **cyning-harness** 仓）  
+- 未跑 C 节就宣称 ready  
+- 无复查 md 就 bump 版本  
+- 擅自 `npm publish` · 改 GitHub visibility  
+
+---
+
+## 可复制 Prompt 正文
+
+```text
+你是 cyning-harness 维护者复查 Agent。Open Folder 必须是 cyning-harness 产品仓根。
+
+## 背景
+刚合并 V2 帽链文档（commit b868671）：SDD_HAT_FLOW_v2、DESIGN_ONTOLOGY v1.3、ontology.yaml、Starter prompts 30⇄40 同 Agent 纪律。当前 package 版本 2.0.3。
+
+## 必读
+@docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md
+@docs/methodology/product/SDD_HAT_FLOW_v2_zh.md
+@docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md
+@ontology.yaml
+@harness/prompts/README.md
+@harness/prompts/30-execute-code.md
+@harness/prompts/40-self-check.md
+@CHANGELOG.md
+@package.json
+
+## 任务
+1. 按 Prompt 文档 **A/B/C** 节逐项复查；跑 npm test 与 harness check（命令见 C 节）。
+2. 落盘 docs/methodology/execution/reviews/review_v2_hat_flow_YYYYMMDD.md。
+3. 若无阻塞：执行 **2.0.4 升级清单**（bump · CHANGELOG · commit · tag v2.0.4）。
+4. 若有阻塞：只输出修复清单与最小 diff 建议，**不要** bump 版本。
+5. 结尾输出：审查结论 · commit short-hash · 是否 ready for HG-RELEASE（npm 须人签）。
+
+## 标准流程真值（核对用）
+人+00 大纲 → 10-spec R0–R9 → 20-spec-audit + HG-SPEC-SIGNOFF → 00 起草 P0 task → 10-task → 20-task-audit R1 → HG-AUDIT-R1 → 30→40（同 Agent 自修重跑）→ 50（↺30）→ CLOSE。
+```
+
+---
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-06-21 | v1：post b868671 复查 + 2.0.4 patch 升级 Prompt |

package/docs/methodology/execution/README.md

@@ -4,6 +4,7 @@
 | --- | --- |
 | **[`P0_V0.2_GAP.md`](./P0_V0.2_GAP.md)** | v0.2 最小闭环 · 已有/缺口 · 演示命令 |
 | **[`PILOT_EVIDENCE_B2_v1_zh.md`](./PILOT_EVIDENCE_B2_v1_zh.md)** | Track B · B2 量化 + SDD-Compliance bench（**draft · #8**） |
+| **[`PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md`](./PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md)** | V2 帽链 post-merge 复查 · **2.0.4** patch 升级 |
 
 **金样路径**：[`../../examples/demo_checkout/`](../../examples/demo_checkout/README.md) + [`ACCEPTANCE.md`](../../examples/demo_checkout/ACCEPTANCE.md)
 

package/docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md

@@ -0,0 +1,71 @@
+# V2 帽链复查 · post b868671
+
+## 元信息
+
+| 项 | 值 |
+|----|-----|
+| **base commit** | `b868671` · `docs(product): V2 帽链 SDD_HAT_FLOW_v2 与本体/Starter 对齐` |
+| **审查 Agent** | cyning-harness 维护者复查 Agent |
+| **日期** | 2026-06-21 |
+| **task_slug** | `cyning-harness-v2-hat-flow-review` |
+| **当前包版本（审查时）** | 2.0.3 |
+| **目标版本** | 2.0.4（docs-only patch） |
+
+---
+
+## A · 帽链真值一致性
+
+| # | 结果 | 证据 |
+|---|------|------|
+| A1 | **pass** | [`SDD_HAT_FLOW_v2_zh.md`](../../product/SDD_HAT_FLOW_v2_zh.md) §1 标准流程与人描述一致：00→10-spec→20-spec-audit↔HG-SPEC-SIGNOFF→00 起草 P0→10-task→20-task-audit↔HG-AUDIT-R1→30→40（同 Agent）→50→CLOSE |
+| A2 | **pass** | [`DESIGN_ONTOLOGY_v1_zh.md`](../../product/DESIGN_ONTOLOGY_v1_zh.md) v1.3 · §3.2 / §4.1 / §8 与 A1 一致；§4.1 显式链 SDD_HAT_FLOW_v2 |
+| A3 | **pass** | [`ontology.yaml`](../../../../ontology.yaml) `version: "1.3"` · `starter_hats`（10-task/20-task-audit/30/40）· `extended_hats`（10-spec/20-spec-audit/00/50）· D1/D2 公理与 V2 一致 |
+| A4 | **pass** | [`harness/prompts/README.md`](../../../../harness/prompts/README.md) V2 流程 · 30/40 同 Agent；[`30-execute-code.md`](../../../../harness/prompts/30-execute-code.md) §输出形状含 40 闭环；[`40-self-check.md`](../../../../harness/prompts/40-self-check.md) §身份写明 30 同 Agent |
+| A5 | **pass** | [`README.md`](../../../../README.md) §典型工作流（V2）+ 链 SDD_HAT_FLOW_v2；[`AGENTS.md`](../../../../AGENTS.md) 阅读顺序 #2；[`ARCHITECTURE.md`](../../../ARCHITECTURE.md) §7 链 SDD_HAT_FLOW_v2 |
+
+---
+
+## B · 残留旧编号
+
+| # | 结果 | 证据 |
+|---|------|------|
+| B1 | **pass** | 无文档作为**唯一真值**写「10→22→30 金样」且无 V2 上下文；[`README.md`](../../../../README.md) / prompts README 已 V2。历史执行文档（`P0_V0.2_GAP.md` · `demo_checkout/ACCEPTANCE.md` · `golden/POINTER_*`）仍用文件名别名 **10→22→30**，属 v0.2 金样考古 · **非阻塞** |
+| B2 | **pass** | [`10-requirements.md`](../../../../harness/prompts/10-requirements.md) HEADER：`hat_id（V2）：10-task`；[`22-task-audit.md`](../../../../harness/prompts/22-task-audit.md) HEADER：`hat_id（V2）：20-task-audit` |
+| B3 | **pass** | `lib/task-meta.js` `evaluateMayStart30`：HG-AUDIT-R1 非 approved → blocked；`test/graph-hgm.test.js` checkAxioms D2；`test/verify.test.js` pending → exit 2 / may_start_30 false |
+| B4 | **pass** | [`pointers/SDD_HAT_FLOW_v1_zh.md`](../../pointers/SDD_HAT_FLOW_v1_zh.md) 产品仓真值 → SDD_HAT_FLOW_v2 |
+
+---
+
+## C · 机械验证
+
+| # | 结果 | 证据 |
+|---|------|------|
+| C1 | **pass** | `npm test` · **72/72** 绿 · exit **0**（须在非沙箱环境；沙箱 EPERM 读 `node_modules/js-yaml` 会误红） |
+| C2 | **pass** | `node bin/harness.js check --target examples/demo_checkout` · exit **0** · 状态：未接入（无 manifest）· 无 error |
+| C3 | **pass** | `npm pack --dry-run` · 无 `_sandbox` / `.env` / 密钥路径 |
+
+---
+
+## 阻塞 / 非阻塞
+
+### 阻塞
+
+无。
+
+### 非阻塞（可选后续）
+
+| 项 | 说明 |
+|----|------|
+| 历史金样文案 | `examples/demo_checkout/` · `P0_V0.2_GAP.md` 等仍写「10→22→30」文件名路径 · 可加 V2 脚注 |
+| USER_GUIDE FAQ | §12「10→22→30→40」可改为「10-task→20-task-audit→30→40」 |
+| `ontology.yaml` product_semver | 审查时为 `2.0.0` · 与 package 2.0.3 漂移 · **2.0.4 bump 一并修正** |
+
+---
+
+## 结论
+
+**`ready_for_2.0.4`**
+
+审查通过后执行：package.json 2.0.4 · ontology product_semver 2.0.4 · CHANGELOG · commit · tag v2.0.4。
+
+**HG-RELEASE**：npm publish / GitHub Release **须维护者人签** · 见 [`TEMPLATE_HG_RELEASE_v1_zh.md`](../TEMPLATE_HG_RELEASE_v1_zh.md)。

package/docs/methodology/pointers/HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md

@@ -0,0 +1,31 @@
+# POINTER · 帽子链 V2 一页纸
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **版本** | v1.0 |
+| **日期** | 2026-06-29 |
+| **真值** | 工作区 `Projects/docs/harness/guides/POINTER_hat_chain_v2_onepager_v1_zh.md` |
+| **修正测评** | 工作区 `Projects/docs/harness/guides/ASSESSMENT_hat_chain_00_50_corrected_v1_zh.md` |
+| **三方原文（只读）** | 工作区 `Projects/docs/harness/guides/ASSESSMENT_third_party_hat_chain_00_50_archive_v1_zh.md` |
+
+> **本文件为 POINTER · 禁止复制全文**。对外/面试摘要请打开上方「真值」链接。
+
+---
+
+## 一句话
+
+工作区 Harness V2 帽链 = **00 编排 + 10 双轨思考 + 20 双类型书面审 + 人闸 + 30–40–可选 50**，目标是把 AI 编码做成 **有规格冻结点、有书面签收、有命令证据、有独立复检、有 CI 终审** 的 PR 级交付。
+
+## 关键纪律
+
+- **双 20**：`20-spec-audit` 审 SPEC，`20-task-audit` 审 task；**不可合并为单审**。  
+- **人闸**：`HG-AUDIT-R1` 必须在 30 执行前书面 approved；00/Agent **禁止代签**。  
+- **50 可选**：非每个 task 都须 50，但 40 自检证据必须可复核。  
+- **invoke ≠ cache**：invoke 是 **开帽快照**，不是 prompt 缓存。  
+
+## 阅读顺序
+
+1. 真值 one-pager：[`POINTER_hat_chain_v2_onepager_v1_zh.md`](../../../../Projects/docs/harness/guides/POINTER_hat_chain_v2_onepager_v1_zh.md)  
+2. 修正测评：[`ASSESSMENT_hat_chain_00_50_corrected_v1_zh.md`](../../../../Projects/docs/harness/guides/ASSESSMENT_hat_chain_00_50_corrected_v1_zh.md)  
+3. V2 链指南：[`GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../Projects/docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md)

package/docs/methodology/pointers/README.md

@@ -16,6 +16,7 @@
 | [`PILOT_kimi_code_fork_v1_zh.md`](./PILOT_kimi_code_fork_v1_zh.md) | `docs/harness/guides/PILOT_kimi_code_fork_adoption_v1_zh.md` |
 | [`GUIDANCE_distribution_v1_zh.md`](./GUIDANCE_distribution_v1_zh.md) | `docs/harness/guides/GUIDANCE_harness_distribution_v1_zh.md` |
 | [`ASSESSMENT_etclovg_v1_zh.md`](./ASSESSMENT_etclovg_v1_zh.md) | `docs/harness/guides/ASSESSMENT_cyning_harness_etclovg_industry_v1_zh.md` |
+| [`HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md`](./HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md) | `docs/harness/guides/POINTER_hat_chain_v2_onepager_v1_zh.md` |
 
 **工作区索引**：`docs/harness/README.md`
 

package/docs/methodology/pointers/SDD_HAT_FLOW_v1_zh.md

@@ -1,8 +1,9 @@
-# POINTER · SDD_HAT_FLOW（工作区）
+# POINTER · SDD 帽链流程
 
 | 项 | 内容 |
 | --- | --- |
-| **真值** | [`docs/harness/SDD_HAT_FLOW.md`](../../../../docs/harness/SDD_HAT_FLOW.md) |
-| **说明** | 历史帽编号流程 · **Starter 以产品仓为准** |
+| **产品仓真值** | [`../product/SDD_HAT_FLOW_v2_zh.md`](../product/SDD_HAT_FLOW_v2_zh.md) |
+| **工作区 Extended** | [`docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md) |
+| **历史 v1** | [`docs/harness/SDD_HAT_FLOW.md`](../../../../docs/harness/SDD_HAT_FLOW.md)（旧编号 · 考古） |
 
-产品 SDD 对照：[`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) §8
+本体对照：[`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) §4.1 · §8