checkoff 0.256.0 → 0.258.0

data/rbi/checkoff.rbi

@@ -82,7 +82,7 @@ module Overcommit
 end
 
 module Checkoff
-  VERSION = '0.256.0'
+  VERSION = '0.258.0'
 
   class Attachments
     include Logging
@@ -1289,10 +1289,10 @@ module Checkoff
     def h_to_task(task_data); end
 
     sig { params(task: T.untyped, portfolio_name: T.untyped, workspace_name: T.untyped).returns(T.untyped) }
-    def in_portfolio_named?(task, portfolio_name, workspace_name: @workspaces.default_workspace.name); end
+    def in_portfolio_named?(task, portfolio_name, workspace_name: T.must(@workspaces.default_workspace.name)); end
 
     sig { params(task: T.untyped, portfolio_name: T.untyped, workspace_name: T.untyped).returns(T.untyped) }
-    def in_portfolio_more_than_once?(task, portfolio_name, workspace_name: @workspaces.default_workspace.name); end
+    def in_portfolio_more_than_once?(task, portfolio_name, workspace_name: T.must(@workspaces.default_workspace.name)); end
 
     sig { returns(T.untyped) }
     def as_cache_key; end
@@ -1862,6 +1862,9 @@ module Checkoff
           sig { returns(T.untyped) }
           def single_value; end
 
+          sig { returns(T.untyped) }
+          def convert; end
+
           sig { returns(T.untyped) }
           attr_reader :key
 
@@ -1977,6 +1980,9 @@ module Checkoff
     class FunctionEvaluator
       include Logging
 
+      sig { params(selector: T.untyped, _kwargs: T.untyped).void }
+      def initialize(selector: nil, **_kwargs); end
+
       sig { params(_index: T.untyped).returns(T.untyped) }
       def evaluate_arg?(_index); end
 
@@ -2127,6 +2133,9 @@ module Checkoff
         sig { params(selector: T.untyped, custom_fields: T.untyped, _kwargs: T.untyped).void }
         def initialize(selector:, custom_fields:, **_kwargs); end
 
+        sig { returns(T.untyped) }
+        attr_reader :custom_fields
+
         sig { returns(T.untyped) }
         attr_reader :selector
       end
@@ -2182,6 +2191,15 @@ module Checkoff
         end
         def initialize(selector:, projects:, portfolios:, workspaces:, **_kwargs); end
 
+        sig { returns(T.untyped) }
+        attr_reader :projects
+
+        sig { returns(T.untyped) }
+        attr_reader :portfolios
+
+        sig { returns(T.untyped) }
+        attr_reader :workspaces
+
         sig { returns(T.untyped) }
         attr_reader :selector
       end
@@ -2220,10 +2238,13 @@ module Checkoff
         def initialize(selector:, sections:, client:, **kwargs); end
 
         sig { returns(T.untyped) }
-        attr_reader :selector
+        attr_reader :sections
 
         sig { returns(T.untyped) }
         attr_reader :client
+
+        sig { returns(T.untyped) }
+        attr_reader :selector
       end
     end
 
@@ -2449,7 +2470,7 @@ end
 # typed: ignore
 # Command-line and gem client for Asana (unofficial)
 module Checkoff
-  VERSION = T.let('0.256.0', T.untyped)
+  VERSION = T.let('0.258.0', T.untyped)
 
   # Move tasks from one place to another
   class MvSubcommand
@@ -2536,7 +2557,7 @@ module Checkoff
     def run; end
 
     # _@param_ `project_arg`
-    sig { params(project_arg: String).returns(T.any(Symbol, String)) }
+    sig { params(project_arg: T.any(Symbol, String)).returns(T.any(Symbol, String)) }
     def project_arg_to_name(project_arg); end
 
     # Returns the value of attribute from_workspace_name.
@@ -2792,7 +2813,7 @@ module Checkoff
     def tasks_by_tag_gid(workspace_name, tag_gid, only_uncompleted: true, extra_fields: []); end
 
     # sord warn - Asana::Resources::Tag wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -2973,7 +2994,8 @@ module Checkoff
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # Add a task
     # 
