RubyGems - familia - Versions diffs - 2.0.0.pre14 → 2.0.0.pre16 - Mend

familia 2.0.0.pre14 → 2.0.0.pre16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (276) hide show

checksums.yaml +4 -4
data/.github/workflows/code-quality.yml +138 -0
data/.github/workflows/code-smellage.yml +145 -0
data/.github/workflows/docs.yml +31 -8
data/.gitignore +1 -1
data/.pre-commit-config.yaml +7 -1
data/.reek.yml +98 -0
data/.rubocop.yml +48 -10
data/.talismanrc +9 -0
data/.yardopts +18 -13
data/CHANGELOG.rst +66 -6
data/CLAUDE.md +1 -1
data/Gemfile +6 -5
data/Gemfile.lock +99 -23
data/LICENSE.txt +1 -1
data/README.md +285 -85
data/changelog.d/README.md +2 -2
data/docs/archive/FAMILIA_RELATIONSHIPS.md +22 -22
data/docs/archive/FAMILIA_TECHNICAL.md +41 -41
data/docs/archive/FAMILIA_UPDATE.md +3 -3
data/docs/archive/README.md +3 -2
data/docs/{guides/API-Reference.md → archive/api-reference.md} +87 -101
data/docs/conf.py +29 -0
data/docs/guides/{Field-System-Guide.md → core-field-system.md} +9 -9
data/docs/guides/feature-encrypted-fields.md +785 -0
data/docs/guides/{Expiration-Feature-Guide.md → feature-expiration.md} +11 -2
data/docs/guides/feature-external-identifiers.md +637 -0
data/docs/guides/feature-object-identifiers.md +435 -0
data/docs/guides/{Quantization-Feature-Guide.md → feature-quantization.md} +94 -29
data/docs/guides/feature-relationships-methods.md +684 -0
data/docs/guides/feature-relationships.md +200 -0
data/docs/guides/{Features-System-Developer-Guide.md → feature-system-devs.md} +4 -4
data/docs/guides/{Feature-System-Guide.md → feature-system.md} +5 -5
data/docs/guides/{Transient-Fields-Guide.md → feature-transient-fields.md} +2 -2
data/docs/guides/{Implementation-Guide.md → implementation.md} +3 -3
data/docs/guides/index.md +176 -0
data/docs/guides/{Security-Model.md → security-model.md} +1 -1
data/docs/migrating/v2.0.0-pre.md +1 -1
data/docs/migrating/v2.0.0-pre11.md +4 -4
data/docs/migrating/v2.0.0-pre12.md +2 -2
data/docs/migrating/v2.0.0-pre13.md +1 -1
data/docs/migrating/v2.0.0-pre5.md +33 -12
data/docs/migrating/v2.0.0-pre6.md +2 -2
data/docs/migrating/v2.0.0-pre7.md +8 -8
data/docs/overview.md +623 -19
data/docs/reference/api-technical.md +1365 -0
data/examples/autoloader/mega_customer/features/deprecated_fields.rb +7 -0
data/examples/autoloader/mega_customer/safe_dump_fields.rb +1 -1
data/examples/autoloader/mega_customer.rb +3 -1
data/examples/encrypted_fields.rb +378 -0
data/examples/json_usage_patterns.rb +144 -0
data/examples/relationships.rb +13 -13
data/examples/safe_dump.rb +6 -6
data/examples/single_connection_transaction_confusions.rb +379 -0
data/lib/familia/base.rb +49 -10
data/lib/familia/connection/handlers.rb +223 -0
data/lib/familia/connection/individual_command_proxy.rb +64 -0
data/lib/familia/connection/middleware.rb +75 -0
data/lib/familia/connection/operation_core.rb +93 -0
data/lib/familia/connection/operations.rb +277 -0
data/lib/familia/connection/pipeline_core.rb +87 -0
data/lib/familia/connection/transaction_core.rb +100 -0
data/lib/familia/connection.rb +60 -186
data/lib/familia/data_type/commands.rb +53 -51
data/lib/familia/data_type/serialization.rb +108 -107
data/lib/familia/data_type/types/counter.rb +1 -1
data/lib/familia/data_type/types/hashkey.rb +13 -10
data/lib/familia/data_type/types/{list.rb → listkey.rb} +13 -5
data/lib/familia/data_type/types/lock.rb +3 -2
data/lib/familia/data_type/types/sorted_set.rb +26 -15
data/lib/familia/data_type/types/{string.rb → stringkey.rb} +7 -5
data/lib/familia/data_type/types/unsorted_set.rb +20 -27
data/lib/familia/data_type.rb +75 -47
data/lib/familia/distinguisher.rb +85 -0
data/lib/familia/encryption/encrypted_data.rb +15 -24
data/lib/familia/encryption/manager.rb +6 -4
data/lib/familia/encryption/providers/aes_gcm_provider.rb +1 -1
data/lib/familia/encryption/providers/secure_xchacha20_poly1305_provider.rb +7 -9
data/lib/familia/encryption/providers/xchacha20_poly1305_provider.rb +4 -5
data/lib/familia/encryption/request_cache.rb +7 -7
data/lib/familia/encryption.rb +2 -3
data/lib/familia/errors.rb +9 -3
data/lib/familia/{autoloader.rb → features/autoloader.rb} +49 -23
data/lib/familia/features/encrypted_fields/concealed_string.rb +3 -4
data/lib/familia/features/encrypted_fields/encrypted_field_type.rb +13 -14
data/lib/familia/features/encrypted_fields.rb +68 -66
data/lib/familia/features/expiration/extensions.rb +61 -0
data/lib/familia/features/expiration.rb +35 -87
data/lib/familia/features/external_identifier.rb +11 -12
data/lib/familia/features/object_identifier.rb +58 -20
data/lib/familia/features/quantization.rb +17 -22
data/lib/familia/features/relationships/README.md +97 -0
data/lib/familia/features/relationships/collection_operations.rb +104 -0
data/lib/familia/features/relationships/indexing/multi_index_generators.rb +202 -0
data/lib/familia/features/relationships/indexing/unique_index_generators.rb +301 -0
data/lib/familia/features/relationships/indexing.rb +176 -256
data/lib/familia/features/relationships/indexing_relationship.rb +35 -0
data/lib/familia/features/relationships/participation/participant_methods.rb +160 -0
data/lib/familia/features/relationships/participation/target_methods.rb +225 -0
data/lib/familia/features/relationships/participation.rb +656 -0
data/lib/familia/features/relationships/participation_relationship.rb +31 -0
data/lib/familia/features/relationships/score_encoding.rb +20 -20
data/lib/familia/features/relationships.rb +69 -271
data/lib/familia/features/safe_dump.rb +127 -132
data/lib/familia/features/transient_fields/redacted_string.rb +6 -6
data/lib/familia/features/transient_fields/transient_field_type.rb +5 -5
data/lib/familia/features/transient_fields.rb +5 -5
data/lib/familia/features.rb +21 -21
data/lib/familia/field_type.rb +24 -4
data/lib/familia/horreum/core/connection.rb +229 -26
data/lib/familia/horreum/core/database_commands.rb +27 -17
data/lib/familia/horreum/core/serialization.rb +40 -20
data/lib/familia/horreum/core/utils.rb +2 -1
data/lib/familia/horreum/shared/settings.rb +2 -1
data/lib/familia/horreum/subclass/definition.rb +33 -45
data/lib/familia/horreum/subclass/management.rb +72 -24
data/lib/familia/horreum/subclass/related_fields_management.rb +82 -21
data/lib/familia/horreum.rb +196 -114
data/lib/familia/json_serializer.rb +0 -1
data/lib/familia/logging.rb +11 -114
data/lib/familia/refinements/dear_json.rb +122 -0
data/lib/familia/refinements/logger_trace.rb +20 -17
data/lib/familia/refinements/stylize_words.rb +65 -0
data/lib/familia/refinements/time_literals.rb +60 -52
data/lib/familia/refinements.rb +2 -1
data/lib/familia/secure_identifier.rb +60 -28
data/lib/familia/settings.rb +83 -7
data/lib/familia/utils.rb +5 -87
data/lib/familia/verifiable_identifier.rb +4 -4
data/lib/familia/version.rb +1 -1
data/lib/familia.rb +72 -15
data/lib/middleware/database_middleware.rb +56 -14
data/lib/{familia/multi_result.rb → multi_result.rb} +23 -16
data/try/configuration/scenarios_try.rb +1 -1
data/try/connection/fiber_context_preservation_try.rb +250 -0
data/try/connection/handler_constraints_try.rb +59 -0
data/try/connection/operation_mode_guards_try.rb +208 -0
data/try/connection/pipeline_fallback_integration_try.rb +128 -0
data/try/connection/responsibility_chain_tracking_try.rb +72 -0
data/try/connection/transaction_fallback_integration_try.rb +288 -0
data/try/connection/transaction_mode_permissive_try.rb +153 -0
data/try/connection/transaction_mode_strict_try.rb +98 -0
data/try/connection/transaction_mode_warn_try.rb +131 -0
data/try/connection/transaction_modes_try.rb +249 -0
data/try/core/autoloader_try.rb +129 -11
data/try/core/connection_try.rb +7 -7
data/try/core/conventional_inheritance_try.rb +130 -0
data/try/core/create_method_try.rb +15 -23
data/try/core/database_consistency_try.rb +10 -10
data/try/core/errors_try.rb +8 -11
data/try/core/familia_extended_try.rb +2 -2
data/try/core/familia_members_methods_try.rb +76 -0
data/try/core/isolated_dbclient_try.rb +165 -0
data/try/core/middleware_try.rb +16 -16
data/try/core/persistence_operations_try.rb +4 -4
data/try/core/pools_try.rb +42 -26
data/try/core/secure_identifier_try.rb +28 -24
data/try/core/time_utils_try.rb +10 -10
data/try/core/tools_try.rb +1 -1
data/try/core/utils_try.rb +2 -2
data/try/data_types/boolean_try.rb +4 -4
data/try/data_types/datatype_base_try.rb +0 -2
data/try/data_types/list_try.rb +10 -10
data/try/data_types/sorted_set_try.rb +5 -5
data/try/data_types/string_try.rb +12 -12
data/try/data_types/unsortedset_try.rb +33 -0
data/try/debugging/cache_behavior_tracer.rb +7 -7
data/try/debugging/debug_aad_process.rb +1 -1
data/try/debugging/debug_concealed_internal.rb +1 -1
data/try/debugging/debug_cross_context.rb +1 -1
data/try/debugging/debug_fresh_cross_context.rb +1 -1
data/try/debugging/encryption_method_tracer.rb +10 -10
data/try/edge_cases/hash_symbolization_try.rb +1 -1
data/try/edge_cases/ttl_side_effects_try.rb +1 -1
data/try/encryption/config_persistence_try.rb +2 -2
data/try/encryption/encryption_core_try.rb +19 -19
data/try/encryption/instance_variable_scope_try.rb +1 -1
data/try/encryption/module_loading_try.rb +2 -2
data/try/encryption/providers/aes_gcm_provider_try.rb +1 -1
data/try/encryption/providers/xchacha20_poly1305_provider_try.rb +1 -1
data/try/encryption/secure_memory_handling_try.rb +1 -1
data/try/features/encrypted_fields/concealed_string_core_try.rb +11 -7
data/try/features/encrypted_fields/encrypted_fields_core_try.rb +1 -1
data/try/features/encrypted_fields/encrypted_fields_integration_try.rb +3 -3
data/try/features/encrypted_fields/encrypted_fields_no_cache_security_try.rb +10 -10
data/try/features/encrypted_fields/encrypted_fields_security_try.rb +14 -14
data/try/features/encrypted_fields/error_conditions_try.rb +7 -7
data/try/features/encrypted_fields/fresh_key_try.rb +1 -1
data/try/features/encrypted_fields/nonce_uniqueness_try.rb +1 -1
data/try/features/encrypted_fields/secure_by_default_behavior_try.rb +7 -7
data/try/features/encrypted_fields/universal_serialization_safety_try.rb +13 -20
data/try/features/external_identifier/external_identifier_try.rb +1 -1
data/try/features/feature_dependencies_try.rb +3 -3
data/try/features/object_identifier/object_identifier_integration_try.rb +28 -34
data/try/features/object_identifier/object_identifier_try.rb +10 -0
data/try/features/quantization/quantization_try.rb +1 -1
data/try/features/relationships/indexing_commands_verification_try.rb +136 -0
data/try/features/relationships/indexing_try.rb +433 -0
data/try/features/relationships/participation_commands_verification_spec.rb +102 -0
data/try/features/relationships/participation_commands_verification_try.rb +105 -0
data/try/features/relationships/participation_performance_improvements_try.rb +124 -0
data/try/features/relationships/participation_reverse_index_try.rb +196 -0
data/try/features/relationships/relationships_api_changes_try.rb +72 -71
data/try/features/relationships/relationships_edge_cases_try.rb +15 -18
data/try/features/relationships/relationships_performance_minimal_try.rb +2 -2
data/try/features/relationships/relationships_performance_simple_try.rb +8 -8
data/try/features/relationships/relationships_performance_try.rb +20 -20
data/try/features/relationships/relationships_try.rb +27 -38
data/try/features/safe_dump/safe_dump_advanced_try.rb +2 -2
data/try/features/transient_fields/refresh_reset_try.rb +1 -1
data/try/features/transient_fields/simple_refresh_test.rb +1 -1
data/try/helpers/test_cleanup.rb +86 -0
data/try/helpers/test_helpers.rb +3 -3
data/try/horreum/base_try.rb +3 -2
data/try/horreum/commands_try.rb +1 -1
data/try/horreum/destroy_related_fields_cleanup_try.rb +330 -0
data/try/horreum/initialization_try.rb +11 -7
data/try/horreum/relations_try.rb +21 -13
data/try/horreum/serialization_try.rb +12 -11
data/try/integration/cross_component_try.rb +3 -3
data/try/memory/memory_basic_test.rb +1 -1
data/try/memory/memory_docker_ruby_dump.sh +1 -1
data/try/models/customer_safe_dump_try.rb +1 -1
data/try/models/customer_try.rb +8 -10
data/try/models/datatype_base_try.rb +3 -3
data/try/models/familia_object_try.rb +9 -8
data/try/performance/benchmarks_try.rb +2 -2
data/try/prototypes/atomic_saves_v1_context_proxy.rb +2 -2
data/try/prototypes/atomic_saves_v3_connection_pool.rb +3 -3
data/try/prototypes/atomic_saves_v4.rb +1 -1
data/try/prototypes/lib/atomic_saves_v2_connection_switching_helpers.rb +4 -4
data/try/prototypes/lib/atomic_saves_v3_connection_pool_helpers.rb +4 -4
data/try/prototypes/pooling/lib/atomic_saves_v3_connection_pool_helpers.rb +4 -4
data/try/prototypes/pooling/lib/connection_pool_metrics.rb +5 -5
data/try/prototypes/pooling/lib/connection_pool_stress_test.rb +26 -26
data/try/prototypes/pooling/lib/connection_pool_threading_models.rb +7 -7
data/try/prototypes/pooling/lib/visualize_stress_results.rb +1 -1
data/try/prototypes/pooling/pool_siege.rb +11 -11
data/try/prototypes/pooling/run_stress_tests.rb +7 -7
data/try/refinements/dear_json_array_methods_try.rb +53 -0
data/try/refinements/dear_json_hash_methods_try.rb +54 -0
data/try/refinements/logger_trace_methods_try.rb +44 -0
data/try/refinements/time_literals_numeric_methods_try.rb +141 -0
data/try/refinements/time_literals_string_methods_try.rb +80 -0
metadata +77 -45
data/.rubocop_todo.yml +0 -208
data/docs/connection_pooling.md +0 -192
data/docs/guides/Connection-Pooling-Guide.md +0 -437
data/docs/guides/Encrypted-Fields-Overview.md +0 -101
data/docs/guides/Feature-System-Autoloading.md +0 -228
data/docs/guides/Home.md +0 -116
data/docs/guides/Relationships-Guide.md +0 -737
data/docs/guides/relationships-methods.md +0 -266
data/docs/reference/auditing_database_commands.rb +0 -228
data/examples/permissions.rb +0 -240
data/lib/familia/features/autoloadable.rb +0 -113
data/lib/familia/features/relationships/cascading.rb +0 -437
data/lib/familia/features/relationships/membership.rb +0 -497
data/lib/familia/features/relationships/permission_management.rb +0 -264
data/lib/familia/features/relationships/querying.rb +0 -615
data/lib/familia/features/relationships/redis_operations.rb +0 -274
data/lib/familia/features/relationships/tracking.rb +0 -418
data/lib/familia/refinements/snake_case.rb +0 -40
data/lib/familia/validation/command_recorder.rb +0 -336
data/lib/familia/validation/expectations.rb +0 -519
data/lib/familia/validation/validation_helpers.rb +0 -443
data/lib/familia/validation/validator.rb +0 -412
data/lib/familia/validation.rb +0 -140
data/try/data_types/set_try.rb +0 -33
data/try/features/autoloadable/autoloadable_try.rb +0 -61
data/try/features/relationships/categorical_permissions_try.rb +0 -515
data/try/features/safe_dump/safe_dump_autoloading_try.rb +0 -111
data/try/validation/atomic_operations_try.rb.disabled +0 -320
data/try/validation/command_validation_try.rb.disabled +0 -207
data/try/validation/performance_validation_try.rb.disabled +0 -324
data/try/validation/real_world_scenarios_try.rb.disabled +0 -390

