judges 0.42.1 → 0.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08d3de03e1b95604d047cef9fc57b854df50472735347fa9eefdb760ade40b2f'
-  data.tar.gz: cfabae3261cdbbfe3a0960f30bde15705c2934f9acbba96032832fb88b1e69d1
+  metadata.gz: bc9d8bdc800247520e9f42a07f90143c7c3fcf505a4a993221d7aa8437b11611
+  data.tar.gz: 21d88232ebe5299cf672945ab83c702a3c942d984f233bd9f714fb2cdb846609
 SHA512:
-  metadata.gz: 83c656135bbaae9ee295b8022ec3a6105fb2be8f9fecbac23cb28c1402d72260ae03872eb887fbe1224a989e7bf41512724b01d3687a9c78673757ded36927f3
-  data.tar.gz: 11df07fc1c6049286aaac01f7af3c3fe6dc75cad176b3907dd2cb006f7ecc9936ea49b43949143874e42a7590fbc08662eec4f8013b792e808ee0be6736923da
+  metadata.gz: eb1ac7d1219d4f901c5856e8c2698c4e77eaf5a3b0f8f0658bc94e1304f5597b3cada4a9c1ba85660bbaebd81a2e03cea58a92b7ba8e1a2c820e3403ea269a60
+  data.tar.gz: a9937c3f3d031d3d2c6e1265d8ccc2bf0365ffcda171d539bdf03a22d68d6a3d887a6010beb876c17fd1f2a31cd38d06d0e7473861bc3e6cb2a21b62857041a3

data/.github/workflows/eslint.yml

@@ -16,6 +16,5 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-      - run: npm install -g eslint@9.17.0
-      - run: npm install @eslint/js
-      - run: eslint
+      - run: npm install
+      - run: npx eslint .

data/.github/workflows/markdown-lint.yml

@@ -20,4 +20,4 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-      - uses: articulate/actions-markdownlint@v1
+      - uses: DavidAnson/markdownlint-cli2-action@v20.0.0

data/.gitignore

@@ -9,3 +9,4 @@ node_modules/
 rdoc/
 temp/
 vendor/
+.claude

data/Gemfile.lock

@@ -78,6 +78,7 @@ GEM
     elapsed (0.0.1)
       loog (> 0)
       tago (> 0)
+    erb (5.0.1)
     ethon (0.16.0)
       ffi (>= 1.15.0)
     factbase (0.10.2)
@@ -111,7 +112,7 @@ GEM
     ffi (1.17.2-x86_64-linux-gnu)
     gli (2.22.2)
       ostruct
-    hashdiff (1.1.2)
+    hashdiff (1.2.0)
     iri (0.10.0)
     json (2.12.0)
     language_server-protocol (3.17.0.5)
@@ -172,12 +173,13 @@ GEM
     rake (13.2.1)
     random-port (0.7.5)
       tago (> 0)
-    rdoc (6.13.1)
+    rdoc (6.14.0)
+      erb
       psych (>= 4.0.0)
     regexp_parser (2.10.0)
     retries (0.0.5)
     rexml (3.4.1)
-    rubocop (1.75.6)
+    rubocop (1.75.7)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)

data/assets/index.js

