familia 2.0.0.pre17 → 2.0.0.pre18

data/try/{horreum → unit/horreum}/serialization_persistent_fields_try.rb

@@ -1,36 +1,42 @@
 # try/horreum/serialization_persistent_fields_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 Familia.debug = false
 
-# Test class with mixed field categories for serialization
+# Test class with mixed field types for serialization
 class SerializationCategoryTest < Familia::Horreum
+  feature :transient_fields
+
   identifier_field :id
   field :id
   field :name                           # persistent by default
-  field :email, category: :encrypted    # persistent, encrypted category
-  field :tryouts_cache_data, category: :transient # should be excluded from serialization
-  field :description, category: :persistent # explicitly persistent
-  field :temp_settings, category: :transient # should be excluded
-  field :metadata, category: :persistent # explicitly persistent
+  field :email                          # persistent field
+  transient_field :tryouts_cache_data   # should be excluded from serialization
+  field :description                    # explicitly persistent
+  transient_field :temp_settings        # should be excluded
+  field :metadata                       # explicitly persistent
 end
 
 # Class with all transient fields
 class AllTransientSerializationTest < Familia::Horreum
+  feature :transient_fields
+
   identifier_field :id
   field :id
-  field :temp1, category: :transient
-  field :temp2, category: :transient
+  transient_field :temp1
+  transient_field :temp2
 end
 
-# Mixed categories with aliased fields
+# Mixed field types with aliased fields
 class AliasedSerializationTest < Familia::Horreum
+  feature :transient_fields
+
   identifier_field :id
   field :id
-  field :internal_name, as: :display_name, category: :persistent
-  field :temp_cache, as: :cache, category: :transient
-  field :user_data, as: :data, category: :encrypted
+  field :internal_name, as: :display_name
+  transient_field :temp_cache, as: :cache
+  field :user_data, as: :data
 end
 
 # Setup test instance with all field types
@@ -66,7 +72,7 @@ end
 @hash_result.key?("name")
 #=> true
 
-## to_h includes encrypted persistent fields
+## to_h includes regular persistent fields
 @hash_result.key?("email")
 #=> true
 
@@ -82,9 +88,9 @@ end
 @hash_result.key?(:temp_settings)
 #=> false
 
-## to_h serializes complex values correctly
-@hash_result["metadata"]
-#=:> String
+## to_h returns actual Ruby values (Hash, not serialized JSON string)
+@hash_result["metadata"].class
+#=> Hash
 
 ## to_a excludes transient fields
 @array_result = @serialization_test.to_a
@@ -133,7 +139,7 @@ SerializationCategoryTest.persistent_fields.include?(:email)
 @all_transient.to_a
 #=> ["transient_test_1"]
 
-## Aliased fields serialization uses original field names
+## Aliased fields serialization uses original field names (transient excluded)
 @aliased_hash = @aliased_test.to_h
 @aliased_hash.keys.sort
 #=> ["id", "internal_name", "user_data"]

data/try/{horreum → unit/horreum}/serialization_try.rb

@@ -1,6 +1,6 @@
 # try/horreum/serialization_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 Familia.debug = false
 
@@ -103,9 +103,9 @@ Familia.dbclient.set('debug:ending_save_if_not_exists_tests', Familia.now.to_s)
 [@customer.name, @customer.email]
 #=> ["Bob Jones", "jane@example.com"]
 
-## serialize_value handles strings
+## serialize_value handles strings with JSON encoding
 @customer.serialize_value('test string')
-#=> "test string"
+#=> "\"test string\""
 
 ## serialize_value handles numbers
 @customer.serialize_value(42)
@@ -121,7 +121,7 @@ Familia.dbclient.set('debug:ending_save_if_not_exists_tests', Familia.now.to_s)
 
 ## deserialize_value handles JSON strings back to objects
 @customer.deserialize_value('{"key":"value","num":123}')
-#=> {:key=>"value", :num=>123}
+#=> {"key"=>"value", "num"=>123}
 
 ## deserialize_value handles JSON arrays
 @customer.deserialize_value('[1,2,"three"]')

