From 3317feed5cee01275a8952a1b33a9fd3c2df1575 Mon Sep 17 00:00:00 2001
From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com>
Date: Sat, 7 Nov 2026 13:15:18 +0000
Subject: [PATCH 1/2] docs: align Laravel guidance with published Workflow 2.21

---
 docs/compatibility.md                         | 26 +++++++++++++++++++
 docs/installation.md                          | 15 +++++++----
 docs/laravel-adoption.md                      | 11 +++++---
 .../current/compatibility.md                  | 25 ++++++++++++++++++
 .../current/installation.md                   | 13 +++++++---
 .../current/laravel-adoption.md               |  9 +++++--
 .../current/compatibility.md                  | 24 +++++++++++++++++
 .../current/installation.md                   | 16 +++++++-----
 .../current/laravel-adoption.md               | 11 +++++---
 .../current/compatibility.md                  | 25 ++++++++++++++++++
 .../current/installation.md                   | 13 +++++++---
 .../current/laravel-adoption.md               | 11 +++++---
 .../current/compatibility.md                  | 25 ++++++++++++++++++
 .../current/installation.md                   | 12 ++++++---
 .../current/laravel-adoption.md               |  8 ++++--
 .../current/compatibility.md                  | 24 +++++++++++++++++
 .../current/installation.md                   | 15 +++++++----
 .../current/laravel-adoption.md               | 11 +++++---
 .../current/compatibility.md                  | 24 +++++++++++++++++
 .../current/installation.md                   | 15 +++++++----
 .../current/laravel-adoption.md               | 11 +++++---
 .../current/compatibility.md                  | 20 ++++++++++++++
 .../current/installation.md                   | 11 +++++---
 .../current/laravel-adoption.md               |  8 ++++--
 static/stable-releases.json                   |  4 +--
 25 files changed, 326 insertions(+), 61 deletions(-)

diff --git a/docs/compatibility.md b/docs/compatibility.md
index 8abee51ff86..c2bfafcfd36 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -92,6 +92,32 @@ directly to a public OpenAPI, AsyncAPI, or JSON Schema document. The
 schema pins the discovery surface every other catalog entry can be
 reached from.
 
+## Published Laravel support {#laravel-support}
+
+Select the package release before comparing PHP and Laravel requirements.
+The embedded package and the service-mode SDK have separate support contracts.
+
+| Package line | PHP | Laravel |
+| --- | --- | --- |
+| Current embedded Workflow 2.21 | PHP 8.2+ in 8.x; PHP 8.3+ for Laravel 13 | `^12.69.0` or `^13.30.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.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.21.0/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/).
+
+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
+`^2.0` constraint can select a later minor once the platform permits it.
+Preserve the original runtime for open v1 runs, and follow the
+[Laravel adoption guide](/docs/laravel-adoption) for drain or coexistence.
+Changing a Composer requirement does not migrate durable history.
+
 ## Stability Levels
 
 Every public surface in Durable Workflow carries exactly one of these
diff --git a/docs/installation.md b/docs/installation.md
index 0c17d5ff700..2b9b4796dc3 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -19,8 +19,13 @@ the embedded Laravel path.
 
 ## Requirements
 
-- PHP 8.1 or later
-- Laravel 9 or later
+- 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
+- PHP 8.3 or later for Laravel 13
+
+These requirements apply to the current embedded release. For an older
+application, choose the appropriate [published support line](./compatibility.md#laravel-support)
+before updating Composer. The bare service-mode PHP SDK has its own requirements.
 
 Check [Database Compatibility](./polyglot/database-support.md) for the embedded
 and Server declarations, exact tested configurations and qualification limits.
@@ -44,9 +49,9 @@ Durable Workflow is installable via Composer:
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Use `durable-workflow/workflow:^2.0` when you want Composer to accept compatible
-2.x updates automatically. See [Version Compatibility](/docs/compatibility)
-for runtime and package compatibility rules.
+Composer pins the published embedded release above. Review the
+[Laravel support and upgrade boundary](./compatibility.md#laravel-support)
+before widening that constraint or upgrading an older Laravel application.
 
 The package auto-loads its migrations, so a normal migrate run is enough after install:
 
diff --git a/docs/laravel-adoption.md b/docs/laravel-adoption.md
index 035c76dd3fa..d1286befa6e 100644
--- a/docs/laravel-adoption.md
+++ b/docs/laravel-adoption.md
@@ -41,9 +41,12 @@ choosing the transition policy here.
 | Stable v1 Laravel | PHP SDK service mode | Laravel should keep dependency injection, configuration, Artisan, logging, events, and test fakes, but Cloud or Server should own durable state. | Install `durable-workflow/sdk` as a separate service client/worker boundary. v1 history and durable Laravel queue jobs stay on the v1 runtime until terminal. |
 | 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. |
 
-The PHP SDK bridge and the embedded package support Laravel 9 through 13 on
-their compatible PHP versions. A supported v1 application can therefore choose
-either destination without an unrelated Laravel upgrade.
+Check the [published Laravel support lines](./compatibility.md#laravel-support)
+before choosing a destination. The current embedded package requires Laravel
+12.69 or 13.30 and compatible PHP. The published PHP SDK 3.9.5 still supports
+patched Laravel 10–13; its bare service-mode client keeps PHP 8.1 support.
+An older v1 application may need a framework upgrade before moving to the
+current embedded line. Preserve its v1 runtime and open runs during that upgrade.
 
 ## Compare the ownership boundary
 
@@ -328,7 +331,7 @@ the published PHP SDK artifact authority, not copied from a point release:
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9 through 13 auto-discover the provider. Publish the package
+Supported Laravel versions auto-discover the provider. Publish the package
 configuration and list the attributed handler classes:
 
 <!-- docs-example id="laravel.adoption.service.config" -->
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
index 9d6f5158238..0aec467565f 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md
@@ -59,6 +59,31 @@ Jedes `surface_family` eines Katalogeintrags muss im obigen Vertrag existieren.
 
 Jeder erforderliche Plattform-Protokollkatalogeintrag ist als `published` markiert. Der Eintrag für den aufrufbaren Träger bleibt `in_progress`. Jeder verfügbare Eintrag verlinkt direkt ein öffentliches OpenAPI-, AsyncAPI- oder JSON-Schema-Dokument. Das Schema [`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes) legt die Ermittlungsschnittstelle fest, von der aus alle anderen Katalogeinträge erreichbar sind.
 
