ci: release script (#182)

Signed-off-by: David Wosk <dwosk@us.ibm.com>

Author: dwosk

.github/workflows/publish.yml

@@ -6,7 +6,7 @@ on:
       - 'v*.*.*'
 
 permissions:
-  contents: read
+  contents: write
   id-token: write
 
 jobs:
@@ -23,3 +23,7 @@ jobs:
       - run: npm run build
       - run: npm run build:module
       - run: npm publish --provenance --access public
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create ${{ github.ref_name }} --title "${{ github.ref_name }}" --generate-notes

docs/DEVELOPMENT.md

@@ -36,3 +36,17 @@ $ npm run test
 ```shell
 $ npm run docs
 ```
+
+### Releasing
+
+Releases are handled automatically via GitHub Actions. The process works as follows:
+
+1. **Version bumping is automatic** - When you merge a PR to `main`, the `version.yml` workflow analyzes your commit message and bumps the version:
+   - `feat: ...` → minor bump (0.4.3 → 0.5.0)
+   - `fix: ...` or other → patch bump (0.4.3 → 0.4.4)
+   - `breaking change: ...` → major bump (0.4.3 → 1.0.0)
+
+2. **To publish a release**, run the release script after merging:
+   ```shell
+   $ ./scripts/release.sh
+   ```

scripts/release.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+set -euo pipefail
+
+# Get the version from package.json
+VERSION=$(node -p "require('./package.json').version")
+TAG="v$VERSION"
+
+# Check if we're on main branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+if [ "$BRANCH" != "main" ]; then
+  echo "Error: You must be on the main branch to release. Currently on: $BRANCH"
+  exit 1
+fi
+
+# Check for uncommitted changes
+if [ -n "$(git status --porcelain)" ]; then
+  echo "Error: You have uncommitted changes. Please commit or stash them first."
+  exit 1
+fi
+
+# Pull latest changes
+echo "Pulling latest changes from main..."
+git pull origin main
+
+# Re-read version after pull (in case version.yml updated it)
+VERSION=$(node -p "require('./package.json').version")
+TAG="v$VERSION"
+
+# Check if tag already exists
+if git rev-parse "$TAG" >/dev/null 2>&1; then
+  echo "Error: Tag $TAG already exists."
+  exit 1
+fi
+
+echo "Creating release for version $VERSION..."
+
+# Create and push the tag
+git tag "$TAG"
+git push origin "$TAG"
+
+echo ""
+echo "Release $TAG triggered successfully!"
+echo ""
+echo "Follow the publish workflow here:"
+echo "https://github.com/IBM/aspera-sdk-js/actions/workflows/publish.yml"