fix(grpc): Restore critical null connection fix and apply race condition fixes after v5.0.0 upstream merge + comprehensive fork documentation

.github/workflows/dart.yml

@@ -1,42 +1,38 @@
 name: Dart
 
 on:
-  # Run CI on pushes to the master branch, and on PRs against master.
+  # Run CI on pushes to main and on PRs against main.
   push:
     branches: [main]
   pull_request:
     branches: [main]
   workflow_dispatch:
 
+# Cancel in-progress runs when new commits are pushed
+concurrency:
+  group: dart-ci-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   # Check code formatting and static analysis on a single OS (linux)
   # against Dart dev.
   analyze:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        sdk: [3.5, dev]
+        sdk: [stable, dev]
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: ${{ matrix.sdk }}
       - name: Report version
         run: dart --version
       - name: Install dependencies
         run: dart pub get
       - name: Check formatting (using dev dartfmt release)
-        if: ${{ matrix.sdk == 'dev' }}
+        if: ${{ matrix.sdk == 'stable' }}
         run: dart format --output=none --set-exit-if-changed .
-      - name: Analyze code (introp and examples)
-        run: |
-          for example in interop example/*/; do
-            pushd $example
-            echo [Getting dependencies in $example]
-            dart pub get
-            popd
-          done
-        shell: bash
       - name: Analyze code
         run: dart analyze --fatal-infos .
       - name: Check that grpc-web sample builds with DDC
@@ -59,7 +55,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        sdk: [3.5, dev]
+        sdk: [stable, dev]
         platform: [vm, chrome]
         exclude:
           # We only run Chrome tests on Linux. No need to run them
@@ -70,7 +66,7 @@ jobs:
             platform: chrome
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: ${{ matrix.sdk }}
       - name: Report version

.github/workflows/enhance-release-pr.yml

@@ -0,0 +1,270 @@
+name: Enhance Release PR
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - main
+
+# Cancel in-progress runs when a new commit is pushed to the same PR
+concurrency:
+  group: enhance-release-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+  id-token: write
+
+jobs:
+  enhance-release-pr:
+    name: 🤖 Claude AI Enhancement
+    if: startsWith(github.head_ref, 'release-please--')
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📥 Checkout PR Branch
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 🏷️ Extract Version from PR Title
+        id: version
+        run: |
+          VERSION=$(echo "${{ github.event.pull_request.title }}" | grep -oP '\d+\.\d+\.\d+' || echo "")
+          if [ -z "$VERSION" ]; then
+            echo "⚠️ Could not extract version from PR title"
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "version=$VERSION" >> $GITHUB_OUTPUT
+            echo "skip=false" >> $GITHUB_OUTPUT
+            echo "📦 Detected version: $VERSION"
+          fi
+
+      - name: ⬅️ Get Previous Version
+        id: prev_version
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          PREV=$(cat .release-please-manifest.json | grep -oP '"\.: "\K[^"]+' || echo "0.0.0")
+          echo "prev_version=$PREV" >> $GITHUB_OUTPUT
+          echo "📦 Previous version: $PREV"
+
+      - name: ✅ Check if Already Enhanced
+        id: check
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          if grep -q "### 🚀 Release Highlights" CHANGELOG.md; then
+            VERSION_LINE=$(grep -n "## \[${{ steps.version.outputs.version }}\]" CHANGELOG.md | head -1 | cut -d: -f1 || echo "0")
+            HIGHLIGHTS_LINE=$(grep -n "### 🚀 Release Highlights" CHANGELOG.md | head -1 | cut -d: -f1 || echo "99999")
+
+            if [ "$VERSION_LINE" != "0" ] && [ "$HIGHLIGHTS_LINE" -gt "$VERSION_LINE" ]; then
+              NEXT_VERSION=$(grep -n "## \[" CHANGELOG.md | grep -v "^$VERSION_LINE:" | head -1 | cut -d: -f1 || echo "99999")
+              if [ "$HIGHLIGHTS_LINE" -lt "${NEXT_VERSION:-99999}" ]; then
+                echo "✅ Already enhanced"
+                echo "already_enhanced=true" >> $GITHUB_OUTPUT
+                exit 0
+              fi
+            fi
+          fi
+          echo "already_enhanced=false" >> $GITHUB_OUTPUT
+
+      - name: 🤖 Full Release Enhancement with Claude
+        if: steps.version.outputs.skip != 'true' && steps.check.outputs.already_enhanced != 'true'
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY_GLOBAL_CLOUD_RUNTIME }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PROPOSED_VERSION: ${{ steps.version.outputs.version }}
+            PREVIOUS_VERSION: ${{ steps.prev_version.outputs.prev_version }}
+            PR_BRANCH: ${{ github.head_ref }}
+            PR_NUMBER: ${{ github.event.pull_request.number }}
+
+            # 🤖 CLAUDE CODE: RELEASE MANAGER FOR open-runtime/grpc-dart
+
+            ## Project Context
+
+            This is a **FORK** of grpc/grpc-dart with critical production enhancements:
+            - **Race condition fixes** - Prevents "Cannot add event after closing" crashes
+            - **Null connection fix** - Actionable errors instead of null pointer exceptions
+            - **ServerInterceptor support** - Powers the AOT security architecture
+
+            Key files: `lib/src/server/handler.dart`, `lib/src/client/http2_connection.dart`
+
+            Release Please has proposed version **${{ steps.version.outputs.version }}** (from ${{ steps.prev_version.outputs.prev_version }}).
+
+            ---
+
+            ## 🎯 YOUR MISSION: Complete Pre-Release Enhancement
+
+            Execute these tasks IN ORDER:
+
+            ---
+
+            ## TASK 0: 🔢 VERSION REVIEW (CRITICAL - DO THIS FIRST!)
+
+            ```bash
+            git log v${{ steps.prev_version.outputs.prev_version }}..HEAD --oneline
+            ```
+
+            **Version Rules:**
+            | Change Type | Version | Examples |
+            |-------------|---------|----------|
+            | **MAJOR** | X.0.0 | Removing public API, breaking protocol changes |
+            | **MINOR** | x.Y.0 | New features, upstream merge with new capabilities |
+            | **PATCH** | x.y.Z | Bug fixes, docs, CI, race condition fixes |
+
+            **⚠️ BREAKING CHANGE Rules (IMPORTANT!):**
+
+            Only use MAJOR bump for **actual API breaking changes**:
+            - ✅ Removing or renaming public classes/methods
+            - ✅ Changing method signatures
+            - ✅ Protocol incompatibilities
+
+            **NEVER** MAJOR for:
+            - ❌ Workflow/CI changes
+            - ❌ Documentation updates
+            - ❌ Internal refactoring
+            - ❌ Adding new features (that's MINOR)
+
+            **If version is wrong** (e.g., 6.0.0 for docs changes):
+            1. Update `.release-please-manifest.json` to correct version
+            2. Update `pubspec.yaml` version field
+            3. Update CHANGELOG.md version header
+            4. Commit: `fix: Adjust version to X.Y.Z (from proposed A.B.C)`
+
+            ---
+
+            ## TASK 1: 📝 ADD RELEASE HIGHLIGHTS
+
+            Insert after version header in CHANGELOG.md:
+
+            ```markdown
+            ### 🚀 Release Highlights
+
+            [2-4 sentences about DEVELOPER IMPACT, not implementation details]
+            ```
+
+            **✅ GOOD Example:**
+            ```markdown
+            ### 🚀 Release Highlights
+
+            This release adds automated release management with AI-enhanced notes, making version
+            tracking effortless. The fork's critical race condition fixes remain fully intact,
+            ensuring production stability for high-concurrency gRPC servers.
+            ```
+
+            **❌ BAD Example:**
+            ```markdown
+            ### 🚀 Release Highlights
+
+            Various improvements and bug fixes. Updated CI workflows and some internal changes.
+            Please update when convenient.
+            ```
+
+            Commit: `docs: Add AI-enhanced release highlights for v${{ steps.version.outputs.version }}`
+
+            ---
+
+            ## TASK 2: 📚 DOCUMENTATION SYNC
+
+            Check if these need updates:
+            - `README.md` - Installation instructions, version references
+            - `WHY_USE_OPEN_RUNTIME_FORK.md` - If fork-specific features changed
+            - `FORK_CHANGES.md` - If new fixes were added
+            - `CLAUDE.md` - If conventions changed
+
+            **Only update if genuinely needed.** Don't change for the sake of it.
+
+            ---
+
+            ## TASK 3: 🏷️ ISSUE MANAGEMENT
+
+            ```bash
+            gh issue list --repo ${{ github.repository }} --state open --limit 50
+            ```
+
+            **When to CLOSE an issue:**
+            - Commit explicitly says "Fixes #X" or "Closes #X"
+            - You can verify the fix by reading code changes
+            - Issue description matches what was changed
+
+            **When NOT to close:**
+            - Partially addressed (comment with progress instead)
+            - Not 100% certain it's fixed
+            - Feature request needing user verification
+
+            **Closing comment format:**
+            ```
+            🎉 This issue has been addressed in v${{ steps.version.outputs.version }}!
+            The fix will be available once the release PR merges.
+            ```
+
+            ---
+
+            ## TASK 4: 💬 POST PR SUMMARY
+
+            ```bash
+            gh pr comment ${{ github.event.pull_request.number }} --body "## 🚀 Release v[VERSION] Ready!
+
+            ### Version Review:
+            - **Proposed:** ${{ steps.version.outputs.version }}
+            - **Final:** [ACTUAL_VERSION] ✅
+            - **Reason:** [Why this version is correct]
+
+            ### What Claude Did:
+            - [x] Reviewed version appropriateness
+            - [x] Added Release Highlights to CHANGELOG.md
+            - [x] Reviewed documentation (updates: yes/no)
+            - [x] Processed related issues (N found)
+
+            ### Fork-Specific Notes:
+            [Notes about upstream compatibility, critical fixes preserved, etc.]
+
+            ### Installation (after merge):
+            \\\`\\\`\\\`yaml
+            dependencies:
+              grpc:
+                git:
+                  url: https://github.com/open-runtime/grpc-dart
+                  tag_pattern: \"^v\"
+                version: ^[VERSION]
+            \\\`\\\`\\\`
+
+            **Ready to merge!** 🎉
+
+            ---
+            *🤖 Generated by Claude Code Action*"
+            ```
+
+            ---
+
+            ## EXECUTION RULES
+
+            1. **Git Setup First:**
+               ```bash
+               git config user.name "github-actions[bot]"
+               git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+               ```
+
+            2. **Commit Each Change Separately** with conventional commit messages
+
+            3. **Push All Changes:**
+               ```bash
+               git push origin ${{ github.head_ref }}
+               ```
+
+            4. **Be Conservative** - this is a critical infrastructure package
+
+            Now execute all tasks in order!
+          claude_args: |
+            --allowedTools "Read,Edit,Bash(git:*),Bash(gh:*),Bash(cat:*),Bash(head:*),Bash(grep:*)"
+
+      - name: ℹ️ Already Enhanced Notice
+        if: steps.check.outputs.already_enhanced == 'true'
+        run: |
+          echo "ℹ️ Release PR already enhanced - skipping"
+

.github/workflows/health.yaml

@@ -1,13 +1,14 @@
 name: Health
+
 on:
   pull_request:
     branches: [ master ]
     types: [opened, synchronize, reopened, labeled, unlabeled]
+
 jobs:
   health:
     uses: dart-lang/ecosystem/.github/workflows/health.yaml@main
     with:
-      checks: "changelog,do-not-submit,breaking,coverage,leaking"
-      ignore_coverage: "example/**,interop/**"
+      checks: "changelog,do-not-submit,breaking,leaking"
     permissions:
       pull-requests: write

.github/workflows/post_summaries.yaml

@@ -1,8 +1,9 @@
 name: Comment on the pull request
 
 on:
-  # Trigger this workflow after the Health workflow completes. This workflow will have permissions to
-  # do things like create comments on the PR, even if the original workflow couldn't.
+  # Trigger this workflow after the given workflows completes.
+  # This workflow will have permissions to do things like create comments on the
+  # PR, even if the original workflow couldn't.
   workflow_run:
     workflows:
       - Health
@@ -14,4 +15,4 @@ jobs:
   upload:
     uses: dart-lang/ecosystem/.github/workflows/post_summaries.yaml@main
     permissions:
-      pull-requests: write
+      pull-requests: write