checkoff 0.256.0 → 0.258.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6f30a4354aedf2688699c3c460f2495445ce9cc647e0da109586f9be561caf4
-  data.tar.gz: 159ce5f7020c4ed9d0c3bd2f6841e3da1c5e5fc3009a2efefc04af8ccc3b97b1
+  metadata.gz: cacf5e2fbe9fab040accd8cd51804fcf3f07cf0e6f050c93ecbe2da2c930bdc5
+  data.tar.gz: ebfe6f20e1be062a918afac5a4703df7a0d5205c69cb8d0479d5f6427c467767
 SHA512:
-  metadata.gz: 473fa677a861c4d4d8d2d6b9c93feeaa4d3a3cd6d029298a3a8ac98bf1ec443316c08860e20f64406aa3775642cf8b08115163513b8b634fe6ddf9dddb8ae78e
-  data.tar.gz: c50cd2149b2465e59e6a84b7ab53ca5027c8fb24aceb1e01731a39dfa52e5e52964f8ee2a38bb3b69ded267a9f989c7a9cc806bbcd2b24ad2b75be70c6d25ad6
+  metadata.gz: cddee9806d41d98908eca0331b3b52ee84b45968e419aad7b8817003389418f65e9536b02c2db20b2368796b447046b7093819b094ba01dcd7c59875eb404562
+  data.tar.gz: 82b6db32f7d6ad50d287da1fba1a537468f94aa283d60358fcf4a03953df86c41dc00da2dd514cfdbd838bd5ce2209f11e97966f00814e27fe1640cf8ad41cb3

data/lib/checkoff/attachments.rb

@@ -54,7 +54,7 @@ module Checkoff
     end
 
     # @param url [String]
-    # @param resource [Asana::Resources::Resource]
+    # @param resource [Asana::Resources::Task]
     # @param attachment_name [String,nil]
     # @param just_the_url [Boolean]
     # @param verify_mode [Integer] - e.g., OpenSSL::SSL::VERIFY_NONE or OpenSSL::SSL::VERIFY_PEER
@@ -79,15 +79,15 @@ module Checkoff
     # extension as the URL using Net::HTTP, raising an exception if
     # not succesful
     #
-    # @param uri [URI]
+    # @param uri [URI::Generic]
     # @param verify_mode [Integer] - e.g., OpenSSL::SSL::VERIFY_NONE,OpenSSL::SSL::VERIFY_PEER
     #
     # @return [Object]
     def download_uri(uri, verify_mode: OpenSSL::SSL::VERIFY_PEER, &block)
       out = nil
-      # @sg-ignore
       Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https', verify_mode:) do |http|
-        # @sg-ignore
+        # @sg-ignore Unresolved constant Net::HTTP::Get / Unresolved call to request —
+        #   stdlib RBS gap on Net::HTTP block param types
         http.request(Net::HTTP::Get.new(uri)) do |response|
           raise("Unexpected response code: #{response.code}") unless response.code == '200'
 
@@ -120,7 +120,7 @@ module Checkoff
     end
 
     # @param url [String]
-    # @param resource [Asana::Resources::Resource]
+    # @param resource [Asana::Resources::Task]
     # @param attachment_name [String,nil]
     # @param verify_mode [Integer] - e.g., OpenSSL::SSL::VERIFY_NONE,OpenSSL::SSL::VERIFY_PEER
     #
@@ -130,25 +130,25 @@ module Checkoff
       uri = URI(url)
       attachment_name ||= File.basename(uri.path)
       download_uri(uri, verify_mode:) do |tempfile|
-        # @sg-ignore
+        # @sg-ignore attachment_name reassignment above isn't narrowed from the declared
+        #   [String, nil] param type — needs a fresh typed local, deferred to a follow-up code PR
         content_type ||= content_type_from_filename(attachment_name)
-        # @sg-ignore
+        # @sg-ignore URI::Generic#path can be nil
         content_type ||= content_type_from_filename(uri.path)
 
-        # @sg-ignore
+        # @sg-ignore same attachment_name/content_type narrowing gap as above
         resource.attach(filename: attachment_name, mime: content_type,
                         io: tempfile)
       end
     end
 
     # @param url [String]
-    # @param resource [Asana::Resources::Resource]
+    # @param resource [Asana::Resources::Task]
     # @param attachment_name [String,nil]
     #
     # @return [Asana::Resources::Attachment]
     def create_attachment_from_url_alone!(url, resource, attachment_name:)
       with_params = {
-        # @sg-ignore
         'parent' => resource.gid,
         'url' => url,
         'resource_subtype' => 'external',
@@ -196,7 +196,8 @@ module Checkoff
         tasks = Checkoff::Tasks.new
         attachments = Checkoff::Attachments.new
         task = tasks.task_by_gid(gid)
-        # @sg-ignore
+        # @sg-ignore task_by_gid can return nil; needs a raise-if-nil guard, deferred to a
+        #   follow-up code PR
         attachment = attachments.create_attachment_from_url!(url, task)
         puts "Results: #{attachment.inspect}"
       end

data/lib/checkoff/cli.rb

@@ -29,7 +29,6 @@ module Checkoff
       end
 
       @from_workspace_name = from_workspace_arg
-      # @sg-ignore
       @from_project_name = project_arg_to_name(from_project_arg)
       @from_section_name = from_section_arg
     end
@@ -41,7 +40,6 @@ module Checkoff
       if to_project_arg == :source_project
         from_project_name
       else
-        # @sg-ignore
         project_arg_to_name(to_project_arg)
       end
     end
@@ -146,7 +144,7 @@ module Checkoff
                 :to_workspace_name, :to_project_name, :to_section_name,
                 :projects, :sections
 
-    # @param project_arg [String]
+    # @param project_arg [Symbol, String]
     # @return [Symbol, String]
     def project_arg_to_name(project_arg)
       arg = project_arg.to_s
@@ -194,7 +192,7 @@ module Checkoff
       elsif task_name.nil?
         run_on_section(workspace_name, project_name, section_name)
       else
-        # @sg-ignore
+        # @sg-ignore task_name.nil? above isn't inferred as narrowing the task_name accessor's return
         run_on_task(workspace_name, project_name, section_name, task_name)
       end
     end
@@ -218,7 +216,6 @@ module Checkoff
     # @return [String]
     def run_on_project(workspace, project)
       tasks_by_section =
-        # @sg-ignore
         sections.tasks_by_section(workspace, project)
       tasks_by_section.update(tasks_by_section) do |_key, tasks|
         tasks_to_hash(tasks)
@@ -315,7 +312,7 @@ module Checkoff
     arg 'workspace'
     arg 'task_name'
     command :quickadd do |c|
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.action do |_global_options, _options, args|
         workspace_name = args.fetch(0)
         task_name = args.fetch(1)
@@ -330,7 +327,7 @@ module Checkoff
     arg 'section', :optional
     arg 'task_name', :optional
     command :view do |c|
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.action do |_global_options, _options, args|
         workspace_name = args.fetch(0)
         project_name = args.fetch(1)
@@ -345,37 +342,37 @@ module Checkoff
 
     # rubocop:disable Metrics/BlockLength
     command :mv do |c|
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :from_workspace,
              type: String,
              default_value: :default_workspace,
              desc: 'Workspace to move tasks from'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :from_project,
              type: String,
              required: true,
              desc: 'Project to move tasks from'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :from_section,
              type: String,
              default_value: :all_sections,
              desc: 'Section to move tasks from'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :to_workspace,
              type: String,
              default_value: :source_workspace,
              desc: 'Workspace to move tasks to'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :to_project,
              type: String,
              default_value: :source_project,
              desc: 'Section to move tasks to'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.flag :to_section,
              type: String,
              default_value: :source_section,
              desc: 'Section to move tasks to'
-      # @sg-ignore
+      # @sg-ignore GLI's DSL block methods (c.flag/c.action) aren't resolved
       c.action do |_global_options, options, _args|
         from_workspace = options.fetch('from_workspace')
         from_project = options.fetch('from_project')

data/lib/checkoff/clients.rb

@@ -30,9 +30,9 @@ module Checkoff
     # @return [Asana::Client]
     def client
       @client ||= @asana_client_class.new do |c|
-        # @sg-ignore
+        # @sg-ignore Unresolved call to authentication — gem config DSL block, not covered by annotations
         c.authentication :access_token, @config.fetch(:personal_access_token)
-        # @sg-ignore
+        # @sg-ignore Unresolved call to default_headers — gem config DSL block, not covered by annotations
         c.default_headers 'asana-enable' =>
                           'new_project_templates,new_user_task_lists,new_memberships,new_goal_memberships'
       end

data/lib/checkoff/custom_fields.rb

@@ -41,7 +41,7 @@ module Checkoff
     # @param custom_field_name [String]
     #
     # @return [Asana::Resources::CustomField]
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     def custom_field_or_raise(workspace_name, custom_field_name)
       cf = custom_field(workspace_name, custom_field_name)
       raise "Could not find custom_field #{custom_field_name} under workspace #{workspace_name}." if cf.nil?
@@ -78,8 +78,10 @@ module Checkoff
 
     # @param resource [Asana::Resources::Project,Asana::Resources::Task]
     # @param custom_field_name [String]
-    # @sg-ignore
     # @return [Array<String>]
+    # @sg-ignore Declared return type Array<String> does not match inferred type Array,Array<Array> —
+    #   fixing cleanly needs binding enum_value.fetch('name') to a typed local; leaving for a
+    #   follow-up code PR to keep this one annotation-only.
     def resource_custom_field_values_names_by_name(resource, custom_field_name)
       custom_field = resource_custom_field_by_name(resource, custom_field_name)
       return [] if custom_field.nil?
@@ -108,9 +110,9 @@ module Checkoff
     end
 
     # @param resource [Asana::Resources::Task,Asana::Resources::Project]
-    # @sg-ignore
     # @param custom_field_name [String]
     # @return [Hash]
+    # @sg-ignore nil check above is not flow-sensitive
     def resource_custom_field_by_name_or_raise(resource, custom_field_name)
       custom_field = resource_custom_field_by_name(resource, custom_field_name)
       if custom_field.nil?
@@ -120,10 +122,10 @@ module Checkoff
       custom_field
     end
 
-    # @sg-ignore
     # @param resource [Asana::Resources::Project,Asana::Resources::Task]
     # @param custom_field_gid [String]
     # @return [Hash]
+    # @sg-ignore nil check above is not flow-sensitive
     def resource_custom_field_by_gid_or_raise(resource, custom_field_gid)
       # @type [Array<Hash>]
       custom_fields = resource.custom_fields
@@ -146,15 +148,15 @@ module Checkoff
     # @param custom_field [Hash{String => Hash,Array<Hash>}]
     #
     # @return [Array<Hash>]
-    # @sg-ignore
+    # @sg-ignore Declared return type Array<Hash> does not match inferred type Array,Hash,Array<Hash> —
+    #   fixing cleanly needs restructuring the case/when to bind each branch to a typed local; leaving
+    #   for a follow-up code PR to keep this one annotation-only.
     def resource_custom_field_enum_values(custom_field)
       resource_subtype = custom_field.fetch('resource_subtype')
       case resource_subtype
       when 'enum'
-        # @type [Array<Hash>]
         [custom_field.fetch('enum_value')]
       when 'multi_enum'
-        # @type [Array<Hash>]
         custom_field.fetch('multi_enum_values')
       else
         raise "Teach me how to handle resource_subtype #{resource_subtype}"

data/lib/checkoff/internal/asana_event_enrichment.rb

@@ -74,9 +74,11 @@ module Checkoff
         end
         resource = webhook_subscription&.fetch('resource', nil)
         name, resource_type = enrich_gid(resource) if resource
-        # @sg-ignore
+        # @sg-ignore webhook_subscription is declared [Hash, nil] but this line assumes non-nil
+        #   without the &. used elsewhere in this method — looks like a real nil-safety gap, not
+        #   just a typing gap; flagging for the follow-up code PR rather than silently widening
         webhook_subscription['checkoff:enriched:name'] = name if name
-        # @sg-ignore
+        # @sg-ignore same nil-safety gap as above
         webhook_subscription['checkoff:enriched:resource_type'] = resource_type if resource_type
       end
 
@@ -96,13 +98,11 @@ module Checkoff
 
       # @param filter [Hash{String => String, Array<String>}]
       #
-      # @sg-ignore
-      # @return [String, nil]
+      # @return [void]
       def enrich_filter_parent_gid!(filter)
-        parent_gid = filter['checkoff:parent.gid']
+        parent_gid = T.cast(filter['checkoff:parent.gid'], T.nilable(String))
         return unless parent_gid
 
-        # @sg-ignore
         name, resource_type = enrich_gid(parent_gid)
         filter['checkoff:enriched:parent.name'] = name if name
         filter['checkoff:enriched:parent.resource_type'] = resource_type if resource_type
@@ -112,11 +112,10 @@ module Checkoff
       #
       # @return [void]
       def enrich_filter_resource!(filter)
-        resource_gid = filter['checkoff:resource.gid']
+        resource_gid = T.cast(filter['checkoff:resource.gid'], T.nilable(String))
 
         return unless resource_gid
 
-        # @sg-ignore
         task = tasks.task_by_gid(resource_gid)
         task_name = task&.name
         filter['checkoff:enriched:resource.name'] = task_name if task_name
@@ -134,19 +133,22 @@ module Checkoff
         filter['checkoff:enriched:fetched.section.name'] = name if name
       end
 
-      # @param asana_event [Hash{'resource' => Hash}]
+      # @param asana_event [Hash]
       #
       # @return [void]
       def enrich_event_parent!(asana_event)
         # @type [Hash{String => String }]
-        # @sg-ignore
         parent = asana_event['parent']
 
         return unless parent
 
         # @type [String]
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         resource_type = parent.fetch('resource_type')
         # @type [String]
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         gid = parent.fetch('gid')
         name, _resource_type = enrich_gid(gid, resource_type:)
         parent['checkoff:enriched:name'] = name if name
@@ -154,16 +156,20 @@ module Checkoff
         nil
       end
 
-      # @param asana_event [Hash{'resource' => Hash}]
+      # @param asana_event [Hash]
       #
       # @return [void]
       def enrich_event_resource!(asana_event)
         # @type [Hash{String => String}]
         resource = T.cast(asana_event['resource'], T::Hash[String, String])
         # @type [String]
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         resource_type = resource.fetch('resource_type')
 
         # @type [String]
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         gid = resource.fetch('gid')
 
         name, _resource_type = enrich_gid(gid, resource_type:)

data/lib/checkoff/internal/asana_event_filter.rb

@@ -122,6 +122,8 @@ module Checkoff
         # @type [Hash{String => String}]
         resource = asana_event.fetch('resource')
         # @type [String]
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         resource_type = resource.fetch('resource_type')
         unless resource_type == 'task'
           raise "Teach me how to check #{key.inspect} on resource type #{resource_type.inspect}"
@@ -131,6 +133,8 @@ module Checkoff
         options = {
           fields:,
         }
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         @client.tasks.find_by_id(task_gid, options:)
       rescue Asana::Errors::NotFound
         nil

data/lib/checkoff/internal/config_loader.rb

@@ -20,12 +20,12 @@ module Checkoff
 
       # @param key [Symbol]
       # @return [Object]
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def [](key)
         config_value = @config[key]
         return config_value unless config_value.nil?
 
-        # @sg-ignore
+        # @sg-ignore Unresolved call to fetch on RBS::Unnamed::ENVClass, Class<ENV>
         ENV.fetch(envvar_name(key), nil)
       end
 

data/lib/checkoff/internal/logging.rb

@@ -57,10 +57,10 @@ module Logging
   private
 
   # @return [Symbol]
-  # @sg-ignore
+  # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
   def log_level
-    # @sg-ignore
     # rubocop:disable Style/RedundantFetchBlock
+    # @sg-ignore Unresolved call to fetch on RBS::Unnamed::ENVClass, Class<ENV>
     ENV.fetch('LOG_LEVEL') { 'INFO' }.downcase.to_sym
     # rubocop:enable Style/RedundantFetchBlock
   end

data/lib/checkoff/internal/search_url/custom_field_param_converter.rb

@@ -59,19 +59,20 @@ module Checkoff
         # @param gid [String]
         # @param single_custom_field_params [Hash{String => Array<String>}]
         # @return [Array(Hash{String => String}, Array<Symbol, Array>)]
-        # @sg-ignore
+        # @sg-ignore `unless variant_class.nil?` return value isn't inferred as the declared tuple type
         def convert_single_custom_field_params(gid, single_custom_field_params)
           variant_key = "custom_field_#{gid}.variant"
           variant = single_custom_field_params.fetch(variant_key)
           remaining_params = single_custom_field_params.reject { |k, _v| k == variant_key }
+          # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+          # https://github.com/castwide/solargraph/pull/1228
           raise "Teach me how to handle #{variant_key} = #{variant}" unless variant.length == 1
 
-          # @sg-ignore
-          # @type [Class<CustomFieldVariant>]
-          # @sg-ignore
+          # @type [Class<CustomFieldVariant>, nil]
+          # @sg-ignore variant.length == 1 guard above isn't inferred as narrowing variant[0] to non-nil
           variant_class = VARIANTS[variant[0]]
           # @type [Array(Hash{String => String}, Array<Symbol, Array>)]
-          # @sg-ignore
+          # @sg-ignore `unless variant_class.nil?` isn't inferred as narrowing the receiver in the same statement
           return variant_class.new(gid, remaining_params).convert unless variant_class.nil?
 
           raise "Teach me how to handle #{variant_key} = #{variant}"
@@ -79,9 +80,9 @@ module Checkoff
 
         # @param key [String]
         # @return [String]
-        # @sg-ignore
+        # @sg-ignore split(...)[n]'s nilable Array indexing isn't inferred as the declared String return
         def gid_from_custom_field_key(key)
-          # @sg-ignore
+          # @sg-ignore split(...)[n] is nilable Array indexing; key's shape guarantees enough parts here
           key.split('_')[2].split('.')[0]
         end
 

data/lib/checkoff/internal/search_url/custom_field_variant.rb

@@ -37,6 +37,8 @@ module Checkoff
             case remaining_params.keys
             when [param_name]
               # @type param_values [Array<String>]
+              # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+              # https://github.com/castwide/solargraph/pull/1228
               param_values = remaining_params.fetch(param_name)
               unless param_values.length == 1
                 raise "Teach me how to handle these remaining keys for #{param_name}: #{remaining_params}"

data/lib/checkoff/internal/search_url/date_param_converter.rb

@@ -15,7 +15,7 @@ module Checkoff
         end
 
         # @return [Array(Hash{String => String}, Array<Symbol, Array>)]
-        # @sg-ignore
+        # @sg-ignore out can genuinely be nil if none of the 3 known prefixes matched; relies on the raise above it
         def convert
           return [{}, []] if date_url_params.empty?
 
@@ -129,15 +129,19 @@ module Checkoff
         end
 
         # @param param_key [String]
-        # @sg-ignore
         # @return [String]
+        # @sg-ignore value.length == 1 guard above isn't inferred as narrowing value[0] to non-nil
         def get_single_param(param_key)
           raise "Expected #{param_key} to have at least one value" unless date_url_params.key? param_key
 
           value = date_url_params.fetch(param_key)
 
+          # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+          # https://github.com/castwide/solargraph/pull/1228
           raise "Expected #{param_key} to have one value" if value.length != 1
 
+          # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+          # https://github.com/castwide/solargraph/pull/1228
           value[0]
         end
 
@@ -154,6 +158,8 @@ module Checkoff
         def validate_unit_is_day!(prefix)
           unit = date_url_params.fetch("#{prefix}.unit").fetch(0)
 
+          # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+          # https://github.com/castwide/solargraph/pull/1228
           raise "Teach me how to handle other time units: #{unit}" unless unit == 'day'
         end
 

data/lib/checkoff/internal/search_url/parser.rb

@@ -24,9 +24,10 @@ module Checkoff
         # @param url [String]
         # @return [Array(Hash{String => String}, Array)]
         def convert_params(url)
-          # @sg-ignore
+          # @sg-ignore URI#query can be nil for a URL with no query string; CGI.parse expects
+          #   String — looks like a real gap (unhandled no-query-string case), not just a typing
+          #   gap, flagging for the follow-up code PR rather than silently asserting non-nil
           url_params = CGI.parse(URI.parse(url).query)
-          # @sg-ignore
           custom_field_params, date_url_params, simple_url_params = partition_url_params(url_params)
           custom_field_args, custom_field_task_selector = convert_custom_field_params(custom_field_params)
           date_url_args, date_task_selector = convert_date_params(date_url_params)
@@ -56,14 +57,15 @@ module Checkoff
           CustomFieldParamConverter.new(custom_field_params:).convert
         end
 
-        # @param url_params [Hash{String => String}]
+        # @param url_params [Hash{String => Array<String>}]
         # @return [Array(Hash{String => Array<String>}, Hash{String => Array<String>}, Hash{String => Array<String>})]
         def partition_url_params(url_params)
           groups = T.let(url_params.to_a.group_by do |key, _values|
-                           # @sg-ignore
+                           # @sg-ignore Unresolved call to start_with? — T.let wrapping this
+                           #   chained group_by block seems to block block-param inference
                            if key.start_with? 'custom_field_'
                              :custom_field
-                           # @sg-ignore
+                           # @sg-ignore Unresolved call to include? — same T.let/block-param gap
                            elsif key.include? '_date'
                              :date
                            else

data/lib/checkoff/internal/search_url/results_merger.rb

@@ -17,8 +17,7 @@ module Checkoff
         end
 
         # @param task_selectors [Array<Symbol, Array>]
-        # @return [Array(Symbol, Array, Array)]
-        # @sg-ignore
+        # @return [Symbol, Array, Array(Symbol, Array, Array)]
         def self.merge_task_selectors(*task_selectors)
           return [] if task_selectors.empty?
 

data/lib/checkoff/internal/search_url/simple_param_converter.rb

@@ -31,6 +31,16 @@ module Checkoff
             end
           end
 
+          public
+
+          # @return [Array<String>]
+          # @sg-ignore abstract method always raises; declared type documents the override contract, not this body
+          def convert
+            raise 'Implement me!'
+          end
+
+          private
+
           # @return [String]
           attr_reader :key
 
@@ -226,7 +236,6 @@ module Checkoff
         # @return [Hash{String => String}] the converted params
         def convert
           # @type [Array<Array(String, String)>]
-          # @sg-ignore
           arr_of_tuples = simple_url_params.to_a.flat_map do |key, values|
             # @type
             entry = convert_arg(key, values).each_slice(2).to_a
@@ -265,14 +274,14 @@ module Checkoff
         # https://developers.asana.com/docs/search-tasks-in-a-workspace
         # @param key [String] the name of the search url param
         # @param values [Array<String>] the values of the search url param
-        # @sg-ignore
-        # @return [Hash{String => String}] the converted params
+        # @return [Array<String>] the converted params, as an alternating key/value flat array
         def convert_arg(key, values)
           # @type [Class<SimpleParam::SimpleParam>]
+          # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+          # https://github.com/castwide/solargraph/pull/1228
           clazz = ARGS.fetch(key)
           # @type [SimpleParam::SimpleParam]
           obj = clazz.new(key:, values:)
-          # @sg-ignore
           obj.convert
         end
 

data/lib/checkoff/internal/selector_classes/common/function_evaluator.rb

@@ -17,6 +17,9 @@ module Checkoff
           super()
         end
 
+        # @return [Checkoff::CustomFields]
+        attr_reader :custom_fields
+
         private
 
         # @return [Array(Symbol, Array), String]