# Release Checklist v0.16.3
**Release Date:** 2025-10-07
**Release Type:** Minor (Feature Release)
**Version:** 0.16.3
---
## ✅ Pre-Release Checks
### Code Quality
- [x] All tests passing in CI/CD
- [x] No linting errors
- [x] Code coverage maintained (~71% server, 100% extension)
- [x] No critical security vulnerabilities
### Version Consistency
- [x] `gorev-npm/package.json`: v0.16.3
- [x] `gorev-vscode/package.json`: v0.16.3
- [x] `gorev-mcpserver`: Version injected at build time
- [x] All inter-package dependencies aligned
### Documentation
- [x] CHANGELOG.md updated with v0.16.3 entry
- [x] README.md reflects latest features
- [x] CLAUDE.md updated with v0.16.3 notes
- [x] API documentation current
- [x] MCP tools reference up-to-date
### Testing
- [x] **npm pack + global install test** (Ubuntu)
- Binary included: ✅
- npx command works: ✅
- VS Code extension connects: ✅
- Daemon starts automatically: ✅
- [x] **Multi-platform compatibility**
- Linux (amd64): ✅ Tested
- Windows (amd64): ⚠️ Not tested locally (CI will test)
- macOS (amd64): ⚠️ Not tested locally (CI will test)
- macOS (arm64): ⚠️ Not tested locally (CI will test)
- Linux (arm64): ⚠️ Not tested locally (CI will test)
### Critical Fixes Verified
- [x] `bin/gorev-mcp` has `wrapper.main()` call
- [x] postinstall.js downloads binaries correctly
- [x] VS Code extension auto-starts server
- [x] Workspace registration works
- [x] Database migrations run successfully
---
## 🚀 Release Process
### 1. GitHub Release (Automated)
**Trigger:** Push tag `v0.16.3`
```bash
git tag -a v0.16.3 -m "Release v0.16.3 - Daemon Architecture"
git push origin v0.16.3
```
**GitHub Actions will:**
1. Build binaries for all platforms (`.github/workflows/npm-publish.yml`)
2. Run tests on Linux, Windows, macOS
3. Publish to NPM
4. Create GitHub Release with binaries
5. Publish to MCP Registry
**Expected Duration:** 15-20 minutes
### 2. Manual Verification (Post-Release)
**NPM Package:**
```bash
# Wait for NPM publish to complete (~2 minutes after workflow starts)
npm view @mehmetsenol/gorev-mcp-server version
# Should show: 0.16.3
# Test installation
npm install -g @mehmetsenol/gorev-mcp-server@0.16.3
npx @mehmetsenol/gorev-mcp-server --version
# Should show: 0.16.3
```
**GitHub Release:**
- Visit: https://github.com/msenol/Gorev/releases/tag/v0.16.3
- Verify binaries attached:
- `gorev-linux-amd64`
- `gorev-linux-arm64`
- `gorev-darwin-amd64`
- `gorev-darwin-arm64`
- `gorev-windows-amd64.exe`
- `checksums.txt`
**MCP Registry:**
- Visit: https://registry.modelcontextprotocol.io/servers/io.github.msenol.gorev
- Verify version: 0.16.3
- Verify README displays correctly
### 3. VS Code Extension Release (Separate)
**Note:** VS Code extension release is separate workflow
```bash
cd gorev-vscode
vsce package
vsce publish
```
**Marketplace:** https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode
---
## 📝 Release Notes Template
```markdown
## 🚀 Gorev v0.16.3 - Daemon Architecture
### 🎯 Major Feature: Background Daemon
Gorev now runs as a persistent background service, enabling:
- **Multi-Client Support**: Claude, VS Code, Cursor, and Windsurf can connect simultaneously
- **Real-Time Updates**: WebSocket-based task synchronization across all clients
- **Auto-Start**: VS Code extension automatically detects and starts the daemon
- **Multi-Workspace**: SHA256-based workspace isolation for parallel projects
### 📦 Installation
```bash
# Global installation
npm install -g @mehmetsenol/gorev-mcp-server@0.16.3
# Or use directly with npx
npx @mehmetsenol/gorev-mcp-server@0.16.3
```
### 🔧 New Commands
- `gorev daemon` - Start/manage daemon process
- `gorev daemon-status` - Check daemon status
- `gorev daemon-stop` - Stop running daemon
### 🐛 Bug Fixes
- Fixed NPM wrapper missing `wrapper.main()` call
- Improved binary installation reliability
- Fixed VS Code extension connection issues
### 📚 Documentation
- [Daemon Architecture](https://github.com/msenol/Gorev/blob/main/docs/architecture/daemon-architecture.md)
- [Multi-Workspace Guide](https://github.com/msenol/Gorev/blob/main/docs/guides/multi-workspace.md)
- [MCP Configuration](https://github.com/msenol/Gorev#-mcp-configuration)
### ⬆️ Upgrading from v0.16.2
```bash
# NPM users
npm update -g @mehmetsenol/gorev-mcp-server
# VS Code extension users
# Update via VS Code extensions panel
```
**Breaking Changes:** None. VS Code extension now uses daemon, but auto-starts it.
---
**Full Changelog:** https://github.com/msenol/Gorev/blob/main/CHANGELOG.md#0163---2025-10-07
```
---
## 🔍 Post-Release Monitoring
### First 24 Hours
- [ ] Monitor NPM download stats
- [ ] Check GitHub issues for installation problems
- [ ] Review user feedback in VS Code marketplace
- [ ] Monitor MCP Registry stats
### First Week
- [ ] Address any critical bugs with patch release
- [ ] Update documentation based on user feedback
- [ ] Plan v0.17.0 features
---
## 🚨 Rollback Plan
If critical issues are found:
1. **NPM Deprecation:**
```bash
npm deprecate @mehmetsenol/gorev-mcp-server@0.16.3 "Critical bug, use v0.16.2"
```
2. **Hotfix Release:**
- Create branch `hotfix/v0.16.4`
- Fix critical bug
- Tag and release v0.16.4 immediately
3. **GitHub Release:**
- Mark v0.16.3 as "Pre-release" if issues found
---
## 📊 Success Metrics
**Release is successful if:**
- ✅ NPM package installs without errors on all platforms
- ✅ VS Code extension connects and works
- ✅ No critical bugs reported within 48 hours
- ✅ Download count increases (target: 50+ in first week)
- ✅ MCP Registry listing is live
---
## 🎉 Announcement Channels
After successful release:
- [ ] GitHub Discussion post
- [ ] Update README.md badges
- [ ] Social media announcement (if applicable)
- [ ] Discord/Slack (if applicable)
---
**Prepared by:** Claude Code
**Review Status:** Ready for Release
**Risk Level:** Low (well-tested, backwards compatible)
