ci: Add automated CLI documentation sync workflow

This adds a GitHub Actions workflow and supporting script to
automatically sync CLI documentation from the docker/cli repository on a
daily schedule.

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>

Author: vvoland

.github/workflows/sync-cli-docs.yml

@@ -0,0 +1,68 @@
+name: sync-cli-docs
+
+on:
+  schedule:
+    # Run daily at 02:00 UTC
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync-cli-docs:
+    runs-on: ubuntu-24.04
+    steps:
+      -
+        name: Checkout docs repo
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      -
+        name: Checkout docker/cli repo
+        uses: actions/checkout@v5
+        with:
+          repository: docker/cli
+          path: cli-source
+          fetch-depth: 0
+      -
+        name: Add upstream remote for docker/cli
+        run: |
+          cd cli-source
+          git remote add upstream https://github.com/docker/cli.git
+          git fetch upstream
+      -
+        name: Create update branch
+        id: create-branch
+        run: |
+          BRANCH_NAME="bot/sync-cli-docs-$(date +%Y%m%d-%H%M%S)"
+          git checkout -b "$BRANCH_NAME"
+          echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT
+      -
+        name: Run sync script
+        id: sync
+        run: |
+          if ./hack/sync-cli-docs.sh cli-source origin/master; then
+              echo "changes=true" >> $GITHUB_OUTPUT
+              echo "Changes detected - syncing CLI docs" >> "$GITHUB_STEP_SUMMARY"
+          else
+            echo "changes=false" >> $GITHUB_OUTPUT
+            echo "No changes to sync - CLI docs are up to date" >> "$GITHUB_STEP_SUMMARY"
+          fi
+      -
+        name: Create Pull Request
+        if: steps.sync.outputs.changes == 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_BODY: |
+            ## Summary
+
+            Automated sync of CLI documentation from docker/cli repository.
+        run: |
+          git push origin "${{ steps.create-branch.outputs.branch_name }}"
+          gh pr create \
+            --title "cli: sync docs with docker/cli" \
+            --body "$PR_BODY" \
+            --base main \
+            --head "${{ steps.create-branch.outputs.branch_name }}"

hack/sync-cli-docs.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+set -euo pipefail
+
+
+main() {
+    local cli_source="${1:-$HOME/src/cli}"
+    local branch_name="${2:-upstream/master}"
+    local worktree_dir="./internal-update-cli-docs"
+
+    (
+        GIT_DIR="$cli_source/.git"
+        GIT_DIR="$GIT_DIR" git fetch upstream
+        GIT_DIR="$GIT_DIR" git worktree add "$worktree_dir" "$branch_name"
+    ) || return $?
+    trap "GIT_DIR=\"$cli_source/.git\" git worktree remove \"$worktree_dir\" --force" EXIT
+
+    (cd "$worktree_dir"; make -f docker.Makefile yamldocs) || return $?
+    cp "$worktree_dir"/docs/yaml/*.yaml ./data/engine-cli/
+
+    if git diff --quiet "./data/engine-cli/*.yaml"; then
+        printf "\e[32m✅ Already up to date\e[0m\n"
+        return 1
+    fi
+
+    echo -e "ℹ️ Changes detected:"
+    git diff --stat "./data/engine-cli/*.yaml" || true
+
+    NICE_GIT_REF=$(cd "$worktree_dir" && git describe --always --dirty) || return $?
+
+    git add "./data/engine-cli/*.yaml"
+    git commit -s -S -m "cli: sync docs with docker/cli $NICE_GIT_REF"
+    
+    printf "\e[32m✅ Committed changes\e[0m\n"
+    return 0
+}
+
+main "$@"