data/CHANGELOG.rst CHANGED Viewed

@@ -12,6 +12,66 @@ Versioning <https://semver.org/spec/v2.0.0.html>`__.
    <!--scriv-insert-here-->
+.. _changelog-2.0.0.pre16:
+2.0.0.pre16 — 2025-09-30
+========================
+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.
+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
+  - ``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:** 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)``
+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.
+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
 .. _changelog-2.0.0.pre14:
 2.0.0.pre14 — 2025-09-08
@@ -44,7 +104,7 @@ 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::Autoloader`` as a shared utility for consistent file loading patterns across the framework, supporting both general-purpose and feature-specific autoloading scenarios.
+- **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.
 - 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.
@@ -183,7 +243,7 @@ Added
    with ancestry chain traversal for model-specific feature
    registration. This enables better organization, standardized naming,
    and automatic loading of project-specific features via the new
-   ``Familia::Autoloader`` module.
+   ``Familia::Features::Autoloader`` module.
 -  **Improved SafeDump DSL**: Replaced the internal
    ``@safe_dump_fields`` implementation with a cleaner, more robust DSL
    using ``safe_dump_field`` and ``safe_dump_fields`` methods.
@@ -293,7 +353,7 @@ Fixed
    (e.g., ``find_by_email``) would fail to correctly instantiate objects
    from the index, returning partially-formed objects.
--  Refactored connection handling to properly cache and reuse Redis
+-  Refactored connection handling to properly cache and reuse Valkey/Redis
    connections. This eliminates repetitive “Overriding existing
    connection” warnings and improves performance.
@@ -342,9 +402,9 @@ Changed
 -  **BREAKING**: ``tracked_in :global, collection`` syntax now raises
    ArgumentError - use ``class_tracked_in collection`` instead
--  **BREAKING**: ``indexed_by field, index, context: :global`` syntax
+-  **BREAKING**: ``indexed_by field, index, target: :global`` syntax
    replaced with ``class_indexed_by field, index``
--  **BREAKING**: ``indexed_by field, index, context: SomeClass`` syntax
+-  **BREAKING**: ``indexed_by field, index, target: SomeClass`` syntax
    replaced with ``indexed_by field, index, parent: SomeClass``
 -  Relationships API now provides consistent parameter naming across all
    relationship types
@@ -498,7 +558,7 @@ Added
 ~~~~~
 -  Complete API redesign for clarity and modern Ruby conventions
--  Valkey compatibility alongside traditional Redis support
+-  Valkey compatibility alongside traditional Valkey/Redis support
 -  Ruby 3.4+ modernization with fiber and thread safety improvements
 -  Connection pooling foundation with provider pattern architecture

