refactor: move HA tooling + reference packs to KNEL/pfv-bms [#762]

HomeAssistant/ is now a redirect stub; AGENTS.md layout updated. Zero HA impact — pfv-bms never loaded from PFVCluster. Detail: https://projects.knownelement.com/issues/762
2026-09-03 13:34:55 -05:00
parent 1620351028
commit 4c461c14e1
6 changed files with 12 additions and 578 deletions
@@ -1,35 +1,15 @@
-# HomeAssistant/ — pfv-bms operational notes
+# HomeAssistant/ — moved to KNEL/pfv-bms

-**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.
+Everything Home-Assistant-related now lives in the config source of
+truth: [KNEL/pfv-bms](https://git.knownelement.com/KNEL/pfv-bms)
+(public, AGPLv3).

-## Where things live
-
-| Thing | Location |
+| Moved | New home |
 |---|---|
-| 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 |
+| `ha-ws-call.py` (websocket CLI) | `tools/ha-ws-call.py` |
+| `packs/*.yaml` (reference packs) | `docs/reference-packs/` (reference only, not loaded) |

-## 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.
+Operational facts (host access, REST API env, deploy pipeline) are
+documented in the pfv-bms README and on
+[Discourse VP TechOps](https://community.turnsys.com/c/vp-techops).
+This stub remains for link compatibility. [#762]