karafka-web 0.11.6 → 1.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5377e1f7c20ed732850895389e9e47be86f94c85068fe363fab13fb52d4f12a4
-  data.tar.gz: f774171188b56858db87e66088436f88dc4d36460743d29152cb3b3fcc7119b2
+  metadata.gz: 27e32327bc795732ee58f5dc757bd1fbe1dbc24198a8561f67cffbb48c5a4eb3
+  data.tar.gz: 81bb5e628233f6acf7d9cf0527ed07517271cc87f4b19cef925dd2e4e3887ef0
 SHA512:
-  metadata.gz: 494a61a08bf0fd768827c05add65ad3d6d13f9e50140d37b25cf9faf9c8f2eecc1b6033612d377fd9cde6fe9d2004817ffa4e1ce8fea1fb24363ca845f979c69
-  data.tar.gz: 3c55088e048fe5a8a861a09d2dabdbea6d4e47423949d3927de646456a5f891628858c377c0bb636e34545d512d3a01887cc25dc55c37bf3904ccc79b3b918de
+  metadata.gz: 935b6515910e2eaf6871c5cb00920cda705935d06449de61410e941dfdb185c7437a2e7fa388244997dcb338efd0221ad7cf9c9e207d0b2fa4237fd9f63166e0
+  data.tar.gz: 9d3fe3b1c638b6a72b729464a2dc5178202fe9158f88aa3d5c692498d82eda3e65760141d5233e43e7bfd083ecd68bbaf2881f97db6a828825498e1771b4bdcf

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Karafka Web Changelog
 
+## 1.0.0 (Unreleased)
+- [Fix] Add `initialize` to `Status::Context` that defines all instance variables upfront in a consistent order, giving every instance the same Ruby object shape and eliminating the `:performance` shape-variation warning.
+- [Enhancement] Add `Warning.process` block to the test helper to turn Ruby warnings originating from the project code into test failures.
+- [Enhancement] Enable all opt-in Ruby warning categories in the test helper via `Warning.categories` (available since Ruby 3.4), so any new categories added in future Ruby versions are automatically enabled without code changes.
+- [Enhancement] Replace sequential per-partition `query_watermark_offsets` consumer calls in `Counters#estimate_errors_count` with a single targeted `topic_info` metadata call followed by a batch `read_watermark_offsets` admin call. This eliminates the consumer connection overhead and reduces Kafka roundtrips from up to N+1 sequential calls to 3 regardless of partition count.
+- [Enhancement] Allow for zero value in number of workers to support dynamic scaling of Karafka workers.
+- [Enhancement] Align concurrency tracking with dynamic thread pool scaling. Workers count is now read from `Karafka::Server.workers.size` instead of the static `Karafka::App.config.concurrency`, so the Web UI accurately reflects runtime thread pool changes.
+- [Enhancement] Track `poll_interval` (max.poll.interval.ms) per subscription group alongside `poll_age` to help users monitor how close they are to the polling timeout limit. Consumer schema version bumped to 1.7.0.
+- [Enhancement] Replace token-based CSRF protection (`route_csrf` plugin) with header-based protection using `Sec-Fetch-Site` header (`sec_fetch_site_csrf` plugin). This eliminates the need for CSRF tokens by leveraging browser-enforced headers that cannot be forged from cross-origin requests. Modern browsers automatically include this header, providing simpler and more robust CSRF protection.
+- [Enhancement] Include a short spec file hash in generated test topic names for traceability. Topic names now follow the `it-{hash}-{uuid}` format, making it easy to identify which test file created a given topic in Kafka logs.
+- [Change] Require Roda `>= 3.100` (previously `~> 3.69`).
+- [Fix] Accept (and ignore) a block in `Karafka::Web::Producer#__getobj__` to silence Ruby 3.4's `strict_unused_block` warning emitted via `SimpleDelegator#method_missing` on every delegated producer call.
+- [Fix] Remove `cgi` as no longer needed.
+- [Fix] Exclude `test/` directory from gem releases to reduce package size.
+- [Fix] Update LinksValidator regexes to match the new `it-{hash}-{uuid}` test topic naming format, fixing test-order dependent failures in explorer controller specs.
+- [Fix] Fix alerts formatting for the distribution view.
+- [Fix] Fix 500 error in the Pro Explorer when a message payload parses as valid JSON but contains strings with invalid UTF-8 byte sequences. `JSON.pretty_generate` would raise `JSON::GeneratorError` outside of any error boundary and propagate as an unhandled 500. The pretty-print step is now wrapped in a dedicated `@safe_pretty_payload` SafeRunner; on failure the raw bytes are displayed alongside a deserialization warning.
+- [Fix] Fix 500 error in the Pro Explorer message JSON export when a payload deserializes correctly but cannot be serialized back to JSON (for example when it contains strings with invalid UTF-8 byte sequences). The export endpoint now responds with 404 in such cases and the export action button is no longer rendered for such messages.
+
 ## 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.

