core/tools: prefer instance workspace and session todo views

tests/test_tools/test_workspace_instance.py

@@ -0,0 +1,47 @@
+"""Workspace root prefers bound InstanceState when set."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from plyngent.tools.context import InstanceState, bind_instance
+from plyngent.tools.workspace import (
+    WorkspaceError,
+    clear_workspace_root,
+    get_workspace_root,
+    set_workspace_root,
+)
+
+
+def test_get_workspace_prefers_instance(tmp_path: Path) -> None:
+    clear_workspace_root()
+    other = tmp_path / "other"
+    other.mkdir()
+    _ = set_workspace_root(tmp_path)
+    instance = InstanceState(workspace_root=other)
+    with bind_instance(instance):
+        assert get_workspace_root() == other.resolve()
+    assert get_workspace_root() == tmp_path.resolve()
+    clear_workspace_root()
+
+
+def test_set_workspace_mirrors_to_bound_instance(tmp_path: Path) -> None:
+    clear_workspace_root()
+    instance = InstanceState()
+    with bind_instance(instance):
+        path = set_workspace_root(tmp_path)
+        assert instance.workspace_root == path
+        assert get_workspace_root() == path
+    clear_workspace_root()
+
+
+def test_clear_clears_bound_instance(tmp_path: Path) -> None:
+    instance = InstanceState()
+    with bind_instance(instance):
+        _ = set_workspace_root(tmp_path)
+        clear_workspace_root()
+        assert instance.workspace_root is None
+        with pytest.raises(WorkspaceError):
+            _ = get_workspace_root()