[Mastra ME01] 锁定 Mastra 兼容组合并演示可持久恢复的最小执行 #473

Parent

Spec: #472 — 内置 Agent 执行迁移 Mastra。本 Issue 是其正式子 Issue。

What to build

维护者可用固定版本的最小 Bot 完成回答、一次受控工具调用和独立进程暂停恢复，证明迁移依赖可用。

Acceptance criteria

• 记录实际解析的 Mastra、AI SDK、AG-UI、Zod 与运行时版本；从现有版本组起步，不以通配或 latest 作为可恢复格式依据。
• 通过真实应用装配的隔离测试入口发起消息，收到非空规范文本流；工具调用一次且模型第二步能使用结果。
• 自定义受控模型在每个步骤被调用；禁止隐藏 provider 直连、自动 retry/fallback 及额外标题/摘要调用。
• 暂停载荷落在受限持久存储，原进程退出后另一进程恢复准确操作；Workflow 同进程内存测试不能代替 Agent 恢复。
• 采集脱敏完整事件样本，覆盖文本、工具参数增量、结果、错误、挂起与终态；缺必要能力明确阻断后续票。
• 恢复/模型能力若要求升级，提交最小精确版本变更和同一组通过证据，不静默换用最新文档 API。

Blocked by

None（无实施依赖；本次仅登记 Issue，不启动实现）

Scope boundary

只做迁移所需兼容探针及必要版本锁定；不接生产默认路由，不实现新业务权限/计费。

Interfaces

• Consumes：前置票经审查的实际交付合同，以及父 Spec 的身份、预算、消息与恢复约束。
• Produces：精确版本指纹、完整事件 fixture、受控模型与恢复载荷合同。
• Responsibility：backend_implementer；相应只读验证者 + 独立 Spec/质量 reviewer。

Verification

演示一轮带工具的流式回答及一次独立进程恢复；核对真实模型/工具调用计数。数据库 fixture 缺失则恢复验收 unverified。

Failure handling

依赖/API 不兼容时停止并修订版本方案，不能以普通文本成功代替恢复能力。

Acceptance mapping

父 Spec：A01。既有实施计划关联：T0, T1。Issue 是完整业务切片，计划 Task 是票内或前置工程步骤，两者不一一等同。

Handoff notes

• 方案、测试 seam 与拆票已由用户于 2026-10-19 确认，按该范围登记 Issue。ready-for-agent 只表示规格可接手，不表示依赖已完成、已实现或已获上线授权。
• 使用根 CONTEXT 的术语，遵守公司/团队/本人/逻辑 Bot、计费准入、个人记忆和测试运行器 ADR；不得因框架替换重定权威。
• 每票保留独立可演示的行为；跨端时先固定事件/状态接口，再按专业角色安排票内实现 Task，不把业务票另拆成数据库/后端/前端水平交付。
• 领取前核验前置代码及其同哈希验证/Review 已集成；关闭状态不是实现证据，外部引用不是自动扩大的实施范围。
• 按仓库 writing-plans/SDD/独立 Review/OCR 流程实施；无提交授权用完整未提交增量检查点。该流程在真正实施时适用，本 Issue 登记不启动实现。
• 验证由 e2e 统一调度，native/driven 清单与实际用例数对账，数据库仅用明确的一次性受限角色 fixture；skip/缺环境/零用例不算通过。
• 结束或中断记录 HEAD、范围、完整 patch/新增文件及哈希、实际命令与结果、Review 和限制，方便新 Agent 恢复；不擅自提交、推送、合并、生产导入、部署或关闭其他 Issue。