chore: improve release workflow with tagging (#33)

Signed-off-by: Alec Jacobs <charles.jacobs@segment.com>

Author: alecjacobs5401

.github/workflows/release.yml

@@ -59,3 +59,11 @@ jobs:
         # exchanges it per-package for a short-lived npm token, and enables
         # provenance automatically (public repo + public package).
         run: yarn lerna publish from-package --yes --loglevel=verbose --dist-tag latest
+
+      - name: Fetch Latest Tags
+        run: |
+          git fetch --tags
+
+      - name: Generate Tags
+        id: get-release-tag
+        run: ./scripts/generate-release-tags.sh

scripts/generate-release-tags.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+
+# This script is executed after the version is bumped by lerna. It generates a release tag.
+# The release tag generated will be pushed to the repository by lerna version.
+set -e
+
+sha=$(git rev-parse HEAD)
+branch=$(git rev-parse --symbolic-full-name --abbrev-ref HEAD)
+message=$(git log -1 --pretty=%B)
+
+RELEASE_COMMIT_PREFIX="chore(release):"
+
+function pre_tag_checks() {
+  # # Only generate release tags for main branch
+  if [[ $branch != "main" ]]; then
+    echo "Skipping release tag generation as branch is not main"
+    exit 0
+  fi;
+
+  if [[ $message != "$RELEASE_COMMIT_PREFIX"* ]]; then
+    echo "Skipping release tag generation as last commit is not a release commit"
+    exit 0
+  fi;
+
+  # check if jq is installed
+  if ! command -v jq &> /dev/null; then
+      echo "jq could not be found. Please install jq to generate release tag."
+      exit 1
+  fi
+}
+
+function generate_monorepo_tag() {
+  # Generate and push release tag. Release tag format: release-YYYY-MM-DD[.N] e.g. release-2026-01-01
+  if ! n=$(git rev-list --count "$sha~" --grep "$RELEASE_COMMIT_PREFIX" --since="00:00"); then
+      echo 'Failed to compute release tag. Exiting.'
+      exit 1
+  else
+      case "$n" in
+          0) suffix="" ;; # first commit of the day gets no suffix
+          *) suffix=".$n" ;; # subsequent commits get a suffix, starting with .1
+      esac
+
+      base_tag=$(date '+%Y-%m-%d')
+      tag=$(printf "release-%s%s" "$base_tag" "$suffix")
+      echo "Tagging $sha with $tag"
+      git tag -a "$tag" -m "Release $tag"
+      git push origin "$tag"
+  fi
+}
+
+function generate_plugin_tags() {
+  # List changed package.json files in the last commit
+  files=$(git show --pretty="" --name-only HEAD | grep -Ei '^plugins/.*package\.json$')
+
+  # Generate and push release tags for each package.
+  # Tag format: <package-name>@<package-version> e.g. @my-org/my-package@1.0.0
+  for file in $files; do
+    tag=$(jq -r '.name + "@" + .version' "$file")
+
+    echo "Tagging $sha with $tag"
+    git tag -a "$tag" -m "Release $tag"
+    git push origin "$tag"
+  done
+}
+
+function main() {
+  pre_tag_checks
+  generate_monorepo_tag
+  generate_plugin_tags
+}
+
+main

scripts/prerelease.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [[ -n "$(git status --porcelain)" ]]; then
+ echo >&2 "ERROR: Uncommitted changes found, please commit or stash them before releasing."
+ exit 1
+fi
+
+echo "Switching to main and pulling ..."
+git switch main
+git pull
+
+echo "Checking yarn.lock status ..."
+if ! yarn install --immutable; then
+  echo >&2 "ERROR: yarn.lock is not up to date, please run yarn install in a feature branch and merge the changes."
+  exit 1
+fi
+
+target_version="$1"
+if [[ -n "$target_version" ]]; then
+  echo "Target version specified: $target_version"
+else
+  echo "No target version specified, using --conventional-commits flag"
+  target_version="--conventional-commits"
+fi
+
+yarn lerna version --no-git-tag-version --no-private "$target_version"
+
+release_branch="release/$(date +%s)"
+git switch --create "$release_branch"
+git add --all # include all files including any untracked
+git commit --all --message "chore(release): generate release"
+git push --set-upstream origin "$release_branch"
+
+echo "Release notes generated and pushed to \"$release_branch\". Please open a pull request, get it reviewed, and merge to trigger package publishing."