Document testifylint availability and keep it disabled for now

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Author: Copilot

.golangci.yml

@@ -9,13 +9,15 @@ linters:
   enable:
     - misspell
     - unconvert
-    - testifylint
+    # testifylint disabled due to requiring extensive test refactoring
+    # Re-enable after addressing existing issues: golangci-lint run --enable=testifylint
     # gosec disabled in golangci-lint due to configuration complexity
     # Can be enabled separately with: gosec -exclude=G101,G104,G115,G301,G302,G304,G306 ./...
   disable:
     - errcheck
     - gocritic
     - revive
+    - testifylint
     - gosec
 
 linters-settings:

AGENTS.md

@@ -172,19 +172,22 @@ assert.JSONEq(t, expectedJSON, actualJSON)
 
 **golangci-lint** is integrated and runs as part of `make lint`:
 - Configuration: `.golangci.yml` (version 2 format)
-- Enabled linters: `misspell`, `unconvert`, `testifylint`
-- Disabled linters: `gosec`, `errcheck`, `gocritic`, `revive`
+- Enabled linters: `misspell`, `unconvert`
+- Disabled linters: `gosec`, `testifylint`, `errcheck`, `gocritic`, `revive`
 - Install: `make install` (installs golangci-lint v2.8.0)
 - Run manually: `golangci-lint run --timeout=5m`
 
-**testifylint**: Automatically catches common testify mistakes:
-- Suggests `assert.Empty(t, x)` instead of `assert.True(t, len(x) == 0)`
-- Suggests `assert.True(t, x)` instead of `assert.Equal(t, true, x)`
-- Suggests `assert.NoError(t, err)` instead of `assert.Nil(t, err)`
+**testifylint**: Available but disabled due to requiring extensive test refactoring across the codebase.
+- Automatically catches common testify mistakes:
+  - Suggests `assert.Empty(t, x)` instead of `assert.True(t, len(x) == 0)`
+  - Suggests `assert.True(t, x)` instead of `assert.Equal(t, true, x)`
+  - Suggests `assert.NoError(t, err)` instead of `assert.Nil(t, err)`
+- To run on specific files: `golangci-lint run --enable=testifylint --timeout=5m <files>`
+- To run on entire codebase: `golangci-lint run --enable=testifylint --timeout=5m`
 
-**Note**: Some linters (gosec, errcheck) are disabled to minimize noise. Enable them for stricter checks:
+**Note**: Some linters (gosec, testifylint, errcheck) are disabled to minimize noise. Enable them for stricter checks:
 ```bash
-golangci-lint run --enable=gosec,errcheck --timeout=5m
+golangci-lint run --enable=gosec,testifylint,errcheck --timeout=5m
 ```
 
 ## Test Structure