fix: simplify release workflow to use proper semantic-release approach

- Remove overcomplicated custom logic with version checks and conditionals
- Use single 'semantic-release version' command as per official documentation
- Eliminate redundant tasks: release:publish, release:setup-git, release:check-version, release:full
- Simplify to single 'task release' that does everything semantic-release is designed to do
- Remove GitHub Actions output logic since semantic-release handles everything internally
- Fix release workflow to follow official python-semantic-release documentation

This resolves the fundamental misunderstanding of how semantic-release works:
- semantic-release version: does EVERYTHING (check, version, commit, tag, release)
- semantic-release publish: only for uploading artifacts, not releasing

Based on: https://python-semantic-release.readthedocs.io/en/latest/configuration/automatic-releases/github-actions.html#gh-actions-examples

Author: chutch3

.github/workflows/release.yml

@@ -56,22 +56,12 @@ jobs:
         id: release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          task release:full
-          # Set GitHub Actions outputs for downstream jobs
-          if [ -f .version.txt ] && [ "$(cat .version.txt)" != "0.0.0" ]; then
-            echo "released=true" >> $GITHUB_OUTPUT
-            echo "version=$(cat .version.txt)" >> $GITHUB_OUTPUT
-            echo "tag=v$(cat .version.txt)" >> $GITHUB_OUTPUT
-          else
-            echo "released=false" >> $GITHUB_OUTPUT
-          fi
+        run: task release
 
   update-lock:
     name: Update Poetry Lock
     runs-on: ubuntu-latest
     needs: release
-    if: needs.release.outputs.released == 'true'
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -102,7 +92,8 @@ jobs:
 
       - name: Update Poetry lock file
         run: |
-          task release:setup-git
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
           task release:update-lock
           # Push changes if any were made
           if [ -n "$(git log --oneline HEAD~1..HEAD | grep 'chore: update poetry.lock')" ]; then

Taskfile.yml

@@ -82,44 +82,12 @@ tasks:
     cmds:
       - poetry run semantic-release version --print
 
-  release:publish:
-    desc: Publish a new release
-    cmds:
-      - poetry run semantic-release publish
-
-  release:setup-git:
-    desc: Configure Git for automated releases
+  release:
+    desc: Run semantic release (determines if release needed and executes)
     cmds:
       - git config --global user.name "github-actions[bot]"
       - git config --global user.email "github-actions[bot]@users.noreply.github.com"
-
-  release:check-version:
-    desc: Check if a new version should be released and output result
-    cmds:
-      - |
-        poetry run semantic-release version --print > .version.txt 2>/dev/null || echo "0.0.0" > .version.txt
-        if [ "$(cat .version.txt)" != "0.0.0" ]; then
-          echo "New version: $(cat .version.txt)"
-          echo "SHOULD_RELEASE=true" >> $GITHUB_ENV
-          echo "NEW_VERSION=$(cat .version.txt)" >> $GITHUB_ENV
-          echo "NEW_TAG=v$(cat .version.txt)" >> $GITHUB_ENV
-        else
-          echo "No release necessary"
-          echo "SHOULD_RELEASE=false" >> $GITHUB_ENV
-        fi
-
-  release:full:
-    desc: Complete release workflow (check, publish if needed)
-    cmds:
-      - task: release:setup-git
-      - task: release:check-version
-      - |
-        if [ "${SHOULD_RELEASE:-false}" = "true" ]; then
-          echo "Publishing release..."
-          task release:publish
-        else
-          echo "Skipping release - no changes requiring version bump"
-        fi
+      - poetry run semantic-release version
 
   release:update-lock:
     desc: Update Poetry lock file after release