-    # @sg-ignore
+    # @sg-ignore @asana_task.create return type could not be inferred — calling a class method
+    #   through a Class<T>-typed ivar is a known Solargraph dispatch limitation
     # 
     # _@param_ `name`
     # 
@@ -2995,7 +3017,6 @@ module Checkoff
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # True if any of the task's dependencies are marked incomplete
     # 
-    # @sg-ignore
     # Include 'dependencies.gid' in extra_fields of task passed in.
     # 
     # _@param_ `task`
@@ -3042,7 +3063,7 @@ module Checkoff
     # 
     # _@param_ `workspace_name`
     sig { params(task: Asana::Resources::Task, portfolio_name: String, workspace_name: String).returns(T::Boolean) }
-    def in_portfolio_named?(task, portfolio_name, workspace_name: @workspaces.default_workspace.name); end
+    def in_portfolio_named?(task, portfolio_name, workspace_name: T.must(@workspaces.default_workspace.name)); end
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # True if the task is in a project which is in the given portfolio
@@ -3053,7 +3074,7 @@ module Checkoff
     # 
     # _@param_ `workspace_name`
     sig { params(task: Asana::Resources::Task, portfolio_name: String, workspace_name: String).returns(T::Boolean) }
-    def in_portfolio_more_than_once?(task, portfolio_name, workspace_name: @workspaces.default_workspace.name); end
+    def in_portfolio_more_than_once?(task, portfolio_name, workspace_name: T.must(@workspaces.default_workspace.name)); end
 
     sig { returns(T::Hash[T.untyped, T.untyped]) }
     def as_cache_key; end
@@ -3088,7 +3109,9 @@ module Checkoff
     sig { returns(Checkoff::Projects) }
     def projects; end
 
-    # @sg-ignore
+    # @sg-ignore @config.fetch return type could not be inferred — @config is intentionally
+    #   dual-typed [Hash, EnvFallbackConfigLoader] throughout this codebase; Solargraph can't
+    #   unify #fetch across that union
     sig { returns(String) }
     def default_assignee_gid; end
 
@@ -3115,7 +3138,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3223,7 +3246,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3343,7 +3366,7 @@ module Checkoff
     # _@param_ `period_name`
     # 
     # _@param_ `args`
-    sig { params(date_or_time: T.nilable(T.any(Date, Time)), period_name: Symbol, args: Object).returns(T::Boolean) }
+    sig { params(date_or_time: T.nilable(T.any(Date, Time)), period_name: Symbol, args: T::Array[Object]).returns(T::Boolean) }
     def compound_in_period?(date_or_time, period_name, *args); end
 
     sig { void }
@@ -3372,7 +3395,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
   end
@@ -3525,7 +3548,7 @@ module Checkoff
     def project(workspace_name, project_name, extra_fields: []); end
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -3645,7 +3668,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3730,7 +3753,7 @@ module Checkoff
     # _@param_ `extra_fields`
     sig do
       params(
-        workspace_name: String,
+        workspace_name: T.any(String, Symbol),
         project_name: T.any(String, Symbol),
         only_uncompleted: T::Boolean,
         extra_fields: T::Array[String]
@@ -3771,7 +3794,7 @@ module Checkoff
     def tasks(workspace_name, project_name, section_name, only_uncompleted: true, extra_fields: []); end
 
     # Pulls just names of tasks from a given section.
-    # @sg-ignore
+    # @sg-ignore Task#name is nilable; task names are assumed present here
     # 
     # _@param_ `workspace_name`
     # 
@@ -3909,7 +3932,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3987,10 +4010,10 @@ module Checkoff
     # expected to move to the new-style way of representing sections
     # as memberships with a separate API within a task.
     # 
-    # @sg-ignore
+    # @sg-ignore Checkoff::Subtasks#subtask_section? return type could not be inferred
     # 
     # _@param_ `subtask`
-    sig { params(subtask: Asana::Resources::Task).returns(T::Boolean) }
+    sig { params(subtask: Asana::Resources::Task).returns(T.nilable(T::Boolean)) }
     def subtask_section?(subtask); end
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
@@ -4209,7 +4232,7 @@ module Checkoff
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana), clients: Checkoff::Clients.new(config:), client: clients.client, projects: Checkoff::Projects.new(config:, client:), workspaces: Checkoff::Workspaces.new(config:, client:)); end
 
     # sord warn - Asana::Resources::Portfolio wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -4292,7 +4315,8 @@ module Checkoff
     def workspace(workspace_name); end
 
     # sord warn - Asana::Resources::Workspace wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore @asana_workspace.find_by_id return type could not be inferred — calling a
