Migrations Overview — OpenSIN-AI Migration Guides
Status: Active Owner: Team Coding
What Are Migrations?
Migration guides document the process of transitioning between versions, architectures, or configurations in the OpenSIN-AI ecosystem. They ensure fleet-wide consistency and prevent breakage during upgrades.
Migration Categories
1. OpenCode Config Migrations
Changes to ~/.config/opencode/opencode.json that require fleet-wide sync:
- Model updates or additions
- Provider configuration changes
- Plugin additions/removals
- MCP server registration changes
Sync command: sin-sync (pushes Mac → OCI VM → HF VMs)
2. Agent Migrations
Updating agent configurations across teams:
- Team member additions/removals
- Model reassignments
- Capability registry updates
- Telegram bot re-registration
3. Database Migrations
Supabase schema changes:
- New tables for agent pools
- Column additions/modifications
- Index optimizations
- Data migrations
4. Infrastructure Migrations
OCI VM, Cloudflare Workers, HF Space changes:
- Container image updates
- Proxy configuration changes
- SSL/TLS certificate rotations
- Domain migrations
Migration Protocol
- Announce: Create GitHub Issue with migration details
- Test: Apply migration on staging/dev environment
- Document: Update migration guide with steps and rollback plan
- Execute: Run migration during low-traffic window
- Verify: Run health checks across all fleet nodes
- Sync: Run
sin-syncto propagate config changes
Rollback Procedure
Every migration MUST have a rollback plan:
- Revert config changes from backup
- Restore database from snapshot
- Run
sin-syncwith previous config - Verify fleet health returns to baseline
Active Migrations
| Migration | Status | Date | Impact |
|---|---|---|---|
| (none currently active) | — | — | — |
Past Migrations
| Migration | Completed | Notes |
|---|---|---|
| Antigravity Plugin Migration | 2026-04 | All fleet nodes updated to use Antigravity OAuth |
| Bun Package Manager Mandate | 2026-03 | npm permanently banned, bun enforced |
| Technology Sovereignty Mandate | 2026-03 | Camoufox/Playwright/Puppeteer/Selenium banned |