data/Gemfile

@@ -6,12 +6,13 @@ gemspec
 
 group :test do
   gem "byebug"
-  gem "factory_bot"
   gem "fugit"
+  gem "mocha"
   # Needed for links extraction for visits verification
   gem "nokogiri"
   gem "ostruct"
   gem "rack-test"
-  gem "rspec"
+  gem "minitest"
   gem "simplecov"
+  gem "warning"
 end

data/Gemfile.lint

@@ -9,6 +9,6 @@ gem "yard-lint"
 gem "standard"
 gem "standard-performance"
 gem "rubocop-performance"
-gem "rubocop-rspec"
-gem "standard-rspec"
+gem "rubocop-minitest"
+gem "standard-minitest"
 gem "rubocop-thread_safety"

data/Gemfile.lint.lock

@@ -27,23 +27,14 @@ GEM
     rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
-    rubocop-capybara (2.22.1)
+    rubocop-minitest (0.39.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 (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
     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)
@@ -58,15 +49,12 @@ GEM
     standard-custom (1.0.2)
       lint_roller (~> 1.0)
       rubocop (~> 1.50)
+    standard-minitest (1.0.0)
+      lint_roller (~> 1.0)
+      rubocop-minitest
     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)
@@ -81,12 +69,12 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  rubocop-minitest
   rubocop-performance
-  rubocop-rspec
   rubocop-thread_safety
   standard
+  standard-minitest
   standard-performance
-  standard-rspec
   yard-lint
 
 CHECKSUMS
@@ -102,17 +90,14 @@ CHECKSUMS
   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-minitest (0.39.1) sha256=998398d6da4026d297f0f9bf709a1eac5f2b6947c24431f94af08138510cf7ed
   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-minitest (1.0.0) sha256=450caa86a64a6e6f6f186cc88601dbb49b6cfaa3b0dce77a73b50ba8cdc15b2a
   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

data/Gemfile.lock

@@ -1,95 +1,79 @@
 PATH
   remote: .
   specs:
-    karafka-web (0.11.6)
+    karafka-web (1.0.0.beta1)
       erubi (~> 1.4)
-      karafka (>= 2.5.2, < 2.6.0)
-      karafka-core (>= 2.5.0, < 2.6.0)
-      roda (~> 3.69, >= 3.69)
+      karafka (>= 2.5.10.rc1, < 2.7.0)
+      karafka-core (>= 2.5.0, < 2.7.0)
+      roda (>= 3.100, < 4.0)
       tilt (~> 2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.1.1)
-      base64
-      bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.3.1)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      json
-      logger (>= 1.4.2)
-      minitest (>= 5.1)
-      securerandom (>= 0.3)
-      tzinfo (~> 2.0, >= 2.0.5)
-      uri (>= 0.13.1)
-    base64 (0.3.0)
-    bigdecimal (3.3.1)
     byebug (13.0.0)
       reline (>= 0.6.0)
-    concurrent-ruby (1.3.5)
-    connection_pool (2.5.4)
-    diff-lcs (1.6.2)
+    concurrent-ruby (1.3.6)
     docile (1.4.1)
     drb (2.2.3)
     erubi (1.13.1)
     et-orbi (1.4.0)
       tzinfo
-    factory_bot (6.5.6)
-      activesupport (>= 6.1.0)
-    ffi (1.17.2)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86-linux-gnu)
-    ffi (1.17.2-x86-linux-musl)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    fugit (1.12.1)
+    ffi (1.17.4)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-aarch64-linux-musl)
+    ffi (1.17.4-arm-linux-gnu)
+    ffi (1.17.4-arm-linux-musl)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86-linux-gnu)
+    ffi (1.17.4-x86-linux-musl)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    ffi (1.17.4-x86_64-linux-musl)
+    fugit (1.12.2)
       et-orbi (~> 1.4)
       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)
-      karafka-core (>= 2.5.6, < 2.6.0)
-      karafka-rdkafka (>= 0.22.0)
-      waterdrop (>= 2.8.9, < 3.0.0)
+    json (2.19.7)
+    karafka (2.5.10.rc1)
+      karafka-core (>= 2.5.13, < 2.6.0)
+      karafka-rdkafka (>= 0.26.1)
+      waterdrop (>= 2.8.14, < 3.0.0)
       zeitwerk (~> 2.3)
