ci: optimize Python validation

.github/workflows/ci.yml

@@ -9,7 +9,73 @@ on:
       - main
 
 jobs:
+  changes:
+    runs-on: ubuntu-latest
+    outputs:
+      python: ${{ steps.classify.outputs.python }}
+      typescript: ${{ steps.classify.outputs.typescript }}
+      markdown: ${{ steps.classify.outputs.markdown }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Classify changed files
+        id: classify
+        env:
+          BASE_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}
+          HEAD_SHA: ${{ github.sha }}
+        run: |
+          set -euo pipefail
+
+          if [[ "${BASE_SHA:-}" =~ ^0+$ ]]; then
+            changed_files="$(git show --format= --name-only "${HEAD_SHA}")"
+          else
+            changed_files="$(git diff --name-only "${BASE_SHA}" "${HEAD_SHA}")"
+          fi
+
+          run_python=false
+          run_typescript=false
+          run_markdown=false
+          run_all=false
+
+          while IFS= read -r path; do
+            [[ -z "${path}" ]] && continue
+            case "${path}" in
+              .github/workflows/*|.github/actions/*|.pre-commit-config.yaml)
+                run_all=true
+                ;;
+              .markdownlint-cli2.jsonc|*.md)
+                run_markdown=true
+                ;;
+              python/*|context_compiler_example_integrations/*|pyproject.toml|uv.lock|scripts/validate_python.sh)
+                run_python=true
+                ;;
+              typescript/*|scripts/validate_typescript.sh|scripts/validate_typescript_fast.sh)
+                run_typescript=true
+                ;;
+              *)
+                run_all=true
+                ;;
+            esac
+          done <<< "${changed_files}"
+
+          if [[ "${run_all}" == true ]]; then
+            run_python=true
+            run_typescript=true
+            run_markdown=true
+          fi
+
+          {
+            echo "python=${run_python}"
+            echo "typescript=${run_typescript}"
+            echo "markdown=${run_markdown}"
+          } >> "${GITHUB_OUTPUT}"
+
   markdownlint:
+    needs: changes
+    if: needs.changes.outputs.markdown == 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
@@ -23,7 +89,40 @@ jobs:
       - name: Run Markdown lint
         run: npx --yes markdownlint-cli2
 
+  python-quality:
+    needs: changes
+    if: needs.changes.outputs.python == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Sync Python dependencies
+        run: uv sync --locked --group dev --no-editable
+
+      - name: Run Ruff check
+        run: uv run --no-sync ruff check
+
+      - name: Run Ruff format check
+        run: uv run --no-sync ruff format --check
+
+      - name: Run mypy
+        run: uv run --no-sync mypy
+
   python-validation:
+    needs: changes
+    if: needs.changes.outputs.python == 'true'
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -34,19 +133,24 @@ jobs:
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Sync Python dependencies
-        run: uv sync --group dev --no-editable
+        run: uv sync --locked --group dev --no-editable
 
-      - name: Run Python validation
-        run: ./scripts/validate_python.sh
+      - name: Run Python tests
+        run: uv run --no-sync pytest python/tests
 
   typescript-validation:
+    needs: changes
+    if: needs.changes.outputs.typescript == 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository