first commit

scripts/README.md

@@ -0,0 +1,14 @@
+# Operational scripts
+
+All operator-facing scripts live in this directory.
+
+- `install.sh` — first installation on a Debian/Ubuntu systemd host or LXC container.
+- `update.sh` — safe in-place update with SQLite/config/binary backup and automatic rollback on failed health check.
+- `service.sh` — start, stop, restart, status, logs and health helper.
+- `dev.sh` — development build/run/check workflow.
+- `smoke.sh` — HTTP/API smoke test used by `dev.sh --check`.
+- `generate_ha_migration.py` — legacy/manual Home Assistant entity mapping helper.
+- `install-lxc.sh` — compatibility alias for `install.sh`.
+- `common.sh` — shared shell functions; normally not executed directly.
+
+`build.rs` remains in the package root because Cargo requires the build script at that location; it is not an operator script.