docs: expand release process with complete workflow

- Add pre-release checklist
- Add branch merging steps
- Add tag creation steps
- Add GitHub release creation steps
- Add post-release cleanup steps
- Add quick reference command sequence

Author: pedrofuentes

.github/copilot-instructions.md

@@ -175,44 +175,123 @@ const flashEnabled = settings.flashOnMeetingStart === true;
 
 ## Release Process
 
-### Creating a Release Package
+### Complete Release Workflow
+
+Follow these steps in order for a complete release:
+
+#### 1. Pre-Release Checklist
+
+```powershell
+# Ensure all tests pass
+npm test
+
+# Ensure you're on the feature branch with all changes committed
+git status
+git log --oneline -5
+```
+
+#### 2. Update Version Numbers
+
+Update version in both files (must match):
+- `manifest.json`: 4-part version `"Version": "X.Y.Z.0"`
+- `package.json`: 3-part version `"version": "X.Y.Z"`
+
+#### 3. Merge Feature Branch to Main
+
+```powershell
+# Switch to main and pull latest
+git checkout main
+git pull origin main
+
+# Merge feature branch (use --no-ff to preserve history)
+git merge --no-ff feature/vX.Y.Z-branch-name -m "Merge feature/vX.Y.Z-branch-name: Brief description"
+
+# Push to main
+git push origin main
+```
+
+#### 4. Create Release Package
 
 **CRITICAL**: Always use the Stream Deck CLI to create packages. Manual zipping will create invalid packages.
 
 ```powershell
-# 1. Build for production (outputs to release/ folder)
+# Build for production (outputs to release/ folder)
 npm run build:production
 
-# 2. Create package using Stream Deck CLI
+# Create package using Stream Deck CLI
 streamdeck pack "release/com.pedrofuentes.ical.sdPlugin" --output release
 
-# 3. Creates: release/com.pedrofuentes.ical.streamDeckPlugin
+# Verify package was created
+Get-Item "release/com.pedrofuentes.ical.streamDeckPlugin"
 ```
 
-### Creating a GitHub Release
+#### 5. Test the Package (Optional but Recommended)
 
 ```powershell
-# 1. Create annotated tag
-git tag -a vX.Y.Z -m "vX.Y.Z - Description"
+# Remove dev plugin and test the package
+Stop-Process -Name "StreamDeck" -Force
+Remove-Item "$env:APPDATA\Elgato\StreamDeck\Plugins\com.pedrofuentes.ical.sdPlugin" -Recurse -Force
+Start-Process "$env:ProgramFiles\Elgato\StreamDeck\StreamDeck.exe"
+# Then double-click the .streamDeckPlugin file to install and verify it works
+```
+
+#### 6. Create Git Tag
+
+```powershell
+# Create annotated tag on main branch
+git tag -a vX.Y.Z -m "vX.Y.Z - Brief description of release"
+
+# Push tag to remote
 git push origin vX.Y.Z
+```
+
+#### 7. Create GitHub Release
 
-# 2. Create release with plugin package
+```powershell
+# Create release with plugin package attached
 gh release create vX.Y.Z "release/com.pedrofuentes.ical.streamDeckPlugin" `
-  --title "vX.Y.Z - Title" `
-  --notes "Release notes"
+  --title "vX.Y.Z - Release Title" `
+  --notes "## What's New
+
+- ✨ Feature 1
+- ✨ Feature 2
+- 🐛 Bug fix 1
+
+## Installation
+
+Download the \`.streamDeckPlugin\` file and double-click to install."
 ```
 
-### Testing Before Release
+Or create manually on GitHub:
+1. Go to https://github.com/pedrofuentes/stream-deck-ical/releases/new
+2. Choose the tag `vX.Y.Z`
+3. Set release title
+4. Add release notes
+5. Attach `release/com.pedrofuentes.ical.streamDeckPlugin`
+6. Publish release
+
+#### 8. Post-Release Cleanup
 
 ```powershell
-# Remove dev plugin and test the package
-Stop-Process -Name "StreamDeck" -Force
-Remove-Item "$env:APPDATA\Elgato\StreamDeck\Plugins\com.pedrofuentes.ical.sdPlugin" -Recurse -Force
-Start-Process "$env:ProgramFiles\Elgato\StreamDeck\StreamDeck.exe"
-# Then double-click the .streamDeckPlugin file to install
+# Delete merged feature branch (optional)
+git branch -d feature/vX.Y.Z-branch-name
+git push origin --delete feature/vX.Y.Z-branch-name
+
+# Re-link development plugin if needed
+streamdeck link "dist/com.pedrofuentes.ical.sdPlugin"
 ```
 
-### Version Numbers
+### Quick Reference Commands
 
-- `manifest.json`: 4-part version `"Version": "X.Y.Z.0"`
-- `package.json`: 3-part version `"version": "X.Y.Z"`
+```powershell
+# Full release sequence (after testing is complete)
+git checkout main
+git pull origin main
+git merge --no-ff feature/vX.Y.Z-name -m "Merge feature/vX.Y.Z-name"
+git push origin main
+npm run build:production
+streamdeck pack "release/com.pedrofuentes.ical.sdPlugin" --output release
+git tag -a vX.Y.Z -m "vX.Y.Z - Description"
+git push origin vX.Y.Z
+gh release create vX.Y.Z "release/com.pedrofuentes.ical.streamDeckPlugin" --title "vX.Y.Z" --notes "Release notes"
+```