checkoff 0.258.0 → 0.260.0

data/rbi/checkoff.rbi

@@ -82,7 +82,7 @@ module Overcommit
 end
 
 module Checkoff
-  VERSION = '0.258.0'
+  VERSION = '0.260.0'
 
   class Attachments
     include Logging
@@ -811,6 +811,9 @@ module Checkoff
     sig { params(gid: T.untyped, resource_type: T.untyped).returns(T.untyped) }
     def resource_by_gid(gid, resource_type: nil); end
 
+    sig { params(resource_type: T.untyped, gid: T.untyped).returns(T.untyped) }
+    def fetch_gid_by_type(resource_type, gid); end
+
     sig { params(gid: T.untyped).returns(T.untyped) }
     def fetch_task_gid(gid); end
 
@@ -1195,13 +1198,16 @@ module Checkoff
     attr_reader :custom_fields
 
     sig { returns(T.untyped) }
-    def self.project_name; end
+    def self.task_selector; end
+
+    sig { params(parsed: T.untyped).returns(T.untyped) }
+    def self.validate_task_selector(parsed); end
 
     sig { returns(T.untyped) }
-    def self.workspace_name; end
+    def self.project_name; end
 
     sig { returns(T.untyped) }
-    def self.task_selector; end
+    def self.workspace_name; end
 
     sig { returns(T.untyped) }
     def self.run; end
@@ -1630,6 +1636,9 @@ module Checkoff
       sig { params(task_hash: T.untyped, memberships: T.untyped).returns(T.untyped) }
       def add_user_task_list(task_hash, memberships); end
 
+      sig { params(task_hash: T.untyped).returns(T.untyped) }
+      def assignee_hash(task_hash); end
+
       sig do
         params(
           task_hash: T.untyped,
@@ -1721,6 +1730,9 @@ module Checkoff
           sig { params(gid: T.untyped, remaining_params: T.untyped).void }
           def initialize(gid, remaining_params); end
 
+          sig { returns(T.untyped) }
+          def convert; end
+
           sig { returns(T.untyped) }
           attr_reader :gid
 
@@ -1798,6 +1810,9 @@ module Checkoff
         sig { returns(T.untyped) }
         def convert; end
 
+        sig { params(out: T.untyped).returns(T.untyped) }
+        def ensure_matched!(out); end
+
         sig { params(prefix: T.untyped).returns(T.untyped) }
         def convert_for_prefix(prefix); end
 
@@ -2470,7 +2485,7 @@ end
 # typed: ignore
 # Command-line and gem client for Asana (unofficial)
 module Checkoff
-  VERSION = T.let('0.258.0', T.untyped)
+  VERSION = T.let('0.260.0', T.untyped)
 
   # Move tasks from one place to another
   class MvSubcommand
@@ -2617,7 +2632,7 @@ module Checkoff
         workspace_name: String,
         project_name: T.any(String, Symbol),
         section_name: T.nilable(T.any(String, Symbol)),
-        task_name: T.nilable(T.any(String, Symbol)),
+        task_name: T.nilable(String),
         config: T.any(Checkoff::Internal::EnvFallbackConfigLoader, T::Hash[T.untyped, T.untyped]),
         projects: Checkoff::Projects,
         sections: Checkoff::Sections,
@@ -2813,8 +2828,6 @@ 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 nil check above is not flow-sensitive
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `tag_name`
@@ -2885,7 +2898,7 @@ module Checkoff
     # _@param_ `asana_task`
     sig do
       params(
-        config: T.any(T::Hash[T.untyped, T.untyped], Checkoff::Internal::EnvFallbackConfigLoader),
+        config: T.any(T::Hash[Symbol, Object], Checkoff::Internal::EnvFallbackConfigLoader),
         client: Asana::Client,
         workspaces: Checkoff::Workspaces,
         sections: Checkoff::Sections,
@@ -2994,9 +3007,6 @@ module Checkoff
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # Add a task
     # 
-    # @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`
     # 
     # _@param_ `workspace_gid`
@@ -3049,14 +3059,12 @@ module Checkoff
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # _@param_ `task_data`
-    sig { params(task_data: T::Hash[T.untyped, T.untyped]).returns(Asana::Resources::Task) }
+    sig { params(task_data: T::Hash[String, Object]).returns(Asana::Resources::Task) }
     def h_to_task(task_data); 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
     # 
-    # @sg-ignore Checkoff::Tasks#in_portfolio_named? return type could not be inferred
-    # 
     # _@param_ `task`
     # 
     # _@param_ `portfolio_name`
@@ -3109,9 +3117,6 @@ module Checkoff
     sig { returns(Checkoff::Projects) }
     def projects; end
 
-    # @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
 
@@ -3138,7 +3143,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3246,7 +3250,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3298,7 +3301,7 @@ module Checkoff
     # _@param_ `date_or_time`
     # 
     # _@param_ `period` — Valid values: :this_week, :now_or_before, :indefinite, [:less_than_n_days_ago, Integer]
-    sig { params(date_or_time: T.nilable(T.any(Date, Time)), period: T.any(Symbol, [Symbol, Integer])).returns(T::Boolean) }
+    sig { params(date_or_time: T.nilable(T.any(Date, Time)), period: T.any(Symbol, T::Array[T.any(Symbol, Integer)])).returns(T::Boolean) }
     def in_period?(date_or_time, period); end
 
     # _@param_ `date_or_time`
@@ -3347,8 +3350,6 @@ module Checkoff
     sig { params(num_days: Integer).returns(ActiveSupport::TimeWithZone) }
     def n_days_from_now(num_days); end
 
-    # @sg-ignore Checkoff::Timing#n_days_from_today return type could not be inferred
-    # 
     # _@param_ `num_days`
     sig { params(num_days: Integer).returns(Date) }
     def n_days_from_today(num_days); end
@@ -3395,7 +3396,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
   end
@@ -3520,6 +3520,12 @@ module Checkoff
 
     # Default options used in Asana API to pull tasks
     # 
+    # Keys are :per_page (Integer), :options (a Hash whose :fields is an
+    # Array<String>) and, when only_uncompleted is set, :completed_since
+    # (String). The value type is genuinely per-key, which a single YARD
+    # Hash value type cannot express.
+    # Callers who want the field list should call #task_fields directly.
+    # 
     # _@param_ `extra_fields`
     # 
     # _@param_ `only_uncompleted`
@@ -3548,8 +3554,6 @@ 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 nil check above is not flow-sensitive
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `project_name` — - :my_tasks or a project name
@@ -3606,8 +3610,8 @@ module Checkoff
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
     # _@param_ `project_obj`
     # 
-    # _@param_ `project` — - :not_specified, :my_tasks or a project name
-    sig { params(project_obj: Asana::Resources::Project, project: T.any(String, Symbol)).returns(T::Hash[T.untyped, T.untyped]) }
+    # _@param_ `project` — - a String is a project name
+    sig { params(project_obj: Asana::Resources::Project, project: T.nilable(T.any(String, Symbol))).returns(T::Hash[String, Object]) }
     def project_to_h(project_obj, project: :not_specified); end
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
@@ -3621,7 +3625,7 @@ module Checkoff
     # _@param_ `project`
     # 
     # _@param_ `period` — See Checkoff::Timing#in_period? - :now_or_before,:this_week
-    sig { params(project: Asana::Resources::Project, period: T.any(Symbol, [Symbol, Integer])).returns(T::Boolean) }
+    sig { params(project: Asana::Resources::Project, period: T.any(Symbol, T::Array[T.any(Symbol, Integer)])).returns(T::Boolean) }
     def project_ready?(project, period: :now_or_before); end
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
@@ -3630,7 +3634,7 @@ module Checkoff
     # _@param_ `field_name`
     # 
     # _@param_ `period` — See Checkoff::Timing#in_period? - :now_or_before,:this_week
-    sig { params(project: Asana::Resources::Project, field_name: T.any(Symbol, T::Array[T.untyped]), period: T.any(Symbol, [Symbol, Integer])).returns(T::Boolean) }
+    sig { params(project: Asana::Resources::Project, field_name: T.any(Symbol, T::Array[T.untyped]), period: T.any(Symbol, T::Array[T.any(Symbol, Integer)])).returns(T::Boolean) }
     def in_period?(project, field_name, period); end
 
     sig { returns(T::Hash[T.untyped, T.untyped]) }
@@ -3668,7 +3672,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -3794,7 +3797,6 @@ 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 Task#name is nilable; task names are assumed present here
     # 
     # _@param_ `workspace_name`
     # 
@@ -3805,8 +3807,6 @@ module Checkoff
     def section_task_names(workspace_name, project_name, section_name); end
 
     # sord warn - Asana::Resources::Section wasn't able to be resolved to a constant in this project
-    # @sg-ignore section() is nil-checked below
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `project_name`
@@ -3901,8 +3901,6 @@ module Checkoff
     def file_task_by_section(by_section, task, project_gid); end
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-    # @sg-ignore projects.project may be nil but is raised below
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `project_name`
@@ -3932,7 +3930,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -4010,8 +4007,6 @@ module Checkoff
     # expected to move to the new-style way of representing sections
     # as memberships with a separate API within a task.
     # 
-    # @sg-ignore Checkoff::Subtasks#subtask_section? return type could not be inferred
-    # 
     # _@param_ `subtask`
     sig { params(subtask: Asana::Resources::Task).returns(T.nilable(T::Boolean)) }
     def subtask_section?(subtask); end
@@ -4101,6 +4096,12 @@ module Checkoff
     sig { void }
     def self.run; end
 
+    # _@param_ `resource_type`
+    # 
+    # _@param_ `gid`
+    sig { params(resource_type: String, gid: String).returns(T.nilable(Asana::Resources::Resource)) }
+    def fetch_gid_by_type(resource_type, gid); end
+
     sig { returns(Checkoff::Workspaces) }
     attr_reader :workspaces
 
@@ -4185,7 +4186,7 @@ module Checkoff
     # _@param_ `task_data`
     # 
     # _@param_ `section`
-    sig { params(task_data: T::Hash[T.untyped, T.untyped], section: Asana::Resources::Section).returns(T::Boolean) }
+    sig { params(task_data: T::Hash[String, Object], section: Asana::Resources::Section).returns(T::Boolean) }
     def task_data_dependent_on_previous_section_last_milestone?(task_data, section); end
 
     sig { void }
@@ -4232,8 +4233,6 @@ 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 nil check above is not flow-sensitive
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `portfolio_name`
@@ -4304,7 +4303,7 @@ module Checkoff
     # _@param_ `client`
     # 
     # _@param_ `asana_workspace`
-    sig { params(config: T.any(T::Hash[T.untyped, T.untyped], Checkoff::Internal::EnvFallbackConfigLoader), client: Asana::Client, asana_workspace: T.class_of(Asana::Resources::Workspace)).void }
+    sig { params(config: T.any(T::Hash[Symbol, Object], Checkoff::Internal::EnvFallbackConfigLoader), client: Asana::Client, asana_workspace: T.class_of(Asana::Resources::Workspace)).void }
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana), client: Checkoff::Clients.new(config:).client, asana_workspace: Asana::Resources::Workspace); end
 
     # sord warn - Asana::Resources::Workspace wasn't able to be resolved to a constant in this project
