3.0 KiB
STEP-057B WeatherRuntime 状态语义修正 — Codex 完成报告
状态：IMPLEMENTED / WAITING_CODE_REVIEW。
实际修改
本轮基于 dad6876c72f29e2d5671677ee15e13cd25e653a1，只修改：
platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/maps/WeatherRuntime.javaplatform/android/MapLibreAndroid/src/test/java/org/maplibre/android/maps/WeatherRuntimeStateTest.java- STEP-057 Step 记录、
粒子开发记录.md与本报告
没有修改 renderer、RenderOrchestrator、JNI、shader/UBO、WeatherColor ramp、timestamp Core、Runtime Field Window、Test App UI 或 React Native bridge。
最终状态语义
普通数据质量拒绝 REJECTED_ADAPTER、REJECTED_INCOMPATIBLE、REJECTED_NON_MONOTONIC、REJECTED_CAPACITY 以及空 metadata/payload 只表示本次提交失败，保留当前 READY 或 WAITING_FOR_FIELDS。ACCEPTED_PENDING_INITIAL_WINDOW → WAITING，INITIAL_WINDOW_READY/ACCEPTED_NEXT_SNAPSHOT → READY，DUPLICATE 保持 current。只有 REJECTED_SOURCE_MODE 和 UNKNOWN 进入 ERROR。
READY 或 WAITING_FOR_FIELDS 重复 enable 是 ACCEPTED no-op；DISABLED enable 成功恢复 visibility 并进入 WAITING，失败进入 ERROR；ERROR enable 返回 REJECTED 并保持 ERROR。clear 成功 → WAITING、失败保持 current；disable 成功 → DISABLED、失败 → ERROR；DISABLED 重复 disable 为 ACCEPTED no-op。
测试覆盖
WeatherRuntimeStateTest 使用现有 JUnit/Mockito，覆盖所有普通 rejection 在 READY/WAITING 下保持状态、SOURCE_MODE/UNKNOWN 错误、enable 分支、clear/disable，以及两条实际 public flow：READY 下 invalid submit 保持 READY，ERROR 下 enable 返回 REJECTED 且不调用 visibility recovery。该源码未单独引入测试框架。
验证
本轮执行 git diff --check：PASS。未执行编译或测试命令；因此 public flow 测试尚未运行。明确未执行：Android Gradle、APK build、ADB、设备/虚拟机测试、Jest。此前 STEP-057A 的 Linux/OpenGL 与非 Jest Core 验证不受本轮代码修改影响。
风险与审计状态
已知剩余风险是 Android Java/Kotlin 编译和 Mockito final-class 配置需在后续统一 Android 验收中确认；本轮没有改变 Core field/timeline 生命周期。当前提交具备再次独立代码审计条件，等待 code review 后再进入 Android T1–T13 综合验证。
Git
- 基线：
dad6876c72f29e2d5671677ee15e13cd25e653a1 - 功能 commit：
486cc80b6ff66e455b776ca488856c0c2ee37ba0 - commit message：
fix: correct STEP-057B weather runtime state semantics - Push：成功，
dad6876c7..486cc80b6 particle/main -> particle/main - Remote branch：
origin/particle/main - STEP-057B 功能 Final HEAD：
486cc80b6ff66e455b776ca488856c0c2ee37ba0 - origin/particle/main HEAD（功能提交后）：
486cc80b6ff66e455b776ca488856c0c2ee37ba0
本报告的文档收尾提交及其最终分支 HEAD 由交付消息一并列出；该收尾只更新本报告元数据。