From 7f8f8e8e643c4e4dffcc646bb086d586ed730096 Mon Sep 17 00:00:00 2001
From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com>
Date: Sat, 14 Nov 2026 04:11:42 +0000
Subject: [PATCH 1/2] Adopt qualified Workflow 2.28.1 security patch

---
 docs/compatibility.md       | 13 ++++++++++---
 docs/installation.md        |  2 +-
 docs/laravel-adoption.md    |  9 +++++----
 static/stable-releases.json |  2 +-
 4 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/docs/compatibility.md b/docs/compatibility.md
index ea4896e7e9d..d471c15da0e 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -99,18 +99,25 @@ The embedded package and the service-mode SDK have separate support contracts.
 
 | Package line | PHP | Laravel |
 | --- | --- | --- |
-| Current embedded Workflow 2.28 | PHP 8.2+ in 8.x; PHP 8.3+ for Laravel 13 | `^12.69.0` or `^13.30.0` |
+| Current embedded Workflow %%artifact.workflowVersion%% | PHP 8.2+ in 8.x; PHP 8.3+ for Laravel 13 | `^12.72.0` or `^13.41.0` |
 | Embedded Workflow 2.20.5 | PHP `^8.1`, subject to Laravel's own minimum | `^10.50.4`, `^11.56.1`, `^12.69.0` or `^13.30.0` |
 | Published PHP SDK 3.14 | Bare SDK PHP `^8.1`; the Laravel bridge needs PHP `^8.2`, and PHP 8.3+ for Laravel 13 | `^12.69.0` or `^13.30.0` |
 | PHP SDK 3.9.5 | Bare SDK PHP `^8.1`; the Laravel bridge also follows Laravel's PHP minimum | `^10.50.4`, `^11.56.1`, `^12.69.0` or `^13.30.0` |
 
