philiprehberger-rule_engine 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f9262600c2b5adefbd5f73154f136518a003284d78e18289b90b95517becf6b
-  data.tar.gz: d89dfe2d39727cbf6b41bf2479b19863d9d1027a313afa3ee1fc1473fe96817d
+  metadata.gz: b150f5bc67b381f5f5a1c88032c5241c4bc83f952c565ceaf5d66baa852d4f65
+  data.tar.gz: 0fc2ae7a0e84089dcfddee3b80d917201924522c249c320bc80dd6bbc317e9f2
 SHA512:
-  metadata.gz: 25752056acd892fac736ef5862b2d7b242418df52dcaa8e7174f19745f0a0557ffafc8db8f4b6ea1101db8a079849688481096d6e6ba0e871916da2801b47e13
-  data.tar.gz: 622c75faa7b5d4905fd89eab451a1efcf0b2fc9ad07612212af7d3693c1ced02b0c229f92409e78df4d5ac87ba4f0cd294b0f785bd29011b98e6ff591abe74c3
+  metadata.gz: 99ab211d1ba3beefd989c2c32444fcc40386d72fdaa90963cbb2ae845021db06ebe4b882843ff8eea76f9773879610f47f71fec26044065b165530ae8d387767
+  data.tar.gz: 0b3ab9ec81247acaab0f07b7c44add184aa0437cf650f66c760d99666f3797d3049d4730c788e9a280ef4352a7333546878a0105289fa64933d5b76787c83af1

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-01
+
+### Added
+- `#dry_run(facts)` for evaluating rules without executing actions
+- `#detect_conflicts` for finding potentially overlapping rule pairs
+- `#validate_rules` for checking rule completeness
+
 ## [0.2.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -158,6 +158,29 @@ engine.stats
 engine.reset_stats!
 ```
 
+### Dry Run
+
+Evaluate without executing actions:
+
+```ruby
+matched = engine.dry_run(facts)
+# => [{ name: "discount", priority: 10 }]
+```
+
+### Conflict Detection
+
+```ruby
+engine.detect_conflicts
+# => [{ rules: ["rule_a", "rule_b"], priorities: [10, 5] }]
+```
+
+### Rule Validation
+
+```ruby
+engine.validate_rules
+# => { valid: false, issues: ["Rule 'x' has no action"] }
+```
+
 ### Serialization
 
 ```ruby
@@ -198,6 +221,9 @@ end
 | `#chain(*rule_names)` | Execute rules sequentially as a pipeline |
 | `#stats` | Per-rule execution statistics |
 | `#reset_stats!` | Clear all execution statistics |
+| `#dry_run(facts)` | Evaluate rules without executing actions |
+| `#detect_conflicts` | Find rule pairs that could both match |
+| `#validate_rules` | Check all rules have conditions and actions |
 
 ### Rule DSL
 

data/lib/philiprehberger/rule_engine/engine.rb

@@ -135,6 +135,40 @@ module Philiprehberger
         @stats.each_key { |k| @stats[k] = new_stat_entry }
       end
 
+      # Evaluate rules without executing actions, return matched rule info
+      #
+      # @param facts [Hash] the facts to evaluate
+      # @return [Array<Hash>] matched rules with name and priority
+      def dry_run(facts)
+        matched = enabled_rules_sorted.select { |rule| rule.matches?(facts) }
+        matched = [matched.first].compact if @mode == :first
+        matched.map { |rule| { name: rule.name, priority: rule.priority } }
+      end
+
+      # Find rules with potentially overlapping conditions
+      #
+      # @return [Array<Hash>] pairs of rule names that could both match
+      def detect_conflicts
+        pairs = []
+        sorted = enabled_rules_sorted
+        sorted.combination(2) do |a, b|
+          pairs << { rules: [a.name, b.name], priorities: [a.priority, b.priority] }
+        end
+        pairs
+      end
+
+      # Validate all rules have conditions and actions defined
+      #
+      # @return [Hash] { valid: Boolean, issues: Array<String> }
+      def validate_rules
+        issues = []
+        @rules.each do |rule|
+          issues << "Rule '#{rule.name}' has no condition" unless rule.instance_variable_get(:@condition)
+          issues << "Rule '#{rule.name}' has no action" unless rule.instance_variable_get(:@action)
+        end
+        { valid: issues.empty?, issues: issues }
+      end
+
       # Serialize the engine configuration to a hash.
       #
       # @return [Hash] engine metadata including mode and rules
@@ -169,6 +203,10 @@ module Philiprehberger
 
       private
 
+      def enabled_rules_sorted
+        @rules.select(&:enabled).sort_by(&:priority)
+      end
+
       def new_stat_entry
         {
           evaluations: 0,

data/lib/philiprehberger/rule_engine/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module RuleEngine
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-rule_engine
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-02 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight rule engine with a declarative DSL for defining conditions
   and actions. Supports priority-based ordering, first-match and all-match evaluation
@@ -27,11 +27,11 @@ files:
 - lib/philiprehberger/rule_engine/helpers.rb
 - lib/philiprehberger/rule_engine/rule.rb
 - lib/philiprehberger/rule_engine/version.rb
-homepage: https://github.com/philiprehberger/rb-rule-engine
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-rule_engine
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-rule-engine
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-rule_engine
   source_code_uri: https://github.com/philiprehberger/rb-rule-engine
   changelog_uri: https://github.com/philiprehberger/rb-rule-engine/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-rule-engine/issues