quonfig 0.0.6 → 0.0.9

data/lib/quonfig/telemetry/telemetry_reporter.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+module Quonfig
+  module Telemetry
+    # Owns the background thread that periodically drains the context
+    # aggregators and POSTs a JSON telemetry batch to
+    # +<telemetry_destination>/api/v1/telemetry/+.
+    #
+    # Wire shape matches api-telemetry's TelemetryEventsSchema:
+    #
+    #   {
+    #     "instanceHash": "...",
+    #     "events": [
+    #       { "summaries":       { "start": ..., "end": ..., "summaries": [...] } },
+    #       { "contextShapes":   { "shapes":   [...] } },
+    #       { "exampleContexts": { "examples": [...] } }
+    #     ]
+    #   }
+    #
+    # Auth is HTTP Basic with username "1" and the SDK key as password
+    # (matching sdk-node and sdk-go). The +X-Quonfig-SDK-Version+ header
+    # carries the +ruby-<VERSION>+ identifier.
+    class TelemetryReporter
+      LOG = Quonfig::InternalLogger.new(self)
+
+      DEFAULT_INITIAL_DELAY_SECONDS = 8
+      DEFAULT_MAX_DELAY_SECONDS = 600
+
+      def initialize(options:, instance_hash:,
+                     context_shape_aggregator: nil,
+                     example_contexts_aggregator: nil,
+                     evaluation_summaries_aggregator: nil,
+                     sync_interval: nil,
+                     http_connection: nil)
+        @options = options
+        @instance_hash = instance_hash
+        @sdk_key = options.sdk_key
+        @telemetry_destination = options.telemetry_destination
+        @context_shape_aggregator = context_shape_aggregator
+        @example_contexts_aggregator = example_contexts_aggregator
+        @evaluation_summaries_aggregator = evaluation_summaries_aggregator
+        @http_connection = http_connection
+        @sync_interval = calculate_sync_interval(sync_interval)
+        @stopped = Concurrent::AtomicBoolean.new(false)
+        @thread = nil
+        @at_exit_registered = false
+      end
+
+      def enabled?
+        return false if @sdk_key.nil? || @sdk_key.to_s.empty?
+        return false if @telemetry_destination.nil? || @telemetry_destination.to_s.empty?
+
+        !@context_shape_aggregator.nil? ||
+          !@example_contexts_aggregator.nil? ||
+          !@evaluation_summaries_aggregator.nil?
+      end
+
+      # Record a context across the context-driven aggregators. Evaluation
+      # summaries are recorded separately via
+      # +record_evaluation(...)+ since they require the evaluation result.
+      def record(context)
+        return if context.nil?
+
+        @context_shape_aggregator&.push(context)
+        @example_contexts_aggregator&.record(context)
+      end
+
+      def record_evaluation(**kwargs)
+        @evaluation_summaries_aggregator&.record(**kwargs)
+      end
+
+      def start
+        return if @thread&.alive?
+        return unless enabled?
+
+        @stopped.make_false
+        register_at_exit_handler
+        @thread = Thread.new do
+          Thread.current.name = 'quonfig-telemetry-reporter'
+          LOG.debug "Telemetry reporter started instance_hash=#{@instance_hash} destination=#{@telemetry_destination}"
+
+          until @stopped.true?
+            begin
+              sleep_duration = @sync_interval.call
+              slept = 0.0
+              step = 0.5
+              while slept < sleep_duration && !@stopped.true?
+                sleep([step, sleep_duration - slept].min)
+                slept += step
+              end
+              break if @stopped.true?
+
+              sync
+            rescue StandardError => e
+              LOG.warn "[quonfig] Telemetry reporter error: #{e.class}: #{e.message}"
+            end
+          end
+        end
+      end
+
+      def stop
+        @stopped.make_true
+        thread = @thread
+        @thread = nil
+        thread&.wakeup if thread&.alive?
+        # Final drain attempt on stop so tests / short-lived processes
+        # don't silently drop pending telemetry.
+        begin
+          sync
+        rescue StandardError => e
+          LOG.debug "[quonfig] Final telemetry sync failed: #{e.class}: #{e.message}"
+        end
+      end
+
+      # Drain all aggregators and POST the batch. Public so tests can
+      # trigger a sync without waiting for the background loop.
+      def sync
+        events = []
+        if (summaries_event = @evaluation_summaries_aggregator&.drain_event)
+          events << summaries_event
+        end
+        if (shape_event = @context_shape_aggregator&.drain_event)
+          events << shape_event
+        end
+        if (example_event = @example_contexts_aggregator&.drain_event)
+          events << example_event
+        end
+
+        return if events.empty?
+
+        payload = {
+          'instanceHash' => @instance_hash,
+          'events' => events
+        }
+
+        post(payload)
+      end
+
+      # Visible for tests.
+      def at_exit_registered?
+        @at_exit_registered
+      end
+
+      private
+
+      # Rails / Passenger / Puma workers often terminate via SIGTERM without
+      # a chance to call Client#stop. Register a Kernel.at_exit hook on
+      # first start so the in-flight batch still gets flushed.
+      def register_at_exit_handler
+        return if @at_exit_registered
+
+        Kernel.at_exit { final_drain_on_exit }
+        @at_exit_registered = true
+      end
+
+      # Wait this long for the background reporter thread to exit before
+      # giving up. Bounded so a thread blocked on a dead telemetry endpoint
+      # can't hang process exit.
+      AT_EXIT_THREAD_JOIN_TIMEOUT_SECONDS = 1.0
+
+      # Idempotent final drain. Safe to call after #stop has already
+      # drained: aggregators return nil when empty and #sync becomes a
+      # no-op. Bounded so a stuck reporter thread or dead telemetry
+      # endpoint can't hang process exit.
+      def final_drain_on_exit
+        @stopped.make_true
+        thread = @thread
+        @thread = nil
+        if thread&.alive?
+          thread.wakeup
+          thread.join(AT_EXIT_THREAD_JOIN_TIMEOUT_SECONDS)
+        end
+        sync
+      rescue StandardError => e
+        LOG.debug "[quonfig] at_exit telemetry drain failed: #{e.class}: #{e.message}"
+      end
+
+      def post(payload)
+        conn = http_connection
+        return if conn.nil?
+
+        response = conn.post('/api/v1/telemetry/', payload)
+        status = response.respond_to?(:status) ? response.status : nil
+        if status && status >= 400
+          LOG.warn "[quonfig] Telemetry POST failed: #{status}"
+        else
+          LOG.debug "[quonfig] Telemetry POST ok: events=#{payload['events'].size}"
+        end
+        response
+      end
+
+      def http_connection
+        @http_connection ||= begin
+          return nil if @sdk_key.nil? || @telemetry_destination.nil?
+
+          Quonfig::HttpConnection.new(@telemetry_destination, @sdk_key)
+        end
+      end
+
+      def calculate_sync_interval(sync_interval)
+        return proc { sync_interval } if sync_interval.is_a?(Numeric)
+        return sync_interval if sync_interval.respond_to?(:call)
+
+        Quonfig::ExponentialBackoff.new(
+          initial_delay: DEFAULT_INITIAL_DELAY_SECONDS,
+          max_delay: DEFAULT_MAX_DELAY_SECONDS,
+          multiplier: 1.5
+        )
+      end
+    end
+  end
+end

