decision_agent 0.3.0 → 1.1.0

data/lib/decision_agent.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative "decision_agent/version"
 require_relative "decision_agent/errors"
 require_relative "decision_agent/context"
@@ -62,9 +64,18 @@ require_relative "decision_agent/auth/rbac_config"
 require_relative "decision_agent/auth/permission_checker"
 require_relative "decision_agent/auth/access_audit_logger"
 
+require_relative "decision_agent/simulation"
+
+require_relative "decision_agent/explainability/condition_trace"
+require_relative "decision_agent/explainability/rule_trace"
+require_relative "decision_agent/explainability/trace_collector"
+require_relative "decision_agent/explainability/explainability_result"
+
 module DecisionAgent
   # Global RBAC configuration
   @rbac_config = Auth::RbacConfig.new
+  @permission_checker = nil
+  @permission_checker_mutex = Mutex.new
 
   class << self
     attr_reader :rbac_config
@@ -85,12 +96,19 @@ module DecisionAgent
       elsif adapter_type
         @rbac_config.use(adapter_type, **options)
       end
+      # Initialize permission checker at configuration time (thread-safe write-once pattern)
+      @permission_checker = Auth::PermissionChecker.new(adapter: @rbac_config.adapter)
       @rbac_config
     end
 
     # Get the configured permission checker
+    # Thread-safe: uses double-checked locking for lazy initialization fallback
     def permission_checker
-      @permission_checker ||= Auth::PermissionChecker.new(adapter: @rbac_config.adapter)
+      return @permission_checker if @permission_checker
+
+      @permission_checker_mutex.synchronize do
+        @permission_checker ||= Auth::PermissionChecker.new(adapter: @rbac_config.adapter)
+      end
     end
 
     # Set a custom permission checker

data/lib/generators/decision_agent/install/install_generator.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "rails/generators"
 require "rails/generators/migration"
 

data/lib/generators/decision_agent/install/templates/ab_test_assignment_model.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # A/B Test Assignment model for decision_agent gem
 # Tracks individual variant assignments and their results
 class ABTestAssignmentModel < ActiveRecord::Base

data/lib/generators/decision_agent/install/templates/ab_test_model.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # A/B Test model for decision_agent gem
 # Stores A/B test configurations
 class ABTestModel < ActiveRecord::Base

data/lib/generators/decision_agent/install/templates/ab_testing_migration.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateDecisionAgentABTestingTables < ActiveRecord::Migration[7.0]
   def change
     # A/B Tests table

data/lib/generators/decision_agent/install/templates/migration.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateDecisionAgentTables < ActiveRecord::Migration[7.0]
   def change
     # Rules table

data/lib/generators/decision_agent/install/templates/rule.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Rule < ApplicationRecord
   has_many :rule_versions, primary_key: :rule_id, foreign_key: :rule_id, dependent: :destroy
 

data/lib/generators/decision_agent/install/templates/rule_version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class RuleVersion < ApplicationRecord
   belongs_to :rule, primary_key: :rule_id, foreign_key: :rule_id, optional: true
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decision_agent
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Sam Aswin
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: json-canonicalization
   requirement: !ruby/object:Gem::Requirement
@@ -41,16 +55,22 @@ dependencies:
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.15'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.15'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.19'
 - !ruby/object:Gem::Dependency
   name: parslet
   requirement: !ruby/object:Gem::Requirement
@@ -66,47 +86,47 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: roo
+  name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rubyzip
+  name: roo
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '2.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '2.10'
 - !ruby/object:Gem::Dependency
-  name: sinatra
+  name: rubyzip
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: rack-test
   requirement: !ruby/object:Gem::Requirement
@@ -163,6 +183,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.60'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
 description: A production-grade decision agent that provides deterministic rule evaluation,
   conflict resolution, and full audit replay capabilities. Framework-agnostic and
   AI-optional.
