taskito 0.15.2__tar.gz → 0.16.2__tar.gz

{taskito-0.15.2 → taskito-0.16.2}/Cargo.lock

@@ -88,9 +88,9 @@ dependencies = [
 
 [[package]]
 name = "bitflags"
-version = "2.11.1"
+version = "2.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4512299f36f043ab09a583e57bceb5a5aab7a73db1805848e8fef3c9e8c78b3"
+checksum = "b4388bee8683e3d04af747c73422af53102d2bd24d9eadb6cbc100baef4b43f8"
 
 [[package]]
 name = "bumpalo"
@@ -112,9 +112,9 @@ checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33"
 
 [[package]]
 name = "cc"
-version = "1.2.63"
+version = "1.2.64"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "556e016178bb5662a08681bbe0f00f8e17631781a4dfc8c45e466e4b185ec27f"
+checksum = "dad887fd958be91b5098c0248def011f4523ab786cd411be668777e55063501f"
 dependencies = [
  "find-msvc-tools",
  "shlex",
@@ -139,9 +139,9 @@ dependencies = [
 
 [[package]]
 name = "chrono"
-version = "0.4.44"
+version = "0.4.45"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c673075a2e0e5f4a1dde27ce9dee1ea4558c7ffe648f576438a20ca1d2acc4b0"
+checksum = "1aa79e62e7697b8e29b513a68abacf485adcd1fe8284a4316c5ae868e6633327"
 dependencies = [
  "iana-time-zone",
  "js-sys",
@@ -273,9 +273,9 @@ dependencies = [
 
 [[package]]
 name = "diesel"
-version = "2.3.9"
+version = "2.3.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9940fb8467a0a06312218ed384185cb8536aa10d8ec017d0ce7fad2c1bd882d5"
+checksum = "29fe29a87fb84c631ffb3ba21798c4b1f3a964701ba78f0dce4bf8668562ec88"
 dependencies = [
  "bitflags",
  "byteorder",
@@ -676,13 +676,12 @@ checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
 
 [[package]]
 name = "js-sys"
-version = "0.3.99"
+version = "0.3.102"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "142bc4740e452c1e57ade0cbc129f139c9093e354346f0872ef985f4f5cf5f11"
+checksum = "03d04c30968dffe80775bd4d7fb676131cd04a1fb46d2686dbffbaec2d9dfd31"
 dependencies = [
  "cfg-if",
  "futures-util",
- "once_cell",
  "wasm-bindgen",
 ]
 
@@ -732,15 +731,15 @@ dependencies = [
 
 [[package]]
 name = "log"
-version = "0.4.30"
+version = "0.4.32"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "616ec5685824bcc94416c6d4a7a446eea774a31efd7062c8480ba6fd06d7a6e5"
+checksum = "953f07c43838f8e6f9758cab68bf5bed85465e7587ebe0b823f1bcd81978ad3a"
 
 [[package]]
 name = "memchr"
-version = "2.8.1"
+version = "2.8.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6b947ae49db0d222b1dbc6b113ce7248a3fc3a6ca21b696717bfc000ba4484d8"
+checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
 
 [[package]]
 name = "memmap2"
@@ -813,18 +812,18 @@ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
 [[package]]
 name = "openssl-src"
-version = "300.6.0+3.6.2"
+version = "300.6.1+3.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a8e8cbfd3a4a8c8f089147fd7aaa33cf8c7450c4d09f8f80698a0cf093abeff4"
+checksum = "46eb8fb9fb3b61ce1c0f8a026c4c1a0714d3a9e138e7fbde78753ce2babc3846"
 dependencies = [
  "cc",
 ]
 
 [[package]]
 name = "openssl-sys"
-version = "0.9.116"
+version = "0.9.117"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f28a22dc7140cda5f096e5e7724a6962ca81a7f8bfd2979f9b18c11af56318c4"
+checksum = "b47e7e6bb2c38cd930d25a23b40fa52e068c10e85f3e03a7f5ba5aaca5713695"
 dependencies = [
  "cc",
  "libc",
@@ -1174,9 +1173,9 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.12.3"
+version = "1.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e10754a14b9137dd7b1e3e5b0493cc9171fdd105e0ab477f51b72e7f3ac0e276"
+checksum = "f1292b7759ae1cb9ec195452d1390a074f0cd8541ab7a5a8c31cd6db45d4a6ba"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -1197,9 +1196,9 @@ dependencies = [
 
 [[package]]
 name = "regex-syntax"
-version = "0.8.10"
+version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
 [[package]]
 name = "rsqlite-vfs"
@@ -1336,9 +1335,9 @@ checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
 
 [[package]]
 name = "smallvec"
-version = "1.15.1"
+version = "1.15.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
+checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90"
 
 [[package]]
 name = "socket2"
@@ -1404,7 +1403,7 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
 
 [[package]]
 name = "taskito-async"
-version = "0.15.2"
+version = "0.16.2"
 dependencies = [
  "async-trait",
  "crossbeam-channel",
@@ -1416,7 +1415,7 @@ dependencies = [
 
 [[package]]
 name = "taskito-core"
-version = "0.15.2"
+version = "0.16.2"
 dependencies = [
  "async-trait",
  "chrono",
@@ -1438,9 +1437,24 @@ dependencies = [
  "uuid",
 ]
 
+[[package]]
+name = "taskito-mesh"
+version = "0.16.2"
+dependencies = [
+ "base64",
+ "bincode",
+ "log",
+ "rand 0.10.1",
+ "serde",
+ "serde_json",
+ "taskito-core",
+ "tokio",
+ "xxhash-rust",
+]
+
 [[package]]
 name = "taskito-python"
-version = "0.15.2"
+version = "0.16.2"
 dependencies = [
  "async-trait",
  "base64",
@@ -1453,6 +1467,7 @@ dependencies = [
  "serde_json",
  "taskito-async",
  "taskito-core",
+ "taskito-mesh",
  "taskito-workflows",
  "tokio",
  "uuid",
@@ -1460,7 +1475,7 @@ dependencies = [
 
 [[package]]
 name = "taskito-workflows"
-version = "0.15.2"
+version = "0.16.2"
 dependencies = [
  "dagron-core",
  "diesel",
@@ -1612,9 +1627,9 @@ checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
 
 [[package]]
 name = "uuid"
-version = "1.23.2"
+version = "1.23.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d258b83ceec21034727ecee8c382cfa6c3e133699b0742c64571814fb420c9f7"
+checksum = "144d6b123cef80b301b8f72a9e2ca4370ddec21950d0a103dd22c437006d2db7"
 dependencies = [
  "getrandom 0.4.2",
  "js-sys",
@@ -1641,9 +1656,9 @@ checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
 
 [[package]]
 name = "wasip2"
-version = "1.0.3+wasi-0.2.9"
+version = "1.0.4+wasi-0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "20064672db26d7cdc89c7798c48a0fdfac8213434a1186e5ef29fd560ae223d6"
+checksum = "b67efb37e106e55ce722a510d6b5f9c17f083e5fc79afc2badeb12cc313d9487"
 dependencies = [
  "wit-bindgen 0.57.1",
 ]
@@ -1659,9 +1674,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.122"
+version = "0.2.125"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ed04576f974d2b2fba0f38c51dbc5518011e38c36bf1143164be765528fd409"
+checksum = "8ddb3f79143bced6de84270411622a2699cee572fc0875aeaf1e7867cf9fca1a"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -1672,9 +1687,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.122"
+version = "0.2.125"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "916151b09da36bd82f6615cbf3a419e2f0ba23a03c6160e8e92eb6bd4aa1dec6"
+checksum = "4e21a184b13fb19e157296e2c46056aec9092264fab83e4ba59e68c61b323c3d"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -1682,9 +1697,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.122"
+version = "0.2.125"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "299047362ccbfce148b67ab7e73349f77748e00c8296f9542adfad2ad82c5c5e"
+checksum = "fecefd9c35bd935a20fc3fc344b5f29138961e4f47fb03297d88f2587afb5ebd"
 dependencies = [
  "bumpalo",
  "proc-macro2",
@@ -1695,9 +1710,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.122"
+version = "0.2.125"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9a929b2c61f11ba3e9bc35b50c1f25cb38e0e892c0c231ae2b8cf78d5dad4437"
+checksum = "23939e44bb9a5d7576fa2b563dc2e136628f1224e88a8deed09e04858b77871f"
 dependencies = [
  "unicode-ident",
 ]
@@ -1921,9 +1936,9 @@ checksum = "fdd20c5420375476fbd4394763288da7eb0cc0b8c11deed431a91562af7335d3"
 
 [[package]]
 name = "yoke"
-version = "0.8.2"
+version = "0.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "abe8c5fda708d9ca3df187cae8bfb9ceda00dd96231bed36e445a1a48e66f9ca"
+checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
 dependencies = [
  "stable_deref_trait",
  "yoke-derive",
@@ -1944,18 +1959,18 @@ dependencies = [
 
 [[package]]
 name = "zerocopy"
-version = "0.8.50"
+version = "0.8.52"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b065d4f0e55f82fae73202e189638116a87c55ab6b8e6c2721e13dd9d854ad1"
+checksum = "ce1022995ff5ff5d841ad7d994facc23098cd40152f2c1d11cd607c6f530653f"
 dependencies = [
  "zerocopy-derive",
 ]
 
 [[package]]
 name = "zerocopy-derive"
-version = "0.8.50"
+version = "0.8.52"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b631b19d36a892ab55420c92dbc83ccd79274f25be714855d3074aa71cab639"
+checksum = "1ae7f38b72ec2a254e2b87ef277cf2cd4fb97cbebf944faa6f33354da0867930"
 dependencies = [
  "proc-macro2",
  "quote",

{taskito-0.15.2 → taskito-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taskito
-Version: 0.15.2
+Version: 0.16.2
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -30,6 +30,7 @@ Requires-Dist: flask>=3.0 ; extra == 'flask'
 Requires-Dist: google-cloud-storage>=2.10 ; extra == 'gcs'
 Requires-Dist: msgpack ; extra == 'msgpack'
 Requires-Dist: authlib>=1.7,<2 ; extra == 'oauth'
+Requires-Dist: joserfc>=0.12 ; extra == 'oauth'
 Requires-Dist: requests>=2.31 ; extra == 'oauth'
 Requires-Dist: opentelemetry-api ; extra == 'otel'
 Requires-Dist: opentelemetry-sdk ; extra == 'otel'
@@ -119,12 +120,78 @@ parallelism on CPU-bound work.
 
 ## Features
 
-- **Reliability** — retries with exponential backoff, dead letter queue with replay, circuit breakers, exception filtering
-- **Scheduling** — priorities, rate limiting, periodic (cron) tasks, delayed execution, job expiration
-- **Workflows** — `chain` / `group` / `chord`, task dependencies with cascade cancel
-- **Control** — cooperative cancellation, soft timeouts, unique/idempotent tasks, queue pause/resume
-- **Observability** — web dashboard, events, HMAC-signed webhooks, structured logging, worker heartbeats
-- **Extensibility** — pluggable serializers, per-task middleware, async API, Postgres/Redis backends
+Grouped by what you're trying to do — each section has a one-line sample and a
+link to its deep-dive guide. New here? Start with
+**[Capabilities at a glance](https://docs.byteveda.org/taskito/capabilities)**.
+
+### Reliability
+
+Retries with exponential backoff, per-exception retry rules, soft timeouts, a
+dead-letter queue with replay, circuit breakers, and idempotent enqueue.
+
+```python
+@queue.task(max_retries=5, retry_backoff=2.0, retry_on=[TimeoutError])
+def fetch_url(url: str) -> str: ...
+```
+
+[→ Reliability guide](https://docs.byteveda.org/taskito/guides/reliability)
+
+### Workflows
+
+Compose tasks with `chain`, fan out with `group`, fan in with `chord` — plus
+task dependency graphs with cascade cancel.
+
+```python
+chain(fetch.s(url), parse.s(), store.s()).apply()
+```
+
+[→ Workflows guide](https://docs.byteveda.org/taskito/guides/workflows/canvas)
+
+### Concurrency
+
+A thread pool by default (ideal for I/O-bound tasks); switch to a **prefork**
+pool of child processes for true CPU parallelism with no GIL contention.
+
+```bash
+taskito worker --pool prefork --app tasks:queue   # CPU-bound: real parallelism
+```
+
+[→ Execution & prefork guide](https://docs.byteveda.org/taskito/guides/advanced-execution/prefork)
+
+### Scheduling
+
+Priorities, rate limiting, periodic (cron) tasks, delayed execution, and job
+expiration.
+
+```python
+@queue.task(priority=9, rate_limit="100/m")
+def notify(user_id: int) -> None: ...
+```
+
+[→ Scheduling guide](https://docs.byteveda.org/taskito/guides/core/scheduling)
+
+### Observability
+
+A built-in web dashboard, an events system, HMAC-signed webhooks, Prometheus and
+OpenTelemetry exporters, structured logging, and worker heartbeats.
+
+```bash
+taskito dashboard --app tasks:queue   # Flower-style monitoring UI
+```
+
+[→ Dashboard & monitoring guide](https://docs.byteveda.org/taskito/guides/dashboard)
+
+### Extensibility
+
+Pluggable serializers, per-task middleware, a fully async API, and Postgres or
+Redis backends for multi-machine workers.
+
+```python
+@queue.task(middleware=[MyMiddleware()])   # per-task hooks
+def handle(payload: dict) -> None: ...
+```
+
+[→ Extensibility guide](https://docs.byteveda.org/taskito/guides/extensibility)
 
 ## Examples
 
@@ -174,7 +241,7 @@ def test_add():
 ## Documentation
 
 **[Read the docs →](https://docs.byteveda.org/taskito)** — guides, API reference, and architecture.
-Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskito/docs/guides/operations/migration)**.
+Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskito/guides/operations/migration)**.
 
 ## Comparison
 
@@ -186,9 +253,11 @@ Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskit
 | Rate limiting | **Yes** | Yes | No | Yes | No |
 | Dead letter queue | **Yes** | No | Yes | No | No |
 | Task dependencies | **Yes** | No | No | No | No |
+| Workflows (chain/group/chord) | **Yes** | Yes | No | Yes | No |
 | Built-in dashboard | **Yes** | No | No | No | No |
 | FastAPI integration | **Yes** | No | No | No | No |
 | Cancel running tasks | **Yes** | Yes | No | No | No |
+| CPU parallelism (prefork pool) | **Yes** | Yes | Yes | Yes | Yes |
 | Postgres backend | **Yes** | Yes | No | No | No |
 | Setup | **`pip install`** | Broker + backend | Redis | Broker | Redis |
 

{taskito-0.15.2 → taskito-0.16.2}/README.md

@@ -57,12 +57,78 @@ parallelism on CPU-bound work.
 
 ## Features
 
-- **Reliability** — retries with exponential backoff, dead letter queue with replay, circuit breakers, exception filtering
-- **Scheduling** — priorities, rate limiting, periodic (cron) tasks, delayed execution, job expiration
-- **Workflows** — `chain` / `group` / `chord`, task dependencies with cascade cancel
-- **Control** — cooperative cancellation, soft timeouts, unique/idempotent tasks, queue pause/resume
-- **Observability** — web dashboard, events, HMAC-signed webhooks, structured logging, worker heartbeats
-- **Extensibility** — pluggable serializers, per-task middleware, async API, Postgres/Redis backends
+Grouped by what you're trying to do — each section has a one-line sample and a
+link to its deep-dive guide. New here? Start with
+**[Capabilities at a glance](https://docs.byteveda.org/taskito/capabilities)**.
+
+### Reliability
+
+Retries with exponential backoff, per-exception retry rules, soft timeouts, a
+dead-letter queue with replay, circuit breakers, and idempotent enqueue.
+
+```python
+@queue.task(max_retries=5, retry_backoff=2.0, retry_on=[TimeoutError])
+def fetch_url(url: str) -> str: ...
+```
+
+[→ Reliability guide](https://docs.byteveda.org/taskito/guides/reliability)
+
+### Workflows
+
+Compose tasks with `chain`, fan out with `group`, fan in with `chord` — plus
+task dependency graphs with cascade cancel.
+
+```python
+chain(fetch.s(url), parse.s(), store.s()).apply()
+```
+
+[→ Workflows guide](https://docs.byteveda.org/taskito/guides/workflows/canvas)
+
+### Concurrency
+
+A thread pool by default (ideal for I/O-bound tasks); switch to a **prefork**
+pool of child processes for true CPU parallelism with no GIL contention.
+
+```bash
+taskito worker --pool prefork --app tasks:queue   # CPU-bound: real parallelism
+```
+
+[→ Execution & prefork guide](https://docs.byteveda.org/taskito/guides/advanced-execution/prefork)
+
+### Scheduling
+
+Priorities, rate limiting, periodic (cron) tasks, delayed execution, and job
+expiration.
+
+```python
+@queue.task(priority=9, rate_limit="100/m")
+def notify(user_id: int) -> None: ...
+```
+
+[→ Scheduling guide](https://docs.byteveda.org/taskito/guides/core/scheduling)
+
+### Observability
+
+A built-in web dashboard, an events system, HMAC-signed webhooks, Prometheus and
+OpenTelemetry exporters, structured logging, and worker heartbeats.
+
+```bash
+taskito dashboard --app tasks:queue   # Flower-style monitoring UI
+```
+
+[→ Dashboard & monitoring guide](https://docs.byteveda.org/taskito/guides/dashboard)
+
+### Extensibility
+
+Pluggable serializers, per-task middleware, a fully async API, and Postgres or
+Redis backends for multi-machine workers.
+
+```python
+@queue.task(middleware=[MyMiddleware()])   # per-task hooks
+def handle(payload: dict) -> None: ...
+```
+
+[→ Extensibility guide](https://docs.byteveda.org/taskito/guides/extensibility)
 
 ## Examples
 
@@ -112,7 +178,7 @@ def test_add():
 ## Documentation
 
 **[Read the docs →](https://docs.byteveda.org/taskito)** — guides, API reference, and architecture.
-Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskito/docs/guides/operations/migration)**.
+Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskito/guides/operations/migration)**.
 
 ## Comparison
 
@@ -124,9 +190,11 @@ Coming from Celery? See the **[Migration Guide](https://docs.byteveda.org/taskit
 | Rate limiting | **Yes** | Yes | No | Yes | No |
 | Dead letter queue | **Yes** | No | Yes | No | No |
 | Task dependencies | **Yes** | No | No | No | No |
+| Workflows (chain/group/chord) | **Yes** | Yes | No | Yes | No |
 | Built-in dashboard | **Yes** | No | No | No | No |
 | FastAPI integration | **Yes** | No | No | No | No |
 | Cancel running tasks | **Yes** | Yes | No | No | No |
+| CPU parallelism (prefork pool) | **Yes** | Yes | Yes | Yes | Yes |
 | Postgres backend | **Yes** | Yes | No | No | No |
 | Setup | **`pip install`** | Broker + backend | Redis | Broker | Redis |
 

{taskito-0.15.2 → taskito-0.16.2}/crates/taskito-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "taskito-core"
-version = "0.15.2"
+version = "0.16.2"
 edition = "2021"
 
 [features]
@@ -32,3 +32,7 @@ redis = { workspace = true, optional = true }
 
 [dev-dependencies]
 tempfile = "3"
+# Raw connection access in the Redis contract tests, to set up race-window
+# state and assert on internal index keys. Only used by `#[cfg(feature = "redis")]`
+# tests; harmless when the feature is off.
+redis = { workspace = true }

{taskito-0.15.2 → taskito-0.16.2}/crates/taskito-core/src/scheduler/maintenance.rs

@@ -57,9 +57,8 @@ impl Scheduler {
 
         let cutoff = now_millis().saturating_sub(ttl);
 
-        // Use per-job TTL aware cleanup
         let completed = self.storage.purge_completed_with_ttl(cutoff)?;
-        let dead = self.storage.purge_dead(cutoff)?;
+        let dead = self.storage.purge_dead_with_ttl(cutoff)?;
         let errors = self.storage.purge_job_errors(cutoff)?;
         let metrics = self.storage.purge_metrics(cutoff).unwrap_or_else(|e| {
             warn!("purge_metrics failed: {e}");
@@ -131,6 +130,49 @@ impl Scheduler {
         Ok(())
     }
 
+    /// Auto-retry eligible DLQ entries that have aged past the configured delay.
+    pub(super) fn auto_retry_dlq(&self) -> Result<()> {
+        let delay = match self.config.dlq_auto_retry_delay_ms {
+            Some(d) => d,
+            None => return Ok(()),
+        };
+
+        let now = now_millis();
+        let cutoff = now.saturating_sub(delay);
+        let max_retries = self.config.dlq_auto_retry_max;
+
+        let candidates = self.storage.list_dead_for_retry(cutoff, max_retries, 50)?;
+
+        if candidates.is_empty() {
+            return Ok(());
+        }
+
+        let mut retried = 0u64;
+        for entry in &candidates {
+            match self.storage.retry_dead(&entry.id) {
+                Ok(new_id) => {
+                    info!(
+                        "dlq auto-retry: {} -> {} (attempt {}/{})",
+                        entry.id,
+                        new_id,
+                        entry.dlq_retry_count + 1,
+                        max_retries
+                    );
+                    retried += 1;
+                }
+                Err(e) => {
+                    warn!("dlq auto-retry failed for {}: {e}", entry.id);
+                }
+            }
+        }
+
+        if retried > 0 {
+            info!("dlq auto-retry: retried {retried} entries");
+        }
+
+        Ok(())
+    }
+
     /// Build a cloudpickle-compatible payload from stored args.
     fn build_periodic_payload(args: &Option<Vec<u8>>) -> Vec<u8> {
         match args {

{taskito-0.15.2 → taskito-0.16.2}/crates/taskito-core/src/scheduler/mod.rs

@@ -39,6 +39,12 @@ pub struct SchedulerConfig {
     /// preserves the original one-job-per-round-trip behavior; values above
     /// `1` enable batch claiming for higher throughput.
     pub batch_size: usize,
+    /// Minimum age (ms) before a DLQ entry is auto-retried. `None` disables.
+    pub dlq_auto_retry_delay_ms: Option<i64>,
+    /// Max DLQ auto-retries per entry before giving up.
+    pub dlq_auto_retry_max: i32,
+    /// Check DLQ auto-retry every N ticks.
+    pub dlq_auto_retry_interval: u32,
 }
 
 impl Default for SchedulerConfig {
@@ -51,6 +57,9 @@ impl Default for SchedulerConfig {
             cleanup_interval: 1200,
             result_ttl_ms: None,
             batch_size: 1,
+            dlq_auto_retry_delay_ms: None,
+            dlq_auto_retry_max: 1,
+            dlq_auto_retry_interval: 60,
         }
     }
 }
@@ -157,6 +166,7 @@ struct TickCounters {
     reap: u32,
     periodic: u32,
     cleanup: u32,
+    dlq_auto_retry: u32,
 }
 
 impl Scheduler {
@@ -316,6 +326,16 @@ impl Scheduler {
             }
         }
 
+        counters.dlq_auto_retry += 1;
+        if counters
+            .dlq_auto_retry
+            .is_multiple_of(self.config.dlq_auto_retry_interval)
+        {
+            if let Err(e) = self.auto_retry_dlq() {
+                error!("dlq auto-retry error: {e}");
+            }
+        }
+
         had_maintenance
     }
 }