pages.yml

name: Deploy to GitHub Pages

on:
  # Run on push to main branch
  push:
    branches: [ main ]
  # Allow manual trigger
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN
permissions:
  contents: write
  pages: write
  id-token: write

# Allow only one concurrent deployment
concurrency:
  group: pages
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Need full history for git log in gather_links.py

      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Install dependencies
        run: |
          python -m pip install markdown llm llm-anthropic>=0.20

      - name: Build site
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GENERATE_LLM_DOCS: "1"
        run: sh build.sh

      - name: Find modified docs stems
        id: docs
        run: |
          # Ensure newly created files are visible to git diff
          git add '*.docs.md'
          # Identify modified files
          MODIFIED_FILES=$(git diff --name-only HEAD -- '*.docs.md')
          if [ -z "$MODIFIED_FILES" ]; then
            echo "stems=" >> $GITHUB_OUTPUT
          else
            STEMS=$(echo "$MODIFIED_FILES" \
              | sed 's/\.docs\.md$//' \
              | paste -sd ', ' -)
            echo "stems=$STEMS" >> $GITHUB_OUTPUT
          fi

      - name: Commit and push if docs have changed
        if: steps.docs.outputs.stems != ''
        run: |-
          git config user.name "Automated"
          git config user.email "actions@users.noreply.github.com"
          git add *.docs.md
          git commit -m "Generated docs: ${{ steps.docs.outputs.stems }}" || exit 0
          git push

      - name: Setup Pages
        uses: actions/configure-pages@v4

      - name: Build with Jekyll
        uses: actions/jekyll-build-pages@v1

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3

  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4