@@ -222,6 +256,30 @@ files:
 - lib/decision_agent/dmn/versioning.rb
 - lib/decision_agent/dmn/visualizer.rb
 - lib/decision_agent/dsl/condition_evaluator.rb
+- lib/decision_agent/dsl/helpers/cache_helpers.rb
+- lib/decision_agent/dsl/helpers/comparison_helpers.rb
+- lib/decision_agent/dsl/helpers/date_helpers.rb
+- lib/decision_agent/dsl/helpers/geospatial_helpers.rb
+- lib/decision_agent/dsl/helpers/operator_evaluation_helpers.rb
+- lib/decision_agent/dsl/helpers/parameter_parsing_helpers.rb
+- lib/decision_agent/dsl/helpers/template_helpers.rb
+- lib/decision_agent/dsl/helpers/utility_helpers.rb
+- lib/decision_agent/dsl/operators/base.rb
+- lib/decision_agent/dsl/operators/basic_comparison_operators.rb
+- lib/decision_agent/dsl/operators/collection_operators.rb
+- lib/decision_agent/dsl/operators/date_arithmetic_operators.rb
+- lib/decision_agent/dsl/operators/date_time_operators.rb
+- lib/decision_agent/dsl/operators/duration_operators.rb
+- lib/decision_agent/dsl/operators/financial_operators.rb
+- lib/decision_agent/dsl/operators/geospatial_operators.rb
+- lib/decision_agent/dsl/operators/mathematical_operators.rb
+- lib/decision_agent/dsl/operators/moving_window_operators.rb
+- lib/decision_agent/dsl/operators/numeric_operators.rb
+- lib/decision_agent/dsl/operators/rate_operators.rb
+- lib/decision_agent/dsl/operators/statistical_aggregations.rb
+- lib/decision_agent/dsl/operators/string_aggregations.rb
+- lib/decision_agent/dsl/operators/string_operators.rb
+- lib/decision_agent/dsl/operators/time_component_operators.rb
 - lib/decision_agent/dsl/rule_parser.rb
 - lib/decision_agent/dsl/schema_validator.rb
 - lib/decision_agent/errors.rb
@@ -231,6 +289,10 @@ files:
 - lib/decision_agent/evaluators/dmn_evaluator.rb
 - lib/decision_agent/evaluators/json_rule_evaluator.rb
 - lib/decision_agent/evaluators/static_evaluator.rb
+- lib/decision_agent/explainability/condition_trace.rb
+- lib/decision_agent/explainability/explainability_result.rb
+- lib/decision_agent/explainability/rule_trace.rb
+- lib/decision_agent/explainability/trace_collector.rb
 - lib/decision_agent/monitoring/alert_manager.rb
 - lib/decision_agent/monitoring/dashboard/public/dashboard.css
 - lib/decision_agent/monitoring/dashboard/public/dashboard.js
@@ -248,6 +310,15 @@ files:
 - lib/decision_agent/scoring/max_weight.rb
 - lib/decision_agent/scoring/threshold.rb
 - lib/decision_agent/scoring/weighted_average.rb
+- lib/decision_agent/simulation.rb
+- lib/decision_agent/simulation/errors.rb
+- lib/decision_agent/simulation/impact_analyzer.rb
+- lib/decision_agent/simulation/monte_carlo_simulator.rb
+- lib/decision_agent/simulation/replay_engine.rb
+- lib/decision_agent/simulation/scenario_engine.rb
+- lib/decision_agent/simulation/scenario_library.rb
+- lib/decision_agent/simulation/shadow_test_engine.rb
+- lib/decision_agent/simulation/what_if_analyzer.rb
 - lib/decision_agent/testing/batch_test_importer.rb
 - lib/decision_agent/testing/batch_test_runner.rb
 - lib/decision_agent/testing/test_coverage_analyzer.rb