data/lib/quonfig.rb

@@ -25,6 +25,7 @@ require 'quonfig/error'
 require 'quonfig/duration'
 require 'quonfig/reason'
 require 'quonfig/evaluation'
+require 'quonfig/evaluation_details'
 require 'quonfig/encryption'
 require 'quonfig/exponential_backoff'
 require 'quonfig/periodic_sync'
@@ -35,7 +36,11 @@ require 'quonfig/errors/env_var_parse_error'
 require 'quonfig/errors/missing_env_var_error'
 require 'quonfig/errors/type_mismatch_error'
 require 'quonfig/errors/uninitialized_error'
+require 'quonfig/errors/decryption_error'
+require 'quonfig/errors/missing_environment_error'
+require 'quonfig/errors/invalid_environment_error'
 require 'quonfig/options'
+require 'quonfig/dev_context'
 require 'quonfig/rate_limit_cache'
 require 'quonfig/weighted_value_resolver'
 require 'quonfig/config_store'
@@ -48,6 +53,11 @@ require 'quonfig/sse_config_client'
 require 'quonfig/http_connection'
 require 'quonfig/caching_http_connection'
 require 'quonfig/context'
+require 'quonfig/telemetry/context_shape'
+require 'quonfig/telemetry/context_shape_aggregator'
+require 'quonfig/telemetry/example_contexts_aggregator'
+require 'quonfig/telemetry/evaluation_summaries_aggregator'
+require 'quonfig/telemetry/telemetry_reporter'
 require 'quonfig/client'
 require 'quonfig/bound_client'
 require 'quonfig/semantic_logger_filter'

