bootspring_upgrade
Check for updates and manage Bootspring versions.
Overview#
The bootspring_upgrade tool helps you stay up-to-date with the latest Bootspring releases. Check for updates, view changelogs, and manage version upgrades.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Action: check, changelog, info |
version | string | No | Specific version to query |
options | object | No | Additional options |
Actions#
| Action | Description |
|---|---|
check | Check for available updates |
changelog | View version changelog |
info | Get version information |
Options Object#
| Option | Type | Default | Description |
|---|---|---|---|
includePrerelease | boolean | false | Include pre-release versions |
detailed | boolean | false | Include detailed release notes |
Usage Examples#
Check for Updates#
Use the bootspring_upgrade tool with:
- action: "check"
Response:
Loading code block...
No Update Available#
Use the bootspring_upgrade tool with:
- action: "check"
Response:
Loading code block...
View Changelog#
Use the bootspring_upgrade tool with:
- action: "changelog"
- version: "1.2.0"
Response:
Loading code block...
Version Information#
Use the bootspring_upgrade tool with:
- action: "info"
Response:
Loading code block...
Include Prereleases#
Use the bootspring_upgrade tool with:
- action: "check"
- options: { includePrerelease: true }
Response:
Loading code block...
Response Format#
Success Response#
Loading code block...
Error Response#
Loading code block...
Version Numbering#
Bootspring follows semantic versioning:
| Format | Description | Example |
|---|---|---|
| MAJOR.MINOR.PATCH | Stable release | 1.2.0 |
| MAJOR.MINOR.PATCH-beta.N | Beta release | 1.3.0-beta.1 |
| MAJOR.MINOR.PATCH-alpha.N | Alpha release | 2.0.0-alpha.1 |
When to Upgrade#
| Type | Contains | Upgrade Strategy |
|---|---|---|
| Patch (x.x.1) | Bug fixes | Safe, upgrade immediately |
| Minor (x.1.x) | New features | Review changelog, upgrade soon |
| Major (1.x.x) | Breaking changes | Read migration guide, plan upgrade |
CLI Integration#
Manage upgrades from the command line:
Loading code block...
Upgrade Process#
Standard Upgrade#
Loading code block...
Major Version Upgrade#
Loading code block...
Notifications#
Automatic Checks#
Bootspring checks for updates periodically and shows notifications:
┌────────────────────────────────────────┐
│ Bootspring update available: 1.2.0 │
│ Run: npm update @girardmedia/bootspring│
└────────────────────────────────────────┘
Disable Notifications#
To disable update notifications:
Loading code block...
Security Updates#
Security updates are flagged in the check response:
Loading code block...
Troubleshooting#
Update Check Fails#
If update checks fail:
- Check network connectivity
- Verify npm registry access
- Try:
npm ping
Upgrade Issues#
If upgrade causes issues:
- Check the changelog for breaking changes
- Run
bootspring doctorto diagnose - Roll back if needed:
npm install @girardmedia/bootspring@previous-version
Version Conflicts#
If you have version conflicts:
Loading code block...
Related Tools#
- bootspring_status - Check current status
- bootspring_help - Get upgrade help
- bootspring_feedback - Report upgrade issues