gitlab-triage 1.6.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85ef311a9c0950dacc0823958bf5a5a61ead1dbc6696599d5a9c1ed9d1cc5ca7
-  data.tar.gz: 421ccd2c8d050659990ad07a8493d23bac378224acd94f47997cfaeec3633b04
+  metadata.gz: d17d4b0574943a4b6dc8419c28fe0d8d09577adebe135e6aafe6cdd06a2ebd12
+  data.tar.gz: 7e937ca82cec7feec0e7223d7a6e4a967cd0d0a65d54a26b807f32cad3bf8669
 SHA512:
-  metadata.gz: 706a9954e233b3a7c427068194e25a998fd193fd6373f5d82ad2f152935c2ca9ec16fd61301c687fac057b4972ccadfcc34bc52d44821494bd908cd5eae32b6e
-  data.tar.gz: 639d905c6dce18d3d1af351897a05800e4cb708a7673dc325887d0b38a58d62c54dc85afdf084705ec713ec9d3d9c06273fc7b8afce5e8644a3fada7193b5d2b
+  metadata.gz: 7041a271066e0b933dfc3d3fa47b7150592746c3a0f25352b363cfc4f6de9c48556ede940394e72c5054e7076244e3e87cc4c2e068755a43e66bbf3d1934f5ed
+  data.tar.gz: bf26c4395bc081ac3930f001448f33d4342dcb2f3a0aac8f74cff84aabe2f665675be8adf5578a2ef3a39d573c5d6f7dbcfeafa7a88339b389ab839a5c7918aa

data/.gitignore

@@ -6,7 +6,6 @@
 /Gemfile.lock
 /_yardoc/
 /coverage/
-/doc/
 /pkg/
 /spec/reports/
 /tmp/

data/.gitlab-ci.yml

@@ -1,49 +1,67 @@
-image: ruby:2.6
-
 stages:
   - prepare
   - test
   - triage
+  - release
 
-.default-only:
-  only:
-    refs:
-      - master
-      - merge_requests
-      - tags
-
-.default-before_script:
+default:
+  image: ruby:2.7
+  tags:
+    - gitlab-org
+  cache:
+    key:
+      files:
+        - Gemfile
+        - gitlab-triage.gemspec
+    paths:
+      - vendor/ruby
+      - Gemfile.lock
+    policy: pull
   before_script:
+    - ruby --version
     - gem install bundler --no-document --version 2.0.2
-    - bundle install --jobs $(nproc) --retry 3 --quiet
+    - bundle --version
+    - bundle install --jobs $(nproc) --path=vendor --retry 3 --quiet
+    - bundle check
+
+workflow:
+  rules:
+    # For merge requests, create a pipeline.
+    - if: '$CI_MERGE_REQUEST_IID'
+    # For `master` branch, create a pipeline (this includes on schedules, pushes, merges, etc.).
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+    # For tags, create a pipeline.
+    - if: '$CI_COMMIT_TAG'
+
+.use-docker-in-docker:
+  image: docker:${DOCKER_VERSION}
+  services:
+    - docker:${DOCKER_VERSION}-dind
+  variables:
+    DOCKER_DRIVER: overlay2
+    DOCKER_HOST: tcp://docker:2375
+    DOCKER_TLS_CERTDIR: ""
+  tags:
+    # See https://gitlab.com/gitlab-com/www-gitlab-com/-/issues/7019 for tag descriptions
+    - gitlab-org-docker
 
 ###################
 ## Prepare stage ##
 ###################
 setup-test-env:
-  extends: .default-only
   stage: prepare
   script:
-    - ruby --version
-    - gem install bundler --no-document
-    - bundle --version
-    - bundle install --clean --jobs $(nproc) --path=vendor --retry=3 --quiet
-    - bundle check
+    - echo "Setup done!"
   cache:
-    key: "$CI_JOB_NAME-ruby-2.6"
-    paths:
-      - vendor/ruby
-      - Gemfile.lock
+    policy: pull-push
   artifacts:
     paths:
-      - vendor/ruby
       - Gemfile.lock
 
 ################
 ## Test stage ##
 ################
 rubocop:
