cmdx 1.9.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ac9af727a0dd815dad8285e7e46d666e3f26f51eb03c3f1ec014c12e4af0e23
-  data.tar.gz: 8279a9ebcf5339fb281cd685cb0484b005f72b2605749f1418baea282be1afdf
+  metadata.gz: 9220688eed061c4c48562665fe9c2c780a2ecc08642eeaedb095d6bfc312e643
+  data.tar.gz: f470f2ccebce524942277865f2967979244dde07ba1a43095c7f95209127c635
 SHA512:
-  metadata.gz: f97ef5703cacbfa7c51e4e513e214322c330750066e2420727d1bdc6469dac092b4f9b601291c8b0a721cba6bca863d22d4189bf10a8aa4b0ec53683f6598ccc
-  data.tar.gz: 3a1019a2f2db8088ec70821d51c5d13a10554f788a7732a70a8c14830cd9804fee354447e61dae3ca86fcf4a8a664932bdff5465a78256845d224870e78951ce
+  metadata.gz: 155e2d09a4ca6147a7df578b0f2952ab81e781d5c492d821a4b71b08b41ef510cfccade001cc2e593f08ea1876ba6e5b658595a2bddaf6919f243c8df07d0569
+  data.tar.gz: fd0dba94495d6d139dc13507169143ee83f13dfac521d6ef607800c6d6e4cfd13e47cc03e2f27e047b185a0b9ebfc0a9d080143f7c6c2ec61aec139f38ea17cd

data/.cursor/prompts/yardoc.md

@@ -12,3 +12,4 @@ Add yardoc to the active tab using the following guidelines:
 - Method level docs should include `@example`, `param`, `@options`, `@return`, and any `@raise`
 - Hash `@params` should expand with possible `@option`
 - Module and method level docs should NOT include `@since`
+- Add RBS inline comments after YARDoc block

data/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [UNRELEASED]
 
+## [1.9.1] - 2025-10-22
+
+### Added
+- Added RBS inlines type signatures
+- Added YARDocs for `attr_reader` and `attr_accessor` methods
+
 ## [1.9.0] - 2025-10-21
 
 ### Added

data/LLM.md

@@ -372,6 +372,15 @@ end
 > [!TIP]
 > Use **present tense verbs + noun** for task names, eg: `ModerateBlogPost`, `ScheduleAppointment`, `ValidateDocument`
 
+## Type safety
+
+CMDx includes built-in RBS (Ruby Type Signature) inline annotations throughout the codebase, providing type information for static analysis and editor support.
+
+- **Type checking** — Catch type errors before runtime using tools like Steep or TypeProf
+- **Better IDE support** — Enhanced autocomplete, navigation, and inline documentation
+- **Self-documenting code** — Clear method signatures and return types
+- **Refactoring confidence** — Type-aware refactoring reduces bugs
+
 ---
 
 url: https://github.com/drexed/cmdx/blob/main/docs/basics/setup.md

data/README.md

@@ -17,6 +17,9 @@
 
 Say goodbye to messy service objects. CMDx helps you design business logic with clarity and consistency—build faster, debug easier, and ship with confidence.
 
+> [!NOTE]
+> Documentation reflects the latest code on `main`. For version-specific documentation, please refer to the `docs/` directory within that version's tag.
+
 ## Requirements
 
 - Ruby: MRI 3.1+ or JRuby 9.4+.
