familia 2.0.0.pre15 → 2.0.0.pre17

data/try/models/datatype_base_try.rb

@@ -35,8 +35,8 @@ stripe_customer.class.name
 #=> "Familia::HashKey"
 
 ## DataType instances know their owner
-@sample_obj.timeline.parent == @sample_obj
-#=> true
+@sample_obj.timeline.parent.class
+#=> Familia::Horreum::ParentDefinition
 
 ## DataType instances know their field name
 @sample_obj.timeline.keystring
@@ -54,7 +54,7 @@ stripe_customer.class.name
 #==> _.respond_to?(:exists?)
 #=/=> _.respond_to?(:destroy!)
 
-## Can check if DataType exists in Redis
+## Can check if DataType exists in Valkey/Redis
 timeline = @sample_obj.timeline
 exists_before = timeline.exists?
 [exists_before.class, [true, false].include?(exists_before)]

data/try/models/familia_object_try.rb

@@ -44,7 +44,8 @@ obj = Customer.find_by_id :delano
 
 ## Customer.destroy
 @cust.destroy!
-#=> true
+#=:> MultiResult
+#==> result.successful?
 
 ## Customer.instances
 Customer.values.size
@@ -56,20 +57,20 @@ obj.save
 #=> true
 
 ## Familia.class_list
-Customer.customers.class
-#=> Familia::List
+Customer.all_customers.class
+#=> Familia::ListKey
 
 ## Familia class dbkey
-Customer.customers.dbkey
-#=> 'customer:customers'
+Customer.all_customers.dbkey
+#=> 'customer:all_customers'
 
 ## Familia.class_list
-Customer.customers << :delano << :tucker << :morton
-Customer.customers.size
+Customer.all_customers << :delano << :tucker << :morton
+Customer.all_customers.size
 #=> 3
 
 ## Familia class clear
-Customer.customers.delete!
+Customer.all_customers.delete!
 #=> true
 
 ## Familia class replace 1 of 4

data/try/performance/benchmarks_try.rb

@@ -10,7 +10,7 @@ user_class = Class.new(Familia::Horreum) do
   field :data
 end
 
-large_data = { items: (1..1000).to_a, metadata: "x" * 1000 }
+large_data = { metadata: "x" * 1000, items: (1..1000).to_a }
 
 json_time = Benchmark.realtime do
   100.times { JSON.dump(large_data) }
@@ -44,7 +44,7 @@ users.each(&:delete!)
 individual_time > 0
 #=!> StandardError
 
-## Redis type access performance
+## Valkey/Redis type access performance
 user_class = Class.new(Familia::Horreum) do
   identifier_field :email
   field :name

data/try/prototypes/atomic_saves_v1_context_proxy.rb

@@ -1,6 +1,6 @@
-# try/prototypes/atomic_saves_v1_context_proxy.rb
+# try/prototypes/atomic_saves_v1_target_proxy.rb
 
-# try -vf try/prototypes/atomic_saves_v1_context_proxy.rb
+# try -vf try/prototypes/atomic_saves_v1_target_proxy.rb
 
 # ⏺ 🎉 Perfect! All Tests Pass!
 #

data/try/prototypes/atomic_saves_v3_connection_pool.rb

@@ -6,10 +6,10 @@
 # The issue is that refresh! is being called within the transaction, but
 #  Database MULTI transactions queue commands and don't return results until
 #  EXEC. So refresh! inside the transaction isn't going to see the current
-#  state from Redis.
+#  state from the database.
 #
 #  The problem is more fundamental: Database MULTI/EXEC transactions don't
-#  work the way this code expects them to. In Redis:
+#  work the way this code expects them to. In Valkey/Redis:
 #
 #  1. MULTI starts queuing commands
 #  2. All subsequent commands are queued, not executed
@@ -20,7 +20,7 @@
 #     work as expected
 #  2. Read the current balance and modify it - this won't work inside MULTI
 #
-#  The atomic operations need to be restructured to work with Redis's
+#  The atomic operations need to be restructured to work with Valkey/Redis's
 #  actual transaction model. Let me fix this:
 
 require 'bundler/setup'

data/try/prototypes/atomic_saves_v4.rb

@@ -99,7 +99,7 @@ class BankAccount < Familia::Horreum
     end
 
     def add(accnt)
-      relatable_objids.add Time.now.to_f, accnt.identifier
+      relatable_objids.add Familia.now, accnt.identifier
     end
   end
 end

data/try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb

@@ -12,7 +12,7 @@
 #    connection or MULTI connection based on Thread-local context
 # 2. **Thread Safety**: Uses Thread-local storage for transaction state
 # 3. **No method_missing**: Clean implementation via method overriding
-# 4. **Database MULTI/EXEC**: Leverages Redis's native transaction support
+# 4. **Database MULTI/EXEC**: Leverages Valkey/Redis's native transaction support
 #
 # Design Decision: TransactionalMethods Module REMOVED
 #
@@ -70,7 +70,7 @@ class TransactionRecord < Familia::Horreum
     @to_account = to
     @amount = amount.to_f
     @status = "pending"
-    @created_at = Time.now.to_i
+    @created_at = Familia.now.to_i
   end
 end
 
@@ -78,11 +78,11 @@ end
 module Familia
   class << self
     def current_transaction
-      Thread.current[:familia_current_transaction]
+      Fiber[:familia_current_transaction]
     end
 
     def current_transaction=(transaction)
-      Thread.current[:familia_current_transaction] = transaction
+      Fiber[:familia_current_transaction] = transaction
     end
 
     def atomic(&block)

data/try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb

@@ -83,7 +83,7 @@ class TransactionRecord < Familia::Horreum
     @to_account = to
     @amount = amount.to_f
     @status = "pending"
-    @created_at = Time.now.to_i
+    @created_at = Familia.now.to_i
   end
 
   def amount
@@ -121,11 +121,11 @@ module Familia
     end
 
     def current_transaction
-      Thread.current[:familia_current_transaction_v3]
+      Fiber[:familia_current_transaction_v3]
     end
 
     def current_transaction=(transaction)
-      Thread.current[:familia_current_transaction_v3] = transaction
+      Fiber[:familia_current_transaction_v3] = transaction
     end
 
     # Proxy approach - transparent like V2
@@ -135,7 +135,7 @@ module Familia
         atomic_separate(&block)
       else
         # Use connection pool to get connection
-        # For this prototype, we'll use a simple approach that works with Redis
+        # For this prototype, we'll use a simple approach that works with Valkey/Redis
         connection_pool.with do |conn|
           begin
             # Store the connection for use within the block

data/try/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb

@@ -83,7 +83,7 @@ class TransactionRecord < Familia::Horreum
     @to_account = to
     @amount = amount.to_f
     @status = "pending"
-    @created_at = Time.now.to_i
+    @created_at = Familia.now.to_i
   end
 
   def amount
@@ -121,11 +121,11 @@ module Familia
     end
 
     def current_transaction
-      Thread.current[:familia_current_transaction_v3]
+      Fiber[:familia_current_transaction_v3]
     end
 
     def current_transaction=(transaction)
-      Thread.current[:familia_current_transaction_v3] = transaction
+      Fiber[:familia_current_transaction_v3] = transaction
     end
 
     # Proxy approach - transparent like V2
@@ -135,7 +135,7 @@ module Familia
         atomic_separate(&block)
       else
         # Use connection pool to get connection
-        # For this prototype, we'll use a simple approach that works with Redis
+        # For this prototype, we'll use a simple approach that works with Valkey/Redis
         connection_pool.with do |conn|
           begin
             # Store the connection for use within the block

data/try/prototypes/pooling/lib/connection_pool_metrics.rb

@@ -26,7 +26,7 @@ module ConnectionPoolMetrics
           thread_id: thread_id,
           wait_time: wait_time,
           acquired: acquired,
-          timestamp: Time.now.to_f
+          timestamp: Familia.now
         }
       end
     end
@@ -37,7 +37,7 @@ module ConnectionPoolMetrics
           thread_id: thread_id,
           state: state, # :waiting, :running, :completed, :failed
           context: context,
-          timestamp: Time.now.to_f
+          timestamp: Familia.now
         }
       end
     end
@@ -47,7 +47,7 @@ module ConnectionPoolMetrics
         @metrics[:pool_exhaustion_events] << {
           wait_time: wait_time,
           threads_waiting: thread_count_waiting,
-          timestamp: Time.now.to_f
+          timestamp: Familia.now
         }
       end
     end
@@ -99,7 +99,7 @@ module ConnectionPoolMetrics
     end
 
     def export_detailed_csv(filename_prefix = "stress_test")
-      timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
+      timestamp = Familia.now.strftime("%Y%m%d_%H%M%S")
 
       # Export operations
       CSV.open("#{filename_prefix}_operations_#{timestamp}.csv", "w") do |csv|
