@cyning/harness 0.3.0

package/docs/ONBOARDING.md

@@ -0,0 +1,126 @@
+# 接入指南
+
+> **方法论**：产品语义与文档关系见 [`methodology/README.md`](./methodology/README.md) · 本体 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)
+
+## 1. 前置
+
+- Git
+- 自选 IDE（推荐带 Agent 能力的编辑器）
+- 业务仓已具备或计划具备：lint / test / build 之一（`ci/` 可对齐）
+
+## 2. 安装（v0.3+ · npx 优先）
+
+**推荐 · 新业务仓根目录：**
+
+```bash
+npx @cyning/harness@latest init --preset harness-only --ide cursor,agents
+```
+
+日常升级：
+
+```bash
+npx @cyning/harness upgrade
+npx @cyning/harness check    # 仅检查是否有新版本
+```
+
+写入 `.cyning-harness/manifest.json`（钉版本 · preset · ide）与 `profile.json`。  
+Schema：[`schema/manifest.v1.schema.json`](../schema/manifest.v1.schema.json)
+
+**维护者 / 离线 · clone 路径：**
+
+```bash
+git clone git@github.com:Cyning12/cyning-harness.git
+cd your-project
+/path/to/cyning-harness/wizard/install.sh --preset harness-only --ide cursor,agents
+```
+
+`wizard/` 交互问卷与 `--ide cursor,claude,agents` 仍可用；详见 [`wizard/README.md`](../wizard/README.md) · [`wizard/ONBOARDING_wizard_v1_zh.md`](../wizard/ONBOARDING_wizard_v1_zh.md)。
+
+**OSS 个人 fork 向上游 PR**：[`wizard/bootstrap-oss-fork-meta.sh`](../wizard/bootstrap-oss-fork-meta.sh) + [`examples/oss-fork/README.md`](../examples/oss-fork/README.md)（双 worktree · C3 思考回填 · 过程轨不进上游 PR）。选题：[`wizard/scan-upstream-issues.sh`](../wizard/scan-upstream-issues.sh)（`kimi-c3-candidate` 等 preset）。
+
+---
+
+## 2.1 安装向导（wizard · 存量/离线）
+
+`wizard/` 将提供勾选问卷（规划 **v0.1**）：
+
+| 步骤 | 选项 |
+|------|------|
+| 仓库类型 | 新仓 / 存量 |
+| 存量档位 | S0 小 · S1 中 · S2 大 · S3 巨（见 §3） |
+| 语言栈 | 前端 TS · 后端 Python · 全栈 · 其他 |
+| IDE 入口 | Cursor rules · CLAUDE.md · AGENTS.md（可多选 · `--ide`） |
+
+当前 **v0.3.0**：**npx 优先**（§2）；离线或维护者用 [`wizard/README.md`](../wizard/README.md) 脚本 + `--ide cursor,claude,agents`。亦可 **手工** 按 §4 复制模板。
+
+**OSS 个人 fork 向上游 PR**：[`wizard/bootstrap-oss-fork-meta.sh`](../wizard/bootstrap-oss-fork-meta.sh) + [`examples/oss-fork/README.md`](../examples/oss-fork/README.md)（双 worktree · C3 思考回填 · 过程轨不进上游 PR）。选题：[`wizard/scan-upstream-issues.sh`](../wizard/scan-upstream-issues.sh)（`kimi-c3-candidate` 等 preset）。
+
+## 3. 存量档位与图谱首次要求（D1:A + D4-a）
+
+| 档位 | 首次 30 改码前 | flowchart |
+|------|----------------|-----------|
+| **S0** 小 | 模块表人签 + 1 条主 flow | 随 task 增量 |
+| **S1** 中 | 模块表人签 + 主路径 flow | 每 Epic 约 1 张 |
+| **S2** 大 | **仅**模块表人签 + 待补清单 | discovery 排队 |
+| **S3** 巨 | 每子仓模块表 + 顶层指针 | 不合并单大图 |
+
+**「全量」** 指 **模块登记表覆盖一级模块**，不是一次画完所有 Mermaid。
+
+人工闸：**`HG-GRAPH-MODULES`**（approved 后允许执行改码 task）。
+
+## 4. 手工接入（v0.0.1）
+
+在 **你的业务仓库** 根目录：
+
+```bash
+# 1. 克隆本产品（或已 clone）
+git clone git@github.com:Cyning12/cyning-harness.git
+
+# 2. 复制模板（示例 · 按栈裁剪）
+mkdir -p docs/_tech_graph docs/coding_wiki docs/standards docs/tasks docs/harness
+cp -R cyning-harness/graph/templates/* docs/_tech_graph/
+cp -R cyning-harness/coding_wiki/templates/* docs/coding_wiki/
+# … 见各子目录 README
+```
+
+3. 填写 `01_struct.md` 模块表 → 人签 `HG-GRAPH-MODULES`  
+4. 从 `harness/templates/` 创建首张 `task_*.md`  
+5. IDE 中 `@` task + `harness/prompts/` 执行  
+
+## 5. 五轨检查清单
+
+- [ ] `docs/_tech_graph/` 骨架 + 模块表
+- [ ] `docs/coding_wiki/` 读序
+- [ ] `docs/standards/`（按栈）
+- [ ] `docs/tasks/` + `docs/harness/invokes/` 约定
+- [ ] CI 样例已适配
+- [ ] IDE 入口已生成
+
+## 6. task 关账与 done 分层索引（v0.2.1）
+
+关账时 **勿** 将全文 task 平铺于 `done/` 根目录并拉长 `_views/done.md`。
+
+| 步骤 | 动作 |
+|------|------|
+| 1 | `git mv docs/tasks/active/<file>.md docs/tasks/done/<domain>/` |
+| 2 | 头部 `done（YYYY-MM-DD 验收通过）` |
+| 3 | `done/README.md` 对应域表 **追加一行** |
+| 4 | 可选同步 `_views/done_by_domain.md` |
+| 5 | `_views/done.md` 保持薄指针 |
+
+**域推断**：[`harness/templates/FRAGMENT_task_domain_infer_v1_zh.md`](../harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)  
+**模板**：`TASK_done_README.md` · `VIEW_done_by_domain.md` · `VIEW_done_thin_pointer.md`  
+**install** 自动创建 `done/<domain>/` 与 Hub（文件不存在时）。
+
+工作区 Harness 路径为 `docs/harness/tasks/`（结构相同）。
+
+## 7. 常见问题
+
+**Q：本产品会调 LLM 吗？**  
+A：不会。LLM 在你使用的 IDE 中运行。
+
+**Q：必须一次画完所有架构图吗？**  
+A：不必。模块表人签 + 主路径即可开工；其余增量。
+
+**Q：Harness 关账等于图谱关账吗？**  
+A：不等。改 BFF/模块边界时须 **同 task 或子 task** 更新相关 flow。

