forgejo-actions/README.md

forgejo-actions

Composite actions reused across all RMS Tech Studio repos.

notify-telegram

Pings a Telegram chat about a workflow outcome. Skips silently if credentials are missing.

Setup once (org-level) — in Forgejo, go to your org → Settings → Actions → Secrets, add:

• TELEGRAM_BOT_TOKEN
• TELEGRAM_CHAT_ID

These propagate to all repos under the org.

Usage in a workflow:

- name: Notify Telegram (success)
  if: success()
  uses: https://git.rmstechstudio.com/rmstechstudio/forgejo-actions/notify-telegram@main
  with:
    bot-token: ${{ secrets.TELEGRAM_BOT_TOKEN }}
    chat-id: ${{ secrets.TELEGRAM_CHAT_ID }}
    status: success
    title: "RMS Ecosystem deploy"
    message: ${{ github.event.head_commit.message }}

- name: Notify Telegram (failure)
  if: failure()
  uses: https://git.rmstechstudio.com/rmstechstudio/forgejo-actions/notify-telegram@main
  with:
    bot-token: ${{ secrets.TELEGRAM_BOT_TOKEN }}
    chat-id: ${{ secrets.TELEGRAM_CHAT_ID }}
    status: failure
    title: "RMS Ecosystem deploy"

Inputs:

Name	Required	Default	Description
bot-token	yes	—	Telegram bot token
chat-id	yes	—	Telegram chat id
status	yes	—	success or failure
title	yes	—	Short label, e.g. "RMS Ecosystem deploy"
message	no	""	Extra body (commit msg, error summary…)
notify-on-success	no	true	Set false for silent crons