Clear stale toolpaths on program replacement

doc-rtcp/xyzac-panel-button-parity-test-report.md

@@ -55,6 +55,8 @@ AXIS 源控件清单：菜单 80、工具栏 20、快捷键 10，共 110 条，
 
 实时参数区显示：主轴实际转速 `speed_rpm`、主轴指令转速 `command_rpm`、G-code `S` 值、TP 实际进给 `velocity_mm_min`、G-code `F` 值、TP 速度/上限、F/S override、队列深度、活动段和当前执行行。所有值来自 WASM program/TP/IO 快照，参数区的 `data-xyzac-parameter-source` 为 `linuxcnc-wasm`；未取得快照时显示 `-`。
 
+程序预览替换规则：`PROGRAM_LOAD` 开始时先清空旧的 canonical preview；如果 WASM 解析或子程序加载失败，错误响应中的路径仍为空，不会把旧程序刀路重新投影出来。新的 WASM preview 成功后才替换为新程序路径。
+
 在 WASM 快照尚未到达前，界面显示 `WASM PENDING` 并禁用运动操作；不会使用 JS 默认轴值、任务状态或 override 值。浏览器定时器只发送 `SIM_STEP` 采样请求，不执行 G-code、轨迹、运动学或设备状态计算。React/Three 中的定时器、相机、网格、刀具网格和文本格式化均为显示层，不产生或修改任何 CNC 状态。
 
 ## 按钮/控件矩阵
@@ -225,6 +227,22 @@ screenshot: /tmp/published-live-parameters-r14.png
 screenshot_sha256: 7f5307c913d8bc4e60c2a31c29aacc9afd1b0d91fac4a4f22e8a64fc2ea37a1e
 ```
 
+发布站点 r15（程序预览原子替换）验证：
+
+```text
+url: https://49.232.250.35:58010/
+release: 20260902-linuxcnc-wasm-program-replace-r15
+initial preview: 29 segments
+invalid PROGRAM_LOAD: preview 0 segments, error shown, old path not retained
+valid PROGRAM_LOAD: preview 1 new segment
+browser_errors: 0
+screenshot: /tmp/published-program-replace-r15.png
+screenshot_sha256: c3e0a5b992381e7b6cb26f98a30338935df5239c875755727fc678911452ac24
+resource_sha256: index-DUB3ldSh.js 4d71a2eb0b162608d7a47b63274cf274a57b1c2f2620b69af139b12c2ba22cce
+                  sim-worker-entry-yfjiq6MN.js a0cf75522ddc9c6712126de86937ec89f24574bf0e0dad3dbddc6d807fb352b7
+                  linuxcnc-sim-core-fuIvKetC.wasm ad4e17ecbf73afbad0d9f069ab20ba3c66b6cc4d75ecdb2b3182673490ee916d
+```
+
 发布站点 r10 连续性验证：
 
 ```text
@@ -304,6 +322,7 @@ switchkins_direct_test_output 24e6cb8ec1195a97f71294b49217db0cbc0d7c3ecfa4bc8aa2
 panel_r10_output 9bddcd8b0219925e00598e081dc7a4ed0f4868e8822a21f0ccd08d8e9d355d45
 pause_resume_browser_screenshot 9d1660fd043dd0628ff2989a3e139a3239acd6386d141657a5834c9d2f1bc5a7
 live_parameters_browser_screenshot 7f5307c913d8bc4e60c2a31c29aacc9afd1b0d91fac4a4f22e8a64fc2ea37a1e
+program_replace_browser_screenshot c3e0a5b992381e7b6cb26f98a30338935df5239c875755727fc678911452ac24
 ```
 
 报告对应提交前工作树保留了既有 coverage 大文件和 LinuxCNC 子模块改动；本轮提交包含 WASM TP/IO/HOME authority、无 JS JOG 运动计算、前端 pending 投影、长程序快照性能修正、聚合测试和本报告。