feat: add HDMI-CEC monitor control API

Add CEC status, standby, and wake endpoints to player API v2:
- GET /api/v2/cec/status — returns CEC availability and TV power state
- POST /api/v2/cec/standby — sends TV to standby via HDMI-CEC
- POST /api/v2/cec/wake — wakes TV via HDMI-CEC

Also adds get_status() method to CecController and removes state guards
from standby/wake to allow manual override when state is out of sync.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Alex

api/urls/v2.py

@@ -14,6 +14,9 @@
     AssetsControlViewV2,
     AssetViewV2,
     BackupViewV2,
+    CecStandbyViewV2,
+    CecStatusViewV2,
+    CecWakeViewV2,
     DeviceSettingsViewV2,
     FileAssetViewV2,
     InfoViewV2,
@@ -86,6 +89,22 @@ def get_url_patterns():
             ViewLogViewV2.as_view(),
             name='viewlog_v2',
         ),
+        # CEC TV control
+        path(
+            'v2/cec/status',
+            CecStatusViewV2.as_view(),
+            name='cec_status_v2',
+        ),
+        path(
+            'v2/cec/standby',
+            CecStandbyViewV2.as_view(),
+            name='cec_standby_v2',
+        ),
+        path(
+            'v2/cec/wake',
+            CecWakeViewV2.as_view(),
+            name='cec_wake_v2',
+        ),
         # Schedule slots
         path(
             'v2/schedule/slots',

api/views/v2.py

@@ -875,6 +875,54 @@ def post(self, request):
             )
 
 
+# ── CEC TV control ──
+
+_cec_instance = None
+
+
+def _get_cec():
+    global _cec_instance
+    if _cec_instance is None:
+        import importlib.util
+        _app_root = path.dirname(path.dirname(path.dirname(path.abspath(__file__))))
+        spec = importlib.util.spec_from_file_location(
+            'cec_controller',
+            path.join(_app_root, 'viewer', 'cec_controller.py'),
+        )
+        mod = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(mod)
+        _cec_instance = mod.CecController()
+    return _cec_instance
+
+
+class CecStatusViewV2(APIView):
+    """GET /api/v2/cec/status — CEC availability and TV power state."""
+
+    @authorized
+    def get(self, request):
+        return Response(_get_cec().get_status())
+
+
+class CecStandbyViewV2(APIView):
+    """POST /api/v2/cec/standby — Send TV to standby via HDMI-CEC."""
+
+    @authorized
+    def post(self, request):
+        cec = _get_cec()
+        cec.standby()
+        return Response(cec.get_status())
+
+
+class CecWakeViewV2(APIView):
+    """POST /api/v2/cec/wake — Wake TV via HDMI-CEC."""
+
+    @authorized
+    def post(self, request):
+        cec = _get_cec()
+        cec.wake()
+        return Response(cec.get_status())
+
+
 class ViewLogViewV2(APIView):
     """GET /api/v2/viewlog — playback history from viewlog.db."""
 

viewer/cec_controller.py

@@ -42,9 +42,13 @@ def _detect_device(self):
 
         logging.warning('CEC: no working device found, TV control disabled')
 
+    def get_status(self):
+        """Return CEC availability and TV power state."""
+        return {'cec_available': self._available, 'tv_on': self._tv_is_on}
+
     def standby(self):
-        """Send TV to standby. No-op if already off or CEC unavailable."""
-        if not self._available or not self._tv_is_on:
+        """Send TV to standby. No-op if CEC unavailable."""
+        if not self._available:
             return
         try:
             subprocess.run(
@@ -57,8 +61,8 @@ def standby(self):
             logging.warning('CEC: standby failed: %s', e)
 
     def wake(self):
-        """Wake TV up. No-op if already on or CEC unavailable."""
-        if not self._available or self._tv_is_on:
+        """Wake TV up. No-op if CEC unavailable."""
+        if not self._available:
             return
         try:
             subprocess.run(