data/CLAUDE.md CHANGED Viewed

@@ -75,7 +75,7 @@ Add changelog fragment with each user-facing or documented change (optional but
 2. **`Familia::DataType`** - Base class for Valkey data type wrappers
    - Located in `lib/familia/data_type.rb`
-   - Provides String, List, Set, SortedSet, HashKey implementations
+   - Provides String, List, UnsortedSet, SortedSet, HashKey implementations
    - Each type has its own class in `lib/familia/data_type/types/`
 3. **`Familia::Base`** - Common module for both Horreum and DataType

data/Gemfile CHANGED Viewed

@@ -5,21 +5,22 @@ source 'https://rubygems.org'
 gemspec
 group :test do
-  gem 'tryouts', '~> 3.6.0', require: false
   gem 'concurrent-ruby', '~> 1.3.5', require: false
   gem 'ruby-prof'
   gem 'stackprof'
+  gem 'timecop', require: false
+  gem 'tryouts', '~> 3.6.0', require: false
 end
 group :development, :test do
-  # byebug only works with MRI
-  gem 'byebug', '~> 11.0', require: false if RUBY_ENGINE == 'ruby'
+  gem 'debug', require: false
   gem 'irb', '~> 1.15.2', require: false
-  gem 'kramdown', require: false # Required for YARD markdown processing
-  gem 'pry-byebug', '~> 3.10.1', require: false if RUBY_ENGINE == 'ruby'
+  gem 'redcarpet', require: false
+  gem 'reek', require: false
   gem 'rubocop', require: false
   gem 'rubocop-performance', require: false
   gem 'rubocop-thread_safety', require: false
+  gem 'solargraph', require: false
   gem 'yard', '~> 0.9', require: false
 end

data/Gemfile.lock CHANGED Viewed

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    familia (2.0.0.pre14)
+    familia (2.0.0.pre16)
       benchmark (~> 0.4)
       connection_pool (~> 2.5)
       csv (~> 3.3)
@@ -15,16 +15,47 @@ GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
+    backport (1.2.0)
     base64 (0.3.0)
     benchmark (0.4.1)
     bigdecimal (3.2.3)
-    byebug (11.1.3)
-    coderay (1.1.3)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.3)
     csv (3.3.5)
     date (3.4.1)
+    debug (1.11.0)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
     diff-lcs (1.6.2)
+    dry-configurable (1.3.0)
+      dry-core (~> 1.1)
+      zeitwerk (~> 2.6)
+    dry-core (1.1.0)
+      concurrent-ruby (~> 1.0)
+      logger
+      zeitwerk (~> 2.6)
+    dry-inflector (1.2.0)
+    dry-initializer (3.2.0)
+    dry-logic (1.6.0)
+      bigdecimal
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.1)
+      zeitwerk (~> 2.6)
+    dry-schema (1.14.1)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 1.0, >= 1.0.1)
+      dry-core (~> 1.1)
+      dry-initializer (~> 3.2)
+      dry-logic (~> 1.5)
+      dry-types (~> 1.8)
+      zeitwerk (~> 2.6)
+    dry-types (1.8.3)
+      bigdecimal (~> 3.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
     erb (5.0.2)
     ffi (1.17.2)
     ffi (1.17.2-arm64-darwin)
@@ -33,20 +64,29 @@ GEM
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.13.0)
+    jaro_winkler (1.6.1)
+    json (2.15.0)
     kramdown (2.5.1)
       rexml (>= 3.3.9)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    method_source (1.1.0)
+    mini_portile2 (2.8.9)
     minitest (5.25.5)
