微信小程序页面迁移校验之前 P5任务处理之前

.kiro/scripts/_ensure_root.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""cwd 校验工具 — .kiro/scripts/ 下所有脚本共享。
+
+用法：
+    from _ensure_root import ensure_repo_root
+    ensure_repo_root()
+
+委托给 neozqyy_shared.repo_root（共享包），未安装时 fallback。
+"""
+from __future__ import annotations
+
+import os
+import warnings
+from pathlib import Path
+
+
+def ensure_repo_root() -> Path:
+    """校验 cwd 是否为仓库根目录，不是则自动切换。"""
+    try:
+        from neozqyy_shared.repo_root import ensure_repo_root as _shared
+        return _shared()
+    except ImportError:
+        pass
+    # fallback
+    cwd = Path.cwd()
+    if (cwd / "pyproject.toml").is_file() and (cwd / ".kiro").is_dir():
+        return cwd
+    root = Path(__file__).resolve().parents[2]
+    if (root / "pyproject.toml").is_file() and (root / ".kiro").is_dir():
+        os.chdir(root)
+        warnings.warn(
+            f"cwd 不是仓库根目录，已自动切换: {cwd} → {root}",
+            stacklevel=2,
+        )
+        return root
+    raise RuntimeError(
+        f"无法定位仓库根目录。当前 cwd={cwd}，推断 root={root}。"
+        f"请在仓库根目录下运行脚本。"
+    )