Skip to content

Commit 35aad4a

Browse files
authored
Merge pull request #153 from durable-workflow/chore/query-authority-2.5.15
Prepare Python 2.5.15 query authority without regressing backfill docs
2 parents 1ec4c31 + f493e6f commit 35aad4a

4 files changed

Lines changed: 46 additions & 4 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
66

77
## [Unreleased]
88

9+
## [2.5.15] - 2026-10-15
10+
11+
### Fixed
12+
- Bound query payload loading, replay and async handler execution to the
13+
original query deadline and lease. Use non-renewing authority observations
14+
when Server 2.8.0 advertises them, with explicit older-Server/1.19 limits.
15+
- Reuse identical external references within one query response and retain
16+
the original typed caller timeout. Add optional pre-registration enforcement
17+
with `require_query_task_authority=True`.
18+
19+
## [2.5.14] - 2026-10-14
20+
21+
### Fixed
22+
- Document schedule backfill as a start-inclusive, end-exclusive window.
23+
An occurrence at the end belongs to the next adjacent window.
24+
925
## [2.5.13] - 2026-10-13
1026

1127
### Fixed

‎docs/reference/client.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,28 @@ Workflow authors should normally yield `ctx.call_nexus_service(...)`; the
66
worker uses this client method to execute once and record the durable result
77
or typed service failure.
88

9+
## Backfill windows
10+
11+
`Client.backfill_schedule()` includes the start time and excludes the end time:
12+
`[start_time, end_time)`. An occurrence exactly at `end_time` is excluded.
13+
14+
Adjacent windows share a boundary without overlapping it:
15+
16+
```python
17+
await client.backfill_schedule(
18+
"daily-orders",
19+
start_time="2026-03-08T07:00:00Z",
20+
end_time="2026-03-08T07:30:00Z",
21+
)
22+
await client.backfill_schedule(
23+
"daily-orders",
24+
start_time="2026-03-08T07:30:00Z",
25+
end_time="2026-03-08T08:00:00Z",
26+
)
27+
```
28+
29+
An occurrence at `07:30:00Z` belongs to the second window. Repeating a window
30+
does not start another workflow for an occurrence already admitted by that
31+
schedule.
32+
933
::: durable_workflow.client

‎pyproject.toml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
44

55
[project]
66
name = "durable-workflow"
7-
version = "2.5.14"
7+
version = "2.5.15"
88
description = "Python client and worker SDK for Durable Workflow Cloud and self-hosted Server"
99
readme = "README.md"
1010
requires-python = ">=3.10"
@@ -71,8 +71,8 @@ durable-workflow-replay-conformance = "durable_workflow.replay_conformance:main"
7171
durable-workflow-workflow-updates-conformance = "durable_workflow.workflow_updates_conformance:main"
7272

7373
[tool.durable-workflow]
74-
product-train = "2.5.14"
75-
registry-version = "2.5.14"
74+
product-train = "2.5.15"
75+
registry-version = "2.5.15"
7676
supported-server-versions = "2.8.0"
7777
worker-protocol-version = "1.20"
7878
control-plane-version = "2"

‎src/durable_workflow/client.py‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4845,8 +4845,10 @@ async def backfill_schedule(
48454845
end_time: str,
48464846
overlap_policy: str | None = None,
48474847
) -> ScheduleBackfillResult:
4848-
"""Fire a schedule for every would-have-been moment in ``[start_time, end_time]``.
4848+
"""Fire a schedule for every would-have-been moment in ``[start_time, end_time)``.
48494849
4850+
The start is inclusive and the end is exclusive. An occurrence equal
4851+
to ``end_time`` is excluded and belongs to the next adjacent window.
48504852
Times are ISO-8601 strings. Useful to replay a period the schedule
48514853
was paused or to seed historical runs. The returned
48524854
:class:`ScheduleBackfillResult` reports how many fires were attempted

0 commit comments

Comments
 (0)