[AIW-05] 通过 unilab CLI 与 MCP 运行和观察工作流

[TablewareBox]

Parent

Part of #215.

What to build

让 Agent 通过稳定的 unilab Domain CLI 完成 workflow list/inspect/run/watch/command/debug，并读取与 Workbench 完全一致的 Task、节点状态、日志和诊断。MCP 仅把这些 SDK 能力暴露为类型化工具，不复制状态机或进程管理。

Acceptance criteria

• CLI 支持 workflow list/inspect/run/watch/command/debug，并在 local/backend Authority 下使用同一领域合同。
• 输出支持人类格式、JSON 与有界 JSONL；所有长操作返回 operation/task identity、source identity、revision 与 generation。
• watch 使用可恢复 cursor，断线重连不丢事件、不重复报告已确认事件，并可在终态自动退出。
• command 支持 continue/step/pause/cancel 等当前调试合同，幂等键和前置状态错误稳定。
• inspect 可查询 Task、Node Job、运行事件、输入绑定、物料身份和结构化失败原因。
• Agent 直接编辑源码后，可通过 CLI 等待 Authoring revision/diagnostics 并触发前端刷新，而不抓取 UI 文本。
• MCP 工具调用同一个 Client SDK；相同输入的 CLI/MCP/Workbench 观察到同一 Task 与节点事实。
• 不通过 Node 私有 RPC 控制 Domain，不直接读取运行目录中的 SQLite 作为公开接口。
• PLC-Sim E2E 从 CLI 启动最长工作流，浏览器同步显示运行状态，CLI watch 到终态并附截图/JSONL 证据。

Blocked by

• [AIW-04] 原子切换 Local 与 Backend Domain Authority #219

[github-actions]

GitHub → Feishu OKF synchronization

Feishu snapshot: Uni-Lab-Core #220
Knowledge stage: implementation
Issue updated: 2026-08-13T18:15:18Z

[TablewareBox]

AIW-05 已完成并通过真实验收。\n\n实现：\n- Uni-Lab-OS 16fe8b1a：authority-aware Domain Client、workflow list/inspect/run/watch/command/debug/authoring CLI、JSON/JSONL、Agent/MCP 共用 adapter、本地 pause/resume。\n- uni-lab-backend 9560c66：持久 Task event cursor、/api/v1/workflow-tasks/:uuid/events、debug task/hold/command API、起始点/断点、step/continue 精确 hold 语义。\n\n验证：\n- OS focused suite：51 passed。\n- Go Backend：go test ./... 全量通过；前端 tsc -b 通过。\n- Backend Authority：真实 debug task 从 start hold 以精确 hold UUID 单步，cursor 37→42，终态 succeeded；Backend 画布 revision CAS 保存有效，工作区代码明确不驱动 Backend 图。\n- Local Authority + PLC-Sim：受管重启 PLC-Sim/握手器与 local 数据后，以 normal（非 dry-run）从 CLI 启动 0810 最长流程；63 节点/51 边，47/47 可执行节点成功；JSONL 136 条，cursor 134，stderr 0，终态 task_terminal: succeeded。\n- Codex 内浏览器同步显示完整画布与 47/47 成功状态。\n\n公开控制面只使用 /api/v1 与 Workspace Host 受管操作；未通过 Node 私有 RPC 控制 Domain，未直接读取 SQLite 作为公开接口。

[TablewareBox]

Acceptance criteria satisfied; closing AIW-05.