# R3.3 固定 Trace 生产 handoff 单步重放报告

- 上下文：
  - [HWLAB #2486](https://github.com/pikasTech/HWLAB/issues/2486)
  - [HWLAB #2487](https://github.com/pikasTech/HWLAB/issues/2487)
  - [AgentRun #283](https://github.com/pikasTech/agentrun/issues/283)
- 固定 trace：`trc_fb6031c28d79495e`
- 未启动新的真实 AgentRun 运行。

## 执行命令

```bash
bun tools/hwlab-cli/bin/hwlab-cli.ts kafka render trace \
  --from kafka \
  --trace-id trc_fb6031c28d79495e \
  --input-topic hwlab.event.v1 \
  --group-prefix hwlab-v03-workbench-isolated-debug-refresh-2487-final \
  --limit 500 \
  --timeout-ms 30000 \
  --format markdown \
  --output-markdown /tmp/hwlab-refresh-2487-trc_fb6031c28d79495e-final.md \
  --row-limit 1 \
  --json
```

## 生产路径证据

- 临时只读源码副本：`/tmp/hwlab-refresh-2487.ACKmyy`。
- CLI 明确调用生产模块：
  - `internal/cloud/workbench-kafka-refresh-handoff:createWorkbenchKafkaRefreshHandoff`。
- 后续路径与 Web 同构：
  - `decodeWorkbenchRealtimeEventFrame`；
  - `reduceWorkbenchRealtimeEvent`；
  - `planWorkbenchRealtimeApply`；
  - `workbenchLiveKafkaProjectionTarget`；
  - `projectWorkbenchLiveKafkaUserMessage|projectWorkbenchLiveKafkaMessage`；
  - `traceDisplayRows`；
  - Markdown 只在最后一步与 HTML 分叉。
- `liveSubscriptionInstalled=true`，证明 CLI 使用完整生产 handoff 合同，不是直接把查询结果塞给 renderer。

## Kafka 与 handoff 结果

- 扫描：
  - `scanned=2727`；
  - `parsed=2727`；
  - `invalidJson=0`；
  - `completionReason=end-offset`。
- barrier：
  - topic 为 `hwlab.event.v1`；
  - partition 为 `0`；
  - start offset 为 `0`；
  - exclusive end offset 为 `2727`；
  - last scanned offset 为 `2726`。
- trace 命中与应用：
  - matched 为 `381`；
  - replayed 为 `381`；
  - decoded、planned、applied 均为 `381`；
  - rejected 为 `0`；
  - stable identity missing 与 duplicate 均为 `0`。
- 终态和可读性：
  - terminal 为 `completed`；
  - rendered rows 为 `194`；
  - tool rows 为 `111`；
  - assistant rows 为 `80`；
  - `finalResponsePresent=true`；
  - `finalResponseInTrace=false`。

## Markdown artifact

- 运行面路径：`/tmp/hwlab-refresh-2487-trc_fb6031c28d79495e-final.md`。
- 行数：`4181`。
- 字节数：`225131`。
- SHA-256：`39f9fe38c05c8ece6a056dcac405fb29fd7b2d81954a5b3b90a47c6ed52c26e7`。

## 用户正式事件补充验收

- 该固定 trace 生成于 `user_message` 合同上线之前，因此历史记录中的 `userMessageCount=0`；未伪造用户输入。
- 正式 user event fixture 验证：
  - AgentRun `user_message` 一对一映射为稳定 HWLAB user event；
  - retention SSE 在 lifecycle 事件前重放用户事件；
  - Web reducer 同时覆盖 Kafka-first 和 HTTP-first，稳定为单个用户气泡；
  - session replay 保留 steer 用户输入与 target trace 的独立身份；
  - 同构 Markdown 的“用户输入”区域只渲染一次。
- CLI 另有定向合同：
  - incomplete scan 即使零匹配也返回 `partial/source_scan_incomplete`；
  - 只有完整 barrier 后零匹配才返回 `source_trace_missing`。