+## Veröffentlichter Laravel-Support {#laravel-support}
+
+Wählen Sie das Paketrelease vor dem Vergleich der PHP- und Laravel-Anforderungen.
+Das eingebettete Paket und das Service-Modus-SDK haben eigene Supportverträge.
+
+| Paketlinie | PHP | Laravel |
+| --- | --- | --- |
+| Aktuelles eingebettetes Workflow 2.21 | PHP 8.2+ in 8.x; PHP 8.3+ für Laravel 13 | `^12.69.0` oder `^13.30.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.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.21.0/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.
+
+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
+wählen, sobald die Plattform sie zulässt. Bewahren Sie die ursprüngliche
+Laufzeit offener v1-Läufe und folgen Sie der [Adoptionsanleitung](/docs/laravel-adoption)
+für Drain oder Koexistenz. Eine geänderte Composer-Anforderung migriert keinen
+dauerhaften Verlauf.
+
 ## Stabilitätsstufen {#stability-levels}
 
 Jede öffentliche Durable-Workflow-Schnittstelle trägt genau eine dieser Stabilitätsstufen. Die Stufen sind explizit: Eine nicht klassifizierte Schnittstelle ist nicht öffentlich.
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/installation.md b/i18n/de/docusaurus-plugin-content-docs/current/installation.md
index 77575b1ce38..da4987b3240 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/installation.md
@@ -12,8 +12,13 @@ Wenn Sie zwischen der Einbettung des Pakets und dem eigenständigen Server wähl
 
 ## Voraussetzungen {#requirements}
 
-- PHP 8.1 oder neuer
-- Laravel 9 oder neuer
+- 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
+- PHP 8.3 oder neuer für Laravel 13
+
+Diese Anforderungen gelten für das aktuelle eingebettete Release. Wählen Sie vor
+einem Composer-Update einer älteren Anwendung die [passende veröffentlichte Linie](./compatibility.md#laravel-support).
+Das reine PHP-SDK im Service-Modus hat eigene Anforderungen.
 
 Prüfen Sie die [Datenbankkompatibilität](./polyglot/database-support.md) für eingebettete und Server-Deklarationen, genaue Testkonfigurationen und Qualifikationsgrenzen.
 
@@ -36,7 +41,9 @@ Installieren Sie Durable Workflow mit Composer:
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Verwenden Sie `durable-workflow/workflow:^2.0`, damit Composer kompatible 2.x-Updates automatisch zulässt. Die [Versionskompatibilität](/docs/compatibility) beschreibt die Regeln für Laufzeitumgebung und Pakete.
+Der obige Befehl bindet das veröffentlichte eingebettete Release. Prüfen Sie
+die [Laravel-Support- und Upgrade-Grenze](./compatibility.md#laravel-support),
+bevor Sie die Einschränkung erweitern oder eine ältere Anwendung aktualisieren.
 
 Das Paket lädt seine Migrationen automatisch. Nach der Installation reicht daher ein normaler Migrationslauf:
 
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 a88413fc9cd..52622ea4128 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -34,7 +34,12 @@ Für ein unmittelbares v1-Upgrade auf Paketebene halten Sie den ausführlichen [
 | Stabiles v1-Laravel | PHP-SDK-Dienstmodus | Laravel soll Dependency Injection, Konfiguration, Artisan, Logging, Ereignisse und Test-Fakes behalten, Cloud oder Server aber den dauerhaften Zustand verwalten. | `durable-workflow/sdk` als separate Dienstclient-/Worker-Grenze installieren. v1-Historie und dauerhafte Laravel-Warteschlangenjobs bleiben bis zum terminalen Zustand auf der v1-Laufzeit. |
 | 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. |
 
-Die PHP-SDK-Bridge und das eingebettete Paket unterstützen Laravel 9 bis 13 mit ihren kompatiblen PHP-Versionen. Eine unterstützte v1-Anwendung kann daher beide Ziele ohne sachfremdes Laravel-Upgrade wählen.
+Prüfen Sie vor der Zielwahl die [veröffentlichten Laravel-Supportlinien](./compatibility.md#laravel-support).
+Das aktuelle eingebettete Paket benötigt Laravel 12.69 oder 13.30 und passendes
+PHP. Das veröffentlichte PHP-SDK 3.9.5 unterstützt weiterhin gepatchtes Laravel
+10–13; der reine Client behält PHP 8.1 bei. Eine ältere v1-Anwendung benötigt
+möglicherweise zuerst ein Framework-Upgrade. Bewahren Sie dabei ihre
+v1-Laufzeit und offenen Läufe.
 
 ## Verantwortungsgrenzen vergleichen {#compare-the-ownership-boundary}
 
@@ -294,7 +299,7 @@ Installieren Sie das unabhängig veröffentlichte SDK-Paket. Dieser Befehl wird
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9 bis 13 erkennt den Provider automatisch. Veröffentlichen Sie die Paketkonfiguration und listen Sie die mit Attributen versehenen Handlerklassen auf:
+Unterstützte Laravel-Versionen erkennen den Provider automatisch. Veröffentlichen Sie die Paketkonfiguration und listen Sie die mit Attributen versehenen Handlerklassen auf:
 
 <!-- docs-example id="laravel.adoption.service.config" -->
 ```php
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
index 4b88061bc87..317ccdbe230 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md
@@ -93,6 +93,30 @@ directamente un documento público OpenAPI, AsyncAPI o JSON Schema. El esquema
 [`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes)
 fija la interfaz de descubrimiento desde la que se alcanza el resto del catálogo.
 
+## Compatibilidad de Laravel publicada {#laravel-support}
+
+Elige la versión del paquete antes de comparar los requisitos de PHP y Laravel.
+El paquete integrado y el SDK de modo servicio tienen contratos distintos.
+
+| Línea del paquete | PHP | Laravel |
+| --- | --- | --- |
+| Workflow integrado 2.21 actual | PHP 8.2+ de 8.x; PHP 8.3+ para Laravel 13 | `^12.69.0` o `^13.30.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.9.5 publicado | 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.21.0/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/).
+
+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
+permita. Conserva el runtime original de las ejecuciones v1 abiertas y sigue la
+[guía de adopción](/docs/laravel-adoption) para drenar o coexistir. Cambiar la
+restricción Composer no migra el historial durable.
+
 ## Niveles de estabilidad {#stability-levels}
 
 Cada interfaz pública tiene exactamente uno de estos niveles de estabilidad.
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/installation.md b/i18n/es/docusaurus-plugin-content-docs/current/installation.md
index 189260f4c8e..5f6492e8c69 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/installation.md
@@ -19,8 +19,13 @@ Esta página describe la integración en Laravel.
 
 ## Requisitos {#requirements}
 
