familia 2.0.0.pre19 → 2.0.0.pre21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4250fd7b94da275c6cfe9ebc7515e14fc6bead4bb25597aa5e433bf6c9368727
-  data.tar.gz: 50818f7fce2464d3a4349d4de6a1fd7992900e45d8774f6d6d40d047d71a1842
+  metadata.gz: 07042bac6b1c1cb48aa4110964f76fcb1bd030b5814d09077e71458528982fc4
+  data.tar.gz: 1cc64f41698963091108f48f45a8af7be8e77473aacae2ccd734175be84f2a45
 SHA512:
-  metadata.gz: bf19202fe2ae0176698fa3ed5b5bd5cb4c1536de2e091a0978d75d8d9964c05cf2285cbcbbdf2d8deb20500a00b83f4fc4d7091e80f08fcaa29840053788da4f
-  data.tar.gz: c7a5810d3c84cca3c8f51e7449d0049c13eae86300f4703b5af9a492329a1a1c6ff01142529351e705f527c4b4f1ad8d07b15e5280b956a3c5a4fa2971ff2b08
+  metadata.gz: 4c2a76ca3e47aff299fcb51ac56fa8b3c6701135921a99228cefe8eb770a8455b0b237849fbd85cb60b8e6bb3d436abe20d7afc384acc6e0e8e7f2ad3ba05d65
+  data.tar.gz: 1c3a6b8ccb9479d701eb98f4b00d700c1e05978d29b0247ce83937471c3ab7a8df515ba1b387ceaf1dc7cfd56f7a8cdabee0b6038093eb5595c69babb6670a27

data/.github/workflows/claude-code-review.yml

@@ -2,13 +2,8 @@ name: Claude Code Review
 
 on:
   pull_request:
-    types: [opened, synchronize]
-    # Optional: Only run on specific file changes
-    # paths:
-    #   - "src/**/*.ts"
-    #   - "src/**/*.tsx"
-    #   - "src/**/*.js"
-    #   - "src/**/*.jsx"
+    types: [opened, synchronize, labeled]
+  workflow_dispatch:
 
 jobs:
   claude-review:
@@ -40,7 +35,7 @@ jobs:
           # Optional: Use sticky comments to make Claude reuse the same comment on subsequent pushes to the same PR
           use_sticky_comment: true
 
-          prompt: |
+          direct_prompt: |
             Please review this pull request and provide feedback on:
             - Code quality and best practices
             - Potential bugs or issues
@@ -54,4 +49,4 @@ jobs:
 
           # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
           # or https://docs.anthropic.com/en/docs/claude-code/sdk#command-line for available options
-          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+          allowed_tools: "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"

data/.github/workflows/code-smells.yml

@@ -1,4 +1,4 @@
-# ..github/workflows/code-smells.yml
+# .github/workflows/code-smells.yml
 ---
 name: Code Smells
 
@@ -14,7 +14,7 @@ permissions:
   pull-requests: write # Needed to post comments on PRs
 
 jobs:
-  reek:
+  reek-analysis:
     name: Reek Code Analysis
     runs-on: ubuntu-24.04
     timeout-minutes: 5
@@ -52,7 +52,7 @@ jobs:
           echo "=== Reek analysis complete ==="
         continue-on-error: true # Don't fail the build on code smells
 
-      - name: Generate Reek report (if analysis available)
+      - name: Generate Reek report
         run: |
           echo "=== Generating detailed Reek report ==="
 
@@ -83,3 +83,64 @@ jobs:
             reek-report.html
           if-no-files-found: ignore
           retention-days: 30
+
+  additional-checks:
+    name: Additional Quality Checks
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4
+          bundler-cache: true
+
+      - name: Configure Bundler for secure gem installation
+        run: |
+          bundle config set --local path 'vendor/bundle'
+          bundle config set --local deployment 'false'
+
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+
+      - name: Check for TODO/FIXME comments
+        run: |
+          echo "=== Scanning for TODO/FIXME comments ==="
+          echo "This helps track technical debt and action items."
+          echo ""
+
+          # Find TODO/FIXME comments (excluding vendor and tmp directories)
+          find . -name "*.rb" -not -path "./vendor/*" -not -path "./tmp/*" | \
+            xargs grep -Hn -i -E "(TODO|FIXME|HACK|XXX|NOTE):" 2>/dev/null | \
+            head -20 || echo "No TODO/FIXME comments found"
+        continue-on-error: true
+
+      - name: Check Ruby file syntax
+        run: |
+          echo "=== Checking Ruby syntax ==="
+          echo "Validates that all Ruby files have correct syntax."
+          echo ""
+
+          find . -name "*.rb" -not -path "./vendor/*" -not -path "./tmp/*" | \
+            while read -r file; do
+              if ! ruby -c "$file" > /dev/null 2>&1; then
+                echo "Syntax error in: $file"
+                ruby -c "$file"
+              fi
+            done
+        continue-on-error: true
+
+      - name: Check for long lines
+        run: |
+          echo "=== Checking for long lines (>120 characters) ==="
+          echo "Identifies potentially hard-to-read code lines."
+          echo ""
+
+          find . -name "*.rb" -not -path "./vendor/*" -not -path "./tmp/*" | \
+            xargs grep -Hn "^.\{121,\}$" | \
+            head -10 || echo "No overly long lines found"
+        continue-on-error: true

data/.pre-commit-config.yaml

@@ -65,13 +65,15 @@ repos:
         env:
           TALISMAN_SCAN_MODE: CI
 
-  - repo: https://github.com/avilaton/add-msg-issue-prefix-hook
-    rev: v0.0.11
+  # Commit message issue tracking integration
+  - repo: https://github.com/delano/add-msg-issue-prefix-hook
+    rev: v0.0.14-fork
     hooks:
       - id: add-msg-issue-prefix
         stages: [prepare-commit-msg]
-        name: Link commit to Github issue
+        description: Automatically prefix commits with issue numbers
         args:
-          - "--default="
-          - "--pattern=[a-zA-Z0-9]{0,10}-?[0-9]{1,5}"
-          - "--template=[#{}]"
+          - '--default='
+          - '--exclude-pattern=^(dependabot|renovate|claude)/'
+          - '--pattern=(i18n(?=/)|([a-zA-Z0-9]{0,10}-?[0-9]{1,5}))'
+          - '--template=[#{}]'

data/.reek.yml

@@ -1,10 +1,11 @@
 # .reek.yml
-# Reek configuration for Familia
+#
+# Reek configuration for Rhales
 #
 # Basic commands:
 #   bundle exec reek                           # Analyze all Ruby files
 #   bundle exec reek lib/                      # Analyze specific directory
-#   bundle exec reek lib/familia/horreum.rb    # Analyze specific file
+#   bundle exec reek lib/rhales.rb             # Analyze specific file
 #   bundle exec reek --help                    # Show all options
 #   bundle exec reek --docs                    # Open documentation
 #
@@ -60,16 +61,16 @@ detectors:
   UncommunicativeParameterName:
     enabled: true
     reject:
-      - '/^.$/' # Single letter names
-      - '/[0-9]$/' # Names ending in numbers
-      - '/^_/' # Names starting with underscore (common Ruby pattern)
+      - "/^.$/" # Single letter names
+      - "/[0-9]$/" # Names ending in numbers
+      - "/^_/" # Names starting with underscore (common Ruby pattern)
     accept: []
 
   UncommunicativeVariableName:
     enabled: true
     reject:
-      - '/^.$/' # Single letter names
-      - '/[0-9]$/' # Names ending in numbers
+      - "/^.$/" # Single letter names
+      - "/[0-9]$/" # Names ending in numbers
     accept:
       - e # Exception variable
       - id # Common identifier
@@ -80,8 +81,8 @@ detectors:
   UncommunicativeMethodName:
     enabled: true
     reject:
-      - '/^.$/' # Single letter method names
-      - '/[0-9]$/' # Methods ending in numbers
+      - "/^.$/" # Single letter method names
+      - "/[0-9]$/" # Methods ending in numbers
     accept:
       - "<<" # Common Ruby operator overload
 

data/.rubocop.yml

@@ -88,6 +88,10 @@ Layout/EndAlignment:
 Layout/FirstArgumentIndentation:
   EnforcedStyle: consistent
 
+Layout/ExtraSpacing:
+  Enabled: true
+  AllowBeforeTrailingComments: true
+
 Metrics/AbcSize:
   Enabled: false
   Max: 20

