name: Gitea Version Tracker

on:
  schedule:
    - cron: '0 8 * * *'
  workflow_dispatch:
    inputs:
      version:
        description: 'Stable Gitea version (e.g. 28.2.0); empty means latest'
        required: false

jobs:
  track:
    name: Track Gitea Release
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Test tracker
        run: python -B -m unittest discover -s .github/scripts -p 'test_*.py'

      - name: Record pending Gitea release
        id: version
        run: python -B .github/scripts/track_gitea_release.py
        env:
          GITEA_VERSION: ${{ github.event.inputs.version }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Create Pull Request
        if: steps.version.outputs.changed == 'true'
        uses: peter-evans/create-pull-request@v7
        with:
          add-paths: '*.md'
          branch: track/gitea-${{ steps.version.outputs.version }}
          commit-message: "docs: track Gitea ${{ steps.version.outputs.version }} pending verification"
          title: "Track Gitea ${{ steps.version.outputs.version }} compatibility"
          body: |
            Gitea **${{ steps.version.outputs.version }}** is recorded as [PENDING] across the marked documentation. Verified/tested ranges remain unchanged.

            - [ ] Review upstream mail templates, mailer data, functions, and translation keys.
            - [ ] Run `cd tools && go test ./...` and `go run . preview all`.
            - [ ] Record findings in `COMPATIBILITY.md`; update tested ranges and status text only after verification.
            - [ ] If template changes are needed, release them separately with reviewed notes and assets.