test(android): establish workflow runner

docs/03-tech-stack.md

@@ -27,7 +27,7 @@
 | VLM 接入 | 应用内统一适配器，优先兼容 OpenAI 风格多模态接口 | 接口已定，供应商待定 | 模型输出必须符合本项目 JSON Schema。 |
 | 通知 | MVP 不使用推送 | 已定 | 点击“获取任务”调用原子 claim API；V2 再评估厂商推送/WebSocket。 |
 | 后端测试 | 标准库 `testing` + `httptest` | MVP 已定 | 覆盖状态机、权限、幂等、SQLite 事务和输入校验。 |
-| Android 测试 | Gradle `test` + 真实设备 smoke | 基线已验证 | 上游没有 `test/androidTest` 源；T-003 建立 workflow 测试。 |
+| Android 测试 | Gradle `test` + `kotlinx-coroutines-test` 1.7.3 + 真实设备 smoke | workflow 基线已实现 | T-003 已覆盖成功、timeout、有限 retry、安全阻塞、用户停止和并发拒绝；真实 UI 动作仍需真机 smoke。 |
 | 部署 | 单机局域网 Go 服务；容器化后置 | MVP 已定 | Android 测试机必须能通过 HTTPS 或受控测试网络访问。 |
 
 ## Roubao 上游版本基线

docs/current-state.md

@@ -5,16 +5,18 @@
 ## 当前快照
 
 - 日期：2026-07-25
-- 阶段：T-002 测试设备基线和就绪检查完成，准备执行 T-003
-- Git：当前分支为 `main`；T-001 和 T-002 均已纳入 Git 历史
+- 阶段：T-003 Android workflow 测试骨架完成，准备执行 T-004
+- Git：当前分支为 `main`；T-001 至 T-003 均已纳入 Git 历史
 - 生产代码：`android-buyer/` 已接入 Roubao Android 源码
 - Android：固定 `main@c8a6d7f03422eb01744b01f3ee77bf7757741f7e`；MIT 许可证已保留
 - 后端：已决定使用 Go 1.23.0 + Gin 1.11.0；Go Blueprint v0.10.11 骨架尚未接入
 - 本机 Android 工具：JDK 17.0.13、Command-line Tools 22.0、SDK 34、
   Build Tools 34.0.0、Platform Tools/ADB 37.0.0；用户级 SDK 环境变量已设置
 - Android Studio：未安装；`winget` 静默安装卡住后已终止，不阻塞命令行构建
-- 测试：`lintDebug test assembleDebug` 成功；T-002 新增 5 个纯 Kotlin 测试，
-  Debug/Release 两个变体共执行 10 次且全部通过
+- 测试：`lintDebug test assembleDebug` 成功；T-002/T-003 共 11 个纯 Kotlin
+  测试，Debug/Release 两个变体共执行 22 次且全部通过
+- Workflow：纯 Kotlin runner 已支持步骤 timeout、最多 3 次 retry、安全阻塞、
+  用户停止和单 runner 并发拒绝；尚未连接真实拼多多动作
 - 测试设备：OnePlus PKG110，Android 16/API 36；肉包 `1.4.2 (7)`；拼多多
   `8.17.0 (81700)`
 - 设备就绪：肉包采购无障碍已启用并连接；可观察前台包名；拼多多首页未发现登录、
@@ -36,6 +38,7 @@
 | `docs/` | 已有 | Harness Coding 文档 |
 | `docs/tasks/T-001.md` | DONE | Android 可构建、可安装、可启动基线 |
 | `docs/tasks/T-002.md` | DONE | 设备版本、无障碍、前台和登录阻塞就绪检查 |
+| `docs/tasks/T-003.md` | DONE | 可注入 Fake automation 的受限 workflow runner |
 | `deepseek总结.txt` | 已有 | 历史讨论摘要，不是正式需求权威 |
 | `android-buyer/` | 已有 | Roubao `main` 固定 commit 的 Android 基线 |
 | `backend-api/` | 待建 | Go-Gin、管理 Web 和数据目标目录 |
@@ -43,9 +46,9 @@
 
 ## 任务摘要
 
-- 已完成：T-001 Android 基线；T-002 测试设备基线和就绪检查。
+- 已完成：T-001 Android 基线；T-002 设备就绪检查；T-003 workflow 测试骨架。
 - 正在进行：无。
-- 下一个可领取任务：T-003 建立 Android workflow 测试骨架。
+- 下一个可领取任务：T-004 导入本机蝦皮订单验证样本。
 
 ## 当前可运行内容
 

