[AIW-03] 重启 OS Edge Runtime 时保持 Backend 与任务事实连续

[TablewareBox]

Parent

Part of #215.

What to build

把可重启的 OS Edge Runtime 从常驻 Local Backend/Local Scheduler 故障域中分离。Edge Runtime 只承担 EdgeExecution、HostLink/ROS、驱动和设备动作；Local Backend 通过与生产 Backend 同形的 durable loopback Edge Interface 调度它。用户或 Agent 重启 OS 时，Authoring、Inventory、Task/Job、History、SSE 和页面保持连续。

Acceptance criteria

• Edge Runtime 不拥有 Authoring 投影、工作流定义、正式库存或第二个 Scheduler Authority。
• Local Scheduler/Inventory/History 位于 Local Backend；HostLink/ROS/驱动位于 Edge Runtime。
• Local Backend 与 Edge Runtime 之间复用生产 Edge 协议语义：HTTP 持久事实，WebSocket 短命令/通知。
• start/stop/restart OS 只改变 Edge PID/device generation，不改变 Local Backend 地址、source identity 或 Authoring SSE cursor。
• OS 重启不清空 Workflow、Material、Task/Job、History 或 Edge outbox。
• 重复 job.start、断网、Edge crash/restart 不重复执行已确认物理动作。
• 未知物理结果保持 UNKNOWN 和设备锁，只有显式 reconcile/resolve 才能继续。
• local 模式通过 PLC-Sim 完成最长带料工作流；运行期间重连后的 Task/节点事实最终收敛。
• Backend 模式使用同一 Edge Runtime，不创建 local Scheduler/Inventory 数据库。
• 浏览器页面在 Edge 重启全过程保持 Workflow 与 Material 画布可交互，并附前后截图和日志证据。

Blocked by

• [AIW-02] 让 Workspace Host 与 unilab CLI 共享 Managed Local 生命周期 #217

[github-actions]

GitHub → Feishu OKF synchronization

Feishu snapshot: Uni-Lab-Core #218
Knowledge stage: implementation
Issue updated: 2026-08-13T15:11:53Z

[TablewareBox]

AIW-03 已实现并通过本地真实进程链路验收。

实现证据：

• Uni-Lab-OS codex/ai-native-workspace-backend：e3ac2106 feat(edge): split local backend and durable control runtime（已推送）。
• Local Backend 成为 Authoring / Scheduler / Inventory / History Authority；Edge Runtime 仅保留 ROS、驱动和设备动作。
• Backend→Edge 使用 /api/v1/edge 的 durable HTTP facts + WebSocket command channel；包含稳定 sequence、ACK/retry、job token、outcome projection、UNKNOWN lock/reconcile 与断线恢复。
• 普通 os.restart 只替换 Edge PID/generation，Backend PID/address、Authoring 数据与事件流保持；显式 local.reset-state 才重建本地 Backend 并清理 transient Edge work，同时保留 Edge instance UUID。
• Edge Runtime 的 local/backend 两种 control plane 均不创建第二个 Scheduler/Inventory Authority。
• Managed Local 新增 PLC handshake workflow 透传，便于可复现 E2E。

验证证据：

• OS focused suite：50 passed（仅 2 条 FastAPI on_event deprecation warning）。
• PLC handshake suite：25 passed。
• 正常模式（非 dry-run）、SZLab 0810 CSV、PLC Sim handshake all、最长带料工作流 7e1122f3-3889-546c-b8f8-49dc8a0121c3：页面 47/47 节点全部执行成功，浏览器 console 0 error。
• 验收截图：/Users/dp/Design_projects/Uni-Lab-Core/.artifacts/aiw-03/longest-workflow-47-of-47.png。
• E2E 中修复的 PLC Sim 缺口提交为本地 codex/aiw-03-plc-handshake / af754c8；上游个人仓库拒绝当前身份 push（403），未改写 remote。

Authority 的 UI 原子切换、缓存/认证/SSE 命名空间隔离继续在 AIW-04 #219 实现。