docs: track Kafka live debug workflow

This commit is contained in:
root
2026-07-10 12:40:33 +02:00
parent b75dac8f75
commit b8f4ee49d7
+63
View File
@@ -0,0 +1,63 @@
# HWLAB #2467 纯 Kafka 实时链路单步调试 MDTODO
## R1 [in_progress]
纯 Kafka 实时链路有界闭环与独立单步调试能力,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1_Task_Report.md)。
### R1.1 [in_progress]
首轮使用 semantic internal origin 执行 typed web-probe,修复一个证据明确的问题或定位首个断点,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.1_Task_Report.md)。
### R1.2
依赖首轮闭环结果完成第二轮复测并作 go/no-go;失败时冻结 sessionId、traceId、artifact 与首个断点,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.2_Task_Report.md)。
### R1.3
依赖第二轮失败结论冻结单步调试契约:partial lineage、JSONL/Kafka 输入、YAML debug topics 与独立 feature flag,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.3_Task_Report.md)。
#### R1.3.1
声明历史 stdio 只能重建 stdio-derived backend events,禁止伪造原 eventId/outboxSeq 或完整 manager lifecycle,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.3.1_Task_Report.md)。
#### R1.3.2
在 owning YAML 声明 debug topics、broker refs、limits/timeouts、consumer group prefix 与 workbenchDebug.kafkaReplay flag,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.3.2_Task_Report.md)。
#### R1.3.3
定义语义 CLI 参数、deterministic debug identity/ordering、JSONL/Kafka 双输入和结构化 provenance 输出,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.3.3_Task_Report.md)。
### R1.4
依赖单步调试契约实现 AgentRun stdio session 单步再生 CLI,不访问 AgentRun 运行面,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.4_Task_Report.md)。
#### R1.4.1
抽取 live 与 CLI 共用的 stateful stdio-derived event reducer,按 commandId 保序并公开 partial reconstruction,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.4.1_Task_Report.md)。
#### R1.4.2
实现 sessionId Kafka 与完全离线 JSONL 双输入的语义 CLIreader/publisher 可注入且默认写 YAML debug topic,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.4.2_Task_Report.md)。
#### R1.4.3
验证 live/CLI reducer fixture 语义一致、输出 count/offset/hash/partialDisclosure,离线模式零网络,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.4.3_Task_Report.md)。
### R1.5
依赖单步调试契约实现 HWLAB AgentRun→HWLAB 单步映射/发布 CLI,不访问 HWLAB 运行面或 projector,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.5_Task_Report.md)。
#### R1.5.1
公开并复用 canonical decode、direct map 与 injected producer seam,保持生产 envelope identity/fingerprint,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.5.1_Task_Report.md)。
#### R1.5.2
实现 sessionId Kafka 与 JSONL 双输入 CLI,支持 dry-run、bounded invalid/ignored 摘要和 YAML debug topic,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.5.2_Task_Report.md)。
#### R1.5.3
验证 CLI 不启动 Cloud API、不访问 DB/projector,映射结果与生产 direct publish 一致,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.5.3_Task_Report.md)。
### R1.6
依赖单步调试契约在原 Workbench 页面实现 YAML gated、view-local 的 traceId Kafka replay debug mode,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.6_Task_Report.md)。
#### R1.6.1
新增独立 workbenchDebug.kafkaReplay YAML flag、admin gate、debug group 与 one-shot high-water completion,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.6.1_Task_Report.md)。
#### R1.6.2
在原 Workbench 页面实现调试开关、清空隔离面板、按当前 traceId 重放并复用生产 reducer/card,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.6.2_Task_Report.md)。
#### R1.6.3
增加 typed web-probe command 与测试,验证关闭调试恢复 canonical panel 且产品 SSE/group 不变,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.6.3_Task_Report.md)。
### R1.7
依赖三个单步能力完成三级串联、原入口 typed web-probe 与产品纯实时链路无扰动验收,完成任务后将详细报告写入[任务报告](./details/HWLAB-2467/R1.7_Task_Report.md)。