-    karafka-core (2.5.7)
+    karafka-core (2.5.13)
       karafka-rdkafka (>= 0.20.0)
       logger (>= 1.6.0)
-    karafka-rdkafka (0.23.0)
+    karafka-rdkafka (0.27.2)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.23.0-aarch64-linux-gnu)
+    karafka-rdkafka (0.27.2-aarch64-linux-gnu)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.23.0-arm64-darwin)
+    karafka-rdkafka (0.27.2-aarch64-linux-musl)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.23.0-x86_64-linux-gnu)
+    karafka-rdkafka (0.27.2-arm64-darwin)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.23.0-x86_64-linux-musl)
+    karafka-rdkafka (0.27.2-x86_64-linux-gnu)
+      ffi (~> 1.17.1)
+      json (> 2.0)
+      logger
+      mini_portile2 (~> 2.6)
+      rake (> 12)
+    karafka-rdkafka (0.27.2-x86_64-linux-musl)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
@@ -97,70 +81,62 @@ GEM
       rake (> 12)
     logger (1.7.0)
     mini_portile2 (2.8.9)
-    minitest (5.26.1)
-    nokogiri (1.19.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    mocha (3.1.0)
+      ruby2_keywords (>= 0.0.5)
+    nokogiri (1.19.3)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.19.0-aarch64-linux-gnu)
+    nokogiri (1.19.3-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.19.0-aarch64-linux-musl)
+    nokogiri (1.19.3-aarch64-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.19.0-arm-linux-gnu)
+    nokogiri (1.19.3-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.19.0-arm-linux-musl)
+    nokogiri (1.19.3-arm-linux-musl)
       racc (~> 1.4)
-    nokogiri (1.19.0-arm64-darwin)
+    nokogiri (1.19.3-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.19.0-x86_64-darwin)
+    nokogiri (1.19.3-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.19.0-x86_64-linux-gnu)
+    nokogiri (1.19.3-x86_64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.19.0-x86_64-linux-musl)
+    nokogiri (1.19.3-x86_64-linux-musl)
       racc (~> 1.4)
     ostruct (0.6.3)
+    prism (1.9.0)
     raabro (1.4.0)
     racc (1.8.1)
-    rack (3.2.4)
+    rack (3.2.6)
     rack-test (2.2.0)
       rack (>= 1.3)
     rackup (0.2.3)
       rack (>= 3.0.0.beta1)
       webrick
-    rake (13.3.1)
+    rake (13.4.2)
     reline (0.6.3)
       io-console (~> 0.5)
-    roda (3.98.0)
+    roda (3.104.0)
       rack
