wurk 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eee8f74b4646a8c8efc7ccd83504f4d88186475b62c07110d427cbc2bb81c540
-  data.tar.gz: 8016408ba51c5ed155b914bb21f2b54abb2a918cb4724532de7f3932fc06479c
+  metadata.gz: e4c0b4f7856306b0cec991a88fa89a2ba86f152598adb27b8b1e34607128c12a
+  data.tar.gz: 4ece7a94d1ddba50dbcb6af3b6e17c6346c7ef90642d5839d1b87cf4a12eb7e7
 SHA512:
-  metadata.gz: d69bf292c551c84ea8d508ce1b639bbd6bcfafed88fd1dc7bded95eebd3b82570d235b1a85fbae67f9dad7eab1a714daa1b6c90c2eba454af83c3cb0ec5c4bc9
-  data.tar.gz: 564be6373cad541391ca36eb31e7e7137dfc4c6e96c44973b886e36ead41ed18cdd761df21b187714a0ed577fa64b03f698e5666fe30a3cd14e9d41440a016ac
+  metadata.gz: ae6268ba18a442b30c692a3017cb6bd5a8b14fa136d5f6ae9edcf3cf5d96df1ac36bc1f5449a78f8d5f237ef70d69720c7b6b3c7a0d8730bdf8ce9ac979c9d0c
+  data.tar.gz: 2269d08c147405889c154e7ed995c346b972c19f0fcb40b42263bf498469b1bc33e297ab1e28f569d7162e3d6b208c3804134d74fbcc4c127e41ebe335b5ef14

data/README.md

@@ -1,6 +1,14 @@
-# Wurk ⚡
+<p align="center">
+  <img src="https://raw.githubusercontent.com/developerz-ai/wurk/main/docs/assets/wurk-logo.png" alt="Wurk — an orc ready to work" width="220">
+</p>
 
-**A 100% drop-in replacement for Sidekiq + Sidekiq Pro + Sidekiq Enterprise. Free forever. Faster.**
+<h1 align="center">Wurk ⚡</h1>
+
+<p align="center"><strong>Wurk, wurk.</strong> 🪓 <em>Ready to work. Zug zug.</em></p>
+
+<p align="center"><strong>A 100% drop-in replacement for Sidekiq + Sidekiq Pro + Sidekiq Enterprise. Free forever. Faster.</strong></p>
+
+<div align="center">
 
 [![Gem Version](https://img.shields.io/gem/v/wurk.svg)](https://rubygems.org/gems/wurk)
 [![CI](https://github.com/developerz-ai/wurk/actions/workflows/test.yml/badge.svg)](https://github.com/developerz-ai/wurk/actions/workflows/test.yml)
@@ -8,6 +16,8 @@
 [![Ruby](https://img.shields.io/badge/ruby-%E2%89%A5%203.2-CC342D.svg)](https://www.ruby-lang.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
+</div>
+
 Wurk is wire-compatible with Sidekiq — same Redis keys, same job JSON, same Ruby DSL. Swap one line in your `Gemfile` and your existing jobs, batches, limiters, cron entries, and live Redis data keep working untouched. The Pro and Enterprise feature sets ship in the same free gem, with no license check and no tiers.
 
 ## Install

data/lib/wurk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wurk
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

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

@@ -1,4 +1,4 @@
 {
-  "version": "0.0.4",
-  "timestamp": "2026-06-01T13:12:27.892Z"
+  "version": "0.0.5",
+  "timestamp": "2026-06-01T13:26:00.506Z"
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wurk
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - developerz.ai
@@ -88,11 +88,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CONTRIBUTING.md
 - LICENSE
 - README.md
-- SECURITY.md
 - app/controllers/wurk/api/pagination.rb
 - app/controllers/wurk/api/serializers.rb
 - app/controllers/wurk/api_controller.rb

data/CHANGELOG.md

@@ -1,67 +0,0 @@
-# Changelog
-
-All notable changes to Wurk are recorded here. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [Semantic Versioning](https://semver.org/).
-
-## [Unreleased]
-
-### Added
-- `Sidekiq::Testing` drop-in: `inline!` / `fake!` / `disable!` (global or block-scoped), the in-memory `Sidekiq::Queues` store, and the `Worker`/`Job` test helpers (`.jobs`, `.clear`, `.drain`, `.perform_one`, `.process_job`, `.drain_all`, `.clear_all`) + `Sidekiq::EmptyQueueError`.
-
-## [0.0.4] - 2026-06-01
-
-### Added
-- `docs/clean-room.md` — compatibility & legal basis: Wurk reimplements the Sidekiq API (clean-room, original implementation), the *Google v. Oracle* rationale, and trademark/nominative-use notes. Linked from the README.
-
-### Changed
-- Dependency refresh. GitHub Actions bumped to current majors (`checkout@v6`, `setup-node@v6`, `upload-artifact@v7`) on Node 24, clearing the Node 20 deprecation. Dashboard frontend upgraded to React 19, React Router 7, Recharts 3, Vite 8, and TypeScript 6. Ruby dev/test gems refreshed to latest.
-
-## [0.0.3] - 2026-06-01
-
-### Changed
-- Gem contact email set to `admin@developerz.ai`.
-
-## [0.0.2] - 2026-06-01
-
-### Changed
-- Releases now publish to RubyGems via GitHub Actions OIDC trusted publishing (`rubygems/release-gem`) — no long-lived API key. Pushing a `v*` tag cuts the release.
-
-### Added
-- Local release helpers: `bin/gem-build`, `bin/gem-login`, `bin/gem-push` for manual/bootstrap publishing.
-
-## [0.0.1] - 2026-06-01
-
-First public (pre-1.0) release. Wurk is a 100% API-compatible drop-in replacement for Sidekiq + Sidekiq Pro + Sidekiq Enterprise — same Redis key schema, same job JSON, same Ruby DSL — with fork-based real parallelism, the full Pro + Enterprise feature set in one free gem (no license check), and a precompiled React dashboard.
-
-### Runtime
-- Fork-based Swarm: parent forks N children with PID supervision, rolling restart (SIGUSR1), graceful drain (SIGTERM/SIGINT) to `shutdown_timeout`, and global pause/resume (SIGTSTP/SIGCONT).
-- Reliable fetcher — atomic `BLMOVE` from the main queue to a per-process private list — with orphan reclamation on boot; Processor runs the middleware chain; Manager owns the thread pool, lifecycle, and heartbeat.
-- Scheduled-set and retry pollers; EVALSHA-cached Lua on the hot paths; per-fork Redis pool over redis-client; Redis-outage client buffer.
-- `reliable_push` opt-in `:raise` overflow policy with a background drainer.
-- Cluster leader election with periodic firing consolidated onto the leader.
-- StatsD metrics across hot paths; liveness HTTP endpoint for Kubernetes probes; expired-job counter for `expires_in`.
-
-### Batches
-- Sidekiq Pro Batch API: `on(:success/:complete/:death)` callbacks, live progress, nested batches, autoflush + linger, nested death cascade, and per-callback rescue.
-
-### Limiters
-- Enterprise rate limiters — concurrent, bucket, window, leaky, and points — each exposing a uniform live `#status` (`used`/`limit`/`reset_at`/`available?`); concurrent additionally reports metric counters. Includes a poison-pill brake.
-
-### Periodic
-- Cron loops (sidekiq-cron compatible): schedule parsing with timezone/DST handling, leader-gated firing, pause/resume, enqueue-now, and fire history.
-
-### Encryption
-- Transparent job-payload encryption with key rotation and graceful failure modes (a decryption failure degrades rather than crashing the worker).
-
-### Dashboard
-- Precompiled React + TypeScript SPA mounted under the engine — consumers never run Node. Tabs: queues, retries, scheduled, dead, busy, processes, batches (+ per-batch detail), limiters, periodic, metrics, and search. SSE live updates, read-only mode, pagination, i18n with host-app override, and a dark default theme.
-
-### Compat
-- `Sidekiq::*` aliases for every public `Wurk::*` class (`Sidekiq::Worker`, `Sidekiq::Batch`, `Sidekiq::Limiter`, `Sidekiq.configure_server`, …) — the drop-in contract.
-- ActiveJob adapter, `IterableJob`, embedded mode, and a standalone `exe/wurk` runner.
-- Sidekiq client/server middleware contract; third-party ecosystem suites (sidekiq-cron, sidekiq-unique-jobs, sidekiq-scheduler, sidekiq-status, sidekiq-failures, sidekiq-throttled) pass against Wurk.
-
-[Unreleased]: https://github.com/developerz-ai/wurk/compare/v0.0.4...HEAD
-[0.0.4]: https://github.com/developerz-ai/wurk/compare/v0.0.3...v0.0.4
-[0.0.3]: https://github.com/developerz-ai/wurk/compare/v0.0.2...v0.0.3
-[0.0.2]: https://github.com/developerz-ai/wurk/compare/v0.0.1...v0.0.2
-[0.0.1]: https://github.com/developerz-ai/wurk/releases/tag/v0.0.1

data/CONTRIBUTING.md

@@ -1,73 +0,0 @@
-# Contributing to Wurk
-
-Thanks for helping make Wurk better. This guide covers local setup, the test
-layers, and the conventions a change has to follow to merge.
-
-## Setup
-
-```sh
-git clone https://github.com/developerz-ai/wurk
-cd wurk
-bundle install
-```
-
-You'll need a local **Redis ≥ 7.0** running (tests use real Redis, never a mock).
-Node is only needed if you touch the dashboard frontend (`frontend/`); the
-precompiled bundle is committed under `vendor/assets/`.
-
-## Running the tests
-
-| Task | Command |
-|---|---|
-| Full suite (parallel) | `bin/rake test` |
-| A single file | `bin/rake test TEST=test/path/to/file_test.rb` |
-| A single test by name | `bin/rake test TEST=test/foo_test.rb TESTOPTS="--name=/pattern/"` |
-| Parity suite (oracles lifted from Sidekiq) | `bin/rake test:parity` |
-| Ecosystem compatibility | `bin/rake test:ecosystem` |
-| Coverage gate | `COVERAGE=1 bin/rake test` |
-| Benchmarks | `bin/rake bench` |
-| Lint | `bundle exec rubocop` |
-
-Test layers:
-
-- **unit** — plain Ruby classes in isolation.
-- **engine** — boots the dummy Rails app in `test/dummy/`.
-- **integration** — real forks + real Redis.
-- **parity** (`test/parity/`) — tests lifted from upstream Sidekiq, SHA-pinned.
-  These are **oracles**: if Wurk diverges, Wurk is wrong unless the divergence
-  is explicitly documented as intentional.
-- **ecosystem** — third-party Sidekiq gem suites run against Wurk.
-
-Never mock Redis in integration or parity tests. Each test uses a unique Redis
-key namespace so the parallel runner stays safe.
-
-## Conventions
-
-These are non-negotiable — they're what keep Wurk a true drop-in:
-
-- **Wire-compat is sacred.** Never change a Redis key, JSON field, or
-  sorted-set score format. If an optimization would break compatibility, drop
-  the optimization.
-- **SOLID, especially SRP.** One reason to change per class — Manager owns
-  lifecycle, Fetcher owns the Redis pop, Processor owns middleware + perform,
-  Client owns enqueue.
-- **Match the spec.** Any public Sidekiq surface must match
-  `docs/target/sidekiq-{free,pro,ent}.md` exactly.
-- **Frozen string literals everywhere**; per-fork Redis pools (never share a
-  socket across a fork).
-- **Comments explain non-obvious _why_**, never restate the code.
-- **Coverage**: line coverage on `lib/` must stay ≥ 90% (the gate blocks PRs
-  below it). Branch coverage is tracked and ratcheting toward 90%.
-
-## Pull requests
-
-1. Branch off `main`.
-2. Keep the change focused; add tests at the right layer.
-3. Run `bin/rake test`, `bin/rake test:parity`, `bin/rake test:ecosystem`, and `bundle exec rubocop` locally.
-4. Open the PR — CI runs the matrix (Ruby 3.2/3.3/3.4 × Rails 7.2/8.0), the
-   coverage gate, the parity job, and benchmarks. The bench bot comments
-   per-benchmark deltas; a real regression fails the check.
-5. Don't `--no-verify` past a failing hook — fix the hook.
-
-By contributing you agree your work is licensed under the project's
-[MIT License](LICENSE).

data/SECURITY.md

@@ -1,39 +0,0 @@
-# Security Policy
-
-## Supported versions
-
-Wurk follows semantic versioning. Security fixes land on the latest minor
-release line.
-
-| Version | Supported |
-|---|---|
-| 1.x | ✅ |
-| < 1.0 | ❌ |
-
-## Reporting a vulnerability
-
-**Please do not open a public issue for security vulnerabilities.**
-
-Report privately through GitHub's
-[**Report a vulnerability**](https://github.com/developerz-ai/wurk/security/advisories/new)
-form (Security → Advisories). This opens a private advisory only the
-maintainers can see.
-
-Please include:
-
-- a description of the issue and its impact,
-- the affected version(s),
-- steps to reproduce or a proof of concept,
-- any suggested remediation.
-
-## What to expect
-
-- **Acknowledgement** within 3 business days.
-- An initial assessment and severity within 7 days.
-- Coordinated disclosure: we'll agree on a timeline with you, ship a patched
-  release, and credit you in the advisory and `CHANGELOG.md` unless you prefer
-  to remain anonymous.
-
-Because Wurk is wire-compatible with Sidekiq and runs your job code with access
-to Redis, reports about deserialization, the dashboard's auth surface, or
-argument encryption are especially welcome.