docs: add push notifications documentation

docs/guide/faq.md

@@ -63,6 +63,13 @@ Yes. Telegram is optional. You can use the web app directly in any browser or in
 3. Navigate to the active session
 4. Approve or deny the pending permission
 
+### How do I receive notifications?
+
+HAPI supports two methods:
+
+1. **PWA Push Notifications** - Enable when prompted, works even when app is closed
+2. **Telegram Bot** - See [Telegram Setup](/guide/installation#telegram-setup)
+
 ### Can I start sessions remotely?
 
 Yes, with daemon mode:

docs/guide/pwa.md

@@ -83,10 +83,23 @@ HAPI uses intelligent caching:
 
 ## Notifications
 
-::: warning Work in Progress
+HAPI supports push notifications to alert you when agents need attention.
-Push notifications are planned for a future release. Currently, notifications work through:
+
-- Telegram bot (recommended)
+### Enable Notifications
-- Keeping the app open in background
+
+1. Open HAPI - a permission popup appears automatically
+2. Tap **Allow** to enable notifications
+3. If you missed the popup, go to system settings to grant permission
+
+### Notification Types
+
+| Type | When Sent |
+|------|-----------|
+| Permission Request | Agent needs your approval |
+| Ready | Agent finished and awaits input |
+
+::: tip
+If push notifications don't work in your region (e.g., FCM unavailable), use [Telegram integration](/guide/installation#telegram-setup) instead.
 :::
 
 ## Managing Your PWA