fix: 保持纯 Kafka 终态与扫描完整性

docs/reference/kafka-source-direct-debug.md

@@ -34,6 +34,8 @@
   - `completionReason=end-offset` 表示已经扫描到命令启动时捕获的 Kafka 上界；
   - `completionReason=limit` 表示达到显式事件上限，不能冒充完整 trace；
   - `completionReason=timeout` 表示未在 YAML 或 CLI 时限内证明到达上界；
+  - 未到捕获上界时，Trace 命令必须返回 `status=partial`、`ok=false`、`source_scan_incomplete` 和非零退出码，同时保留有界 Markdown artifact 供下钻；
+  - 默认文本首词必须是 `partial`，并披露 `completionReason` 与 `reachedEndOffsets`，禁止用 `ok` 或 `succeeded` 表示部分扫描；
   - 没有匹配事件时以 `source_trace_missing` 失败，并保留上述扫描计数。
 
 - Trace Markdown artifact 默认写入 `.state/hwlab-cli/kafka-render/`：
@@ -64,6 +66,7 @@
   - Workbench 消费 debug topic 由 `HWLAB_WORKBENCH_KAFKA_DEBUG_REPLAY_ENABLED` 独立控制；
   - CLI 的离线映射不依赖该运行面开关；
   - Kafka 输入默认只做映射预检和本地证据固化；
+  - Kafka 输入未扫描到命令启动时捕获的 topic 上界时返回 `partial/source_scan_incomplete`，保留 artifact，但即使指定 `--publish` 也不得调用 producer；
   - 只有显式 `--publish` 才发布到独立 HWLAB debug topic。
 
 - JSONL 输入适合完全离线的单步测试：