@zhushanwen/pi-subagent-workflow 8.14.7 → 9.0.0

package/src/interface/bg-notify-render.ts

@@ -25,15 +25,14 @@ import type { Theme } from "@earendil-works/pi-coding-agent";
 import { displayAgentName } from "@zhushanwen/subagent-core";
 import { deriveOutcome } from "@zhushanwen/subagent-core";
 import { CLOSED_REASONS } from "@zhushanwen/subagent-core";
-import type { ClosedReason, ExecutionOutcome } from "@zhushanwen/subagent-core";
+import type { ClosedReason } from "@zhushanwen/subagent-core";
 import {
   firstLineSanitized,
-  padToVisible,
   shortId,
   statusGlyph,
   type ThemeLike,
-  truncLine,
 } from "./format.ts";
+import { padToVisible, truncLine } from "./tui-kit.ts";
 
 /** agent 名最大显示宽度。 */
 const AGENT_MAX_WIDTH = 40;
@@ -50,6 +49,16 @@ const BORDER_CHARS = 2;
 /** 能画出完整边框的最小宽度（│ │ 各 1 + 至少 1 内容列）。 */
 const MIN_BORDER_WIDTH = BORDER_CHARS + INNER_PAD_TOTAL + 1;
 
+/**
+ * record 域轮终 outcome 子集（[W2 D5] 单源 RunOutcome 收窄别名——interrupted 只由
+ * run 收编/回收路径写入，record 轮终构造性不可达）。本文件原经 core 的
+ * ExecutionOutcome 消费同值联合；[D2]（workflow-run-resume-revision）RunOutcome
+ * 词表重构后 Exclude 派生失效（interrupted 已移出），本域改独立实体字面量、与
+ * core execution/assembly/types.ts 的 ExecutionOutcome 三值同构（record 域终局
+ * 形态不含 run 级 time_limited）。
+ */
+type RecordOutcome = "completed" | "failed" | "cancelled";
+
 /**
  * background 完成通知的 record 形态（从 message.details 提取）。
  * notifier.ts 构造，本文件防御性解析。
@@ -58,10 +67,10 @@ interface BgNotifyRecord {
   id: string;
   /** v4 B-1: closed（终态，含 cancelled）或 running（对话模式轮次完成，旧 idle）。 */
   status: "running" | "closed";
-  /** L2 关闭原因子枚举（内部诊断 + outcome 兑底派生输入；经 toClosedReason 防御性收窄）。 */
+  /** L2 关闭原因子枚举（内部诊断 + outcome 兜底派生输入；经 toClosedReason 防御性收窄）。 */
   closedReason?: ClosedReason;
-  /** 终态三态对外语义（U3 C-outcome）。缺失（升级前旧消息重放）时按 deriveOutcome 兑底。 */
-  outcome?: ExecutionOutcome;
+  /** 终态三态对外语义（U3 C-outcome）。缺失（升级前旧消息重放）时按 deriveOutcome 兜底。 */
+  outcome?: RecordOutcome;
   agent: string;
   model?: string;
   result?: string;
