From f0ad0c3e4c07c2564ee7756708bc9b8d5705cbe6 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Tue, 17 Nov 2026 16:36:30 +0000 Subject: [PATCH 1/3] Prepare 2.9.0: built-in native development Server Co-Authored-By: Claude Opus 5.5 --- docs/release-notes/2.9.0.md | 43 +++++++++++++++++++++++++++++++++++++ rust/Cargo.lock | 2 +- rust/Cargo.toml | 2 +- 3 files changed, 45 insertions(+), 2 deletions(-) create mode 100644 docs/release-notes/2.9.0.md diff --git a/docs/release-notes/2.9.0.md b/docs/release-notes/2.9.0.md new file mode 100644 index 0000000..2e5a4b6 --- /dev/null +++ b/docs/release-notes/2.9.0.md @@ -0,0 +1,43 @@ +Durable Workflow CLI 2.9.0 + +## Start a local Server with only `dw` installed + +2.9.0 adds `dw server:start-dev` (cli#161, cli#160). The native Server and a bundled +SQLite database are compiled into `dw`, so you need nothing else to start a local +runtime: no PHP, Docker, Redis, separate Server installation or runtime download. + +```bash +dw server:start-dev +# in another terminal +dw env:set local --server=http://127.0.0.1:8080 --token=dev-token --make-default +dw doctor +``` + +- **It works from an empty directory.** The command creates the schema and the + default namespace, then runs its own timers and maintenance. Your application + workers still run workflow and activity code through an SDK. +- **It is local by design.** It binds only to loopback (`127.0.0.1` by default; + `--host=localhost` and `--host=::1` also work) and refuses any other address. + `--port=0` picks a free port and prints the URL it chose. +- **Authentication is on.** The default development bearer token is + `dev-token`. `--token` sets a custom token, which is never printed. +- **Data persists.** It is stored in `dev-server` beside the CLI config file; + `--data-dir` picks another directory. Only one development Server can use a + directory at a time. The command refuses shared, linked or replaced data + directories and files. It never takes over or upgrades an unrelated PHP + Server database. +- **Ctrl+C stops it cleanly** and keeps its data. + +The embedded engine is the native Server from accepted source `3d90086f`. That +is Server main after 3.11.0, including portable storage admission for library +builds. It is meant for development, not production; run a released Server +image for anything shared. + +## Other changes + +- The CLI now uses the published Rust SDK **4.18.0** (was 4.12.0), built without + its `msrv-1-86` default feature so it can share the native Server's Avro + dependency. Command behavior is unchanged apart from `server:start-dev`. +- Building from source needs Rust 1.99. +- CI pins the repaired central PHP bootstrap (durable-workflow/.github#400). This + doesn't change release artifacts. diff --git a/rust/Cargo.lock b/rust/Cargo.lock index e4367df..c7c7089 100644 --- a/rust/Cargo.lock +++ b/rust/Cargo.lock @@ -518,7 +518,7 @@ dependencies = [ [[package]] name = "dw" -version = "2.8.0" +version = "2.9.0" dependencies = [ "axum", "durable-workflow", diff --git a/rust/Cargo.toml b/rust/Cargo.toml index 0963d00..f9ee5f5 100644 --- a/rust/Cargo.toml +++ b/rust/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "dw" -version = "2.8.0" +version = "2.9.0" edition = "2021" rust-version = "1.99" description = "Command-line interface for Durable Workflow Server and Cloud" From c3a6afd63254a7760fe9647ed7e47bd1176c4654 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Tue, 17 Nov 2026 16:42:51 +0000 Subject: [PATCH 2/3] Note first-use guidance in 2.9.0 Co-Authored-By: Claude Opus 5.5 --- docs/release-notes/2.9.0.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/release-notes/2.9.0.md b/docs/release-notes/2.9.0.md index 2e5a4b6..e72cbba 100644 --- a/docs/release-notes/2.9.0.md +++ b/docs/release-notes/2.9.0.md @@ -33,6 +33,15 @@ is Server main after 3.11.0, including portable storage admission for library builds. It is meant for development, not production; run a released Server image for anything shared. +## Friendlier first use + +- `dw` with no arguments and `dw list` now guide a new user to the next useful + command, including `server:start-dev` (cli#162, cli#159). +- A mistyped command suggests the nearest command in the namespace you typed + first. For example, `dw workflow:lst` now leads with `workflow:list` instead of + unrelated commands that happen to sort earlier. Suggestions never run a + command for you. + ## Other changes - The CLI now uses the published Rust SDK **4.18.0** (was 4.12.0), built without From 83f49c517626728b4e503f76eb3f76d8f48771c2 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Tue, 17 Nov 2026 16:43:05 +0000 Subject: [PATCH 3/3] Describe the workflow:start help change accurately Co-Authored-By: Claude Opus 5.5 --- docs/release-notes/2.9.0.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/release-notes/2.9.0.md b/docs/release-notes/2.9.0.md index e72cbba..5e0ee4e 100644 --- a/docs/release-notes/2.9.0.md +++ b/docs/release-notes/2.9.0.md @@ -35,8 +35,9 @@ image for anything shared. ## Friendlier first use -- `dw` with no arguments and `dw list` now guide a new user to the next useful - command, including `server:start-dev` (cli#162, cli#159). +- `dw workflow:start --help` now opens with a quick start + (`dw workflow:start --type=orders.Checkout`, plus `--wait` and `--output=json`). + It lists the essential options before the advanced ones (cli#162, cli#159). - A mistyped command suggests the nearest command in the namespace you typed first. For example, `dw workflow:lst` now leads with `workflow:list` instead of unrelated commands that happen to sort earlier. Suggestions never run a