Files
git.stella-ops.org/docs/updates/2025-10-26-scheduler-graph-jobs.md
root 68da90a11a
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Restructure solution layout by module
2025-10-28 15:10:40 +02:00

2.2 KiB

2025-10-26 — Scheduler Graph Job DTOs ready for integration

Summary

SCHED-MODELS-21-001 delivered the new GraphBuildJob/GraphOverlayJob contracts and SCHED-MODELS-21-002 publishes the accompanying documentation + samples for downstream teams.

Key links:

  • Schema doc: src/Scheduler/__Libraries/StellaOps.Scheduler.Models/docs/SCHED-MODELS-21-001-GRAPH-JOBS.md
  • Samples (round-trip tested): samples/api/scheduler/graph-build-job.json, samples/api/scheduler/graph-overlay-job.json
  • Event schema + sample: docs/events/scheduler.graph.job.completed@1.json, docs/events/samples/scheduler.graph.job.completed@1.sample.json
  • API doc: src/Scheduler/StellaOps.Scheduler.WebService/docs/SCHED-WEB-21-001-GRAPH-APIS.md
  • Tests: StellaOps.Scheduler.Models.Tests/SamplePayloadTests.cs, GraphJobStateMachineTests.cs

Action items

Guild Request Owner Target
Scheduler WebService Wire DTOs into upcoming /graphs job APIs (SCHED-WEB-21-001/002). Scheduler Models Guild Sprint 21 stand-up
Scheduler Worker Align planners/executors with GraphJobStateMachine and new metadata fields. Scheduler Models Guild Sprint 21 stand-up
Cartographer Confirm expectations for graphSnapshotId, cartographerJobId, overlay triggers. Scheduler Models Guild Cartographer sync 2025-10-27

Notification log

  • 2025-10-26 — Posted summary + action items to #scheduler-guild and #cartographer-guild using the snippet below. Both messages linked back to the schema doc and event sample for follow-up.
  • 2025-10-26 — Shared the API doc link with WebService guild thread for endpoint contract review before Cartographer wiring. Highlighted new POST /graphs/hooks/completed + GET /graphs/overlays/lag behaviour and correlation IDs.

Suggested message for Slack #scheduler-guild & #cartographer-guild:

Graph job DTOs/docs are live (SCHED-MODELS-21-001/002). Samples under samples/api/scheduler, schema notes in src/Scheduler/__Libraries/StellaOps.Scheduler.Models/docs/SCHED-MODELS-21-001-GRAPH-JOBS.md. Please review before wiring SCHED-WEB-21-001/201. GraphJobStateMachine enforces status/attempt invariants—shout if you need additional states.

Record notifications here once posted.