data/CHANGELOG.rst

@@ -7,61 +7,179 @@ The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.1.0/>`
 
    <!--scriv-insert-here-->
 
-.. _changelog-2.0.0.pre19:
+.. _changelog-2.0.0.pre21:
 
-2.0.0.pre19 — 2025-10-11
-=========================
+2.0.0.pre21 — 2025-10-21
+========================
 
 Added
 -----
 
--  **DataType Transaction and Pipeline Support** - DataType objects can now initiate transactions and pipelines independently, enabling atomic operations and batch command execution for both parent-owned and standalone DataType objects. `PR #160 <https://github.com/familia/familia/pull/160>`__. Key capabilities added:
+- Pipeline Routing Investigation: Created 7 diagnostic testcases in ``try/investigation/pipeline_routing/`` to investigate suspected middleware routing issue. Investigation revealed single-command pipelines don't have ' | ' separator (expected Array#join behavior), confirming no routing bug exists. Full analysis documented in ``CONCLUSION.md``.
+
+Changed
+-------
+
+- **BREAKING**: Duration measurements now use integer microseconds instead of milliseconds. Instrumentation hooks and logging output have changed format:
+
+  - ``Familia.on_command`` receives ``duration`` in microseconds (was ``duration_ms`` in milliseconds)
+  - ``Familia.on_pipeline`` receives ``duration`` in microseconds (was ``duration_ms`` in milliseconds)
+  - ``Familia.on_lifecycle`` uses ``duration`` key in microseconds (was ``duration_ms`` in milliseconds)
+  - Log messages show ``duration=1234`` (microseconds) instead of ``duration_ms=1.23`` (milliseconds)
+
+- Migration: Convert to milliseconds when needed: ``duration / 1000.0``
+
+Fixed
+-----
+
+- Connection Chain Race Condition: Fixed race condition in connection chain initialization where concurrent calls could create multiple instances. Added thread-safe protection to ensure proper singleton behavior.
 
-   * ``transaction`` and ``pipelined`` methods for atomic MULTI/EXEC operations and batched command execution on all DataType classes
-   * Connection chain pattern with Chain of Responsibility for DataType objects
-   * Two new connection handlers: ``ParentDelegationHandler`` for owned DataTypes and ``StandaloneConnectionHandler`` for independent DataTypes
-   * Enhanced ``direct_access`` method with automatic transaction/pipeline context detection
-   * Shared ``Familia::Connection::Behavior`` module extracting common connection functionality
+- Thread Safety Test Suite: Corrected test assertions to properly verify thread safety invariants.
 
--  New error hierarchy with ``PersistenceError``, ``HorreumError``, ``CreationError``, and ``OptimisticLockError`` classes for better error categorization and handling
--  ``watch``, ``unwatch``, and ``discard`` Redis commands for optimistic locking support
--  Enhanced database command logging with structured format for pipelined and transaction operations
--  ``save_fields`` method in Persistence module for selective field updates
+
+AI Assistance
+-------------
+
+- Claude Code assisted with analyzing test failures, identifying and fixing the connection chain race condition with Mutex protection, correcting test assertions to verify proper thread safety invariants, and creating diagnostic testcases to investigate pipeline routing behavior.
+
+
+
+.. _changelog-2.0.0.pre20:
+
+2.0.0.pre20 — 2025-10-20
+========================
+
+Added
+-----
+
+- **Instrumentation Hooks**: New ``Familia::Instrumentation`` module provides hooks for Redis commands, pipeline operations, lifecycle events, and errors. Applications can now register callbacks for audit trails and performance monitoring.
+
+- **DatabaseLogger Structured Mode**: Added ``DatabaseLogger.structured_logging`` mode that outputs Redis commands with structured key=value context instead of formatted string output.
+
+- **DatabaseLogger Sampling**: Added ``DatabaseLogger.sample_rate`` for controlling log volume in high-traffic scenarios. Set to 0.1 for 10% sampling, 0.01 for 1% sampling, or nil to disable. Command capture for testing remains unaffected.
+
+- **Lifecycle Logging**: Horreum initialize, save, and destroy operations now log with timing and structured context when ``FAMILIA_DEBUG`` is enabled.
+
+- **Operational Logging**: TTL operations and serialization errors now include structured context for better debugging.
 
 Changed
 -------
 
--  **Connection Architecture Refactored** - The ``Horreum::Connection`` module now includes ``Familia::Connection::Behavior``, eliminating code duplication by sharing URI normalization and connection creation methods between Horreum and DataType. DataType objects with ``logical_database`` settings now return clean URIs without custom port information (e.g., ``redis://127.0.0.1/3`` instead of ``redis://127.0.0.1:2525/3``), ensuring consistent URI representation across the library.
+- Refactored ``save`` and ``save_if_not_exists!`` to use shared helper methods (``prepare_for_save`` and ``persist_to_storage``) to eliminate code duplication and ensure consistency. Both methods now follow the same preparation and persistence logic, differing only in their concurrency control patterns (simple transaction vs. optimistic locking with WATCH).
 
--  **BREAKING**: Renamed ``Management.create`` to ``create!`` to follow Rails conventions and indicate potential exceptions
--  **BREAKING**: Updated ``save_if_not_exists`` to ``save_if_not_exists!`` with optimistic locking and automatic retry logic (up to 3 attempts)
--  Improved ``save`` method to use single atomic transaction encompassing field updates, expiration setting, index updates, and instance collection management
--  Enhanced ``delete!`` methods to work correctly within Redis transactions
--  Updated timestamp fields (``created``, ``updated``) to use float values instead of integers for higher precision
--  Refined log message formatting for better readability and debugging
--  Removed deprecated Connection instance methods for Horreum models in favor of class-level database operations
--  Clarified "pipelined" terminology throughout codebase (renamed from "pipeline" for consistency with Redis documentation)
+- **Structured Logging**: Replaced internal logging methods (``Familia.ld``, ``Familia.le``) with structured logging methods (``Familia.debug``, ``Familia.info``, ``Familia.error``) that support keyword context for operational observability.
+
+Removed
+-------
+
+- **Internal Methods**: Removed ``Familia.ld`` and ``Familia.le`` internal logging methods. These were never part of the public API.
 
 Fixed
 -----
 
--  Resolved atomicity issues and race conditions in save operations by consolidating all related operations into single Redis transaction with proper watch/multi/exec pattern and optimistic locking
--  Corrected transaction handling to ensure proper cleanup and error propagation
+- Fixed ``save_if_not_exists!`` to perform the same operations as ``save`` when creating new objects. Previously, ``save_if_not_exists!`` omitted timestamp updates (``created``/``updated``), unique index validation (``guard_unique_indexes!``), and adding to the instances collection. Now both methods produce identical results when saving a new object, with ``save_if_not_exists`` only differing in its conditional existence check.
+
+- Fixed ``save_if_not_exists!`` return value to correctly return ``true`` when successfully saving new objects. Previously returned ``false`` despite successful persistence due to incorrect handling of transaction result.
 
 Documentation
 -------------
 
--  Added comprehensive parameter documentation for database command methods including return value specifications and usage examples
+- Streamlined inline documentation for ``save``, ``save_if_not_exists!``, and ``save_if_not_exists`` methods to be more concise, internally consistent, and non-redundant. Each method's documentation now stands on its own with clear, focused descriptions.
 
 AI Assistance
 -------------
 
-This feature was implemented with AI assistance from Claude Sonnet 4.5, Opus 4.1 (Anthropic).
+- Claude Code identified the inconsistencies between ``save`` and ``save_if_not_exists!`` methods, implemented the fixes, refactored both methods to extract shared logic into private helper methods (``prepare_for_save`` and ``persist_to_storage``), and updated the documentation to be more concise and internally consistent.
+
+
+
+This implementation was completed with significant AI assistance from Claude (Anthropic), including:
+
+- Architecture design for the instrumentation hook system
+- Implementation of structured logging methods with backward-compatible signatures
+- Integration of hooks into DatabaseLogger middleware
+- Bulk replacement of 51 logging method calls across 21 files
+- Comprehensive code review and bug fixes (RedisClient::Config object vs hash handling)
+- Documentation and changelog creation
+
+The AI provided discussion, rubber ducking, code generation, testing strategy, and documentation throughout the implementation process.
+
+Developer Notes
+---------------
+
+This is a clean break for v2.0 with no deprecation warnings, as the removed methods were internal-only. Applications using the public API are unaffected.
+
+**Migration**: No action required for external users. Internal development references to ``Familia.ld`` should use ``Familia.debug``, and ``Familia.le`` should use ``Familia.error``.
+
+**New Capabilities**: Applications can now register instrumentation hooks for operational observability:
+
+.. code-block:: ruby
+
+   # Enable structured logging with 10% sampling for production
+   Familia.logger = Rails.logger
+   DatabaseLogger.structured_logging = true
+   DatabaseLogger.sample_rate = 0.1  # Log 10% of commands
+
+   # Register hooks for audit trails
+   Familia.on_command do |cmd, duration_ms, context|
+     AuditLog.create!(
+       event: 'redis_command',
+       command: cmd,
+       duration_ms: duration_ms,
+       user_id: RequestContext.current_user_id
+     )
+   end
+
+   Familia.on_lifecycle do |event, instance, context|
+     case event
+     when :save
+       AuditLog.create!(event: 'object_saved', object_id: instance.identifier)
+     when :destroy
+       AuditLog.create!(event: 'object_destroyed', object_id: instance.identifier)
+     end
+   end
+
+.. _changelog-2.0.0.pre19:
+
+2.0.0.pre19 — 2025-10-13
+========================
+
+Added
+-----
+
+-  **DataType Transaction and Pipeline Support** - DataType objects can now initiate transactions and pipelines independently, enabling atomic operations and batch command execution. `PR #159 <https://github.com/familia/familia/pull/159>`_
+
+   * ``transaction`` and ``pipelined`` methods for all DataType classes
+   * Connection chain pattern with ``ParentDelegationHandler`` and ``StandaloneConnectionHandler``
+   * Enhanced ``direct_access`` method with automatic context detection
+   * Shared ``Familia::Connection::Behavior`` module for common functionality
+
+-  **Automatic Unique Index Validation** - Instance-scoped unique indexes now validate automatically in ``add_to_*`` methods, with transaction detection to prevent ``save()`` calls within MULTI/EXEC blocks
+
+Changed
+-------
+
+-  **Connection Architecture** - Refactored to share ``Familia::Connection::Behavior`` between Horreum and DataType, with cleaner URI construction for logical databases
+
+-  **Indexing Terminology** - Renamed internal ``target_class`` to ``scope_class`` throughout to clarify semantic role. Added explicit ``:within`` field to IndexingRelationship for clearer instance-scoped index handling
+
+Fixed
+-----
+
+-  URI formatting for DataType objects with logical database settings
+-  Transaction detection and validation flow for unique index operations
+
+Documentation
+-------------
+
+-  Enhanced ``save()`` method documentation with transaction restrictions
+-  Updated indexing and relationship cheatsheets with improved terminology
+-  Added comprehensive test coverage (48 new tests) for transactions, pipelines, and validation
+
+AI Assistance
+-------------
 
-* Architectural design of the connection chain pattern and shared Behavior module
-* Implementation of DataType-specific connection handlers  (ParentDelegationHandler, StandaloneConnectionHandler) and comprehensive test coverage
-* Error hierarchy design and transaction atomicity optimization
-* Documentation enhancement and URI formatting debugging
+This release was implemented with assistance from Claude (Anthropic) for architectural design, test coverage, and systematic refactoring of terminology across the codebase.
 
 
 .. _changelog-2.0.0.pre18:
@@ -118,7 +236,7 @@ Documentation
 AI Assistance
 -------------
 
-- Claude Code (claude-sonnet-4-5) provided implementation guidance, identified the ``initialize_with_keyword_args`` falsy value bug, wrote comprehensive test suite, and coordinated multi-file changes across serialization, management, and base modules.
+- Claude Code (claude-sonnet-4-5) provided implementation guidance, identified the ``initialize_with_keyword_args`` falsy value bug, wrote test coverage, and coordinated multi-file changes across serialization, management, and base modules.
 
 - Issue analysis, implementation guidance, test verification, and documentation for JSON serialization changes and encrypted field security fix.
 
@@ -132,19 +250,17 @@ AI Assistance
 Added
 -----
 
-- **SortedSet#add**: Full ZADD option support (NX, XX, GT, LT, CH) for atomic conditional operations and accurate change tracking. This enables proper index management with timestamp preservation, update-only operations, conditional score updates, and analytics tracking. Closes issue #135.
+- **SortedSet#add** - Full ZADD option support (NX, XX, GT, LT, CH) for atomic conditional operations and accurate change tracking. Closes #135
 
 Fixed
 -----
 
-- Restored objid provenance tracking when loading objects from Redis. The ``ObjectIdentifier`` feature now infers the generator type (:uuid_v7, :uuid_v4, :hex) from the objid format, enabling dependent features like ``ExternalIdentifier`` to derive external identifiers from loaded objects. PR #131
+- Restored objid provenance tracking when loading objects from Redis, enabling dependent features to derive external identifiers. PR #131
 
 AI Assistance
 -------------
 
-- Claude Code assisted with implementing the ``infer_objid_generator`` method and updating the setter logic in ``lib/familia/features/object_identifier.rb``.
-
-- Claude Code assisted with Redis ZADD option semantics research, mutual exclusivity validation design, comprehensive test case matrix creation (50+ test cases), and YAML documentation examples.
+- Claude (Anthropic) assisted with objid generator inference implementation and ZADD option validation design.
 
 .. _changelog-2.0.0.pre16:
 
@@ -154,57 +270,29 @@ AI Assistance
 Added
 -----
 
-- Added support for instance-scoped unique indexes via ``unique_index`` with ``within:`` parameter. Issue #128
-
-  Example: ``unique_index :badge_number, :badge_index, within: Company`` creates per-company unique badge lookups using HashKey DataType.
+- **Instance-scoped unique indexes** via ``unique_index`` with ``within:`` parameter for per-scope unique lookups. Issue #128
 
 Changed
 -------
 
-- **BREAKING**: Consolidated relationships API by replacing ``tracked_in`` and ``member_of`` with unified ``participates_in`` method. PR #110
-- **BREAKING**: Renamed ``context_class`` terminology to ``target_class`` throughout relationships module for clarity
-- **BREAKING**: Removed ``tracking.rb`` and ``membership.rb`` modules, merged functionality into ``participation.rb``
-- **BREAKING**: Updated method names and configuration keys to use ``target`` instead of ``context`` terminology
-- Added ``bidirectional`` parameter to ``participates_in`` to control generation of convenience methods (default: true)
-- Added support for different collection types (sorted_set, set, list) in unified ``participates_in`` API
-- Renamed ``class_tracked_in`` to ``class_participates_in`` for consistency
-
-- Renamed DataType classes to avoid Ruby namespace confusion: ``Familia::String`` → ``Familia::StringKey``, ``Familia::List`` → ``Familia::ListKey``
-- Added dual registration for both traditional and explicit method names (``string``/``stringkey``, ``list``/``listkey``)
-- Updated ``Counter`` and ``Lock`` to inherit from ``StringKey`` instead of ``String``
-
-- **BREAKING:** Renamed indexing API methods for clarity. Issue #128
+- **BREAKING**: Consolidated relationships API - replaced ``tracked_in`` and ``member_of`` with unified ``participates_in`` method. PR #110
 
-  - ``class_indexed_by`` → ``unique_index`` (1:1 field-to-object mapping via HashKey)
-  - ``indexed_by`` → ``multi_index`` (1:many field-to-objects mapping via UnsortedSet)
-  - Parameter ``target:`` → ``within:`` for consistency across both index types
+- **BREAKING**: Renamed indexing API methods for clarity. Issue #128
+  - ``class_indexed_by`` → ``unique_index``
+  - ``indexed_by`` → ``multi_index``
+  - Changed ``multi_index`` to use ``UnsortedSet`` instead of ``SortedSet``
 
-- **BREAKING:** Changed ``multi_index`` to use ``UnsortedSet`` instead of ``SortedSet``. Issue #128
-
-  Multi-value indexes no longer include temporal scoring. This aligns with the design philosophy that indexing is for finding objects by attribute, not ordering them. Sort results in Ruby when needed: ``employees.sort_by(&:hire_date)``
+- **DataType class renaming** to avoid Ruby namespace conflicts: ``Familia::String`` → ``Familia::StringKey``, ``Familia::List`` → ``Familia::ListKey``, etc., with dual registration for compatibility
 
 Documentation
 -------------
 
-- Updated overview documentation to explain dual naming system and namespace safety benefits
-- Enhanced examples to demonstrate both traditional and explicit DataType method naming
-
-- Updated inline module documentation
-    - ``Familia::Features::Relationships::Indexing`` with comprehensive examples, terminology guide, and design philosophy.
-    - ``Familia::Features::Relationships::Participation`` to clarify differences from indexing module.
+- Updated indexing and participation module documentation with comprehensive examples and design philosophy
 
 AI Assistance
 -------------
 
-- Comprehensive analysis of existing ``tracked_in`` and ``member_of`` implementations
-- Design and implementation of unified ``participates_in`` API integrating both functionalities
-- Systematic refactoring of codebase terminology from context to target
-- Complete test suite updates to verify API consolidation and new functionality
-
-- DataType class renaming and dual registration system implementation designed and developed with Claude Code assistance
-- All test updates and documentation enhancements created with AI support
-
-- Architecture design, implementation, test updates, and documentation for indexing API refactoring completed with Claude Code assistance. Issue #128
+- Claude (Anthropic) assisted with relationship API consolidation, DataType renaming, and indexing API refactoring.
 
 .. _changelog-2.0.0.pre14:
 
@@ -214,19 +302,18 @@ AI Assistance
 Changed
 -------
 
-- **BREAKING CHANGE**: Renamed ``Familia::Refinements::TimeUtils`` to ``Familia::Refinements::TimeLiterals`` to better reflect the module's primary purpose of enabling numeric and string values to be treated as time unit literals (e.g., ``5.minutes``, ``"30m".in_seconds``). Functionality remains the same - only the module name has changed. Users must update their refinement usage from ``using Familia::Refinements::TimeUtils`` to ``using Familia::Refinements::TimeLiterals``.
+- **BREAKING**: Renamed ``TimeUtils`` to ``TimeLiterals`` to better reflect module purpose. PR #100
 
 Fixed
 -----
 
-- Fixed ExternalIdentifier HashKey method calls by replacing incorrect ``.del()`` calls with ``.remove_field()`` in three critical locations: extid setter (cleanup old mapping when changing value), find_by_extid (cleanup orphaned mapping when object not found), and destroy! (cleanup mapping when object is destroyed). Added comprehensive test coverage for all scenarios to prevent regression. PR #100
+- **CRITICAL**: Fixed Redis connection persistence for standalone DataType objects. PR #107
+- Fixed ExternalIdentifier HashKey cleanup using correct ``remove_field()`` method. PR #100
 
 AI Assistance
 -------------
 
-- Claude Code helped rename TimeUtils to TimeLiterals throughout the codebase, including module name, file path, all usage references, and updating existing documentation.
-- Gemini 2.5 Flash wrote the inline docs for TimeLiterals based on a discussion re: naming rationale.
-- Claude Code fixed the ExternalIdentifier HashKey method bug, replacing incorrect ``.del()`` calls with proper ``.remove_field()`` calls, and implemented test coverage for the affected scenarios.
+- Claude (Anthropic) and Gemini assisted with TimeLiterals refactoring and ExternalIdentifier fixes.
 
 .. _changelog-2.0.0.pre13:
 
@@ -236,61 +323,39 @@ AI Assistance
 Added
 -----
 
-- **Feature Autoloading System**: Features can now automatically discover and load extension files from your project directories. When you include a feature like ``safe_dump``, Familia searches for configuration files using conventional patterns like ``{model_name}/{feature_name}_*.rb``, enabling clean separation between core model definitions and feature-specific configurations. See ``docs/migrating/v2.0.0-pre13.md`` for migration details.
-
-- **Consolidated autoloader architecture**: Introduced ``Familia::Features::Autoloader`` as a shared utility for consistent file loading patterns across the framework, supporting both general-purpose and feature-specific autoloading scenarios.
+- **Feature Autoloading System** - Features automatically discover and load extension files from project directories using conventional patterns. PR #97
 
-- Added ``PER_MONTH`` constant (2,629,746 seconds = 30.437 days) derived from Gregorian year for consistent month calculations.
-- Added ``months``, ``month``, and ``in_months`` conversion methods to Numeric refinement.
-- Added month unit mappings (``'mo'``, ``'month'``, ``'months'``) to TimeLiterals ``UNIT_METHODS`` hash.
-
-- **Error Handling**: Added ``NotSupportedError`` for invalid serialization mode combinations in encryption subsystem. PR #97
+- **Month calculations** - Added ``PER_MONTH`` constant and month conversion methods to TimeLiterals refinement. Issue #94
 
 Changed
 -------
 
-- Refactored time and numeric extensions from global monkey patches to proper Ruby refinements for better encapsulation and reduced global namespace pollution
-- Updated all internal classes to use refinements via ``using Familia::Refinements::TimeLiterals`` statements
-- Added centralized ``RefinedContext`` module in test helpers to support refinement testing in tryouts files
-
-- Updated ``PER_YEAR`` constant to use Gregorian year (31,556,952 seconds = 365.2425 days) for calendar consistency.
-
-- **Performance**: Replaced stdlib JSON with OJ gem for 2-5x faster JSON operations and reduced memory allocation. All existing code remains compatible through mimic_JSON mode. PR #97
-
-- **Encryption**: Enhanced serialization safety for encrypted fields with improved ConcealedString handling across different JSON processing modes. Strengthened protection against accidental data exposure during serialization. PR #97
+- **Performance** - Replaced stdlib JSON with OJ gem for 2-5x faster operations. PR #97
+- Refactored time/numeric extensions from global monkey patches to Ruby refinements
+- Enhanced encryption serialization safety with improved ConcealedString handling
 
 Fixed
 -----
 
-- Fixed byte conversion logic in ``to_bytes`` method to correctly handle exact 1024-byte boundaries (``size >= 1024`` instead of ``size > 1024``)
-- Resolved refinement testing issues in tryouts by implementing ``eval``-based code execution within refined contexts
-
-- Fixed TimeLiterals refinement ``months_old`` and ``years_old`` methods returning incorrect values (raw seconds instead of months/years). The underlying ``age_in`` method now properly handles ``:months`` and ``:years`` units. Issue #94.
-- Fixed calendar consistency issue where ``12.months != 1.year`` by updating ``PER_YEAR`` to use Gregorian year (365.2425 days) and defining ``PER_MONTH`` as ``PER_YEAR / 12``.
+- Fixed ``months_old`` and ``years_old`` methods returning raw seconds instead of proper units. Issue #94
+- Fixed byte conversion boundary logic (``size >= 1024`` instead of ``size > 1024``)
+- Fixed calendar consistency where ``12.months != 1.year`` by using Gregorian year
 
 Security
 --------
 
-- **Encryption**: Improved concealed value protection during JSON serialization, ensuring encrypted data remains properly protected across all OJ serialization modes. PR #97
+- Improved concealed value protection during JSON serialization across all OJ modes. PR #97
 
 Documentation
 -------------
 
-- **Feature System Autoloading Guide**: Added comprehensive guide at ``docs/guides/Feature-System-Autoloading.md`` explaining the new autoloading system, including file naming conventions, directory patterns, and usage examples.
-- **Enhanced API documentation**: Added detailed YARD documentation for autoloading modules and methods.
+- Added Feature System Autoloading guide with conventions and usage examples
+- Enhanced YARD documentation for autoloading modules
 
 AI Assistance
 -------------
 
-- Provided comprehensive analysis of Ruby refinement scoping issues and designed the eval-based testing solution
-- Assisted with refactoring global extensions to proper refinements while maintaining backward compatibility
-- Helped debug and fix the byte conversion boundary condition bug
-
-- Significant AI assistance in architectural design and implementation of the feature-specific autoloading system, including pattern matching logic, Ruby introspection methods, and comprehensive debugging of edge cases and thread safety considerations.
-
-- Claude Code assisted with implementing the fix for broken ``months_old`` and ``years_old`` methods in the TimeLiterals refinement, including analysis, implementation, testing, and documentation.
-
-- Performance optimization research and OJ gem integration strategy, including compatibility analysis and testing approach for seamless stdlib JSON replacement. PR #97
+- Claude (Anthropic) assisted with refinement refactoring, autoloading system design, and OJ integration.
 
 2.0.0.pre12 — 2025-09-04
 ========================