+    #   class method through a Class<T>-typed ivar is a known Solargraph dispatch limitation
     sig { returns(Asana::Resources::Workspace) }
     def default_workspace; end
 
@@ -4303,7 +4327,9 @@ module Checkoff
     sig { params(workspace_name: T.any(String, Symbol)).returns(Asana::Resources::Workspace) }
     def workspace_or_raise(workspace_name); end
 
-    # @sg-ignore
+    # @sg-ignore @config.fetch return type could not be inferred — @config is intentionally
+    #   dual-typed [Hash, EnvFallbackConfigLoader] throughout this codebase; Solargraph can't
+    #   unify #fetch across that union
     sig { returns(String) }
     def default_workspace_gid; end
 
@@ -4340,6 +4366,7 @@ module Checkoff
     end
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana), workspaces: Checkoff::Workspaces.new(config:), clients: Checkoff::Clients.new(config:), client: clients.client); end
 
+    # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Attachment wasn't able to be resolved to a constant in this project
     # _@param_ `url`
     # 
@@ -4353,7 +4380,7 @@ module Checkoff
     sig do
       params(
         url: String,
-        resource: Asana::Resources::Resource,
+        resource: Asana::Resources::Task,
         attachment_name: T.nilable(String),
         verify_mode: Integer,
         just_the_url: T::Boolean
@@ -4361,7 +4388,6 @@ module Checkoff
     end
     def create_attachment_from_url!(url, resource, attachment_name: nil, verify_mode: OpenSSL::SSL::VERIFY_PEER, just_the_url: false); end
 
-    # sord warn - URI wasn't able to be resolved to a constant in this project
     # Writes contents of URL to a temporary file with the same
     # extension as the URL using Net::HTTP, raising an exception if
     # not succesful
@@ -4369,7 +4395,7 @@ module Checkoff
     # _@param_ `uri`
     # 
     # _@param_ `verify_mode` — - e.g., OpenSSL::SSL::VERIFY_NONE,OpenSSL::SSL::VERIFY_PEER
-    sig { params(uri: URI, verify_mode: Integer, block: T.untyped).returns(Object) }
+    sig { params(uri: URI::Generic, verify_mode: Integer, block: T.untyped).returns(Object) }
     def download_uri(uri, verify_mode: OpenSSL::SSL::VERIFY_PEER, &block); end
 
     # sord duck - #read_body looks like a duck type, replacing with untyped
@@ -4377,6 +4403,7 @@ module Checkoff
     sig { params(response: T.untyped).void }
     def write_tempfile_from_response(response); end
 
+    # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Attachment wasn't able to be resolved to a constant in this project
     # _@param_ `url`
     # 
@@ -4388,20 +4415,21 @@ module Checkoff
     sig do
       params(
         url: String,
-        resource: Asana::Resources::Resource,
+        resource: Asana::Resources::Task,
         attachment_name: T.nilable(String),
         verify_mode: Integer
       ).returns(Asana::Resources::Attachment)
     end
     def create_attachment_from_downloaded_url!(url, resource, attachment_name:, verify_mode: OpenSSL::SSL::VERIFY_PEER); end
 
+    # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Attachment wasn't able to be resolved to a constant in this project
     # _@param_ `url`
     # 
     # _@param_ `resource`
     # 
     # _@param_ `attachment_name`
-    sig { params(url: String, resource: Asana::Resources::Resource, attachment_name: T.nilable(String)).returns(Asana::Resources::Attachment) }
+    sig { params(url: String, resource: Asana::Resources::Task, attachment_name: T.nilable(String)).returns(Asana::Resources::Attachment) }
     def create_attachment_from_url_alone!(url, resource, attachment_name:); end
 
     # _@param_ `filename`
@@ -4441,7 +4469,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -4483,7 +4511,7 @@ module Checkoff
                                                         client:)); end
 
     # sord warn - Asana::Resources::CustomField wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -4508,7 +4536,9 @@ module Checkoff
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @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.
     # 
     # _@param_ `resource`
     # 
