| 1 | # Generated Migration Reference |
| 2 | |
| 3 | `migration/v3-to-v4.md` is generated. Check annotations and regenerate using |
| 4 | explicit committed refs containing the change: |
| 5 | |
| 6 | ```sh |
| 7 | pnpm api-diff --base-ref origin/v3 --head-ref HEAD --check |
| 8 | pnpm api-diff --base-ref origin/v3 --head-ref HEAD --write-doc migration/v3-to-v4.md |
| 9 | ``` |
| 10 | |
| 11 | The API diff reads refs through detached worktrees. If the API change is |
| 12 | uncommitted, `HEAD` does not contain it. Update known annotation IDs, defer the |
| 13 | check and regeneration, and report the limitation. Do not create a temporary |
| 14 | commit solely to run the tool. |