From 3b1bf0adcb21657ee3259a4f262a29b0f3fac88e Mon Sep 17 00:00:00 2001 From: reachableceo Date: Tue, 1 Sep 2026 17:35:13 -0500 Subject: [PATCH] chore: HomeAssistant ops dir (config-repo pointer, needfromcharles asks); tidy test junk [#344] --- AGENTS.md | 3 +- HomeAssistant/README.md | 35 +++++++++++++++ HomeAssistant/needfromcharles.md | 44 +++++++++++++++++++ .../packs}/automations-ups-alerts.yaml | 0 .../packs}/energy-plant-kwh.yaml | 0 .../packs}/sensors-snmp-plant.yaml | 0 6 files changed, 81 insertions(+), 1 deletion(-) create mode 100644 HomeAssistant/README.md create mode 100644 HomeAssistant/needfromcharles.md rename {dcinfra/ha => HomeAssistant/packs}/automations-ups-alerts.yaml (100%) rename {dcinfra/ha => HomeAssistant/packs}/energy-plant-kwh.yaml (100%) rename {dcinfra/ha => HomeAssistant/packs}/sensors-snmp-plant.yaml (100%) diff --git a/AGENTS.md b/AGENTS.md index 8b7a90c..2fe0d75 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -346,7 +346,8 @@ Work tracking stays in [Redmine](https://projects.knownelement.com). ## Repository Layout ``` -dcinfra/ Data-center infra: PDU (powerman), serial console (console), UPS (ups) +dcinfra/ Data-center infra: PDU (powerman), serial console (console), UPS (ups), sensors (temper) +HomeAssistant/ OAM: pfv-bms ops pointer + needfromcharles asks (live config SoR = KNEL/pfv-bms repo) netinfra/ DNS/NTP/DHCP setup + audit; DNS cluster replication (dns-cluster-setup); switch captures (switches); DHCP config (dhcp) k8s/ k3s cluster setup scripts (HA control plane over Tailscale) + docs/ diff --git a/HomeAssistant/README.md b/HomeAssistant/README.md new file mode 100644 index 0000000..4b8047b --- /dev/null +++ b/HomeAssistant/README.md @@ -0,0 +1,35 @@ +# HomeAssistant/ — pfv-bms operational notes + +**Config source of truth: [KNEL/pfv-bms](https://git.knownelement.com/KNEL/pfv-bms)** +(private). Everything live (YAML, dashboards, packages) is deployed by +pushing that repo — the `core_git_pull` add-on on pfv-bms polls every 300s, +pulls, and auto-restarts Home Assistant on config changes. + +## Where things live + +| Thing | Location | +|---|---| +| HA configuration (live) | KNEL/pfv-bms repo → /config on pfv-bms (VM 100, pfv-tsys1, 4 vCPU / 6GB) | +| Deploy pipeline | core_git_pull add-on (deploy key `~/.creds/pfv-bms-gitpull`, read-only) | +| Host shell access | `VM_IP=pfv-bms-lan.knel.net VM_USER=root VM_PORT=22222 bash tests/remote.sh vm '...'` | +| HA REST API | `~/.creds/homeassistant.env` (token) | +| Global/Cloudron instance | https://building-management.knownelement.com (`~/.creds/cloudron-ha.env`) | +| Samba (interactive edits) | add-on; creds `~/.creds/pfv-bms-samba.env` | +| Custom components | on-box only, gitignored (HACS 2.0.5, Govee lasswellt v2026.8.7) | +| Reference packs (this dir) | `packs/` — see statuses below | + +## packs/ status + +| File | Status | +|---|---| +| automations-ups-alerts.yaml | SUPERSEDED — live copy in KNEL/pfv-bms (retargeted to companion app) | +| sensors-snmp-plant.yaml | DEAD — legacy snmp sensor platform creates nothing in HA 2026.8; migration tracked in #618 | +| energy-plant-kwh.yaml | PENDING — Riemann-sum helper reference for the energy dashboard (#439) | + +## Related tickets + +#344 (umbrella) · #439 (UPS/alerts) · #614 (minisplit/BTU) · #618-#628 (roadmap) · #629 (Friday onsite) + +Knowledge docs live on +[Discourse VP TechOps](https://community.turnsys.com/c/vp-techops) — this +file is the repo-side operational pointer. diff --git a/HomeAssistant/needfromcharles.md b/HomeAssistant/needfromcharles.md new file mode 100644 index 0000000..21932ad --- /dev/null +++ b/HomeAssistant/needfromcharles.md @@ -0,0 +1,44 @@ + +> Working ask-file; knowledge docs live on Discourse: https://community.turnsys.com/c/vp-techops (audit log: https://community.turnsys.com/t/298) + +# needfromcharles.md — open asks from the agent (2026-09-01 night session) + +Answer inline below each item; the agent checks this file before asking again. + +## 1. Minisplit (Midea/Carrier) — blocks #614 +Your login `charles@turnsys.com` was rejected by all three Midea cloud +backends (SmartHome / Midea Air / NetHome Plus). Likely a Carrier-specific +backend or a different account. +- [ ] Exact app name on your phone that controls the minisplit: +- [ ] Account email that app uses (if different): +- [ ] (If MSmartHome-family) password for that account: + +## 2. Govee — blocks #620 device data +Cloud API sees zero devices (suspect BLE-only sensors). +- [ ] Model numbers of your Govee temp sensors / lights: +- [ ] Govee app account email + password (thermometer readings require it): + +## 3. HomeKit codes — blocks #619 (ecobee + front-door lock) +- [ ] ecobee HomeKit setup code (8-digit, on paperwork/box if not the unit): +- [ ] Front-door lock brand/model: +- [ ] Lock HomeKit code (if visible in its vendor app settings): + +## 4. Emporia Vue 3 — blocks circuit-level power + BTU loop (#623/#614) +- [ ] Ordered? ETA: + +## 5. Decisions (yes/no) +- [ ] UniFi mDNS/multicast setting change may briefly re-provision APs + (short WiFi blip) — OK to apply tonight? +- [ ] Re-enable HA core watchdog (was disabled to break the boot loop; + box has been stable since)? +- [ ] Uninstall the crash-looping community SSH add-on (a0d7b954_ssh)? + (core_ssh on 22222 is the keeper) +- [ ] k8s rebuild tonight or next session? + +## 6. Friday onsite (#629 — unchanged) +Dongle manual/app check · minisplit nameplate photo · ecobee + lock codes +(if not provided above) · Tripp Lite USB reseat (#372) · Emporia CT install. + +## 7. Small hygiene +- [ ] Re-enroll Pi-hole TOTP in your authenticator (secret in + `~/.creds/pihole.env`) — password already rotated. diff --git a/dcinfra/ha/automations-ups-alerts.yaml b/HomeAssistant/packs/automations-ups-alerts.yaml similarity index 100% rename from dcinfra/ha/automations-ups-alerts.yaml rename to HomeAssistant/packs/automations-ups-alerts.yaml diff --git a/dcinfra/ha/energy-plant-kwh.yaml b/HomeAssistant/packs/energy-plant-kwh.yaml similarity index 100% rename from dcinfra/ha/energy-plant-kwh.yaml rename to HomeAssistant/packs/energy-plant-kwh.yaml diff --git a/dcinfra/ha/sensors-snmp-plant.yaml b/HomeAssistant/packs/sensors-snmp-plant.yaml similarity index 100% rename from dcinfra/ha/sensors-snmp-plant.yaml rename to HomeAssistant/packs/sensors-snmp-plant.yaml