philiprehberger-rule_engine 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48759336967f009c48193bd19ba3abc3edf2c45712e21f18bbc3382b50ce2c19
-  data.tar.gz: 2894eca7b2c22440eb52c0920ae3edcb1642ada7193668f3e2d01213c6d0f560
+  metadata.gz: b150f5bc67b381f5f5a1c88032c5241c4bc83f952c565ceaf5d66baa852d4f65
+  data.tar.gz: 0fc2ae7a0e84089dcfddee3b80d917201924522c249c320bc80dd6bbc317e9f2
 SHA512:
-  metadata.gz: 0f1df77fa3a9caa8dc480eeb6cdb9c2010806f2b57108b8c4fde06b60830c853387918d225d48584d56cca89aeb2e790eee245ef0081debe6f9b8af723b3fa47
-  data.tar.gz: 9cd80a35da5092a44dd170965cd508faed0d3aba1d25a4005a91af5da037dff4a2e41cf9e54cb4995533e7240f4dd47155c5c26259d495d238f0eb41fd8bb9ee
+  metadata.gz: 99ab211d1ba3beefd989c2c32444fcc40386d72fdaa90963cbb2ae845021db06ebe4b882843ff8eea76f9773879610f47f71fec26044065b165530ae8d387767
+  data.tar.gz: 0b3ab9ec81247acaab0f07b7c44add184aa0437cf650f66c760d99666f3797d3049d4730c788e9a280ef4352a7333546878a0105289fa64933d5b76787c83af1

data/CHANGELOG.md

@@ -7,6 +7,18 @@ 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
+- Standardize README badges, support section, and license format
+
 ## [0.2.0] - 2026-03-28
 
 ### Added

data/README.md

@@ -2,12 +2,7 @@
 
 [![Tests](https://github.com/philiprehberger/rb-rule-engine/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/rb-rule-engine/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-rule_engine.svg)](https://rubygems.org/gems/philiprehberger-rule_engine)
-[![GitHub release](https://img.shields.io/github/v/release/philiprehberger/rb-rule-engine)](https://github.com/philiprehberger/rb-rule-engine/releases)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-rule-engine)](https://github.com/philiprehberger/rb-rule-engine/commits/main)
-[![License](https://img.shields.io/github/license/philiprehberger/rb-rule-engine)](LICENSE)
-[![Bug Reports](https://img.shields.io/github/issues/philiprehberger/rb-rule-engine/bug)](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
-[![Feature Requests](https://img.shields.io/github/issues/philiprehberger/rb-rule-engine/enhancement)](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
-[![Sponsor](https://img.shields.io/badge/sponsor-GitHub%20Sponsors-ec6cb9)](https://github.com/sponsors/philiprehberger)
 
 Lightweight rule engine with declarative conditions and actions
 
@@ -163,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
@@ -203,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
 
@@ -230,9 +251,21 @@ bundle exec rubocop
 
 ## Support
 
-- [Bug Reports](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
-- [Feature Requests](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
-- [GitHub Sponsors](https://github.com/sponsors/philiprehberger)
+If you find this project useful:
+
+⭐ [Star the repo](https://github.com/philiprehberger/rb-rule-engine)
+
+🐛 [Report issues](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+💡 [Suggest features](https://github.com/philiprehberger/rb-rule-engine/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+
+❤️ [Sponsor development](https://github.com/sponsors/philiprehberger)
+
+🌐 [All Open Source Projects](https://philiprehberger.com/open-source-packages)
+
+💻 [GitHub Profile](https://github.com/philiprehberger)
+
+🔗 [LinkedIn Profile](https://www.linkedin.com/in/philiprehberger)
 
 ## License
 

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.0'
+    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.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-29 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