@cyning/harness 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -4,6 +4,35 @@
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-06-17
+
+### Added
+
+- **Inform Graph YAML v3**：`schema/inform_graph.v3.schema.json` · 对齐试点 `*.graph.yaml` 编辑源
+- **Inform-YAML 迁移对照表**：`docs/methodology/graph/INFORM_YAML_MIGRATION_v1_zh.md` · 试点字段 → 产品字段
+- **`harness graph yaml compile|check`**：YAML → Mermaid MD + 结构化表 · YAML ↔ graph.json slice diff
+- **demo_checkout dogfood**：`examples/demo_checkout/00_main.graph.yaml` + `graph.json` + `00_main.md`
+- **测试覆盖**：`test/graph-yaml.test.js` + `test/gate-check.graph.test.js` Inform-YAML 路径
+
+### Changed
+
+- **USER_GUIDE v1.0**：新增 §13 Inform-YAML 章 · 明确 MD / YAML / HGM 三轨边界
+- **README**：当前版本 → **v1.1.0** · 补充 `graph yaml` 命令速查
+- **`ontology.yaml`**：`product_semver: "1.1.0"`
+
+### Notes
+
+- **HG-RELEASE**（tag v1.1.0 · npm publish）仍留维护者人闸
+- `gate-check --graph` 语义不变；Inform 模块闸仍读 `docs/_tech_graph/`
+- HGM G1 v2.0 仍待 Y1 merge + npm 发布（或维护者书面豁免）后启动
+
+## [1.0.2] - 2026-06-16
+
+### Fixed
+
+- **`verify` 无 `--task`**：摘要不再误匹配闸表行 `❌ 拒 30`；多 task 阻塞时摘要列出 blocked task 名
+- **`verify` BLOCKED**：exit 2 时不再打印空 `Error` stack trace
+
 ## [1.0.1] - 2026-06-16
 
 ### Added

package/README.md

@@ -91,6 +91,7 @@ npx @cyning/harness upgrade --gate-check       # upgrade 前自动 audit
 - **S5**：dirty 工作区 warn，apply 须 `--force` 明示  
 
 Inform 图谱闸：`npx @cyning/harness gate-check --graph --target /path/to/your-repo`  
+Inform-YAML：`npx @cyning/harness graph yaml compile|check --input docs/_tech_graph`（v1.1+）  
 Invoke 索引：`npx @cyning/harness sync index --target /path/to/your-repo`（不覆盖 S2 域）
 
 Node 仓可选：`npx @cyning/harness init --with-scripts` → `pnpm harness:verify`。  
@@ -167,7 +168,7 @@ cyning-harness/
 
 | 项 | 值 |
 |----|-----|
-| 当前 | **v1.0.0** — A4 stable · 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 证据 |
 | 上一档 | v0.4.0 — A3 public push · MIT · 脱敏金样 |
 | 许可 | **MIT** · [`LICENSE`](LICENSE) · Release [`docs/RELEASE_v1.0.0.md`](docs/RELEASE_v1.0.0.md) |
 

package/docs/USER_GUIDE_v1.0_zh.md

@@ -1,7 +1,7 @@
 # cyning-harness v1.0 · 使用手册
 
 > **读者**：要在 **自己的业务仓库** 里落地 AI 辅助研发纪律的开发者（非 cyning-harness 维护者）。  
-> **版本**：[`@cyning/harness@1.0.1`](https://www.npmjs.com/package/@cyning/harness) · MIT  
+> **版本**：[`@cyning/harness@1.1.0`](https://www.npmjs.com/package/@cyning/harness) · MIT  
 > **仓库**：<https://github.com/Cyning12/cyning-harness>  
 > **更短入口**：[`README.md`](../README.md) Quick Start · [`ONBOARDING.md`](./ONBOARDING.md) 接入细节  
 > **Release**：[`RELEASE_v1.0.1.md`](./RELEASE_v1.0.1.md) · [`CHANGELOG.md`](../CHANGELOG.md)
@@ -226,20 +226,66 @@ npm run harness -- check --target /tmp/foo
 
 ---
 
-## 10. 局限与诚实边界（v1.0）
+## 10. Inform-YAML 图谱编辑源（v1.1+）
+
+从 `@cyning/harness@1.1.0` 起，业务仓可选择用 **`docs/_tech_graph/*.graph.yaml`** 作为 Inform 架构图谱的编辑源，再编译为 `.md`（人类可读）与 `graph.json`（机器可读）。
+
+### 10.1 三轨边界
+
+| 轨 | 文件 | 用途 | 版本 |
+| --- | --- | --- | --- |
+| **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+** |
+
+**原则**：YAML 为 Inform 编辑源，HGM 为过程事件图；YAML **不替代** task/review 真值，HGM **不替代** YAML/MD Inform 正文。
+
+### 10.2 最小工作流
+
+```bash
+# 1. 在业务仓编辑 docs/_tech_graph/00_main.graph.yaml
+# 2. 编译为 Markdown（人类可读）
+npx @cyning/harness graph yaml compile --graph-id 00_main --input docs/_tech_graph
+
+# 3. 校验 YAML 与 graph.json 切片是否一致
+npx @cyning/harness graph yaml check --graph-id 00_main --input docs/_tech_graph
+
+# 4. 一次性编译/校验全部 *.graph.yaml
+npx @cyning/harness graph yaml compile --all --input docs/_tech_graph
+npx @cyning/harness graph yaml check --all --input docs/_tech_graph
+```
+
+### 10.3 schema 与迁移
+
+- **产品 schema**：[`schema/inform_graph.v3.schema.json`](../../schema/inform_graph.v3.schema.json)
+- **迁移对照表**：[`docs/methodology/graph/INFORM_YAML_MIGRATION_v1_zh.md`](./methodology/graph/INFORM_YAML_MIGRATION_v1_zh.md)
+- **试点真值**：Ink 后端 `ai-ink-brain-api-python/docs/_tech_graph/*.graph.yaml`
+
+### 10.4 与 gate-check --graph 的关系
+
+`gate-check --graph` 语义不变：仍扫描 `docs/_tech_graph/` 下所有模块/流程文件，输出 `HG-GRAPH-MODULES` 状态摘要。新增 `.graph.yaml` 文件会 **友好列出**，不改变通过/失败规则。
+
+### 10.5 金样
+
+`examples/demo_checkout/00_main.graph.yaml` 提供零风险 Inform-YAML 切片，可对照其生成的 `00_main.md` 与 `graph.json`。
+
+---
+
+## 11. 局限与诚实边界（v1.1）
 
 | 项 | 说明 |
 | --- | --- |
 | 不是胜率工具 | [`README` 试点证据 B2](../README.md) · 完整表 [`PILOT_EVIDENCE_B2_v1_zh.md`](./methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md) · **小样本机制证据**，不可外推 |
 | bench `100` | [SDD-Compliance](../examples/compliance_bench/README.md) 四场景合规率 · 见上文 §6.1 |
 | Extended 帽 | 00/50/链式 PROMPT 不在 Starter 默认包 · 见 [`harness/prompts/README.md`](../harness/prompts/README.md) |
-| HGM / 图数据库 | **Track G · v2.0+ 提案**，v1.0 未实现 |
+| Inform-YAML | **v1.1+** · 可选编辑源 · 须 `graph yaml check` 与 `graph.json` 一致 |
+| HGM / 图数据库 | **Track G · v2.0+ 提案**，v1.1 未实现事件 ingest |
 | Agent-shell | 研究轨 #9，非 npm 功能 |
 | rejected→draft | bench S5 场景 v1 未纳入；gate-check 对非 approved 拒 30 |
 
 ---
 
-## 11. 常见问题
+## 12. 常见问题
 
 **Q：Harness 会调用我的 LLM 吗？**  
 A：不会。LLM 在你使用的 IDE 里；Harness 只提供文件、脚本与约定。
@@ -253,12 +299,18 @@ A：`init --ide cursor` 会生成入口片段；Harness task + prompts 是 **任
 **Q：升级后 task 会被覆盖吗？**  
 A：不会（S2 域）。若 prompts 模板有更新，apply 会更新 **模板侧**，不删你的 active task。
 
+**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：如何贡献或报 issue？**  
 A：GitHub [Cyning12/cyning-harness](https://github.com/Cyning12/cyning-harness) · MIT。
 
 ---
 
-## 12. 进一步阅读
+## 13. 进一步阅读
 
 | 优先级 | 文档 |
 | --- | --- |
@@ -282,3 +334,4 @@ A：GitHub [Cyning12/cyning-harness](https://github.com/Cyning12/cyning-harness)
 | 2026-06-16 | v1.0 stable 首版使用手册 |
 | 2026-06-16 | 补全相对链接 · §6.1 compliance-bench · §12 阅读索引 |
 | 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` · 三轨边界说明 |

package/docs/methodology/graph/INFORM_YAML_MIGRATION_v1_zh.md

@@ -0,0 +1,81 @@
+# Inform-YAML 迁移对照表 · v1.1+
+
+> **范围**：将 Ink 后端 `*.graph.yaml` 试点能力抽象进 `@cyning/harness@1.1+`。  
+> **真值来源**：`ai-ink-brain-api-python/docs/_tech_graph/*.graph.yaml`（P0–P1 done）。  
+> **产品 schema**：`schema/inform_graph.v3.schema.json`。  
+
+---
+
+## 1. 字段对照
+
+| 试点字段（后端 graph_v2 YAML） | 产品字段（v3 schema） | 变化 | 说明 |
+| ---------------------------- | ------------------- | ---- | ---- |
+| `graph_id`                   | `graph_id`          | 无   | 图 ID · 与文件名一致 |
+| `title`                      | `title`             | 无   | 人类可读标题 |
+| `description`                | `description`       | 无   | 用途简述 |
+| `version`                    | `version`           | 无   | 编辑源版本 |
+| —                            | `schema_version`    | **新增** | 固定 `inform_graph.v3` · 显式声明 |
+| —                            | `direction`         | **新增** | Mermaid 方向 · 默认 `TD` |
+| `notes`                      | `notes`             | 无   | 字符串或字符串数组 |
+| `nodes[].id`                 | `nodes[].id`        | 无   | 节点 ID |
+| `nodes[].label`              | `nodes[].label`     | 无   | 显示标签 |
+| —                            | `nodes[].kind`      | **新增** | `flow` / `struct` / `external` |
+| `edges[].from`               | `edges[].from`      | 无   | 源节点 |
+| `edges[].to`                 | `edges[].to`        | 无   | 目标节点 |
+| `edges[].mark`               | `edges[].mark`      | 无   | Mermaid 箭头标记 |
+| `edges[].label`              | `edges[].label`     | 无   | 语义标签 |
+| `edges[].type`               | `edges[].type`      | 无   | 显式边类型 |
+| `edges[].anchors`            | `edges[].anchors`   | 无   | 代码锚点 |
+| `anchors[].path`             | `anchors[].path`    | 无   | 相对路径 |
+| `anchors[].symbol`           | `anchors[].symbol`  | 无   | 符号名 |
+| `anchors[].line`             | `anchors[].line`    | 无   | 行号 |
+
+---
+
+## 2. 有漂移须说明
+
+### 2.1 `schema_version` 新增
+
+- **原因**：产品化后须机械区分 YAML 版本，避免后端试点与产品 schema 混用。
+- **兼容**：`harness graph yaml compile` 对缺 `schema_version` 的 YAML 发出 warn，但仍尝试编译（graceful）。
+
+### 2.2 `nodes[].kind` 新增
+
+- **原因**：试点 graph_v2 schema 在 `graph.json` 阶段未强制 kind；v3 将其前移到编辑源，便于 Mermaid class 渲染与 HGM `InformArtifact` 子类型推断。
+- **兼容**：缺省 `kind` 时编译器按 label 启发式推断形状，与试点 `graph_yaml_compile.py` 行为一致。
+
+### 2.3 `direction` 新增
+
+- **原因**：试点 `00_main.graph.yaml` 未声明方向，编译器默认 `TD`；v3 显式支持 `TD/TB/BT/LR/RL`。
+- **兼容**：缺省仍为 `TD`。
+
+---
+
+## 3. 无漂移（保持语义）
+
+- `graph_id` / `title` / `description` / `version` / `notes`
+- `nodes[].id` / `nodes[].label`
+- `edges[].from` / `edges[].to` / `edges[].mark` / `edges[].label` / `edges[].type`
+- `edges[].anchors[].path` / `symbol` / `line`
+
+---
+
+## 4. 产物对照
+
+| 产物 | 试点 | 产品 v1.1+ |
+| ---- | ---- | ---------- |
+| 人类可读 MD | `scripts/graph_yaml_compile.py` | `harness graph yaml compile` |
+| graph.json 切片 | `tools/tech_graph_graph_export.py` + `tech_graph_graph_v2_yaml.py` | `harness graph yaml check`（diff 模式） |
+| 校验 schema | `tools/tech_graph_graph_v2_schema.py` | `schema/inform_graph.v3.schema.json` |
+
+---
+
+## 5. 与 HGM G1 接口
+
+- **InformArtifact 节点 ID**：`inform:{repo_rel_path}`，其中 `repo_rel_path` 为业务仓 `docs/_tech_graph/` 下编译产物路径（如 `docs/_tech_graph/00_main.md`）。
+- **MUST_READ 边**：Task → InformArtifact，由 task 表 `must_read` 或 `gate-check --graph` 解析。
+- **正文来源**：仍来自 YAML/MD 真值 · HGM 只存指针。
+
+---
+
+freeze_id: CYNING-HARNESS-Y1-YAML-INFORM

package/docs/methodology/graph/PROMPT_ontology_inventory_scan_G0_v1_zh.md

@@ -0,0 +1,313 @@
+# Prompt · 项目本体构成扫描 · HGM G0（v1.3）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` · G0 讨论素材 · **须满足执行前提 P1–P5** |
+| **用途** | 扫描产品仓或试点仓 · 产出 **本体清单报告**（不修改 DESIGN_ONTOLOGY） |
+| **触发时机** | Inform YAML 闭环 **done** + **HG-TASK-DRAFT** 签收 · 见 [`task_ontology_inventory_scan_g0_v1.md`](../../../../docs/harness/tasks/active/task_ontology_inventory_scan_g0_v1.md) · [`HGM_UPGRADE_OUTLINE_v1_zh.md`](./HGM_UPGRADE_OUTLINE_v1_zh.md) G0 |
+| **关联 task** | [`task_ontology_inventory_scan_g0_v1.md`](../../../../docs/harness/tasks/active/task_ontology_inventory_scan_g0_v1.md) · [`task_cyning_harness_g1_hgm_v2_v1.md`](../../../../docs/harness/tasks/active/task_cyning_harness_g1_hgm_v2_v1.md)（HGM G1 · deferred） |
+| **语义真值（执行时必读）** | [`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) · [`HARNESS_GRAPH_MODEL_design_v0_zh.md`](./HARNESS_GRAPH_MODEL_design_v0_zh.md) |
+| **预期产出** | [`inventory/ONTOLOGY_INVENTORY_cyning_harness_v1.yaml`](./inventory/ONTOLOGY_INVENTORY_cyning_harness_v1.yaml)（主）· [`inventory/ONTOLOGY_INVENTORY_ai_ink_brain_api_python_v1.yaml`](./inventory/ONTOLOGY_INVENTORY_ai_ink_brain_api_python_v1.yaml)（试点） |
+| **Open Folder** | **`cyning-harness/`** 或 **`ai-ink-brain-api-python/`** · **禁止**工作区根全量扫描 |
+| **invoke** | [`PROMPT_START_30_v1.md`](../../../../docs/harness/invokes/by-task/ontology-inventory-scan-g0/PROMPT_START_30_v1.md) |
+
+---
+
+## 执行 Prompt（v1.3 · P3 放宽 · 先扫描后删 ai.md）
+
+```text
+# 任务：扫描当前项目，生成“项目本体构成报告”
+
+> **维护者决策 D-G0-P3（v1.3）**：试点仓 **允许** 仍存在 `@deprecated` 的 `*.ai.md`。
+> 扫描须将其列入 `legacy_pending_delete` · **不在本任务删除** · 删源见后继 task `graph-yaml-remove-ai-md`。
+
+## ⚠️ 执行前提（硬性检查，不满足则终止）
+
+在开始扫描之前，**必须先确认以下条件全部满足**。任一 **硬门槛** 不满足，输出 fail_msg 并终止。
+
+**试点仓检查顺序**：**P1 → P2 → P4 → P5** · **P3 为盘点项（不阻断扫描）**
+
+### 前置条件清单
+
+preconditions:
+  # 1. 仓库范围确认（硬门槛）
+  - id: "P1"
+    check: "当前所在目录是 cyning-harness/ 或 ai-ink-brain-api-python/"
+    fail_msg: "请在产品仓（cyning-harness/）或试点仓（ai-ink-brain-api-python/）下执行此扫描。工作区根不执行全量扫描。"
+
+  # 2. YAML 图源就绪（试点仓 · 硬门槛）
+  - id: "P2"
+    check: "test -s docs/_tech_graph/00_main.graph.yaml"
+    fail_msg: "docs/_tech_graph/00_main.graph.yaml 不存在或为空。请先完成 00_main YAML 迁移。"
+    note: "试点仓执行时检查；产品仓跳过 P2"
+
+  # 3. deprecated .ai.md 盘点（试点仓 · 软门槛 · 不阻断）
+  - id: "P3"
+    check: "find docs/_tech_graph -name '*.ai.md' 2>/dev/null"
+    fail_msg: null
+    note: |
+      试点仓：若存在 .ai.md → 逐文件列入报告 legacy_pending_delete（status: deprecated_readonly）。
+      **不得** 因 .ai.md 存在而终止扫描。
+      产品仓跳过 P3。
+
+  # 4. 维护者审批（硬门槛）
+  - id: "P4"
+    check: "HG-TASK-DRAFT approved（task_ontology_inventory_scan_g0_v1）"
+    fail_msg: "请先获得维护者签收 HG-TASK-DRAFT 后再执行。"
+
+  # 5. 扫描目的声明
+  - id: "P5"
+    note: "本次扫描仅为 G0 讨论提供素材，不代替 HGM G1 开发规格，不修改 DESIGN_ONTOLOGY。"
+
+### 扫描范围规则
+
+- 若在 **cyning-harness/** 下执行 → 输出 **产品仓主报告**
+- 若在 **ai-ink-brain-api-python/** 下执行 → 输出 **试点仓辅助报告**
+- 若在其他目录 → **终止**并提示
+
+两份报告各自独立；**产品仓报告为「主报告」**，试点仓报告为「验证参考」。
+
+---
+
+## 角色设定
+
+你是一位精通**本体论（Ontology）**、**图论（Graph Theory）**和**知识工程**的架构分析师。你的任务是扫描给定的代码仓库/文档目录，识别其中隐含的「本体结构」，并按标准化格式输出报告。
+
+## 本体定义（给你判断用的标准）
+
+在软件工程中，**本体（Ontology）** = 对某一领域内的**概念（类）、属性、关系、公理（约束）** 的显式、形式化规范说明。
+
+你需要区分：
+- **元本体（Meta-Ontology）**：定义「如何定义本体」的顶层框架
+- **子本体（Sub-Ontology）**：针对特定领域的具体概念模型（如 Task/Hat/Gate；Node/Edge/Anchor）
+
+## 判断标准：什么是「本体文件」？
+
+清单内文件 **默认** 为本体载体；若某文件不在清单中但符合以下 **≥2 条**，可追加到报告 `gaps` 或 `additional_files`：
+1. 定义 **类/实体**
+2. 定义 **关系**
+3. 定义 **约束/公理**
+4. 作为 **唯一真相源**
+5. 在 **CI 或工具链** 中用于校验/生成
+
+## 四原语分类框架（T/K/H/B）
+
+| 原语 | 全称 | 判断标准 | 示例 |
+|---|---|---|---|
+| **T** | Topic | 分类节点 · 抽象概念 · 领域名称 | RAG、Track、Hat |
+| **K** | Keyword | 检索/验证锚点 · 阈值 · 约束 | payload_min_keys、test_strategy=required |
+| **H** | History | 时序节点 · 状态变更 · 执行轨迹 | InvokeSnapshot、AuditReview、Git commit |
+| **B** | Business | 终端业务实体/产物 | Task 实例、documents 表、npm 包 |
+
+## 四原语定位说明（重要）
+
+T/K/H/B 四原语**仅作为本次扫描报告的「分类标签」（Lens）**，用于标记扫描到的本体元素属于哪种原语类型。
+
+**它们不写入 HGM Schema、不修改 DESIGN_ONTOLOGY、不作为 HGM 节点类型。** HGM 节点类型保持项目现有命名：
+Task, Hat, HumanGate, InformArtifact, AuditReview, InvokeSnapshot, FailureReport
+
+**映射规则**（报告中 `primitives_used` 字段使用此表）：
+
+| 原语 | 映射到项目中的 | 示例 |
+|---|---|---|
+| **T (Topic)** | Track, Hat, Epic, OrchestratorHat | 概念分类、领域名称 |
+| **K (Keyword)** | _contract_manifest 中 payload_min_keys/allowed_events；embedding；RAG_MATCH_THRESHOLD | 检索锚点、约束阈值 |
+| **H (History)** | trace.json, InvokeSnapshot, AuditReview, Git commit, .version/ 索引 | 时序节点、状态变更 |
+| **B (Business)** | Task 实例, User, Project, documents/code_chunks 表, npm 包 | 终端业务实体/产物 |
+
+**报告中不出现「T/K/H/B 是 HGM 节点类型」的表述。**
+
+---
+
+## 你需要执行的具体步骤
+
+### 第1步：扫描固定文件清单（不使用通配符）
+
+**不要**使用 `*.ontology.yaml` 等模糊匹配。仅扫描以下清单中的文件（若不存在则跳过并记入 gaps）。
+
+#### 产品仓 cyning-harness/ 清单
+
+product_manifest:
+  - path: "docs/methodology/STRATEGY_ONTOLOGY_cyning_harness_v1_zh.md"
+    role: "战略本体"
+  - path: "docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md"
+    role: "产品设计本体（主）"
+  - path: "docs/methodology/product/PRODUCT_ONTOLOGY_v1.1.md"
+    role: "产品设计本体（v1.1，若存在）"
+  - path: "docs/methodology/graph/HGM_UPGRADE_OUTLINE_v1_zh.md"
+    role: "HGM 升级大纲（G0）"
+  - path: "docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md"
+    role: "HGM 设计稿（v0）"
+  - path: "docs/methodology/ROADMAP_v1_zh.md"
+    role: "路线图"
+  - path: "harness/meta/ontology.yaml"
+    role: "机器可读本体（v0.4+ 规划，若存在）"
+
+#### 试点仓 ai-ink-brain-api-python/ 清单
+
+pilot_manifest:
+  - path: "docs/_tech_graph/00_main.graph.yaml"
+    role: "图源 YAML（主流程）"
+  - path: "docs/_tech_graph/*.graph.yaml"
+    role: "图源 YAML（全量 flow）· 展开 glob 后逐文件扫描"
+  - path: "docs/_tech_graph/*.ai.md"
+    role: "legacy · @deprecated 只读对照 · 须列入 legacy_pending_delete · 本任务不删"
+  - path: "docs/_tech_graph/_manifest.json"
+    role: "端点/表/env 索引本体"
+  - path: "docs/_tech_graph/_contract_manifest.json"
+    role: "契约/公理本体"
+  - path: "docs/_tech_graph/99_spec.md"
+    role: "治理/规约本体"
+  - path: "docs/_tech_graph/01_struct.md"
+    role: "数据结构本体"
+  - path: "docs/_tech_graph/graph.json"
+    role: "物化图（由 YAML 生成，非手写）"
+
+#### 工作区共有（仅引用，不重复扫描）
+
+- Projects/docs/harness/guides/POST_V1_0_SEQUENCE_v1_zh.md（上下文引用）
+- Projects/docs/harness/tasks/active/*.md（**仅** Task 模板结构，不扫描实例全文）
+
+输出：每个已扫描文件的路径 + role + 是否存在。
+
+### 第2步：对每个本体文件，提取其核心内容
+
+对每个文件，回答：
+- 定义了哪些 **类/实体**？
+- 定义了哪些 **关系**（类型与方向）？
+- 定义了哪些 **约束/公理**（摘录）？
+- **primitives_used**（T/K/H/B 标签 · 仅 Lens）
+
+### 第3步：识别子本体（对齐 Track 命名）
+
+子本体分组**必须**使用以下 Track 名称，避免三「图」混淆：
+
+| 子本体 ID | 名称 | 职责 | 典型文件 |
+|---|---|---|---|
+| PROCESS_TRACK | 过程本体 | Task/Hat/Gate/Review | DESIGN_ONTOLOGY §1–§5 |
+| GRAPH_TRACK | 图源本体 | YAML 源 → graph.json | docs/_tech_graph/*.graph.yaml、graph.json |
+| WIKI_TRACK | 知识库本体 | coding_wiki 叙事 | coding_wiki/syntheses/*.md |
+| STANDARDS_TRACK | 约束本体 | 编码规范、L2 | standards/、.cursor/rules/ |
+| VERIFY_TRACK | 验证本体 | CI、测试样本 | .github/workflows/、ci/samples/ |
+| IDE_TRACK | IDE 适配本体 | IDE 片段、marker | ide/adapters/、CLAUDE.md |
+| GOVERNANCE_TRACK | 治理本体 | CI 校验、漂移、规约 | 99_spec.md、_contract_manifest.json |
+
+若某子本体无对应项，可新增并标注「新增 Track · 待维护者确认」。
+
+### 第4步：分析关系——元路径（`*b` 模式）
+
+扫描是否隐含元路径（T→K→B、T→H→B、H→T→B 等），并指出在哪些文件/流程中被隐式使用。
+**注明**：元路径为分析 Lens，**非** HGM 边类型（HGM 边见 design v0 §1.2）。
+
+### 第5步：Epic 映射（对齐 Harness 术语）
+
+项目定义：**Epic 是 Task 的特化子类**（DESIGN_ONTOLOGY §1.4），**不**单独升格为一等类（v1）。
+
+报告中须含：
+
+epic_task_mapping:
+  definition: "EpicTask 是 Task 的特化子类"
+  evidence: "DESIGN_ONTOLOGY_v1_zh.md §1.4"
+  fields:
+    - depends_on: "string[] — 子 Task slug 列表"
+    - completion_policy: "must_complete_all | any_completes"
+  related_gate: "HG-EPIC-ROADMAP（Epic CLOSE 专用闸门）"
+  note: "Epic 不直接执行 30，通过子 Task 状态聚合判断完成"
+
+### 第6步：输出「项目本体构成报告」
+
+YAML 结构（字段名须保留）：
+
+  project: "<cyning-harness | ai-ink-brain-api-python>"
+  scan_date: "<YYYY-MM-DD>"
+  report_role: "<primary | pilot_reference>"
+
+  meta_ontology:
+    - 是否隐式定义顶层原语 Lens（T/K/H/B）？在哪些文档？
+    - 是否有显式元路径约定？
+    - 是否有全局公理约束所有子本体？
+
+  sub_ontologies:
+    - id: "<PROCESS_TRACK | ...>"
+      name: "<Track 名称>"
+      files: ["..."]
+      primitives_used: ["T", "K"]
+      core_classes: ["..."]
+      key_relations: ["..."]
+      key_axioms: ["..."]
+
+  epic_task_mapping: { ... 见第5步 ... }
+
+  graph_summary:
+    primitive_lens_used: ["T", "K", "H", "B"]
+    hgm_node_labels: ["Task", "Hat", ...]  # 来自 DESIGN_ONTOLOGY · 非 T/K/H/B
+    meta_paths_observed: ["tkb", "htb"]
+    missing_meta_paths: ["..."]
+
+  legacy_pending_delete:  # 试点仓 · v1.3 新增 · 仅盘点
+    - path: "docs/_tech_graph/00_main.ai.md"
+      status: "deprecated_readonly"
+      successor: "docs/_tech_graph/00_main.graph.yaml"
+      note: "删源 task: graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后"
+    # ... 其余 6× flow .ai.md 同理 ...
+
+  gaps:
+    - "..."
+
+### 与 harness ontology-check 的关系
+
+| 维度 | 本次扫描 | harness ontology-check（v0.4+ 规划） |
+|---|---|---|
+| 目的 | 发现本体文件、分组、原语 Lens | 验证 DESIGN_ONTOLOGY 与 ontology.yaml 一致性 |
+| 输出 | 盘点报告 YAML | PASS/FAIL + 差异列表 |
+| 时机 | G0 讨论前执行一次 | CI / 产品变更时 |
+| 关系 | **串联**：先扫描了解现状，再校验一致性。**扫描不替代校验。** |
+
+### 输出要求
+
+- **报告格式**：YAML
+- **落盘路径**（根据执行目录）：
+  - 产品仓扫描：`cyning-harness/docs/methodology/graph/inventory/ONTOLOGY_INVENTORY_cyning_harness_v1.yaml`
+  - 试点仓扫描：`cyning-harness/docs/methodology/graph/inventory/ONTOLOGY_INVENTORY_ai_ink_brain_api_python_v1.yaml`
+    （试点仓执行时仍写入产品仓 inventory/ · 若无法跨仓写入则落盘 invoke 附件并提示维护者手动拷贝）
+- **提交策略**：维护者审阅后 **须提交 Git 留档**（本链 D-G0-ARCHIVE）· 签 HG-INVENTORY-ARCHIVED · 此后方可删 `.ai.md`。
+- **若目录不存在**：mkdir -p docs/methodology/graph/inventory/ 后写入。
+
+---
+
+## 整合执行流程
+
+1. 检查执行前提 **P1 → P2 → P4 → P5** → 硬门槛失败则终止
+2. 试点仓执行 **P3 盘点** → 填充 `legacy_pending_delete` · **不终止**
+3. 确定当前目录 → 产品仓 or 试点仓
+4. 读取固定文件清单 → 逐个解析（含 deprecated `.ai.md` 只读摘要）
+5. 标注原语类型 T/K/H/B（仅 Lens）
+6. 按 Track 命名分组 → sub_ontologies
+7. 输出 epic_task_mapping
+8. 生成报告 → 落盘到 inventory/ 指定路径
+9. 提示维护者：「扫描完成 · 请审阅 · 留档 merge 后签 HG-INVENTORY-ARCHIVED · 再开删 ai.md task」
+
+---
+
+## 重要约束
+
+- 不要编造；不存在则写「未发现」
+- 必须打开文件阅读内容，不只靠文件名
+- 冲突处标记「冲突点」
+- 优先使用项目内部术语（Hat、InvokeSnapshot 等）
+- **禁止**修改 DESIGN_ONTOLOGY 或任何真值文件
+
+开始执行
+满足 P1–P5 后，按上述流程扫描并生成报告。无法判断的文件列入 gaps 并标注「待确认」。
+```
+
+---
+
+## 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | 2026-06-16 | 初版落盘 |
+| v1.1 | 2026-06-16 | 整合修正：P1–P5 前提 · T/K/H/B Lens · 固定清单 · Track 分组 · epic_task_mapping · inventory 落盘 · ontology-check 关系 |
+| v1.2 | 2026-06-16 | P2 路径改为 `docs/_tech_graph/00_main.graph.yaml` · P3 前置为硬门槛（全删 `.ai.md` 后方可执行）· pilot_manifest 去 `src/` |
+| v1.3 | 2026-06-17 | **D-G0-P3**：P3 改为软门槛 · `legacy_pending_delete` 盘点 · 先扫描后删 ai.md · 落盘须 Git 留档 · 关联 task_ontology_inventory_scan_g0_v1 · 试点产出文件名统一 |

package/docs/methodology/graph/README.md

@@ -5,6 +5,8 @@
 | 文档 | 状态 | 说明 |
 | --- | --- | --- |
 | **[`HARNESS_GRAPH_MODEL_design_v0_zh.md`](./HARNESS_GRAPH_MODEL_design_v0_zh.md)** | proposal · **v2.0+** | **真值稿** · 节点/边/事件 · CLI 路线 |
+| [`HGM_UPGRADE_OUTLINE_v1_zh.md`](./HGM_UPGRADE_OUTLINE_v1_zh.md) | outline | G0 讨论入口 · 依赖链 |
+| [`PROMPT_ontology_inventory_scan_G0_v1_zh.md`](./PROMPT_ontology_inventory_scan_G0_v1_zh.md) | active · **v1.3** | G0 本体扫描 · P3 软门槛 · legacy 盘点 · inventory/ 落盘 |
 | [`HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md`](./HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md) | archive | 对话参考 · **非真值** |
 
 ```text