checkoff 0.255.0 → 0.257.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]
@@ -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
@@ -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
@@ -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]
@@ -2663,7 +2679,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 +2739,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 +2748,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 +2771,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
@@ -3036,7 +3048,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
@@ -3267,7 +3280,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`
         # 
@@ -3297,6 +3311,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
 
@@ -3376,6 +3392,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
 
@@ -3428,6 +3450,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 +3462,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 +3478,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 +3508,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 +3653,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
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.255.0
+  version: 0.257.0
 platform: ruby
 authors:
 - Vince Broz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-11 00:00:00.000000000 Z
+date: 2026-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport