|
| 1 | +# Migration Guide |
| 2 | + |
| 3 | +## Upgrading to v0.1.1 |
| 4 | + |
| 5 | +### Breaking Changes |
| 6 | + |
| 7 | +None. This is a backward-compatible release. |
| 8 | + |
| 9 | +### New Features |
| 10 | + |
| 11 | +- Added Dependabot for automated dependency updates |
| 12 | +- Added SECURITY.md for vulnerability reporting |
| 13 | +- Added performance benchmarks |
| 14 | +- Increased test coverage |
| 15 | + |
| 16 | +### Upgrade Steps |
| 17 | + |
| 18 | +```bash |
| 19 | +# Update CLI |
| 20 | +curl -fsSL https://gitant.io/install.sh | sh |
| 21 | + |
| 22 | +# Update daemon |
| 23 | +docker pull ghcr.io/graycodeai/gitant-daemon:v0.1.1 |
| 24 | + |
| 25 | +# Update web |
| 26 | +docker pull ghcr.io/graycodeai/gitant-web:v0.1.1 |
| 27 | +``` |
| 28 | + |
| 29 | +## Upgrading from v0.1.0 to v0.1.1 |
| 30 | + |
| 31 | +### Database |
| 32 | + |
| 33 | +No schema changes. Existing data is compatible. |
| 34 | + |
| 35 | +### Configuration |
| 36 | + |
| 37 | +No configuration changes required. |
| 38 | + |
| 39 | +### API |
| 40 | + |
| 41 | +No breaking API changes. |
| 42 | + |
| 43 | +## Upgrading from Pre-release to v0.1.0 |
| 44 | + |
| 45 | +### Breaking Changes |
| 46 | + |
| 47 | +1. **CLI renamed**: `gitant` → `gt` (alias `gitant` still works) |
| 48 | +2. **MCP tools renamed**: All tools now use `gitant_` prefix |
| 49 | +3. **API endpoints**: Some endpoints moved to `/api/v1/` prefix |
| 50 | + |
| 51 | +### Database Migration |
| 52 | + |
| 53 | +```bash |
| 54 | +# Backup existing data |
| 55 | +cp -r ~/.gitant ~/.gitant.backup |
| 56 | + |
| 57 | +# Run migration (if any) |
| 58 | +gitant migrate |
| 59 | +``` |
| 60 | + |
| 61 | +### Configuration Changes |
| 62 | + |
| 63 | +```yaml |
| 64 | +# Old config |
| 65 | +daemon_url: http://localhost:7777 |
| 66 | + |
| 67 | +# New config (same, but documented) |
| 68 | +daemon_url: http://localhost:7777 |
| 69 | +``` |
| 70 | +
|
| 71 | +### API Changes |
| 72 | +
|
| 73 | +| Old Endpoint | New Endpoint | |
| 74 | +|--------------|--------------| |
| 75 | +| `/repos` | `/api/v1/repos` | |
| 76 | +| `/issues` | `/api/v1/repos/{id}/issues` | |
| 77 | +| `/prs` | `/api/v1/repos/{id}/prs` | |
| 78 | + |
| 79 | +### MCP Tool Changes |
| 80 | + |
| 81 | +All MCP tools now use `gitant_` prefix: |
| 82 | + |
| 83 | +| Old Name | New Name | |
| 84 | +|----------|----------| |
| 85 | +| `list_repos` | `gitant_list_repos` | |
| 86 | +| `create_issue` | `gitant_create_issue` | |
| 87 | +| `open_pr` | `gitant_open_pr` | |
| 88 | + |
| 89 | +## Rollback |
| 90 | + |
| 91 | +If you need to rollback: |
| 92 | + |
| 93 | +```bash |
| 94 | +# Restore from backup |
| 95 | +cp -r ~/.gitant.backup ~/.gitant |
| 96 | +
|
| 97 | +# Downgrade CLI |
| 98 | +curl -fsSL https://gitant.io/install.sh | sh -s -- --version v0.1.0 |
| 99 | +``` |
| 100 | + |
| 101 | +## Support |
| 102 | + |
| 103 | +If you encounter issues during migration: |
| 104 | + |
| 105 | +1. Check the [FAQ](https://docs.gitant.io/faq) |
| 106 | +2. Search [GitHub Issues](https://github.com/GrayCodeAI/gitant-daemon/issues) |
| 107 | +3. Ask on [Discord](https://discord.gg/gitant) |
| 108 | +4. Email support@gitant.io |
0 commit comments