Changelog

Unreleased

[0.5.0] - 2026-08-20

Added

  • Added auto_create_user_fk_constraints configuration for automatically creating foreign-key constraints from creator, updater, and deleter stamp columns to the configured user table.
  • Added user_class_table_name for explicitly overriding the inferred user table name.
  • Added per-migration overrides for automatic user foreign-key creation.
  • Added automatic injection of the configured soft-delete timestamp alongside the deleter stamp column.

Fixed

  • Made stamp auto-injection idempotent when migrations already declare stamp columns or matching foreign keys.
  • Removed stamp foreign-key constraints before removing stamp columns in migration helpers.
  • Avoided loading the configured user model while migrations infer its table name, preventing failures when the user table is being created in the same migration.
  • Skipped automatic stamp and user-FK injection for Rails internal metadata tables during database setup.
  • Made require "whodunit" safe before Active Record loads by deferring migration integration until Active Record is available.

[0.4.1] - 2026-06-01

Fixed

  • Fixed Whodunit::Stampable when included on an abstract ActiveRecord base class, such as ApplicationRecord. Association setup and model registration are now deferred to concrete subclasses.
  • Preserved existing inherited hooks by prepending an internal hook instead of replacing self.inherited.
  • Supported multi-level abstract inheritance, such as ApplicationRecord -> TenantRecord -> Post, without registering abstract classes.

Added

  • Added RSpec regression coverage for abstract-base inclusion, inherited-hook preservation, abstract subclass exclusion, concrete subclass registration, multi-level abstract inheritance, and inherited callback stamping.

[0.4.0] - 2025-05-20

Breaking Changes

  • Dropped support for Ruby 3.1. Minimum supported Ruby version is now 3.2.

Fixed

  • TableDefinitionExtension: replaced included { attr_accessor :_whodunit_stamps_added } with explicit reader/writer methods so the accessor is defined correctly when the module is prepended (as the Railtie does) rather than included. Previously the accessor was silently missing in production, causing @_whodunit_stamps_added to be inaccessible via the public API.

Changed

  • Test suite: eliminated all hand-rolled ActiveRecord and Railtie mocks in favour of genuine infrastructure — real ActiveRecord::Base subclasses backed by an in-memory SQLite3 database, and real ActiveRecord::ConnectionAdapters::TableDefinition instances for migration-helper tests. Callbacks, dirty tracking, belongs_to reflections, and column_names now go through actual AR code paths rather than no-op stubs.
    • spec/support/rails_mocks.rb — emptied; activesupport is a runtime dependency and needs no re-implementation in tests.
    • spec/support/test_models.rb — replaced MockActiveRecord stub class with real AR models (WhodunitRecord, WhodunitSoftDeleteRecord) on an in-memory SQLite3 schema; backward-compat aliases preserved.
    • spec/spec_helper.rb — added rescue Bundler::GemNotFound guard on require "bundler/setup" to allow running specs directly without bundle exec; wrapped every example in an AR transaction that rolls back on completion; added missing config keys to ORIGINAL_WHODUNIT_CONFIG.
    • spec/whodunit/table_definition_extension_spec.rb — now tests the real ActiveRecord::ConnectionAdapters::TableDefinition with TableDefinitionExtension prepended, rather than an anonymous class that reimplemented the extension logic internally.
    • spec/whodunit/stampable_spec.rb — being_soft_deleted? tests use real AR dirty tracking via genuine attribute writes; callback-integration tests persist records and assert database values after reload.
    • spec/whodunit/migration_helpers_spec.rb — whodunit_stamps(table_def) path uses a real TableDefinitionExtension-prepended TableDefinition instance instead of a double.
    • spec/whodunit/per_model_config_spec.rb, railtie_spec.rb, reverse_associations_integration_spec.rb — all converted to real AR anonymous subclasses; removed stubs for before_create, belongs_to, and column_names.

[0.3.0] - 2025-01-24

Added

  • Automatic Reverse Associations: When models include Whodunit::Stampable, reverse associations are automatically created on the user class (e.g., user.created_posts, user.updated_comments, user.deleted_documents)
  • Model Registry System: Tracks models that include Stampable for automatic reverse association setup
  • Per-Model Reverse Association Control: Models can disable reverse associations with disable_whodunit_reverse_associations!
  • Reverse Association Configuration: Global configuration options including auto_setup_reverse_associations, reverse_association_prefix, and reverse_association_suffix
  • Smart Model Capability Detection: Automatically detects which associations to create based on model capabilities (creator, updater, deleter, soft-delete)
  • Custom Column Support: Reverse associations respect per-model custom column configurations
  • Manual Setup Methods: setup_whodunit_reverse_associations! and setup_all_reverse_associations for manual control

