feat: Add Docker Hub integration and improve dependency updates (#6)

* feat: Add Docker Hub integration and improve dependency updates

- Configure Docker Hub multi-architecture builds (amd64, arm64)
- Add automatic Docker image publishing for main/develop branches
- Set up semantic version tagging for releases
- Add Docker Scout CVE scanning
- Fix dependency update workflow permissions
- Add better error handling and change detection for dependency updates
- Include comprehensive Docker Hub setup documentation

Images will be published to: rishabhverma17/hypercache

* fix: Fix Docker tag generation for PR builds

- Fix invalid tag format with empty branch prefix
- Use proper SHA format with sha- prefix
- Add explicit pr- prefix for pull request tags
- Ensures valid Docker tag names for all build contexts

Author: rishabhverma17

.github/workflows/dependencies.yml

@@ -5,6 +5,10 @@ on:
     - cron: '0 0 * * 1'  # Weekly on Monday
   workflow_dispatch:
 
+permissions:
+  contents: write
+  pull-requests: write
+
 jobs:
   update-dependencies:
     name: Update Go Dependencies
@@ -21,33 +25,63 @@ jobs:
       with:
         go-version: '1.23.2'
 
-    - name: Update dependencies
+    - name: Check for changes
+      id: changes
       run: |
+        echo "🔄 Updating Go dependencies..."
+        
+        # Get current versions for comparison
+        echo "Current go.mod before update:"
+        cat go.mod
+        
+        # Update dependencies
         go get -u ./...
         go mod tidy
+        
+        echo "Updated go.mod after update:"
+        cat go.mod
+        
+        # Check if there are any changes
+        if git diff --quiet go.mod go.sum; then
+          echo "No dependency updates available"
+          echo "has_changes=false" >> $GITHUB_OUTPUT
+        else
+          echo "Dependencies updated successfully"
+          echo "has_changes=true" >> $GITHUB_OUTPUT
+          git diff --name-only
+        fi
 
     - name: Run tests
-      run: go test ./tests/... ./internal/... ./pkg/...
+      if: steps.changes.outputs.has_changes == 'true'
+      run: |
+        echo "🧪 Running tests after dependency update..."
+        go test ./tests/... ./internal/... ./pkg/...
 
     - name: Create Pull Request
+      if: steps.changes.outputs.has_changes == 'true'
       uses: peter-evans/create-pull-request@v5
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
         commit-message: 'chore: update Go dependencies'
         title: 'chore: update Go dependencies'
         body: |
-          ## Automated Dependency Update
+          ## 🔄 Automated Dependency Update
           
           This PR updates Go dependencies to their latest versions.
           
-          ### Changes
+          ### 📋 Changes
           - Updated Go modules to latest versions
-          - Ran `go mod tidy` to clean up
+          - Ran `go mod tidy` to clean up dependencies
+          - All tests pass after updates
           
-          ### Testing
+          ### ✅ Testing
           - [x] All tests pass
           - [x] Build succeeds
+          - [x] Dependencies resolved correctly
           
+          ### 🤖 Automation
           This PR was created automatically by the dependency update workflow.
+          
+          **Review the changes and merge if everything looks good!**
         branch: chore/update-dependencies
         delete-branch: true

.github/workflows/docker-build.yml

@@ -1,4 +1,4 @@
-name: Docker Build Test
+name: Docker Build and Push
 
 on:
   push:
@@ -8,7 +8,12 @@ on:
     branches: [ main ]
 
 env:
-  IMAGE_NAME: hypercache
+  REGISTRY: docker.io
+  IMAGE_NAME: rishabhverma17/hypercache
+
+permissions:
+  contents: read
+  packages: write
 
 jobs:
   test:
@@ -48,17 +53,65 @@ jobs:
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
 
-    - name: Build Docker image
+    - name: Log in to Docker Hub
+      if: github.event_name != 'pull_request'
+      uses: docker/login-action@v3
+      with:
+        username: ${{ secrets.DOCKERHUB_USERNAME }}
+        password: ${{ secrets.DOCKERHUB_TOKEN }}
+    
+    - name: Extract metadata
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+        tags: |
+          type=ref,event=branch
+          type=ref,event=pr,prefix=pr-
+          type=sha,prefix=sha-,format=short
+          type=raw,value=latest,enable={{is_default_branch}}
+          type=semver,pattern={{version}}
+          type=semver,pattern={{major}}.{{minor}}
+          type=semver,pattern={{major}}
+    
+    - name: Build and push Docker image
       uses: docker/build-push-action@v5
       with:
         context: .
-        platforms: linux/amd64
-        push: false
-        tags: ${{ env.IMAGE_NAME }}:test
+        platforms: linux/amd64,linux/arm64
+        push: ${{ github.event_name != 'pull_request' }}
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}
         cache-from: type=gha
         cache-to: type=gha,mode=max
 
-    - name: Test Docker image
+    - name: Docker Scout CVE scanning
+      if: github.event_name != 'pull_request'
+      uses: docker/scout-action@v1
+      with:
+        command: cves
+        image: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+        only-severities: critical,high
+        exit-code: false
+    
+    - name: Summary
       run: |
-        echo "✅ Docker image built successfully"
-        echo "Image would be tagged as: ${{ env.IMAGE_NAME }}:test"
+        echo "## Docker Build Summary 🐳" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**Image:** \`${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}\`" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**Tags built:**" >> $GITHUB_STEP_SUMMARY
+        echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+        echo "${{ steps.meta.outputs.tags }}" >> $GITHUB_STEP_SUMMARY
+        echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        if [ "${{ github.event_name }}" != "pull_request" ]; then
+          echo "✅ **Images pushed to Docker Hub**" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Pull the latest image:" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "docker pull ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+        else
+          echo "🔨 **PR build completed (not pushed)**" >> $GITHUB_STEP_SUMMARY
+        fi