@@ -4315,21 +4314,14 @@ 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 @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
 
     # sord warn - Asana::Resources::Workspace wasn't able to be resolved to a constant in this project
-    # @sg-ignore workspace() is nil-checked below
-    # 
     # _@param_ `workspace_name`
     sig { params(workspace_name: T.any(String, Symbol)).returns(Asana::Resources::Workspace) }
     def workspace_or_raise(workspace_name); end
 
-    # @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
 
@@ -4469,7 +4461,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -4511,8 +4502,6 @@ module Checkoff
                                                         client:)); end
 
     # sord warn - Asana::Resources::CustomField wasn't able to be resolved to a constant in this project
-    # @sg-ignore nil check above is not flow-sensitive
-    # 
     # _@param_ `workspace_name`
     # 
     # _@param_ `custom_field_name`
@@ -4536,10 +4525,6 @@ 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 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`
     # 
     # _@param_ `custom_field_name`
@@ -4551,41 +4536,41 @@ module Checkoff
     # _@param_ `resource`
     # 
     # _@param_ `custom_field_name`
-    sig { params(resource: T.any(Asana::Resources::Task, Asana::Resources::Project), custom_field_name: String).returns(T.nilable(T::Hash[T.untyped, T.untyped])) }
+    sig { params(resource: T.any(Asana::Resources::Task, Asana::Resources::Project), custom_field_name: String).returns(T.nilable(T::Hash[String, Object])) }
     def resource_custom_field_by_name(resource, custom_field_name); end
 
     # 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 nil check above is not flow-sensitive
-    # 
     # _@param_ `resource`
     # 
     # _@param_ `custom_field_name`
-    sig { params(resource: T.any(Asana::Resources::Task, Asana::Resources::Project), custom_field_name: String).returns(T::Hash[T.untyped, T.untyped]) }
+    sig { params(resource: T.any(Asana::Resources::Task, Asana::Resources::Project), custom_field_name: String).returns(T::Hash[String, Object]) }
     def resource_custom_field_by_name_or_raise(resource, custom_field_name); end
 
     # 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 nil check above is not flow-sensitive
-    # 
     # _@param_ `resource`
     # 
     # _@param_ `custom_field_gid`
-    sig { params(resource: T.any(Asana::Resources::Project, Asana::Resources::Task), custom_field_gid: String).returns(T::Hash[T.untyped, T.untyped]) }
+    sig { params(resource: T.any(Asana::Resources::Project, Asana::Resources::Task), custom_field_gid: String).returns(T::Hash[String, Object]) }
     def resource_custom_field_by_gid_or_raise(resource, custom_field_gid); end
 
-    # @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.
+    # sord warn - "\"resource_subtype\"" does not appear to be a type
+    # sord warn - "String} & Hash{\"enum_value\"" does not appear to be a type
+    # sord warn - "Hash} & Hash{\"multi_enum_values\"" does not appear to be a type
+    # sord warn - "\"gid\"" does not appear to be a type
+    # sord warn - "String} & Hash{\"name\"" does not appear to be a type
+    # rubocop:disable Layout/LineLength, YARD/TagTypeSyntax
+    # rubocop:enable Layout/LineLength, YARD/TagTypeSyntax
     # 
     # _@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]]) }
+    sig { params(custom_field: T::Hash[T.untyped, T.any(T.untyped, T.any(T.untyped, T::Array[T::Hash[T.untyped, T.untyped]]))]).returns(T::Array[T::Hash[T.untyped, T.any(T.untyped, String)]]) }
     def resource_custom_field_enum_values(custom_field); end
 
     # _@param_ `custom_field`
     # 
     # _@param_ `enum_value`
-    sig { params(custom_field: T::Hash[T.untyped, T.untyped], enum_value: T.nilable(T::Hash[String, String])).returns(T::Array[String]) }
+    sig { params(custom_field: T::Hash[String, Object], enum_value: T.nilable(T::Hash[String, String])).returns(T::Array[String]) }
     def find_gids(custom_field, enum_value); end
 
     sig { void }
@@ -4721,9 +4706,6 @@ 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 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::Array[String]]) }
     def calculate_api_options(extra_fields); end
@@ -4754,7 +4736,6 @@ module Checkoff
     sig { params(message: T.nilable(Object), block: T.untyped).void }
     def finer(message = nil, &block); end
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     sig { returns(Symbol) }
     def log_level; end
 
@@ -4809,24 +4790,25 @@ module Checkoff
     # _@param_ `task`
     # 
     # _@param_ `task_selector` — Filter based on task details.  Examples: [:tag, 'foo'] [:not, [:tag, 'foo']] [:tag, 'foo']
-    sig { params(task: Asana::Resources::Task, task_selector: T.any(Symbol, T::Array[T.any(Symbol, Integer, T::Array[T.untyped])])).returns(T::Boolean) }
+    sig { params(task: Asana::Resources::Task, task_selector: T.any(Symbol, T::Array[T.any(Symbol, String, Integer, T::Array[T.untyped])])).returns(T::Boolean) }
     def filter_via_task_selector(task, task_selector); end
 
-    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     sig { returns(String) }
     def self.project_name; end
 
-    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     sig { returns(String) }
     def self.workspace_name; end
 
-    # @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
 
     sig { void }
     def self.run; end
 
+    # _@param_ `parsed` — result of JSON.parse on a task selector
+    sig { params(parsed: Object).returns([String, T::Array[T.untyped]]) }
+    def self.validate_task_selector(parsed); end
+
     sig { returns(Checkoff::Tasks) }
     attr_reader :tasks
 
@@ -4877,7 +4859,7 @@ module Checkoff
     # _@param_ `project`
     # 
     # _@param_ `project_selector` — Filter based on project details.  Examples: [:tag, 'foo'] [:not, [:tag, 'foo']] [:tag, 'foo']
-    sig { params(project: Asana::Resources::Project, project_selector: [Symbol, T::Array[T.untyped]]).returns(T::Boolean) }
+    sig { params(project: Asana::Resources::Project, project_selector: T::Array[T.any(Symbol, String, T::Array[T.untyped])]).returns(T::Boolean) }
     def filter_via_project_selector(project, project_selector); end
 
     sig { void }
@@ -4971,7 +4953,7 @@ module Checkoff
       # _@param_ `task_data`
       # 
       # _@param_ `client`
-      sig { params(task_data: T::Hash[T.untyped, T.untyped], client: Asana::Client).returns(Asana::Resources::Task) }
+      sig { params(task_data: T::Hash[String, Object], client: Asana::Client).returns(Asana::Resources::Task) }
       def h_to_task(task_data, client:); end
 
       # _@param_ `task_hash`
@@ -4993,7 +4975,7 @@ module Checkoff
       # _@param_ `key`
       sig do
         params(
-          task_hash: T::Hash[T.untyped, T.untyped],
+          task_hash: T::Hash[String, Object],
           memberships: T::Array[T::Hash[T.untyped, T.untyped]],
           resource: String,
           key: String
@@ -5002,8 +4984,12 @@ module Checkoff
       def unwrap_memberships(task_hash, memberships, resource, key); end
 
       # _@param_ `task_hash`
-      sig { params(task_hash: T::Hash[T.untyped, T.untyped]).void }
+      sig { params(task_hash: T::Hash[String, Object]).void }
       def unwrap_all_memberships(task_hash); end
+
+      # _@param_ `task_hash`
+      sig { params(task_hash: T::Hash[String, T.any(String, T::Hash[T.untyped, T.untyped], T::Array[T.untyped])]).returns(T::Hash[String, Object]) }
+      def assignee_hash(task_hash); end
     end
 
     # Utility methods for working with task dates and times
@@ -5027,17 +5013,11 @@ 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 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 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 due_time(task); end
@@ -5076,9 +5056,6 @@ 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 return type could not be inferred — Solargraph's generic/yield-return
-      #   inference gap for #with_thread_local_variable
-      # 
       # _@param_ `name`
       # 
       # _@param_ `value`
@@ -5097,8 +5074,6 @@ 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 return type could not be inferred — cascades from the ENV.fetch RBS gap below
-      # 
       # _@param_ `key`
       sig { params(key: Symbol).returns(Object) }
       def [](key); end
@@ -5137,8 +5112,8 @@ module Checkoff
       # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
       # _@param_ `project_obj`
       # 
-      # _@param_ `project` — - :not_specified, :my_tasks
-      sig { params(project_obj: Asana::Resources::Project, project: T.any(String, Symbol)).returns(T::Hash[T.untyped, T.untyped]) }
+      # _@param_ `project` — - a String is a project name
+      sig { params(project_obj: Asana::Resources::Project, project: T.nilable(T.any(String, Symbol))).returns(T::Hash[String, Object]) }
       def project_to_h(project_obj, project: :not_specified); end
 
       # _@param_ `project_hash`
@@ -5248,6 +5223,10 @@ module Checkoff
           sig { params(param_name: String).returns(String) }
           def fetch_solo_param(param_name); end
 
+          # Implemented by every subclass.
+          sig { returns([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]]) }
+          def convert; end
+
           sig { returns(String) }
           attr_reader :gid
 
@@ -5339,7 +5318,6 @@ module Checkoff
         sig { params(date_url_params: T::Hash[String, T::Array[String]]).void }
         def initialize(date_url_params:); end
 
-        # @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
 
@@ -5371,8 +5349,6 @@ 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 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) }
         def get_single_param(param_key); end
@@ -5385,6 +5361,10 @@ module Checkoff
         sig { params(prefix: String).void }
         def validate_unit_is_day!(prefix); end
 
+        # _@param_ `out`
+        sig { params(out: T.nilable([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]])).returns([T::Hash[String, String], T::Array[T.any(Symbol, T::Array[T.untyped])]]) }
+        def ensure_matched!(out); end
+
         sig { returns(T::Hash[String, T::Array[String]]) }
         attr_reader :date_url_params
       end
@@ -5420,7 +5400,6 @@ 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
 
@@ -5577,16 +5556,12 @@ module Checkoff
         sig { returns(T::Hash[String, T::Hash[T.untyped, T.untyped]]) }
         def by_custom_field; end
 
-        # @sg-ignore `unless variant_class.nil?` return value isn't inferred as the declared tuple type
-        # 
         # _@param_ `gid`
         # 
         # _@param_ `single_custom_field_params`
         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 split(...)[n]'s nilable Array indexing isn't inferred as the declared String return
-        # 
         # _@param_ `key`
         sig { params(key: String).returns(String) }
         def gid_from_custom_field_key(key); end
@@ -5635,7 +5610,7 @@ module Checkoff
       # _@param_ `asana_event`
       # 
       # _@param_ `failures`
-      sig { params(filter: T::Hash[T.untyped, T.untyped], asana_event: T::Hash[T.untyped, T.untyped], failures: T::Array[String]).returns(T::Boolean) }
+      sig { params(filter: T::Hash[String, T.any(String, T::Array[String])], asana_event: T::Hash[T.untyped, T.untyped], failures: T::Array[String]).returns(T::Boolean) }
       def filter_matches_asana_event?(filter, asana_event, failures); end
 
       # _@param_ `key`
@@ -5678,7 +5653,6 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
     end
@@ -5789,7 +5763,6 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
 
@@ -5817,13 +5790,12 @@ module Checkoff
   # Base class to evaluate Asana resource selectors against an Asana resource
   class SelectorEvaluator
     # _@param_ `selector`
-    sig { params(selector: T.any(Symbol, T::Array[T.any(Symbol, Integer, T::Array[T.untyped])])).returns(T.nilable(T.any(T::Boolean, Object, T::Array[T.untyped]))) }
+    sig { params(selector: T.any(Symbol, T::Array[T.any(Symbol, String, Integer, T::Array[T.untyped])])).returns(T.nilable(T.any(T::Boolean, Object, T::Array[T.untyped]))) }
     def evaluate(selector); end
 
     sig { returns(T::Hash[T.untyped, T.untyped]) }
     def initializer_kwargs; end
 
-    # @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
 
@@ -5904,9 +5876,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 Hash#fetch generic<X> leak on rbs >= 4.1.0, fix in progress upstream
-        # https://github.com/castwide/solargraph/pull/1228
-        # 
         # _@param_ `task`
         # 
         # _@param_ `project_name`
@@ -5996,9 +5965,6 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore Checkoff::SelectorClasses::Task::UnassignedPFunctionEvaluator#evaluate
-        #   return type could not be inferred
-        # 
         # _@param_ `task`
         sig { params(task: Asana::Resources::Task).returns(T::Boolean) }
         def evaluate(task); end
@@ -6012,9 +5978,6 @@ module Checkoff
         def matches?; end
 
         # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
-        # @sg-ignore Checkoff::SelectorClasses::Task::DueDateSetPFunctionEvaluator#evaluate
-        #   return type could not be inferred
-        # 
         # _@param_ `task`
         sig { params(task: Asana::Resources::Task).returns(T::Boolean) }
         def evaluate(task); end
@@ -6117,9 +6080,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 Checkoff::SelectorClasses::Task::MilestonePFunctionEvaluator#evaluate
-        #   return type could not be inferred
-        # 
         # _@param_ `task`
         sig { params(task: Asana::Resources::Task).returns(T::Boolean) }
         def evaluate(task); end
@@ -6156,7 +6116,7 @@ module Checkoff
         # _@param_ `_kwargs`
         sig do
           params(
-            selector: T.any([Symbol, T::Array[T.untyped]], String),
+            selector: T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol),
             tasks: Checkoff::Tasks,
             timelines: Checkoff::Timelines,
             custom_fields: Checkoff::CustomFields,
@@ -6174,7 +6134,7 @@ module Checkoff
         sig { returns(Checkoff::CustomFields) }
         attr_reader :custom_fields
 
-        sig { returns([Symbol, T::Array[T.untyped]]) }
+        sig { returns(T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol)) }
         attr_reader :selector
       end
     end
@@ -6377,9 +6337,6 @@ 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 Checkoff::SelectorClasses::Common::NameStartsWithPFunctionEvaluator#evaluate
-        #   return type could not be inferred
-        # 
         # _@param_ `resource`
         # 
         # _@param_ `prefix`
@@ -6394,8 +6351,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 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) }
         def evaluate(_resource); end
@@ -6408,10 +6363,10 @@ module Checkoff
         # _@param_ `custom_fields`
         # 
         # _@param_ `_kwargs`
-        sig { params(selector: T.any([Symbol, T::Array[T.untyped]], String), custom_fields: Checkoff::CustomFields, _kwargs: T::Hash[T.untyped, T.untyped]).void }
+        sig { params(selector: T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol), custom_fields: Checkoff::CustomFields, _kwargs: T::Hash[T.untyped, T.untyped]).void }
         def initialize(selector:, custom_fields:, **_kwargs); end
 
-        sig { returns(T.any([Symbol, T::Array[T.untyped]], String)) }
+        sig { returns(T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol)) }
         attr_reader :selector
 
         sig { returns(Checkoff::CustomFields) }
@@ -6429,8 +6384,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 nilable return from an @!parse-declared method isn't inferred
-        # 
         # _@param_ `resource`
         sig { params(resource: Asana::Resources::Project).returns(T.nilable(String)) }
         def evaluate(resource); end
@@ -6490,7 +6443,7 @@ module Checkoff
         # _@param_ `_kwargs`
         sig do
           params(
-            selector: T.any([Symbol, T::Array[T.untyped]], String),
+            selector: T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol),
             projects: Checkoff::Projects,
             portfolios: Checkoff::Portfolios,
             workspaces: Checkoff::Workspaces,
@@ -6499,7 +6452,7 @@ module Checkoff
         end
         def initialize(selector:, projects:, portfolios:, workspaces:, **_kwargs); end
 
-        sig { returns([Symbol, T::Array[T.untyped]]) }
+        sig { returns(T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol)) }
         attr_reader :selector
 
         sig { returns(Checkoff::Projects) }
@@ -6523,8 +6476,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 String, nil safe-nav chain isn't inferred as returning Boolean
-        # 
         # _@param_ `section`
         sig { params(section: Asana::Resources::Section).returns(T::Boolean) }
         def evaluate(section); end
@@ -6555,7 +6506,7 @@ module Checkoff
         # _@param_ `kwargs`
         sig do
           params(
-            selector: T.any([Symbol, T::Array[T.untyped]], String),
+            selector: T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol),
             sections: Checkoff::Sections,
             client: Asana::Client,
             kwargs: T::Hash[T.untyped, T.untyped]
@@ -6563,7 +6514,7 @@ module Checkoff
         end
         def initialize(selector:, sections:, client:, **kwargs); end
 
-        sig { returns([Symbol, T::Array[T.untyped]]) }
+        sig { returns(T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol)) }
         attr_reader :selector
 
         # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
@@ -6583,13 +6534,10 @@ module Checkoff
       sig { params(_index: Integer).returns(T::Boolean) }
       def evaluate_arg?(_index); end
 
-      # @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 return type could not be inferred — abstract method body is only `raise`
-      # 
       # _@param_ `_task`
       # 
       # _@param_ `_args`
@@ -6599,7 +6547,7 @@ module Checkoff
       # _@param_ `object`
       # 
       # _@param_ `fn_name`
-      sig { params(object: Object, fn_name: Symbol).returns(T::Boolean) }
+      sig { params(object: T.any(T::Array[T.any(Symbol, T::Array[T.untyped])], Symbol), fn_name: Symbol).returns(T::Boolean) }
       def fn?(object, fn_name); end
 
       # Concrete subclasses each declare their own initialize with their
@@ -6639,7 +6587,6 @@ module Checkoff
       sig { params(message: T.nilable(Object), block: T.untyped).void }
       def finer(message = nil, &block); end
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       sig { returns(Symbol) }
       def log_level; end
     end
@@ -6788,8 +6735,8 @@ end - [Checkoff::SelectorClasses::Section::FunctionEvaluator]).freeze, T.untyped
     sig { returns(T::Hash[T.untyped, T.untyped]) }
     def initializer_kwargs; end
 
-    # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-    sig { returns(Asana::Resources::Project) }
+    # sord warn - Asana::Resources::Section wasn't able to be resolved to a constant in this project
+    sig { returns(Asana::Resources::Section) }
     attr_reader :item
 
     sig { returns(Checkoff::Sections) }
@@ -6832,7 +6779,6 @@ module Logging
   sig { params(message: T.nilable(Object), block: T.untyped).void }
   def finer(message = nil, &block); end
 
-  # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
   sig { returns(Symbol) }
   def log_level; end
 end
@@ -6853,11 +6799,11 @@ module Asana
     # Public: The base resource class which provides some sugar over common
     # resource functionality.
     class Resource
-      sig { returns(T::Hash[T.untyped, T.untyped]) }
+      sig { returns(T::Hash[String, Object]) }
       def marshal_dump; end
 
       # _@param_ `data`
-      sig { params(data: T::Hash[T.untyped, T.untyped]).void }
+      sig { params(data: T::Hash[String, Object]).void }
       def marshal_load(data); end
     end
   end