From 86effbf4cd4839fdb7cb6fa464ed9bb52025a7f2 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Wed, 18 Nov 2026 16:08:57 +0000 Subject: [PATCH 1/2] Prepare Python SDK 2.19.0 release Release the all() member-failure fix that no longer resends an open group (#338, #341), WorkflowContext.schedule_origin (.github#243, #340) and typed request_id_ambiguous signal/update refusals (.github#216, #322). Retarget the installed retry-cap qualification cell to the 2.19.0 candidate on native Server 3.13.0. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/ci.yml | 4 ++-- CHANGELOG.md | 4 ++++ pyproject.toml | 6 +++--- scripts/ci/activity-retry-cap.md | 2 +- scripts/ci/activity_acceptance_release.py | 2 +- tests/fixtures/published-retry-cap.json | 10 +++++----- tests/test_activity_retry_cap_cell.py | 2 +- 7 files changed, 17 insertions(+), 13 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 3b7ab1e..8debb7e 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -97,7 +97,7 @@ jobs: id: retry-candidate env: GH_TOKEN: ${{ github.token }} - run: python .github/scripts/promote_release.py resolve --version 2.18.0 + run: python .github/scripts/promote_release.py resolve --version 2.19.0 - name: Download the approved candidate handoff if: inputs.retry_cap_artifact_source == 'candidate' uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8 @@ -110,7 +110,7 @@ jobs: archive: false - name: Verify candidate archive and distribution bytes if: inputs.retry_cap_artifact_source == 'candidate' - run: python .github/scripts/promote_release.py extract --version 2.18.0 + run: python .github/scripts/promote_release.py extract --version 2.19.0 - name: Bootstrap patched pip trust uses: durable-workflow/.github/.github/actions/bootstrap-patched-pip@75587fc33ff40c34f32ef777293dad56bb6f48c7 # clean-trust with: diff --git a/CHANGELOG.md b/CHANGELOG.md index f686e15..641b3bf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [2.19.0] - 2026-11-18 + ### Added - `WorkflowContext.schedule_origin` returns the schedule fire that started the run as a `ScheduleOrigin` (`schedule_id`, `occurrence_time`, `trigger_number`), or `None` for a run no schedule started (durable-workflow/.github#243). It reads the run's `ScheduleTriggered` history event, so it is available on the first workflow task and identical on replay. `occurrence_time` is the time the scheduler evaluated (the jittered fire time for a tick, the enumerated time for a backfill), not the run's start time, and is `None` for a manual trigger. Histories without the event read `None`, so existing runs replay unchanged. @@ -16,6 +18,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - An `all()` group (`yield [...]`) whose member fails while other members are still running no longer blocks the run. Server wakes the workflow once, for the failure, and never again for that group. The worker used to send the group's whole scheduling batch again on that wake, and native Server refused the completion with `409 parallel_sequence_mismatch` (2.17.2 and 2.18.0 on native Server 3.12.0 and 3.13.0). The first recorded member failure is now raised at the yield as soon as it is recorded, as in Workflow's embedded engine. The other members keep running and their outcomes are ignored. A wake while a group is open, such as a signal, also no longer sends the group again. (#338) - **Recorded decision:** the task that raises a failure early first records which member it raised, as a side effect whose result is keyed `durable_workflow.parallel_failure_decision`, at the sequence right after the group. Replay raises exactly that member. History has no workflow-task boundaries, so without the record a member failing after the task read history but before its completion was written would make a later replay choose differently. Workflow code after such a group therefore starts one sequence later. - **Replay safety:** a history in which every member settled before the workflow did anything else replays as before, raising the failure with the lowest input position. This is now the documented default for groups with no recorded policy, matching Workflow's embedded engine and the PHP and Rust SDKs. The explicit policies remain tracked in #307. + - **Visible effect:** when a member fails while a sibling is still running, workflow code after the group, such as a compensation, now starts one sequence later than it would have, because the decision record takes the sequence right after the group. Nothing else about the group changes: the same failure reaches the same `except` block. + - **Runs already blocked under 2.18.0 or earlier recover after the upgrade.** Upgrade every worker on the task queue to 2.19.0, wait until the group's other members have finished, then repair the run (`WorkflowHandle.repair()` or `Client.repair_workflow()`). The repaired workflow task raises the group's failure on the upgraded worker instead of sending the group again, and the run continues. Upgrading alone is not enough, because native Server sends no new workflow task to a blocked run. Native Server 3.13.0 refuses the repair with `development_workflow_task_repair_active_work_unqualified` while a member is still running, and also when the blocked run has received a signal or an accepted update, so a run in that state stays blocked. Checked on native Server 3.13.0: a run blocked by a 2.18.0 worker stayed `waiting` after the upgrade until it was repaired, then ran its compensation and completed. ## [2.18.0] - 2026-11-18 diff --git a/pyproject.toml b/pyproject.toml index 7f927f0..ba498de 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "durable-workflow" -version = "2.18.0" +version = "2.19.0" description = "Python client and worker SDK for Durable Workflow Cloud and self-hosted Server" readme = "README.md" requires-python = ">=3.10" @@ -79,8 +79,8 @@ durable-workflow-replay-conformance = "durable_workflow.replay_conformance:main" durable-workflow-workflow-updates-conformance = "durable_workflow.workflow_updates_conformance:main" [tool.durable-workflow] -product-train = "2.18.0" -registry-version = "2.18.0" +product-train = "2.19.0" +registry-version = "2.19.0" supported-server-versions = "2.8.0" supported-server-release-baselines = { "2" = "2.8.0", "3" = "3.0.0" } worker-protocol-version = "1.20" diff --git a/scripts/ci/activity-retry-cap.md b/scripts/ci/activity-retry-cap.md index b1aa87f..89e6f9c 100644 --- a/scripts/ci/activity-retry-cap.md +++ b/scripts/ci/activity-retry-cap.md @@ -1,4 +1,4 @@ -The retry-cap case qualifies the exact reviewed 2.18.0 wheel on the published +The retry-cap case qualifies the exact reviewed 2.19.0 wheel on the published Server/Python tuple in `tests/fixtures/published-retry-cap.json`. It uses the existing internal two-container profile, complete hash lock, captured no-site entry, before/after installed inventory and independent ID/label cleanup. diff --git a/scripts/ci/activity_acceptance_release.py b/scripts/ci/activity_acceptance_release.py index ef8e489..d441a23 100644 --- a/scripts/ci/activity_acceptance_release.py +++ b/scripts/ci/activity_acceptance_release.py @@ -8,7 +8,7 @@ from scripts.ci.activity_acceptance_entry import captured_file -VERSION = "2.18.0" +VERSION = "2.19.0" WHEEL = f"durable_workflow-{VERSION}-py3-none-any.whl" SDIST = f"durable_workflow-{VERSION}.tar.gz" diff --git a/tests/fixtures/published-retry-cap.json b/tests/fixtures/published-retry-cap.json index c62b542..93464f1 100644 --- a/tests/fixtures/published-retry-cap.json +++ b/tests/fixtures/published-retry-cap.json @@ -1,10 +1,10 @@ { "schema": "sdk-python.published-activity-acceptance/v1", - "sdk_version": "2.18.0", - "server_image": "ghcr.io/durable-workflow/server@sha256:33c7ec1d61dbbdf5c1c2248da609208bdaa8a0f8d25f3f016686c486fc7ed7f8", - "server_source": "da655a8500691d6ce8e018d1552801491a696135", - "server_amd64_manifest": "sha256:52fed6731309116bc9e71cb4b140be570e50942935f3238ebed08e1b338d998d", - "server_qualification": "https://github.com/durable-workflow/server/releases/tag/3.12.0", + "sdk_version": "2.19.0", + "server_image": "ghcr.io/durable-workflow/server@sha256:30ccaf2cea6810a92915a9eb389f1a63ea870818a74c9cc1a321379b07b2d25c", + "server_source": "2d1244be4611e1bc4aa4f0d856c708bed17937b4", + "server_amd64_manifest": "sha256:6cdcb909b1ca46d10410d7f659fcbd292dbf02be0c337d989b886153c0f3ee56", + "server_qualification": "https://github.com/durable-workflow/server/releases/tag/3.13.0", "python_image": "docker.io/library/python@sha256:935c3c5b12357a7e10caa9c1e6ca5692344d97cf229832ef584be2cec9fc03df", "python_amd64_manifest": "sha256:0f086103b026048cc50cb5da25ec435c023c5241a83fc44daea593377abc61c4", "python_version": "3.12.16" diff --git a/tests/test_activity_retry_cap_cell.py b/tests/test_activity_retry_cap_cell.py index 0fe2418..dffd0c2 100644 --- a/tests/test_activity_retry_cap_cell.py +++ b/tests/test_activity_retry_cap_cell.py @@ -84,7 +84,7 @@ def approval(digest="a" * 64): def test_effective_lock_adds_only_the_approved_sdk_to_the_fixed_dependencies(): result, digest = release.lock(b"pytest==1 --hash=sha256:" + b"c" * 64 + b"\n", approval()) - assert result.endswith(f"durable-workflow==2.18.0 --hash=sha256:{digest}\n".encode()) + assert result.endswith(f"durable-workflow==2.19.0 --hash=sha256:{digest}\n".encode()) assert result.count(b"durable-workflow") == 1 From 4e84b0d61db6128b9c48fd98e1e59af3f1267945 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Wed, 18 Nov 2026 16:12:30 +0000 Subject: [PATCH 2/2] Approve the reviewed 2.19.0 release candidate Co-Authored-By: Claude Opus 5.5 --- .github/release-candidates/2.19.0.json | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .github/release-candidates/2.19.0.json diff --git a/.github/release-candidates/2.19.0.json b/.github/release-candidates/2.19.0.json new file mode 100644 index 0000000..1622077 --- /dev/null +++ b/.github/release-candidates/2.19.0.json @@ -0,0 +1,14 @@ +{ + "schema": "sdk-python.reviewed-release/v1", + "version": "2.19.0", + "source_commit": "86effbf4cd4839fdb7cb6fa464ed9bb52025a7f2", + "source_tree": "42c96102d889a65a4b4f70687ed5bcf41f549fee", + "run_id": 44343865375, + "run_attempt": 1, + "artifact_id": 14443574939, + "artifact_sha256": "7d2132af4f7f13c020cfa935b24e4d4024ae1cbacaf012694dce3391c4ef8e7f", + "files": { + "durable_workflow-2.19.0-py3-none-any.whl": "1f18d038f24a6ad9440e03837e634b99a3f870afaf9c4a874829fca48737a056", + "durable_workflow-2.19.0.tar.gz": "57aaba83102474b77283f3d7b1bb862635c846378e8c5155d228bc910b4b41a6" + } +}