agentworkshop 0.7.44 → 0.7.46

package/server/services/workshop/runtime/scheduler-loop.ts

@@ -1,799 +0,0 @@
-/**
- * SchedulerLoop — lead 常驻调度循环(统一调度核心)。
- * 定时 tick + 事件唤醒(wake 去抖合并);每轮在 lead.execLock 串行化下:
- * 收集快照 → lead.supervise 决策(未实现/抛错回退内置规则引擎)→ 逐条执行决策。
- * 支持三种执行模式:goal(满意度判断)/ loop(循环重放)/ pipeline(流水线)。
- * 权威契约见 docs/superpowers/plans/2026-08-13-agent-workshop-multi-agent.md 核心契约块 T5。
- */
-import { createLogger } from '../logger'
-import { randomUUID } from 'node:crypto'
-import { TERMINAL_TASK_STATES } from '../types/task'
-import type { A2AMessage, ChannelMail } from '../types/a2a'
-import type { SupervisionDecision, SupervisionSnapshot, ExecutionMode, AgentWorkspace } from '../agents/agent-interface'
-import { AppError } from '../../../utils/errors'
-import type { ChannelRuntime } from './channel-runtime'
-import type { AgentRuntime } from './agent-runtime'
-import {
-  extractTaskMode,
-  findModeTask,
-  isGoalSummaryArtifact,
-  LoopController,
-  type ModeConfig,
-} from './execution-mode'
-
-const log = createLogger('workshop.scheduler')
-
-/** 调度快照注入的最近邮件条数(倒序;控制 supervise prompt 体量) */
-const MAIL_SNAPSHOT_LIMIT = 20
-
-/** 成员摘要(快照内;含队列上下文与实时进度,供 lead 最优调配与停滞识别) */
-interface MemberView {
-  agentId: string
-  name: string
-  role: 'lead' | 'worker'
-  state: 'idle' | 'busy' | 'stopped'
-  /** 待执行队列长度(SUBMITTED/ASSIGNED;FIFO) */
-  queued: number
-  /** 执行中任务 id(空闲为 null) */
-  currentTaskId: string | null
-  /** 执行中任务标题(lead 观察 worker 在干什么,不必翻任务表) */
-  currentTaskTitle: string | null
-  /** 执行中任务进度 0-100(空闲/未上报为 null;lead 据此判断是否在推进) */
-  currentTaskProgress: number | null
-  /** 已完成任务数 */
-  completedCount: number
-  /** 忙碌但进度长期停滞(超 stallMs 未变)→ lead 应介入(notify/reassign/cancel) */
-  stalled: boolean
-}
-
-export interface SchedulerLoopOptions {
-  tickMs?: number
-  stallMs?: number
-  /** 调度快照邮件提供者(manager 注入;返回最新在前);未注入则快照 mail 为空 */
-  supervisionMail?: (limit: number) => ChannelMail[]
-  /** agent 最近一次工具调用时刻(manager 注入;停滞看门狗的活性信号:
-   *  真实 LLM 长工具链不更新 progress 数字,健康工作不能被两轮 stallMs 误回收) */
-  toolActivityOf?: (agentId: string) => number | null
-}
-
-/** 空闲退避上限(指纹不变时 tick 间隔指数退避至此;事件 wake 立即恢复) */
-const IDLE_TICK_CAP_MS = 8000
-
-export class SchedulerLoop {
-  private readonly tickMs: number
-  private readonly stallMs: number
-  private readonly supervisionMail: ((limit: number) => ChannelMail[]) | null
-  private readonly toolActivityOf: ((agentId: string) => number | null) | null
-  /** supervise 节流:最小间隔与最近一次执行时刻/信号指纹(token 效率) */
-  private lastSuperviseAt = 0
-  private lastFingerprint = ''
-  private timer: NodeJS.Timeout | null = null
-  private started = false
-  private running = false
-  private pendingWake = false
-  private tick = 0
-  /** 已催办一次的 WORKING 任务(再次停滞 → cancel) */
-  private readonly notified = new Set<string>()
-  /** WORKING 任务最近一次 progress 与时间(停滞检测) */
-  private readonly lastProgress = new Map<string, { progress: number, at: number }>()
-  /** busy 成员执行中任务的进度基线(与 lastProgress 分离:busy 不重置——
-   *  独立检测"忙碌但进度长期不变"的停滞,喂给快照的 stalled 标记) */
-  private readonly progressSeen = new Map<string, { progress: number, at: number }>()
-  /** goal 父任务「全部子任务 COMPLETED」首见时刻(宽限后规则引擎兜底收口) */
-  private readonly goalAllDoneAt = new Map<string, number>()
-  /** goal 收口宽限窗(ms):给 lead 充分判定机会,超时平台兜底完成 */
-  private readonly goalGraceMs = 45_000
-  /** 成员空闲起始时间(最久空闲 worker 排序) */
-  private readonly idleSince = new Map<string, number>()
-  /** 当前活跃的执行模式(null = 默认无模式) */
-  private activeMode: ExecutionMode | null = null
-  private activeModeConfig: ModeConfig = {}
-  /** loop 模式控制器 */
-  private loopController: LoopController | null = null
-  /** 已通知 loop 控制器的完成任务,避免每轮 tick 重复计数 */
-  private readonly loopCompletedTaskIds = new Set<string>()
-  /** 调度器启动时刻(loop 完成识别基线;防进程重启后重放重启前的 loop 主任务) */
-  private readonly bootAt = Date.now()
-  /** loop 模式下重新提交任务的回调 */
-  private onLoopResubmit: ((title: string, description: string) => void) | null = null
-
-  constructor(
-    private readonly channelRuntime: ChannelRuntime,
-    private readonly lead: AgentRuntime,
-    options: SchedulerLoopOptions = {},
-  ) {
-    this.tickMs = options.tickMs ?? 1000
-    this.stallMs = options.stallMs ?? 300000
-    this.supervisionMail = options.supervisionMail ?? null
-    this.toolActivityOf = options.toolActivityOf ?? null
-  }
-
-  /** 空闲退避:快照指纹连续不变的轮数(决定下次 tick 间隔) */
-  private idleStreak = 0
-  /** 上一轮快照指纹(空闲判定) */
-  private lastRoundFingerprint = ''
-
-  /** 启动调度(自重排 setTimeout:tick 间隔可按空闲状态退避) */
-  start(): void {
-    if (this.started) return
-    this.started = true
-    this.scheduleNext(this.tickMs)
-  }
-
-  /** 事件唤醒(任务状态变化即调):空闲退避中的循环立即恢复快节奏 */
-  wake(): void {
-    if (!this.started) return
-    if (this.running) {
-      this.pendingWake = true
-      return
-    }
-    this.clearTimer()
-    void this.runRound()
-  }
-
-  private clearTimer(): void {
-    if (this.timer) {
-      clearTimeout(this.timer)
-      this.timer = null
-    }
-  }
-
-  private scheduleNext(delayMs: number): void {
-    this.clearTimer()
-    this.timer = setTimeout(() => {
-      this.timer = null
-      this.wake()
-    }, delayMs)
-    this.timer.unref?.()
-  }
-
-  stop(): void {
-    this.started = false
-    this.clearTimer()
-    if (this.loopController) {
-      this.loopController.stop()
-      this.loopController = null
-    }
-    this.loopCompletedTaskIds.clear()
-  }
-
-  /** 设置 loop 模式重新提交回调(manager 注入 submitChannelTask) */
-  setLoopResubmitCallback(fn: (title: string, description: string) => void): void {
-    this.onLoopResubmit = fn
-  }
-
-  // ===== 内部 =====
-
-  private async runRound(): Promise<void> {
-    this.running = true
-    try {
-      await this.lead.withExecLock(() => this.tickRound())
-    }
-    catch (err) {
-      log.error(`[SchedulerLoop:${this.lead.agentId}] 一轮调度失败:`, err)
-    }
-    finally {
-      this.running = false
-      if (this.started) {
-        if (this.pendingWake) {
-          // 事件驱动:执行期间有新信号 → 立即下一轮(节奏不退避)
-          this.pendingWake = false
-          void this.runRound()
-        }
-        else {
-          // 定时驱动:空闲退避(指纹不变 → 间隔翻倍至 8s 上限;有事件 wake() 即刻打断)
-          this.scheduleNext(Math.min(this.tickMs * 2 ** this.idleStreak, IDLE_TICK_CAP_MS))
-        }
-      }
-    }
-  }
-
-  private async tickRound(): Promise<void> {
-    this.tick += 1
-    const snapshot = this.collectSnapshot()
-    // 状态 Map 生命周期修剪:终态/已删任务的条目随轮清理(长会话内存有界)。
-    // progressSeen 全程只增不减;notified/lastProgress/goalAllDoneAt/loopCompletedTaskIds
-    // 仅部分路径清理 —— 统一对当前任务集收敛,任务重入(FAILED→ASSIGNED)时自然重建。
-    const liveIds = new Set(snapshot.tasks.map(t => t.id))
-    for (const map of [this.progressSeen, this.lastProgress, this.goalAllDoneAt]) {
-      for (const key of map.keys()) {
-        if (!liveIds.has(key)) map.delete(key)
-      }
-    }
-    for (const key of this.notified) {
-      if (!liveIds.has(key)) this.notified.delete(key)
-    }
-    for (const key of this.loopCompletedTaskIds) {
-      if (!liveIds.has(key)) this.loopCompletedTaskIds.delete(key)
-    }
-    // 空闲判定指纹(与 supervise 节流同源):任务/成员/邮件信号均未变 → 退避
-    const fp = this.superviseFingerprint(snapshot)
-    if (fp === this.lastRoundFingerprint) this.idleStreak++
-    else {
-      this.idleStreak = 0
-      this.lastRoundFingerprint = fp
-    }
-
-    // 检测当前活跃的执行模式
-    const modeTask = findModeTask(snapshot.tasks, this.lead.agentId)
-    if (modeTask) {
-      this.activeMode = modeTask.mode
-      this.activeModeConfig = modeTask.config
-    }
-
-    // loop 模式:检测主任务完成 → 触发循环控制器
-    this.checkLoopCompletion(snapshot)
-
-    const decisions = await this.decide(snapshot)
-    for (const decision of decisions) {
-      try {
-        this.execute(decision)
-      }
-      catch (err) {
-        log.error(`[SchedulerLoop:${this.lead.agentId}] 执行决策失败:`, decision, err)
-      }
-    }
-  }
-
-  /**
-   * supervise 智能节流(token 效率,纯指纹驱动):
-   *  - 信号指纹 = 任务状态集合 · 成员状态/队列 · 最新邮件 id,不含 progress 渐变
-   *    (worker 进度上报不值得唤醒 lead;状态翻转/新邮件才是需要行动的信号);
-   *  - 指纹无变化 → 跳过 LLM supervise,只跑规则引擎(停滞检测/兜底派发照常);
-   *  - 指纹变化 → 立即 supervise(mock 剧本的秒级状态机与 LLM 决策跟进都不被拖延);
-   *  - 首轮必跑。
-   */
-  private superviseFingerprint(snapshot: SupervisionSnapshot): string {
-    const tasks = snapshot.tasks
-      .map(t => `${t.id}:${t.state}`)
-      .sort()
-      .join('|')
-    const members = snapshot.members
-      .map(m => `${m.agentId}:${m.state}:${m.queued ?? 0}`)
-      .sort()
-      .join('|')
-    const mailTop = snapshot.mail?.[0]?.messageId ?? ''
-    return `${tasks}#${members}#${mailTop}`
-  }
-
-  private shouldSupervise(snapshot: SupervisionSnapshot): boolean {
-    if (this.lead.supervise === null) return false // 无 LLM 决策能力,规则引擎自走
-    if (this.lastSuperviseAt === 0) return true // 首轮
-    // 收尾挂起例外:父任务 WAITING 且子任务全部终态(有完成交付)——指纹虽稳定,
-    // lead 也必须获得监督回合做目标判定收尾(否则作废尝试会永久阻塞 goal 闭环)。
-    // 30s 冷却:LLM 反复不收尾时不会每 tick 消耗回合
-    if (this.hasCloseableParent(snapshot)) {
-      if (Date.now() - this.lastCloseOutAt >= 30_000) {
-        this.lastCloseOutAt = Date.now()
-        return true
-      }
-      return false
-    }
-    return this.superviseFingerprint(snapshot) !== this.lastFingerprint
-  }
-
-  private lastCloseOutAt = 0
-
-  /** 存在"子任务全部终态且至少一个完成交付"的 WAITING 父任务(待 lead 判定收尾) */
-  private hasCloseableParent(snapshot: SupervisionSnapshot): boolean {
-    return snapshot.tasks.some((t) => {
-      if (t.state !== 'WAITING') return false
-      const children = snapshot.tasks.filter(c => c.parentId === t.id)
-      if (children.length === 0) return false
-      return children.every(c => TERMINAL_TASK_STATES[c.state] === true)
-        && children.some(c => c.state === 'COMPLETED')
-    })
-  }
-
-  /**
-   * 决策:lead.supervise 优先(真实 harness 的 LLM 调度);
-   * supervise 未实现/抛错 → 内置规则引擎;
-   * supervise 返回空但有可调度任务且无任何进展(如 LLM 拒绝/漏看)→ 规则引擎兜底补齐,
-   * 保证系统不因单轮 LLM 决策失败而停滞(harness 无关的安全网)。
-   * 节流:指纹无变化 → 跳过 LLM(本轮仅规则引擎)。
-   */
-  private async decide(snapshot: SupervisionSnapshot): Promise<SupervisionDecision[]> {
-    try {
-      if (!this.shouldSupervise(snapshot)) return this.ruleEngine(snapshot)
-      this.lastSuperviseAt = Date.now()
-      this.lastFingerprint = this.superviseFingerprint(snapshot)
-      const decisions = await this.lead.supervise(snapshot)
-      if (decisions === null) return this.ruleEngine(snapshot)
-      if (decisions.length > 0) return decisions
-      // 空决策 + 规则引擎发现可行动作 → 兜底(LLM 优先,规则保底推进)
-      const fallback = this.ruleEngine(snapshot)
-      return fallback.length > 0
-        ? fallback
-        : decisions
-    }
-    catch (err) {
-      log.error(`[SchedulerLoop:${this.lead.agentId}] lead supervise 抛错,回退规则引擎:`, err)
-      return this.ruleEngine(snapshot)
-    }
-  }
-
-  /** 收集快照:全 channel 任务 + 成员状态与队列视图(含未装配成员,标 idle)+ pendingChildren */
-  private collectSnapshot(): SupervisionSnapshot {
-    const now = Date.now()
-    // lite 快照:元数据投影,免每 tick 对全部任务做 artifacts/history JSON 大列解析
-    // (调度决策/规则引擎仅消费状态/进度/标题/描述;LLM 交付预览降级,状态信息仍完整)
-    const tasks = this.lead.taskEngine.listLite(this.channelRuntime.channelId)
-    // 已装配成员的实时状态
-    const wired = new Map(this.channelRuntime.getAgents().map(a => [a.agentId, a.getState()]))
-    // channel 全部 enabled 成员(含未装配懒加载成员 → idle,lead 可据此 dispatch);
-    // 队列视图来自 tasks 表(未装配成员的排队任务同样可见)
-    // 队列视图批量化:一次 list(channel) 聚合全部成员(原每成员一次查询)
-    const views = this.lead.taskEngine.queueViewsOfLite(this.channelRuntime.channelId)
-    const emptyView = { queued: [] as typeof tasks, current: undefined, completed: [] as typeof tasks }
-    const members: MemberView[] = this.channelRuntime.listChannelAgents().map((m) => {
-      const view = views.get(m.agentId) ?? emptyView
-      const current = view.current
-      const progress = current?.progress ?? null
-      // 进度基线更新:progress 变化或首次记录时刷新时间;不变则保留起始时刻
-      if (current && progress != null) {
-        const seen = this.progressSeen.get(current.id)
-        if (!seen || seen.progress !== progress) {
-          this.progressSeen.set(current.id, { progress, at: now })
-        }
-      }
-      // 停滞识别:执行中任务长期无进度变化(i.e. progress 与上次观测相同且超 stallMs)。
-      // busy 状态不再无限豁免 —— 一个进程活着但 LLM 回合内卡死、progress 从不变化的
-      // worker 是最危险场景(worker 自认为在跑,lead 无从知晓),必须给 lead 明确信号。
-      const seen = current ? this.progressSeen.get(current.id) : undefined
-      const stalled = current != null
-        && seen != null
-        && seen.progress === progress
-        && now - seen.at > this.stallMs
-      return {
-        agentId: m.agentId,
-        name: m.name,
-        role: m.role,
-        state: wired.get(m.agentId) ?? 'idle',
-        queued: view.queued.length,
-        currentTaskId: current?.id ?? null,
-        currentTaskTitle: current?.title ?? null,
-        currentTaskProgress: progress,
-        completedCount: view.completed.length,
-        stalled,
-      }
-    })
-    const pendingChildren: Record<string, number> = {}
-    for (const task of tasks) {
-      if (!task.parentId) continue
-      if (TERMINAL_TASK_STATES[task.state]) continue
-      pendingChildren[task.parentId] = (pendingChildren[task.parentId] ?? 0) + 1
-    }
-    return {
-      tick: this.tick,
-      now,
-      tasks,
-      members,
-      pendingChildren,
-      // 最近邮件(最新在前):lead 观察 worker 间通信/回执,判断结果是否已产出
-      mail: this.supervisionMail ? this.supervisionMail(MAIL_SNAPSHOT_LIMIT) : [],
-    }
-  }
-
-  /** 内置规则引擎兜底(harness 无关) */
-  private ruleEngine(snapshot: SupervisionSnapshot): SupervisionDecision[] {
-    const decisions: SupervisionDecision[] = []
-    const { tasks, members, now } = snapshot
-    this.refreshIdle(members, now)
-    // parent → children 一次构建(原每任务 some/filter 全量扫描,O(N²) → O(N))
-    const childrenByParent = new Map<string, typeof tasks>()
-    for (const t of tasks) {
-      if (!t.parentId) continue
-      const arr = childrenByParent.get(t.parentId)
-      if (arr) arr.push(t)
-      else childrenByParent.set(t.parentId, [t])
-    }
-    const childrenOf = (id: string): typeof tasks => childrenByParent.get(id) ?? []
-    // 本轮可用空闲 worker 池:dispatch/reassign 消费后即从池中移除,
-    // 保证一轮内不会把多个任务重复分给同一个"看似空闲"的 worker(其状态尚未翻 busy)。
-    const pool = members.filter(m => m.role === 'worker' && m.state === 'idle')
-
-    // 任务按 createdAt ASC 迭代(list 顺序)= 外部提交 FIFO:先提交先分解先分发。
-    for (const task of tasks) {
-      // SUBMITTED or WORKING 且 assignee=lead 且无子任务 → dispatch 给最优空闲 worker
-      const hasChildren = childrenOf(task.id).length > 0
-      if ((task.state === 'SUBMITTED' || task.state === 'WORKING')
-        && task.assigneeId === this.lead.agentId
-        && !hasChildren) {
-        const worker = this.pickWorker(pool, now)
-        if (worker) {
-          decisions.push({
-            kind: 'dispatch',
-            parentTaskId: task.id,
-            assigneeId: worker.agentId,
-            title: task.title,
-            description: task.description,
-          })
-        }
-      }
-      // FAILED 且 retryCount<3:优先换人重试;仅剩原 assignee 空闲(如单 worker channel)
-      // → 由原 assignee 重试(reassign 到自己,走 FAILED→ASSIGNED 恢复);无人可用 → cancel(允许终结)
-      if (task.state === 'FAILED') {
-        if (task.retryCount < 3) {
-          const other = this.pickWorker(pool, now, task.assigneeId)
-          if (other) {
-            decisions.push({ kind: 'reassign', taskId: task.id, toAgentId: other.agentId })
-          }
-          else {
-            const same = this.pickWorker(pool, now)
-            if (same && same.agentId === task.assigneeId) {
-              decisions.push({ kind: 'reassign', taskId: task.id, toAgentId: same.agentId })
-            }
-            else {
-              decisions.push({ kind: 'cancel', taskId: task.id })
-            }
-          }
-        }
-        else {
-          decisions.push({ kind: 'cancel', taskId: task.id })
-        }
-      }
-    }
-
-    // WORKING 停滞检测:progress 停滞超过 stallMs → notify 催一次;再超时 → cancel。
-    // 活跃度感知:assignee 正 busy(执行中,含多轮协作/等待回执的长任务)不算"被遗弃"——
-    // 看门狗不回收 busy(取消忙碌中的回合是破坏性的)。
-    // 但 busy 且 progress 长期不变(progressSeen 基线)代表"在跑但无产出信号",
-    // 用 progressSeen 独立追踪:给 lead 发一次 notify 提醒介入(可见性修复:杜绝
-    //  worker 自己觉得在跑、lead 却毫无感知)。是否 cancel 由 lead(supervise)判断,
-    // 规则引擎对 busy 不强制取消 —— 只留可见信号,不做破坏性动作。
-    const assigneeState = new Map(this.channelRuntime.getAgents().map(a => [a.agentId, a.getState()]))
-    for (const task of tasks) {
-      if (task.state !== 'WORKING') continue
-      // 工具调用即活性:最近 stallMs 内有工具invoke的任务视为健康推进,刷新基线并跳过看门狗。
-      // 真实 LLM worker 的长工具链(真实 PLC 写+等待回读)不更新 progress 数字,且回合间隙
-      // runtime 会短暂 idle——仅凭 progress 停滞会把健康任务误回收(实测 live-line 闭环任务
-      // 交付物已含 CLOSEDLOOP-OK 却被Canceled)。真停滞(无工具活动+无进度)仍走 notify→cancel。
-      const lastTool = this.toolActivityOf?.(task.assigneeId) ?? 0
-      const toolActive = lastTool > 0 && now - lastTool <= this.stallMs
-      if (toolActive) {
-        this.lastProgress.set(task.id, { progress: task.progress, at: now })
-        this.progressSeen.set(task.id, { progress: task.progress, at: now })
-        this.notified.delete(task.id)
-        continue
-      }
-      if (assigneeState.get(task.assigneeId) === 'busy') {
-        // busy 且 progress 长期不变:催一次 lead 介入(notify 到 assignee 本人,请其推进/汇报);
-        // 尚未到基准时间或 progress 已变 → 刷新基线
-        const seen = this.progressSeen.get(task.id)
-        if (seen && seen.progress === task.progress && now - seen.at > this.stallMs) {
-          if (!this.notified.has(task.id)) {
-            this.notified.add(task.id)
-            decisions.push({
-              kind: 'notify',
-              toAgentId: task.assigneeId,
-              parts: [{ text: `任务「${task.title}」进度 ${task.progress}% 已 ${Math.round((now - seen.at) / 1000)}s 未变化,请确认是否仍在推进;若卡住请说明阻塞并请求协助` }],
-            })
-          }
-          // 已催过一次仍无变化:不重复催(避免每 tick 打扰),把最终裁决交给 lead
-        }
-        else {
-          this.notified.delete(task.id)
-          this.lastProgress.set(task.id, { progress: task.progress, at: now })
-        }
-        continue
-      }
-      const prev = this.lastProgress.get(task.id)
-      if (!prev || prev.progress !== task.progress) {
-        this.lastProgress.set(task.id, { progress: task.progress, at: now })
-        continue
-      }
-      if (now - prev.at <= this.stallMs) continue
-      if (!this.notified.has(task.id)) {
-        this.notified.add(task.id)
-        this.lastProgress.set(task.id, { progress: task.progress, at: now })
-        decisions.push({
-          kind: 'notify',
-          toAgentId: task.assigneeId,
-          parts: [{ text: `任务「${task.title}」停滞超过 ${this.stallMs}ms,请推进` }],
-        })
-      }
-      else {
-        this.notified.delete(task.id)
-        this.lastProgress.delete(task.id)
-        // 交回裁决:这里**不能无条件 cancel**。
-        // 直接派发给 worker 的任务(无父任务)是由 worker 自己调 complete_task 收口的;
-        // 它的回合结束时若漏了这一步,任务会停在 WORKING,assignee 也不再 busy ——
-        // 旧实现直接 cancel,把**已经产出的交付物一起作废**(实测:omp worker 干到
-        // progress=90、产物齐全,却因没走收口动作被整单取消;换成真实 harness lead 时
-        // 由 lead 的监督回合兜住,所以只在 mock/规则引擎这条路径上暴露)。
-        // 现在按"有没有真干过活"分流:干过 → 收口(成果保留);没干过 → 仍然取消(防永挂)。
-        const didWork = task.progress > 0
-          || (task.artifacts ?? []).some(a => a.name !== 'input' && (a.parts ?? []).length > 0)
-        decisions.push(didWork ? { kind: 'complete', taskId: task.id } : { kind: 'cancel', taskId: task.id })
-      }
-    }
-
-    // 子任务全完成且父任务(WAITING/WORKING)→ complete 父
-    for (const task of tasks) {
-      const children = childrenOf(task.id)
-      if (children.length === 0) continue
-      if (task.state === 'COMPLETED' || task.state === 'FAILED' || task.state === 'CANCELED') continue
-      const allDone = children.every(c => c.state === 'COMPLETED')
-      // goal/pipeline 父任务的完成判定属于 lead 模式剧本(goal 需满意度判定、
-      // pipeline 需全部阶段收敛),规则引擎不越权提前收口;loop 与无模式照旧兜底
-      const modeInfo = extractTaskMode(task)
-      if (modeInfo && (modeInfo.mode === 'goal' || modeInfo.mode === 'pipeline')) {
-        // goal 收口保活:lead 判定回合可能以纯文本收尾(未调用 complete_task),之后
-        // 状态不再变化 → 监督回合被指纹节流 → goal 永挂 WORKING 直至看门狗误取消。
-        // 全部子任务 COMPLETED 持续超过宽限窗(45s,lead 仍有充分判定机会)后由
-        // 规则引擎兜底收口;taskEngine.complete 内建 goal-summary 合成,标志必然落盘。
-        if (modeInfo.mode !== 'goal') continue
-        if (!allDone || (task.state !== 'WAITING' && task.state !== 'WORKING')) {
-          this.goalAllDoneAt.delete(task.id)
-          continue
-        }
-        const since = this.goalAllDoneAt.get(task.id)
-        if (since === undefined) {
-          this.goalAllDoneAt.set(task.id, now)
-        }
-        else if (now - since >= this.goalGraceMs) {
-          this.goalAllDoneAt.delete(task.id)
-          decisions.push({ kind: 'complete', taskId: task.id })
-        }
-        continue
-      }
-      if (allDone && (task.state === 'WAITING' || task.state === 'WORKING')) {
-        decisions.push({ kind: 'complete', taskId: task.id })
-      }
-      // 部分成功收口(防父任务永挂):全部子任务已终态,但存在失败/取消且至少一个
-      // COMPLETED 交付 —— 父任务不应 CANCEL(有成果),也不应无限 WAITING。
-      // 以"已有成果"为完成条件收口父任务(lead 汇总已产出部分,缺的口子明确可见),
-      // 否则父任务在子任务混合终态时永久卡死,lead 无从得知去补派。
-      else if (
-        (task.state === 'WAITING' || task.state === 'WORKING')
-        && children.every(c => TERMINAL_TASK_STATES[c.state] === true)
-        && children.some(c => c.state === 'COMPLETED')
-        && !children.every(c => c.state === 'COMPLETED')
-      ) {
-        decisions.push({ kind: 'complete', taskId: task.id })
-      }
-    }
-
-    // 父任务终结:子任务全部终态且存在不可重试的 FAILED/CANCELED
-    // → 父任务无法交付 → cancel 父任务(避免 WAITING 永挂;lead 可重新提交)。
-    // 已有 COMPLETED 交付的父任务不自动取消——作废尝试(FAILED/CANCELED)不阻塞,
-    // 收尾判定属于 lead(goal 模式按目标达成度而非子任务簿记收尾)
-    for (const task of tasks) {
-      const children = childrenOf(task.id)
-      if (children.length === 0) continue
-      if (task.state !== 'WAITING' && task.state !== 'WORKING') continue
-      const allTerminal = children.every(c => TERMINAL_TASK_STATES[c.state] === true)
-      const anyUnsuccessful = children.some(c => c.state !== 'COMPLETED')
-      const hasRetryableFailure = children.some(c => c.state === 'FAILED' && c.retryCount < 3)
-      const hasCompletedDeliverable = children.some(c => c.state === 'COMPLETED')
-      if (allTerminal && anyUnsuccessful && !hasRetryableFailure && !hasCompletedDeliverable) {
-        decisions.push({ kind: 'cancel', taskId: task.id })
-      }
-    }
-
-    return decisions
-  }
-
-  /** 执行单条决策(身份=lead,经 TaskEngine 与 ChannelRuntime) */
-  private execute(decision: SupervisionDecision): void {
-    switch (decision.kind) {
-      case 'dispatch': {
-        if (!decision.parentTaskId) {
-          throw new AppError(400, 'INVALID_DECISION', 'dispatch 决策缺少 parentTaskId')
-        }
-        // HITL 竞态守卫:快照后成员可能已被用户/lead 移除,目标不存在则跳过本轮
-        // (任务保持 SUBMITTED/WORKING,下一轮快照重新决策;避免派发给幽灵成员)
-        // listChannelAgents 仅返回 enabled=1 成员,存在即可用
-        const target = this.channelRuntime.listChannelAgents().find(a => a.agentId === decision.assigneeId)
-        if (!target) {
-          log.warn(`[SchedulerLoop:${this.lead.agentId}] dispatch 目标成员已不存在/禁用,跳过: ${decision.assigneeId}`)
-          break
-        }
-        const parent = this.lead.taskEngine.get(decision.parentTaskId)
-        if (!parent) throw new AppError(404, 'NOT_FOUND', `父任务不存在: ${decision.parentTaskId}`)
-        // lead 自动接取:SUBMITTED → WORKING(§2.2 状态机,dispatch 需父任务处于 WORKING/WAITING)
-        if (parent.state === 'SUBMITTED') {
-          this.lead.taskEngine.transition(parent.id, 'WORKING', this.lead.agentId)
-        }
-        this.lead.taskEngine.dispatch(parent, {
-          assigneeId: decision.assigneeId,
-          title: decision.title,
-          description: decision.description,
-          parts: decision.parts,
-        })
-        this.wakeAgent(decision.assigneeId)
-        break
-      }
-      case 'reassign': {
-        // HITL 竞态守卫:目标成员被移除/禁用时跳过重派(任务保持 FAILED,留待 lead/用户重试)
-        // listChannelAgents 仅返回 enabled=1 成员,存在即可用
-        const target = this.channelRuntime.listChannelAgents().find(a => a.agentId === decision.toAgentId)
-        if (!target) {
-          log.warn(`[SchedulerLoop:${this.lead.agentId}] reassign 目标成员已不存在/禁用,跳过: ${decision.toAgentId}`)
-          break
-        }
-        this.lead.taskEngine.reassign(decision.taskId, decision.toAgentId)
-        this.wakeAgent(decision.toAgentId)
-        break
-      }
-      case 'cancel': {
-        const task = this.lead.taskEngine.get(decision.taskId)
-        this.lead.taskEngine.cancel(decision.taskId, this.lead.agentId)
-        // lead 终态同步:经调度器判定取消同样不经 processMessage,重广播队列上下文
-        this.lead.refreshStatus()
-        if (task) {
-          const assignee = this.channelRuntime.getAgents().find(a => a.agentId === task.assigneeId)
-          if (assignee && assignee.getState() === 'busy') assignee.abortCurrent()
-        }
-        break
-      }
-      case 'complete': {
-        // 幂等守卫:LLM lead 可能对已终态任务重复 complete(快照滞后/重复决策)——
-        // 静默跳过而非报错,避免调度噪音(正确性不受影响:终态即目标状态)
-        const existing = this.lead.taskEngine.get(decision.taskId)
-        if (existing && ['COMPLETED', 'CANCELED', 'FAILED'].includes(existing.state)) {
-          break
-        }
-        const completed = this.lead.taskEngine.complete(decision.taskId, decision.artifacts)
-        // lead 状态同步:complete 由调度器直接收口(不经 processMessage),终态迁移后
-        // 重广播 lead 队列上下文(current→null/completed+1),前端实时反映 lead 判定完成
-        this.lead.refreshStatus()
-        // 汇总成果走统一事件流(与 harness 事件同构,monitor/WS 可见)
-        for (const artifact of decision.artifacts ?? []) {
-          this.lead.emitExternal({ kind: 'artifact', artifact }, this.lead.agentId)
-        }
-        // goal 保底合成产物(lead 未自带总结时 taskEngine 追加)同样广播
-        const knownArtifacts = new Set((decision.artifacts ?? []).map(a => a.artifactId))
-        for (const artifact of completed.artifacts) {
-          if (isGoalSummaryArtifact(artifact) && !knownArtifacts.has(artifact.artifactId)) {
-            this.lead.emitExternal({ kind: 'artifact', artifact }, this.lead.agentId)
-          }
-        }
-        // lead 终态记忆沉淀:调度器直接收口不经过 processMessage,此处补齐 harvest(异常不阻塞调度)
-        void this.lead.recordTaskMemory(completed).catch(() => {})
-        if (completed.parentId) {
-          this.lead.taskEngine.onChildCompleted(completed)
-          const parent = this.lead.taskEngine.get(completed.parentId)
-          if (parent) this.wakeAgent(parent.assigneeId)
-        }
-        break
-      }
-      case 'notify': {
-        const message: A2AMessage = {
-          messageId: randomUUID(),
-          contextId: this.channelRuntime.channelId,
-          role: 'ROLE_AGENT',
-          parts: decision.parts,
-          metadata: {
-            'x-aw-target-agent': decision.toAgentId,
-            'x-aw-from-agent': this.lead.agentId,
-          },
-        }
-        this.channelRuntime.route(message)
-        break
-      }
-      // 团队成员管理决策(lead 自主扩容/调参/裁撤;经 AgentWorkspace 与工具桥同源路径)。
-      // fire-and-forget:成员落库即刻对下一轮快照可见,dispatch 在后续 tick 自然衔接。
-      case 'spawn_agent': {
-        const ws: AgentWorkspace = this.lead.workspace
-        void ws.createTeamMember({
-          name: decision.name,
-          harness: decision.harness,
-          config: decision.config,
-          templateId: decision.templateId,
-          reason: decision.reason,
-        }).catch((err) => {
-          log.error(`[SchedulerLoop:${this.lead.agentId}] spawn_agent 决策执行失败:`, err)
-        })
-        break
-      }
-      case 'update_agent': {
-        const ws: AgentWorkspace = this.lead.workspace
-        void ws.updateTeamMember(decision.agentId, {
-          name: decision.name,
-          config: decision.config,
-          enabled: decision.enabled === undefined ? undefined : (decision.enabled ? 1 : 0),
-          reason: decision.reason,
-        }).catch((err) => {
-          log.error(`[SchedulerLoop:${this.lead.agentId}] update_agent 决策执行失败:`, err)
-        })
-        break
-      }
-      case 'remove_agent': {
-        const ws: AgentWorkspace = this.lead.workspace
-        void ws.removeTeamMember(decision.agentId, decision.reason).catch((err) => {
-          log.error(`[SchedulerLoop:${this.lead.agentId}] remove_agent 决策执行失败:`, err)
-        })
-        break
-      }
-    }
-  }
-
-  private wakeAgent(agentId: string): void {
-    this.channelRuntime.wakeAgent(agentId)
-  }
-
-  private refreshIdle(members: SupervisionSnapshot['members'], now: number): void {
-    const liveIds = new Set(members.map(m => m.agentId))
-    // 修剪已删除成员的残留条目(成员删除时正 idle → 不在 liveIds,不清会永久残留)
-    for (const id of this.idleSince.keys()) {
-      if (!liveIds.has(id)) this.idleSince.delete(id)
-    }
-    for (const m of members) {
-      if (m.state === 'idle') {
-        if (!this.idleSince.has(m.agentId)) this.idleSince.set(m.agentId, now)
-      }
-      else {
-        this.idleSince.delete(m.agentId)
-      }
-    }
-  }
-
-  /**
-   * 从本轮空闲池选最优 worker 并消费(选中即移出,一轮不重复用):
-   * 队列最短优先(负载均衡),空闲最久次之(FIFO 兜底)。
-   */
-  private pickWorker(pool: SupervisionSnapshot['members'], now: number, exclude?: string) {
-    const idx = pool.findIndex(w => w.agentId !== exclude)
-    if (idx < 0) return undefined
-    let best = idx
-    for (let i = idx + 1; i < pool.length; i++) {
-      const a = pool[i]!
-      const b = pool[best]!
-      const byQueue = (a.queued ?? 0) - (b.queued ?? 0)
-      const byIdle = (this.idleSince.get(a.agentId) ?? now) - (this.idleSince.get(b.agentId) ?? now)
-      if (byQueue < 0 || (byQueue === 0 && byIdle < 0)) best = i
-    }
-    return pool.splice(best, 1)[0]
-  }
-
-  /** loop 模式:检测主任务完成 → 启动循环控制器重放 */
-  private checkLoopCompletion(snapshot: SupervisionSnapshot): void {
-    if (this.activeMode !== 'loop') return
-
-    // 找到当前循环新完成的 COMPLETED 主任务(尚未通知过控制器)。
-    // bootAt 过滤:loopCompletedTaskIds 是内存态,进程重启后为空 —— 不过滤会把
-    // 重启前已完成的主任务再识别一次并 resubmit(多跑一轮);只认本进程生命
-    // 周期内完成的任务,重启前的历史 loop 由用户/上游重新提交
-    const current = snapshot.tasks.find((t) => {
-      if (t.assigneeId !== this.lead.agentId) return false
-      if (t.state !== 'COMPLETED') return false
-      if (this.loopCompletedTaskIds.has(t.id)) return false
-      if (Date.parse(t.updatedAt) < this.bootAt) return false
-      const modeInfo = extractTaskMode(t)
-      return !!modeInfo && modeInfo.mode === 'loop'
-    })
-    if (!current) {
-      // 无新的完成事件,但控制器可能已达到最大次数:清空以允许后续新 loop 任务重新开始
-      if (this.loopController?.exhausted) {
-        this.loopController = null
-      }
-      return
-    }
-
-    // 同一主任务只通知一次(防每轮 tick 重复计数)
-    this.loopCompletedTaskIds.add(current.id)
-
-    // 已有控制器 → 让控制器推进下一轮
-    if (this.loopController) {
-      this.loopController.onTaskCompleted()
-      return
-    }
-
-    // 创建 loop 控制器 → 每次主任务完成后等待 intervalMs 再重新提交相同任务
-    const modeInfo = extractTaskMode(current)!
-    const intervalMs = Math.min(86_400_000, Math.max(100, Math.floor(modeInfo.config.intervalMs ?? 60_000)))
-    const maxIterations = modeInfo.config.maxIterations ?? Number.POSITIVE_INFINITY
-    if (this.onLoopResubmit) {
-      this.loopController = new LoopController(
-        this.channelRuntime.channelId,
-        current.title,
-        current.description ?? '',
-        intervalMs,
-        maxIterations,
-        this.onLoopResubmit,
-      )
-      this.loopController.onTaskCompleted()
-    }
-  }
-}