version: "1.0.1" name: upgrade-unchained description: Guides upgrading Unchained Engine to a new major version. Use when the user wants to upgrade their Unchained project, mentions updating @unchainedshop packages, or asks about migration.

Upgrade Unchained Engine

Instructions

1. Enter planning mode to create an upgrade plan
2. Get available versions with npm view @unchainedshop/platform versions --json
3. Show the user which versions they can upgrade to
4. Once a target version is selected (e.g., 4.5.0), fetch these resources:

• Migration guide: https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/MIGRATION.md
• Changelog: https://raw.githubusercontent.com/unchainedshop/unchained/refs/tags/v{version}/CHANGELOG.md
• README: https://raw.githubusercontent.com/unchainedshop/unchained/refs/heads/master/README.md

1. Execute the upgrade by:

• Updating npm dependencies
• Removing deprecated dependencies
• Running lint, tests, and build
• Starting the project to verify

Reference Examples

Fetch example boot files for the target version to understand current patterns:

Additional Resources

• Documentation: https://docs.unchained.shop