agentworkshop 0.7.27 → 0.7.33

package/scripts/test-aml-job.ts

@@ -0,0 +1,174 @@
+/**
+ * AML 作业链路冒烟测试(进程内,秒级;存根运行器):
+ *   沙箱环境 → 建数据集(合成一阶动力学)→ 创建训练作业(AML_STUB 存根运行器)→
+ *   门禁判定 → 实验行登记 → 注册表/工件纪律(STUB 模型不可预测)。
+ *
+ * 真实 Python 链路(venv 供给 + torch 训练 + ONNX 评估)由 scripts/e2e-aml.ts --real
+ * 对活服覆盖 —— 本脚本专注作业状态机与登记语义,不依赖本机 Python。
+ *
+ * 运行:AML_STUB=1 npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-aml-job.ts
+ */
+import assert from 'node:assert'
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { tmpdir } from 'node:os'
+
+const ROOT = join(tmpdir(), `aml-job-${Date.now()}`)
+
+/** 路径 allowlist:测试沙箱只允许落在系统临时目录内 */
+function assertInTmp(p: string, label: string): string {
+  const abs = resolve(p)
+  if (!abs.startsWith(tmpdir())) {
+    throw new Error(`${label} 越界(仅允许系统临时目录): ${abs}`)
+  }
+  return abs
+}
+
+/** 确定性伪随机(测试夹具专用;[0,1)) */
+let lcgState = 0x2F6E2B1
+function lcg(): number {
+  lcgState = (Math.imul(lcgState, 1664525) + 1013904223) >>> 0
+  return lcgState / 0x100000000
+}
+
+let passed = 0
+let failed = 0
+function t(name: string, fn: () => void | Promise<void>): Promise<void> {
+  return Promise.resolve()
+    .then(fn)
+    .then(() => {
+      passed++
+      console.log(`  ✓ ${name}`)
+    })
+    .catch((err) => {
+      failed++
+      console.error(`  ✗ ${name}: ${err?.stack ?? String(err)}`)
+    })
+}
+
+async function main() {
+  rmSync(ROOT, { recursive: true, force: true })
+  const dataDir = assertInTmp(join(ROOT, 'data'), 'data')
+  const serverData = assertInTmp(join(ROOT, 'server', 'data'), 'server/data')
+  mkdirSync(serverData, { recursive: true })
+  mkdirSync(dataDir, { recursive: true })
+  process.env.AW_DATA_DIR = dataDir
+  process.env.AML_STUB = '1'
+  process.chdir(ROOT)
+
+  const { openWorkshopDb, initWorkshopDb } = await import('../server/services/workshop/db/database')
+  const { configureAmlRuntime } = await import('../server/services/workshop/aml/runtime')
+  const db = openWorkshopDb(join(dataDir, 'workshop.sqlite'))
+  initWorkshopDb(db)
+  const rt = configureAmlRuntime(db, dataDir)
+
+  // ---- 夹具:批次 + 节点 + 合成一阶动力学样本(与集成测试同源) ----
+  const mkRun = (id: string, startedAt: string, endedAt: string) => ({
+    id, recipeId: 'rc-it-1', productId: 'pd-it-1', lineId: 'ln-it-1',
+    name: id, startedAt, endedAt, params: [], paramsSnapshot: [], results: [],
+  })
+  const now = Date.now()
+  const runs = [0, 1, 2, 3].map(i => mkRun(
+    `rr-it-${i}`,
+    new Date(now - (4 - i) * 3600_000).toISOString(),
+    new Date(now - (4 - i) * 3600_000 + 2400_000).toISOString(),
+  ))
+  writeFileSync(join(serverData, 'dcw-runs.json'), JSON.stringify(runs))
+  writeFileSync(join(serverData, 'dcw-recipes.json'), JSON.stringify([]))
+  writeFileSync(join(serverData, 'daqs.json'), JSON.stringify([
+    { id: 'daq-it-ctrl', templateRef: 'daq-temp-tc', name: 'it-ctrl', lineId: 'ln-it-1', min: 0, max: 100 },
+    { id: 'daq-it-tmp', templateRef: 'daq-pressure-tx', name: 'it-tmp', lineId: 'ln-it-1', min: 0, max: 200 },
+  ]))
+  const { SqliteTimeSeriesAdapter } = await import('../server/services/workshop/daq/storage/sqlite.adapter')
+  const tsdb = new SqliteTimeSeriesAdapter()
+  await tsdb.init()
+  const beatMs = 5000
+  const rows = []
+  for (const run of runs) {
+    const t0 = Date.parse(run.startedAt)
+    const t1 = Date.parse(run.endedAt)
+    let pv = 50
+    for (let t = t0; t <= t1; t += 1000) {
+      const sp = 60 + 10 * Math.sin((t - t0) / 60000)
+      pv = pv + (sp - pv) * 0.02 + (lcg() - 0.5) * 0.3
+      rows.push({ nodeId: 'daq-it-ctrl', tsMs: t, value: sp, state: 'ok', lineId: 'ln-it-1', productId: 'pd-it-1', recipeId: 'rc-it-1', runId: run.id })
+      rows.push({ nodeId: 'daq-it-tmp', tsMs: t, value: pv, state: 'ok', lineId: 'ln-it-1', productId: 'pd-it-1', recipeId: 'rc-it-1', runId: run.id })
+    }
+  }
+  await tsdb.writeSamples(rows)
+
+  // ---- 构建数据集 + 创建训练作业(存根代码由编排器写入工作区) ----
+  const { buildDataset } = await import('../server/services/workshop/aml/dataset-builder')
+  const { parseDatasetSpec } = await import('../server/services/workshop/aml/spec')
+  const orchestrator = await import('../server/services/workshop/aml/job-orchestrator')
+  const { dataset } = await buildDataset(parseDatasetSpec({
+    lineId: 'ln-it-1', productId: 'pd-it-1', recipeId: 'rc-it-1',
+    nodes: [{ nodeId: 'daq-it-ctrl', role: 'control' }, { nodeId: 'daq-it-tmp', role: 'target' }],
+    beatMs, window: { historySteps: 12, horizonSteps: 6 },
+    cleaning: { hampelK: 5, maxInterpMs: 15000, maxDropRatio: 0.3 },
+    split: { valRatio: 0.25, testRatio: 0.25, seed: 42 },
+    purpose: 'mpc_surrogate',
+  }), { id: 'tester', kind: 'user' })
+  console.log(`  数据集 ${dataset.id}:rows=${dataset.rowCount} runs=${dataset.runIds.length}`)
+
+  const job = orchestrator.submitJob({
+    datasetId: dataset.id,
+    code: 'import amlkit\namlkit.report_progress(50, \'stub\')\namlkit.save_metrics({\'agent\': {\'note\': \'stub\'}})\nprint(\'stub done\')\n',
+    changeNote: 'job-smoke 基线',
+    seed: 42,
+    params: { stubNrmse: 0.07, stubRolloutNrmse: 0.18 },
+    agent: { id: 'tester-agent' },
+  })
+  console.log(`  作业 ${job.id} 已创建(存根运行器)…`)
+
+  // ---- 轮询至终态 ----
+  const started = Date.now()
+  let final = rt.repo.job.get(job.id)!
+  while (Date.now() - started < 60_000) {
+    await new Promise(r => setTimeout(r, 1000))
+    final = rt.repo.job.get(job.id)!
+    if (['done', 'failed', 'timeout', 'cancelled'].includes(final.status)) break
+  }
+
+  await t('作业完成(done)', () => {
+    assert.equal(final.status, 'done', `status=${final.status} err=${final.error}`)
+  })
+  await t('实验行已登记且门禁全过(存根达标指标)', () => {
+    const exps = rt.repo.experiment.listByDataset(dataset.id)
+    assert.ok(exps.length >= 1)
+    assert.equal(exps[0].status, 'gates_passed')
+    const gateReport = JSON.parse(exps[0].gatesJson)
+    assert.ok(gateReport.passed)
+    assert.ok(Array.isArray(gateReport.checks) && gateReport.checks.length >= 5)
+    console.log(`    门禁:${gateReport.checks.map((c: { id: string, pass: boolean }) => `${c.id}:${c.pass ? '✓' : '✗'}`).join(' ')}`)
+  })
+  await t('候选模型登记:STUB 工件在册,预测服务拒绝(STUB 纪律)', async () => {
+    const models = rt.repo.model.list({ recipeId: 'rc-it-1' })
+    assert.ok(models.length >= 1, '应有 candidate 模型')
+    const io = JSON.parse(models[0].ioSpecJson)
+    assert.equal(io.modelInterface, 'one_step')
+    assert.deepEqual(io.targetNodes, ['daq-it-tmp'])
+    const { predictWithModel } = await import('../server/services/workshop/aml/predictor')
+    await assert.rejects(
+      () => predictWithModel(models[0].id, { history: [[0]] }),
+      (e: unknown) => (e as { code?: string }).code === 'AML_STUB_MODEL',
+    )
+  })
+  await t('日志可读(终态后落盘 run.log)', () => {
+    const logs = orchestrator.jobLogsTail(job.id, 40)
+    assert.ok(logs.length > 0)
+  })
+  await t('操作归属:审计留痕含提交者', () => {
+    const jobs = rt.repo.job.list({ datasetId: dataset.id })
+    assert.equal(jobs[0].agentId, 'tester-agent')
+  })
+
+  console.log(`\n结果:${passed} 通过 / ${failed} 失败`)
+  if (failed > 0) process.exit(1)
+  process.exit(0)
+}
+
+main().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})

package/scripts/test-aml-unit.ts

@@ -0,0 +1,184 @@
+/**
+ * AML 单元测试(纯函数,无服务依赖):清洗/统计/规格校验/门禁判定。
+ * 运行:npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-aml-unit.ts
+ */
+import assert from 'node:assert'
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+
+let passed = 0
+let failed = 0
+function t(name: string, fn: () => void | Promise<void>): Promise<void> {
+  return Promise.resolve()
+    .then(fn)
+    .then(() => {
+      passed++
+      console.log(`  ✓ ${name}`)
+    })
+    .catch((err) => {
+      failed++
+      console.error(`  ✗ ${name}: ${err instanceof Error ? err.message : String(err)}`)
+    })
+}
+
+async function main() {
+  const { cleanPoints, alignToGrid } = await import('../server/services/workshop/aml/clean')
+  const { median, pearson, lagCrossCorr, summarize } = await import('../server/services/workshop/aml/stats')
+  const { parseDatasetSpec } = await import('../server/services/workshop/aml/spec')
+  const { evaluateGates } = await import('../server/services/workshop/aml/gates')
+
+  console.log('clean.ts')
+  await t('state 过滤:非 ok 样本剔除并计数', () => {
+    const r = cleanPoints([
+      { at: 1, value: 10, state: 'ok' },
+      { at: 2, value: 11, state: 'alarm' },
+      { at: 3, value: 12 },
+    ], {})
+    assert.equal(r.values.length, 2)
+    assert.equal(r.counts.droppedState, 1)
+    assert.equal(r.counts.total, 3)
+  })
+  await t('量程截断:模板量程外剔除', () => {
+    const r = cleanPoints([{ at: 1, value: -50 }, { at: 2, value: 25 }], { range: { min: 0, max: 100 } })
+    assert.equal(r.values.length, 1)
+    assert.equal(r.counts.droppedRange, 1)
+  })
+  await t('Hampel:尖峰被移除,正常波动保留', () => {
+    const base = Array.from({ length: 41 }, (_, i) => ({ at: i, value: 50 + Math.sin(i / 5) }))
+    const withSpike = [...base.slice(0, 20), { at: 20, value: 500 }, ...base.slice(21)]
+    const r = cleanPoints(withSpike, { hampelK: 5 })
+    assert.equal(r.counts.droppedHampel, 1)
+    const r2 = cleanPoints(base, { hampelK: 5 })
+    assert.equal(r2.counts.droppedHampel, 0)
+  })
+  await t('对齐:桶均值 + 短缺口线性插值', () => {
+    const beat = 1000
+    const vals = [
+      { at: 0, value: 0 }, { at: 500, value: 10 }, // 同桶均值 5
+      { at: 3000, value: 30 }, // 缺 1000/2000 两格 → 线性插值 13.33 / 21.67
+      { at: 9000, value: 90 }, // 长缺口不插
+    ]
+    const r = alignToGrid(vals, { beatMs: beat, maxInterpMs: 3000 })
+    assert.equal(r.grid[0].at, 0)
+    assert.ok(Math.abs(r.grid[0].value - 5) < 1e-9)
+    assert.equal(r.counts.interpolated, 2)
+    const at2000 = r.grid.find(g => g.at === 2000)
+    assert.ok(at2000 && Math.abs(at2000.value - (5 + 25 * 2 / 3)) < 1e-9, `插值=${at2000?.value}`)
+    assert.ok(!r.grid.some(g => g.at === 5000)) // 长缺口留空
+  })
+
+  console.log('stats.ts')
+  await t('median/quantile', () => {
+    assert.equal(median([3, 1, 2]), 2)
+    assert.equal(median([4, 1, 3, 2]), 2.5)
+    const s = summarize('n', 'target', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10], 0, 0)
+    assert.equal(s.mean, 5.5)
+    assert.equal(s.min, 1)
+    assert.equal(s.max, 10)
+    assert.equal(s.p50, 5.5)
+  })
+  await t('pearson:同向 1 / 反向 -1', () => {
+    const a = [1, 2, 3, 4, 5]
+    assert.ok(Math.abs(pearson(a, [2, 4, 6, 8, 10]) - 1) < 1e-9)
+    assert.ok(Math.abs(pearson(a, [10, 8, 6, 4, 2]) + 1) < 1e-9)
+  })
+  await t('滞后互相关:能找到注入的真实时滞(控制领先目标)', () => {
+    const n = 300
+    const control = Array.from({ length: n }, (_, i) => Math.sin(i / 12))
+    const trueLag = 7
+    // 物理语义:控制领先 7 拍 → target[t] = control[t-7]
+    const target = Array.from({ length: n }, (_, i) => (i - trueLag >= 0 ? control[i - trueLag] : 0))
+    const est = lagCrossCorr(control, target, 20)
+    assert.equal(est.lagSteps, trueLag)
+    assert.ok(est.corr > 0.99)
+  })
+
+  console.log('spec.ts')
+  await t('合法 spec 解析通过', () => {
+    const spec = parseDatasetSpec({
+      lineId: 'ln-1', productId: 'pd-1', recipeId: 'rc-1',
+      nodes: [{ nodeId: 'n1', role: 'control' }, { nodeId: 'n2', role: 'target' }],
+      beatMs: 5000, window: { historySteps: 12, horizonSteps: 6 },
+      split: { valRatio: 0.2, testRatio: 0.2, seed: 42 },
+      purpose: 'mpc_surrogate',
+    })
+    assert.equal(spec.window.historySteps, 12)
+  })
+  await t('缺 target 节点 → 422', () => {
+    assert.throws(() => parseDatasetSpec({
+      lineId: 'ln-1', productId: 'pd-1', recipeId: 'rc-1',
+      nodes: [{ nodeId: 'n1', role: 'feature' }, { nodeId: 'n2', role: 'feature' }],
+      beatMs: 5000, window: { historySteps: 12, horizonSteps: 6 },
+      split: { valRatio: 0.2, testRatio: 0.2, seed: 42 },
+    }), (e: unknown) => (e as { code?: string }).code === 'AML_SPEC_INVALID')
+  })
+  await t('beatMs < 1000 → 422', () => {
+    assert.throws(() => parseDatasetSpec({
+      lineId: 'ln-1', productId: 'pd-1', recipeId: 'rc-1',
+      nodes: [{ nodeId: 'n1', role: 'control' }, { nodeId: 'n2', role: 'target' }],
+      beatMs: 100, window: { historySteps: 12, horizonSteps: 6 },
+      split: { valRatio: 0.2, testRatio: 0.2, seed: 42 },
+    }), (e: unknown) => (e as { code?: string }).code === 'AML_SPEC_INVALID')
+  })
+
+  console.log('gates.ts')
+  const tmp = join(tmpdir(), `aml-gates-${Date.now()}`)
+  mkdirSync(tmp, { recursive: true })
+  writeFileSync(join(tmp, 'model.onnx'), Buffer.alloc(1024, 1))
+  const dsMeta = { rowCount: 5000, runIds: ['a', 'b', 'c'] }
+  const manifest = { split: { train: 4000, val: 500, test: 500 } } as never
+  await t('全部门禁通过(好指标)', () => {
+    const g = evaluateGates('mpc_surrogate', dsMeta, manifest, {
+      oneStepVal: { windows: 500, nrmse: 0.08 },
+      oneStepTest: { windows: 500, nrmse: 0.09 },
+      rolloutTest: { windows: 100, nrmse: 0.2, horizon: 12 },
+    }, tmp)
+    assert.equal(g.passed, true, JSON.stringify(g.checks))
+  })
+  await t('滚动 NRMSE 超标 → G2 不过', () => {
+    const g = evaluateGates('mpc_surrogate', dsMeta, manifest, {
+      oneStepVal: { windows: 500, nrmse: 0.05 },
+      oneStepTest: { windows: 500, nrmse: 0.05 },
+      rolloutTest: { windows: 100, nrmse: 0.9, horizon: 12 },
+    }, tmp)
+    assert.equal(g.passed, false)
+    assert.ok(g.checks.find(c => c.id === 'G2' && !c.pass))
+  })
+  await t('泛化差超标 → G3 不过', () => {
+    const g = evaluateGates('mpc_surrogate', dsMeta, manifest, {
+      oneStepVal: { windows: 500, nrmse: 0.05 },
+      oneStepTest: { windows: 500, nrmse: 0.20 },
+      rolloutTest: { windows: 100, nrmse: 0.1, horizon: 12 },
+    }, tmp)
+    assert.ok(g.checks.find(c => c.id === 'G3' && !c.pass))
+  })
+  await t('数据覆盖不足 → G4 不过', () => {
+    const g = evaluateGates('mpc_surrogate', { rowCount: 100, runIds: ['a'] }, manifest, {
+      oneStepVal: { windows: 50, nrmse: 0.05 },
+      oneStepTest: { windows: 50, nrmse: 0.06 },
+      rolloutTest: { windows: 10, nrmse: 0.1, horizon: 12 },
+    }, tmp)
+    assert.ok(g.checks.find(c => c.id === 'G4' && !c.pass))
+  })
+  await t('空工件目录 → G5 不过;quality_predict 不查 G2', () => {
+    const empty = join(tmpdir(), `aml-gates-empty-${Date.now()}`)
+    mkdirSync(empty, { recursive: true })
+    const g = evaluateGates('mpc_surrogate', dsMeta, manifest, {
+      oneStepVal: { windows: 500, nrmse: 0.08 }, oneStepTest: { windows: 500, nrmse: 0.09 },
+      rolloutTest: { windows: 100, nrmse: 0.2, horizon: 12 },
+    }, empty)
+    assert.ok(g.checks.find(c => c.id === 'G5' && !c.pass))
+    writeFileSync(join(empty, 'STUB'), 'x')
+    const g2checks = evaluateGates('quality_predict', dsMeta, manifest, {
+      oneStepVal: { windows: 500, nrmse: 0.08 }, oneStepTest: { windows: 500, nrmse: 0.09 },
+    }, empty)
+    assert.ok(!g2checks.checks.some(c => c.id === 'G2'))
+    assert.ok(g2checks.passed, JSON.stringify(g2checks.checks))
+  })
+
+  console.log(`\n结果:${passed} 通过 / ${failed} 失败`)
+  if (failed > 0) process.exit(1)
+}
+
+main()

