Merge pull request #349 from cipherstash/feat/release-task

feat: add mise release task for GitHub releases

Author: tobyhede

DEVELOPMENT.md

@@ -65,7 +65,7 @@ mise has tasks for:
 - Running unit tests (`test:unit`)
 - Running integration tests (`test:integration`, `test:integration:*`)
 - Building binaries (`build:binary`) and Docker images (`build:docker`)
-- Publishing release artifacts (`release`)
+- Creating GitHub releases (`release`) — see [Releasing](#releasing)
 
 These are the important files in the repo:
 
@@ -741,3 +741,48 @@ Struct definitions make error message strings slightly clearer.
 
 Note: not all errors do this at the moment, and we will change over time.
 
+## Releasing
+
+Releases are published via GitHub Actions when a GitHub release is created.
+
+### Using mise (recommended)
+
+```bash
+mise run release v2.1.9
+```
+
+This will:
+1. Create a git tag for the version
+2. Push the tag to origin
+3. Create a GitHub release with auto-generated notes
+4. Trigger the release workflow which builds and publishes Docker images
+
+### Manual release
+
+If you need more control over the release process:
+
+```bash
+# Create and push the tag
+git tag v2.1.9
+git push origin v2.1.9
+
+# Create the GitHub release
+gh release create v2.1.9 --generate-notes
+```
+
+### Re-releasing a version
+
+If a release fails and you need to re-release the same version:
+
+```bash
+# Delete the GitHub release
+gh release delete v2.1.9 --yes
+
+# Delete the tag (local and remote)
+git tag -d v2.1.9
+git push origin :refs/tags/v2.1.9
+
+# Create the release again
+mise run release v2.1.9
+```
+

mise.toml

@@ -666,8 +666,21 @@ mise --env tls run proxy:down
 """
 
 [tasks.release]
-description = "Publish release artifacts"
-depends = ["release:docker"]
+description = "Create a GitHub release"
+run = """
+#!/usr/bin/env bash
+set -euo pipefail
+
+VERSION="${1:?Version required, e.g., mise run release v2.1.9}"
+
+echo "Creating release $VERSION..."
+
+git tag "$VERSION"
+git push origin "$VERSION"
+gh release create "$VERSION" --generate-notes
+
+echo "Done! Release workflow will run automatically."
+"""
 
 [tasks."release:docker"]
 description = "Release a Docker image for cipherstash-proxy"