feat: enable priority queue

[ricardo-mng]

Enable Priority Queue for Controller Manager

Summary

Enable the controller-runtime priority queue feature to improve reconciliation responsiveness. This ensures newly created or updated Terraform resources are reconciled before re-queued existing resources during controller restarts.

Problem

Without priority queue, all resources use FIFO ordering. During controller restarts, new resources wait behind all re-queued existing resources.

Test evidence:

• 15 existing resources + controller restart + 1 new resource
• Result: New resource reconciled last (position 16/16)
• Expected: New resource reconciled first (top 20%)

Solution

Enable priority queue in manager configuration:

Controller: config.Controller{
    UsePriorityQueue: ptr.To[bool](true),
}

This will be the default behavior in future controller-runtime releases - commit d2c0c8b

How it works:

• High priority (0): New resources, spec changes, real updates
• Low priority (-100): Controller restart re-queue, periodic resyncs

Testing

• 15 existing resources + controller restart + 1 new resource
• Result: New resource reconciled first (top 20%) as expected

References

• controller-runtime PR #3290 - Complete priority queue implementation
• Future default commit - Enable by default

[alexandermarston]

LGTM 🚀