背景

拆自专项 issue gitcode-cli/cli#506 §3.1。对齐 gh run watch。

需求

新增 gc actions run watch <run-id> 命令，客户端定时轮询 GetActionsRun API 直到 run 状态为终态，实时展示 stage/job 执行进度。

无需新 API

纯客户端轮询，复用已有 api.GetActionsRun（api/queries_actions.go）。终态判断：COMPLETED / FAILED / CANCELED / IGNORED / PAUSED / SUSPEND。

命令接口

gc actions run watch <run-id> -R owner/repo [flags]

Flags:

• --interval <seconds>：刷新间隔，默认 3 秒（对齐 gh）
• --compact：仅展示相关/失败 step（对齐 gh）
• --exit-status：run 失败时返回非零退出码
• -R, --repo：仓库（全局标准 flag）
• --json：JSON 输出（轮询结果）

行为

1. 首次拉取 run 详情，展示 stage/job 概览
2. 按 --interval 定时轮询，刷新 stage/job 状态（TTY 下清屏重绘）
3. 非 TTY 环境不阻塞轮询，输出单次快照后退出（符合 agent-friendly 契约）
4. run 进入终态后停止轮询，输出最终结果
5. --exit-status 时终态为 FAILED/CANCELED 返回退出码 1

对齐 gh 参考

gh run watch <run-id> [--compact] [--exit-status] [--interval <seconds>]

验收标准

• gc actions run watch <run-id> -R owner/repo 可实时监控 run 进度
• --exit-status 在 run 失败时返回非零退出码
• --compact 仅展示失败 step
• 非 TTY 环境输出单次快照不阻塞
• --json 输出轮询结果
• 支持 --yes 跳过确认
• 单元测试覆盖终态判断和轮询逻辑
• 真实命令验证（使用 infra-test/* 仓库）

Refs gitcode-cli/cli#506