gitlab-triage 1.23.1 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34fcebd4ec7d33597bb45cf4a48a9708143972b9d5c836f374f2cc629dc392a8
-  data.tar.gz: 48ed9e443369d98b3681d07bd83d81962a82fc5e5449c6c3198935f46a52e764
+  metadata.gz: 0d4dafafa454a68a9258f5753ef3df345e0a0f13c104158bc1243ecb561d408a
+  data.tar.gz: c0d12641e77a6865e0f5569d405e2548b03884e61280dc262a922ff38b786c84
 SHA512:
-  metadata.gz: d32b0e581d1067771b25a1124d591e1e084c10e042a82d20e00ac4d00346e0f386c4c0962477db98d166dab2b0e893d82cbc171f7a5e81c398d2758c6839807d
-  data.tar.gz: 94b2712733c583bab7bc2a4f0c7d92155f9b454a257cd8461cecb1290b4e3aef77d758fadbba1b8720f95585372d2b1c4366ed38481d013f8c19a7ae52d19f44
+  metadata.gz: ea2b0d33abf1eb19403519f264ab25d249a9992e97e08f830505f497a50cc91ae0f9210db270b87d45649ef41c1d1248fcf2ef13b6820991455cfe4d09e8247f
+  data.tar.gz: 063b0a7ec5503f55ee4971e84cc1ddeb81b1ce83997a41dbd48a9c730ada4b402693fc1e4f2be6a955cc9de57c283ed4ee1b37e059633bec355a95c2a55efe3b

data/.gitlab/issue_templates/Default.md

@@ -9,3 +9,5 @@ If you are experiencing an issue when using GitLab.com, your first port of call
 If you feel that your issue can be categorized as a reproducible bug or a feature proposal, please use one of the issue templates provided and include as much information as possible.
 
 Thank you for helping to make GitLab a better product.
+
+<!-- template sourced from https://gitlab.com/gitlab-org/ruby/gems/gitlab-triage/-/blob/master/.gitlab/issue_templates/Default.md -->

data/.gitlab/merge_request_templates/Default.md

@@ -7,3 +7,5 @@ Please keep this description updated with any discussion that takes place so
 that reviewers can understand your intent. Keeping the description updated is
 especially important if they didn't participate in the discussion.
 -->
+
+<!-- template sourced from https://gitlab.com/gitlab-org/ruby/gems/gitlab-triage/-/blob/master/.gitlab/merge_request_templates/Default.md -->

data/.gitlab-ci.yml

@@ -106,6 +106,13 @@ specs:
   script:
     - bundle exec rake spec
 
+specs ruby3.0:
+  image: ruby:3.0
+  needs: ["setup-test-env"]
+  stage: test
+  script:
+    - bundle exec rake spec
+
 ##################
 ## Triage stage ##
 ##################

data/.rubocop.yml

@@ -1,3 +1,5 @@
+inherit_from: .rubocop_todo.yml
+
 inherit_gem:
   gitlab-styles:
     - rubocop-default.yml
@@ -14,3 +16,6 @@ Rails/Output:
 
 Metrics/LineLength:
   Max: 152
+
+Style/SingleArgumentDig:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,145 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2022-05-26 15:15:19 UTC using RuboCop version 0.93.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 43
+CodeReuse/ActiveRecord:
+  Exclude:
+    - 'lib/gitlab/triage/engine.rb'
+    - 'lib/gitlab/triage/graphql_network.rb'
+    - 'spec/gitlab/triage/engine_spec.rb'
+    - 'spec/gitlab/triage/graphql_network_spec.rb'
+    - 'spec/gitlab/triage/network_adapters/graphql_adapter_spec.rb'
+    - 'spec/gitlab/triage/rest_api_network_spec.rb'
+    - 'spec/gitlab/triage/policies/rule_policy_spec.rb'
+    - 'spec/gitlab/triage/resource/label_spec.rb'
+    - 'spec/support/expect_next_instance_of.rb'
+    - 'spec/support/shared_examples/issuable_shared_examples.rb'
+    - 'spec/support/shared_examples/label_command_shared_examples.rb'
+    - 'spec/support/stub_api.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Cop/LineBreakAroundConditionalBlock:
+  Exclude:
+    - 'lib/gitlab/triage/engine.rb'
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'gitlab-triage.gemspec'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Lint/NonDeterministicRequireOrder:
+  Exclude:
+    - 'spec/spec_helper.rb'
+
+# Offense count: 1
+# Configuration parameters: IgnoredMethods.
+Metrics/AbcSize:
+  Max: 57
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Performance/ConstantRegexp:
+  Exclude:
+    - 'lib/gitlab/triage/command_builders/text_content_builder.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: SafeMultiline.
+Performance/DeleteSuffix:
+  Exclude:
+    - 'lib/gitlab/triage/api_query_builders/date_query_param_builder.rb'
+    - 'lib/gitlab/triage/graphql_queries/query_param_builders/date_param_builder.rb'
+
+# Offense count: 5
+Performance/MethodObjectAsBlock:
+  Exclude:
+    - 'lib/gitlab/triage/engine.rb'
+    - 'lib/gitlab/triage/entity_builders/issue_builder.rb'
+    - 'lib/gitlab/triage/expand_condition.rb'
+    - 'lib/gitlab/triage/expand_condition/expansion.rb'
+    - 'lib/gitlab/triage/limiters/date_field_limiter.rb'
+
+# Offense count: 31
+# Cop supports --auto-correct.
+RSpec/EmptyLineAfterLetBlock:
+  Enabled: false
+
+# Offense count: 93
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 12
+
+# Offense count: 12
+# Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
+RSpec/VerifiedDoubles:
+  Exclude:
+    - 'spec/gitlab/triage/graphql_network_spec.rb'
+    - 'spec/gitlab/triage/network_adapters/graphql_adapter_spec.rb'
+    - 'spec/gitlab/triage/rest_api_network_spec.rb'
+    - 'spec/support/shared_examples/label_command_shared_examples.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Rails/IndexBy:
+  Exclude:
+    - 'lib/gitlab/triage/engine.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Rails/NegateInclude:
+  Exclude:
+    - 'lib/gitlab/triage/filters/member_conditions_filter.rb'
+
+# Offense count: 3
+# Cop supports --auto-correct.
+Rails/Pluck:
+  Exclude:
+    - 'lib/gitlab/triage/filters/base_conditions_filter.rb'
+    - 'lib/gitlab/triage/filters/member_conditions_filter.rb'
+    - 'lib/gitlab/triage/validators/limiter_validator.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Style/ArrayCoercion:
+  Exclude:
+    - 'lib/gitlab/triage/graphql_network.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/ExplicitBlockArgument:
+  Exclude:
+    - 'spec/support/expect_next_instance_of.rb'
+
+# Offense count: 115
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Offense count: 5
+Style/OpenStructUse:
+  Exclude:
+    - 'spec/gitlab/triage/network_adapters/httparty_adapter_spec.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/RedundantRegexpEscape:
+  Exclude:
+    - 'lib/gitlab/triage/command_builders/text_content_builder.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowModifier.
+Style/SoleNestedConditional:
+  Exclude:
+    - 'lib/gitlab/triage/validators/params_validator.rb'

data/Gemfile

@@ -6,7 +6,7 @@ gemspec
 gem "yard"
 
 group :test do
-  gem 'gitlab-styles', '~> 3.3.0'
+  gem 'gitlab-styles', '~> 7.0'
 end
 
 group :development, :test, :danger do

data/README.md

@@ -178,8 +178,9 @@ Accepts a hash of fields.
 | `condition`     | string  | `older_than`, `newer_than`              | yes       |
 | `interval_type` | string  | `days`, `weeks`, `months`, `years`      | yes       |
 | `interval`      | integer | integer                                 | yes       |
-
-> **Note:** `merged_at` only works on merge requests.
+> **Note:**
+>   - `merged_at` only works on merge requests.
+>   - `closed_at` is not supported in the GitLab API, but can be used in a [`ruby` condition](#ruby-condition).
 
 Example:
 
@@ -612,6 +613,13 @@ conditions:
 This will make it only act on resources which have active milestones and
 there exists next milestone which has already started.
 
+Since `closed_at` is not a queryable attribute in the GitLab API, we can use a Ruby expression to filter resources like:
+
+```yml
+conditions:
+  ruby: resource[:closed_at] > 7.days.ago.strftime('%Y-%m-%dT00:00:00.000Z')
+```
+
 See [Ruby expression API](#ruby-expression-api) for the list of currently
 available API.
 
@@ -984,6 +992,46 @@ resource_rules:
               /label ~"needs attention"
 ```
 
+##### Create a new issue from each resource
+
+Generates one issue for each resource, by default in the same project as the resource.
+
+The use case for this is, for example, creating test issues in the same (or different)
+project for issues labeled "extended-testing"; or automatically splitting one issue with a
+certain label into multiple ones.
+
+Accepts a hash of fields.
+
+| Field         | Type   | Description                                     | Required | Placeholders | Ruby expression | Default        |
+| ----          | ----   | ----                                            | ----     | ----         | ----            | ----           |
+| `title`       | string | The title of the generated issue                | yes      | yes          | yes             |                |
+| `destination` | integer or string | The project ID or path to create the generated issue in | no   | no              | no             | source project |
+| `description`     | string | The description of the generated issue          | no       | yes | yes | |
+| `redact_confidential_resources` | boolean | Whether redact fields for confidential resources | no | no | no | true |
+
+The placeholders available in `title` and `destination` are the properties of the resource being used to generate the issue.
+
+Example
+
+```yml
+resource_rules:
+  issues:
+    rules:
+      - name: Issues requiring extra testing
+        labels:
+          - needs-testing
+        actions:
+          issue:
+            title: |
+              Testing: {{ title }}
+            description: |
+              The issue {{ full_reference }} needs testing.
+
+              Please take care of them before the end of #{7.days.from_now.strftime('%Y-%m-%d')}
+
+              /label ~"needs attention"
+```
+
 ### Summary policies
 
 Summary policies are special policies that join multiple rule policies together
@@ -1090,13 +1138,20 @@ Here's a list of currently available Ruby expression API:
 | project_path            | String          | The path with namespace to the issues or merge requests project |
 | full_resource_reference | String          | A full reference including project path to the issue or merge request |
 
-##### Methods for `Issue` (issue context)
+##### Methods for `Issue` and `LinkedIssue` (issue context)
 
 | Name                   | Return type    | Description |
 | ----                   | ----           | ----        |
 | merge_requests_count   | Integer        | The number of merge requests related to the issue |
 | related_merge_requests | [MergeRequest] | The list of merge requests related to the issue |
 | closed_by              | [MergeRequest] | The list of merge requests that close the issue |
+| linked_issues          | [LinkedIssue]  | The list of issues that are linked to the issue |
+
+##### Methods for `LinkedIssue`
+
+| Method    | Return type | Description |
+| ----      | ----        | ----        |
+| link_type | String      | The link type of the linked issue (`blocks`, `is_blocked_by`, or `relates_to`) |
 
 ##### Methods for `MergeRequest` (merge request context)
 
@@ -1227,8 +1282,8 @@ run:triage:triage:
   script:
     - gem install gitlab-triage
     - gitlab-triage --token $GITLAB_API_TOKEN --source-id $CI_PROJECT_PATH
-  only:
-    - schedules
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "schedule"
 ```
 
 > **Note:** You can use the [`--init-ci`](#usage) option to add an example [`.gitlab-ci.yml` file](support/.gitlab-ci.example.yml) to your project

data/lib/gitlab/triage/action/issue.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Gitlab
+  module Triage
+    module Action
+      class Issue < Base
+        class Dry < Issue
+          def act
+            puts "The following issues would be created for the rule **#{policy.name}**:\n\n"
+
+            super
+          end
+
+          private
+
+          def perform(resource, issue)
+            puts ">>>"
+            puts "* Project: #{issue.destination || resource[policy.source_id_sym]}"
+            puts "* Title: #{issue.title}"
+            puts "* Description: #{issue.description}"
+            puts ">>>"
+          end
+        end
+
+        def act
+          policy.resources.each do |resource|
+            issue = policy.build_issue(resource)
+
+            perform(resource, issue) if issue.valid?
+          end
+        end
+
+        private
+
+        def perform(resource, issue)
+          network.post_api(build_post_url(resource, issue), post_issue_body(issue))
+        end
+
+        def build_post_url(resource, issue)
+          # POST /projects/:id/issues
+          # https://docs.gitlab.com/ee/api/issues.html#new-issue
+          post_url = UrlBuilders::UrlBuilder.new(
+            network_options: network.options,
+            source_id: issue.destination || resource[policy.source_id_sym],
+            resource_type: 'issues'
+          ).build
+
+          puts Gitlab::Triage::UI.debug "post_issue_url: #{post_url}" if network.options.debug
+
+          post_url
+        end
+
+        def post_issue_body(issue)
+          {
+            title: issue.title,
+            description: issue.description
+          }
+        end
+      end
+    end
+  end
+end

data/lib/gitlab/triage/action/summarize.rb

@@ -45,7 +45,7 @@ module Gitlab
         end
 
         def issue
-          @issue ||= policy.build_issue
+          @issue ||= policy.build_summary
         end
 
         def destination

data/lib/gitlab/triage/action.rb

@@ -1,6 +1,7 @@
 require_relative 'action/summarize'
 require_relative 'action/comment'
 require_relative 'action/comment_on_summary'
+require_relative 'action/issue'
 
 module Gitlab
   module Triage
@@ -11,7 +12,8 @@ module Gitlab
         [
           [Summarize, policy.summarize?],
           [Comment, policy.comment?],
-          [CommentOnSummary, policy.comment_on_summary?]
+          [CommentOnSummary, policy.comment_on_summary?],
+          [Issue, policy.issue?]
         ].each do |action, active|
           act(action: action, policy: policy, **args) if active
         end

data/lib/gitlab/triage/engine.rb

@@ -21,6 +21,7 @@ require_relative 'api_query_builders/multi_query_param_builder'
 require_relative 'url_builders/url_builder'
 require_relative 'network'
 require_relative 'graphql_network'
+require_relative 'rest_api_network'
 require_relative 'network_adapters/httparty_adapter'
 require_relative 'network_adapters/graphql_adapter'
 require_relative 'graphql_queries/query_builder'
@@ -78,7 +79,11 @@ module Gitlab
       end
 
       def network
-        @network ||= Network.new(network_adapter)
+        @network ||= Network.new(restapi: restapi_network, graphql: graphql_network)
+      end
+
+      def restapi_network
+        @restapi_network ||= RestAPINetwork.new(network_adapter)
       end
 
       def graphql_network

data/lib/gitlab/triage/entity_builders/issue_builder.rb

@@ -6,72 +6,44 @@ module Gitlab
   module Triage
     module EntityBuilders
       class IssueBuilder
+        attr_reader :destination
+
         def initialize(
-          type:, action:, resources:, network:,
+          type:, action:, resource:, network:,
           policy_spec: {}, separator: "\n")
           @type = type
           @policy_spec = policy_spec
           @item_template = action[:item]
           @title_template = action[:title]
-          @summary_template = action[:summary]
-          @summary_destination = action[:destination]
+          @description_template = action[:description]
+          @destination = action[:destination]
           @redact_confidentials =
             action[:redact_confidential_resources] != false
-          @resources = resources
+          @resource = resource
           @network = network
           @separator = separator
         end
 
         def title
-          @title ||= build_text(title_resource, @title_template)
+          @title ||= build_text(@title_template)
         end
 
         def description
-          @description ||= build_text(description_resource, @summary_template)
-        end
-
-        def destination
-          @summary_destination
+          @description ||= build_text(@description_template)
         end
 
         def valid?
-          title =~ /\S+/ && any_resources?
-        end
-
-        def any_resources?
-          @resources.any?
+          title =~ /\S+/
         end
 
         private
 
-        def title_resource
-          { type: @type }
-        end
-
-        def description_resource
-          title_resource.merge(
-            title: title, items: items, resources: @resources)
-        end
-
-        def items
-          @items ||= @resources.map(&method(:build_item)).join(@separator)
-        end
-
-        def build_item(resource)
-          case resource
-          when IssueBuilder
-            resource.description
-          else
-            build_text(resource, @item_template)
-          end
-        end
-
-        def build_text(resource, template)
+        def build_text(template)
           return '' unless template
 
           CommandBuilders::TextContentBuilder.new(
             template,
-            resource: resource,
+            resource: @resource,
             network: @network,
             redact_confidentials: @redact_confidentials)
             .build_command.chomp

data/lib/gitlab/triage/entity_builders/summary_builder.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require_relative '../command_builders/text_content_builder'
+
+module Gitlab
+  module Triage
+    module EntityBuilders
+      class SummaryBuilder
+        def initialize(
+          type:, action:, resources:, network:,
+          policy_spec: {}, separator: "\n")
+          @type = type
+          @policy_spec = policy_spec
+          @item_template = action[:item]
+          @title_template = action[:title]
+          @summary_template = action[:summary]
+          @summary_destination = action[:destination]
+          @redact_confidentials =
+            action[:redact_confidential_resources] != false
+          @resources = resources
+          @network = network
+          @separator = separator
+        end
+
+        def title
+          @title ||= build_text(title_resource, @title_template)
+        end
+
+        def description
+          @description ||= build_text(description_resource, @summary_template)
+        end
+
+        def destination
+          @summary_destination
+        end
+
+        def valid?
+          title =~ /\S+/ && any_resources?
+        end
+
+        def any_resources?
+          @resources.any?
+        end
+
+        private
+
+        def title_resource
+          { type: @type }
+        end
+
+        def description_resource
+          title_resource.merge(
+            title: title, items: items, resources: @resources)
+        end
+
+        def items
+          @items ||= @resources.map { |x| build_item(x) }.join(@separator)
+        end
+
+        def build_item(resource)
+          case resource
+          when SummaryBuilder
+            resource.description
+          else
+            build_text(resource, @item_template)
+          end
+        end
+
+        def build_text(resource, template)
+          return '' unless template
+
+          CommandBuilders::TextContentBuilder.new(
+            template,
+            resource: resource,
+            network: @network,
+            redact_confidentials: @redact_confidentials)
+            .build_command.chomp
+        end
+      end
+    end
+  end
+end

data/lib/gitlab/triage/graphql_queries/query_builder.rb

@@ -103,28 +103,28 @@ module Gitlab
             when 'forbidden_labels'
               ['labelName', condition_params, { negated: true }]
             when 'labels'
-              ['labelName', condition_params]
+              ['labelName', condition_params, {}]
             else
               return nil
             end
 
-          QueryParamBuilders::LabelsParamBuilder.new(*args)
+          QueryParamBuilders::LabelsParamBuilder.new(*args[0...-1], **args.last)
         end
 
         def merge_requests_resource_query(condition, condition_params)
           args =
             case condition.to_s
             when 'source_branch'
-              ['sourceBranches', condition_params]
+              ['sourceBranches', condition_params, {}]
             when 'target_branch'
-              ['targetBranches', condition_params]
+              ['targetBranches', condition_params, {}]
             when 'draft'
               ['draft', condition_params, { with_quotes: false }]
             else
               return nil
             end
 
-          QueryParamBuilders::BaseParamBuilder.new(*args)
+          QueryParamBuilders::BaseParamBuilder.new(*args[0...-1], **args.last)
         end
 
         def merge_requests_label_query(condition, condition_params)
@@ -133,12 +133,12 @@ module Gitlab
             when 'forbidden_labels'
               ['labels', condition_params, { negated: true }]
             when 'labels'
-              ['labels', condition_params]
+              ['labels', condition_params, {}]
             else
               return nil
             end
 
-          QueryParamBuilders::LabelsParamBuilder.new(*args)
+          QueryParamBuilders::LabelsParamBuilder.new(*args[0...-1], **args.last)
         end
       end
     end

data/lib/gitlab/triage/network.rb

@@ -1,110 +1,34 @@
-require 'active_support/all'
-require 'net/protocol'
-
-require_relative 'retryable'
-require_relative 'ui'
-require_relative 'errors'
+require_relative 'graphql_network'
+require_relative 'rest_api_network'
 
 module Gitlab
   module Triage
-    class Network
-      include Retryable
-
-      TokenNotFound = Class.new(StandardError)
-      MINIMUM_RATE_LIMIT = 25
-
-      attr_reader :options, :adapter
-
-      def initialize(adapter)
-        @adapter = adapter
-        @options = adapter.options
-        @cache = {}
-      end
-
-      def query_api_cached(url)
-        @cache[url] || @cache[url] = query_api(url)
-      end
-
+    Network = Struct.new(:restapi, :graphql, keyword_init: true) do
       def query_api(url)
-        response = {}
-        resources = []
-
-        begin
-          print '.'
-          url = response.fetch(:next_page_url) { url }
-
-          response = execute_with_retry(
-            exception_types: [Net::ReadTimeout, Errors::Network::InternalServerError],
-            backoff_exceptions: Errors::Network::TooManyRequests) do
-            puts Gitlab::Triage::UI.debug "query_api: #{url}" if options.debug
-
-            @adapter.get(token, url)
-          end
-
-          results = response.delete(:results)
-
-          case results
-          when Array
-            resources.concat(results)
-          when Hash
-            resources << results
-          else
-            raise_unexpected_response(results)
-          end
-
-          rate_limit_debug(response) if options.debug
-          rate_limit_wait(response)
-        end while response.delete(:more_pages)
-
-        resources.map!(&:with_indifferent_access)
-      rescue Net::ReadTimeout
-        []
+        restapi.query_api(url)
       end
 
-      def post_api(url, body)
-        response = execute_with_retry(
-          exception_types: Net::ReadTimeout,
-          backoff_exceptions: Errors::Network::TooManyRequests) do
-          puts Gitlab::Triage::UI.debug "post_api: #{url}" if options.debug
-
-          @adapter.post(token, url, body)
-        end
-
-        rate_limit_debug(response) if options.debug
-        rate_limit_wait(response)
-
-        results = response.delete(:results)
-
-        case results
-        when Hash
-          results.with_indifferent_access
-        else
-          raise_unexpected_response(results)
-        end
-      rescue Net::ReadTimeout
-        {}
+      def query_graphql(...)
+        graphql.query(...)
       end
 
-      private
-
-      def token
-        options.token || raise(TokenNotFound)
+      def query_api_cached(url)
+        restapi.query_api_cached(url)
       end
 
-      def rate_limit_debug(response)
-        rate_limit_infos = "Rate limit remaining: #{response[:ratelimit_remaining]} (reset at #{response[:ratelimit_reset_at]})"
-        puts Gitlab::Triage::UI.debug "rate_limit_infos: #{rate_limit_infos}"
+      def restapi_options
+        restapi.options
       end
 
-      def rate_limit_wait(response)
-        return unless response.delete(:ratelimit_remaining) < MINIMUM_RATE_LIMIT
+      # FIXME: Remove the alias method
+      alias_method :options, :restapi_options
 
-        puts Gitlab::Triage::UI.debug "Rate limit almost exceeded, sleeping for #{response[:ratelimit_reset_at] - Time.now} seconds" if options.debug
-        sleep(1) until Time.now >= response[:ratelimit_reset_at]
+      def graphql_options
+        graphql.options
       end
 
-      def raise_unexpected_response(results)
-        raise Errors::Network::UnexpectedResponse, "Unexpected response: #{results.inspect}"
+      def post_api(...)
+        restapi.post_api(...)
       end
     end
   end

data/lib/gitlab/triage/policies/base_policy.rb

@@ -59,9 +59,17 @@ module Gitlab
           (actions.keys.map(&:to_sym) - [:summarize, :comment_on_summary]).any?
         end
 
+        def issue?
+          actions.key?(:issue)
+        end
+
         def build_issue
           raise NotImplementedError
         end
+
+        def build_summary
+          raise NotImplementedError
+        end
       end
     end
   end

data/lib/gitlab/triage/policies/rule_policy.rb

@@ -2,22 +2,34 @@
 
 require_relative 'base_policy'
 require_relative '../entity_builders/issue_builder'
+require_relative '../entity_builders/summary_builder'
 
 module Gitlab
   module Triage
     module Policies
       class RulePolicy < BasePolicy
-        # Build an issue from a single rule policy
-        def build_issue
+        # Build a summary from a single rule policy
+        def build_summary
           action = actions.fetch(:summarize, {})
 
-          EntityBuilders::IssueBuilder.new(
+          EntityBuilders::SummaryBuilder.new(
             type: type,
             policy_spec: policy_spec,
             action: action,
             resources: resources,
             network: network)
         end
+
+        def build_issue(resource)
+          action = actions.fetch(:issue, {})
+
+          EntityBuilders::IssueBuilder.new(
+            type: type,
+            policy_spec: policy_spec,
+            action: action,
+            resource: resource,
+            network: network)
+        end
       end
     end
   end

data/lib/gitlab/triage/policies/summary_policy.rb

@@ -1,22 +1,22 @@
 # frozen_string_literal: true
 
 require_relative 'base_policy'
-require_relative '../entity_builders/issue_builder'
+require_relative '../entity_builders/summary_builder'
 
 module Gitlab
   module Triage
     module Policies
       class SummaryPolicy < BasePolicy
-        # Build an issue from several rules policies
-        def build_issue
+        # Build a summary from several rules policies
+        def build_summary
           action = actions[:summarize]
           issues = resources.map do |inner_policy_spec, inner_resources|
             Policies::RulePolicy.new(
               type, inner_policy_spec, inner_resources, network)
-              .build_issue
+              .build_summary
           end
 
-          EntityBuilders::IssueBuilder.new(
+          EntityBuilders::SummaryBuilder.new(
             type: type,
             action: action,
             resources: issues.select(&:any_resources?),

data/lib/gitlab/triage/resource/context.rb

@@ -3,6 +3,7 @@
 require_relative 'base'
 require_relative 'epic'
 require_relative 'issue'
+require_relative 'linked_issue'
 require_relative 'merge_request'
 require_relative 'instance_version'
 

data/lib/gitlab/triage/resource/instance_version.rb

@@ -5,7 +5,7 @@ module Gitlab
     module Resource
       class InstanceVersion < Base
         def initialize(**options)
-          super({}, options)
+          super({}, **options)
         end
 
         def version

data/lib/gitlab/triage/resource/issue.rb

@@ -24,6 +24,12 @@ module Gitlab
             resource_url(sub_resource_type: 'closed_by'))
             .map { |merge_request| MergeRequest.new(merge_request, parent: self) }
         end
+
+        def linked_issues
+          @linked_issues ||= network.query_api_cached(
+            resource_url(sub_resource_type: 'links'))
+            .map { |issue| LinkedIssue.new(issue, parent: self) }
+        end
       end
     end
   end

data/lib/gitlab/triage/resource/linked_issue.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative 'issue'
+
+module Gitlab
+  module Triage
+    module Resource
+      class LinkedIssue < Issue
+        def link_type
+          @link_type ||= resource.dig(:link_type)
+        end
+      end
+    end
+  end
+end

data/lib/gitlab/triage/rest_api_network.rb

@@ -0,0 +1,111 @@
+require 'active_support/all'
+require 'net/protocol'
+
+require_relative 'retryable'
+require_relative 'ui'
+require_relative 'errors'
+
+module Gitlab
+  module Triage
+    class RestAPINetwork
+      include Retryable
+
+      TokenNotFound = Class.new(StandardError)
+      MINIMUM_RATE_LIMIT = 25
+
+      attr_reader :options, :adapter
+
+      def initialize(adapter)
+        @adapter = adapter
+        @options = adapter.options
+        @cache = {}
+      end
+
+      def query_api_cached(url)
+        @cache[url] || @cache[url] = query_api(url)
+      end
+
+      def query_api(url)
+        response = {}
+        resources = []
+
+        begin
+          print '.'
+          url = response.fetch(:next_page_url) { url }
+
+          response = execute_with_retry(
+            exception_types: [Net::ReadTimeout, Errors::Network::InternalServerError],
+            backoff_exceptions: Errors::Network::TooManyRequests) do
+            puts Gitlab::Triage::UI.debug "query_api: #{url}" if options.debug
+
+            @adapter.get(token, url)
+          end
+
+          results = response.delete(:results)
+
+          case results
+          when Array
+            resources.concat(results)
+          when Hash
+            resources << results
+          else
+            raise_unexpected_response(results)
+          end
+
+          rate_limit_debug(response) if options.debug
+          rate_limit_wait(response)
+        end while response.delete(:more_pages)
+
+        resources.map!(&:with_indifferent_access)
+      rescue Net::ReadTimeout
+        []
+      end
+
+      def post_api(url, body)
+        response = execute_with_retry(
+          exception_types: Net::ReadTimeout,
+          backoff_exceptions: Errors::Network::TooManyRequests) do
+          puts Gitlab::Triage::UI.debug "post_api: #{url}" if options.debug
+
+          @adapter.post(token, url, body)
+        end
+
+        rate_limit_debug(response) if options.debug
+        rate_limit_wait(response)
+
+        results = response.delete(:results)
+
+        case results
+        when Hash
+          results.with_indifferent_access
+        else
+          raise_unexpected_response(results)
+        end
+      rescue Net::ReadTimeout
+        {}
+      end
+
+      private
+
+      def token
+        options.token || raise(TokenNotFound)
+      end
+
+      def rate_limit_debug(response)
+        rate_limit_infos = "Rate limit remaining: #{response[:ratelimit_remaining]} (reset at #{response[:ratelimit_reset_at]})"
+        puts Gitlab::Triage::UI.debug "rate_limit_infos: #{rate_limit_infos}"
+      end
+
+      def rate_limit_wait(response)
+        return unless response.delete(:ratelimit_remaining) < MINIMUM_RATE_LIMIT
+
+        puts Gitlab::Triage::UI.debug "Rate limit almost exceeded, sleeping for #{response[:ratelimit_reset_at] - Time.now} seconds" if options.debug
+        sleep(1) until Time.now >= response[:ratelimit_reset_at]
+      end
+
+      def raise_unexpected_response(results)
+        raise Errors::Network::UnexpectedResponse, "Unexpected response: #{results.inspect}"
+      end
+    end
+  end
+end

data/lib/gitlab/triage/version.rb

@@ -2,6 +2,6 @@
 
 module Gitlab
   module Triage
-    VERSION = '1.23.1'
+    VERSION = '1.24.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-triage
 version: !ruby/object:Gem::Version
-  version: 1.23.1
+  version: 1.24.0
 platform: ruby
 authors:
 - GitLab
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-27 00:00:00.000000000 Z
+date: 2022-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -153,6 +153,7 @@ files:
 - ".gitlab/merge_request_templates/Default.md"
 - ".gitlab/merge_request_templates/Release.md"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
 - ".ruby-version"
 - ".tool-versions"
 - ".yardopts"
@@ -170,6 +171,7 @@ files:
 - lib/gitlab/triage/action/base.rb
 - lib/gitlab/triage/action/comment.rb
 - lib/gitlab/triage/action/comment_on_summary.rb
+- lib/gitlab/triage/action/issue.rb
 - lib/gitlab/triage/action/summarize.rb
 - lib/gitlab/triage/api_query_builders/base_query_param_builder.rb
 - lib/gitlab/triage/api_query_builders/date_query_param_builder.rb
@@ -185,6 +187,7 @@ files:
 - lib/gitlab/triage/command_builders/text_content_builder.rb
 - lib/gitlab/triage/engine.rb
 - lib/gitlab/triage/entity_builders/issue_builder.rb
+- lib/gitlab/triage/entity_builders/summary_builder.rb
 - lib/gitlab/triage/errors.rb
 - lib/gitlab/triage/errors/network.rb
 - lib/gitlab/triage/expand_condition.rb
@@ -228,9 +231,11 @@ files:
 - lib/gitlab/triage/resource/issue.rb
 - lib/gitlab/triage/resource/label.rb
 - lib/gitlab/triage/resource/label_event.rb
+- lib/gitlab/triage/resource/linked_issue.rb
 - lib/gitlab/triage/resource/merge_request.rb
 - lib/gitlab/triage/resource/milestone.rb
 - lib/gitlab/triage/resource/shared/issuable.rb
+- lib/gitlab/triage/rest_api_network.rb
 - lib/gitlab/triage/retryable.rb
 - lib/gitlab/triage/ui.rb
 - lib/gitlab/triage/url_builders/url_builder.rb