taskcheck 1.6.1__tar.gz → 1.6.2__tar.gz

{taskcheck-1.6.1/taskcheck.egg-info → taskcheck-1.6.2}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: taskcheck
-Version: 1.6.1
+Version: 1.6.2
 Summary: Automatic scheduler for taskwarrior
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: google-api-python-client>=2.198.0
@@ -148,6 +148,10 @@ Before writing a schedule, taskcheck backs up the affected tasks' `scheduled`, `
 
 If a task would finish after its due date, taskcheck retries with a total-urgency override. Each retry moves the task immediately above the task with the smallest greater urgency by adding `urgency_epsilon` (default: `0.1`). At rank 1, it adds epsilon for up to `max_top_urgency_rounds` retries (default: `10`), then tries once at urgency `1000`. If the task is still late, taskcheck stops raising it and optimizes the other overdue tasks.
 
+Each task gets at most `N - 1 + max_top_urgency_rounds` priority increases before the final retry at urgency `1000`.
+Here, `N` is the number of tasks in the schedule.
+This limit stops repeated retries when tasks with competing deadlines keep overtaking each other.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.

{taskcheck-1.6.1 → taskcheck-1.6.2}/README.md

@@ -133,6 +133,10 @@ Before writing a schedule, taskcheck backs up the affected tasks' `scheduled`, `
 
 If a task would finish after its due date, taskcheck retries with a total-urgency override. Each retry moves the task immediately above the task with the smallest greater urgency by adding `urgency_epsilon` (default: `0.1`). At rank 1, it adds epsilon for up to `max_top_urgency_rounds` retries (default: `10`), then tries once at urgency `1000`. If the task is still late, taskcheck stops raising it and optimizes the other overdue tasks.
 
+Each task gets at most `N - 1 + max_top_urgency_rounds` priority increases before the final retry at urgency `1000`.
+Here, `N` is the number of tasks in the schedule.
+This limit stops repeated retries when tasks with competing deadlines keep overtaking each other.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.

{taskcheck-1.6.1 → taskcheck-1.6.2}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "taskcheck"
-version = "1.6.1"
+version = "1.6.2"
 description = "Automatic scheduler for taskwarrior"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 dependencies = [
   "appdirs>=1.4.4",
   "google-api-python-client>=2.198.0",

{taskcheck-1.6.1 → taskcheck-1.6.2}/taskcheck/parallel.py

@@ -58,7 +58,7 @@ def advance_urgency_override(
     for task_uuid in overdue_uuids:
         state = adjustment_states.setdefault(
             task_uuid,
-            {"top_rounds": 0, "fallback_used": False, "exhausted": False},
+            {"top_rounds": 0, "rounds": 0, "fallback_used": False, "exhausted": False},
         )
         if state["exhausted"]:
             continue
@@ -72,7 +72,10 @@ def advance_urgency_override(
             for uuid in task_info
             if uuid != task_uuid and effective_urgency(uuid) > current_urgency
         ]
-        if greater_urgencies:
+        if state["rounds"] >= len(task_info) - 1 + max_top_rounds:
+            urgency_overrides[task_uuid] = 1000.0
+            state["fallback_used"] = True
+        elif greater_urgencies:
             urgency_overrides[task_uuid] = min(greater_urgencies) + epsilon
         elif state["top_rounds"] < max_top_rounds:
             urgency_overrides[task_uuid] = current_urgency + epsilon
@@ -80,6 +83,7 @@ def advance_urgency_override(
         else:
             urgency_overrides[task_uuid] = 1000.0
             state["fallback_used"] = True
+        state["rounds"] += 1
         return task_uuid
     return None
 

{taskcheck-1.6.1 → taskcheck-1.6.2/taskcheck.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: taskcheck
-Version: 1.6.1
+Version: 1.6.2
 Summary: Automatic scheduler for taskwarrior
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: google-api-python-client>=2.198.0
@@ -148,6 +148,10 @@ Before writing a schedule, taskcheck backs up the affected tasks' `scheduled`, `
 
 If a task would finish after its due date, taskcheck retries with a total-urgency override. Each retry moves the task immediately above the task with the smallest greater urgency by adding `urgency_epsilon` (default: `0.1`). At rank 1, it adds epsilon for up to `max_top_urgency_rounds` retries (default: `10`), then tries once at urgency `1000`. If the task is still late, taskcheck stops raising it and optimizes the other overdue tasks.
 
+Each task gets at most `N - 1 + max_top_urgency_rounds` priority increases before the final retry at urgency `1000`.
+Here, `N` is the number of tasks in the schedule.
+This limit stops repeated retries when tasks with competing deadlines keep overtaking each other.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.

{taskcheck-1.6.1 → taskcheck-1.6.2}/tests/test_parallel.py

@@ -388,6 +388,25 @@ class TestMainSchedulingFunction:
 
 
 class TestAutoAdjustUrgency:
+    def test_competing_overdue_tasks_exhaust_retries(self):
+        task_info = {
+            uuid: {"task": {"uuid": uuid, "urgency": urgency}, "urgency": urgency}
+            for uuid, urgency in (("a", 1.0), ("b", 2.0))
+        }
+        overrides = {}
+        states = {}
+        # Resolving one deadline can make the other task late on the next pass.
+        for index in range(12):
+            overdue = [task_info["a" if index % 2 == 0 else "b"]["task"]]
+            advance_urgency_override(
+                overdue, task_info, overrides, states, epsilon=0.1, max_top_rounds=2
+            )
+        assert advance_urgency_override(
+            [info["task"] for info in task_info.values()],
+            task_info, overrides, states, epsilon=0.1, max_top_rounds=2,
+        ) is None
+        assert overrides == {"a": 1000.0, "b": 1000.0}
+
     def test_urgency_override_moves_up_one_rank_then_uses_bounded_top_rounds(self):
         task_info = {
             "t1": {"task": {"uuid": "t1"}, "urgency": 1.0},