data/try/{horreum → unit/horreum}/settings_try.rb

@@ -2,7 +2,7 @@
 
 # Test Horreum settings
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 ## database selection inheritance
 user_class = Class.new(Familia::Horreum) do

data/try/{refinements → unit/refinements}/dear_json_array_methods_try.rb

@@ -1,6 +1,6 @@
 # try/refinements/dear_json_array_methods_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 class TestArrayWithDearJson < Array
   include Familia::Refinements::DearJsonArrayMethods

data/try/{refinements → unit/refinements}/dear_json_hash_methods_try.rb

@@ -1,6 +1,6 @@
 # try/refinements/dear_json_hash_methods_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 class TestHashWithDearJson < Hash
   include Familia::Refinements::DearJsonHashMethods

data/try/{refinements → unit/refinements}/time_literals_numeric_methods_try.rb

@@ -1,6 +1,6 @@
 # try/refinements/time_literals_numeric_methods_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 class TestNumericWithTimeLiterals
   include Familia::Refinements::TimeLiterals::NumericMethods

data/try/{refinements → unit/refinements}/time_literals_string_methods_try.rb

@@ -1,6 +1,6 @@
 # try/refinements/time_literals_string_methods_try.rb
 
-require_relative '../helpers/test_helpers'
+require_relative '../../support/helpers/test_helpers'
 
 class TestStringWithTimeLiterals < String
   include Familia::Refinements::TimeLiterals::StringMethods

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: familia
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre17
+  version: 2.0.0.pre18
 platform: ruby
 authors:
 - Delano Mandelbaum
@@ -184,10 +184,12 @@ files:
 - docs/migrating/v2.0.0-pre12.md
 - docs/migrating/v2.0.0-pre13.md
 - docs/migrating/v2.0.0-pre14.md
+- docs/migrating/v2.0.0-pre18.md
 - docs/migrating/v2.0.0-pre5.md
 - docs/migrating/v2.0.0-pre6.md
 - docs/migrating/v2.0.0-pre7.md
 - docs/overview.md
+- docs/qodo-merge-compliance.md
 - docs/reference/api-technical.md
 - examples/autoloader/mega_customer.rb
 - examples/autoloader/mega_customer/features/deprecated_fields.rb
@@ -210,8 +212,8 @@ files:
 - lib/familia/connection/transaction_core.rb
 - lib/familia/data_type.rb
 - lib/familia/data_type/class_methods.rb
-- lib/familia/data_type/commands.rb
 - lib/familia/data_type/connection.rb
+- lib/familia/data_type/database_commands.rb
 - lib/familia/data_type/serialization.rb
 - lib/familia/data_type/settings.rb
 - lib/familia/data_type/types/counter.rb
@@ -221,7 +223,6 @@ files:
 - lib/familia/data_type/types/sorted_set.rb
 - lib/familia/data_type/types/stringkey.rb
 - lib/familia/data_type/types/unsorted_set.rb
-- lib/familia/distinguisher.rb
 - lib/familia/encryption.rb
 - lib/familia/encryption/encrypted_data.rb
 - lib/familia/encryption/manager.rb
@@ -270,11 +271,11 @@ files:
 - lib/familia/horreum/serialization.rb
 - lib/familia/horreum/settings.rb
 - lib/familia/horreum/utils.rb
+- lib/familia/identifier_extractor.rb
 - lib/familia/json_serializer.rb
 - lib/familia/logging.rb
 - lib/familia/refinements.rb
 - lib/familia/refinements/dear_json.rb
-- lib/familia/refinements/logger_trace.rb
 - lib/familia/refinements/stylize_words.rb
 - lib/familia/refinements/time_literals.rb
 - lib/familia/secure_identifier.rb
@@ -282,90 +283,18 @@ files:
 - lib/familia/utils.rb
 - lib/familia/verifiable_identifier.rb
 - lib/familia/version.rb
-- lib/middleware/database_middleware.rb
+- lib/middleware/database_logger.rb
 - lib/multi_result.rb
