checkoff 0.256.0 → 0.258.0

data/sig/checkoff.rbs

@@ -77,7 +77,7 @@ module Checkoff
     def run: () -> void
 
     # _@param_ `project_arg`
-    def project_arg_to_name: (String project_arg) -> (Symbol | String)
+    def project_arg_to_name: ((Symbol | String) project_arg) -> (Symbol | String)
 
     # Returns the value of attribute from_workspace_name.
     attr_reader from_workspace_name: untyped
@@ -288,7 +288,7 @@ 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
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -444,7 +444,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`
     # 
@@ -464,7 +465,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`
@@ -544,7 +544,9 @@ module Checkoff
 
     def projects: () -> Checkoff::Projects
 
-    # @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
     def default_assignee_gid: () -> String
 
     def logger: () -> ::Logger
@@ -564,7 +566,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -654,7 +656,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -746,7 +748,7 @@ module Checkoff
     # _@param_ `period_name`
     # 
     # _@param_ `args`
-    def compound_in_period?: ((Date | Time)? date_or_time, Symbol period_name, *Object args) -> bool
+    def compound_in_period?: ((Date | Time)? date_or_time, Symbol period_name, *::Array[Object] args) -> bool
 
     def self.run: () -> void
 
@@ -767,7 +769,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
     def log_level: () -> Symbol
   end
 
@@ -900,7 +902,7 @@ 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
+    # @sg-ignore nil check above is not flow-sensitive
     # 
     # _@param_ `workspace_name`
     # 
@@ -1002,7 +1004,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -1074,7 +1076,7 @@ module Checkoff
     # 
     # _@param_ `extra_fields`
     def tasks_by_section: (
-                            String workspace_name,
+                            (String | Symbol) workspace_name,
                             (String | Symbol) project_name,
                             ?only_uncompleted: bool,
                             ?extra_fields: ::Array[String]
@@ -1109,7 +1111,7 @@ module Checkoff
                ) -> ::Enumerable[Asana::Resources::Task]
 
     # 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`
     # 
@@ -1225,7 +1227,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -1292,10 +1294,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`
-    def subtask_section?: (Asana::Resources::Task subtask) -> bool
+    def subtask_section?: (Asana::Resources::Task subtask) -> bool?
 
     # sord warn - Asana::Resources::Task wasn't able to be resolved to a constant in this project
     # _@param_ `current_section`
@@ -1483,7 +1485,7 @@ module Checkoff
                     ) -> void
 
     # 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`
     # 
@@ -1555,7 +1557,8 @@ 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
+    # @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
@@ -1564,7 +1567,9 @@ module Checkoff
     # _@param_ `workspace_name`
     def workspace_or_raise: ((String | Symbol) workspace_name) -> Asana::Resources::Workspace
 
-    # @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
     def default_workspace_gid: () -> String
 
     # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
@@ -1596,6 +1601,7 @@ module Checkoff
                       ?client: Asana::Client
                     ) -> void
 
+    # 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`
     # 
@@ -1608,13 +1614,12 @@ module Checkoff
     # _@param_ `verify_mode` — - e.g., OpenSSL::SSL::VERIFY_NONE or OpenSSL::SSL::VERIFY_PEER
     def create_attachment_from_url!: (
                                        String url,
-                                       Asana::Resources::Resource resource,
+                                       Asana::Resources::Task resource,
                                        ?attachment_name: String?,
                                        ?verify_mode: Integer,
                                        ?just_the_url: bool
                                      ) -> Asana::Resources::Attachment
 
-    # 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
@@ -1622,12 +1627,13 @@ module Checkoff
     # _@param_ `uri`
     # 
     # _@param_ `verify_mode` — - e.g., OpenSSL::SSL::VERIFY_NONE,OpenSSL::SSL::VERIFY_PEER
-    def download_uri: (URI uri, ?verify_mode: Integer) -> Object
+    def download_uri: (URI::Generic uri, ?verify_mode: Integer) -> Object
 
     # sord duck - #read_body looks like a duck type, replacing with untyped
     # _@param_ `response`
     def write_tempfile_from_response: (untyped response) -> void
 
+    # 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`
     # 
@@ -1638,18 +1644,19 @@ module Checkoff
     # _@param_ `verify_mode` — - e.g., OpenSSL::SSL::VERIFY_NONE,OpenSSL::SSL::VERIFY_PEER
     def create_attachment_from_downloaded_url!: (
                                                   String url,
-                                                  Asana::Resources::Resource resource,
+                                                  Asana::Resources::Task resource,
                                                   attachment_name: String?,
                                                   ?verify_mode: Integer
                                                 ) -> Asana::Resources::Attachment
 
+    # 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`
-    def create_attachment_from_url_alone!: (String url, Asana::Resources::Resource resource, attachment_name: String?) -> Asana::Resources::Attachment
+    def create_attachment_from_url_alone!: (String url, Asana::Resources::Task resource, attachment_name: String?) -> Asana::Resources::Attachment
 
     # _@param_ `filename`
     def content_type_from_filename: (String filename) -> String?
@@ -1679,7 +1686,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -1714,7 +1721,7 @@ module Checkoff
                     ) -> void
 
     # 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`
     # 
@@ -1736,7 +1743,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`
     # 
@@ -1752,7 +1761,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`
     # 
@@ -1761,14 +1770,16 @@ 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`
     # 
     # _@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]
 
-    # @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`
     def resource_custom_field_enum_values: (::Hash[String, (::Hash[untyped, untyped] | ::Array[::Hash[untyped, untyped]])] custom_field) -> ::Array[::Hash[untyped, untyped]]
@@ -1898,10 +1909,11 @@ 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
+    # @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, untyped]
+    def calculate_api_options: (::Array[String] extra_fields) -> ::Hash[Symbol, ::Array[String]]
 
     def self.run: () -> void
 
@@ -1922,7 +1934,7 @@ module Checkoff
     # _@param_ `message`
     def finer: (?Object? message) -> void
 
-    # @sg-ignore
+    # @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
@@ -1968,13 +1980,13 @@ module Checkoff
     # _@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
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.project_name: () -> String
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.workspace_name: () -> String
 
-    # @sg-ignore
+    # @sg-ignore `x || raise(...)` isn't inferred as narrowing away the nil branch
     def self.task_selector: () -> [Symbol, ::Array[untyped]]
 
     def self.run: () -> void
@@ -2146,13 +2158,15 @@ module Checkoff
                       ) -> void
 
       # 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`
       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
