prefect 3.7.9.dev3__tar.gz → 3.7.9.dev4__tar.gz

{prefect-3.7.9.dev3 → prefect-3.7.9.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect
-Version: 3.7.9.dev3
+Version: 3.7.9.dev4
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

prefect-3.7.9.dev4/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.9.dev4"
+__build_date__ = "2026-07-18 08:39:02.069484+00:00"
+__git_commit__ = "60025750fb7ea1d69fef8a1c8b1e013cdc8149ae"
+__dirty__ = False

{prefect-3.7.9.dev3 → prefect-3.7.9.dev4}/src/prefect/server/orchestration/global_policy.py

@@ -10,8 +10,10 @@ state database, they should be the most deeply nested contexts in orchestration
 
 from __future__ import annotations
 
+from datetime import timedelta
 from typing import Any, Union, cast
 
+import sqlalchemy as sa
 from packaging.version import Version
 
 import prefect.server.models as models
@@ -66,22 +68,32 @@ class GlobalFlowPolicy(BaseOrchestrationPolicy[orm_models.FlowRun, core.FlowRunP
             type[BaseOrchestrationRule[orm_models.FlowRun, core.FlowRunPolicy]],
         ]
     ]:
-        return cast(
-            list[
-                Union[
-                    type[
-                        BaseUniversalTransform[orm_models.FlowRun, core.FlowRunPolicy]
-                    ],
-                    type[BaseOrchestrationRule[orm_models.FlowRun, core.FlowRunPolicy]],
-                ]
-            ],
-            COMMON_GLOBAL_TRANSFORMS(),
-        ) + [
-            UpdateSubflowParentTask,
-            UpdateSubflowStateDetails,
-            IncrementFlowRunCount,
-            RemoveResumingIndicator,
-        ]
+        return (
+            [EnsureFlowRunStateTimestampIsUnique]
+            + cast(
+                list[
+                    Union[
+                        type[
+                            BaseUniversalTransform[
+                                orm_models.FlowRun, core.FlowRunPolicy
+                            ]
+                        ],
+                        type[
+                            BaseOrchestrationRule[
+                                orm_models.FlowRun, core.FlowRunPolicy
+                            ]
+                        ],
+                    ]
+                ],
+                COMMON_GLOBAL_TRANSFORMS(),
+            )
+            + [
+                UpdateSubflowParentTask,
+                UpdateSubflowStateDetails,
+                IncrementFlowRunCount,
+                RemoveResumingIndicator,
+            ]
+        )
 
 
 class GlobalTaskPolicy(BaseOrchestrationPolicy[orm_models.TaskRun, core.TaskRunPolicy]):
@@ -112,6 +124,53 @@ class GlobalTaskPolicy(BaseOrchestrationPolicy[orm_models.TaskRun, core.TaskRunP
         ) + [IncrementTaskRunCount]
 
 
+class EnsureFlowRunStateTimestampIsUnique(
+    FlowRunUniversalTransform[orm_models.FlowRun, core.FlowRunPolicy]
+):
+    """
+    Prevents a flow run's states from sharing a timestamp.
+
+    State timestamps are minted server-side from the wall clock. On platforms with
+    coarse clock resolution (notably Windows, ~15.6ms) several states written for the
+    same flow run within a single clock tick can receive identical timestamps,
+    violating the unique `(flow_run_id, timestamp)` constraint. When the proposed
+    timestamp collides with a persisted state, advance it to the first available
+    microsecond after the collision. This handles repeated collisions while keeping
+    explicitly backdated states near their intended timestamp.
+
+    This transform must run before the transforms that read `proposed_state.timestamp`
+    (e.g. `SetRunStateTimestamp`, `SetStartTime`, `SetEndTime`, `IncrementRunTime`) so
+    the adjusted timestamp is reflected consistently in the persisted state, the run's
+    denormalized timestamps, and its runtime accounting.
+    """
+
+    async def before_transition(
+        self, context: OrchestrationContext[orm_models.FlowRun, core.FlowRunPolicy]
+    ) -> None:
+        if self.nullified_transition():
+            return
+
+        proposed_state = context.proposed_state
+        if proposed_state is None:
+            return
+
+        candidate_timestamp = proposed_state.timestamp
+        while (
+            await context.session.scalar(
+                sa.select(orm_models.FlowRunState.timestamp)
+                .where(
+                    orm_models.FlowRunState.flow_run_id == context.run.id,
+                    orm_models.FlowRunState.timestamp == candidate_timestamp,
+                )
+                .limit(1)
+            )
+            is not None
+        ):
+            candidate_timestamp += timedelta(microseconds=1)
+
+        proposed_state.timestamp = candidate_timestamp
+
+
 class SetRunStateType(
     BaseUniversalTransform[
         orm_models.Run, Union[core.FlowRunPolicy, core.TaskRunPolicy]

prefect-3.7.9.dev3/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.9.dev3"
-__build_date__ = "2026-07-16 08:52:37.868141+00:00"
-__git_commit__ = "b749a6732bccbdcee1351e9afa806d32fb530d99"
-__dirty__ = False