@@ -259,6 +330,8 @@ files:
 - lib/decision_agent/versioning/file_storage_adapter.rb
 - lib/decision_agent/versioning/version_manager.rb
 - lib/decision_agent/web/dmn_editor.rb
+- lib/decision_agent/web/dmn_editor/serialization.rb
+- lib/decision_agent/web/dmn_editor/xml_builder.rb
 - lib/decision_agent/web/middleware/auth_middleware.rb
 - lib/decision_agent/web/middleware/permission_middleware.rb
 - lib/decision_agent/web/public/app.js
@@ -268,8 +341,21 @@ files:
 - lib/decision_agent/web/public/dmn-editor.js
 - lib/decision_agent/web/public/index.html
 - lib/decision_agent/web/public/login.html
+- lib/decision_agent/web/public/sample_batch.csv
+- lib/decision_agent/web/public/sample_impact.csv
+- lib/decision_agent/web/public/sample_replay.csv
+- lib/decision_agent/web/public/sample_rules.json
+- lib/decision_agent/web/public/sample_shadow.csv
+- lib/decision_agent/web/public/sample_whatif.csv
+- lib/decision_agent/web/public/simulation.html
+- lib/decision_agent/web/public/simulation_impact.html
+- lib/decision_agent/web/public/simulation_replay.html
+- lib/decision_agent/web/public/simulation_shadow.html
+- lib/decision_agent/web/public/simulation_whatif.html
 - lib/decision_agent/web/public/styles.css
 - lib/decision_agent/web/public/users.html
+- lib/decision_agent/web/rack_helpers.rb
+- lib/decision_agent/web/rack_request_helpers.rb
 - lib/decision_agent/web/server.rb
 - lib/generators/decision_agent/install/install_generator.rb
 - lib/generators/decision_agent/install/templates/README
@@ -286,85 +372,13 @@ files:
 - lib/generators/decision_agent/install/templates/performance_metric.rb
 - lib/generators/decision_agent/install/templates/rule.rb
 - lib/generators/decision_agent/install/templates/rule_version.rb
-- spec/ab_testing/ab_test_assignment_spec.rb
-- spec/ab_testing/ab_test_manager_spec.rb
-- spec/ab_testing/ab_test_spec.rb
-- spec/ab_testing/ab_testing_agent_spec.rb
-- spec/ab_testing/storage/adapter_spec.rb
-- spec/ab_testing/storage/memory_adapter_spec.rb
-- spec/activerecord_thread_safety_spec.rb
-- spec/advanced_operators_spec.rb
-- spec/agent_spec.rb
-- spec/api_contract_spec.rb
-- spec/audit_adapters_spec.rb
-- spec/auth/access_audit_logger_spec.rb
-- spec/auth/authenticator_spec.rb
-- spec/auth/password_reset_spec.rb
-- spec/auth/permission_checker_spec.rb
-- spec/auth/permission_spec.rb
-- spec/auth/rbac_adapter_spec.rb
-- spec/auth/rbac_config_spec.rb
-- spec/auth/role_spec.rb
-- spec/auth/session_manager_spec.rb
-- spec/auth/session_spec.rb
-- spec/auth/user_spec.rb
-- spec/comprehensive_edge_cases_spec.rb
-- spec/context_spec.rb
-- spec/decision_agent_spec.rb
-- spec/decision_spec.rb
-- spec/dmn/decision_graph_spec.rb
-- spec/dmn/decision_tree_spec.rb
-- spec/dmn/feel/errors_spec.rb
-- spec/dmn/feel/functions_spec.rb
-- spec/dmn/feel/simple_parser_spec.rb
-- spec/dmn/feel/types_spec.rb
-- spec/dmn/feel_parser_spec.rb
-- spec/dmn/hit_policy_spec.rb
-- spec/dmn/integration_spec.rb
-- spec/dsl/condition_evaluator_spec.rb
-- spec/dsl_validation_spec.rb
-- spec/edge_cases_spec.rb
-- spec/evaluation_spec.rb
-- spec/evaluation_validator_spec.rb
-- spec/examples.txt
-- spec/examples/feedback_aware_evaluator_spec.rb
-- spec/fixtures/dmn/complex_decision.dmn
-- spec/fixtures/dmn/invalid_structure.dmn
-- spec/fixtures/dmn/simple_decision.dmn
-- spec/issue_verification_spec.rb
-- spec/json_rule_evaluator_spec.rb
-- spec/monitoring/alert_manager_spec.rb
-- spec/monitoring/metrics_collector_spec.rb
-- spec/monitoring/monitored_agent_spec.rb
-- spec/monitoring/prometheus_exporter_spec.rb
-- spec/monitoring/storage/activerecord_adapter_spec.rb
-- spec/monitoring/storage/base_adapter_spec.rb
-- spec/monitoring/storage/memory_adapter_spec.rb
-- spec/performance_optimizations_spec.rb
-- spec/replay_edge_cases_spec.rb
-- spec/replay_spec.rb
-- spec/rfc8785_canonicalization_spec.rb
-- spec/scoring_spec.rb
-- spec/spec_helper.rb
-- spec/testing/batch_test_importer_spec.rb
-- spec/testing/batch_test_runner_spec.rb
-- spec/testing/test_coverage_analyzer_spec.rb
-- spec/testing/test_result_comparator_spec.rb
-- spec/testing/test_scenario_spec.rb
-- spec/thread_safety_spec.rb
-- spec/thread_safety_spec.rb.broken
-- spec/versioning/adapter_spec.rb
-- spec/versioning_spec.rb
-- spec/web/middleware/auth_middleware_spec.rb
-- spec/web/middleware/permission_middleware_spec.rb
-- spec/web_ui_rack_spec.rb
 homepage: https://github.com/samaswin/decision_agent
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/samaswin/decision_agent
   source_code_uri: https://github.com/samaswin/decision_agent
-  changelog_uri: https://github.com/samaswin/decision_agent/blob/main/CHANGELOG.md
+  changelog_uri: https://github.com/samaswin/decision_agent/blob/main/docs/CHANGELOG.md
   github_repo: https://github.com/samaswin/decision_agent
   rubygems_mfa_required: 'true'
 rdoc_options: []

data/spec/ab_testing/ab_test_assignment_spec.rb

@@ -1,253 +0,0 @@
-require "spec_helper"
-require "decision_agent/ab_testing/ab_test_assignment"
-
-RSpec.describe DecisionAgent::ABTesting::ABTestAssignment do
-  describe "#initialize" do
-    it "creates an assignment with required fields" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1"
-      )
-
-      expect(assignment.ab_test_id).to eq("test_1")
-      expect(assignment.variant).to eq(:champion)
-      expect(assignment.version_id).to eq("v1")
-      expect(assignment.timestamp).to be_a(Time)
-    end
-
-    it "accepts optional user_id" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        user_id: "user_123"
-      )
-
-      expect(assignment.user_id).to eq("user_123")
-    end
-
-    it "accepts optional timestamp" do
-      custom_time = Time.new(2024, 1, 1, 12, 0, 0, "+00:00")
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        timestamp: custom_time
-      )
-
-      expect(assignment.timestamp).to eq(custom_time)
-    end
-
-    it "accepts optional decision_result and confidence" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        decision_result: "approve",
-        confidence: 0.95
-      )
-
-      expect(assignment.decision_result).to eq("approve")
-      expect(assignment.confidence).to eq(0.95)
-    end
-
-    it "accepts optional context" do
-      context = { user_type: "premium", region: "us" }
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        context: context
-      )
-
-      expect(assignment.context).to eq(context)
-    end
-
-    it "defaults context to empty hash" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1"
-      )
-
-      expect(assignment.context).to eq({})
-    end
-
-    it "accepts optional id" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        id: "assign_123"
-      )
-
-      expect(assignment.id).to eq("assign_123")
-    end
-
-    it "raises error if ab_test_id is nil" do
-      expect do
-        described_class.new(
-          ab_test_id: nil,
-          variant: :champion,
-          version_id: "v1"
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /AB test ID is required/)
-    end
-
-    it "raises error if variant is nil" do
-      expect do
-        described_class.new(
-          ab_test_id: "test_1",
-          variant: nil,
-          version_id: "v1"
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /Variant is required/)
-    end
-
-    it "raises error if version_id is nil" do
-      expect do
-        described_class.new(
-          ab_test_id: "test_1",
-          variant: :champion,
-          version_id: nil
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /Version ID is required/)
-    end
-
-    it "raises error if variant is not :champion or :challenger" do
-      expect do
-        described_class.new(
-          ab_test_id: "test_1",
-          variant: :invalid,
-          version_id: "v1"
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /Variant must be :champion or :challenger/)
-    end
-
-    it "raises error if confidence is negative" do
-      expect do
-        described_class.new(
-          ab_test_id: "test_1",
-          variant: :champion,
-          version_id: "v1",
-          confidence: -0.1
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /Confidence must be between 0 and 1/)
-    end
-
-    it "raises error if confidence is greater than 1" do
-      expect do
-        described_class.new(
-          ab_test_id: "test_1",
-          variant: :champion,
-          version_id: "v1",
-          confidence: 1.5
-        )
-      end.to raise_error(DecisionAgent::ValidationError, /Confidence must be between 0 and 1/)
-    end
-
-    it "accepts confidence of 0" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        confidence: 0.0
-      )
-
-      expect(assignment.confidence).to eq(0.0)
-    end
-
-    it "accepts confidence of 1" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        confidence: 1.0
-      )
-
-      expect(assignment.confidence).to eq(1.0)
-    end
-
-    it "accepts challenger variant" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :challenger,
-        version_id: "v2"
-      )
-
-      expect(assignment.variant).to eq(:challenger)
-    end
-  end
-
-  describe "#record_decision" do
-    let(:assignment) do
-      described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1"
-      )
-    end
-
-    it "updates decision_result and confidence" do
-      assignment.record_decision("approve", 0.95)
-
-      expect(assignment.decision_result).to eq("approve")
-      expect(assignment.confidence).to eq(0.95)
-    end
-
-    it "can update multiple times" do
-      assignment.record_decision("approve", 0.95)
-      assignment.record_decision("reject", 0.85)
-
-      expect(assignment.decision_result).to eq("reject")
-      expect(assignment.confidence).to eq(0.85)
-    end
-  end
-
-  describe "#to_h" do
-    it "converts assignment to hash with all fields" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1",
-        id: "assign_123",
-        user_id: "user_456",
-        decision_result: "approve",
-        confidence: 0.95,
-        context: { region: "us" },
-        timestamp: Time.new(2024, 1, 1, 12, 0, 0, "+00:00")
-      )
-
-      hash = assignment.to_h
-
-      expect(hash).to eq({
-                           id: "assign_123",
-                           ab_test_id: "test_1",
-                           user_id: "user_456",
-                           variant: :champion,
-                           version_id: "v1",
-                           timestamp: Time.new(2024, 1, 1, 12, 0, 0, "+00:00"),
-                           decision_result: "approve",
-                           confidence: 0.95,
-                           context: { region: "us" }
-                         })
-    end
-
-    it "includes nil values in hash" do
-      assignment = described_class.new(
-        ab_test_id: "test_1",
-        variant: :champion,
-        version_id: "v1"
-      )
-
-      hash = assignment.to_h
-
-      expect(hash[:id]).to be_nil
-      expect(hash[:user_id]).to be_nil
-      expect(hash[:decision_result]).to be_nil
-      expect(hash[:confidence]).to be_nil
-      expect(hash[:context]).to eq({})
-    end
-  end
-end