fix(acceptance): reuse published staging candidate and validate scalar outputs

Author: fabricebrito

.github/workflows/build.yaml

@@ -34,6 +34,10 @@ jobs:
           .venv/bin/python scripts/cwl-docs.py --validate --output acceptance-results/cwl-docs
           .venv/bin/python scripts/wrap-pattern.py --output acceptance-results/wrapped
           for cwl in acceptance-results/wrapped/*.cwl; do .venv/bin/cwltool --validate "$cwl"; done
+      - name: Test the processing runner
+        run: |
+          cd runner
+          ../.venv/bin/python -m nose2 -v
       - name: Start authenticated disposable S3
         run: |
           printf '%s' '{"identities":[{"name":"test","credentials":[{"accessKey":"test","secretKey":"test"}],"actions":["Admin","Read","Write","List","Tagging"]}]}' > /tmp/s3.json

CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
-## ## [0.3.1] - 2026-10-08
+## [2.0.0] - Unreleased
+
+- Use CWL v1.2 and embedded typed input contracts throughout the twelve patterns.
+- Compose standalone wrapped applications with eoap-cwlwrap and mastering GHCR staging artifacts.
+- Hash-lock the Python 3.12 environment and pin processing images by digest.
+- Validate all twelve real-data workflows and four optional-input/output cases, including S3 STAC and raster checks.
+- Replace stale practice notebooks with executable examples, typed lesson documentation and diagrams.
+- Add acceptance and guarded publication CI for original and wrapped CWL artifacts.
+
+## [0.3.1] - 2026-10-08
 
 ### Fixed
 

README.md

@@ -131,13 +131,20 @@ spectral band and vegetation index definitions. Existing shared OGC and
 GeoJSON schemas remain explicit imports. Metadata and port documentation are
 validated by `python scripts/cwl-docs.py --validate --output /tmp/cwl-docs`.
 
-Notebooks use current eoap-cwlwrap/cwl-loader APIs and serialize composed
-processes with dump_cwl. Wrapper-introduced URI definitions are embedded in
-the resulting document. Diagram rendering uses local Graphviz and displays
-PlantUML source. Ordinary box labels avoid Graphviz record-node flat-edge
-failures. Python 3.12 or newer is required.
-
-Staging retries incomplete network transfers at most three times, retaining
-completed assets; exhausted retries and non-network failures remain errors.
-Kubernetes deployment and notebook acceptance tasks are maintained in the
-`application-package-patterns` folder of dev-platform-eoap.
+The lessons are Markdown pages backed by twelve executable CWL examples. `eoap-cwlwrap` composes each example with the mastering stage-in/out commands; wrapper-introduced URI definitions are embedded in the resulting standalone document. No CWL packing step is used.
+
+Install and validate the release environment:
+
+```bash
+uv venv --python 3.12 .venv
+uv pip sync --python .venv/bin/python --require-hashes requirements-notebooks.txt
+source .venv/bin/activate
+task test:contracts
+task wrap
+```
+
+Run all twelve patterns and four optional-input/output cases against real Landsat and DEM data using the `application-package-patterns` module in [dev-platform-eoap](https://github.com/eoap/dev-platform-eoap). Its `task labs` uses Calrissian on Kubernetes and the deployed SeaweedFS S3 endpoint. For a local Podman runner, configure `PATTERNS_S3_ENDPOINT`, prepare the bucket with `python scripts/prepare-s3.py`, then run `python scripts/run-acceptance.py --runner cwltool`.
+
+The acceptance runner verifies published STAC links, readable raster assets, coordinate reference systems and intersection with the requested area. Pattern 6 returns a scalar normalized-index mean; its acceptance check verifies a finite value within [-1, 1]. Evidence includes execution logs, outputs and scientific checks for each case.
+
+The staging provenance and immutable GHCR image references are recorded in `mastering-staging.lock.json`. Deployment uses GitHub resources and published containers; it requires no sibling host checkout.

RELEASE_NOTES.md

@@ -1,6 +1,6 @@
 # Application Package Patterns 2.0.0
 
-The twelve patterns now expose typed CWL v1.2 contracts with embedded custom definitions. eoap-cwlwrap 0.32.0 composes standalone workflows using the mastering 2.0.0 stage-in and stage-out commands and immutable GHCR container digests. Directory staging no longer injects copies of Python staging scripts.
+The twelve patterns now expose typed CWL v1.2 contracts with embedded custom definitions. eoap-cwlwrap 0.32.0 composes standalone workflows using the mastering 2.0.1-rc.44.1 stage-in and stage-out commands and immutable GHCR container digests. Directory staging no longer injects copies of Python staging scripts.
 
 Real Landsat processing and S3 publication are checked across all twelve patterns and four optional-port cases. Acceptance validates metadata and standalone CWL, verifies returned STAC links and raster assets on authenticated S3, and builds the static Markdown documentation strictly. Dependencies are hash-locked for Python 3.12; AMD64 is the acceptance architecture.
 

docs/pattern-1.md

@@ -176,7 +176,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-1

docs/pattern-10.md

@@ -337,7 +337,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-10

docs/pattern-11.md

@@ -178,7 +178,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-11

docs/pattern-12.md

@@ -347,7 +347,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-12

docs/pattern-2.md

@@ -178,7 +178,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-2

docs/pattern-3.md

@@ -176,7 +176,7 @@ symbols:
 
 ## Run the wrapped pattern
 
-The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes mastering 2.0.0 staging, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
+The application uses local File/Directory ports. `eoap-cwlwrap` converts these to typed URI references and composes the locked mastering staging artifacts, using immutable GHCR container digests. Configure `PATTERNS_S3_ENDPOINT` for your S3 service.
 
 ```bash
 python scripts/run-acceptance.py --case pattern-3