chore: snapshot before shared RS485 bus integration

components/loadbalancer/include/loadbalancer.h

@@ -9,11 +9,32 @@ extern "C" {
 #include <stdint.h>
 #include "esp_err.h"
 
+/**
+ * @brief Operational current limiting mode.
+ *
+ * This is owned by the loadbalancer/policy layer. MQTT/REST should only
+ * request a mode change; they should not persist or re-apply their own mode.
+ */
+typedef enum
+{
+    LOADBALANCER_LIMIT_MODE_OFF = 0,
+    LOADBALANCER_LIMIT_MODE_MANUAL,
+    LOADBALANCER_LIMIT_MODE_GRID,
+    LOADBALANCER_LIMIT_MODE_SOLAR,
+    LOADBALANCER_LIMIT_MODE_GRID_SOLAR
+} loadbalancer_limit_mode_t;
+
 void loadbalancer_init(void);
 
 void loadbalancer_set_enabled(bool enabled);
 bool loadbalancer_is_enabled(void);
 
+// Operational limit mode
+esp_err_t loadbalancer_set_limit_mode(loadbalancer_limit_mode_t mode);
+loadbalancer_limit_mode_t loadbalancer_get_limit_mode(void);
+const char *loadbalancer_limit_mode_to_str(loadbalancer_limit_mode_t mode);
+bool loadbalancer_limit_mode_from_str(const char *str, loadbalancer_limit_mode_t *out);
+
 // GRID limit (A)
 void     loadbalancer_grid_set_enabled(bool en);
 bool     loadbalancer_grid_is_enabled(void);