checkoff 0.258.0 → 0.260.0

data/sig/checkoff.rbs

@@ -127,7 +127,7 @@ module Checkoff
                       String workspace_name,
                       (String | Symbol) project_name,
                       (String | Symbol)? section_name,
-                      (String | Symbol)? task_name,
+                      String? task_name,
                       ?config: (Checkoff::Internal::EnvFallbackConfigLoader | ::Hash[untyped, untyped]),
                       ?projects: Checkoff::Projects,
                       ?sections: Checkoff::Sections,
@@ -288,8 +288,6 @@ module Checkoff
                           ) -> ::Enumerable[Asana::Resources::Task]
 
     # 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`
@@ -351,7 +349,7 @@ module Checkoff
     # 
     # _@param_ `asana_task`
     def initialize: (
-                      ?config: (::Hash[untyped, untyped] | Checkoff::Internal::EnvFallbackConfigLoader),
+                      ?config: (::Hash[Symbol, Object] | Checkoff::Internal::EnvFallbackConfigLoader),
                       ?client: Asana::Client,
                       ?workspaces: Checkoff::Workspaces,
                       ?sections: Checkoff::Sections,
@@ -444,9 +442,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`
@@ -494,13 +489,11 @@ module Checkoff
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # _@param_ `task_data`
-    def h_to_task: (::Hash[untyped, untyped] task_data) -> Asana::Resources::Task
+    def h_to_task: (::Hash[String, Object] task_data) -> Asana::Resources::Task
 
     # 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`
@@ -544,9 +537,6 @@ module Checkoff
 
     def projects: () -> Checkoff::Projects
 
-    # @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
     def default_assignee_gid: () -> String
 
     def logger: () -> ::Logger
@@ -566,7 +556,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
@@ -656,7 +645,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     attr_reader projects: Checkoff::Projects
@@ -692,7 +680,7 @@ module Checkoff
     # _@param_ `date_or_time`
     # 
     # _@param_ `period` — Valid values: :this_week, :now_or_before, :indefinite, [:less_than_n_days_ago, Integer]
-    def in_period?: ((Date | Time)? date_or_time, (Symbol | [Symbol, Integer]) period) -> bool
+    def in_period?: ((Date | Time)? date_or_time, (Symbol | ::Array[(Symbol | Integer)]) period) -> bool
 
     # _@param_ `date_or_time`
     # 
@@ -731,8 +719,6 @@ module Checkoff
     # _@param_ `num_days`
     def n_days_from_now: (Integer num_days) -> ActiveSupport::TimeWithZone
 
-    # @sg-ignore Checkoff::Timing#n_days_from_today return type could not be inferred
-    # 
     # _@param_ `num_days`
     def n_days_from_today: (Integer num_days) -> Date
 
@@ -769,7 +755,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
   end
 
@@ -844,13 +829,13 @@ module Checkoff
   class Projects
     include Logging
     extend CacheMethod::ClassMethods
-    MINUTE: untyped
-    HOUR: untyped
-    DAY: untyped
-    REALLY_LONG_CACHE_TIME: untyped
-    LONG_CACHE_TIME: untyped
-    MEDIUM_CACHE_TIME: untyped
-    SHORT_CACHE_TIME: untyped
+    MINUTE: Integer
+    HOUR: Integer
+    DAY: Integer
+    REALLY_LONG_CACHE_TIME: Integer
+    LONG_CACHE_TIME: Integer
+    MEDIUM_CACHE_TIME: Integer
+    SHORT_CACHE_TIME: Integer
 
     # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
     # _@param_ `config`
@@ -878,6 +863,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`
@@ -902,8 +893,6 @@ module Checkoff
     def project: ((String | Symbol) workspace_name, (String | Symbol) project_name, ?extra_fields: ::Array[String]) -> Asana::Resources::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_ `workspace_name`
     # 
     # _@param_ `project_name` — - :my_tasks or a project name
@@ -954,8 +943,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
-    def project_to_h: (Asana::Resources::Project project_obj, ?project: (String | Symbol)) -> ::Hash[untyped, untyped]
+    # _@param_ `project` — - a String is a project name
+    def project_to_h: (Asana::Resources::Project project_obj, ?project: (String | Symbol)?) -> ::Hash[String, Object]
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
     # Indicates a project is ready for a person to work on it.  This
@@ -968,7 +957,7 @@ module Checkoff
     # _@param_ `project`
     # 
     # _@param_ `period` — See Checkoff::Timing#in_period? - :now_or_before,:this_week
-    def project_ready?: (Asana::Resources::Project project, ?period: (Symbol | [Symbol, Integer])) -> bool
+    def project_ready?: (Asana::Resources::Project project, ?period: (Symbol | ::Array[(Symbol | Integer)])) -> bool
 
     # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
     # _@param_ `project`
@@ -976,7 +965,7 @@ module Checkoff
     # _@param_ `field_name`
     # 
     # _@param_ `period` — See Checkoff::Timing#in_period? - :now_or_before,:this_week
-    def in_period?: (Asana::Resources::Project project, (Symbol | ::Array[untyped]) field_name, (Symbol | [Symbol, Integer]) period) -> bool
+    def in_period?: (Asana::Resources::Project project, (Symbol | ::Array[untyped]) field_name, (Symbol | ::Array[(Symbol | Integer)]) period) -> bool
 
     def as_cache_key: () -> ::Hash[untyped, untyped]
 
@@ -1004,7 +993,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     attr_reader timing: Checkoff::Timing
@@ -1022,11 +1010,11 @@ module Checkoff
     include Logging
     extend CacheMethod::ClassMethods
     extend Forwardable
-    MINUTE: untyped
-    HOUR: untyped
-    REALLY_LONG_CACHE_TIME: untyped
-    LONG_CACHE_TIME: untyped
-    SHORT_CACHE_TIME: untyped
+    MINUTE: Integer
+    HOUR: Integer
+    REALLY_LONG_CACHE_TIME: Integer
+    LONG_CACHE_TIME: Integer
+    SHORT_CACHE_TIME: Integer
 
     # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
     # _@param_ `config`
@@ -1111,7 +1099,6 @@ module Checkoff
                ) -> ::Enumerable[Asana::Resources::Task]
 
     # Pulls just names of tasks from a given section.
-    # @sg-ignore Task#name is nilable; task names are assumed present here
     # 
     # _@param_ `workspace_name`
     # 
@@ -1121,8 +1108,6 @@ module Checkoff
     def section_task_names: (String workspace_name, (String | Symbol) project_name, String? section_name) -> ::Array[String]
 
     # 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`
@@ -1203,8 +1188,6 @@ module Checkoff
     def file_task_by_section: (::Hash[String?, ::Array[Asana::Resources::Task]] by_section, Asana::Resources::Task task, String project_gid) -> void
 
     # 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`
@@ -1227,7 +1210,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     attr_reader projects: Checkoff::Projects
@@ -1294,8 +1276,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`
     def subtask_section?: (Asana::Resources::Task subtask) -> bool?
 
@@ -1373,6 +1353,11 @@ module Checkoff
 
     def self.run: () -> void
 
+    # _@param_ `resource_type`
+    # 
+    # _@param_ `gid`
+    def fetch_gid_by_type: (String resource_type, String gid) -> Asana::Resources::Resource?
+
     attr_reader workspaces: Checkoff::Workspaces
 
     attr_reader projects: Checkoff::Projects
@@ -1445,7 +1430,7 @@ module Checkoff
     # _@param_ `task_data`
     # 
     # _@param_ `section`
-    def task_data_dependent_on_previous_section_last_milestone?: (::Hash[untyped, untyped] task_data, Asana::Resources::Section section) -> bool
+    def task_data_dependent_on_previous_section_last_milestone?: (::Hash[String, Object] task_data, Asana::Resources::Section section) -> bool
 
     def self.run: () -> void
 
@@ -1485,8 +1470,6 @@ module Checkoff
                     ) -> void
 
     # 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`
@@ -1548,7 +1531,7 @@ module Checkoff
     # _@param_ `client`
     # 
     # _@param_ `asana_workspace`
-    def initialize: (?config: (::Hash[untyped, untyped] | Checkoff::Internal::EnvFallbackConfigLoader), ?client: Asana::Client, ?asana_workspace: singleton(Asana::Resources::Workspace)) -> void
+    def initialize: (?config: (::Hash[Symbol, Object] | Checkoff::Internal::EnvFallbackConfigLoader), ?client: Asana::Client, ?asana_workspace: singleton(Asana::Resources::Workspace)) -> void
 
     # sord warn - Asana::Resources::Workspace wasn't able to be resolved to a constant in this project
     # Pulls an Asana workspace object
@@ -1557,19 +1540,12 @@ module Checkoff
     def workspace: ((String | Symbol) workspace_name) -> Asana::Resources::Workspace?
 
     # 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
     def default_workspace: () -> Asana::Resources::Workspace
 
     # 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`
     def workspace_or_raise: ((String | Symbol) workspace_name) -> Asana::Resources::Workspace
 
-    # @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
     def default_workspace_gid: () -> String
 
     # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
@@ -1686,7 +1662,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     attr_reader workspaces: Checkoff::Workspaces
@@ -1721,8 +1696,6 @@ module Checkoff
                     ) -> void
 
     # 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`
