feat: dynamic-workflow 来了 (#1271)

* feat(workflow): add workflow engine, /workflows panel, /ultracode skill

将 feat/sdk-backend 分支中 workflow 相关的 20 个 commit 压缩为单 commit：

- 工作流引擎核心：phase / agent / parallel / pipeline 编排原语（packages/workflow-engine/）
- /workflows 面板：三区焦点布局（顶部 run tabs + 左侧 phase 侧栏 + 右侧 agent 列表）
- /ultracode skill：多 agent workflow 编排入口
- 进度存储 / journal / notification 系统
- WorkflowService 生命周期管理 + SentryErrorBoundary
- 脚本沙箱：禁用 dynamic import()、JSON args 防御性归一化
- journal 与 named-workflow 路径统一在 projectRoot
- 错误处理：parallel/pipeline hooks 错误日志、failure routing、semaphore abort
- workflow 工具升级为 core 工具 + PascalCase 命名

Co-Authored-By: glm-5.1 <zai-org@claude-code-best.win>

* feat(workflow): 复刻 ultracode 手册并修复 worktree/inline/opt-in 三处缺口

围绕 ultracode skill 审查 agent 系统一致性后：
- ultracode.ts: 用系统提示版完整 Workflow 编排手册替换中文精简版
- HIGH#1 isolation:'worktree': claudeCodeBackend.run() 用 createAgentWorktree +
  runWithCwdOverride 包裹 runAgent + finally 清理实现真正的 cwd 隔离；slug 用
  sha256(runId:agentId) 派生以匹配 cleanupStaleAgentWorktrees 清理正则
  （修 runId 为 w+base36 非 UUID 导致的泄漏盲区）；worktree.ts 注释同步修正
- HIGH#2 inline 持久化: 新增 persistInlineScript，WorkflowTool + service 两条
  inline 路径对称持久化到 .claude/workflow-runs/<runId>/script.js，返回可复用
  scriptPath（闭环 inline→编辑→scriptPath 重提迭代循环）
- HIGH#3 opt-in 分工: ultracode/WorkflowTool/effort 注明 session reminder 由
  harness 注入，repo 内无 ultracode 信号，保持 feature('WORKFLOW_SCRIPTS') +
  isEnabled 两层 gate，不自造注入
- 测试: 新增 persistInline.test.ts；扩展 claudeCodeBackend(isolation 4 用例)/
  WorkflowTool(inline)/service(scriptPath)/ultracode(harness)

含配套 workflow engine/panel 完善与 run-state-persistence design doc。

Co-Authored-By: Claude <noreply@anthropic.com>

* feat(workflow): run 终态落盘 state.json 支持跨重启恢复

终态 RunProgress（含 returnValue/error）此前只在内存 ProgressStore，进程
重启即丢失。本次让其落盘到 .claude/workflow-runs/<runId>/state.json，使
(a) 重启后可按 runId 取 return、(b) /workflows 面板跨重启展示历史 run。
跨进程 resume 明确不在范围。

- persistence.ts: getRunsDir/writeRunState/readRunState/listPersistedRuns
  + attachRunStatePersistence；原子覆盖写（tmp+rename），读容错（缺文件/
  损坏/schemaVersion 不符 → null），写 best-effort（IO 失败只 log warn）
- progress/store.ts: 加 hydrate(run) 直接注入磁盘 run（已存在 runId 跳过，
  内存优先）
- service.ts: getWorkflowService() 接线 attachRunStatePersistence(bus,
  store) 订阅 run_done（completed/failed/killed 三态共用，shutdown-kill
  也走同路径，无需额外钩子）；WorkflowService 加 getRunAsync(id) 内存
  miss→读盘 fallback（不注入内存）+ loadPersistedRuns() 扫盘 hydrate
  （persistedLoaded flag 守护幂等）
- panel/WorkflowsPanel.tsx: mount 时调一次 loadPersistedRuns（重 mount
  不重复）
- ports.ts: runsDir 改用 getRunsDir() 消除拼接重复
- 测试: persistence.test.ts(11)/runStatePersistence.test.ts(5)/
  progressStore(2)/service(5)/WorkflowsPanel(1) 共 24 个新测试；
  precheck 5629 pass / 0 fail

设计偏离: 计划原写 monkey-patch getRunsDir 指向 tmpdir，Bun ESM namespace
不可变不可行；改用可选 runsDirProvider 参数（默认 getRunsDir）DI 注入，
加到 attachRunStatePersistence 与 makeService（cwdOverride 之后第 4 参），
与现有 cwdOverride 模式一致。makeService 的 cwdOverride 保持不变，不破坏
inline 持久化特性。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(workflow): 默认并发降为 3 并支持 per-run maxConcurrency 注入

- DEFAULT_MAX_CONCURRENCY=3 替代旧的 min(16, cores-2)；MAX_CONCURRENCY_CAP=16 保留为用户输入的绝对上限
- 新增 clampMaxConcurrency() 处理 undefined/<1/>CAP 边界
- WorkflowInput schema 新增 maxConcurrency: number.int().min(1).max(16).optional()
- 引擎层 context/runWorkflow 全链路透传：semaphore 容量来自 per-run 入参
- WorkflowTool prompt 增加指引：fan-out 场景先用 AskUserQuestion 与用户确认并发再启动
- 同步 ultracode skill + audit workflow spec 的并发文字（删 cpu-cores 公式）
- 同步 docs/features/workflow-scripts.md 旧公式

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(workflow): 面板 UI 字符串英文化

WorkflowsPanel 中 4 处面向用户的中文（onDone 错误消息、键位提示行）
改为英文；其他面板组件（AgentList/TabsBar）原本已是英文。代码注释
保留中文，与 workflow 模块惯例一致。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(workflow): 中断系统（x 杀单 agent / K 杀整个 workflow，Dialog 二次确认）

- claudeCodeBackend 桥接 ctx.signal → runAgent.override.abortController（修 'x' 无效根因：abort 到不了内部 fetch）
- AbortError 识别为 throw WorkflowAbortedError（不再吞成 dead，workflow 能感知被 kill）
- ports.taskRegistrar 加 registerAgentAbort/unregisterAgentAbort/killAgent；service.killAgent(runId, agentId) 精确中断
- 面板键位：'x' 杀当前 agent（agents 列聚焦时） / 'K' 杀整个 workflow；Dialog 二次确认 + confirm 模式吞导航键防误触
- 新增测试 8 项（backend signal bridge / hooks inject / ports killAgent / service killAgent）

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* docs(workflow): ultracode skill 加 model tier 选择指引（haiku/sonnet/opus/best 场景匹配）

补足 agent() 已有 model 参数缺的判断依据：列出 4 个 tier 的成本/延迟量级和典型场景，
明确"无法 articulate 为什么换 tier 就 omit"的 rule of thumb。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(workflow): maxConcurrency≠3 必须先 AskUserQuestion（默认 3 推荐值）

把 fan-out 时才问改成任何 maxConcurrency≠3 都必须问。
唯一例外：用户在当前会话已明确说过并发数（"use 6" / "maxConcurrency 9"）。
prompt (WorkflowTool.ts) + skill (ultracode.ts) + audit spec 三处同步。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(workflow): agent 失败自动重试一次（dead 或非 abort throw）

- hooks.agent 包装 invokeBackend：第一次 dead 或非 abort throw → 重试一次
- WorkflowAbortedError（kill）不重试——是用户意图
- registry.resolve 配置错（AdapterNotFoundError 等）在 try 外直接上抛，不走重试——
  配置问题重试无意义且掩盖 bug
- 重试仍失败：dead 保持 dead；throw 降级 dead（不击穿 workflow，
  与 parallel/pipeline null-on-error 契约一致）
- budget 不重复扣：dead 不 addOutputTokens，重试 ok 才扣一次
- 新增 7 项 hooks 层重试测试 + 1 项 service 层降级测试

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(workflow): 面板 label 截断保留 #数字 后缀（同 dim 多 finding 可区分）

audit workflow 用 verify:\${dim}#\${findingIdx} 命名 verify agent。
旧逻辑 slice(0, 18) 从右切把 #idx 全吃了——同 dimension 多 finding
肉眼无法区分。新逻辑：含 #数字 后缀时保留后缀，前缀截断 + … 省略号。

例：verify:correctness#0 → verify:correctn…#0
   verify:architecture#15 → verify:archite…#15

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(workflow): kill 整个 workflow 后立即回主 chat

run_done→store→notifications.ts 的通知路径已有，但 confirmYes 后面板继续
挂着挡住主 chat，用户看不到"已停止"反馈。kill 后调 onDone() 立即退出面板，
让主 chat 的 `Workflow "<name>" was stopped` 通知直接可见。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(workflow): agent dead 带 reason/detail + prompt 加压 StructuredOutput

12 agent audit workflow 8 个 dead，journal 只记 {kind:"dead"} 无信息，
事后无法区分 "agent 没产 StructuredOutput" vs "runAgent 抛错"。
证据指向主因：sonnet 长 tool chain 后忘记调 StructuredOutput，
extractStructuredOutput 返回 null 即降级 dead。

- types.ts: AgentRunResult.dead 加可选 reason/detail 字段
  （no-structured-output / runagent-threw / worktree-failed / unknown）
  兼容旧 journal（均 optional）。
- claudeCodeBackend.ts: 三处 dead 填 reason + detail；
  no-structured-output 把 finalized 文本前 200 字符做 detail，
  让日志/面板能立刻看到 agent 最后说了什么。
- claudeCodeBackend.ts: schema 模式 prompt 首尾各放一次
  StructuredOutput 强制要求，针对 sonnet 长 tool chain 后忘记收尾。
- hooks.ts: retry 日志带 reason；retry 仍 throw 时降级 dead 也填
  reason=runagent-threw + detail。
- types.test.ts: 加 reason JSON 往返 + 旧 journal 兼容测试。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(workflow): schema 模式弃用 StructuredOutput 工具契约，改鲁棒 JSON 文本解析

上一轮 70a2f76 把"agent 长 tool chain 后忘调 StructuredOutput"当作死因，
加 prompt 头尾双强制。但实测跑 5 个 review agent 4 个 dead，detail 全是
"StructuredOutput tool is not available as a deferred tool"——根因是
该工具从未注入 workflow sub-agent 的工具集（assembleToolPool 默认池不含，
只有 stop_hook 路径 execAgentHook.ts 显式 createStructuredOutputTool()）。
prompt 反复要求调一个不可达的工具，agent 困扰、长篇辩解、最终没产 JSON。

- claudeCodeBackend.ts:
  - extractStructuredOutput 重写：括号栈扫描替代 indexOf/lastIndexOf，
    处理嵌套对象、字符串内的括号、转义符；新增 fenced code block
    优先路径（```json / ```），多 JSON 块取第一个 parse 成功的；
    只返回 plain object（拒 array/number/string/null）。不做语法修复
    （尾逗号/单引号/注释）——避免在字符串内误改（如 "http://" 被 // 注释正则吃）。
  - schema 模式 prompt 简化：删首尾双 STRUCTURED OUTPUT 强制（600+ token），
    改成指示 agent 在最后文本块 emit raw JSON；明确告知"StructuredOutput
    is not available in this environment"，消除调用幻觉。
- hooks.ts: detail.slice 用 typeof === 'string' 守卫；catch 块用
  e instanceof Error ? e.message : String(e)（旧 journal / 第三方 adapter
  可能写非 string detail，直接 .slice 会抛 TypeError 击穿日志）。
- claudeCodeBackend.test.ts: +9 测试覆盖 fenced / 嵌套 / 字符串内括号 /
  转义引号 / 多块取首 / 类型守卫 / 损坏 JSON。

precheck: 5663 pass / 0 fail。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* docs(effort): 新增 /effort 交互面板设计 spec

设计要点：
- /effort 无参 → 横向 slider 面板（low/medium/high/xhigh/max/ultracode）
- ←/→ 移动光标，Enter 确认，Esc 取消
- ultracode 仅视觉占位，确认后提示走 /ultracode <context>
- env override 时双标记 + 顶部警告
- 模型不支持时面板禁用
- 两阶段交付：先基础面板 commit，再做 ultracode 波纹动画

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* docs(effort): 新增 EffortPanel 基础面板实施计划（第一阶段）

按 TDD 分 6 个 task：纯函数状态 → keybinding 注册 → 组件 → 命令挂载 → 分支测试 → precheck。
波纹动画在第二阶段单独 commit。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* docs(effort): plan 补 q/ctrl+c 取消绑定，对齐 spec §5 状态机

verifier 抓到的 gap：spec §5 写明 Esc / Ctrl+C / q 都是取消事件，
但 plan Task 2.3 只绑了 escape。补上 q 和 ctrl+c → effortPanel:cancel。
同时把 Step 2.2 直接写成 6 个 action 版本（home/end），删除迂回表达。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* docs(effort): plan 修订执行前 review 发现的 5 处 gap

- Task 3.3 EffortPanel.tsx 草稿：Faster/Smarter padEnd 语法错乱重写；
  useKeybindings import 路径从 @anthropic/ink 修正为 ../../keybindings/useKeybinding.js；
  移除冗余 renderSeparatorLine；保留 renderPaddedLine
- Task 5.2 computeConfirmOutcome 改为注入 ApplyFn 模式：
  避免 effortPanelState → effort.tsx → EffortPanel 循环依赖；
  测试可注入 mockApply，无需 mock settings
- Step 5.3 测试代码对齐注入版签名

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): 新增 EffortPanel 纯函数状态模块（PanelPosition + 移动/初始光标）

仅含纯函数与类型，无 React/Ink 依赖，便于单测。
- PANEL_POSITIONS：low → medium → high → xhigh → max → ultracode
- moveLeft/moveRight：边界钳制（low 不再左移、ultracode 不再右移）
- getInitialCursor：env override > displayed level

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(keybindings): 注册 EffortPanel context 与 6 个 action

绑定 ←/→/h/l/home/end/enter/escape/q/ctrl+c 到 effortPanel:* action。
与 ModelPicker context 范式一致，避免左右键被全局 keybinding 拦截。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): 实现 EffortPanel 组件主体（渲染 + 键盘交互 + 确认/取消分支）

- 横向 slider 布局：Faster ↔ Smarter 两极，6 档刻度
- useKeybindings 注册 EffortPanel context（←/→/h/l/home/end/enter/escape/q/ctrl+c）
- Enter 在 5 档之一 → 调 executeEffort 写 settings + AppState
- Enter 在 ultracode → 输出引导文案，不写状态
- Esc/q → "Effort unchanged."
- env override 时顶部黄色警告
- computeConfirmOutcome 注入 ApplyFn，便于测试（Task 5 补测试）

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): /effort 无参时挂载 EffortPanel 交互面板

- 无参 → <EffortPanelWrapper> 透传 AppState.effortValue
- current/status → 仍显示文本（不变）
- 有参 → 直跳 executeEffort（不变）
- help/-h/--help → 不变

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* test(effort): 补 computeConfirmOutcome 分支测试（注入 mockApply）

