karafka-web 0.11.5 → 0.11.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24ceb5279e48629e0a1c3a609b1c041323bdedc9faf6cf03dec926c7c0278b4f
-  data.tar.gz: 4ea8f9aef69bb0ee9ac51cc20e132e64e955df2984f6f2359b1c878421793972
+  metadata.gz: 5377e1f7c20ed732850895389e9e47be86f94c85068fe363fab13fb52d4f12a4
+  data.tar.gz: f774171188b56858db87e66088436f88dc4d36460743d29152cb3b3fcc7119b2
 SHA512:
-  metadata.gz: 7861ba705d420ddd875053bb9f687302ad8d2719d332e925cab53075edf267245660e2467934c746f3707327f198538321585b77abe60fcb1bcb49c3c8a1771a
-  data.tar.gz: dd30a59da0ed8590eb471965d1f6e917b15f2a390eb099e4b1527ca1a490dda46695fb3a40cc1e96729f15377a2b74d3a361d593a8b6cf5747fb03ecd4efb461
+  metadata.gz: 494a61a08bf0fd768827c05add65ad3d6d13f9e50140d37b25cf9faf9c8f2eecc1b6033612d377fd9cde6fe9d2004817ffa4e1ce8fea1fb24363ca845f979c69
+  data.tar.gz: 3c55088e048fe5a8a861a09d2dabdbea6d4e47423949d3927de646456a5f891628858c377c0bb636e34545d512d3a01887cc25dc55c37bf3904ccc79b3b918de

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Karafka Web Changelog
 
+## 0.11.6 (2026-02-01)
+- **[Feature]** Provide ability to pause/resume all partitions of a topic at once across all consumer processes via the Health Overview page (Pro). Topic-level commands are broadcast to all processes, and each process applies the command to partitions it owns within the specified consumer group. This simplifies bulk operations compared to pausing/resuming individual partitions one by one.
+- [Enhancement] Optimize partition command tracker to use index-based lookup instead of iterating over 10,000 partitions during rebalance events. The tracker now maintains a partition index for O(n) lookups where n is the number of partitions with pending commands.
+- [Enhancement] Report `group.instance.id` (static membership ID) per subscription group in consumer reports. This enables identifying consumers using Kafka's static group membership feature. The ID is displayed in the per-consumer subscription view header and in Health Overview below each process ID, making it easy to find a process by its static membership ID. Consumer schema version bumped to 1.6.0.
+- [Enhancement] Display `min.insync.replicas` alongside replication factor on the topic replication page with fault tolerance indicators (Pro). Shows specific warnings for different resilience issues: no redundancy (RF=1), zero fault tolerance (RF ≤ minISR), and low durability (minISR=1). Each warning includes impact details, environment-aware severity messaging, and recommended actions. Helps users identify misconfigured topics that would cause outages or data loss.
+- [Enhancement] Add `.options` CSS class for table columns containing action buttons, providing consistent `width: 1%; white-space: nowrap` styling to prevent column width fluctuation.
+- [Enhancement] Add commands topic presence status check for Pro users. Warns when the `karafka_consumers_commands` topic is missing, which is required for commanding features (pause, resume, trace).
+- [Enhancement] Disable "Quiet All" and "Stop All" buttons when only swarm or embedded consumers are running (Pro). These commands only work on standalone consumer processes.
+- [Enhancement] Use low-ack producer variant (`acks: 0`) for Web UI reporting. Since Web UI reporting serves analytical purposes, fire-and-forget semantics minimize latency and overhead while occasional message loss is acceptable. Falls back to the original producer for idempotent/transactional producers.
+- [Refactor] Refactor Status model into a DSL-based architecture with individual check classes. Each status check is now a separate class in `Karafka::Web::Ui::Models::Status::Checks` that declares its dependencies using `depends_on :check_name` DSL. Shared state is managed through a `Context` class, and the `Step` struct has been extracted to its own file. This improves maintainability, testability, and makes it easier to add new status checks in the future.
+- [Fix] Fix session keys to use strings instead of symbols for compatibility with Roda's session management.
+- [Fix] Fix actions and selector alignment in explorer and errors views by wrapping col-span elements in proper grid container.
+
 ## 0.11.5 (2025-11-14)
 - [Enhancement] Utilize newly released Roda session management `:env_key` to isolate Karafka Web session from the main application session.
 

