fix: improve setup wizard behavior (#127)

* fix: improve setup wizard behavior

* fix: derive runtime versions from release metadata

* test: validate metabase source mapping requirements

* Fix boundary check release identifiers

python/ktx-daemon/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ktx-daemon"
-version = "0.1.0"
+version = "0.0.0+private"
 description = "Portable compute package for KTX semantic-layer operations"
 readme = "README.md"
 requires-python = ">=3.13"

python/ktx-daemon/src/ktx_daemon/__init__.py

@@ -1,6 +1,28 @@
 """Portable compute package for KTX."""
 
-PACKAGE_NAME = "ktx-daemon"
-VERSION = "0.1.0"
+from collections.abc import Callable
+from importlib.metadata import PackageNotFoundError, version
 
-__all__ = ["PACKAGE_NAME", "VERSION"]
+PACKAGE_NAME = "ktx-daemon"
+RUNTIME_DISTRIBUTION_NAME = "kaelio-ktx"
+
+
+def resolve_package_version(
+    version_loader: Callable[[str], str] = version,
+) -> str:
+    for distribution_name in (RUNTIME_DISTRIBUTION_NAME, PACKAGE_NAME):
+        try:
+            return version_loader(distribution_name)
+        except PackageNotFoundError:
+            continue
+    return "0.0.0+local"
+
+
+VERSION = resolve_package_version()
+
+__all__ = [
+    "PACKAGE_NAME",
+    "RUNTIME_DISTRIBUTION_NAME",
+    "VERSION",
+    "resolve_package_version",
+]

python/ktx-daemon/src/ktx_daemon/app.py

@@ -10,6 +10,7 @@ from typing import Any
 from fastapi import FastAPI, HTTPException
 from fastapi.responses import Response
 
+from ktx_daemon import VERSION
 from ktx_daemon.code_execution import (
     ExecuteCodeRequest,
     ExecuteCodeResponse,
@@ -84,7 +85,7 @@ def create_app(
     app = FastAPI(
         title="KTX Daemon",
         description="Stateless portable compute server for KTX.",
-        version="0.1.0",
+        version=VERSION,
     )
 
     @app.get("/health")

python/ktx-daemon/tests/test_package.py

@@ -1,6 +1,19 @@
-from ktx_daemon import PACKAGE_NAME, VERSION
+from ktx_daemon import PACKAGE_NAME, VERSION, resolve_package_version
 
 
 def test_package_metadata() -> None:
     assert PACKAGE_NAME == "ktx-daemon"
-    assert VERSION == "0.1.0"
+    assert VERSION == resolve_package_version()
+
+
+def test_package_version_prefers_bundled_runtime_distribution() -> None:
+    calls: list[str] = []
+
+    def fake_version(distribution_name: str) -> str:
+        calls.append(distribution_name)
+        if distribution_name == "kaelio-ktx":
+            return "0.1.0rc1"
+        raise AssertionError(f"unexpected distribution lookup: {distribution_name}")
+
+    assert resolve_package_version(version_loader=fake_version) == "0.1.0rc1"
+    assert calls == ["kaelio-ktx"]