Skip to content
CAI
Software that uses CAICheck a score

mbleigh/acts-as-taggable-on

64.7

Adequate · 14 November 2026

1.7k

lines of production code

Ruby

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

ActsAsTaggableOn is a Ruby gem that enables models to manage tags, contexts, and tag ownership within Rails applications. It provides features for tag parsing, caching, and querying, while supporting multiple database backends and modern Rails versions. The system includes utilities for database setup and configuration, ensuring compatibility with current Ruby and ActiveRecord standards.

How it got here

2007 — Rails 8.1 and Zeitwerk migration

6 changes.

The project upgraded to support Rails 8.1 and Ruby 3.3, dropping older versions and replacing legacy autoloading with Zeitwerk. This modernization involved removing obsolete plugin files and Rake tasks while refactoring the test suite for better reliability and coverage.

2008–2014 — Rails 8 and Zeitwerk migration

7 changes.

The project focused on upgrading compatibility to Rails 8 and ActiveRecord 8.0/8.1, replacing legacy autoloading with Zeitwerk, and refactoring tag parsing logic. This period also involved extensive updates to the test suite, including new database schemas, fixtures, and support helpers to ensure robust testing across multiple database backends.

2015–2025 — Database configuration and performance optimization

4 changes.

This period focused on enhancing database setup and query performance by consolidating migrations into a single file and introducing rake tasks for MySQL collation and initializer installation. The tagging engine was refactored to improve maintainability and speed, featuring default tag caching, rewritten Arel-based queries, and modularized concerns for ownership and related tags.

Features

Added bin stubs for rake, rspec, guard, and appraisal

The project now includes executable wrapper scripts in the bin directory for rake, rspec, guard, and appraisal. These stubs allow these tools to be invoked directly from the project's local environment, ensuring they run against the correct Gemfile and dependencies managed by Bundler.

bin · high confidence

Added rake tasks for MySQL collation and initializer installation

This change introduces new rake tasks to assist with database configuration and setup. Users can now run \acts\_as\_taggable\_on:tag\_names:collate\_bin\ or \collate\_ci\ to force binary or general collation for tag names in MySQL, addressing string encoding issues. Additionally, a new task \acts\_as\_taggable\_on:sharded\_db:install\_initializer\ is provided to copy an example initializer file into the application's \config/initializers\ directory, facilitating the configuration of a custom base class for the tagging engine.

lib/tasks · high confidence

Removals

Removal of acts\_as\_taggable\_on plugin

The \acts\_as\_taggable\_on\ plugin has been removed from the codebase, deleting the \lib/active\_record/acts/taggable\_on.rb\ file. This eliminates the ability for models to use the \acts\_as\_taggable\_on\ DSL for managing tagged contexts, related tag queries, and tag caching.

_lib/active\record · high confidence

Removal of placeholder Rake task file

The placeholder Rake task file for acts\_as\_taggable\_on has been removed. This cleanup eliminates unused code stubs as part of the gemification process, ensuring the project no longer includes dormant task definitions.

tasks · high confidence

Behavioural changes

ActsAsTaggableOn v13.0.0: Drop Rails 7.1/7.2, require Ruby 3.3+, add Rails 8.1 support

This release drops support for Rails 7.1 and 7.2, raising the minimum ActiveRecord version to 8.0 (allowed up to \< 9.0) and requiring Ruby 3.3 or higher. It adds support for Rails 8.1 and includes a fix to use \lease\_connection\ in \ActsAsTaggableOn::Utils.connection\ to avoid the Rails 7.2 \ActiveRecord::Base.connection\ deprecation warning. The gem also now tests against Rails edge (main branch) in CI.

(repo-wide) · high confidence

ActsAsTaggableOn v13.0.0: Rails 8 support, Zeitwerk autoloading, and refactored tag parsing

