# Monitor / Web 哨兵运行时与持久化

- 范围：Monitor / Web Sentinel 的需求与架构、调度、runner 执行、observe/analyze 终态、报告产物、统一持久化、查询 API、monitor-web 与运行时可靠性。
- 权威路径：遵循 YAML-first；每个阶段只保留一个调度权威和一个持久化/查询权威，不建立旁路 scheduler、永久双写、fallback store 或补洞入口。


## R1 [in_progress]

解决 [UniDesk #1861](https://github.com/pikasTech/unidesk/issues/1861)：修复 NC01/v03 Web 哨兵控制面与 cadence 正常但 latest 报告长期不更新的问题，只修既有调度→observe/analyze→产物→SQLite/index→latest 路径，不扩展次生问题，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1_Task_Report.md)。

### R1.1 [in_progress]

单步定位 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 中新 run 未进入 latest 的唯一断点，区分调度、终态、产物、索引和查询层，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.1_Task_Report.md)。

### R1.2

在 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 边界内实现最小修复和定向测试，由 Artificer 创建独立 PR，不新增旁路或补洞，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.2_Task_Report.md)。

### R1.3

PR 合并后只等待自动发布链，使用受控 Web sentinel 原入口产生新 run，并验收 latest 返回新鲜非空 run.id/status/updatedAt，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.3_Task_Report.md)。

### R1.4 [in_progress]

核对 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 的小时级实际探测 cadence 与 10 分钟 scheduler heartbeat/扫描间隔；若只读报告语义误导则纠正字段和文档，若 owning YAML 未生效则修正渲染，验收 CronJob 与报告明确区分二者，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.4_Task_Report.md)。

## R2 [in_progress]

推进 [UniDesk #1868](https://github.com/pikasTech/unidesk/issues/1868)：按当前多 runner、全局查询与 Dashboard 复杂度重构 Monitor 平台，评估并实施分散 SQLite 到 NC01 YAML-first Host PostgreSQL 的统一迁移；P0 先冻结架构、数据模型和切换边界，再实现、自动发布和原入口验收，不以迁移掩盖 [#1861](https://github.com/pikasTech/unidesk/issues/1861)，不保留永久双写或第二权威，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2_Task_Report.md)。

### R2.1 [completed]

完成 [#1869](https://github.com/pikasTech/unidesk/issues/1869) 的需求演进、组件职责与复杂度失效边界审计，形成目标架构 must/should/out-of-scope 和候选方案，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.1_Task_Report.md)。

### R2.2 [completed]

完成 [#1871](https://github.com/pikasTech/unidesk/issues/1871) 的 SQLite 实例、schema、数据规模与生命周期盘点，设计 NC01 Host PG schema、YAML role/database/export、一次性迁移、校验、切换和回滚，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.2_Task_Report.md)。

### R2.3 [completed]

完成 [#1870](https://github.com/pikasTech/unidesk/issues/1870) 的 service/scheduler/runner API/monitor-web 调用链审计，冻结中心 Monitor 服务拆分、唯一写入/查询权威和故障隔离边界，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.3_Task_Report.md)。

### R2.4 [in_progress]

由主代理汇总 R2.1-R2.3 冻结 [#1868](https://github.com/pikasTech/unidesk/issues/1868) 架构规格，再按规格拆实施 issue/PR，迁移已有数据，等待自动 CI/CD，并用 CLI、Monitor 页面和 Web Sentinel 原入口完成一致性验收及旧 SQLite 权威退役，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.4_Task_Report.md)。