agentworkshop 0.7.39 → 0.7.40

package/scripts/capture-walkthrough.mjs

@@ -0,0 +1,232 @@
+/**
+ * Canonical walkthrough-figure capture. High-DPI (3x), element/row-accurate crops
+ * of the four operational stages on a live AgentWorkShop instance.
+ *
+ * The shared production instance carries Chinese-named test data, so the four
+ * screenshots are taken against the small ENGLISH fixture created by
+ * scripts/seed-walkthrough-fixture.mjs (line "Cast-film line A", English DAQ
+ * nodes, an English agent team). The UI is forced to the `en` locale (persisted
+ * in localStorage under `aw.locale`, applied by app/plugins/locale-restore.client.ts)
+ * before any capture, so every UI string is English.
+ *
+ * Geometry discipline: every crop is ≤470 CSS px wide (12 px UI text must print
+ * ≥ ~6.4 pt at the ~88 mm panel width of the 181 mm figure), except panel 2 whose
+ * four table columns cannot fit narrower.
+ *
+ * Usage:
+ *   NO_PROXY='127.0.0.1,localhost' node scripts/seed-walkthrough-fixture.mjs
+ *   NO_PROXY='127.0.0.1,localhost' AW_BASE=http://127.0.0.1:3005 node scripts/capture-walkthrough.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3005'
+const OUT = process.env.AW_OUT ?? 'paper/tii/figures/walkthrough'
+fs.mkdirSync(OUT, { recursive: true })
+
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const tok = async (e, p) => {
+  const r = await (await fetch(`${BASE}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: e, password: p }) })).json()
+  if (!r.data?.token) throw new Error(`login failed: ${e} (${JSON.stringify(r).slice(0, 120)})`)
+  return r.data.token
+}
+const ADMIN = await tok('admin@awshop.local', 'admin123')
+
+const jget = async (u) => {
+  const r = await (await fetch(`${BASE}${u}`, { headers: { Authorization: `Bearer ${ADMIN}` } })).json()
+  return r.data
+}
+
+// ── fixture discovery (fail loudly rather than silently capturing Chinese) ──
+const LINES = (await jget('/api/workshop/dcw/lines')).lines
+const LINE = LINES.find(l => l.name === 'Cast-film line A')
+if (!LINE) throw new Error('English fixture line "Cast-film line A" missing — run scripts/seed-walkthrough-fixture.mjs first')
+const DAQ = await jget('/api/workshop/daq')
+const modbusNode = DAQ.nodes.find(n => n.lineId === LINE.id && n.driver === 'modbus-tcp')
+if (!modbusNode) throw new Error('fixture Modbus-TCP node missing on Cast-film line A')
+// panel 4 uses the real judged optimization records already on the ledger of this node
+const RECORD_LINE = 'ln-af002514'
+const RECORD_NODE = 'dw-322b1978'
+console.log(`fixture line=${LINE.id}  modbus=${modbusNode.id} (${modbusNode.name})  records=${RECORD_NODE}`)
+
+const browser = await puppeteer.launch({
+  executablePath: process.env.AW_CHROME ?? 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu', '--proxy-server=direct://', '--proxy-bypass-list=*'],
+})
+const page = await browser.newPage()
+const errs = []
+page.on('pageerror', e => errs.push(String(e).slice(0, 120)))
+await page.setViewport({ width: 1680, height: 1600, deviceScaleFactor: 3 })
+
+const auth = async (t) => { const c = await page.target().createCDPSession(); await c.send('Network.clearBrowserCookies'); await page.setCookie({ name: 'token', value: t, domain: '127.0.0.1', path: '/' }) }
+const goto = async (u, w = 10000) => { await page.goto(`${BASE}${u}`, { waitUntil: 'domcontentloaded', timeout: 90_000 }); await sleep(w) }
+
+// content-visibility:auto sections report estimated rects until rendered; force real
+// layout so element-accurate clips do not drift. Also kill CSS transitions/animations
+// so a mid-transition frame (e.g. the hold-interval cell double-painting its value)
+// can never be captured.
+const settle = async () => {
+  await page.evaluate(() => {
+    let st = document.getElementById('aw-capture-calm')
+    if (!st) {
+      st = document.createElement('style')
+      st.id = 'aw-capture-calm'
+      st.textContent = '*,*::before,*::after{transition:none!important;transition-duration:0s!important;animation:none!important;animation-duration:0s!important;animation-delay:0s!important}'
+      document.head.appendChild(st)
+    }
+    for (const e of document.querySelectorAll('*')) {
+      const cs = getComputedStyle(e)
+      if (cs.contentVisibility && cs.contentVisibility !== 'visible') e.style.contentVisibility = 'visible'
+    }
+    window.scrollTo(0, document.body.scrollHeight)
+  })
+  await sleep(700)
+  await page.evaluate(() => window.scrollTo(0, 0))
+  await sleep(300)
+}
+
+// Grow the viewport to the full document height BEFORE measuring, so that the
+// screenshot's captureBeyondViewport expansion cannot re-layout the page and
+// shift elements between measurement and capture.
+const expand = async () => {
+  const h = await page.evaluate(() => document.documentElement.scrollHeight)
+  await page.setViewport({ width: 1680, height: Math.min(Math.ceil(h) + 40, 14000), deviceScaleFactor: 3 })
+  await sleep(1200)
+  await settle()
+}
+
+const repaint = async () => {
+  await page.evaluate(() => new Promise(res => {
+    window.scrollTo(0, 0)
+    requestAnimationFrame(() => requestAnimationFrame(res))
+  }))
+  await sleep(120)
+}
+
+// Capture only once the pixels stop changing: two consecutive identical captures are
+// required (guards against mid-transition / late-commit frames like double-struck text).
+const shot = async (n, x, y, w, h, tries = 5) => {
+  const clip = { x, y, width: w, height: h }
+  let prev = null
+  let stable = false
+  for (let i = 0; i < tries; i++) {
+    await repaint()
+    const buf = Buffer.from(await page.screenshot({ encoding: 'binary', clip, captureBeyondViewport: true }))
+    if (prev && Buffer.compare(prev, buf) === 0) { prev = buf; stable = true; break }
+    prev = buf
+    await sleep(1000)
+  }
+  fs.writeFileSync(path.join(OUT, n), prev)
+  console.log(`  ✓ ${n}  ${Math.round(w)}x${Math.round(h)} css @3x  ${stable ? 'stable' : 'NOT STABLE (last frame written)'}`)
+}
+
+// ── force English UI before any capture ──────────────────────────────────
+await auth(ADMIN)
+await goto('/daq', 4000)
+await page.evaluate(() => localStorage.setItem('aw.locale', 'en'))
+await page.reload({ waitUntil: 'domcontentloaded' })
+await sleep(6000)
+const heads = await page.evaluate(() => [...document.querySelectorAll('.nodes-table thead th')].map(t => t.textContent.trim()))
+if (!heads.some(h => /Sampling/i.test(h))) throw new Error(`locale not English (headers: ${JSON.stringify(heads)})`)
+console.log(`locale  : en (headers: ${heads.join(' | ')})`)
+
+// ══ ① provision & connect — /daq nodes filtered to the English line ══════
+console.log('\n== ① /daq ==')
+await page.evaluate((ln) => {
+  for (const s of document.querySelectorAll('select')) {
+    if ([...s.options].some(o => o.value === ln)) { s.value = ln; s.dispatchEvent(new Event('change', { bubbles: true })); break }
+  }
+}, LINE.id)
+await sleep(3500)
+await settle()
+await expand()
+
+const G = await page.evaluate(() => {
+  const tbl = document.querySelector('.nodes-table')
+  const rect = tbl.getBoundingClientRect()
+  const ths = [...tbl.querySelectorAll('thead th')].map(t => ({ x: Math.round(t.getBoundingClientRect().x - rect.x), text: t.textContent.trim() }))
+  const rows = [...tbl.querySelectorAll('tbody tr')].map((tr) => {
+    const q = tr.getBoundingClientRect()
+    const tds = tr.querySelectorAll('td')
+    return { y: Math.round(q.y + window.scrollY), h: q.height, name: (tr.querySelector('b')?.textContent || '').trim(), driver: (tds[6]?.textContent || '').trim() }
+  })
+  return { x: rect.x, ths, rows }
+})
+console.log('  rows:', G.rows.map(r => `${r.name}[${r.driver}]`).join(', '))
+if (!G.rows.some(r => r.driver.includes('modbus'))) throw new Error('no Modbus-TCP row visible on filtered line')
+// columns: 4 Sampling · 5 WS Publish · 6 Driver · 7 Line (indices are locale-stable).
+// Keep the crop ≤470 css px: 12 px UI text must print ≥ ~6.4 pt at the 88 mm panel width.
+const mbIdx = G.rows.findIndex(r => r.driver.includes('modbus'))
+const mkIdx = mbIdx > 0 ? mbIdx - 1 : 0
+const x0 = G.x + G.ths[4].x
+const x1 = G.x + G.ths[8].x
+const yS = G.rows[mkIdx].y
+const yE = G.rows[mbIdx].y + G.rows[mbIdx].h
+console.log(`  pair: ${G.rows[mkIdx].name}[${G.rows[mkIdx].driver}] + ${G.rows[mbIdx].name}[${G.rows[mbIdx].driver}]`)
+await shot('p1-driver.png', x0 - 2, yS, Math.min(x1 - x0 + 4, 470), yE - yS)
+
+// ══ ② bind node → line / device — /dcw/{English line} ═══════════════════
+console.log('\n== ② /dcw/' + LINE.id + ' ==')
+await goto(`/dcw/${LINE.id}`, 9000)
+await settle()
+await expand()
+const D = await page.evaluate(() => {
+  const t = document.querySelector('.aw-tile.table-card table')
+  const rect = t.getBoundingClientRect()
+  const ths = [...t.querySelectorAll('thead th')].map(x => ({ x: Math.round(x.getBoundingClientRect().x - rect.x), text: x.textContent.trim() }))
+  return { x: rect.x, y: rect.y + window.scrollY, h: rect.height, ths }
+})
+console.log('  cols:', D.ths.map(c => c.text).join(' | '))
+// columns: 5 Setpoint · 6 Process Range · 7 Hold Interval · 8 Bound Device
+const c0 = D.x + D.ths[5].x
+const c1 = D.x + D.ths[9].x
+await shot('p2-binding.png', c0 - 6, D.y, (c1 - c0) + 12, D.h)
+
+// ══ ④ governed closed loop — ledger optimization records (real, judged) ══
+console.log('\n== ④ /dcw/' + RECORD_LINE + ' ledger ==')
+await goto(`/dcw/${RECORD_LINE}`, 9000)
+await page.evaluate((nid) => {
+  const s = document.querySelector('.ledger-card select.inp')
+  if (!s) return
+  s.value = nid
+  s.dispatchEvent(new Event('change', { bubbles: true }))
+}, RECORD_NODE)
+await sleep(3500)
+await settle()
+await expand()
+const L = await page.evaluate(() => {
+  const card = document.querySelector('.ledger-card')
+  const col = [...card.querySelectorAll('.ledger-col')].find(c => c.querySelector('li.ledger-rec')) || [...card.querySelectorAll('.ledger-col')].pop()
+  const recs = [...col.querySelectorAll('li.ledger-rec')]
+  const r = col.getBoundingClientRect()
+  const last = recs[recs.length - 1].getBoundingClientRect()
+  return { x: r.x, y: r.y + window.scrollY, w: r.width, h: last.bottom - r.top, texts: recs.map(li => li.textContent.replace(/\s+/g, ' ').trim()) }
+})
+console.log('  records:', JSON.stringify(L.texts))
+// tight: header + the real records, without the empty box below them
+await shot('p4-records.png', L.x - 5, L.y - 5, Math.min(L.w + 14, 470), L.h + 14)
+
+// ══ ③ compose & deploy the agent team — /workshop/teams ═════════════════
+// Desktop viewport: one card in the multi-column grid (~343 px wide), which keeps the
+// crop ≤470 css px so member text prints ≥ ~6 pt at the 88 mm panel width.
+console.log('\n== ③ /workshop/teams ==')
+await page.setViewport({ width: 1680, height: 1600, deviceScaleFactor: 3 })
+await goto('/workshop/teams', 9000)
+await settle()
+await expand()
+const cards = await page.evaluate(() => [...document.querySelectorAll('.grid .card')].map(e => {
+  const r = e.getBoundingClientRect()
+  const members = e.querySelectorAll('.member')
+  const last = members[members.length - 1]?.getBoundingClientRect()
+  return { x: Math.round(r.x), y: Math.round(r.y + window.scrollY), w: Math.round(r.width), h: Math.round(r.height), memberH: last ? Math.round(last.bottom - r.top) : Math.round(r.height), t: e.textContent.replace(/\s+/g, ' ').slice(0, 40) }
+}))
+console.log('  cards:', JSON.stringify(cards))
+const tgt = cards.find(c => c.t.includes('Cast-film control team'))
+if (!tgt) throw new Error('English team card not found on /workshop/teams')
+// crop head + member rows only (excludes the Add-Member button) to keep the figure compact
+await shot('p3-team.png', tgt.x - 5, tgt.y - 5, Math.min(tgt.w + 10, 470), tgt.memberH + 8)
+
+console.log('\npageerrors:', errs.length ? errs.join(' | ') : 'none')
+await browser.close()

package/scripts/render-walkthrough-figure.mjs

@@ -0,0 +1,46 @@
+/**
+ * Render the walkthrough figure HTML to (a) an exact-size PDF via headless Chrome
+ * --print-to-pdf and (b) a high-resolution PNG for inspection/archival.
+ *
+ * Usage: node scripts/render-walkthrough-figure.mjs
+ */
+import { execFileSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import puppeteer from 'puppeteer-core'
+
+const CHROME = process.env.AW_CHROME ?? 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+const DIR = path.resolve('paper/tii/figures/walkthrough')
+const SRC = path.join(DIR, 'fig-walkthrough.html')
+if (!fs.existsSync(SRC)) throw new Error('missing ' + SRC)
+
+// ── (a) exact-size PDF ────────────────────────────────────────────────────
+const pdfUrl = 'file:///' + SRC.replace(/\\/g, '/')
+const outPdf = path.resolve('paper/tii/figures/pdf/fig-walkthrough.pdf')
+fs.mkdirSync(path.dirname(outPdf), { recursive: true })
+execFileSync(CHROME, [
+  '--headless=new', '--disable-gpu', '--no-pdf-header-footer',
+  `--print-to-pdf=${outPdf}`, pdfUrl,
+], { stdio: 'ignore' })
+const info = execFileSync('pdfinfo', [outPdf], { encoding: 'utf8' })
+console.log('PDF  :', outPdf)
+console.log('     ', info.split('\n').filter(l => /Page size|Pages/.test(l)).join(' | ').trim())
+
+// ── (b) high-resolution PNG (overall + per-panel) ─────────────────────────
+const browser = await puppeteer.launch({ executablePath: CHROME, headless: 'new', args: ['--no-sandbox', '--disable-gpu', '--allow-file-access-from-files'] })
+const page = await browser.newPage()
+// 181 mm wide at 96 dpi/css == 684 css px; height is a minimum — fullPage grows to content
+await page.setViewport({ width: 684, height: 200, deviceScaleFactor: 8 })
+await page.goto(pdfUrl, { waitUntil: 'networkidle0' })
+await page.evaluate(() => document.fonts?.ready)
+await new Promise(r => setTimeout(r, 500))
+await page.screenshot({ path: path.join(DIR, 'fig-walkthrough.png'), fullPage: true })
+const png = fs.statSync(path.join(DIR, 'fig-walkthrough.png'))
+console.log('PNG  :', path.join(DIR, 'fig-walkthrough.png'), `${(png.size / 1024).toFixed(0)} KB`)
+
+// medium-res variant for quick review
+await page.setViewport({ width: 684, height: 200, deviceScaleFactor: 2 })
+await page.screenshot({ path: path.join(DIR, '_preview.png'), fullPage: true })
+console.log('PREV :', path.join(DIR, '_preview.png'))
+
+await browser.close()

package/scripts/seed-walkthrough-fixture.mjs

@@ -0,0 +1,143 @@
+/**
+ * Purpose-built ENGLISH-locale fixture for the IEEE TII Figure 2 walkthrough.
+ *
+ * The shared production instance is full of Chinese-named test data; we must NOT
+ * rename or delete anything. Instead this script creates a small additive fixture
+ * with English entity names via the platform's own REST API, so the four
+ * walkthrough screenshots contain English strings only:
+ *
+ *   - line      "Cast-film line A"
+ *   - DAQ nodes  mock + a real Modbus-TCP node on the PLC simulator, one line
+ *   - device     "Die-head heater" twin, bound by a DCW node with a 150-200 C window
+ *   - agents     English lead + workers on the `omp` harness
+ *   - team       "Cast-film control team" (lead + 2 workers)
+ *
+ * Idempotent: re-running reuses rows with the same names. Prints a JSON summary.
+ *
+ * Usage: NO_PROXY='127.0.0.1,localhost' node scripts/seed-walkthrough-fixture.mjs
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3005'
+
+const login = async (e, p) =>
+  (await (await fetch(`${BASE}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: e, password: p }) })).json()).data.token
+
+const T = await login('admin@awshop.local', 'admin123')
+
+const api = async (method, path, body) => {
+  const r = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { Authorization: `Bearer ${T}`, ...(body ? { 'content-type': 'application/json' } : {}) },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const j = await r.json().catch(() => ({}))
+  if (!r.ok || j.code !== 0) throw new Error(`${method} ${path} -> ${r.status} ${JSON.stringify(j).slice(0, 200)}`)
+  return j.data
+}
+const get = p => api('GET', p)
+const post = (p, b) => api('POST', p, b)
+
+// ── 1. production line ────────────────────────────────────────────────────
+const LINE_NAME = 'Cast-film line A'
+const lines = (await get('/api/workshop/dcw/lines')).lines
+let line = lines.find(l => l.name === LINE_NAME)
+if (!line) line = (await post('/api/workshop/dcw/lines', { name: LINE_NAME, color: '#f4c542' })).line
+console.log(`line    : ${line.id}  ${line.name}`)
+
+// ── 2. DAQ nodes on that line (mock + real Modbus-TCP share one loop) ─────
+const daq = await get('/api/workshop/daq')
+const haveNode = n => daq.nodes.find(x => x.name === n)
+const mkNode = async (spec) => {
+  const existing = haveNode(spec.name)
+  if (existing) return existing
+  return (await post('/api/workshop/daq', { enabled: true, intervalMs: 1000, lineId: line.id, ...spec })).node
+}
+
+const nTemp = await mkNode({
+  name: 'Melt temperature', templateRef: 'daq-temp-tc', driver: 'mock',
+  unit: '\u00B0C', decimals: 1, min: 150, max: 200, warnLow: 155, warnHigh: 195,
+})
+const nSpeed = await mkNode({
+  name: 'Line speed', templateRef: 'daq-line-encoder', driver: 'mock',
+  unit: 'm/min', decimals: 0, min: 280, max: 360, warnLow: 290, warnHigh: 350,
+})
+const nPress = await mkNode({
+  name: 'Melt pressure', templateRef: 'daq-pressure-tx', driver: 'mock',
+  unit: 'MPa', decimals: 2, min: 0.6, max: 1.2, warnLow: 0.65, warnHigh: 1.15,
+})
+// real Modbus-TCP against the PLC simulator's "extruder" slave (melt-temp @ 40001)
+const nModbus = await mkNode({
+  name: 'Die-head temperature', templateRef: 'daq-temp-tc', driver: 'modbus-tcp',
+  unit: '\u00B0C', decimals: 2, min: 0, max: 400, warnLow: 150, warnHigh: 260,
+  driverConfig: { host: '127.0.0.1', port: 16040, unitId: 1, register: 40001, dataType: 'float32', byteOrder: 'big' },
+})
+console.log(`daq     : temp=${nTemp.id} speed=${nSpeed.id} pressure=${nPress.id} modbus=${nModbus.id}`)
+
+// ── 3. device twin + DCW control node with a recipe window ────────────────
+const twins = (await get('/api/workshop/device-twins')).twins
+let twin = twins.find(t => t.name === 'Die-head heater')
+if (!twin) twin = (await post('/api/workshop/device-twins', { name: 'Die-head heater', kind: 'device', controls: ['setpoint'] })).twin
+console.log(`twin    : ${twin.id}  ${twin.name}`)
+
+const dcw = await get('/api/workshop/dcw')
+let dcwNode = dcw.nodes.find(n => n.name === 'Die-head setpoint')
+if (!dcwNode) {
+  dcwNode = (await post('/api/workshop/dcw', {
+    name: 'Die-head setpoint', templateRef: 'dcw-temp-sp', driver: 'mock',
+    unit: '\u00B0C', decimals: 1, min: 150, max: 200,
+    holdIntervalMs: 5000, readIntervalMs: 5000, enabled: true,
+    lineId: line.id, deviceIds: [twin.id],
+  })).node
+}
+console.log(`dcw     : ${dcwNode.id}  ${dcwNode.name}  bound=${twin.id}  window=${dcwNode.min}-${dcwNode.max}`)
+
+// ── 4. English agents + team (one lead, harness-backed workers) ───────────
+const teams0 = await get('/api/workshop/teams')
+let team = teams0.find(t => t.name === 'Cast-film control team')
+if (!team) team = await post('/api/workshop/teams', { name: 'Cast-film control team', description: 'Cast-film process lead plus DAQ and modelling workers.', visibility: 'public' })
+
+const teamId = team.id
+const existingTeam = (await get('/api/workshop/teams')).find(t => t.id === teamId)
+const memberNames = new Set((existingTeam?.members ?? []).map(m => m.name))
+
+const AGENTS = [
+  { name: 'Cast-film process lead', harness: 'omp', role: 'lead' },
+  { name: 'DAQ engineer', harness: 'omp', role: 'worker' },
+  { name: 'Model trainer', harness: 'omp', role: 'worker' },
+]
+for (const a of AGENTS) {
+  if (memberNames.has(a.name)) continue
+  const agent = await post('/api/workshop/agents', { name: a.name, harness: a.harness, visibility: 'public' })
+  await post(`/api/workshop/teams/${teamId}/members`, { agentId: agent.id, role: a.role })
+}
+const finalTeam = (await get('/api/workshop/teams')).find(t => t.id === teamId)
+console.log(`team    : ${teamId}  ${finalTeam.name}  members=${(finalTeam.members ?? []).map(m => `${m.role}:${m.name}:${m.harness}`).join(', ')}`)
+
+// ── 5. start the line so DAQ acquisition is genuinely live ────────────────
+// DAQ sampling is gated on an active per-line batch (recipe run). Without a run
+// the nodes report `offline` and the panel-1 claim "share one acquisition loop"
+// would be untrue. Create a product + recipe carrying one setpoint param and
+// start the line; idempotent via the line's active-run flag.
+const lineStates = (await get('/api/workshop/dcw/lines')).states
+const alreadyRunning = lineStates.find(s => s.lineId === line.id && s.active)
+if (alreadyRunning) {
+  console.log(`run     : already active ${alreadyRunning.runId}`)
+}
+else {
+  const dcwState = await get('/api/workshop/dcw')
+  let product = (dcwState.products ?? []).find(p => p.name === 'Cast-film roll')
+  if (!product) product = (await post('/api/workshop/dcw/products', { name: 'Cast-film roll', lineId: line.id })).product
+  let recipe = (dcwState.recipes ?? []).find(r => r.name === 'Cast-film recipe' && r.lineId === line.id)
+  if (!recipe) {
+    recipe = (await post('/api/workshop/dcw/recipes', {
+      productId: product.id,
+      name: 'Cast-film recipe',
+      description: 'Cast-film line A baseline recipe.',
+      params: [{ nodeId: dcwNode.id, value: 178, min: 150, max: 200 }],
+      daqWindows: [{ nodeId: nTemp.id, min: 150, max: 200 }],
+    })).recipe
+  }
+  await post(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: recipe.id })
+  console.log(`run     : started with recipe ${recipe.id} (${recipe.name})`)
+}
+
+console.log('\nFIXTURE ' + JSON.stringify({ lineId: line.id, lineName: line.name, modbusNodeId: nModbus.id, dcwNodeId: dcwNode.id, twinId: twin.id, teamId }))

package/scripts/test-plugin-hardening.mjs

@@ -60,6 +60,14 @@ console.log('\n━━━ 3. 稳定性护栏的严重性判定(哪类异常不该
   check('undici UND_ERR_CONNECT_TIMEOUT → upstream', classifyFatalCandidate(err('UND_ERR_CONNECT_TIMEOUT')) === 'upstream')
   check('无 code 但 message 带 ECONNREFUSED → upstream',
     classifyFatalCandidate(new Error('connect ECONNREFUSED 127.0.0.1:1502')) === 'upstream')
+  // 实测事故 2:工业驱动库(Modbus/OPC UA 客户端)超时时只给可读 message、不带 errno code,
+  // 旧实现据此判 fatal → 生产实例运行中 exit 1(平台带着数采/数控一起挂掉)。
+  check('无 code,message "TCP Connection Timed Out" → upstream',
+    classifyFatalCandidate(new Error('TCP Connection Timed Out')) === 'upstream')
+  check('无 code,message "connection timed out" → upstream',
+    classifyFatalCandidate(new Error('connect error: connection timed out')) === 'upstream')
+  check('无 code,message "socket hang up" → upstream',
+    classifyFatalCandidate(new Error('socket hang up')) === 'upstream')
 
   // 其余既有分级不得回退
   check('ECONNRESET(客户端硬断)→ socket', classifyFatalCandidate(err('ECONNRESET')) === 'socket')

package/scripts/ui/admin-shots.mjs

@@ -0,0 +1,46 @@
+/**
+ * 以 **admin 账号** 登录并给数采 / 数控 / 数字孪生出图。
+ * 与 lib.mjs 的视觉走查账号(visual)区分:admin 是文档里写的管理员账号,
+ * 能看见全量节点与全部产线;演示工作区由 scripts/ui/seed-admin.mjs 准备。
+ */
+import { launch, openPage, gotoReady } from './lib.mjs'
+import fs from 'node:fs'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3021'
+const OUT = process.env.AW_OUT ?? '.e2e-shots/admin'
+fs.mkdirSync(OUT, { recursive: true })
+
+const loginRes = await fetch(BASE + '/api/users/login', {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }),
+})
+const login = await loginRes.json()
+if (login.code !== 0) throw new Error('admin 登录失败: ' + JSON.stringify(login).slice(0, 200))
+const token = login.data.token
+console.log('登录成功:', login.data.user.name, '(' + login.data.user.role + ')')
+
+const browser = await launch()
+const routes = [
+  { path: '/', name: '01-dashboard', wait: 9000 },
+  { path: '/daq', name: '02-daq', wait: 12000 },
+  { path: '/dcw', name: '03-dcw', wait: 9000 },
+  { path: '/town', name: '04-town', wait: 16000 },
+  { path: '/monitor', name: '05-monitor', wait: 7000 },
+]
+for (const r of routes) {
+  const page = await openPage(browser, { token, dark: true, width: 1440, height: 900, deviceScaleFactor: 2 })
+  const errs = []
+  page.on('pageerror', e => errs.push(String(e.message).slice(0, 120)))
+  await gotoReady(page, r.path, { wait: r.wait })
+  const file = OUT + '/' + r.name + '.png'
+  await page.screenshot({ path: file })
+  const info = await page.evaluate(() => ({
+    nodes: document.querySelectorAll('*').length,
+    text: document.body.innerText.replace(/\s+/g, ' ').slice(0, 120),
+  }))
+  console.log('  ok ' + r.name.padEnd(16) + ' dom=' + String(info.nodes).padStart(6) + ' errs=' + errs.length)
+  await page.close()
+}
+await browser.close()
+console.log('->', OUT)