feat: add CI check for sqlc-generated files to prevent stale code (#4554)

<!-- Thanks for sending a pull request! Here are some tips for you: -->

#### What type of PR is this?

Enhancement

#### What this PR does / why we need it

Adds a CI job that validates sqlc-generated Go files are up-to-date,
preventing stale generated code from being merged.

#### Which issue(s) this PR fixes
<!--
*Automatically closes linked issue when PR is merged.
Usage: `Fixes #<issue number>`, or `Fixes (paste link of issue)`.
_If PR is about `failing-tests or flakes`, please post the related
issues/tests in a comment and do not use `Fixes`_*
-->
Fixes #

#### Special notes for your reviewer

Signed-off-by: Dejan Zele Pejchev <[email protected]>

Author: dejanzele

.github/workflows/test.yml

@@ -48,7 +48,9 @@ jobs:
 
   go-unit-tests:
     name: Golang Unit Tests
-    needs: go-mod-up-to-date
+    needs:
+      - go-mod-up-to-date
+      - sqlc-up-to-date
     runs-on: ubuntu-22.04
 
     steps:
@@ -84,7 +86,9 @@ jobs:
 
   go-integration-tests:
     name: Golang Integration Tests
-    needs: go-mod-up-to-date
+    needs:
+      - go-mod-up-to-date
+      - sqlc-up-to-date
     runs-on: ubuntu-22.04
 
     env:
@@ -235,3 +239,40 @@ jobs:
           fi
 
           exit $changed
+
+  sqlc-up-to-date:
+    name: SQLC Generated Files Up To Date
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: ./.github/actions/setup-go-cache
+        with:
+          cache-prefix: sqlc-up-to-date
+          cache-tools: true
+
+      - name: Validate no changes in generated SQL files
+        run: |
+          go run github.com/magefile/[email protected] -v sql
+
+          changed=$(git status -s -uno | wc -l)
+
+          echo -e "### Git status" >> $GITHUB_STEP_SUMMARY
+          if [[ "$changed" -gt 0 ]]; then
+            echo -e "Generated SQL files are out of date. Please run 'mage sql' and commit the changes." >> $GITHUB_STEP_SUMMARY
+
+            git status -s -uno >> $GITHUB_STEP_SUMMARY
+
+            echo -e >> $GITHUB_STEP_SUMMARY
+            echo -e "### Git diff" >> $GITHUB_STEP_SUMMARY
+
+            git --no-pager diff >> $GITHUB_STEP_SUMMARY
+          else
+            echo -e "Generated SQL files are up to date." >> $GITHUB_STEP_SUMMARY
+            echo -e >> $GITHUB_STEP_SUMMARY
+          fi
+
+          exit $changed