- ultracode → kind=ultracode-hint，不调 applyFn
- low → kind=apply，message/effortUpdate 来自 applyFn
- applyFn 返回无 effortUpdate 时 outcome.effortUpdate 为 undefined
- CANCEL_MESSAGE / ULTRACODE_HINT 常量

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 测试里 cursor cast 为 EffortValue，避免 PanelPosition 含 ultracode 触发 TS 错误

computeConfirmOutcome 的 ApplyFn 契约要求 EffortValue，但测试 mockApply 接收 PanelPosition。
实际运行时 computeConfirmOutcome 在 ultracode 档位走 hint 分支不会调 applyFn，
cast 安全。precheck 全量通过：5688 tests / 0 fail。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 面板对齐与配色修复

- 对齐：用 Box width={SEGMENT} + justifyContent="center" 让 ▲ 与档位名严格居中对齐，
  替代之前 string padEnd(11) 与 SEGMENT=12 不一致导致的 1 列偏移
- 配色：所有面板文字改用 theme.claude（Claude Orange rgb(215,119,87)），
  替代终端默认紫；分隔线/副标签/底栏用 theme.subtle；env 警告用 theme.warning
- 光标档位的档位名也加粗，强化视觉焦点

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 面板文字改紫色，ULTRACODE_HINT 英文化

- 颜色：theme.claude（橙）→ theme.purple_FOR_SUBAGENTS_ONLY（Purple 600, rgb(147,51,234)），
  覆盖标题、Faster/Smarter、▲、档位名
- ULTRACODE_HINT：中文 → 英文
  "ultracode is not an effort level. Use /ultracode <context> to start a multi-agent workflow."

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 统一用色版——选中 suggestion（蓝），未选中 subtle（灰）

弃用 purple_FOR_SUBAGENTS_ONLY（subagent 专用）。改与项目其他面板一致：
- 选中档位 + ▲：color="suggestion"（Medium blue rgb(87,105,247)）+ bold
- 未选中档位 + 空 ▲ 占位：color="subtle"（Light gray rgb(175,175,175)）
- 标题 / Faster / Smarter：color="suggestion"
- 分隔线 / 副标签 / 底栏：color="subtle"

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(workflow): 终态前补发 phase_done，面板自动退出 running→terminal 转换

runWorkflow：脚本结束时 hook.phase 不会触发最后一个 phase 的 phase_done，
UI 左栏会永远显示 running。三路径（completed/killed/failed）统一在 run_done
之前补发 emitTerminalPhaseDone。

WorkflowsPanel：抽 isRunTerminatedTransition 纯函数判定 running → terminal，
面板 useEffect 检测到转换后自动退出聚焦。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): 波纹动画纯函数 pickChar/computeRippleLine/mergeLayers + 18 测试

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): useRippleFrame hook 包装 useAnimationFrame，按需订阅时钟

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): EffortPanel 集成波纹背景——cursor 停在 ultracode 时切换波纹模式

仅在 cursor === 'ultracode' 时启用 useRippleFrame，渲染 5 行波纹背景
+ overlay 文字（Faster/Smarter、分隔线、▲、档位名、副标签）。
其余档位保持原 PlainContent 渲染路径不动。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* refactor(effort): 波纹动画从字符密度改为颜色渐变

按原版风格把波纹背景从 INTENSITY_CHARS 密度字符（'·∙░▒▓'）改为
suggestion 系颜色渐变（transparent → 暗深紫蓝 → suggestion → 高光）：

rippleAnimation.ts:
- 删除 pickChar / INTENSITY_CHARS / WAVE_PEAK_CHARS / mergeLayers
- 新增 intensityToColor(intensity) → 'transparent' | '#xxxxxx'
- 新增 computeRippleCells 返回 Cell[]（每位置 char+color）
- 新增 applyOverlaysToCells(cells, overlays) 替代 mergeLayers
- 新增 cellsToSegments(cells) 合并相邻同色段（减少 Text 节点）

EffortPanel.tsx:
- RippleContent 用 cells→segments→tokens 渲染
- 空格段用 BaseText backgroundColor 染色块（纯色块视觉）
- 文字段用 Text color 染色（亮色突出）
- tokens 按空格/文字二次拆分，避免混合段渲染歧义

测试: 29 个 rippleAnimation 测试覆盖 intensityToColor 边界、
computeRippleCells 长度/震源/衰减、applyOverlaysToCells 覆盖/截断/
防御式拷贝、cellsToSegments 合并逻辑。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 波纹参数调优——铺满左侧 + 速度调慢 + 全面板有底色

用户反馈三个问题：
1. "低峰部分没有颜色变化" → intensity ≤ 0.1 返回 transparent 导致波谷
   位置看不见。改为永不返回 transparent，最低档 #0a0d1a 作为面板
   底色（暗紫黑海洋），波峰在底色上流动。
2. "波浪速度太快" → time 系数 0.012 → 0.004（约 1/3 速）。波峰移动
   速度从 34 cell/s 降到 11 cell/s，每帧颜色变化从 45% 降到 36%。
3. "波浪只到中间部分，没覆盖左侧" → falloff 覆盖半径 40 → 90。
   震源 x=65，左侧 dist=65 < 90，波纹可达最左端（约 30-50% 覆盖）。

色阶调整：
- 删除 transparent 档，新增 #0a0d1a 作最暗档（底色）
- 最高档从 #8aa0ff（高光）改为 #5769F7（suggestion），避免与
  文字 overlay 同色互相吞噬
- 7 档颜色：#0a0d1a → #15182b → #1f2543 → #2a3360 →
  #3a4582 → #4a5bb0 → #5769F7

测试：删除 transparent 期望，改为期望具体颜色（#0a0d1a 等）。
新增"覆盖半径扩大"测试验证 dist=65 仍有非最暗颜色。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* fix(effort): 波纹 v3 — 去黑边 + 删中心高频涟漪 + y 轴覆盖快捷键行

用户反馈三个问题：
1. "黑色边感觉不太对" — 最暗档 #0a0d1a (rgb 10,13,26) 太接近纯黑，
   远端波谷看起来像硬黑边。改为 #1a1f3a (rgb 26,31,58)，紫蓝感
   更强而非纯黑。
