Upgrade the vendored LLVM submodule in ponyc across major versions.
npx skills add https://github.com/ponylang/ponyc --skill upgrade-llvm
Please help me install this Agent Skill. Skill: upgrade-llvm Source: https://github.com/ponylang/ponyc/tree/main/.claude/skills/upgrade-llvm Command: npx skills add https://github.com/ponylang/ponyc --skill upgrade-llvm
Upgrading the LLVM version vendored into the ponyc compiler is error-prone: the submodule is a shallow clone, patches may or may not have been upstreamed, LLVM APIs change or disappear between major versions, and some failures only surface when ponyc compiles a Pony program rather than at build time. This Skill provides the exact step-by-step procedure to perform the upgrade safely.
lib/llvm/patches/ with forward and reverse git apply checks, and update LLVM_DESIRED_HASH and PATCHES_DESIRED_HASH in lib/CMakeLists.txt.ci-core test label, and add a release note.Ask the AI to upgrade ponyc's vendored LLVM submodule from the current version to a specific newer LLVM release and follow the documented per-version procedure.
High-intent search queries and answers about installing and using this skill.
Upgrade one major version at a time: fetch the new llvmorg tag with --depth 1 in lib/llvm/src, update LLVM_DESIRED_HASH in lib/CMakeLists.txt, re-check each patch, commit the submodule pointer, rebuild LLVM and ponyc, then run ctest with the ci-core label.
Run git apply --check with the same flags the build uses; if the forward check fails, run the reverse check. Forward failing while reverse passes on a freshly reset tree means LLVM upstreamed the change, so delete the patch file.
LLVM can change an intrinsic's signature without breaking the C API, so ponyc compiles cleanly but emits invalid IR. The failure appears as a module verification error at Pony compile time, which is why running the ci-core tests is mandatory.
Removed LLVMConst* constant expression functions (replaced by LLVMBuild* equivalents), deprecated functions that fail the -Werror build, C++ API changes in DIBuilder and optimizer callbacks, and new link dependencies such as ntdll.lib on Windows.
The submodule is a shallow clone created with --depth 1 and no tags. A plain git fetch of a tag deepens it to full history; always pass --depth 1 when fetching the new llvmorg tag to keep the clone shallow.
The lib configure step prints both the actual and desired hashes when patch files change. Copy the actual hash into PATCHES_DESIRED_HASH in lib/CMakeLists.txt rather than trying to compute the SHA256 yourself.
ray-manalotoConfigures mise.toml, Ninja ccache, and CMake presets for C++ builds.
jeisenbackMerge base branch, run tests, bump versions, update CHANGELOG, commit, and create a PR.
web-infra-devContainerize CI environments to reproduce and debug local failures.
hw-native-sysBuild and validate the PTOAS compiler toolchain from source in WSL.