@@ -4526,7 +4556,7 @@ module Checkoff
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `resource`
     # 
@@ -4536,7 +4566,7 @@ module Checkoff
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-    # @sg-ignore
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `resource`
     # 
@@ -4544,7 +4574,9 @@ module Checkoff
     sig { params(resource: T.any(Asana::Resources::Project, Asana::Resources::Task), custom_field_gid: String).returns(T::Hash[T.untyped, T.untyped]) }
     def resource_custom_field_by_gid_or_raise(resource, custom_field_gid); end
 
-    # @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.
     # 
     # _@param_ `custom_field`
     sig { params(custom_field: T::Hash[String, T.any(T::Hash[T.untyped, T.untyped], T::Array[T::Hash[T.untyped, T.untyped]])]).returns(T::Array[T::Hash[T.untyped, T.untyped]]) }
@@ -4689,10 +4721,11 @@ module Checkoff
     sig { params(api_params: T::Hash[String, Object], workspace_gid: String, extra_fields: T::Array[String]).returns(T::Enumerable[Asana::Resources::Task]) }
     def iterated_raw_task_search(api_params, workspace_gid:, extra_fields:); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — bracket access on a Hash{Symbol=>undefined}
+    #   local doesn't narrow even with a T.cast on the return expression
     # 
     # _@param_ `extra_fields`
-    sig { params(extra_fields: T::Array[String]).returns(T::Hash[Symbol, T.untyped]) }
+    sig { params(extra_fields: T::Array[String]).returns(T::Hash[Symbol, T::Array[String]]) }
     def calculate_api_options(extra_fields); end
 
     sig { void }
@@ -4721,7 +4754,7 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -4779,15 +4812,15 @@ module Checkoff
     sig { params(task: Asana::Resources::Task, task_selector: T.any(Symbol, T::Array[T.any(Symbol, Integer, T::Array[T.untyped])])).returns(T::Boolean) }
     def filter_via_task_selector(task, task_selector); end
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     sig { returns(String) }
     def self.project_name; end
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     sig { returns(String) }
     def self.workspace_name; end
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     sig { returns([Symbol, T::Array[T.untyped]]) }
     def self.task_selector; end
 
@@ -4994,14 +5027,16 @@ module Checkoff
       def initialize(time_class: Time, date_class: Date, client: Checkoff::Clients.new.client, custom_fields: Checkoff::CustomFields.new(client:)); end
 
       # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — #to_time called via &. on a Date|Time
+      #   union receiver
       # 
       # _@param_ `task`
       sig { params(task: Asana::Resources::Task).returns(T.nilable(Time)) }
       def start_time(task); end
 
       # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — #to_time called via &. on a Date|Time
+      #   union receiver
       # 
       # _@param_ `task`
       sig { params(task: Asana::Resources::Task).returns(T.nilable(Time)) }
@@ -5041,7 +5076,8 @@ module Checkoff
     class ThreadLocal
       # sord warn - T wasn't able to be resolved to a constant in this project
       # sord warn - T wasn't able to be resolved to a constant in this project
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — Solargraph's generic/yield-return
+      #   inference gap for #with_thread_local_variable
       # 
       # _@param_ `name`
       # 
@@ -5061,7 +5097,7 @@ module Checkoff
       sig { params(config: T::Hash[Symbol, T.untyped], sym: Symbol, yaml_filename: String).void }
       def initialize(config, sym, yaml_filename); end
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       # 
       # _@param_ `key`
       sig { params(key: Symbol).returns(Object) }
@@ -5180,7 +5216,7 @@ module Checkoff
         def convert_custom_field_params(custom_field_params); end
 
         # _@param_ `url_params`
-        sig { params(url_params: T::Hash[String, String]).returns([T::Hash[String, T::Array[String]], T::Hash[String, T::Array[String]], T::Hash[String, T::Array[String]]]) }
+        sig { params(url_params: T::Hash[String, T::Array[String]]).returns([T::Hash[String, T::Array[String]], T::Hash[String, T::Array[String]], T::Hash[String, T::Array[String]]]) }
         def partition_url_params(url_params); end
       end
 