package/docs/P0_V0.2_GAP.md

@@ -0,0 +1,6 @@
+# POINTER · P0 差距清单
+
+| 项 | 内容 |
+| --- | --- |
+| **真值** | [`methodology/execution/P0_V0.2_GAP.md`](./methodology/execution/P0_V0.2_GAP.md) |
+| **总指引** | [`methodology/README.md`](./methodology/README.md) |

package/docs/README.md

@@ -0,0 +1,38 @@
+# cyning-harness · 文档索引
+
+| 项 | 内容 |
+| --- | --- |
+| **入口** | 本页 → **[方法论总指引](./methodology/README.md)** |
+| **接入** | [`ONBOARDING.md`](./ONBOARDING.md) · [`../wizard/README.md`](../wizard/README.md) |
+| **架构** | [`ARCHITECTURE.md`](./ARCHITECTURE.md) |
+
+---
+
+## 快速导航
+
+| 读者 | 先读 |
+| --- | --- |
+| **新接入** | ONBOARDING → wizard/install → [`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/pointers/`](./methodology/pointers/README.md) → 工作区 STRATEGY_* |
+| **HGM 远期** | [`methodology/graph/`](./methodology/graph/README.md) |
+
+---
+
+## 目录结构
+
+```text
+docs/
+├── README.md                 # 本页
+├── ARCHITECTURE.md           # 五轨 · 与业务仓关系
+├── ONBOARDING.md             # 接入指南
+├── DESIGN_ONTOLOGY_v1_zh.md  # POINTER → methodology/product/
+├── P0_V0.2_GAP.md            # POINTER → methodology/execution/
+├── HARNESS_GRAPH_MODEL_*.md  # POINTER → methodology/graph/
+└── methodology/              # ★ 方法论与本体 · 总指引
+    ├── README.md · ROADMAP_v1_zh.md · DOCUMENT_MAP_v1_zh.md
+    ├── product/ · graph/ · execution/ · pointers/
+    └── prompts/              # Agent 写作 / 讨论 Prompt
+```
+
+**修订**：2026-06-15 · 方法论归集至 `methodology/`

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

