Skip to content
Merged
2 changes: 1 addition & 1 deletion docs/failures-and-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@ Workflow releases before 2.18.0 accept a narrower set of runs. Every step before

Releases before 2.19.0 ignore `reused_recorded_at` on reused signal, memo and search-attribute steps. After a Workflow 2.19.0 or later successor reuses those steps, keep 2.19.0 or later workers, or confirm that no such history can replay, before you roll back. In embedded mode, Workflow 2.19.0 replays, imports and resumes a 2.20.0 successor that reused an update or a chained signal wait the same way 2.20.0 does ([qualification receipt](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)).

From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`, so workflow time after them matches the failed run. A 3.8.0 Server refuses to redrive a run whose workflow code upserted a memo or search attribute (`service_redrive_history_not_qualified`) or whose side effect result is stored externally (`external_side_effect_result_not_supported`). Otherwise it still applies the rules from before 2.18.0, so a fired timer is still refused with `unsupported_history`. Native Server support for the remaining rules is tracked in [server#980](https://github.com/durable-workflow/server/issues/980).
From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). Native 3.11.0 accepts a completed plain timer before the failed activity and writes fallback clocks at the full millisecond precision the server stores ([native fired-timer redrive](./polyglot/server-api-reference.md#native-redrive-timers)). Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980).

## Service Entry Refusal and Recovery {#service-entry-recovery}

Expand Down
23 changes: 23 additions & 0 deletions docs/polyglot/server-api-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -501,6 +501,29 @@ encode them for you. A direct HTTP caller must use the official Avro encoder's
`{codec, blob}` envelope or the runtime external reference below. The surrounding
HTTP document is JSON; raw business JSON is not an alternative payload codec.

### Native fired-timer redrive and replay clocks {#native-redrive-timers}

:::note Available from native Server 3.11.0

Native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) accepts the completed plain timers and writes the replay clocks described in this section. Earlier native releases refuse fired timers with `unsupported_history`.

:::

For an otherwise eligible run that failed at an activity, the new source accepts a completed plain timer before that failure. Its unique step must contain exactly one ordered `TimerScheduled` / `TimerFired` pair with matching source `timer_id`. The successor writes the pair with one fresh shared timer ID, creates no timer row or timer task, and resumes at the failed activity without waiting for that timer again. Source history stays unchanged.

The reused `TimerFired` names the immediate predecessor in `reused_from_run_id`. Its `reused_recorded_at` retains the original timer event time across repeated redrives. Reused activities and markers also retain full available fractional precision when a fallback clock is first written. The initial replay anchor comes from the persisted source run start and is carried in `replayed_started_at`; consumed steps use their event-time authority. Repeated redrives preserve already-recorded clock strings and the existing initial anchor. Fractions omitted by an older producer cannot be reconstructed. Deadline formatting is unchanged.

| Refusal | Timer boundary retained by the new source |
| --- | --- |
| `unsupported_timer` | A scope, parallel-group, cancellation-cleanup, condition or signal-timeout timer is outside the plain-timer slice. |
| `incomplete_timer_step` | A timer step has a missing event, reversed or duplicate events, or absent/non-string/mismatched source timer IDs. |

Cancelled timers remain `unsupported_history`. Step collisions, gaps and invalid failure boundaries keep their existing explicit refusals. Definition/fingerprint, parent/local-activity, external-payload and workflow-code-upsert limits still apply. Signals, updates and child workflows gain no native redrive support from this slice. Describe and redrive share structural eligibility; the existing worker-fingerprint comparison still applies when redrive is requested.

The [actual PHP/Python/Rust cold-worker cohort](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) must retain the same workflow definition/fingerprint through cold replacement and repeated redrive. It compares parsed full-precision UTC instants against an observed nonzero-fraction source `TimerFired`, preserves source history, and checks original callback counts, fresh timer identity and absence of repeated timer work. Whole-second rendering cannot establish that precision result, and installed history must not be rewritten to supply it. Source-controlled timestamp tests are separate evidence.

Installed published-SDK cold-worker receipts passed against native Server 3.11.0 for Rust SDK 4.18.0, Python SDK 2.17.2 and PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). The server stores these clocks at millisecond precision. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged.

## Namespace And Storage

Namespace routes require operator or admin roles. Mutating namespace and
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ Workflow-Releases vor 2.18.0 nehmen weniger Läufe an. Jeder Schritt vor der feh

Releases vor 2.19.0 ignorieren `reused_recorded_at` bei wiederverwendeten Signal-, Memo- und Suchattribut-Schritten. Nachdem ein Nachfolger aus Workflow 2.19.0 oder später diese Schritte wiederverwendet hat, behalten Sie Worker ab 2.19.0 bei oder stellen Sie vor einem Rollback sicher, dass keine solche Historie per Replay verarbeitet werden kann. Im Embedded-Modus verarbeitet Workflow 2.19.0 einen 2.20.0-Nachfolger, der ein Update oder eine verkettete Signalwarteoperation wiederverwendet hat, beim Replay, Import und Fortsetzen genauso wie 2.20.0 ([Qualifizierungsnachweis](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)).

Ab 3.7.0 übernimmt Redrive im nativen Server beim Start gesetzte Memos und Suchattribute auf den Nachfolger, und `describe()` meldet `can_redrive` und `redrive_blocked_reason` unter `actions`. Ab 3.8.0 verwendet er außerdem Seiteneffekte und Versionsmarker vor dem fehlgeschlagenen Schritt wieder und zeichnet jeden davon mit seinem ursprünglichen Payload, `reused_from_run_id` und `reused_recorded_at` auf, sodass die Workflow-Zeit nach diesen Schritten der des fehlgeschlagenen Laufs entspricht. Ein Server 3.8.0 lehnt den Redrive eines Laufs ab, dessen Workflow-Code ein Memo oder Suchattribut per Upsert gesetzt hat (`service_redrive_history_not_qualified`) oder dessen Seiteneffekt-Ergebnis extern gespeichert ist (`external_side_effect_result_not_supported`). Ansonsten wendet er weiterhin die Regeln von vor 2.18.0 an, daher wird ein ausgelöster Timer weiterhin mit `unsupported_history` abgelehnt. Die Unterstützung der übrigen Regeln im nativen Server wird in [server#980](https://github.com/durable-workflow/server/issues/980) verfolgt.
Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Native 3.11.0 akzeptiert einen abgeschlossenen einfachen Timer vor der fehlgeschlagenen Activity und schreibt Fallback-Uhren mit der vollen Millisekundenpräzision, die der Server speichert ([natives Redrive ausgelöster Timer](./polyglot/server-api-reference.md#native-redrive-timers)). Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst.

## Ablehnung am Einstieg im Servicemodus und Wiederherstellung {#service-entry-recovery}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -485,6 +485,29 @@ Laufbezogene Befehlsrouten lehnen historische oder falsche Laufziele explizit ab

Befehle übertragen Geschäftswerte in Avro-Envelopes. Die offiziellen SDKs codieren sie automatisch. Direkte HTTP-Clients müssen den `{codec, blob}`-Envelope des offiziellen Avro-Encoders oder die unten beschriebene Runtime-Referenz verwenden. Das äußere HTTP-Dokument ist JSON; uncodiertes Geschäfts-JSON ist kein alternativer Nutzlast-Codec.

### Native Redrive ausgelöster Timer und Replay-Uhren {#native-redrive-timers}

:::note Verfügbar ab nativem Server 3.11.0

Nativer Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) akzeptiert die abgeschlossenen einfachen Timer und schreibt die in diesem Abschnitt beschriebenen Replay-Uhren. Frühere native Releases verweigern ausgelöste Timer mit `unsupported_history`.

:::

Für einen sonst geeigneten Lauf, der bei einer Activity scheiterte, akzeptiert der neue Quellstand einen davor abgeschlossenen einfachen Timer. Dessen eindeutiger Schritt muss genau ein geordnetes Paar `TimerScheduled` / `TimerFired` mit übereinstimmender Quell-`timer_id` enthalten. Der Nachfolger schreibt das Paar mit einer neuen gemeinsamen Timer-ID, erzeugt weder Timer-Zeile noch Timer-Task und setzt an der gescheiterten Activity fort, ohne erneut auf den Timer zu warten. Die Quellhistorie bleibt unverändert.

Das wiederverwendete `TimerFired` nennt den unmittelbaren Vorgänger in `reused_from_run_id`. Sein `reused_recorded_at` erhält die ursprüngliche Timer-Ereigniszeit über wiederholte Redrives. Wiederverwendete Activities und Marker erhalten bei der ersten Fallback-Uhrschreibung ebenfalls die volle verfügbare Bruchteilpräzision. Der anfängliche Replay-Anker stammt aus dem gespeicherten Start des Quelllaufs und wird in `replayed_started_at` weitergegeben; konsumierte Schritte verwenden ihre Ereigniszeit als Autorität. Wiederholte Redrives erhalten vorhandene Uhrstrings und den bestehenden Anfangsanker. Von älteren Producern ausgelassene Bruchteile lassen sich nicht rekonstruieren. Die Deadline-Formatierung bleibt unverändert.

| Ablehnung | Vom neuen Quellstand bewahrte Timer-Grenze |
| --- | --- |
| `unsupported_timer` | Ein Scope-, Parallelgruppen-, Cancellation-Cleanup-, Condition- oder Signal-Timeout-Timer liegt außerhalb des Plain-Timer-Umfangs. |
| `incomplete_timer_step` | Einem Timer-Schritt fehlt ein Ereignis, Ereignisse sind vertauscht oder doppelt, oder Quell-Timer-IDs fehlen, sind keine Strings oder stimmen nicht überein. |

Abgebrochene Timer bleiben `unsupported_history`. Schritt-Kollisionen, Lücken und ungültige Fehlergrenzen behalten ihre expliziten Ablehnungen. Definition/Fingerprint-, Eltern-/Local-Activity-, externe Payload- und Workflow-Code-Upsert-Grenzen gelten weiter. Signals, Updates und Child-Workflows erhalten durch diesen Teil keine native Redrive-Unterstützung. Describe und Redrive teilen strukturelle Eignung; beim Redrive gilt weiterhin der Worker-Fingerprint-Vergleich.

Die [tatsächliche PHP/Python/Rust-Cold-Worker-Kohorte](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) muss bei kaltem Austausch und wiederholtem Redrive dieselbe Workflow-Definition und denselben Fingerprint erhalten. Sie vergleicht vollständig geparste UTC-Zeitpunkte mit einem beobachteten Quell-`TimerFired` mit nichtnull Sekundenbruchteil, erhält die Quellhistorie und prüft ursprüngliche Callback-Zahlen, neue Timer-Identität und ausbleibende erneute Timer-Arbeit. Eine Ganzsekundendarstellung belegt diese Präzision nicht; installierte Historie darf dafür nicht umgeschrieben werden. Quelltests mit kontrollierten Zeitstempeln sind separate Evidenz.

Installierte Cold-Worker-Belege veröffentlichter SDKs sind gegen nativen Server 3.11.0 für Rust SDK 4.18.0, Python SDK 2.17.2 und PHP SDK 3.18.3 bestanden ([Server #980](https://github.com/durable-workflow/server/issues/980)). Der Server speichert diese Uhren mit Millisekundenpräzision. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert.

## Namespace und Speicher {#namespace-and-storage}

Namespace-Routen benötigen Operator- oder Admin-Rollen. Ändernde Namespace-
Expand Down
4 changes: 2 additions & 2 deletions i18n/de/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
"defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529",
"defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c",
"deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb",
"failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c",
"failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e",
"features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082",
"features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b",
"features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb",
Expand Down Expand Up @@ -88,7 +88,7 @@
"polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71",
"polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3",
"polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314",
"polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee",
"polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2",
"polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429",
"polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2",
"polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -265,7 +265,7 @@ Las versiones de Workflow anteriores a 2.18.0 aceptan menos ejecuciones. Cada pa

Las versiones anteriores a 2.19.0 ignoran `reused_recorded_at` en los pasos reutilizados de señal, memo y atributo de búsqueda. Después de que un sucesor de Workflow 2.19.0 o posterior reutilice esos pasos, mantenga workers de 2.19.0 o posteriores, o confirme que ningún historial así puede reproducirse, antes de volver atrás. En modo embebido, Workflow 2.19.0 reproduce, importa y reanuda un sucesor de 2.20.0 que reutilizó un update o una espera de señal encadenada igual que 2.20.0 ([comprobante de calificación](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)).

Desde 3.7.0, el redrive en el Server nativo traslada a la sucesora los memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` dentro de `actions`. Desde 3.8.0 también reutiliza los efectos secundarios y los marcadores de versión anteriores al paso fallido, y registra cada uno con su carga útil original, `reused_from_run_id` y `reused_recorded_at`, así que la hora del workflow después de ellos coincide con la de la ejecución fallida. Un Server 3.8.0 rechaza el redrive de una ejecución cuyo código de workflow actualizó un memo o atributo de búsqueda (`service_redrive_history_not_qualified`) o cuyo resultado de efecto secundario se almacena externamente (`external_side_effect_result_not_supported`). Por lo demás, sigue aplicando las reglas anteriores a 2.18.0, así que un temporizador disparado se sigue rechazando con `unsupported_history`. La compatibilidad del Server nativo con las reglas restantes se sigue en [server#980](https://github.com/durable-workflow/server/issues/980).
Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). Server nativo 3.11.0 acepta un temporizador simple completado antes de la actividad fallida y escribe los relojes de respaldo con la precisión completa de milisegundos que almacena el servidor ([redrive nativo de temporizadores disparados](./polyglot/server-api-reference.md#native-redrive-timers)). El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980).

## Rechazo de entrada y recuperación en modo servicio {#service-entry-recovery}

Expand Down
Loading
Loading