Add Azure/typespec-azure integration check to PR CI workflow

.github/workflows/README.md

@@ -0,0 +1,37 @@
+# TypeSpec Workflows
+
+This directory contains the GitHub workflows used for TypeSpec repository CI/CD processes.
+
+## Available Workflows
+
+| Workflow | Description |
+|----------|-------------|
+| `consistency.yml` | Ensures code consistency, including changelog, spellcheck, formatting, and linting |
+| `codeql.yml` | Runs CodeQL analysis for code security |
+| `typespec-azure-integration-check.yml` | Optional CI check that verifies compatibility with Azure/typespec-azure repository |
+
+## TypeSpec-Azure Integration Check
+
+The `typespec-azure-integration-check.yml` workflow verifies that changes in the TypeSpec repository do not break compatibility with the Azure/typespec-azure repository, which depends on TypeSpec as a core dependency.
+
+### How It Works
+
+1. Clones the Azure/typespec-azure repository
+2. Finds the "core" submodule that references microsoft/typespec
+3. Updates that submodule to use the changes from the current PR
+4. Runs the build and tests for the Azure/typespec-azure repository
+
+### When It Runs
+
+This check runs on:
+- Pull requests to the main branch
+- Manual triggers via workflow_dispatch
+
+### What It Checks
+
+- Whether the Azure/typespec-azure repository can build successfully with the changes from the PR
+- Whether all tests in the Azure/typespec-azure repository pass with the changes
+
+### Configuration
+
+This is an optional check that won't block PRs from being merged. It only runs on Linux with Node LTS (20.x) to minimize resource usage while still catching compatibility issues.

.github/workflows/typespec-azure-integration-check.yml

@@ -0,0 +1,74 @@
+name: Azure TypeSpec Integration Check
+
+on:
+  pull_request:
+    branches: ["main"]
+    paths-ignore:
+      - 'packages/http-client-csharp/**'
+      - 'packages/http-client-java/**'
+      - 'packages/http-client-python/**'
+      - 'website/**'
+  # Allow manual triggering
+  workflow_dispatch:
+    inputs:
+      run:
+        description: 'Run this workflow'
+        required: false
+        default: 'true'
+
+# This check is optional by default
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  azure-integration-check:
+    name: Check Azure/typespec-azure compatibility
+    runs-on: ubuntu-latest
+    # Only run if not from dependabot, publish, backmerge, or revert branches
+    if: |
+      !startsWith(github.head_ref, 'dependabot/') &&
+      !startsWith(github.head_ref, 'publish/') &&
+      !startsWith(github.head_ref, 'backmerge/') &&
+      !startsWith(github.head_ref, 'revert-')
+
+    steps:
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24.x # Using current LTS
+
+      - name: Checkout Azure/typespec-azure repo
+        uses: actions/checkout@v4
+        with:
+          repository: Azure/typespec-azure
+          submodules: true
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+
+      - name: Update core submodule to PR changes
+        run: |
+          # Core submodule is located at ./core
+          echo "Updating core submodule to PR changes"
+
+          # Point the submodule to our PR changes
+          git config -f .gitmodules submodule.core.url "$GITHUB_WORKSPACE"
+
+          # Navigate to the core submodule directory
+          cd core
+
+          # Use the PR changes
+          git checkout ${{ github.event.pull_request.head.sha }}
+
+      - name: Install
+        run: |
+          pnpm install
+
+      - name: Build
+        run: |
+          pnpm build
+
+      - name: Test
+        run: |
+          pnpm test