bun.sh/.claude/commands/upgrade-webkit.md

Upgrade Bun's Webkit fork to the latest upstream version of Webkit.

To do that:

• cd vendor/WebKit
• git fetch upstream
• git merge upstream main
• Fix the merge conflicts
• cd ../../ (back to bun)
• make jsc-build (this will take about 7 minutes)
• While it compiles, in another task review the JSC commits between the last version of Webkit and the new version. Write up a summary of the webkit changes in a file called "webkit-changes.md"
• bun run build:local (build a build of Bun with the new Webkit, make sure it compiles)
• After making sure it compiles, run some code to make sure things work. something like ./build/debug-local/bun-debug --print '42' should be all you need
• cd vendor/WebKit
• git commit -am "Upgrade Webkit to the latest version"
• git push
• get the commit SHA in the vendor/WebKit directory of your new commit
• cd ../../ (back to bun)
• Update WEBKIT_VERSION in cmake/tools/SetupWebKit.cmake to the commit SHA of your new commit
• git checkout -b bun/webkit-upgrade-
• commit + push (without adding the webkit-changes.md file)
• create PR titled "Upgrade Webkit to the ", paste your webkit-changes.md into the PR description
• delete the webkit-changes.md file