comate-cli 0.3.4__tar.gz → 0.3.7__tar.gz

{comate_cli-0.3.4 → comate_cli-0.3.7}/.gitignore

@@ -223,4 +223,6 @@ __marimo__/
 ./tmp/
 
 # OS generated files
+.DS_Store
 .DS_Store.worktrees/
+.superpowers/

{comate_cli-0.3.4 → comate_cli-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.3.4
+Version: 0.3.7
 Summary: Comate terminal CLI built on comate-agent-sdk
 Project-URL: Homepage, https://github.com/AndyLee1024/agent-sdk
 Project-URL: Repository, https://github.com/AndyLee1024/agent-sdk
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.11
 Requires-Dist: comate-agent-sdk<1.0.0,>=0.0.2
+Requires-Dist: packaging>=25.0
 Requires-Dist: prompt-toolkit>=3.0
 Requires-Dist: rich>=14.0
 Description-Content-Type: text/markdown

{comate_cli-0.3.4 → comate_cli-0.3.7}/comate_cli/terminal_agent/app.py

@@ -60,7 +60,7 @@ def _is_chinese_locale() -> bool:
 async def _check_update() -> str | None:
     """异步检查 comate-cli 是否有新版本，返回提示字符串或 None。
 
-    中文 locale 自动使用腾讯云镜像源，其余使用官方 PyPI。
+    中文 locale 自动使用清华 TUNA 镜像源，其余使用官方 PyPI。
     """
     package = "comate-cli"
     try:
@@ -86,8 +86,8 @@ async def _check_update() -> str | None:
         return None
 
     try:
-        from importlib.metadata import version as _v
         from packaging.version import Version
+
         if Version(latest) > Version(current):
             return (
                 f"[dim] New version available: [bold cyan]{latest}[/] "
@@ -95,7 +95,12 @@ async def _check_update() -> str | None:
                 f"Run [bold green]uv tool upgrade {package}[/] to upgrade.[/]"
             )
     except Exception:
-        pass
+        logger.debug(
+            "update comparison failed (current=%s, latest=%s)",
+            current,
+            latest,
+            exc_info=True,
+        )
     return None
 
 

{comate_cli-0.3.4 → comate_cli-0.3.7}/comate_cli/terminal_agent/path_context_hint.py

@@ -34,9 +34,11 @@ def build_path_context_hint(text: str, project_root: Path) -> str | None:
 
         try:
             if candidate.is_dir():
-                hint_lines.append(_describe_dir(raw_path, candidate))
+                desc = _describe_dir(raw_path, candidate)
+                hint_lines.append(f"{desc} [{candidate}]")
             elif candidate.is_file():
-                hint_lines.append(_describe_file(raw_path, candidate))
+                desc = _describe_file(raw_path, candidate)
+                hint_lines.append(f"{desc} [{candidate}]")
             else:
                 # Not found — only include if path looks like a filesystem path
                 if "/" in raw_path or "." in raw_path:

{comate_cli-0.3.4 → comate_cli-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "comate-cli"
-version = "0.3.4"
+version = "0.3.7"
 description = "Comate terminal CLI built on comate-agent-sdk"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -25,6 +25,7 @@ dependencies = [
     "comate-agent-sdk>=0.0.2,<1.0.0",
     "rich>=14.0",
     "prompt-toolkit>=3.0",
+    "packaging>=25.0",
 ]
 
 [project.urls]

{comate_cli-0.3.4 → comate_cli-0.3.7}/tests/test_path_context_hint.py

@@ -104,3 +104,26 @@ class TestBuildPathContextHint(unittest.TestCase):
         link.symlink_to(target)  # target doesn't exist
         hint = build_path_context_hint("check @link.txt", self.root)
         self.assertIn("not found", hint)
+
+    def test_file_hint_includes_absolute_path(self) -> None:
+        """File hints should include [absolute_path] suffix."""
+        f = self.root / "demo.py"
+        f.write_text("x\n")
+        hint = build_path_context_hint("check @demo.py", self.root)
+        expected_abs = str(f.resolve())
+        self.assertIn(f"[{expected_abs}]", hint)
+
+    def test_dir_hint_includes_absolute_path(self) -> None:
+        """Directory hints should include [absolute_path] suffix."""
+        d = self.root / "src"
+        d.mkdir()
+        (d / "a.py").write_text("x")
+        hint = build_path_context_hint("check @src/", self.root)
+        expected_abs = str(d.resolve())
+        self.assertIn(f"[{expected_abs}]", hint)
+
+    def test_not_found_has_no_absolute_path(self) -> None:
+        """'not found' lines should NOT include [absolute_path] suffix."""
+        hint = build_path_context_hint("read @missing.txt", self.root)
+        self.assertIn("not found", hint)
+        self.assertNotIn("[", hint.split("not found")[1])

comate_cli-0.3.7/tests/test_update_check.py

@@ -0,0 +1,152 @@
+from __future__ import annotations
+
+import tomllib
+import unittest
+from pathlib import Path
+from types import SimpleNamespace
+from unittest.mock import AsyncMock, MagicMock, patch
+
+from comate_cli.terminal_agent import app as app_module
+from comate_cli.terminal_agent.preflight import PreflightResult
+
+
+class _FakeResponse:
+    def __init__(self, latest: str) -> None:
+        self._latest = latest
+
+    def raise_for_status(self) -> None:
+        return None
+
+    def json(self) -> dict[str, object]:
+        return {"info": {"version": self._latest}}
+
+
+class _FakeClient:
+    def __init__(self, latest: str) -> None:
+        self._latest = latest
+
+    async def __aenter__(self) -> _FakeClient:
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb) -> bool:
+        return False
+
+    async def get(self, url: str) -> _FakeResponse:
+        return _FakeResponse(self._latest)
+
+
+class _FailingClient:
+    async def __aenter__(self) -> _FailingClient:
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb) -> bool:
+        return False
+
+    async def get(self, url: str) -> _FakeResponse:
+        raise RuntimeError("boom")
+
+
+class TestCheckUpdate(unittest.IsolatedAsyncioTestCase):
+    async def test_check_update_returns_hint_when_latest_is_newer(self) -> None:
+        with (
+            patch.object(app_module, "_is_chinese_locale", return_value=False),
+            patch.object(app_module.importlib.metadata, "version", return_value="0.3.3"),
+            patch("httpx.AsyncClient", side_effect=lambda **_: _FakeClient("0.3.6")),
+        ):
+            hint = await app_module._check_update()
+
+        self.assertIsNotNone(hint)
+        assert hint is not None
+        self.assertIn("0.3.6", hint)
+        self.assertIn("0.3.3", hint)
+        self.assertIn("uv tool upgrade comate-cli", hint)
+
+    async def test_check_update_returns_none_when_versions_match(self) -> None:
+        with (
+            patch.object(app_module, "_is_chinese_locale", return_value=False),
+            patch.object(app_module.importlib.metadata, "version", return_value="0.3.6"),
+            patch("httpx.AsyncClient", side_effect=lambda **_: _FakeClient("0.3.6")),
+        ):
+            hint = await app_module._check_update()
+
+        self.assertIsNone(hint)
+
+    async def test_check_update_logs_and_returns_none_on_network_error(self) -> None:
+        with (
+            patch.object(app_module, "_is_chinese_locale", return_value=False),
+            patch.object(app_module.importlib.metadata, "version", return_value="0.3.3"),
+            patch("httpx.AsyncClient", side_effect=lambda **_: _FailingClient()),
+            self.assertLogs(app_module.logger, level="DEBUG") as logs,
+        ):
+            hint = await app_module._check_update()
+
+        self.assertIsNone(hint)
+        self.assertTrue(
+            any("update check failed" in message for message in logs.output),
+            logs.output,
+        )
+
+    async def test_run_prints_update_hint(self) -> None:
+        session = MagicMock()
+        session.get_mode.return_value = "default"
+        session.get_usage = AsyncMock(
+            return_value=SimpleNamespace(
+                total_prompt_tokens=0,
+                total_prompt_cached_tokens=0,
+                total_completion_tokens=0,
+                total_reasoning_tokens=0,
+            )
+        )
+
+        renderer = MagicMock()
+        logging_session = MagicMock()
+        status_bar = MagicMock()
+        tui = MagicMock()
+        tui.run = AsyncMock()
+        tui.session = session
+        tui.initialized_session_id = None
+
+        with (
+            patch.object(
+                app_module,
+                "run_preflight_if_needed",
+                AsyncMock(return_value=PreflightResult(status="configured")),
+            ),
+            patch.object(app_module, "_build_agent", return_value=MagicMock()),
+            patch.object(app_module, "print_logo"),
+            patch.object(app_module, "EventRenderer", return_value=renderer),
+            patch("comate_cli.terminal_agent.logging_adapter.setup_tui_logging", return_value=logging_session),
+            patch.object(app_module, "_resolve_session", return_value=(session, "new")),
+            patch.object(app_module, "_check_update", AsyncMock(return_value="[dim] New version available: 0.3.6[/]")),
+            patch.object(app_module, "StatusBar", return_value=status_bar),
+            patch.object(app_module, "TerminalAgentTUI", return_value=tui),
+            patch.object(app_module, "_graceful_shutdown", AsyncMock()),
+            patch.object(app_module.console, "print") as mock_console_print,
+            patch.object(app_module.random, "choice", return_value="test-tip"),
+        ):
+            await app_module.run()
+
+        self.assertTrue(
+            any(
+                "New version available" in str(call.args[0])
+                for call in mock_console_print.call_args_list
+                if call.args
+            ),
+            mock_console_print.call_args_list,
+        )
+
+
+class TestCliPyproject(unittest.TestCase):
+    def test_pyproject_declares_packaging_runtime_dependency(self) -> None:
+        pyproject_path = Path(__file__).resolve().parents[1] / "pyproject.toml"
+        data = tomllib.loads(pyproject_path.read_text(encoding="utf-8"))
+        dependencies = data["project"]["dependencies"]
+
+        self.assertTrue(
+            any(str(dep).startswith("packaging") for dep in dependencies),
+            dependencies,
+        )
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

{comate_cli-0.3.4 → comate_cli-0.3.7}/uv.lock

@@ -364,7 +364,7 @@ wheels = [
 
 [[package]]
 name = "comate-agent-sdk"
-version = "0.3.3"
+version = "0.3.4"
 source = { editable = "../../" }
 dependencies = [
     { name = "aiohttp" },
@@ -433,6 +433,7 @@ version = "0.3.4"
 source = { editable = "." }
 dependencies = [
     { name = "comate-agent-sdk" },
+    { name = "packaging" },
     { name = "prompt-toolkit" },
     { name = "rich" },
 ]
@@ -445,6 +446,7 @@ dev = [
 [package.metadata]
 requires-dist = [
     { name = "comate-agent-sdk", editable = "../../" },
+    { name = "packaging", specifier = ">=25.0" },
     { name = "prompt-toolkit", specifier = ">=3.0" },
     { name = "rich", specifier = ">=14.0" },
 ]