-  extends: [".default-only", ".default-before_script"]
   stage: test
   needs: ["setup-test-env"]
   dependencies: ["setup-test-env"]
@@ -55,20 +73,15 @@ rubocop:
       - .cache/rubocop_cache/
 
 # We need to copy this job's definition from the Code-Quality.gitlab-ci.yml
-# template because `only` is set without `refs`, so it takes precedence over `.default-only`.
+# template because `only` is set without `refs`, so it takes precedence over default workflow rules.
 # See https://gitlab.com/gitlab-org/gitlab-ce/issues/66767.
 code_quality:
-  extends: .default-only
-  needs: ["setup-test-env"]
-  dependencies: ["setup-test-env"]
+  extends: .use-docker-in-docker
   stage: test
-  image: docker:stable
   allow_failure: true
-  services:
-    - docker:stable-dind
   variables:
-    DOCKER_DRIVER: overlay2
     DOCKER_TLS_CERTDIR: ""
+  before_script: []
   script:
     - |
       if ! docker info &>/dev/null; then
@@ -85,14 +98,9 @@ code_quality:
     reports:
       codequality: gl-code-quality-report.json
     expire_in: 1 week
-  except:
-    variables:
-      - $CODE_QUALITY_DISABLED
 
 specs:
-  extends: [".default-only", ".default-before_script"]
   needs: ["setup-test-env"]
-  dependencies: ["setup-test-env"]
   stage: test
   script:
     - bundle exec rake spec
@@ -101,12 +109,13 @@ specs:
 ## Triage stage ##
 ##################
 dry-run:gitlab-triage:
-  extends: [".default-only", ".default-before_script"]
   needs: ["setup-test-env"]
-  dependencies: ["setup-test-env"]
   stage: triage
   script:
