decision_agent 0.3.0 → 1.0.1

data/lib/decision_agent.rb

@@ -62,12 +62,32 @@ 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/data_enrichment/config"
+require_relative "decision_agent/data_enrichment/client"
+require_relative "decision_agent/data_enrichment/cache_adapter"
+require_relative "decision_agent/data_enrichment/cache/memory_adapter"
+require_relative "decision_agent/data_enrichment/circuit_breaker"
+require_relative "decision_agent/data_enrichment/errors"
+
+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
+  # Global data enrichment configuration
+  @data_enrichment_config = DataEnrichment::Config.new
+  @data_enrichment_client = nil
+  @permission_checker = nil
+  @permission_checker_mutex = Mutex.new
+  @data_enrichment_client_mutex = Mutex.new
 
   class << self
-    attr_reader :rbac_config
+    attr_reader :rbac_config, :data_enrichment_config
 
     # Configure RBAC adapter
     # @param adapter_type [Symbol] :default, :devise_cancan, :pundit, or :custom
@@ -85,15 +105,53 @@ 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
     attr_writer :permission_checker
+
+    # Configure data enrichment endpoints
+    # @yield [DataEnrichment::Config] Configuration block
+    # @example
+    #   DecisionAgent.configure_data_enrichment do |config|
+    #     config.add_endpoint(:credit_bureau,
+    #       url: "https://api.creditbureau.com/v1/score",
+    #       method: :post,
+    #       auth: { type: :api_key, header: "X-API-Key" },
+    #       cache: { ttl: 3600, adapter: :memory }
+    #     )
+    #   end
+    def configure_data_enrichment
+      yield @data_enrichment_config if block_given?
+      # Initialize client at configuration time (thread-safe write-once pattern)
+      @data_enrichment_client = DataEnrichment::Client.new(config: @data_enrichment_config)
+      @data_enrichment_config
+    end
+
+    # Get the data enrichment client
+    # Thread-safe: uses double-checked locking for lazy initialization fallback
+    def data_enrichment_client
+      return @data_enrichment_client if @data_enrichment_client
+
+      @data_enrichment_client_mutex.synchronize do
+        @data_enrichment_client ||= DataEnrichment::Client.new(config: @data_enrichment_config)
+      end
+    end
+
+    # Set a custom data enrichment client
+    attr_writer :data_enrichment_client
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: decision_agent
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.1
 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
@@ -163,6 +177,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.
@@ -201,6 +229,12 @@ files:
 - lib/decision_agent/auth/session_manager.rb
 - lib/decision_agent/auth/user.rb
 - lib/decision_agent/context.rb
+- lib/decision_agent/data_enrichment/cache/memory_adapter.rb
+- lib/decision_agent/data_enrichment/cache_adapter.rb
+- lib/decision_agent/data_enrichment/circuit_breaker.rb
+- lib/decision_agent/data_enrichment/client.rb
+- lib/decision_agent/data_enrichment/config.rb
+- lib/decision_agent/data_enrichment/errors.rb
 - lib/decision_agent/decision.rb
 - lib/decision_agent/dmn/adapter.rb
 - lib/decision_agent/dmn/cache.rb
@@ -231,6 +265,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 +286,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
@@ -268,6 +315,11 @@ 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/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/server.rb
@@ -286,78 +338,6 @@ 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

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