mirrors/pikasTech-HWLAB
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 修正 MDTODO 依赖可见性
Pipelines as Code CI / hwlab-nc01-v03-ci-poll- Success
Details

Browse Source
This commit is contained in:
root
2026-07-10 15:00:01 +02:00
parent 9af0521979
commit 189d599e35
1 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/MDTODO/pure-kafka-live-single-step-debug.md
+2 -2
View File
@@ -24,10 +24,10 @@
按 eventSource 修复 Trace 序列权威：live Kafka 保留 ingress 顺序并以 sourceEventId 或 runId+sourceSeq 识别事件，不伪造 projectedSeq；补 sourceSeq-only running/assistant/tool/terminal、去重与 terminal 保留合同。上下文：[前端根因 #2475](https://github.com/pikasTech/HWLAB/issues/2475#issuecomment-4935381417)、[运行面证据 #2477](https://github.com/pikasTech/HWLAB/issues/2477#issuecomment-4935385934)。依赖：无。验证：真实 mapper envelope 的 eventCount 等于 stored events、readableRows 大于 0，projection 保持关闭，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.1_Task_Report.md)。
### R2.2
在同一产品 EventSource 的 decode/coalesce 前 tee 原始 frame，并在隔离调试卡片增加 Trace 卡片/原始 HWLAB Event 子标签；raw 按到达顺序写入 bounded 内存、暴露 invalid JSON，YAML-first 开关和容量独立配置，不新增 SSE 或 Kafka consumer。上下文：[主 issue #2474](https://github.com/pikasTech/HWLAB/issues/2474)、[前端设计 #2475](https://github.com/pikasTech/HWLAB/issues/2475#issuecomment-4935381417)。依赖：无，可与 R2.1 并行。验证：每个产品 frame 恰好 raw+1 且 reducer 一次，切换标签不新增 EventSource，eviction/invalid-json/runtime contract 通过，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.2_Task_Report.md)。
在同一产品 EventSource 的 decode/coalesce 前 tee 原始 frame，并在隔离调试卡片增加 Trace 卡片/原始 HWLAB Event 子标签；raw 按到达顺序写入 bounded 内存、暴露 invalid JSON，YAML-first 开关和容量独立配置，不新增 SSE 或 Kafka consumer。上下文：[主 issue #2474](https://github.com/pikasTech/HWLAB/issues/2474)、[前端设计 #2475](https://github.com/pikasTech/HWLAB/issues/2475#issuecomment-4935381417)。依赖：无，可与 Trace 序列权威修复并行。验证：每个产品 frame 恰好 raw+1 且 reducer 一次，切换标签不新增 EventSource，eviction/invalid-json/runtime contract 通过，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.2_Task_Report.md)。
### R2.3
修复隔离 debug replay 的 producer/barrier 与分层结果合同：保留 source lineage、replayId、offset range，报告 scanned/matched/delivered/decoded/applied/terminal，区分 producer-not-invoked、trace missing、filter mismatch、decoder/reducer rejection 与 terminal missing；仅写 debug topic。上下文：[隔离根因 #2476](https://github.com/pikasTech/HWLAB/issues/2476#issuecomment-4935398125)、[主方案 #2474](https://github.com/pikasTech/HWLAB/issues/2474#issuecomment-4935408473)。依赖：无。验证：empty、matched-no-terminal、reducer-rejected、terminal-complete 四类 typed 结果及 semantic internal web-probe command，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.3_Task_Report.md)。
### R2.4
集成 R2.1-R2.3，受控部署到 NC01/v03 并用原入口验证运行中及结束后 Trace 可读、同一 ingress raw/reducer 计数可解释、隔离 debug 命中 terminal；保持 OTel 三服务完整、error=0、projection=0 且产品链无补洞路径。上下文：[验收 #2474](https://github.com/pikasTech/HWLAB/issues/2474)、[OTel 基线 #2477](https://github.com/pikasTech/HWLAB/issues/2477#issuecomment-4935385934)。依赖：R2.1、R2.2、R2.3。验证：定向测试、YAML/render/runtime contract、受控 CI/CD、semantic --origin internal web-probe 与 Kafka/SSE/DOM/OTel bounded counts，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.4_Task_Report.md)。
集成前三个子任务，受控部署到 NC01/v03 并用原入口验证运行中及结束后 Trace 可读、同一 ingress raw/reducer 计数可解释、隔离 debug 命中 terminal；保持 OTel 三服务完整、error=0、projection=0 且产品链无补洞路径。上下文：[验收 #2474](https://github.com/pikasTech/HWLAB/issues/2474)、[OTel 基线 #2477](https://github.com/pikasTech/HWLAB/issues/2477#issuecomment-4935385934)。依赖：Trace 序列权威修复、单一 ingress raw 观察窗、隔离 debug replay 分层诊断。验证：定向测试、YAML/render/runtime contract、受控 CI/CD、semantic --origin internal web-probe 与 Kafka/SSE/DOM/OTel bounded counts，完成任务后将详细报告写入[任务报告](./details/pure-kafka-live-single-step-debug/R2.4_Task_Report.md)。