From 14a8d45c58e9845726f4dfea38260f0a24e8c2e2 Mon Sep 17 00:00:00 2001
From: tcomlab <tcomlab@gmail.com>
Date: Thu, 18 Dec 2025 17:03:38 +0200
Subject: [PATCH] Add VPN/APP status to heartbeat and document behavior

---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index 4265b50..316b99e 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,13 @@ sudo systemctl enable --now serial-heartbeat
 Сервіс використовує `Type=notify`, тож systemd очікує сигнал готовності і
 контролює watchdog з таймаутом 20 секунд.
 
+## Heartbeat behaviour
+
+- На `{"hb": 1}` або `{"cmd": "status"}` в?дпов?дає `{"hb": 2, "VPN": <0|1>, "APP": <0|1>}`.
+- `VPN` = 1, якщо ?нтерфейс `tun0` ?снує ? (`operstate` = `up` / `carrier` = `1` / `unknown`, але ?нтерфейс присутн?), ?накше 0.
+- `APP` = 1, якщо `systemctl is-active --quiet watcher_application.service` повертає усп?х, ?накше 0.
+- Увесь вх?дний JSON журналюється на р?вн? INFO для видимост?.
+
 ## Розробка
 
 - `python3 -m py_compile serial_heartbeat.py` — швидка перевірка синтаксису.