+      # @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?
@@ -2186,7 +2200,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`
       # 
@@ -2204,7 +2219,7 @@ module Checkoff
       # _@param_ `yaml_filename`
       def initialize: (::Hash[Symbol, untyped] config, Symbol sym, String yaml_filename) -> void
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       # 
       # _@param_ `key`
       def []: (Symbol key) -> Object
@@ -2302,7 +2317,7 @@ module Checkoff
         def convert_custom_field_params: (::Hash[String, ::Array[String]] custom_field_params) -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
 
         # _@param_ `url_params`
-        def partition_url_params: (::Hash[String, String] url_params) -> [::Hash[String, ::Array[String]], ::Hash[String, ::Array[String]], ::Hash[String, ::Array[String]]]
+        def partition_url_params: (::Hash[String, ::Array[String]] url_params) -> [::Hash[String, ::Array[String]], ::Hash[String, ::Array[String]], ::Hash[String, ::Array[String]]]
       end
 
       # Merge task selectors and search API arguments
@@ -2310,10 +2325,8 @@ module Checkoff
         # _@param_ `args`
         def self.merge_args: (*::Array[::Hash[String, String]] args) -> ::Hash[String, String]
 
-        # @sg-ignore
-        # 
         # _@param_ `task_selectors`
-        def self.merge_task_selectors: (*::Array[(Symbol | ::Array[untyped])] task_selectors) -> [Symbol, ::Array[untyped], ::Array[untyped]]
+        def self.merge_task_selectors: (*::Array[(Symbol | ::Array[untyped])] task_selectors) -> (Symbol | ::Array[untyped] | [Symbol, ::Array[untyped], ::Array[untyped]])
       end
 
       # https://developers.asana.com/docs/search-tasks-in-a-workspace
@@ -2404,7 +2417,7 @@ module Checkoff
         # _@param_ `date_url_params` — the simple params
         def initialize: (date_url_params: ::Hash[String, ::Array[String]]) -> void
 
-        # @sg-ignore
+        # @sg-ignore out can genuinely be nil if none of the 3 known prefixes matched; relies on the raise above it
         def convert: () -> [::Hash[String, String], ::Array[(Symbol | ::Array[untyped])]]
 
         # _@param_ `prefix`
@@ -2430,7 +2443,7 @@ 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
+        # @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
@@ -2471,6 +2484,9 @@ 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
 
           attr_reader values: ::Array[String]
@@ -2554,14 +2570,13 @@ module Checkoff
         def convert: () -> ::Hash[String, String]
 
         # 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
-        def convert_arg: (String key, ::Array[String] values) -> ::Hash[String, String]
+        # _@return_ — the converted params, as an alternating key/value flat array
+        def convert_arg: (String key, ::Array[String] values) -> ::Array[String]
 
         attr_reader simple_url_params: ::Hash[String, ::Array[String]]
       end
@@ -2578,14 +2593,14 @@ module Checkoff
 
         def by_custom_field: () -> ::Hash[String, ::Hash[untyped, untyped]]
 
-        # @sg-ignore
+        # @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
+        # @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
@@ -2663,7 +2678,7 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def log_level: () -> Symbol
     end
 
@@ -2723,10 +2738,8 @@ module Checkoff
       # _@param_ `resource_type`
       def enrich_gid: (String gid, ?resource_type: String?) -> [untyped, untyped, untyped, untyped]
 
-      # @sg-ignore
-      # 
       # _@param_ `filter`
-      def enrich_filter_parent_gid!: (::Hash[String, (String | ::Array[String])] filter) -> String?
+      def enrich_filter_parent_gid!: (::Hash[String, (String | ::Array[String])] filter) -> void
 
       # _@param_ `filter`
       def enrich_filter_resource!: (::Hash[String, (String | ::Array[String])] filter) -> void
@@ -2734,13 +2747,11 @@ module Checkoff
       # _@param_ `filter`
       def enrich_filter_section!: (::Hash[String, (String | ::Array[String])] filter) -> void
 
-      # sord warn - "'resource'" does not appear to be a type
       # _@param_ `asana_event`
-      def enrich_event_parent!: (::Hash[untyped, ::Hash[untyped, untyped]] asana_event) -> void
+      def enrich_event_parent!: (::Hash[untyped, untyped] asana_event) -> void
 
-      # sord warn - "'resource'" does not appear to be a type
       # _@param_ `asana_event`
-      def enrich_event_resource!: (::Hash[untyped, ::Hash[untyped, untyped]] asana_event) -> void
+      def enrich_event_resource!: (::Hash[untyped, untyped] asana_event) -> void
 
       def logger: () -> ::Logger
 
@@ -2759,7 +2770,7 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore
+      # @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
@@ -2784,18 +2795,18 @@ module Checkoff
 
     def initializer_kwargs: () -> ::Hash[untyped, untyped]
 
-    # @sg-ignore
+    # @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`
     # 
     # _@param_ `evaluator`
-    def evaluate_args: (::Array[untyped] selector, Checkoff::SelectorClasses::FunctionEvaluator evaluator) -> ::Array[untyped]
+    def evaluate_args: ((Symbol | ::Array[untyped]) selector, Checkoff::SelectorClasses::FunctionEvaluator evaluator) -> ::Array[untyped]
 
     # _@param_ `selector`
     # 
     # _@param_ `evaluator`
-    def try_this_evaluator: (::Array[untyped] selector, Checkoff::SelectorClasses::FunctionEvaluator evaluator) -> (bool | Object)?
+    def try_this_evaluator: ((Symbol | ::Array[untyped]) selector, Checkoff::SelectorClasses::FunctionEvaluator evaluator) -> (bool | Object)?
 
     attr_reader item: Asana::Resources::Resource
   end
@@ -2822,8 +2833,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
-        # 
         # _@param_ `task`
         # 
         # _@param_ `section_name_prefix`
@@ -2838,8 +2847,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
-        # 
         # _@param_ `task`
         # 
         # _@param_ `section_name`
@@ -2854,7 +2861,8 @@ 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
+        # @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`
         # 
@@ -2884,8 +2892,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
-        # 
         # _@param_ `task`
         # 
         # _@param_ `tag_name`
@@ -3036,7 +3042,8 @@ 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
+        # @sg-ignore Checkoff::SelectorClasses::Task::MilestonePFunctionEvaluator#evaluate
+        #   return type could not be inferred
         # 
         # _@param_ `task`
         def evaluate: (Asana::Resources::Task task) -> bool
@@ -3185,10 +3192,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`
@@ -3205,9 +3208,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`
@@ -3226,9 +3226,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`
@@ -3267,7 +3264,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`
         # 
@@ -3281,7 +3279,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`
         def evaluate: ((Asana::Resources::Task | Asana::Resources::Project) _resource) -> String
@@ -3297,6 +3295,8 @@ module Checkoff
         def initialize: (selector: ([Symbol, ::Array[untyped]] | String), custom_fields: Checkoff::CustomFields, **::Hash[untyped, untyped] _kwargs) -> void
 
         attr_reader selector: ([Symbol, ::Array[untyped]] | String)
+
+        attr_reader custom_fields: Checkoff::CustomFields
       end
     end
 
@@ -3309,7 +3309,7 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Project resource) -> String?
@@ -3322,8 +3322,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
-        # 
         # _@param_ `project`
         # 
         # _@param_ `period` — - :now_or_before or :this_week
@@ -3337,10 +3335,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
-        # 
-        # @sg-ignore
-        # 
         # _@param_ `project`
         # 
         # _@param_ `portfolio_name`
@@ -3376,6 +3370,12 @@ module Checkoff
                         ) -> void
 
         attr_reader selector: [Symbol, ::Array[untyped]]
+
+        attr_reader projects: Checkoff::Projects
+
+        attr_reader portfolios: Checkoff::Portfolios
+
+        attr_reader workspaces: Checkoff::Workspaces
       end
     end
 
@@ -3388,7 +3388,7 @@ module Checkoff
         def matches?: () -> bool
 
         # 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`
         def evaluate: (Asana::Resources::Section section) -> bool
@@ -3401,8 +3401,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
-        # 
         # _@param_ `section`
         def evaluate: (Asana::Resources::Section section) -> bool
       end
@@ -3428,6 +3426,8 @@ module Checkoff
 
         # sord warn - Asana::Client wasn't able to be resolved to a constant in this project
         attr_reader client: Asana::Client
+
+        attr_reader sections: Checkoff::Sections
       end
     end
 
@@ -3438,11 +3438,11 @@ module Checkoff
       # _@param_ `_index`
       def evaluate_arg?: (Integer _index) -> bool
 
-      # @sg-ignore
+      # @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
+      # @sg-ignore return type could not be inferred — abstract method body is only `raise`
       # 
       # _@param_ `_task`
       # 
@@ -3454,6 +3454,19 @@ module Checkoff
       # _@param_ `fn_name`
       def fn?: (Object object, Symbol fn_name) -> bool
 
+      # 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`
+      def initialize: (?selector: (Symbol | ::Array[untyped] | String)?, **::Hash[untyped, untyped] _kwargs) -> void
+
       def logger: () -> ::Logger
 
       # _@param_ `message`
@@ -3471,7 +3484,7 @@ module Checkoff
       # _@param_ `message`
       def finer: (?Object? message) -> void
 
-      # @sg-ignore
+      # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
       def log_level: () -> Symbol
     end
   end
@@ -3616,7 +3629,7 @@ module Logging
   # _@param_ `message`
   def finer: (?Object? message) -> void
 
-  # @sg-ignore
+  # @sg-ignore return type could not be inferred — cascades from the ENV.fetch RBS gap below
   def log_level: () -> Symbol
 end