docs(tailwindcss-patch): add github actions validate template

Author: sonofmagic

.changeset/dirty-queens-wave.md

@@ -0,0 +1,9 @@
+---
+"tailwindcss-patch": patch
+---
+
+Add a reusable GitHub Actions template for migration report validation.
+
+- add `packages/tailwindcss-patch/examples/github-actions/validate-migration-report.yml`
+- document how to map validate exit codes (`21/22/23/24`) in CI workflows
+- link the example template from README and migration notes

packages/tailwindcss-patch/MIGRATION.md

@@ -95,6 +95,7 @@ Migration mapping:
 - `tw-patch validate` can validate migration report compatibility in dry-run mode without restoring files.
 - `tw-patch validate` now uses dedicated failure exit codes for CI diagnostics (`21`/`22`/`23`/`24`).
 - `tw-patch validate --json` now emits a stable discriminated payload (`ok: true` success / `ok: false` failure with `reason` + `exitCode`), covered by `tailwindcss-patch/validate-result.schema.json`.
+- A ready-to-use GitHub Actions example is available at `packages/tailwindcss-patch/examples/github-actions/validate-migration-report.yml`.
 - Migration report tooling now has public exports from package entry (`migrateConfigFiles`, `restoreConfigFiles`, report constants/types) and published JSON schema subpaths: `tailwindcss-patch/migration-report.schema.json`, `tailwindcss-patch/restore-result.schema.json`, `tailwindcss-patch/validate-result.schema.json`.
 - Commands resolve configuration from `tailwindcss-patch.config.ts` via `@tailwindcss-mangle/config`. Existing configuration files continue to work without changes.
 

packages/tailwindcss-patch/README-cn.md

@@ -138,6 +138,8 @@ case "$status" in
 esac
 ```
 
+GitHub Actions 模板：`packages/tailwindcss-patch/examples/github-actions/validate-migration-report.yml`。
+
 ### `tokens` 常用参数
 
 | 参数                                   | 说明                                                        |

packages/tailwindcss-patch/README.md

@@ -195,6 +195,8 @@ case "$status" in
 esac
 ```
 
+GitHub Actions template: `packages/tailwindcss-patch/examples/github-actions/validate-migration-report.yml`.
+
 ### Token report options
 
 | Flag                                   | Description                                                                               |

packages/tailwindcss-patch/examples/github-actions/validate-migration-report.yml

@@ -0,0 +1,61 @@
+name: Validate Tailwind Patch Migration Report
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate-migration-report:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Ensure migration report is up-to-date
+        run: pnpm dlx tw-patch migrate --workspace --check --report-file .tw-patch/migrate-report.json
+
+      - name: Validate migration report
+        shell: bash
+        run: |
+          mkdir -p .tw-patch
+          set +e
+          pnpm dlx tw-patch validate --report-file .tw-patch/migrate-report.json --strict --json > .tw-patch/validate-result.json
+          status=$?
+          set -e
+
+          if [ "$status" -ne 0 ]; then
+            cat .tw-patch/validate-result.json
+          fi
+
+          case "$status" in
+            0)  echo "validate ok" ;;
+            21) echo "::error::Migration report schema/kind incompatible"; exit 1 ;;
+            22) echo "::error::Missing backups under --strict"; exit 1 ;;
+            23) echo "::error::I/O failure while reading report/backups"; exit 1 ;;
+            *)  echo "::error::Unknown validate failure (exit $status)"; exit "$status" ;;
+          esac
+
+      - name: Upload validate result
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: tw-patch-validate-result
+          path: .tw-patch/validate-result.json