refactor: use HOTDATA_WORKSPACE env var

Revert to the canonical HOTDATA_WORKSPACE name for explicit
workspace selection, matching the CLI and other adapters.

Author: eddietejeda

CONTRACT.md

@@ -63,7 +63,7 @@ Adapters should import from `hotdata_runtime` and treat this surface as the stab
 - `default_api_key()` reads `HOTDATA_API_KEY`.
 - `default_host()` reads `HOTDATA_API_URL` (default: `https://api.hotdata.dev`) and normalizes it.
 - `default_session_id()` reads `HOTDATA_SANDBOX`.
-- `explicit_workspace_id()` reads `HOTDATA_WORKSPACE_ID` (workspace public id).
+- `explicit_workspace_id()` reads `HOTDATA_WORKSPACE` (workspace public id).
 - `pick_workspace()` prefers explicit env workspace, then active workspace, then first workspace.
 - `resolve_workspace_selection()` is the canonical workspace selection algorithm. It returns `WorkspaceSelection` with selected workspace id, selection source, and discovered workspaces when auto-selected.
 

hotdata_runtime/env.py

@@ -23,7 +23,7 @@ def default_api_key() -> str:
 
 
 def explicit_workspace_id() -> str | None:
-    return os.environ.get("HOTDATA_WORKSPACE_ID")
+    return os.environ.get("HOTDATA_WORKSPACE")
 
 
 def default_host() -> str:

tests/test_client.py

@@ -25,15 +25,15 @@ def test_normalize_host(raw: str, expected: str):
     assert normalize_host(raw) == expected
 
 
-def test_pick_workspace_prefers_workspace_id_env(monkeypatch: pytest.MonkeyPatch):
-    monkeypatch.setenv("HOTDATA_WORKSPACE_ID", "ws_explicit")
+def test_pick_workspace_prefers_env(monkeypatch: pytest.MonkeyPatch):
+    monkeypatch.setenv("HOTDATA_WORKSPACE", "ws_explicit")
     assert pick_workspace("k", "https://api.hotdata.dev", None) == "ws_explicit"
 
 
 def test_resolve_workspace_selection_prefers_env_without_listing(
     monkeypatch: pytest.MonkeyPatch,
 ):
-    monkeypatch.setenv("HOTDATA_WORKSPACE_ID", "ws_explicit")
+    monkeypatch.setenv("HOTDATA_WORKSPACE", "ws_explicit")
     with patch("hotdata_runtime.env.list_workspaces") as listing:
         resolved = resolve_workspace_selection(
             "k", "https://api.hotdata.dev", None
@@ -46,7 +46,7 @@ def test_resolve_workspace_selection_prefers_env_without_listing(
 
 
 def test_pick_workspace_chooses_first_active(monkeypatch: pytest.MonkeyPatch):
-    monkeypatch.delenv("HOTDATA_WORKSPACE_ID", raising=False)
+    monkeypatch.delenv("HOTDATA_WORKSPACE", raising=False)
 
     items = [
         SimpleNamespace(public_id="ws_1", active=False),
@@ -61,7 +61,7 @@ def test_pick_workspace_chooses_first_active(monkeypatch: pytest.MonkeyPatch):
 
 
 def test_pick_workspace_falls_back_to_first(monkeypatch: pytest.MonkeyPatch):
-    monkeypatch.delenv("HOTDATA_WORKSPACE_ID", raising=False)
+    monkeypatch.delenv("HOTDATA_WORKSPACE", raising=False)
 
     items = [
         SimpleNamespace(public_id="ws_1", active=False),
@@ -75,7 +75,7 @@ def test_pick_workspace_falls_back_to_first(monkeypatch: pytest.MonkeyPatch):
 
 
 def test_resolve_workspace_selection_source_first(monkeypatch: pytest.MonkeyPatch):
-    monkeypatch.delenv("HOTDATA_WORKSPACE_ID", raising=False)
+    monkeypatch.delenv("HOTDATA_WORKSPACE", raising=False)
     items = [
         SimpleNamespace(public_id="ws_1", active=False),
         SimpleNamespace(public_id="ws_2", active=False),
@@ -94,7 +94,7 @@ def test_resolve_workspace_selection_source_first(monkeypatch: pytest.MonkeyPatc
 def test_resolve_workspace_selection_returns_workspaces_and_source(
     monkeypatch: pytest.MonkeyPatch,
 ):
-    monkeypatch.delenv("HOTDATA_WORKSPACE_ID", raising=False)
+    monkeypatch.delenv("HOTDATA_WORKSPACE", raising=False)
 
     items = [
         SimpleNamespace(public_id="ws_1", active=False),