data/quonfig.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: quonfig 0.0.2 ruby lib
+# stub: quonfig 0.0.9 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "quonfig".freeze
-  s.version = File.read(File.expand_path("VERSION", __dir__)).strip
+  s.version = "0.0.9".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Jeff Dwyer".freeze]
-  s.date = "2026-04-22"
+  s.date = "2026-04-27"
   s.description = "Quonfig \u2014 feature flags and live config, stored as files in git.".freeze
   s.email = "jeff@quonfig.com".freeze
   s.extra_rdoc_files = [
@@ -54,14 +54,18 @@ Gem::Specification.new do |s|
     "lib/quonfig/config_store.rb",
     "lib/quonfig/context.rb",
     "lib/quonfig/datadir.rb",
+    "lib/quonfig/dev_context.rb",
     "lib/quonfig/duration.rb",
     "lib/quonfig/encryption.rb",
     "lib/quonfig/error.rb",
+    "lib/quonfig/errors/decryption_error.rb",
     "lib/quonfig/errors/env_var_parse_error.rb",
     "lib/quonfig/errors/initialization_timeout_error.rb",
+    "lib/quonfig/errors/invalid_environment_error.rb",
     "lib/quonfig/errors/invalid_sdk_key_error.rb",
     "lib/quonfig/errors/missing_default_error.rb",
     "lib/quonfig/errors/missing_env_var_error.rb",
+    "lib/quonfig/errors/missing_environment_error.rb",
     "lib/quonfig/errors/type_mismatch_error.rb",
     "lib/quonfig/errors/uninitialized_error.rb",
     "lib/quonfig/evaluation.rb",
@@ -80,14 +84,20 @@ Gem::Specification.new do |s|
     "lib/quonfig/semantic_logger_filter.rb",
     "lib/quonfig/semver.rb",
     "lib/quonfig/sse_config_client.rb",
+    "lib/quonfig/stdlib_formatter.rb",
+    "lib/quonfig/telemetry/context_shape.rb",
+    "lib/quonfig/telemetry/context_shape_aggregator.rb",
+    "lib/quonfig/telemetry/evaluation_summaries_aggregator.rb",
+    "lib/quonfig/telemetry/example_contexts_aggregator.rb",
+    "lib/quonfig/telemetry/telemetry_reporter.rb",
     "lib/quonfig/time_helpers.rb",
     "lib/quonfig/types.rb",
     "lib/quonfig/weighted_value_resolver.rb",
     "quonfig.gemspec",
-    "scripts/generate_integration_tests.rb",
     "test/fixtures/datafile.json",
     "test/integration/test_context_precedence.rb",
     "test/integration/test_datadir_environment.rb",
+    "test/integration/test_dev_overrides.rb",
     "test/integration/test_enabled.rb",
     "test/integration/test_enabled_with_contexts.rb",
     "test/integration/test_get.rb",
@@ -105,12 +115,18 @@ Gem::Specification.new do |s|
     "test/test_caching_http_connection.rb",
     "test/test_client.rb",
     "test/test_client_network_mode.rb",
+    "test/test_client_telemetry.rb",
     "test/test_config_loader.rb",
     "test/test_context.rb",
+    "test/test_context_shape.rb",
+    "test/test_context_shape_aggregator.rb",
     "test/test_datadir.rb",
+    "test/test_dev_context.rb",
     "test/test_duration.rb",
     "test/test_encryption.rb",
+    "test/test_evaluation_summaries_aggregator.rb",
     "test/test_evaluator.rb",
+    "test/test_example_contexts_aggregator.rb",
     "test/test_exponential_backoff.rb",
     "test/test_fixed_size_hash.rb",
     "test/test_helper.rb",
@@ -123,7 +139,10 @@ Gem::Specification.new do |s|
     "test/test_resolver.rb",
     "test/test_semantic_logger_filter.rb",
     "test/test_semver.rb",
+    "test/test_should_log.rb",
     "test/test_sse_config_client.rb",
+    "test/test_stdlib_formatter.rb",
+    "test/test_telemetry_reporter.rb",
     "test/test_typed_getters.rb",
     "test/test_types.rb",
     "test/test_weighted_value_resolver.rb"

data/test/integration/test_context_precedence.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 #
 # AUTO-GENERATED from integration-test-data/tests/eval/context_precedence.yaml.
-# Regenerate with `bundle exec ruby scripts/generate_integration_tests.rb`.
+# Regenerate with:
+#   cd integration-test-data/generators && npm run generate -- --target=ruby
+# Source: integration-test-data/generators/src/targets/ruby.ts
 # Do NOT edit by hand — changes will be overwritten.
 
 require 'test_helper'
@@ -14,181 +16,97 @@ class TestContextPrecedence < Minitest::Test
 
   # returns the correct `flag` value using the global context (1)
   def test_returns_the_correct_flag_value_using_the_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
   end
 
   # returns the correct `flag` value using the global context (2)
   def test_returns_the_correct_flag_value_using_the_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
   end
 
   # returns the correct `flag` value when local context clobbers global context (1)
   def test_returns_the_correct_flag_value_when_local_context_clobbers_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
   end
 
   # returns the correct `flag` value when local context clobbers global context (2)
   def test_returns_the_correct_flag_value_when_local_context_clobbers_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
   end
 
   # returns the correct `flag` value when block context clobbers global context (1)
   def test_returns_the_correct_flag_value_when_block_context_clobbers_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
   end
 
   # returns the correct `flag` value when block context clobbers global context (2)
   def test_returns_the_correct_flag_value_when_block_context_clobbers_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
   end
 
   # returns the correct `flag` value when local context clobbers block context (1)
   def test_returns_the_correct_flag_value_when_local_context_clobbers_block_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "?"}}, false)
   end
 
   # returns the correct `flag` value when local context clobbers block context (2)
   def test_returns_the_correct_flag_value_when_local_context_clobbers_block_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_enabled(resolver, "mixed.case.property.name", {"user" => {"isHuman" => "verified"}}, true)
   end
 
   # returns the correct `get` value using the global context (1)
   def test_returns_the_correct_get_value_using_the_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
   end
 
   # returns the correct `get` value using the global context (2)
   def test_returns_the_correct_get_value_using_the_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