-    rspec (3.13.2)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.6)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.5)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.7)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.6)
-    securerandom (0.4.1)
+    ruby2_keywords (0.0.5)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    tilt (2.6.1)
+    tilt (2.7.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    uri (1.1.1)
-    waterdrop (2.8.13)
-      karafka-core (>= 2.4.9, < 3.0.0)
-      karafka-rdkafka (>= 0.20.0)
+    warning (1.6.0)
+    waterdrop (2.10.1)
+      karafka-core (>= 2.5.12, < 3.0.0)
+      karafka-rdkafka (>= 0.24.0)
       zeitwerk (~> 2.3)
-    webrick (1.9.1)
-    zeitwerk (2.7.3)
+    webrick (1.9.2)
+    zeitwerk (2.8.2)
 
 PLATFORMS
   aarch64-linux-gnu
@@ -177,15 +153,16 @@ PLATFORMS
 
 DEPENDENCIES
   byebug
-  factory_bot
   fugit
   karafka-web!
+  minitest
+  mocha
   nokogiri
   ostruct
   rack-test
   rackup (~> 0.2)
-  rspec
   simplecov
+  warning
 
 BUNDLED WITH
-   2.7.1
+  4.0.12

data/Rakefile

@@ -2,3 +2,29 @@
 
 require "bundler/setup"
 require "bundler/gem_tasks"
+require "minitest/test_task"
+
+specs_type = ENV.fetch("SPECS_TYPE", "regular")
+
+Minitest::TestTask.create(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_prelude = 'require "test_helper"; require "minitest/autorun"'
+
+  t.test_globs = if specs_type == "pro"
+    ["test/lib/karafka/web/pro/**/*_test.rb"]
+  else
+    # Exclude pro tests from regular test runs
+    [
+      "test/lib/karafka/web/*_test.rb",
+      "test/lib/karafka/web/cli/**/*_test.rb",
+      "test/lib/karafka/web/contracts/**/*_test.rb",
+      "test/lib/karafka/web/management/**/*_test.rb",
+      "test/lib/karafka/web/processing/**/*_test.rb",
+      "test/lib/karafka/web/tracking/**/*_test.rb",
+      "test/lib/karafka/web/ui/**/*_test.rb"
+    ]
+  end
+end
+
+task default: :test

data/bin/{balance_specs → balance_tests}

@@ -1,29 +1,29 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# Balances spec files across N workers using timing data
+# Balances test 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>
+# Usage: bin/balance_tests <regular|pro> <num_workers>
 #
-# Output: JSON array of arrays where each inner array contains the spec files
+# Output: JSON array of arrays where each inner array contains the test 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"]]
+#   bin/balance_tests regular 4
+#   [["test/a.rb","test/d.rb"],["test/b.rb"],["test/c.rb"],["test/e.rb"]]
 
 require 'json'
 
-TIMINGS_DIR = File.expand_path('../spec/timings', __dir__)
+TIMINGS_DIR = File.expand_path('../test/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
+# Loads timing data from a JSON file for the given test type
 #
-# @param specs_type [String] the type of specs ('regular' or 'pro')
+# @param tests_type [String] the type of tests ('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")
+def load_timings(tests_type)
+  file_path = File.join(TIMINGS_DIR, "#{tests_type}.json")
 
   if File.exist?(file_path)
     JSON.parse(File.read(file_path))
@@ -32,37 +32,37 @@ def load_timings(specs_type)
   end
 end
 
-# Returns a sorted list of spec files for the given spec type
+# Returns a sorted list of test files for the given test 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
+# @param tests_type [String] the type of tests ('regular' or 'pro')
+# @return [Array<String>] sorted array of test file paths
+def get_test_files(tests_type)
+  all_tests = Dir.glob('test/lib/karafka/web/**/*_test.rb').sort
 
-  case specs_type
+  case tests_type
   when 'pro'
-    all_specs.select { |f| f.include?('/pro/') }
+    all_tests.select { |f| f.include?('/pro/') }
   when 'regular'
-    all_specs.reject { |f| f.include?('/pro/') }
+    all_tests.reject { |f| f.include?('/pro/') }
   else
-    warn "Unknown specs type: #{specs_type}"
+    warn "Unknown tests type: #{tests_type}"
     exit 1
   end
 end
 
-# Balances spec files across workers using greedy bin-packing algorithm
+# Balances test 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 files [Array<String>] list of test 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
+  # Handle both "./test/..." and "test/..." path formats
   files_with_times = files.map do |file|
     time = timings[file] || timings["./#{file}"] || DEFAULT_TIME
     [file, time]
@@ -101,16 +101,16 @@ def print_balance_info(workers)
 end
 
 # Main
-specs_type = ARGV[0]
+tests_type = ARGV[0]
 num_workers = (ARGV[1] || '4').to_i
 
-unless specs_type
-  warn "Usage: bin/balance_specs <regular|pro> <num_workers>"
+unless tests_type
+  warn "Usage: bin/balance_tests <regular|pro> <num_workers>"
   exit 1
 end
 
-timings = load_timings(specs_type)
-files = get_spec_files(specs_type)
+timings = load_timings(tests_type)
+files = get_test_files(tests_type)
 workers = balance_files(files, timings, num_workers)
 
 # Print balance info to stderr

data/bin/check_coverage

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
 
-# Collates SimpleCov results from parallel spec runs and checks minimum coverage
+# Collates SimpleCov results from parallel test runs and checks minimum coverage
 #
-# This script should be run after bin/rspecs_parallel or bin/rspecs to verify
+# This script should be run after bin/tests_parallel to verify
 # code coverage meets the minimum threshold.
 #
-# Coverage thresholds are defined in spec/support/coverage_config.rb
+# Coverage thresholds are defined in test/support/coverage_config.rb
 
 set -e
 
@@ -13,10 +13,10 @@ echo "Collating SimpleCov coverage results..."
 
 bundle exec ruby -e "
   require 'simplecov'
-  require_relative 'spec/support/coverage_config'
+  require_relative 'test/support/coverage_config'
 
   SimpleCov.collate Dir['coverage/.resultset.json'], 'rails' do
-    add_filter '/spec/'
+    add_filter '/test/'
     add_filter '/vendor/'
     add_filter '/gems/'
     add_filter '/.bundle/'