Release Guardian

Release Guardian

This skill ensures smooth releases by maintaining version consistency and following the proven release workflow.

When This Skill Activates

• Mentioning version numbers (e.g., "v1.0.97", "bump to 1.0.98")
• Commands like "release", "ship", "deploy", "new version"
• Creating git tags
• Modifying version-containing files

Version Synchronization Points

Desktop Application

File: VoiceLite/VoiceLite/VoiceLite.csproj

<Version>1.0.97</Version>
<FileVersion>1.0.97.0</FileVersion>
<AssemblyVersion>1.0.97.0</AssemblyVersion>

Installer Script

File: VoiceLite/Installer/VoiceLiteSetup.iss

AppVersion=1.0.97
VersionInfoVersion=1.0.97
OutputBaseFilename=VoiceLite-Setup-1.0.97

Web Application

File: voicelite-web/package.json

"version": "0.1.0"  // Note: Web version independent of desktop

Download Endpoint

File: voicelite-web/app/api/download/route.ts

const CURRENT_VERSION = 'v1.0.97';
const INSTALLER_FILENAME = `VoiceLite-Setup-1.0.97.exe`;

Website Homepage

Files:

• voicelite-web/components/home/hero-section.tsx
• voicelite-web/components/home/cta-section.tsx

href="/api/download?version=1.0.97"

Documentation

File: CLAUDE.md

**Current Desktop**: v1.0.97

Release Workflow

Phase 1: Pre-Release

# 1. Ensure clean working directory
git status

# 2. Run tests
dotnet test VoiceLite/VoiceLite.Tests/VoiceLite.Tests.csproj

# 3. Update all version locations (see above)

# 4. Build in Release mode
dotnet build VoiceLite/VoiceLite.sln -c Release

Phase 2: Build & Package

# 5. Publish self-contained
dotnet publish VoiceLite/VoiceLite/VoiceLite.csproj -c Release -r win-x64 --self-contained

# 6. Build installer
"C:\Program Files (x86)\Inno Setup 6\ISCC.exe" /Q VoiceLite/Installer/VoiceLiteSetup.iss

# 7. Verify installer size (should be ~100-150MB with model)

Phase 3: Git & Deploy

# 8. Commit version changes
git add -A
git commit -m "release: v1.0.97"

# 9. Create and push tag (triggers GitHub Actions)
git tag v1.0.97
git push origin master --tags

# 10. Monitor GitHub Actions (~5-7 minutes)
gh run list --workflow release.yml

Phase 4: Post-Release

# 11. Verify GitHub Release created
gh release view v1.0.97

# 12. Test download from website
curl -I https://voicelite.app/api/download

# 13. Update website if needed
cd voicelite-web && vercel deploy --prod

Version Numbering Convention

Format: MAJOR.MINOR.PATCH

• MAJOR (1.x.x): Breaking changes, major features
• MINOR (x.1.x): New features, Pro models, UI changes
• PATCH (x.x.1): Bug fixes, performance improvements

Recent versions:

• v1.0.96: CRITICAL - Fixed missing model file
• v1.0.95: BROKEN - Model not bundled
• v1.0.94: Fixed logging in Release builds

Common Issues & Solutions

Version Mismatch Detected

1. List all files with old version
2. Update systematically (desktop → installer → web)
3. Commit all changes together

GitHub Actions Failed

# Check workflow logs
gh run view [run-id] --log

# Common failures:
# - Tag already exists → Delete and recreate
# - Tests failing → Fix before release
# - Upload failed → Retry workflow

Installer Too Small (<50MB)

CRITICAL: Model file missing! Check:

• Is ggml-tiny.bin in VoiceLite/whisper/?
• Is it referenced in .iss file?

GitHub Actions Monitoring

Watch the release workflow in real-time:

# Watch workflow (blocks until complete ~5-7 min)
gh run watch

# Check latest workflow status
gh run list --workflow release.yml --limit 1

# View logs if failed
gh run view --log

# Expected: "completed" status with green checkmark