Allow for pep440 releases

Author: markdlv-sf

.github/workflows/released_version_check.yml

@@ -0,0 +1,33 @@
+name: Released Version Check
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  check-stable-resolution:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Wait for PyPI indexing
+      run: sleep 180
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install from PyPI (no --pre)
+      run: |
+        python -m venv /tmp/check-venv
+        /tmp/check-venv/bin/pip install salesforce-data-customcode
+
+    - name: Verify resolved version is stable
+      run: |
+        VERSION=$(/tmp/check-venv/bin/pip show salesforce-data-customcode | grep ^Version: | awk '{print $2}')
+        echo "Resolved version: $VERSION"
+        if echo "$VERSION" | grep -qE '(\.dev|a|b|rc)[0-9]+'; then
+          echo "::error::pip install (no --pre) resolved to pre-release version: $VERSION"
+          exit 1
+        fi
+        echo "Version $VERSION is stable."

CONTRIBUTING.md

@@ -78,6 +78,17 @@ See the [Prerequisites section in README.md](./README.md#prerequisites) for comp
 
    **Tip**: See the [README.md](./README.md) for additional `datacustomcode` commands (`scan`, `deploy`, `zip`) to test specific code paths and validate your SDK changes thoroughly.
 
+## Versioning and Pre-Releases
+
+This project uses [PEP 440](https://peps.python.org/pep-0440/) version syntax. Versions are derived automatically from git tags via `poetry-dynamic-versioning`.
+
+- **Stable releases** use tags like `v4.1.0` → published as `4.1.0` on PyPI.
+- **Pre-releases** use tags like `v4.1.0.dev1`, `v4.1.0rc1` → published as `4.1.0.dev1`, `4.1.0rc1` on PyPI.
+
+Pre-release versions are **never** resolved by `pip install salesforce-data-customcode` unless the user explicitly passes `--pre`. This ensures customers always get stable releases by default.
+
+A Github Action (`Released Version Check`) runs after every publish to verify that bare `pip install` still resolves to a stable version.
+
 ## Makefile Commands
 
 ```bash

pyproject.toml

@@ -134,7 +134,7 @@ datacustomcode = "datacustomcode.cli:cli"
 [tool.poetry-dynamic-versioning]
 enable = true
 pattern = "^v(?P<base>.+)$"
-style = "semver"
+style = "pep440"
 vcs = "git"
 
 [tool.pytest.ini_options]