@@ -105,6 +108,8 @@ I, [2022-07-17T18:43:15.000000 #3784] INFO -- CMDx:
 index=0 chain_id="018c2b95-b764-7615-a924-cc5b910ed1e5" type="Task" class="AnalyzeMetrics" state="complete" status="success" metadata={runtime: 187}
 ```
 
+Ready to dive in? Check out the [Getting Started](https://drexed.github.io/cmdx/getting_started/) guide to learn more.
+
 ## Ecosystem
 
 - [cmdx-rspec](https://github.com/drexed/cmdx-rspec) - RSpec test matchers
@@ -116,7 +121,7 @@ For backwards compatibility of certain functionality:
 
 ## Contributing
 
-Bug reports and pull requests are welcome at https://github.com/drexed/cmdx. We're committed to fostering a welcoming, collaborative community. Please follow our [code of conduct](CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome at <https://github.com/drexed/cmdx>. We're committed to fostering a welcoming, collaborative community. Please follow our [code of conduct](CODE_OF_CONDUCT.md).
 
 ## License
 

data/docs/getting_started.md

@@ -367,3 +367,12 @@ end
 !!! tip
 
     Use **present tense verbs + noun** for task names, eg: `ModerateBlogPost`, `ScheduleAppointment`, `ValidateDocument`
+
+## Type safety
+
+CMDx includes built-in RBS (Ruby Type Signature) inline annotations throughout the codebase, providing type information for static analysis and editor support.
+
+- **Type checking** — Catch type errors before runtime using tools like Steep or TypeProf
+- **Better IDE support** — Enhanced autocomplete, navigation, and inline documentation
+- **Self-documenting code** — Clear method signatures and return types
+- **Refactoring confidence** — Type-aware refactoring reduces bugs

data/docs/index.md

@@ -6,8 +6,20 @@ Build business logic that's powerful, predictable, and maintainable.
 [![Build](https://github.com/drexed/cmdx/actions/workflows/ci.yml/badge.svg)](https://github.com/drexed/cmdx/actions/workflows/ci.yml)
 [![License](https://img.shields.io/github/license/drexed/cmdx)](https://github.com/drexed/cmdx/blob/main/LICENSE.txt)
 
+---
+
 Say goodbye to messy service objects. CMDx helps you design business logic with clarity and consistency—build faster, debug easier, and ship with confidence.
 
+!!! note
+
+    Documentation reflects the latest code on `main`. For version-specific documentation, please refer to the `docs/` directory within that version's tag.
+
+## Requirements
+
+- Ruby: MRI 3.1+ or JRuby 9.4+.
+
+CMDx works with any Ruby framework. Rails support is built-in, but it's framework-agnostic at its core.
+
 ## Installation
 
 ```sh
@@ -113,7 +125,7 @@ For backwards compatibility of certain functionality:
 
 ## Contributing
 
-Bug reports and pull requests are welcome at https://github.com/drexed/cmdx. We're committed to fostering a welcoming, collaborative community. Please follow our [code of conduct](CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome at <https://github.com/drexed/cmdx>. We're committed to fostering a welcoming, collaborative community. Please follow our [code of conduct](CODE_OF_CONDUCT.md).
 
 ## License
 

data/lib/cmdx/attribute.rb

@@ -6,14 +6,71 @@ module CMDx
   # They can be nested to create complex hierarchical data structures.
   class Attribute
 
+    # @rbs AFFIX: Proc
     AFFIX = proc do |value, &block|
       value == true ? block.call : value
     end.freeze
     private_constant :AFFIX
 
+    # Returns the task instance associated with this attribute.
+    #
+    # @return [CMDx::Task] The task instance
+    #
+    # @example
+    #   attribute.task.context[:user_id] # => 42
+    #
+    # @rbs @task: Task
     attr_accessor :task
 
-    attr_reader :name, :options, :children, :parent, :types
+    # Returns the name of this attribute.
+    #
+    # @return [Symbol] The attribute name
+    #
+    # @example
+    #   attribute.name # => :user_id
+    #
+    # @rbs @name: Symbol
+    attr_reader :name
+
+    # Returns the configuration options for this attribute.
+    #
+    # @return [Hash{Symbol => Object}] Configuration options hash
+    #
+    # @example
+    #   attribute.options # => { required: true, default: 0 }
+    #
+    # @rbs @options: Hash[Symbol, untyped]
+    attr_reader :options
+
+    # Returns the child attributes for nested structures.
+    #
+    # @return [Array<Attribute>] Array of child attributes
+    #
+    # @example
+    #   attribute.children # => [#<Attribute @name=:street>, #<Attribute @name=:city>]
+    #
+    # @rbs @children: Array[Attribute]
+    attr_reader :children
+
+    # Returns the parent attribute if this is a nested attribute.
+    #
+    # @return [Attribute, nil] The parent attribute, or nil if root-level
+    #
+    # @example
+    #   attribute.parent # => #<Attribute @name=:address>
+    #
+    # @rbs @parent: (Attribute | nil)
+    attr_reader :parent
+
+    # Returns the expected type(s) for this attribute's value.
+    #
+    # @return [Array<Class>] Array of expected type classes
+    #
+    # @example
+    #   attribute.types # => [Integer, String]
+    #
+    # @rbs @types: Array[Class]
+    attr_reader :types
 
     # Creates a new attribute with the specified name and configuration.
     #
@@ -35,6 +92,8 @@ module CMDx
     #     required :name, types: String
     #     optional :email, types: String
     #   end
+    #
+    # @rbs ((Symbol | String) name, ?Hash[Symbol, untyped] options) ?{ () -> void } -> void
     def initialize(name, options = {}, &)
       @parent = options.delete(:parent)
       @required = options.delete(:required) || false
@@ -62,6 +121,8 @@ module CMDx
       #
       # @example
       #   Attribute.build(:first_name, :last_name, required: true, types: String)
+      #
+      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
       def build(*names, **options, &)
         if names.none?
           raise ArgumentError, "no attributes given"
@@ -83,6 +144,8 @@ module CMDx
       #
       # @example
       #   Attribute.optional(:description, :tags, types: String)
+      #
+      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
       def optional(*names, **options, &)
         build(*names, **options.merge(required: false), &)
       end
@@ -98,6 +161,8 @@ module CMDx
       #
       # @example
       #   Attribute.required(:id, :name, types: [Integer, String])
+      #
+      # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
       def required(*names, **options, &)
         build(*names, **options.merge(required: true), &)
       end
@@ -110,6 +175,8 @@ module CMDx
     #
     # @example
     #   attribute.required? # => true
+    #
+    # @rbs () -> bool
     def required?
       !!@required
     end
@@ -120,6 +187,8 @@ module CMDx
     #
     # @example
     #   attribute.source # => :context
+    #
+    # @rbs () -> untyped
     def source
       @source ||= parent&.method_name || begin
         value = options[:source]
@@ -140,6 +209,8 @@ module CMDx
     #
     # @example
     #   attribute.method_name # => :user_name
+    #
+    # @rbs () -> Symbol
     def method_name
       @method_name ||= options[:as] || begin
         prefix = AFFIX.call(options[:prefix]) { "#{source}_" }
@@ -150,6 +221,8 @@ module CMDx
     end
 
     # Defines and verifies the entire attribute tree including nested children.
+    #
+    # @rbs () -> void
     def define_and_verify_tree
       define_and_verify
 
@@ -172,6 +245,8 @@ module CMDx
     #
     # @example
     #   attributes :street, :city, :zip, types: String
+    #
+    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
     def attributes(*names, **options, &)
       attrs = self.class.build(*names, **options.merge(parent: self), &)
       children.concat(attrs)
@@ -189,6 +264,8 @@ module CMDx
     #
     # @example
     #   optional :middle_name, :nickname, types: String
+    #
+    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
     def optional(*names, **options, &)
       attributes(*names, **options.merge(required: false), &)
     end
@@ -204,6 +281,8 @@ module CMDx
     #
     # @example
     #   required :first_name, :last_name, types: String
+    #
+    # @rbs (*untyped names, **untyped options) ?{ () -> void } -> Array[Attribute]
     def required(*names, **options, &)
       attributes(*names, **options.merge(required: true), &)
     end
@@ -211,6 +290,8 @@ module CMDx
     # Defines the attribute method on the task and validates the configuration.
     #
     # @raise [RuntimeError] When the method name is already defined on the task
+    #
+    # @rbs () -> void
     def define_and_verify
       if task.respond_to?(method_name, true)
         raise <<~MESSAGE

data/lib/cmdx/attribute_registry.rb

@@ -6,6 +6,14 @@ module CMDx
   # in a hierarchical structure, supporting nested attribute definitions.
   class AttributeRegistry
 
+    # Returns the collection of registered attributes.
+    #
+    # @return [Array<Attribute>] Array of registered attributes
+    #
+    # @example
+    #   registry.registry # => [#<Attribute @name=:name>, #<Attribute @name=:email>]
+    #
+    # @rbs @registry: Array[Attribute]
     attr_reader :registry
     alias to_a registry
 
@@ -18,6 +26,8 @@ module CMDx
     # @example
     #   registry = AttributeRegistry.new
     #   registry = AttributeRegistry.new([attr1, attr2])
+    #
+    # @rbs (?Array[Attribute] registry) -> void
     def initialize(registry = [])
       @registry = registry
     end
@@ -28,6 +38,8 @@ module CMDx
     #
     # @example
     #   new_registry = registry.dup
+    #
+    # @rbs () -> AttributeRegistry
     def dup
       self.class.new(registry.dup)
     end
@@ -41,6 +53,8 @@ module CMDx
     # @example
     #   registry.register(attribute)
     #   registry.register([attr1, attr2])
+    #
+    # @rbs (Attribute | Array[Attribute] attributes) -> self
     def register(attributes)
       @registry.concat(Array(attributes))
       self
@@ -56,6 +70,8 @@ module CMDx
     # @example
     #   registry.deregister(:name)
     #   registry.deregister(['name1', 'name2'])
+    #
+    # @rbs ((Symbol | String | Array[Symbol | String]) names) -> self
     def deregister(names)
       Array(names).each do |name|
         @registry.reject! { |attribute| matches_attribute_tree?(attribute, name.to_sym) }
@@ -69,6 +85,8 @@ module CMDx
     # and validate the attribute hierarchy.
     #
     # @param task [Task] The task to associate with all attributes
+    #
+    # @rbs (Task task) -> void
     def define_and_verify(task)
       registry.each do |attribute|
         attribute.task = task
@@ -84,6 +102,8 @@ module CMDx
     # @param name [Symbol] The name to match against
     #
     # @return [Boolean] True if the attribute or any child matches the name
+    #
+    # @rbs (Attribute attribute, Symbol name) -> bool
     def matches_attribute_tree?(attribute, name)
       return true if attribute.method_name == name
 

data/lib/cmdx/attribute_value.rb

@@ -8,6 +8,14 @@ module CMDx
 
     extend Forwardable
 
+    # Returns the attribute managed by this value handler.
+    #
+    # @return [Attribute] The attribute instance
+    #
+    # @example
+    #   attr_value.attribute.name # => :user_id
+    #
+    # @rbs @attribute: Attribute
     attr_reader :attribute
 
     def_delegators :attribute, :task, :parent, :name, :options, :types, :source, :method_name, :required?
@@ -20,6 +28,8 @@ module CMDx
     # @example
     #   attr = Attribute.new(:user_id, required: true)
     #   attr_value = AttributeValue.new(attr)
+    #
+    # @rbs (Attribute attribute) -> void
     def initialize(attribute)
       @attribute = attribute
     end
@@ -30,6 +40,8 @@ module CMDx
     #
     # @example
     #   attr_value.value # => "john_doe"
+    #
+    # @rbs () -> untyped
     def value
       attributes[method_name]
     end
@@ -41,6 +53,8 @@ module CMDx
     #
     # @example
     #   attr_value.generate # => 42
+    #
+    # @rbs () -> untyped
     def generate
       return value if attributes.key?(method_name)
 
@@ -64,6 +78,8 @@ module CMDx
     # @example
     #   attr_value.validate
     #   # Validates value against :presence, :format, etc.
+    #
+    # @rbs () -> void
     def validate
       registry = task.class.settings[:validators]
 
@@ -86,6 +102,7 @@ module CMDx
     # @example
     #   # Sources from task method, proc, or direct value
     #   source_value # => "raw_value"
+    # @rbs () -> untyped
     def source_value
       sourced_value =
         case source
@@ -115,6 +132,8 @@ module CMDx
     # @example
     #   # Default can be symbol, proc, or direct value
     #   -> { rand(100) } # => 23
+    #
+    # @rbs () -> untyped
     def default_value
       default = options[:default]
 
@@ -140,6 +159,8 @@ module CMDx
     # @example
     #   # Derives from hash key, method call, or proc execution
     #   context.user_id # => 42
+    #
+    # @rbs (untyped source_value) -> untyped
     def derive_value(source_value)
       derived_value =
         case source_value
@@ -163,6 +184,8 @@ module CMDx
     #
     # @example
     #   :downcase # => "hello"
+    #
+    # @rbs (untyped derived_value) -> untyped
     def transform_value(derived_value)
       transform = options[:transform]
 
@@ -186,6 +209,8 @@ module CMDx
     # @example
     #   # Coerces "42" to Integer, "true" to Boolean, etc.
     #   coerce_value("42") # => 42
+    #
+    # @rbs (untyped transformed_value) -> untyped
     def coerce_value(transformed_value)
       return transformed_value if types.empty?
 

data/lib/cmdx/callback_registry.rb

@@ -7,6 +7,7 @@ module CMDx
   # Each callback type represents a specific execution phase or outcome.
   class CallbackRegistry
 
+    # @rbs TYPES: Array[Symbol]
     TYPES = %i[
       before_validation
       before_execution
@@ -20,10 +21,20 @@ module CMDx
       on_bad
     ].freeze
 
+    # Returns the internal registry of callbacks organized by type.
+    #
+    # @return [Hash{Symbol => Set<Array>}] Hash mapping callback types to their registered callables
+    #
+    # @example
+    #   registry.registry # => { before_execution: #<Set: [[[:validate], {}]]> }
+    #
+    # @rbs @registry: Hash[Symbol, Set[Array[untyped]]]
     attr_reader :registry
     alias to_h registry
 
     # @param registry [Hash] Initial registry hash, defaults to empty
+    #
+    # @rbs (?Hash[Symbol, Set[Array[untyped]]] registry) -> void
     def initialize(registry = {})
       @registry = registry
     end
@@ -31,6 +42,8 @@ module CMDx
     # Creates a deep copy of the registry with duplicated callable sets
     #
     # @return [CallbackRegistry] A new instance with duplicated registry contents
+    #
+    # @rbs () -> CallbackRegistry
     def dup
       self.class.new(registry.transform_values(&:dup))
     end
@@ -54,6 +67,8 @@ module CMDx
     #   registry.register(:on_success, if: { status: :completed }) do |task|
     #     task.log("Success callback executed")
     #   end
+    #
+    # @rbs (Symbol type, *untyped callables, **untyped options) ?{ (Task) -> void } -> self
     def register(type, *callables, **options, &block)
       callables << block if block_given?
 
@@ -73,6 +88,8 @@ module CMDx
     #
     # @example Remove a specific callback
     #   registry.deregister(:before_execution, :validate_inputs)
+    #
+    # @rbs (Symbol type, *untyped callables, **untyped options) ?{ (Task) -> void } -> self
     def deregister(type, *callables, **options, &block)
       callables << block if block_given?
       return self unless registry[type]
@@ -91,6 +108,8 @@ module CMDx
     #
     # @example Invoke all before_execution callbacks
     #   registry.invoke(:before_execution, task)
+    #
+    # @rbs (Symbol type, Task task) -> void
     def invoke(type, task)
       raise TypeError, "unknown callback type #{type.inspect}" unless TYPES.include?(type)
 

data/lib/cmdx/chain.rb

@@ -8,9 +8,28 @@ module CMDx
 
     extend Forwardable
 
+    # @rbs THREAD_KEY: Symbol
     THREAD_KEY = :cmdx_chain
 
-    attr_reader :id, :results
+    # Returns the unique identifier for this chain.
+    #
+    # @return [String] The chain identifier
+    #
+    # @example
+    #   chain.id # => "abc123xyz"
+    #
+    # @rbs @id: String
+    attr_reader :id
+
+    # Returns the collection of execution results in this chain.
+    #
+    # @return [Array<Result>] Array of task results
+    #
+    # @example
+    #   chain.results # => [#<Result>, #<Result>]
+    #
+    # @rbs @results: Array[Result]
+    attr_reader :results
 
     def_delegators :results, :index, :first, :last, :size
     def_delegators :first, :state, :status, :outcome, :runtime
@@ -18,6 +37,8 @@ module CMDx
     # Creates a new chain with a unique identifier and empty results collection.
     #
     # @return [Chain] A new chain instance
+    #
+    # @rbs () -> void
     def initialize
       @id = Identifier.generate
       @results = []
@@ -34,6 +55,8 @@ module CMDx
       #   if chain
       #     puts "Current chain: #{chain.id}"
       #   end
+      #
+      # @rbs () -> Chain?
       def current
         Thread.current[THREAD_KEY]
       end
@@ -46,6 +69,8 @@ module CMDx
       #
       # @example
       #   Chain.current = my_chain
+      #
+      # @rbs (Chain chain) -> Chain
       def current=(chain)
         Thread.current[THREAD_KEY] = chain
       end
@@ -56,6 +81,8 @@ module CMDx
       #
       # @example
       #   Chain.clear
+      #
+      # @rbs () -> nil
       def clear
         Thread.current[THREAD_KEY] = nil
       end
@@ -73,6 +100,8 @@ module CMDx
       #   result = task.execute
       #   chain = Chain.build(result)
       #   puts "Chain size: #{chain.size}"
+      #
+      # @rbs (Result result) -> Chain
       def build(result)
         raise TypeError, "must be a CMDx::Result" unless result.is_a?(Result)
 
@@ -95,6 +124,8 @@ module CMDx
     #   chain_hash = chain.to_h
     #   puts chain_hash[:id]
     #   puts chain_hash[:results].size
+    #
+    # @rbs () -> Hash[Symbol, untyped]
     def to_h
       {
         id: id,
@@ -108,6 +139,8 @@ module CMDx
     #
     # @example
     #   puts chain.to_s
+    #
+    # @rbs () -> String
     def to_s
       Utils::Format.to_str(to_h)
     end

data/lib/cmdx/coercion_registry.rb

@@ -7,6 +7,14 @@ module CMDx
   # for various data types including arrays, numbers, dates, and other primitives.
   class CoercionRegistry
 
+    # Returns the internal registry mapping coercion types to handler classes.
+    #
+    # @return [Hash{Symbol => Class}] Hash of coercion type names to coercion classes
+    #
+    # @example
+    #   registry.registry # => { integer: Coercions::Integer, boolean: Coercions::Boolean }
+    #
+    # @rbs @registry: Hash[Symbol, Class]
     attr_reader :registry
     alias to_h registry
 
@@ -17,6 +25,8 @@ module CMDx
     # @example
     #   registry = CoercionRegistry.new
     #   registry = CoercionRegistry.new(custom: CustomCoercion)
+    #
+    # @rbs (?Hash[Symbol, Class]? registry) -> void
     def initialize(registry = nil)
       @registry = registry || {
         array: Coercions::Array,
@@ -40,6 +50,8 @@ module CMDx
     #
     # @example
     #   new_registry = registry.dup
+    #
+    # @rbs () -> CoercionRegistry
     def dup
       self.class.new(registry.dup)
     end
@@ -54,6 +66,8 @@ module CMDx
     # @example
     #   registry.register(:custom_type, CustomCoercion)
     #   registry.register("another_type", AnotherCoercion)
+    #
+    # @rbs ((Symbol | String) name, Class coercion) -> self
     def register(name, coercion)
       registry[name.to_sym] = coercion
       self
@@ -68,6 +82,8 @@ module CMDx
     # @example
     #   registry.deregister(:custom_type)
     #   registry.deregister("another_type")
+    #
+    # @rbs ((Symbol | String) name) -> self
     def deregister(name)
       registry.delete(name.to_sym)
       self
@@ -87,6 +103,8 @@ module CMDx
     # @example
     #   result = registry.coerce(:integer, task, "42")
     #   result = registry.coerce(:boolean, task, "true", strict: true)
+    #
+    # @rbs (Symbol type, untyped task, untyped value, ?Hash[Symbol, untyped] options) -> untyped
     def coerce(type, task, value, options = {})
       raise TypeError, "unknown coercion type #{type.inspect}" unless registry.key?(type)
 

data/lib/cmdx/coercions/array.rb

@@ -26,6 +26,8 @@ module CMDx
       #   Array.call("hello")     # => ["hello"]
       #   Array.call(42)          # => [42]
       #   Array.call(nil)         # => []
+      #
+      # @rbs (untyped value, ?Hash[Symbol, untyped] options) -> Array[untyped]
       def call(value, options = {})
         if value.is_a?(::String) && value.start_with?("[")
           JSON.parse(value)