Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

fix(version): mark source-checkout builds as -dev (#2072)

Tejas Chopra1cc99792ac08
diff --git a/headroom/_version.py b/headroom/_version.py
index 1c50487c1..863df0ed2 100644
--- a/headroom/_version.py
+++ b/headroom/_version.py
@@ -107,7 +107,10 @@ def get_version() -> str:
if root is not None:
source_version = _source_tree_version(root)
if source_version:
- return source_version
+ # A source checkout sits ahead of the last release tag, so this is
+ # the next version we'd cut, not a shipped one. Tag it -dev so a
+ # dev build is never mistaken for the published release.
+ return f"{source_version}-dev"
build_version = _packaged_build_version()
if build_version:
diff --git a/headroom/cli/wrap.py b/headroom/cli/wrap.py
index 12b1b8140..816ab1bbe 100644
--- a/headroom/cli/wrap.py
+++ b/headroom/cli/wrap.py
@@ -2683,7 +2683,9 @@ def _proxy_needs_version_restart(payload: dict[str, Any] | None) -> bool:
"""Return True when a running Headroom proxy uses a different package version."""
running_version = _proxy_version(payload)
running_release = _normalize_release_version(running_version)
- current_release = _normalize_release_version(_HEADROOM_VERSION)
+ # -dev is a display marker for source builds; compare the base release so a
+ # dev CLI still restarts a stale proxy on a real version difference.
+ current_release = _normalize_release_version(_HEADROOM_VERSION.removesuffix("-dev"))
return (
running_release is not None
and current_release is not None
diff --git a/tests/test_cli/test_wrap_persistent.py b/tests/test_cli/test_wrap_persistent.py
index ba463469e..648386cab 100644
--- a/tests/test_cli/test_wrap_persistent.py
+++ b/tests/test_cli/test_wrap_persistent.py
@@ -163,6 +163,32 @@ def test_ensure_proxy_restarts_idle_stale_persistent_deployment(monkeypatch) ->
assert calls == ["restart:default:8787"]
+def test_ensure_proxy_restarts_stale_proxy_from_dev_build(monkeypatch) -> None:
+ """A source (-dev) CLI still restarts a stale proxy: the -dev marker is
+ display-only and must not disable a real version-mismatch restart."""
+ calls: list[str] = []
+ health = {
+ "version": "0.0.1",
+ "runtime": {"websocket_sessions": {"active_sessions": 0, "active_relay_tasks": 0}},
+ "config": {"pid": 12345},
+ }
+ monkeypatch.setattr(wrap_cli, "_HEADROOM_VERSION", "0.32.0-dev")
+ monkeypatch.setattr(wrap_cli, "_find_persistent_manifest", lambda port: _Manifest())
+ monkeypatch.setattr("headroom.install.health.probe_ready", lambda url: True)
+ monkeypatch.setattr(wrap_cli, "_query_proxy_health", lambda port: health)
+ monkeypatch.setattr(
+ wrap_cli,
+ "_restart_persistent_proxy",
+ lambda manifest, port: calls.append(f"restart:{manifest.profile}:{port}") or True,
+ )
+
+ proc, actual_port = wrap_cli._ensure_proxy(8787, False)
+
+ assert proc is None
+ assert actual_port == 8787
+ assert calls == ["restart:default:8787"]
+
+
def test_ensure_proxy_leaves_active_stale_persistent_deployment_running(monkeypatch) -> None:
health = {
"version": "0.0.1",
diff --git a/tests/test_package_init_lazy.py b/tests/test_package_init_lazy.py
index 7a320137e..b03b6cce7 100644
--- a/tests/test_package_init_lazy.py
+++ b/tests/test_package_init_lazy.py
@@ -131,7 +131,9 @@ def test_version_prefers_source_tree_release_history() -> None:
patch.object(version_module, "_source_tree_version", return_value="0.21.17"),
patch.object(version_module, "version", return_value="0.9.1") as package_version,
):
- assert version_module.get_version() == "0.21.17"
+ # Source checkouts are marked -dev so a dev build is never mistaken
+ # for the published release.
+ assert version_module.get_version() == "0.21.17-dev"
package_version.assert_not_called()