feat(release): enhance workflow dispatch with release type options and improve documentation

Author: krypton-byte

.github/workflows/release.yml

@@ -32,6 +32,7 @@ jobs:
           echo "ref=${GITHUB_REF}"
           echo "actor=${GITHUB_ACTOR}"
           echo "default_branch=${{ github.event.repository.default_branch }}"
+          echo "release_type=${{ github.event.inputs.release_type || 'auto' }}"
 
       - uses: actions/checkout@v4
         with:

CONTRIBUTING.md

@@ -110,10 +110,11 @@ Use this rule of thumb for automatic versioning:
 How to trigger semantic release until publish to PyPI:
 
 1. Push commits to default branch (direct push or merged PR), using Conventional Commit messages.
-2. Open GitHub Actions and run `Semantic Release` on default branch.
-3. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
-4. Workflow creates the corresponding GitHub Release.
-5. CI workflow runs on that tag and publishes artifacts to PyPI.
+2. Open GitHub Actions and run `Semantic Release` on the default branch.
+3. Choose `release_type`: `auto` (default) for commit-based bump, or `patch`/`minor`/`major` to force bump manually.
+4. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
+5. Workflow creates the corresponding GitHub Release.
+6. CI workflow runs on that tag and publishes artifacts to PyPI.
 
 Manual fallback (if needed):