comate-cli 0.12.0b2__tar.gz → 0.12.0b3__tar.gz

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/CHANGELOG.md

@@ -26,6 +26,9 @@
   （2 个）的旧版本由下次启动后台试删回收。源码开发态（editable）拒绝自更新，PATH 无 uv
   时给出手动命令。版本检查新增预发布规则：装着 beta 的用户会被推荐下一个 beta，正式版
   用户永远看不到 beta；`comate update --pre` 可显式选择预发布版。
+- CLI 启动时把 uv 跳板（zipapp 形态的 `comate.exe`）从 `sys.path` 移除：此前
+  `importlib.metadata` 会把它当 zip 打开并缓存不关，Windows 上这个句柄让运行中的
+  comate 阻止自更新替换入口。从更早版本升级到本版时，其他旧窗口仍需关闭一次。
 - 新增 `/workflows` 独立全屏面板：跑次列表 → 跑次详情（阶段标题 + agent 行）→ agent 详情
   （prompt / 结果 / 错误 pager）三层导航，每秒轮询 run JSON live 刷新；`x` 对本会话发起的
   跑次两段式停止，非本会话 / 崩溃遗留的 running 行标记为「非本会话」且不可停；忙时可打开。

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comate-cli
-Version: 0.12.0b2
+Version: 0.12.0b3
 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

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/comate_cli/main.py

@@ -12,7 +12,28 @@ import sys
 import time
 import warnings
 
-from comate_cli.terminal_agent.exit_watchdog import ExitWatchdog
+
+def _drop_zipapp_launcher_from_sys_path() -> None:
+    """把 uv 跳板（zipapp 形态的 comate.exe）从 sys.path 移除。
+
+    uv 生成的入口是「跳板 exe + 附带 __main__.py 的 zip」，python 以 zipapp 方式运行它，
+    sys.path[0] 就是这个 exe。此后任何 importlib.metadata 调用都会用 ZipFile 打开它并
+    留在进程级缓存里永不关闭（CPython 3.11–3.13 的 FastPath.zip_children 把 zipfile.Path
+    的 bound method 挂到了 lru_cache 住的实例上）。Windows 上这个句柄不带
+    FILE_SHARE_DELETE，运行中的 comate 会让 Self-Update 的 Entrypoint Flip 无法 rename
+    入口（实机 handle64 证据，2026-09-10）。__main__ 已经加载完毕，移除对后续 import
+    无影响；源码树 / `-m` 运行时 sys.path[0] 是目录，不受影响。
+    """
+    if not sys.path:
+        return
+    head = sys.path[0]
+    if head and os.path.isfile(head):
+        del sys.path[0]
+
+
+_drop_zipapp_launcher_from_sys_path()
+
+from comate_cli.terminal_agent.exit_watchdog import ExitWatchdog  # noqa: E402
 
 # 进程启动锚点：在任何重三方库 import（anthropic/prompt_toolkit/rich）之前捕获，
 # 交给 StartupProfiler 测量「run() 之前的 import」这段以往不可见的启动成本。

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "comate-cli"
-version = "0.12.0b2"
+version = "0.12.0b3"
 description = "Comate terminal CLI built on comate-agent-sdk"
 readme = "README.md"
 requires-python = ">=3.11,<3.14"

comate_cli-0.12.0b3/tests/test_zipapp_launcher_path.py