+    nokogiri (1.18.10)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm64-darwin)
+      racc (~> 1.4)
+    observer (0.1.2)
     oj (3.16.11)
       bigdecimal (>= 3.0)
       ostruct (>= 0.2)
     ostruct (0.6.3)
     parallel (1.27.0)
-    parser (3.3.8.0)
+    parser (3.3.9.0)
       ast (~> 2.4.1)
       racc
     pastel (0.8.0)
@@ -54,13 +94,7 @@ GEM
     pp (0.6.2)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.4.0)
-    pry (0.14.2)
-      coderay (~> 1.1)
-      method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
+    prism (1.5.1)
     psych (5.2.6)
       date
       stringio
@@ -68,16 +102,27 @@ GEM
     rainbow (3.1.1)
     rbnacl (7.1.2)
       ffi (~> 1)
+    rbs (3.9.5)
+      logger
     rdoc (6.14.2)
       erb
       psych (>= 4.0.0)
+    redcarpet (3.6.1)
     redis (5.4.1)
       redis-client (>= 0.22.0)
     redis-client (0.25.1)
       connection_pool
-    regexp_parser (2.10.0)
+    reek (6.5.0)
+      dry-schema (~> 1.13)
+      logger (~> 1.6)
+      parser (~> 3.3.0)
+      rainbow (>= 2.0, < 4.0)
+      rexml (~> 3.1)
+    regexp_parser (2.11.3)
     reline (0.6.2)
       io-console (~> 0.5)
