From 9487100d0d8a5efbf762a54881bc3e662ff7e349 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Tue, 17 Nov 2026 23:26:08 +0000 Subject: [PATCH] Prepare 2.10.0: workflow version usage and Server 3.12.0 dev runtime Co-Authored-By: Claude Opus 5.5 --- docs/release-notes/2.10.0.md | 60 ++++++++++++++++++++++++++++++++++++ rust/Cargo.lock | 2 +- rust/Cargo.toml | 2 +- 3 files changed, 62 insertions(+), 2 deletions(-) create mode 100644 docs/release-notes/2.10.0.md diff --git a/docs/release-notes/2.10.0.md b/docs/release-notes/2.10.0.md new file mode 100644 index 0000000..6d5b9a7 --- /dev/null +++ b/docs/release-notes/2.10.0.md @@ -0,0 +1,60 @@ +Durable Workflow CLI 2.10.0 + +## See which open runs still depend on a version branch + +2.10.0 adds `dw workflow:version-usage` (cli#158, durable-workflow/.github#220). +Before you raise a minimum supported version or delete a `patched()` legacy +branch, ask the Server which open runs would still replay through it: + +```bash +dw workflow:version-usage orders.Checkout payment-provider --min-version=2 +dw workflow:version-usage orders.Checkout payment-provider --min-version=2 --state=unknown --json +``` + +- **Each open run is legacy, current or unknown.** Legacy means it recorded a + version below `--min-version`; current means at or above. Unknown means it + has no marker for this change ID (`marker_absent`) or its history is + unavailable or invalid. A run that started before the change point existed + shows as unknown, so retire a branch only when legacy **and** unknown are zero. +- **Counts cover every open run**, before `--state` filtering and paging. Closed + runs are not included. Markers recorded by the PHP, Python and Rust SDKs and by + embedded Laravel classify the same way. +- **Paging.** `--limit` (1–200) sets the page size. Pass the returned opaque + `next_cursor` with the same query to continue. JSON and JSONL output keep the + whole page, including counts. +- **It needs Server 3.12.0 or later.** The command checks that the Server + advertises `capabilities.workflow_version_usage`. If it doesn't, the command + exits with code 8 before sending the query and never reports an empty result. + +The result is a live view, not a deployment fence. Stop or fence new starts +that could take the old path, then run the query again before removing code. +See [Check Open Runs Before Retiring a Branch](https://durable-workflow.com/docs/features/versioning/#check-version-usage). + +## The development Server is now Server 3.12.0 + +`dw server:start-dev` now embeds native Server **3.12.0** (cli#165), so the +local Server answers `workflow:version-usage` and includes the 3.12.0 +retained-payload fixes. + +**Existing development data is upgraded once.** The first time 2.10.0 starts on +a data directory created by 2.9.0, it upgrades that SQLite database from schema +14 to 15 in place. It prints `Upgraded the development database from schema 14 +to 15.`, keeps your workflows and history, and then starts normally. The upgrade: + +- runs only on the development Server's own data directory, while it holds that + directory exclusively; +- is a single transaction, so an interrupted upgrade leaves the database as it + was; +- is **one-way**: CLI 2.9.0 can no longer open that directory afterwards. To keep + a copy usable by 2.9.0, copy the data directory (by default `dev-server` beside + the CLI config file) before the first 2.10.0 start. + +A data directory written by a newer `dw` is still refused, and the message says +to use that newer `dw` or to choose another `--data-dir`. + +## Compatibility + +- Commands other than `workflow:version-usage` work with the same Servers as + 2.9.0. +- The CLI still uses the published Rust SDK 4.18.0. Building from source needs + Rust 1.99. diff --git a/rust/Cargo.lock b/rust/Cargo.lock index 834d660..c0b7954 100644 --- a/rust/Cargo.lock +++ b/rust/Cargo.lock @@ -518,7 +518,7 @@ dependencies = [ [[package]] name = "dw" -version = "2.9.0" +version = "2.10.0" dependencies = [ "axum", "durable-workflow", diff --git a/rust/Cargo.toml b/rust/Cargo.toml index 20d4fab..20454a9 100644 --- a/rust/Cargo.toml +++ b/rust/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "dw" -version = "2.9.0" +version = "2.10.0" edition = "2021" rust-version = "1.99" description = "Command-line interface for Durable Workflow Server and Cloud"