feat: Stateful Resource Reconciler

[freeznet]

(If this PR fixes a github issue, please add Fixes #<xyz>.)

Fixes #310

(or if this PR is one task of a github issue, please add Master Issue: #<xyz> to link to the master issue.)

Master Issue: #

Motivation

Explain here the context, and why you're making that change. What is the problem you're trying to solve.

Modifications

Describe the modifications you've done.

Verifying this change

• Make sure that the change passes the CI checks.

(Please pick either of the following options)

This change is a trivial rework / code cleanup without any test coverage.

(or)

This change is already covered by existing tests, such as (please describe tests).

(or)

This change added tests and can be verified as follows:

(example:)

• Added integration tests for end-to-end deployment with large payloads (10MB)
• Extended integration test for recovery after broker failure

Documentation

Check the box below.

Need to update docs?

• doc-required

  (If you need help on updating docs, create a doc issue)

• no-need-doc

  (Please explain why)

• doc

  (If this PR contains doc changes)

[github-actions]

@freeznet:Thanks for your contribution. For this PR, do we need to update docs?
(The PR template contains info about doc, which helps others know more about the changes. Can you provide doc-related info in this and future PR descriptions? Thanks)

[Copilot]

Pull Request Overview

This PR implements a stateful reconciliation framework for managing Pulsar resource state, with new tests added to validate permission state annotations and multi-permission handling.

• Introduces a BaseStatefulReconciler and its interfaces for generic state tracking
• Enhances PulsarPermission reconciliation with context change detection and state annotation updates
• Adds comprehensive test cases to verify correct permission operations and state transitions

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
tests/operator/resources_test.go	Added test cases for initial state, role modifications, and multi-permission scenarios
pkg/reconciler/stateful_reconciler.go	Introduced a generic framework for stateful resource reconciliation using annotations
pkg/connection/reconcile_permission.go	Updated PulsarPermission reconciliation with context change detection and improved state tracking

Comments suppressed due to low confidence (1)

pkg/connection/reconcile_permission.go:181

• The variable 'currentPermissions' is used to determine slice capacity and in the iteration below but is not defined in this scope. Consider replacing it with the appropriate source of current roles (for example, using permission.Spec.Roles) to ensure the intended logic is applied.

	currentRoles := make([]string, 0, len(currentPermissions))

[maxsxu]

👍 Creative work! two questions here:

1. what if the annotations been modified externally or lost?
2. we need take care that annotation has max value size limitation