From cdf0e71115232a78e92e431aee69f4c64a710bea Mon Sep 17 00:00:00 2001 From: root Date: Fri, 10 Jul 2026 12:48:42 +0200 Subject: [PATCH] docs: simplify Kafka debug task tracking --- .../pure-kafka-live-single-step-debug.md | 53 ++----------------- 1 file changed, 4 insertions(+), 49 deletions(-) diff --git a/docs/MDTODO/pure-kafka-live-single-step-debug.md b/docs/MDTODO/pure-kafka-live-single-step-debug.md index b479bc53..cd76ffb4 100644 --- a/docs/MDTODO/pure-kafka-live-single-step-debug.md +++ b/docs/MDTODO/pure-kafka-live-single-step-debug.md @@ -6,58 +6,13 @@ 纯 Kafka 实时链路有界闭环与独立单步调试能力,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1_Task_Report.md)。 ### R1.1 [in_progress] -首轮使用 semantic internal origin 执行 typed web-probe,修复一个证据明确的问题或定位首个断点,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.1_Task_Report.md)。 +使用 semantic internal origin 完成最多两轮 typed web-probe 闭环;仍失败则冻结 sessionId、traceId、artifact 与首个断点,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.1_Task_Report.md)。 ### R1.2 -依赖首轮闭环结果完成第二轮复测并作 go/no-go;失败时冻结 sessionId、traceId、artifact 与首个断点,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.2_Task_Report.md)。 +实现 AgentRun 按已有 stdio Kafka sessionId 直接调用源码 reducer 再生 AgentRun Kafka 事件的 CLI,不依赖运行面并披露 partial lineage,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.2_Task_Report.md)。 ### R1.3 -依赖第二轮失败结论冻结单步调试契约:partial lineage、JSONL/Kafka 输入、YAML debug topics 与独立 feature flag,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.3_Task_Report.md)。 -#### R1.3.1 - -声明历史 stdio 只能重建 stdio-derived backend events,禁止伪造原 eventId/outboxSeq 或完整 manager lifecycle,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.3.1_Task_Report.md)。 -#### R1.3.2 - -在 owning YAML 声明 debug topics、broker refs、limits/timeouts、consumer group prefix 与 workbenchDebug.kafkaReplay flag,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.3.2_Task_Report.md)。 -#### R1.3.3 - -定义语义 CLI 参数、deterministic debug identity/ordering、JSONL/Kafka 双输入和结构化 provenance 输出,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.3.3_Task_Report.md)。 +实现 HWLAB 按 sessionId 加载 AgentRun Kafka 事件并直接调用源码映射/发布 HWLAB Kafka 事件的 CLI,不依赖运行面或 projector,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.3_Task_Report.md)。 ### R1.4 -依赖单步调试契约实现 AgentRun stdio session 单步再生 CLI,不访问 AgentRun 运行面,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.4_Task_Report.md)。 -#### R1.4.1 - -抽取 live 与 CLI 共用的 stateful stdio-derived event reducer,按 commandId 保序并公开 partial reconstruction,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.4.1_Task_Report.md)。 -#### R1.4.2 - -实现 sessionId Kafka 与完全离线 JSONL 双输入的语义 CLI,reader/publisher 可注入且默认写 YAML debug topic,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.4.2_Task_Report.md)。 -#### R1.4.3 - -验证 live/CLI reducer fixture 语义一致、输出 count/offset/hash/partialDisclosure,离线模式零网络,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.4.3_Task_Report.md)。 -### R1.5 - -依赖单步调试契约实现 HWLAB AgentRun→HWLAB 单步映射/发布 CLI,不访问 HWLAB 运行面或 projector,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.5_Task_Report.md)。 -#### R1.5.1 - -公开并复用 canonical decode、direct map 与 injected producer seam,保持生产 envelope identity/fingerprint,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.5.1_Task_Report.md)。 -#### R1.5.2 - -实现 sessionId Kafka 与 JSONL 双输入 CLI,支持 dry-run、bounded invalid/ignored 摘要和 YAML debug topic,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.5.2_Task_Report.md)。 -#### R1.5.3 - -验证 CLI 不启动 Cloud API、不访问 DB/projector,映射结果与生产 direct publish 一致,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.5.3_Task_Report.md)。 -### R1.6 - -依赖单步调试契约在原 Workbench 页面实现 YAML gated、view-local 的 traceId Kafka replay debug mode,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.6_Task_Report.md)。 -#### R1.6.1 - -新增独立 workbenchDebug.kafkaReplay YAML flag、admin gate、debug group 与 one-shot high-water completion,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.6.1_Task_Report.md)。 -#### R1.6.2 - -在原 Workbench 页面实现调试开关、清空隔离面板、按当前 traceId 重放并复用生产 reducer/card,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.6.2_Task_Report.md)。 -#### R1.6.3 - -增加 typed web-probe command 与测试,验证关闭调试恢复 canonical panel 且产品 SSE/group 不变,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.6.3_Task_Report.md)。 -### R1.7 - -依赖三个单步能力完成三级串联、原入口 typed web-probe 与产品纯实时链路无扰动验收,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.7_Task_Report.md)。 \ No newline at end of file +在原 Workbench 页面增加独立 YAML 调试开关,支持清空隔离面板并按当前 traceId 重放 HWLAB Kafka→SSE→生产卡片 reducer,完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R1.4_Task_Report.md)。 \ No newline at end of file