[Code Health] A5 HBG AICore 调度：全部功能实现后删除 legacy 回退路径 #2861

最新进展（2026-11-11）

状态：OPEN，legacy 回退仍存在，继续等待剩余功能与组合验收。 负责人 @poursoul。

• 前置功能：[Feature] A5 HBG AICore 调度：支持 Graph body 原生执行 #2830 Graph、[Feature] A5 HBG AICore 调度：支持异步任务 deferred completion #2832 deferred completion 已交付；[Feature] A5 HBG AICore 调度：补齐多 block 与 MIX predicate 支持 #2831 多 block/MIX predicate、[Feature] A5 HBG AICore 调度：支持 early dispatch #2867 resident early dispatch、[Feature] A5 HBG AICore 调度：支持 Host、AICPU 初始化与 AICore 运行流水重叠 #2927 两层流水仍开放。
• main 0569c7796b86 的Host 模式选择仍包含 select_legacy_scheduler、LEGACY_GRAPH、LEGACY_UNSUPPORTED_SHAPE；AICPU 入口仍调用 legacy_aicpu_execute。Add: support nonblocking defer_wait in A5 HBG #2967/Refactor: simplify A5 HBG scheduling and compact shared state #2989 合入不代表回退路径已删除。
• Refactor: simplify A5 HBG scheduling and compact shared state #2989 清理了历史／实验诊断兼容格式并统一当前 v10/v11 合同，这部分协议整理已交付；它与本项的 legacy runtime executor 清理范围不同。

下一步： 完成剩余三项功能及约定组合验收，再按最终 main 的可达调用与构建引用删除旧调度入口、专用 executor、配置和测试依赖。保留当前有效 runtime variants／支持功能，接口与 producer、consumer、测试、文档同步更新。

Category

Technical Debt (cleanup, refactor)

Component

Other (please specify in description)

Description

在 #2667 的全部功能实现并完成验收后，删除 A5 host_build_graph AICore scheduling 工作线保留的 legacy AICPU 调度回退路径，使该范围内的任务统一通过 AICore resident Scheduler 执行。

父 Issue：#2667。沿用工作线负责人 @poursoul。本项是功能补齐后的收尾清理，不能以关闭回退入口代替功能实现，也不能把父 Issue 已关闭作为开始清理的前提。

当前功能子项：

• [Feature] A5 HBG AICore 调度：支持 Graph body 原生执行 #2830：Graph body 原生执行，已完成。
• [Feature] A5 HBG AICore 调度：补齐多 block 与 MIX predicate 支持 #2831：多 block / SPMD 与 MIX predicate 支持。
• [Feature] A5 HBG AICore 调度：支持异步任务 deferred completion #2832：异步任务 deferred completion，已由 Add: support nonblocking defer_wait in A5 HBG #2967 交付并按功能验收完成。
• [Feature] A5 HBG AICore 调度：支持 early dispatch #2867：early dispatch。
• [Feature] A5 HBG AICore 调度：支持 Host、AICPU 初始化与 AICore 运行流水重叠 #2927：Host、AICPU 初始化与 AICore 调度运行的流水重叠。

以上子项及 #2667 最终约定范围内的其余功能、组合语义和消费者交接完成后，再执行本项。普通 SPMD / sync-start 已有 #2785 的集成记录；清理时应依据最终集成版本盘点剩余回退入口，不沿用早期实现的能力边界。

Location

• src/a5/runtime/host_build_graph/host/runtime_maker.cpp：select_legacy_scheduler 及 capability / runtime mode 选择。
• src/a5/runtime/host_build_graph/aicpu/aicpu_executor.cpp、aicpu/aicpu_legacy_executor.cpp：legacy AICPU 分流和调度实现。
• src/a5/runtime/host_build_graph/aicore/aicore_executor.cpp、aicore/aicore_legacy_executor.cpp：legacy AICore 分流和执行实现。
• 同 runtime 下的 runtime/scheduler/、构建配置及相关测试、文档；具体删除清单以最终集成版本的调用关系为准。

Proposed Fix

1. 汇总全部功能及组合支持的验收证据，逐项确认原先需要 legacy 的场景已有 resident 实现；未完成项继续作为前置阻塞。
2. 删除自动或显式选择 legacy 调度的入口、LEGACY_GRAPH / LEGACY_UNSUPPORTED_SHAPE 等回退模式，以及仅服务该路径的 executor、状态、数据结构和构建产物。共享的启动、关闭、错误处理和资源生命周期逻辑按实际调用关系保留。
3. 删除仅为旧路径保留的开关、宏、参数、日志分支及测试配置；同步更新文档和测试，不保留隐藏的兼容回退入口。
4. 对最终支持范围之外或非法的输入给出明确诊断，不能静默进入旧 Scheduler。仍在使用的接口或数据布局按消费者依赖完成迁移。

Acceptance criteria

• [Feature] A5 HBG AICore 调度：支持 Graph body 原生执行 #2830、[Feature] A5 HBG AICore 调度：补齐多 block 与 MIX predicate 支持 #2831、[Feature] A5 HBG AICore 调度：支持异步任务 deferred completion #2832、[Feature] A5 HBG AICore 调度：支持 early dispatch #2867、[Feature] A5 HBG AICore 调度：支持 Host、AICPU 初始化与 AICore 运行流水重叠 #2927 及父项其余功能已交付并验收，支持矩阵和组合语义明确；链接对应实现 PR 和最终集成基线。
• legacy 回退入口、专用实现及构建引用已删除；源码与配置引用检查确认没有可达的旧调度路径。
• 验证普通 AIC/AIV、MIX、多 block/SPMD、sync-start、Graph、predicate、异步完成、early dispatch、Host／AICPU 初始化／AICore 调度运行流水及约定组合，覆盖正确性、依赖释放、重复运行、失败与安全关闭。
• A5 onboard 验收包含 scheduler_producer=aicore 或等价的 resident 路径证据；sim / 单元测试结果分别记录，不能仅用输出正确证明迁移完成。
• 记录相对清理前集成基线的设备调度成本、完整 Device 时间及适用的端到端影响，说明退化和未覆盖项。
• 测试、构建配置和文档与最终行为一致；清理 PR 合入最终交付分支，并将结果回填 [Track] AICore scheduling workstream and acceptance #2667。

本项清理尚未完成；前置功能的实际交付进展见正文开头，不能以删除回退入口代替剩余功能验收。

Priority

Medium (minor risk, should fix in next few releases)