agentworkshop 0.7.4 → 0.7.6

package/cli/commands/stop.mjs

@@ -0,0 +1,108 @@
+// ============================================================
+// 指令:stop —— 终止当前配置根下运行中的 aw 实例(读单实例锁 → 终止进程树)。
+// 用法:aw stop [--home]   (--home 强制以 home 配置根为目标;默认随 cwd 解析)
+// ============================================================
+import { existsSync, readFileSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { color } from '../core/logger.mjs'
+
+export const meta = {
+  name: 'stop',
+  aliases: [],
+  group: '服务',
+  summary: '终止运行中的 aw 服务实例(读单实例锁)',
+  usage: 'aw stop [--home]',
+  needsProject: false,
+}
+
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0)
+    return true
+  }
+  catch (err) {
+    return err?.code === 'EPERM'
+  }
+}
+
+/** 终止进程树:Windows taskkill /T /F;POSIX 先 SIGTERM 宽限 5s 再 SIGKILL */
+function killTree(pid) {
+  if (process.platform === 'win32') {
+    const r = spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { encoding: 'utf8' })
+    if (r.status !== 0) throw new Error((r.stderr || r.stdout || 'taskkill 失败').trim().split(/\r?\n/)[0])
+    return
+  }
+  try {
+    process.kill(pid, 'SIGTERM')
+  }
+  catch { /* 已死 */ }
+  const deadline = Date.now() + 5000
+  while (Date.now() < deadline && pidAlive(pid)) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200)
+  }
+  if (pidAlive(pid)) {
+    try {
+      process.kill(pid, 'SIGKILL')
+    }
+    catch { /* 已死 */ }
+  }
+}
+
+export async function run(argv, ctx) {
+  // argv 为 parseArgs 结果({ flags, positionals, unknown });兼容裸数组调用
+  const flags = argv?.flags ?? {}
+  const positionals = Array.isArray(argv?.positionals) ? argv.positionals : (Array.isArray(argv) ? argv : [])
+  const forceHome = flags.home === true || positionals.includes('--home')
+
+  const configRoot = forceHome
+    ? ctx.home
+    : (ctx.mode === 'repo' ? join(ctx.root, '.AgentWorkShop') : ctx.home)
+  const lockPath = join(configRoot, '.runtime', 'aw.lock')
+
+  if (!existsSync(lockPath)) {
+    console.log(`${color.blue('ℹ')} 未发现运行中的实例(无锁文件:${lockPath})`)
+    return 0
+  }
+  let holder
+  try {
+    holder = JSON.parse(readFileSync(lockPath, 'utf8'))
+  }
+  catch {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 锁文件损坏,已清除:${lockPath}`)
+    return 0
+  }
+
+  const pid = Number(holder?.pid)
+  if (!Number.isInteger(pid) || pid <= 0) {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 锁内 PID 无效,已清除锁文件`)
+    return 0
+  }
+  if (!pidAlive(pid)) {
+    rmSync(lockPath, { force: true })
+    console.log(`${color.blue('ℹ')} 持锁进程已不存在(pid=${pid},残留锁),已清除锁文件`)
+    return 0
+  }
+
+  console.log(`› 终止实例 pid=${pid}(mode=${holder.mode ?? '?'}${holder.port ? `,端口=${holder.port}` : ''},启动于 ${holder.startedAt ?? '?'})`)
+  try {
+    killTree(pid)
+  }
+  catch (err) {
+    console.error(`${color.red('✖')} 终止失败:${err.message}`)
+    console.error(`  可手动执行:taskkill /PID ${pid} /T /F(Windows)`)
+    return 1
+  }
+  // 锁文件由退出钩子自清;残留则手动兜底
+  for (let i = 0; i < 20 && existsSync(lockPath); i++) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200)
+  }
+  try {
+    if (existsSync(lockPath)) rmSync(lockPath, { force: true })
+  }
+  catch { /* ignore */ }
+  console.log(`${color.green('✔')} 实例已停止(pid=${pid})`)
+  return 0
+}

package/cli/infra.mjs