@@ -213,7 +222,7 @@ function renderRecordLines(record: BgNotifyRecord, t: ThemeLike): string[] {
     ? ` ${t.fg("dim", "·")} ${t.fg("accent", truncLine(record.model, MODEL_MAX_WIDTH))}`
     : "";
   // U3 C-outcome：verb 与正文分流只读 outcome——单一权威派生（升级前旧消息重放等
-  // details 缺 outcome 的存量形态经 deriveOutcome(closedReason, error) 兑底，非同构
+  // details 缺 outcome 的存量形态经 deriveOutcome(closedReason, error) 兜底，非同构
   // 重写）。判定先于 patchFile：failed 分支不展示 patch/result（失败轮也会写
   // patchFile，历史 bug 存档见 deriveOutcome 注释）。
   const outcome = record.outcome ?? deriveOutcome(record.closedReason, record.error);
@@ -257,14 +266,14 @@ function renderRecordLines(record: BgNotifyRecord, t: ThemeLike): string[] {
 
 /**
  * details.closedReason 防御性收窄：任意字符串 → ClosedReason | undefined。
- * 旧数据/外部构造的非法值按缺失处理，交由 deriveOutcome 兑底（消费方不崩溃）。
+ * 旧数据/外部构造的非法值按缺失处理，交由 deriveOutcome 兜底（消费方不崩溃）。
  */
 function toClosedReason(value: unknown): ClosedReason | undefined {
   return CLOSED_REASONS.find((reason) => reason === value);
 }
 
 /** details.outcome 防御性收窄：仅接受三态枚举值，其余按缺失处理。 */
-function toOutcome(value: unknown): ExecutionOutcome | undefined {
+function toOutcome(value: unknown): RecordOutcome | undefined {
   return value === "completed" || value === "failed" || value === "cancelled" ? value : undefined;
 }
 

package/src/interface/command-actions.ts

@@ -22,22 +22,22 @@ export type SubagentRpcAction =
 /** /workflows RPC action 判别联合。 */
 export type WorkflowRpcAction =
   | { action: "abort"; runId: string }
-  | { action: "lifecycle-missing-id"; verb: "abort" }
-  | { action: "lifecycle-removed"; verb: "pause" | "resume" }
+  | { action: "resume"; runId: string }
+  | { action: "lifecycle-missing-id"; verb: "abort" | "resume" }
+  | { action: "lifecycle-removed"; verb: "pause" }
   | { action: "noop" };
 
 /**
- * 已移除的 lifecycle verb 集合（pause/resume——run 一次性生命周期化后删除，
- * 解析为 lifecycle-removed 提示，而非 unknown noop）。
+ * 已移除的 lifecycle verb 集合（pause——run 一次性生命周期化后删除，解析为
+ * lifecycle-removed 提示，而非 unknown noop）。resume 不在此列：断点续跑能力
+ * 落地后 resume 是一等 action（workflow-run-resume-revision U3「action 词表
+ * 适配」覆盖 RPC 通道——taiji GUI 用户经 client.prompt 发 /workflows resume）。
  */
-const REMOVED_LIFECYCLE_VERBS: ReadonlySet<"pause" | "resume"> = new Set([
-  "pause",
-  "resume",
-]);
+const REMOVED_LIFECYCLE_VERBS: ReadonlySet<"pause"> = new Set(["pause"]);
 
-/** verb 是否为已移除的 lifecycle action（类型守卫，收窄到 "pause" | "resume"）。 */
-function isRemovedLifecycleVerb(verb: string): verb is "pause" | "resume" {
-  return REMOVED_LIFECYCLE_VERBS.has(verb as "pause" | "resume");
+/** verb 是否为已移除的 lifecycle action（类型守卫，收窄到 "pause"）。 */
+function isRemovedLifecycleVerb(verb: string): verb is "pause" {
+  return REMOVED_LIFECYCLE_VERBS.has(verb as "pause");
 }
 
 /**
@@ -128,8 +128,11 @@ export function parseSubagentRpcCommand(argsStr: string): SubagentRpcAction {
  * 支持格式：
  * - `abort <runId>` → { action: "abort", runId }
  * - `abort`（无 runId）→ { action: "lifecycle-missing-id", verb: "abort" }
- * - `pause|resume ...`（已移除的 lifecycle verb，带或不带 runId 均同）→
- *   { action: "lifecycle-removed", verb }——removed verb 优先于 missing-id 判定
+ * - `resume <runId>` → { action: "resume", runId }（断点续跑——与 TUI verb、
+ *   workflow tool action:"resume" 三通道同语义）
+ * - `resume`（无 runId）→ { action: "lifecycle-missing-id", verb: "resume" }
+ * - `pause ...`（已移除的 lifecycle verb，带或不带 runId 均同）→
+ *   { action: "lifecycle-removed", verb: "pause" }——removed verb 优先于 missing-id 判定
  *  （提示语义优先：用户应得知能力已删除并获 abort 指引，而非被引导补 runId）
  * - 其他（空 / 未知 action / 无参）→ { action: "noop" }
  */
@@ -141,10 +144,12 @@ export function parseWorkflowRpcCommand(argsStr: string): WorkflowRpcAction {
   if (isRemovedLifecycleVerb(verb)) {
     return { action: "lifecycle-removed", verb };
   }
-  // abort 是 lifecycle verb 单成员（pause/resume 已移除，见上），直判即可，无需集合机件
-  if (verb === "abort") {
-    if (!runId) return { action: "lifecycle-missing-id", verb: "abort" };
-    return { action: "abort", runId };
+  // abort/resume 是 lifecycle verb 现行成员（pause 已移除，见上），直判即可，无需集合机件
+  if (verb === "abort" || verb === "resume") {
+    if (!runId) return { action: "lifecycle-missing-id", verb };
+    return verb === "abort"
+      ? { action: "abort", runId }
+      : { action: "resume", runId };
   }
   return { action: "noop" };
 }

package/src/interface/commands.ts

@@ -8,6 +8,7 @@
  * - /workflow run <name> → 用 workflow tool { action: "run" }
  * - /workflow list → 用 workflow tool { action: "status" }
  * - /workflow abort <run-id> → 用 workflow tool { action: "abort" }
+ * - /workflow resume <run-id> → 用 workflow tool { action: "resume" }（interrupted 态断点续跑）
  * - /workflow save <name> → 用 workflow-script tool { action: "save" }
  * - /workflow delete <name> → 用 workflow-script tool { action: "delete" }
  *
@@ -22,17 +23,22 @@
 import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@earendil-works/pi-coding-agent";
 
 import type { LauncherDeps } from "@zhushanwen/subagent-core";
-import { abortRun, getSubagentService } from "@zhushanwen/subagent-core";
+import { abortRun, getSubagentService, resumeRun } from "@zhushanwen/subagent-core";
 import type { WorkflowRun } from "@zhushanwen/subagent-core";
 import { parseWorkflowRpcCommand, type WorkflowRpcAction } from "./command-actions.ts";
 import { createWorkflowsView, type ViewActions } from "./views/WorkflowsView.ts";
 import { toErrorMessage } from "@zhushanwen/pi-ext-guards";
 import { LIST_LIMIT } from "./list-shared.ts";
 import { ID_PREVIEW_LENGTH } from "./id-preview.ts";
+import { displayStatusOf } from "./tool-workflow.ts";
 
-/** status 显示顺序：running 优先（活跃态在前），再 startedAt 倒序。 */
+/** status 显示顺序：running 优先（活跃态在前），interrupted 次之（[D2] 暂停态
+ *  ——无活体但可续跑，排活体后、终局前），再 startedAt 倒序。
+ *  [W2/V1 D1 第 6 行] 权重表消费键 = displayStatusOf 投影三态（排序键不读
+ *  outcome 细分——outcome 由 runSummary.reason 并列承载）。 */
 const STATUS_ORDER: Record<string, number> = {
   running: 0,
+  interrupted: 1,
   done: 2,
 };
 /** 未知 status 的默认排序权重（排在已知 status 之后）。 */
@@ -45,6 +51,7 @@ const UNKNOWN_STATUS_WEIGHT = 9;
  *
  * 行为：
  * - 无 UI（RPC/print/json 模式）→ notify 提示（降级，不打开 TUI）
+ * - `/workflows resume <runId>`（TUI）→ 执行断点续跑后 notify，不打开面板
  * - `/workflows <runId>` 或前缀匹配唯一 run → 直接打开该 run 的 view
  * - `/workflows`（无参）：
  * · 0 runs → notify "No workflows"
@@ -56,7 +63,7 @@ const UNKNOWN_STATUS_WEIGHT = 9;
  *
  * @param api ExtensionAPI
  * @param getRuns 获取当前 session 的 runs（Map<runId, WorkflowRun>）
- * @param deps LauncherDeps（lifecycle abort 用）
+ * @param deps LauncherDeps（lifecycle abort / resumeRun 用）
  */
 export function registerWorkflowsCommand(
   api: ExtensionAPI,
@@ -64,7 +71,7 @@ export function registerWorkflowsCommand(
   deps: LauncherDeps,
 ): void {
   api.registerCommand("workflows", {
-    description: "Open workflow panel. /workflows [runId] | /workflows abort <runId>",
+    description: "Open workflow panel. /workflows [runId] | /workflows abort <runId> | /workflows resume <runId>",
     getArgumentCompletions(prefix: string) {
       const trimmed = prefix.trimStart();
       const parts = trimmed.split(/\s+/).filter(Boolean);
@@ -73,18 +80,19 @@ export function registerWorkflowsCommand(
       if (parts.length <= 1) {
         return [
           { label: "abort", value: "abort ", description: "Abort a workflow run" },
+          { label: "resume", value: "resume ", description: "Resume an interrupted workflow run" },
         ].filter((opt) => opt.label.startsWith(trimmed.toLowerCase()));
       }
 
       // 第二级：lifecycle 动词后补全当前 session 的 runId
-      if (parts[0] === "abort") {
+      if (parts[0] === "abort" || parts[0] === "resume") {
         try {
           const runs = sortedRuns(getRuns());
           if (runs.length === 0) return null;
           return runs.map((r) => ({
             label: r.runId,
             value: r.runId,
-            description: `${r.spec.scriptName} [${r.state.status}]`,
+            description: `${r.spec.scriptName} [${displayStatusOf(r)}]`,
           }));
         } catch {
           // 拿不到运行时数据（getRuns 抛错）→ 静默降级，补全失败不影响 command
@@ -107,8 +115,30 @@ export function registerWorkflowsCommand(
         return;
       }
 
+      // TUI 动词命令：/workflows resume <runId>——执行断点续跑后 notify，不打开面板
+      // （abort 动词在 TUI 侧无既有通道，不在此顺手扩——resume 是本批接入面）
+      const trimmedArgs = args.trim();
+      const [verb, ...rest] = trimmedArgs.split(/\s+/).filter(Boolean);
+      if (verb === "resume") {
+        const runId = rest[0];
+        if (!runId) {
+          ctx.ui.notify("Usage: /workflows resume <runId>", "warning");
+          return;
+        }
+        try {
+          await resumeRun(runId, deps);
+          ctx.ui.notify(
+            `Workflow ${runId}: resuming — completed calls replay at zero token cost, unfinished calls re-dispatched`,
+            "info",
+          );
+        } catch (err) {
+          ctx.ui.notify(`Failed to resume workflow ${runId}: ${toErrorMessage(err)}`, "warning");
+        }
+        return;
+      }
+
       // 直接按 runId / 前缀匹配打开
-      const directRunId = args.trim();
+      const directRunId = trimmedArgs;
       if (directRunId) {
         await openByRunId(directRunId, getRuns, ctx, deps);
         return;
@@ -127,7 +157,10 @@ export function registerWorkflowsCommand(
  *
  * 各 action 语义：
  * - abort → 调 lifecycle abortRun，成功/失败均 notify（不向上抛）
- * - lifecycle-removed → 已移除的 verb（pause/resume），给定制指引而非 Usage
+ * - resume → 调 core resumeRun 断点续跑（与 TUI verb、workflow tool
+ *   action:"resume" 三通道同语义——D14 args 校验面在 tool action 入口，命令
+ *   通道不带 args，沿用历史 args），成功/失败均 notify（不向上抛）
+ * - lifecycle-removed → 已移除的 verb（pause），给定制指引而非 Usage
  *   （F3 定稿——提示语义优先于 missing-id：run 一次性生命周期后不可挂起）
  * - lifecycle-missing-id → Usage 提示
  * - noop → 无 action 或未知 action：GUI 端已屏蔽此 command 入口，此处兜底
@@ -149,6 +182,19 @@ async function handleRpcMode(
       }
       return;
     }
+    case "resume": {
+      try {
+        await resumeRun(parsed.runId, deps);
+        ctx.ui.notify(
+          `Workflow ${parsed.runId}: resuming — completed calls replay at zero token cost, unfinished calls re-dispatched`,
+          "info",
+        );
+      } catch (err) {
+        const msg = toErrorMessage(err);
+        ctx.ui.notify(`Failed to resume workflow ${parsed.runId}: ${msg}`, "warning");
+      }
+      return;
+    }
     case "lifecycle-removed":
       ctx.ui.notify(
         `Workflow ${parsed.verb} has been removed — runs are one-shot. To stop a run early: /workflows abort <runId>`,
@@ -217,7 +263,7 @@ async function openFromList(
 
   // 多 run——select 选择
   const entries = all.map(
-    (r) => `${r.spec.scriptName} [${r.state.status}] (${r.runId.slice(0, ID_PREVIEW_LENGTH)})`,
+    (r) => `${r.spec.scriptName} [${displayStatusOf(r)}] (${r.runId.slice(0, ID_PREVIEW_LENGTH)})`,
   );
   const selected = await ctx.ui.select("Select workflow:", entries);
   if (!selected) return;
@@ -233,8 +279,8 @@ async function openFromList(
 function sortedRuns(runs: Map<string, WorkflowRun>): WorkflowRun[] {
   const arr = Array.from(runs.values());
   return arr.sort((a, b) => {
-    const sa = STATUS_ORDER[a.state.status] ?? UNKNOWN_STATUS_WEIGHT;
-    const sb = STATUS_ORDER[b.state.status] ?? UNKNOWN_STATUS_WEIGHT;
+    const sa = STATUS_ORDER[displayStatusOf(a)] ?? UNKNOWN_STATUS_WEIGHT;
+    const sb = STATUS_ORDER[displayStatusOf(b)] ?? UNKNOWN_STATUS_WEIGHT;
     if (sa !== sb) return sa - sb;
     const ta = a.meta.startedAt ? new Date(a.meta.startedAt).getTime() : 0;
     const tb = b.meta.startedAt ? new Date(b.meta.startedAt).getTime() : 0;
@@ -246,7 +292,7 @@ function sortedRuns(runs: Map<string, WorkflowRun>): WorkflowRun[] {
  * 打开 WorkflowsView（三级导航 TUI），注入 lifecycle ViewActions。
  *
  * ViewActions 通过 deps 调 lifecycle（abort），与 view 解耦——
- * view 单测可注入 mock actions（见 views/__tests__/WorkflowsView-signature.test.ts）。
+ * view 单测可注入 mock actions（见 views/__tests__/WorkflowsView.test.ts）。
  *
  * [H2 W3] live 进度数据源（设计 D2 进度源切换）：view 经 store 查询
  * collectRecordsByParentRunId(run.runId)（内存 ∪ 磁盘重建 ∪ manifest，LIST_LIMIT

package/src/interface/format.ts

@@ -6,8 +6,8 @@
 //   `·` 同级并列字段/thinking 图标;`()` 元数据分组;`›` 工具;`>` 输出;`·` thinking.
 //   禁用 `│` 做 stats 分隔、`├─`/`└─` 做 eventLog 前缀.
 //
-// 截断/填充/换行（truncLine / padToVisible / segFillColored / wrapText）已迁
-// ./tui-kit.ts（post-convergence C4 零依赖叶），本文件 re-export 维持既有导入面.
+// 截断/填充/换行（truncLine / padToVisible / segFillColored / wrapText）单定义
+// ./tui-kit.ts（零依赖叶），消费方直接从 tui-kit import。
 
 import os from "node:os";
 
@@ -20,17 +20,12 @@ import { DEFAULT_AGENT_NAME } from "@zhushanwen/subagent-core";
 import type {
   DoneReason,
   ExecutionTraceNode,
+  RunEventFoldCheckpoint,
   RunStatus,
   ToolCallEntry,
 } from "@zhushanwen/subagent-core";
 import { displayAgentName } from "@zhushanwen/subagent-core";
 
-import { padToVisible, segFillColored, truncLine, wrapText } from "./tui-kit.ts";
-
-// ANSI 可见宽度布局家族单定义在 ./tui-kit.ts（零依赖叶）；此处 re-export 保持
-// 既有消费方（tool-render / bg-notify-render / 测试等）导入面零改动。
-export { padToVisible, segFillColored, truncLine, wrapText };
-
 /**
  * ThemeLike:TUI 语义 token 着色接口(duck-typed,兼容 Pi Theme).
  *
@@ -419,7 +414,7 @@ export function formatDisplayItem(item: DisplayItem, theme: ThemeLike): string {
 // 自 views/format.ts 并入（D7-① 双轨合并）：workflow 视图特有的 badge/phase/
 // trace 行格式化在此作差异段保留。并入时收敛的同构构件——ThemeLike、
 // formatElapsedSeconds（本文件版含小时分支，>1h 显示 "1h15m" 而非 "75m30s"）、
-// segFillColored、padToVisible（后者已随 C4 迁 ./tui-kit.ts，经 re-export 复用）。
+// segFillColored、padToVisible（后者已随 C4 迁 ./tui-kit.ts，消费方直接 import）。
 // ============================================================
 
 // ── Workflow view 布局常量 ────────────────────────────────────
@@ -437,14 +432,16 @@ const MS_PER_SEC = 1000;
 /**
  * 可显示的状态文本集合。
  *
- * 包含 RunStatus（"running"|"done" 不直接显示，转 reason）+ DoneReason
- * （completed/failed/aborted/budget_limited/time_limited）+ ExecutionTraceNode.status
- * （含 "pending"——trace 节点的初始态）。
+ * 包含 RunStatus（"running"|"done" 不直接显示，转 reason）+ 中断投影态
+ * "interrupted"（[D2] 重水合中断 run 经 meta.interruptedAt 投影——displayStatusOf
+ * 三态输出的第三值）+ DoneReason（completed/failed/aborted/budget_limited/
+ * time_limited）+ ExecutionTraceNode.status（含 "pending"——trace 节点的初始态）。
  *
  * 收窄自 string → 显式联合，编译器会在新增 status 时强制 switch 补齐分支。
  */
 export type StatusText =
   | RunStatus
+  | "interrupted"
   | DoneReason
   | "pending";
 
@@ -476,6 +473,7 @@ export function formatStatusBadge(
 ): string {
   switch (status) {
     case "running": return theme.fg("warning", "\u25CF running");
+    case "interrupted": return theme.fg("muted", "\u25CB interrupted");
     case "completed": return theme.fg("success", "\u2713 completed");
     case "failed": return theme.fg("error", "\u2717 failed");
     case "aborted": return theme.fg("error", "\u2717 aborted");
@@ -589,10 +587,28 @@ export function formatActivityLine(entry: ToolCallEntry, maxWidth: number): stri
 
 // ── Workflow phase group（filters empty phases）──────────────
 
+/**
+ * phase 折叠投影的展示消费面（[D3] phase 状态机与展示分组同源）。
+ *
+ * 数据源 = core fold 的 phases 半边（RunEventFoldCheckpoint["phases"]：
+ * phase 名 → { startedAt, settledAt? }——settledAt 有无即 running/settled 态，
+ * 由 phase-settled 转移事件驱动）。展示分组的 phase 完成判定读它而非「组内节点
+ * 全部 completed」的推导——「续聊时算不算完成」的唯一答案：phase 看 call 落定
+ * 事件（fold 权威），agent 会话续聊是另一层。
+ */
+export type PhaseFoldProjection = RunEventFoldCheckpoint["phases"];
+
 export interface PhaseGroup {
   name: string;
   nodes: ExecutionTraceNode[];
   doneCount: number;
+  /**
+   * [D3] phase 状态机态的展示位：true = phase-settled 转移已落账（fold 投影
+   * settledAt 有值）。注入折叠投影时读投影（权威）；未注入（活体聚合 trace 的
+   * 既有调用形态）回落「组内全部节点 completed」推导——两者的同源性由测试
+   * 断言钉住（同一事件流喂两侧恒等）。
+   */
+  settled: boolean;
 }
 
 /** Group trace nodes by phase. Nodes without phase go to "(no phase)". */
@@ -617,16 +633,34 @@ function groupByPhase(nodes: ExecutionTraceNode[]): Map<string, ExecutionTraceNo
 /** The fallback phase name when node has no explicit phase. */
 const NO_PHASE = "(default)";
 
-/** Build phase groups. Nodes without a phase are placed in an unnamed group. */
-export function buildPhaseGroups(nodes: ExecutionTraceNode[]): PhaseGroup[] {
+/**
+ * Build phase groups. Nodes without a phase are placed in an unnamed group.
+ *
+ * @param nodes trace 节点（活体聚合或 fold 重建的 calls 投影）
+ * @param phaseFold 可选的 phase 折叠投影（[D3] 状态机权威）——在场时组完成判定
+ *   读投影（phase 名 → settledAt 有无）；(default) 组（无 phase 归属节点）在投影
+ *   中无对应行（fold 只登记显式 phase），恒走节点计数推导兜底。
+ */
+export function buildPhaseGroups(
+  nodes: ExecutionTraceNode[],
+  phaseFold?: PhaseFoldProjection,
+): PhaseGroup[] {
   const map = groupByPhase(nodes);
   const result: PhaseGroup[] = [];
   for (const [name, phaseNodes] of map) {
     if (phaseNodes.length > 0) {
+      const doneCount = phaseNodes.filter((n) => n.status === "completed").length;
+      // 投影在场且该 phase 有行 → 读投影（行存在即权威——running 行 settledAt
+      // undefined 判 false，不回落推导）；未注入投影 / 无该行（(default) 组）→ 推导兜底
+      const foldRow = phaseFold?.get(name);
+      const settled = foldRow !== undefined
+        ? foldRow.settledAt !== undefined
+        : doneCount === phaseNodes.length;
       result.push({
         name: name === NO_PHASE ? "" : name,
         nodes: phaseNodes,
-        doneCount: phaseNodes.filter((n) => n.status === "completed").length,
+        doneCount,
+        settled,
       });
     }
   }
@@ -643,7 +677,7 @@ export function formatPhaseLine(
   maxWidth: number,
 ): string {
   const pointer = isSelected ? "❯ " : "  ";
-  const dot = statusDotStr(pg.doneCount === pg.nodes.length ? "completed" : "running", theme);
+  const dot = statusDotStr(pg.settled ? "completed" : "running", theme);
   const name = pg.name || "(unnamed)";
   const label = `${idx + 1} ${name} ${pg.doneCount}/${pg.nodes.length}`;
   // pointer(2) + dot(1) + space(1)

package/src/interface/id-preview.ts

@@ -3,10 +3,10 @@
 // run/subagent 标识符的截断展示口径（单点常量）。
 //
 // runId（wf-<ts>-<rand>）与 subagentId（UUID）分属两族标识符，但所有展示面
-// （workflow tool 渲染 / /workflows 命令行 / GUI label / subagent GUI header）
-// 统一取前 8 字符做预览——同一口径保证各界面引用同一 run/subagent 时展示一致
-// （helpers 的 GUI label 与 buildWorkflowGui 对齐先例 I#3）。此前 4 处本地常量
-// 3 种命名（RUNID_SHORT ×2 / RUN_ID_DISPLAY_LENGTH / SUBAGENT_ID_PREVIEW）收敛到此。
+// （workflow tool 渲染 / /workflows 命令行 / subagent GUI header）统一取前 8 字符
+// 做预览——同一口径保证各界面引用同一 run/subagent 时展示一致（对齐先例 I#3）。
+// 此前 4 处本地常量 3 种命名（RUNID_SHORT ×2 / RUN_ID_DISPLAY_LENGTH /
+// SUBAGENT_ID_PREVIEW）收敛到此。
 
 /** 标识符截断展示长度（前 N 字符）。 */
 export const ID_PREVIEW_LENGTH = 8;

package/src/interface/subagent-actions.ts

@@ -1,25 +1,19 @@
 // src/interface/subagent-actions.ts
 //
-// subagent tool 六 action 的 pi adapter 壳（sink 设计 D6② 消费收缩）。
+// subagent tool 六 action 的 TUI/GUI 渲染壳（sink 设计 D6② 消费收缩）。
 //
 // 领域内核（入参校验 / message 拒绝文案分流 / fork-from 拒绝链 / 终态映射 /
-// list 投影）已下沉 core @zhushanwen/subagent-core/execution/assembly/subagent-actions-core——
-// ⛔4 行为快照等值锚定见 core __tests__/subagent-actions-core.test.ts（期望值硬编码自
-// 本文件迁移前实测输出，含错误文案逐字锚）。本壳按设计仅保留三类职责：
-//   1. core 调用面 re-export：六 handler + 领域类型（签名不变，消费方零改动）
-//   2. 参数提取：位于 subagent-tool.ts executeSubagent（action 路由 / listParam /
-//      cancelParam 解包 / skillPath-cwd 路径检查），本次收缩零改动
-//   3. TUI/GUI 渲染：adapter / buildGuiComponent（pi TUI 渲染族按设计留壳）
+// list 投影）在 core @zhushanwen/subagent-core/execution/assembly/subagent-actions-core，
+// 六 handler + 领域类型消费方经 core barrel import；行为快照等值锚定见 core
+// __tests__/subagent-actions-core.test.ts（期望值硬编码自迁移前实测输出，含错误
+// 文案逐字锚）。参数提取位于 subagent-tool.ts executeSubagent（action 路由 /
+// listParam / cancelParam 解包 / skillPath-cwd 路径检查）。本壳只做渲染：
+// adapter（领域对象 → {content, details}）+ buildGuiComponent（GUI 协议组件）。
 //
 // content（JSON 字符串）给 LLM，details（SubagentToolResult）给 renderResult，同源同处生成。
 
 import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
-import {
-  guiComponent,
-  type GuiContext,
-  guiResult,
-  isGuiCapable,
-} from "@zhushanwen/extension-protocol";
+import { guiComponent, type GuiContext } from "@zhushanwen/extension-protocol";
 
 import type {
   CancelHandlerResult,
@@ -32,37 +26,7 @@ import type {
 } from "@zhushanwen/subagent-core";
 import { mapRunIcon, mapRunStatus } from "./gui-mappers.ts";
 import { ID_PREVIEW_LENGTH } from "./id-preview.ts";
-
-// ============================================================
-// core 领域内核 re-export（pi 消费面符号与收缩前一致，经 core barrel 统一消费）
-// ============================================================
-
-export {
-  cancelHandler,
-  closeHandler,
-  endedMessageGuard,
-  forkFromHandler,
-  listHandler,
-  mapExternalState,
-  messageHandler,
-  recordToListItem,
-  startHandler,
-} from "@zhushanwen/subagent-core";
-
-export type {
-  CancelHandlerInput,
-  CancelHandlerResult,
-  CloseHandlerInput,
-  CloseHandlerResult,
-  ForkFromHandlerInput,
-  ForkFromHandlerResult,
-  ListHandlerInput,
-  ListHandlerResult,
-  MessageHandlerInput,
-  MessageHandlerResult,
-  StartHandlerInput,
-  StartHandlerResult,
-} from "@zhushanwen/subagent-core";
+import { withGuiAttach } from "./tool-shared.ts";
 
 // ============================================================
 // 渲染层常量 / 类型（pi TUI 渲染族，按设计留壳）
@@ -76,8 +40,9 @@ function assertNever(value: never): string {
 /**
  * action ↔ domain 配对的承重类型（替代三处松散 `as`）。
  * 调用方必须传匹配的 {action, domain}——TS 在调用点校验，错配编译报错。
+ * export：gui.test.ts 经 type-only import 消费（RPC/TUI 模式分发契约）。
  */
-type AdapterInput =
+export type AdapterInput =
   | { action: "start"; domain: StartHandlerResult }
   | { action: "list"; domain: ListHandlerResult }
   | { action: "cancel"; domain: CancelHandlerResult }
@@ -128,10 +93,13 @@ export function adapter(
     detailsBase = { action: "start", subagentId: d.subagentId, sessionFile: d.sessionFile ?? null, slug: d.slug, model: d.model, bgResponse: d.response };
   }
 
-  // GUI 协议：RPC 模式下附加结构化渲染数据（union 各成员已声明 __gui__?，无需强转）
-  const details: SubagentToolResult = ctx && isGuiCapable(ctx)
-    ? { ...detailsBase, __gui__: guiResult(buildGuiComponent(input, result)) }
-    : detailsBase;
+  // GUI 协议：RPC 模式下附加结构化渲染数据（attach 单点在 tool-shared；组件构造
+  // 用 input/result 而非 detailsBase——与 adapter 领域对象同源）
+  const details: SubagentToolResult = withGuiAttach(
+    detailsBase,
+    ctx,
+    () => buildGuiComponent(input, result),
+  );
 
   // [W3 修复] list action 追加 reminder text block：LLM 调 list 时提醒不要轮询。
   // reminder 作为第二个 text block（独立追加，不污染 details/JSON schema）。