build: add the release task & workflow

Updated mise tasks:
  - ✅ Added github-cli tool - Installs gh CLI automatically
  - ✅ Enhanced release task - Uses gh release create for GitHub release
  - ✅ Complete automation - Handles tags, GitHub release, and major version
  updates
  - ✅ Proper escaping - Handles YAML and JSON in release notes

  Simplified GitHub workflow:
  - ✅ Single step - Just calls mise run release
  - ✅ Passes GITHUB_TOKEN - For gh CLI authentication
  - ✅ Clean and maintainable - All logic is in mise tasks

  Benefits:
  - Local/CI consistency - Same release process everywhere
  - Tool management - mise handles all dependencies (dprint, bun, gh)
  - Maintainability - One place to update release logic
  - Flexibility - Can run releases locally or via GitHub

  Usage:
  # Local release
  mise run release -- v1.2.3

  # Or via GitHub workflow
  # Actions → Release → Run workflow → Enter v1.2.3

Author: davidB

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., v1.2.3)'
+        required: true
+        type: string
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup mise
+        uses: jdx/mise-action@v2
+
+      - name: Create release
+        run: mise run release -- ${{ inputs.version }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.mise.toml

@@ -1,6 +1,7 @@
 [tools]
 dprint = "latest"
 bun = "latest"
+github-cli = "latest"
 
 [tasks.format]
 description = "Format code using dprint"
@@ -18,4 +19,87 @@ run = [
 
 [tasks.ci]
 description = "Run all CI checks locally"
-alias = "check"
+alias = "check"
+
+[tasks.release]
+description = "Create a new release with version tag (usage: mise run release -- v1.2.3)"
+depends = ["check"]
+run = '''
+  if [ -z "$1" ]; then 
+    echo 'Error: Please provide version (e.g., mise run release -- v1.2.3)'
+    exit 1
+  fi
+  
+  VERSION="$1"
+  MAJOR_VERSION=$(echo $VERSION | cut -d. -f1)
+  
+  echo "=== Creating GitHub Action release ==="
+  echo "Version: $VERSION (major: $MAJOR_VERSION)"
+  
+  # Ensure we're on main branch and up to date
+  git checkout main
+  git pull origin main
+  
+  # Create and push version tag
+  echo "Creating tag: $VERSION"
+  git tag -a "$VERSION" -m "Release $VERSION"
+  git push origin "$VERSION"
+  
+  # Create GitHub release using gh CLI
+  echo "Creating GitHub release"
+  gh release create "$VERSION" \
+    --title "Release $VERSION" \
+    --notes "## Changes
+
+See [CHANGELOG.md](https://github.com/cdviz-dev/send-cdevents/blob/main/CHANGELOG.md) for details.
+
+## Usage
+
+\`\`\`yaml
+- name: Send CDEvent
+  uses: cdviz-dev/send-cdevents@$VERSION
+  with:
+    data: |
+      {
+        \"context\": {
+          \"version\": \"0.4.1\",
+          \"source\": \"github-actions\",
+          \"type\": \"dev.cdevents.taskrun.started.0.2.0\"
+        },
+        \"subject\": {
+          \"id\": \"\${{ github.run_id }}\",
+          \"type\": \"taskRun\",
+          \"content\": {
+            \"taskName\": \"ci-build\"
+          }
+        }
+      }
+    url: \"https://your-webhook-endpoint.com/cdevents\"
+\`\`\`"
+  
+  # Update major version tag (e.g., v1)  
+  echo "Updating major version tag: $MAJOR_VERSION"
+  git tag -f -a "$MAJOR_VERSION" -m "Release $MAJOR_VERSION (latest: $VERSION)"
+  git push origin "$MAJOR_VERSION" --force
+  
+  echo "=== Release completed! ==="
+  echo "✅ Created version tag: $VERSION"
+  echo "✅ Created GitHub release: $VERSION"
+  echo "✅ Updated major tag: $MAJOR_VERSION" 
+  echo "📦 GitHub Marketplace will auto-update from the major version tag"
+'''
+
+[tasks.release-check]
+description = "Check current release status and tags"
+depends = ["check"]
+run = '''
+  echo "=== Current Release Status ==="
+  echo "Latest tags:"
+  git tag --sort=-version:refname | head -5
+  
+  echo "Current branch:"
+  git branch --show-current
+  
+  echo "Uncommitted changes:"
+  git status --porcelain || echo "Working tree clean"
+'''