docs: record hwlab kafka debug trace workflow

docs/reference/hwlab.md

@@ -190,6 +190,8 @@ HWLAB 与 AgentRun 协同修复必须按 `docs/reference/agentrun.md` 的职责
 
 HWLAB v0.3 订阅 AgentRun Kafka event 的权威输入是 `agentrun.event.v1`，HWLAB 转换后的权威输出是 `hwlab.event.v1`；三 topic 的平台边界和 topic ownership 统一见 `docs/reference/platform-infra.md#kafka-event-bus-boundary`。HWLAB 侧只负责消费 AgentRun manager event、投影成 `hwlab.trace.event.projected` 并发布到 HWLAB event stream，不得回写或改写 `agentrun.event.v1`，也不得把 Codex stdio raw frame 直接混入 HWLAB event schema。该桥接的 runtime 配置必须来自 NC01/v03 受控部署配置，关键 env 至少包括 Kafka enable、bootstrap servers、AgentRun event topic、HWLAB event topic、client id 和 AgentRun consumer group id；运行面关闭证据应包含 `hwlab-kafka-event-bridge-started` 日志摘要。
 
+Workbench 调试页的 Kafka SSE 子标签是三流实时观察入口。按 Workbench `traceId` 调试时，Cloud API 会先从本进程 Workbench trace store 解析 AgentRun `runId`/`commandId`，再用实际 Kafka 维度订阅 `codex-stdio.raw.v1`、`agentrun.event.v1` 和 `hwlab.event.v1`；SSE connected payload 必须同时暴露用户输入的 `filters` 和后端实际使用的 `resolvedFilters`，方便判断空流是关联字段缺失、上游未产生日志，还是订阅失败。若 `agentrun` 与 `hwlab` 流命中但 `stdio` 流为空，优先核对该 AgentRun command 是否真实进入 runner 并产生 stdio raw frame；不要把 stdio 空列表误判为调试页或 SSE 透传失败。
+
 Kafka event bridge 的最小关闭证据必须同时证明源流和目标流。先用 AgentRun 原入口或既有真实 run 生成 `sessionId`/`runId`，再在 HWLAB runtime pod 内用 HWLAB CLI 查询 `kafka tail --stream agentrun --session-id <sessionId>`，确认 `agentrun.event.v1` 中存在 run/command 或 durable event；随后用同一 id 查询 `kafka tail --stream hwlab --session-id <sessionId>`，确认 `hwlab.event.v1` 中存在对应的 `hwlab.trace.event.projected`、`runId`、`commandId`、label 和 status。默认查询只输出紧凑 rows，不展开 raw value；需要排查 schema 时才使用 full/raw 形式，并继续保持 `valuesPrinted=false`。KafkaJS `TimeoutNegativeWarning` 本身不等于桥接失败；只要 bounded query 在声明 timeout 内返回并退出，warning 应登记为 KafkaJS/client 层 follow-up，而不是回滚 HWLAB bridge 或改用裸 Kafka 直连绕过 CLI。
 
 ### Code Agent Provider Profile 配置与验收