refactor: simplify prepare-release to accept explicit version only

Remove patch/minor/major version arithmetic from prepare-release.yml.
Callers must now pass an explicit x.y.z semver string; the workflow
validates the format and fails fast on invalid input.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: olivermeyer

.github/CLAUDE.md

@@ -1018,9 +1018,6 @@ Releases use a four-phase workflow triggered from the developer's machine via `g
 **Phase 1 — Prepare the release branch** (triggers `prepare-release.yml`):
 
 ```bash
-make prepare-release patch   # 1.0.0 → 1.0.1
-make prepare-release minor   # 1.0.0 → 1.1.0
-make prepare-release major   # 1.0.0 → 2.0.0
 make prepare-release 1.2.3   # explicit version
 ```
 

.github/workflows/prepare-release.yml

@@ -3,8 +3,8 @@ name: "Prepare Release"
 on:
   workflow_dispatch:
     inputs:
-      version_part:
-        description: 'Version part to bump ("patch", "minor", "major") or an explicit "x.y.z" version'
+      version:
+        description: 'Version to release (e.g. "1.3.0")'
         required: true
         type: string
 
@@ -41,28 +41,20 @@ jobs:
           enable-cache: true
           cache-dependency-glob: uv.lock
 
-      - name: Compute next version
+      - name: Validate version
         id: version
         run: |
-          CURRENT=$(cat VERSION)
-          INPUT="${{ inputs.version_part }}"
-
-          if echo "$INPUT" | grep -qE '^\d+\.\d+\.\d+$'; then
-            NEW_VERSION="$INPUT"
-          else
-            MAJOR=$(echo "$CURRENT" | cut -d. -f1)
-            MINOR=$(echo "$CURRENT" | cut -d. -f2)
-            PATCH=$(echo "$CURRENT" | cut -d. -f3)
-            case "$INPUT" in
-              major) NEW_VERSION="$((MAJOR + 1)).0.0" ;;
-              minor) NEW_VERSION="${MAJOR}.$((MINOR + 1)).0" ;;
-              patch) NEW_VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))" ;;
-              *) echo "❌ Invalid version_part: '$INPUT'. Use patch, minor, major, or x.y.z."; exit 1 ;;
-            esac
+          INPUT="${{ inputs.version }}"
+
+          # Must be an explicit x.y.z semver
+          if ! echo "$INPUT" | grep -qE '^\d+\.\d+\.\d+$'; then
+            echo "❌ Invalid version: '$INPUT'. Must be an explicit semver like '1.3.0'."
+            exit 1
           fi
 
-          BRANCH_NAME="release/v${NEW_VERSION}"
-          echo "new_version=${NEW_VERSION}" >> "$GITHUB_OUTPUT"
+          CURRENT=$(cat VERSION)
+          BRANCH_NAME="release/v${INPUT}"
+          echo "new_version=${INPUT}" >> "$GITHUB_OUTPUT"
           echo "branch_name=${BRANCH_NAME}" >> "$GITHUB_OUTPUT"
           echo "current_version=${CURRENT}" >> "$GITHUB_OUTPUT"
 

CLAUDE.md

@@ -1281,7 +1281,7 @@ Releases follow a **four-phase GitHub workflow–based strategy** that allows Ke
 
 ```
 Phase 0 (anytime): Create the Ketryx release in the Ketryx portal
-Phase 1:           make prepare-release patch|minor|major|x.y.z
+Phase 1:           make prepare-release x.y.z
 Phase 2:           Point Ketryx release to release/vX.Y.Z; collect approvals
 Phase 3:           make publish-release
 Phase 4:           make merge-release
@@ -1292,9 +1292,6 @@ Phase 4:           make merge-release
 ```bash
 # Creates release/vX.Y.Z branch from main, bumps version files, and pushes.
 # No tag is created yet.
-make prepare-release patch   # 1.0.0 → 1.0.1
-make prepare-release minor   # 1.0.0 → 1.1.0
-make prepare-release major   # 1.0.0 → 2.0.0
 make prepare-release 1.2.3   # explicit version
 ```
 

CONTRIBUTING.md

@@ -129,9 +129,6 @@ Releases follow a four-phase workflow that allows Ketryx compliance approvals to
 **Phase 1 — Create the release branch:**
 
 ```shell
-make prepare-release patch   # 1.0.0 → 1.0.1
-make prepare-release minor   # 1.0.0 → 1.1.0
-make prepare-release major   # 1.0.0 → 2.0.0
 make prepare-release 1.2.3   # explicit version
 ```
 

Makefile

@@ -104,14 +104,14 @@ test_coverage_reset:
 	rm -rf reports/coverage*
 
 ## Trigger the prepare-release GitHub workflow to create a release/vX.Y.Z branch
-## Usage: make prepare-release patch|minor|major|x.y.z
+## Usage: make prepare-release x.y.z
 prepare-release:
-	$(eval VERSION_PART := $(filter-out $@,$(MAKECMDGOALS)))
-	@if [ -z "$(VERSION_PART)" ]; then \
-		echo "❌ Usage: make prepare-release patch|minor|major|x.y.z"; \
+	$(eval VERSION := $(filter-out $@,$(MAKECMDGOALS)))
+	@if [ -z "$(VERSION)" ]; then \
+		echo "❌ Usage: make prepare-release x.y.z"; \
 		exit 1; \
 	fi
-	gh workflow run prepare-release.yml --field version_part=$(VERSION_PART)
+	gh workflow run prepare-release.yml --field version=$(VERSION)
 	@echo "Workflow triggered. Monitor at: https://github.com/aignostics/python-sdk/actions"
 
 ## Trigger the publish-release GitHub workflow to generate changelog, tag, and push