-- try/configuration/scenarios_try.rb
-- try/connection/fiber_context_preservation_try.rb
-- try/connection/handler_constraints_try.rb
-- try/connection/operation_mode_guards_try.rb
-- try/connection/pipeline_fallback_integration_try.rb
-- try/connection/responsibility_chain_tracking_try.rb
-- try/connection/transaction_fallback_integration_try.rb
-- try/connection/transaction_mode_permissive_try.rb
-- try/connection/transaction_mode_strict_try.rb
-- try/connection/transaction_mode_warn_try.rb
-- try/connection/transaction_modes_try.rb
-- try/core/autoloader_try.rb
-- try/core/base_enhancements_try.rb
-- try/core/connection_try.rb
-- try/core/conventional_inheritance_try.rb
-- try/core/create_method_try.rb
-- try/core/database_consistency_try.rb
-- try/core/errors_try.rb
-- try/core/extensions_try.rb
-- try/core/familia_extended_try.rb
-- try/core/familia_members_methods_try.rb
-- try/core/familia_try.rb
-- try/core/isolated_dbclient_try.rb
-- try/core/middleware_try.rb
-- try/core/persistence_operations_try.rb
-- try/core/pools_try.rb
-- try/core/secure_identifier_try.rb
-- try/core/settings_try.rb
-- try/core/time_utils_try.rb
-- try/core/tools_try.rb
-- try/core/utils_try.rb
-- try/core/verifiable_identifier_try.rb
-- try/data_types/boolean_try.rb
-- try/data_types/counter_try.rb
-- try/data_types/datatype_base_try.rb
-- try/data_types/hash_try.rb
-- try/data_types/list_try.rb
-- try/data_types/lock_try.rb
-- try/data_types/sorted_set_try.rb
-- try/data_types/sorted_set_zadd_options_try.rb
-- try/data_types/string_try.rb
-- try/data_types/unsortedset_try.rb
-- try/debugging/README.md
-- try/debugging/cache_behavior_tracer.rb
-- try/debugging/debug_aad_process.rb
-- try/debugging/debug_concealed_internal.rb
-- try/debugging/debug_concealed_reveal.rb
-- try/debugging/debug_context_aad.rb
-- try/debugging/debug_context_simple.rb
-- try/debugging/debug_cross_context.rb
-- try/debugging/debug_database_load.rb
-- try/debugging/debug_encrypted_json_check.rb
-- try/debugging/debug_encrypted_json_step_by_step.rb
-- try/debugging/debug_exists_lifecycle.rb
-- try/debugging/debug_field_decrypt.rb
-- try/debugging/debug_fresh_cross_context.rb
-- try/debugging/debug_load_path.rb
-- try/debugging/debug_method_definition.rb
-- try/debugging/debug_method_resolution.rb
-- try/debugging/debug_minimal.rb
-- try/debugging/debug_provider.rb
-- try/debugging/debug_secure_behavior.rb
-- try/debugging/debug_string_class.rb
-- try/debugging/debug_test.rb
-- try/debugging/debug_test_design.rb
-- try/debugging/encryption_method_tracer.rb
-- try/debugging/provider_diagnostics.rb
+- pr_agent.toml
+- pr_compliance_checklist.yaml
 - try/edge_cases/empty_identifiers_try.rb
 - try/edge_cases/hash_symbolization_try.rb
 - try/edge_cases/json_serialization_try.rb
+- try/edge_cases/legacy_data_detection/deserialization_edge_cases_try.rb
 - try/edge_cases/race_conditions_try.rb
 - try/edge_cases/reserved_keywords_try.rb
 - try/edge_cases/string_coercion_try.rb
 - try/edge_cases/ttl_side_effects_try.rb