-    - bundle exec rake install:local
+    - bundle exec rake build
+    - gem install pkg/*.gem
+    - which gitlab-triage
+    - gitlab-triage --version
     - gitlab-triage --help
     - gitlab-triage --init
     - gitlab-triage --dry-run --debug --token $API_TOKEN --source-id $CI_PROJECT_PATH
@@ -114,4 +123,30 @@ dry-run:gitlab-triage:
 # This job requires allows to override the `CI_PROJECT_PATH` variable when triggered.
 dry-run:custom:
   extends: dry-run:gitlab-triage
-  when: manual
+  rules:
+    - when: manual
+      allow_failure: true
+
+###################
+## Release stage ##
+###################
+release:
+  stage: release
+  rules:
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $CI_PIPELINE_SOURCE == "push"'
+      changes: ["lib/gitlab/triage/version.rb"]
+    - if: '$CI_MERGE_REQUEST_TITLE =~ /RELEASE/'
+      when: manual
+  before_script: []
+  script:
+    - version=$(ruby -r ./lib/gitlab/triage/version -e 'puts Gitlab::Triage::VERSION' | tr -d "\n")
+    - tag="v${version}"
+    - message="Version ${version}."
+    # TODO: Add release notes from the Release MR?
+    - 'curl --request POST --header "PRIVATE-TOKEN: ${API_TOKEN}" -d "tag_name=${tag}" -d "ref=${CI_COMMIT_SHA}" -d "message=${message}" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/repository/tags"'
+    - gem build gitlab-triage.gemspec
+    - gem push "gitlab-triage-${version}.gem"
+  artifacts:
+    paths:
+      - gitlab-triage*.gem
+    expire_in: 30 days

data/.gitlab/merge_request_templates/Release.md

@@ -0,0 +1,35 @@
+<!-- Replace `v4.5.0` with the previous release here, and `e18d76b309e42888759c1effe96767f13e34ae55`
+with the latest commit from https://gitlab.com/gitlab-org/gitlab-triage/commits/master that will be included in the release. -->
+- Diff: https://gitlab.com/gitlab-org/gitlab-triage/compare/v4.5.0...e18d76b309e42888759c1effe96767f13e34ae55
+
+- Release notes:
+
+<!-- Keep the sections order but remove the empty sections -->
+
+```markdown
+### New scenarios and scenario updates
+
+- !aaa <Title of the aaa MR>.
+
+### Fixes
+
+- !bbb <Title of the bbb MR>.
+
+### Doc changes
+
+- !ccc <Title of the ccc MR>.
+
+### Other changes (CI, backstage)
+
+- !ddd <Title of the ddd MR>.
+```
+
+- Checklist before merging:
+  - [ ] Diff link is up-to-date.
+  - [ ] Based on the diff, `lib/gitlab/triage/version.rb` is updated, according to [SemVer](https://semver.org).
+  - [ ] Release notes are accurate.
+
+- Checklist after merging:
+  - [ ] [Update the release notes for the newly created tag](docs/release_process.md#how-to).
+
+/label ~"Engineering Productivity" ~"ep::triage"

data/.rubocop.yml

@@ -11,3 +11,6 @@ AllCops:
 
 Rails/Output:
   Enabled: false
+
+Metrics/LineLength:
+  Max: 152

data/Gemfile

@@ -4,5 +4,5 @@ source 'https://rubygems.org'
 gemspec
 
 group :test do
-  gem 'gitlab-styles', '~> 3.0'
+  gem 'gitlab-styles', '~> 3.3.0'
 end

data/README.md

@@ -2,7 +2,7 @@
 
 # GitLab Triage Project
 
-This project contains the library and pipeline definition to enable automated triaging of issues in the [GitLab Project](https://gitlab.com/gitlab-org/gitlab).
+This project allows to automate triaging of issues and merge requests for GitLab projects or groups.
 
 ## gitlab-triage gem
 
@@ -58,7 +58,7 @@ resource_rules:
             interval: 5
           state: opened
           labels:
-            - No Label
+            - None
         limits:
           most_recent: 50
         actions:
@@ -66,6 +66,7 @@ resource_rules:
             - needs attention
           mention:
             - markglenfletcher
+          move: gitlab-org/backlog
           comment: |
             {{author}} This issue is unlabelled after 5 days. It needs attention. Please take care of this before the end of #{2.days.from_now.strftime('%Y-%m-%d')}
           summarize:
@@ -85,9 +86,27 @@ resource_rules:
               /label ~"needs attention"
   merge_requests:
     rules:
-      []
+      - name: My policy
+        conditions:
+          state: opened
+          labels:
+            - None
+        limits:
+          most_recent: 50
+        actions:
+          labels:
+            - needs attention
+          comment_type: thread
+          comment: |
+            {{author}} This issue is unlabelled. Please add one or more labels.
 ```
 
+### Real world example
+
+We're enforcing multiple polices with pipeline schedules at [triage-ops](
+https://gitlab.com/gitlab-org/quality/triage-ops), where we're also
+extensively utilizing the [plugins system](#can-i-customize).
+
 ### Fields
 
 A policy consists of the following fields:
@@ -210,6 +229,22 @@ conditions:
     - feature proposal
 ```
 
+###### Predefined special label names
+
+Basing on the [issues API](https://docs.gitlab.com/ee/api/issues.html), there
+are two special predefined label names we can use here:
+
+* `None`: This indicates that no labels were present
+* `Any`: This indicates that any labels were presented
+
+Example:
+
+```yml
+conditions:
+  labels:
+    - None
+```
+
 ###### Labels brace expansion
 
 We could expand the labels by using brace expansion, which is a pattern
@@ -506,7 +541,9 @@ Available action types:
 - [`remove_labels` action](#remove-labels-action)
 - [`status` action](#status-action)
 - [`mention` action](#mention-action)
+- [`move` action](#move-action)
 - [`comment` action](#comment-action)
+- [`comment_type` action option](#comment-type-action-option)
 - [`summarize` action](#summarize-action)
 
 ##### Labels action
@@ -572,6 +609,19 @@ actions:
     - markglenfletcher
 ```
 
+##### Move action
+
+Moves an issue (merge request is not supported yet) to the specified project.
+
+Accepts a string containing the target project path.
+
+Example:
+
+```yml
+actions:
+  move: target/project_path
+```
+
 ##### Comment action
 
 Adds a comment to the resource.
@@ -619,6 +669,26 @@ actions:
     {{author}} Are you still interested in finishing this merge request?
 ```
 
+##### Comment type action option
+
+Determines the type of comment to be added to the resource.
+
+The following comment types are supported:
+
+- `comment` (default): creates a regular comment on the resource
+- `thread`: starts a resolvable thread (discussion) on the resource
+
+For merge requests, if `comment_type` is set to `thread`, we can also configure that [all threads should be resolved before merging](https://docs.gitlab.com/ee/user/discussions/#only-allow-merge-requests-to-be-merged-if-all-threads-are-resolved), therefore this comment can prevent it from merging.
+
+Example:
+
+```yml
+actions:
+  comment_type: thread
+  comment: |
+    {{author}} Are you still interested in finishing this merge request?
+```
+
 ###### Harnessing Quick Actions
 
 [GitLab's quick actions feature](https://docs.gitlab.com/ce/user/project/quick_actions.html) is available in Core.
@@ -839,7 +909,7 @@ Which could generate an issue like:
 
 Here's a list of currently available Ruby expression API:
 
-##### API
+##### Methods for `Issue` and `MergeRequest` (the context)
 
 | Name                    | Return type     | Description |
 | ----                    | ----            | ----        |
@@ -851,6 +921,14 @@ Here's a list of currently available Ruby expression API:
 | labels_chronologically  | [Label]         | Same as `labels_with_details` but sorted chronologically |
 | label_events            | [LabelEvent]    | A list of label events on the resource |
 | instance_version        | InstanceVersion | The version for the GitLab instance we're triaging with |
+| project_path            | String          | The path with namespace to the issues or merge requests project |
+| full_resource_reference | String          | A full reference incuding project path to the issue or merge request |
+
+##### Methods for `MergeRequest` (merge request context)
+
+| Method              | Return type | Description |
+| ----                | ----        | ----        |
+| first_contribution? | Boolean     | `true` if it's the author's first contribution to the project; `false` otherwise. This API requires an additional API request for the merge request, thus would be slower. |
 
 ##### Methods for `Milestone`
 
@@ -928,6 +1006,7 @@ Usage: gitlab-triage [options]
     -r, --require [string]           Require a file before performing
     -d, --debug                      Print debug information
     -h, --help                       Print help message
+        --all-projects               Process all projects visible to `--token`
         --init                       Initialize the project with a policy file
         --init-ci                    Initialize the project with a .gitlab-ci.yml file
 ```
@@ -946,6 +1025,14 @@ Triaging against a whole group:
 gitlab-triage --dry-run --token $API_TOKEN --source-id gitlab-org --source groups
 ```
 
+Triaging against an entire instance:
+
+```
+gitlab-triage --dry-run --token $API_TOKEN --all-projects
+```
+
+> **Note:** The `--all-projects` option will process all resources for all projects visible to the specified `$API_TOKEN`
+
 #### Running on GitLab CI pipeline
 
 You can enforce policies using a scheduled pipeline:
@@ -1028,3 +1115,7 @@ resource_rules:
 ### Contributing
 
 Please refer to the [Contributing Guide](CONTRIBUTING.md).
+
+## Release Process
+
+Please refer to the [Release Process](docs/release_process.md).

data/gitlab-triage.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
+    f.match(%r{^(docs|test|spec|features)/})
   end
   spec.bindir        = 'bin'
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }

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

@@ -7,6 +7,7 @@ require_relative '../command_builders/label_command_builder'
 require_relative '../command_builders/remove_label_command_builder'
 require_relative '../command_builders/cc_command_builder'
 require_relative '../command_builders/status_command_builder'
+require_relative '../command_builders/move_command_builder'
 
 module Gitlab
   module Triage
@@ -43,6 +44,7 @@ module Gitlab
               CommandBuilders::LabelCommandBuilder.new(policy.actions[:labels]).build_command,
               CommandBuilders::RemoveLabelCommandBuilder.new(policy.actions[:remove_labels]).build_command,
               CommandBuilders::CcCommandBuilder.new(policy.actions[:mention]).build_command,
+              CommandBuilders::MoveCommandBuilder.new(policy.actions[:move]).build_command,
               CommandBuilders::StatusCommandBuilder.new(policy.actions[:status]).build_command
             ]
           ).build_command
@@ -61,13 +63,24 @@ module Gitlab
             source_id: resource[:project_id],
             resource_type: policy.type,
             resource_id: resource['iid'],
-            sub_resource_type: 'notes'
+            sub_resource_type: sub_resource_type
           ).build
 
           puts Gitlab::Triage::UI.debug "post_url: #{post_url}" if network.options.debug
 
           post_url
         end
+
+        def sub_resource_type
+          case type = policy.actions[:comment_type]
+          when 'comment', nil # nil is default
+            'notes'
+          when 'thread'
+            'discussions'
+          else
+            raise ArgumentError, "Unknown comment type: #{type}"
+          end
+        end
       end
     end
   end

data/lib/gitlab/triage/command_builders/move_command_builder.rb

@@ -0,0 +1,19 @@
+require_relative 'base_command_builder'
+
+module Gitlab
+  module Triage
+    module CommandBuilders
+      class MoveCommandBuilder < BaseCommandBuilder
+        private
+
+        def slash_command_string
+          "/move"
+        end
+
+        def format_item(item)
+          item
+        end
+      end
+    end
+  end
+end

data/lib/gitlab/triage/command_builders/text_content_builder.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'active_support/core_ext/array/wrap'
+require 'cgi'
 
 require_relative 'base_command_builder'
 require_relative '../resource/context'
@@ -76,7 +77,22 @@ module Gitlab
               template.sub(PLACEHOLDER_REGEX, attribute.to_s)
             end.join(', ')
 
-            comment.gsub("{{#{placeholder}}}", formatted_text)
+            escaped_text =
+              case placeholder
+              when :items
+                # We don't need to escape it because it's recursive,
+                # which the contents should all be escaped already.
+                # Or put it another way, items isn't an attribute
+                # retrieved externally. It's a generated value which
+                # should be safe to begin with. At some point we
+                # may want to make this more distinguishable,
+                # separating values from API and values generated.
+                formatted_text
+              else
+                CGI.escape_html(formatted_text)
+              end
+
+            comment.gsub("{{#{placeholder}}}", escaped_text)
           end
         end
 

data/lib/gitlab/triage/engine.rb

@@ -38,6 +38,7 @@ module Gitlab
         @options = options
         @network_adapter_class = network_adapter_class
 
+        assert_all!
         assert_project_id!
         assert_token!
         require_ruby_files
@@ -66,6 +67,7 @@ module Gitlab
 
       def assert_project_id!
         return if options.source_id
+        return if options.all
 
         raise ArgumentError, 'A project_id is needed (pass it with the `--source-id` option)!'
       end
@@ -76,6 +78,11 @@ module Gitlab
         raise ArgumentError, 'A token is needed (pass it with the `--token` option)!'
       end
 
+      def assert_all!
+        raise ArgumentError, '--all-projects option cannot be used in conjunction with --source and --source-id option!' if
+          options.all && (options.source || options.source_id)
+      end
+
       def require_ruby_files
         options.require_files.each(&method(:require))
       end
@@ -196,12 +203,32 @@ module Gitlab
                          raise "Unknown resource type: #{resource[:type]}"
                        end
           end
-          results << Filters::VotesConditionsFilter.new(resource, conditions[:upvotes]).calculate if conditions[:upvotes]
-          results << Filters::ForbiddenLabelsConditionsFilter.new(resource, conditions[:forbidden_labels]).calculate if conditions[:forbidden_labels]
-          results << Filters::NoAdditionalLabelsConditionsFilter.new(resource, conditions.fetch(:labels) { [] }).calculate if conditions[:no_additional_labels]
-          results << Filters::AuthorMemberConditionsFilter.new(resource, conditions[:author_member], network).calculate if conditions[:author_member]
-          results << Filters::AssigneeMemberConditionsFilter.new(resource, conditions[:assignee_member], network).calculate if conditions[:assignee_member]
-          results << Filters::RubyConditionsFilter.new(resource, conditions, network).calculate if conditions[:ruby]
+
+          # rubocop:disable Style/IfUnlessModifier
+          if conditions[:upvotes]
+            results << Filters::VotesConditionsFilter.new(resource, conditions[:upvotes]).calculate
+          end
+
+          if conditions[:forbidden_labels]
+            results << Filters::ForbiddenLabelsConditionsFilter.new(resource, conditions[:forbidden_labels]).calculate
+          end
+
+          if conditions[:no_additional_labels]
+            results << Filters::NoAdditionalLabelsConditionsFilter.new(resource, conditions.fetch(:labels) { [] }).calculate
+          end
+
+          if conditions[:author_member]
+            results << Filters::AuthorMemberConditionsFilter.new(resource, conditions[:author_member], network).calculate
+          end
+
+          if conditions[:assignee_member]
+            results << Filters::AssigneeMemberConditionsFilter.new(resource, conditions[:assignee_member], network).calculate
+          end
+
+          if conditions[:ruby]
+            results << Filters::RubyConditionsFilter.new(resource, conditions, network).calculate
+          end
+          # rubocop:enable Style/IfUnlessModifier
 
           results.all?
         end
@@ -235,6 +262,7 @@ module Gitlab
 
         UrlBuilders::UrlBuilder.new(
           network_options: options,
+          all: options.all,
           source: options.source,
           source_id: options.source_id,
           resource_type: resource_type,

data/lib/gitlab/triage/errors.rb

@@ -0,0 +1 @@
+require_relative 'errors/network'

data/lib/gitlab/triage/errors/network.rb

@@ -0,0 +1,9 @@
+module Gitlab
+  module Triage
+    module Errors
+      module Network
+        InternalServerError = Class.new(StandardError)
+      end
+    end
+  end
+end

data/lib/gitlab/triage/network.rb

@@ -3,6 +3,7 @@ require 'net/protocol'
 
 require_relative 'retryable'
 require_relative 'ui'
+require_relative 'errors'
 
 module Gitlab
   module Triage
@@ -30,11 +31,12 @@ module Gitlab
 
         begin
           print '.'
+          url = response.fetch(:next_page_url) { url }
 
-          response = execute_with_retry(Net::ReadTimeout) do
+          response = execute_with_retry([Net::ReadTimeout, Errors::Network::InternalServerError]) do
             puts Gitlab::Triage::UI.debug "query_api: #{url}" if options.debug
 
-            @adapter.get(token, response.fetch(:next_page_url) { url })
+            @adapter.get(token, url)
           end
 
           results = response.delete(:results)

data/lib/gitlab/triage/network_adapters/httparty_adapter.rb

@@ -2,6 +2,7 @@ require 'httparty'
 
 require_relative 'base_adapter'
 require_relative '../ui'
+require_relative '../errors'
 
 module Gitlab
   module Triage
@@ -17,10 +18,11 @@ module Gitlab
           )
 
           raise_on_unauthorized_error!(response)
+          raise_on_internal_server_error!(response)
 
           {
             more_pages: (response.headers["x-next-page"].to_s != ""),
-            next_page_url: url + "&page=#{response.headers['x-next-page']}",
+            next_page_url: next_page_url(url, response),
             results: response.parsed_response,
             ratelimit_remaining: response.headers["ratelimit-remaining"].to_i,
             ratelimit_reset_at: Time.at(response.headers["ratelimit-reset"].to_i)
@@ -38,6 +40,7 @@ module Gitlab
           )
 
           raise_on_unauthorized_error!(response)
+          raise_on_internal_server_error!(response)
 
           {
             results: response.parsed_response,
@@ -52,8 +55,29 @@ module Gitlab
           return unless response.response.is_a?(Net::HTTPUnauthorized)
 
           puts Gitlab::Triage::UI.debug response.inspect if options.debug
+
           raise 'The provided token is unauthorized!'
         end
+
+        def raise_on_internal_server_error!(response)
+          return unless response.response.is_a?(Net::HTTPInternalServerError)
+
+          puts Gitlab::Triage::UI.debug response.inspect if options.debug
+
+          raise Errors::Network::InternalServerError, 'Internal server error encountered!'
+        end
+
+        def next_page_url(url, response)
+          return unless response.headers['x-next-page'].present?
+
+          next_page = "&page=#{response.headers['x-next-page']}"
+
+          if url.include?('&page')
+            url.gsub(/&page=\d+/, next_page)
+          else
+            url + next_page
+          end
+        end
       end
     end
   end

data/lib/gitlab/triage/option_parser.rb

@@ -23,6 +23,10 @@ module Gitlab
               options.policies_files << value
             end
 
+            opts.on('--all-projects', 'Process all projects the token has access to') do |value|
+              options.all = value
+            end
+
             opts.on('-s', '--source [type]', [:projects, :groups], 'The source type between [ projects or groups ], default value: projects') do |value|
               options.source = value
             end
@@ -59,6 +63,12 @@ module Gitlab
               exit # rubocop:disable Rails/Exit
             end
 
+            opts.on('-v', '--version', 'Print version') do
+              require_relative 'version'
+              $stdout.puts Gitlab::Triage::VERSION
+              exit # rubocop:disable Rails/Exit
+            end
+
             opts.on('--init', 'Initialize the project with a policy file') do
               example_path =
                 File.expand_path('../../../support/.triage-policies.example.yml', __dir__)

data/lib/gitlab/triage/options.rb

@@ -3,6 +3,7 @@ module Gitlab
     Options = Struct.new(
       :dry_run,
       :policies_files,
+      :all,
       :source,
       :source_id,
       :token,
@@ -17,6 +18,7 @@ module Gitlab
         # Defaults
         self.host_url ||= 'https://gitlab.com'
         self.api_version ||= 'v4'
+        self.all ||= false
         self.source ||= 'projects'
         self.require_files ||= []
         self.policies_files ||= Set.new

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

@@ -41,6 +41,11 @@ module Gitlab
 
         private
 
+        def expand_resource!(params: {})
+          resource.merge!(
+            network.query_api_cached(resource_url(params: params)).first)
+        end
+
         def source_resource
           @source_resource ||= network.query_api_cached(source_url).first
         end

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

@@ -8,6 +8,10 @@ module Gitlab
     module Resource
       class Issue < Base
         include Shared::Issuable
+
+        def reference
+          '#'
+        end
       end
     end
   end

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

@@ -8,6 +8,19 @@ module Gitlab
     module Resource
       class MergeRequest < Base
         include Shared::Issuable
+
+        def reference
+          '!'
+        end
+
+        def first_contribution?
+          if resource.key?(:first_contribution)
+            resource[:first_contribution]
+          else
+            expanded = expand_resource!
+            expanded[:first_contribution]
+          end
+        end
       end
     end
   end

data/lib/gitlab/triage/resource/shared/issuable.rb

@@ -49,6 +49,20 @@ module Gitlab
             @author ||= resource.dig(:author, :username)
           end
 
+          def project_path
+            @project_path ||=
+              request_project(resource[:project_id])[:path_with_namespace]
+          end
+
+          def full_resource_reference
+            @full_resource_reference ||=
+              "#{project_path}#{reference}#{resource[:iid]}"
+          end
+
+          def reference
+            raise NotImplementedError
+          end
+
           def root_id(
             resource: source_resource,
             max_levels: MAX_PARENT_LOOKUP)
@@ -72,6 +86,10 @@ module Gitlab
               resource_url(sub_resource_type: 'resource_label_events'))
           end
 
+          def request_project(project_id)
+            network.query_api_cached(project_url(project_id)).first
+          end
+
           def request_group(group_id)
             network.query_api_cached(group_url(group_id)).first
           end
@@ -83,6 +101,14 @@ module Gitlab
               source_id: group_id
             ).build
           end
+
+          def project_url(project_id)
+            Gitlab::Triage::UrlBuilders::UrlBuilder.new(
+              network_options: network.options,
+              source: 'projects',
+              source_id: project_id
+            ).build
+          end
         end
       end
     end

data/lib/gitlab/triage/retryable.rb

@@ -5,7 +5,7 @@ module Gitlab
 
       attr_accessor :tries
 
-      def execute_with_retry(exception_type = StandardError)
+      def execute_with_retry(exception_types = [StandardError])
         @tries = 0
 
         until maximum_retries_reached?
@@ -13,7 +13,7 @@ module Gitlab
             @tries += 1
             result = yield
             break
-          rescue exception_type
+          rescue *exception_types
             raise if maximum_retries_reached?
           end
         end

data/lib/gitlab/triage/url_builders/url_builder.rb

@@ -6,6 +6,7 @@ module Gitlab
           @network_options = options.fetch(:network_options)
           @host_url = @network_options.host_url
           @api_version = @network_options.api_version
+          @all = options.fetch(:all, false)
           @source = options.fetch(:source, 'projects')
           @source_id = options.fetch(:source_id)
           @resource_type = options.fetch(:resource_type, nil)
@@ -15,11 +16,11 @@ module Gitlab
         end
 
         def build
-          base_url.tap do |url|
-            url << "/#{@resource_id}" if @resource_id
-            url << "/#{@sub_resource_type}" if @sub_resource_type
-            url << params_string if @params
-          end
+          url = base_url
+          url << "/#{@resource_id}" if @resource_id
+          url << "/#{@sub_resource_type}" if @sub_resource_type
+          url << params_string if @params
+          url
         end
 
         private
@@ -29,10 +30,10 @@ module Gitlab
         end
 
         def base_url
-          "#{host_with_api_url}/#{@source}/#{CGI.escape(@source_id.to_s)}"
-            .tap do |url|
-              url << "/#{@resource_type}" if @resource_type
-            end
+          url = host_with_api_url
+          url << "/#{@source}/#{CGI.escape(@source_id.to_s)}" unless @all
+          url << "/#{@resource_type}" if @resource_type
+          url
         end
 
         def params_string

data/lib/gitlab/triage/validators/limiter_validator.rb

@@ -12,7 +12,9 @@ module Gitlab
       end
 
       def validate_required_parameters(value)
-        raise ArgumentError, "For the limits field, please specify one of: `#{params_limiter_names.join('`, `')}`" unless value.keys.map(&:to_sym).one? { |key| params_limiter_names.include?(key) }
+        return if value.keys.one? { |key| params_limiter_names.include?(key.to_sym) }
+
+        raise ArgumentError, "For the limits field, please specify one of: `#{params_limiter_names.join('`, `')}`"
       end
     end
   end

data/lib/gitlab/triage/version.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module Gitlab
   module Triage
-    VERSION = '1.6.0'.freeze
+    VERSION = '1.9.0'
   end
 end

data/support/.triage-policies.example.yml

@@ -6,10 +6,10 @@ resource_rules:
           date:
             attribute: created_at
             condition: older_than
-            interval_type: week
+            interval_type: weeks
             interval: 1
           labels:
-            - No label
+            - None
           state: opened
         actions:
           comment: |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-triage
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.9.0
 platform: ruby
 authors:
 - GitLab
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-31 00:00:00.000000000 Z
+date: 2020-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -120,6 +120,7 @@ files:
 - ".gitignore"
 - ".gitlab-ci.yml"
 - ".gitlab/CODEOWNERS"
+- ".gitlab/merge_request_templates/Release.md"
 - ".rubocop.yml"
 - CONTRIBUTING.md
 - Gemfile
@@ -141,11 +142,14 @@ files:
 - lib/gitlab/triage/command_builders/cc_command_builder.rb
 - lib/gitlab/triage/command_builders/comment_command_builder.rb
 - lib/gitlab/triage/command_builders/label_command_builder.rb
+- lib/gitlab/triage/command_builders/move_command_builder.rb
 - lib/gitlab/triage/command_builders/remove_label_command_builder.rb
 - lib/gitlab/triage/command_builders/status_command_builder.rb
 - 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/errors.rb
+- lib/gitlab/triage/errors/network.rb
 - lib/gitlab/triage/expand_condition.rb
 - lib/gitlab/triage/expand_condition/expansion.rb
 - lib/gitlab/triage/expand_condition/list.rb
@@ -210,7 +214,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: GitLab triage automation project.