From b35a8675b5c2d87611c9903b2e5cd14de74c882d Mon Sep 17 00:00:00 2001
From: William Valentin <william.valentin.info@gmail.com>
Date: Wed, 18 Feb 2026 13:12:21 -0800
Subject: [PATCH] docs(config): default telegram group replies and track
 reliability hardening

---
 README.md             |  1 +
 config/default.yaml   |  1 +
 docs/plans/state.json | 23 +++++++++++++++++++++++
 3 files changed, 25 insertions(+)

diff --git a/README.md b/README.md
index 0428500..8a0e047 100644
--- a/README.md
+++ b/README.md
@@ -149,6 +149,7 @@ Config location: `~/.config/flynn/config.yaml` (or set `FLYNN_CONFIG`)
 telegram:
   bot_token: "your-telegram-bot-token"
   allowed_chat_ids: [123456789]  # Your Telegram user ID
+  require_mention: false          # Default false: respond in allowed groups without @mention
 
 # Optional: Matrix
 matrix:
diff --git a/config/default.yaml b/config/default.yaml
index 9da085a..84cadcb 100644
--- a/config/default.yaml
+++ b/config/default.yaml
@@ -8,6 +8,7 @@
 telegram:
   bot_token: ${FLYNN_TELEGRAM_TOKEN}
   allowed_chat_ids: []  # Add your Telegram chat ID
+  # require_mention: false  # Default false: respond to all allowed group messages
 
 # Optional: Signal via signal-cli
 # signal:
diff --git a/docs/plans/state.json b/docs/plans/state.json
index 5019438..3a1d144 100644
--- a/docs/plans/state.json
+++ b/docs/plans/state.json
@@ -5525,6 +5525,29 @@
         "docs/plans/state.json"
       ],
       "test_status": "pnpm test:run src/gateway/handlers/handlers.test.ts src/cli/setup/config.test.ts src/cli/setup/automation.test.ts + pnpm typecheck passing"
+    },
+    "telegram-reliability-hardening-diagnostics": {
+      "status": "completed",
+      "date": "2026-02-18",
+      "updated": "2026-02-18",
+      "summary": "Hardened Telegram channel reliability: default group behavior now responds without mention gating, adapter now records error metadata, retries transient Telegram API failures, and schedules reconnect attempts after polling/runtime faults. Surfaced adapter error diagnostics through gateway services/channels, dashboard service cards, and doctor Telegram status detail.",
+      "files_modified": [
+        "src/channels/telegram/adapter.ts",
+        "src/channels/telegram/adapter.test.ts",
+        "src/channels/types.ts",
+        "src/config/schema.ts",
+        "src/config/schema.test.ts",
+        "src/gateway/server.ts",
+        "src/gateway/handlers/system.ts",
+        "src/gateway/handlers/services.ts",
+        "src/gateway/handlers/services.test.ts",
+        "src/gateway/ui/pages/dashboard.js",
+        "src/cli/doctor.ts",
+        "config/default.yaml",
+        "README.md",
+        "docs/plans/state.json"
+      ],
+      "test_status": "pnpm test:run src/channels/telegram/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts src/cli/doctor.test.ts + pnpm typecheck passing"
     }
   },
   "overall_progress": {