[project]
name = "mcm26b"
version = "0.2.0"
description = "CUMCM 2026 B题：无线电干扰源的快速自动定位与清除（协议基线、几何内核与策略骨架）"
readme = "README.md"
requires-python = ">=3.10"
dependencies = [
    "requests>=2.31",
]

[dependency-groups]
dev = [
    "optuna>=5.0.0",
    "pytest>=8",
    # 独立评测机（自建模拟器）：仅测试侧依赖，运行时代码零导入（懒加载 + 守卫测试）
    "mcm26b-referee",
]
rl = [
    "gymnasium>=1.1",
    "sb3-contrib==2.9.0",
    "stable-baselines3>=2.6",
    "torch==2.11.0",
]

# uv 工作区：referee/ 是独立包（零第三方依赖、不依赖 mcm26b），双方仅通过 HTTP 协议耦合
[tool.uv.workspace]
members = ["referee"]

# RL 训练使用 CUDA 12.8 版 PyTorch（本机 RTX 4060；运行时依赖保持轻量）。
[[tool.uv.index]]
name = "pytorch-cu128"
url = "https://download.pytorch.org/whl/cu128"
explicit = true

[tool.uv.sources]
mcm26b-referee = { workspace = true }
# CUDA 12.8 版 PyTorch 仅限 Windows/Linux（RTX 4060 训练机）；
# macOS (Apple Silicon, MPS) 回落到 PyPI 官方轮子。
torch = [
  { index = "pytorch-cu128", marker = "sys_platform == 'linux' or sys_platform == 'win32'" },
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.hatch.build.targets.wheel]
packages = ["src/mcm26b"]

[project.scripts]
mcm26b = "mcm26b.cli:main"

[tool.pytest.ini_options]
testpaths = ["tests", "referee/tests"]

# ---------------------------------------------------------------------------
# pylint：全仓库静态检查口径
#
# 目标：`python -m pylint src scripts project tests referee main.py` 拿 10.00/10。
# 原则：真实的逻辑 / 资源 / 命名 / 死代码问题一律改代码；下面 disable 的每一条
# 都对应项目刻意的设计选择或已确认的静态分析误报，并写明理由，不做"一键静音"。
# ---------------------------------------------------------------------------
[tool.pylint.main]
py-version = "3.10"
jobs = 0
# 不写 ~/Library/Caches/pylint：CI 与受限沙箱里没有该目录，会刷警告
persistent = false
recursive = true
ignore = [".venv", ".uv-cache", "output"]

[tool.pylint.format]
max-line-length = 100

[tool.pylint.design]
# 阈值按"实际最长函数 + 余量"设定，而不是关闭检查：超过即说明该拆了
max-args = 14
max-positional-arguments = 10
max-locals = 45
max-branches = 26
max-statements = 180
max-attributes = 32
max-nested-blocks = 6
max-returns = 12
max-module-lines = 4000
min-public-methods = 0

[tool.pylint.basic]
# 这些是既有代码里的短名/别名（importorskip 后的模块句柄、几何单字母常量、
# 坐标系里的 x/y/z），让命名检查接受它们。
# 注意：good-names 不覆盖 redefined-builtin——stdlib 回调签名里的 `format`
# 之类只能在对应 def 上写行内 disable（见 server.py / referee 的 log_message）。
good-names = [
    "i", "j", "k", "n", "m", "x", "y", "z", "_", "ex",
    "id", "pytest", "numpy", "S", "ROOT", "FONT", "ET",
]
# http.server 要求 do_GET/do_POST 这类方法名，不能改成 snake_case
method-rgx = "[a-z_][a-z0-9_]{2,49}$|do_(GET|POST|PUT|DELETE|HEAD|PATCH|OPTIONS)$"

[tool.pylint."messages control"]
disable = [
    # —— 项目刻意风格 ——
    "missing-module-docstring",       # 内部小模块与 __main__ 不强制
    "missing-class-docstring",
    "missing-function-docstring",
    "import-outside-toplevel",        # torch/SB3/referee 等重依赖与可选依赖懒加载
    "wrong-import-position",          # 同上：importorskip 守卫后的延迟导入
    "ungrouped-imports",              # 同上：延迟导入无法与顶部导入分组
    "broad-exception-caught",         # 子进程 / IO / HTTP 边界防御式兜底，逐处注释
    "protected-access",               # 测试与 mixin 有意检查内部状态
    "duplicate-code",                 # 脚本与测试夹具存在结构性相似，非复制粘贴缺陷
    "redefined-outer-name",           # pytest 要求测试参数与 fixture 同名
    "attribute-defined-outside-init", # 轻量对象在 helper 里补字段
    "multiple-statements",            # 单行守卫 (if x: return) 是可读性选择
    "use-dict-literal",               # dict(...) 与 {...} 混用是既有风格
    "abstract-method",                # 无头训练环境不需要实现 gym.Env.render
    # —— 已确认的静态分析误报 ——
    "possibly-used-before-assignment",  # pytest.importorskip 成功即赋值，skip 会抛异常
]