ci: notify master commits via telegram (#143)

.github/workflows/ci.yml

@@ -68,3 +68,25 @@ jobs:
             echo ""
             uv run --no-sync python -m coverage report || true
           } >> "$GITHUB_STEP_SUMMARY"
+
+  notify-commit:
+    name: notify-commit
+    runs-on: ubuntu-latest
+    needs: checks
+    if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' && needs.checks.result == 'success' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Send Telegram notification
+        run: uv run scripts/commit_notify.py
+        env:
+          REPO: ${{ github.repository }}
+          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}

scripts/commit_notify.py

@@ -0,0 +1,77 @@
+# /// script
+# requires-python = ">=3.14"
+# dependencies = [
+#     "mistune>=3.2.0",
+#     "requests>=2.32.5",
+#     "sulguk>=0.11.1",
+# ]
+# ///
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+import re
+
+import mistune
+import requests
+import sulguk
+
+repo = os.environ["REPO"]
+bot_token = os.environ["TELEGRAM_BOT_TOKEN"]
+chat_id = os.environ["TELEGRAM_CHAT_ID"]
+
+event_path = Path(os.environ["GITHUB_EVENT_PATH"])
+event = json.loads(event_path.read_text(encoding="utf-8"))
+
+ref = event.get("ref") or ""
+branch = ref.removeprefix("refs/heads/") if ref.startswith("refs/heads/") else ref
+commits = list(event.get("commits") or [])
+head_commit = event.get("head_commit")
+if not commits and head_commit:
+    commits = [head_commit]
+
+PULL_RE = re.compile(rf"(https://github.com/{repo}/pull/(\d+))")
+
+
+def _short_sha(value: str) -> str:
+    return value[:7] if value else ""
+
+
+def _commit_line(commit: dict[str, object]) -> str:
+    full_sha = str(commit.get("id") or "")
+    sha = _short_sha(full_sha)
+    message = str(commit.get("message") or "").splitlines()[0].strip()
+    message = PULL_RE.sub(r"[#\2](\1)", message)
+    url = f"https://github.com/{repo}/commit/{full_sha or sha}"
+    return f"- [{sha}]({url}) {message}"
+
+
+lines: list[str] = []
+if commits:
+    max_commits = 10
+    lines.extend(_commit_line(commit) for commit in commits[:max_commits])
+    if len(commits) > max_commits:
+        lines.append(f"- ...and {len(commits) - max_commits} more")
+
+header = f"push **{repo} {branch}**".strip()
+parts = [header]
+if lines:
+    parts.append("\n".join(lines))
+
+message = "\n\n".join(part for part in parts if part)
+
+html = mistune.html(message)
+rendered = sulguk.transform_html(html)
+
+payload = {
+    "chat_id": chat_id,
+    "text": rendered.text,
+    "entities": rendered.entities,
+    "link_preview_options": {"is_disabled": True},
+}
+resp = requests.post(
+    f"https://api.telegram.org/bot{bot_token}/sendMessage", json=payload
+)
+resp.raise_for_status()
+print(f"sent to {chat_id}")