@@ -1743,10 +1716,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`
@@ -1757,37 +1726,37 @@ module Checkoff
     # _@param_ `resource`
     # 
     # _@param_ `custom_field_name`
-    def resource_custom_field_by_name: ((Asana::Resources::Task | Asana::Resources::Project) resource, String custom_field_name) -> ::Hash[untyped, untyped]?
+    def resource_custom_field_by_name: ((Asana::Resources::Task | Asana::Resources::Project) resource, String custom_field_name) -> ::Hash[String, Object]?
 
     # 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`
-    def resource_custom_field_by_name_or_raise: ((Asana::Resources::Task | Asana::Resources::Project) resource, String custom_field_name) -> ::Hash[untyped, untyped]
+    def resource_custom_field_by_name_or_raise: ((Asana::Resources::Task | Asana::Resources::Project) resource, String custom_field_name) -> ::Hash[String, Object]
 
     # 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`
-    def resource_custom_field_by_gid_or_raise: ((Asana::Resources::Project | Asana::Resources::Task) resource, String custom_field_gid) -> ::Hash[untyped, untyped]
+    def resource_custom_field_by_gid_or_raise: ((Asana::Resources::Project | Asana::Resources::Task) resource, String custom_field_gid) -> ::Hash[String, Object]
 
-    # @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`
-    def resource_custom_field_enum_values: (::Hash[String, (::Hash[untyped, untyped] | ::Array[::Hash[untyped, untyped]])] custom_field) -> ::Array[::Hash[untyped, untyped]]
+    def resource_custom_field_enum_values: (::Hash[untyped, (untyped | (untyped | ::Array[::Hash[untyped, untyped]]))] custom_field) -> ::Array[::Hash[untyped, (untyped | String)]]
 
     # _@param_ `custom_field`
     # 
     # _@param_ `enum_value`
