fix: extract VERSION via file parsing instead of Python import

Replace the namespace-package import (`from src.X import __version__`)
with a helper script that reads __init__.py directly. The script
resolves the file path relative to its own location, avoiding CWD and
import-mechanism issues on Windows. Includes ZENABLE_LOGLEVEL=DEBUG
support for diagnostics.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: JonZeolla

.github/workflows/ci.yml

@@ -105,6 +105,8 @@ jobs:
   windows-smoke-test:
     name: Windows Smoke Test
     runs-on: windows-latest
+    env:
+      ZENABLE_LOGLEVEL: DEBUG
     steps:
       # Note: no checkout step. The cookiecutter template directory contains
       # characters (pipe, quotes) that are illegal on NTFS, so we cannot check

{{cookiecutter.project_name|replace(" ", "")}}/Taskfile.yml

@@ -14,7 +14,7 @@ vars:
   PYTHON_VERSION: {{ cookiecutter.python_version }}
   SUPPORTED_PLATFORMS: 'linux/amd64,linux/arm64'
   VERSION:
-    sh: uv run python -c "import sys; sys.path.insert(0, 'src'); from {{ '{{.PROJECT_SLUG}}' }} import __version__; print(__version__)"
+    sh: "{{ '{{.RUN_SCRIPT}}' }} {{ '{{.SCRIPTS_DIR}}' }}/get_version.py {{ '{{.PROJECT_SLUG}}' }}"
   RUN_SCRIPT: 'uv run --frozen'
   SCRIPTS_DIR: 'scripts'
   LOCAL_PLATFORM:

{{cookiecutter.project_name|replace(" ", "")}}/scripts/get_version.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""Extract __version__ from the project's __init__.py without importing it.
+
+This avoids import-mechanism issues (namespace packages, venv state, etc.)
+that can occur cross-platform.  The script locates the file relative to its
+own position in the repo so it works regardless of the caller's CWD.
+"""
+
+import os
+import pathlib
+import re
+import sys
+
+FALLBACK = "0.0.0"
+
+
+def _debug(msg: str) -> None:
+    if os.environ.get("ZENABLE_LOGLEVEL", "").upper() == "DEBUG":
+        print(f"get_version: {msg}", file=sys.stderr)
+
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        print(FALLBACK)
+        sys.exit(0)
+
+    project_slug = sys.argv[1]
+
+    # Resolve relative to this script's location (scripts/ -> project root)
+    script_dir = pathlib.Path(__file__).resolve().parent
+    project_root = script_dir.parent
+    init_file = project_root / "src" / project_slug / "__init__.py"
+
+    _debug(f"cwd={os.getcwd()}")
+    _debug(f"script_dir={script_dir}")
+    _debug(f"project_root={project_root}")
+    _debug(f"init_file={init_file} exists={init_file.exists()}")
+
+    if not init_file.exists():
+        _debug(f"init file not found, falling back to {FALLBACK}")
+        print(FALLBACK)
+        sys.exit(0)
+
+    text = init_file.read_text(encoding="utf-8")
+    match = re.search(r'__version__\s*=\s*"(.+?)"', text)
+    if match:
+        print(match.group(1))
+    else:
+        _debug(f"no __version__ found in {init_file}, falling back to {FALLBACK}")
+        print(FALLBACK)
+
+
+if __name__ == "__main__":
+    main()