Implementation of release workflow

[ank1m]

GitHub Issue: #206, #207

Description

This PR organizes the GitHub Actions workflows for testing, gating, and building new release.

Trigger Workflows

• test-on-push.yml
  Runs unit tests and linting on every push to any branch. Ensures baseline correctness for all commits.
• test-on-pr.yml
  Runs tests on pull requests to validate changes before merging.
• test-build-on-pr.yml
  Runs tests and performs a Docker build (without pushing) for PRs when build-relevant files change. Helps catch build/runtime issues early.
• build-release-candidate.yml
  Builds and publishes Docker images for release candidate (RC) tags. Triggered from release/* branches during the release cycle.
• build-release.yml
  Handles final release builds on merge to main. Produces and publishes the official Docker image, drafts GitHub release with notes, and create auto-PR for back-merge from main to develop.

Reusable Workflows

• reusable-tests.yml
  Shared test and linting workflow used across push and PR pipelines.
• reusable-docker.yml
  Contains Docker build and push logic. Supports both RC and final release builds.
• reusable-gate.yml
  Provides validation and gating logic (e.g., branch naming, release version rules).

Local test steps

See next section

Overview of integration done

All workflows were validated in a forked repository before being committed here. The fork-based testing confirms that workflows are ready for integration into the main repository.

PR Acceptance Checklist

• Unit tests added/updated and passing.
• Integration testing
• CHANGELOG.md updated
• Documentation updated (if needed).

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.02%. Comparing base (6a158cb) to head (296b285).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop     #213   +/-   ##
========================================
  Coverage    84.02%   84.02%           
========================================
  Files            4        4           
  Lines          144      144           
========================================
  Hits           121      121           
  Misses          23       23           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[danielfromearth]

This is looking great to me!