"""阶段测试脚本的统一启动引导。

确保相对路径始终从项目根目录解析，并允许未执行
uv sync 时直接从 src 导入正式功能模块。
"""

from __future__ import annotations

import os
import sys
from pathlib import Path


PROJECT_ROOT = Path(__file__).resolve().parent.parent
SOURCE_ROOT = PROJECT_ROOT / "src"

# 让 test_step*.py 在未显式设置环境变量时能读取 .env（如 PROPOSA_WORK_DIR）。
try:
    from dotenv import load_dotenv

    load_dotenv(PROJECT_ROOT / ".env", override=False, encoding="utf-8-sig")
except Exception:
    pass

source_path = str(SOURCE_ROOT)
if source_path not in sys.path:
    sys.path.insert(0, source_path)

os.chdir(PROJECT_ROOT)