salsify/goldiloader
59.1
Adequate · 6 November 2026
600
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Initial release of Goldiloader for automatic association loading
Goldiloader is introduced as a new library that automatically eager loads ActiveRecord associations to prevent N+1 query issues. It provides a global configuration flag to enable or disable this behavior and offers thread-safe, block-based methods (\enabled\ and \disabled\) to temporarily toggle automatic loading within specific code sections without affecting other threads.
lib · high confidence
Behavioural changes
Benchmark suite now runs in forked processes to isolate memory state
The benchmark infrastructure has been refactored to execute test blocks in forked child processes via a new \ExperimentServer\ and \ForkingBenchmark\ adapter. This change ensures that each benchmark iteration starts with a clean, isolated memory state, preventing data leakage or state accumulation between runs. The suite now includes specific benchmarks for comparing ActiveRecord eager loading against Goldiloader for both single-model associations and multi-model scenarios.
benchmark · high confidence
Goldiloader 6.0.0: Custom preloads, fully\_load option, and Rails 8.0 support
Goldiloader has been updated to version 6.0.0, introducing support for Rails 8.0 and Ruby 4.0. This release adds a new \fully\_load\ association option that forces immediate loading of association data, and introduces custom preloads via the \goldiload\ method on relations, allowing users to define and cache custom queries for multiple models. The library also refactors its internal patching strategy to use \Module\#prepend\ instead of \alias\_method\_chain\ for better compatibility with modern Ruby and Rails versions, and drops support for older Ruby and Rails versions.
lib/goldiloader · high confidence
Goldiloader 6.0.0: Support for Rails 8.1 and Ruby 3.4
This release updates the library to support Rails 8.1 and Ruby 3.4, while dropping support for older versions including Rails 6.1, 7.0, 7.1, and Ruby 3.0, 3.1. The test matrix has been expanded to include Rails 7.2, 8.0, 8.1, and the Rails edge (main branch), ensuring compatibility with the latest ActiveRecord versions. Additionally, the project configuration has been updated to target Ruby 3.2 as the minimum version for development and linting via RuboCop.
(repo-wide) · high confidence
Refactored auto-include context and added benchmark schema
The library introduces a dedicated \AutoIncludeContext\ class to manage the state of models being auto-included, replacing the previous inline context handling. This change includes a fix to prevent infinite recursion when accessing \ActiveStorage::Attachment\#blob\ by avoiding \Array.wrap\ on model collections during registration. Additionally, a new \ScopeInfo\ helper class is added to inspect ActiveRecord scope properties (such as limit, offset, and ordering), and a benchmark schema is included to support performance testing of these optimizations.
goldiloader · high confidence
Test coverage
Add RSpec test infrastructure with query-expectation matcher; Added database schema and model definitions for test suite; Added internal Rails test application scaffolding; Added test coverage for Goldiloader's auto-include context and core eager-loading behaviors.
Dependencies
Added Gemfiles for Rails 7.2, 8.0, 8.1, and Edge testing
The project now includes dedicated Appraisal gemfiles to support testing against Rails 7.2.3, 8.0.4, 8.1.2, and the Rails main branch (edge). These files explicitly pin the \activerecord\, \activesupport\, and \rails\ gems to their respective versions, enabling the library to verify compatibility with these newer Rails releases.
gemfiles · high confidence
Initial release of Goldiloader gem with Rails 7.2+ support
This change introduces the Goldiloader gem, which automatically eager loads Rails associations as they are traversed. The gem is configured to require Ruby 3.2 or higher and supports ActiveRecord and ActiveSupport versions 7.2 through 8.2. Development dependencies include testing tools like RSpec, Combustion, and SQLite3.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 55 → 59 (+4.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 76 → 76 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 43 → 54 (+11.5)
- Readiness 51 → 51 (+0.0)
- Security 94 → 90 (-3.9)
- Domain Modelling 100 → 100 (+0.0)
- Performance 80 → 80 (+0.0)
Resolved (4)
- Ambiguous distinction between auto_include and auto_include!. In Ruby, the ! suffix often implies a mutating or more aggressive action, but without documentation, it is unclear if these methods have different side effects or if one is just an alias. If they perform the same logical operation (setting auto_include), one is redundant.
- Orphaned file (lib/goldiloader/active_record_patches.rb)
- Orphaned files with no living knowledge
- Redundant getter methods. In Ruby, enabled? is the standard convention for boolean predicates, while enabled is typically used for the getter/setter pair (enabled/enabled=). Having both enabled? and enabled as separate methods creates confusion about which one to use for reading the state, especially since enabled= exists.
Changes since last survey
- 7 commits — 7 feature/other, 0 fixes
By area
- (root) — 7 commits
Notable commits
- change: Auto eager load associations below includes that Rails joins (31 → 2 queries) (#178)
- change: Auto eager load associations of models loaded with load_async (11 → 2 queries) (#179)
- change: Document goldiload cache names that depend on method arguments (#180)
- change: Document uninstalling the gem with records cached by Marshal (#181)
- change: Forward arguments without allocating in CollectionAssociationPatch (#175)
- change: Keep belongs_to optional in the test app with combustion 1.6+ (#176)
- change: Release version 6.0.1 (#177)
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
salsify/goldiloader was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit bac4ee78249696be5b474c9dd9611d1537248da5 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.