-    def find_gids: (::Hash[untyped, untyped] custom_field, ::Hash[String, String]? enum_value) -> ::Array[String]
+    def find_gids: (::Hash[String, Object] custom_field, ::Hash[String, String]? enum_value) -> ::Array[String]
 
     def self.run: () -> void
 
@@ -1909,9 +1878,6 @@ module Checkoff
     # _@param_ `extra_fields`
     def iterated_raw_task_search: (::Hash[String, Object] api_params, workspace_gid: String, extra_fields: ::Array[String]) -> ::Enumerable[Asana::Resources::Task]
 
-    # @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`
     def calculate_api_options: (::Array[String] extra_fields) -> ::Hash[Symbol, ::Array[String]]
 
@@ -1934,7 +1900,6 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
 
     attr_reader task_selectors: Checkoff::TaskSelectors
@@ -1978,19 +1943,19 @@ module Checkoff
     # _@param_ `task`
     # 
     # _@param_ `task_selector` — Filter based on task details.  Examples: [:tag, 'foo'] [:not, [:tag, 'foo']] [:tag, 'foo']
-    def filter_via_task_selector: (Asana::Resources::Task task, (Symbol | ::Array[(Symbol | Integer | ::Array[untyped])]) task_selector) -> bool
+    def filter_via_task_selector: (Asana::Resources::Task task, (Symbol | ::Array[(Symbol | String | Integer | ::Array[untyped])]) task_selector) -> bool
 
-    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.project_name: () -> String
 
-    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.workspace_name: () -> String
 
-    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.task_selector: () -> [Symbol, ::Array[untyped]]
 
     def self.run: () -> void
 
