refactor: Remove extract_version script, parse from PR title instead

Simplify the release workflow by parsing versions directly from the PR title
instead of maintaining a separate script to extract from CHANGELOG.md.

Benefits:
- No custom scripts needed - one less moving part
- Uses the version explicitly approved in the PR title
- Simpler and more maintainable
- Consistent with the principle of minimal scripting

The create-release-tags workflow now extracts versions using grep -oP directly
from the PR title format: 'Release: setuptools-scm vX.Y.Z, vcs-versioning vX.Y.Z'

Updated documentation to reflect that no custom scripts are required.

Author: RonnyPfannschmidt

.github/scripts/extract_version.py

@@ -130,6 +130,7 @@ The workflow system is designed with these principles:
 4. **Project-prefixed tags** - Enable monorepo releases (`project-vX.Y.Z`)
 5. **Automated but controlled** - Automation with human approval gates
 6. **Fail fast** - No fallback values; workflows fail explicitly if required data is missing
+7. **No custom scripts** - Uses PR title parsing and built-in tools only
 
 ## Version Bump Logic
 

.github/workflows/README.md

@@ -39,21 +39,17 @@ jobs:
           set -e
 
           TAGS_CREATED=""
+          PR_TITLE="${{ github.event.pull_request.title }}"
 
           # Check if we should release setuptools-scm
           if echo "${{ toJson(github.event.pull_request.labels.*.name) }}" | grep -q "release:setuptools-scm"; then
-            cd setuptools-scm
-
-            if [ ! -f "CHANGELOG.md" ]; then
-              echo "ERROR: CHANGELOG.md not found for setuptools-scm"
-              exit 1
-            fi
-
-            VERSION=$(python ../.github/scripts/extract_version.py CHANGELOG.md)
+            # Extract version from PR title: "Release: setuptools-scm v9.3.0, ..."
+            VERSION=$(echo "$PR_TITLE" | grep -oP 'setuptools-scm v\K[0-9]+\.[0-9]+\.[0-9]+')
 
             if [ -z "$VERSION" ]; then
-              echo "ERROR: Failed to extract version from setuptools-scm CHANGELOG.md"
-              echo "The CHANGELOG.md file must contain a version heading"
+              echo "ERROR: Failed to extract setuptools-scm version from PR title"
+              echo "PR title: $PR_TITLE"
+              echo "Expected format: 'Release: setuptools-scm vX.Y.Z'"
               exit 1
             fi
 
@@ -66,24 +62,17 @@ jobs:
             TAGS_CREATED="$TAGS_CREATED $TAG"
             echo "setuptools_scm_tag=$TAG" >> $GITHUB_OUTPUT
             echo "setuptools_scm_version=$VERSION" >> $GITHUB_OUTPUT
-
-            cd ..
           fi
 
           # Check if we should release vcs-versioning
           if echo "${{ toJson(github.event.pull_request.labels.*.name) }}" | grep -q "release:vcs-versioning"; then
-            cd vcs-versioning
-
-            if [ ! -f "CHANGELOG.md" ]; then
-              echo "ERROR: CHANGELOG.md not found for vcs-versioning"
-              exit 1
-            fi
-
-            VERSION=$(python ../.github/scripts/extract_version.py CHANGELOG.md)
+            # Extract version from PR title: "Release: ..., vcs-versioning v0.2.0"
+            VERSION=$(echo "$PR_TITLE" | grep -oP 'vcs-versioning v\K[0-9]+\.[0-9]+\.[0-9]+')
 
             if [ -z "$VERSION" ]; then
-              echo "ERROR: Failed to extract version from vcs-versioning CHANGELOG.md"
-              echo "The CHANGELOG.md file must contain a version heading"
+              echo "ERROR: Failed to extract vcs-versioning version from PR title"
+              echo "PR title: $PR_TITLE"
+              echo "Expected format: 'Release: vcs-versioning vX.Y.Z'"
               exit 1
             fi
 
@@ -96,8 +85,6 @@ jobs:
             TAGS_CREATED="$TAGS_CREATED $TAG"
             echo "vcs_versioning_tag=$TAG" >> $GITHUB_OUTPUT
             echo "vcs_versioning_version=$VERSION" >> $GITHUB_OUTPUT
-
-            cd ..
           fi
 
           echo "tags_created=$TAGS_CREATED" >> $GITHUB_OUTPUT

.github/workflows/create-release-tags.yml

@@ -97,15 +97,21 @@ jobs:
 
 ### 6. Helper Scripts ✅
 
-**Only one simple script:**
-- `.github/scripts/extract_version.py` - Extracts version from CHANGELOG.md after towncrier builds it
+**No custom scripts needed!** ✅
+
+All version handling is done through:
+- Version scheme for version calculation
+- PR title parsing for tag creation
+- vcs-versioning CLI for querying versions
 
 **Removed duplicate logic:**
 - ❌ No version bump calculation scripts
 - ❌ No duplicate version determination logic
 - ❌ No fallback values or default versions
+- ❌ No helper scripts for version extraction
 - ✅ Version scheme is the **single source of truth**
 - ✅ Workflows fail explicitly if required data is missing
+- ✅ Simple PR title parsing for tags
 
 ### 7. Comprehensive Documentation ✅