wurk 1.7.3 → 1.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de5a24063d924950bf14f06ba530215018d35acc33a069a9a6698f48602833fa
-  data.tar.gz: bcdf163c1de721563e707958f3487e2518f175a811143f84e48b070b55e4cacb
+  metadata.gz: ac61be234c0359ccb0761df401c351021317cf2a5ae162e2329dcd94d7b8b4af
+  data.tar.gz: 00e7d69e0a3d440f1bf335ebbeeceb80b7e93ec1f82a6f48fcc189f54c4737ab
 SHA512:
-  metadata.gz: cc074e442e5987d123b86d9e02c8349840cd7c0b5e90d0cc5866b8e928f136e8d8ac5c861ffcf1c8a9243c0bb5e053f79a9b9477654d28b7728aadf7129957f3
-  data.tar.gz: 8c1ee815585ca13aef64a68d62b98e50288aeb989a98471177b4ddc94dfa8baddd33a74b42ff75eb92133b54e2da1c7f8ddbcb3403182ccda55112df33e2c6bd
+  metadata.gz: bd52c4819554b5cad428d2514379005027aaa21cddf679ae89974edd12568075711e5dbc41b86da656f7df4a6b28ccde88cd421952002cd9966ec0e72b7841cd
+  data.tar.gz: 796f59f291295b5681a920cb5c9d04baa70fb416afc3246db55d1ebbd009f5a6f348d785b57c80b1dd9a07dc249771b67b3bb9203927e41becf0484cf27a6c74

data/README.md

@@ -29,6 +29,8 @@ Wurk is wire-compatible with Sidekiq — same Redis keys, same job JSON, same Ru
 
 **On speed:** Wurk is not currently faster than stock Sidekiq — it runs at roughly 0.87×–1.02× depending on workload shape, with parity on CPU and I/O but still behind on framework overhead (noop) and boot time. Numbers, method, and the reproduction command are in [docs/benchmarks.md](docs/benchmarks.md); run them yourself with `rake bench:vs_sidekiq`.
 
