feat: Add semantic release release-created (#7)

Author: AndyRae

.github/workflows/release.yml

@@ -12,3 +12,10 @@ jobs:
       node-version: '20'
     secrets: inherit
 
+  confirm-release:
+    needs: release
+    if: needs.release.outputs.release-created == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "A new release was created!"
+

.github/workflows/semantic-release.yml

@@ -8,6 +8,10 @@ on:
         required: false
         default: '24'
         type: string
+    outputs:
+      release-created:
+        description: 'Whether semantic-release created a new release/tag'
+        value: ${{ jobs.release.outputs.release-created }}
 
 permissions:
   contents: write
@@ -17,10 +21,17 @@ permissions:
 jobs:
   release:
     runs-on: ubuntu-latest
+    concurrency:
+      group: semantic-release-${{ github.repository }}
+      cancel-in-progress: false
+    outputs:
+      release-created: ${{ steps.release-check.outputs.release-created }}
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Set up Node.js
         uses: actions/setup-node@v4
@@ -36,8 +47,35 @@ jobs:
             @semantic-release/changelog \
             @semantic-release/github
 
+      - name: Capture tags before release
+        run: |
+          git fetch --tags --force
+          git tag -l | sort > /tmp/tags-before.txt
+
       - name: Run Semantic Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: semantic-release
 
+      - name: Capture tags after release
+        run: |
+          git fetch --tags --force
+          git tag -l | sort > /tmp/tags-after.txt
+
+      - name: Determine whether release was created
+        id: release-check
+        run: |
+          head_sha=$(git rev-parse HEAD)
+          new_tags=$(comm -13 /tmp/tags-before.txt /tmp/tags-after.txt)
+          release_created=false
+
+          while IFS= read -r tag; do
+            tag_sha=$(git rev-parse "${tag}^{}" 2>/dev/null || git rev-parse "$tag")
+            if [ "$tag_sha" = "$head_sha" ]; then
+              release_created=true
+              break
+            fi
+          done <<< "$new_tags"
+
+          echo "release-created=$release_created" >> "$GITHUB_OUTPUT"
+

.github/workflows/semver-container.yml

@@ -12,16 +12,10 @@ on:
         required: false
         default: 'ghcr.io'
         type: string
-      release-name-prefix:
-        description: 'Prefix for the GitHub Release title'
-        required: false
-        default: ''
-        type: string
 
 env:
   image-name: ${{ inputs.image-name }}
   registry: ${{ inputs.registry }}
-  release-name-prefix: ${{ inputs.release-name-prefix }}
 
 jobs:
   version-tag:

docs/semantic-release.md

@@ -8,6 +8,28 @@ Reusable workflow that runs [semantic-release](https://github.com/semantic-relea
 |----------------|----------|---------|----------------------------|
 | `node-version` | No       | `'24'`  | Node.js version to use.    |
 
+## Outputs
+
+| Output            | Description                                              |
+|-------------------|----------------------------------------------------------|
+| `release-created` | `'true'` if a new release was created, `'false'` if not. |
+
+Use this to conditionally run downstream jobs (e.g. re-tag a container, publish to PyPI) only when a release actually happened:
+
+```yaml
+jobs:
+  release:
+    uses: health-informatics-uon/workflows/.github/workflows/semantic-release.yml@main
+    secrets: inherit
+
+  publish:
+    needs: release
+    if: needs.release.outputs.release-created == 'true'
+    ...
+```
+
+> **Note:** If the workflow itself errors, `release-created` will be an empty string rather than `'false'`. Always use `== 'true'` rather than `!= 'false'` in conditions.
+
 ## Secrets
 
 - `GITHUB_TOKEN` — Pass with `secrets: inherit` (or set explicitly) so the workflow can create releases and comment on PRs/issues.