-- try/encryption/config_persistence_try.rb
-- try/encryption/encryption_core_try.rb
-- try/encryption/instance_variable_scope_try.rb
-- try/encryption/module_loading_try.rb
-- try/encryption/providers/aes_gcm_provider_try.rb
-- try/encryption/providers/xchacha20_poly1305_provider_try.rb
-- try/encryption/roundtrip_validation_try.rb
-- try/encryption/secure_memory_handling_try.rb
 - try/features/encrypted_fields/aad_protection_try.rb
 - try/features/encrypted_fields/concealed_string_core_try.rb
 - try/features/encrypted_fields/context_isolation_try.rb
@@ -383,6 +312,14 @@ files:
 - try/features/encrypted_fields/secure_by_default_behavior_try.rb
 - try/features/encrypted_fields/thread_safety_try.rb
 - try/features/encrypted_fields/universal_serialization_safety_try.rb
+- try/features/encryption/config_persistence_try.rb
+- try/features/encryption/core_try.rb
+- try/features/encryption/instance_variable_scope_try.rb
+- try/features/encryption/module_loading_try.rb
+- try/features/encryption/providers/aes_gcm_provider_try.rb
+- try/features/encryption/providers/xchacha20_poly1305_provider_try.rb
+- try/features/encryption/roundtrip_validation_try.rb
+- try/features/encryption/secure_memory_handling_try.rb
 - try/features/expiration/expiration_try.rb
 - try/features/external_identifier/external_identifier_try.rb
 - try/features/feature_dependencies_try.rb
@@ -413,53 +350,125 @@ files:
 - try/features/transient_fields/single_use_redacted_string_try.rb
 - try/features/transient_fields/transient_fields_core_try.rb
 - try/features/transient_fields/transient_fields_integration_try.rb
-- try/helpers/test_cleanup.rb
-- try/helpers/test_helpers.rb
-- try/horreum/auto_indexing_on_save_try.rb
-- try/horreum/base_try.rb
-- try/horreum/class_methods_try.rb
-- try/horreum/commands_try.rb
-- try/horreum/defensive_initialization_try.rb
-- try/horreum/destroy_related_fields_cleanup_try.rb
-- try/horreum/enhanced_conflict_handling_try.rb
-- try/horreum/field_categories_try.rb
-- try/horreum/field_definition_try.rb
-- try/horreum/initialization_try.rb
-- try/horreum/relations_try.rb
-- try/horreum/serialization_persistent_fields_try.rb
-- try/horreum/serialization_try.rb
-- try/horreum/settings_try.rb
+- try/integration/connection/fiber_context_preservation_try.rb
+- try/integration/connection/handler_constraints_try.rb
+- try/integration/connection/isolated_dbclient_try.rb
+- try/integration/connection/middleware_reconnect_try.rb
+- try/integration/connection/operation_mode_guards_try.rb
+- try/integration/connection/pipeline_fallback_integration_try.rb
+- try/integration/connection/pools_try.rb
+- try/integration/connection/responsibility_chain_tracking_try.rb
+- try/integration/connection/transaction_fallback_integration_try.rb
+- try/integration/connection/transaction_mode_permissive_try.rb
+- try/integration/connection/transaction_mode_strict_try.rb
+- try/integration/connection/transaction_mode_warn_try.rb
+- try/integration/connection/transaction_modes_try.rb
+- try/integration/conventional_inheritance_try.rb
+- try/integration/create_method_try.rb
 - try/integration/cross_component_try.rb
-- try/memory/memory_basic_test.rb
-- try/memory/memory_detailed_test.rb
-- try/memory/memory_docker_ruby_dump.sh
-- try/memory/memory_search_for_string.rb
-- try/memory/test_actual_redactedstring_protection.rb
-- try/models/customer_safe_dump_try.rb
-- try/models/customer_try.rb
-- try/models/datatype_base_try.rb
-- try/models/familia_object_try.rb
+- try/integration/database_consistency_try.rb
+- try/integration/familia_extended_try.rb
+- try/integration/familia_members_methods_try.rb
+- try/integration/models/customer_safe_dump_try.rb
+- try/integration/models/customer_try.rb
+- try/integration/models/datatype_base_try.rb
+- try/integration/models/familia_object_try.rb
+- try/integration/persistence_operations_try.rb
+- try/integration/relationships_persistence_round_trip_try.rb
+- try/integration/scenarios_try.rb
+- try/integration/secure_identifier_try.rb
+- try/integration/verifiable_identifier_try.rb
 - try/performance/benchmarks_try.rb
-- try/prototypes/atomic_saves_v1_context_proxy.rb
-- try/prototypes/atomic_saves_v2_connection_switching.rb
-- try/prototypes/atomic_saves_v3_connection_pool.rb
-- try/prototypes/atomic_saves_v4.rb
-- try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
-- try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
-- try/prototypes/pooling/README.md
-- try/prototypes/pooling/configurable_stress_test.rb
-- try/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
-- try/prototypes/pooling/lib/connection_pool_metrics.rb
-- try/prototypes/pooling/lib/connection_pool_stress_test.rb
-- try/prototypes/pooling/lib/connection_pool_threading_models.rb
-- try/prototypes/pooling/lib/visualize_stress_results.rb
-- try/prototypes/pooling/pool_siege.rb
-- try/prototypes/pooling/run_stress_tests.rb
-- try/refinements/dear_json_array_methods_try.rb
-- try/refinements/dear_json_hash_methods_try.rb
-- try/refinements/logger_trace_methods_try.rb
-- try/refinements/time_literals_numeric_methods_try.rb
-- try/refinements/time_literals_string_methods_try.rb
+- try/support/benchmarks/deserialization_benchmark.rb
+- try/support/benchmarks/deserialization_correctness_test.rb
+- try/support/debugging/README.md
+- try/support/debugging/cache_behavior_tracer.rb
+- try/support/debugging/debug_aad_process.rb
+- try/support/debugging/debug_concealed_internal.rb
+- try/support/debugging/debug_concealed_reveal.rb
+- try/support/debugging/debug_context_aad.rb
+- try/support/debugging/debug_context_simple.rb
+- try/support/debugging/debug_cross_context.rb
+- try/support/debugging/debug_database_load.rb
+- try/support/debugging/debug_encrypted_json_check.rb
+- try/support/debugging/debug_encrypted_json_step_by_step.rb
+- try/support/debugging/debug_exists_lifecycle.rb
+- try/support/debugging/debug_field_decrypt.rb
+- try/support/debugging/debug_fresh_cross_context.rb
+- try/support/debugging/debug_load_path.rb
+- try/support/debugging/debug_method_definition.rb
+- try/support/debugging/debug_method_resolution.rb
+- try/support/debugging/debug_minimal.rb
+- try/support/debugging/debug_provider.rb
+- try/support/debugging/debug_secure_behavior.rb
+- try/support/debugging/debug_string_class.rb
+- try/support/debugging/debug_test.rb
+- try/support/debugging/debug_test_design.rb
+- try/support/debugging/encryption_method_tracer.rb
+- try/support/debugging/provider_diagnostics.rb
+- try/support/helpers/test_cleanup.rb
+- try/support/helpers/test_helpers.rb
+- try/support/memory/memory_basic_test.rb
+- try/support/memory/memory_detailed_test.rb
+- try/support/memory/memory_docker_ruby_dump.sh
+- try/support/memory/memory_search_for_string.rb
+- try/support/memory/test_actual_redactedstring_protection.rb
+- try/support/prototypes/atomic_saves_v1_context_proxy.rb
+- try/support/prototypes/atomic_saves_v2_connection_switching.rb
+- try/support/prototypes/atomic_saves_v3_connection_pool.rb
+- try/support/prototypes/atomic_saves_v4.rb
+- try/support/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb
+- try/support/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb
+- try/support/prototypes/pooling/README.md
+- try/support/prototypes/pooling/configurable_stress_test.rb
+- try/support/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb
+- try/support/prototypes/pooling/lib/connection_pool_metrics.rb
+- try/support/prototypes/pooling/lib/connection_pool_stress_test.rb
+- try/support/prototypes/pooling/lib/connection_pool_threading_models.rb
+- try/support/prototypes/pooling/lib/visualize_stress_results.rb
+- try/support/prototypes/pooling/pool_siege.rb
+- try/support/prototypes/pooling/run_stress_tests.rb
+- try/unit/core/autoloader_try.rb
+- try/unit/core/base_enhancements_try.rb
+- try/unit/core/connection_try.rb
+- try/unit/core/errors_try.rb
+- try/unit/core/extensions_try.rb
+- try/unit/core/familia_logger_try.rb
+- try/unit/core/familia_try.rb
+- try/unit/core/middleware_try.rb
+- try/unit/core/settings_try.rb
+- try/unit/core/time_utils_try.rb
+- try/unit/core/tools_try.rb
+- try/unit/core/utils_try.rb
+- try/unit/data_types/boolean_try.rb
+- try/unit/data_types/counter_try.rb
+- try/unit/data_types/datatype_base_try.rb
+- try/unit/data_types/hash_try.rb
+- try/unit/data_types/list_try.rb
+- try/unit/data_types/lock_try.rb
+- try/unit/data_types/sorted_set_try.rb
+- try/unit/data_types/sorted_set_zadd_options_try.rb
+- try/unit/data_types/string_try.rb
+- try/unit/data_types/unsortedset_try.rb
+- try/unit/horreum/auto_indexing_on_save_try.rb
+- try/unit/horreum/base_try.rb
+- try/unit/horreum/class_methods_try.rb
+- try/unit/horreum/commands_try.rb
+- try/unit/horreum/defensive_initialization_try.rb
+- try/unit/horreum/destroy_related_fields_cleanup_try.rb
+- try/unit/horreum/enhanced_conflict_handling_try.rb
+- try/unit/horreum/field_categories_try.rb
+- try/unit/horreum/field_definition_try.rb
+- try/unit/horreum/initialization_try.rb
+- try/unit/horreum/json_type_preservation_try.rb
+- try/unit/horreum/relations_try.rb
+- try/unit/horreum/serialization_persistent_fields_try.rb
+- try/unit/horreum/serialization_try.rb
+- try/unit/horreum/settings_try.rb
+- try/unit/refinements/dear_json_array_methods_try.rb
+- try/unit/refinements/dear_json_hash_methods_try.rb
+- try/unit/refinements/time_literals_numeric_methods_try.rb
+- try/unit/refinements/time_literals_string_methods_try.rb
 - try/valkey.conf
 homepage: https://github.com/delano/familia
 licenses:

data/lib/familia/distinguisher.rb

@@ -1,85 +0,0 @@
-# lib/familia/distinguisher.rb
-
-module Familia
-  module Distinguisher
-    # This method determines the appropriate transformation to apply based on
-    # the class of the input argument.
-    #
-    # @param [Object] value_to_distinguish The value to be processed. Keep in
-    #   mind that all data is stored as a string so whatever the type
-    #   of the value, it will be converted to a string.
-    # @param [Boolean] strict_values Whether to enforce strict value handling.
-    #   Defaults to true.
-    # @return [String, nil] The processed value as a string or nil for unsupported
-    #   classes.
-    #
-    # The method uses a case statement to handle different classes:
-    # - For `Symbol`, `String`, `Integer`, and `Float` classes, it traces the
-    #   operation and converts the value to a string.
-    # - For `Familia::Horreum` class, it traces the operation and returns the
-    #   identifier of the value.
-    # - For `TrueClass`, `FalseClass`, and `NilClass`, it traces the operation and
-    #   converts the value to a string ("true", "false", or "").
-    # - For any other class, it traces the operation and returns nil.
-    #
-    # Alternative names for `value_to_distinguish` could be `input_value`, `value`,
-    # or `object`.
-    #
-    def distinguisher(value_to_distinguish, strict_values: true)
-      case value_to_distinguish
-      when ::Symbol, ::String, ::Integer, ::Float
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'string' if Familia.debug?
-
-        # Symbols and numerics are naturally serializable to strings
-        # so it's a relatively low risk operation.
-        value_to_distinguish.to_s
-
-      when ::TrueClass, ::FalseClass, ::NilClass
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'true/false/nil' if Familia.debug?
-
-        # TrueClass, FalseClass, and NilClass are considered high risk because their
-        # original types cannot be reliably determined from their serialized string
-        # representations. This can lead to unexpected behavior during deserialization.
-        # For instance, a TrueClass value serialized as "true" might be deserialized as
-        # a String, causing application errors. Even more problematic, a NilClass value
-        # serialized as an empty string makes it impossible to distinguish between a
-        # nil value and an empty string upon deserialization. Such scenarios can result
-        # in subtle, hard-to-diagnose bugs. To mitigate these risks, we raise an
-        # exception when encountering these types unless the strict_values option is
-        # explicitly set to false.
-        #
-        raise Familia::NotDistinguishableError, value_to_distinguish if strict_values
-
-        value_to_distinguish.to_s #=> "true", "false", ""
-
-      when Familia::Base, Class
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, 'base' if Familia.debug?
-
-        # When called with a class we simply transform it to its name. For
-        # instances of Familia class, we store the identifier.
-        if value_to_distinguish.is_a?(Class)
-          value_to_distinguish.name
-        else
-          value_to_distinguish.identifier
-        end
-
-      else
-        Familia.trace :TOREDIS_DISTINGUISHER, nil, "else1 #{strict_values}" if Familia.debug?
-
-        if value_to_distinguish.class.ancestors.member?(Familia::Base)
-          Familia.trace :TOREDIS_DISTINGUISHER, nil, 'isabase' if Familia.debug?
-
-          value_to_distinguish.identifier
-
-        else
-          Familia.trace :TOREDIS_DISTINGUISHER, nil, "else2 #{strict_values}" if Familia.debug?
-          raise Familia::NotDistinguishableError, value_to_distinguish if strict_values
-
-          nil
-        end
-      end
-    end
-  end
-
-  extend Distinguisher
-end