+    reverse_markdown (3.0.0)
+      nokogiri
     rexml (3.4.1)
     rspec (3.13.1)
       rspec-core (~> 3.13.0)
@@ -92,7 +137,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.4)
-    rubocop (1.78.0)
+    rubocop (1.81.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -100,10 +145,10 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.45.1, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.46.0)
+    rubocop-ast (1.47.1)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-performance (1.25.0)
@@ -117,8 +162,32 @@ GEM
     ruby-prof (1.7.2)
       base64
     ruby-progressbar (1.13.0)
+    solargraph (0.57.0)
+      backport (~> 1.2)
+      benchmark (~> 0.4)
+      bundler (~> 2.0)
+      diff-lcs (~> 1.4)
+      jaro_winkler (~> 1.6, >= 1.6.1)
+      kramdown (~> 2.3)
+      kramdown-parser-gfm (~> 1.1)
+      logger (~> 1.6)
+      observer (~> 0.1)
+      ostruct (~> 0.6)
+      parser (~> 3.0)
+      prism (~> 1.4)
+      rbs (>= 3.6.1, <= 4.0.0.dev.4)
+      reverse_markdown (~> 3.0)
+      rubocop (~> 1.76)
+      thor (~> 1.0)
+      tilt (~> 2.0)
+      yard (~> 0.9, >= 0.9.24)
+      yard-activesupport-concern (~> 0.0)
+      yard-solargraph (~> 0.1)
     stackprof (0.2.27)
     stringio (3.1.7)
+    thor (1.4.0)
+    tilt (2.6.1)
+    timecop (0.9.10)
     tryouts (3.6.0)
       concurrent-ruby (~> 1.0)
       irb
@@ -131,29 +200,36 @@ GEM
     tty-color (0.6.0)
     tty-cursor (0.7.1)
     tty-screen (0.8.2)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
     uri-valkey (1.4.0)
     yard (0.9.37)
+    yard-activesupport-concern (0.0.1)
+      yard (>= 0.8)
+    yard-solargraph (0.1.0)
+      yard (~> 0.9)
+    zeitwerk (2.7.3)
 PLATFORMS
   arm64-darwin-24
   ruby
 DEPENDENCIES
-  byebug (~> 11.0)
   concurrent-ruby (~> 1.3.5)
+  debug
   familia!
   irb (~> 1.15.2)
-  kramdown
-  pry-byebug (~> 3.10.1)
   rbnacl (~> 7.1, >= 7.1.1)
+  redcarpet
+  reek
   rubocop
   rubocop-performance
   rubocop-thread_safety
   ruby-prof
+  solargraph
   stackprof
+  timecop
   tryouts (~> 3.6.0)
   yard (~> 0.9)

data/LICENSE.txt CHANGED Viewed

@@ -1,6 +1,6 @@
 MIT License
-Copyright (c) 2010-2024 Delano Mandelbaum
+Copyright (c) 2010-ongoing delano, contributors
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal