RubyGems - decision_agent - Versions diffs - 0.1.3 → 0.1.6 - Mend

decision_agent 0.1.3 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (110) hide show

checksums.yaml +4 -4
data/README.md +84 -233
data/lib/decision_agent/ab_testing/ab_test.rb +197 -0
data/lib/decision_agent/ab_testing/ab_test_assignment.rb +76 -0
data/lib/decision_agent/ab_testing/ab_test_manager.rb +317 -0
data/lib/decision_agent/ab_testing/ab_testing_agent.rb +188 -0
data/lib/decision_agent/ab_testing/storage/activerecord_adapter.rb +155 -0
data/lib/decision_agent/ab_testing/storage/adapter.rb +67 -0
data/lib/decision_agent/ab_testing/storage/memory_adapter.rb +116 -0
data/lib/decision_agent/agent.rb +5 -3
data/lib/decision_agent/auth/access_audit_logger.rb +122 -0
data/lib/decision_agent/auth/authenticator.rb +127 -0
data/lib/decision_agent/auth/password_reset_manager.rb +57 -0
data/lib/decision_agent/auth/password_reset_token.rb +33 -0
data/lib/decision_agent/auth/permission.rb +29 -0
data/lib/decision_agent/auth/permission_checker.rb +43 -0
data/lib/decision_agent/auth/rbac_adapter.rb +278 -0
data/lib/decision_agent/auth/rbac_config.rb +51 -0
data/lib/decision_agent/auth/role.rb +56 -0
data/lib/decision_agent/auth/session.rb +33 -0
data/lib/decision_agent/auth/session_manager.rb +57 -0
data/lib/decision_agent/auth/user.rb +70 -0
data/lib/decision_agent/context.rb +24 -4
data/lib/decision_agent/decision.rb +10 -3
data/lib/decision_agent/dsl/condition_evaluator.rb +378 -1
data/lib/decision_agent/dsl/schema_validator.rb +8 -1
data/lib/decision_agent/errors.rb +38 -0
data/lib/decision_agent/evaluation.rb +10 -3
data/lib/decision_agent/evaluation_validator.rb +8 -13
data/lib/decision_agent/monitoring/dashboard_server.rb +1 -0
data/lib/decision_agent/monitoring/metrics_collector.rb +164 -7
data/lib/decision_agent/monitoring/storage/activerecord_adapter.rb +253 -0
data/lib/decision_agent/monitoring/storage/base_adapter.rb +90 -0
data/lib/decision_agent/monitoring/storage/memory_adapter.rb +222 -0
data/lib/decision_agent/testing/batch_test_importer.rb +373 -0
data/lib/decision_agent/testing/batch_test_runner.rb +244 -0
data/lib/decision_agent/testing/test_coverage_analyzer.rb +191 -0
data/lib/decision_agent/testing/test_result_comparator.rb +235 -0
data/lib/decision_agent/testing/test_scenario.rb +42 -0
data/lib/decision_agent/version.rb +10 -1
data/lib/decision_agent/versioning/activerecord_adapter.rb +1 -1
data/lib/decision_agent/versioning/file_storage_adapter.rb +96 -28
data/lib/decision_agent/web/middleware/auth_middleware.rb +45 -0
data/lib/decision_agent/web/middleware/permission_middleware.rb +94 -0
data/lib/decision_agent/web/public/app.js +184 -29
data/lib/decision_agent/web/public/batch_testing.html +640 -0
data/lib/decision_agent/web/public/index.html +37 -9
data/lib/decision_agent/web/public/login.html +298 -0
data/lib/decision_agent/web/public/users.html +679 -0
data/lib/decision_agent/web/server.rb +873 -7
data/lib/decision_agent.rb +59 -0
data/lib/generators/decision_agent/install/install_generator.rb +37 -0
data/lib/generators/decision_agent/install/templates/ab_test_assignment_model.rb +45 -0
data/lib/generators/decision_agent/install/templates/ab_test_model.rb +54 -0
data/lib/generators/decision_agent/install/templates/ab_testing_migration.rb +43 -0
data/lib/generators/decision_agent/install/templates/ab_testing_tasks.rake +189 -0
data/lib/generators/decision_agent/install/templates/decision_agent_tasks.rake +114 -0
data/lib/generators/decision_agent/install/templates/decision_log.rb +57 -0
data/lib/generators/decision_agent/install/templates/error_metric.rb +53 -0
data/lib/generators/decision_agent/install/templates/evaluation_metric.rb +43 -0
data/lib/generators/decision_agent/install/templates/monitoring_migration.rb +109 -0
data/lib/generators/decision_agent/install/templates/performance_metric.rb +76 -0
data/lib/generators/decision_agent/install/templates/rule_version.rb +1 -1
data/spec/ab_testing/ab_test_assignment_spec.rb +253 -0
data/spec/ab_testing/ab_test_manager_spec.rb +612 -0
data/spec/ab_testing/ab_test_spec.rb +270 -0
data/spec/ab_testing/ab_testing_agent_spec.rb +481 -0
data/spec/ab_testing/storage/adapter_spec.rb +64 -0
data/spec/ab_testing/storage/memory_adapter_spec.rb +485 -0
data/spec/advanced_operators_spec.rb +1003 -0
data/spec/agent_spec.rb +40 -0
data/spec/audit_adapters_spec.rb +18 -0
data/spec/auth/access_audit_logger_spec.rb +394 -0
data/spec/auth/authenticator_spec.rb +112 -0
data/spec/auth/password_reset_spec.rb +294 -0
data/spec/auth/permission_checker_spec.rb +207 -0
data/spec/auth/permission_spec.rb +73 -0
data/spec/auth/rbac_adapter_spec.rb +550 -0
data/spec/auth/rbac_config_spec.rb +82 -0
data/spec/auth/role_spec.rb +51 -0
data/spec/auth/session_manager_spec.rb +172 -0
data/spec/auth/session_spec.rb +112 -0
data/spec/auth/user_spec.rb +130 -0
data/spec/context_spec.rb +43 -0
data/spec/decision_agent_spec.rb +96 -0
data/spec/decision_spec.rb +423 -0
data/spec/dsl/condition_evaluator_spec.rb +774 -0
data/spec/evaluation_spec.rb +364 -0
data/spec/evaluation_validator_spec.rb +165 -0
data/spec/examples.txt +1542 -548
data/spec/issue_verification_spec.rb +95 -21
data/spec/monitoring/metrics_collector_spec.rb +221 -3
data/spec/monitoring/monitored_agent_spec.rb +1 -1
data/spec/monitoring/prometheus_exporter_spec.rb +1 -1
data/spec/monitoring/storage/activerecord_adapter_spec.rb +498 -0
data/spec/monitoring/storage/base_adapter_spec.rb +61 -0
data/spec/monitoring/storage/memory_adapter_spec.rb +247 -0
data/spec/performance_optimizations_spec.rb +486 -0
data/spec/spec_helper.rb +23 -0
data/spec/testing/batch_test_importer_spec.rb +693 -0
data/spec/testing/batch_test_runner_spec.rb +307 -0
data/spec/testing/test_coverage_analyzer_spec.rb +292 -0
data/spec/testing/test_result_comparator_spec.rb +392 -0
data/spec/testing/test_scenario_spec.rb +113 -0
data/spec/versioning/adapter_spec.rb +156 -0
data/spec/versioning_spec.rb +253 -0
data/spec/web/middleware/auth_middleware_spec.rb +133 -0
data/spec/web/middleware/permission_middleware_spec.rb +247 -0
data/spec/web_ui_rack_spec.rb +1705 -0
metadata +123 -6

data/lib/decision_agent/web/server.rb CHANGED Viewed

@@ -1,19 +1,96 @@
 require "sinatra/base"
 require "json"
+require "securerandom"
+require "tempfile"
+# Ensure testing classes are loaded
+require_relative "../testing/test_scenario"
+require_relative "../testing/batch_test_importer"
+require_relative "../testing/batch_test_runner"
+require_relative "../testing/test_result_comparator"
+require_relative "../testing/test_coverage_analyzer"
+require_relative "../evaluators/json_rule_evaluator"
+require_relative "../agent"
+# Auth components
+require_relative "../auth/user"
+require_relative "../auth/role"
+require_relative "../auth/permission"
+require_relative "../auth/session"
+require_relative "../auth/session_manager"
+require_relative "../auth/authenticator"
+require_relative "../auth/permission_checker"
+require_relative "../auth/access_audit_logger"
+require_relative "middleware/auth_middleware"
+require_relative "middleware/permission_middleware"
 module DecisionAgent
   module Web
+    # rubocop:disable Metrics/ClassLength
     class Server < Sinatra::Base
       set :public_folder, File.expand_path("public", __dir__)
       set :views, File.expand_path("views", __dir__)
       set :bind, "0.0.0.0"
       set :port, 4567
+      # In-memory storage for batch test runs
+      @batch_test_storage = {}
+      @batch_test_storage_mutex = Mutex.new
+      # Auth components
+      @authenticator = nil
+      @permission_checker = nil
+      @access_audit_logger = nil
+      def self.batch_test_storage
+        @batch_test_storage ||= {}
+      end
+      def self.batch_test_storage_mutex
+        @batch_test_storage_mutex ||= Mutex.new
+      end
+      class << self
+        attr_writer :authenticator
+      end
+      def self.authenticator
+        @authenticator ||= Auth::Authenticator.new
+      end
+      class << self
+        attr_writer :permission_checker
+      end
+      def self.permission_checker
+        @permission_checker ||= Auth::PermissionChecker.new(adapter: DecisionAgent.rbac_config.adapter)
+      end
+      class << self
+        attr_writer :access_audit_logger
+      end
+      def self.access_audit_logger
+        @access_audit_logger ||= Auth::AccessAuditLogger.new
+      end
       # Enable CORS for API calls
       before do
         headers["Access-Control-Allow-Origin"] = "*"
         headers["Access-Control-Allow-Methods"] = "GET, POST, DELETE, OPTIONS"
-        headers["Access-Control-Allow-Headers"] = "Content-Type"
+        headers["Access-Control-Allow-Headers"] = "Content-Type, Authorization"
+      end
+      # Auth middleware - extract user from token
+      before do
+        token = extract_token
+        if token
+          auth_result = self.class.authenticator.authenticate(token)
+          if auth_result
+            @current_user = auth_result[:user]
+            @current_session = auth_result[:session]
+          end
+        end
       end
       # OPTIONS handler for CORS preflight
@@ -23,7 +100,46 @@ module DecisionAgent
       # Main page - serve the rule builder UI
       get "/" do
-        send_file File.join(settings.public_folder, "index.html")
+        # Read the HTML file
+        html_file = File.join(settings.public_folder, "index.html")
+        unless File.exist?(html_file)
+          status 404
+          return "Index page not found"
+        end
+        html_content = File.read(html_file, encoding: "UTF-8")
+        # Determine the base path from the request
+        # When mounted in Rails, request.script_name contains the mount path
+        base_path = request.script_name.empty? ? "./" : "#{request.script_name}/"
+        # Inject or update base tag
+        base_tag = "<base href=\"#{base_path}\">"
+        html_content = if html_content.include?("<base")
+                         # Replace existing base tag
+                         html_content.sub(/<base[^>]*>/, base_tag)
+                       else
+                         # Insert base tag after <head>
+                         html_content.sub("<head>", "<head>\n    #{base_tag}")
+                       end
+        content_type "text/html"
+        html_content
+      rescue StandardError => e
+        status 500
+        content_type "text/html"
+        "Error loading page: #{e.message}"
+      end
+      # Serve static assets explicitly (needed when mounted in Rails)
+      get "/styles.css" do
+        content_type "text/css"
+        send_file File.join(settings.public_folder, "styles.css")
+      end
+      get "/app.js" do
+        content_type "application/javascript"
+        send_file File.join(settings.public_folder, "app.js")
       end
       # API: Validate rules
@@ -219,11 +335,392 @@ module DecisionAgent
         { status: "ok", version: DecisionAgent::VERSION }.to_json
       end
+      # Authentication API endpoints
+      # POST /api/auth/login - User login
+      post "/api/auth/login" do
+        content_type :json
+        begin
+          request_body = request.body.read
+          data = JSON.parse(request_body)
+          email = data["email"]
+          password = data["password"]
+          unless email && password
+            status 400
+            return { error: "Email and password are required" }.to_json
+          end
+          session = self.class.authenticator.login(email, password)
+          unless session
+            self.class.access_audit_logger.log_authentication(
+              "login",
+              user_id: nil,
+              email: email,
+              success: false,
+              reason: "Invalid credentials"
+            )
+            status 401
+            return { error: "Invalid email or password" }.to_json
+          end
+          user = self.class.authenticator.find_user(session.user_id)
+          self.class.access_audit_logger.log_authentication(
+            "login",
+            user_id: user.id,
+            email: user.email,
+            success: true
+          )
+          {
+            token: session.token,
+            user: user.to_h,
+            expires_at: session.expires_at.iso8601
+          }.to_json
+        rescue JSON::ParserError
+          status 400
+          { error: "Invalid JSON" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # POST /api/auth/logout - User logout
+      post "/api/auth/logout" do
+        content_type :json
+        begin
+          token = extract_token
+          if token
+            self.class.authenticator.logout(token)
+            if @current_user
+              checker = self.class.permission_checker
+              self.class.access_audit_logger.log_authentication(
+                "logout",
+                user_id: checker.user_id(@current_user),
+                email: checker.user_email(@current_user),
+                success: true
+              )
+            end
+          end
+          { success: true, message: "Logged out successfully" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # GET /api/auth/me - Current user info
+      get "/api/auth/me" do
+        content_type :json
+        if @current_user
+          @current_user.to_h.to_json
+        else
+          status 401
+          { error: "Not authenticated" }.to_json
+        end
+      end
+      # GET /api/auth/roles - List all roles
+      get "/api/auth/roles" do
+        content_type :json
+        require_permission!(:read)
+        roles = Auth::Role.all.map do |role|
+          {
+            id: role.to_s,
+            name: Auth::Role.name_for(role),
+            permissions: Auth::Role.permissions_for(role).map(&:to_s)
+          }
+        end
+        roles.to_json
+      end
+      # POST /api/auth/users - Create user (admin only)
+      post "/api/auth/users" do
+        content_type :json
+        require_permission!(:manage_users)
+        begin
+          request_body = request.body.read
+          data = JSON.parse(request_body)
+          email = data["email"]
+          password = data["password"]
+          roles = data["roles"] || []
+          unless email && password
+            status 400
+            return { error: "Email and password are required" }.to_json
+          end
+          # Validate roles
+          roles.each do |role|
+            unless Auth::Role.exists?(role)
+              status 400
+              return { error: "Invalid role: #{role}" }.to_json
+            end
+          end
+          user = self.class.authenticator.create_user(
+            email: email,
+            password: password,
+            roles: roles
+          )
+          checker = self.class.permission_checker
+          self.class.access_audit_logger.log_access(
+            user_id: checker.user_id(@current_user),
+            action: "create_user",
+            resource_type: "user",
+            resource_id: user.id,
+            success: true
+          )
+          status 201
+          user.to_h.to_json
+        rescue JSON::ParserError
+          status 400
+          { error: "Invalid JSON" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # GET /api/auth/users - List users (admin only)
+      get "/api/auth/users" do
+        content_type :json
+        require_permission!(:manage_users)
+        users = self.class.authenticator.user_store.all.map(&:to_h)
+        users.to_json
+      end
+      # POST /api/auth/users/:id/roles - Assign role to user (admin only)
+      post "/api/auth/users/:id/roles" do
+        content_type :json
+        require_permission!(:manage_users)
+        begin
+          user_id = params[:id]
+          request_body = request.body.read
+          data = JSON.parse(request_body)
+          role = data["role"]
+          unless role
+            status 400
+            return { error: "Role is required" }.to_json
+          end
+          unless Auth::Role.exists?(role)
+            status 400
+            return { error: "Invalid role: #{role}" }.to_json
+          end
+          user = self.class.authenticator.find_user(user_id)
+          unless user
+            status 404
+            return { error: "User not found" }.to_json
+          end
+          user.assign_role(role)
+          checker = self.class.permission_checker
+          self.class.access_audit_logger.log_access(
+            user_id: checker.user_id(@current_user),
+            action: "assign_role",
+            resource_type: "user",
+            resource_id: user.id,
+            success: true
+          )
+          user.to_h.to_json
+        rescue JSON::ParserError
+          status 400
+          { error: "Invalid JSON" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # DELETE /api/auth/users/:id/roles/:role - Remove role from user (admin only)
+      delete "/api/auth/users/:id/roles/:role" do
+        content_type :json
+        require_permission!(:manage_users)
+        begin
+          user_id = params[:id]
+          role = params[:role]
+          user = self.class.authenticator.find_user(user_id)
+          unless user
+            status 404
+            return { error: "User not found" }.to_json
+          end
+          user.remove_role(role)
+          checker = self.class.permission_checker
+          self.class.access_audit_logger.log_access(
+            user_id: checker.user_id(@current_user),
+            action: "remove_role",
+            resource_type: "user",
+            resource_id: user.id,
+            success: true
+          )
+          user.to_h.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # GET /api/auth/audit - Query access audit logs
+      get "/api/auth/audit" do
+        content_type :json
+        require_permission!(:audit)
+        begin
+          filters = {}
+          filters[:user_id] = params[:user_id] if params[:user_id]
+          filters[:event_type] = params[:event_type] if params[:event_type]
+          filters[:start_time] = params[:start_time] if params[:start_time]
+          filters[:end_time] = params[:end_time] if params[:end_time]
+          filters[:limit] = params[:limit]&.to_i if params[:limit]
+          logs = self.class.access_audit_logger.query(filters)
+          logs.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # POST /api/auth/password/reset-request - Request password reset
+      post "/api/auth/password/reset-request" do
+        content_type :json
+        begin
+          request_body = request.body.read
+          data = JSON.parse(request_body)
+          email = data["email"]
+          unless email
+            status 400
+            return { error: "Email is required" }.to_json
+          end
+          token = self.class.authenticator.request_password_reset(email)
+          # For security, we always return success even if user doesn't exist
+          # In production, you would send the token via email
+          if token
+            self.class.access_audit_logger.log_authentication(
+              "password_reset_request",
+              user_id: token.user_id,
+              email: email,
+              success: true
+            )
+            {
+              success: true,
+              message: "If the email exists, a password reset token has been generated",
+              # In production, remove this token from response and send via email
+              token: token.token,
+              expires_at: token.expires_at.iso8601
+            }.to_json
+          else
+            # Log failed attempt (but don't reveal if user exists)
+            self.class.access_audit_logger.log_authentication(
+              "password_reset_request",
+              user_id: nil,
+              email: email,
+              success: false,
+              reason: "User not found or inactive"
+            )
+            {
+              success: true,
+              message: "If the email exists, a password reset token has been generated"
+            }.to_json
+          end
+        rescue JSON::ParserError
+          status 400
+          { error: "Invalid JSON" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # POST /api/auth/password/reset - Reset password with token
+      post "/api/auth/password/reset" do
+        content_type :json
+        begin
+          request_body = request.body.read
+          data = JSON.parse(request_body)
+          token = data["token"]
+          new_password = data["password"]
+          unless token && new_password
+            status 400
+            return { error: "Token and password are required" }.to_json
+          end
+          unless new_password.length >= 8
+            status 400
+            return { error: "Password must be at least 8 characters long" }.to_json
+          end
+          user = self.class.authenticator.reset_password(token, new_password)
+          unless user
+            status 400
+            return { error: "Invalid or expired reset token" }.to_json
+          end
+          self.class.access_audit_logger.log_authentication(
+            "password_reset",
+            user_id: user.id,
+            email: user.email,
+            success: true
+          )
+          {
+            success: true,
+            message: "Password has been reset successfully"
+          }.to_json
+        rescue JSON::ParserError
+          status 400
+          { error: "Invalid JSON" }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
       # Versioning API endpoints
       # Create a new version
       post "/api/versions" do
         content_type :json
+        require_permission!(:write)
         begin
           request_body = request.body.read
@@ -231,7 +728,7 @@ module DecisionAgent
           rule_id = data["rule_id"]
           rule_content = data["content"]
-          created_by = data["created_by"] || "system"
+          created_by = data["created_by"] || (@current_user&.email || "system")
           changelog = data["changelog"]
           version = version_manager.save_version(
@@ -252,6 +749,7 @@ module DecisionAgent
       # List all versions for a rule
       get "/api/rules/:rule_id/versions" do
         content_type :json
+        require_permission!(:read)
         begin
           rule_id = params[:rule_id]
@@ -269,6 +767,7 @@ module DecisionAgent
       # Get version history with metadata
       get "/api/rules/:rule_id/history" do
         content_type :json
+        require_permission!(:read)
         begin
           rule_id = params[:rule_id]
@@ -284,6 +783,7 @@ module DecisionAgent
       # Get a specific version
       get "/api/versions/:version_id" do
         content_type :json
+        require_permission!(:read)
         begin
           version_id = params[:version_id]
@@ -304,12 +804,13 @@ module DecisionAgent
       # Activate a version (rollback)
       post "/api/versions/:version_id/activate" do
         content_type :json
+        require_permission!(:deploy)
         begin
           version_id = params[:version_id]
           request_body = request.body.read
           data = request_body.empty? ? {} : JSON.parse(request_body)
-          performed_by = data["performed_by"] || "system"
+          performed_by = data["performed_by"] || (@current_user&.email || "system")
           version = version_manager.rollback(
             version_id: version_id,
@@ -326,6 +827,7 @@ module DecisionAgent
       # Compare two versions
       get "/api/versions/:version_id_1/compare/:version_id_2" do
         content_type :json
+        require_permission!(:read)
         begin
           version_id_1 = params[:version_id_1]
@@ -353,30 +855,393 @@ module DecisionAgent
         content_type :json
         begin
+          require_permission!(:delete)
           version_id = params[:version_id]
-          version_manager.delete_version(version_id: version_id)
+          # Ensure version_id is present
+          unless version_id
+            status 400
+            return { error: "Version ID is required" }.to_json
+          end
+          result = version_manager.delete_version(version_id: version_id)
-          status 200
-          { success: true, message: "Version deleted successfully" }.to_json
+          if result == false
+            status 404
+            { error: "Version not found" }.to_json
+          else
+            status 200
+            { success: true, message: "Version deleted successfully" }.to_json
+          end
         rescue DecisionAgent::NotFoundError => e
           status 404
           { error: e.message }.to_json
         rescue DecisionAgent::ValidationError => e
           status 422
           { error: e.message }.to_json
+        rescue StandardError
+          # Log the error for debugging but return a safe response
+          # In production, you might want to log this to a proper logger
+          status 500
+          { error: "Internal server error" }.to_json
+        end
+      end
+      # Batch Testing API Endpoints
+      # POST /api/testing/batch/import - Upload CSV/Excel file
+      post "/api/testing/batch/import" do
+        content_type :json
+        begin
+          unless params[:file] && params[:file][:tempfile]
+            status 400
+            return { error: "No file uploaded" }.to_json
+          end
+          uploaded_file = params[:file][:tempfile]
+          filename = params[:file][:filename] || "uploaded_file"
+          file_extension = File.extname(filename).downcase
+          # Create temporary file
+          temp_file = Tempfile.new(["batch_test", file_extension])
+          temp_file.binmode
+          temp_file.write(uploaded_file.read)
+          temp_file.rewind
+          # Import scenarios based on file type
+          importer = DecisionAgent::Testing::BatchTestImporter.new
+          scenarios = if [".xlsx", ".xls"].include?(file_extension)
+                        importer.import_excel(temp_file.path)
+                      else
+                        importer.import_csv(temp_file.path)
+                      end
+          temp_file.close
+          temp_file.unlink
+          # Check for import errors - return error status if there are errors and no scenarios
+          if importer.errors.any? && scenarios.empty?
+            status 422
+            return { error: "Import failed: #{importer.errors.join('; ')}" }.to_json
+          end
+          # If there are errors but some scenarios were created, still return error status
+          # to indicate partial failure
+          if importer.errors.any?
+            status 422
+            return {
+              error: "Import completed with errors: #{importer.errors.join('; ')}",
+              test_id: nil,
+              scenarios_count: scenarios.size,
+              errors: importer.errors,
+              warnings: importer.warnings
+            }.to_json
+          end
+          # Store scenarios with a unique ID
+          test_id = SecureRandom.uuid
+          self.class.batch_test_storage_mutex.synchronize do
+            self.class.batch_test_storage[test_id] = {
+              id: test_id,
+              scenarios: scenarios,
+              status: "imported",
+              created_at: Time.now.utc.iso8601,
+              results: nil,
+              coverage: nil
+            }
+          end
+          status 201
+          {
+            test_id: test_id,
+            scenarios_count: scenarios.size,
+            errors: importer.errors,
+            warnings: importer.warnings
+          }.to_json
+        rescue DecisionAgent::ImportError => e
+          status 422
+          { error: e.message, errors: importer&.errors || [] }.to_json
+        rescue StandardError => e
+          status 500
+          { error: "Failed to import file: #{e.message}" }.to_json
+        end
+      end
+      # POST /api/testing/batch/run - Execute batch test
+      post "/api/testing/batch/run" do
+        content_type :json
+        begin
+          request_body = request.body.read
+          data = request_body.empty? ? {} : JSON.parse(request_body)
+          test_id = data["test_id"] || params[:test_id]
+          rules_json = data["rules"]
+          options = data["options"] || {}
+          unless test_id
+            status 400
+            return { error: "test_id is required" }.to_json
+          end
+          unless rules_json
+            status 400
+            return { error: "rules JSON is required" }.to_json
+          end
+          # Get stored scenarios
+          test_data = nil
+          self.class.batch_test_storage_mutex.synchronize do
+            test_data = self.class.batch_test_storage[test_id]
+          end
+          unless test_data
+            status 404
+            return { error: "Test not found" }.to_json
+          end
+          # Create agent from rules
+          evaluator = DecisionAgent::Evaluators::JsonRuleEvaluator.new(rules_json: rules_json)
+          agent = DecisionAgent::Agent.new(evaluators: [evaluator])
+          # Update status
+          self.class.batch_test_storage_mutex.synchronize do
+            self.class.batch_test_storage[test_id][:status] = "running"
+            self.class.batch_test_storage[test_id][:started_at] = Time.now.utc.iso8601
+          end
+          # Run batch test
+          runner = DecisionAgent::Testing::BatchTestRunner.new(agent)
+          results = runner.run(
+            test_data[:scenarios],
+            parallel: options.fetch("parallel", true),
+            thread_count: options.fetch("thread_count", 4),
+            checkpoint_file: options["checkpoint_file"]
+          )
+          # Calculate comparison if expected results exist
+          comparison = nil
+          if test_data[:scenarios].any?(&:expected_result?)
+            comparator = DecisionAgent::Testing::TestResultComparator.new
+            comparison = comparator.compare(results, test_data[:scenarios])
+          end
+          # Calculate coverage
+          coverage_analyzer = DecisionAgent::Testing::TestCoverageAnalyzer.new
+          coverage = coverage_analyzer.analyze(results, agent)
+          # Store results
+          self.class.batch_test_storage_mutex.synchronize do
+            self.class.batch_test_storage[test_id][:status] = "completed"
+            self.class.batch_test_storage[test_id][:results] = results.map(&:to_h)
+            self.class.batch_test_storage[test_id][:comparison] = comparison
+            self.class.batch_test_storage[test_id][:coverage] = coverage.to_h
+            self.class.batch_test_storage[test_id][:statistics] = runner.statistics
+            self.class.batch_test_storage[test_id][:completed_at] = Time.now.utc.iso8601
+          end
+          {
+            test_id: test_id,
+            status: "completed",
+            results_count: results.size,
+            statistics: runner.statistics,
+            comparison: comparison,
+            coverage: coverage.to_h
+          }.to_json
+        rescue StandardError => e
+          # Update status to failed
+          if test_id
+            self.class.batch_test_storage_mutex.synchronize do
+              if self.class.batch_test_storage[test_id]
+                self.class.batch_test_storage[test_id][:status] = "failed"
+                self.class.batch_test_storage[test_id][:error] = e.message
+              end
+            end
+          end
+          status 500
+          { error: "Batch test execution failed: #{e.message}" }.to_json
+        end
+      end
+      # GET /api/testing/batch/:id/results - Get batch test results
+      get "/api/testing/batch/:id/results" do
+        content_type :json
+        begin
+          test_id = params[:id]
+          test_data = nil
+          self.class.batch_test_storage_mutex.synchronize do
+            test_data = self.class.batch_test_storage[test_id]
+          end
+          unless test_data
+            status 404
+            return { error: "Test not found" }.to_json
+          end
+          {
+            test_id: test_data[:id],
+            status: test_data[:status],
+            created_at: test_data[:created_at],
+            started_at: test_data[:started_at],
+            completed_at: test_data[:completed_at],
+            scenarios_count: test_data[:scenarios]&.size || 0,
+            results: test_data[:results],
+            comparison: test_data[:comparison],
+            statistics: test_data[:statistics],
+            error: test_data[:error]
+          }.to_json
+        rescue StandardError => e
+          status 500
+          { error: e.message }.to_json
+        end
+      end
+      # GET /api/testing/batch/:id/coverage - Get coverage report
+      get "/api/testing/batch/:id/coverage" do
+        content_type :json
+        begin
+          test_id = params[:id]
+          test_data = nil
+          self.class.batch_test_storage_mutex.synchronize do
+            test_data = self.class.batch_test_storage[test_id]
+          end
+          unless test_data
+            status 404
+            return { error: "Test not found" }.to_json
+          end
+          unless test_data[:coverage]
+            status 404
+            return { error: "Coverage report not available. Run the batch test first." }.to_json
+          end
+          {
+            test_id: test_data[:id],
+            coverage: test_data[:coverage]
+          }.to_json
         rescue StandardError => e
           status 500
           { error: e.message }.to_json
         end
       end
+      # GET /testing/batch - Batch testing UI page
+      get "/testing/batch" do
+        send_file File.join(settings.public_folder, "batch_testing.html")
+      rescue StandardError
+        status 404
+        "Batch testing page not found"
+      end
+      # GET /auth/login - Login page
+      get "/auth/login" do
+        send_file File.join(settings.public_folder, "login.html")
+      rescue StandardError
+        status 404
+        "Login page not found"
+      end
+      # GET /auth/users - User management page
+      get "/auth/users" do
+        send_file File.join(settings.public_folder, "users.html")
+      rescue StandardError
+        status 404
+        "User management page not found"
+      end
       private
       def version_manager
         @version_manager ||= DecisionAgent::Versioning::VersionManager.new
       end
+      def extract_token
+        # Check Authorization header: Bearer <token>
+        auth_header = request.env["HTTP_AUTHORIZATION"]
+        return auth_header[7..] if auth_header&.start_with?("Bearer ")
+        # Check session cookie
+        cookie_token = request.cookies["decision_agent_session"]
+        return cookie_token if cookie_token
+        # Check query parameter
+        params["token"]
+      end
+      attr_reader :current_user
+      def require_authentication!
+        return if @current_user
+        content_type :json
+        halt 401, { error: "Authentication required" }.to_json
+      end
+      def require_permission!(permission, resource = nil)
+        # Always require authentication first
+        require_authentication!
+        # Skip permission checks if disabled via environment variable
+        # Useful for development environments
+        # This allows authenticated users to bypass permission checks
+        return true if permissions_disabled?
+        checker = self.class.permission_checker
+        unless checker.can?(@current_user, permission, resource)
+          begin
+            self.class.access_audit_logger.log_permission_check(
+              user_id: checker.user_id(@current_user),
+              permission: permission,
+              resource_type: resource&.class&.name,
+              resource_id: resource&.id,
+              granted: false
+            )
+          rescue StandardError
+            # If logging fails, continue with permission denial
+          end
+          # Move halt outside ensure block - Ruby 3.1 compatibility
+          # Placing halt here instead of ensure block fixes Ruby 3.1 issue where
+          # halt inside ensure doesn't reliably stop execution
+          content_type :json
+          halt 403, { error: "Permission denied: #{permission}" }.to_json
+        end
+        begin
+          self.class.access_audit_logger.log_permission_check(
+            user_id: checker.user_id(@current_user),
+            permission: permission,
+            resource_type: resource&.class&.name,
+            resource_id: resource&.id,
+            granted: true
+          )
+        rescue StandardError
+          # If logging fails, continue - permission was granted
+        end
+      end
+      def permissions_disabled?
+        # Check explicit environment variable first
+        # Make it case-insensitive and handle whitespace
+        disable_flag = ENV.fetch("DISABLE_WEBUI_PERMISSIONS", nil)
+        if disable_flag
+          normalized = disable_flag.to_s.strip.downcase
+          return true if %w[true 1 yes].include?(normalized)
+          return false if %w[false 0 no].include?(normalized)
+        end
+        # Auto-disable in development environments if not explicitly set
+        env = ENV["RACK_ENV"] || ENV["RAILS_ENV"] || "development"
+        env == "development"
+      end
       def parse_validation_errors(error_message)
         # Extract individual errors from the formatted error message
         errors = []
@@ -411,5 +1276,6 @@ module DecisionAgent
         new.call(env)
       end
     end
+    # rubocop:enable Metrics/ClassLength
   end
 end