Merge branch 'main' into chore/sync-affinity-docs

Author: yaniv-golan

.github/workflows/check-docs-updates.yml

@@ -8,6 +8,7 @@ on:
 permissions:
   contents: write
   pull-requests: write
+  actions: write
 
 jobs:
   sync-docs:
@@ -43,6 +44,23 @@ jobs:
             echo "changes=false" >> "$GITHUB_OUTPUT"
           fi
 
+      - name: Trigger Tests and Pre-commit workflows
+        if: steps.sync_docs.outputs.changes == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          BRANCH: chore/sync-affinity-docs
+        run: |
+          set -euo pipefail
+          for workflow in tests.yml pre-commit.yml; do
+            curl -X POST \
+              -H "Accept: application/vnd.github+json" \
+              -H "Authorization: Bearer $GITHUB_TOKEN" \
+              -H "X-GitHub-Api-Version: 2022-11-28" \
+              "https://api.github.com/repos/$REPO/actions/workflows/$workflow/dispatches" \
+              -d "{\"ref\":\"$BRANCH\"}"
+          done
+
       - name: Create pull request
         if: steps.sync_docs.outputs.changes == 'true'
         uses: peter-evans/create-pull-request@v6

REPOSITORY_STRUCTURE.md

@@ -11,6 +11,7 @@ This document explains the repository structure and why files are organized this
   - `workflows/` - Actions definitions (`check-docs-updates.yml`, `tests.yml`, `pre-commit.yml`)
   - `scripts/validate_docs_structure.py` - Lightweight CI validation helper
   - `docs-version-*.json` - Metadata files used by historic workflows
+  - **CI note**: `check-docs-updates.yml` auto-creates the `chore/sync-affinity-docs` branch/PR and then explicitly triggers `tests.yml` and `pre-commit.yml` via `workflow_dispatch` so that required checks run even though the PR is opened by a workflow.
 
 **Why here?**: Keeps automation-specific assets scoped to GitHub configuration.