feat(gateway): implement reconciliation mechanism and command prioritization

- Introduced a reconciliation job structure to manage the reconciliation process for gateway channels.
- Added methods to schedule and run reconciliation steps, including group, scene, and settings reconciliation.
- Implemented a locking mechanism to ensure thread safety during reconciliation operations.
- Enhanced command handling in GatewayRuntime to classify commands by priority (control, normal, maintenance).
- Updated command enqueueing and processing to respect command priorities, ensuring maintenance commands are handled appropriately.
- Added configuration options for enabling/disabling cache functionality in GatewayRuntime.
- Improved logging to include cache status during runtime initialization.

Co-authored-by: Copilot <copilot@github.com>

components/gateway_controller/include/gateway_controller.hpp

@@ -1,8 +1,10 @@
 #pragma once
 
 #include <array>
+#include <atomic>
 #include <cstdint>
 #include <functional>
+#include <map>
 #include <string>
 #include <string_view>
 #include <vector>
@@ -10,6 +12,7 @@
 #include "gateway_cache.hpp"
 #include "esp_err.h"
 #include "freertos/FreeRTOS.h"
+#include "freertos/semphr.h"
 #include "freertos/task.h"
 
 namespace gateway {
@@ -83,9 +86,30 @@ class GatewayController {
   GatewayControllerSnapshot snapshot();
 
  private:
+  struct ReconciliationJob {
+    enum class Phase : uint8_t {
+      kReloadFlags = 0,
+      kGroups = 1,
+      kScenes = 2,
+      kSettings = 3,
+    };
+
+    GatewayCacheChannelFlags flags{};
+    Phase phase{Phase::kReloadFlags};
+    uint8_t short_address{0};
+    uint8_t scene_id{0};
+  };
+
   static void TaskEntry(void* arg);
   void taskLoop();
   void dispatchCommand(const std::vector<uint8_t>& command);
+  void scheduleReconciliation(uint8_t gateway_id);
+  bool hasPendingReconciliation() const;
+  bool runMaintenanceStep();
+  bool runReconciliationStep(uint8_t gateway_id, ReconciliationJob& job);
+  void reconcileGroupStep(uint8_t gateway_id, uint8_t short_address);
+  void reconcileSceneStep(uint8_t gateway_id, uint8_t short_address, uint8_t scene_id);
+  void reconcileSettingsStep(uint8_t gateway_id, uint8_t short_address);
 
   bool hasGateway(uint8_t gateway_id) const;
   std::vector<uint8_t> gatewayIds() const;
@@ -131,10 +155,13 @@ class GatewayController {
   GatewayCache& cache_;
   GatewayControllerConfig config_;
   TaskHandle_t task_handle_{nullptr};
+  SemaphoreHandle_t maintenance_lock_{nullptr};
   std::vector<NotificationSink> notification_sinks_;
   std::vector<BleStateSink> ble_state_sinks_;
   std::vector<WifiStateSink> wifi_state_sinks_;
   std::vector<GatewayNameSink> gateway_name_sinks_;
+  std::map<uint8_t, ReconciliationJob> reconciliation_jobs_;
+  std::atomic<int> maintenance_activity_gateway_{-1};
   bool setup_mode_{false};
   bool wireless_setup_mode_{false};
   bool ble_enabled_{false};