live/operator-session/clawdie-live-power

@@ -1,14 +1,22 @@
 #!/bin/sh
+# PROVIDE: clawdie_live_power
+# REQUIRE: FILESYSTEMS syslogd
+# BEFORE: LOGIN
+# KEYWORD: nojail
+#
 # Clawdie operator USB live power baseline.
 # Applies the rc.conf power_profile C-state policy once at boot. FreeBSD's
 # power_profile service is marked nostart and normally runs only when devd sees
 # an AC-line transition, so a live USB can otherwise sit at the firmware/default
 # C-state until AC is unplugged/replugged.
-
-# PROVIDE: clawdie_live_power
-# REQUIRE: FILESYSTEMS syslogd
-# BEFORE: LOGIN
-# KEYWORD: nojail
+#
+# Scope: this selects a CPU C-state/frequency profile ONLY. It never suspends,
+# sleeps, blanks the screen, or enables DPMS (screen-blank is handled separately
+# by the no-blank stack: xorg.conf.d/40-clawdie-noblank.conf + the power-manager
+# skel + clawdie-noblank-guard.sh). Both branches are wake-safe: rc.conf pins
+# performance_cx_lowest AND economy_cx_lowest to C3, so neither the AC (0x01) nor
+# battery (0x00) profile can drop into a deeper C-state that breaks the
+# USB-backed resume path. Keep both at C3 on the live USB — do not deepen.
 
 . /etc/rc.subr