@cyning/harness 1.0.2 → 2.0.0

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

package/docs/methodology/graph/inventory/ONTOLOGY_INVENTORY_ai_ink_brain_api_python_v1.yaml

@@ -0,0 +1,283 @@
+# G0 本体构成扫描 · 试点仓辅助报告
+# 生成：ontology-inventory-scan-g0 · 30 执行 · freeze_id ONTOLOGY-INVENTORY-G0
+# 约束：只读扫描 · 未删 .ai.md · 未改 export/compile
+
+project: ai-ink-brain-api-python
+scan_date: "2026-06-17"
+report_role: pilot_reference
+prompt_version: "1.3"
+freeze_id: ONTOLOGY-INVENTORY-G0
+
+preconditions:
+  P1: pass  # 扫描源 = ai-ink-brain-api-python/
+  P2: pass  # docs/_tech_graph/00_main.graph.yaml 存在且非空
+  P3: inventory_only  # 7× .ai.md 列入 legacy_pending_delete · 不阻断
+  P4: pass  # HG-TASK-DRAFT approved
+  P5: pass  # G0 讨论素材
+
+scanned_manifest:
+  pilot_manifest:
+    - path: docs/_tech_graph/00_main.graph.yaml
+      role: 图源 YAML（主流程）
+      exists: true
+      graph_id: "00_main"
+      node_count: 24
+    - path: docs/_tech_graph/10_flow_rag.graph.yaml
+      role: 图源 YAML（RAG 子流程）
+      exists: true
+      graph_id: "10_flow_rag"
+    - path: docs/_tech_graph/11_flow_text2sql.graph.yaml
+      role: 图源 YAML（Text2SQL 子流程）
+      exists: true
+      graph_id: "11_flow_text2sql"
+    - path: docs/_tech_graph/12_flow_fts.graph.yaml
+      role: 图源 YAML（FTS 子流程）
+      exists: true
+      graph_id: "12_flow_fts"
+    - path: docs/_tech_graph/13_flow_supabase_rpc.graph.yaml
+      role: 图源 YAML（Supabase RPC 子流程）
+      exists: true
+      graph_id: "13_flow_supabase_rpc"
+    - path: docs/_tech_graph/14_runtime_observability.graph.yaml
+      role: 图源 YAML（运行时可观测）
+      exists: true
+      graph_id: "14_runtime_observability"
+    - path: docs/_tech_graph/15_e2e_boundary.graph.yaml
+      role: 图源 YAML（E2E 边界）
+      exists: true
+      graph_id: "15_e2e_boundary"
+    - path: docs/_tech_graph/_manifest.json
+      role: 端点/表/env 索引本体
+      exists: true
+      schema_version: tech_graph_manifest_v1
+      endpoint_count: 18
+      table_count: 5
+      env_count: 53
+    - path: docs/_tech_graph/_contract_manifest.json
+      role: 契约/公理本体
+      exists: true
+      schema_version: tech_graph_contract_manifest_v1
+      topic: unified_chat_sse_contract
+    - path: docs/_tech_graph/99_spec.md
+      role: 治理/规约本体
+      exists: true
+    - path: docs/_tech_graph/01_struct.md
+      role: 数据结构本体
+      exists: true
+    - path: docs/_tech_graph/graph.json
+      role: 物化图（由 YAML export 生成，非手写）
+      exists: true
+      node_count: 135
+      edge_count: 186
+      graph_ids: [00_main, 10_flow_rag, 11_flow_text2sql, 12_flow_fts, 13_flow_supabase_rpc, 14_runtime_observability, 15_e2e_boundary]
+
+meta_ontology:
+  implicit_primitive_lens:
+    present: true
+    documents:
+      - 99_spec.md  # AI 行为约束 C1–C6 · drift_check 锚点
+      - _contract_manifest.json  # payload_min_keys · allowed_events 作 K 类锚点
+  explicit_meta_path_convention:
+    present: true
+    documents:
+      - 99_spec.md  # YAML 单源 → compile → .md · export → graph.json
+    note: Inform YAML 闭环（P0–P1 done）· .ai.md 已 deprecated
+  global_axioms:
+    present: true
+    source: 99_spec.md + CI tools/
+    axioms_sample:
+      - 禁止编造不存在的表/字段/RPC/端点
+      - 端点/RPC/表/env 变更须同步 _manifest.json
+      - graph.json 禁止手改 · 由 YAML export 生成
+      - _contract_manifest payload_min_keys 删改导致 contract_check 失败
+
+sub_ontologies:
+  - id: GRAPH_TRACK
+    name: 图源本体
+    files:
+      - docs/_tech_graph/00_main.graph.yaml
+      - docs/_tech_graph/10_flow_rag.graph.yaml
+      - docs/_tech_graph/11_flow_text2sql.graph.yaml
+      - docs/_tech_graph/12_flow_fts.graph.yaml
+      - docs/_tech_graph/13_flow_supabase_rpc.graph.yaml
+      - docs/_tech_graph/14_runtime_observability.graph.yaml
+      - docs/_tech_graph/15_e2e_boundary.graph.yaml
+      - docs/_tech_graph/graph.json
+    primitives_used: [T, K, H]
+    core_classes:
+      - GraphNode
+      - GraphEdge
+      - Anchor
+      - InformArtifact
+    key_relations:
+      - graph.yaml --compile--> *.md
+      - graph.yaml --export--> graph.json
+      - Node --depends_on--> Node  # mark -> ~> ?> 等拓扑边
+      - Edge --anchor--> api/*.py symbol
+    key_axioms:
+      - 单图编辑源为 .graph.yaml
+      - flowchart 须遵循 99_mermaid_protocol.md 拓扑协议（历史 .ai.md 承载）
+
+  - id: GOVERNANCE_TRACK
+    name: 治理本体
+    files:
+      - docs/_tech_graph/99_spec.md
+      - docs/_tech_graph/_contract_manifest.json
+      - docs/_tech_graph/_manifest.json
+      - docs/_tech_graph/_test_manifest.json
+    primitives_used: [K, H]
+    core_classes:
+      - ContractManifest
+      - TechGraphManifest
+      - TestManifest
+    key_relations:
+      - CI --validates--> _manifest.json
+      - CI --validates--> _contract_manifest.json
+      - drift_check --scans--> docs/_tech_graph/*.md
+    key_axioms:
+      - tech_graph_manifest_check.py 门禁
+      - tech_graph_contract_check.py SSE 键名校验
+      - tech_graph_drift_check.py 子串匹配防静默过期
+
+  - id: STANDARDS_TRACK
+    name: 约束本体（数据结构规约）
+    files:
+      - docs/_tech_graph/01_struct.md
+    primitives_used: [T, B]
+    core_classes:
+      - documents
+      - code_chunks
+      - chatbi_access_tokens
+      - rag_conversation_logs
+      - FileMeta
+    key_relations:
+      - documents --> FileMeta : metadata
+      - code_chunks --> FileMeta : metadata
+    key_axioms:
+      - Struct 表达 DB 结构 · 来源 supabase/sql/*.sql
+
+  - id: PROCESS_TRACK
+    name: 过程本体
+    files:
+      - docs/tasks/active/
+      - docs/harness/
+      - docs/tasks/RECENT_TASK_SCHEDULE.md
+    primitives_used: [T, H, B]
+    core_classes:
+      - Task
+      - InvokeSnapshot
+      - HumanGate
+    key_relations:
+      - Task --mustRead--> InformArtifact  # _tech_graph/*
+      - Task --blocks--> graph-yaml-remove-ai-md  # 待 G0 关账后
+    key_axioms:
+      - Harness SDD 帽链 10→22→30→40
+      - Inform 闭环 P0–P1 done（PR #178）
+
+  - id: VERIFY_TRACK
+    name: 验证本体
+    files:
+      - .github/workflows/tech-graph.yml
+      - tools/tech_graph_manifest_check.py
+      - tools/tech_graph_contract_check.py
+      - tools/tech_graph_drift_check.py
+      - tools/tech_graph_test_manifest_check.py
+      - tools/graph_yaml_compile.py
+      - tools/graph_yaml_export.py
+    primitives_used: [K, H]
+    core_classes:
+      - VerifyArtifact
+      - GateCheckRun
+    key_relations:
+      - CI --runs--> manifest_check / contract_check / drift_check
+      - export --generates--> graph.json
+    key_axioms:
+      - pytest 排除 intent_eval / intent_benchmark
+      - graph.json 白名单手改禁止
+
+  - id: WIKI_TRACK
+    name: 知识库本体
+    files:
+      - docs/coding_wiki/syntheses/
+      - docs/spec/governance/SPEC-Governance-Wiki-TechGraph-Bridge-v1.md
+    primitives_used: [T, K]
+    core_classes:
+      - WikiSynthesis
+      - graph_nodes  # frontmatter 种子
+    key_relations:
+      - WikiSynthesis --graph_nodes--> GraphNode
+      - graph_query.py --neighbors/downstream/upstream--> graph.json
+    key_axioms:
+      - coding_wiki_graph_nodes_lint.py 校验 frontmatter
+
+  - id: IDE_TRACK
+    name: IDE 适配本体
+    files:
+      - AGENTS.md
+      - .cursor/rules/
+    primitives_used: [K]
+    core_classes:
+      - ConstrainArtifact
+    key_relations:
+      - Task --constrainedBy--> ConstrainArtifact
+    key_axioms: []
+
+epic_task_mapping:
+  definition: EpicTask 是 Task 的特化子类
+  evidence: cyning-harness 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
+  note: 试点仓 RECENT_TASK_SCHEDULE §1.7 G0 链 #1/3 为本扫描 task
+
+graph_summary:
+  primitive_lens_used: [T, K, H, B]
+  hgm_node_labels:
+    - InformArtifact  # _tech_graph/* 映射
+    - Task
+    - HumanGate
+    - InvokeSnapshot
+  meta_paths_observed:
+    - tkb  # flow 图 Topic → contract payload_min_keys → 业务端点/表实体
+    - htb  # git/02_version → YAML 版本字段 → graph.json 物化
+    - tkh  # Track 命名（GRAPH vs PROCESS）→ CI 键校验 → merge 门禁
+  missing_meta_paths:
+    - HGM events/*.jsonl 未启用（G1 deferred）
+    - 部分 Sub-graph 死链（并行 task graph-yaml-subgraph-nit）
+
+legacy_pending_delete:
+  - 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 后
+  - path: docs/_tech_graph/10_flow_rag.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/10_flow_rag.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+  - path: docs/_tech_graph/11_flow_text2sql.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/11_flow_text2sql.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+  - path: docs/_tech_graph/12_flow_fts.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/12_flow_fts.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+  - path: docs/_tech_graph/13_flow_supabase_rpc.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/13_flow_supabase_rpc.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+  - path: docs/_tech_graph/14_runtime_observability.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/14_runtime_observability.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+  - path: docs/_tech_graph/15_e2e_boundary.ai.md
+    status: deprecated_readonly
+    successor: docs/_tech_graph/15_e2e_boundary.graph.yaml
+    note: 删源 task graph-yaml-remove-ai-md · 须 HG-INVENTORY-ARCHIVED 后
+
+gaps:
+  - 7× .ai.md 仍存 · 已标 legacy_pending_delete · 待后继 task 删除
+  - Sub-graph 死链未修（非本 task 范围 · graph-yaml-subgraph-nit 并行）
+  - HGM G1 ingest 未实现（task_cyning_harness_g1_hgm_v2_v1 · blocked）
+  - 02_version.md 未列入 pilot_manifest 固定清单（存在但未逐文件展开）