@@ -0,0 +1,69 @@
+# 一致性审计报告 · 2026-06-15
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `closed` · 后续任务已落盘 |
+| **触发** | [`prompts/PROMPT_doc_consistency_audit_v1_zh.md`](./prompts/PROMPT_doc_consistency_audit_v1_zh.md) |
+| **真值层** | L2 `docs/methodology/` |
+
+---
+
+## 摘要（≤150 字）
+
+L2 真值链大体自洽，但存在 semver（v0.5 HGM 晚于 v1.0 闸门）、HGM design §5 与 ROADMAP 对 `gate-check --graph` 版本分歧、公众 ICV 三支柱 vs 产品 ICVO 四支柱缺桥接、STRATEGY A0「已完成」与 P0 未闭合等漂移。**2026-06-15 已全部落盘修复**（见 §6）。
+
+---
+
+## 问题清单（按严重程度）
+
+| 级别 | ID | 问题 | 影响读者 | 建议改法 | 涉及文件 | 状态 |
+| --- | --- | --- | --- | --- | --- | --- |
+| P0 | SEM-01 | v0.5.x 在 semver 表位于 v1.0 后，数字易误读 | 以为 HGM 是 v1.0 前产品版 | Track G 子表 + 对外脚注 | `ROADMAP_v1_zh.md` 等 | ✅ |
+| 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` | ✅ |
+
+---
+
+## ICVO 升级说明草稿（给续篇用）
+
+连载 **方法论地图（v1.0.2+）** 中的 **ICV 三支柱**（Inform · Constrain · Verify）归属 **SDD 上层方法论**；**Harness 协作流程** 落实 **过程轨**，**不是** 与 ICV 平级的第四方法论支柱——**不变**。
+
+在 **cyning-harness 产品本体（v1.2）** 中，卷三已实践的 **帽链、Handoff（00）、Epic 编排、invoke/review 落盘** 显式命名为第四产品支柱 **Orchestrate（编排）**，记作 **ICVO**——**产品轨映射升格**，不替代 Verify，不推翻 SDD 或公众 ICV。
+
+**卷三/卷四对照**：§13 阶段流、§14 半自动 → Orchestrate；卷四 Epic → EpicTask；00 Handoff → OrchestratorHat（Extended）。
+
+**方法论地图 v1.0.3**：已增 §3 脚注（不改正文结构）。
+
+---
+
+## semver / Track G 对外统一用语建议
+
+> cyning-harness 产品主版本按 **v0.2 → v0.3（npx）→ v0.4（public push）→ v1.0（stable）** 推进。**Track G（Harness Graph Model）** 是 **v1.0 公理稳定后的可选增强**，能力标签 **G1 / v0.5+**，**不是** 早于 v1.0 的产品版，也 **不阻塞** Q3 开源。对外请写 **「Track G 提案」** 或 **「G1：事件+jsonl ingest（proposal · 未实现）」**。
+
+---
+
+## 6. 已执行后续任务
+
+- [x] 更新 DOCUMENT_MAP §4 版本锚点
+- [x] ROADMAP 增「对外表述」脚注 + Track G 子表
+- [x] 方法论地图 v1.0.3 勘误（ICVO 脚注 · 不改正文结构）
+- [x] DESIGN_ONTOLOGY product/README 链到续篇 / ICVO 对照
+- [x] HGM design §5 / 依赖行校正
+- [x] STRATEGY_MASTER A0 · §1.1 · §4.9
+- [x] PILOT 与 P0 边界句
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-15 | 初版审计 · 同日落盘修复 |

package/docs/methodology/DOCUMENT_MAP_v1_zh.md

@@ -0,0 +1,122 @@
+# 文档关系图 · Harness 方法论（v1）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **日期** | 2026-06-15 |
+| **用途** | 归档 **谁引用谁** · 真值在哪 · 避免复制漂移 |
+| **维护** | 增删 L2 文档时同步更新 §2 矩阵 |
+
+---
+
+## 1. 总览（Mermaid）
+
+```mermaid
+flowchart TB
+  subgraph L0["L0 治理 · ai_coding_governance"]
+    ADOPT[HARNESS_ADOPTION_METHODOLOGY]
+    TARGET[HARNESS_ADOPTION_TARGET_STATE]
+    ASSESS_INK[Harness工程测评 ai-ink]
+  end
+
+  subgraph L1["L1 工作区 · docs/harness"]
+    V2[HARNESS_V2_PLAN]
+    STRAT_M[STRATEGY_MASTER]
+    STRAT_O[STRATEGY_ONTOLOGY]
+    PILOT[PILOT_kimi_code_fork]
+    DIST[GUIDANCE_distribution]
+    PTR_REPO[POINTER_cyning_harness_repo]
+  end
+
+  subgraph L2["L2 产品仓 · docs/methodology"]
+    GUIDE[methodology/README 总指引]
+    ONTO[product/DESIGN_ONTOLOGY v1.2]
+    P0[execution/P0_V0.2_GAP]
+    HGM[graph/HGM design v0]
+    ARCH[docs/ARCHITECTURE]
+    ONB[docs/ONBOARDING]
+  end
+
+  subgraph L3["L3 业务仓实例"]
+    TASK[docs/tasks]
+    PROMPT[docs/harness/prompts]
+    REV[docs/harness/reviews]
+  end
+
+  ADOPT -.->|inform| STRAT_M
+  TARGET -.->|inform| ONTO
+  STRAT_O -->|约束| ONTO
+  STRAT_M -->|里程碑| P0
+  PTR_REPO -->|指针| GUIDE
+  ONTO -->|公理 S1-S6 D1-D7| PROMPT
+  ONTO -->|实现范围| P0
+  ONTO -->|语义层| HGM
+  HGM -->|事件投影| REV
+  ONB -->|install| TASK
+  ARCH -->|五轨| ONB
+  V2 -.->|工作区 Ink| TASK
+  PILOT -->|验证| P0
+  DIST -->|npx A1| P0
+```
+
+---
+
+## 2. 文档矩阵
+
+| 文档 | 层 | 仓库路径 | 角色 | 直接依赖 |
+| --- | --- | --- | --- | --- |
+| HARNESS_ADOPTION_METHODOLOGY | L0 | `ai_coding_governance/methodology/harness/` | 推广方法论过程态 | — |
+| HARNESS_ADOPTION_TARGET_STATE | L0 | 同上 | 目标态 | METHODOLOGY |
+| STRATEGY_MASTER | L1 | `docs/harness/guides/` | 路线真值 · A/B/C 轨 | STRATEGY_ONTOLOGY |
+| STRATEGY_ONTOLOGY | L1 | 同上 | 战略本体 · push 清单 | DESIGN_ONTOLOGY |
+| HARNESS_V2_PLAN | L1 | `docs/harness/` | Ink 工作区 Harness 规划 | AGENTS.md §8 |
+| PILOT_kimi_code_fork | L1 | `docs/harness/guides/` | kimi-code-meta 试点 | ONBOARDING · wizard |
+| GUIDANCE_distribution | L1 | 同上 | npx / ctx / MCP | STRATEGY_MASTER |
+| **ROADMAP v1.3** | L2 | `methodology/` | **产品 semver · Track G · B 证据** | STRATEGY_MASTER · ONTOLOGY |
+| **REVIEW B3 bench** | L2 | `methodology/reviews/` | B8 方案审核稿 · 1+3 | ROADMAP §6 · task #8 |
+| **REVIEW B9 shell** | L2 | `methodology/reviews/` | B9 方案审核稿 · 并行 | ROADMAP §6 · task #9 |
+| **PROMPT feasibility B** | L2 | `methodology/prompts/` | B8+B9 联合审核 Invoke | REVIEW_B3 · REVIEW_B9 |
+| **AUDIT doc consistency** | L2 | `methodology/` | 一致性审计归档 | PROMPT_doc_consistency_audit |
+| **methodology/README** | L2 | `cyning-harness/docs/methodology/` | **总指引** | 本文件 |
+| **DESIGN_ONTOLOGY v1.2** | L2 | `methodology/product/` | **产品语义真值** | ARCHITECTURE · templates |
+| **P0_V0.2_GAP** | L2 | `methodology/execution/` | 实现差距 · 演示命令 | ONTOLOGY §0.2 |
+| **HGM design v0** | L2 | `methodology/graph/` | 图+事件远期 | ONTOLOGY v1.2 |
+| HGM dialogue archive | L2 | `methodology/graph/` | 参考 · 非真值 | HGM design |
+| ARCHITECTURE | L2 | `docs/` | 五轨物理结构 | — |
+| ONBOARDING | L2 | `docs/` | 接入 UX | wizard |
+| demo_checkout | L2 | `examples/` | P0 金样 | P0 · ACCEPTANCE |
+
+---
+
+## 3. POINTER 规则
+
+| 规则 | 说明 |
+| --- | --- |
+| **真值唯一** | L2 全文只在 `methodology/product|graph|execution/` |
+| **根目录 POINTER** | `docs/DESIGN_ONTOLOGY_v1_zh.md` 等短 POINTER · 兼容旧链 |
+| **工作区 POINTER** | `docs/harness/guides/POINTER_*` → L2 路径 |
+| **禁止** | 在 POINTER 中复制 L2 全文 |
+
+---
+
+## 4. 版本锚点（2026-06-15）
+
+| 文档 | 版本 |
+| --- | --- |
+| DESIGN_ONTOLOGY | v1.2 · draft |
+| ROADMAP | v1.3 · active |
+| HGM design | v0.1 · proposal |
+| STRATEGY_ONTOLOGY | v1.1 · active（L1 · 工作区） |
+| P0 gap | active |
+| methodology README | v1.2 |
+| 一致性审计 | [`AUDIT_doc_consistency_2026-06-15_zh.md`](./AUDIT_doc_consistency_2026-06-15_zh.md) |
+
+---
+
+## 5. 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-15 | 初版关系图 · 归集 methodology/ 后 |
+| 2026-06-15 | §4 版本锚点同步 v1.1 · 补 ROADMAP · 审计报告链 |
+| 2026-06-15 | B8/B9 审核稿 · ROADMAP v1.3 |

package/docs/methodology/README.md

@@ -0,0 +1,147 @@
+# Harness 方法论 · 总指引
+
+
+| 项       | 内容                                                 |
+| ------- | -------------------------------------------------- |
+| **状态**  | `active`                                           |
+| **版本**  | v1.2                                               |
+| **日期**  | 2026-06-15                                         |
+| **路线真值** | [`ROADMAP_v1_zh.md`](./ROADMAP_v1_zh.md) · 工作区 Epic [`TASK_epic_cyning_harness_roadmap`](../../../../docs/harness/tasks/active/TASK_epic_cyning_harness_roadmap_v0_2_to_v1_v1.md) |
+| **范围**  | cyning-harness **产品仓**内方法论文档索引 · 与工作区 / 治理仓分层      |
+| **关系图** | `[DOCUMENT_MAP_v1_zh.md](./DOCUMENT_MAP_v1_zh.md)` |
+
+
+> **阅读顺序（维护者）**：战略 POINTER → 产品设计本体 v1.2 → P0 差距 →（可选）HGM 草案 v0 · [一致性审计 `AUDIT_doc_consistency_2026-06-15_zh.md`](./AUDIT_doc_consistency_2026-06-15_zh.md)  
+> **阅读顺序（接入者）**：`[../ONBOARDING.md](../ONBOARDING.md)` → `[execution/P0_V0.2_GAP.md](./execution/P0_V0.2_GAP.md)` → 金样 `[../examples/demo_checkout/](../examples/demo_checkout/)`
+
+---
+
+## 1. 文档分层（四层）
+
+```text
+L0  治理 / 行业     ai_coding_governance/methodology/     （私有 · 推广方法论）
+L1  工作区战略      Projects/docs/harness/guides/         （STRATEGY_* · 试点 · 分发）
+L2  产品方法论      cyning-harness/docs/methodology/      （本目录 · 真值）
+L3  运行实例        业务仓 docs/tasks · harness · …       （S2 保护 · 用户数据）
+```
+
+
+| 层      | 回答的问题                          | 真值位置                                              |
+| ------ | ------------------------------ | ------------------------------------------------- |
+| **L0** | 为什么 Harness · 目标态 · 行业对照       | 治理仓 POINTER → `[pointers/](./pointers/README.md)` |
+| **L1** | 何时开源 · 里程碑 · 试点 kimi-code-meta | 工作区 `docs/harness/guides/`                        |
+| **L2** | Track/Hat/Sync 如何实现 · 公理 · HGM | **本目录** `product/` · `graph/` · `execution/`      |
+| **L3** | 具体 task / review / invoke      | 嵌入后的业务仓                                           |
+
+
+**冲突时**：L2 产品本体 > L1 战略叙事 > L0 治理泛化（实现细节以 L2 为准）。
+
+---
+
+## 2. 子目录职责
+
+
+| 目录                                    | 内容                                   | 主文档                                                                                  |
+| ------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------ |
+| `[product/](./product/README.md)`     | **产品设计本体** · 类 / 公理 / 状态机            | `[DESIGN_ONTOLOGY_v1_zh.md](./product/DESIGN_ONTOLOGY_v1_zh.md)` v1.2                |
+| `[graph/](./graph/README.md)`         | **Harness Graph Model** · 过程实例图 + 事件 | `[HARNESS_GRAPH_MODEL_design_v0_zh.md](./graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)` |
+| `[execution/](./execution/README.md)` | **落地差距** · P0 命令 · 验收                | `[P0_V0.2_GAP.md](./execution/P0_V0.2_GAP.md)`                                       |
+| `[reviews/](./reviews/)`              | **方案审核稿** · 待外部 Agent 审方向           | `REVIEW_B3_*` · `REVIEW_B9_*`                                                        |
+| `[prompts/](./prompts/)`                | 审计 / 写作 / **可行性审核** Invoke          | `PROMPT_feasibility_review_b_evidence_v1_zh.md`                                       |
+| `[pointers/](./pointers/README.md)`   | 工作区 / 治理仓 **只读 POINTER**             | 禁止复制全文                                                                               |
+
+
+---
+
+## 3. 核心概念链（精简）
+
+```text
+战略本体 (DisciplinePackage · MIT · push)
+    ↓ 约束
+产品设计本体 (Track · Hat · Gate · P/S/D 公理 · ICVO)
+    ↓ 实现
+wizard / harness-sync / gate-check（命令式 · 类 OOP）
+    ↓ 可选 v0.5+
+Harness Graph Model（显式边 + 事件历史 + 公理查询）
+```
+
+**HGM 公式**（见 `[graph/README.md](./graph/README.md)`）：
+
+```text
+HGM = 结构化对象 + 显式带类型的边 + 不可变事件历史 + 可推理的公理
+```
+
+---
+
+## 4. 与工作区 Harness V2 的关系
+
+
+| 工作区文档                                                       | 关系                                   |
+| ----------------------------------------------------------- | ------------------------------------ |
+| `[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 为准      |
+| 工作区 `docs/harness/prompts/`                                 | **Extended** 全量帽 · 不默认复制进产品包         |
+
+
+产品包 **Starter** 闭包：`harness/prompts/` 10 · 22 · 30（+ A2 待 40）。
+
+---
+
+## 5. 后续优化全景
+
+§5 不是「仅 5 条文档待办」，而是 **文档轨（O）** 摘要；**产品 / 试点 / HGM** 见 [`ROADMAP_v1_zh.md`](./ROADMAP_v1_zh.md)。
+
+### 5.1 文档轨（O 系列）
+
+| # | 项 | 目标版本 |
+| --- | --- | --- |
+| O1 | `ontology.yaml` 从本体抽取 | v0.4 |
+| O2 | 本总指引与 STRATEGY_MASTER 日历双向链 | v0.3 |
+| O3 | HGM `events/*.jsonl` 原型（**proposal · 未实现**） | Track G · v0.5+ |
+| O4 | 对外博客 · ICVO 四支柱 · §7.5 展开 | Q3 push 前 |
+| O5 | 治理仓 L0 单页摘要（不重复 L2） | 可选 |
+| O6 | `DOCUMENT_MAP` 随 semver 自动校验脚本 | v1.0 |
+| O7 | 写作 Prompt 系列沉淀（[`prompts/`](./prompts/)） | 持续 |
+
+### 5.2 产品实现轨（P 系列 · 摘要）
+
+| # | 项 | 版本 | 真值 |
+| --- | --- | --- | --- |
+| P0 | 金样 10→22→30 闭环 | v0.2 | [`execution/P0_V0.2_GAP.md`](./execution/P0_V0.2_GAP.md) |
+| P1 | npx · manifest · S5（**v0.3 · 未实现**） | v0.3 | 本体 §7.4 · ROADMAP §2 |
+| P2 | 40 帽 · task schema · FailureReport | v0.3.x | 本体 §7.2 |
+| P3 | ontology.yaml · D7 · public push | v0.4 | ROADMAP A3.5 |
+| P4 | ICVO audit · invoke_index · Inform graph | v1.0 | 本体 §5.4 |
+| P5 | 三路合并 · rollback | v0.4 | 本体 §4.3 · S6 |
+
+### 5.3 知识建模轨（K 系列 · HGM）
+
+| # | 项 | 版本 |
+| --- | --- | --- |
+| K1 | 事件 schema + ingest（**proposal · 未实现**） | Track G · G1 / v0.5+ |
+| K2 | snapshot + axioms check（**proposal**） | v0.5–v0.6 |
+| K3 | timeline / patterns（**proposal**） | v0.7–v0.8 |
+| K4 | 与 Runtime/C 轨推理衔接 | v1.0+ · **未立项** |
+
+> **Track G 用语**：**G1 / v0.5+** 为能力标签，**启动闸门在 v1.0 之后**（见 [`ROADMAP_v1_zh.md`](./ROADMAP_v1_zh.md) §2.2 · §5）· 非「下一个产品 semver」。
+
+### 5.4 试点与叙事轨（B/D · 摘要）
+
+| 轨 | 项 | 指针 |
+| --- | --- | --- |
+| B | kimi-code-meta · **#8 B2+micro-bench（1+3）** · **#9 Agent-shell（2 并行）** | [`reviews/REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md`](./reviews/REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md) · [`REVIEW_B9_agent_shell_parallel_v1_zh.md`](./reviews/REVIEW_B9_agent_shell_parallel_v1_zh.md) |
+| D | MIT push · ETCLOVG · 求职向 preset | STRATEGY_ONTOLOGY §5 |
+
+**原则**：v0.2–v0.4 **不扩 K 轨人力**；HGM 在 v1.0 公理稳定后再动 ingest（ROADMAP §5 闸门）。
+
+---
+
+## 6. 修订记录
+
+
+| 版本   | 日期         | 说明                                          |
+| ---- | ---------- | ------------------------------------------- |
+| v1.0 | 2026-06-15 | 初版总指引 · 归集 product/graph/execution/pointers |
+| v1.1 | 2026-06-15 | §5 扩为 O/P/K/B/D 全景 · ROADMAP · 写作 Prompt |
+| v1.1.1 | 2026-06-15 | K/O 轨 proposal 标注 · Track G 脚注 · 链审计报告 |
+| v1.2 | 2026-06-15 | Track B 证据 #8/#9 · reviews/ · 可行性审核 Prompt |

package/docs/methodology/ROADMAP_v1_zh.md

@@ -0,0 +1,136 @@
+# cyning-harness · 统一更新路线（v1）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **版本** | v1.3 |
+| **日期** | 2026-06-15 |
+| **性质** | **L2 产品路线真值** · 吸收本体 v1.2 + HGM + P0 后修订 |
+| **L1 对齐** | 工作区 [`STRATEGY_MASTER`](./pointers/STRATEGY_MASTER_v1_zh.md) Track A/B/C/D · **冲突时本文件管产品 semver 与能力边界** |
+
+> **2026-06-15 结论**：OOP / 本体 / 图论 / History 融合 **不推翻** v0.2→v1.0 主轨；新增 **Track G（HGM）** 为 v0.5+ 可选增强 · **不阻塞** A1 npx 与 Q3 push。
+
+---
+
+## 1. 思想栈 → 工程映射
+
+| 思想 | 在 Harness 中的落点 | 版本 |
+| --- | --- | --- |
+| **OOP** | wizard 脚本 · bash/TS 实现 · Task/Hat 作「类」的 runtime 投影 | 现在 |
+| **本体** | `product/DESIGN_ONTOLOGY` · P/S/D 公理 · ICVO 四支柱 | v1.2 已文档化 |
+| **图论（过程）** | HGM：显式边 · 遍历 · 模式查询 | **v0.5+** |
+| **History** | append-only 事件 · gate/task 状态变迁 | **v0.5+** |
+| **图论（Inform）** | `docs/_tech_graph/` · `gate-check --graph` | v1.0 |
+
+```text
+文件真值（L3 Markdown）  →  命令式实现（OOP/bash）  →  可选图+事件投影（HGM）
+         ↑ 始终优先                    ↑ v0.2–v0.4 主投入
+```
+
+---
+
+## 2. 版本里程碑（产品 semver）
+
+> **对外表述（semver 纪律）**：主产品版本按 **v0.2 → v0.3 → v0.4 → v1.0** 推进。**Track G** 能力标签为 **G1 / v0.5+**（见下表），**启动闸门在 v1.0 之后**（§5）；**不是** semver 时间序上早于 v1.0 的产品版，也 **不阻塞** Q3 public push。对外请写 **「Track G 提案」**，避免单独宣传「即将发布产品 v0.5」。
+
+### 2.1 主轨（A · 产品包）
+
+| 版本 | 代号 | 须交付（实现） | 文档 / 方法论 |
+| --- | --- | --- | --- |
+| **v0.2.x** | **P0 闭环** | harness-only · sync plan/apply · gate-check · 金样 10→22→30 | methodology/ 归集 · P0 gap |
+| **v0.3.0** | **A1 分发** | manifest · npx init/upgrade/check · S5 git-clean · **✅ 2026-06-15**（Release/npm 留维护者） | FailureReport 模板 · rejected→draft gate-check |
+| **v0.3.x** | **A2 Starter** | 40-self-check 帽 · `task.harness.v1.json` · depends_on 禁环 CLI | ONBOARDING npx 优先 |
+| **v0.4.0** | **A3 + push** | ontology.yaml · D7 HG-RELEASE · demo_checkout 脱敏 · MIT public | ETCLOVG 映射页 · README 叙事 |
+| **v1.0.0** | **A4 stable** | ICVO audit CLI · invoke_index · gate-check --graph（Inform） | CHANGELOG 冻结 · B2 量化进 README |
+
+### 2.2 Track G（HGM · v1.0 后 · proposal）
+
+| 能力标签 | 代号 | 须交付（实现） | 文档 |
+| --- | --- | --- | --- |
+| **G1 · v0.5+** | HGM 起步 | `events/*.jsonl` · graph ingest · snapshot · axioms check 子集（**均未实现**） | HGM design v0.1→v0.2 |
+| **G2 · v0.6+** | HGM 查询 | timeline · patterns · SQLite 投影 | 可选 Neo4j 导出 |
+
+**刻意不做（至 v1.0）**：GrowingReasoningAgent · OWL 推理机 · 热插拔 Track（Q5）· Neo4j 默认后端 · **Track G ingest（v1.0 前）**。
+
+---
+
+## 3. 并行轨道（与 STRATEGY_MASTER 对照）
+
+| 轨 | STRATEGY 名 | 本路线重点 | 当前 |
+| --- | --- | --- | --- |
+| **A** | 产品包 | §2 表 · v0.2→v1.0 | **A1 done** · A2 next |
+| **B** | kimi-code-meta 试点 | oss-fork-meta / kimi-code-meta preset · 上游 PR 证据 · **#8 B2+micro-bench（1+3 主链）** · **#9 Agent-shell（2 并行）** | B0 · 证据方案待审 |
+| **C** | Runtime | harness ctx · Worker · **HGM 不替代 C** | 后置 |
+| **D** | 对外叙事 | ICVO · §7.5 对比 · 理论文章（见 prompts/） | 待 P0 绿 |
+| **G** | **（新增）HGM** | §2 v0.5+ · 依赖 v1.0 公理稳定 | proposal |
+
+---
+
+## 4. 相对 STRATEGY_MASTER v1.2 的变更摘要
+
+| 变更 | 说明 |
+| --- | --- |
+| **A3 与 P0 关系** | P0 金样已建 `examples/demo_checkout/` · A3 = 脱敏 + 补 40 帽完整链 |
+| **methodology/** | L2 文档真值集中 · 不改变 A1–A4 日期 |
+| **Track G** | 新增 · 不插入 A1/A2 人力 · v0.5 启动条件：v0.4 push 完成 + P0/A2 绿 |
+| **ICVO 叙事** | 纳入 D 轨与 v1.0 验收 · 非新 semver |
+| **三路合并 / rollback** | 仍 v0.3 设计 · v0.4 实现（本体 §4.3） |
+
+**无需重写的部分**：MIT · Q3–Q4 push · npx P0 · kimi 双分支 · Runtime 后置。
+
+---
+
+## 5. 验收闸门（阶段切换条件）
+
+| 从 → 到 | 闸门 |
+| --- | --- |
+| v0.2 → v0.3 | P0 金样 ACCEPTANCE ✅ · A1 实现 ✅（Release/npm 可后补） |
+| v0.3 → v0.4 | npx upgrade dogfood（kimi-code-meta）· ontology.yaml 草案 |
+| v0.4 → v1.0 | public push 审计 · **#8 B2 + SDD-Compliance micro-bench** · ICVO audit 子集绿 |
+| v1.0 → v0.5 HGM | 维护者确认事件 schema 冻结 · ingest 不破坏 S2 |
+
+---
+
+## 6. 工作区任务编排
+
+Epic 与子 task 真值：`Projects/docs/harness/tasks/active/`
+
+| Epic / 子 task | 对应 ROADMAP |
+| --- | --- |
+| [`TASK_epic_cyning_harness_roadmap_v0_2_to_v1_v1.md`](../../../../docs/harness/tasks/active/TASK_epic_cyning_harness_roadmap_v0_2_to_v1_v1.md) | 全文 |
+| #1 P0 golden close | v0.2.x · **done** 2026-06-15 |
+| #2 A1 npx | v0.3.0 · **done** 2026-06-15 |
+| #3 A2 Starter | v0.3.x · **next** |
+| #4 B kimi dogfood | Track B |
+| #5 D 续篇 | Track D · 篇 1 已 draft |
+| #6 A3 public push | v0.4.0 |
+| #7 A4 v1.0 | v1.0.0 · 引用 #8 |
+| **#8 B2 + bench** | Track B · **1+3 主证据** · P0 绿后优先 |
+| **#9 Agent-shell** | Track B · **2 并行** · 核实期 · 不挡 A3 |
+
+**证据策略（2026-06-15 锁定）**：
+
+| 线 | 内容 | 优先级 |
+| --- | --- | --- |
+| **1+3** | B2 真实试点量化 + SDD-Compliance micro-bench（5 scenario） | **主链** · #8 |
+| **2** | Agent-shell（Kimi agent 规则层 SDD） | **并行** · #9 · Epic 不强制 |
+
+审核稿：`methodology/reviews/REVIEW_B3_*` · `REVIEW_B9_*` · Prompt：`prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md`
+
+**审核结论（2026-06-15）**：B8 **4/5** · B9 **3/5** · 均 **APPROVE_WITH_CHANGES** · #8 **P0 绿后主投入** · #9 **≤4h/周** · #8 scenario 冻结后再开 #9
+
+**理论参考**：[`ARTICLE_纪律包工程续篇_篇1`](../../../../ai_coding_governance/narrative/discipline_package_series/ARTICLE_纪律包工程续篇_篇1_从OOP到本体_v1_zh.md)
+
+---
+
+## 7. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | 2026-06-15 | 本体+HGM 融合后首版统一路线 · 新增 Track G |
+| v1.1 | 2026-06-15 | §2 主轨/Track G 分表 · 对外表述脚注 · 一致性审计落盘 |
+| v1.2 | 2026-06-15 | §6 链工作区 Epic 任务 · 篇 1 理论参考 |
+| v1.3 | 2026-06-15 | Track B 证据三线 · #8/#9 · 审核稿索引 |
+| v1.3.1 | 2026-06-15 | B8/B9 审核结论回写 · S1–S4 · 3×2 · D6 字段 |
+| v1.3.2 | 2026-06-15 | P0 金样关账 · v0.2→v0.3 首闸满足 · A1 next |
+| v1.3.3 | 2026-06-15 | A1 实现关账 · A2 next · v0.3.0 表标注 |