@@ -0,0 +1,68 @@
+"""uv 跳板把 comate.exe 当 zipapp 运行时，必须把它从 sys.path 移除。
+
+为什么重要（Windows 实机 2026-09-10，handle64 证据）：`importlib.metadata` 扫描
+sys.path 时会用 ZipFile 打开 sys.path[0] 上的 shim，并把对象留在进程级 LRU 缓存里
+永不关闭；Windows 上这个句柄不带 FILE_SHARE_DELETE，Entrypoint Flip 的 rename 就会
+WinError 32。移除后 importlib.metadata 不再碰 shim，运行中的 comate 不再阻止自更新。
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+from comate_cli.main import _drop_zipapp_launcher_from_sys_path
+
+
+class TestDropZipappLauncherFromSysPath(unittest.TestCase):
+    def test_file_entry_at_head_is_removed(self) -> None:
+        with tempfile.NamedTemporaryFile(suffix=".exe", delete=False) as handle:
+            shim = handle.name
+        self.addCleanup(os.unlink, shim)
+        fake_path = [shim, "/site-packages"]
+        with patch.object(sys, "path", fake_path):
+            _drop_zipapp_launcher_from_sys_path()
+            self.assertEqual(sys.path, ["/site-packages"])
+
+    def test_directory_entry_is_untouched(self) -> None:
+        """源码树 / `python -m` 运行时 sys.path[0] 是目录，不能误删。"""
+        with tempfile.TemporaryDirectory() as tmp:
+            fake_path = [tmp, "/site-packages"]
+            with patch.object(sys, "path", fake_path):
+                _drop_zipapp_launcher_from_sys_path()
+                self.assertEqual(sys.path, [tmp, "/site-packages"])
+
+    def test_empty_or_missing_entry_is_untouched(self) -> None:
+        for fake_path in ([], ["", "/site-packages"], [str(Path("/definitely/missing.exe"))]):
+            with self.subTest(path=fake_path):
+                with patch.object(sys, "path", list(fake_path)):
+                    _drop_zipapp_launcher_from_sys_path()
+                    self.assertEqual(sys.path, fake_path)
+
+    def test_importlib_metadata_no_longer_opens_the_launcher(self) -> None:
+        """端到端：扫描元数据后，进程不再持有 shim 的文件对象。"""
+        import gc
+        import importlib.metadata
+        import zipfile
+
+        with tempfile.TemporaryDirectory() as tmp:
+            shim = Path(tmp) / "fake-shim.exe"
+            with zipfile.ZipFile(shim, "w") as archive:
+                archive.writestr("__main__.py", "pass\n")
+            importlib.metadata.FastPath.__new__.cache_clear()
+            with patch.object(sys, "path", [str(shim), *sys.path]):
+                _drop_zipapp_launcher_from_sys_path()
+                importlib.metadata.version("packaging")
+            open_zips = [
+                obj for obj in gc.get_objects()
+                if isinstance(obj, zipfile.ZipFile) and obj.filename == str(shim) and obj.fp
+            ]
+            self.assertEqual(open_zips, [])
+
+
+if __name__ == "__main__":
+    unittest.main()

comate_cli-0.12.0b3/tools/diagnose_windows_shim_rename.py

@@ -0,0 +1,122 @@
+"""诊断：为什么运行中的 uv 跳板 comate.exe 不能被 rename（WinError 32）。
+
+只用标准库。在真实 Windows 上运行：
+    python diagnose_windows_shim_rename.py [--command comate]
+
+每一步都把 shim 改回原名，不留副作用：
+  T0 没有任何 comate 在跑时 rename（基线，应成功）
+  T1 另一个 comate 进程（`--rpc-stdio` 常驻）在跑时立即 rename
+  T2 同上，但连续重试 10 次 × 0.5s（区分「瞬时占用」与「持续占用」）
+  T3 若 PATH 上有 Sysinternals handle64.exe，列出谁占着这个文件
+  T4 常驻进程退出后再 rename（应恢复成功）
+  T5 绕过 uv 跳板：直接用 venv 的 python.exe 把 shim 当 zip 跑起来再 rename。
+     T5 成功 = 跳板进程在占文件；T5 失败 = python（zipimport）在占文件。
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+import shutil
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+logging.basicConfig(level=logging.INFO, format="%(message)s", stream=sys.stdout)
+logger = logging.getLogger("diagnose_windows_shim_rename")
+
+
+def try_rename(shim: Path, label: str, *, attempts: int = 1, delay_s: float = 0.0) -> bool:
+    target = shim.with_name(f"{shim.name}.old.diag")
+    last: OSError | None = None
+    for i in range(attempts):
+        try:
+            os.replace(shim, target)
+            os.replace(target, shim)  # 立刻改回去
+            logger.info("[OK]   %s  (attempt %d)", label, i + 1)
+            return True
+        except OSError as exc:
+            last = exc
+            if delay_s:
+                time.sleep(delay_s)
+    logger.info("[FAIL] %s  %r", label, last)
+    return False
+
+
+def list_holders(shim: Path) -> None:
+    handle = shutil.which("handle64") or shutil.which("handle")
+    if handle is None:
+        logger.info("  (PATH 上没有 Sysinternals handle64.exe，跳过占用者列举；"
+                    "可从 https://learn.microsoft.com/sysinternals/downloads/handle 下载后重跑)")
+        return
+    out = subprocess.run([handle, "-accepteula", "-nobanner", shim.name],
+                         capture_output=True, text=True, timeout=60)
+    logger.info("  handle 输出：\n%s", out.stdout.strip() or out.stderr.strip())
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--command", default="comate")
+    args = parser.parse_args()
+    if sys.platform != "win32":
+        logger.info("必须在 Windows 上运行（当前 %s）", sys.platform)
+        return 2
+    raw = shutil.which(args.command)
+    if raw is None:
+        logger.info("PATH 上找不到 %s", args.command)
+        return 2
+    shim = Path(raw)
+    logger.info("shim: %s  (%d bytes)", shim, shim.stat().st_size)
+
+    try_rename(shim, "T0 baseline（无 comate 运行）")
+
+    logger.info("启动一个常驻的 comate 进程（--rpc-stdio，stdin 挂起）...")
+    proc = subprocess.Popen(
+        [str(shim), "--rpc-stdio"],
+        stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+    )
+    try:
+        time.sleep(4.0)  # 等 python 子进程完成 import
+        if proc.poll() is not None:
+            logger.info("常驻进程提前退出 rc=%s，T1/T2 无效", proc.returncode)
+        try_rename(shim, "T1 另一个 comate 运行中，立即 rename")
+        try_rename(shim, "T2 另一个 comate 运行中，重试 10 次 × 0.5s", attempts=10, delay_s=0.5)
+        logger.info("T3 谁占着这个文件：")
+        list_holders(shim)
+    finally:
+        proc.kill()
+        proc.wait(timeout=10)
+    time.sleep(1.0)
+    try_rename(shim, "T4 常驻进程退出后 rename")
+
+    uv = shutil.which("uv")
+    if uv is None:
+        logger.info("T5 跳过：PATH 上没有 uv")
+        return 0
+    ver = subprocess.run([uv, "--version"], capture_output=True, text=True, timeout=30)
+    logger.info("uv 版本：%s", (ver.stdout or ver.stderr).strip())
+    tool_dir = subprocess.run([uv, "tool", "dir"], capture_output=True, text=True, timeout=30)
+    venv_python = Path(tool_dir.stdout.strip()) / "comate-cli" / "Scripts" / "python.exe"
+    if not venv_python.is_file():
+        logger.info("T5 跳过：找不到 %s", venv_python)
+        return 0
+    logger.info("T5 用 %s 直接跑 shim（不经过跳板）...", venv_python)
+    proc = subprocess.Popen(
+        [str(venv_python), str(shim), "--rpc-stdio"],
+        stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+    )
+    try:
+        time.sleep(4.0)
+        if proc.poll() is not None:
+            logger.info("T5 进程提前退出 rc=%s，结果无效", proc.returncode)
+        try_rename(shim, "T5 python 直接跑 shim（无跳板）时 rename")
+    finally:
+        proc.kill()
+        proc.wait(timeout=10)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/tools/verify_windows_self_update_semantics.py

