prefect 3.7.6.dev1__tar.gz → 3.7.6.dev2__tar.gz

{prefect-3.7.6.dev1 → prefect-3.7.6.dev2}/PKG-INFO

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

prefect-3.7.6.dev2/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.6.dev2"
+__build_date__ = "2026-06-23 09:17:07.122273+00:00"
+__git_commit__ = "59cc990c54a9d59f889f4f070e89d118fe7fa670"
+__dirty__ = False

{prefect-3.7.6.dev1 → prefect-3.7.6.dev2}/src/prefect/server/AGENTS.md

@@ -63,6 +63,8 @@ alembic_revision("description")      # Create a new migration
 
 - **`record_bulk_task_run_events` batches must be sorted by conflict key before upserting.** In `services/task_run_recorder.py`, task runs are sorted by conflict key — natural key `(flow_run_id, task_key, dynamic_key)` when available, otherwise `("id", task_run_id)` — before batching into upsert groups. This enforces deterministic row-level lock acquisition order across concurrent recorder instances; removing or reordering the sort causes deadlocks. Events that collide on either `id` or natural key are coalesced via union-find to a single canonical ID — the input `TaskRun.id` and `state.state_details.task_run_id` are mutated in-place to that canonical value. Any refactor that re-batches or re-merges must re-sort by conflict key. The function retries once internally on `IntegrityError` to handle TOCTOU races between concurrent recorders, then re-raises on a second failure — callers must catch `IntegrityError` or re-queue the batch.
 
+- **`docket.add()` in monitor loops must pass a per-entity `key=` to prevent duplicate enqueues.** Without it, repeated iterations over the same pending entity enqueue duplicate tasks — causing duplicate state transitions. Format: `"<service-name>:<entity-id>"`, e.g., `"mark-flow-run-late:{run.id}"` in `services/late_runs.py`.
+
 ## UI Serving Architecture
 
 Both V1 and V2 UI bundles are served simultaneously when available: V1 at `PREFECT_UI_SERVE_BASE` (default `/`), V2 at `{base_url}/v2`. The `redirect_to_preferred_ui` middleware routes neutral entry points using the `prefect_ui_version` cookie. `PREFECT_SERVER_UI_V2_ENABLED` sets the *default* for browsers with no saved preference — it does not remove V1 or force all users to V2. Both bundles must be built before packaging (`PREFECT_REQUIRE_PACKAGED_UI_BUNDLES=1` enforces this via `hatch_build.py`).

{prefect-3.7.6.dev1 → prefect-3.7.6.dev2}/src/prefect/server/orchestration/core_policy.py

@@ -1789,10 +1789,15 @@ class EnsureOnlyScheduledFlowsMarkedLate(FlowRunOrchestrationRule):
         marking_flow_late = (
             proposed_state.is_scheduled() and proposed_state.name == "Late"
         )
-        if marking_flow_late and not initial_state.is_scheduled():
-            await self.reject_transition(
-                state=None, reason="Only scheduled flows can be marked late."
-            )
+        if marking_flow_late:
+            if not initial_state.is_scheduled():
+                await self.reject_transition(
+                    state=None, reason="Only scheduled flows can be marked late."
+                )
+            elif initial_state.name == "Late":
+                await self.reject_transition(
+                    state=None, reason="This flow run is already marked late."
+                )
 
 
 class EnforceDeploymentConcurrencyOnLate(FlowRunOrchestrationRule):

{prefect-3.7.6.dev1 → prefect-3.7.6.dev2}/src/prefect/server/services/late_runs.py

@@ -82,4 +82,6 @@ async def monitor_late_runs(
         runs = result.all()
 
         for run in runs:
-            await docket.add(mark_flow_run_late)(run.id)
+            await docket.add(mark_flow_run_late, key=f"mark-flow-run-late:{run.id}")(
+                run.id
+            )

prefect-3.7.6.dev1/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.6.dev1"
-__build_date__ = "2026-06-20 09:11:15.541080+00:00"
-__git_commit__ = "441d5e112d263706d963612aabc8f252df94a42e"
-__dirty__ = False