feat(ci): enhance test notifications with automated incident reporting

.github/workflows/testsPython.yml

@@ -69,11 +69,93 @@ jobs:
   notifications:
     needs: python-unit-tests
     runs-on: ubuntu-latest
+    if: always()
+    permissions:
+      contents: read
+      actions: read
     steps:
-      - name: Notify on test results
+      - name: Notify on successful test results
+        if: needs.python-unit-tests.result == 'success'
+        run: |          
+          echo "### ✅ Build Passed!" >> $GITHUB_STEP_SUMMARY
+          echo "All unit tests completed successfully for commit ${GITHUB_SHA::7}." >> $GITHUB_STEP_SUMMARY
+
+      - name: Notify on failed test results (summary)
+        if: needs.python-unit-tests.result == 'failure'
+        run: |
+          echo "### ❌ Build Failed!" >> $GITHUB_STEP_SUMMARY
+          echo "The Python Unit Tests failed on commit [${GITHUB_SHA::7}](${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }})." >> $GITHUB_STEP_SUMMARY
+          echo "**Triggered by**: ${{ github.actor }}" >> $GITHUB_STEP_SUMMARY
+          echo "Please check the logs in the 'python-unit-tests' job to identify the error." >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "---" >> $GITHUB_STEP_SUMMARY
+          echo "**Note:** An automated incident report with failure details has been emailed to the designated recipients." >> $GITHUB_STEP_SUMMARY
+
+      - name: Build incident report
+        id: report
+        if: needs.python-unit-tests.result == 'failure'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "short_sha=${GITHUB_SHA::7}" >> $GITHUB_OUTPUT
+          sleep 10
+
+          # Fetch Job ID for python-unit-tests
+          JOB_ID=$(gh api repos/${{ github.repository }}/actions/runs/${{ github.run_id }}/jobs \
+            --jq '.jobs[] | select(.name=="python-unit-tests") | .id')
+
+          # Fetch job logs and strip ANSI color codes and ISO8601 timestamps
+          CLEAN_LOGS=$(gh api repos/${{ github.repository }}/actions/jobs/$JOB_ID/logs | \
+            sed -r "s/\x1B\[([0-9]{1,3}(;[0-9]{1,2})?)?[mGK]//g" | \
+            sed -r 's/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]+Z //')
+
+          # Extract summaries
+          FAILED_TESTS=$(echo "$CLEAN_LOGS" | grep -Ei "ERROR: test_|FAILED \(errors=[0-9]+\)" || echo "No test failures identified.")
+          ROOT_CAUSE=$(echo "$CLEAN_LOGS" | grep -Ei "ImportError:|AssertionError:|ValueError:|TypeError:|NameError:|AttributeError:" | sort -u || echo "Could not determine root cause. Please see full logs for details.")
+
+          # Build report
+          {
+            echo "incident_report<<EOF"        
+            echo "❌ Python Unit Tests Failed - Incident Report"
+            echo ""
+            echo "Repository: ${{ github.repository }}"
+            echo "Branch: ${{ github.ref_name }}"
+            echo "Commit: ${GITHUB_SHA::7}"
+            echo "Triggered by: ${{ github.actor }}"
+            echo ""
+            echo "────────────────────────────"
+            echo "🧪 FAILED TESTS"
+            echo "────────────────────────────"
+            echo "$FAILED_TESTS"
+            echo ""
+            echo "────────────────────────────"
+            echo "🔥 ROOT CAUSE"
+            echo "────────────────────────────"
+            echo "$ROOT_CAUSE"
+            echo ""
+            echo "────────────────────────────"
+            echo "🔗 VIEW FULL LOGS:"
+            echo "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+            echo "EOF"
+          } >> $GITHUB_OUTPUT
+
+      - name: Notify on failed test results (email)
+        if: needs.python-unit-tests.result == 'failure'
+        uses: dawidd6/action-send-mail@v3
+        with:
+          server_address: smtp.gmail.com
+          server_port: 465
+          username: ${{ secrets.EMAIL_USERNAME }}
+          password: ${{ secrets.EMAIL_PASSWORD }}
+          subject: "❌ Python Unit Tests Failed - ${{ github.repository }} (${{ steps.report.outputs.short_sha }})"
+          to: ${{ secrets.NOTIFY_EMAIL }}
+          from: "GitHub Actions Notifications <${{ secrets.EMAIL_USERNAME }}>"
+          body: |
+            ${{ steps.report.outputs.incident_report }}
+
+      - name: Notify on cancelled test runs
+        if: needs.python-unit-tests.result == 'cancelled'
         run: |
-          if [ "${{ needs.python-unit-tests.result }}" == "success" ]; then
-            echo "success notifications go here"
-          else
-            echo "failure notifications go here"
-          fi
+          echo "### ⚠️ Build Cancelled" >> $GITHUB_STEP_SUMMARY
+          echo "The workflow was cancelled before completion." >> $GITHUB_STEP_SUMMARY
+          echo "**Commit:** [${GITHUB_SHA::7}](${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }})" >> $GITHUB_STEP_SUMMARY