refactor: use pinned golangci-lint Docker image for linting

Refactor Dockerfile to use a separate lint stage with a pinned
golangci-lint v2.11.3 Docker image instead of installing
golangci-lint via curl in the builder stage. This follows the
pattern used by sneak/pixa.

Changes:
- Dockerfile: separate lint stage using golangci/golangci-lint:v2.11.3
  (Debian-based, pinned by sha256) with COPY --from=lint dependency
- Bump Go from 1.24 to 1.26.1 (golang:1.26.1-bookworm, pinned)
- Bump golangci-lint from v1.64.8 to v2.11.3
- Migrate .golangci.yml from v1 to v2 format (same linters, format only)
- All Docker images pinned by sha256 digest
- Fix all lint issues from the v2 linter upgrade:
  - Add package comments to all packages
  - Add doc comments to all exported types, functions, and methods
  - Fix unchecked errors (errcheck)
  - Fix unused parameters (revive)
  - Fix gosec warnings (MaxBytesReader for form parsing)
  - Fix staticcheck suggestions (fmt.Fprintf instead of WriteString)
  - Rename DeliveryTask to Task to avoid stutter (delivery.Task)
  - Rename shadowed builtin 'max' parameter
- Update README.md version requirements

internal/delivery/circuit_breaker.go

@@ -5,41 +5,32 @@ import (
 	"time"
 )
 
-// CircuitState represents the current state of a circuit breaker.
+// CircuitState represents the current state of a circuit
+// breaker.
 type CircuitState int
 
 const (
-	// CircuitClosed is the normal operating state. Deliveries flow through.
+	// CircuitClosed is the normal operating state.
 	CircuitClosed CircuitState = iota
-	// CircuitOpen means the circuit has tripped. Deliveries are skipped
-	// until the cooldown expires.
+	// CircuitOpen means the circuit has tripped.
 	CircuitOpen
-	// CircuitHalfOpen allows a single probe delivery to test whether
-	// the target has recovered.
+	// CircuitHalfOpen allows a single probe delivery to
+	// test whether the target has recovered.
 	CircuitHalfOpen
 )
 
 const (
-	// defaultFailureThreshold is the number of consecutive failures
-	// before a circuit breaker trips open.
+	// defaultFailureThreshold is the number of consecutive
+	// failures before a circuit breaker trips open.
 	defaultFailureThreshold = 5
 
-	// defaultCooldown is how long a circuit stays open before
-	// transitioning to half-open for a probe delivery.
+	// defaultCooldown is how long a circuit stays open
+	// before transitioning to half-open.
 	defaultCooldown = 30 * time.Second
 )
 
-// CircuitBreaker implements the circuit breaker pattern for a single
-// delivery target. It tracks consecutive failures and prevents
-// hammering a down target by temporarily stopping delivery attempts.
-//
-// States:
-//   - Closed (normal): deliveries flow through; consecutive failures
-//     are counted.
-//   - Open (tripped): deliveries are skipped; a cooldown timer is
-//     running. After the cooldown expires the state moves to HalfOpen.
-//   - HalfOpen (probing): one probe delivery is allowed. If it
-//     succeeds the circuit closes; if it fails the circuit reopens.
+// CircuitBreaker implements the circuit breaker pattern
+// for a single delivery target.
 type CircuitBreaker struct {
 	mu          sync.Mutex
 	state       CircuitState
@@ -49,7 +40,8 @@ type CircuitBreaker struct {
 	lastFailure time.Time
 }
 
-// NewCircuitBreaker creates a circuit breaker with default settings.
+// NewCircuitBreaker creates a circuit breaker with default
+// settings.
 func NewCircuitBreaker() *CircuitBreaker {
 	return &CircuitBreaker{
 		state:     CircuitClosed,
@@ -58,12 +50,7 @@ func NewCircuitBreaker() *CircuitBreaker {
 	}
 }
 
-// Allow checks whether a delivery attempt should proceed. It returns
-// true if the delivery should be attempted, false if the circuit is
-// open and the delivery should be skipped.
-//
-// When the circuit is open and the cooldown has elapsed, Allow
-// transitions to half-open and permits exactly one probe delivery.
+// Allow checks whether a delivery attempt should proceed.
 func (cb *CircuitBreaker) Allow() bool {
 	cb.mu.Lock()
 	defer cb.mu.Unlock()
@@ -73,17 +60,15 @@ func (cb *CircuitBreaker) Allow() bool {
 		return true
 
 	case CircuitOpen:
-		// Check if cooldown has elapsed
 		if time.Since(cb.lastFailure) >= cb.cooldown {
 			cb.state = CircuitHalfOpen
+
 			return true
 		}
+
 		return false
 
 	case CircuitHalfOpen:
-		// Only one probe at a time — reject additional attempts while
-		// a probe is in flight. The probe goroutine will call
-		// RecordSuccess or RecordFailure to resolve the state.
 		return false
 
 	default:
@@ -91,9 +76,8 @@ func (cb *CircuitBreaker) Allow() bool {
 	}
 }
 
-// CooldownRemaining returns how much time is left before an open circuit
-// transitions to half-open. Returns zero if the circuit is not open or
-// the cooldown has already elapsed.
+// CooldownRemaining returns how much time is left before
+// an open circuit transitions to half-open.
 func (cb *CircuitBreaker) CooldownRemaining() time.Duration {
 	cb.mu.Lock()
 	defer cb.mu.Unlock()
@@ -106,11 +90,12 @@ func (cb *CircuitBreaker) CooldownRemaining() time.Duration {
 	if remaining < 0 {
 		return 0
 	}
+
 	return remaining
 }
 
-// RecordSuccess records a successful delivery and resets the circuit
-// breaker to closed state with zero failures.
+// RecordSuccess records a successful delivery and resets
+// the circuit breaker to closed state.
 func (cb *CircuitBreaker) RecordSuccess() {
 	cb.mu.Lock()
 	defer cb.mu.Unlock()
@@ -119,8 +104,8 @@ func (cb *CircuitBreaker) RecordSuccess() {
 	cb.state = CircuitClosed
 }
 
-// RecordFailure records a failed delivery. If the failure count reaches
-// the threshold, the circuit trips open.
+// RecordFailure records a failed delivery. If the failure
+// count reaches the threshold, the circuit trips open.
 func (cb *CircuitBreaker) RecordFailure() {
 	cb.mu.Lock()
 	defer cb.mu.Unlock()
@@ -134,20 +119,25 @@ func (cb *CircuitBreaker) RecordFailure() {
 			cb.state = CircuitOpen
 		}
 
+	case CircuitOpen:
+		// Already open; no state change needed.
+
 	case CircuitHalfOpen:
-		// Probe failed — reopen immediately
+		// Probe failed -- reopen immediately.
 		cb.state = CircuitOpen
 	}
 }
 
-// State returns the current circuit state. Safe for concurrent use.
+// State returns the current circuit state.
 func (cb *CircuitBreaker) State() CircuitState {
 	cb.mu.Lock()
 	defer cb.mu.Unlock()
+
 	return cb.state
 }
 
-// String returns the human-readable name of a circuit state.
+// String returns the human-readable name of a circuit
+// state.
 func (s CircuitState) String() string {
 	switch s {
 	case CircuitClosed: