ROX-28223: Pause-reconcile handler

[vladbologa]

This PR upstreams a feature from the https://github.com/stackrox/helm-operator fork used by ACS (Advanced Cluster Security)

Source commit: stackrox/helm-operator@30a1ac3
Original PR: stackrox/helm-operator#29

The PR implements support for a "pause reconcile" handler, which determines if the reconcile should be paused for a given custom resource. Also provided is an implementation for such a handler, that allows pausing reconciliation via a custom annotation that must be added to the CR. If this annotation is set to true then the operator does not reconcile the CR.

[perdasilva]

lgmt ^^ thank you!!

[perdasilva]

@vladbologa I've taken the liberty of fixing up the lint complaints - I hope that's ok. If it's green, I'll merge.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 84.37500% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 78.47%. Comparing base (08ab7fb) to head (195e0cb).
⚠️ Report is 139 commits behind head on main.

Files with missing lines	Patch %	Lines
pkg/reconciler/reconciler.go	90.00%	2 Missing and 1 partial ⚠️
pkg/reconciler/internal/conditions/conditions.go	0.00%	2 Missing ⚠️

❗ There is a different number of reports uploaded between BASE (08ab7fb) and HEAD (195e0cb). Click for more details.

HEAD has 1 upload less than BASE

Flag	BASE (08ab7fb)	HEAD (195e0cb)
	2	1

Additional details and impacted files

@@ Coverage Diff @@## main #426 +/- ##
==========================================
- Coverage 85.06% 78.47% -6.60% 
==========================================
Files 19 31 +12 Lines 1346 2518 +1172 ==========================================
+ Hits 1145 1976 +831 - Misses 125 451 +326 - Partials 76 91 +15 

☔ 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.