feat(workflows): normalise v0.0.x → v0.1.0 with opt-out checkbox

>
> When the current release is v0.0.x, auto-increment now jumps to v0.1.0
> (the standard semver starting point) instead of v0.0.2, v0.0.3, etc.
>
> A new 'normalize_version' checkbox (default: checked) lets users opt out
> and keep incrementing within v0.0.x if they prefer. Propagates from update.yml → release.yml.
>
> Also applies the || true fix to the PRIOR_TAG pipeline to prevent set -e failures when
> only one version tag exists.

Author: xaoscience

.github/workflows/release.yml

@@ -113,6 +113,11 @@ on:
         required: false
         type: boolean
         default: false
+      normalize_version:
+        description: 'Normalise v0.0.x to v0.1.0 (uncheck to keep v0.0.x scheme)'
+        required: false
+        type: boolean
+        default: true
 
 permissions:
   contents: write
@@ -176,8 +181,14 @@ jobs:
                 MAJOR=${BASH_REMATCH[1]}
                 MINOR=${BASH_REMATCH[2]}
                 PATCH=${BASH_REMATCH[3]}
-                VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
-                echo "🔢 Auto-detected next version: ${VERSION} (from latest: v${LATEST})"
+                # Normalise v0.0.x → v0.1.0 (standard semver starting point)
+                if [[ "${{ github.event.inputs.normalize_version }}" != 'false' && "$MAJOR" -eq 0 && "$MINOR" -eq 0 ]]; then
+                  VERSION="0.1.0"
+                  echo "📐 Normalising v${LATEST} → v${VERSION} (standard semver convention)"
+                else
+                  VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
+                  echo "🔢 Auto-detected next version: ${VERSION} (from latest: v${LATEST})"
+                fi
               else
                 echo "❌ Could not determine latest version to auto-increment"
                 exit 1

.github/workflows/update.yml

@@ -87,6 +87,11 @@ on:
         required: false
         type: boolean
         default: false
+      normalize_version:
+        description: 'Normalise v0.0.x to v0.1.0 (uncheck to keep v0.0.x scheme)'
+        required: false
+        type: boolean
+        default: true
       check_dependencies:
         description: 'Check and update dependencies (package.json, requirements.txt)'
         required: false
@@ -200,7 +205,7 @@ jobs:
                       while read -r t; do
                         v="${t#v}"
                         [[ "$v" != "$LATEST_VERSION" ]] && echo "$t" && break
-                      done)
+                      done) || true
           if [[ -n "$PRIOR_TAG" ]]; then
             CUMULATIVE_COUNT=$(git log "${PRIOR_TAG}..HEAD" --oneline | wc -l)
           else
@@ -242,7 +247,12 @@ jobs:
                             git tag --list 'v*' --sort=-version:refname | grep -vE 'latest|alpha|beta|rc' | head -1)
           CURRENT_VERSION=${CURRENT_VERSION#v}
           
-          if [[ $CUMULATIVE_COUNT -ge $NEW_RELEASE_THRESHOLD ]]; then
+          # Normalise v0.0.x → v0.1.0 (standard semver starting point)
+          if [[ "${{ github.event.inputs.normalize_version }}" != 'false' && "$CURRENT_VERSION" =~ ^0\.0\.[0-9]+$ ]]; then
+            echo "📐 Normalising v${CURRENT_VERSION} → v0.1.0 (standard semver convention)"
+            RELEASE_VERSION="0.1.0"
+            RELEASE_TYPE="new release"
+          elif [[ $CUMULATIVE_COUNT -ge $NEW_RELEASE_THRESHOLD ]]; then
             # Cumulative changes across re-releases exceed ceiling — bump patch version
             IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
             NEXT_VERSION="${MAJOR}.${MINOR}.$(( PATCH + 1 ))"
@@ -260,6 +270,7 @@ jobs:
           gh workflow run release.yml \
             --ref ${{ github.ref_name }} \
             -f version="${RELEASE_VERSION}" \
+            -f normalize_version="${{ github.event.inputs.normalize_version || 'true' }}" \
             -f prerelease=false \
             -f draft=false
           

workflows-templates/release.yml

@@ -116,6 +116,11 @@ on:
         required: false
         type: boolean
         default: false
+      normalize_version:
+        description: 'Normalise v0.0.x to v0.1.0 (uncheck to keep v0.0.x scheme)'
+        required: false
+        type: boolean
+        default: true
 
 permissions:
   contents: write
@@ -179,8 +184,14 @@ jobs:
                 MAJOR=${BASH_REMATCH[1]}
                 MINOR=${BASH_REMATCH[2]}
                 PATCH=${BASH_REMATCH[3]}
-                VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
-                echo "🔢 Auto-detected next version: ${VERSION} (from latest: v${LATEST})"
+                # Normalise v0.0.x → v0.1.0 (standard semver starting point)
+                if [[ "${{ github.event.inputs.normalize_version }}" != 'false' && "$MAJOR" -eq 0 && "$MINOR" -eq 0 ]]; then
+                  VERSION="0.1.0"
+                  echo "📐 Normalising v${LATEST} → v${VERSION} (standard semver convention)"
+                else
+                  VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
+                  echo "🔢 Auto-detected next version: ${VERSION} (from latest: v${LATEST})"
+                fi
               else
                 echo "❌ Could not determine latest version to auto-increment"
                 exit 1

workflows-templates/update.yml

@@ -90,6 +90,11 @@ on:
         required: false
         type: boolean
         default: false
+      normalize_version:
+        description: 'Normalise v0.0.x to v0.1.0 (uncheck to keep v0.0.x scheme)'
+        required: false
+        type: boolean
+        default: true
       check_dependencies:
         description: 'Check and update dependencies (package.json, requirements.txt)'
         required: false
@@ -203,7 +208,7 @@ jobs:
                       while read -r t; do
                         v="${t#v}"
                         [[ "$v" != "$LATEST_VERSION" ]] && echo "$t" && break
-                      done)
+                      done) || true
           if [[ -n "$PRIOR_TAG" ]]; then
             CUMULATIVE_COUNT=$(git log "${PRIOR_TAG}..HEAD" --oneline | wc -l)
           else
@@ -245,7 +250,12 @@ jobs:
                             git tag --list 'v*' --sort=-version:refname | grep -vE 'latest|alpha|beta|rc' | head -1)
           CURRENT_VERSION=${CURRENT_VERSION#v}
           
-          if [[ $CUMULATIVE_COUNT -ge $NEW_RELEASE_THRESHOLD ]]; then
+          # Normalise v0.0.x → v0.1.0 (standard semver starting point)
+          if [[ "${{ github.event.inputs.normalize_version }}" != 'false' && "$CURRENT_VERSION" =~ ^0\.0\.[0-9]+$ ]]; then
+            echo "📐 Normalising v${CURRENT_VERSION} → v0.1.0 (standard semver convention)"
+            RELEASE_VERSION="0.1.0"
+            RELEASE_TYPE="new release"
+          elif [[ $CUMULATIVE_COUNT -ge $NEW_RELEASE_THRESHOLD ]]; then
             # Cumulative changes across re-releases exceed ceiling — bump patch version
             IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
             NEXT_VERSION="${MAJOR}.${MINOR}.$(( PATCH + 1 ))"
@@ -263,6 +273,7 @@ jobs:
           gh workflow run release.yml \
             --ref ${{ github.ref_name }} \
             -f version="${RELEASE_VERSION}" \
+            -f normalize_version="${{ github.event.inputs.normalize_version || 'true' }}" \
             -f prerelease=false \
             -f draft=false