data/lib/familia/refinements/logger_trace.rb

@@ -1,60 +0,0 @@
-# lib/familia/refinements/logger_trace.rb
-
-require 'pathname'
-require 'logger'
-
-# Controls whether tracing is enabled via an environment variable
-FAMILIA_TRACE = ENV.fetch('FAMILIA_TRACE', 'false').downcase
-
-# Familia::Refinements::LoggerTrace
-#
-# This module adds a 'trace' log level to the Ruby Logger class.
-# It is enabled when the FAMILIA_TRACE environment variable is set to
-# '1', 'true', or 'yes' (case-insensitive).
-#
-# @example Enabling trace logging
-#   # UnsortedSet environment variable
-#   ENV['FAMILIA_TRACE'] = 'true'
-#
-#   # In your Ruby code
-#   require 'logger'
-#   using Familia::Refinements::LoggerTrace
-#
-#   logger = Logger.new(STDOUT)
-#   logger.trace("This is a trace message")
-#
-module Familia
-  module Refinements
-    # Familia::Refinements::LoggerTrace
-    module LoggerTraceMethods
-      ##
-      # Logs a message at the TRACE level.
-      #
-      # @param progname [String] The program name to include in the log message
-      # @yield A block that evaluates to the message to log
-      # @return [true] Always returns true
-      #
-      # @example Logging a trace message
-      #   logger.trace("MyApp") { "Detailed trace information" }
-      def trace(progname = nil, &)
-        Fiber[:severity_letter] = 'T'
-        add(Familia::Refinements::LoggerTrace::TRACE, nil, progname, &)
-      ensure
-        Fiber[:severity_letter] = nil
-      end
-    end
-
-    module LoggerTrace
-      unless defined?(ENABLED)
-        # Indicates whether trace logging is enabled
-        ENABLED = %w[1 true yes].include?(FAMILIA_TRACE).freeze
-        # The numeric level for trace logging (same as DEBUG)
-        TRACE = 0
-      end
-
-      refine Logger do
-        import_methods LoggerTraceMethods
-      end
-    end
-  end
-end