fix: 按助手 item 生命周期收敛 Trace

docs/reference/kafka-source-direct-debug.md

@@ -13,6 +13,9 @@
   - 事件使用 `reduceWorkbenchRealtimeEvent` 与 `planWorkbenchRealtimeApply` 分类；
   - 卡片使用 `projectWorkbenchLiveKafkaMessage` 增量归约；
   - Trace 行使用 `traceDisplayRows` 生成同一 row model；
+  - assistant、tool 与 terminal 使用同一稳定 item lifecycle 收敛可见行；
+  - 同一 `itemId` 已出现 `completed-agent-message` 后到达的 `agent-message-delta-progress` 不再生成第二条 assistant row；
+  - lifecycle 收敛只影响可见行，不删除 source/applied 事件，也不使用正文、时间戳或 DOM 去重；
   - Web 最后渲染 HTML，CLI 最后使用 `renderTraceRowsMarkdown` 渲染 Markdown；
   - Final Response 只放在 Trace 外层，Trace 内保留非最终的助手进展消息。
 
@@ -45,7 +48,10 @@
   - 默认 JSON 只返回 `--row-limit` 指定的尾部行，并披露 returned/omitted/window；
   - `--full` 仅用于显式下钻完整 row payload；
   - `--format markdown` 输出 Markdown 正文；
-  - `--json` 输出身份、投影、row model、终态、计数和 artifact SHA 的结构化证据。
+  - `--json` 输出身份、投影、row model、终态、计数和 artifact SHA 的结构化证据；
+  - `replayLineage` 分别披露 source、applied、render 与 outer final 层的计数；
+  - 助手重复只披露正文 SHA-256、首次 identity、`sourceSeq` 和 Kafka transport，不回显正文；
+  - source/applied 重复保持可见而 render 重复归零时，表示稳定 item lifecycle 已在共享 row model 收敛。
 
 - `hwlab-cli kafka regenerate hwlab` 用于把指定 AgentRun session 的事件直接映射为 HWLAB debug 事件：
   - 调用生产路径同源的 AgentRun 解码与 HWLAB 事件映射函数；