2. "中心的快速波纹有点奇怪" — 删除震源附近 dist<6 的高频涟漪叠加
   (time*0.02，5 倍主波纹频率)。原本想让震源附近"水波感"更强，
   实际效果像"快速闪烁"反而突兀。主波纹已经足够，无需叠加。
3. "y 方向覆盖快捷键" — RippleContent 新增 y=2 行渲染快捷键 overlay
   ("←/→ adjust · Enter confirm · Esc cancel")。PlainContent 路径
   保持原 Box marginTop=1 + Text 渲染。

色阶调整（紫蓝感更强）：
- #1a1f3a (原 #0a0d1a) — 最暗档
- #1f2543 / #252c55 / #2e3870 / #3a4582 / #4a5bb0 / #5769F7
  (中间档略调亮度，保持平滑过渡)

测试：震源点测试更新为"time=0 时波谷最暗，time 推进后扫过波峰变亮"，
反映删除高频涟漪后的纯主波纹行为。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* chore(workflow): 工作流相关代码中文文案全部英文化

源码（src/workflow/ + packages/workflow-engine/src/）的中文注释、
用户可见错误消息、字符串字面量；测试文件的标题与注释；同步 6 条
硬编码断言到英文化后的错误消息。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* feat(effort): 波纹 v4 — 平滑波 + 全色环旋转 + 淡入淡出 + 宽度自适应

- 波函数改 (sin+1)/2：消除 max(0,sin) 平直暗带（约 6 行宽）
- 主色相连续旋转（0.03°/ms，12s/圈全色环）：蓝→紫→品红→红→橙→黄→绿→青
- 文字 overlay 同步色相旋转（rotateHue 应用到 Faster/▲/档位名/分隔线/副标签）
- 淡入淡出动画：fadeColor/fadeCells + fade 状态机 ~300ms 进出过渡
- 副标签固定 ultracode 段下方，不跟随光标移动
- 顶部/底部各加一行纯波纹行，视觉一致
- 宽度自适应终端列数：窄则 72，宽则铺满（computeSegment/computeRippleSourceX）
- 快捷键改 plain Text，不参与波纹背景渲染
- 新增 18 测试（fadeColor/fadeCells/rotateHue/getHueShiftAtTime）

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

* refactor: remove CYBER_RISK_MITIGATION_REMINDER from FileReadTool

Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win>

* fix: prevent ReDoS in extractMeta regex by anchoring to splice boundary

Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win>

* chore: 更新脚本

---------

Co-authored-by: glm-5.1 <zai-org@claude-code-best.win>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: deepseek-v4-pro <deepseek-ai@claude-code-best.win>

src/workflow/panel/AgentList.tsx

@@ -0,0 +1,71 @@
+import React from 'react';
+import { Box, Text, useAnimationFrame } from '@anthropic/ink';
+import type { Theme } from '@anthropic/ink';
+import type { AgentProgress } from '../progress/store.js';
+import { agentMetaText, agentVisual } from './status.js';
+
+const SPINNER_FRAMES = ['·', '✢', '✱', '✶', '✻', '✽'];
+const FRAME_MS = 120;
+const LABEL_MAX = 18;
+
+/**
+ * Truncate the label to at most max characters. Preserves the trailing `#number` suffix (the audit workflow
+ * `verify:${dim}#${findingIdx}` format) - so verify agent labels with multiple findings under the same dimension
+ * stay distinguishable (the prefix is elided with `…`). When there is no suffix, truncates from the right (legacy behavior).
+ * Exported for unit test coverage.
+ */
+export function truncateLabel(raw: string, max: number): string {
+  if (raw.length <= max) return raw;
+  const m = raw.match(/#\d+$/);
+  if (!m) return raw.slice(0, max);
+  const suffix = m[0]; // includes the # sign
+  const prefix = raw.slice(0, raw.length - suffix.length);
+  const available = max - suffix.length - 1; // -1 reserved for …
+  return `${prefix.slice(0, available)}…${suffix}`;
+}
+
+/**
+ * Right-side agent list (already filtered by the selected phase).
+ * Selected row: only when this column has focus (focused=true) does it paint a selectionBg background (keeps fg, not inverse color);
+ * when focus is not on this column it does not paint the background color, to avoid a "fake focus".
+ * The status mark of a running agent is driven by useAnimationFrame via a spinner animation (shared clock, globally synchronized);
+ * the right side `model · Nk tok · N tool` is refreshed in real time by agent_progress / agent_done.
+ */
+export function AgentList({
+  agents,
+  selectedIndex,
+  focused,
+}: {
+  agents: AgentProgress[];
+  selectedIndex: number;
+  focused: boolean;
+}): React.ReactNode {
+  // Subscribe once to the animation frame at the top level: all running agents share the same frame (synchronized animation, avoids a per-row hook).
+  const [ref, time] = useAnimationFrame(FRAME_MS);
+  const frame = SPINNER_FRAMES[Math.floor(time / FRAME_MS) % SPINNER_FRAMES.length];
+
+  if (agents.length === 0) {
+    return <Text color="subtle">(no agents in this phase)</Text>;
+  }
+  return (
+    <Box ref={ref} flexDirection="column">
+      {agents.map((a, i) => {
+        const v = agentVisual(a);
+        const selected = i === selectedIndex;
+        const highlighted = selected && focused;
+        const running = a.status === 'running';
+        const mark = running ? frame : v.mark;
+        const label = truncateLabel(a.label ?? `agent-${a.id}`, LABEL_MAX);
+        return (
+          <Box key={a.id} backgroundColor={highlighted ? 'selectionBg' : undefined} justifyContent="space-between">
+            <Box>
+              <Text color={v.color as keyof Theme}>{mark}</Text>
+              <Text> {label}</Text>
+            </Box>
+            <Text color="subtle">{agentMetaText(a)}</Text>
+          </Box>
+        );
+      })}
+    </Box>
+  );
+}

src/workflow/panel/PhaseSidebar.tsx

@@ -0,0 +1,65 @@
+import React from 'react';
+import { Box, Text, useAnimationFrame } from '@anthropic/ink';
+import type { Theme } from '@anthropic/ink';
+import type { AgentProgress } from '../progress/store.js';
+import { PHASE_COLOR, PHASE_MARK, type PhaseStatus } from './status.js';
+import { ALL_PHASE, type MergedPhase } from './selectors.js';
+
+const SPINNER_FRAMES = ['·', '✢', '✱', '✶', '✻', '✽'];
+const FRAME_MS = 120;
+
+type PhaseRow = {
+  title: string;
+  status?: PhaseStatus;
+  done: number;
+  total: number;
+};
+
+/**
+ * Left phase sidebar: the first row is All (aggregating done/total), followed by the merged phases (including pending ○).
+ * Selected row: only when this column has focus (focused=true) does it paint a selectionBg background (keeps fg, not inverse color) + a `>` marker;
+ * when focus is not on this column it does not paint the background color, to avoid a "fake focus". The status mark of a running phase is driven by useAnimationFrame via a spinner animation.
+ * Style aligns with the reference image: `> ✓ Scan  3/3`.
+ */
+export function PhaseSidebar({
+  phases,
+  agents,
+  selectedIndex,
+  focused,
+}: {
+  phases: MergedPhase[];
+  agents: AgentProgress[];
+  selectedIndex: number;
+  focused: boolean;
+}): React.ReactNode {
+  const [ref, time] = useAnimationFrame(FRAME_MS);
+  const frame = SPINNER_FRAMES[Math.floor(time / FRAME_MS) % SPINNER_FRAMES.length];
+  const totalAgents = agents.length;
+  const doneAgents = agents.filter(a => a.status === 'done').length;
+  const rows: PhaseRow[] = [{ title: ALL_PHASE, done: doneAgents, total: totalAgents }, ...phases];
+
+  return (
+    <Box ref={ref} flexDirection="column">
+      {rows.map((row, i) => {
+        const selected = i === selectedIndex;
+        const highlighted = selected && focused;
+        const running = row.status === 'running';
+        const mark = running ? frame : row.status ? PHASE_MARK[row.status] : ' ';
+        const color = (row.status ? PHASE_COLOR[row.status] : 'subtle') as keyof Theme;
+        return (
+          <Box key={row.title} backgroundColor={highlighted ? 'selectionBg' : undefined} justifyContent="space-between">
+            <Box>
+              <Text color={selected ? 'claude' : undefined}>{highlighted ? '>' : ' '}</Text>
+              <Text> </Text>
+              <Text color={color}>{mark}</Text>
+              <Text> {row.title}</Text>
+            </Box>
+            <Text color="subtle">
+              {row.done}/{row.total}
+            </Text>
+          </Box>
+        );
+      })}
+    </Box>
+  );
+}

src/workflow/panel/TabsBar.tsx

@@ -0,0 +1,37 @@
+import React from 'react';
+import { Box, Text } from '@anthropic/ink';
+import type { Theme } from '@anthropic/ink';
+import type { RunProgress } from '../progress/store.js';
+import { RUN_STATUS_COLOR, STATUS_DOT } from './status.js';
+import { tabLabel } from './selectors.js';
+
+/**
+ * Top run tab row: one tab per run (status dot + name + #short code).
+ * The current tab is highlighted with an orange ═ underline.
+ */
+export function TabsBar({ runs, activeRunId }: { runs: RunProgress[]; activeRunId: string | null }): React.ReactNode {
+  if (runs.length === 0) {
+    return <Text color="subtle">(no runs)</Text>;
+  }
+  return (
+    <Box>
+      {runs.map(r => {
+        const active = r.runId === activeRunId;
+        const label = tabLabel(r.workflowName, r.runId);
+        const underline = '═'.repeat(label.length + 2);
+        return (
+          <Box key={r.runId} flexDirection="column" marginRight={2}>
+            <Box>
+              <Text color={RUN_STATUS_COLOR[r.status] as keyof Theme}>{STATUS_DOT[r.status]}</Text>
+              <Text> </Text>
+              <Text color={active ? 'claude' : undefined} bold={active}>
+                {label}
+              </Text>
+            </Box>
+            <Text color={active ? 'claude' : undefined}>{active ? underline : ''}</Text>
+          </Box>
+        );
+      })}
+    </Box>
+  );
+}

src/workflow/panel/WorkflowsPanel.tsx

@@ -0,0 +1,283 @@
+import React, { useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { Box, Dialog, Text, useAnimationFrame } from '@anthropic/ink';
+import type { Theme } from '@anthropic/ink';
+import type { LocalJSXCommandContext, LocalJSXCommandOnDone } from '../../types/command.js';
+import { getWorkflowService } from '../service.js';
+import type { RunProgress } from '../progress/store.js';
+import { AgentList } from './AgentList.js';
+import { PhaseSidebar } from './PhaseSidebar.js';
+import { TabsBar } from './TabsBar.js';
+import { RUN_STATUS_COLOR, RUN_STATUS_TEXT } from './status.js';
+import { type FocusColumn, type WorkflowKeyboardHandlers, useWorkflowKeyboard } from './useWorkflowKeyboard.js';
+import { ALL_PHASE, filterAgentsByPhase, formatDuration, mergePhases } from './selectors.js';
+
+/**
+ * Clamp the selected index to a valid range (empty list -> 0; out of range -> last position; negative/NaN -> 0).
+ * Extracted into a module-level pure function: called inside the panel + unit tested for the same logic, to avoid behavior drift.
+ */
+export function clampSelected(selected: number, len: number): number {
+  if (len === 0) return 0;
+  const n = Math.trunc(selected);
+  if (Number.isNaN(n) || n < 0) return 0;
+  return Math.min(n, len - 1);
+}
+
+/**
+ * Determine whether the focused run completed the running -> terminal state transition (used for panel auto-exit).
+ * Extracted into a pure function for easy unit testing; called directly inside the panel's useEffect.
+ *
+ * Trigger condition: prev and curr are the same runId, prev is running, curr is completed/failed/killed.
+ * - Opening the history panel (prev=null): does not trigger
+ * - Switching to an already completed tab (different runId): does not trigger
+ * - Same run running -> terminal: triggers
+ */
+export function isRunTerminatedTransition(
+  prev: { runId: string; status: RunProgress['status'] } | null,
+  curr: { runId: string; status: RunProgress['status'] } | null,
+): boolean {
+  if (!prev || !curr) return false;
+  if (prev.runId !== curr.runId) return false;
+  if (prev.status !== 'running') return false;
+  return curr.status === 'completed' || curr.status === 'failed' || curr.status === 'killed';
+}
+
+/**
+ * /workflows main panel: three-region focus model (top tab + left phase sidebar + right agent list).
+ *
+ * - useSyncExternalStore subscribes to WorkflowService (the store returns stable snapshots, no re-render without change).
+ * - Focus state: activeRunId / focusColumn('phases'|'agents') / selectedPhaseIndex(0=All) / selectedAgentIndex.
+ * - Keybindings: Tab switch run · Left/Right switch focus column · Up/Down move within column · x kill · r resume · q/Esc quit.
+ */
+export function WorkflowsPanel({
+  onDone,
+  context,
+}: {
+  onDone: LocalJSXCommandOnDone;
+  context: LocalJSXCommandContext;
+}): React.ReactNode {
+  const svc = getWorkflowService();
+  const runs = useSyncExternalStore(
+    svc.subscribe,
+    () => svc.listRuns(),
+    () => [],
+  );
+
+  const [activeRunId, setActiveRunId] = useState<string | null>(null);
+  const [focusColumn, setFocusColumn] = useState<FocusColumn>('phases');
+  const [selectedPhaseIndex, setSelectedPhaseIndex] = useState(0);
+  const [selectedAgentIndex, setSelectedAgentIndex] = useState(0);
+  // kill secondary confirmation. null = no dialog; 'workflow' = kill the whole run; 'agent' = kill the currently selected agent.
+  // When non-null the keyboard enters confirm mode (only y/Enter/n/Esc/q respond).
+  const [confirmKill, setConfirmKill] = useState<null | 'agent' | 'workflow'>(null);
+
+  // On mount, trigger a single disk scan to hydrate historical runs (the service's internal persistedLoaded flag guards idempotency).
+  // Re-mount / re-render does not scan again (guarded by the process-singleton flag). The svc reference is stable (getWorkflowService singleton).
+  useEffect(() => {
+    void svc.loadPersistedRuns();
+  }, [svc]);
+
+  // On runs change: activeRunId invalidated (killed / first time) -> clamp to the first one
+  useEffect(() => {
+    if (runs.length === 0) {
+      if (activeRunId !== null) setActiveRunId(null);
+      return;
+    }
+    if (!runs.some(r => r.runId === activeRunId)) {
+      setActiveRunId(runs[0]!.runId);
+    }
+  }, [runs, activeRunId]);
+
+  const focused: RunProgress | undefined = runs.find(r => r.runId === activeRunId);
+  const phases = focused ? mergePhases(focused) : [];
+  // The sidebar includes the All row: prepend one item to the phases array -> total rows = phases.length + 1
+  const phaseRowCount = phases.length + 1;
+  const clampedPhase = clampSelected(selectedPhaseIndex, phaseRowCount);
+
+  // Auto-exit the panel when the focused run transitions from running to terminal (800ms delay so the user sees the ✓/✗ terminal state).
+  // Only triggered by a state transition on the same runId: switching to an already completed tab (prev was a different run) does not exit; opening the history panel
+  // (prev=null) does not exit either. Otherwise the agent is blocked by the panel while waiting for the Workflow tool result, and the user must press q manually.
+  const prevFocusedRef = useRef<{ runId: string; status: RunProgress['status'] } | null>(null);
+  useEffect(() => {
+    const curr = focused ? { runId: focused.runId, status: focused.status } : null;
+    const prev = prevFocusedRef.current;
+    prevFocusedRef.current = curr;
+    if (!isRunTerminatedTransition(prev, curr)) return;
+    const timer = setTimeout(() => onDone(), 800);
+    return (): void => {
+      clearTimeout(timer);
+    };
+  }, [focused?.runId, focused?.status, onDone]);
+
+  // Selected phase title (0 = All = undefined)
+  const selectedPhaseTitle = clampedPhase === 0 ? undefined : phases[clampedPhase - 1]?.title;
+
+  const visibleAgents = focused ? filterAgentsByPhase(focused.agents, selectedPhaseTitle) : [];
+  const clampedAgent = clampSelected(selectedAgentIndex, visibleAgents.length);
+
+  const switchTab = (runId: string): void => {
+    setActiveRunId(runId);
+    setFocusColumn('phases');
+    setSelectedPhaseIndex(0);
+    setSelectedAgentIndex(0);
+  };
+
+  const nextTab = (): void => {
+    if (runs.length === 0) return;
+    const idx = runs.findIndex(r => r.runId === activeRunId);
+    const next = runs[(idx + 1) % runs.length]!;
+    switchTab(next.runId);
+  };
+  const prevTab = (): void => {
+    if (runs.length === 0) return;
+    const idx = runs.findIndex(r => r.runId === activeRunId);
+    const next = runs[(idx - 1 + runs.length) % runs.length]!;
+    switchTab(next.runId);
+  };
+
+  const handlers: WorkflowKeyboardHandlers = {
+    nextTab,
+    prevTab,
+    focusLeft: () => setFocusColumn('phases'),
+    focusRight: () => setFocusColumn('agents'),
+    moveUp: () => {
+      if (focusColumn === 'phases') setSelectedPhaseIndex(s => clampSelected(s - 1, phaseRowCount));
+      else setSelectedAgentIndex(s => clampSelected(s - 1, visibleAgents.length));
+    },
+    moveDown: () => {
+      if (focusColumn === 'phases') setSelectedPhaseIndex(s => clampSelected(s + 1, phaseRowCount));
+      else setSelectedAgentIndex(s => clampSelected(s + 1, visibleAgents.length));
+    },
+    killAgent: () => {
+      // Only pop the agent confirmation when the agents column is focused (pressing x in the phases column has no target, no-op).
+      // The selected agent is decided by visibleAgents[clampedAgent]; saved into confirmKill and then
+      // actually executed by confirmYes - to avoid mis-killing caused by visibleAgents changing between two renders.
+      if (focusColumn !== 'agents' || !focused) return;
+      const agent = visibleAgents[clampedAgent];
+      if (!agent) return;
+      setConfirmKill('agent');
+    },
+    killWorkflow: () => {
+      if (!focused) return;
+      setConfirmKill('workflow');
+    },
+    resumeFocused: () => {
+      if (!focused) return;
+      const canUseTool = context.canUseTool;
+      if (!canUseTool) {
+        onDone('resume needs canUseTool context; run /<name> resume from the main session.');
+        return;
+      }
+      void svc
+        .launch({ resumeFromRunId: focused.runId, name: focused.workflowName }, context, canUseTool)
+        .catch(e => onDone(`resume failed: ${(e as Error).message}`));
+    },
+    newRun: () => onDone('Tip: start a named workflow with /<name>, or pass name via the Workflow tool.'),
+    quit: () => {
+      // In confirm mode q = cancel confirmation (routeWorkflowKey already routed to confirmNo);
+      // only in non-confirm mode does it really exit the panel.
+      if (confirmKill !== null) {
+        setConfirmKill(null);
+        return;
+      }
+      onDone();
+    },
+    confirmYes: () => {
+      if (confirmKill === 'workflow' && focused) {
+        svc.kill(focused.runId);
+        // After killing the entire workflow, immediately return to the main chat: the run_done event -> the store reducer changes the status to
+        // killed -> notifications.ts bridges enqueuePendingNotification, and the main chat shows
+        // `Workflow "<name>" was stopped`. Staying on the panel would instead make the user miss the "stopped" feedback.
+        setConfirmKill(null);
+        onDone();
+        return;
+      } else if (confirmKill === 'agent' && focused) {
+        const agent = visibleAgents[clampedAgent];
+        if (agent) svc.killAgent(focused.runId, agent.id);
+      }
+      setConfirmKill(null);
+    },
+    confirmNo: () => setConfirmKill(null),
+  };
+  useWorkflowKeyboard(handlers, confirmKill !== null ? 'confirm' : 'normal');
+
+  const running = runs.filter(r => r.status === 'running').length;
+  const done = runs.length - running;
+  const phaseHeader = selectedPhaseTitle ?? ALL_PHASE;
+  const agentDone = focused ? focused.agents.filter(a => a.status === 'done').length : 0;
+  // Refresh the header duration every second (shared clock; subscribing triggers re-render, duration follows wall clock).
+  const [clockRef] = useAnimationFrame(1000);
+  const elapsed = focused ? Date.now() - focused.startedAt : 0;
+
+  return (
+    <Box ref={clockRef} flexDirection="column" borderStyle="round" borderColor="claude" paddingX={1}>
+      <Box justifyContent="space-between">
+        <Text bold>{focused?.workflowName ?? 'Workflows'}</Text>
+        {focused ? (
+          <Text color="subtle">
+            {agentDone}/{focused.agentCount} agents · {formatDuration(elapsed)} ·{' '}
+            <Text color={RUN_STATUS_COLOR[focused.status] as keyof Theme}>{RUN_STATUS_TEXT[focused.status]}</Text>
+          </Text>
+        ) : (
+          <Text color="subtle">
+            {running} running · {done} done
+          </Text>
+        )}
+      </Box>
+      {focused?.description ? <Text color="subtle">{focused.description}</Text> : null}
+
+      {runs.length > 1 ? (
+        <Box marginTop={1}>
+          <TabsBar runs={runs} activeRunId={activeRunId} />
+        </Box>
+      ) : null}
+
+      <Box flexDirection="row" marginTop={1}>
+        <Box width="25%" flexDirection="column">
+          <Text color={focusColumn === 'phases' ? 'claude' : 'subtle'} bold>
+            Phases
+          </Text>
+          <PhaseSidebar
+            phases={phases}
+            agents={focused?.agents ?? []}
+            selectedIndex={clampedPhase}
+            focused={focusColumn === 'phases'}
+          />
+        </Box>
+        <Text color="subtle">│</Text>
+        <Box flexGrow={1} flexDirection="column">
+          <Text color={focusColumn === 'agents' ? 'claude' : 'subtle'} bold>
+            {phaseHeader} · {visibleAgents.length} agents
+          </Text>
+          <AgentList agents={visibleAgents} selectedIndex={clampedAgent} focused={focusColumn === 'agents'} />
+        </Box>
+      </Box>
+
+      <Box marginTop={1}>
+        <Text color="subtle">
+          {confirmKill !== null
+            ? 'Confirm: y kill · n/Esc cancel'
+            : 'Tab switch run · ←/→ focus · ↑/↓ move · x kill agent · K kill workflow · r resume · q quit'}
+        </Text>
+      </Box>
+
+      {confirmKill !== null ? (
+        <Dialog
+          title={
+            confirmKill === 'workflow'
+              ? `Kill workflow "${focused?.workflowName ?? ''}"?`
+              : `Kill agent "${visibleAgents[clampedAgent]?.label ?? ''}"?`
+          }
+          subtitle={
+            confirmKill === 'workflow'
+              ? 'All in-flight agents will be aborted. Resume will replay from journal.'
+              : 'Only this agent aborts; other agents in the workflow keep running.'
+          }
+          onCancel={() => setConfirmKill(null)}
+          color="warning"
+        >
+          <Text color="subtle">Press y to confirm, or n/Esc to cancel.</Text>
+        </Dialog>
+      ) : null}
+    </Box>
+  );
+}

src/workflow/panel/panelCall.tsx

@@ -0,0 +1,16 @@
+import type { LocalJSXCommandCall } from '../../types/command.js';
+import { SentryErrorBoundary } from '../../components/SentryErrorBoundary.js';
+import { WorkflowsPanel } from './WorkflowsPanel.js';
+
+/**
+ * local-jsx call for /workflows: builds the panel element and returns it for Ink to render.
+ *
+ * Wrapped in SentryErrorBoundary: when useSyncExternalStore / listNamed / child components
+ * throw, the exception must not break through to the REPL top level and crash the whole session; the boundary falls back to a local error card.
+ * onDone/context are injected by the command runtime; args is unused (the panel has no parameterized behavior).
+ */
+export const call: LocalJSXCommandCall = async (onDone, context, _args) => (
+  <SentryErrorBoundary name="WorkflowsPanel">
+    <WorkflowsPanel onDone={onDone} context={context} />
+  </SentryErrorBoundary>
+);

src/workflow/panel/selectors.ts

@@ -0,0 +1,71 @@
+import type { AgentProgress, RunProgress } from '../progress/store.js'
+import type { PhaseStatus } from './status.js'
+
+/** Title of the fixed "no filter" item (first row of the sidebar). */
+export const ALL_PHASE = 'All'
+
+/** Merged phase (including pending), with done/total counts of agents under that phase. */
+export type MergedPhase = {
+  title: string
+  status: PhaseStatus
+  done: number
+  total: number
+}
+
+/**
+ * Merge declaredPhases (declared by meta) and run.phases (actually running/done):
+ * - Declared order takes priority; phases present in actual but not declared are appended at the end.
+ * - No actual record -> pending; otherwise take the actual status.
+ * - done/total = done under that phase / total agents under that phase.
+ */
+export function mergePhases(
+  run: Pick<RunProgress, 'declaredPhases' | 'phases' | 'agents'>,
+): MergedPhase[] {
+  const actualByTitle = new Map(run.phases.map(p => [p.title, p]))
+  const seen = new Set<string>()
+  const out: MergedPhase[] = []
+  const push = (title: string): void => {
+    if (seen.has(title)) return
+    seen.add(title)
+    const actual = actualByTitle.get(title)
+    const status: PhaseStatus = !actual ? 'pending' : actual.status
+    const inPhase = run.agents.filter(a => a.phase === title)
+    out.push({
+      title,
+      status,
+      done: inPhase.filter(a => a.status === 'done').length,
+      total: inPhase.length,
+    })
+  }
+  for (const t of run.declaredPhases) push(t)
+  for (const p of run.phases) push(p.title)
+  return out
+}
+
+/**
+ * Filter agents by the selected phase.
+ * selectedPhase undefined or ALL_PHASE -> all.
+ */
+export function filterAgentsByPhase(
+  agents: AgentProgress[],
+  selectedPhase: string | undefined,
+): AgentProgress[] {
+  if (selectedPhase === undefined || selectedPhase === ALL_PHASE) return agents
+  return agents.filter(a => a.phase === selectedPhase)
+}
+
+/** tab label: workflow name + `#` + last 4 chars of runId (disambiguates same-name runs). */
+export function tabLabel(workflowName: string, runId: string): string {
+  return `${workflowName}#${runId.slice(-4)}`
+}
+
+/** milliseconds -> compact duration (<60s -> `Ns`; <60m -> `MmSSs`; otherwise `HhMMm`). Used by the panel header. */
+export function formatDuration(ms: number): string {
+  const s = Math.floor(ms / 1000)
+  if (s < 60) return `${s}s`
+  const m = Math.floor(s / 60)
+  const ss = s % 60
+  if (m < 60) return `${m}m${String(ss).padStart(2, '0')}s`
+  const h = Math.floor(m / 60)
+  return `${h}h${String(m % 60).padStart(2, '0')}m`
+}

src/workflow/panel/status.ts

@@ -0,0 +1,73 @@
+import type { AgentProgress, RunProgress } from '../progress/store.js'
+
+/** run status -> dot character (used by top tab). */
+export const STATUS_DOT: Record<RunProgress['status'], string> = {
+  running: '●',
+  completed: '✓',
+  failed: '✗',
+  killed: '■',
+}
+
+/** run status -> ink theme color token (follows existing WorkflowList palette). */
+export const RUN_STATUS_COLOR: Record<RunProgress['status'], string> = {
+  running: 'warning',
+  completed: 'success',
+  failed: 'error',
+  killed: 'subtle',
+}
+
+/** run status -> display text (used by header; aligns with reference image done/running). */
+export const RUN_STATUS_TEXT: Record<RunProgress['status'], string> = {
+  running: 'running',
+  completed: 'done',
+  failed: 'failed',
+  killed: 'killed',
+}
+
+/** merged phase status in the sidebar (includes pending: declared by meta but not started). */
+export type PhaseStatus = 'running' | 'done' | 'pending'
+
+export const PHASE_MARK: Record<PhaseStatus, string> = {
+  running: '●',
+  done: '✓',
+  pending: '○',
+}
+
+export const PHASE_COLOR: Record<PhaseStatus, string> = {
+  running: 'warning',
+  done: 'success',
+  pending: 'subtle',
+}
+
+/** visual for an agent row: mark character + color (running has the mark overridden by a spinner animation in UI). */
+export type AgentVisual = { mark: string; color: string }
+
+/**
+ * agent status -> visual.
+ * - running -> ● warning (UI overrides mark with spinner animation)
+ * - done·dead -> ✗ error
+ * - done·ok -> ✓ success
+ */
+export function agentVisual(a: AgentProgress): AgentVisual {
+  if (a.status === 'running') return { mark: '●', color: 'warning' }
+  if (a.resultKind === 'dead') return { mark: '✗', color: 'error' }
+  return { mark: '✓', color: 'success' }
+}
+
+/** token count -> display string (<1000 keeps the raw value; otherwise keeps 1 decimal + k). */
+export function formatTokenCount(n: number | undefined): string {
+  if (!n) return '0'
+  return n >= 1000 ? `${(n / 1000).toFixed(1)}k` : String(n)
+}
+
+/**
+ * right-side stats text for an agent row: `model · Nk tok · N tool`.
+ * Omits the prefix when there is no model; token/tool refresh in real time via agent_progress while running.
+ */
+export function agentMetaText(a: AgentProgress): string {
+  const parts: string[] = []
+  if (a.model) parts.push(a.model)
+  parts.push(`${formatTokenCount(a.tokenCount)} tok`)
+  parts.push(`${a.toolCount ?? 0} tool`)
+  return parts.join(' · ')
+}

src/workflow/panel/useWorkflowKeyboard.ts

@@ -0,0 +1,145 @@
+import { useInput } from '@anthropic/ink'
+
+/** The column that currently has focus. */
+export type FocusColumn = 'phases' | 'agents'
+
+/** Keyboard mode: normal = regular navigation; confirm = a Dialog is open, waiting for the user's y/n confirmation. */
+export type WorkflowKeyboardMode = 'normal' | 'confirm'
+
+/** Subset of the useInput key object (only declares the fields we use, to avoid coupling to the ink Key type). */
+type KeyEvent = {
+  tab?: boolean
+  shift?: boolean
+  escape?: boolean
+  return?: boolean
+  leftArrow?: boolean
+  rightArrow?: boolean
+  upArrow?: boolean
+  downArrow?: boolean
+}
+
+/** key -> action (pure function, easy to unit test; no rendering dependencies). */
+export type WorkflowKeyAction =
+  | 'nextTab'
+  | 'prevTab'
+  | 'focusLeft'
+  | 'focusRight'
+  | 'moveUp'
+  | 'moveDown'
+  | 'killAgent'
+  | 'killWorkflow'
+  | 'resume'
+  | 'newRun'
+  | 'quit'
+  | 'confirmYes'
+  | 'confirmNo'
+
+export function routeWorkflowKey(
+  input: string,
+  key: KeyEvent,
+  mode: WorkflowKeyboardMode = 'normal',
+): WorkflowKeyAction | null {
+  // confirm mode: only y/Enter confirms, n/Esc/q cancels, all other keys are swallowed (prevent mis-touch)
+  if (mode === 'confirm') {
+    if (input === 'y' || input === 'Y' || key.return) return 'confirmYes'
+    if (input === 'n' || input === 'N' || key.escape || input === 'q') {
+      return 'confirmNo'
+    }
+    return null
+  }
+  // @anthropic/ink sets key.tab to true for the Tab key; some environments fall back to '\t'
+  if (key.tab || input === '\t') return key.shift ? 'prevTab' : 'nextTab'
+  if (key.escape || input === 'q') return 'quit'
+  // Capital K = kill the entire workflow; lowercase x = kill the currently selected agent (agents column only).
+  // Case distinction avoids x accidentally triggering workflow kill; K explicitly requires Shift, hinting at a "heavy operation".
+  if (input === 'K') return 'killWorkflow'
+  if (input === 'x') return 'killAgent'
+  if (input === 'r') return 'resume'
+  if (input === 'n') return 'newRun'
+  if (key.leftArrow) return 'focusLeft'
+  if (key.rightArrow) return 'focusRight'
+  if (key.upArrow) return 'moveUp'
+  if (key.downArrow) return 'moveDown'
+  return null
+}
+
+/** Focus model callbacks (injected by WorkflowsPanel). */
+export type WorkflowKeyboardHandlers = {
+  nextTab: () => void
+  prevTab: () => void
+  focusLeft: () => void
+  focusRight: () => void
+  moveUp: () => void
+  moveDown: () => void
+  /** Request killing the currently selected agent (panel pops a Dialog for secondary confirmation). */
+  killAgent: () => void
+  /** Request killing the entire workflow (panel pops a Dialog for secondary confirmation). */
+  killWorkflow: () => void
+  resumeFocused: () => void
+  newRun: () => void
+  quit: () => void
+  /** User confirms in confirm mode (y/Enter). */
+  confirmYes: () => void
+  /** User cancels in confirm mode (n/Esc/q). */
+  confirmNo: () => void
+}
+
+/**
+ * /workflows panel keybindings (focus rotation model):
+ * - Tab / Shift+Tab: switch the top run tab
+ * - Left / Right: switch focus between phases and agents
+ * - Up / Down: move within the currently focused column
+ * - x kill single agent · K kill the entire workflow (with Dialog secondary confirmation) · r resume · n new · q / Esc quit
+ *
+ * @param mode In confirm mode only y/n/Esc/q are accepted, all other keys are swallowed - avoid mis-navigation inside the confirmation dialog.
+ */
+export function useWorkflowKeyboard(
+  h: WorkflowKeyboardHandlers,
+  mode: WorkflowKeyboardMode = 'normal',
+): void {
+  useInput((input, key) => {
+    const action = routeWorkflowKey(input, key as KeyEvent, mode)
+    if (action === null) return
+    switch (action) {
+      case 'nextTab':
+        h.nextTab()
+        break
+      case 'prevTab':
+        h.prevTab()
+        break
+      case 'focusLeft':
+        h.focusLeft()
+        break
+      case 'focusRight':
+        h.focusRight()
+        break
+      case 'moveUp':
+        h.moveUp()
+        break
+      case 'moveDown':
+        h.moveDown()
+        break
+      case 'killAgent':
+        h.killAgent()
+        break
+      case 'killWorkflow':
+        h.killWorkflow()
+        break
+      case 'resume':
+        h.resumeFocused()
+        break
+      case 'newRun':
+        h.newRun()
+        break
+      case 'quit':
+        h.quit()
+        break
+      case 'confirmYes':
+        h.confirmYes()
+        break
+      case 'confirmNo':
+        h.confirmNo()
+        break
+    }
+  })
+}