judges 0.60.2 → 0.60.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b8a66e3d51e2392f0f93f1520b688ab8720a530cffb0a2a929ee51d8a788351
-  data.tar.gz: edfdf8700f08f118988c1f03c77973d27695895eda3837f15a3ea3b19d2e60ba
+  metadata.gz: 26d69625988cf52b0a58b477b38399fa6131ce5ef2fca9e41fad8b3f0d9409e9
+  data.tar.gz: 49a6f1decdb471de65037f19d249cd4a5f3208e53a7ca3b9e23a8b7a225dbbe4
 SHA512:
-  metadata.gz: f0df3c5a1be9698e575ba9853c51c0e868cdaf2870fba7c6e9fe222be299b58941bec182b2d3f1800f3cf33d1de12c053147290fe5ccb31c10912e3b4ec96036
-  data.tar.gz: c9bd376f7b8a1aca9add4af2132a77e229a24e4a7eb401bbd4c80f6799170f164b94b9bed0bdbd75ac2f13ad041a975d20bba8ead756a17fb4d628c0c6810090
+  metadata.gz: 3222d9734c7ed4e2afe39f61ba91fc9c69ba8ef17ea7639de5112e886a3a5f42cd7a84af6fb024dc96e817750f0cb567f04cd8bf08d93b894500c081323ce5a5
+  data.tar.gz: 74bc0d47b424a70b03221212a3626e83999234370003aa97f33d7500c1c2fff7fa175186664c170371ac45a3fa54302ea84920679306079a033f0e0883a8d526

data/Gemfile

@@ -7,7 +7,7 @@ source 'https://rubygems.org'
 gemspec
 
 gem 'base64', '~>0.3'
-gem 'cucumber', '~>10.0', require: false
+gem 'cucumber', '~>11.0', require: false
 gem 'diff-lcs', '1.6.2', require: false # GPL
 gem 'minitest', '~>6.0', require: false
 gem 'minitest-mock', '~>5.27', require: false

data/Gemfile.lock

@@ -26,7 +26,7 @@ GEM
   specs:
     addressable (2.8.9)
       public_suffix (>= 2.0.2, < 8.0)
-    ansi (1.5.0)
+    ansi (1.6.0)
     ast (2.4.3)
     backtrace (0.4.1)
     base64 (0.3.0)
@@ -42,24 +42,24 @@ GEM
       retries (~> 0.0)
       tago (~> 0.2)
       typhoeus (~> 1.4)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.1)
     builder (3.3.0)
     concurrent-ruby (1.3.6)
     crack (1.0.1)
       bigdecimal
       rexml
-    cucumber (10.2.0)
+    cucumber (11.0.0)
       base64 (~> 0.2)
       builder (~> 3.2)
       cucumber-ci-environment (> 9, < 12)
-      cucumber-core (> 15, < 17)
+      cucumber-core (>= 16.2.0, < 17)
       cucumber-cucumber-expressions (> 17, < 20)
-      cucumber-html-formatter (> 21, < 23)
+      cucumber-html-formatter (> 21, < 24)
       diff-lcs (~> 1.5)
       logger (~> 1.6)
       mini_mime (~> 1.1)
       multi_test (~> 1.1)
-      sys-uname (~> 1.3)
+      sys-uname (~> 1.5)
     cucumber-ci-environment (11.0.0)
     cucumber-core (16.2.0)
       cucumber-gherkin (> 36, < 40)
@@ -69,9 +69,9 @@ GEM
       bigdecimal
     cucumber-gherkin (39.0.0)
       cucumber-messages (>= 31, < 33)
-    cucumber-html-formatter (22.3.0)
+    cucumber-html-formatter (23.1.0)
       cucumber-messages (> 23, < 33)
-    cucumber-messages (32.2.0)
+    cucumber-messages (32.3.1)
     cucumber-tag-expressions (8.1.0)
     date (3.5.1)
     decoor (0.1.0)
