paper_trail_diff 0.2.0 → 0.3.1

data/lib/paper_trail_diff.rb

@@ -5,30 +5,50 @@ require 'paper_trail'
 
 require_relative 'paper_trail_diff/version'
 require_relative 'paper_trail_diff/support'
+require_relative 'paper_trail_diff/instrumentation'
 require_relative 'paper_trail_diff/errors'
 require_relative 'paper_trail_diff/configuration'
 require_relative 'paper_trail_diff/endpoint'
 require_relative 'paper_trail_diff/association_traversal'
 require_relative 'paper_trail_diff/association_discovery'
 require_relative 'paper_trail_diff/diagnostics'
+require_relative 'paper_trail_diff/collection_identity_index'
+require_relative 'paper_trail_diff/collection_transition'
 require_relative 'paper_trail_diff/snapshot'
+require_relative 'paper_trail_diff/activity_snapshot_delta'
 require_relative 'paper_trail_diff/value_objects'
 require_relative 'paper_trail_diff/traversal_entry'
 require_relative 'paper_trail_diff/traversal_emitter'
 require_relative 'paper_trail_diff/snapshot_traversal'
 require_relative 'paper_trail_diff/association_diff_traversal'
 require_relative 'paper_trail_diff/traversal'
+require_relative 'paper_trail_diff/collection_comparator'
 require_relative 'paper_trail_diff/engine'
 require_relative 'paper_trail_diff/historical_association_reifier'
 require_relative 'paper_trail_diff/prepared_record_index'
 require_relative 'paper_trail_diff/prepared_history'
+require_relative 'paper_trail_diff/version_association_candidate_scope'
 require_relative 'paper_trail_diff/prepared_edge_loader'
 require_relative 'paper_trail_diff/prepared_history_loader'
 require_relative 'paper_trail_diff/prepared_association_reifier'
 require_relative 'paper_trail_diff/live_association_reader'
+require_relative 'paper_trail_diff/live_endpoint_batch_loader'
+require_relative 'paper_trail_diff/preloaded_endpoint_batch_loader'
+require_relative 'paper_trail_diff/live_endpoint_provider'
+require_relative 'paper_trail_diff/live_graph_collector'
+require_relative 'paper_trail_diff/comparison_batch'
 require_relative 'paper_trail_diff/snapshot_normalizer'
 require_relative 'paper_trail_diff/historical_snapshot_store'
 require_relative 'paper_trail_diff/timeline_snapshot_provider'
+require_relative 'paper_trail_diff/activity_event_record_resolver'
+require_relative 'paper_trail_diff/activity_event_route_finder'
+require_relative 'paper_trail_diff/activity_relationship'
+require_relative 'paper_trail_diff/activity_collection_route_change'
+require_relative 'paper_trail_diff/activity_collection_record_updater'
+require_relative 'paper_trail_diff/activity_collection_route_updater'
+require_relative 'paper_trail_diff/activity_event_record_normalizer'
+require_relative 'paper_trail_diff/activity_collection_event_applier'
+require_relative 'paper_trail_diff/activity_belongs_to_event_applier'
 require_relative 'paper_trail_diff/activity_event_snapshot_refresher'
 require_relative 'paper_trail_diff/activity_root_snapshot_refresher'
 require_relative 'paper_trail_diff/branch_snapshot_refresher'
@@ -36,11 +56,17 @@ require_relative 'paper_trail_diff/activity_boundary'
 require_relative 'paper_trail_diff/step'
 require_relative 'paper_trail_diff/analysis'
 require_relative 'paper_trail_diff/version_range'
+require_relative 'paper_trail_diff/time_range'
+require_relative 'paper_trail_diff/time_version_range'
+require_relative 'paper_trail_diff/timeline_range'
 require_relative 'paper_trail_diff/timeline_builder'
 require_relative 'paper_trail_diff/activity_range'
 require_relative 'paper_trail_diff/activity_event'