@@ -274,7 +274,7 @@ module ConnectionPoolMetrics
 
     def add_result(config, metrics_summary, model_info = {})
       @results << {
-        timestamp: Time.now,
+        timestamp: Familia.now,
         config: config,
         summary: metrics_summary,
         model: model_info

data/try/prototypes/pooling/lib/connection_pool_stress_test.rb

@@ -260,7 +260,7 @@ class MetricsCollector
       duration: duration,
       success: success,
       wait_time: wait_time,
-      timestamp: Time.now.to_f
+      timestamp: Familia.now
     }
 
     if @use_concurrent
@@ -277,7 +277,7 @@ class MetricsCollector
       error: error.class.name,
       message: error.message,
       context: context,
-      timestamp: Time.now.to_f
+      timestamp: Familia.now
     }
 
     if @use_concurrent
@@ -301,7 +301,7 @@ class MetricsCollector
       utilization: utilization,
       utilization_alt: utilization_alt,
       in_use: in_use,
-      timestamp: Time.now.to_f
+      timestamp: Familia.now
     }
 
     if @use_concurrent
@@ -582,17 +582,17 @@ class ConnectionPoolStressTest
           @config[:operations_per_thread].times do |op_index|
             account = get_account_for_operation(i, op_index)
             begin
-              start = Time.now
-              wait_start = Time.now
+              start = Familia.now
+              wait_start = Familia.now
 
               Familia.atomic do
-                wait_time = Time.now - wait_start
+                wait_time = Familia.now - wait_start
                 account.complex_operation
-                @metrics.record_operation(:transaction, Time.now - start, true, wait_time)
+                @metrics.record_operation(:transaction, Familia.now - start, true, wait_time)
               end
             rescue => e
               @metrics.record_error(e, { thread: i })
-              @metrics.record_operation(:transaction, Time.now - start, false)
+              @metrics.record_operation(:transaction, Familia.now - start, false)
             end
           end
         rescue => e
@@ -629,12 +629,12 @@ class ConnectionPoolStressTest
     puts "Running rapid fire test with #{@config[:thread_count]} threads"
 
     if @config[:duration]
-      end_time = Time.now + @config[:duration]
+      end_time = Familia.now + @config[:duration]
 
       @config[:thread_count].times do |i|
         threads << Thread.new do
           op_index = 0
-          while Time.now < end_time
+          while Familia.now < end_time
             account = get_account_for_operation(i, op_index)
             operation = select_operation
             execute_operation(account, operation)
@@ -691,7 +691,7 @@ class ConnectionPoolStressTest
 
         @config[:operations_per_thread].times do
           begin
-            start = Time.now
+            start = Familia.now
 
             Familia.atomic do
               # Simulate long-running transaction
@@ -706,10 +706,10 @@ class ConnectionPoolStressTest
               account2.save
             end
 
-            @metrics.record_operation(:long_transaction, Time.now - start, true)
+            @metrics.record_operation(:long_transaction, Familia.now - start, true)
           rescue => e
             @metrics.record_error(e, { thread: i })
-            @metrics.record_operation(:long_transaction, Time.now - start, false)
+            @metrics.record_operation(:long_transaction, Familia.now - start, false)
           end
         end
       end
@@ -731,7 +731,7 @@ class ConnectionPoolStressTest
 
         @config[:operations_per_thread].times do
           begin
-            start = Time.now
+            start = Familia.now
 
             Familia.atomic do
               account.deposit(50)
@@ -747,10 +747,10 @@ class ConnectionPoolStressTest
               account.save
             end
 
-            @metrics.record_operation(:nested_transaction, Time.now - start, true)
+            @metrics.record_operation(:nested_transaction, Familia.now - start, true)
           rescue => e
             @metrics.record_error(e, { thread: i })
-            @metrics.record_operation(:nested_transaction, Time.now - start, false)
+            @metrics.record_operation(:nested_transaction, Familia.now - start, false)
           end
         end
       end
@@ -773,7 +773,7 @@ class ConnectionPoolStressTest
 
         @config[:operations_per_thread].times do |op_num|
           begin
-            start = Time.now
+            start = Familia.now
 
             if rand < error_rate
               # Inject an error
@@ -784,10 +784,10 @@ class ConnectionPoolStressTest
               account.complex_operation
             end
 
-            @metrics.record_operation(:with_errors, Time.now - start, true)
+            @metrics.record_operation(:with_errors, Familia.now - start, true)
           rescue => e
             @metrics.record_error(e, { thread: i, operation: op_num })
-            @metrics.record_operation(:with_errors, Time.now - start, false)
+            @metrics.record_operation(:with_errors, Familia.now - start, false)
           end
         end
       end
@@ -811,12 +811,12 @@ class ConnectionPoolStressTest
 
   def run_duration_based_test(mix)
     threads = []
-    end_time = Time.now + @config[:duration]
+    end_time = Familia.now + @config[:duration]
 
     @config[:thread_count].times do |i|
       threads << Thread.new do
         op_index = 0
-        while Time.now < end_time
+        while Familia.now < end_time
           account = get_account_for_operation(i, op_index)
           operation = select_operation_from_mix(mix)
           execute_operation(account, operation)
@@ -898,18 +898,18 @@ class ConnectionPoolStressTest
 
   def execute_operation(account, operation)
     begin
-      start = Time.now
+      start = Familia.now
 
       case operation
       when :read
         account.refresh!
         _ = account.balance
-        @metrics.record_operation(:read, Time.now - start, true)
+        @metrics.record_operation(:read, Familia.now - start, true)
       when :write
         current = account.balance || 0
         account.balance = current + rand(-10..10)
         account.save
-        @metrics.record_operation(:write, Time.now - start, true)
+        @metrics.record_operation(:write, Familia.now - start, true)
       when :transaction
         Familia.atomic do
           account.refresh!
@@ -917,12 +917,12 @@ class ConnectionPoolStressTest
           account.balance = current + rand(-10..10)
           account.save
         end
-        @metrics.record_operation(:transaction, Time.now - start, true)
+        @metrics.record_operation(:transaction, Familia.now - start, true)
       end
     rescue => e
       puts "Operation error: #{e.message} (#{e.class})" if ENV['FAMILIA_DEBUG']
       @metrics.record_error(e, { operation: operation })
-      @metrics.record_operation(operation, Time.now - start, false)
+      @metrics.record_operation(operation, Familia.now - start, false)
     end
   end
 

data/try/prototypes/pooling/lib/connection_pool_threading_models.rb

@@ -227,24 +227,24 @@ module ThreadingModels
       end
 
       def perform_operation(operation, account)
-        start = Time.now
+        start = Familia.now
 
         case operation[:type]
         when :read
           account.refresh!
-          { success: true, duration: Time.now - start }
+          { success: true, duration: Familia.now - start }
         when :write
           account.balance += operation[:amount] || 0
           account.save
-          { success: true, duration: Time.now - start }
+          { success: true, duration: Familia.now - start }
         when :transaction
           Familia.atomic do
             account.complex_operation
           end
-          { success: true, duration: Time.now - start }
+          { success: true, duration: Familia.now - start }
         end
       rescue => e
-        { success: false, error: e, duration: Time.now - start }
+        { success: false, error: e, duration: Familia.now - start }
       end
     end
 
@@ -334,7 +334,7 @@ class EnhancedConnectionPoolStressTest < ConnectionPoolStressTest
 
     puts "\n=== Running with #{model_name} model ==="
 
-    start_time = Time.now
+    start_time = Familia.now
 
     result = model.run do |account, thread_id, op_num|
       operation = select_operation_from_mix(
@@ -343,7 +343,7 @@ class EnhancedConnectionPoolStressTest < ConnectionPoolStressTest
       execute_operation(account, operation)
     end
 
-    duration = Time.now - start_time
+    duration = Familia.now - start_time
 
     result.merge(
       total_duration: duration,

data/try/prototypes/pooling/lib/visualize_stress_results.rb

@@ -46,7 +46,7 @@ class StressTestVisualizer
   def generate_report
     report = []
     report << "# Connection Pool Stress Test Results"
-    report << "\nGenerated: #{Time.now}"
+    report << "\nGenerated: #{Familia.now}"
     report << "\n"
 
     # Summary section

data/try/prototypes/pooling/pool_siege.rb

@@ -26,7 +26,7 @@ class PoolSiege
     if @options[:profile]
       run_with_profiling
     else
-      start_time = Time.now
+      start_time = Familia.now
 
       if @options[:quiet]
         run_silent_test
@@ -34,7 +34,7 @@ class PoolSiege
         run_with_progress
       end
 
-      end_time = Time.now
+      end_time = Familia.now
       print_final_results(end_time - start_time)
     end
   end
@@ -157,7 +157,7 @@ class PoolSiege
       end
     end.parse!(args)
 
-    # Set defaults
+    # UnsortedSet defaults
     options[:threads] ||= 10
     options[:pool_size] ||= 5
     options[:operations] ||= 100 unless options[:duration]
@@ -310,16 +310,16 @@ class PoolSiege
     end
 
     # Run the test
-    start_time = Time.now
+    start_time = Familia.now
     run_silent_test
-    end_time = Time.now
+    end_time = Familia.now
     total_time = end_time - start_time
 
     # Restore original method
     Familia.define_singleton_method(:atomic, original_atomic)
 
     # Generate report
-    timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
+    timestamp = Familia.now.strftime("%Y%m%d_%H%M%S")
     scenario_name = @options[:scenario].to_s
     report_file = "pool_siege_#{scenario_name}_#{timestamp}_profile.txt"
 
@@ -439,8 +439,8 @@ class ProgressTracker
     @total_ops = total_ops
     @completed = 0
     @successful = 0
-    @start_time = Time.now
-    @last_update = Time.now
+    @start_time = Familia.now
+    @last_update = Familia.now
   end
 
   def update(success)
@@ -465,7 +465,7 @@ class ProgressTracker
   private
 
   def should_update?
-    now = Time.now
+    now = Familia.now
     return false if (now - @last_update) < 0.5 # Update at most every 500ms
     @last_update = now
     true
@@ -474,7 +474,7 @@ class ProgressTracker
   def show_ops_progress
     percent = (@completed.to_f / @total_ops * 100).round(1)
     success_rate = (@successful.to_f / @completed * 100).round(1) if @completed > 0
-    elapsed = Time.now - @start_time
+    elapsed = Familia.now - @start_time
     rate = (@completed / elapsed).round(1) if elapsed > 0
 
     bar_width = 20
@@ -489,7 +489,7 @@ class ProgressTracker
   end
 
   def show_time_progress
-    elapsed = Time.now - @start_time
+    elapsed = Familia.now - @start_time
     success_rate = (@successful.to_f / @completed * 100).round(1) if @completed > 0
     rate = (@completed / elapsed).round(1) if elapsed > 0
 

data/try/prototypes/pooling/run_stress_tests.rb

@@ -29,7 +29,7 @@ class StressTestRunner
   def initialize(options = {})
     @options = {
       config_set: :moderate,
-      output_dir: "stress_test_results_#{Time.now.strftime('%Y%m%d_%H%M%S')}",
+      output_dir: "stress_test_results_#{Familia.now.strftime('%Y%m%d_%H%M%S')}",
       threading_models: [:traditional, :thread_pool, :fiber],
       operation_mixes: [:balanced, :read_heavy, :write_heavy],
       generate_visualizations: true,
@@ -67,7 +67,7 @@ class StressTestRunner
     puts "Total tests to run: #{total_tests}"
     puts ""
 
-    start_time = Time.now
+    start_time = Familia.now
 
     @config_set[:scenarios].each do |scenario|
       puts "\n--- Testing Scenario: #{scenario} ---"
@@ -105,7 +105,7 @@ class StressTestRunner
       end
     end
 
-    duration = Time.now - start_time
+    duration = Familia.now - start_time
     puts "\n" + "=" * 80
     puts "ALL TESTS COMPLETED"
     puts "Total duration: #{format_duration(duration)}"
@@ -206,7 +206,7 @@ class StressTestRunner
   end
 
   def save_test_results(config, metrics, model_info)
-    timestamp = Time.now.strftime('%Y%m%d_%H%M%S_%L')
+    timestamp = Familia.now.strftime('%Y%m%d_%H%M%S_%L')
     test_id = "#{config[:threading_model]}_#{config[:scenario]}_#{timestamp}"
 
     # Export detailed CSV files
@@ -217,7 +217,7 @@ class StressTestRunner
 
     # Save test configuration and results
     test_data = {
-      timestamp: Time.now,
+      timestamp: Familia.now,
       config: config,
       model_info: model_info,
       summary: metrics.respond_to?(:detailed_summary) ? metrics.detailed_summary : metrics.summary
@@ -267,7 +267,7 @@ class StressTestRunner
     <<~README
     # Connection Pool Stress Test Results
 
-    Generated: #{Time.now}
+    Generated: #{Familia.now}
     Configuration: #{@options[:config_set]}
 
     ## Directory Structure
@@ -305,7 +305,7 @@ class StressTestRunner
     summary = <<~SUMMARY
     # Executive Summary - Connection Pool Stress Testing
 
-    **Generated**: #{Time.now}
+    **Generated**: #{Familia.now}
     **Test Configuration**: #{@options[:config_set]}
 
     ## Key Findings