[Boundary Refactor][L3-cpp] 清理模块边界与依赖职责（Phase 1）

[ShuhaoZhangTony]

背景

当前 SAGE 体系在该仓库存在边界职责不够清晰的风险，需要执行一次“无兼容层优先”的深度梳理。

• Repository: sage-amms
• Layer: L3-cpp
• Heavy deps signal: torch

目标

1. 明确该仓库在分层架构中的唯一职责（做什么 / 不做什么）。
2. 移除或下沉越层实现，避免 L 层反向依赖。
3. 删除不必要兼容层（re-export/fallback/shim），直接改调用方。
4. 依赖最小化：只保留当前层真实运行所需依赖。

Phase 1 可执行任务（manageable）

• 产出边界清单：in-scope / out-of-scope / forbidden imports
• 盘点跨层调用与动态导入点（含 CLI、tests、scripts）
• 标记兼容层并给出移除顺序与受影响调用方
• 依赖审计：pyproject.toml 与运行时 import 一致性
• 拆分为 3~6 个子改造 PR（每个 PR 可独立回归）

非目标

• 不在本 issue 内一次性重写全部功能；仅完成边界梳理、拆分计划与第一批落地改造。

验收标准

• 有书面边界定义（README/ARCHITECTURE/DEVELOPER 文档之一）
• 删除至少 1 个不必要兼容层或越层路径
• 依赖清单有删减或明确保留理由
• 测试与 lint 全绿（按本仓库既有门禁）
• 新增后续子 issue/PR checklist 并可追踪

约束

• Flownet-first（不新增 ray）
• 不创建 .venv/venv
• fail-fast，禁止静默 fallback
• 避免新增过渡兼容层，优先直接更新调用方

[ShuhaoZhangTony]

回填子任务 #4：

• 链接：[Wave C][amms][C1] AMM接口/实现边界清理与目录分层 #4
• 完成内容：清理 AMMS 包入口与 wrapper 的 ImportError 兼容分支，保持显式导入与 fail-fast 边界。
• 新增：tests/test_issue4_boundary_cleanup.py 与 ADR 0002。
• 验证：ruff + pytest（issue4/issue5）通过，4 passed。

结论：#4 范围内接口/实现边界问题已消除，无新增兼容层。

[ShuhaoZhangTony]

子任务 #5 已完成：清理 CUDA/CPU 路径中的兼容分支。

完成项：

• 删除冗余构建入口：sage/libs/amms/implementations/setup.py
• 构建入口收敛到 root setup.py
• 构建能力改为显式开关（AMMS_ENABLE_CUDA=0/1），并在缺前置条件时 fail-fast
• 文档同步更新 README.md
• 新增回归测试 tests/test_issue5_cuda_cpu_switch_cleanup.py
• 新增 ADR docs/adr/0001-clean-cuda-cpu-build-compat-branches.md

验证：

• ruff 检查通过（目标改动文件）
• pytest 定向回归 2 passed

详情见：#5