name: External Link Checker

on:
  schedule:
    # Runs at 00:00 UTC every day
    - cron: "0 13 * * *"
  workflow_dispatch: # Allow manual runs
  pull_request:
    paths:
      - ".github/workflows/link-checker.yml"

concurrency:
  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.ref }}
  cancel-in-progress: true

defaults:
  run:
    shell: bash
    working-directory: docs

permissions: {}

jobs:
  check-external-links:
    # Only run on the main repository
    if: github.repository == 'mlflow/mlflow'
    permissions:
      contents: read
    timeout-minutes: 30
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
        with:
          persist-credentials: false
      - uses: ./.github/actions/setup-node
      - name: Install dependencies
        run: |
          npm ci
      - name: Run external links checker
        run: |
          npm run check-links