docs/tasks/T-003.md

@@ -0,0 +1,81 @@
+---
+id: T-003
+title: 建立 Android workflow 测试骨架
+phase: 0
+deps:
+  - T-001
+status: DONE
+created: 2026-07-25
+context_ref: d013ac8c84b69ab1bcf5b2cfd5385c93049d5439
+work_branch: main
+write_paths:
+  - android-buyer/app/build.gradle.kts
+  - android-buyer/app/src/main/java/com/roubao/autopilot/workflow/**
+  - android-buyer/app/src/test/java/com/roubao/autopilot/workflow/**
+  - docs/03-tech-stack.md
+  - docs/current-state.md
+  - docs/tasks/T-003.md
+  - progress.md
+---
+
+## 问题 / 背景
+
+现有 Roubao `MobileAgent` 直接组合 VLM、设备控制和 UI 状态，无法在本地 JVM 中稳定
+验证采购步骤的超时、重试和安全停止。T-101 开始操作拼多多前，需要先建立一个小型、
+可注入 Fake automation 的工作流内核，防止自动化逻辑只能靠真机人工回归。
+
+## 关联需求与交互
+
+- 功能：为 F-004 至 F-007 提供可测试执行骨架。
+- 用户故事：US-004 执行受限采购探针、US-006 安全失败和可恢复。
+- 交互：本任务无新界面。
+- 架构：Android workflow 层和 automation adapter 接口。
+
+## 方案
+
+1. 定义步骤、自动化结果、状态、失败原因、安全停止原因和运行报告。
+2. `WorkflowRunner` 每次只运行一个工作流；每步使用协程 timeout，重试次数有硬上限。
+3. 用户停止只取消当前 automation 子任务并返回 `STOPPED` 报告，不取消调用方协程。
+4. 登录、验证码、风控、未知页面和支付边界作为不可重试的 `BLOCKED` 终态。
+5. 使用 `kotlinx-coroutines-test` 和 Fake automation 覆盖成功、重试、超时、阻塞、
+   用户停止和并发运行拒绝。
+
+## 验收要点
+
+- [x] Fake automation 下可以验证多步骤成功状态迁移。
+- [x] 单步 timeout 可确定性触发，且不会形成无界等待。
+- [x] retry 次数有明确上限，耗尽后进入结构化失败。
+- [x] 登录、验证码、风控、未知页面和支付边界不自动重试。
+- [x] 用户停止会取消当前步骤并返回 `STOPPED`，调用方测试协程仍可完成。
+- [x] 同一 Runner 拒绝并发运行。
+- [x] `lintDebug test assembleDebug` 通过。
+
+## 边界
+
+- 不实现拼多多搜索、点击或页面解析。
+- 不接入 MainActivity 或替换现有 MobileAgent。
+- 不做任务持久化、进程恢复、后台 API 或前台服务。
+- 不允许无限 retry；`maxRetries` 必须为非负且由步骤显式给出。
+
+## 执行记录
+
+### 2026-07-25：任务开始
+
+- 基于 T-002 提交 `d013ac8` 开始。
+- T-002 已提供设备就绪和安全阻塞事实；T-003 只定义如何消费 automation 结果。
+
+### 2026-07-25：实现和验证完成
+
+- 新增纯 Kotlin `WorkflowStep`、`AutomationGateway`、状态/结果/报告模型和
+  `WorkflowRunner`，没有 Android UI、设备或 VLM 依赖。
+- 单步强制正 timeout；`maxRetries` 只能是 0 至 3。timeout 作为结构化可重试失败，
+  重试预算耗尽后进入 `FAILED`。
+- 登录、验证码、风控、未知页面和支付边界统一返回 `BLOCKED`，即使步骤配置了重试
+  也只调用 automation 一次。
+- `requestStop()` 只取消当前 automation 子任务；runner 捕获该取消并返回 `STOPPED`，
+  不取消调用方协程。原子运行标记拒绝同一 runner 并发执行。
+- 增加 `kotlinx-coroutines-test 1.7.3`，用虚拟时间验证两次 100ms timeout 在
+  200ms 后失败，不产生真实等待。
+- 新增 6 个 workflow 测试；连同 T-002 的 5 个测试，在 Debug/Release 两个变体
+  共执行 22 次，0 failure、0 error、0 skipped。
+- `.\gradlew.bat lintDebug test assembleDebug --no-daemon`：成功。