feat: neutral status when no changes

Author: skulidropek

README.md

@@ -100,6 +100,7 @@ jobs:
 | `publish_npm` | Whether to publish to npm registry | No | `true` |
 | `publish_github_packages` | Whether to publish to GitHub Packages | No | `true` |
 | `skip_if_unchanged` | Skip version bump/publish if the local npm tarball matches the latest published tarball (ignoring version/gitHead) | No | `false` |
+| `neutral_on_no_changes` | Mark workflow as neutral (exit 78) when no changes are detected | No | `false` |
 | `npm_token` | NPM authentication token | No (required if `publish_npm` is true) | - |
 | `github_token` | GitHub token for releases and packages | Yes | - |
 

SETUP.md

@@ -96,6 +96,7 @@ permissions:
 ### Optional Behavior
 
 - `skip_if_unchanged` - When enabled, the action compares the local npm tarball with the latest published tarball (ignoring version/gitHead) and skips the release if identical. For private npm packages, provide `NPM_TOKEN` so the comparison can fetch the published tarball.
+- `neutral_on_no_changes` - When enabled, the action exits with code 78 (neutral/gray) if no changes are detected.
 
 ### Action Permissions Policy
 

action.yml

@@ -54,6 +54,10 @@ inputs:
     description: "Skip version bump and publish if package.json and dist match the latest npm package"
     required: false
     default: "false"
+  neutral_on_no_changes:
+    description: "Mark workflow as neutral (exit 78) when no changes are detected"
+    required: false
+    default: "false"
   npm_token:
     description: "NPM authentication token (required if publish_npm is true)"
     required: false
@@ -176,6 +180,14 @@ runs:
           git stash drop >/dev/null 2>&1 || true
         fi
 
+    - name: Stop with neutral status on no changes
+      if: inputs.neutral_on_no_changes == 'true' && steps.compare_npm.outputs.should_release == 'false'
+      shell: bash
+      run: |
+        set -euo pipefail
+        echo "::notice::No changes detected; marking workflow neutral."
+        exit 78
+
     - name: Auto changeset (patch if no changeset exists)
       id: auto_changeset
       if: steps.compare_npm.outputs.should_release != 'false' && github.actor != 'github-actions[bot]'