@@ -109,41 +109,36 @@ GEM
       net-http (~> 0.5)
     faraday-retry (2.4.0)
       faraday (~> 2.0)
-    ffi (1.17.3-aarch64-linux-gnu)
-    ffi (1.17.3-aarch64-linux-musl)
-    ffi (1.17.3-arm-linux-gnu)
-    ffi (1.17.3-arm-linux-musl)
-    ffi (1.17.3-arm64-darwin)
-    ffi (1.17.3-x64-mingw-ucrt)
-    ffi (1.17.3-x86_64-darwin)
-    ffi (1.17.3-x86_64-linux-gnu)
-    ffi (1.17.3-x86_64-linux-musl)
+    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-x64-mingw-ucrt)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    ffi (1.17.4-x86_64-linux-musl)
     gli (2.22.2)
       ostruct
     hashdiff (1.2.1)
     iri (0.11.8)
-    json (2.18.1)
-    json-schema (6.1.0)
-      addressable (~> 2.8)
-      bigdecimal (>= 3.1, < 5)
+    json (2.19.3)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
     loog (0.8.0)
       ellipsized
       logger (~> 1.0)
-    mcp (0.7.1)
-      json-schema (>= 4.1)
     memoist3 (1.0.0)
     mini_mime (1.1.5)
-    minitest (6.0.2)
+    minitest (6.0.5)
       drb (~> 2.0)
       prism (~> 1.5)
     minitest-mock (5.27.0)
-    minitest-reporters (1.7.1)
+    minitest-reporters (1.8.0)
       ansi
       builder
-      minitest (>= 5.0)
+      minitest (>= 5.0, < 7)
       ruby-progressbar
     minitest-retry (0.3.1)
       minitest (>= 5.0)
@@ -181,22 +176,22 @@ GEM
     ostruct (0.6.3)
     others (0.1.1)
     parallel (1.27.0)
-    parser (3.3.10.2)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
     psych (5.3.1)
       date
       stringio