@@ -5190,10 +5226,8 @@ module Checkoff
         sig { params(args: T::Array[T::Hash[String, String]]).returns(T::Hash[String, String]) }
         def self.merge_args(*args); end
 
-        # @sg-ignore
-        # 
         # _@param_ `task_selectors`
-        sig { params(task_selectors: T::Array[T.any(Symbol, T::Array[T.untyped])]).returns([Symbol, T::Array[T.untyped], T::Array[T.untyped]]) }
+        sig { params(task_selectors: T::Array[T.any(Symbol, T::Array[T.untyped])]).returns(T.any(Symbol, T::Array[T.untyped], [Symbol, T::Array[T.untyped], T::Array[T.untyped]])) }
         def self.merge_task_selectors(*task_selectors); end
       end
 
@@ -5305,7 +5339,7 @@ module Checkoff
         sig { params(date_url_params: T::Hash[String, T::Array[String]]).void }
         def initialize(date_url_params:); end
 
-        # @sg-ignore
+        # @sg-ignore out can genuinely be nil if none of the 3 known prefixes matched; relies on the raise above it
         sig { returns([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]]) }
         def convert; end
 
@@ -5337,7 +5371,7 @@ module Checkoff
         sig { params(prefix: String).returns([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]]) }
         def handle_within_next(prefix); end
 
-        # @sg-ignore
+        # @sg-ignore value.length == 1 guard above isn't inferred as narrowing value[0] to non-nil
         # 
         # _@param_ `param_key`
         sig { params(param_key: String).returns(String) }
@@ -5386,6 +5420,10 @@ module Checkoff
           sig { params(verb: String).returns(T::Array[String]) }
           def convert_from_projects_and_sections(verb); end
 
+          # @sg-ignore abstract method always raises; declared type documents the override contract, not this body
+          sig { returns(T::Array[String]) }
+          def convert; end
+
           sig { returns(String) }
           attr_reader :key
 
@@ -5500,14 +5538,13 @@ module Checkoff
         def convert; end
 
         # https://developers.asana.com/docs/search-tasks-in-a-workspace
-        # @sg-ignore
         # 
         # _@param_ `key` — the name of the search url param
         # 
         # _@param_ `values` — the values of the search url param
         # 
-        # _@return_ — the converted params
-        sig { params(key: String, values: T::Array[String]).returns(T::Hash[String, String]) }
+        # _@return_ — the converted params, as an alternating key/value flat array
+        sig { params(key: String, values: T::Array[String]).returns(T::Array[String]) }
         def convert_arg(key, values); end
 
         sig { returns(T::Hash[String, T::Array[String]]) }
@@ -5540,7 +5577,7 @@ module Checkoff
         sig { returns(T::Hash[String, T::Hash[T.untyped, T.untyped]]) }
         def by_custom_field; end
 
-        # @sg-ignore
+        # @sg-ignore `unless variant_class.nil?` return value isn't inferred as the declared tuple type
         # 
         # _@param_ `gid`
         # 
@@ -5548,7 +5585,7 @@ module Checkoff
         sig { params(gid: String, single_custom_field_params: T::Hash[String, T::Array[String]]).returns([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]]) }
         def convert_single_custom_field_params(gid, single_custom_field_params); end
 
-        # @sg-ignore
+        # @sg-ignore split(...)[n]'s nilable Array indexing isn't inferred as the declared String return
         # 
         # _@param_ `key`
         sig { params(key: String).returns(String) }
@@ -5641,7 +5678,7 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
     end
@@ -5709,10 +5746,8 @@ module Checkoff
       sig { params(gid: String, resource_type: T.nilable(String)).returns([T.untyped, T.untyped, T.untyped, T.untyped]) }
       def enrich_gid(gid, resource_type: nil); end
 
-      # @sg-ignore
-      # 
       # _@param_ `filter`
-      sig { params(filter: T::Hash[String, T.any(String, T::Array[String])]).returns(T.nilable(String)) }
+      sig { params(filter: T::Hash[String, T.any(String, T::Array[String])]).void }
       def enrich_filter_parent_gid!(filter); end
 
       # _@param_ `filter`
@@ -5723,14 +5758,12 @@ module Checkoff
       sig { params(filter: T::Hash[String, T.any(String, T::Array[String])]).void }
       def enrich_filter_section!(filter); end
 
-      # sord warn - "'resource'" does not appear to be a type
       # _@param_ `asana_event`
-      sig { params(asana_event: T::Hash[T.untyped, T::Hash[T.untyped, T.untyped]]).void }
+      sig { params(asana_event: T::Hash[T.untyped, T.untyped]).void }
       def enrich_event_parent!(asana_event); end
 
-      # sord warn - "'resource'" does not appear to be a type
       # _@param_ `asana_event`
-      sig { params(asana_event: T::Hash[T.untyped, T::Hash[T.untyped, T.untyped]]).void }
+      sig { params(asana_event: T::Hash[T.untyped, T.untyped]).void }
       def enrich_event_resource!(asana_event); end
 
       sig { returns(::Logger) }
@@ -5756,7 +5789,7 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
 
@@ -5790,20 +5823,20 @@ module Checkoff
     sig { returns(T::Hash[T.untyped, T.untyped]) }
     def initializer_kwargs; end
 
-    # @sg-ignore
+    # @sg-ignore abstract method always raises; declared type documents the override contract, not this body
     sig { returns(T::Array[T.class_of(Checkoff::SelectorClasses::FunctionEvaluator)]) }
     def function_evaluators; end
 
     # _@param_ `selector`
     # 
     # _@param_ `evaluator`
-    sig { params(selector: T::Array[T.untyped], evaluator: Checkoff::SelectorClasses::FunctionEvaluator).returns(T::Array[T.untyped]) }
+    sig { params(selector: T.any(Symbol, T::Array[T.untyped]), evaluator: Checkoff::SelectorClasses::FunctionEvaluator).returns(T::Array[T.untyped]) }
     def evaluate_args(selector, evaluator); end
 
     # _@param_ `selector`
     # 
     # _@param_ `evaluator`
-    sig { params(selector: T::Array[T.untyped], evaluator: Checkoff::SelectorClasses::FunctionEvaluator).returns(T.nilable(T.any(T::Boolean, Object))) }
+    sig { params(selector: T.any(Symbol, T::Array[T.untyped]), evaluator: Checkoff::SelectorClasses::FunctionEvaluator).returns(T.nilable(T.any(T::Boolean, Object))) }
     def try_this_evaluator(selector, evaluator); end
 
     sig { returns(Asana::Resources::Resource) }
@@ -5837,8 +5870,6 @@ module Checkoff
         def evaluate_arg?(_index); end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
         # _@param_ `task`
         # 
         # _@param_ `section_name_prefix`
@@ -5856,8 +5887,6 @@ module Checkoff
         def evaluate_arg?(_index); end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
         # _@param_ `task`
         # 
         # _@param_ `section_name`
@@ -5875,7 +5904,8 @@ module Checkoff
         def evaluate_arg?(_index); end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
+        # https://github.com/castwide/solargraph/pull/1228
         # 
         # _@param_ `task`
         # 
@@ -5911,8 +5941,6 @@ module Checkoff
         def evaluate_arg?(_index); end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
         # _@param_ `task`
         # 
         # _@param_ `tag_name`
@@ -6089,7 +6117,8 @@ module Checkoff
         def evaluate_arg?(_index); end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore Checkoff::SelectorClasses::Task::MilestonePFunctionEvaluator#evaluate
+        #   return type could not be inferred
         # 
         # _@param_ `task`
         sig { params(task: Asana::Resources::Task).returns(T::Boolean) }
@@ -6264,10 +6293,6 @@ module Checkoff
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # @sg-ignore
-        # @sg-ignore
-        # 
         # _@param_ `resource`
         # 
         # _@param_ `custom_field_gid`
@@ -6287,9 +6312,6 @@ module Checkoff
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # @sg-ignore
-        # 
         # _@param_ `resource`
         # 
         # _@param_ `custom_field_gid`
@@ -6311,9 +6333,6 @@ module Checkoff
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # @sg-ignore
-        # 
         # _@param_ `resource`
         # 
         # _@param_ `custom_field_name`
@@ -6358,7 +6377,8 @@ module Checkoff
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
         # sord warn - boolish is probably not a type, but using anyway
         # sord warn - boolish wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore Checkoff::SelectorClasses::Common::NameStartsWithPFunctionEvaluator#evaluate