-  end
-
-  # returns the correct `get` value using the global context and api context (1)
-  def test_returns_the_correct_get_value_using_the_global_context_and_api_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config.with.api.conditional", {"user" => {"email" => "test@prefab.cloud"}}, "override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
-  end
-
-  # returns the correct `get` value using the global context and api context (2)
-  def test_returns_the_correct_get_value_using_the_global_context_and_api_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config.with.api.conditional", {"user" => {"email" => "test@example.com"}}, "api-override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
   end
 
   # returns the correct `get` value when local context clobbers global context (1)
   def test_returns_the_correct_get_value_when_local_context_clobbers_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
   end
 
   # returns the correct `get` value when local context clobbers global context (2)
   def test_returns_the_correct_get_value_when_local_context_clobbers_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
   end
 
   # returns the correct `get` value when block context clobbers global context (1)
   def test_returns_the_correct_get_value_when_block_context_clobbers_global_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
   end
 
   # returns the correct `get` value when block context clobbers global context (2)
   def test_returns_the_correct_get_value_when_block_context_clobbers_global_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
   end
 
   # returns the correct `get` value when local context clobbers block context (1)
   def test_returns_the_correct_get_value_when_local_context_clobbers_block_context_1
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@example.com"}}, "default")
   end
 
   # returns the correct `get` value when local context clobbers block context (2)
   def test_returns_the_correct_get_value_when_local_context_clobbers_block_context_2
-    begin
-      resolver = IntegrationTestHelpers.build_resolver(@store)
-      IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
-    rescue Exception => e
-      skip("resolver not yet ported for this case: #{e.class}: #{e.message}")
-    end
+    resolver = IntegrationTestHelpers.build_resolver(@store)
+    IntegrationTestHelpers.assert_resolved(resolver, "basic.rule.config", {"user" => {"email" => "test@prefab.cloud"}}, "override")
   end
 end

data/test/integration/test_datadir_environment.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 #
 # AUTO-GENERATED from integration-test-data/tests/eval/datadir_environment.yaml.
-# Regenerate with `bundle exec ruby scripts/generate_integration_tests.rb`.
+# Regenerate with:
+#   cd integration-test-data/generators && npm run generate -- --target=ruby
+# Source: integration-test-data/generators/src/targets/ruby.ts
 # Do NOT edit by hand — changes will be overwritten.
 
 require 'test_helper'
@@ -14,63 +16,39 @@ class TestDatadirEnvironment < Minitest::Test
 
   # datadir with environment option gets environment-specific value
   def test_datadir_with_environment_option_gets_environment_specific_value
-    begin
-      client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
-      assert_equal "test4", client.get("james.test.key")
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
-    end
+    client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
+    assert_equal "test4", client.get("james.test.key")
   end
 
   # datadir with QUONFIG_ENVIRONMENT env var gets environment-specific value
   def test_datadir_with_quonfig_environment_env_var_gets_environment_specific_value
-    begin
-      IntegrationTestHelpers.with_env({"QUONFIG_ENVIRONMENT" => "Production"}) do
-        client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir)
-        assert_equal "test4", client.get("james.test.key")
-      end
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
+    IntegrationTestHelpers.with_env({"QUONFIG_ENVIRONMENT" => "Production"}) do
+      client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir)
+      assert_equal "test4", client.get("james.test.key")
     end
   end
 
   # environment option supersedes QUONFIG_ENVIRONMENT env var
   def test_environment_option_supersedes_quonfig_environment_env_var
-    begin
-      IntegrationTestHelpers.with_env({"QUONFIG_ENVIRONMENT" => "nonexistent"}) do
-        client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
-        assert_equal "test4", client.get("james.test.key")
-      end
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
+    IntegrationTestHelpers.with_env({"QUONFIG_ENVIRONMENT" => "nonexistent"}) do
+      client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
+      assert_equal "test4", client.get("james.test.key")
     end
   end
 
   # config without environment override returns default value
   def test_config_without_environment_override_returns_default_value
-    begin
-      client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
-      assert_equal "hello from no env row", client.get("config.with.only.default.env.row")
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
-    end
+    client = Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "Production")
+    assert_equal "hello from no env row", client.get("config.with.only.default.env.row")
   end
 
   # datadir without environment fails to init
   def test_datadir_without_environment_fails_to_init
-    begin
-      skip("init raise-case (missing_environment) — no Quonfig::Errors mapping yet")
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
-    end
+    assert_raises(Quonfig::Errors::MissingEnvironmentError) { Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir) }
   end
 
   # datadir with invalid environment fails to init
   def test_datadir_with_invalid_environment_fails_to_init
-    begin
-      skip("init raise-case (invalid_environment) — no Quonfig::Errors mapping yet")
-    rescue Exception => e
-      skip("datadir Client.new not yet wired: #{e.class}: #{e.message}")
-    end
+    assert_raises(Quonfig::Errors::InvalidEnvironmentError) { Quonfig::Client.new(datadir: IntegrationTestHelpers.data_dir, environment: "nonexistent") }
   end
 end