@@ -1,7 +1,7 @@
 /*
- SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
- SPDX-License-Identifier: MIT
-*/
+ * SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
+ */
 
 $(() => {
   $('#facts').tablesorter();

data/bin/judges

@@ -23,7 +23,7 @@ class JudgesGLI extend GLI::App
       start = Time.now
       @@loog.debug("Running '#{ruby}' command...")
       Object.const_get("Judges::#{ruby.capitalize}").new(@@loog).run(options, args)
-      @@loog.debug("Command '#{ruby}' finished in #{start.ago}")
+      @@loog.debug("Command '#{ruby}' completed in #{start.ago}")
     end
   end
 
@@ -37,9 +37,9 @@ class JudgesGLI extend GLI::App
 
   subcommand_option_handling(:normal)
 
-  desc 'Make it more verbose, logging as much as possible'
+  desc 'Enable verbose mode with maximum logging'
   switch([:v, :verbose])
-  desc 'Version of Factbase to use'
+  desc 'Specify Factbase version to use'
   flag([:factbase], type: String)
 
   pre do |global, command, options, args|
@@ -61,36 +61,40 @@ class JudgesGLI extend GLI::App
     true
   end
 
-  desc 'Update the factbase by passing all judges one by one'
+  desc 'Update the factbase by executing all judges sequentially'
   command :update do |c|
-    c.desc 'Options to pass to every judge'
+    c.desc 'Options to pass to each judge'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
-    c.desc 'File with options, one k=v pair per line'
+    c.desc 'File containing options, one key=value pair per line'
     c.flag([:'options-file'])
     c.desc 'Name of the judge to run (directory name)'
     c.flag([:judge], multiple: true)
-    c.desc 'The location of a Ruby library (directory with .rb files to include)'
+    c.desc 'Location of a Ruby library (directory with .rb files to include)'
     c.flag([:lib])
-    c.desc 'Shuffle them, except the ones that start with the prefix'
+    c.desc 'Shuffle judges, except those starting with the specified prefix'
     c.flag([:shuffle], default_value: '')
-    c.desc 'Boost one judge, running it on top of all others'
+    c.desc 'Prioritize a judge to run before all others'
     c.flag([:boost], multiple: true)
-    c.desc 'Maximum time in seconds to spend on the entire update cycle'
+    c.desc 'Maximum time in seconds for the entire update cycle'
     c.flag([:lifetime], default_value: 300, type: Integer)
-    c.desc 'Maximum time in seconds to spend on every judge (forcefully terminate if over time)'
+    c.desc 'Maximum time in seconds for each judge (forcefully terminates if exceeded)'
     c.flag([:timeout], default_value: 30, type: Integer)
     c.desc 'Maximum number of update cycles to run'
     c.flag([:'max-cycles'], default_value: 8, type: Integer)
-    c.desc 'Stay quiet even if some judges fail'
+    c.desc 'Suppress errors even when judges fail'
     c.switch([:q, :quiet], default_value: false)
-    c.desc 'Place a summarization fact into the factbase'
+    c.desc 'Stop processing immediately after the first error'
+    c.switch([:'fail-fast'], default_value: false)
+    c.desc 'Add a summary fact to the factbase'
     c.switch([:summary], default_value: false)
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
+    c.desc 'Expect at least one judge to be used (fail if none are used)'
+    c.switch([:'expect-judges'], default_value: true)
     run_it(c, 'update')
   end
 
-  desc 'Evaluate a single Ruby expression on the factbase'
+  desc 'Evaluate a single Ruby expression against the factbase'
   command :eval do |c|
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
@@ -109,40 +113,40 @@ class JudgesGLI extend GLI::App
     run_it(c, 'import')
   end
 
-  desc 'Remove the facts that are too old'
+  desc 'Remove outdated facts from the factbase'
   command :trim do |c|
-    c.desc 'Only the facts that match the expression are deleted'
+    c.desc 'Delete only facts matching the specified expression'
     c.flag([:query], default_value: '(never)')
     run_it(c, 'trim')
   end
 
-  desc 'Print the factbase into a human-readable format (YAML, JSON, etc.)'
+  desc 'Convert the factbase to a human-readable format (YAML, JSON, etc.)'
   command :print do |c|
     c.desc 'Output format (xml, json, or yaml)'
     c.flag([:format], default_value: 'yaml')
-    c.desc 'Generate output name of the file automatically'
+    c.desc 'Automatically generate the output filename'
     c.switch([:auto], default_value: false)
-    c.desc 'The title of the document to use'
+    c.desc 'Document title to use'
     c.flag([:title], default_value: 'summary')
-    c.desc 'Only the facts that match the expression are printed'
+    c.desc 'Print only facts matching the specified expression'
     c.flag([:query], default_value: '(always)')
-    c.desc 'Comma separated list of columns to show in HTML output (no spaces!)'
+    c.desc 'Comma-separated list of columns to display in HTML output (no spaces)'
     c.flag([:columns], default_value: 'when,what')
-    c.desc 'Comma separated list of hidden columns, not to be rendered (no spaces!)'
+    c.desc 'Comma-separated list of columns to hide from rendering (no spaces)'
     c.flag([:hidden], default_value: '_id,_time,_version,_job')
-    c.desc 'Print even if target file already exists and is older than the factbase'
+    c.desc 'Force printing even if the target file exists and is older than the factbase'
     c.switch([:force], default_value: false)
     run_it(c, 'print')
   end
 
-  desc 'Inspect the factbase and print all its possible meta-data'
+  desc 'Inspect the factbase and display all available metadata'
   command :inspect do |c|
     run_it(c, 'inspect')
   end
 
   desc 'Run automated tests for all judges'
   command :test do |c|
-    c.desc 'Options to pass to every judge (may be overwritten by YAML)'
+    c.desc 'Options to pass to each judge (may be overridden by YAML)'
     c.flag([:o, :option], multiple: true, arg_name: '<key=value>')
     c.desc 'Categories of tests to disable'
     c.flag([:disable], multiple: true)
@@ -150,57 +154,57 @@ class JudgesGLI extend GLI::App
     c.flag([:enable], multiple: true)
     c.desc 'Name of the judge to run (directory name)'
     c.flag([:judge], multiple: true)
-    c.desc 'How many times to run?'
+    c.desc 'Number of times to run the tests'
     c.flag([:runs], type: Integer)
-    c.desc 'The location of a Ruby library (directory with .rb files to include)'
+    c.desc 'Location of a Ruby library (directory with .rb files to include)'
     c.flag([:lib])
-    c.desc 'Stay quiet even if some tests fail or simply no tests executed?'
+    c.desc 'Suppress output even if tests fail or none are executed'
     c.switch([:quiet], default_value: false)
     c.desc 'Use default logging facility'
     c.switch([:log], default_value: true)
     run_it(c, 'test')
   end
 
-  desc 'Push the factbase to the server and unlock it over there'
+  desc 'Push the factbase to the server and unlock it remotely'
   command :push do |c|
     c.desc 'Authentication token'
     c.flag([:token])
-    c.desc 'The IP/hostname of the server'
+    c.desc 'Server IP/hostname'
     c.flag([:host], default_value: 'api.zerocracy.com')
-    c.desc 'The TCP port number of the server'
+    c.desc 'Server TCP port number'
     c.flag([:port], default_value: 443, type: Integer)
-    c.desc 'Connection and read time in seconds'
+    c.desc 'Connection and read timeout in seconds'
     c.flag([:timeout], default_value: 30, type: Integer)
-    c.desc 'Shall SSL be used?'
+    c.desc 'Enable SSL connection'
     c.switch([:ssl], default_value: true)
-    c.desc 'A unique name to use for a lock/unlock'
+    c.desc 'Unique identifier for lock/unlock operations'
     c.flag([:owner], default_value: 'default', type: String)
-    c.desc 'Supplementary meta information about the upload (key:value)'
+    c.desc 'Additional metadata for the upload (key:value format)'
     c.flag([:meta], type: String, multiple: true)
-    c.desc 'How many times to retry'
+    c.desc 'Number of retry attempts'
     c.flag([:retries], type: Integer, default_value: 3)
-    c.desc 'Turn on the package compression'
+    c.desc 'Enable package compression'
     c.switch([:zip], default_value: true)
     run_it(c, 'push')
   end
 
-  desc 'Pull the factbase from the server and lock it over there'
+  desc 'Pull the factbase from the server and lock it remotely'
   command :pull do |c|
     c.desc 'Authentication token'
     c.flag([:token])
-    c.desc 'How many seconds to wait'
+    c.desc 'Maximum wait time in seconds'
     c.flag([:wait], default_value: 10 * 60, arg_name: '<seconds>', type: Integer)
-    c.desc 'The IP/hostname of the server'
+    c.desc 'Server IP/hostname'
     c.flag([:host], default_value: 'api.zerocracy.com')
-    c.desc 'The TCP port number of the server'
+    c.desc 'Server TCP port number'
     c.flag([:port], default_value: 443, type: Integer)
-    c.desc 'Connection and read time in seconds'
+    c.desc 'Connection and read timeout in seconds'
     c.flag([:timeout], default_value: 30, type: Integer)
-    c.desc 'Shall SSL be used?'
+    c.desc 'Enable SSL connection'
     c.switch([:ssl], default_value: true)
-    c.desc 'A unique name to use for a lock/unlock'
+    c.desc 'Unique identifier for lock/unlock operations'
     c.flag([:owner], default_value: 'default', type: String)
-    c.desc 'How many times to retry'
+    c.desc 'Number of retry attempts'
     c.flag([:retries], type: Integer, default_value: 3)
     run_it(c, 'pull')
   end

data/features/import.feature

@@ -16,5 +16,5 @@ Feature: Import
       z: 3.14
     """
     Then I run bin/judges with "--verbose import simple.yaml simple.fb"
-    Then Stdout contains "Import of 2 facts finished"
+    Then Stdout contains "Import of 2 facts completed"
     And Exit code is zero

data/features/update.feature

@@ -15,7 +15,7 @@ Feature: Update
     Then Stdout contains "FOO → "
     Then Stdout contains "BAR → "
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 3 cycle(s), did 3i/0d/3a"
+    Then Stdout contains "Update completed in 3 cycle(s), did 3i/0d/3a"
     And Exit code is zero
 
   Scenario: Generate a summary fact, with errors
@@ -39,7 +39,7 @@ Feature: Update
     """
     Then I run bin/judges with "--verbose update --quiet --lifetime 1 --max-cycles 5 . simple.fb"
     Then Stdout contains "The 'simple' judge skipped, no time left"
-    Then Stdout contains "Update finished in 2 cycle(s), did 1i/0d/0a"
+    Then Stdout contains "Update completed in 2 cycle(s), did 1i/0d/0a"
     And Exit code is zero
 
   Scenario: Use options from a file
@@ -57,7 +57,7 @@ Feature: Update
     Then Stdout contains "A1 → "
     Then Stdout contains "A2 → "
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished"
+    Then Stdout contains "Update completed"
     And Exit code is zero
 
   Scenario: Simple run with a timeout for a judge
@@ -71,7 +71,7 @@ Feature: Update
     Then Stdout contains "execution expired"
     Then Stdout contains "judge timed out after"
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 1 cycle(s), did 0i/0d/0a"
+    Then Stdout contains "Update completed in 1 cycle(s), did 0i/0d/0a"
     And Exit code is zero
 
   Scenario: Simple run of a few judges, with a lib
@@ -87,7 +87,7 @@ Feature: Update
     """
     Then I run bin/judges with "update --lib mylib --max-cycles 1 mine simple.fb"
     Then Stdout contains "1 judge(s) processed"
-    Then Stdout contains "Update finished in 1 cycle(s)"
+    Then Stdout contains "Update completed in 1 cycle(s)"
     And Exit code is zero
 
   Scenario: The update fails when a bug in a judge

data/judges.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.2'
   s.name = 'judges'
-  s.version = '0.42.1'
+  s.version = '0.44.0'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =

data/lib/judges/commands/eval.rb

@@ -22,7 +22,7 @@ class Judges::Eval
     @loog = loog
   end
 
-  # Run the eval command.
+  # Run the eval command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
   # @raise [RuntimeError] If not exactly two arguments provided
@@ -40,7 +40,7 @@ class Judges::Eval
       eval(expr)
       # rubocop:enable Security/Eval
       impex.export($fb)
-      throw :'Evaluated successfully'
+      throw :'👍 Evaluated successfully'
     end
   end
 end

data/lib/judges/commands/import.rb

@@ -24,7 +24,7 @@ class Judges::Import
     @loog = loog
   end
 
-  # Run the import command.
+  # Run the import command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
   # @raise [RuntimeError] If not exactly two arguments provided or file not found
@@ -47,7 +47,7 @@ class Judges::Import
         end
       end
       impex.export(fb)
-      throw :"Import of #{yaml.size} facts finished"
+      throw :"👍 Import of #{yaml.size} facts completed"
     end
   end
 end

data/lib/judges/commands/inspect.rb

@@ -21,12 +21,12 @@ class Judges::Inspect
     @loog = loog
   end
 
-  # Run the inspect command.
+  # Run the inspect command (called by the +bin/judges+ script).
   # @param [Hash] _opts Command line options (not used)
   # @param [Array] args List of command line arguments
   # @raise [RuntimeError] If no arguments provided
   def run(_opts, args)
-    raise 'At lease one argument required' if args.empty?
+    raise 'At least one argument required' if args.empty?
     fb = Judges::Impex.new(@loog, args[0]).import
     @loog.info("Facts: #{fb.size}")
   end

data/lib/judges/commands/join.rb

@@ -22,7 +22,7 @@ class Judges::Join
     @loog = loog
   end
 
-  # Run the join command.
+  # Run the join command (called by the +bin/judges+ script).
   # @param [Hash] _opts Command line options (not used)
   # @param [Array] args List of command line arguments
   # @raise [RuntimeError] If not exactly two arguments provided
@@ -34,7 +34,7 @@ class Judges::Join
       fb = master.import
       slave.import_to(fb)
       master.export(fb)
-      throw :'Two factbases joined'
+      throw :'👍 Two factbases joined successfully'
     end
   end
 end

data/lib/judges/commands/print.rb

@@ -29,11 +29,12 @@ class Judges::Print
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the print command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If no arguments provided
   def run(opts, args)
-    raise 'At lease one argument required' if args.empty?
+    raise 'At least one argument required' if args.empty?
     f = args[0]
     fb = Judges::Impex.new(@loog, f).import
     fb.query("(not #{opts['query']})").delete! unless opts['query'].nil?
@@ -70,7 +71,7 @@ class Judges::Print
             raise "Unknown format '#{fmt}'"
         end
       File.binwrite(o, output)
-      throw :"Factbase printed to #{o.to_rel} (#{File.size(o)} bytes)"
+      throw :"👍 Factbase printed to #{o.to_rel} (#{File.size(o)} bytes)"
     end
   end
 

data/lib/judges/commands/pull.rb

@@ -25,9 +25,10 @@ class Judges::Pull
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the pull command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     fb = Factbase.new
@@ -54,9 +55,9 @@ class Judges::Pull
           baza.unlock(name, opts['owner'])
           raise e
         end
-        throw :"Pulled #{fb.size} facts by the name '#{name}'"
+        throw :"👍 Pulled #{fb.size} facts by name '#{name}'"
       else
-        throw :"There is nothing to pull, the name '#{name}' is absent on the server"
+        throw :"⚠️ Nothing to pull - name '#{name}' not found on server"
       end
     end
   end
@@ -69,7 +70,7 @@ class Judges::Pull
     loop do
       break if baza.finished?(id)
       sleep 1
-      raise "Time is over, the job ##{id} ('#{name}') is still not finished" if Time.now - start > limit
+      raise "Time is over, the job ##{id} ('#{name}') is still not completed" if Time.now - start > limit
       lapsed = Time.now - start
       @loog.debug("Still waiting for the job ##{id} ('#{name}') to finish... (#{format('%.2f', lapsed)}s already)")
     end

data/lib/judges/commands/push.rb

@@ -25,9 +25,10 @@ class Judges::Push
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the push command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     name = args[0]
@@ -44,7 +45,7 @@ class Judges::Push
       baza.lock(name, opts['owner'])
       begin
         id = baza.push(name, fb.export, opts['meta'] || [])
-        throw :"Pushed #{fb.size} facts, job ID is #{id}"
+        throw :"👍 Pushed #{fb.size} facts, job ID is #{id}"
       ensure
         baza.unlock(name, opts['owner'])
       end

data/lib/judges/commands/test.rb

@@ -29,9 +29,10 @@ class Judges::Test
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the test command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly one argument provided
   def run(opts, args)
     raise 'Exactly one argument required' unless args.size == 1
     dir = args[0]

data/lib/judges/commands/trim.rb

@@ -23,18 +23,19 @@ class Judges::Trim
     @loog = loog
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
+  # Run the trim command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly one argument provided
   def run(opts, args)
     raise 'Exactly one argument required' unless args.size == 1
     impex = Judges::Impex.new(@loog, args[0])
     fb = impex.import
     elapsed(@loog, level: Logger::INFO) do
       deleted = fb.query(opts['query']).delete!
-      throw :'No facts deleted' if deleted.zero?
+      throw :'⚠️ No facts deleted' if deleted.zero?
       impex.export(fb)
-      throw :"🗑 #{deleted} fact(s) deleted"
+      throw :"👍 #{deleted} fact(s) deleted"
     end
   end
 end

data/lib/judges/commands/update.rb

@@ -33,10 +33,10 @@ class Judges::Update
     @start = Time.now
   end
 
-  # Run it (it is supposed to be called by the +bin/judges+ script.
-  #
+  # Run the update command (called by the +bin/judges+ script).
   # @param [Hash] opts Command line options (start with '--')
   # @param [Array] args List of command line arguments
+  # @raise [RuntimeError] If not exactly two arguments provided or directory is missing
   def run(opts, args)
     raise 'Exactly two arguments required' unless args.size == 2
     dir = args[0]
@@ -81,9 +81,13 @@ class Judges::Update
           @loog.info("Too many cycles already, as set by --max-cycles=#{opts['max-cycles']}, breaking")
           break
         end
+        if opts['fail-fast'] && !errors.empty?
+          @loog.info("Due to #{errors.count} errors we must stop at the update cycle ##{c}")
+          break
+        end
         @loog.info("The cycle #{c} did #{delta}")
       end
-      throw :"Update finished in #{c} cycle(s), did #{churn}"
+      throw :"👍 Update completed in #{c} cycle(s), did #{churn}"
     end
     return unless opts['summary']
     summarize(fb, churn, errors, start, c)
@@ -141,11 +145,17 @@ class Judges::Update
   def cycle(opts, judges, fb, options, start, errors)
     churn = Factbase::Churn.new
     global = {}
+    used = 0
     elapsed(@loog, level: Logger::INFO) do
       done =
         judges.each_with_index do |judge, i|
+          if opts['fail-fast'] && !errors.empty?
+            @loog.info("Not running #{judge.name.inspect} due to #{errors.count} errors above, in --fail-fast mode")
+            next
+          end
           next unless include?(opts, judge.name)
           @loog.info("\n👉 Running #{judge.name} (##{i}) at #{judge.dir.to_rel} (#{start.ago} already)...")
+          used += 1
           elapsed(@loog, level: Logger::INFO) do
             c = one_judge(opts, fb, judge, global, options, errors)
             churn += c
@@ -158,6 +168,10 @@ class Judges::Update
       throw :"👍 #{done} judge(s) processed" if errors.empty?
       throw :"❌ #{done} judge(s) processed with #{errors.size} errors"
     end
+    if used.zero?
+      raise 'No judges were used, while at least one expected to run' if opts['expect-judges']
+      @loog.info('No judges were used (looks like an error); not failing because of --no-expect-judges')
+    end
     unless errors.empty?
       raise "Failed to update correctly (#{errors.size} errors)" unless opts['quiet']
       @loog.info('Not failing because of the --quiet flag provided')

data/lib/judges/judge.rb

@@ -59,7 +59,7 @@ class Judges::Judge
     end
     s = File.join(@dir, script)
     raise "Can't load '#{s}'" unless File.exist?(s)
-    elapsed(@loog, intro: "#{$judge} finished", level: Logger::INFO) do
+    elapsed(@loog, intro: "#{$judge} completed", level: Logger::INFO) do
       load(s, true)
       $fb.churn
       # rubocop:disable Lint/RescueException

data/lib/judges.rb

@@ -8,5 +8,5 @@
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 module Judges
-  VERSION = '0.42.1' unless const_defined?(:VERSION)
+  VERSION = '0.44.0' unless const_defined?(:VERSION)
 end