@@ -13,6 +13,9 @@
   A3 内含运行中进程的目录 rmtree 必然失败（试删探测的依据）
   A4 UV_TOOL_DIR/UV_TOOL_BIN_DIR 旁装对默认 uv tool 布局零接触，且产出 bin shim
   A5 旁装 shim 复制到其他目录后仍可独立运行（自包含）
+  A6 旁装 shim 以 --rpc-stdio 常驻运行时，其文件仍可 rename（要求被装版本
+     >= 0.12.0b2：启动即把 zipapp shim 从 sys.path 移除，否则 importlib.metadata
+     会持有句柄；旧版本此项必 FAIL，是已知事实而非设计缺陷）
 """
 
 from __future__ import annotations
@@ -141,6 +144,36 @@ def verify_uv_side_install(package: str, command: str) -> None:
                     run.returncode == 0 and "Usage" in run.stdout,
                     f"rc={run.returncode} out={run.stdout[:200]!r} err={run.stderr[:200]!r}",
                 )
+                verify_running_shim_rename(copied)
+
+
+def verify_running_shim_rename(shim: Path) -> None:
+    """A6：真实 shim 常驻运行时 rename 自身文件——Entrypoint Flip 的前提。"""
+    proc = subprocess.Popen(
+        [str(shim), "--rpc-stdio"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    try:
+        time.sleep(4.0)
+        if proc.poll() is not None:
+            check("A6 运行中的 shim 可 rename", False, f"常驻进程提前退出 rc={proc.returncode}")
+            return
+        renamed = shim.with_name(f"{shim.name}.old.verify")
+        try:
+            os.replace(shim, renamed)
+            os.replace(renamed, shim)
+            check("A6 运行中的 shim 可 rename", True)
+        except OSError as exc:
+            check(
+                "A6 运行中的 shim 可 rename",
+                False,
+                f"{exc!r}（被装版本若 < 0.12.0b2 属已知：importlib.metadata 持有 zipapp 句柄）",
+            )
+    finally:
+        proc.kill()
+        proc.wait(timeout=10)
 
 
 def main() -> int:

{comate_cli-0.12.0b2 → comate_cli-0.12.0b3}/uv.lock

@@ -379,7 +379,7 @@ dev = [
 
 [[package]]
 name = "comate-cli"
-version = "0.12.0b2"
+version = "0.12.0b3"
 source = { editable = "." }
 dependencies = [
     { name = "charset-normalizer" },