-The [published embedded upgrade contract](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+The older rows record the requirements of their named releases.
+
+The [published embedded upgrade contract](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 and each release's `composer.json` are the package authorities. The current
 embedded release was verified on Laravel 12 with PHP 8.2–8.4 and Laravel 13 with
 PHP 8.3–8.4. Its PHP 8.1 and Laravel 10/11 support has been removed. This does
 not change the [historical stable-v1 installation guide](/docs/1.x/installation/)
 or the independently published [PHP SDK requirements](https://php.durable-workflow.com/).
 
+Workflow 2.28.1 is a security-only patch that raises the Laravel minimums shown
+above. Runtime and schema files are identical to 2.28.0, so upgrading from
+2.28.0 adds no database migration. The [published package verification and five upgrade/rollback journeys](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+qualify this package.
+
 Before upgrading an older embedded application, upgrade PHP and Laravel to a
 supported combination. If that migration is not ready, `~2.20.5` keeps Composer
 on the 2.20 patch line; it does not promise indefinite maintenance. A broad
@@ -200,7 +207,7 @@ Workflow 2.27 keeps the 2.21 support floors and the embedded worker protocol `1.
 
 See the [2.27.0 release notes](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-Workflow 2.28 keeps the 2.21 support floors and the embedded worker protocol `1.22`, and adds no database migration. Behavior change to check before upgrading:
+Workflow 2.28.0 keeps the 2.21 support floors and the embedded worker protocol `1.22`, and adds no database migration. Behavior change to check before upgrading:
 
 - From 2.28, a run that completes, fails or continues as new cancels the activities and timers it never awaited, such as `select()` losers, in the same transaction, instead of leaving them running. A late result from such an activity is refused with `run_closed`. If a workflow needs a loser's effect, await it before returning. See [Losers when the run closes](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/docs/installation.md b/docs/installation.md
index 2b9b4796dc3..87ccd80a86f 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -20,7 +20,7 @@ the embedded Laravel path.
 ## Requirements
 
 - PHP 8.2 or later in the supported PHP 8.x line
-- Laravel 12.69 or later in 12.x, or Laravel 13.30 or later in 13.x
+- Laravel 12.72 or later in 12.x, or Laravel 13.41 or later in 13.x
 - PHP 8.3 or later for Laravel 13
 
 These requirements apply to the current embedded release. For an older
diff --git a/docs/laravel-adoption.md b/docs/laravel-adoption.md
index b4bc030869d..e2db3c21cd3 100644
--- a/docs/laravel-adoption.md
+++ b/docs/laravel-adoption.md
@@ -42,10 +42,11 @@ choosing the transition policy here.
 | 2.0 embedded Laravel | PHP SDK service mode | The application should stop owning the orchestration runtime or needs a shared/polyglot runtime boundary. | Route new starts to the service runtime after its workers are ready. Drain embedded runs where they started, or use the explicit eligible embedded-v2 import procedure for self-hosted Server. |
 
 Check the [published Laravel support lines](./compatibility.md#laravel-support)
-before choosing a destination. The current embedded package and, from PHP SDK
-3.10, the service-mode Laravel bridge both require Laravel 12.69 or 13.30 and
-compatible PHP. The bare service-mode client keeps PHP 8.1 support. PHP SDK
-3.9.x keeps its earlier patched Laravel 10–13 bridge contract. An older v1
+before choosing a destination. The current embedded package requires Laravel
+12.72 or 13.41 and compatible PHP. The service-mode Laravel bridge follows its
+[own PHP SDK requirements](./polyglot/php.md#requirements). The bare
+service-mode client keeps PHP 8.1 support. PHP SDK 3.9.x keeps its earlier
+Laravel 10–13 bridge contract. An older v1
 application may need a framework upgrade before moving to either current line.
 Preserve its v1 runtime and open runs during that upgrade.
 
diff --git a/static/stable-releases.json b/static/stable-releases.json
index 362f997607f..0322e3d88d0 100644
--- a/static/stable-releases.json
+++ b/static/stable-releases.json
@@ -10,7 +10,7 @@
     "sdk-rust": "4.17.0",
     "server": "3.10.0",
     "waterline": "2.18.0",
-    "workflow": "2.28.0"
+    "workflow": "2.28.1"
   },
   "helm_chart": {
     "app_version": "3.10.0",

From e80f81b0b4a78606bf9ddeadd85f1711ea85b9e6 Mon Sep 17 00:00:00 2001
From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com>
Date: Sat, 14 Nov 2026 04:22:51 +0000
Subject: [PATCH 2/2] Translate Workflow 2.28.1 requirements in all locales

---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 12 ++++++------
 i18n/de/source-hashes.json                        |  6 +++---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 15 ++++++++-------
 i18n/es/source-hashes.json                        |  6 +++---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 15 ++++++++-------
 i18n/fr/source-hashes.json                        |  6 +++---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 11 ++++++-----
 i18n/ja/source-hashes.json                        |  6 +++---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 14 +++++++-------
 i18n/pt-BR/source-hashes.json                     |  6 +++---
 .../current/compatibility.md                      | 14 +++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   | 14 +++++++-------
 i18n/uk/source-hashes.json                        |  6 +++---
 .../current/compatibility.md                      | 13 ++++++++++---
 .../current/installation.md                       |  2 +-
 .../current/laravel-adoption.md                   |  8 ++++----
 i18n/zh-Hans/source-hashes.json                   |  6 +++---
 28 files changed, 150 insertions(+), 92 deletions(-)

diff --git a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
index 383f38a5b3f..6dc63e1a279 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
@@ -66,17 +66,25 @@ Das eingebettete Paket und das Service-Modus-SDK haben eigene Supportverträge.
 
 | Paketlinie | PHP | Laravel |
 | --- | --- | --- |
-| Aktuelles eingebettetes Workflow 2.28 | PHP 8.2+ in 8.x; PHP 8.3+ für Laravel 13 | `^12.69.0` oder `^13.30.0` |
+| Aktuelles eingebettetes Workflow %%artifact.workflowVersion%% | PHP 8.2+ in 8.x; PHP 8.3+ für Laravel 13 | `^12.72.0` oder `^13.41.0` |
 | Eingebettetes Workflow 2.20.5 | PHP `^8.1`, zusätzlich gilt das Framework-Minimum | `^10.50.4`, `^11.56.1`, `^12.69.0` oder `^13.30.0` |
 | Veröffentlichtes PHP-SDK 3.14 | Reines SDK PHP `^8.1`; die Laravel-Bridge benötigt PHP `^8.2` und für Laravel 13 PHP 8.3+ | `^12.69.0` oder `^13.30.0` |
 | PHP-SDK 3.9.5 | Reines SDK PHP `^8.1`; die Laravel-Bridge beachtet ebenfalls das Framework-Minimum | `^10.50.4`, `^11.56.1`, `^12.69.0` oder `^13.30.0` |
 
-Maßgeblich sind der [veröffentlichte eingebettete Upgrade-Vertrag](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+Die älteren Zeilen dokumentieren die Anforderungen ihrer benannten Versionen.
+
+Maßgeblich sind der [veröffentlichte eingebettete Upgrade-Vertrag](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 und die jeweilige `composer.json`. Das aktuelle eingebettete Release wurde mit
 Laravel 12/PHP 8.2–8.4 und Laravel 13/PHP 8.3–8.4 geprüft. Es entfernt PHP 8.1
 und Laravel 10/11. Die [historische stabile v1-Anleitung](/docs/1.x/installation/)
 und die [eigenen PHP-SDK-Anforderungen](https://php.durable-workflow.com/) bleiben getrennt.
 
+Workflow 2.28.1 ist ein reines Sicherheitsupdate, das die oben angegebenen
+Laravel-Mindestversionen anhebt. Laufzeit- und Schemadateien sind mit 2.28.0
+identisch, daher fügt ein Upgrade von 2.28.0 keine Datenbankmigration hinzu.
+Die [Verifikation des veröffentlichten Pakets und fünf Upgrade-/Rollback-Abläufe](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+qualifizieren dieses Paket.
+
 Aktualisieren Sie PHP und Laravel zuerst auf eine unterstützte Kombination.
 Solange das nicht möglich ist, hält `~2.20.5` Composer in der 2.20-Patchlinie,
 ohne unbefristete Wartung zu versprechen. `^2.0` kann eine spätere Minor-Version
@@ -131,7 +139,7 @@ Workflow 2.27 behält die Mindestanforderungen von 2.21 und das eingebettete Wor
 
 Siehe die [Versionshinweise zu 2.27.0](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-Workflow 2.28 behält die Mindestanforderungen von 2.21 und das eingebettete Worker-Protokoll `1.22` bei und fügt keine Datenbankmigration hinzu. Vor dem Upgrade zu prüfende Verhaltensänderung:
+Workflow 2.28.0 behält die Mindestanforderungen von 2.21 und das eingebettete Worker-Protokoll `1.22` bei und fügt keine Datenbankmigration hinzu. Vor dem Upgrade zu prüfende Verhaltensänderung:
 
 - Ab 2.28 bricht ein Lauf, der abgeschlossen wird, fehlschlägt oder mit Continue-as-new fortgesetzt wird, die Aktivitäten und Timer, auf die er nie gewartet hat, etwa `select()`-Verlierer, in derselben Transaktion ab, statt sie weiterlaufen zu lassen. Ein verspätetes Ergebnis einer solchen Aktivität wird mit `run_closed` abgelehnt. Braucht ein Workflow die Wirkung eines Verlierers, warten Sie vor der Rückgabe auf ihn. Siehe [Verlierer beim Schließen des Laufs](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/installation.md b/i18n/de/docusaurus-plugin-content-docs/current/installation.md
index da4987b3240..7c53471e9e9 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/installation.md
@@ -13,7 +13,7 @@ Wenn Sie zwischen der Einbettung des Pakets und dem eigenständigen Server wähl
 ## Voraussetzungen {#requirements}
 
 - PHP 8.2 oder neuer innerhalb der 8.x-Linie
-- Laravel 12.69 oder neuer in 12.x oder Laravel 13.30 oder neuer in 13.x
+- Laravel 12.72 oder neuer in 12.x oder Laravel 13.41 oder neuer in 13.x
 - PHP 8.3 oder neuer für Laravel 13
 
 Diese Anforderungen gelten für das aktuelle eingebettete Release. Wählen Sie vor
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 048c2eb81d6..46e498c22db 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -35,12 +35,12 @@ Für ein unmittelbares v1-Upgrade auf Paketebene halten Sie den ausführlichen [
 | Eingebettetes 2.0-Laravel | PHP-SDK-Dienstmodus | Die Anwendung soll die Orchestrierungslaufzeit nicht mehr verwalten oder benötigt eine gemeinsame/mehrsprachige Laufzeitgrenze. | Neue Starts nach Bereitschaft der Worker an die Dienstlaufzeit leiten. Eingebettete Läufe an ihrem Ursprungsort abschließen lassen oder für selbst gehosteten Server das explizite Importverfahren für geeignete eingebettete v2-Läufe verwenden. |
 
 Prüfen Sie vor der Zielwahl die [veröffentlichten Laravel-Supportlinien](./compatibility.md#laravel-support).
-Das aktuelle eingebettete Paket und ab PHP-SDK 3.10 auch die Laravel-Bridge des
-Dienstmodus benötigen beide Laravel 12.69 oder 13.30 und passendes PHP. Der
-reine Dienstmodus-Client behält PHP 8.1 bei. PHP-SDK 3.9.x behält seinen
-früheren Bridge-Vertrag für gepatchtes Laravel 10–13. Eine ältere v1-Anwendung
-benötigt möglicherweise ein Framework-Upgrade, bevor sie auf eine der beiden
-aktuellen Linien wechselt. Bewahren Sie dabei ihre v1-Laufzeit und offenen Läufe.
+Das aktuelle eingebettete Paket benötigt Laravel 12.72 oder 13.41 und passendes
+PHP. Die Laravel-Bridge im Dienstmodus folgt ihren [eigenen PHP-SDK-Anforderungen](./polyglot/php.md#requirements).
+Der reine Dienstmodus-Client behält PHP 8.1 bei. PHP-SDK 3.9.x behält seinen
+früheren Laravel-10–13-Bridge-Vertrag. Eine ältere v1-Anwendung benötigt
+möglicherweise ein Framework-Upgrade, bevor sie auf eine der beiden aktuellen
+Linien wechselt. Bewahren Sie dabei ihre v1-Laufzeit und offenen Läufe.
 
 ## Verantwortungsgrenzen vergleichen {#compare-the-ownership-boundary}
 
diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/de/source-hashes.json
+++ b/i18n/de/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
index c8ef7b1587b..b27c1ca21cf 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
@@ -100,17 +100,25 @@ El paquete integrado y el SDK de modo servicio tienen contratos distintos.
 
 | Línea del paquete | PHP | Laravel |
 | --- | --- | --- |
-| Workflow integrado 2.28 actual | PHP 8.2+ de 8.x; PHP 8.3+ para Laravel 13 | `^12.69.0` o `^13.30.0` |
+| Workflow integrado %%artifact.workflowVersion%% actual | PHP 8.2+ de 8.x; PHP 8.3+ para Laravel 13 | `^12.72.0` o `^13.41.0` |
 | Workflow integrado 2.20.5 | PHP `^8.1`, sujeto al mínimo del framework | `^10.50.4`, `^11.56.1`, `^12.69.0` o `^13.30.0` |
 | SDK PHP 3.14 publicado | SDK básico PHP `^8.1`; el puente Laravel necesita PHP `^8.2`, y PHP 8.3+ para Laravel 13 | `^12.69.0` o `^13.30.0` |
 | SDK PHP 3.9.5 | SDK básico PHP `^8.1`; el puente Laravel también exige el mínimo del framework | `^10.50.4`, `^11.56.1`, `^12.69.0` o `^13.30.0` |
 
-Las autoridades son el [contrato integrado publicado](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+Las filas anteriores registran los requisitos de sus versiones indicadas.
+
+Las autoridades son el [contrato integrado publicado](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 y el `composer.json` de cada versión. La versión integrada actual se verificó
 con Laravel 12/PHP 8.2–8.4 y Laravel 13/PHP 8.3–8.4. Retira PHP 8.1 y Laravel
 10/11. No cambia la [guía histórica de v1 estable](/docs/1.x/installation/)
 ni los [requisitos independientes del SDK PHP](https://php.durable-workflow.com/).
 
+Workflow 2.28.1 es un parche solo de seguridad que eleva los mínimos de
+Laravel indicados arriba. Los archivos de runtime y esquema son idénticos
+a los de 2.28.0, por lo que actualizar desde 2.28.0 no añade migraciones de
+base de datos. La [verificación del paquete publicado y cinco recorridos de actualización/reversión](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+validan este paquete.
+
 Actualiza primero PHP y Laravel a una combinación compatible. Si aún no puedes,
 `~2.20.5` mantiene Composer en los parches 2.20, sin prometer mantenimiento
 indefinido. `^2.0` puede seleccionar un minor posterior cuando la plataforma lo
@@ -164,7 +172,7 @@ Workflow 2.27 mantiene los mínimos de soporte de 2.21 y el protocolo de workers
 
 Consulte las [notas de la versión 2.27.0](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-Workflow 2.28 mantiene los mínimos de soporte de 2.21 y el protocolo de workers integrado `1.22`, y no añade ninguna migración de base de datos. Cambio de comportamiento que conviene revisar antes de actualizar:
+Workflow 2.28.0 mantiene los mínimos de soporte de 2.21 y el protocolo de workers integrado `1.22`, y no añade ninguna migración de base de datos. Cambio de comportamiento que conviene revisar antes de actualizar:
 
 - Desde 2.28, una ejecución que se completa, falla o continúa como nueva cancela en la misma transacción las actividades y los temporizadores que nunca esperó, como los perdedores de `select()`, en lugar de dejarlos en ejecución. Un resultado tardío de esa actividad se rechaza con `run_closed`. Si un workflow necesita el efecto de un perdedor, espérelo antes de retornar. Consulte [Perdedores cuando se cierra la ejecución](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/installation.md b/i18n/es/docusaurus-plugin-content-docs/current/installation.md
index 5f6492e8c69..41fb3739ed2 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/installation.md
@@ -20,7 +20,7 @@ Esta página describe la integración en Laravel.
 ## Requisitos {#requirements}
 
 - PHP 8.2 o posterior de la serie 8.x
-- Laravel 12.69 o posterior de 12.x, o Laravel 13.30 o posterior de 13.x
+- Laravel 12.72 o posterior de 12.x, o Laravel 13.41 o posterior de 13.x
 - PHP 8.3 o posterior para Laravel 13
 
 Estos requisitos corresponden a la versión integrada actual. Antes de actualizar
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 2e4ec0929fa..57d78ba5dc6 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -42,13 +42,14 @@ elegir aquí la política de transición.
 | Laravel 2.0 integrado | SDK PHP en modo servicio | La aplicación debe dejar de operar la orquestación o necesita un entorno compartido/políglota. | Dirige los nuevos inicios al servicio tras preparar sus workers. Drena las ejecuciones integradas en origen o usa la importación explícita de ejecuciones v2 elegibles a Server autogestionado. |
 
 Consulta las [líneas publicadas compatibles con Laravel](./compatibility.md#laravel-support)
-antes de elegir un destino. El paquete integrado actual y, desde el SDK PHP
-3.10, el puente Laravel de modo servicio requieren Laravel 12.69 o 13.30 y un
-PHP compatible. El cliente básico de modo servicio mantiene PHP 8.1. El SDK PHP
-3.9.x conserva su contrato anterior del puente para Laravel 10–13 con los
-parches mínimos. Una aplicación v1 antigua puede necesitar una actualización
-del framework antes de pasar a cualquiera de las dos líneas actuales. Conserva
-su runtime v1 y sus ejecuciones abiertas durante esa actualización.
+antes de elegir un destino. El paquete integrado actual requiere Laravel
+12.72 o 13.41 y un PHP compatible. El puente Laravel de modo servicio sigue
+sus [propios requisitos del SDK PHP](./polyglot/php.md#requirements). El cliente
+básico de modo servicio mantiene PHP 8.1. El SDK PHP 3.9.x conserva su contrato
+anterior del puente para Laravel 10–13. Una aplicación v1 antigua puede
+necesitar una actualización del framework antes de pasar a cualquiera de las
+dos líneas actuales. Conserva su runtime v1 y sus ejecuciones abiertas durante
+esa actualización.
 
 ## Compara los límites de responsabilidad {#compare-the-ownership-boundary}
 
diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/es/source-hashes.json
+++ b/i18n/es/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
index 9a611ff56fa..e81cd6d709b 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
@@ -96,17 +96,25 @@ embarqué et le SDK en mode service ont des contrats distincts.
 
 | Branche du paquet | PHP | Laravel |
 | --- | --- | --- |
-| Workflow embarqué 2.28 actuel | PHP 8.2+ en 8.x ; PHP 8.3+ pour Laravel 13 | `^12.69.0` ou `^13.30.0` |
+| Workflow embarqué %%artifact.workflowVersion%% actuel | PHP 8.2+ en 8.x ; PHP 8.3+ pour Laravel 13 | `^12.72.0` ou `^13.41.0` |
 | Workflow embarqué 2.20.5 | PHP `^8.1`, sous réserve du minimum du framework | `^10.50.4`, `^11.56.1`, `^12.69.0` ou `^13.30.0` |
 | SDK PHP 3.14 publié | SDK de base PHP `^8.1` ; le pont Laravel exige PHP `^8.2`, et PHP 8.3+ pour Laravel 13 | `^12.69.0` ou `^13.30.0` |
 | SDK PHP 3.9.5 | SDK de base PHP `^8.1` ; le pont Laravel suit aussi le minimum du framework | `^10.50.4`, `^11.56.1`, `^12.69.0` ou `^13.30.0` |
 
-Le [contrat embarqué publié](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+Les anciennes lignes indiquent les exigences des versions qu’elles nomment.
+
+Le [contrat embarqué publié](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 et le `composer.json` de chaque version font autorité. La version embarquée
 actuelle a été vérifiée sur Laravel 12/PHP 8.2–8.4 et Laravel 13/PHP 8.3–8.4.
 Elle retire PHP 8.1 et Laravel 10/11. Le [guide historique v1 stable](/docs/1.x/installation/)
 et les [exigences propres au SDK PHP](https://php.durable-workflow.com/) restent distincts.
 
+Workflow 2.28.1 est un correctif de sécurité uniquement, qui relève les
+versions minimales de Laravel indiquées ci-dessus. Les fichiers du runtime
+et du schéma sont identiques à ceux de 2.28.0. Une mise à niveau depuis
+2.28.0 n’ajoute donc aucune migration de base de données. La [vérification du paquet publié et cinq parcours de mise à niveau/retour arrière](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+confirment la validation de ce paquet.
+
 Mettez d'abord PHP et Laravel à niveau vers une combinaison compatible. Si cette
 migration n'est pas prête, `~2.20.5` maintient Composer sur les correctifs 2.20,
 sans promettre une maintenance indéfinie. `^2.0` peut sélectionner une version
@@ -160,7 +168,7 @@ Workflow 2.27 conserve les planchers de support de 2.21 et le protocole de worke
 
 Voir les [notes de version de 2.27.0](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-Workflow 2.28 conserve les planchers de support de 2.21 et le protocole de worker embarqué `1.22`, et n'ajoute aucune migration de base de données. Changement de comportement à vérifier avant la mise à niveau :
+Workflow 2.28.0 conserve les planchers de support de 2.21 et le protocole de worker embarqué `1.22`, et n'ajoute aucune migration de base de données. Changement de comportement à vérifier avant la mise à niveau :
 
 - Depuis 2.28, une exécution qui se termine, échoue ou continue dans une nouvelle exécution annule dans la même transaction les activités et minuteurs qu'elle n'a jamais attendus, comme les perdants de `select()`, au lieu de les laisser s'exécuter. Un résultat tardif d'une telle activité est refusé avec `run_closed`. Si un workflow a besoin de l'effet d'un perdant, attendez-le avant de retourner. Voir [Perdants à la clôture de l’exécution](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
index 515f4762bf9..85eee9aabc9 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
@@ -13,7 +13,7 @@ Si vous hésitez entre l’intégration du package et un Server indépendant, co
 ## Prérequis {#requirements}
 
 - PHP 8.2 ou ultérieur dans la série 8.x
-- Laravel 12.69 ou ultérieur dans la série 12.x, ou Laravel 13.30 ou ultérieur dans la série 13.x
+- Laravel 12.72 ou ultérieur dans la série 12.x, ou Laravel 13.41 ou ultérieur dans la série 13.x
 - PHP 8.3 ou ultérieur pour Laravel 13
 
 Ces exigences concernent la version embarquée actuelle. Avant de mettre à jour
diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 9b9e49e8399..c496b12829a 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -42,13 +42,14 @@ choisi ici votre politique de transition.
 | Laravel 2.0 embarqué | SDK PHP en mode service | L'application doit cesser de posséder le runtime d'orchestration ou nécessite un runtime partagé ou polyglotte. | Dirigez les nouveaux démarrages vers le service une fois ses workers prêts. Terminez les exécutions embarquées là où elles ont démarré, ou utilisez la procédure explicite d'import embarqué-v2 éligible pour Server auto-hébergé. |
 
 Consultez les [branches publiées compatibles avec Laravel](./compatibility.md#laravel-support)
-avant de choisir la destination. Le paquet embarqué actuel et, à partir du SDK
-PHP 3.10, le pont Laravel en mode service exigent tous deux Laravel 12.69 ou 13.30
-et une version PHP compatible. Le client de base en mode service conserve PHP 8.1.
-Le SDK PHP 3.9.x conserve son contrat de pont antérieur pour Laravel 10–13 avec
-les correctifs minimaux. Une ancienne application v1 peut nécessiter une mise à
-niveau du framework avant le passage à l'une ou l'autre des branches actuelles.
-Conservez son runtime v1 et ses exécutions ouvertes pendant cette mise à niveau.
+avant de choisir la destination. Le paquet embarqué actuel exige Laravel
+12.72 ou 13.41 et une version PHP compatible. Le pont Laravel en mode service
+suit les [exigences propres au SDK PHP](./polyglot/php.md#requirements). Le client
+de base en mode service conserve PHP 8.1. Le SDK PHP 3.9.x conserve son contrat
+de pont antérieur pour Laravel 10–13. Une ancienne application v1 peut nécessiter
+une mise à niveau du framework avant le passage à l’une ou l’autre des branches
+actuelles. Préservez son runtime v1 et ses exécutions ouvertes pendant cette
+mise à niveau.
 
 ## Comparer les responsabilités {#compare-the-ownership-boundary}
 
diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/fr/source-hashes.json
+++ b/i18n/fr/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
index e4a540a59e8..cce69fb495a 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
@@ -66,18 +66,26 @@ PHP と Laravel の要件を比較する前にパッケージのリリースを
 
 | パッケージ系列 | PHP | Laravel |
 | --- | --- | --- |
-| 現在の組み込み Workflow 2.28 | 8.x 系の PHP 8.2 以降。Laravel 13 は PHP 8.3 以降 | `^12.69.0` または `^13.30.0` |
+| 現在の組み込み Workflow %%artifact.workflowVersion%% | 8.x 系の PHP 8.2 以降。Laravel 13 は PHP 8.3 以降 | `^12.72.0` または `^13.41.0` |
 | 組み込み Workflow 2.20.5 | PHP `^8.1`。Laravel 自身の最低要件も適用 | `^10.50.4`、`^11.56.1`、`^12.69.0` または `^13.30.0` |
 | 公開済み PHP SDK 3.14 | 基本 SDK は PHP `^8.1`。Laravel ブリッジは PHP `^8.2` が必要で、Laravel 13 は PHP 8.3 以降 | `^12.69.0` または `^13.30.0` |
 | PHP SDK 3.9.5 | 基本 SDK は PHP `^8.1`。Laravel ブリッジはフレームワークの最低要件にも従う | `^10.50.4`、`^11.56.1`、`^12.69.0` または `^13.30.0` |
 
-[公開済み組み込みアップグレード契約](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+古い行は、それぞれに示したリリースの要件を記録しています。
+
+[公開済み組み込みアップグレード契約](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 と各リリースの `composer.json` がパッケージの根拠です。現在の組み込みリリースは
 Laravel 12/PHP 8.2～8.4 と Laravel 13/PHP 8.3～8.4 で検証されています。
 PHP 8.1 と Laravel 10/11 のサポートは終了しました。
 [従来の安定版 v1 ガイド](/docs/1.x/installation/)と
 [PHP SDK 独自の要件](https://php.durable-workflow.com/)は別に維持されます。
 
+Workflow 2.28.1 はセキュリティ修正のみのパッチで、上記の Laravel 最低バージョンを
+引き上げます。ランタイムとスキーマのファイルは 2.28.0 と同一のため、2.28.0 からの
+更新でデータベースマイグレーションは追加されません。
+[公開パッケージの検証と 5 つのアップグレード/ロールバック経路](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+が、このパッケージの検証根拠です。
+
 まず PHP と Laravel を対応する組み合わせへ更新してください。移行がまだできない場合、
 `~2.20.5` は Composer を 2.20 のパッチ系列内に保ちますが、無期限の保守を約束するものではありません。
 `^2.0` はプラットフォームが許可すれば後のマイナーを選ぶ場合があります。
@@ -127,7 +135,7 @@ Workflow 2.27 は 2.21 のサポート下限と組み込みワーカープロト
 
 [2.27.0 のリリースノート](https://github.com/durable-workflow/workflow/releases/tag/2.27.0)を参照してください。
 
-Workflow 2.28 は 2.21 のサポート下限と組み込みワーカープロトコル `1.22` を維持し、データベースマイグレーションは追加しません。アップグレード前に確認すべき動作の変更:
+Workflow 2.28.0 は 2.21 のサポート下限と組み込みワーカープロトコル `1.22` を維持し、データベースマイグレーションは追加しません。アップグレード前に確認すべき動作の変更:
 
 - 2.28 以降、完了、失敗、または continue-as-new する実行は、`select()` の敗者など一度も待たなかったアクティビティとタイマーを、実行し続けさせるのではなく同じトランザクション内でキャンセルします。そのようなアクティビティからの遅れた結果は `run_closed` で拒否されます。ワークフローが敗者の効果を必要とする場合は、戻る前にそれを待ってください。[実行が閉じるときの敗者](./features/concurrency.md#selection-losers-at-close)を参照してください。
 
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
index 25acfeb7dfb..1b61714dee0 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
@@ -13,7 +13,7 @@ sidebar_position: 3
 ## 必要な環境 {#requirements}
 
 - PHP 8.x 系の 8.2 以降
-- Laravel 12.x 系の 12.69 以降、または 13.x 系の 13.30 以降
+- Laravel 12.x 系の 12.72 以降、または 13.x 系の 13.41 以降
 - Laravel 13 では PHP 8.3 以降
 
 これは現在の組み込みリリースの要件です。古いアプリの Composer を更新する前に、
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 07672608c52..921587a6753 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -35,11 +35,12 @@ Laravel アプリケーションには、Durable Workflow 2.0 のファースト
 | 2.0 組み込み Laravel | PHP SDK サービスモード | アプリによるオーケストレーションランタイム所有をやめる、または共有・多言語ランタイムが必要。 | Worker 準備後、新規開始をサービスへ振り向ける。組み込み実行は開始元でドレインするか、セルフホスト Server 向けの適格な組み込み v2 の明示的インポートを使う。 |
 
 移行先を選ぶ前に、[公開済み Laravel 対応系列](./compatibility.md#laravel-support)を確認してください。
-現在の組み込みパッケージと、PHP SDK 3.10 以降のサービスモード Laravel ブリッジは、
-いずれも Laravel 12.69 または 13.30 と互換 PHP が必要です。基本のサービスモードクライアントは
-PHP 8.1 のサポートを維持します。PHP SDK 3.9.x は、必要なパッチを適用した Laravel 10～13 向けの
-従来のブリッジ契約を維持します。古い v1 アプリは、いずれかの現行系列へ移る前にフレームワーク更新が
-必要な場合があります。その更新中は v1 の実行環境と未完了の実行を保持してください。
+現在の組み込みパッケージには Laravel 12.72 または 13.41 と互換 PHP が必要です。
+サービスモードの Laravel ブリッジは [PHP SDK 独自の要件](./polyglot/php.md#requirements)に従います。
+基本のサービスモードクライアントは PHP 8.1 のサポートを維持します。PHP SDK 3.9.x は
+Laravel 10～13 向けの従来のブリッジ契約を維持します。古い v1 アプリは、いずれかの
+現行系列へ移る前にフレームワーク更新が必要な場合があります。その更新中は v1 の
+実行環境と未完了の実行を保持してください。
 
 ## 所有境界を比較する {#compare-the-ownership-boundary}
 
diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/ja/source-hashes.json
+++ b/i18n/ja/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md
index 9efa67c8afe..110d6c9f296 100644
--- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md
@@ -101,17 +101,25 @@ O pacote embutido e o SDK de modo de serviço têm contratos separados.
 
 | Linha do pacote | PHP | Laravel |
 | --- | --- | --- |
-| Workflow embutido 2.28 atual | PHP 8.2+ da linha 8.x; PHP 8.3+ para Laravel 13 | `^12.69.0` ou `^13.30.0` |
+| Workflow embutido %%artifact.workflowVersion%% atual | PHP 8.2+ da linha 8.x; PHP 8.3+ para Laravel 13 | `^12.72.0` ou `^13.41.0` |
 | Workflow embutido 2.20.5 | PHP `^8.1`, respeitando o mínimo do framework | `^10.50.4`, `^11.56.1`, `^12.69.0` ou `^13.30.0` |
 | SDK PHP 3.14 publicado | SDK básico PHP `^8.1`; a ponte Laravel exige PHP `^8.2`, e PHP 8.3+ para Laravel 13 | `^12.69.0` ou `^13.30.0` |
 | SDK PHP 3.9.5 | SDK básico PHP `^8.1`; a ponte Laravel também segue o mínimo do framework | `^10.50.4`, `^11.56.1`, `^12.69.0` ou `^13.30.0` |
 
-As autoridades são o [contrato embutido publicado](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+As linhas antigas registram os requisitos das versões nelas indicadas.
+
+As autoridades são o [contrato embutido publicado](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 e o `composer.json` de cada versão. A versão embutida atual foi verificada com
 Laravel 12/PHP 8.2–8.4 e Laravel 13/PHP 8.3–8.4. Ela remove suporte a PHP 8.1 e
 Laravel 10/11. Isso preserva o [guia histórico do v1 estável](/docs/1.x/installation/)
 e os [requisitos próprios do SDK PHP](https://php.durable-workflow.com/).
 
+Workflow 2.28.1 é um patch somente de segurança que eleva os mínimos de
+Laravel indicados acima. Os arquivos de runtime e esquema são idênticos aos
+de 2.28.0, portanto atualizar a partir de 2.28.0 não adiciona migrações de
+banco de dados. A [verificação do pacote publicado e cinco jornadas de atualização/rollback](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+qualificam este pacote.
+
 Atualize primeiro PHP e Laravel para uma combinação compatível. Enquanto essa
 migração não estiver pronta, `~2.20.5` mantém Composer nos patches 2.20, sem
 prometer manutenção indefinida. `^2.0` pode selecionar um minor posterior quando
@@ -164,7 +172,7 @@ O Workflow 2.27 mantém os pisos de suporte do 2.21 e o protocolo de workers emb
 
 Veja as [notas da versão 2.27.0](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-O Workflow 2.28 mantém os pisos de suporte do 2.21 e o protocolo de workers embutido `1.22`, e não adiciona migração de banco de dados. Mudança de comportamento para verificar antes de atualizar:
+O Workflow 2.28.0 mantém os pisos de suporte do 2.21 e o protocolo de workers embutido `1.22`, e não adiciona migração de banco de dados. Mudança de comportamento para verificar antes de atualizar:
 
 - A partir do 2.28, uma execução que é concluída, falha ou continua como nova cancela na mesma transação as atividades e timers que nunca aguardou, como os perdedores de `select()`, em vez de deixá-los em execução. Um resultado tardio dessa atividade é recusado com `run_closed`. Se um workflow precisa do efeito de um perdedor, aguarde-o antes de retornar. Veja [Perdedores quando a execução é encerrada](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md
index 872e7258a53..0ea4d6680e2 100644
--- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md
@@ -21,7 +21,7 @@ trata do Laravel integrado.
 ## Requisitos {#requirements}
 
 - PHP 8.2 ou superior na linha 8.x
-- Laravel 12.69 ou superior na linha 12.x, ou Laravel 13.30 ou superior na linha 13.x
+- Laravel 12.72 ou superior na linha 12.x, ou Laravel 13.41 ou superior na linha 13.x
 - PHP 8.3 ou superior para Laravel 13
 
 Estes requisitos se aplicam à versão embutida atual. Antes de atualizar Composer
diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 6e1b924a253..38712baf0d9 100644
--- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -42,13 +42,13 @@ depois de escolher a política de transição aqui.
 | Laravel 2.0 integrado | SDK PHP em modo de serviço | A aplicação deve deixar de ser responsável pelo runtime de orquestração ou precisa de uma fronteira de runtime compartilhada/entre linguagens. | Direcione novos inícios ao runtime de serviço depois que seus workers estiverem prontos. Deixe as execuções integradas terminarem onde começaram, ou use o procedimento explícito de importação de execuções elegíveis da v2 integrada para Server sob sua administração. |
 
 Confira as [linhas publicadas de suporte ao Laravel](./compatibility.md#laravel-support)
-antes de escolher o destino. O pacote embutido atual e, a partir do SDK PHP
-3.10, a ponte Laravel do modo de serviço exigem Laravel 12.69 ou 13.30 e PHP
-compatível. O cliente básico do modo de serviço continua aceitando PHP 8.1. O
-SDK PHP 3.9.x mantém seu contrato anterior da ponte Laravel 10–13 com os patches
-mínimos. Uma aplicação v1 antiga pode precisar atualizar o framework antes de
-migrar para qualquer uma das linhas atuais. Preserve seu runtime v1 e as
-execuções abertas durante essa atualização.
+antes de escolher o destino. O pacote embutido atual exige Laravel 12.72 ou
+13.41 e PHP compatível. A ponte Laravel do modo de serviço segue seus
+[próprios requisitos do SDK PHP](./polyglot/php.md#requirements). O cliente básico
+do modo de serviço continua aceitando PHP 8.1. O SDK PHP 3.9.x mantém seu contrato
+anterior da ponte Laravel 10–13. Uma aplicação v1 antiga pode precisar atualizar
+o framework antes de migrar para qualquer uma das linhas atuais. Preserve seu
+runtime v1 e as execuções abertas durante essa atualização.
 
 ## Compare a fronteira de responsabilidade {#compare-the-ownership-boundary}
 
diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/pt-BR/source-hashes.json
+++ b/i18n/pt-BR/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
index c50485808e0..777fbbc0fb7 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
@@ -98,17 +98,25 @@ OpenAPI, AsyncAPI чи JSON Schema. Schema
 
 | Лінійка пакета | PHP | Laravel |
 | --- | --- | --- |
-| Поточний вбудований Workflow 2.28 | PHP 8.2+ у 8.x; PHP 8.3+ для Laravel 13 | `^12.69.0` або `^13.30.0` |
+| Поточний вбудований Workflow %%artifact.workflowVersion%% | PHP 8.2+ у 8.x; PHP 8.3+ для Laravel 13 | `^12.72.0` або `^13.41.0` |
 | Вбудований Workflow 2.20.5 | PHP `^8.1` з урахуванням мінімуму фреймворку | `^10.50.4`, `^11.56.1`, `^12.69.0` або `^13.30.0` |
 | Опублікований PHP SDK 3.14 | Базовий SDK PHP `^8.1`; міст Laravel потребує PHP `^8.2`, а для Laravel 13 — PHP 8.3+ | `^12.69.0` або `^13.30.0` |
 | PHP SDK 3.9.5 | Базовий SDK PHP `^8.1`; міст Laravel також дотримується мінімуму фреймворку | `^10.50.4`, `^11.56.1`, `^12.69.0` або `^13.30.0` |
 
-Першоджерела пакета — [опублікований контракт вбудованого оновлення](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+Старіші рядки фіксують вимоги названих у них випусків.
+
+Першоджерела пакета — [опублікований контракт вбудованого оновлення](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 і `composer.json` кожного випуску. Поточний вбудований випуск перевірено з
 Laravel 12/PHP 8.2–8.4 та Laravel 13/PHP 8.3–8.4. Підтримку PHP 8.1 і Laravel
 10/11 вилучено. [Історичний посібник стабільної v1](/docs/1.x/installation/) та
 [окремі вимоги PHP SDK](https://php.durable-workflow.com/) залишаються окремими.
 
+Workflow 2.28.1 містить лише оновлення безпеки та підвищує наведені вище
+мінімальні версії Laravel. Файли середовища виконання та схеми ідентичні
+2.28.0, тому оновлення з 2.28.0 не додає міграцій бази даних.
+[Перевірка опублікованого пакета та п’ять сценаріїв оновлення/відкату](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+підтверджують перевірку цього пакета.
+
 Спочатку оновіть PHP і Laravel до підтримуваного поєднання. Якщо міграція ще не
 готова, `~2.20.5` залишає Composer на патч-лінійці 2.20, але не обіцяє безстрокової
 підтримки. `^2.0` може вибрати пізнішу мінорну версію, щойно платформа її дозволяє.
@@ -159,7 +167,7 @@ Workflow 2.27 зберігає мінімальні вимоги підтрим
 
 Див. [примітки до випуску 2.27.0](https://github.com/durable-workflow/workflow/releases/tag/2.27.0).
 
-Workflow 2.28 зберігає мінімальні вимоги підтримки з 2.21 і протокол вбудованого worker `1.22` та не додає міграцій бази даних. Зміна поведінки, яку варто перевірити перед оновленням:
+Workflow 2.28.0 зберігає мінімальні вимоги підтримки з 2.21 і протокол вбудованого worker `1.22` та не додає міграцій бази даних. Зміна поведінки, яку варто перевірити перед оновленням:
 
 - Починаючи з 2.28, запуск, який завершується, зазнає збою або виконує continue-as-new, скасовує в тій самій транзакції активності й таймери, на які він ніколи не чекав, наприклад учасників `select()`, що програли, замість того щоб залишати їх працювати. Запізнілий результат такої активності відхиляється з `run_closed`. Якщо workflow потрібен ефект учасника, що програв, дочекайтеся його до повернення. Див. [Учасники, що програли, під час закриття запуску](./features/concurrency.md#selection-losers-at-close).
 
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
index b0dedac9039..ed3740ce48c 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
@@ -21,7 +21,7 @@ sidebar_position: 3
 ## Вимоги {#requirements}
 
 - PHP 8.2 або новіший у лінійці 8.x
-- Laravel 12.69 або новіший у 12.x чи Laravel 13.30 або новіший у 13.x
+- Laravel 12.72 або новіший у 12.x чи Laravel 13.41 або новіший у 13.x
 - PHP 8.3 або новіший для Laravel 13
 
 Ці вимоги стосуються поточного вбудованого випуску. Перед оновленням Composer
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 0a96405fc4e..bae2a164fdf 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -42,13 +42,13 @@ Laravel-застосунки мають два офіційні режими Dur
 | Laravel embedded 2.0 | PHP SDK service mode | Застосунок має передати orchestration runtime або потребує спільної/polyglot межі runtime. | Спрямовуйте нові запуски до service runtime після готовності його workers. Завершіть embedded runs там, де вони почалися, або використайте явний import допустимих embedded-v2 runs для власного Server. |
 
 Перед вибором режиму перевірте [опубліковані лінійки підтримки Laravel](./compatibility.md#laravel-support).
-Поточний вбудований пакет і, починаючи з PHP SDK 3.10, міст Laravel сервісного
-режиму вимагають Laravel 12.69 або 13.30 та сумісного PHP. Базовий клієнт
-сервісного режиму зберігає підтримку PHP 8.1. PHP SDK 3.9.x зберігає свій
-попередній контракт мосту для Laravel 10–13 із мінімальними виправленнями.
-Старому застосунку v1 може знадобитися оновлення фреймворку перед переходом на
-будь-яку з поточних лінійок. Збережіть його середовище v1 та незавершені виконання
-під час цього оновлення.
+Поточний вбудований пакет вимагає Laravel 12.72 або 13.41 та сумісного PHP.
+Міст Laravel сервісного режиму дотримується [окремих вимог PHP SDK](./polyglot/php.md#requirements).
+Базовий клієнт сервісного режиму зберігає підтримку PHP 8.1. PHP SDK 3.9.x
+зберігає свій попередній контракт мосту для Laravel 10–13. Старому застосунку
+v1 може знадобитися оновлення фреймворку перед переходом на будь-яку з поточних
+лінійок. Збережіть його середовище v1 та незавершені виконання під час цього
+оновлення.
 
 ## Порівняння відповідальності {#compare-the-ownership-boundary}
 
diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/uk/source-hashes.json
+++ b/i18n/uk/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md
index 1a97713a9c7..48158ff16a8 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md
@@ -65,16 +65,23 @@ import protocolCatalog from '@site/static/platform-protocol-specs.json';
 
 | 包版本线 | PHP | Laravel |
 | --- | --- | --- |
-| 当前嵌入式 Workflow 2.28 | PHP 8.x 中的 8.2+；Laravel 13 需要 PHP 8.3+ | `^12.69.0` 或 `^13.30.0` |
+| 当前嵌入式 Workflow %%artifact.workflowVersion%% | PHP 8.x 中的 8.2+；Laravel 13 需要 PHP 8.3+ | `^12.72.0` 或 `^13.41.0` |
 | 嵌入式 Workflow 2.20.5 | PHP `^8.1`，并满足框架自身最低要求 | `^10.50.4`、`^11.56.1`、`^12.69.0` 或 `^13.30.0` |
 | 已发布 PHP SDK 3.14 | 基础 SDK 为 PHP `^8.1`；Laravel 桥接需要 PHP `^8.2`，Laravel 13 需要 PHP 8.3+ | `^12.69.0` 或 `^13.30.0` |
 | PHP SDK 3.9.5 | 基础 SDK 为 PHP `^8.1`；Laravel 桥接还需满足框架的 PHP 要求 | `^10.50.4`、`^11.56.1`、`^12.69.0` 或 `^13.30.0` |
 
-包的依据是[已发布的嵌入式升级契约](https://github.com/durable-workflow/workflow/blob/2.28.0/resources/laravel-embedded-upgrade-contract.json)
+较早的行记录了其中所列发行版的要求。
+
+包的依据是[已发布的嵌入式升级契约](https://github.com/durable-workflow/workflow/blob/2.28.1/resources/laravel-embedded-upgrade-contract.json)
 及各版本的 `composer.json`。当前嵌入式版本已验证 Laravel 12/PHP 8.2–8.4 与 Laravel 13/PHP 8.3–8.4，
 不再支持 PHP 8.1 和 Laravel 10/11。[历史稳定 v1 安装指南](/docs/1.x/installation/)与
 [PHP SDK 的独立要求](https://php.durable-workflow.com/)保持独立。
 
+Workflow 2.28.1 仅包含安全补丁，提升了上表中的 Laravel 最低版本要求。运行时和
+架构文件与 2.28.0 相同，因此从 2.28.0 升级不会新增数据库迁移。
+[已发布包验证及五条升级/回滚流程](https://github.com/durable-workflow/workflow/pull/1141#issuecomment-6871390667)
+验证了此包。
+
 先将 PHP 和 Laravel 升级到受支持的组合。若暂时无法迁移，`~2.20.5` 可将 Composer 保持在 2.20 补丁线，
 但不代表无限期维护。平台条件允许时，`^2.0` 可选中后续次要版本。
 保留未完成 v1 运行的原运行时，并按 [Laravel 采用指南](/docs/laravel-adoption)执行排空或共存。
@@ -118,7 +125,7 @@ Workflow 2.27 保持 2.21 的支持下限和嵌入式 worker 协议 `1.22`，不
 
 参见 [2.27.0 发布说明](https://github.com/durable-workflow/workflow/releases/tag/2.27.0)。
 
-Workflow 2.28 保持 2.21 的支持下限和嵌入式 worker 协议 `1.22`，不新增数据库迁移。升级前需要检查的行为变更：
+Workflow 2.28.0 保持 2.21 的支持下限和嵌入式 worker 协议 `1.22`，不新增数据库迁移。升级前需要检查的行为变更：
 
 - 从 2.28 起，完成、失败或 continue-as-new 的运行会在同一事务中取消它从未等待的活动和计时器（例如 `select()` 的落选成员），而不是让它们继续运行。此类活动的迟到结果会以 `run_closed` 被拒绝。如果工作流需要某个落选成员的效果，请在返回之前等待它。参见[运行关闭时的落选成员](./features/concurrency.md#selection-losers-at-close)。
 
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
index 99af4de1e1e..2b64d00c1cb 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
@@ -13,7 +13,7 @@ sidebar_position: 3
 ## 环境要求 {#requirements}
 
 - PHP 8.x 系列中的 8.2 或更高版本
-- Laravel 12.x 中的 12.69 或更高版本，或 13.x 中的 13.30 或更高版本
+- Laravel 12.x 中的 12.72 或更高版本，或 13.x 中的 13.41 或更高版本
 - Laravel 13 需要 PHP 8.3 或更高版本
 
 这些要求适用于当前嵌入式版本。更新旧应用的 Composer 依赖前，请先选择
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md
index 2234cb7625a..3f763634656 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -35,10 +35,10 @@ Laravel 应用有两个第一方 Durable Workflow 2.0 目标。嵌入模式让
 | 2.0 嵌入式 Laravel | PHP SDK 服务模式 | 应用应不再拥有编排运行时，或需要共享/多语言运行时边界。 | 服务 Worker 就绪后，将新启动路由到服务运行时。嵌入运行实例在原处排空，或对自托管 Server 使用明确的符合条件的嵌入 v2 导入流程。 |
 
 选择目标前，请查看[已发布的 Laravel 支持范围](./compatibility.md#laravel-support)。
-当前嵌入式包，以及从 PHP SDK 3.10 起的服务模式 Laravel 桥接，均需要 Laravel 12.69 或 13.30 以及兼容的 PHP。
-基础服务模式客户端仍支持 PHP 8.1。PHP SDK 3.9.x 保留其此前支持满足最低补丁要求的 Laravel 10 至 13 的桥接契约。
-旧版 v1 应用可能需要先升级框架才能迁移到任一当前版本线。
-升级期间须保留原 v1 运行时及其未完成的运行。
+当前嵌入式包需要 Laravel 12.72 或 13.41 以及兼容的 PHP。服务模式 Laravel 桥接遵循
+[PHP SDK 的独立要求](./polyglot/php.md#requirements)。基础服务模式客户端仍支持 PHP 8.1。
+PHP SDK 3.9.x 保留其此前的 Laravel 10 至 13 桥接契约。旧版 v1 应用可能需要先升级框架
+才能迁移到任一当前版本线。升级期间须保留原 v1 运行时及其未完成的运行。
 
 ## 比较归属边界 {#compare-the-ownership-boundary}
 
diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json
index a6ad7cb1019..8f81228c72e 100644
--- a/i18n/zh-Hans/source-hashes.json
+++ b/i18n/zh-Hans/source-hashes.json
@@ -4,7 +4,7 @@
   "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d",
   "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3",
   "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc",
-  "compatibility.md": "9e6e155c6e42ec224a625b5e172c0b314cb77992371bd93bb73d6cc9495aef5f",
+  "compatibility.md": "2846972d7644f88bece616bc7e4b3b2a53a2e3e1a348c7d525f7dd76ea9dea88",
   "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78",
   "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9",
   "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a",
@@ -58,9 +58,9 @@
   "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8",
   "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c",
   "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb",
-  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
+  "installation.md": "895d390a17a71f4846223c4637ed1e70adf1221ba99d6b422ce1a5480c2f167b",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "be0890619736ee2362ee96b6b1f5f397f10fb58cb845448ac15b437ac3062b36",
+  "laravel-adoption.md": "8974d4906658a0727a185ba3d53bf03e8e33494cd63d84def0b9ae62fcc7507e",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "346b8a5207b7d69cea63dc9bfec95bf1911d3038a9d30ad06939b13130079279",