-- PHP 8.1 o posterior
-- Laravel 9 o posterior
+- 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
+- PHP 8.3 o posterior para Laravel 13
+
+Estos requisitos corresponden a la versión integrada actual. Antes de actualizar
+Composer en una aplicación antigua, elige la [línea publicada compatible](./compatibility.md#laravel-support).
+El SDK PHP básico de modo servicio tiene requisitos independientes.
 
 Consulte [Compatibilidad de bases de datos](./polyglot/database-support.md) para las declaraciones de modo embebido y Server, configuraciones exactas probadas y límites de cualificación.
 
@@ -45,10 +50,9 @@ Instala Durable Workflow con Composer:
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Usa `durable-workflow/workflow:^2.0` para que Composer pueda instalar
-actualizaciones compatibles de la serie 2.x. Consulta
-[Compatibilidad de versiones](/docs/compatibility) para conocer las reglas
-de compatibilidad entre el runtime y los paquetes.
+El comando anterior fija la versión integrada publicada. Revisa el
+[límite de compatibilidad y actualización de Laravel](./compatibility.md#laravel-support)
+antes de ampliar la restricción o actualizar una aplicación Laravel antigua.
 
 El paquete carga sus migraciones automáticamente. Después de instalarlo,
 basta con ejecutar las migraciones habituales:
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 697c2560cb5..6adb44e4e75 100644
--- a/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -41,9 +41,12 @@ elegir aquí la política de transición.
 | Laravel v1 estable | SDK PHP en modo servicio | Laravel debe conservar inyección de dependencias, configuración, Artisan, registros, eventos y simulaciones de prueba, pero Cloud o Server deben poseer el estado duradero. | Instala `durable-workflow/sdk` como límite separado de cliente/worker. El historial v1 y los trabajos duraderos de colas Laravel permanecen en v1 hasta terminar. |
 | 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. |
 
-El puente del SDK PHP y el paquete integrado admiten Laravel 9 a 13 con sus
-versiones PHP compatibles. Una aplicación v1 admitida puede elegir cualquiera
-de los destinos sin una actualización de Laravel ajena a esta transición.
+Consulta las [líneas publicadas compatibles con Laravel](./compatibility.md#laravel-support)
+antes de elegir un destino. El paquete integrado actual requiere Laravel 12.69 o
+13.30 y un PHP compatible. El SDK PHP 3.9.5 publicado conserva el soporte para
+Laravel 10–13 con los parches mínimos; el cliente básico mantiene PHP 8.1.
+Una aplicación v1 antigua puede necesitar una actualización del framework antes
+de pasar a la línea integrada actual. Conserva su runtime v1 y sus ejecuciones abiertas.
 
 ## Compara los límites de responsabilidad {#compare-the-ownership-boundary}
 
@@ -327,7 +330,7 @@ autoridad del artefacto SDK PHP publicado, sin copiar una versión puntual:
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9 a 13 descubre automáticamente el proveedor. Publica la configuración y
+Las versiones compatibles de Laravel descubren automáticamente el proveedor. Publica la configuración y
 enumera las clases de manejadores con atributos:
 
 <!-- docs-example id="laravel.adoption.service.config" -->
diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
index c55b4551b76..de6d0dee6d2 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md
@@ -89,6 +89,31 @@ renvoie directement à un document public OpenAPI, AsyncAPI ou JSON Schema. Le
 schéma [`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes)
 fixe l'interface de découverte depuis laquelle toutes les autres entrées sont accessibles.
 
+## Compatibilité Laravel publiée {#laravel-support}
+
+Choisissez la version du paquet avant de comparer PHP et Laravel. Le paquet
+embarqué et le SDK en mode service ont des contrats distincts.
+
+| Branche du paquet | PHP | Laravel |
+| --- | --- | --- |
+| Workflow embarqué 2.21 actuel | PHP 8.2+ en 8.x ; PHP 8.3+ pour Laravel 13 | `^12.69.0` ou `^13.30.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.9.5 publié | 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.21.0/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.
+
+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
+mineure ultérieure si la plateforme le permet. Conservez le runtime d'origine
+pour les exécutions v1 ouvertes et suivez le [guide d'adoption](/docs/laravel-adoption)
+pour la vidange ou la coexistence. Modifier une contrainte Composer ne migre
+pas l'historique durable.
+
 ## Niveaux de stabilité {#stability-levels}
 
 Chaque interface publique Durable Workflow porte exactement un de ces niveaux.
diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
index 05f970de35f..515f4762bf9 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md
@@ -12,8 +12,13 @@ Si vous hésitez entre l’intégration du package et un Server indépendant, co
 
 ## Prérequis {#requirements}
 
-- PHP 8.1 ou ultérieur
-- Laravel 9 ou ultérieur
+- 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
+- PHP 8.3 ou ultérieur pour Laravel 13
+
+Ces exigences concernent la version embarquée actuelle. Avant de mettre à jour
+Composer dans une ancienne application, choisissez la [branche publiée compatible](./compatibility.md#laravel-support).
+Le SDK PHP de base en mode service a ses propres exigences.
 
 Consultez la [compatibilité des bases de données](./polyglot/database-support.md) pour les déclarations embarquées et Server, configurations exactes testées et limites de qualification.
 
@@ -36,7 +41,9 @@ Installez le package avec Composer :
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Utilisez `durable-workflow/workflow:^2.0` pour que Composer accepte automatiquement les mises à jour 2.x compatibles. La [compatibilité des versions](/docs/compatibility) précise les règles pour les packages et les runtimes.
+La commande ci-dessus fixe la version embarquée publiée. Consultez les
+[limites de compatibilité et de mise à niveau Laravel](./compatibility.md#laravel-support)
+avant d'élargir la contrainte ou de mettre à niveau une ancienne application.
 
 Le package charge automatiquement ses migrations. Après l’installation, exécutez les migrations habituelles :
 
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 e12469a27e7..62a6708013a 100644
--- a/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -41,9 +41,12 @@ choisi ici votre politique de transition.
 | Laravel v1 stable | SDK PHP en mode service | Laravel doit conserver injection de dépendances, configuration, Artisan, journaux, événements et simulations de test, mais Cloud ou Server doit posséder l'état durable. | Installez `durable-workflow/sdk` comme frontière distincte de client/worker de service. L'historique v1 et les jobs Laravel durables restent sur le runtime v1 jusqu'à leur état terminal. |
 | 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é. |
 
-Le pont du SDK PHP et le paquet embarqué prennent en charge Laravel 9 à 13 sur
-leurs versions PHP compatibles. Une application v1 prise en charge peut donc
-choisir l'une ou l'autre sans mise à niveau Laravel sans rapport avec la transition.
+Consultez les [branches publiées compatibles avec Laravel](./compatibility.md#laravel-support)
+avant de choisir la destination. Le paquet embarqué actuel exige Laravel 12.69
+ou 13.30 et une version PHP compatible. Le SDK PHP 3.9.5 publié conserve Laravel
+10–13 avec les correctifs minimaux ; son client de base conserve PHP 8.1.
+Une ancienne application v1 peut nécessiter une mise à niveau du framework avant
+le passage à la branche embarquée actuelle. Conservez son runtime v1 et ses exécutions ouvertes.
 
 ## Comparer les responsabilités {#compare-the-ownership-boundary}
 
@@ -330,7 +333,7 @@ partir de la référence d'artefacts SDK PHP publiée, sans recopier une version
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9 à 13 découvrent automatiquement le fournisseur. Publiez la
+Les versions compatibles de Laravel découvrent automatiquement le fournisseur. Publiez la
 configuration et listez les classes de gestionnaire munies d'attributs :
 
 <!-- docs-example id="laravel.adoption.service.config" -->
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
index 6a815a87f0e..9aa178105b5 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md
@@ -59,6 +59,31 @@ SDK、Server マニフェスト、CI ゲートが一つの正しい情報源に
 
 必須の全プラットフォームプロトコルカタログエントリは `published` です。呼び出し可能キャリアのエントリは `in_progress` のままです。利用可能な各エントリは、公開 OpenAPI、AsyncAPI、JSON Schema ドキュメントへ直接リンクします。[`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes) スキーマは、他の全エントリに到達できる検出インターフェースを固定します。
 
+## 公開済み Laravel サポート {#laravel-support}
+
+PHP と Laravel の要件を比較する前にパッケージのリリースを選びます。
+組み込みパッケージとサービスモード SDK のサポート契約は別です。
+
+| パッケージ系列 | PHP | Laravel |
+| --- | --- | --- |
+| 現在の組み込み Workflow 2.21 | 8.x 系の PHP 8.2 以降。Laravel 13 は PHP 8.3 以降 | `^12.69.0` または `^13.30.0` |
+| 組み込み Workflow 2.20.5 | PHP `^8.1`。Laravel 自身の最低要件も適用 | `^10.50.4`、`^11.56.1`、`^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.21.0/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/)は別に維持されます。
+
+まず PHP と Laravel を対応する組み合わせへ更新してください。移行がまだできない場合、
+`~2.20.5` は Composer を 2.20 のパッチ系列内に保ちますが、無期限の保守を約束するものではありません。
+`^2.0` はプラットフォームが許可すれば後のマイナーを選ぶ場合があります。
+未完了 v1 実行の元のランタイムを保持し、ドレインまたは共存の手順は
+[Laravel 導入ガイド](/docs/laravel-adoption)に従ってください。
+Composer 制約の変更で永続履歴は移行されません。
+
 ## 安定性レベル {#stability-levels}
 
 Durable Workflow の各公開インターフェースは、次の安定性レベルを厳密に一つ持ちます。分類は明示的です。未分類のインターフェースは公開ではありません。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
index db543dda877..25acfeb7dfb 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md
@@ -12,8 +12,13 @@ sidebar_position: 3
 
 ## 必要な環境 {#requirements}
 
-- PHP 8.1 以降
-- Laravel 9 以降
+- PHP 8.x 系の 8.2 以降
+- Laravel 12.x 系の 12.69 以降、または 13.x 系の 13.30 以降
+- Laravel 13 では PHP 8.3 以降
+
+これは現在の組み込みリリースの要件です。古いアプリの Composer を更新する前に、
+[公開済みの対応リリース系列](./compatibility.md#laravel-support)を選んでください。
+サービスモードの基本 PHP SDK には別の要件があります。
 
 組み込みと Server の宣言、正確なテスト構成、検証の限界は[データベースの互換性](./polyglot/database-support.md)を確認してください。
 
@@ -36,7 +41,8 @@ Composer でインストールします。
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-互換性のある 2.x 更新を Composer で自動的に受け入れたい場合は、`durable-workflow/workflow:^2.0` を使います。ランタイムとパッケージの互換ルールは[バージョン互換性](/docs/compatibility)を参照してください。
+上のコマンドは公開済みの組み込みリリースを固定します。制約を広げたり古いアプリを更新したりする前に、
+[Laravel のサポートと更新の境界](./compatibility.md#laravel-support)を確認してください。
 
 パッケージはマイグレーションを自動読み込みするため、インストール後は通常のマイグレーションを実行します。
 
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 9a015ce7d88..83b310a7bc2 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -34,7 +34,11 @@ Laravel アプリケーションには、Durable Workflow 2.0 のファースト
 | 安定版 v1 Laravel | PHP SDK サービスモード | Laravel の依存注入、設定、Artisan、ログ、イベント、テスト fake を維持し、永続状態は Cloud・Server が所有する。 | `durable-workflow/sdk` を別のサービスクライアント・Worker 境界として追加。v1 履歴と永続 Laravel キュージョブは終端まで v1 に残す。 |
 | 2.0 組み込み Laravel | PHP SDK サービスモード | アプリによるオーケストレーションランタイム所有をやめる、または共有・多言語ランタイムが必要。 | Worker 準備後、新規開始をサービスへ振り向ける。組み込み実行は開始元でドレインするか、セルフホスト Server 向けの適格な組み込み v2 の明示的インポートを使う。 |
 
-PHP SDK ブリッジと組み込みパッケージは、互換 PHP バージョン上の Laravel 9～13 をサポートします。サポート対象 v1 アプリは、無関係な Laravel 更新なしでどちらも選べます。
+移行先を選ぶ前に、[公開済み Laravel 対応系列](./compatibility.md#laravel-support)を確認してください。
+現在の組み込みパッケージには Laravel 12.69 または 13.30 と互換 PHP が必要です。
+公開済み PHP SDK 3.9.5 は必要なパッチを適用した Laravel 10～13 に引き続き対応し、
+基本クライアントは PHP 8.1 を維持します。古い v1 アプリは、現在の組み込み系列へ
+移る前にフレームワーク更新が必要な場合があります。v1 の実行環境と未完了の実行を保持してください。
 
 ## 所有境界を比較する {#compare-the-ownership-boundary}
 
@@ -294,7 +298,7 @@ WorkflowStub::assertDispatched(
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9～13 は provider を自動検出します。設定を公開し、属性付きハンドラークラスを列挙します。
+対応する Laravel バージョンは provider を自動検出します。設定を公開し、属性付きハンドラークラスを列挙します。
 
 <!-- docs-example id="laravel.adoption.service.config" -->
 ```php
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 b56df05c2c1..1bbe7ecfa15 100644
--- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md
@@ -94,6 +94,30 @@ AsyncAPI ou JSON Schema. O esquema
 fixa a interface de descoberta a partir da qual todas as outras entradas do
 catálogo podem ser alcançadas.
 
+## Suporte publicado ao Laravel {#laravel-support}
+
+Escolha a versão do pacote antes de comparar os requisitos de PHP e Laravel.
+O pacote embutido e o SDK de modo de serviço têm contratos separados.
+
+| Linha do pacote | PHP | Laravel |
+| --- | --- | --- |
+| Workflow embutido 2.21 atual | PHP 8.2+ da linha 8.x; PHP 8.3+ para Laravel 13 | `^12.69.0` ou `^13.30.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.9.5 publicado | 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.21.0/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/).
+
+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
+a plataforma permitir. Preserve o runtime original das execuções v1 abertas e
+siga o [guia de adoção](/docs/laravel-adoption) para drenagem ou coexistência.
+Alterar a restrição Composer não migra o histórico durável.
+
 ## Níveis de estabilidade {#stability-levels}
 
 Cada interface pública do Durable Workflow tem exatamente um destes níveis.
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 ef5f3b4b138..872e7258a53 100644
--- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md
@@ -20,8 +20,13 @@ trata do Laravel integrado.
 
 ## Requisitos {#requirements}
 
-- PHP 8.1 ou superior
-- Laravel 9 ou superior
+- 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
+- PHP 8.3 ou superior para Laravel 13
+
+Estes requisitos se aplicam à versão embutida atual. Antes de atualizar Composer
+em uma aplicação antiga, escolha a [linha publicada compatível](./compatibility.md#laravel-support).
+O SDK PHP básico do modo de serviço tem requisitos próprios.
 
 Confira [Compatibilidade de bancos de dados](./polyglot/database-support.md) para declarações do modo embutido e Server, configurações exatas testadas e limites de qualificação.
 
@@ -47,9 +52,9 @@ Instale o pacote pelo Composer:
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Use `durable-workflow/workflow:^2.0` para aceitar automaticamente atualizações
-compatíveis de 2.x. Consulte [Compatibilidade de versões](/docs/compatibility)
-para conhecer as regras do ambiente e dos pacotes.
+O comando acima fixa a versão embutida publicada. Confira o
+[limite de suporte e atualização do Laravel](./compatibility.md#laravel-support)
+antes de ampliar a restrição ou atualizar uma aplicação Laravel antiga.
 
 O pacote carrega suas migrations automaticamente. Após a instalação, basta
 executar a migração normal:
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 c598977bdf3..6fd403d4ab1 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
@@ -41,9 +41,12 @@ depois de escolher a política de transição aqui.
 | Laravel v1 estável | SDK PHP em modo de serviço | O Laravel deve manter injeção de dependências, configuração, Artisan, logs, eventos e fakes de teste, mas o Cloud ou Server deve ser responsável pelo estado durável. | Instale `durable-workflow/sdk` como uma fronteira separada de cliente/worker de serviço. O histórico v1 e os jobs duráveis das filas Laravel permanecem no runtime v1 até atingirem estado terminal. |
 | 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. |
 
-A ponte Laravel do SDK PHP e o pacote integrado suportam Laravel 9 a 13 nas
-versões compatíveis de PHP. Assim, uma aplicação v1 suportada pode escolher
-qualquer um dos destinos sem uma atualização não relacionada do Laravel.
+Confira as [linhas publicadas de suporte ao Laravel](./compatibility.md#laravel-support)
+antes de escolher o destino. O pacote embutido atual exige Laravel 12.69 ou 13.30
+e PHP compatível. O SDK PHP 3.9.5 publicado mantém suporte ao Laravel 10–13 com
+os patches mínimos; o cliente básico continua aceitando PHP 8.1. Uma aplicação
+v1 antiga pode precisar atualizar o framework antes de migrar para a linha
+embutida atual. Preserve seu runtime v1 e as execuções abertas.
 
 ## Compare a fronteira de responsabilidade {#compare-the-ownership-boundary}
 
@@ -331,7 +334,7 @@ copiado de uma release específica:
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-O Laravel 9 a 13 descobre o provider automaticamente. Publique a configuração
+As versões compatíveis do Laravel descobrem o provider automaticamente. Publique a configuração
 do pacote e liste as classes de handlers com atributos:
 
 <!-- docs-example id="laravel.adoption.service.config" -->
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
index 441cf5de288..023588afcc2 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md
@@ -91,6 +91,30 @@ OpenAPI, AsyncAPI чи JSON Schema. Schema
 [`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes)
 закріплює discovery-поверхню, через яку доступні всі інші записи каталогу.
 
+## Опублікована підтримка Laravel {#laravel-support}
+
+Виберіть випуск пакета перед порівнянням вимог PHP і Laravel.
+Вбудований пакет і SDK сервісного режиму мають окремі контракти підтримки.
+
+| Лінійка пакета | PHP | Laravel |
+| --- | --- | --- |
+| Поточний вбудований Workflow 2.21 | PHP 8.2+ у 8.x; PHP 8.3+ для Laravel 13 | `^12.69.0` або `^13.30.0` |
+| Вбудований Workflow 2.20.5 | PHP `^8.1` з урахуванням мінімуму фреймворку | `^10.50.4`, `^11.56.1`, `^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.21.0/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/) залишаються окремими.
+
+Спочатку оновіть PHP і Laravel до підтримуваного поєднання. Якщо міграція ще не
+готова, `~2.20.5` залишає Composer на патч-лінійці 2.20, але не обіцяє безстрокової
+підтримки. `^2.0` може вибрати пізнішу мінорну версію, щойно платформа її дозволяє.
+Збережіть початкове середовище незавершених виконань v1 та дотримуйтеся
+[посібника переходу](/docs/laravel-adoption) для завершення чи співіснування.
+Зміна обмеження Composer не переносить довговічну історію.
+
 ## Рівні стабільності {#stability-levels}
 
 Кожна публічна поверхня Durable Workflow має рівно один із цих рівнів
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
index 61f13996a3a..b0dedac9039 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md
@@ -20,8 +20,13 @@ sidebar_position: 3
 
 ## Вимоги {#requirements}
 
-- PHP 8.1 або новіший
-- Laravel 9 або новіший
+- PHP 8.2 або новіший у лінійці 8.x
+- Laravel 12.69 або новіший у 12.x чи Laravel 13.30 або новіший у 13.x
+- PHP 8.3 або новіший для Laravel 13
+
+Ці вимоги стосуються поточного вбудованого випуску. Перед оновленням Composer
+у старому застосунку виберіть [сумісну опубліковану лінійку](./compatibility.md#laravel-support).
+Базовий PHP SDK сервісного режиму має окремі вимоги.
 
 Дивіться [сумісність баз даних](./polyglot/database-support.md): заяви вбудованого режиму та Server, точні перевірені конфігурації й межі кваліфікації.
 
@@ -46,9 +51,9 @@ Durable Workflow можна встановити через Composer:
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-Використовуйте `durable-workflow/workflow:^2.0`, щоб Composer автоматично
-приймав сумісні оновлення 2.x. Правила сумісності середовища виконання та
-пакетів описано в [сумісності версій](/docs/compatibility).
+Команда вище фіксує опублікований вбудований випуск. Перед розширенням
+обмеження чи оновленням старого застосунку Laravel перевірте
+[межі підтримки й оновлення Laravel](./compatibility.md#laravel-support).
 
 Пакет автоматично завантажує свої міграції. Після встановлення достатньо
 звичайного запуску міграцій:
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 72cdb853701..6330d294fd8 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md
@@ -41,9 +41,12 @@ Laravel-застосунки мають два офіційні режими Dur
 | Стабільний Laravel v1 | PHP SDK service mode | Laravel має зберігати dependency injection, конфігурацію, Artisan, логування, events і test fakes, а Cloud чи Server — відповідати за durable-стан. | Установіть `durable-workflow/sdk` як окрему межу service client/worker. Історія v1 та durable Laravel queue jobs залишаються на runtime v1 до термінального стану. |
 | Laravel embedded 2.0 | PHP SDK service mode | Застосунок має передати orchestration runtime або потребує спільної/polyglot межі runtime. | Спрямовуйте нові запуски до service runtime після готовності його workers. Завершіть embedded runs там, де вони почалися, або використайте явний import допустимих embedded-v2 runs для власного Server. |
 
-PHP SDK bridge та embedded-пакет підтримують Laravel 9–13
-на сумісних версіях PHP. Тому підтримуваний застосунок v1 може
-вибрати будь-який кінцевий режим без окремого оновлення Laravel.
+Перед вибором режиму перевірте [опубліковані лінійки підтримки Laravel](./compatibility.md#laravel-support).
+Поточний вбудований пакет вимагає Laravel 12.69 або 13.30 та сумісного PHP.
+Опублікований PHP SDK 3.9.5 і далі підтримує Laravel 10–13 із мінімальними
+виправленнями; базовий клієнт зберігає PHP 8.1. Старому застосунку v1 може
+знадобитися оновлення фреймворку перед переходом на поточну вбудовану лінійку.
+Збережіть його середовище v1 та незавершені виконання.
 
 ## Порівняння відповідальності {#compare-the-ownership-boundary}
 
@@ -335,7 +338,7 @@ WorkflowStub::assertDispatched(
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9–13 автоматично знаходять provider.
+Підтримувані версії Laravel автоматично знаходять provider.
 Опублікуйте конфігурацію пакета та перелічіть класи обробників з атрибутами:
 
 <!-- docs-example id="laravel.adoption.service.config" -->
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 db25d250cec..82ed373c350 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md
@@ -59,6 +59,26 @@ import protocolCatalog from '@site/static/platform-protocol-specs.json';
 
 每个必需的平台协议目录条目都标记为 `published`；可调用载体条目仍是 `in_progress`。每个可用条目直接链接公开 OpenAPI、AsyncAPI 或 JSON Schema 文档。[`cluster_info_envelope`](/docs/platform-protocol-specs#cluster-info-envelope-notes) schema 固定了发现接口，其他所有目录条目均可从中到达。
 
+## 已发布的 Laravel 支持范围 {#laravel-support}
+
+先选择包版本，再比较 PHP 和 Laravel 要求。嵌入式包与服务模式 SDK 有独立的支持契约。
+
+| 包版本线 | PHP | Laravel |
+| --- | --- | --- |
+| 当前嵌入式 Workflow 2.21 | PHP 8.x 中的 8.2+；Laravel 13 需要 PHP 8.3+ | `^12.69.0` 或 `^13.30.0` |
+| 嵌入式 Workflow 2.20.5 | PHP `^8.1`，并满足框架自身最低要求 | `^10.50.4`、`^11.56.1`、`^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.21.0/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/)保持独立。
+
+先将 PHP 和 Laravel 升级到受支持的组合。若暂时无法迁移，`~2.20.5` 可将 Composer 保持在 2.20 补丁线，
+但不代表无限期维护。平台条件允许时，`^2.0` 可选中后续次要版本。
+保留未完成 v1 运行的原运行时，并按 [Laravel 采用指南](/docs/laravel-adoption)执行排空或共存。
+修改 Composer 约束不会迁移持久历史。
+
 ## 稳定性级别 {#stability-levels}
 
 Durable Workflow 中每个公开接口恰好具有以下一个稳定性级别。级别必须明确；未分类的接口不是公开接口。
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 5f6b1a6fded..99af4de1e1e 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md
@@ -12,8 +12,12 @@ sidebar_position: 3
 
 ## 环境要求 {#requirements}
 
-- PHP 8.1 或更高版本
-- Laravel 9 或更高版本
+- PHP 8.x 系列中的 8.2 或更高版本
+- Laravel 12.x 中的 12.69 或更高版本，或 13.x 中的 13.30 或更高版本
+- Laravel 13 需要 PHP 8.3 或更高版本
+
+这些要求适用于当前嵌入式版本。更新旧应用的 Composer 依赖前，请先选择
+[已发布的兼容版本线](./compatibility.md#laravel-support)。服务模式的基础 PHP SDK 有独立要求。
 
 参阅[数据库兼容性](./polyglot/database-support.md)，了解嵌入式与 Server 声明、确切测试配置及验证边界。
 
@@ -36,7 +40,8 @@ Durable Workflow 支持 Laravel 的各类队列驱动，**不支持 `sync`**，
 composer require %%artifact.workflowComposerPackage%%
 ```
 
-如果希望 Composer 自动接受兼容的 2.x 更新，可以使用 `durable-workflow/workflow:^2.0`。[版本兼容性](/docs/compatibility)说明运行时和包的兼容规则。
+上述命令固定已发布的嵌入式版本。放宽约束或升级旧 Laravel 应用之前，
+请查看 [Laravel 支持与升级边界](./compatibility.md#laravel-support)。
 
 包会自动加载数据库迁移，安装后运行常规迁移命令即可：
 
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 6fdf957e3bd..dba40b5798f 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
@@ -34,7 +34,11 @@ Laravel 应用有两个第一方 Durable Workflow 2.0 目标。嵌入模式让
 | 稳定 v1 Laravel | PHP SDK 服务模式 | Laravel 应保留依赖注入、配置、Artisan、日志、事件和测试 fake，但由 Cloud 或 Server 拥有持久状态。 | 安装 `durable-workflow/sdk` 作为独立服务客户端/Worker 边界。v1 历史和持久 Laravel 队列 job 留在 v1 运行时，直到进入终态。 |
 | 2.0 嵌入式 Laravel | PHP SDK 服务模式 | 应用应不再拥有编排运行时，或需要共享/多语言运行时边界。 | 服务 Worker 就绪后，将新启动路由到服务运行时。嵌入运行实例在原处排空，或对自托管 Server 使用明确的符合条件的嵌入 v2 导入流程。 |
 
-PHP SDK 桥接和嵌入软件包在各自兼容的 PHP 版本上支持 Laravel 9 至 13。因此，受支持的 v1 应用无需进行无关的 Laravel 升级即可选择任一目标。
+选择目标前，请查看[已发布的 Laravel 支持范围](./compatibility.md#laravel-support)。
+当前嵌入式包需要 Laravel 12.69 或 13.30 以及兼容的 PHP。
+已发布的 PHP SDK 3.9.5 仍支持满足最低补丁要求的 Laravel 10 至 13，基础客户端仍支持 PHP 8.1。
+旧版 v1 应用可能需要先升级框架才能迁移到当前嵌入式版本线。
+升级期间须保留原 v1 运行时及其未完成的运行。
 
 ## 比较归属边界 {#compare-the-ownership-boundary}
 
@@ -294,7 +298,7 @@ WorkflowStub::assertDispatched(
 composer require %%artifact.publishedPhpSdkComposerPackage%%
 ```
 
-Laravel 9 至 13 自动发现 provider。发布软件包配置，并列出带属性标记的处理器类：
+受支持的 Laravel 版本会自动发现 provider。发布软件包配置，并列出带属性标记的处理器类：
 
 <!-- docs-example id="laravel.adoption.service.config" -->
 ```php
diff --git a/static/stable-releases.json b/static/stable-releases.json
index ea799f57a89..1495e42dcf5 100644
--- a/static/stable-releases.json
+++ b/static/stable-releases.json
@@ -1,7 +1,7 @@
 {
   "schema": "durable-workflow.docs.stable-releases",
   "schema_version": 1,
-  "updated_at": "2026-11-04",
+  "updated_at": "2026-11-07",
   "artifacts": {
     "cli": "2.3.6",
     "helm-chart": "1.0.3",
@@ -10,7 +10,7 @@
     "sdk-rust": "4.12.0",
     "server": "3.0.5",
     "waterline": "2.14.0",
-    "workflow": "2.20.3"
+    "workflow": "2.21.0"
   },
   "helm_chart": {
     "app_version": "3.0.5",

From a2e4da2af258d2ba619d4ca107693c52a0f2040b Mon Sep 17 00:00:00 2001
From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com>
Date: Sat, 7 Nov 2026 13:18:47 +0000
Subject: [PATCH 2/2] docs: refresh translated source review hashes

---
 i18n/de/source-hashes.json      | 6 +++---
 i18n/es/source-hashes.json      | 6 +++---
 i18n/fr/source-hashes.json      | 6 +++---
 i18n/ja/source-hashes.json      | 6 +++---
 i18n/pt-BR/source-hashes.json   | 6 +++---
 i18n/uk/source-hashes.json      | 6 +++---
 i18n/zh-Hans/source-hashes.json | 6 +++---
 7 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",
diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json
index 8f4abd62c77..590401d8cd3 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": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6",
+  "compatibility.md": "3b2b45cbc9f1d614d19cb1ed876b7f63ee73506845951b4658b70febe62df1cc",
   "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": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931",
+  "installation.md": "f69b98de4e10ba5ab892203b0418e4ed77e3edf3ac84cc46d9cf4694ee47ada9",
   "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3",
-  "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8",
+  "laravel-adoption.md": "b78962f1a895d03120e4221a6709c43993be3acf3b6e7a8b6b38e4feea5dad6c",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b",
   "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a",