docs.yml

name: Docs

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  check:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    - name: Set up Python 3.12
      uses: actions/setup-python@v5
      with:
        python-version: "3.12"

    - name: Install uv
      uses: astral-sh/setup-uv@v5
      with:
        version: "0.6.10"
        cache: true

    - name: Install dependencies
      run: uv sync --frozen --all-extras --dev

    - name: Check generated tool documentation
      run: uv run python scripts/generate_tool_docs.py --check

    - name: Verify tool documentation diff
      run: |
        uv run python scripts/generate_tool_docs.py
        git diff --exit-code -- docs/tools/ docs/tools-reference.mdx