mcgram 0.2.0__tar.gz → 0.2.2__tar.gz

{mcgram-0.2.0 → mcgram-0.2.2}/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to mcgram will be documented in this file.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.2.2] — 2026-07-26
+
+### Added
+- `mcgram init` now probes `api.telegram.org` reachability and bakes the result
+  into the scaffolded config: `bot.disable_polling` is pre-set (`true` when the
+  machine looks Telegram-blocked, `false` when reachable). Skippable via
+  `MCGRAM_INIT_NO_TG_PROBE=1` (air-gapped installs / CI).
+
+### Changed
+- Default-channel auto-seed (`Settings._seed_default_channel`) now prefers ntfy
+  when a bot is configured but `disable_polling=true` (blocked machine) and an
+  ntfy topic exists — so notifications land on a reachable transport instead of
+  a Telegram channel that can't be polled. Explicit `channels.default` still wins.
+- `ask` now rewrites the question message to record the operator's choice
+  (`✅ Đã chọn: …` for buttons, `✅ Trả lời: …` for freetext) instead of only
+  stripping the inline keyboard — the selection stays visible in chat history.
+
+### Fixed
+- `test_version` no longer hard-codes the version string (asserts `__version__`).
+
+## [0.2.1] — 2026-07-26
+
+### Fixed
+- README images and doc links now use absolute GitHub URLs so they render on
+  the PyPI project page (relative paths only resolve inside the GitHub repo).
+
 ## [0.2.0] — 2026-05-22
 
 ### Added

{mcgram-0.2.0 → mcgram-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcgram
-Version: 0.2.0
+Version: 0.2.2
 Summary: Notification bridge for Claude Code (Telegram + ntfy.sh) — send notifications, ask short questions, set reminders via Telegram bot or ntfy.sh topic.
 Project-URL: Homepage, https://github.com/tvtdev94/mcgram
 Project-URL: Repository, https://github.com/tvtdev94/mcgram
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-<img src="docs/images/logo.png" alt="mcgram logo" width="120" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/logo.png" alt="mcgram logo" width="120" />
 
 # mcgram
 
@@ -49,11 +49,11 @@ Description-Content-Type: text/markdown
 [![CI](https://github.com/tvtdev94/mcgram/actions/workflows/ci.yml/badge.svg)](https://github.com/tvtdev94/mcgram/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/mcgram.svg)](https://pypi.org/project/mcgram/)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/tvtdev94/mcgram/blob/main/LICENSE)
 [![Tests](https://img.shields.io/badge/tests-153%20passing-brightgreen.svg)](#)
 [![Coverage](https://img.shields.io/badge/coverage-84%25-brightgreen.svg)](#)
 
-<img src="docs/images/hero.png" alt="mcgram hero" width="720" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/hero.png" alt="mcgram hero" width="720" />
 
 </div>
 
@@ -77,7 +77,7 @@ Single process, no daemon, no VPS, no webhook setup. Lives inside the MCP server
 ## How it fits together
 
 <div align="center">
-<img src="docs/images/flow.png" alt="Architecture flow" width="720" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/flow.png" alt="Architecture flow" width="720" />
 </div>
 
 Claude Code spawns `mcgram` over stdio. mcgram opens a long-poll to the Telegram Bot API. When you tap a button or type a reply, the update lands on your phone-out / mcgram-in side, the operator allowlist filters non-you traffic, and the answer flows back to Claude as the tool result.
@@ -147,7 +147,7 @@ Declare both `ntfy:` and `bot:` in config — each named channel picks its own t
 | **`cancel_reminder`** | — | — | Cancel a pending reminder |
 | **`list_reminders`** | — | — | List currently pending reminders |
 
-ntfy.sh has no 2-way input, so `ask` returns `transport_unsupported` on ntfy channels. The companion [Claude Code skill](src/mcgram/data/skill/SKILL.md) (installed by `mcgram init`) teaches Claude when to call which tool — both **English** and **Vietnamese** trigger phrases are recognized.
+ntfy.sh has no 2-way input, so `ask` returns `transport_unsupported` on ntfy channels. The companion [Claude Code skill](https://github.com/tvtdev94/mcgram/blob/main/src/mcgram/data/skill/SKILL.md) (installed by `mcgram init`) teaches Claude when to call which tool — both **English** and **Vietnamese** trigger phrases are recognized.
 
 ## Channels
 
@@ -236,7 +236,7 @@ allow_outside_cwd: false           # send_file restricted to CWD by default
 | ⏱ **`ask` DoS** | Hard timeout cap (600s) so a forgetful user can't freeze Claude forever |
 | 🔁 **Polling conflict** | Telegram 409 caught with clean error — no crash loop |
 
-Full STRIDE analysis: [docs/security-threat-model.md](docs/security-threat-model.md).
+Full STRIDE analysis: [docs/security-threat-model.md](https://github.com/tvtdev94/mcgram/blob/main/docs/security-threat-model.md).
 
 ## Audit
 
@@ -269,7 +269,7 @@ Sample lines:
 
 ## Architecture
 
-Full module map, lifecycle diagram, and data flow: [docs/architecture.md](docs/architecture.md).
+Full module map, lifecycle diagram, and data flow: [docs/architecture.md](https://github.com/tvtdev94/mcgram/blob/main/docs/architecture.md).
 
 ```
 src/mcgram/
@@ -308,4 +308,4 @@ uv run ruff check src/ tests/
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/tvtdev94/mcgram/blob/main/LICENSE).

{mcgram-0.2.0 → mcgram-0.2.2}/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="docs/images/logo.png" alt="mcgram logo" width="120" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/logo.png" alt="mcgram logo" width="120" />
 
 # mcgram
 
@@ -9,11 +9,11 @@
 [![CI](https://github.com/tvtdev94/mcgram/actions/workflows/ci.yml/badge.svg)](https://github.com/tvtdev94/mcgram/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/mcgram.svg)](https://pypi.org/project/mcgram/)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/tvtdev94/mcgram/blob/main/LICENSE)
 [![Tests](https://img.shields.io/badge/tests-153%20passing-brightgreen.svg)](#)
 [![Coverage](https://img.shields.io/badge/coverage-84%25-brightgreen.svg)](#)
 
-<img src="docs/images/hero.png" alt="mcgram hero" width="720" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/hero.png" alt="mcgram hero" width="720" />
 
 </div>
 
@@ -37,7 +37,7 @@ Single process, no daemon, no VPS, no webhook setup. Lives inside the MCP server
 ## How it fits together
 
 <div align="center">
-<img src="docs/images/flow.png" alt="Architecture flow" width="720" />
+<img src="https://raw.githubusercontent.com/tvtdev94/mcgram/main/docs/images/flow.png" alt="Architecture flow" width="720" />
 </div>
 
 Claude Code spawns `mcgram` over stdio. mcgram opens a long-poll to the Telegram Bot API. When you tap a button or type a reply, the update lands on your phone-out / mcgram-in side, the operator allowlist filters non-you traffic, and the answer flows back to Claude as the tool result.
@@ -107,7 +107,7 @@ Declare both `ntfy:` and `bot:` in config — each named channel picks its own t
 | **`cancel_reminder`** | — | — | Cancel a pending reminder |
 | **`list_reminders`** | — | — | List currently pending reminders |
 
-ntfy.sh has no 2-way input, so `ask` returns `transport_unsupported` on ntfy channels. The companion [Claude Code skill](src/mcgram/data/skill/SKILL.md) (installed by `mcgram init`) teaches Claude when to call which tool — both **English** and **Vietnamese** trigger phrases are recognized.
+ntfy.sh has no 2-way input, so `ask` returns `transport_unsupported` on ntfy channels. The companion [Claude Code skill](https://github.com/tvtdev94/mcgram/blob/main/src/mcgram/data/skill/SKILL.md) (installed by `mcgram init`) teaches Claude when to call which tool — both **English** and **Vietnamese** trigger phrases are recognized.
 
 ## Channels
 
@@ -196,7 +196,7 @@ allow_outside_cwd: false           # send_file restricted to CWD by default
 | ⏱ **`ask` DoS** | Hard timeout cap (600s) so a forgetful user can't freeze Claude forever |
 | 🔁 **Polling conflict** | Telegram 409 caught with clean error — no crash loop |
 
-Full STRIDE analysis: [docs/security-threat-model.md](docs/security-threat-model.md).
+Full STRIDE analysis: [docs/security-threat-model.md](https://github.com/tvtdev94/mcgram/blob/main/docs/security-threat-model.md).
 
 ## Audit
 
@@ -229,7 +229,7 @@ Sample lines:
 
 ## Architecture
 
-Full module map, lifecycle diagram, and data flow: [docs/architecture.md](docs/architecture.md).
+Full module map, lifecycle diagram, and data flow: [docs/architecture.md](https://github.com/tvtdev94/mcgram/blob/main/docs/architecture.md).
 
 ```
 src/mcgram/
@@ -268,4 +268,4 @@ uv run ruff check src/ tests/
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/tvtdev94/mcgram/blob/main/LICENSE).

{mcgram-0.2.0 → mcgram-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcgram"
-version = "0.2.0"
+version = "0.2.2"
 description = "Notification bridge for Claude Code (Telegram + ntfy.sh) — send notifications, ask short questions, set reminders via Telegram bot or ntfy.sh topic."
 readme = "README.md"
 requires-python = ">=3.11"

{mcgram-0.2.0 → mcgram-0.2.2}/src/mcgram/__init__.py

@@ -1,3 +1,3 @@
 """mcgram - notification bridge for Claude Code (Telegram + ntfy.sh)."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{mcgram-0.2.0 → mcgram-0.2.2}/src/mcgram/ask_registry.py

@@ -68,7 +68,7 @@ class AskRegistry:
         )
         try:
             value, source = await asyncio.wait_for(fut, timeout=timeout_s)
-            await _strip_keyboard(client, chat_id, msg["message_id"])
+            await _mark_answered(client, chat_id, msg["message_id"], question, value, source)
             return {"value": value, "source": source, "question_id": q_id}
         except TimeoutError:
             await _mark_timed_out(client, chat_id, msg["message_id"], question)
@@ -124,6 +124,29 @@ class AskRegistry:
         self._answer_hook = hook
 
 
+async def _mark_answered(
+    client: TelegramClient,
+    chat_id: int,
+    message_id: int,
+    question: str,
+    value: str,
+    source: str,
+) -> None:
+    """Record the operator's answer in the chat by rewriting the question message.
+
+    Without this the inline keyboard just vanishes on reply, leaving no trace in
+    chat history of what was picked. Append the choice, then drop the buttons.
+    """
+    label = "Đã chọn" if source == "button" else "Trả lời"
+    try:
+        await client.edit_message_text(
+            chat_id, message_id, f"{question}\n\n✅ {label}: {value}"
+        )
+    except Exception:
+        log.debug("edit_message_text on answer failed (non-fatal)", exc_info=True)
+    await _strip_keyboard(client, chat_id, message_id)
+
+
 async def _strip_keyboard(client: TelegramClient, chat_id: int, message_id: int) -> None:
     try:
         await client.edit_message_reply_markup(chat_id, message_id, reply_markup=None)

{mcgram-0.2.0 → mcgram-0.2.2}/src/mcgram/cli_init.py

@@ -120,9 +120,34 @@ def _register_with_claude_code(cfg: Path, *, force: bool) -> None:
             print(f"            stderr: {result.stderr.strip()[:200]}")
 
 
-def _render_config_template(topic: str) -> str:
-    """Substitute placeholder topic into the bundled config template."""
-    return _bundled_config_yaml().replace("{{NTFY_TOPIC}}", topic)
+def _render_config_template(topic: str, *, tg_disable_polling: bool) -> str:
+    """Substitute placeholders into the bundled config template: the generated
+    ntfy topic and the detected Telegram reachability (`disable_polling`)."""
+    return (
+        _bundled_config_yaml()
+        .replace("{{NTFY_TOPIC}}", topic)
+        .replace("{{TG_DISABLE_POLLING}}", "true" if tg_disable_polling else "false")
+    )
+
+
+def _probe_telegram_reachable(
+    api_root: str = "https://api.telegram.org", timeout: float = 5.0
+) -> bool:
+    """Best-effort: can this machine reach the Telegram Bot API?
+
+    Any HTTP response (even 404) means the host is reachable -> True. A connect
+    or timeout error means it is blocked/unreachable -> False. Never raises.
+
+    Returns True (skips the probe) when MCGRAM_INIT_NO_TG_PROBE is set — for
+    air-gapped installs and tests, where 'reachable' keeps disable_polling=false.
+    """
+    if os.environ.get("MCGRAM_INIT_NO_TG_PROBE", "").strip().lower() in {"1", "true", "yes"}:
+        return True
+    try:
+        httpx.get(api_root, timeout=timeout)
+        return True
+    except httpx.HTTPError:
+        return False
 
 
 def _seed_ntfy_subscription(server: str, topic: str) -> None:
@@ -184,9 +209,14 @@ def init_config(*, force: bool = False) -> int:
     skipped: list[str] = []
 
     fresh_scaffold = False
+    tg_reachable = True
     if not cfg.exists() or force:
         topic = _generate_topic()
-        cfg.write_text(_render_config_template(topic), encoding="utf-8")
+        tg_reachable = _probe_telegram_reachable()
+        cfg.write_text(
+            _render_config_template(topic, tg_disable_polling=not tg_reachable),
+            encoding="utf-8",
+        )
         created.append(str(cfg))
         fresh_scaffold = True
     else:
@@ -204,6 +234,15 @@ def init_config(*, force: bool = False) -> int:
     for p in skipped:
         print(f"skipped  {p} (already exists; use --force to overwrite)")
 
+    if fresh_scaffold:
+        if tg_reachable:
+            print("detect   telegram reachable — enable `bot:` later for 2-way `ask`")
+        else:
+            print(
+                "detect   api.telegram.org unreachable — this machine looks "
+                "Telegram-blocked; ntfy stays default (bot.disable_polling pre-set true)"
+            )
+
     install_skill(quiet=False, force=force)
     _register_with_claude_code(cfg, force=force)
 

{mcgram-0.2.0 → mcgram-0.2.2}/src/mcgram/config.py

@@ -154,25 +154,38 @@ class Settings(BaseModel):
 
     @model_validator(mode="after")
     def _seed_default_channel(self) -> Settings:
-        """Auto-seed `default` channel based on which transport is configured.
+        """Auto-seed `default` channel based on which transport can actually serve.
 
-        Priority when both transports are present and user hasn't declared
-        `channels.default` explicitly: telegram wins (preserves pre-ntfy behavior).
+        User's explicit `channels.default` always wins. Otherwise Telegram is the
+        default only when it can fully operate (polling on → `ask` works). A machine
+        that blocks Telegram sets `bot.disable_polling=true`; there, if ntfy is
+        configured, the default routes to ntfy instead — so notifications land
+        somewhere reachable rather than a transport that can't be polled.
         """
         if DEFAULT_CHANNEL in self.channels:
             return self
-        if self.bot is not None:
+        ntfy_usable = self.ntfy is not None and bool(self.ntfy.default_topic)
+        if self.bot is not None and not self.bot.disable_polling:
             self.channels[DEFAULT_CHANNEL] = ChannelConfig(
                 transport="telegram",
                 chat_id=self.bot.operator_chat_id,
                 description="Auto-created from bot.operator_chat_id",
             )
-        elif self.ntfy is not None and self.ntfy.default_topic:
+        elif ntfy_usable:
+            assert self.ntfy is not None
             self.channels[DEFAULT_CHANNEL] = ChannelConfig(
                 transport="ntfy",
                 ntfy_topic=self.ntfy.default_topic,
                 description="Auto-created from ntfy.default_topic",
             )
+        elif self.bot is not None:
+            # bot present but polling disabled and no ntfy fallback — still seed a
+            # default so send-only Telegram deployments have a target.
+            self.channels[DEFAULT_CHANNEL] = ChannelConfig(
+                transport="telegram",
+                chat_id=self.bot.operator_chat_id,
+                description="Auto-created from bot.operator_chat_id (send-only)",
+            )
         return self
 
     def resolve_destination(self, name: str | None = None) -> Destination:

{mcgram-0.2.0 → mcgram-0.2.2}/src/mcgram/data/config.example.yaml

@@ -16,6 +16,8 @@ ntfy:
 # bot:
 #   token_env: MCGRAM_BOT_TOKEN
 #   operator_chat_id: 0             # your personal chat ID (integer)
+#   disable_polling: {{TG_DISABLE_POLLING}}   # auto-detected at init: true = api.telegram.org
+#                                   # looked unreachable (send-only, no `ask`); false = reachable
 
 defaults:
   parse_mode: plain               # plain | markdown_v2 (default plain)

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_ask_registry.py

@@ -190,5 +190,51 @@ async def test_callback_index_out_of_range() -> None:
     assert result["value"] == "only"
 
 
+async def test_button_answer_echoed_into_message() -> None:
+    """After a button tap the question message is rewritten to record the choice."""
+    client = FakeClient()
+    reg = AskRegistry()
+    reg.set_answer_hook(client.answer_callback_query)
+
+    async def driver() -> None:
+        for _ in range(50):
+            if reg.open_count:
+                break
+            await asyncio.sleep(0.01)
+        q_id = next(iter(reg._pending))
+        await reg.handle_update({"callback_query": {"id": "cq1", "data": f"{q_id}:1"}})
+
+    drv = asyncio.create_task(driver())
+    result = await reg.open(
+        client, chat_id=1, question="Deploy?", options=["Yes", "No"], timeout_s=5
+    )
+    await drv
+    assert result["value"] == "No"
+    text_edits = [e for e in client.edited if e["kind"] == "text"]
+    assert any("Deploy?" in e["text"] and "Đã chọn: No" in e["text"] for e in text_edits)
+
+
+async def test_freetext_answer_echoed_into_message() -> None:
+    client = FakeClient()
+    reg = AskRegistry()
+
+    async def driver() -> None:
+        for _ in range(50):
+            if reg.open_count:
+                break
+            await asyncio.sleep(0.01)
+        await asyncio.sleep(0.01)
+        await reg.handle_update({
+            "message": {"chat": {"id": 1}, "text": "ship it", "date": time.time() + 1}
+        })
+
+    drv = asyncio.create_task(driver())
+    result = await reg.open(client, chat_id=1, question="Why?", options=None, timeout_s=5)
+    await drv
+    assert result["value"] == "ship it"
+    text_edits = [e for e in client.edited if e["kind"] == "text"]
+    assert any("Trả lời: ship it" in e["text"] for e in text_edits)
+
+
 # Suppress "Unused" import on bare envs
 _ = pytest

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_channels.py

@@ -61,3 +61,48 @@ def test_unknown_channel_raises(tmp_path: Path) -> None:
     s = _write(tmp_path / "c.yaml", "bot:\n  operator_chat_id: 1\n")
     with pytest.raises(ConfigError, match="unknown channel"):
         s.resolve_channel("nope")
+
+
+def test_default_routes_to_ntfy_when_telegram_blocked(tmp_path: Path) -> None:
+    """bot present but polling disabled (blocked machine) + ntfy → default = ntfy."""
+    s = _write(
+        tmp_path / "c.yaml",
+        """
+bot:
+  operator_chat_id: 1
+  disable_polling: true
+ntfy:
+  default_topic: mcgram-abc
+""",
+    )
+    dest = s.resolve_destination()
+    assert dest.transport == "ntfy"
+    assert dest.ntfy_topic == "mcgram-abc"
+
+
+def test_default_routes_to_telegram_when_reachable(tmp_path: Path) -> None:
+    """bot with polling on wins the default even when ntfy is also configured."""
+    s = _write(
+        tmp_path / "c.yaml",
+        """
+bot:
+  operator_chat_id: 7
+  disable_polling: false
+ntfy:
+  default_topic: mcgram-abc
+""",
+    )
+    dest = s.resolve_destination()
+    assert dest.transport == "telegram"
+    assert dest.chat_id == 7
+
+
+def test_default_telegram_sendonly_when_blocked_without_ntfy(tmp_path: Path) -> None:
+    """No ntfy fallback: a blocked bot still seeds a (send-only) telegram default."""
+    s = _write(
+        tmp_path / "c.yaml",
+        "bot:\n  operator_chat_id: 5\n  disable_polling: true\n",
+    )
+    dest = s.resolve_destination()
+    assert dest.transport == "telegram"
+    assert dest.chat_id == 5

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_cli.py

@@ -11,11 +11,13 @@ from mcgram.cli import main
 
 
 def test_version(monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]) -> None:
+    from mcgram import __version__
+
     monkeypatch.setattr(sys, "argv", ["mcgram", "--version"])
     main()
     out = capsys.readouterr().out
     assert "mcgram" in out
-    assert "0.2.0" in out
+    assert __version__ in out
 
 
 def test_help(monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]) -> None:

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_cli_init.py

@@ -16,6 +16,13 @@ def _no_claude_cli(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(cli_init, "_claude_cli_available", lambda: False)
 
 
+@pytest.fixture(autouse=True)
+def _no_tg_probe(monkeypatch: pytest.MonkeyPatch) -> None:
+    """Keep init offline: skip the Telegram reachability probe unless a test
+    overrides `_probe_telegram_reachable` itself."""
+    monkeypatch.setenv("MCGRAM_INIT_NO_TG_PROBE", "1")
+
+
 def test_init_creates_files(tmp_path: Path, monkeypatch: pytest.MonkeyPatch,
                             capsys: pytest.CaptureFixture[str]) -> None:
     monkeypatch.setenv("HOME", str(tmp_path))
@@ -93,3 +100,58 @@ def test_register_skipped_when_already_present(
     init_config()
     out = capsys.readouterr().out
     assert "already in" in out
+
+
+def test_init_sets_disable_polling_false_when_telegram_reachable(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    monkeypatch.setenv("HOME", str(tmp_path))
+    monkeypatch.setenv("USERPROFILE", str(tmp_path))
+    monkeypatch.setattr(cli_init, "_probe_telegram_reachable", lambda *a, **k: True)
+    init_config()
+    text = (Path.home() / ".mcgram" / "config.yaml").read_text(encoding="utf-8")
+    assert "disable_polling: false" in text
+    assert "{{TG_DISABLE_POLLING}}" not in text  # placeholder fully substituted
+
+
+def test_init_sets_disable_polling_true_when_telegram_blocked(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    monkeypatch.setenv("HOME", str(tmp_path))
+    monkeypatch.setenv("USERPROFILE", str(tmp_path))
+    monkeypatch.setattr(cli_init, "_probe_telegram_reachable", lambda *a, **k: False)
+    init_config()
+    text = (Path.home() / ".mcgram" / "config.yaml").read_text(encoding="utf-8")
+    assert "disable_polling: true" in text
+    out = capsys.readouterr().out
+    assert "unreachable" in out.lower()
+
+
+def test_probe_reachable_true_on_any_response(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delenv("MCGRAM_INIT_NO_TG_PROBE", raising=False)
+    import httpx
+    monkeypatch.setattr(httpx, "get", lambda *a, **k: object())
+    assert cli_init._probe_telegram_reachable() is True
+
+
+def test_probe_reachable_false_on_http_error(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delenv("MCGRAM_INIT_NO_TG_PROBE", raising=False)
+    import httpx
+
+    def _boom(*_a: object, **_k: object) -> object:
+        raise httpx.ConnectError("blocked")
+
+    monkeypatch.setattr(httpx, "get", _boom)
+    assert cli_init._probe_telegram_reachable() is False
+
+
+def test_probe_skipped_via_env(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("MCGRAM_INIT_NO_TG_PROBE", "1")
+    import httpx
+
+    def _boom(*_a: object, **_k: object) -> object:
+        raise AssertionError("probe must not touch the network when skipped")
+
+    monkeypatch.setattr(httpx, "get", _boom)
+    assert cli_init._probe_telegram_reachable() is True

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_cli_init_ntfy.py

@@ -19,8 +19,10 @@ def _no_claude_cli(monkeypatch: pytest.MonkeyPatch) -> None:
 
 @pytest.fixture(autouse=True)
 def _no_real_network(monkeypatch: pytest.MonkeyPatch) -> None:
-    """Don't hit ntfy.sh from the test suite; default to skipping the welcome seed."""
+    """Don't hit the network from the test suite: skip the welcome seed and the
+    Telegram reachability probe (probe-skipped counts as reachable)."""
     monkeypatch.setenv("MCGRAM_INIT_NO_WELCOME", "1")
+    monkeypatch.setenv("MCGRAM_INIT_NO_TG_PROBE", "1")
 
 
 def test_generate_topic_format() -> None:

{mcgram-0.2.0 → mcgram-0.2.2}/tests/test_tools_ask.py

@@ -64,6 +64,11 @@ async def test_happy_button(app_state: AppState, httpx_mock) -> None:
         url="https://api.telegram.org/botfake-token/answerCallbackQuery",
         json={"ok": True, "result": True},
     )
+    # ask now rewrites the question message to record the choice, then strips buttons.
+    httpx_mock.add_response(
+        url="https://api.telegram.org/botfake-token/editMessageText",
+        json={"ok": True, "result": True},
+    )
     httpx_mock.add_response(
         url="https://api.telegram.org/botfake-token/editMessageReplyMarkup",
         json={"ok": True, "result": True},

{mcgram-0.2.0 → mcgram-0.2.2}/uv.lock

@@ -506,7 +506,7 @@ wheels = [
 
 [[package]]
 name = "mcgram"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },