From 3e86614267852f207090f93de0a49527a87a68e5 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2026 02:52:10 +0000
Subject: [PATCH] chore(sync): synced file(s) with cplieger/ci

---
 .golangci.yaml | 26 +++++++++++++++++++++-----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/.golangci.yaml b/.golangci.yaml
index 447ea76..5ccde16 100644
--- a/.golangci.yaml
+++ b/.golangci.yaml
@@ -136,11 +136,27 @@ formatters:
     - gci
   settings:
     gofumpt:
-      # Strictest: the `-extra` rules (group adjacent same-type params,
-      # forbid naked returns) on top of gofumpt's strict superset of
-      # gofmt. module-path is auto-detected from each repo's go.mod when
-      # left empty.
-      extra-rules: true
+      # Strictest: every `extra` rule, on top of gofumpt's strict superset of
+      # gofmt. module-path is auto-detected from each repo's go.mod when left
+      # empty.
+      #
+      # Named individually rather than via the old `extra-rules: true`
+      # catch-all, which golangci-lint deprecates (it warns on every run) and
+      # which will be removed. The three keys below are exactly what
+      # `extra-rules: true` enabled, so this migration changes no formatting.
+      #
+      # Upstream deliberately offers NO replacement "all" switch: enabling each
+      # rule is meant to be a conscious choice so new rules cannot silently
+      # reformat every repo. The consequence to know is that a future gofumpt
+      # rule will NOT arrive here automatically and has to be added on purpose.
+      extra:
+        # Group adjacent function parameters that share a type.
+        group-params: true
+        # Clothe naked returns in functions with named results.
+        clothe-returns: true
+        # Put a multi-line call's closing paren on its own line when the
+        # opening paren ends a line.
+        balance-calls: true
     gci:
       # Deterministic import grouping: standard -> third-party -> local
       # module (folded by gofumpt into the third-party group). A separate