POC: Find way to add branch filters in controller-filters.yaml

[KacperMalachowski]

Background

Currently, the controller-filters.yaml file in this repository does not support filtering by branch. This limits our ability to control which branches trigger specific workflows or controller actions.

Problem

We need to introduce a mechanism that allows us to specify branch filters in controller-filters.yaml. This functionality is essential for managing multi-branch strategies and ensuring that only targeted branches are affected by certain controllers or CI/CD workflows.

Goals

• Research: Investigate available options or patterns (in our tooling or upstream) for implementing branch filtering in YAML configuration.
• POC: Implement a proof-of-concept (POC) solution for adding branch filters to controller-filters.yaml.
• Validation: Demonstrate that the new branch filtering mechanism works as intended, ideally with example filter rules and test cases.
• Documentation: Update the documentation to explain how to use the new branch filter feature.

Acceptance Criteria

• A proposed solution for adding branch filters is documented in this issue or an attached document.
• The POC implementation is submitted as a PR for review.
• Example use cases are provided.
• Documentation is updated to reflect the changes.

References

• GitHub Actions: Workflow syntax - branches filter

TImebox: 3 days

[szumejker]

Draft PR with PoC #13179