feat(ups): NUT setup for APC Smart-UPS C 1500 on pfv-tsys1

Deploy Network UPS Tools to monitor the server-room UPS units and feed data to
Home Assistant for power-usage tracking.

APC Smart-UPS C 1500 is fully operational: battery charge, runtime, load,
voltage, and status all reporting via usbhid-ups + APC HID 0.100 subdriver.
upsd listens on Tailscale (100.121.189.98:3493) for HA polling; local upsmon
provides graceful hypervisor shutdown on battery-low.

Key deployment fix: the udev rule must cover SUBSYSTEM=="usb" (raw
/dev/bus/usb) in addition to hidraw, because usbhid-ups opens the raw USB
device file after dropping to the nut user via setuid(). Matching only hidraw
causes EACCES on driver start.

Tripp Lite UPS (09ae:3016) is blocked — driver matches TrippLite HID 0.85
subdriver but fails reading the 878-byte HID Report Descriptor (EAGAIN via USB
hub). Needs physical reseat to direct motherboard USB port. Driver masked to
prevent restart-loop spam.

Files: ups/discover.sh, ups/setup.sh (idempotent), ups/status.sh, ups/README.md

💘 Generated with Crush

Assisted-by: Crush:glm-5.2

AGENTS.md

@@ -14,6 +14,7 @@ dns-cluster-setup/   Technitium DNS cluster replication
 k8s/                 k3s cluster setup scripts (3-node HA over Tailscale) + docs/
 powerman/            Cyclades PM10i PDU management via powerman
 console/             Serial console management (ser2net + conman) for switches
+ups/                 UPS management (NUT) for APC Smart-UPS C 1500 on pfv-tsys1
 perf/                Proxmox perf tuning, fleet audit, iperf
 proxmox/             Proxmox fleet docs (hardware audit, capacity, k8s host planning)
 netinfra/            pfv-netinfra-01/02 DNS/NTP/DHCP setup
@@ -96,6 +97,7 @@ vendor/              Vendored KNELShellFramework
 | [`k8s/install-cp.sh`](k8s/install-cp.sh) | Bootstrap k3s HA control plane |
 | [`powerman/setup.sh`](powerman/setup.sh) | Configure Cyclades PDU via powerman |
 | [`console/setup.sh`](console/setup.sh) | Configure serial console access via ser2net + conman |
+| [`ups/setup.sh`](ups/setup.sh) | Configure NUT (Network UPS Tools) for UPS monitoring |
 | [`perf/deploy-tuning.sh`](perf/deploy-tuning.sh) | Deploy perf tunings |
 
 ## Key Docs