solid_objects 0.16.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d267d861c25f682b3e45208131b9c115b49710ae43fb499223c6d63f48519a0
-  data.tar.gz: 1acc3bb415c57e9072f231fc5e37ed37ce8bab4a9ba5fc894a7dbe5453839d8e
+  metadata.gz: b060638b79ca2236a6530f8c478fe28ac0453fc514a0daeeb5f0f3a400f446ee
+  data.tar.gz: 31424c65ecc34caab85a2296b3e2f7055f731b07a5db16022fc48d1fcc860ed6
 SHA512:
-  metadata.gz: 1f3d71f114877579419a680b8ff46b56036060d8575c7c6732c4c9d530ed3020fbb58eb61ac3e348810d44ecf09e8553b4f07390bd1c22460b5604005578e06f
-  data.tar.gz: 07e811b54283aa3f3638ae90b8fbc449f5e151dbcae69e01487a8231a1b8cc5556bd1cc035b67aa347f080329a64f9c0394965d468860dd989f0ba40afdc7552
+  metadata.gz: 6fee1b678cfb18e2a0b59c1e275a079631570b7a7b44cdd9edc2e0d880ec7efc688f9ee59bc9e3afb2742f355f793939f9a263f07f9e3a7bc466c07367dcbb23
+  data.tar.gz: 5d92fe6f884c53b757c5dde1ab372afe0200a3f509ddef737f75bd8810f42e224def36ce363abf57d1e41326fe2dc5ff0985b111deed3656db960a3889b26d9c

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.16.1 - 2026-10-02
+
+- Fix the SQLite join order of the claimed-message scan. The query in
+  `ActivationManager#claimed_instance_ids` has no condition on a
+  claimed-message column. The claimed-messages table is a short queue, so it is
+  often empty when `ANALYZE` or `PRAGMA optimize` runs, and `sqlite_stat1` then
+  has no row for it. Without statistics, SQLite assumed that the table was
+  large, and it scanned every instance on each worker poll. The scan now uses
+  `CROSS JOIN`, which SQLite keeps as a fixed join order, so it starts from the
+  claimed messages. PostgreSQL and MySQL treat `CROSS JOIN` with an equality as
+  an inner join and keep their plans. The ids and their order do not change.
+- Find SQLite effect recovery candidates through the processing effects.
+  `sqlite_stat1` records only the average row count for each effect status.
+  When most effects are complete, SQLite estimated that `status = 'processing'`
+  matched most of the effects table. It then read every recovery row in key
+  order to skip a sort, on each effect poll. An index on the recovery filter
+  does not help, because a recovery row keeps `retired_at` empty after a normal
+  completion. On SQLite the status test now carries
+  `likelihood(..., 0.000001)`, so the plan starts from `idx_so_effects_poll`.
+  The PostgreSQL and MySQL queries do not change.
+
 ## 0.16.0 - 2026-09-23
 
 - Find a message whose reference a caller lost.

data/lib/solid_objects/activation_manager.rb

@@ -86,7 +86,8 @@ module SolidObjects
     # @rbs (Time) -> Array[Integer]
     def claimed_instance_ids(now)
       ClaimedMessage
-        .joins(:instance)
+        .joins("CROSS JOIN #{Instance.table_name}")
+        .where("#{Instance.table_name}.id = #{ClaimedMessage.table_name}.instance_id")
         .where("#{Instance.table_name}.paused_at IS NULL")
         .where(available_lease_sql, now)
         .group(:instance_id)

data/lib/solid_objects/effect_recovery_coordinator.rb

@@ -63,17 +63,22 @@ module SolidObjects
       effects = Effect.table_name
       owners = Process.table_name
       bindings = EffectRecovery.table_name
-      heartbeat = case DatabaseAdapter.family(Record.connection)
+      family = DatabaseAdapter.family(Record.connection)
+      heartbeat = case family
       when :postgresql then "EXTRACT(EPOCH FROM #{owners}.last_heartbeat_at)"
       when :mysql then "UNIX_TIMESTAMP(#{owners}.last_heartbeat_at)"
       else "CAST(STRFTIME('%s', #{owners}.last_heartbeat_at) AS REAL)"
       end
+      processing = case family
+      when :postgresql, :mysql then "#{effects}.status = ?"
+      else "likelihood(#{effects}.status = ?, 0.000001)"
+      end
       now = SolidObjects.database_adapter.database_clock_now.to_f
       threshold = SolidObjects.configuration.process_alive_threshold
       EffectRecovery.joins("INNER JOIN #{effects} ON #{effects}.effect_id = #{bindings}.effect_id")
         .joins("LEFT JOIN #{owners} ON #{owners}.id = #{effects}.claimed_by")
         .where(retired_at: nil).where.not(recovery_operation: nil)
-        .where("#{effects}.status = ?", "processing")
+        .where(processing, "processing")
         .where("#{owners}.id IS NULL OR #{heartbeat} <= ? - CASE WHEN #{bindings}.recovery_timeout > ? THEN #{bindings}.recovery_timeout ELSE ? END", now, threshold, threshold)
         .order(:effect_id).limit(SolidObjects.configuration.claim_scan_limit)
     end

data/lib/solid_objects/version.rb

@@ -1,5 +1,5 @@
 # rbs_inline: enabled
 
 module SolidObjects
-  VERSION = "0.16.0"
+  VERSION = "0.16.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable