fix(cli): derive runtime version from package metadata

Use importlib.metadata for CLI and module version reporting so displayed version always matches the installed distribution. Add regression tests for metadata and fallback behavior, and release as v0.1.9.

Made-with: Cursor

Author: wx-b

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentic-devkit"
-version = "0.1.8"
+version = "0.1.9"
 description = "CLI and catalog for agentic documentation OS templates (greenfield + brownfield overlay)"
 readme = "README.md"
 requires-python = ">=3.10"

src/agentic_devkit/__init__.py

@@ -1,3 +1,8 @@
 """Agentic dev CLI — init, overlay, and intake for agentic documentation OS templates."""
 
-__version__ = "0.1.7"
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("agentic-devkit")
+except PackageNotFoundError:
+    __version__ = "0+unknown"

src/agentic_devkit/cli.py

@@ -1,10 +1,10 @@
 """agentic-dev CLI: init, overlay, intake."""
+import importlib.metadata
 import os
 import subprocess
 import sys
 from pathlib import Path
 
-from . import __version__
 from .census import write_census_yaml
 
 DEFAULT_GREENFIELD = "gh:your-org/agentic-dev-greenfield"
@@ -50,6 +50,13 @@ def _run_copier(source: str, dest: Path) -> int:
     return subprocess.call([sys.executable, "-m", "copier", "copy", source, dest_str])
 
 
+def _package_version() -> str:
+    try:
+        return importlib.metadata.version("agentic-devkit")
+    except importlib.metadata.PackageNotFoundError:
+        return "0+unknown"
+
+
 def cmd_init(dest: str) -> int:
     """Create a new greenfield repo from template."""
     source = _greenfield_source()
@@ -125,7 +132,7 @@ def main() -> int:
         prog="agentic-dev",
         description="Init, overlay, or intake for the agentic documentation OS templates.",
     )
-    ap.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    ap.add_argument("--version", action="version", version=f"%(prog)s {_package_version()}")
     sub = ap.add_subparsers(dest="command", required=True)
 
     p_init = sub.add_parser("init", help="Create a new repo from greenfield template")

tests/test_cli_version.py

@@ -0,0 +1,14 @@
+from agentic_devkit import cli
+
+
+def test_package_version_reads_distribution_metadata(monkeypatch):
+    monkeypatch.setattr(cli.importlib.metadata, "version", lambda _: "9.9.9")
+    assert cli._package_version() == "9.9.9"
+
+
+def test_package_version_falls_back_when_distribution_missing(monkeypatch):
+    def _raise_not_found(_: str) -> str:
+        raise cli.importlib.metadata.PackageNotFoundError
+
+    monkeypatch.setattr(cli.importlib.metadata, "version", _raise_not_found)
+    assert cli._package_version() == "0+unknown"