up

docs/updates/2025-10-29-scheduler-policy-doc-refresh.md

@@ -0,0 +1,21 @@
+# 2025-10-29 — Scheduler/Policy Guild Doc Refresh
+
+## Summary
+- Extended `SCHED-MODELS-20-001` with environment metadata guidance, lifecycle semantics, and diff payload breakdown for Policy Engine runs.
+- Confirmed `StellaOps.Scheduler.Models.Tests` to keep sample fixtures in sync with the documentation.
+- Ready for distribution to Scheduler (Models/Worker/WebService) and Policy Engine guilds; link this update when posting to internal channels.
+
+## Suggested announcement
+> **Channel(s):** `#scheduler-guild`, `#policy-engine`  
+> **Message:**  
+> ```
+> Policy Engine run DTO docs just picked up a refresh (environment metadata, lifecycle+retry table, diff payload notes).  
+> • Doc: src/StellaOps.Scheduler.Models/docs/SCHED-MODELS-20-001-POLICY-RUNS.md  
+> • Samples: samples/api/scheduler/policy-*.json  
+> • Tests: dotnet test src/StellaOps.Scheduler.Models.Tests  
+> Please review for orchestration + API consumer work; ping back if other fields need coverage.  
+> ```
+
+## Follow-up
+- [ ] Confirm both guilds acknowledge the documentation update.
+- [ ] Fold any feedback into Sprint 21 scheduler schema backlog if additional DTO changes are requested.