ctrlrelay 0.1.6__tar.gz → 0.1.7__tar.gz

{ctrlrelay-0.1.6 → ctrlrelay-0.1.7}/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-04-20
+
+Patch release. Fixes one drift bug in how the package reports its own
+version — the `__version__` string was pinned to a literal in
+`__init__.py` and never got bumped alongside releases, so `ctrlrelay
+version` on an installed 0.1.6 wheel still reported `0.1.4`. No API
+or behavior changes.
+
+### Fixed
+
+- **`__version__` now derives from installed metadata** (`closes
+  #94`). `ctrlrelay.__version__` resolves via
+  `importlib.metadata.version("ctrlrelay")` at import time so it
+  tracks the installed wheel's `pyproject.toml` automatically.
+  Source-checkout pytest runs (where no dist-info exists because
+  `pythonpath = ["src"]` is the only mechanism putting the package on
+  `sys.path`) fall back to parsing the sibling `pyproject.toml` with
+  `tomllib` — so the drift-catcher test
+  (`test_version_matches_pyproject`) still sees a real version
+  instead of a `0.0.0+unknown` placeholder.
+
+### Operator notes
+
+- No migration or restart guidance. Upgrade via `uv tool upgrade
+  ctrlrelay` (or `pip install -U ctrlrelay`) and the next `ctrlrelay
+  version` will report `0.1.7`.
+
 ## [0.1.6] - 2026-04-20
 
 The "pipeline reliability + operator control" release. Closes three

{ctrlrelay-0.1.6 → ctrlrelay-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctrlrelay
-Version: 0.1.6
+Version: 0.1.7
 Summary: Local-first orchestrator for headless coding agents across multiple GitHub repos
 Project-URL: Homepage, https://github.com/AInvirion/ctrlrelay
 Project-URL: Documentation, https://ainvirion.github.io/ctrlrelay/

{ctrlrelay-0.1.6 → ctrlrelay-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ctrlrelay"
-version = "0.1.6"
+version = "0.1.7"
 description = "Local-first orchestrator for headless coding agents across multiple GitHub repos"
 readme = "README.md"
 requires-python = ">=3.12"

ctrlrelay-0.1.7/src/ctrlrelay/__init__.py

@@ -0,0 +1,33 @@
+"""ctrlrelay: Local-first orchestrator for headless coding agents."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from ctrlrelay.core import checkpoint
+
+
+def _resolve_version() -> str:
+    try:
+        return version("ctrlrelay")
+    except PackageNotFoundError:
+        # Source checkout with no installed dist-info — e.g. a bare
+        # `pytest tests/` with pyproject's `pythonpath = ["src"]` as the
+        # only mechanism putting the package on sys.path. Fall back to
+        # parsing pyproject.toml so the drift-catcher test still sees a
+        # real version instead of a placeholder.
+        import tomllib
+        from pathlib import Path
+
+        pyproject = Path(__file__).resolve().parents[2] / "pyproject.toml"
+        if pyproject.is_file():
+            try:
+                with pyproject.open("rb") as f:
+                    return tomllib.load(f)["project"]["version"]
+            except (OSError, KeyError, tomllib.TOMLDecodeError):
+                pass
+        return "0.0.0+unknown"
+
+
+__version__ = _resolve_version()
+
+# Public API
+__all__ = ["__version__", "checkpoint"]

ctrlrelay-0.1.7/tests/test_cli_version.py

@@ -0,0 +1,49 @@
+"""Tests for the version command."""
+
+import re
+import tomllib
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from ctrlrelay import __version__
+from ctrlrelay.cli import app
+
+runner = CliRunner()
+
+SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+([.\-+].+)?$")
+
+
+class TestVersionCommand:
+    def test_version_command_succeeds(self) -> None:
+        """ctrlrelay version should exit with code 0."""
+        result = runner.invoke(app, ["version"])
+
+        assert result.exit_code == 0
+
+    def test_version_command_prints_version(self) -> None:
+        """ctrlrelay version should print the package version."""
+        result = runner.invoke(app, ["version"])
+
+        assert __version__ in result.output
+
+    def test_version_matches_semver_shape(self) -> None:
+        """__version__ should look like a real version, not a literal placeholder."""
+        assert SEMVER_RE.match(__version__), (
+            f"__version__={__version__!r} does not match semver-like shape"
+        )
+
+    def test_version_matches_pyproject(self) -> None:
+        """__version__ must match pyproject.toml so published wheels don't lie.
+
+        Catches the drift that caused issue #94: bumping pyproject.toml on each
+        release while forgetting to bump a hardcoded string in __init__.py.
+        """
+        pyproject_path = Path(__file__).resolve().parents[1] / "pyproject.toml"
+        pyproject = tomllib.loads(pyproject_path.read_text())
+        expected = pyproject["project"]["version"]
+
+        assert __version__ == expected, (
+            f"__version__={__version__!r} diverges from pyproject.toml version "
+            f"{expected!r} — did a release bump one but not the other?"
+        )

ctrlrelay-0.1.6/src/ctrlrelay/__init__.py

@@ -1,8 +0,0 @@
-"""ctrlrelay: Local-first orchestrator for Claude Code."""
-
-from ctrlrelay.core import checkpoint
-
-__version__ = "0.1.3"
-
-# Public API
-__all__ = ["__version__", "checkpoint"]

ctrlrelay-0.1.6/tests/test_cli_version.py

@@ -1,22 +0,0 @@
-"""Tests for the version command."""
-
-from typer.testing import CliRunner
-
-from ctrlrelay import __version__
-from ctrlrelay.cli import app
-
-runner = CliRunner()
-
-
-class TestVersionCommand:
-    def test_version_command_succeeds(self) -> None:
-        """ctrlrelay version should exit with code 0."""
-        result = runner.invoke(app, ["version"])
-
-        assert result.exit_code == 0
-
-    def test_version_command_prints_version(self) -> None:
-        """ctrlrelay version should print the package version."""
-        result = runner.invoke(app, ["version"])
-
-        assert __version__ in result.output