feat: auto-versioning from git tags and manual bump workflow

- Switch to hatch-vcs for automatic version from git tags
- Add bump-version.yml workflow (manual dispatch: patch/minor/major)
- Simplify release.yml to use uv build with hatch-vcs
- Exclude generated _version.py from git and ruff

Author: ivolnistov

.github/workflows/bump-version.yml

@@ -0,0 +1,57 @@
+name: Bump Version
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  bump:
+    name: Bump version and tag
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Required to read all tags
+
+    - name: Get latest version tag
+      id: current
+      run: |
+        TAG=$(git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -1)
+        echo "tag=${TAG:-v0.0.0}" >> $GITHUB_OUTPUT
+        echo "Current version: ${TAG:-v0.0.0}"
+
+    - name: Calculate next version
+      id: next
+      run: |
+        VERSION="${{ steps.current.outputs.tag }}"
+        VERSION="${VERSION#v}"
+        IFS='.' read -r MAJOR MINOR PATCH <<< "$VERSION"
+
+        case "${{ inputs.bump }}" in
+          major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
+          minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
+          patch) PATCH=$((PATCH + 1)) ;;
+        esac
+
+        NEXT="v${MAJOR}.${MINOR}.${PATCH}"
+        echo "version=$NEXT" >> $GITHUB_OUTPUT
+        echo "Next version: $NEXT"
+
+    - name: Create and push tag
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "github-actions[bot]@users.noreply.github.com"
+        git tag -a "${{ steps.next.outputs.version }}" -m "Release ${{ steps.next.outputs.version }}"
+        git push origin "${{ steps.next.outputs.version }}"
+        echo "Tagged and pushed ${{ steps.next.outputs.version }}"

.github/workflows/release.yml

@@ -16,21 +16,19 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Required for hatch-vcs to resolve version from tags
 
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
         python-version: '3.14'
 
-    - name: Install build tools
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install build
-        # Ensure git tags are available for versioning
-        git fetch --prune --unshallow --tags || true
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
 
     - name: Build package
-      run: python -m build
+      run: uv build
 
     - name: Publish to PyPI
       uses: pypa/gh-action-pypi-publish@release/v1
@@ -99,21 +97,19 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Required for hatch-vcs to resolve version from tags
 
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
         python-version: '3.14'
 
-    - name: Install build tools
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install build
-        # Ensure git tags are available for versioning
-        git fetch --prune --unshallow --tags || true
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
 
     - name: Build packages
-      run: python -m build
+      run: uv build
 
     - name: Upload wheel
       uses: actions/upload-artifact@v4
@@ -165,13 +161,10 @@ jobs:
           dist/*.whl
           dist/*.tar.gz
         body: |
-          ## 🚀 Release v${{ steps.version.outputs.VERSION }}
+          ## Release v${{ steps.version.outputs.VERSION }}
 
           ### Installation Options:
 
-          #### Direct Download
-          Download the packages attached to this release.
-
           #### PyPI
           ```bash
           # Using uvx (no installation required)

.gitignore

@@ -1,5 +1,6 @@
 # Python
 __pycache__/
+src/pararam_nexus_mcp/_version.py
 *.py[cod]
 *$py.class
 *.so

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pararam-nexus-mcp"
-version = "0.1.0"
+dynamic = ["version"]
 description = "Model Context Protocol server for pararam.io - a modern communication and collaboration platform"
 readme = "README.md"
 requires-python = ">=3.14"
@@ -55,9 +55,15 @@ dev = [
 ]
 
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/pararam_nexus_mcp/_version.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/pararam_nexus_mcp"]
 
@@ -70,6 +76,7 @@ exclude = [
     "__pycache__",
     "build",
     "dist",
+    "_version.py",
 ]
 line-length = 120
 indent-width = 4