@@ -1,109 +1,108 @@
-// ============================================================
-// AgentWorkShop CLI — 数采基础设施前置检查(Docker 编排)
-// ------------------------------------------------------------
-// aw start 启动服务前的引导层:
-//   1. 探测 MQTT / TimescaleDB 端口连通(按有效配置的 host/port)
-//   2. 已连通 → 依赖就绪,直接通过
-//   3. 未连通且本机 Docker 可用且策略允许 → docker compose up -d 拉起并等待端口
-//   4. 无 Docker → 打印回退引导:安装 Docker,或在 config.yml 按需配置外部依赖地址
-// 真正的容器编排与降级重连在服务进程内(server/plugins/daq.ts → ensureDaqInfrastructure);
-// 本模块只做启动前置探测与引导,失败不阻断服务启动(平台降级可用)。
-// ============================================================
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { connect } from 'node:net'
-import { join } from 'node:path'
-import { color } from './core/logger.mjs'
-
-/** 本机 Docker 可用性(docker -v) */
-export function detectDocker() {
-  const r = spawnSync('docker', ['-v'], { encoding: 'utf8', shell: process.platform === 'win32' })
-  if (r.status === 0) return { ok: true, version: (r.stdout ?? '').trim().replace(/^Docker version\s*/i, '') }
-  return { ok: false, version: null }
-}
-
-/** TCP 端口连通探测(毫秒级超时;resolve('online'|'offline')) */
-export function probeTcp(port, host = '127.0.0.1', timeoutMs = 1200) {
-  return new Promise((resolveState) => {
-    const sock = connect({ port: Number(port), host })
-    const done = (state) => {
-      sock.destroy()
-      resolveState(state)
-    }
-    sock.setTimeout(timeoutMs)
-    sock.on('connect', () => done('online'))
-    sock.on('timeout', () => done('offline'))
-    sock.on('error', () => done('offline'))
-  })
-}
-
-/** 在 compose 目录执行 docker compose up -d(阻塞至命令结束) */
-export function composeUp(composeDir) {
-  const r = spawnSync('docker', ['compose', 'up', '-d'], {
-    cwd: composeDir,
-    stdio: 'inherit',
-    shell: process.platform === 'win32',
-  })
-  return r.status === 0
-}
-
-/**
- * 数采基础设施前置检查。
- * @param {{ daq: any, configRoot: string }} opts ctx.config 片段与配置根(daQ compose 种子所在)
- * @returns {{ ok: boolean, mqtt: object, timescale: object, docker: object }}
- */
-export async function daqPreflight({ daq, configRoot }) {
-  const mqtt = {
-    host: String(daq?.['daq.mqtt.host'] ?? '127.0.0.1'),
-    port: Number(daq?.['daq.mqtt.port'] ?? 1883),
-    online: null,
-  }
-  const timescale = {
-    host: String(daq?.['daq.timescale.host'] ?? '127.0.0.1'),
-    port: Number(daq?.['daq.timescale.port'] ?? 5432),
-    online: null,
-  }
-  const policy = String(daq?.['daq.startInfrastructure'] ?? 'auto')
-
-  const docker = detectDocker()
-  mqtt.online = (await probeTcp(mqtt.port, mqtt.host)) === 'online'
-  timescale.online = (await probeTcp(timescale.port, timescale.host)) === 'online'
-  const allOnline = mqtt.online && timescale.online
-  const composeDir = existsSync(join(configRoot, 'docker-compose.yml')) ? configRoot : null
-
-  const result = { ok: allOnline, mqtt, timescale, docker, policy, composeDir }
-
-  if (allOnline) return result
-
-  // 未全连通:
-  //  · Docker 可用 + 策略允许(auto/always)+ 本地有 compose 定义 → 拉起并等待端口上线
-  if (docker.ok && policy !== 'never' && composeDir) {
-    console.log(`${color.cyan('›')} 数采依赖未就绪(MQTT ${mqtt.online ? '✓' : '✗'} / Timescale ${timescale.online ? '✓' : '✗'})——docker compose up -d 拉起 ...`)
-    const up = composeUp(composeDir)
-    // 等待端口上线(最长 30s;Timescale 首启初始化较慢)
-    for (let i = 0; i < 15; i++) {
-      await new Promise(r => setTimeout(r, 2000))
-      mqtt.online = (await probeTcp(mqtt.port, mqtt.host)) === 'online'
-      timescale.online = (await probeTcp(timescale.port, timescale.host)) === 'online'
-      if (mqtt.online && timescale.online) break
-    }
-    result.ok = mqtt.online && timescale.online
-    result.pulled = up
-    return result
-  }
-
-  return result
-}
-
-/** 打印回退引导(无 Docker 且依赖不可达时) */
-export function printInfraGuidance({ mqtt, timescale, docker }) {
-  console.log('')
-  console.log(color.yellow('⚠ 数采基础设施不可达(MQTT/TimescaleDB)——服务将继续启动,数采功能降级并每 30s 自动重连。'))
-  console.log(color.dim('  解决方式(二选一):'))
-  console.log(`  ${color.cyan('1.')} 安装 Docker Desktop 后重启本命令,依赖容器将自动拉起`)
-  console.log(`  ${color.cyan('2.')} 在 config.yml 的 daq 段按需配置外部依赖:`)
-  console.log(color.dim(`       daq.mqtt.host/port       (当前 ${mqtt.host}:${mqtt.port} ✗)`))
-  console.log(color.dim(`       daq.timescale.host/port  (当前 ${timescale.host}:${timescale.port} ✗)`))
-  if (!docker.ok) console.log(color.dim('       (本机未检测到 Docker)'))
-  console.log('')
-}
+// ============================================================
+// AgentWorkShop CLI — 数采基础设施前置检查(Docker 编排)
+// ------------------------------------------------------------
+// aw start 启动服务前的引导层:
+//   1. 探测 MQTT / TimescaleDB 端口连通(按有效配置的 host/port)
+//   2. 已连通 → 依赖就绪,直接通过
+//   3. 未连通且本机 Docker 可用且策略允许 → docker compose up -d 拉起并等待端口
+//   4. 无 Docker → 打印回退引导:安装 Docker,或在 config.yml 按需配置外部依赖地址
+// 真正的容器编排与降级重连在服务进程内(server/plugins/daq.ts → ensureDaqInfrastructure);
+// 本模块只做启动前置探测与引导,失败不阻断服务启动(平台降级可用)。
+// ============================================================
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { connect } from 'node:net'
+import { join } from 'node:path'
+import { color } from './core/logger.mjs'
+
+/** 本机 Docker 可用性(docker -v) */
+export function detectDocker() {
+  const r = spawnSync('docker', ['-v'], { encoding: 'utf8' })
+  if (r.status === 0) return { ok: true, version: (r.stdout ?? '').trim().replace(/^Docker version\s*/i, '') }
+  return { ok: false, version: null }
+}
+
+/** TCP 端口连通探测(毫秒级超时;resolve('online'|'offline')) */
+export function probeTcp(port, host = '127.0.0.1', timeoutMs = 1200) {
+  return new Promise((resolveState) => {
+    const sock = connect({ port: Number(port), host })
+    const done = (state) => {
+      sock.destroy()
+      resolveState(state)
+    }
+    sock.setTimeout(timeoutMs)
+    sock.on('connect', () => done('online'))
+    sock.on('timeout', () => done('offline'))
+    sock.on('error', () => done('offline'))
+  })
+}
+
+/** 在 compose 目录执行 docker compose up -d(阻塞至命令结束) */
+export function composeUp(composeDir) {
+  const r = spawnSync('docker', ['compose', 'up', '-d'], {
+    cwd: composeDir,
+    stdio: 'inherit',
+  })
+  return r.status === 0
+}
+
+/**
+ * 数采基础设施前置检查。
+ * @param {{ daq: any, configRoot: string }} opts ctx.config 片段与配置根(daQ compose 种子所在)
+ * @returns {{ ok: boolean, mqtt: object, timescale: object, docker: object }}
+ */
+export async function daqPreflight({ daq, configRoot }) {
+  const mqtt = {
+    host: String(daq?.['daq.mqtt.host'] ?? '127.0.0.1'),
+    port: Number(daq?.['daq.mqtt.port'] ?? 1883),
+    online: null,
+  }
+  const timescale = {
+    host: String(daq?.['daq.timescale.host'] ?? '127.0.0.1'),
+    port: Number(daq?.['daq.timescale.port'] ?? 5432),
+    online: null,
+  }
+  const policy = String(daq?.['daq.startInfrastructure'] ?? 'auto')
+
+  const docker = detectDocker()
+  mqtt.online = (await probeTcp(mqtt.port, mqtt.host)) === 'online'
+  timescale.online = (await probeTcp(timescale.port, timescale.host)) === 'online'
+  const allOnline = mqtt.online && timescale.online
+  const composeDir = existsSync(join(configRoot, 'docker-compose.yml')) ? configRoot : null
+
+  const result = { ok: allOnline, mqtt, timescale, docker, policy, composeDir }
+
+  if (allOnline) return result
+
+  // 未全连通:
+  //  · Docker 可用 + 策略允许(auto/always)+ 本地有 compose 定义 → 拉起并等待端口上线
+  if (docker.ok && policy !== 'never' && composeDir) {
+    console.log(`${color.cyan('›')} 数采依赖未就绪(MQTT ${mqtt.online ? '✓' : '✗'} / Timescale ${timescale.online ? '✓' : '✗'})——docker compose up -d 拉起 ...`)
+    const up = composeUp(composeDir)
+    // 等待端口上线(最长 30s;Timescale 首启初始化较慢)
+    for (let i = 0; i < 15; i++) {
+      await new Promise(r => setTimeout(r, 2000))
+      mqtt.online = (await probeTcp(mqtt.port, mqtt.host)) === 'online'
+      timescale.online = (await probeTcp(timescale.port, timescale.host)) === 'online'
+      if (mqtt.online && timescale.online) break
+    }
+    result.ok = mqtt.online && timescale.online
+    result.pulled = up
+    return result
+  }
+
+  return result
+}
+
+/** 打印回退引导(无 Docker 且依赖不可达时) */
+export function printInfraGuidance({ mqtt, timescale, docker }) {
+  console.log('')
+  console.log(color.yellow('⚠ 数采基础设施不可达(MQTT/TimescaleDB)——服务将继续启动,数采功能降级并每 30s 自动重连。'))
+  console.log(color.dim('  解决方式(二选一):'))
+  console.log(`  ${color.cyan('1.')} 安装 Docker Desktop 后重启本命令,依赖容器将自动拉起`)
+  console.log(`  ${color.cyan('2.')} 在 config.yml 的 daq 段按需配置外部依赖:`)
+  console.log(color.dim(`       daq.mqtt.host/port       (当前 ${mqtt.host}:${mqtt.port} ✗)`))
+  console.log(color.dim(`       daq.timescale.host/port  (当前 ${timescale.host}:${timescale.port} ✗)`))
+  if (!docker.ok) console.log(color.dim('       (本机未检测到 Docker)'))
+  console.log('')
+}

