gitlab-triage 1.49.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6412e63a12ac53c09a1eb643cd3b5aa49e08e4691544b3356212e8ddec460d56
-  data.tar.gz: 2c655d476bc397a889f103763a31525116b1b647bfa382ddd9e7418cfe3e7c42
+  metadata.gz: '066092d8567b3b76494b99f0c244c565d1c9b65938082e741fe955742c89e88e'
+  data.tar.gz: 3fc1d9bf0c94a47b6d6a39002014bb60fe52ac93624cb50f6a06cc2f73d11528
 SHA512:
-  metadata.gz: df41feed9393573cf512348b2fb8f5be16474f58ca2af16ab1190543f7cf910b97b5a5c48798927b54ca5e25c72522f2e3609dc0c9d3d46a384259372160be85
-  data.tar.gz: 23f44c55003c443b5535dc9be1100cf55510f4fd105fc145685cb3446a1cff8b67540db0c784340fe1cd90c999a2c08330cc9b6722c1131760b2a39fd08a7194
+  metadata.gz: cd1f5e1088ec9cbe4e21ed6c968ce47489be3d83c95fffd07fd8e59a8eb92240ed44172f09f34390901dd43241a70320e859b5350b1afd20007550736d4bad75
+  data.tar.gz: ef7c028266e48926aba06c4fc908798eb7b9b60d3a16cfe7fe05a6134e5756374419961f52baf6c41e12a38f61b5a9c66f11c7e771b725d640619bc13db9bf04

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitlab-triage (1.49.0)
+    gitlab-triage (1.50.0)
       activesupport (>= 5.1)
       globalid (~> 1.0, >= 1.0.1)
       graphql (< 2.1.0)

data/README.md

@@ -1467,6 +1467,10 @@ Usage: gitlab-triage [options]
     -H, --host-url [string]          A valid host url
     -r, --require [string]           Require a file before performing
     -d, --debug                      Print debug information
+        --cache-dir [string]         Directory containing pre-fetched API responses.
+                                     Files must follow the naming convention: <source>_<id>_<resource>.json
+                                     (e.g. groups_9970_members.json).
+                                     Can also be set via the GITLAB_TRIAGE_CACHE_DIR environment variable.
     -h, --help                       Print help message
     -v, --version                    Print version
         --init                       Initialize the project with a policy file
@@ -1592,6 +1596,44 @@ resource_rules:
             #{'/label ~P3' unless has_priority_label?}
 ```
 
+### API Response Caching (`--cache-dir`)
+
+In large CI pipelines with many concurrent triage jobs, each job independently fetches the same paginated API responses (e.g., group members). This results in many redundant API calls.
+
+The `--cache-dir` option (or `CACHE_DIR` environment variable) allows you to pre-fetch responses once and share them across all jobs via CI artifacts.
+
+#### File naming convention
+
+Cache files must be named `<source_type>_<source_id>_<resource>.json`, for example:
+
+- `groups_9970_members.json` — members of group 9970 (numeric ID)
+- `projects_278964_members.json` — members of project 278964 (numeric ID)
+- `groups_gitlab-org_gitlab_members.json` — members of `gitlab-org/gitlab` (path slashes replaced with `_`)
+
+The gem checks for a matching cache file before making each `query_api_cached` call. If a file exists, its contents are returned directly. If not, the gem falls back to the normal API call transparently.
+
+#### Usage in CI
+
+Pre-fetch in a `pre-hygiene` stage and share as an artifact:
+
+```yaml
+# pre-hygiene job writes the cache
+prefetch-members:
+  stage: pre-hygiene
+  script:
+    - ruby bin/prefetch_members
+  artifacts:
+    paths:
+      - tmp/members_cache/
+    expire_in: 1 hour
+
+# triage jobs read from the cache
+triage-job:
+  stage: hygiene
+  script:
+    - gitlab-triage --cache-dir tmp/members_cache --token $TOKEN --source groups --source-id 9970 -f policy.yml
+```
+
 ### Contributing
 
 Please refer to the [Contributing Guide](CONTRIBUTING.md).

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

@@ -44,7 +44,8 @@ module Gitlab
             return
           end
 
-          policy.summary = network.post_api(post_issue_url, post_issue_body)
+          response = network.post_api(post_issue_url, post_issue_body)
+          policy.summary = response.merge('type' => SUMMARY_RESOURCE_TYPE)
         end
 
         def issue

data/lib/gitlab/triage/option_parser.rb

@@ -65,6 +65,14 @@ module Gitlab
               options.debug = value
             end
 
+            opts.on('--cache-dir [string]', String,
+              'Directory containing pre-fetched API responses. ' \
+                'Files must follow the naming convention: <source>_<id>_<resource>.json ' \
+                '(e.g. groups_9970_members.json). ' \
+                'Can also be set via the GITLAB_TRIAGE_CACHE_DIR environment variable.') do |value|
+              options.cache_dir = value
+            end
+
             opts.on('-h', '--help', 'Print help message') do
               $stdout.puts opts
               exit # rubocop:disable Rails/Exit

data/lib/gitlab/triage/options.rb

@@ -14,7 +14,8 @@ module Gitlab
       :debug,
       :host_url,
       :require_files,
-      :api_version
+      :api_version,
+      :cache_dir
     ) do
       def initialize(*args)
         super

data/lib/gitlab/triage/rest_api_network.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
 require 'active_support/all'
+require 'json'
 require 'net/protocol'
+require 'uri'
 
 require_relative 'retryable'
 require_relative 'ui'
@@ -13,6 +15,7 @@ module Gitlab
       include Retryable
 
       MINIMUM_RATE_LIMIT = 25
+      CACHE_URL_PATTERN = %r{/api/v[^/]+/(groups|projects)/(.+?)/(members)(?:\z|\?)}
 
       attr_reader :options, :adapter
 
@@ -20,10 +23,11 @@ module Gitlab
         @adapter = adapter
         @options = adapter.options
         @cache = {}
+        @file_cache = {}
       end
 
       def query_api_cached(url)
-        @cache[url] || @cache[url] = query_api(url)
+        @cache[url] || @cache[url] = load_from_file_cache(url) || query_api(url)
       end
 
       def query_api(url)
@@ -66,7 +70,7 @@ module Gitlab
 
       def post_api(url, body)
         response = execute_with_retry(
-          exception_types: Net::ReadTimeout,
+          exception_types: [Net::ReadTimeout, Errors::Network::InternalServerError],
           backoff_exceptions: Errors::Network::TooManyRequests, debug: options.debug) do
           puts Gitlab::Triage::UI.debug "post_api: #{url}" if options.debug
 
@@ -88,7 +92,7 @@ module Gitlab
 
       def delete_api(url)
         response = execute_with_retry(
-          exception_types: Net::ReadTimeout,
+          exception_types: [Net::ReadTimeout, Errors::Network::InternalServerError],
           backoff_exceptions: Errors::Network::TooManyRequests, debug: options.debug) do
           puts Gitlab::Triage::UI.debug "delete_api: #{url}" if options.debug
 
@@ -101,6 +105,53 @@ module Gitlab
 
       private
 
+      def cache_dir
+        options.cache_dir || ENV.fetch('GITLAB_TRIAGE_CACHE_DIR', nil)
+      end
+
+      def load_from_file_cache(url)
+        return nil unless cache_dir_valid?
+
+        cache_key = cache_key_for(url)
+        return nil unless cache_key
+
+        @file_cache[cache_key] || read_cache_file(cache_key)
+      end
+
+      def cache_dir_valid?
+        cache_dir && File.directory?(cache_dir)
+      end
+
+      def cache_key_for(url)
+        match = url.match(CACHE_URL_PATTERN)
+        return nil unless match
+
+        source_type = match[1]
+        source_id   = URI.decode_www_form_component(match[2]).tr('/', '_')
+        resource    = match[3]
+
+        "#{source_type}_#{source_id}_#{resource}"
+      end
+
+      def read_cache_file(cache_key)
+        data = parse_cache_file(cache_key)
+        return nil unless data
+
+        @file_cache[cache_key] = data
+        puts Gitlab::Triage::UI.debug "cache_dir: loaded #{data.size} records" if options.debug
+        data
+      end
+
+      def parse_cache_file(cache_key)
+        file = File.join(cache_dir, "#{cache_key}.json")
+        parsed = JSON.parse(File.read(file))
+        return nil unless parsed.is_a?(Array) && parsed.all?(Hash)
+
+        parsed.map(&:with_indifferent_access)
+      rescue JSON::ParserError, Errno::ENOENT, Errno::EACCES
+        nil
+      end
+
       def token
         options.token
       end

data/lib/gitlab/triage/version.rb

@@ -2,6 +2,6 @@
 
 module Gitlab
   module Triage
-    VERSION = '1.49.0'
+    VERSION = '1.50.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-triage
 version: !ruby/object:Gem::Version
-  version: 1.49.0
+  version: 1.50.0
 platform: ruby
 authors:
 - GitLab
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-12 00:00:00.000000000 Z
+date: 2026-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport