feat(power): add controlled low-battery shutdown

components/domain/include/domain.h

@@ -67,9 +67,15 @@ esp_err_t domain_battery_sample(void);
 /** Copy the latest battery SSOT snapshot into `out_status`. */
 esp_err_t domain_battery_get_status(domain_battery_status_t *out_status);
 
-/** Reserved policy hook; this release intentionally performs no shutdown. */
+/** Enter the configured board deep-sleep state; a successful call does not return. */
 esp_err_t domain_battery_prepare_shutdown(void);
 
+/** Return true when the current boot resumed through a deep-sleep wake source. */
+bool domain_battery_woke_from_deep_sleep(void);
+
+/** Release low-power GPIO holds after accepting a deep-sleep wake. */
+void domain_battery_complete_wakeup(void);
+
 typedef enum {
     DOMAIN_WIFI_PROMPT_WIFI_SUCCESS = 0,
     DOMAIN_WIFI_PROMPT_AFTER_WIFI_SUCCESS,