Changed

  • Enhanced Stampable Module: Now automatically registers models for reverse association setup when included
  • Improved Configuration: Extended main configuration module with reverse association settings
  • Better Association Management: Prevents duplicate associations and handles edge cases gracefully

Features

  • Zero Configuration: Reverse associations work automatically with sensible defaults
  • Thread Safe: Built on existing thread-safe architecture
  • Flexible Naming: Configurable prefixes and suffixes for association names
  • Comprehensive Testing: Full test coverage for all reverse association functionality
  • RuboCop Compliant: All code follows project style guidelines

[0.2.1] - 2025-01-21

Added

  • ApplicationRecord Integration: whodunit install now prompts to automatically add Whodunit::Stampable to ApplicationRecord for convenient all-model stamping
  • Enhanced Configuration Template: Detailed explanations and examples for each configuration option in generated initializer
  • Post-install Message: Helpful instructions displayed after gem installation via bundle add whodunit
  • Comprehensive Test Coverage: Full test suite for ApplicationRecord integration with edge case handling

Changed

  • Improved CLI Experience: More user-friendly prompts and messages throughout the installation process
  • Better Documentation: Updated README with corrected installation commands and new ApplicationRecord feature
  • Code Organization: Extracted ApplicationRecord integration logic into separate module for better maintainability

Fixed

  • Gemspec Consistency: Corrected post-install message to show whodunit install instead of incorrect Rails generator command
  • RuboCop Compliance: Fixed all style issues and reduced complexity across codebase

[0.2.0] - 2025-01-20

Added

  • New whodunit install CLI command to generate configuration initializer
  • Per-model configuration override capability via whodunit_config block
  • Column enabling/disabling - set individual columns to nil to disable them
  • Configuration validation to prevent disabling both creator and updater columns
  • Comprehensive generator with Rails app detection and safety prompts
  • Enhanced YARD documentation reflecting simplified architecture

Changed

  • BREAKING: soft_delete_column now defaults to nil instead of :deleted_at
  • BREAKING: Removed automatic soft-delete detection - now purely configuration-based
  • BREAKING: Simplified being_soft_deleted? logic to check only configured column
  • Migration helpers now respect column enabling/disabling configuration
  • Updated all documentation to reflect simplified, configuration-based approach
  • Improved test infrastructure with better configuration isolation

Removed

  • BREAKING: SoftDeleteDetector class and all auto-detection logic
  • BREAKING: SOFT_DELETE_COLUMNS constant and pattern-matching detection
  • Complex database schema introspection for soft-delete detection

Performance

  • Eliminated expensive auto-detection queries during model initialization
  • Reduced computational overhead by trusting user configuration
  • Simplified callback and association setup based on explicit configuration

[0.1.0] - 2025-01-15

Added

  • Initial release of Whodunit gem
  • Thread-safe user context with Whodunit::Current
  • Smart soft-delete detection for multiple gems (Discard, Paranoia, ActsAsParanoid)
  • Automatic creator/updater/deleter tracking via Whodunit::Stampable
  • Database migration helpers with configurable data types
  • Rails controller integration with automatic user detection
  • Comprehensive test suite with 93.4% coverage
  • YARD documentation for API reference
  • RuboCop integration for code style enforcement
  • SimpleCov integration for test coverage tracking
  • Github CI workflow with ruby version matrix strategy for 3.1.1=>7.2, 3.2.0=>7.2, 3.3.0=>8.0.2, 3.4.4=>edge
  • Github CD (Release) workflow on version release and manual via workflow dispatch dry-run support
  • Documentation deployment Github pages workflow/pipeline

Features

  • Configurable Data Types: Support for bigint, integer, string, and UUID column types
  • Smart Detection: Multi-layered soft-delete detection across popular gems
  • Zero Configuration: Automatic Rails integration via Railtie
  • Thread Safety: Built on Rails CurrentAttributes for proper request isolation
  • Performance: Zero overhead when no user is set
  • Flexibility: Manual user management for background jobs and admin actions

Supported Ruby, and Ruby on Rails Versions

  • Rails 7.2+
  • Ruby 3.1+