feat(tech-graph): 闸口 C′ graph_v2 查询轨 impact F1 物化增强 (#36)

feat(tech-graph): 闸口 C′ graph_v2 查询轨 impact F1 物化增强

Author: Cyning12

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_DUAL_MD/T001_embedding_dim_default.dual_track.md

@@ -2,7 +2,7 @@
 schema: gate_ctx_c_dual_md_main_v1
 arm: CTX_DUAL_MD
 task_id: T001_embedding_dim_default
-freeze_id: TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0
+freeze_id: TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0
 ---
 
 <!-- gate_ctx_c dual_track role=ai path=docs/_tech_graph/10_flow_rag.ai.md -->

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_DUAL_MD/T002_unified_sse_chain_contract.dual_track.md

@@ -2,7 +2,7 @@
 schema: gate_ctx_c_dual_md_main_v1
 arm: CTX_DUAL_MD
 task_id: T002_unified_sse_chain_contract
-freeze_id: TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0
+freeze_id: TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0
 ---
 
 <!-- gate_ctx_c dual_track role=ai path=docs/_tech_graph/15_e2e_boundary.ai.md -->

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_DUAL_MD/T003_ingest_admin_rpc.dual_track.md

@@ -2,7 +2,7 @@
 schema: gate_ctx_c_dual_md_main_v1
 arm: CTX_DUAL_MD
 task_id: T003_ingest_admin_rpc
-freeze_id: TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0
+freeze_id: TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0
 ---
 
 <!-- gate_ctx_c dual_track role=ai path=docs/_tech_graph/13_flow_supabase_rpc.ai.md -->

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_V2_QUERY/T001_embedding_dim_default.subgraph.json

@@ -2,7 +2,7 @@
   "schema": "gate_ctx_c_v2_query_main_v1",
   "arm": "CTX_V2_QUERY",
   "task_id": "T001_embedding_dim_default",
-  "freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
+  "freeze_id": "TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0",
   "query": {
     "op": "downstream",
     "node_id": "ENV",

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_V2_QUERY/T002_unified_sse_chain_contract.subgraph.json

@@ -2,7 +2,7 @@
   "schema": "gate_ctx_c_v2_query_main_v1",
   "arm": "CTX_V2_QUERY",
   "task_id": "T002_unified_sse_chain_contract",
-  "freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
+  "freeze_id": "TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0",
   "query": {
     "op": "union",
     "parts": [
@@ -460,12 +460,29 @@
   },
   "note": "graph_v2 子图；ref 边不参与 BFS",
   "contract_slice": {
-    "schema": "gate_ctx_c_sse_contract_slice_v1",
+    "schema": "gate_ctx_c_sse_contract_slice_v2",
     "source": "docs/_tech_graph/_contract_manifest.json",
+    "envelope_keys": [
+      "event",
+      "data"
+    ],
     "allowed_events": [
       "chain",
       "done"
     ],
+    "chain_data_keys": [
+      "type",
+      "ts",
+      "step_id",
+      "payload"
+    ],
+    "done_data_keys": [
+      "ok",
+      "mode",
+      "run_id",
+      "session_id",
+      "request_id"
+    ],
     "chain_type_values": [
       "meta",
       "router.decision",
@@ -493,6 +510,18 @@
       "text2sql.phase.start",
       "text2sql.phase.end"
     ],
+    "impact_chain_type_values": [
+      "agent.llm.delta",
+      "agent.llm.end",
+      "agent.llm.start",
+      "agent.llm.truncated",
+      "error",
+      "rag.query_expand",
+      "rag.sources",
+      "sql.result",
+      "text2sql.phase.end",
+      "text2sql.phase.start"
+    ],
     "payload_min_keys_by_type": {
       "_note": "每个 type 的 payload 最小必需键集合：后端必须至少提供这些键；前端不得读取 manifest 未承诺的键。",
       "meta": [
@@ -647,6 +676,150 @@
         "phase_id",
         "latency_ms"
       ]
-    }
+    },
+    "impact_payload_min_keys_by_type": {
+      "agent.llm.delta": [
+        "text",
+        "part_index"
+      ],
+      "agent.llm.end": [
+        "ok",
+        "phase",
+        "step_id"
+      ],
+      "agent.llm.start": [
+        "phase",
+        "step_id"
+      ],
+      "agent.llm.truncated": [
+        "dropped_chars",
+        "reason"
+      ],
+      "error": [
+        "stage",
+        "message"
+      ],
+      "rag.query_expand": [
+        "raw",
+        "rewrite"
+      ],
+      "rag.sources": {
+        "_note": "rag.sources 的 payload 为 sources+retrieval；source_item_keys 为 sources[] 每一项的最小键名集合。",
+        "payload_keys": [
+          "sources",
+          "retrieval"
+        ],
+        "source_item_keys": [
+          "id",
+          "content",
+          "filename",
+          "score",
+          "path",
+          "url"
+        ],
+        "retrieval_keys": [
+          "top_k",
+          "rrf_k"
+        ]
+      },
+      "sql.result": [
+        "sql",
+        "columns",
+        "rows",
+        "truncated"
+      ],
+      "text2sql.phase.end": [
+        "subphase_id",
+        "phase_id",
+        "latency_ms"
+      ],
+      "text2sql.phase.start": [
+        "subphase_id",
+        "phase_id",
+        "phase_kind"
+      ]
+    },
+    "contract_check_tool": "tools/tech_graph_contract_check.py"
+  },
+  "manifest_slice": {
+    "schema": "gate_ctx_c_manifest_slice_v1",
+    "source": "docs/_tech_graph/_manifest.json",
+    "endpoints": [
+      {
+        "method": "POST",
+        "path": "/api/py/unified/chat",
+        "handler": "unified_chat_route",
+        "anchor": {
+          "path": "api/index.py",
+          "symbol": "unified_chat_route"
+        }
+      },
+      {
+        "method": "POST",
+        "path": "/api/py/unified/chat/stream",
+        "handler": "unified_chat_stream_route",
+        "anchor": {
+          "path": "api/index.py",
+          "symbol": "unified_chat_stream_route"
+        }
+      },
+      {
+        "method": "GET",
+        "path": "/api/py/chatbi/access/verify",
+        "handler": "chatbi_access_verify",
+        "anchor": {
+          "path": "api/index.py",
+          "symbol": "chatbi_access_verify"
+        }
+      }
+    ],
+    "anchors": [
+      {
+        "path": "api/chatbi_principal.py",
+        "symbol": "resolve_chatbi_from_plain_token"
+      }
+    ],
+    "note": "gold impact：_manifest.json / chatbi_access_verify（CV）"
+  },
+  "impact_surface": {
+    "schema": "gate_ctx_c_impact_surface_v1",
+    "source": "docs/diary/jsonPKmermaid/fixtures/gate_ctx_ab_v1/tasks.json",
+    "candidates": [
+      {
+        "path": "docs/_tech_graph/_contract_manifest.json",
+        "kind": "contract",
+        "graph_id": "EV_TYPES",
+        "note": "allowed_events、type_values、payload_min_keys_by_type 真值"
+      },
+      {
+        "path": "tools/tech_graph_contract_check.py",
+        "kind": "ci",
+        "note": "删改 chain typ/键名须过静态契约扫描（workflow tech-graph-contract）"
+      },
+      {
+        "path": "api/unified_chat.py",
+        "kind": "control",
+        "graph_id": "RAG",
+        "note": "SSE 内 RAG 分支 yield chain（rewrite/embed/retrieve/generate）"
+      },
+      {
+        "path": "api/unified_chat.py",
+        "kind": "control",
+        "graph_id": "T2S",
+        "note": "SSE 内 Text2SQL 分支（retrieve/generate_sql/execute_sql）"
+      },
+      {
+        "path": "api/agent.py",
+        "kind": "control",
+        "note": "emit agent.llm.start|delta|end|truncated；与 unified_chat 增量队列合并契约扫描"
+      },
+      {
+        "path": "docs/_tech_graph/_manifest.json",
+        "kind": "contract",
+        "graph_id": "CV",
+        "note": "含 chatbi_access_verify；鉴权链变更时 BFF 探活敏感"
+      }
+    ],
+    "note": "产出 JSON 时 impacts 须含 path + kind；evidence 可附 graph_id"
   }
 }

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_V2_QUERY/T003_ingest_admin_rpc.subgraph.json

@@ -2,7 +2,7 @@
   "schema": "gate_ctx_c_v2_query_main_v1",
   "arm": "CTX_V2_QUERY",
   "task_id": "T003_ingest_admin_rpc",
-  "freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
+  "freeze_id": "TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0",
   "query": {
     "op": "downstream",
     "node_id": "A2",

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/materialize_report.json

@@ -1,7 +1,7 @@
 {
   "schema": "gate_ctx_c_payload_materialize_v1",
-  "generated_at": "2026-05-18T07:08:44Z",
-  "freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
+  "generated_at": "2026-05-18T09:15:19Z",
+  "freeze_id": "TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0",
   "graph_v2_path": "docs/_tech_graph/graph.json",
   "graph_v2_freeze_id": "TECH_GRAPH_S2_FREEZE_20260519_V2_3",
   "arms_static": {
@@ -15,7 +15,7 @@
             "depth": 2
           },
           "nodes": 2,
-          "bytes_utf8": 1684,
+          "bytes_utf8": 1685,
           "heuristic_tokens": 417
         },
         "T002_unified_sse_chain_contract": {
@@ -40,8 +40,8 @@
             ]
           },
           "nodes": 17,
-          "bytes_utf8": 14138,
-          "heuristic_tokens": 3494
+          "bytes_utf8": 18537,
+          "heuristic_tokens": 4555
         },
         "T003_ingest_admin_rpc": {
           "path": "docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/payloads/CTX_V2_QUERY/T003_ingest_admin_rpc.subgraph.json",
@@ -51,7 +51,7 @@
             "depth": 2
           },
           "nodes": 4,
-          "bytes_utf8": 1949,
+          "bytes_utf8": 1950,
           "heuristic_tokens": 481
         }
       },

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/protocol_version.yaml

@@ -5,6 +5,7 @@ created_at: "2026-05-18"
 
 repo: ai-ink-brain-api-python
 freeze_id: TECH_GRAPH_GATE_C_FREEZE_20260518_V1_0
+gate_c_prime_freeze_id: TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0
 graph_v2_freeze_id: TECH_GRAPH_S2_FREEZE_20260519_V2_3
 graph_v2_path: docs/_tech_graph/graph.json
 

docs/diary/jsonPKmermaid/fixtures/gate_ctx_c_v1/query_seeds.json

@@ -1,6 +1,7 @@
 {
   "schema_version": "gate_ctx_c_query_seeds_v1",
-  "freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
+  "freeze_id": "TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0",
+  "parent_freeze_id": "TECH_GRAPH_QUERY_COVERAGE_FREEZE_20260519_V1_0",
   "graph_v2_freeze_id": "TECH_GRAPH_S2_FREEZE_20260519_V2_3",
   "default_op": "downstream",
   "default_depth": 2,