-    public_suffix (7.0.2)
-    qbash (0.8.0)
+    public_suffix (7.0.5)
+    qbash (0.8.2)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
       tago (> 0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
+    rake (13.4.2)
     random-port (0.8.2)
       tago (~> 0.0)
     rdoc (7.2.0)
@@ -206,19 +201,18 @@ GEM
     regexp_parser (2.11.3)
     retries (0.0.5)
     rexml (3.4.4)
-    rubocop (1.85.0)
+    rubocop (1.86.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      mcp (~> 0.6)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.0)
+    rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     rubocop-minitest (0.39.1)
@@ -246,9 +240,13 @@ GEM
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
     stringio (3.2.0)
-    sys-uname (1.5.0)
+    sys-uname (1.5.1)
+      ffi (~> 1.1)
+      memoist3 (~> 1.0.0)
+    sys-uname (1.5.1-universal-mingw32)
       ffi (~> 1.1)
       memoist3 (~> 1.0.0)
+      win32ole
     tago (0.7.0)
     timeout (0.6.0)
     total (0.4.2)
@@ -263,10 +261,11 @@ GEM
       json (>= 1.8)
       nokogiri (~> 1.6)
       rexml (~> 3.2)
-    webmock (3.26.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
+    win32ole (1.9.3)
     yaml (0.4.0)
     yard (0.9.38)
 
@@ -283,7 +282,7 @@ PLATFORMS
 
 DEPENDENCIES
   base64 (~> 0.3)
-  cucumber (~> 10.0)
+  cucumber (~> 11.0)
   diff-lcs (= 1.6.2)
   judges!
   minitest (~> 6.0)

data/README.md

@@ -84,6 +84,60 @@ of Ruby scripts that are executed after the judge
 The `expected_failure` (default: `[]`) is a list of strings that must
 be present in the message of the exception being raised.
 
+## Architecture
+
+The core data structure is a
+  [Factbase](https://github.com/yegor256/factbase) — a flat, schemaless,
+  binary-serialized collection of facts (records with named attributes)
+  held in memory during a run. Facts are queried via
+  [XPath](https://www.w3.org/TR/xpath/) expressions rather than SQL.
+  There is no schema to migrate, no ORM layer, and no database process
+  to manage. The factbase binary file is read at the start of each
+  `update` run and written back on exit, making state portable and
+  inspectable via `judges print`. This differs from tools such as
+  [Sidekiq](https://sidekiq.org/) or
+  [ActiveJob](https://guides.rubyonrails.org/active_job_basics.html),
+  which depend on an external database or message broker.
+
+Each judge is a single `.rb` Ruby file in its own directory. It is
+  not a class, a module, or a Rake task — it is a plain script loaded
+  with Ruby's `load(file, true)`, which wraps it in an anonymous module
+  and prevents constants in one judge from leaking into another. All
+  context is injected as Ruby global variables: `$fb` (the factbase),
+  `$loog` (logging), `$options` (configuration), `$global` (shared
+  across all judges in a run), and `$local` (reset after each judge).
+  A new judge author needs to know only those variables; there is no
+  base class to inherit and no interface contract to satisfy.
+
+The `update` command runs all judges in repeated cycles until the
+  factbase stops changing (zero churn) or until the `--max-cycles` or
+  `--lifetime` limit is reached. This fixed-point convergence model is
+  analogous to [Datalog](https://en.wikipedia.org/wiki/Datalog): a
+  judge that inserts a fact in one cycle may trigger a different judge
+  in the next cycle, without any explicit dependency declaration.
+  Pipeline tools such as
+  [Apache Airflow](https://airflow.apache.org/) or
+  [GitHub Actions](https://docs.github.com/en/actions) require a
+  directed acyclic graph defined upfront; judges require none.
+
+Every judge directory contains `.yml` test files alongside its `.rb`
+  script. A YAML file declares the initial facts (`input`), the count
+  of judge executions (`runs`), prerequisite judges (`before`),
+  post-condition scripts (`after`), and
+  [XPath](https://www.w3.org/TR/xpath/) assertions the factbase must
+  satisfy when the judge finishes (`expected`). Running `judges test`
+  creates a fresh, in-memory factbase per test case. Co-locating tests
+  with the script keeps each judge directory self-contained: one
+  directory holds both the deliverable and its verification.
+
+The `push` and `pull` commands exchange the binary factbase with a
+  remote [Baza](https://github.com/yegor256/baza.rb) server via a
+  named-lock protocol. `pull` acquires the lock and downloads the
+  file; `push` uploads the modified file and releases the lock. This
+  lets distributed CI pipelines share a single evolving factbase
+  across multiple jobs without running a database: each job pulls,
+  runs `update` locally, and pushes back.
+
 ## How to contribute
 
 Read

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.60.2'
+  s.version = '0.60.3'
   s.license = 'MIT'
   s.summary = 'Command-Line Tool for a Factbase'
   s.description =

data/lib/judges/commands/pull.rb

@@ -51,9 +51,8 @@ class Judges::Pull
           end
           fb.import(baza.pull(wait(name, baza, jid, opts['wait'])))
           Judges::Impex.new(@loog, args[1]).export(fb)
-        rescue StandardError => e
+        ensure
           baza.unlock(name, opts['owner'])
-          raise e
         end
         throw :"👍 Pulled #{fb.size} facts by name '#{name}'"
       else

data/lib/judges/judges.rb

@@ -78,7 +78,7 @@ class Judges::Judges
         next unless File.directory?(d)
         b = File.basename(d)
         next unless File.exist?(File.join(d, "#{b}.rb"))
-        Judges::Judge.new(File.absolute_path(d), @lib, @loog)
+        Judges::Judge.new(File.absolute_path(d), @lib, @loog, epoch: @epoch)
       end
     list.compact!
     list.sort_by!(&:name)

data/lib/judges.rb

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

data/package-lock.json

@@ -52,15 +52,15 @@
       }
     },
     "node_modules/@eslint/config-array": {
-      "version": "0.21.1",
-      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz",
-      "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==",
+      "version": "0.21.2",
+      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.2.tgz",
+      "integrity": "sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==",
       "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "@eslint/object-schema": "^2.1.7",
         "debug": "^4.3.1",
-        "minimatch": "^3.1.2"
+        "minimatch": "^3.1.5"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -93,20 +93,20 @@
       }
     },
     "node_modules/@eslint/eslintrc": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz",
-      "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==",
+      "version": "3.3.5",
+      "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.5.tgz",
+      "integrity": "sha512-4IlJx0X0qftVsN5E+/vGujTRIFtwuLbNsVUe7TO6zYPDR1O6nFwvwhIKEKSrl6dZchmYBITazxKoUYOjdtjlRg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "ajv": "^6.12.4",
+        "ajv": "^6.14.0",
         "debug": "^4.3.2",
         "espree": "^10.0.1",
         "globals": "^14.0.0",
         "ignore": "^5.2.0",
         "import-fresh": "^3.2.1",
-        "js-yaml": "^4.1.0",
-        "minimatch": "^3.1.2",
+        "js-yaml": "^4.1.1",
+        "minimatch": "^3.1.5",
         "strip-json-comments": "^3.1.1"
       },
       "engines": {
@@ -117,9 +117,9 @@
       }
     },
     "node_modules/@eslint/js": {
-      "version": "9.39.2",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.2.tgz",
-      "integrity": "sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA==",
+      "version": "9.39.4",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.4.tgz",
+      "integrity": "sha512-nE7DEIchvtiFTwBw4Lfbu59PG+kCofhjsKaCWzxTpt4lfRjRMqG6uMBzKXuEcyXhOHoUp9riAm7/aWYGhXZ9cw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -239,7 +239,6 @@
       "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -258,9 +257,9 @@
       }
     },
     "node_modules/ajv": {
-      "version": "6.12.6",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
-      "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
+      "version": "6.14.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz",
+      "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -305,9 +304,9 @@
       "license": "MIT"
     },
     "node_modules/brace-expansion": {
-      "version": "1.1.11",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
-      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -423,26 +422,25 @@
       }
     },
     "node_modules/eslint": {
-      "version": "9.39.2",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.2.tgz",
-      "integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==",
+      "version": "9.39.4",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.4.tgz",
+      "integrity": "sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
-        "@eslint/config-array": "^0.21.1",
+        "@eslint/config-array": "^0.21.2",
         "@eslint/config-helpers": "^0.4.2",
         "@eslint/core": "^0.17.0",
-        "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "9.39.2",
+        "@eslint/eslintrc": "^3.3.5",
+        "@eslint/js": "9.39.4",
         "@eslint/plugin-kit": "^0.4.1",
         "@humanfs/node": "^0.16.6",
         "@humanwhocodes/module-importer": "^1.0.1",
         "@humanwhocodes/retry": "^0.4.2",
         "@types/estree": "^1.0.6",
-        "ajv": "^6.12.4",
+        "ajv": "^6.14.0",
         "chalk": "^4.0.0",
         "cross-spawn": "^7.0.6",
         "debug": "^4.3.2",
@@ -461,7 +459,7 @@
         "is-glob": "^4.0.0",
         "json-stable-stringify-without-jsonify": "^1.0.1",
         "lodash.merge": "^4.6.2",
-        "minimatch": "^3.1.2",
+        "minimatch": "^3.1.5",
         "natural-compare": "^1.4.0",
         "optionator": "^0.9.3"
       },
@@ -753,9 +751,9 @@
       "license": "ISC"
     },
     "node_modules/js-yaml": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz",
+      "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -834,9 +832,9 @@
       "license": "MIT"
     },
     "node_modules/minimatch": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
       "dev": true,
       "license": "ISC",
       "dependencies": {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: judges
 version: !ruby/object:Gem::Version
-  version: 0.60.2
+  version: 0.60.3
 platform: ruby
 authors:
 - Yegor Bugayenko