feat: integrate swag fmt and improve CI/CD workflows

- Add swag fmt to git pre-commit hook and CI/CD pipeline
- Create comprehensive CONTRIBUTING.md guide with AI section
- Update ADR-0013 with swag fmt documentation
- Fix swagger generation to include all endpoints
- Improve local testing scripts and workflows
- Update Dockerfile for better swagger handling
- Fix CI/CD workflow file references

.gitea/workflows/go-ci-cd.yaml

@@ -91,9 +91,20 @@ jobs:
         with:
           go-version: '1.26.1'
 
+      - name: Set up Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: '1.26.1'
+
+      - name: Install swag
+        run: go install github.com/swaggo/swag/cmd/swag@latest
+
       - name: Run go fmt
         run: go fmt ./...
 
+      - name: Run swag fmt
+        run: swag fmt
+
       - name: Check for formatting issues
         run: |
           if [ -n "$(go fmt ./...)" ]; then
@@ -105,7 +116,7 @@ jobs:
   version-check:
     name: Version Management
     runs-on: ubuntu-latest
-    needs: [build-test, lint-format, workflow-validation]
+    needs: [build-test, lint-format]
     if: github.ref == 'refs/heads/main'
 
     steps: