agentworkshop 0.7.34 → 0.7.38

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/86b7c1daafc8b60ba9982dde5bf1bcc74265709483c176e71f23ec6fc267451f.source

@@ -0,0 +1,259 @@
+/**
+ * AML 端到端测试(对活服):fixtures → 数据集构建 → 隔离拒绝 → 训练作业 → 门禁 →
+ * 排行榜 → 晋升守卫 → 预测守卫 → 审计归属。
+ *
+ * 运行:
+ *   1) 存根模式(无 Python 环境;服务器以 AML_STUB=1 启动):
+ *        npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/e2e-aml.ts
+ *   2) 真实模式(服务器正常启动,venv 供给可用):… scripts/e2e-aml.ts --real
+ *      真实模式走 venv 供给 + torch 训练 + ONNX 评估(首次约数分钟)。
+ *
+ * 前置:AW_BASE(默认 http://127.0.0.1:3001,仅允许本机回环);AW_E2E_TOKEN
+ *       (admin/editor token —— 建数采节点需要 editor+;缺省时注册临时用户,
+ *       仅 fresh 库首位=admin 时可行)。
+ */
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const BASE_URL = new URL(process.env.AW_BASE ?? 'http://127.0.0.1:3001')
+// 测试脚本安全守卫:仅允许 http(s) + 本机回环/私网主机名(防误把测试流量打向外部)
+if (BASE_URL.protocol !== 'http:' && BASE_URL.protocol !== 'https:') {
+  console.error('AW_BASE 协议必须为 http/https')
+  process.exit(1)
+}
+const host = BASE_URL.hostname
+const isLocal = host === 'localhost' || host === '127.0.0.1' || host === '::1' || host.endsWith('.local') || /^10\./.test(host) || /^192\.168\./.test(host) || /^172\.(1[6-9]|2\d|3[01])\./.test(host)
+if (!isLocal && process.env.AW_ALLOW_REMOTE_BASE !== '1') {
+  console.error(`AW_BASE 主机 ${host} 非本机/私网;确需远程测试请设 AW_ALLOW_REMOTE_BASE=1`)
+  process.exit(1)
+}
+const BASE = BASE_URL.origin
+const REAL = process.argv.includes('--real')
+
+let passed = 0
+let failures = 0
+let step = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed++
+  else failures++
+}
+function section(title: string): void {
+  step += 1
+  console.log(`\n━━━ ${step}. ${title} ━━━`)
+}
+
+/* eslint-disable @typescript-eslint/no-explicit-any -- e2e 断言脚本:响应体按动态 JSON 探查 */
+
+interface ApiRes { status: number, ok: boolean, json: any }
+
+async function api(method: string, path: string, opts: { body?: unknown, token?: string } = {}): Promise<ApiRes> {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', 'authorization': `Bearer ${opts.token ?? ''}` },
+    body: opts.body === undefined ? undefined : JSON.stringify(opts.body),
+  })
+  const json = await res.json().catch(() => null)
+  return { status: res.status, ok: res.ok, json }
+}
+
+// ---------- 登录 ----------
+let token = process.env.AW_E2E_TOKEN ?? ''
+if (!token) {
+  const name = `e2e-aml-${process.pid.toString(36)}-${Date.now().toString(36).slice(-5)}`
+  const reg = await api('POST', '/api/workshop/users/register', { body: { name }, token: '' })
+  token = reg.json?.data?.token ?? ''
+}
+if (!token) {
+  console.error('缺少 token:设置 AW_E2E_TOKEN(admin/editor)后重试')
+  process.exit(1)
+}
+
+const suffix = `${process.pid.toString(36)}${Date.now().toString(36).slice(-5)}`
+const STUB_TRAIN_PY = [
+  '# e2e 存根训练代码(AML_STUB=1 时不会真正执行)',
+  'import amlkit',
+  'amlkit.report_progress(50, \'stub\')',
+  'amlkit.save_metrics({\'agent\': {\'note\': \'stub\'}})',
+  'print(\'stub train done\')',
+  '',
+].join('\n')
+
+async function main(): Promise<void> {
+  section('平台概览')
+  const overview = await api('GET', '/api/workshop/aml', { token })
+  check('GET /aml 返回运行时状态', overview.ok && !!overview.json?.data?.runtime, `python.ok=${overview.json?.data?.runtime?.python?.ok}`)
+  if (overview.json?.data?.runtime?.python?.ok === false && REAL) {
+    console.error('真实模式要求服务器具备 Python;当前探测失败:', overview.json?.data?.runtime?.python?.reason)
+  }
+
+  section('门禁阈值放宽(幂等;无权限则降级;测试后恢复)')
+  const keysToRelax = ['aml.gates.minRows', 'aml.gates.minRuns', 'aml.gates.nrmse', 'aml.gates.rolloutNrmse', 'aml.gates.valTestGap'] as const
+  const relaxedValues: Record<string, unknown> = {
+    'aml.gates.minRows': 50,
+    'aml.gates.minRuns': 2,
+    'aml.gates.nrmse': 0.99,
+    'aml.gates.rolloutNrmse': 0.99,
+    'aml.gates.valTestGap': 2,
+  }
+  const before = await api('GET', '/api/system/settings', { token })
+  const prevEffective: Record<string, unknown> = before.json?.data?.effective ?? {}
+  const patch = await api('PATCH', '/api/system/settings', { token, body: { overrides: relaxedValues } })
+  const gatesRelaxed = patch.ok
+  const restoreSettings = async (): Promise<void> => {
+    if (!gatesRelaxed) return
+    const restore: Record<string, unknown> = {}
+    for (const k of keysToRelax) {
+      if (k in prevEffective) restore[k] = prevEffective[k]
+    }
+    if (Object.keys(restore).length > 0) await api('PATCH', '/api/system/settings', { token, body: { overrides: restore } })
+  }
+  check('门禁阈值可写(权限或键缺失则降级)', gatesRelaxed || patch.status === 403 || patch.status === 404 || patch.status === 401, `status=${patch.status}`)
+
+  section('产线 fixtures')
+  const line = await api('POST', '/api/workshop/dcw/lines', { token, body: { name: `AML-E2E 线 ${suffix}` } })
+  const lineId: string = line.json?.data?.line?.id
+  check('创建产线', line.ok && !!lineId, lineId ?? line.json?.message)
+  const product = await api('POST', '/api/workshop/dcw/products', { token, body: { lineId, name: `AML-E2E 产品 ${suffix}` } })
+  const productId: string = product.json?.data?.product?.id
+  check('创建产品', product.ok && !!productId, productId ?? product.json?.message)
+  const dcwNode = await api('POST', '/api/workshop/dcw', {
+    token,
+    body: { name: `aml-e2e-dcw-${suffix}`, driver: 'mock', lineId, templateRef: 'temp-sp' },
+  })
+  const dcwNodeId: string = dcwNode.json?.data?.node?.id
+  check('创建数控节点(mock)', dcwNode.ok && !!dcwNodeId, dcwNodeId ?? dcwNode.json?.message)
+  const recipe = await api('POST', '/api/workshop/dcw/recipes', {
+    token,
+    body: {
+      productId, name: `AML-E2E 配方 ${suffix}`, description: 'e2e',
+      params: [{ nodeId: dcwNodeId, value: 60, min: 0, max: 100 }],
+    },
+  })
+  const recipeId: string = recipe.json?.data?.recipe?.id
+  check('创建配方(节点级绑定)', recipe.ok && !!recipeId, recipeId ?? recipe.json?.message)
+
+  section('数采节点 ×2')
+  const mkDaq = async (name: string, templateRef: string) => api('POST', '/api/workshop/daq', {
+    token,
+    body: { name, templateRef, driver: 'mock', lineId, intervalMs: 1000, publishIntervalMs: 0 },
+  })
+  const daqCtrl = await mkDaq(`aml-e2e-ctrl-${suffix}`, 'daq-temp-tc')
+  const daqTmp = await mkDaq(`aml-e2e-tmp-${suffix}`, 'daq-pressure-tx')
+  const ctrlId: string = daqCtrl.json?.data?.node?.id
+  const tmpId: string = daqTmp.json?.data?.node?.id
+  check('数采节点(控制量)', daqCtrl.ok, ctrlId)
+  check('数采节点(目标量)', daqTmp.ok, tmpId)
+
+  section('开跑 4 个批次(短窗采集;样本按 run 打标)')
+  const sleep = (ms: number) => new Promise(r => setTimeout(r, ms))
+  for (let i = 0; i < 4; i++) {
+    const start = await api('POST', `/api/workshop/dcw/lines/${lineId}/start`, { token, body: { recipeId } })
+    if (!start.ok) {
+      check(`批次 ${i + 1} 开跑`, false, JSON.stringify(start.json)?.slice(0, 120))
+      break
+    }
+    await sleep(20000)
+    await api('POST', `/api/workshop/dcw/lines/${lineId}/stop`, { token, body: {} })
+    check(`批次 ${i + 1} 采集完成(20s)`, true)
+  }
+
+  section('数据集构建(隔离三元组)')
+  const dsSpec = {
+    lineId, productId, recipeId,
+    nodes: [{ nodeId: ctrlId, role: 'control' }, { nodeId: tmpId, role: 'target' }],
+    beatMs: 1000, window: { historySteps: 3, horizonSteps: 2 },
+    cleaning: { hampelK: 5, maxInterpMs: 3000, maxDropRatio: 0.5 },
+    split: { valRatio: 0.25, testRatio: 0.25, seed: 42 },
+    purpose: 'mpc_surrogate',
+    note: 'e2e',
+  }
+  const ds = await api('POST', '/api/workshop/aml/datasets', { token, body: dsSpec })
+  const rowCount = ds.json?.data?.dataset?.rowCount ?? 0
+  check('数据集构建成功', ds.ok && rowCount > 0, `rows=${rowCount} runs=${ds.json?.data?.dataset?.runIds?.length} ${ds.json?.message ?? ''}`)
+  const datasetId: string = ds.json?.data?.dataset?.id
+  const dsList = await api('GET', `/api/workshop/aml/datasets?recipeId=${recipeId}`, { token })
+  check('数据集列表可见', dsList.ok && (dsList.json?.data?.datasets?.length ?? 0) >= 1)
+
+  section('隔离硬约束')
+  const badLine = await api('POST', '/api/workshop/aml/datasets', { token, body: { ...dsSpec, lineId: 'ln-not-exist' } })
+  check('节点产线不一致被拒', !badLine.ok && String(badLine.json?.code ?? '').startsWith('AML_'), `code=${badLine.json?.code}`)
+  const badProduct = await api('POST', '/api/workshop/aml/datasets', { token, body: { ...dsSpec, productId: 'pd-not-exist' } })
+  check('批次归属不一致被拒', !badProduct.ok, `code=${badProduct.json?.code}`)
+
+  section('训练作业(提交 → 终态)')
+  const code = REAL
+    ? readFileSync(join(process.cwd(), 'server', 'services', 'workshop', 'aml', 'python', 'train-example.py'), 'utf8')
+    : STUB_TRAIN_PY
+  const job = await api('POST', '/api/workshop/aml/jobs', {
+    token,
+    body: { datasetId, code, changeNote: 'e2e 基线', seed: 42, params: REAL ? { epochs: 30 } : {} },
+  })
+  const jobId: string = job.json?.data?.job?.id
+  check('作业提交成功', job.ok, jobId ?? job.json?.message)
+  let finalJob: any = null
+  const budgetMs = REAL ? 15 * 60_000 : 4 * 60_000
+  const t0 = Date.now()
+  while (Date.now() - t0 < budgetMs) {
+    await sleep(2000)
+    const r = await api('GET', `/api/workshop/aml/jobs/${jobId}`, { token })
+    finalJob = r.json?.data?.job
+    if (finalJob && ['done', 'failed', 'timeout', 'cancelled'].includes(finalJob.status)) break
+  }
+  check('作业终态到达', !!finalJob, `status=${finalJob?.status} err=${String(finalJob?.error ?? '').slice(0, 140)}`)
+  const stubDone = finalJob?.status === 'done'
+  if (finalJob) {
+    const detail = await api('GET', `/api/workshop/aml/jobs/${jobId}`, { token })
+    check('门禁报告产出(逐项可读)', Array.isArray(detail.json?.data?.gates?.checks),
+      `passed=${detail.json?.data?.gates?.passed} checks=${detail.json?.data?.gates?.checks?.length}`)
+  }
+
+  section('排行榜与实验谱系')
+  const lb = await api('GET', `/api/workshop/aml/experiments?datasetId=${datasetId}`, { token })
+  check('实验行已登记', lb.ok && (lb.json?.data?.experiments?.length ?? 0) >= 1, `n=${lb.json?.data?.experiments?.length}`)
+  const expRow = lb.json?.data?.experiments?.[0]
+  check('谱系/改动声明落库', !!expRow && Array.isArray(expRow.gates?.checks) && typeof expRow.changeNote === 'string', `status=${expRow?.status}`)
+
+  section('模型注册与晋升守卫')
+  const models = await api('GET', `/api/workshop/aml/models?recipeId=${recipeId}`, { token })
+  const cand = models.json?.data?.models?.find((m: any) => m.stage === 'candidate')
+  if (stubDone && cand) {
+    check('候选模型已登记(门禁通过)', true, cand.id)
+    const promote = await api('POST', `/api/workshop/aml/models/${cand.id}/promote`, { token, body: { toStage: 'production' } })
+    if (REAL) {
+      // 真实工件:深检(onnxruntime 试推理)应通过 → 晋升成功 → production 在册
+      check('真实工件通过深检并晋升 production', promote.ok && promote.json?.data?.ok === true,
+        `status=${promote.status} code=${promote.json?.code} ${promote.json?.message ?? ''}`)
+      const prods = await api('GET', `/api/workshop/aml/models?recipeId=${recipeId}&stage=production`, { token })
+      check('production 模型在册(唯一)', (prods.json?.data?.models?.length ?? 0) === 1,
+        `n=${prods.json?.data?.models?.length}`)
+    }
+    else {
+      // 存根工件(STUB 标记/无真实 onnx)必须被深检拦下 —— 这是守卫,不是缺陷
+      check('无效工件被生产晋升深检拦截', promote.status === 422 && String(promote.json?.code ?? '').includes('ARTIFACT'),
+        `status=${promote.status} code=${promote.json?.code}`)
+    }
+  }
+  else {
+    check('门禁未过 → 注册表无候选模型(干净)', !cand, `models=${models.json?.data?.models?.length}`)
+  }
+
+  section('预测守卫(未知模型)')
+  const noProd = await api('POST', '/api/workshop/aml/models/mdl-not-exist/predict', { token, body: { history: [[0]] } })
+  check('未知模型预测 404', noProd.status === 404, `status=${noProd.status}`)
+
+  section('审计归属(ops_log)')
+  const ops = await api('GET', '/api/workshop/ops-logs?limit=300', { token })
+  const opsRows: any[] = ops.json?.data?.logs ?? []
+  const amlOps = opsRows.filter(r => String(r.action ?? '').startsWith('aml.'))
+  check('aml.* 操作已入审计', amlOps.length >= 1, `n=${amlOps.length} actions=${[...new Set(amlOps.map(r => r.action))].slice(0, 5).join(',')}`)
+
+  console.log(`\n━━━ 结果:${passed} PASS / ${failures} FAIL ━━━`)
+  await restoreSettings()
+  process.exit(failures > 0 ? 1 : 0)
+}
+
+main().catch(async (err) => {
+  console.error(err)
+  process.exit(1)
+})

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/8df66d62bd41984d0970e8236882080c5085ac937d07a29779463d6a03b37c76.source

@@ -0,0 +1,97 @@
+"""Harness 可用性 UI E2E:用户名登录 → 仪表盘 Harness 面板(dsh=未安装灰化) → agents 模板选择禁用 → teams 页截图。
+dsh 未安装态由外部脚本预置;恢复也由外部执行(本脚本不发起 HTTP)。
+AW_BASE 环境变量切换目标实例(默认 :3021);EXPECT_OFF=1 时断言恰好 1 条灰化。"""
+import asyncio, os, sys
+from playwright.async_api import async_playwright
+
+BASE = os.environ.get('AW_BASE', 'http://127.0.0.1:3021')
+EXPECT_OFF = os.environ.get('EXPECT_OFF', '1') == '1'
+SHOT = '.e2e-shots'
+
+async def main():
+    results = []
+    def ok(cond, name, extra=''):
+        results.append((cond, name))
+        print(('  ✓ ' if cond else '  ✗ ') + name + (f' {extra}' if extra and not cond else ''), flush=True)
+
+    async with async_playwright() as p:
+        browser = await p.chromium.launch()
+        page = await browser.new_page(viewport={'width': 1440, 'height': 900})
+
+        # ---- 1. 用户名登录(admin/admin123;水合时机在 dev 下有抖动 → 重试 3 轮)----
+        await page.goto(BASE + '/workshop', wait_until='domcontentloaded', timeout=90000)
+        await page.reload(wait_until='domcontentloaded', timeout=90000)
+        await page.wait_for_selector('input[placeholder="邮箱 / 用户名"]', timeout=60000)
+        login_status = None
+        for attempt in range(3):
+            await page.wait_for_timeout(2500 + attempt * 2000)  # 等 Vue 水合
+            await page.fill('input[placeholder="邮箱 / 用户名"]', 'admin')
+            await page.fill('.ant-input-password input', 'admin123')
+            try:
+                async with page.expect_response(lambda r: '/api/users/login' in r.url, timeout=15000) as ri:
+                    await page.locator('.ant-input-password input').first.press('Enter')
+                login_status = (await ri.value).status
+            except Exception:
+                login_status = None
+            login_input = page.locator('input[placeholder="邮箱 / 用户名"]')
+            gone = (await login_input.count()) == 0 or not await login_input.first.is_visible()
+            if login_status == 200 and gone:
+                break
+        ok(login_status == 200, f'登录 POST 200(实际 {login_status})')
+        login_input = page.locator('input[placeholder="邮箱 / 用户名"]')
+        logged = (await login_input.count()) == 0 or not await login_input.first.is_visible()
+        ok(logged, '用户名登录进入系统')
+
+        # ---- 2. 仪表盘 Harness 面板(dsh 当前为未安装态)----
+        await page.goto(BASE + '/', wait_until='domcontentloaded', timeout=90000)
+        ok('/workshop' not in page.url, f'仪表盘未跳登录门(url={page.url})')
+        await page.wait_for_selector('.harness-row .h-item', timeout=90000)
+        await page.wait_for_timeout(1500)
+        items = await page.locator('.harness-row .h-item').count()
+        ok(items == 6, f'仪表盘 6 引擎条目(实际 {items})')
+        off = page.locator('.harness-row .h-item.off')
+        off_n = await off.count()
+        if EXPECT_OFF:
+            ok(off_n == 1, f'未安装灰化条目=1(实际 {off_n})')
+            if off_n == 1:
+                txt = await off.first.inner_text()
+                ok('未安装' in txt and 'dsh' in txt, f'灰化条目为 dsh:{txt!r}')
+            total = await page.locator('.dp-hd:has-text("执行引擎") .fleet-total').inner_text()
+            ok('5/6' in total, f'就绪计数 5/6(实际 {total!r})')
+        else:
+            print(f'  · 灰化条目={off_n}(当前环境探测结果;全部安装时为 0)', flush=True)
+            total = await page.locator('.dp-hd:has-text("执行引擎") .fleet-total').inner_text()
+            print(f'  · 就绪计数={total!r}', flush=True)
+        await page.screenshot(path=f'{SHOT}/harness-1-dashboard-off.png', full_page=False)
+
+        # ---- 3. agents 模板页:选择器禁用未安装项 ----
+        await page.goto(BASE + '/workshop/agents', wait_until='domcontentloaded', timeout=90000)
+        await page.click('button:has-text("新建模板")')
+        await page.wait_for_selector('.ant-modal .ant-select', timeout=10000)
+        await page.click('.ant-modal .ant-select')
+        await page.wait_for_selector('.ant-select-dropdown .ant-select-item-option', timeout=10000)
+        opts = await page.locator('.ant-select-dropdown .ant-select-item-option').all_inner_texts()
+        disabled = page.locator('.ant-select-dropdown .ant-select-item-option-disabled')
+        dis_n = await disabled.count()
+        if EXPECT_OFF:
+            ok(any('未安装' in o for o in opts), f'下拉含(未安装)标记:{[o for o in opts if "未安装" in o]!r}')
+            ok(dis_n == 1, f'禁用选项=1(实际 {dis_n})')
+            if dis_n == 1:
+                ok('dsh' in (await disabled.first.inner_text()), '禁用项为 dsh')
+        else:
+            print(f'  · 下拉选项={len(opts)},禁用={dis_n}(全部安装时为 0)', flush=True)
+        await page.screenshot(path=f'{SHOT}/harness-2-agent-select-disabled.png', full_page=False)
+        await page.keyboard.press('Escape')
+
+        # ---- 4. teams 页:成员选择禁用 dsh 模板(视觉记录)----
+        await page.goto(BASE + '/workshop/teams', wait_until='domcontentloaded', timeout=90000)
+        await page.wait_for_timeout(1500)
+        await page.screenshot(path=f'{SHOT}/harness-3-teams.png', full_page=False)
+
+        await browser.close()
+
+    fails = [r for r in results if not r[0]]
+    print(f'\nUI RESULT: {len(results) - len(fails)} pass / {len(fails)} fail')
+    sys.exit(1 if fails else 0)
+
+asyncio.run(main())

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/9962f2d1b3a85137bd40cc835725600b39f89ee02a27c06b2e0402e1eafde115.source

@@ -0,0 +1,277 @@
+/**
+ * 端到端验证:每个 AgentRuntime 的任务队列管理 + 实时状态追踪 + lead 统一调度分发。
+ *
+ * 场景 A(用户要求的实际测试):
+ *  1. 模拟用户向 channel 连发两个任务需求(submitChannelTask ×2)
+ *  2. 观察 lead FIFO 处理外部队列:先提交的任务先分解(dispatch 子任务 createdAt 严格递增)
+ *  3. 一轮内两个任务分给两个不同 worker(池化分配,不重复占同一个空闲 worker)
+ *  4. worker 接任务 → busy(带 currentTaskId)→ 执行 → 完成后查队列取下一个 → 队列空 → idle
+ *  5. 执行中再补两个任务 → 排队等待 → 逐个消化 → 全部完成后 worker idle
+ *
+ * 场景 B(lead 对 worker 队列的增删改查与调配,走 omp host tool 同款 manager 通道):
+ *  - 查:queueViewOf 看 worker 待执行/执行中/已完成
+ *  - 改:updateTask 修改排队任务内容,队列投递自动刷新
+ *  - 调配:reassignTask 把排队任务迁移到另一 worker,旧 assignee 队列自动清退
+ *  - 删:cancelTask 取消排队任务,过期投递作废,worker 永不执行
+ *
+ * 场景 C(omp rpc 原生集成冒烟):
+ *  - 真实 omp 子进程(--mode rpc)注册全部 host tools(含 5 个新增队列管理工具)
+ *
+ * 运行: npx tsx scripts/e2e-task-queue.ts
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import { monitorChannel } from '../server/services/workshop/runtime/monitor'
+import { HOST_TOOLS } from '../server/services/workshop/agents/omp-agent'
+import { OmpRpcClient } from '../server/services/workshop/agents/adapters/omp-rpc-client'
+import type { AgentTaskQueueView } from '../server/services/workshop/types/task'
+
+let failures = 0
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+function makeManager(db: DatabaseSync): AgentChannelManager {
+  return createAgentChannelManager({
+    repos: {
+      channels: createChannelRepo(db),
+      agents: createAgentRepo(db),
+      channelAgents: createChannelAgentRepo(db),
+      messages: createMessageRepo(db),
+      subscriptions: createSubscriptionRepo(db),
+      tasks: createTaskRepo(db),
+      memories: createMemoryRepo(db),
+
+      channelEvents: createChannelEventRepo(db),
+      teams: createTeamRepo(db),
+      teamMembers: createTeamMemberRepo(db),
+    },
+    implFactory: createAgentImpl,
+    db,
+  })
+}
+
+/** manager 内部 TaskEngine 访问(与运行时同一实例;ws.ts 同风格类型收窄) */
+function engineOf(manager: AgentChannelManager) {
+  return (manager as unknown as {
+    getTaskEngine(): {
+      get(id: string): { id: string, title: string, state: string, assigneeId: string, createdAt: string, parentId?: string } | undefined
+      list(channelId: string): Array<{ id: string, title: string, state: string, assigneeId: string, createdAt: string, parentId?: string }>
+      queueViewOf(channelId: string, agentId: string): AgentTaskQueueView
+    }
+  }).getTaskEngine()
+}
+
+async function waitUntil(pred: () => boolean, timeoutMs: number): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (pred()) return true
+    await sleep(20)
+  }
+  return pred()
+}
+
+/** 场景 A + A2:两任务 FIFO 分发 → 双 worker 执行 → 追加任务排队消化 → 全部完成转空闲 */
+async function scenarioDispatchAndDrain(manager: AgentChannelManager): Promise<void> {
+  console.log('\n━━━ 场景 A:外部两任务 FIFO 分发 + worker 执行 + 追加排队消化 ━━━')
+  const ch = await manager.createChannel({
+    name: 'queue-e2e-A',
+    leadAgent: { name: 'lead-甲', harness: 'mock', config: { delayMs: 0 } },
+  })
+  const wTplA = await manager.createAgent({ name: 'worker-A', harness: 'mock', config: { delayMs: 200 } })
+  const wTplB = await manager.createAgent({ name: 'worker-B', harness: 'mock', config: { delayMs: 200 } })
+  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTplA.id, role: 'worker' })
+  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTplB.id, role: 'worker' })
+
+  const members = await manager.listChannelAgents(ch.channelId)
+  const workers = members.filter(m => m.role === 'worker')
+  const engine = engineOf(manager)
+
+  // 先激活 channel(装配 bus + 调度循环),monitor 才能订阅到实时事件流
+  manager.ensureChannelActive(ch.channelId, { tickMs: 50 })
+  const mon = monitorChannel(manager, ch.channelId)
+  const p1 = await manager.submitChannelTask({ channelId: ch.channelId, title: '任务一:统计苹果数', description: '读取 input 文件统计水果' })
+  const p2 = await manager.submitChannelTask({ channelId: ch.channelId, title: '任务二:汇总会议纪要', description: '汇总 note 文件' })
+  console.log(`  用户提交:P1=${p1.id.slice(0, 8)} P2=${p2.id.slice(0, 8)}`)
+
+  // 2. lead FIFO:两个父任务都被分解出子任务
+  const childOf = (parentId: string) => engine.list(ch.channelId).find(t => t.parentId === parentId)
+  const bothDispatched = await waitUntil(() => !!childOf(p1.id) && !!childOf(p2.id), 10_000)
+  check('lead FIFO 处理外部队列:两个任务都被分解分发', bothDispatched)
+  const c1 = childOf(p1.id)!
+  const c2 = childOf(p2.id)!
+  check('FIFO 顺序:先提交的任务子任务先创建', c1.createdAt <= c2.createdAt, `c1@${c1.createdAt.slice(11, 23)} c2@${c2.createdAt.slice(11, 23)}`)
+
+  // 3. 一轮内两个任务去了两个不同 worker(池化分配;若都给同一 worker 则说明分配退化)
+  check('一轮内两任务分给不同 worker(最优分配)', c1.assigneeId !== c2.assigneeId, `w=${c1.assigneeId.slice(0, 8)}/${c2.assigneeId.slice(0, 8)}`)
+
+  // 4. 执行中追加两个任务 → 排队,worker 完成当前任务后按 FIFO 消化
+  const p3 = await manager.submitChannelTask({ channelId: ch.channelId, title: '任务三:整理清单', description: '第三需求' })
+  const p4 = await manager.submitChannelTask({ channelId: ch.channelId, title: '任务四:输出报告', description: '第四需求' })
+  const allDone = await waitUntil(
+    () => [p1, p2, p3, p4].every(p => engine.get(p.id)?.state === 'COMPLETED'),
+    30_000,
+  )
+  check('4 个外部任务全部完成(排队任务被逐个消化)', allDone,
+    [p1, p2, p3, p4].map(p => `${p.id.slice(0, 8)}=${engine.get(p.id)?.state}`).join(' '))
+
+  // 5. 每个 worker 内部执行顺序 = 其名下子任务(按 assignee 归属)创建顺序 = FIFO。
+  //    过滤按 assignee 而非 transition by:父任务 WAITING→WORKING 的迁移 by=子任务 assignee,
+  //    但那是 lead 汇总相位,不是该 worker 的执行相位。
+  const workingTasks = mon.events
+    .filter((e): e is Extract<typeof e, { taskId: string }> => e.kind === 'task.status' && e.state === 'WORKING')
+    .map(e => engine.get(e.taskId))
+    .filter((t): t is NonNullable<typeof t> => t !== undefined)
+  for (const w of workers) {
+    const seq = workingTasks.filter(t => t.assigneeId === w.id)
+    const fifo = seq.every((t, i) => i === 0 || seq[i - 1]!.createdAt <= t.createdAt)
+    check(`worker ${w.name} 执行顺序 FIFO(${seq.length} 个)`, seq.length >= 2 && fifo,
+      seq.map(t => t.title.slice(0, 12)).join(' → '))
+  }
+
+  // 6. 状态实时追踪:busy 事件带 currentTaskId;全部完成后 worker 空闲且队列空
+  const busyWithContext = mon.events.some(e =>
+    e.kind === 'agent.status' && e.state === 'busy' && e.currentTaskId != null)
+  check('agent.status busy 事件携带 currentTaskId(实时状态追踪)', busyWithContext)
+
+  const workersIdle = await waitUntil(() =>
+    workers.every(w => manager.getChannelAgent(w.id)?.runtimeState === 'idle'), 10_000)
+  check('队列清空后全部 worker 标记 idle', workersIdle)
+  for (const w of workers) {
+    const q = engine.queueViewOf(ch.channelId, w.id)
+    check(`worker ${w.name} 队列空 + 已完成 ${q.completed.length} 个`, q.queued.length === 0 && !q.current && q.completed.length >= 2)
+  }
+  mon.stop()
+}
+
+/** 场景 B:lead 对 worker 队列的查/改/调配/删(omp host tool 同款 manager 通道) */
+async function scenarioQueueCrud(manager: AgentChannelManager): Promise<void> {
+  console.log('\n━━━ 场景 B:lead 对 worker 队列的增删改查与调配 ━━━')
+  const ch = await manager.createChannel({
+    name: 'queue-e2e-B',
+    leadAgent: { name: 'lead-乙', harness: 'mock', config: { delayMs: 0 } },
+  })
+  const wTpl1 = await manager.createAgent({ name: 'worker-甲', harness: 'mock', config: { delayMs: 500 } })
+  const wTpl2 = await manager.createAgent({ name: 'worker-乙', harness: 'mock', config: { delayMs: 500 } })
+  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTpl1.id, role: 'worker' })
+  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTpl2.id, role: 'worker' })
+
+  const members = await manager.listChannelAgents(ch.channelId)
+  const lead = members.find(m => m.role === 'lead')!
+  const [w1, w2] = members.filter(m => m.role === 'worker')
+  const engine = engineOf(manager)
+
+  // 激活 channel 装配 bus(不经 submitChannelTask,避免占位任务污染 worker 队列)
+  manager.ensureChannelActive(ch.channelId, { tickMs: 50 })
+  const mon = monitorChannel(manager, ch.channelId)
+
+  // lead 直接分发(= omp host tool dispatch_task 同款通道):
+  // C_a → w1(立即执行),C_b → w1(排队),C_c → w2(立即执行)
+  const ca = await manager.dispatchTask(ch.channelId, lead.id, { assigneeId: w1.id, title: 'C_a-首批' })
+  const cb = await manager.dispatchTask(ch.channelId, lead.id, { assigneeId: w1.id, title: 'C_b-次批' })
+  const cc = await manager.dispatchTask(ch.channelId, lead.id, { assigneeId: w2.id, title: 'C_c-并行' })
+
+  // 查:w1 执行中 C_a、队列 [C_b];w2 执行中 C_c
+  await waitUntil(() => engine.get(ca.id)?.state === 'WORKING' && engine.get(cc.id)?.state === 'WORKING', 10_000)
+  const q1 = engine.queueViewOf(ch.channelId, w1.id)
+  check('查:w1 执行中 C_a + 队列 [C_b]', q1.current?.id === ca.id && q1.queued.map(t => t.id).join() === cb.id)
+
+  // 改:更新排队任务 C_b 内容
+  const updated = await manager.updateTask(ch.channelId, lead.id, cb.id, { title: 'C_b-改后内容', description: '改描述' })
+  check('改:排队任务标题已更新', updated.title === 'C_b-改后内容' && engine.queueViewOf(ch.channelId, w1.id).queued[0]?.title === 'C_b-改后内容')
+
+  // 调配:C_b 从 w1 迁到 w2;w1 队列清退,w2 队列接收
+  const reassigned = await manager.reassignTask(ch.channelId, lead.id, cb.id, w2.id)
+  const q1b = engine.queueViewOf(ch.channelId, w1.id)
+  const q2b = engine.queueViewOf(ch.channelId, w2.id)
+  check('调配:assignee 已换到 w2', reassigned.assigneeId === w2.id && engine.get(cb.id)?.assigneeId === w2.id)
+  check('调配:w1 队列已清退', q1b.queued.length === 0 && !q1b.queued.some(t => t.id === cb.id))
+  check('调配:w2 队列接收(FIFO 排在当前任务后)', q2b.queued.some(t => t.id === cb.id))
+
+  // 删:向 w2 追加 C_d 后立即取消;过期投递作废
+  const cd = await manager.dispatchTask(ch.channelId, lead.id, { assigneeId: w2.id, title: 'C_d-待删' })
+  const canceled = await manager.cancelTask(ch.channelId, lead.id, { taskId: cd.id })
+  check('删:任务已 CANCELED', canceled.state === 'CANCELED')
+
+  // 终态:C_a/C_c/C_b 完成(调配后 C_b 由 w2 执行),C_d 永不执行
+  const settled = await waitUntil(
+    () => ['COMPLETED', 'FAILED', 'CANCELED'].includes(engine.get(ca.id)?.state ?? '')
+      && ['COMPLETED', 'FAILED', 'CANCELED'].includes(engine.get(cb.id)?.state ?? '')
+      && ['COMPLETED', 'FAILED', 'CANCELED'].includes(engine.get(cc.id)?.state ?? ''),
+    30_000,
+  )
+  check('C_a/C_b/C_c 全部完成', settled,
+    `C_a=${engine.get(ca.id)?.state} C_b=${engine.get(cb.id)?.state} C_c=${engine.get(cc.id)?.state}`)
+  check('调配后的 C_b 由 w2 执行完成', engine.get(cb.id)?.state === 'COMPLETED' && engine.get(cb.id)?.assigneeId === w2.id)
+  check('取消的 C_d 未被执行(仍 CANCELED)', engine.get(cd.id)?.state === 'CANCELED')
+
+  // w1 从未执行 C_b(调配后无 WORKING 事件);w2 从未执行 C_d
+  const worked = mon.events.filter(e => e.kind === 'task.status' && e.state === 'WORKING')
+  check('w1 从未执行已调配走的 C_b', !worked.some(e => (e as { taskId: string }).taskId === cb.id && (e as { agentId?: string }).agentId === w1.id))
+  check('w2 从未执行已取消的 C_d', !worked.some(e => (e as { taskId: string }).taskId === cd.id))
+
+  // 过期投递作废:w2 邮箱无 C_d 的 pending 消息
+  const msgs = (manager as unknown as {
+    deps: { repos: { messages: { listPendingByChannelAgent(chId: string, aId: string): Array<{ taskId: string | null }> } } }
+  }).deps.repos.messages.listPendingByChannelAgent(ch.channelId, w2.id)
+  check('取消任务的过期投递已作废(无 pending)', !msgs.some(m => m.taskId === cd.id))
+
+  // lead 队列总览(host tool get_queue_overview 同款通道)
+  const overview = await manager.queueOverview(ch.channelId, lead.id)
+  check('queueOverview 返回全员实时状态', overview.length === 3 && overview.every(s => s.state === 'idle' || s.state === 'busy' || s.state === 'stopped'))
+  mon.stop()
+}
+
+/** 场景 C:真实 omp rpc 子进程注册全部 host tools(原生集成冒烟,无 LLM 调用) */
+async function scenarioOmpRpc(): Promise<void> {
+  console.log('\n━━━ 场景 C:omp rpc 原生集成(host tools 注册冒烟)━━━')
+  const client = new OmpRpcClient({ command: 'omp' })
+  try {
+    await client.start()
+    const resp = await client.send({ type: 'set_host_tools', tools: HOST_TOOLS })
+    check(`omp rpc 就绪 + 注册 ${HOST_TOOLS.length} 个 host tools(含 5 个队列管理工具)`, resp.success === true)
+    const names = HOST_TOOLS.map(t => t.name)
+    check('新增队列工具均在注册列表', ['get_my_task_queue', 'get_queue_overview', 'reassign_task', 'update_task', 'cancel_task'].every(n => names.includes(n)))
+  }
+  finally {
+    await client.dispose()
+  }
+}
+
+async function main(): Promise<void> {
+  console.log('━━━ AgentRuntime 任务队列管理 + 状态追踪 + lead 调度 端到端 ━━━')
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    await scenarioDispatchAndDrain(manager)
+    await scenarioQueueCrud(manager)
+    await scenarioOmpRpc()
+  }
+  finally {
+    await manager.shutdown()
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('测试异常:', e)
+  process.exit(1)
+})