This release upgrades the library to version 13.0.0, adding support for Rails 8.0 and dropping support for Rails 7.1. It replaces legacy autoloading with the Zeitwerk loader by default and removes the \lease\_connection\ fallback. The tag parsing logic has been refactored into a new \DefaultParser\ class (replacing the inline parsing in \TagList.from\), and the \TagList\ class now supports a configurable parser. Additionally, the \TagsHelper\ has been updated to use \taggings\_count\ for tag cloud calculations, and the \Tag\ model now includes a \validates\_name\_uniqueness?\ method to allow disabling uniqueness validation.

lib/acts-as-taggable-on · high confidence

Migration to Zeitwerk autoloading and removal of legacy model files

The library now uses Zeitwerk for autoloading, replacing the previous manual load-path and autoloading mechanisms. This change is accompanied by the removal of the legacy \lib/tag.rb\ and \lib/tagging.rb\ files, indicating that the Tag and Tagging models have been moved to a different location (likely within the engine or a modules structure) to align with the new autoloader. Users should ensure their applications are compatible with the new file structure and autoloading behavior.

lib · high confidence

Tagging behavior and caching refactored for performance

The taggable module has been restructured into distinct concerns (core, caching, collection, ownership, related) to improve performance and maintainability. Tag caching is now enabled by default, persisting tag lists to database columns to reduce query load, and only changed tag lists are persisted to the database. The \tagged\_with\ query logic has been rewritten using Arel for better SQL generation and performance, supporting options like \:exclude\, \:any\, and \:match\_all\. Additionally, tag ownership and related tag finding have been refactored into their own modules with optimized queries.

lib/acts-as-taggable-on/taggable · high confidence

Fixes

Consolidate acts\_as\_taggable\_on database migrations into a single file

The seven separate database migrations for the acts\_as\_taggable\_on gem (versions 1 through 7) have been replaced by a single combined migration file (1\_setup\_acts\_as\_taggable\_on.rb). This change simplifies the database schema setup process by executing all table creations, index additions, and collation adjustments in one step, reducing the number of migration files and ensuring consistent initialization of the tagging system.

db · high confidence

Test coverage

Added comprehensive test suite for acts-as-taggable-on core features; Added sample database configuration for testing; Added test database schema for internal specs; Added test fixtures for taggable models and contexts; Added test support helpers and database configuration; Test suite modernization and cleanup.

Dependencies

ActsAsTaggableOn 2.0.0: Rails 8 support and Ruby 3.3 requirement

This release updates the gem to version 2.0.0, raising the minimum required Ruby version to 3.3.0 and adding support for Rails 8.0 (ActiveRecord \>= 8.0, \< 9.0). The gem now relies on Zeitwerk for autoloading, removing legacy autoloading mechanisms. Development dependencies have been modernized to include RSpec 3, Database Cleaner, and Appraisal for multi-version testing.

(dependencies) · high confidence

Added support for ActiveRecord 8.0 and 8.1

The gemfile matrix now includes dedicated configurations for ActiveRecord 8.0 and 8.1, enabling the library to be tested and used with these specific versions. This change expands compatibility beyond previous versions, allowing users to integrate the gem with newer ActiveRecord releases.

gemfiles · 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 65 → 65 (-0.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 75 → 73 (-2.7)
  • Architecture 99 → 100 (+0.5)
  • Maturity 60 → 60 (+0.0)
  • Readiness 58 → 58 (+0.0)
  • Security 87 → 86 (-0.9)

Resolved (2)

  • Change coupling: core.rb ↔ ownership.rb (lib/acts-as-taggable-on/taggable/core.rb)
  • Off-boarding risk: anonymized user #1

New (2)

  • Edited copy of a member (24 corresponding lines) (lib/acts-as-taggable-on/taggable/tagged_with_query/all_tags_query.rb)
  • Off-boarding risk: anonymized user #1

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

mbleigh/acts-as-taggable-on 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 14 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 719734149d4f4295f497dc9a02884b08051325a3 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.65+preprod-36d4cd83012f.