feat(investigation): publish incremental reference graphs

Publish graph deltas using the Server-owned cumulative graph contract. Validate historical comparison chart publications and consolidate Agent documentation.
2026-11-11 19:10:41 +08:00
parent 5ee93329a4
commit db87323b69
28 changed files with 2329 additions and 90 deletions
@@ -23,7 +23,7 @@ Mermaid、todo 和可选的旧执行计划供人理解，不约束 Agent 调度

 ## 任务、协作与恢复

-后台调查通过 `publish_task_progress` 在真实步骤开始及路线变化时发布完整 summary 与可空 diagram，复用 Server `agent-artifacts` 写入。节点可带显式 status 和供水图层要素 map_targets；只有 running 代表当前活动。进度图可以替换或重绘，不受旧计划保留节点规则约束，也不从 todo 推算。最终报告 diagram 使用相同节点引用字段；两者均不调度 Agent。
+后台调查通过 `publish_task_progress` 按需整理 summary 与可选 graph_update，复用 Server `agent-artifacts` 写入。路线实质调整、重要结果或失败尝试需要留痕、归纳报告时更新即可，不要求逐步发布或实时同步。graph_update 只提交变化的 nodes 和显式 edges（source/target/label）；Server 累计保留路径并生成 Mermaid。node_id 稳定，可用 detail、证据及动作引用解释依据。可选 status 只接受 reference（参考步骤）、recorded（已有结果）、needs_input（待补充条件）、failed（尝试失败）、not_taken（未采用路线）；无标记时保持中性。recorded 不证明实际任务或现场动作完成，needs_input 不控制任务等待。失败路径保留，重试另建节点。需要接续旧图时读取 get_task_context(section="progress")；旧 pending/running 仅作参考，completed 表示已有结果，waiting/waiting_human 表示待补充条件，skipped/cancelled 表示未采用。summary 更新不清图，报告归档已有累计图；旧图原源码保留，未保存的旧进度无法补回。图示与实际任务、计算和工具执行状态独立，不调度 Agent。上面的旧执行计划字段只用于历史兼容，也不驱动 Mermaid 标记。

 `publish_task_presentation` 仅允许 task_execution，通过 Server `presentation-events` 记录有限地图、图表及证据图层命令。run_id、任务和会话身份来自可信运行上下文；request_id 为模型提供的 UUID，相同操作重试复用。命令无需浏览器 capability 或实际显示回执，recorded 不代表已显示。图表引用真实证据，overlay 仅提供 evidence_id，由 Server 提取数据。前端 Dev 选择当前任务后实时跟随未来展示事件，关闭、切换或重连不回放旧展示，不启动新调查。