fix: Allow test versions to exceed main release version, add debug output --test --v 0.0.8

Author: 0xAhmadYousuf

.github/workflows/publish_python.yml

@@ -145,11 +145,23 @@ jobs:
         shell: bash
       - name: Resolve Release Meta
         run: |
+          echo "Resolving release metadata..."
           if [ -n "${{ env.CUSTOM_VERSION }}" ]; then
             python libs/python/tools/release_meta.py --mode "${{ env.RELEASE_MODE }}" --force "${{ env.FORCE_RELEASE }}" --version "${{ env.CUSTOM_VERSION }}" >> $GITHUB_ENV
           else
             python libs/python/tools/release_meta.py --mode "${{ env.RELEASE_MODE }}" --force "${{ env.FORCE_RELEASE }}" >> $GITHUB_ENV
           fi
+        shell: bash
+      - name: Debug Environment Variables
+        run: |
+          echo "=== Release Configuration ==="
+          echo "PY_VERSION: ${{ env.PY_VERSION }}"
+          echo "RELEASE_MODE: ${{ env.RELEASE_MODE }}"
+          echo "SKIP_PUBLISH: ${{ env.SKIP_PUBLISH }}"
+          echo "PRERELEASE: ${{ env.PRERELEASE }}"
+          echo "CUSTOM_VERSION: ${{ env.CUSTOM_VERSION }}"
+          echo "============================"
+        shell: bash
       - name: Set Tag Name
         run: |
           if [ "${{ env.RELEASE_MODE }}" = "test" ]; then

libs/python/tools/release_meta.py

@@ -80,8 +80,9 @@ def main():
 
     main_tag = latest_tag("v", repo_root)
     main_version = parse_version(main_tag) if main_tag else None
-    if main_version and version and version > main_version:
-        raise RuntimeError("Release note version exceeds main release tag")
+    # Only check version constraint for actual releases, not test/beta/alpha
+    if mode == "release" and main_version and version and version <= main_version:
+        raise RuntimeError(f"Release version {version_str} must be greater than current main tag {main_tag}")
 
     version_str = ".".join(str(x) for x in version)
     prerelease = mode in {"test", "beta", "alpha"}