+        #   return type could not be inferred
         # 
         # _@param_ `resource`
         # 
@@ -6374,7 +6394,7 @@ module Checkoff
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore selector is only String here per matches?'s is_a?(String) check, in another method
         # 
         # _@param_ `_resource`
         sig { params(_resource: T.any(Asana::Resources::Task, Asana::Resources::Project)).returns(String) }
@@ -6393,6 +6413,9 @@ module Checkoff
 
         sig { returns(T.any([Symbol, T::Array[T.untyped]], String)) }
         attr_reader :selector
+
+        sig { returns(Checkoff::CustomFields) }
+        attr_reader :custom_fields
       end
     end
 
@@ -6406,7 +6429,7 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore nilable return from an @!parse-declared method isn't inferred
         # 
         # _@param_ `resource`
         sig { params(resource: Asana::Resources::Project).returns(T.nilable(String)) }
@@ -6421,8 +6444,6 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
         # _@param_ `project`
         # 
         # _@param_ `period` — - :now_or_before or :this_week
@@ -6438,10 +6459,6 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
-        # @sg-ignore
-        # 
         # _@param_ `project`
         # 
         # _@param_ `portfolio_name`
@@ -6484,6 +6501,15 @@ module Checkoff
 
         sig { returns([Symbol, T::Array[T.untyped]]) }
         attr_reader :selector
+
+        sig { returns(Checkoff::Projects) }
+        attr_reader :projects
+
+        sig { returns(Checkoff::Portfolios) }
+        attr_reader :portfolios
+
+        sig { returns(Checkoff::Workspaces) }
+        attr_reader :workspaces
       end
     end
 
@@ -6497,7 +6523,7 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Section wasn't able to be resolved to a constant in this project
-        # @sg-ignore
+        # @sg-ignore String, nil safe-nav chain isn't inferred as returning Boolean
         # 
         # _@param_ `section`
         sig { params(section: Asana::Resources::Section).returns(T::Boolean) }
@@ -6512,8 +6538,6 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Section wasn't able to be resolved to a constant in this project
-        # @sg-ignore
-        # 
         # _@param_ `section`
         sig { params(section: Asana::Resources::Section).returns(T::Boolean) }
         def evaluate(section); end
@@ -6545,6 +6569,9 @@ module Checkoff
         # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
         sig { returns(Asana::Client) }
         attr_reader :client
+
+        sig { returns(Checkoff::Sections) }
+        attr_reader :sections
       end
     end
 
@@ -6556,12 +6583,12 @@ module Checkoff
       sig { params(_index: Integer).returns(T::Boolean) }
       def evaluate_arg?(_index); end
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — abstract method body is only `raise`
       sig { returns(T::Boolean) }
       def matches?; end
 
       # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — abstract method body is only `raise`
       # 
       # _@param_ `_task`
       # 
@@ -6575,6 +6602,20 @@ module Checkoff
       sig { params(object: Object, fn_name: Symbol).returns(T::Boolean) }
       def fn?(object, fn_name); end
 
+      # Concrete subclasses each declare their own initialize with their
+      # specific keyword args (and set @selector themselves before calling
+      # super()); this signature exists only so Solargraph can resolve
+      # `evaluator_class.new(selector:, **kwargs)` call sites that hold a
+      # `Class<FunctionEvaluator>` reference rather than a concrete subclass -
+      # deliberately a no-op so a bare `super()` call from those subclasses
+      # can't clobber the @selector they already set.
+      # 
+      # _@param_ `selector`
+      # 
+      # _@param_ `_kwargs`
+      sig { params(selector: T.nilable(T.any(Symbol, T::Array[T.untyped], String)), _kwargs: T::Hash[T.untyped, T.untyped]).void }
+      def initialize(selector: nil, **_kwargs); end
+
       sig { returns(::Logger) }
       def logger; end
 
@@ -6598,7 +6639,7 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
     end
@@ -6791,7 +6832,7 @@ module Logging
   sig { params(message: T.nilable(Object), block: T.untyped).void }
   def finer(message = nil, &block); end
 
-  # @sg-ignore
+  # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
   sig { returns(Symbol) }
   def log_level; end
 end