ci: add shared e2e-staging Slack summary script

[piotr-iohk]

Summary

Add a shared Slack summary script for Bitkit E2E Staging nightlies, enabling a single implementation for both bitkit-ios and bitkit-android app repos.

Changes

• scripts/slack_summary.py: New script with e2e-staging CLI mode
• scripts/test_slack_summary.py: Unit tests (14 tests covering status icons, platform display, message rendering)

Features

• Posts plain {"text": ...} JSON to SLACK_WEBHOOK_URL via urllib (no Slack action dependency)
• Skips gracefully (exit 0) if SLACK_WEBHOOK_URL is not set
• Status icon helpers: :white_check_mark: success, :x: failure, :warning: cancelled, :fast_forward: skipped
• Platform-aware title (iOS/Android)
• Rejects unknown CLI modes with helpful error

Message Format

:x: Bitkit iOS E2E staging: failure
Time: 2026-09-14 07:07:11 UTC
Run attempt: 1
Run: https://github.com/synonymdev/bitkit-ios/actions/runs/12345
E2E tests ref: main
Repository: synonymdev/bitkit-ios

Jobs:
  build-staging: :white_check_mark: success
  e2e-branch: :white_check_mark: success
  e2e-tests-staging: :x: failure

Environment Variables for App Workflows

Required

Variable	Description
SLACK_WEBHOOK_URL	Slack incoming webhook URL
PLATFORM	ios or android
STAGING_RESULT	Overall workflow result (success/failure/cancelled/...)
BUILD_RESULT	build-staging job result
E2E_BRANCH_RESULT	e2e-branch job result
E2E_TESTS_RESULT	e2e-tests-staging job result
RUN_URL	GitHub Actions run URL
RUN_ATTEMPT	Current run attempt number

Optional

Variable	Description
E2E_TESTS_REF	Resolved e2e-tests branch/ref
GITHUB_REPOSITORY	Repository name (e.g. synonymdev/bitkit-ios)

Usage in App Workflows

Call from the slack-report job:

slack-report:
  if: always() && (github.event_name == 'schedule' || inputs.post_to_slack == 'true')
  needs: [build-staging, e2e-branch, e2e-tests-staging]
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
      with:
        repository: synonymdev/bitkit-e2e-tests
        ref: ${{ needs.e2e-branch.outputs.e2e_branch }}
    - run: python3 scripts/slack_summary.py e2e-staging
      env:
        SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
        PLATFORM: ios  # or android
        STAGING_RESULT: ${{ needs.e2e-tests-staging.result }}
        BUILD_RESULT: ${{ needs.build-staging.result }}
        E2E_BRANCH_RESULT: ${{ needs.e2e-branch.result }}
        E2E_TESTS_RESULT: ${{ needs.e2e-tests-staging.result }}
        RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
        RUN_ATTEMPT: ${{ github.run_attempt }}
        E2E_TESTS_REF: ${{ needs.e2e-branch.outputs.e2e_branch }}
        GITHUB_REPOSITORY: ${{ github.repository }}

Related

• iOS PR ci: add E2E staging workflow for iOS bitkit-ios#747 (will use this script)
• Android PR ci: add e2e-staging workflow for nightly staging tests bitkit-android#1253 (will use this script)

Testing

cd scripts && python3 -m unittest test_slack_summary -v

All 14 tests pass.