+    # _@param_ `parsed` — result of JSON.parse on a task selector
+    def self.validate_task_selector: (Object parsed) -> [String, ::Array[untyped]]
+
     attr_reader tasks: Checkoff::Tasks
 
     attr_reader timelines: Checkoff::Timelines
@@ -2035,7 +2000,7 @@ module Checkoff
     # _@param_ `project`
     # 
     # _@param_ `project_selector` — Filter based on project details.  Examples: [:tag, 'foo'] [:not, [:tag, 'foo']] [:tag, 'foo']
-    def filter_via_project_selector: (Asana::Resources::Project project, [Symbol, ::Array[untyped]] project_selector) -> bool
+    def filter_via_project_selector: (Asana::Resources::Project project, ::Array[(Symbol | String | ::Array[untyped])] project_selector) -> bool
 
     def self.run: () -> void
 
@@ -2112,7 +2077,7 @@ module Checkoff
       # _@param_ `task_data`
       # 
       # _@param_ `client`
-      def h_to_task: (::Hash[untyped, untyped] task_data, client: Asana::Client) -> Asana::Resources::Task
+      def h_to_task: (::Hash[String, Object] task_data, client: Asana::Client) -> Asana::Resources::Task
 
       # _@param_ `task_hash`
       def unwrap_custom_fields: (::Hash[untyped, untyped] task_hash) -> void
@@ -2130,14 +2095,17 @@ module Checkoff
       # 
       # _@param_ `key`
       def unwrap_memberships: (
-                                ::Hash[untyped, untyped] task_hash,
+                                ::Hash[String, Object] task_hash,
                                 ::Array[::Hash[untyped, untyped]] memberships,
                                 String resource,
                                 String key
                               ) -> void
 
       # _@param_ `task_hash`
-      def unwrap_all_memberships: (::Hash[untyped, untyped] task_hash) -> void
+      def unwrap_all_memberships: (::Hash[String, Object] task_hash) -> void
+
+      # _@param_ `task_hash`
+      def assignee_hash: (::Hash[String, (String | ::Hash[untyped, untyped] | ::Array[untyped])] task_hash) -> ::Hash[String, Object]
     end
 
     # Utility methods for working with task dates and times
@@ -2158,16 +2126,10 @@ module Checkoff
                       ) -> void
 
       # 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`
       def start_time: (Asana::Resources::Task task) -> Time?
 
       # 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`
       def due_time: (Asana::Resources::Task task) -> Time?
 
@@ -2200,9 +2162,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`
@@ -2219,8 +2178,6 @@ module Checkoff
       # _@param_ `yaml_filename`
       def initialize: (::Hash[Symbol, untyped] config, Symbol sym, String yaml_filename) -> void
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
-      # 
       # _@param_ `key`
       def []: (Symbol key) -> Object
 
@@ -2252,8 +2209,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
-      def project_to_h: (Asana::Resources::Project project_obj, ?project: (String | Symbol)) -> ::Hash[untyped, untyped]
+      # _@param_ `project` — - a String is a project name
+      def project_to_h: (Asana::Resources::Project project_obj, ?project: (String | Symbol)?) -> ::Hash[String, Object]
 
       # _@param_ `project_hash`
       def unwrap_custom_fields: (::Hash[untyped, untyped] project_hash) -> void
@@ -2343,6 +2300,9 @@ module Checkoff
           # _@param_ `param_name`
           def fetch_solo_param: (String param_name) -> String
 
+          # Implemented by every subclass.
+          def convert: () -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
+
           attr_reader gid: String
 
           attr_reader remaining_params: ::Hash[String, ::Array[String]]
@@ -2417,7 +2377,6 @@ module Checkoff
         # _@param_ `date_url_params` — the simple params
         def initialize: (date_url_params: ::Hash[String, ::Array[String]]) -> void
 
-        # @sg-ignore out can genuinely be nil if none of the 3 known prefixes matched; relies on the raise above it
         def convert: () -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
 
         # _@param_ `prefix`
@@ -2443,8 +2402,6 @@ module Checkoff
         # _@return_ — See https://developers.asana.com/docs/search-tasks-in-a-workspace
         def handle_within_next: (String prefix) -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
 
-        # @sg-ignore value.length == 1 guard above isn't inferred as narrowing value[0] to non-nil
-        # 
         # _@param_ `param_key`
         def get_single_param: (String param_key) -> String
 
@@ -2454,6 +2411,9 @@ module Checkoff
         # _@param_ `prefix`
         def validate_unit_is_day!: (String prefix) -> void
 
+        # _@param_ `out`
+        def ensure_matched!: ([::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]? _out) -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
+
         attr_reader date_url_params: ::Hash[String, ::Array[String]]
       end
 
@@ -2484,7 +2444,6 @@ module Checkoff
           # _@param_ `verb`
           def convert_from_projects_and_sections: (String verb) -> ::Array[String]
 
-          # @sg-ignore abstract method always raises; declared type documents the override contract, not this body
           def convert: () -> ::Array[String]
 
           attr_reader key: String
@@ -2593,15 +2552,11 @@ module Checkoff
 
         def by_custom_field: () -> ::Hash[String, ::Hash[untyped, untyped]]
 
-        # @sg-ignore `unless variant_class.nil?` return value isn't inferred as the declared tuple type
-        # 
         # _@param_ `gid`
         # 
         # _@param_ `single_custom_field_params`
         def convert_single_custom_field_params: (String gid, ::Hash[String, ::Array[String]] single_custom_field_params) -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
 
-        # @sg-ignore split(...)[n]'s nilable Array indexing isn't inferred as the declared String return
-        # 
         # _@param_ `key`
         def gid_from_custom_field_key: (String key) -> String
 
@@ -2644,7 +2599,7 @@ module Checkoff
       # _@param_ `asana_event`
       # 
       # _@param_ `failures`
-      def filter_matches_asana_event?: (::Hash[untyped, untyped] filter, ::Hash[untyped, untyped] asana_event, ::Array[String] failures) -> bool
+      def filter_matches_asana_event?: (::Hash[String, (String | ::Array[String])] filter, ::Hash[untyped, untyped] asana_event, ::Array[String] failures) -> bool
 
       # _@param_ `key`
       # 
@@ -2678,7 +2633,6 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def log_level: () -> Symbol
     end
 
@@ -2770,7 +2724,6 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def log_level: () -> Symbol
 
       attr_reader projects: Checkoff::Projects
@@ -2791,11 +2744,10 @@ module Checkoff
   # Base class to evaluate Asana resource selectors against an Asana resource
   class SelectorEvaluator
     # _@param_ `selector`
-    def evaluate: ((Symbol | ::Array[(Symbol | Integer | ::Array[untyped])]) selector) -> (bool | Object | ::Array[untyped])?
+    def evaluate: ((Symbol | ::Array[(Symbol | String | Integer | ::Array[untyped])]) selector) -> (bool | Object | ::Array[untyped])?
 
     def initializer_kwargs: () -> ::Hash[untyped, untyped]
 
-    # @sg-ignore abstract method always raises; declared type documents the override contract, not this body
     def function_evaluators: () -> ::Array[singleton(Checkoff::SelectorClasses::FunctionEvaluator)]
 
     # _@param_ `selector`
@@ -2861,9 +2813,6 @@ module Checkoff
         def evaluate_arg?: (Integer _index) -> bool
 
         # 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`
@@ -2939,9 +2888,6 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Task task) -> bool
       end
@@ -2953,9 +2899,6 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Task task) -> bool
       end
@@ -3042,9 +2985,6 @@ module Checkoff
         def evaluate_arg?: (Integer _index) -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Task task) -> bool
       end
@@ -3076,7 +3016,7 @@ module Checkoff
         # 
         # _@param_ `_kwargs`
         def initialize: (
-                          selector: ([Symbol, ::Array[untyped]] | String),
+                          selector: (::Array[(Symbol | ::Array[untyped])] | Symbol),
                           tasks: Checkoff::Tasks,
                           timelines: Checkoff::Timelines,
                           custom_fields: Checkoff::CustomFields,
@@ -3089,7 +3029,7 @@ module Checkoff
 
         attr_reader custom_fields: Checkoff::CustomFields
 
-        attr_reader selector: [Symbol, ::Array[untyped]]
+        attr_reader selector: (::Array[(Symbol | ::Array[untyped])] | Symbol)
       end
     end
 
@@ -3264,9 +3204,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`
@@ -3279,8 +3216,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`
         def evaluate: ((Asana::Resources::Task | Asana::Resources::Project) _resource) -> String
       end
@@ -3292,9 +3227,9 @@ module Checkoff
         # _@param_ `custom_fields`
         # 
         # _@param_ `_kwargs`
-        def initialize: (selector: ([Symbol, ::Array[untyped]] | String), custom_fields: Checkoff::CustomFields, **::Hash[untyped, untyped] _kwargs) -> void
+        def initialize: (selector: (::Array[(Symbol | ::Array[untyped])] | Symbol), custom_fields: Checkoff::CustomFields, **::Hash[untyped, untyped] _kwargs) -> void
 
-        attr_reader selector: ([Symbol, ::Array[untyped]] | String)
+        attr_reader selector: (::Array[(Symbol | ::Array[untyped])] | Symbol)
 
         attr_reader custom_fields: Checkoff::CustomFields
       end
@@ -3309,8 +3244,6 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Project resource) -> String?
       end
@@ -3362,14 +3295,14 @@ module Checkoff
         # 
         # _@param_ `_kwargs`
         def initialize: (
-                          selector: ([Symbol, ::Array[untyped]] | String),
+                          selector: (::Array[(Symbol | ::Array[untyped])] | Symbol),
                           projects: Checkoff::Projects,
                           portfolios: Checkoff::Portfolios,
                           workspaces: Checkoff::Workspaces,
                           **::Hash[untyped, untyped] _kwargs
                         ) -> void
 
-        attr_reader selector: [Symbol, ::Array[untyped]]
+        attr_reader selector: (::Array[(Symbol | ::Array[untyped])] | Symbol)
 
         attr_reader projects: Checkoff::Projects
 
@@ -3388,8 +3321,6 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Section section) -> bool
       end
@@ -3416,13 +3347,13 @@ module Checkoff
         # 
         # _@param_ `kwargs`
         def initialize: (
-                          selector: ([Symbol, ::Array[untyped]] | String),
+                          selector: (::Array[(Symbol | ::Array[untyped])] | Symbol),
                           sections: Checkoff::Sections,
                           client: Asana::Client,
                           **::Hash[untyped, untyped] kwargs
                         ) -> void
 
-        attr_reader selector: [Symbol, ::Array[untyped]]
+        attr_reader selector: (::Array[(Symbol | ::Array[untyped])] | Symbol)
 
         # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
         attr_reader client: Asana::Client
@@ -3438,12 +3369,9 @@ module Checkoff
       # _@param_ `_index`
       def evaluate_arg?: (Integer _index) -> bool
 
-      # @sg-ignore return type could not be inferred — abstract method body is only `raise`
       def matches?: () -> bool
 
       # 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`
@@ -3452,7 +3380,7 @@ module Checkoff
       # _@param_ `object`
       # 
       # _@param_ `fn_name`
-      def fn?: (Object object, Symbol fn_name) -> bool
+      def fn?: ((::Array[(Symbol | ::Array[untyped])] | Symbol) object, Symbol fn_name) -> bool
 
       # Concrete subclasses each declare their own initialize with their
       # specific keyword args (and set @selector themselves before calling
@@ -3484,7 +3412,6 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def log_level: () -> Symbol
     end
   end
@@ -3596,8 +3523,8 @@ module Checkoff
 
     def initializer_kwargs: () -> ::Hash[untyped, untyped]
 
-    # sord warn - Asana::Resources::Project wasn't able to be resolved to a constant in this project
-    attr_reader item: Asana::Resources::Project
+    # sord warn - Asana::Resources::Section wasn't able to be resolved to a constant in this project
+    attr_reader item: Asana::Resources::Section
 
     attr_reader sections: Checkoff::Sections
 
@@ -3629,7 +3556,6 @@ module Logging
   # _@param_ `message`
   def finer: (?Object? message) -> void
 
-  # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
   def log_level: () -> Symbol
 end
 
@@ -3649,10 +3575,10 @@ module Asana
     # Public: The base resource class which provides some sugar over common
     # resource functionality.
     class Resource
-      def marshal_dump: () -> ::Hash[untyped, untyped]
+      def marshal_dump: () -> ::Hash[String, Object]
 
       # _@param_ `data`
-      def marshal_load: (::Hash[untyped, untyped] data) -> void
+      def marshal_load: (::Hash[String, Object] data) -> void
     end
   end
 end