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` — швидка перевірка синтаксису.