docs-sync.yml

name: Docs Sync

on:
  push:
    branches: [main]  # change to match your default branch
    paths-ignore:
      - "docs/**"
      - "**/*.md"
  pull_request:
    branches: [main]  # runs check (no writes) on PRs
    types: [opened, synchronize]
  workflow_dispatch:
    inputs:
      force:
        description: "Force recompile all docs"
        type: boolean
        default: false

permissions:
  contents: write
  pull-requests: write

concurrency:
  group: docs-sync
  cancel-in-progress: true

jobs:
  compile:
    name: Compile Docs
    runs-on: ubuntu-latest
    timeout-minutes: 10

    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: thevrus/wiki-forge@v1
        id: forge
        with:
          api_key: ${{ secrets.GEMINI_API_KEY }}
          force: ${{ inputs.force || 'false' }}

      - uses: peter-evans/create-pull-request@v7
        if: steps.forge.outputs.docs_changed == 'true'
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: docs/auto-sync
          delete-branch: true
          title: "docs: sync documentation with codebase changes"
          body: |
            ## Auto-compiled docs update

            **Updated:** ${{ steps.forge.outputs.updated_docs }}

            ${{ steps.forge.outputs.diff_summary }}

            > Auto-generated by [Wiki Forge](https://github.com/thevrus/wiki-forge)

            ### Review checklist
            - [ ] Changes accurately reflect the codebase
            - [ ] No sensitive information exposed
          commit-message: "docs: auto-sync documentation with codebase changes"
          labels: documentation,automated