data/Gemfile

@@ -1,18 +1,17 @@
 # frozen_string_literal: true
 
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 gemspec
 
 group :test do
-  gem 'byebug'
-  gem 'factory_bot'
-  gem 'fugit'
+  gem "byebug"
+  gem "factory_bot"
+  gem "fugit"
   # Needed for links extraction for visits verification
-  gem 'nokogiri'
-  gem 'ostruct'
-  gem 'rack-test'
-  gem 'rspec'
-  gem 'simplecov'
-  gem 'yard-lint'
+  gem "nokogiri"
+  gem "ostruct"
+  gem "rack-test"
+  gem "rspec"
+  gem "simplecov"
 end

data/Gemfile.lint

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Documentation linting
+gem "yard-lint"
+
+# Code style (StandardRB via RuboCop)
+gem "standard"
+gem "standard-performance"
+gem "rubocop-performance"
+gem "rubocop-rspec"
+gem "standard-rspec"
+gem "rubocop-thread_safety"

data/Gemfile.lint.lock

@@ -0,0 +1,123 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.8.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    regexp_parser (2.11.3)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-capybara (2.22.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-factory_bot (2.28.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rspec (3.9.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.81)
+    rubocop-rspec_rails (2.32.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+      rubocop-rspec (~> 3.5)
+    rubocop-thread_safety (0.7.3)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    standard (1.53.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.82.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    standard-rspec (0.3.1)
+      lint_roller (>= 1.0)
+      rubocop-capybara (~> 2.22)
+      rubocop-factory_bot (~> 2.27)
+      rubocop-rspec (~> 3.5)
+      rubocop-rspec_rails (~> 2.31)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    yard (0.9.38)
+    yard-lint (1.4.0)
+      yard (~> 0.9)
+      zeitwerk (~> 2.6)
+    zeitwerk (2.7.4)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  rubocop-performance
+  rubocop-rspec
+  rubocop-thread_safety
+  standard
+  standard-performance
+  standard-rspec
+  yard-lint
+
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  json (2.18.0) sha256=b10506aee4183f5cf49e0efc48073d7b75843ce3782c68dbeb763351c08fd505
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
+  prism (1.8.0) sha256=84453a16ef5530ea62c5f03ec16b52a459575ad4e7b9c2b360fd8ce2c39c1254
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  rubocop (1.82.1) sha256=09f1a6a654a960eda767aebea33e47603080f8e9c9a3f019bf9b94c9cab5e273
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop-capybara (2.22.1) sha256=ced88caef23efea53f46e098ff352f8fc1068c649606ca75cb74650970f51c0c
+  rubocop-factory_bot (2.28.0) sha256=4b17fc02124444173317e131759d195b0d762844a71a29fe8139c1105d92f0cb
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  rubocop-rspec (3.9.0) sha256=8fa70a3619408237d789aeecfb9beef40576acc855173e60939d63332fdb55e2
+  rubocop-rspec_rails (2.32.0) sha256=4a0d641c72f6ebb957534f539d9d0a62c47abd8ce0d0aeee1ef4701e892a9100
+  rubocop-thread_safety (0.7.3) sha256=067cdd52fbf5deffc18995437e45b5194236eaff4f71de3375a1f6052e48f431
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  standard (1.53.0) sha256=f3c9493385db7079d0abce6f7582f553122156997b81258cd361d3480eeacf9c
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  standard-rspec (0.3.1) sha256=67bc957281cacf24f0d88235ca1bf28a8995265b1a60eb519cd0451858b56a22
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  yard (0.9.38) sha256=721fb82afb10532aa49860655f6cc2eaa7130889df291b052e1e6b268283010f
+  yard-lint (1.4.0) sha256=7dd88fbb08fd77cb840bea899d58812817b36d92291b5693dd0eeb3af9f91f0f
+  zeitwerk (2.7.4) sha256=2bef90f356bdafe9a6c2bd32bcd804f83a4f9b8bc27f3600fff051eb3edcec8b
+
+BUNDLED WITH
+  4.0.3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    karafka-web (0.11.5)
+    karafka-web (0.11.6)
       erubi (~> 1.4)
       karafka (>= 2.5.2, < 2.6.0)
       karafka-core (>= 2.5.0, < 2.6.0)
@@ -26,7 +26,8 @@ GEM
       uri (>= 0.13.1)
     base64 (0.3.0)
     bigdecimal (3.3.1)
-    byebug (12.0.0)
+    byebug (13.0.0)
+      reline (>= 0.6.0)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.4)
     diff-lcs (1.6.2)
@@ -53,6 +54,7 @@ GEM
       raabro (~> 1.4)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
+    io-console (0.8.2)
     json (2.16.0)
     karafka (2.5.2)
       base64 (~> 0.2)
@@ -96,24 +98,24 @@ GEM
     logger (1.7.0)
     mini_portile2 (2.8.9)
     minitest (5.26.1)
-    nokogiri (1.18.10)
+    nokogiri (1.19.0)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.18.10-aarch64-linux-gnu)
+    nokogiri (1.19.0-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-aarch64-linux-musl)
+    nokogiri (1.19.0-aarch64-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm-linux-gnu)
+    nokogiri (1.19.0-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm-linux-musl)
+    nokogiri (1.19.0-arm-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.18.10-arm64-darwin)
+    nokogiri (1.19.0-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-darwin)
+    nokogiri (1.19.0-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-gnu)
+    nokogiri (1.19.0-x86_64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-musl)
+    nokogiri (1.19.0-x86_64-linux-musl)
       racc (~> 1.4)
     ostruct (0.6.3)
     raabro (1.4.0)
@@ -125,6 +127,8 @@ GEM
       rack (>= 3.0.0.beta1)
       webrick
     rake (13.3.1)
+    reline (0.6.3)
+      io-console (~> 0.5)
     roda (3.98.0)
       rack
     rspec (3.13.2)
@@ -156,10 +160,6 @@ GEM
       karafka-rdkafka (>= 0.20.0)
       zeitwerk (~> 2.3)
     webrick (1.9.1)
-    yard (0.9.37)
-    yard-lint (1.2.3)
-      yard (~> 0.9)
-      zeitwerk (~> 2.6)
     zeitwerk (2.7.3)
 
 PLATFORMS
@@ -186,7 +186,6 @@ DEPENDENCIES
   rackup (~> 0.2)
   rspec
   simplecov
-  yard-lint
 
 BUNDLED WITH
    2.7.1

data/README.md

@@ -4,31 +4,31 @@
 [![Gem Version](https://badge.fury.io/rb/karafka-web.svg)](http://badge.fury.io/rb/karafka-web)
 [![Join the chat at https://slack.karafka.io](https://raw.githubusercontent.com/karafka/misc/master/slack.svg)](https://slack.karafka.io)
 
-Karafka Web UI is a user interface for the [Karafka framework](https://github.com/karafka/karafka). The Web UI provides a convenient way for developers to monitor and manage their Karafka-based applications, without the need to use the command line or third party software.
+Karafka Web UI is a web-based interface for the [Karafka framework](https://github.com/karafka/karafka). The Web UI provides a convenient way for developers to monitor and manage their Kafka-based applications, eliminating the need to use command-line tools or third-party software.
 
-It allows for easy access to various metrics, such as the number of messages consumed, the number of errors, and the number of consumers operating. It also provides a way to view the different Kafka topics, consumers, and groups that are being used by the application.
+It provides easy access to various metrics, including the number of messages consumed, the number of errors, and the number of consumers in operation. It also provides a way to view the various Kafka topics, consumers, and groups used by the application.
 
 > [!IMPORTANT]
-> All of Karafka ecosystems components documentation, including the Web UI, can be found [here](https://karafka.io/docs/#web-ui).
+> Documentation for all ecosystem components, including the Web UI, is available in the [Karafka framework docs Wiki](https://karafka.io/docs/).
 
 ## Getting started
 
-Karafka Web UI documentation is part of the Karafka framework documentation and can be found [here](https://karafka.io/docs).
+To get started with the Karafka Web UI, see the [Web UI](https://karafka.io/docs/#web-ui) chapter of the Karafka documentation Wiki.
 
 ![karafka web ui dashboard](https://raw.githubusercontent.com/karafka/misc/master/printscreens/web-ui.png)
 
 ## Karafka Pro Enhanced Web UI
 
-The Enhanced Web UI, aside from all the features from the OSS version, also offers additional features and capabilities not available in the free version, making it a better option for those looking for more robust monitoring and management capabilities for their Karafka applications. Some of the key benefits of the Enhanced Web UI version include the following:
+The Enhanced Web UI, in addition to all the features from the OSS version, also offers additional features and capabilities not available in the free version, making it a more robust option for those seeking enhanced monitoring and management capabilities for their Karafka applications. Some of the key benefits of the Enhanced Web UI version include the following:
 
-- Real-time and historical processing and utilization metrics.
-- Real-time topics lag awareness.
-- Enhanced consumers utilization metrics providing much better insights into processes resources utilization.
-- Consumer process inspection to quickly analyze the state of a given consuming process.
-- Consumer jobs inspection to view currently running jobs on a per-process basis.
-- Health dashboard containing general consumption overview information
-- Data Explorer allowing for viewing and exploring the data produced to Kafka topics. It understands the routing table and can deserialize data before it is displayed.
-- Enhanced error reporting allowing for backtrace inspection and providing multi-partition support.
-- DLQ / Dead insights allowing to navigate through DLQ topics and messages that were dispatched to them.
+- Real-time and historical processing and utilization metrics
+- Real-time topics lag awareness
+- Enhanced consumer utilization metrics providing much better insights into process and resource utilization
+- Consumer process inspection to quickly analyze the state of a given consuming process
+- Consumer jobs inspection to view currently running jobs on a per-process basis
+- A health dashboard containing general consumption overview information
+- Data Explorer allowing for viewing and exploring the data produced to Kafka topics and understanding the routing table and deserializing data before it is displayed
+- Enhanced error reporting allowing for backtrace inspection and providing multi-partition support
+- DLQ / Dead insights allowing navigation through DLQ topics and messages dispatched
 
-Help me provide high-quality open-source software. Please see the Karafka [homepage](https://karafka.io) for more details.
+Help me provide high-quality open-source software. For more details, see the Karafka [homepage](https://karafka.io).

data/Rakefile

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 
-require 'bundler/setup'
-require 'bundler/gem_tasks'
+require "bundler/setup"
+require "bundler/gem_tasks"

data/bin/balance_specs

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Balances spec files across N workers using timing data
+# Uses greedy bin-packing: assign each file to worker with lowest total time
+#
+# Usage: bin/balance_specs <regular|pro> <num_workers>
+#
+# Output: JSON array of arrays where each inner array contains the spec files
+#         assigned to that worker
+#
+# Example:
+#   bin/balance_specs regular 4
+#   [["spec/a.rb","spec/d.rb"],["spec/b.rb"],["spec/c.rb"],["spec/e.rb"]]
+
+require 'json'
+
+TIMINGS_DIR = File.expand_path('../spec/timings', __dir__)
+DEFAULT_TIME = 1.0 # Default time for files not in timing data
+
+# Loads timing data from a JSON file for the given spec type
+#
+# @param specs_type [String] the type of specs ('regular' or 'pro')
+# @return [Hash<String, Float>] hash mapping file paths to execution times in seconds
+def load_timings(specs_type)
+  file_path = File.join(TIMINGS_DIR, "#{specs_type}.json")
+
+  if File.exist?(file_path)
+    JSON.parse(File.read(file_path))
+  else
+    {}
+  end
+end
+
+# Returns a sorted list of spec files for the given spec type
+#
+# @param specs_type [String] the type of specs ('regular' or 'pro')
+# @return [Array<String>] sorted array of spec file paths
+def get_spec_files(specs_type)
+  all_specs = Dir.glob('spec/lib/karafka/web/**/*_spec.rb').sort
+
+  case specs_type
+  when 'pro'
+    all_specs.select { |f| f.include?('/pro/') }
+  when 'regular'
+    all_specs.reject { |f| f.include?('/pro/') }
+  else
+    warn "Unknown specs type: #{specs_type}"
+    exit 1
+  end
+end
+
+# Balances spec files across workers using greedy bin-packing algorithm
+#
+# Files are sorted by execution time (descending) and each file is assigned
+# to the worker with the lowest total time. This minimizes the imbalance
+# between the slowest and fastest workers.
+#
+# @param files [Array<String>] list of spec file paths to balance
+# @param timings [Hash<String, Float>] hash mapping file paths to execution times
+# @param num_workers [Integer] number of workers to distribute files across
+# @return [Array<Hash>] array of worker hashes, each with :files and :total_time keys
+def balance_files(files, timings, num_workers)
+  # Get timing for each file, using default if not found
+  # Handle both "./spec/..." and "spec/..." path formats
+  files_with_times = files.map do |file|
+    time = timings[file] || timings["./#{file}"] || DEFAULT_TIME
+    [file, time]
+  end
+
+  # Sort by time descending (largest first for better bin packing)
+  files_with_times.sort_by! { |_, time| -time }
+
+  # Initialize workers
+  workers = Array.new(num_workers) { { files: [], total_time: 0.0 } }
+
+  # Greedy assignment: assign each file to worker with lowest total time
+  files_with_times.each do |file, time|
+    # Find worker with minimum total time
+    min_worker = workers.min_by { |w| w[:total_time] }
+    min_worker[:files] << file
+    min_worker[:total_time] += time
+  end
+
+  workers
+end
+
+# Prints balance information to stderr for debugging/visibility
+#
+# @param workers [Array<Hash>] array of worker hashes with :files and :total_time keys
+def print_balance_info(workers)
+  total_time = workers.sum { |w| w[:total_time] }
+  max_time = workers.max_by { |w| w[:total_time] }[:total_time]
+  min_time = workers.min_by { |w| w[:total_time] }[:total_time]
+
+  warn "Balance info:"
+  workers.each_with_index do |worker, i|
+    warn "  Worker #{i + 1}: #{worker[:files].size} files, #{worker[:total_time].round(1)}s"
+  end
+  warn "  Total: #{total_time.round(1)}s, Max: #{max_time.round(1)}s, Imbalance: #{(max_time - min_time).round(1)}s"
+end
+
+# Main
+specs_type = ARGV[0]
+num_workers = (ARGV[1] || '4').to_i
+
+unless specs_type
+  warn "Usage: bin/balance_specs <regular|pro> <num_workers>"
+  exit 1
+end
+
+timings = load_timings(specs_type)
+files = get_spec_files(specs_type)
+workers = balance_files(files, timings, num_workers)
+
+# Print balance info to stderr
+print_balance_info(workers)
+
+# Output file lists as JSON array of arrays
+puts JSON.generate(workers.map { |w| w[:files] })

data/bin/check_coverage

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Collates SimpleCov results from parallel spec runs and checks minimum coverage
+#
+# This script should be run after bin/rspecs_parallel or bin/rspecs to verify
+# code coverage meets the minimum threshold.
+#
+# Coverage thresholds are defined in spec/support/coverage_config.rb
+
+set -e
+
+echo "Collating SimpleCov coverage results..."
+
+bundle exec ruby -e "
+  require 'simplecov'
+  require_relative 'spec/support/coverage_config'
+
+  SimpleCov.collate Dir['coverage/.resultset.json'], 'rails' do
+    add_filter '/spec/'
+    add_filter '/vendor/'
+    add_filter '/gems/'
+    add_filter '/.bundle/'
+    add_filter '/doc/'
+    add_filter '/config/'
+    enable_coverage :branch
+    minimum_coverage(
+      line: CoverageConfig::LINE_COVERAGE,
+      branch: CoverageConfig::BRANCH_COVERAGE
+    )
+  end
+"

data/bin/collect_timings

@@ -0,0 +1,83 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Collects timing data from RSpec runs for both regular and pro specs.
+# Results are stored in spec/timings/{regular,pro}.json for use by bin/balance_specs.
+#
+# Usage: bin/collect_timings
+
+require 'json'
+require 'open3'
+require 'fileutils'
+
+TIMINGS_DIR = File.expand_path('../spec/timings', __dir__)
+
+# Returns spec files for the given type
+#
+# @param specs_type [String] 'regular' or 'pro'
+# @return [Array<String>] sorted array of spec file paths
+def spec_files(specs_type)
+  all_specs = Dir.glob('spec/lib/karafka/web/**/*_spec.rb').sort
+
+  case specs_type
+  when 'pro' then all_specs.select { |f| f.include?('/pro/') }
+  when 'regular' then all_specs.reject { |f| f.include?('/pro/') }
+  end
+end
+
+# Collects timing data by running specs with JSON output
+#
+# @param specs_type [String] 'regular' or 'pro'
+# @return [Hash<String, Float>] file paths to execution times in seconds
+def collect_timings(specs_type)
+  puts "Collecting #{specs_type} specs timings..."
+
+  env = { 'SPECS_TYPE' => specs_type }
+  files = spec_files(specs_type)
+
+  puts "  Running #{files.size} spec files..."
+
+  # Run all specs at once with JSON output
+  cmd = ['bundle', 'exec', 'rspec', *files, '--format', 'json']
+  stdout, _stderr, _status = Open3.capture3(env, *cmd)
+
+  # Parse timing from JSON output
+  data = JSON.parse(stdout)
+  timings = {}
+
+  data['examples'].each do |example|
+    file = example['file_path']
+    timings[file] ||= 0
+    timings[file] += example['run_time'] || 0
+  end
+
+  timings.transform_values! { |v| v.round(3) }
+  timings
+end
+
+# Saves timing data to JSON file
+#
+# @param specs_type [String] 'regular' or 'pro'
+# @param timings [Hash<String, Float>] timing data
+def save_timings(specs_type, timings)
+  FileUtils.mkdir_p(TIMINGS_DIR)
+  file_path = File.join(TIMINGS_DIR, "#{specs_type}.json")
+
+  sorted = timings.sort_by { |_, time| -time }.to_h
+  File.write(file_path, JSON.pretty_generate(sorted))
+
+  total = timings.values.sum
+  puts "  Saved #{file_path}: #{timings.size} files, #{total.round(1)}s total"
+end
+
+# Main
+puts '=== Collecting Spec Timings ==='
+puts
+
+%w[regular pro].each do |specs_type|
+  timings = collect_timings(specs_type)
+  save_timings(specs_type, timings)
+  puts
+end
+
+puts 'Done!'

data/bin/rspecs

@@ -1,10 +1,20 @@
 #!/usr/bin/env bash
 
+# Runs all specs sequentially (regular then pro)
+# For parallel execution, use bin/rspecs_parallel
+
 set -e
 
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "Running specs in sequential mode..."
+
 SPECS_TYPE=regular bundle exec rspec \
   spec/lib \
   --exclude-pattern "**/pro/**/*_spec.rb"
 
 SPECS_TYPE=pro bundle exec rspec \
   spec/lib/karafka/web/pro
+
+# Run coverage check
+"$SCRIPT_DIR/check_coverage"