package/scripts/test-cli-exit.mjs

@@ -0,0 +1,235 @@
+/**
+ * CLI 退出码与 argv 解析回归测试（node 直跑,不启动服务器、不触发构建）:
+ *   node scripts/test-cli-exit.mjs
+ *
+ * 覆盖两类真实缺陷:
+ *   A. 退出码语义 —— 子进程被信号杀死时 close code === null,旧代码 `code ?? 0`
+ *      把「被 Ctrl+C 打断」报成成功;约定:被信号 N 终止 → 128 + N。
+ *   B. argv 剥离 —— 全局标志必须按「选项位」剥离,不能按字面量过滤,
+ *      否则值位上出现的同名 token 会被误删（值丢失 / 位置参数错位）。
+ *   C. 入口退出码 —— stdout/stderr 为管道且写入未 flush 时,顶层 await 下
+ *      Node 以 13 收场;入口必须显式 process.exit(code)。
+ *
+ * 子进程测试一律用 'inherit' stdio:父进程不持有子进程的管道句柄,
+ * 父侧事件循环保持干净,信号转发语义才可被确定性地观测。
+ */
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const root = resolve(here, '..')
+const AW = join(root, 'cli', 'aw.mjs')
+const LIFECYCLE = join(root, 'cli', 'core', 'child-lifecycle.mjs')
+
+let failures = 0
+let checks = 0
+const check = (name, cond, extra = '') => {
+  checks++
+  console.log(`${cond ? '  ✓' : '  ✗ FAIL'} ${name}${extra ? ` (${extra})` : ''}`)
+  if (!cond) failures++
+}
+
+/** 起一个 aw 子进程,回传 { code, signal, stdout, stderr } */
+function runAw(args, { timeoutMs = 30000 } = {}) {
+  return new Promise((resolveRun) => {
+    const child = spawn(process.execPath, [AW, ...args], {
+      cwd: root,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: { ...process.env, NO_COLOR: '1' },
+    })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', d => { stdout += d })
+    child.stderr.on('data', d => { stderr += d })
+    const timer = setTimeout(() => { try { child.kill('SIGKILL') } catch { /* ignore */ } }, timeoutMs)
+    child.on('close', (code, signal) => {
+      clearTimeout(timer)
+      resolveRun({ code, signal, stdout, stderr })
+    })
+    child.on('error', err => {
+      clearTimeout(timer)
+      resolveRun({ code: null, signal: null, stdout, stderr, error: err })
+    })
+  })
+}
+
+/** 测试替身子进程文件 */
+const TMP = {
+  sig: join(root, 'scripts', '_tmp-sig-child.mjs'),
+  stubborn: join(root, 'scripts', '_tmp-stubborn-child.mjs'),
+  marker: join(root, 'scripts', '_tmp-signal-marker.json'),
+}
+const cleanup = () => { for (const p of [TMP.sig, TMP.stubborn, TMP.marker]) rmSync(p, { force: true }) }
+process.on('exit', cleanup)
+
+console.log('[1] aw 入口退出码（缺陷 C:stdio 未 flush 导致 TLA 以 13 收场）')
+{
+  const help = await runAw(['--help'])
+  check('aw --help → 0（非 13）', help.code === 0, `code=${help.code} signal=${help.signal}`)
+  check('aw --help 退出码不是 13(ERR_UNSETTLED_TOP_LEVEL_AWAIT)', help.code !== 13, `code=${help.code}`)
+  check('aw --help 输出未被 process.exit 截断', help.stdout.includes('agentworkshop'), `len=${help.stdout.length}`)
+
+  const version = await runAw(['--version'])
+  check('aw --version → 0', version.code === 0, `code=${version.code}`)
+  check('aw --version 有版本号输出', /\d+\.\d+\.\d+/.test(version.stdout), `out=${version.stdout.trim()}`)
+
+  const noCmd = await runAw([])
+  check('aw（无指令）→ 2 用法错误', noCmd.code === 2, `code=${noCmd.code}`)
+
+  const bad = await runAw(['definitely-not-a-command'])
+  check('aw 未知指令 → 2', bad.code === 2, `code=${bad.code}`)
+
+  const cmdHelp = await runAw(['start', '--help'])
+  check('aw start --help → 0', cmdHelp.code === 0, `code=${cmdHelp.code}`)
+
+  const badSub = await runAw(['help', 'definitely-not-a-command'])
+  check('aw help <未知> → 2', badSub.code === 2, `code=${badSub.code}`)
+}
+
+console.log('[2] 全局标志剥离不吞掉值位同名 token（缺陷 B）')
+{
+  const { parseArgs, stripGlobals } = await import(pathToFileURL(join(root, 'cli', 'core', 'args.mjs')).href)
+  const GLOBALS = ['--json', '--debug']
+
+  // 关键回归:值位上的同名 token 必须留下
+  const u1 = stripGlobals(['--name', '--json'], GLOBALS)
+  check('值位 --json 保留（是 --name 的取值）', JSON.stringify(u1) === JSON.stringify(['--name']),
+    `got=${JSON.stringify(u1)}`)
+
+  const u2 = stripGlobals(['--title=--json'], GLOBALS)
+  check('等号值位 --json 保留', JSON.stringify(u2) === JSON.stringify(['--title=--json']),
+    `got=${JSON.stringify(u2)}`)
+
+  // 真正的全局选项必须被剥离
+  const u3 = stripGlobals(['--json', 'x'], GLOBALS)
+  check('选项位 --json 被剥离', JSON.stringify(u3) === JSON.stringify(['x']), `got=${JSON.stringify(u3)}`)
+
+  const u4 = stripGlobals(['--json', '--name', '--debug', 'v'], GLOBALS)
+  check('选项位剥离 + 值位保留共存', JSON.stringify(u4) === JSON.stringify(['--name', 'v']),
+    `got=${JSON.stringify(u4)}`)
+
+  const u5 = stripGlobals(['--', '--json'], GLOBALS)
+  check('-- 之后不剥离', JSON.stringify(u5) === JSON.stringify(['--', '--json']), `got=${JSON.stringify(u5)}`)
+
+  const u6 = stripGlobals(['--root', 'R', '--json'], GLOBALS)
+  check('带值全局项连同取值一起移除', JSON.stringify(u6) === JSON.stringify(['--json']),
+    `got=${JSON.stringify(u6)}`)
+
+  const u7 = stripGlobals(['--debug=1'], GLOBALS)
+  check('内联取值形式 --debug=1 整体移除', JSON.stringify(u7) === JSON.stringify([]), `got=${JSON.stringify(u7)}`)
+
+  // 旧实现（字面量过滤）确实会丢值 —— 缺陷复现对照
+  const oldWay = ['--name', '--json'].filter(a => a !== '--json' && a !== '--debug')
+  const oldFlags = parseArgs(oldWay).flags
+  check('旧字面量过滤确会丢值（缺陷复现）',
+    JSON.stringify(oldWay) === JSON.stringify(['--name']) && oldFlags.name === true && oldFlags.json === undefined,
+    `old=${JSON.stringify(oldWay)} flags=${JSON.stringify(oldFlags)}`)
+
+  // 修复后的调用约定:--name 取值位被 --json 占住时解析结果不同
+  const fixedFlags = parseArgs(['--name', '--json']).flags
+  check('按位置解析后 --json 不再是全局标志', fixedFlags.json === true && fixedFlags.name === true,
+    JSON.stringify(fixedFlags))
+}
+
+console.log('[3] 子进程生命周期:信号 → 退出码传播（缺陷 A）')
+{
+  const { runChild, signalExitCode, SHUTDOWN_GRACE_MS } = await import(pathToFileURL(LIFECYCLE).href)
+
+  check('signalExitCode(SIGINT) === 130', signalExitCode('SIGINT') === 130, `got=${signalExitCode('SIGINT')}`)
+  check('signalExitCode(SIGTERM) === 143', signalExitCode('SIGTERM') === 143)
+  check('signalExitCode(未知信号) === 1', signalExitCode('NOPE') === 1)
+  check('grace 默认 5000ms（对齐 stop.mjs）', SHUTDOWN_GRACE_MS === 5000)
+
+  // 正常退出:退出码原样透传(不能被污染成 128+)
+  const ok = await runChild(process.execPath, ['-e', 'process.exit(0)'], { stdio: 'inherit' })
+  check('正常退出 0 → 0', ok === 0, `got=${ok}`)
+  const seven = await runChild(process.execPath, ['-e', 'process.exit(7)'], { stdio: 'inherit' })
+  check('正常退出 7 → 7 原样透传', seven === 7, `got=${seven}`)
+
+  // spawn 失败 → 1（且不抛异常）
+  const enoent = await runChild(join(root, '__no_such_binary__'), [], { stdio: 'inherit' })
+  check('spawn ENOENT → 1', enoent === 1, `got=${enoent}`)
+
+  // 核心场景:信号转发 → 子进程被信号杀死 → 父得 128+N（旧代码 code ?? 0 → 0 误报成功）
+  writeFileSync(TMP.sig, 'setTimeout(() => {}, 60000)\n')
+  {
+    const p = runChild(process.execPath, [TMP.sig], { stdio: 'inherit', graceMs: 2000 })
+    setTimeout(() => process.emit('SIGTERM'), 250)
+    const code = await p
+    check('子进程被 SIGTERM 杀死 → 父得 143', code === 143, `got=${code}`)
+    check('不再出现 code ?? 0 的「假成功」', code !== 0, `got=${code}`)
+  }
+
+  // 强杀兜底:子进程忽略 SIGTERM → 宽限期后 SIGKILL,父仍非 0 且能返回
+  writeFileSync(TMP.stubborn, [
+    '// 忽略可捕获信号,只有 SIGKILL 能终止',
+    "process.on('SIGTERM', () => {})",
+    "process.on('SIGINT', () => {})",
+    'setTimeout(() => {}, 60000)',
+    '',
+  ].join('\n'))
+  {
+    const t0 = Date.now()
+    const p = runChild(process.execPath, [TMP.stubborn], { stdio: 'inherit', graceMs: 800 })
+    setTimeout(() => process.emit('SIGTERM'), 250)
+    const code = await p
+    const elapsed = Date.now() - t0
+    check('忽略 SIGTERM → 强杀兜底,父非 0 返回', code !== 0, `got=${code}`)
+    check('强杀在宽限期内发生（未挂死）', elapsed < 8000, `elapsed=${elapsed}ms`)
+  }
+
+  // 信号转发确实到达子进程（缺陷 A/2:子进程不再变孤儿）:
+  // 子进程收到 SIGTERM 后写标记文件,父进程排在后面的监听器据此断言。
+  writeFileSync(TMP.sig, [
+    "import { writeFileSync } from 'node:fs'",
+    `process.on('SIGTERM', () => { writeFileSync(${JSON.stringify(TMP.marker)}, JSON.stringify({ sig: 'SIGTERM' })); process.exit(0) })`,
+    "process.on('SIGINT', () => {})",
+    'setTimeout(() => {}, 60000)',
+    '',
+  ].join('\n'))
+  {
+    let forwarded = null
+    const observe = () => { forwarded = readFileSync(TMP.marker, 'utf8') }
+    process.on('SIGTERM', observe) // 注册在 runChild 之后 → 在 runChild 转发之后执行
+    try {
+      const p = runChild(process.execPath, [TMP.sig], { stdio: 'inherit', graceMs: 3000 })
+      setTimeout(() => process.emit('SIGTERM'), 300)
+      const code = await p
+      const sawSignal = forwarded !== null && String(forwarded).includes('SIGTERM')
+      check('SIGTERM 被转发至子进程（孤儿化已修复）', sawSignal, `marker=${forwarded}`)
+      check('子进程正常退出(0)后父透传 0', code === 0, `got=${code}`)
+    }
+    finally {
+      process.removeListener('SIGTERM', observe)
+    }
+  }
+
+  // 转发后必须摘掉监听器,不能泄漏到进程级
+  const before = process.listenerCount('SIGINT') + process.listenerCount('SIGTERM')
+  await runChild(process.execPath, ['-e', 'process.exit(0)'], { stdio: 'inherit' })
+  const afterCount = process.listenerCount('SIGINT') + process.listenerCount('SIGTERM')
+  check('退出后不泄漏信号监听器', afterCount === before, `before=${before} after=${afterCount}`)
+}
+
+console.log('[4] start / dev / build 已接入统一生命周期（静态断言）')
+{
+  for (const f of ['start.mjs', 'dev.mjs', 'build.mjs']) {
+    const src = readFileSync(join(root, 'cli', 'commands', f), 'utf8')
+    check(`${f} 复用 runChild`, src.includes("from '../core/child-lifecycle.mjs'") && src.includes('runChild('))
+    check(`${f} 不再有 'code ?? 0' 误报`, !src.includes('code ?? 0'))
+    check(`${f} 不再自建 SIGINT handler（统一收敛）`, !src.includes("process.on('SIGINT'"))
+  }
+  const buildSrc = readFileSync(join(root, 'cli', 'commands', 'build.mjs'), 'utf8')
+  check('build.mjs 已转发信号（Ctrl+C 不再产生孤儿 nuxt）', buildSrc.includes('runChild(process.execPath'))
+  const awSrc = readFileSync(AW, 'utf8')
+  check('aw.mjs 入口改用 process.exit(code)', awSrc.includes('process.exit(await main())'))
+  check('aw.mjs 不再用 exitCode = await main()', !awSrc.includes('process.exitCode = await main()'))
+}
+
+console.log(`\n${failures === 0 ? '✔ 全部通过' : '✖ 存在失败'} : ${checks - failures}/${checks}`)
+if (failures > 0) {
+  console.log(`失败 ${failures} 项`)
+  process.exitCode = 1
+}