SnapOtter/.github/workflows/ai-docs-updater.yml

name: AI Documentation Updater

on:
  push:
    branches:
      - main
    paths:
      - 'apps/api/**'
      - 'apps/web/**'
      - 'packages/**'

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

    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 2 # Fetch previous commit to get diff

      - name: Setup pnpm
        uses: pnpm/action-setup@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: pnpm

      - name: Install dependencies
        run: pnpm install

      - name: Generate Diff
        run: git diff HEAD^ HEAD > diff.patch

      - name: Run Real AI Agent
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          echo "Running Claude to analyze changes and update docs..."
          cd apps/docs && pnpm exec tsx scripts/update-docs.ts ../../diff.patch
          
      - name: Commit and Push Changes
        run: |
          git config --global user.name "github-actions[bot]"
          git config --global user.email "github-actions[bot]@users.noreply.github.com"
          git add apps/docs/
          if ! git diff-index --quiet HEAD; then
            git commit -m "docs: auto-updated by AI 🤖"
            git push
          else
            echo "No documentation changes needed."
          fi