# 檔案用途：定義 CLEANUP OLD RELEASES 這個 Docker action 的輸入參數與執行環境
# 更新日期：2026/07/11 21:02:25

# Action 名稱，會顯示在 action 市集與文件中
name: 'CLEANUP OLD RELEASES'

# Action 描述，簡短說明這個 action 的目的
description: '清理舊版成品'

# 作者資訊，標示此 action 的維護者
author: 'Jeffery'

# 定義可由使用者或呼叫端傳入的輸入參數
inputs:
  # RUNNER_TOKEN 用於授權呼叫 Gitea API；未提供時會改用 secrets
  RUNNER_TOKEN:
    # 參數說明，讓呼叫端知道這是 Runner Token
    description: 'Gitea Runner Token'
  # KEEP_COUNT 用於控制保留的 release 數量
  KEEP_COUNT:
    # 參數說明，這裡表示保留的版本數量
    description: '保留的版本數量'
    # 預設保留 2 個版本，避免完全刪除歷史 release
    default: '2'

# 定義 action 的執行方式
runs:
  # 使用 Docker image 作為執行環境
  using: docker
  # Dockerfile 位於 repo 根目錄
  image: Dockerfile
  # 將 Gitea 與輸入參數映射為容器環境變數
  env:
    # GITEA_SERVER_URL 由 Gitea runtime 注入，供程式組 API URL
    GITEA_SERVER_URL: ${{ gitea.server_url }}
    # GITEA_REPOSITORY 由 Gitea runtime 注入，供程式指定目標 repo
    GITEA_REPOSITORY: ${{ gitea.repository }}
    # 優先使用傳入的 RUNNER_TOKEN，否則退回 Gitea token secrets
    RUNNER_TOKEN: ${{ inputs.RUNNER_TOKEN || secrets.GITEA_TOKEN || secrets.RUNNER_TOKEN }}
    # KEEP_COUNT 直接沿用輸入值，交由程式驗證
    KEEP_COUNT: ${{ inputs.KEEP_COUNT }}