sync-docs.yml

name: Generate CLI Docs and PR to genlayer-docs

on:
  workflow_dispatch:
  release:
    types: [published]

jobs:
  generate-and-sync:
    # Skip for pre-releases (tags containing '-') unless manually dispatched
    if: github.event_name != 'release' || !contains(github.event.release.tag_name, '-')
    runs-on: ubuntu-latest
    environment: Sync-docs
    permissions:
      contents: read
    steps:
      - name: Checkout CLI repo
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Build
        run: npm run build

      - name: Determine version for docs
        id: version
        run: |
          if [ "${{ github.event_name }}" = "release" ]; then
            echo "value=${{ github.event.release.tag_name }}" >> $GITHUB_OUTPUT
          else
            # Prefer package.json version when not a release event
            echo "value=$(node -p 'require("./package.json").version')" >> $GITHUB_OUTPUT
          fi

      - name: Generate CLI docs (MDX)
        env:
          DOCS_CLEAN: 'true'
          DOCS_VERSION: ${{ steps.version.outputs.value }}
        run: node scripts/generate-cli-docs.mjs | cat

      - name: Generate docs repo token
        id: app-token
        uses: actions/create-github-app-token@v3
        with:
          client-id: ${{ vars.DOCS_SYNC_APP_CLIENT_ID }}
          private-key: ${{ secrets.DOCS_SYNC_APP_KEY }}
          repositories: genlayer-docs

      - name: Checkout docs repo
        uses: actions/checkout@v4
        with:
          repository: genlayerlabs/genlayer-docs
          token: ${{ steps.app-token.outputs.token }}
          path: docs-repo
          fetch-depth: 0

      - name: Sync and push docs
        working-directory: docs-repo
        run: |
          set -euo pipefail
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          rm -rf pages/api-references/genlayer-cli
          mkdir -p pages/api-references/genlayer-cli
          rsync -a "${{ github.workspace }}/docs/api-references/" pages/api-references/genlayer-cli/
          # Copy README as sibling file (strip badges/emojis)
          sed -E '/^\[!\[.*\]\(https:\/\/(img\.shields\.io|dcbadge|badge\.fury)/d' "${{ github.workspace }}/README.md" > pages/api-references/genlayer-cli.mdx
          if [ -z "$(git status --porcelain)" ]; then
            echo "No changes to commit"
            exit 0
          fi
          git add pages/api-references/genlayer-cli pages/api-references/genlayer-cli.mdx
          git commit -m "docs(cli): sync API reference ${{ steps.version.outputs.value }}"
          git push