Upgrading Versions
Guide to upgrading Bootspring between versions.
Checking Your Version#
Loading code block...
Upgrade Process#
Step 1: Check Current Version#
Loading code block...
Step 2: Check for Updates#
Loading code block...
Output:
Current version: 1.1.0
Latest version: 1.2.0
Changelog:
- New: Preseed workflow
- New: 5 additional agents
- Improved: Context generation performance
- Fixed: Memory leak in long sessions
Run `bootspring update` to upgrade.
Step 3: Backup Configuration#
Loading code block...
Step 4: Update#
Loading code block...
Step 5: Verify#
Loading code block...
Version Numbering#
Bootspring follows semantic versioning:
MAJOR.MINOR.PATCH
| Type | Description | Example |
|---|---|---|
| Major | Breaking changes | 1.0.0 → 2.0.0 |
| Minor | New features, backwards compatible | 1.1.0 → 1.2.0 |
| Patch | Bug fixes | 1.1.0 → 1.1.1 |
Major Version Upgrades#
Major versions may include breaking changes.
Pre-Upgrade Checklist#
- Read the changelog
- Backup configuration
- Check deprecation warnings
- Review migration guide
- Test in development first
Common Breaking Changes#
Configuration Schema Changes#
Old config:
Loading code block...
New config:
Loading code block...
Migration:
Loading code block...
Command Changes#
| Old | New |
|---|---|
bootspring agent frontend-expert | bootspring agent invoke frontend-expert |
bootspring skill patterns/auth | bootspring skill apply patterns/auth |
API Changes#
Check SDK documentation for API changes.
Migration Commands#
Loading code block...
Minor Version Upgrades#
Minor versions add features without breaking changes.
Typical Process#
Loading code block...
No configuration changes needed.
New Features#
Check what's new:
Loading code block...
Patch Version Upgrades#
Patches contain bug fixes only.
Auto-Update#
Enable auto-updates for patches:
Loading code block...
Manual Update#
Loading code block...
Version Pinning#
Pin to Specific Version#
Loading code block...
Pin in CI/CD#
Loading code block...
Lock File#
For team consistency:
Loading code block...
Rollback#
Rollback to Previous Version#
Loading code block...
Clear Cache After Rollback#
Loading code block...
Beta and Canary Versions#
Installing Beta#
Loading code block...
Installing Canary#
Loading code block...
Switching Back to Stable#
Loading code block...
Multi-Project Upgrades#
Check All Projects#
Loading code block...
Upgrade All#
Loading code block...
Project-Specific Versions#
Use npx for project-specific versions:
Loading code block...
Loading code block...
Troubleshooting Upgrades#
Config Validation Failed#
Loading code block...
Context Generation Changed#
Regenerate context after major upgrades:
Loading code block...
Cache Issues#
Clear cache if experiencing issues:
Loading code block...
Plugin Compatibility#
Check plugin compatibility:
Loading code block...
Release Channels#
| Channel | Description | Stability |
|---|---|---|
stable | Production ready | High |
beta | Feature complete, testing | Medium |
canary | Latest features, may be unstable | Low |
Subscribe to Releases#
Changelog#
View changelog:
Loading code block...
Or visit /changelog on the website.