workflows: Add workflow for syncing module with upstream

Since some modules owned by the Zephyr organization are not created as a
Github fork maintaining them as a complete mirror requires manual
pushing. To fix this add a reusable workflow that can be configured for
each module to sync a specific branch in our version with upstream.
Also adds a sample usage of said workflow for the LVGL module.

Signed-off-by: Fabian Blatz <[email protected]>

Author: faxe1008

.github/workflows/sync_module/lvgl.yml

@@ -0,0 +1,18 @@
+name: Sync Upstream LVGL
+
+on:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  sync-lvgl:
+    uses: ./.github/workflows/sync-module/sync-module.yml
+    with:
+      module_name: "lvgl"
+      upstream_repository: "https://github.com/lvgl/lvgl"
+      upstream_branch: "master"
+      target_repository: "zephyrproject-rtos/lvgl"
+      target_branch: "master"
+    secrets:
+      PAT_TOKEN: ${{ secrets.ZB_REPO_SYNC_GITHUB_TOKEN }}

.github/workflows/sync_module/sync-module.yml

@@ -0,0 +1,59 @@
+name: Reusable Sync Upstream
+
+on:
+  workflow_call:
+    inputs:
+      module_name:
+        description: "Module name"
+        required: true
+        type: string
+      upstream_repository:
+        description: "Upstream repository URL"
+        required: true
+        type: string
+      upstream_branch:
+        description: "Upstream branch to sync from"
+        required: true
+        type: string
+      target_repository:
+        description: "Target repository URL"
+        required: true
+        type: string
+      target_branch:
+        description: "Target branch in the target repository"
+        required: true
+        type: string
+    secrets:
+      PAT_TOKEN:
+        description: "GitHub Personal Access Token"
+        required: true
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout target repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+        with:
+          repository: ${{ inputs.target_repository }}
+          ref: ${{ inputs.target_branch }}
+          token: ${{ secrets.PAT_TOKEN }}
+          path: repo-${{ inputs.module_name }}
+
+      - name: Configure Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Merge Upstream Changes (Fast-Forward)
+        working-directory: repo-${{ inputs.module_name }}
+        run: |
+          git remote add upstream ${{ inputs.upstream_repository }}
+          git fetch upstream ${{ inputs.upstream_branch }}
+          git merge --ff-only upstream/${{ inputs.upstream_branch }} || (echo "Merge conflict detected. Please resolve manually." && exit 1)
+
+      - name: Push Changes to Target Repository
+        working-directory: repo-${{ inputs.module_name }}
+        run: |
+          git push https://oauth2:${{ secrets.PAT_TOKEN }}@github.com/${{ inputs.target_repository }} HEAD:${{ inputs.target_branch }}