kailash 4.43.0-aarch64-linux → 4.45.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc0be3b0f475c98b76be239eb42f6a1364c025a5cf76e6acc3d03e793d56c558
-  data.tar.gz: 834d61c7ed64357d8b2ec972354713cb36224cee3724007e1a9bb74afc25b5f7
+  metadata.gz: '05967636a9f54f3bcf3a7e98338e98957d77d05f19a2df14aefdaccf395ef6f3'
+  data.tar.gz: 5adb12720cecbf530dff57dfb1c13646f0eb0ead7aaaf6f144e0b7024255693e
 SHA512:
-  metadata.gz: d0d18ef4cbe83fd88a108ab8c45aaaf66b7d9bb30fe58ca187501fc817eca1ef2f6c31f66e7c30ae5343854d75ac9ba1d5cfea0d0c7fecdc272add5a86e3ba71
-  data.tar.gz: 8fb41e4b24520d893989828ec2194fa8cf54f88b7a641a5a35cbbcd0aaddb18621e0b3b26850e99cd781efa17c87431ed554603d3fea4c66a61114f0d691bc26
+  metadata.gz: d9a5a6881fbde7a3373a95b5d1d640c48453effee3427151420624559e7da480ce0c6edeac4acaeb65bb2523178a5e4246bc1947c1a73914a6d947b033ca70fe
+  data.tar.gz: 252a84fc50cffcd0b67e0c12de9b51ffcfa4eb392dc29b1f94c9ef3e04e129dc44090329034d061bf15b85bafeeba7dba01f2028f01c3541b0f67aec048d4e93

data/README.md

@@ -348,11 +348,43 @@ registry.close
 | `DataFlowInspector`              | Schema inspection                                      |
 | `Migration` / `MigrationManager` | Database migration management                          |
 | `SchemaCache`                    | In-memory schema caching                               |
-| `ValidationLayer` / `StrictMode` | Query validation configuration                         |
+| `ValidationLayer`                | Field validation: rules, named validators, `validate`  |
+| `StrictMode`                     | Settings object only — see the note below              |
 | `LoggingConfig`                  | Query logging (level, format, slow query threshold)    |
 | `ErrorEnhancer`                  | Enhanced error context (query, params, stack)          |
 | `DebugAgent`                     | Query debugging                                        |
 
+`ValidationLayer` is backed by `kailash_dataflow::validation::ValidationLayer`
+(`crates/kailash-dataflow/src/validation.rs:729-918`). Register rules per model
+and field, then get the violations back:
+
+```ruby
+layer = Kailash::DataFlow::ValidationLayer.new
+layer.add_rule("User", "name", "min_length", 2)          # min_length, max_length,
+layer.add_rule("User", "status", "one_of", %w[active])   # pattern, range, one_of
+layer.add_validator("User", "email", "email")            # email, url, uuid, phone
+layer.add_custom_rule("User", "code") { |v| v.start_with?("K") }
+
+layer.validate("User", { "name" => "A" })
+# => [{ "field" => "name", "rule" => "min_length", "message" => "...", "value" => "A" }]
+layer.valid?("User", { "name" => "Alice" })  # => true
+```
+
+Rules fail CLOSED: a rule applied to a value whose type it cannot evaluate, and a
+custom block that raises or returns a non-boolean, both report a violation rather
+than a pass (`crates/kailash-dataflow/src/validation.rs:257-268`). The
+`enable_strict_mode` / `strict_mode?` / one-argument `add_validator(name)` /
+zero-argument `validator_count` accessors are deprecated as of #2497 and removed
+in 5.0.0; each warns that it reaches no validation. The replacements and the
+operator checklist are in `DEPRECATION.md`.
+
+`StrictMode` holds three boolean settings and nothing reads them: the Ruby
+binding does not reference `kailash_dataflow::strict`, and the class registers no
+method that takes data or returns a verdict
+(`bindings/kailash-ruby/ext/kailash/src/dataflow.rs:2571-2580` for the state,
+`:4544-4571` for the registered methods). Tracked as #2587; the Python binding
+already wires the same Rust surface.
+
 ## Value Conversion
 
 Ruby values are automatically converted to the Rust `Value` type and back:

data/lib/kailash/version.rb

@@ -4,5 +4,5 @@ module Kailash
   # Ruby gem version — kept in sync with Cargo.toml via release process.
   # The native extension also defines Kailash::VERSION from the Rust side;
   # this file provides a fallback before the extension is loaded.
-  GEM_VERSION = "4.43.0"
+  GEM_VERSION = "4.45.0"
 end

data/lib/kailash.rb

@@ -47,7 +47,35 @@ module Kailash
     # its `status` + `body` to the outgoing HTTP response. Any other
     # exception falls through to the legacy 400 "Ruby handler raised"
     # path for backward compatibility with S5a.
-    class NexusHandlerError
+    # The superclass is STATED, not inherited by accident of load order.
+    #
+    # The native extension defines this class first, as
+    # `Kailash::Nexus::NexusHandlerError < Kailash::Error`
+    # (`ext/kailash/src/nexus.rs`, `define_error`), and the `require` at the top
+    # of this file runs before this block -- so a bare `class NexusHandlerError`
+    # REOPENS that exception class and everything works. It works because of the
+    # ordering, and nothing said so.
+    #
+    # If that ordering ever changed, a bare reopen would silently create a NEW
+    # class inheriting `Object`, and the feature would stop working at two
+    # separate points. Measured on Ruby 3.3.11 against the same class body
+    # evaluated without the extension loaded:
+    #
+    #   superclass: Object
+    #   k.new("boom", status: 422)
+    #     -> ArgumentError: wrong number of arguments (given 1, expected 0)
+    #        (`super(message)` reaching `Object#initialize`)
+    #   raise k.new  ->  TypeError: exception class/object expected
+    #
+    # And the `rescue NexusHandlerError` below would not raise -- it would
+    # simply never match, which is the quieter of the two failures. Between
+    # them the documented status/body mapping would have no reachable entry
+    # point, with this comment still describing it.
+    #
+    # Naming the superclass turns that into a loud failure at load: a
+    # `NameError` if the extension has not defined `Kailash::Error` yet, or a
+    # `TypeError: superclass mismatch` if it ever defines this class differently.
+    class NexusHandlerError < ::Kailash::Error
       attr_reader :status, :body
 
       def initialize(message = nil, status: 500, body: nil)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kailash
 version: !ruby/object:Gem::Version
-  version: 4.43.0
+  version: 4.45.0
 platform: aarch64-linux
 authors:
 - Kailash Authors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-27 00:00:00.000000000 Z
+date: 2026-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake-compiler