name: Firmware build

# Сборка прошивок на своём Gitea-раннере (метка ubuntu-latest, см. ci/README.md).
#
# Запуск ТОЛЬКО вручную: Actions → Firmware build → Run workflow, либо через API
# (пример запроса — в ci/README.md). Автоматических сборок по push и тегам нет:
# прошивки собираются локально (ci/build-local.ps1) и публикуются релизом в Gitea.

on:
  workflow_dispatch:
    inputs:
      targets:
        description: 'env через запятую (пусто — набор по умолчанию)'
        required: false
        default: ''
      match:
        description: 'подстрока имени env, например heltec_t096'
        required: false
        default: ''
      version:
        description: 'FIRMWARE_VERSION (по умолчанию ci)'
        required: false
        default: ''

jobs:
  build:
    runs-on: ubuntu-latest
    timeout-minutes: 300
    steps:
      - name: Клонирование
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Кэш PlatformIO
        uses: actions/cache@v4
        continue-on-error: true   # сервер кэша может быть недоступен — сборку это ломать не должно
        with:
          path: |
            ~/.cache/pip
            ~/.platformio
            ~/.platformio-venv
          key: pio-${{ runner.os }}-v1
          restore-keys: |
            pio-${{ runner.os }}-

      - name: PlatformIO
        run: |
          # отдельное venv: на свежих Debian/Ubuntu pip в систему запрещён (PEP 668)
          python3 -m venv "$HOME/.platformio-venv"
          # venv из кэша может оказаться без pip (если на хосте не было python3-pip) — пересоздаём
          if ! "$HOME/.platformio-venv/bin/pip" --version >/dev/null 2>&1; then
            echo "venv без pip — пересоздаю"
            rm -rf "$HOME/.platformio-venv"
            python3 -m venv "$HOME/.platformio-venv"
          fi
          "$HOME/.platformio-venv/bin/pip" install --upgrade pip platformio
          echo "$HOME/.platformio-venv/bin" >> "$GITHUB_PATH"

      - name: Версия прошивки
        run: |
          VERSION="${{ github.event.inputs.version }}"
          [[ -z "$VERSION" ]] && VERSION="ci"
          echo "FIRMWARE_VERSION=$VERSION" >> "$GITHUB_ENV"
          echo "версия: $VERSION"

      - name: Сборка прошивок
        env:
          TARGETS: ${{ github.event.inputs.targets }}
          MATCH: ${{ github.event.inputs.match }}
        run: bash ci/build-firmwares.sh

      - name: Выгрузка артефактов
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: firmware
          path: out/
          if-no-files-found: warn