# R1 纯 Kafka 实时链路与单步调试收口报告

## 总结论

产品主线未偏离，且已在 NC01/v03 拉通：

```text
stdio -> codex-stdio.raw.v1
AgentRun event -> agentrun.event.v1
HWLAB direct map/publish -> hwlab.event.v1
shared fixed-group consumer/fanout -> SSE -> Web
```

产品路径保持纯实时，不使用 snapshot、sync、replay recovery、gap-fill、finalizer 或 polling。transactional projector 代码保留但关闭，不参与本次链路。

## 产品实时证据

R1.1 的冻结 trace `trc_mretx18t3jl4tg` 已证明 AgentRun/HWLAB/SSE 为 `35/35/35`，eventId/sourceEventId 顺序逐项一致，terminal 1 个。

最终新 trace `trc_mrew3yvpvv2ep6` 又完成一次真实 Workbench turn，最终响应为 `KAFKA_DEBUG_REPLAY_READY`。OTel 证据：

- OTel traceId: `98854312e576a7a7a0b96ced5702d8e3`。
- 167 spans、0 error。
- 服务覆盖: `hwlab-cloud-api`、`agentrun-manager`、`agentrun-runner`。
- `hwlab.kafka.live.direct_publish=30`。
- `hwlab.kafka.live.fanout_receive=30`。
- `hwlab.workbench.live_sse.business_event_write=60`，对应两个同时在线的产品 SSE subscriber。
- projection writes 为空，诊断结论 `PROJECTION=none`。

五个独立可组合 capability 保持：

```text
directPublish=true
liveKafkaSse=true
transactionalProjector=false
projectionOutboxRelay=false
projectionRealtime=false
```

固定产品 group 保持：

```text
hwlab-v03-agentrun-event-direct-publish
hwlab-v03-agentrun-event-projector
hwlab-v03-workbench-live-sse
```

projector group 在关闭状态下不活跃；debug consumer 使用独立、每次唯一的 group。

## 单步 debug 闭环

| 阶段 | 输入 | 输出 | 结果 |
|---|---:|---:|---|
| AgentRun stdio 源码 reducer | 22 个选中 frame | 11 个 AgentRun debug event | terminal 1，partial lineage 明示 |
| HWLAB 生产 mapper | 11 个 AgentRun debug event | 11 个 HWLAB debug event | 11→11，顺序/lineage 保持 |
| Workbench debug SSE/card | 11 个 HWLAB debug event | 11 个 applied event | terminal completed |

隔离 topic 为 `agentrun.event.debug.v1` 与 `hwlab.event.debug.v1`，均由 YAML 声明并使用 1 天 retention。任何调试 CLI 都禁止写产品 topic。

## 交付与部署

- 产品纯实时主线: pikasTech/HWLAB#2466。
- AgentRun 重建 CLI 与 producer 释放: pikasTech/agentrun#278、#279。
- HWLAB 映射 CLI、Workbench debug 与 trace fallback: pikasTech/HWLAB#2471、#2472。
- typed web-probe command: pikasTech/unidesk#1703。
- debug topic YAML: pikasTech/unidesk#1701。

最终运行面：

- AgentRun source `ef241221ecd1ecbecc69a294c261b9c254f67550`，PaC/Argo/manager 1/1 exact。
- HWLAB source `3f8b6e2f676b3354b55fd0a42b19baec73f34568`，PipelineRun completed，GitOps `fd0558d5a38a`，Argo Synced/Healthy，workloads 13/13。

KafkaJS 2.2.4 空队列 1ms 自循环属于独立依赖风险，已转 pikasTech/unidesk#1704，不影响本任务的数据正确性结论。
