chore: Enhanced testing

Author: actuarysailor

.github/workflows/build-image-test.yaml

@@ -128,3 +128,30 @@ jobs:
         provenance: false
         secrets: |
           "github_token=${{ secrets.GITHUB_TOKEN }}"
+
+    # Build tools image using Dockerfile.tools and the just-built main image as base
+    - name: Build tools image
+      if: steps.changed-files-specific.outputs.any_changed == 'true'
+      uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83  # v6.18.0
+      with:
+        context: .
+        file: ./Dockerfile.tools
+        build-args: |
+          BASE_IMAGE=${{ env.IMAGE }}
+        push: false
+        load: true
+        tags: ${{ env.IMAGE }}-tools
+        provenance: false
+        secrets: |
+          "github_token=${{ secrets.GITHUB_TOKEN }}"
+
+    # Smoke test the tools image
+    - name: Smoke test tools image
+      if: steps.changed-files-specific.outputs.any_changed == 'true'
+      env:
+        TOOLS_IMAGE: ${{ env.IMAGE }}-tools
+      run: |
+        echo "Testing tools image: $TOOLS_IMAGE"
+        docker run --rm "$TOOLS_IMAGE" terraform --version
+        docker run --rm "$TOOLS_IMAGE" terraform-docs --version
+        docker run --rm "$TOOLS_IMAGE" tflint --version