package/config.yml

@@ -10,7 +10,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.4
+  version: 0.7.6
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "PolyForm-Noncommercial-1.0.0",

package/scripts/e2e-aw-tui-global.mjs

@@ -0,0 +1,277 @@
+/**
+ * 全局 `aw tui` 完整 E2E(用户真实路径:npm i -g agentworkshop → aw tui):
+ *   node scripts/e2e-aw-tui-global.mjs [--base http://127.0.0.1:3000]
+ *
+ * 前置:全局已安装 agentworkshop@0.7.4(npm root -g 可解析);dev/prod 服务运行。
+ * 场景:加载【全局包】的 tui 入口(非仓库源码)→ 建频道(内联 omp lead)→
+ *       成员列表 → 任务下发(触发 omp spawn)→ /monitor 独立监控接入 →
+ *       /send 注入 ask → /hitl 定位作答 → REST 确认落定 → 终端帧证实答案
+ *       回传 agent → /task 正式任务 + /tasks 列表 → /monitor off → 清理。
+ */
+import { execSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { pathToFileURL } from 'node:url'
+import { join } from 'node:path'
+
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3000'
+})()
+// --repo:加载仓库源码的 tui(开发验证新交互);默认加载全局安装包(用户真实路径)
+const USE_REPO = process.argv.includes('--repo')
+const WS_BASE = BASE.replace(/^http/, 'ws')
+const TAG = Date.now().toString(36)
+const ASK_INSTRUCTION = 'Use the ask tool NOW to ask me: Deploy? with options go and abort. After I answer, call complete_task with the deliverable set to my answer.'
+
+let failures = 0
+let passed = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed += 1
+  else failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function waitUntil(name, cond, timeoutMs = 300_000, intervalMs = 1000) {
+  const deadline = Date.now() + timeoutMs
+  let last = null
+  while (Date.now() < deadline) {
+    try {
+      last = await cond()
+      if (last) return last
+    }
+    catch (e) { last = e }
+    await sleep(intervalMs)
+  }
+  throw new Error(`waitUntil timeout: ${name} (last=${String(last).slice(0, 200)})`)
+}
+
+const api = async (method, path, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+/** 终端 WS(答案回传验证用) */
+function openTerm(agentId, channelId, token) {
+  const messages = []
+  const ws = new WebSocket(`${WS_BASE}/api/system/monitor/terminal/ws?agentId=${agentId}&channelId=${channelId}&token=${encodeURIComponent(token)}`)
+  ws.addEventListener('message', (ev) => {
+    try {
+      messages.push(JSON.parse(ev.data))
+    }
+    catch { /* ignore */ }
+  })
+  return { ws, messages, frames: () => messages.filter(m => m.type === 'term.frames').flatMap(m => m.frames) }
+}
+
+/** 解析 TUI 入口:--repo = 仓库源码;默认 = 全局安装包(用户 `aw tui` 的真实加载路径) */
+function tuiEntry() {
+  if (USE_REPO) {
+    const entry = join(process.cwd(), 'tui', 'aw-tui.mjs')
+    return { entry, ok: existsSync(entry), repo: true }
+  }
+  const root = execSync('npm root -g', { encoding: 'utf8' }).trim()
+  const entry = join(root, 'agentworkshop', 'tui', 'aw-tui.mjs')
+  return { entry, ok: existsSync(entry), repo: false }
+}
+
+async function main() {
+  console.log(`\n━━━ 全局 aw tui 完整 E2E @ ${BASE} ━━━`)
+
+  // 0. 入口存在(全局包 = 0.7.4 发布包含 tui/;repo = 源码)
+  const g = tuiEntry()
+  check(`0.1 TUI 入口存在(${g.repo ? '仓库源码' : '全局包'})`, g.ok, g.entry)
+  if (!g.ok) process.exit(1)
+
+  // 登录
+  const reg = await api('POST', '/api/users/register', {
+    body: { email: `awtui-${TAG}@test.local`, password: 'Passw0rd!123', name: `awtui-${TAG}` },
+  })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 160)}`)
+
+  // 0.2 预建一个频道(启动频道选择器需要至少一个可选项;全局包模式同样受益)
+  const bootCh = (await api('POST', '/api/workshop/channels', {
+    body: { name: `awtui-boot-${TAG}`, description: '启动选择器测试频道' },
+    token,
+  })).data
+  check('0.2 预建启动频道', Boolean(bootCh?.channelId), `id=${bootCh?.channelId?.slice(0, 8)}`)
+
+  // 1. 加载 TUI,headless 驱动
+  const mod = await import(pathToFileURL(g.entry).href)
+  await mod.main(['--headless', '--url', BASE, '--token', token, '--channel', ''])
+  const vt = globalThis.__tuiSmokeTerminal
+  const type = async (text) => {
+    for (const c of text) vt.emitInput(c)
+    await sleep(50)
+    vt.emitInput('\r')
+    await sleep(400)
+  }
+  const waitTui = async (needle, timeoutMs = 300_000) => {
+    const deadline = Date.now() + timeoutMs
+    while (Date.now() < deadline) {
+      if (vt.text().includes(needle)) return true
+      await sleep(500)
+    }
+    return false
+  }
+  check('1.1 TUI 启动就绪', await waitTui('TUI 已就绪', 30_000), g.entry.slice(-60))
+
+  // 1.2 [新交互] 启动频道选择器:↑↓ + Enter 选择预建频道;Esc 自动进第一个
+  if (USE_REPO) {
+    check('1.2 启动弹出频道选择器', await waitTui('选择要进入的频道', 20_000))
+    vt.emitInput('\x1b[B') // 下移一次,选中第二个(证明方向键导航)
+    await sleep(200)
+    vt.emitInput('\r')
+    check('1.3 Enter 进入所选频道', await waitTui('已切换到频道「', 30_000))
+  }
+  else {
+    check('1.2 (全局包)自动接入频道', await waitTui('已切换到频道「', 30_000))
+  }
+
+  // 2. Channel 操作:列表 + 创建(内联 omp lead)+ 自动切换
+  await type('/channels')
+  check('2.1 /channels 列出频道', await waitTui('个:', 15_000))
+  const channelName = `awtui-e2e-${TAG}`
+  await type(`/channel new ${channelName} --lead 领航员 全局tui端到端频道`)
+  check('2.2 /channel new 创建成功', await waitTui('✔ 频道已创建', 30_000))
+  check('2.3 自动切换到新频道', await waitTui(`已切换到频道「${channelName}」`, 30_000))
+
+  // 2.4 [新交互] /channel use 无参 → 频道选择器 → 方向键导航到目标频道 → Enter
+  // (SelectList 的可打印字符过滤不生效,导航用方向键;序号按 REST 顺序计算)
+  if (USE_REPO) {
+    await type('/channel use')
+    check('2.4 /channel use 弹出频道选择器', await waitTui('选择要进入的频道', 20_000))
+    const order = (await api('GET', '/api/workshop/channels', { token })).data ?? []
+    const downTimes = Math.max(0, order.findIndex(c => c.name === channelName))
+    for (let i = 0; i < downTimes; i++) {
+      vt.emitInput('\x1b[B')
+      await sleep(150)
+    }
+    await sleep(200)
+    vt.emitInput('\r')
+    await sleep(800)
+    check('2.5 方向键选择后频道正确', await waitTui(`已切换到频道「${channelName}」`, 20_000))
+  }
+
+  // 3. Agent 操作:成员列表出现内联建的 omp lead(选择器切换后刷新有竞态,轮询重发)
+  {
+    const ok = await waitUntil('3.1 /agents 出现 lead 成员', async () => {
+      await type('/agents')
+      return vt.text().includes('领航员(lead)') ? true : null
+    }, 30_000).catch(() => null)
+    check('3.1 /agents 出现 lead 成员', ok === true)
+  }
+
+  // 4. 任务下发:普通文本 → lead(触发 omp spawn)
+  await type('请保持待命,等待操作员通过终端下达进一步指令。')
+  console.log('  … 等待 omp spawn(冷启动可达 2-3 分钟)…')
+  const ch = (await api('GET', '/api/workshop/channels', { token })).data?.find?.(c => c.name === channelName)
+    ?? (await api('GET', '/api/workshop/channels', { token })).data?.at(-1)
+  const channelId = ch?.id
+  const members = channelId ? (await api('GET', `/api/workshop/channels/${channelId}/agents`, { token })).data ?? [] : []
+  const lead = members.find(a => a.role === 'lead')
+  check('4.1 频道/lead 实例可查(REST 交叉核对)', Boolean(lead?.id), `lead=${lead?.id?.slice(0, 8)}`)
+
+  const spawnOk = await waitUntil('4.2 omp 进程 spawn', async () => {
+    const mon = await api('GET', '/api/system/monitor', { token })
+    return (mon.data?.processes ?? []).find(p => p.harness === 'omp' && p.alive && p.agentId === lead?.id) ? true : null
+  }, 300_000).catch(() => null)
+  check('4.2 omp 进程 spawn(REST 监控)', spawnOk === true)
+
+  // 5. 独立 monitor:/monitor 领航员 → 终端面板接入
+  await type('/monitor 领航员')
+  check('5.1 /monitor 面板开启', await waitTui('监控已开启:领航员', 20_000))
+  const termConnected = await waitTui('已接入 领航员', 120_000)
+  check('5.2 监控面板接入 omp 会话(term.init)', termConnected)
+
+  // 6. HITL:等首回合结束 → /send 注入 ask → /hitl 定位作答
+  const idleOk = await waitUntil('6.1 lead 首回合结束(idle)', async () => {
+    const terms = await api('GET', `/api/workshop/channels/${channelId}/terminals`, { token })
+    const mine = (terms.data ?? []).find(t2 => t2.agentId === lead?.id)
+    return mine && mine.running === false ? true : null
+  }, 300_000).catch(() => null)
+  check('6.1 lead 空闲(可注入)', idleOk === true)
+  await sleep(1500)
+  await type(`/send 领航员 ${ASK_INSTRUCTION}`)
+  check('6.2 /send 直发回执', await waitTui('✔ 已直发 领航员', 30_000))
+
+  const item = await waitUntil('6.3 HITL 待办到达(REST Deploy?)', async () => {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    return (p.data?.items ?? []).find(i => String(i.title).includes('Deploy?')) ?? null
+  }, 300_000).catch(() => null)
+  check('6.3 omp ask → 全局待办(Deploy?)', Boolean(item), item ? `method=${item.method} options=${JSON.stringify(item.options)}` : 'timeout')
+
+  await type('/hitl')
+  check('6.4 /hitl 列表渲染', await waitTui('待人工处理', 20_000))
+  const row = await waitUntil('6.5 列表出现 Deploy? 行', () => {
+    const m = vt.text().match(/(\d+)\. \[omp-dialog\] Deploy\?/)
+    return m ? m[1] : null
+  }, 60_000).catch(() => null)
+  check('6.5 目标待办行定位', Boolean(row), `序号=${row}`)
+  await type(`/hitl ${row}`)
+  check('6.6 进入作答卡', await waitTui('HITL 作答', 20_000))
+  await type('1')
+  check('6.7 应答提交回执(选项 1 = go)', await waitTui('应答已提交', 30_000))
+  if (failures > 0) console.log('[diag 6.7 tail]', JSON.stringify(vt.text().slice(-700)))
+
+  const cleared = await waitUntil('6.8 REST 待办不再含 Deploy?', async () => {
+    const p = await api('GET', `/api/workshop/hitl/pending?channelId=${channelId}`, { token })
+    return ((p.data?.items ?? []).every(i => !String(i.title).includes('Deploy?'))) ? true : null
+  }, 60_000).catch(() => null)
+  check('6.8 应答写入服务端(待办落定)', cleared === true)
+
+  // 6.9 答案回传 agent 铁证:ask 工具结果含 go(独立终端 WS 帧)
+  const term = openTerm(lead.id, channelId, token)
+  const askFed = await waitUntil('6.9 ask 工具收到 go(终端帧)', () => {
+    const list = term.frames().filter(f => f.frame.type === 'tool_execution_end' && String(f.frame.toolName) === 'ask')
+    const lastAsk = list.at(-1)
+    return lastAsk ? String(lastAsk.frame.result ?? '').toLowerCase().includes('go') : null
+  }, 120_000).catch(() => null)
+  check('6.9 闭环:答案回传 agent(ask 结果含 go)', Boolean(askFed))
+
+  // 6.10-6.14 [新交互] Tab 目标选择器 + 通信/任务分流(仓库源码特性)
+  if (USE_REPO) {
+    vt.emitInput('\t')
+    check('6.10 Tab 呼出目标选择器', await waitTui('选择对话目标', 20_000))
+    vt.emitInput('\x1b[B')
+    await sleep(200)
+    vt.emitInput('\r')
+    check('6.11 选成员 → 通信模式 + 自动开监控', await waitTui('监控已开启:领航员', 20_000) && await waitTui('@领航员(通信)', 20_000))
+    await type('你在吗?看到请回应')
+    check('6.12 普通文本按通信直发目标', await waitTui('通信消息已发 → @领航员', 30_000))
+    vt.emitInput('\t')
+    await waitTui('选择对话目标', 20_000)
+    vt.emitInput('\r')
+    await sleep(400)
+    check('6.13 选频道 → 重置任务模式', await waitTui('频道(任务)', 20_000))
+    await type('/msg 心跳检查,请确认收到')
+    check('6.14 /msg 通信消息(目标重置后路由 lead)', await waitTui('通信消息已发 → @', 30_000))
+  }
+
+  // 7. 正式任务 + 任务列表
+  await type('/task 汇报当前待命状态')
+  check('7.1 /task 正式任务提交', await waitTui('✔ 任务已发布', 30_000))
+  await type('/tasks')
+  check('7.2 /tasks 列表出现任务', await waitTui('汇报当前待命状态', 30_000))
+
+  // 8. monitor 关闭 + 清理
+  await type('/monitor off')
+  check('8.1 /monitor off 关闭', await waitTui('监控面板已关闭', 20_000))
+  await api('DELETE', `/api/workshop/channels/${channelId}?purge=1`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/channels/${bootCh.channelId}?purge=1`, { token }).catch(() => {})
+
+  console.log(`\n━━━ 结果: ${passed} passed / ${failures} failed ━━━`)
+  console.log('(经 /quit 退出全局 TUI 进程)')
+  if (failures > 0) process.exit(1)
+  await type('/quit')
+  console.log('[warn] /quit 未按预期退出,兜底退出')
+  process.exit(0)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err.message)
+  process.exit(1)
+})