+**Also from us:** [Ultimate](https://github.com/developerz-ai/ultimate) — the AI-first full-stack framework, for a weekend pet project or the system a company runs on. What a whole stack looks like when the one writing the code is an agent, not a human: [`bunx create-ultimate myapp`](#also-from-developerzai-ultimate).
+
 ## Install
 
 ```ruby
@@ -299,6 +301,18 @@ Wurk is MIT and stays that way. If what you need is a commercial support contrac
 
 Full walkthrough — config side-by-side, the Redis key/`sidekiq_options` mapping, known incompatibilities, and a one-page cutover checklist: **[docs/migrate-from-sidekiq.md](https://github.com/developerz-ai/wurk/blob/main/docs/migrate-from-sidekiq.md)**.
 
+## Also from developerz.ai: Ultimate
+
+**[Ultimate](https://github.com/developerz-ai/ultimate) — the AI-first full-stack framework.** Rails' opinions, Bun's speed, one command that means shippable. Wurk is what one AI-maintained *library* looks like; Ultimate is the whole stack built on the same bet — the best framework you can hand a coding agent, whether what you are building is a weekend pet project or the system a company runs on.
+
+```bash
+bunx create-ultimate myapp && cd myapp && x dev
+```
+
+Every framework of the last fifteen years optimised for a human typing the code. Ultimate assumes an agent writes it, and that rewrites the defaults: **one way to do each thing**, so there is nothing to choose between; conventions that are **build errors**, so the compiler corrects the agent instead of a reviewer; errors carrying a stable code, a cause, and the exact command that fixes it, so a failure costs one round-trip; docs shipped in `node_modules` and `--json` on every command, so nothing reaches for a wiki. `x verify` is the whole contract — green means shippable.
+
+TypeScript end to end, MIT, and as measured about its own claims as this file is: what is proven, what is not, and what it refuses to claim yet are all in [its README](https://github.com/developerz-ai/ultimate#readme).
+
 ## Contributing
 
 Issues and pull requests are welcome — see **[CONTRIBUTING.md](https://github.com/developerz-ai/wurk/blob/main/CONTRIBUTING.md)** for the dev setup, test layers, and conventions, and **[SECURITY.md](https://github.com/developerz-ai/wurk/blob/main/SECURITY.md)** to report a vulnerability.

data/lib/wurk/api/validation.rb

@@ -94,13 +94,12 @@ module Wurk
       # one without reopening this file. Baked into the literal rather than
       # appended at load, so the parallel test runner never observes a
       # half-built list.
-      # rubocop:disable Style/MutableConstant
+      # rubocop:disable-next Style/MutableConstant
       JOB_KEYS = %w[
         class args queue at retry jid backtrace tags dead
         retry_for retry_queue expires_in track timeout deadline
         encrypt unique_for unique_until collapse log_level locale wrapped
       ]
-      # rubocop:enable Style/MutableConstant
 
       # `push_bulk`'s envelope keys, on top of the job keys it shares.
       BULK_KEYS = %w[batch_size spread_interval].freeze

data/lib/wurk/stats.rb

@@ -116,9 +116,9 @@ module Wurk
     # Single pipeline for the cheap counters. Eagerly invoked at initialize
     # so callers can read many fields without paying per-method round trips.
     FAST_QUERIES = [
-      ['GET',   'stat:processed'],
-      ['GET',   'stat:failed'],
-      ['GET',   Keys::STAT_EXPIRED],
+      ['GET', 'stat:processed'],
+      ['GET', 'stat:failed'],
+      ['GET', Keys::STAT_EXPIRED],
       ['ZCARD', Keys::SCHEDULE],
       ['ZCARD', Keys::RETRY],
       ['ZCARD', Keys::DEAD],

data/lib/wurk/swarm.rb

@@ -65,6 +65,25 @@ module Wurk
     # them mid-tail, so its own wait always extends past theirs by this much.
     SHUTDOWN_GRACE = 5
 
+    # How often the drain re-relays TERM to whatever is still in the child
+    # table. A child forked in the instant before the drain can miss the first
+    # one outright: from `Process.fork` returning in the child until ChildBoot
+    # resets the inherited traps, the PARENT's handler is what a TERM finds
+    # there, and it writes the signal into the parent's self-pipe (or, once
+    # `fork_child` has dropped that pipe, into nothing) instead of stopping the
+    # child. The child then boots clean, drains nothing, and `wait_for_children`
+    # burns its whole budget before `hard_kill_stragglers` SIGKILLs it — taking
+    # its in-flight jobs with it. The window is the `_fork` hook chain
+    # (ActiveSupport's ForkTracker and friends all run child-side before
+    # `Process.fork` returns), so it widens with load: measured 10.5s drains
+    # against a 2.6s baseline once that chain is slowed. No child-side fix can
+    # close it — the window precedes any code the child controls — so the
+    # supervisor repeats itself instead. Re-sending is safe: by the second pass
+    # the child owns its handler, TERM to a child already draining is a no-op,
+    # and the pids come from the child table, where an exited child is a zombie
+    # until reaped and so can never be a recycled pid.
+    RETERM_INTERVAL = 1.0
+
     # USR2 is relayed (log reopen) — without a trap, a logrotate config that
     # signals the master pid would hit USR2's default disposition and kill the
     # whole swarm.
@@ -341,7 +360,20 @@ module Wurk
     # stall signal delivery if the pipe fills. `exception: false` returns
     # :wait_writable instead of raising when full (drop the coalescible
     # duplicate); a closed pipe during shutdown is ignored too.
+    #
+    # The owner check is what keeps ONE child's signal from draining the whole
+    # fleet. A forked child inherits both this trap and the parent's live pipe,
+    # and `fork_child` cannot drop them until `Process.fork` RETURNS — the
+    # `_fork` hook chain runs child-side before that, so there is a window
+    # where an operator's `kill <child_pid>` writes TERM into the PARENT's
+    # supervise loop and drains every sibling. Measured: with that chain slowed
+    # the way a loaded box does, TERMing a single child killed the supervisor
+    # and all of it. Comparing pids instead closes it with no window at all —
+    # the inherited trap is inert in the child from its first instruction,
+    # because `@owner_pid` was stamped before the fork.
     def emit_signal(sig)
+      return unless owner?
+
       @signal_write&.write_nonblock("#{sig}\n", exception: false)
     rescue ::IOError, ::Errno::EPIPE, ::Errno::EBADF
       nil
@@ -503,8 +535,13 @@ module Wurk
 
     def wait_for_children(timeout)
       deadline = monotonic + timeout
+      reterm_at = monotonic + RETERM_INTERVAL
       while monotonic < deadline && any_children?
         reap_children
+        if monotonic >= reterm_at
+          relay_signal('TERM')
+          reterm_at = monotonic + RETERM_INTERVAL
+        end
         sleep 0.1
       end
     end

data/lib/wurk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wurk
-  VERSION = '1.7.3'
+  VERSION = '1.7.5'
 end

data/vendor/assets/dashboard/wurk-manifest.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.7.3",
-  "timestamp": "2026-08-18T15:19:58.150Z"
+  "version": "1.7.5",
+  "timestamp": "2026-08-27T21:26:34.924Z"
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wurk
 version: !ruby/object:Gem::Version
-  version: 1.7.3
+  version: 1.7.5
 platform: ruby
 authors:
 - developerz.ai