update-docs.yml

name: Update reference docs

on:
  pull_request:
    paths:
      - "src/parxy_cli/commands/**"
      - "src/parxy_cli/cli.py"
      - "src/parxy_core/models/config.py"
      - "scripts/generate_docs.py"

jobs:
  update-docs:
    name: Regenerate reference docs
    runs-on: ubuntu-latest
    permissions:
      contents: write

    steps:
      - uses: actions/checkout@v6
        with:
          ref: ${{ github.head_ref }}

      - name: Install uv
        uses: astral-sh/setup-uv@v8.1.0
        with:
          enable-cache: true
          python-version: 3.13

      - name: Install dependencies
        run: uv sync --frozen

      - name: Generate reference docs
        run: uv run python scripts/generate_docs.py

      - name: Commit if changed
        uses: stefanzweifel/git-auto-commit-action@v7.1.0
        with:
          commit_message: "docs: sync CLI and configuration reference"
          file_pattern: "docs/reference/*.md"