+require_relative 'paper_trail_diff/activity_child_candidate_loader'
 require_relative 'paper_trail_diff/activity_version_collector'
 require_relative 'paper_trail_diff/activity_snapshot_sequence'
+require_relative 'paper_trail_diff/activity_history'
+require_relative 'paper_trail_diff/time_activity_timeline_builder'
 require_relative 'paper_trail_diff/activity_timeline_builder'
 require_relative 'paper_trail_diff/paper_trail_adapter'
 
@@ -53,6 +79,8 @@ require_relative 'paper_trail_diff/paper_trail_adapter'
 #     type association_diffs = Hash[String, association_diff]
 #     type association_snapshots = Hash[String, AssociationSnapshot]
 #     type identity = Array[untyped]
+#     type comparison_input = Hash[String | Symbol, untyped]
+#     type comparison_results = Hash[identity, Diff]
 #     type ignore_option = Array[String | Symbol] | Hash[String | Symbol, untyped]
 #     type reference_key = :type | :id | "type" | "id"
 #     type traversal_context = :change | :included_state
@@ -73,40 +101,82 @@ module PaperTrailDiff
 
   class << self
     # Compares net state between explicit PaperTrail-version or current-record endpoints.
-    #: (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Diff
-    def compare(from_version, to_version, associations: [], ignore: DEFAULT_IGNORED_ATTRIBUTES)
-      PaperTrailAdapter.new(associations: associations, ignore: ignore).compare(
+    #: (untyped, untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> Diff
+    def compare(
+      from_version,
+      to_version,
+      associations: [],
+      ignore: DEFAULT_IGNORED_ATTRIBUTES,
+      reload_live_endpoints: true
+    )
+      PaperTrailAdapter.new(
+        associations: associations,
+        ignore: ignore,
+        reload_live_endpoints: reload_live_endpoints
+      ).compare(
         from_version,
         to_version
       )
     end
 
+    # Compares many independent endpoint pairs while batching current-record loading.
+    #: (Array[comparison_input], ?associations: Array[String | Symbol], ?ignore: ignore_option, ?reload_live_endpoints: bool) -> comparison_results
+    def compare_many(
+      comparisons,
+      associations: [],
+      ignore: DEFAULT_IGNORED_ATTRIBUTES,
+      reload_live_endpoints: true
+    )
+      PaperTrailAdapter.new(
+        associations: associations,
+        ignore: ignore,
+        reload_live_endpoints: reload_live_endpoints
+      ).compare_many(comparisons)
+    end
+
     # Compares every adjacent reconstructed state in an inclusive version range.
-    #: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
-    def timeline(record, from:, to:, associations: [], ignore: DEFAULT_IGNORED_ATTRIBUTES)
+    #: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[Step]
+    def timeline( # rubocop:disable Metrics/ParameterLists
+      record,
+      from: nil,
+      to: nil,
+      within: nil,
+      associations: [],
+      ignore: DEFAULT_IGNORED_ATTRIBUTES
+    )
       PaperTrailAdapter.new(associations: associations, ignore: ignore).timeline(
         record,
         from: from,
-        to: to
+        to: to,
+        within: within
       )
     end
 
     # Compares adjacent root and selected-descendant activity boundaries.
-    #: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
-    def activity_timeline(record, from:, to:, associations: [], ignore: DEFAULT_IGNORED_ATTRIBUTES)
+    #: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option) -> Array[ActivityStep]
+    def activity_timeline( # rubocop:disable Metrics/ParameterLists
+      record,
+      from: nil,
+      to: nil,
+      within: nil,
+      associations: [],
+      ignore: DEFAULT_IGNORED_ATTRIBUTES
+    )
       PaperTrailAdapter.new(associations: associations, ignore: ignore).activity_timeline(
         record,
         from: from,
-        to: to
+        to: to,
+        within: within
       )
     end
 
     # Builds an endpoint diff and root-checkpoint timeline while normalizing each version once.
-    #: (untyped, from: untyped, to: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
+    #: (untyped, ?from: untyped, ?to: untyped, ?within: untyped, ?associations: Array[String | Symbol], ?ignore: ignore_option, ?activity: bool) -> Analysis
     def analyze( # rubocop:disable Metrics/ParameterLists
       record,
-      from:,
-      to:,
+      from: nil,
+      to: nil,
+      within: nil,
       associations: [],
       ignore: DEFAULT_IGNORED_ATTRIBUTES,
       activity: false
@@ -115,6 +185,7 @@ module PaperTrailDiff
         record,
         from: from,
         to: to,
+        within: within,
         activity: activity
       )
     end

data/sig/generated/paper_trail_diff/activity_belongs_to_event_applier.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/paper_trail_diff/activity_belongs_to_event_applier.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies selected non-polymorphic belongs-to target updates to a snapshot.
+  class ActivityBelongsToEventApplier
+    # : (route_finder: ActivityEventRouteFinder, record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer) -> void
+    def initialize: (route_finder: ActivityEventRouteFinder, record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer) -> void
+
+    # : (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [bool, RecordSnapshot?]
+    def call: (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [ bool, RecordSnapshot? ]
+
+    private
+
+    @record_normalizer: ActivityEventRecordNormalizer
+
+    @record_resolver: ActivityEventRecordResolver
+
+    @route_finder: ActivityEventRouteFinder
+
+    # : (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+    def normalized_route_record: (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
+    def replace_route: (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
+
+    # : (Array[RecordSnapshot], Array[untyped], untyped, RecordSnapshot?, Integer) -> [Array[RecordSnapshot], bool]
+    def replacement_records: (Array[RecordSnapshot], Array[untyped], untyped, RecordSnapshot?, Integer) -> [ Array[RecordSnapshot], bool ]
+
+    # : (Array[RecordSnapshot], untyped, RecordSnapshot?) -> [Array[RecordSnapshot], bool]
+    def replace_existing_target: (Array[RecordSnapshot], untyped, RecordSnapshot?) -> [ Array[RecordSnapshot], bool ]
+
+    # : (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+    def replace_association: (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+
+    # : (untyped, RecordSnapshot?) -> String
+    def replacement_type: (untyped, RecordSnapshot?) -> String
+
+    # : (untyped) -> untyped
+    def endpoint_model_class: (untyped) -> untyped
+  end
+end

data/sig/generated/paper_trail_diff/activity_child_candidate_loader.rbs

@@ -0,0 +1,40 @@
+# Generated from lib/paper_trail_diff/activity_child_candidate_loader.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Loads direct-child identities active at or after one activity boundary.
+  class ActivityChildCandidateLoader
+    # : (untyped, Array[untyped], untyped, ActivityRange) -> void
+    def initialize: (untyped, Array[untyped], untyped, ActivityRange) -> void
+
+    # : () -> Array[untyped]
+    def call: () -> Array[untyped]
+
+    private
+
+    @parent_class: untyped
+
+    @parent_ids: Array[untyped]
+
+    @range: ActivityRange
+
+    @reflection: untyped
+
+    # : () -> Array[untyped]
+    def historical_ids: () -> Array[untyped]
+
+    # : (untyped) -> untyped
+    def historical_relation: (untyped) -> untyped
+
+    # : (untyped) -> VersionAssociationCandidateScope
+    def candidate_scope: (untyped) -> VersionAssociationCandidateScope
+
+    # : () -> Array[untyped]
+    def current_ids: () -> Array[untyped]
+
+    # : () -> String
+    def child_item_type: () -> String
+
+    # : () -> Array[String?]
+    def parent_types: () -> Array[String?]
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_event_applier.rbs

@@ -0,0 +1,46 @@
+# Generated from lib/paper_trail_diff/activity_collection_event_applier.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies a safe collection event across every selected route for its record type.
+  class ActivityCollectionEventApplier
+    # : (record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer, route_updater: ActivityCollectionRouteUpdater, relationship: ActivityRelationship) -> void
+    def initialize: (record_resolver: ActivityEventRecordResolver, record_normalizer: ActivityEventRecordNormalizer, route_updater: ActivityCollectionRouteUpdater, relationship: ActivityRelationship) -> void
+
+    # : (Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> bool
+    def safe?: (Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> bool
+
+    # : (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [bool, RecordSnapshot]
+    def call: (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped, ActivitySnapshotDelta?) -> [ bool, RecordSnapshot ]
+
+    private
+
+    @record_normalizer: ActivityEventRecordNormalizer
+
+    @record_resolver: ActivityEventRecordResolver
+
+    @relationship: ActivityRelationship
+
+    @route_updater: ActivityCollectionRouteUpdater
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot
+    def apply_route: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot
+
+    # : (Array[Array[untyped]], untyped) -> bool
+    def unsafe_through_membership_event?: (Array[Array[untyped]], untyped) -> bool
+
+    # : (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
+    def unsafe_nested_membership_delta?: (Array[Array[untyped]], ActivitySnapshotDelta?) -> bool
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> [untyped, RecordSnapshot?]
+    def route_event_state: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?, Array[untyped], SnapshotNormalizer, Array[untyped]) -> [ untyped, RecordSnapshot? ]
+
+    # : (untyped, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot?
+    def normalized_event_record: (untyped, Array[untyped], SnapshotNormalizer, Array[untyped]) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
+    def existing_delta_record: (RecordSnapshot, Array[untyped], untyped, ActivitySnapshotDelta?) -> RecordSnapshot?
+
+    # : (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
+    def nested_delta_owner: (RecordSnapshot, Array[untyped], ActivitySnapshotDelta) -> RecordSnapshot?
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_record_updater.rbs

@@ -0,0 +1,25 @@
+# Generated from lib/paper_trail_diff/activity_collection_record_updater.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Applies one event to the leaf records of a collection association snapshot.
+  class ActivityCollectionRecordUpdater
+    # : (ActivityRelationship) -> void
+    def initialize: (ActivityRelationship) -> void
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, untyped, RecordSnapshot) -> RecordSnapshot?
+    def event_child: (AssociationSnapshot, ActivityCollectionRouteChange, untyped, RecordSnapshot) -> RecordSnapshot?
+
+    # : (AssociationSnapshot, untyped, RecordSnapshot?) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
+    def call: (AssociationSnapshot, untyped, RecordSnapshot?) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (untyped, RecordSnapshot?) -> String
+    def replacement_type: (untyped, RecordSnapshot?) -> String
+
+    private
+
+    @relationship: ActivityRelationship
+
+    # : (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
+    def replacement_records: (Array[RecordSnapshot], Integer?, RecordSnapshot?) -> Array[RecordSnapshot]
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_route_change.rbs

@@ -0,0 +1,17 @@
+# Generated from lib/paper_trail_diff/activity_collection_route_change.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Carries one collection event through recursive immutable route replacement.
+  class ActivityCollectionRouteChange
+    attr_reader route: Array[untyped]
+
+    attr_reader version: untyped
+
+    attr_reader record: untyped
+
+    attr_reader replacement: RecordSnapshot?
+
+    # : (route: Array[untyped], version: untyped, record: untyped, replacement: RecordSnapshot?) -> void
+    def initialize: (route: Array[untyped], version: untyped, record: untyped, replacement: RecordSnapshot?) -> void
+  end
+end

data/sig/generated/paper_trail_diff/activity_collection_route_updater.rbs

@@ -0,0 +1,44 @@
+# Generated from lib/paper_trail_diff/activity_collection_route_updater.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Replaces a collection event record along one explicit immutable snapshot route.
+  class ActivityCollectionRouteUpdater
+    # : (pool: SnapshotPool, relationship: ActivityRelationship) -> void
+    def initialize: (pool: SnapshotPool, relationship: ActivityRelationship) -> void
+
+    # : (RecordSnapshot, ActivityCollectionRouteChange, ?depth: Integer) -> [RecordSnapshot, bool]
+    def call: (RecordSnapshot, ActivityCollectionRouteChange, ?depth: Integer) -> [ RecordSnapshot, bool ]
+
+    private
+
+    @pool: SnapshotPool
+
+    @record_updater: ActivityCollectionRecordUpdater
+
+    @relationship: ActivityRelationship
+
+    # : (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def updated_records: (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def leaf_records: (AssociationSnapshot, RecordSnapshot, ActivityCollectionRouteChange) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]?
+    def targeted_parent: (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]?
+
+    # : (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool]
+    def recursive_records: (AssociationSnapshot, ActivityCollectionRouteChange, Integer) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool, bool ]
+
+    # : ([RecordSnapshot?, RecordSnapshot?, bool], RecordSnapshot, RecordSnapshot, bool) -> [RecordSnapshot?, RecordSnapshot?, bool]
+    def recursive_transition: ([ RecordSnapshot?, RecordSnapshot?, bool ], RecordSnapshot, RecordSnapshot, bool) -> [ RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool]
+    def targeted_parent_replacement: (Array[RecordSnapshot], Integer, RecordSnapshot, RecordSnapshot, bool) -> [ Array[RecordSnapshot], RecordSnapshot?, RecordSnapshot?, bool ]
+
+    # : (AssociationSnapshot, untyped, ActivityCollectionRouteChange) -> Integer?
+    def nested_owner_position: (AssociationSnapshot, untyped, ActivityCollectionRouteChange) -> Integer?
+
+    # : (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+    def replace_association: (RecordSnapshot, String, AssociationSnapshot) -> RecordSnapshot
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_record_normalizer.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/paper_trail_diff/activity_event_record_normalizer.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Normalizes one event record with the historical reader for its boundary.
+  class ActivityEventRecordNormalizer
+    # : (?association_reader: untyped) -> void
+    def initialize: (?association_reader: untyped) -> void
+
+    # : (untyped, reflection: untyped, subtree: AssociationTree, path: String, normalizer: SnapshotNormalizer, root_endpoint: untyped, context_endpoint: untyped) -> RecordSnapshot?
+    def call: (untyped, reflection: untyped, subtree: AssociationTree, path: String, normalizer: SnapshotNormalizer, root_endpoint: untyped, context_endpoint: untyped) -> RecordSnapshot?
+
+    private
+
+    @association_reader: untyped
+
+    # : (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
+    def historical_reader: (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_record_resolver.rbs

@@ -0,0 +1,44 @@
+# Generated from lib/paper_trail_diff/activity_event_record_resolver.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Reconstructs an event's post-change record or immutable scalar delta.
+  class ActivityEventRecordResolver
+    RECORD_AFTER_HANDLERS: untyped
+
+    # : (?record_transition: untyped) -> void
+    def initialize: (?record_transition: untyped) -> void
+
+    # : (untyped) -> untyped
+    def record_after: (untyped) -> untyped
+
+    # : (untyped) -> ActivitySnapshotDelta?
+    def snapshot_delta: (untyped) -> ActivitySnapshotDelta?
+
+    # : (untyped) -> untyped
+    def changed_record_after: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def created_record_after: (untyped) -> untyped
+
+    # : (untyped) -> untyped
+    def updated_record_after: (untyped) -> untyped
+
+    # Mirrors PaperTrail's changeset deserialization without resolving
+    # +version.item+, which would issue one live-record query per event.
+    # : (untyped, untyped) -> untyped
+    def deserialized_changeset: (untyped, untyped) -> untyped
+
+    private
+
+    @record_transition: untyped
+
+    # : (untyped, untyped) -> Hash[untyped, untyped]
+    def after_attributes: (untyped, untyped) -> Hash[untyped, untyped]
+
+    # : (untyped, untyped) -> untyped
+    def apply_changes: (untyped, untyped) -> untyped
+
+    # : (untyped, untyped, untyped) -> untyped
+    def standard_changeset: (untyped, untyped, untyped) -> untyped
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_route_finder.rbs

@@ -0,0 +1,54 @@
+# Generated from lib/paper_trail_diff/activity_event_route_finder.rb with RBS::Inline
+
+module PaperTrailDiff
+  # Finds explicitly selected collection and belongs-to routes for one event type.
+  class ActivityEventRouteFinder
+    # : (AssociationTraversal) -> void
+    def initialize: (AssociationTraversal) -> void
+
+    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    def collection_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    def belongs_to_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+
+    private
+
+    @belongs_to_model: untyped
+
+    @belongs_to_path: String?
+
+    @belongs_to_routes: Array[Array[untyped]]?
+
+    @belongs_to_tree: AssociationTree?
+
+    @belongs_to_type: String?
+
+    @collection_model: untyped
+
+    @collection_path: String?
+
+    @collection_routes: Array[Array[untyped]]?
+
+    @collection_tree: AssociationTree?
+
+    @collection_type: String?
+
+    @traversal: AssociationTraversal
+
+    # : (Array[Array[untyped]]) -> Array[Array[untyped]]
+    def freeze_routes: (Array[Array[untyped]]) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, Symbol, path: String) -> Array[Array[untyped]]
+    def routes: (untyped, AssociationTree, String, Symbol, path: String) -> Array[Array[untyped]]
+
+    # : (untyped, AssociationTree, String, Symbol, String) -> Array[Array[untyped]]
+    def routes_for_reflection: (untyped, AssociationTree, String, Symbol, String) -> Array[Array[untyped]]
+
+    # : (untyped, String, Symbol) -> bool
+    def direct_route?: (untyped, String, Symbol) -> bool
+
+    # : (untyped, Symbol) -> bool
+    def supported_direct_reflection?: (untyped, Symbol) -> bool
+  end
+end

data/sig/generated/paper_trail_diff/activity_event_snapshot_refresher.rbs

@@ -1,97 +1,46 @@
 # Generated from lib/paper_trail_diff/activity_event_snapshot_refresher.rb with RBS::Inline
 
 module PaperTrailDiff
-  # Applies safe descendant event deltas without rebuilding an entire selected branch.
-  # rubocop:disable Metrics/ClassLength
+  # Dispatches safe descendant events to focused immutable snapshot appliers.
   class ActivityEventSnapshotRefresher
-    RECORD_AFTER_HANDLERS: untyped
+    # : (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped, ?record_transition: untyped) -> void
+    def initialize: (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped, ?record_transition: untyped) -> void
 
-    # : (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped) -> void
-    def initialize: (traversal: AssociationTraversal, pool: SnapshotPool, components: untyped, ?association_reader: untyped) -> void
+    # : (SnapshotPool, untyped) -> void
+    def configure_appliers: (SnapshotPool, untyped) -> void
 
-    # : (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [bool, RecordSnapshot?]
-    def call: (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [ bool, RecordSnapshot? ]
-
-    private
-
-    @association_reader: untyped
-
-    @components: untyped
+    # : (SnapshotPool) -> ActivityCollectionRouteUpdater
+    def collection_updater: (SnapshotPool) -> ActivityCollectionRouteUpdater
 
-    @pool: SnapshotPool
+    # : (ActivityEventRecordNormalizer, ActivityCollectionRouteUpdater) -> ActivityCollectionEventApplier
+    def collection_applier: (ActivityEventRecordNormalizer, ActivityCollectionRouteUpdater) -> ActivityCollectionEventApplier
 
-    @traversal: AssociationTraversal
+    # : (ActivityEventRecordNormalizer) -> ActivityBelongsToEventApplier
+    def belongs_to_applier: (ActivityEventRecordNormalizer) -> ActivityBelongsToEventApplier
 
-    # : (Array[Array[untyped]], untyped) -> bool
-    def unsafe_through_membership_event?: (Array[Array[untyped]], untyped) -> bool
-
-    # : (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped) -> [bool, RecordSnapshot]
-    def collection_target_snapshot: (untyped, untyped, RecordSnapshot, SnapshotNormalizer, Array[Array[untyped]], untyped) -> [ bool, RecordSnapshot ]
+    # : (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [bool, RecordSnapshot?]
+    def call: (untyped, untyped, RecordSnapshot, Array[String], ActivityEvent?) -> [ bool, RecordSnapshot? ]
 
-    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
-    def direct_collection_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    private
 
-    # : (RecordSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
-    def replace_collection_route: (RecordSnapshot, Array[untyped], untyped, untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
+    @belongs_to_applier: ActivityBelongsToEventApplier
 
-    # : (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [bool, RecordSnapshot?]
-    def belongs_to_target_snapshot: (untyped, untyped, RecordSnapshot, AssociationTree, SnapshotNormalizer, untyped) -> [ bool, RecordSnapshot? ]
+    @collection_applier: ActivityCollectionEventApplier
 
-    # : (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
-    def belongs_to_routes: (untyped, AssociationTree, String, ?path: String) -> Array[Array[untyped]]
+    @components: untyped
 
-    # : (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-    def normalized_route_record: (Array[untyped], untyped, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
+    @record_resolver: ActivityEventRecordResolver
 
-    # : (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [RecordSnapshot, bool]
-    def replace_route: (RecordSnapshot, Array[untyped], untyped, RecordSnapshot?, ?depth: Integer) -> [ RecordSnapshot, bool ]
+    @relationship: ActivityRelationship
 
-    # : (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
-    def replace_existing_target: (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
+    @route_finder: ActivityEventRouteFinder
 
     # : (untyped) -> untyped
     def record_after: (untyped) -> untyped
 
-    # PaperTrail create/update versions contain deserialized change pairs, so
-    # their post-event records need no successor query.
-    # : (untyped) -> untyped
-    def changed_record_after: (untyped) -> untyped
-
-    # : (untyped) -> untyped
-    def created_record_after: (untyped) -> untyped
-
-    # : (untyped) -> untyped
-    def updated_record_after: (untyped) -> untyped
-
-    # : (untyped, untyped) -> Hash[untyped, untyped]
-    def after_attributes: (untyped, untyped) -> Hash[untyped, untyped]
-
-    # : (untyped, untyped) -> untyped
-    def apply_changes: (untyped, untyped) -> untyped
-
-    # Mirrors PaperTrail's changeset deserialization without resolving
-    # +version.item+, which would issue one live-record query per event.
     # : (untyped, untyped) -> untyped
     def deserialized_changeset: (untyped, untyped) -> untyped
 
-    # : (untyped, untyped, untyped) -> untyped
-    def standard_changeset: (untyped, untyped, untyped) -> untyped
-
-    # : (untyped, untyped, RecordSnapshot) -> bool
-    def member_of_owner?: (untyped, untyped, RecordSnapshot) -> bool
-
-    # : (untyped, untyped, AssociationTree, String, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-    def normalize_event_record: (untyped, untyped, AssociationTree, String, SnapshotNormalizer, untyped, untyped) -> RecordSnapshot?
-
-    # : (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
-    def historical_reader: (untyped, habtm_version: untyped) -> HistoricalAssociationReifier
-
-    # : (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
-    def replace_collection_record: (Array[RecordSnapshot], untyped, RecordSnapshot?) -> Array[RecordSnapshot]
-
-    # : (untyped, RecordSnapshot?) -> String
-    def replacement_type: (untyped, RecordSnapshot?) -> String
-
     # : (untyped) -> untyped
     def endpoint_model_class: (untyped) -> untyped
   end