Document jobs release prep
Authored by
mfwolffe <wolffemf@dukes.jmu.edu>
- SHA
ef83fae47f863c8e2c7e8d95e4386092c1edac60- Parents
-
ca87d2d - Tree
12598f9
ef83fae
ef83fae47f863c8e2c7e8d95e4386092c1edac60ca87d2d
12598f9| Status | File | + | - |
|---|---|---|---|
| M |
README.md
|
11 | 2 |
README.mdmodified@@ -23,7 +23,7 @@ Future scope: | ||
| 23 | 23 | |
| 24 | 24 | ## Status |
| 25 | 25 | |
| 26 | -Sprint 03 is in place. | |
| 26 | +Sprint 04 is in place. | |
| 27 | 27 | |
| 28 | 28 | Tracked today: |
| 29 | 29 | |
@@ -36,7 +36,9 @@ Tracked today: | ||
| 36 | 36 | - grouped pipeline-member tracking on job handles |
| 37 | 37 | - explicit signal-forwarding and terminal-handoff policy fields |
| 38 | 38 | - pipeline-aware stop, continue, and completion aggregation |
| 39 | -- focused scaffold coverage in `fpm test` | |
| 39 | +- tracked examples for lifecycle and pipeline state transitions | |
| 40 | +- replacement-safe pipeline member attachment and cleaner group-stop member results | |
| 41 | +- CI now runs both tests and tracked examples | |
| 40 | 42 | |
| 41 | 43 | ## Public API Shape |
| 42 | 44 | |
@@ -96,6 +98,8 @@ Current semantics: | ||
| 96 | 98 | - `job_handle` is now the explicit ownership point for a launched job group, and may track member-level pipeline state |
| 97 | 99 | - `job_result` now carries pid/process-group identity plus exited, signaled, stopped, and continued wait outcomes |
| 98 | 100 | - grouped pipeline jobs only finish once all tracked members have reached terminal outcomes |
| 101 | +- reattaching pipeline members replaces the previous tracked member set cleanly | |
| 102 | +- group-scoped stop fanout preserves each tracked member pid in member-level results | |
| 99 | 103 | - `jobs_backend_name()` currently reports the planned backend family and exists to stabilize the package surface early |
| 100 | 104 | |
| 101 | 105 | ## Build And Test |
@@ -104,6 +108,11 @@ Current semantics: | ||
| 104 | 108 | fpm test |
| 105 | 109 | ``` |
| 106 | 110 | |
| 111 | +Tracked examples: | |
| 112 | + | |
| 113 | +- [job_lifecycle_demo.f90](example/job_lifecycle_demo.f90) | |
| 114 | +- [pipeline_tracking_demo.f90](example/pipeline_tracking_demo.f90) | |
| 115 | + | |
| 107 | 116 | ## Supported Platforms |
| 108 | 117 | |
| 109 | 118 | - macOS |