agentworkshop 0.7.27 → 0.7.33

package/scripts/_audit/diag-cwd2.ts

@@ -0,0 +1,19 @@
+import { existsSync, readdirSync, statSync } from 'node:fs'
+import path from 'node:path'
+
+process.chdir(new URL('./.tmp/', import.meta.url).pathname.replace(/^\//, ''))
+console.log('[diag2] cwd =', process.cwd())
+console.log('[diag2] dir listing =', readdirSync(path.join(process.cwd(), 'server', 'data')))
+const guess = path.join(process.cwd(), 'server', 'data', 'dcw-rollback.json')
+console.log('[diag2] guessed ROLLBACK_PATH exists =', existsSync(guess))
+
+const mod = await import('../../server/services/workshop/dcw/recipe-rollback.repo')
+const repo = new mod.RecipeRollBackRepo()
+const first = repo.listAnchors({ limit: 2 })
+const last = repo.listAnchors({ limit: 2 })
+console.log('[diag2] stats =', JSON.stringify(repo.stats()))
+console.log('[diag2] first anchors =', JSON.stringify(first.map(a => ({ id: a.id, at: a.at, node: a.nodeId }))))
+console.log('[diag2] exists after import =', existsSync(guess), existsSync(guess) ? statSync(guess).size : 0)
+console.log('[diag2] dir listing after import =', readdirSync(path.join(process.cwd(), 'server', 'data')))
+const repo2 = new mod.RecipeRollBackRepo()
+console.log('[diag2] second instance stats =', JSON.stringify(repo2.stats()))

package/scripts/_audit/exp-cost-scaling.mjs

@@ -0,0 +1,54 @@
+/**
+ * 审计实验 2:
+ *  A. SQLite 保留期批量 DELETE 的耗时随表规模线性增长(全扫 → 每批一次全扫)
+ *  B. InProcQueueAdapter.publish 溢出时 queue.shift() 的 O(n) 代价(10k 容量)
+ * 运行:node scripts/_audit/exp-cost-scaling.mjs
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+// ---------- A ----------
+function build(nodes, perNode) {
+  const dir = mkdtempSync(join(tmpdir(), 'daq-audit-'))
+  const db = new DatabaseSync(join(dir, 'ts.sqlite'))
+  db.exec('PRAGMA journal_mode = WAL')
+  db.exec(`CREATE TABLE daq_samples (node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, value REAL NOT NULL,
+    state TEXT NOT NULL DEFAULT 'ok', line_id TEXT, product_id TEXT, recipe_id TEXT, run_id TEXT,
+    PRIMARY KEY (node_id, ts_ms));
+    CREATE INDEX idx_daq_node_ts ON daq_samples (node_id, ts_ms DESC);`)
+  const ins = db.prepare('INSERT OR IGNORE INTO daq_samples (node_id, ts_ms, value) VALUES (?,?,?)')
+  const now = Date.now()
+  db.exec('BEGIN')
+  for (let n = 0; n < nodes; n++) for (let i = 0; i < perNode; i++) ins.run(`dn-${n}`, now - i * 1000, i)
+  db.exec('COMMIT')
+  return { db, now }
+}
+
+const DEL = 'DELETE FROM daq_samples WHERE rowid IN (SELECT rowid FROM daq_samples WHERE ts_ms < ? LIMIT 5000)'
+for (const [nodes, perNode] of [[1, 50_000], [10, 50_000], [40, 50_000]]) {
+  const { db, now } = build(nodes, perNode)
+  const rows = db.prepare('SELECT COUNT(*) AS c FROM daq_samples').get().c
+  const cutoff = now - 3600_000 // 1h 保留
+  const t0 = performance.now()
+  const r = db.prepare(DEL).run(cutoff)
+  const ms = performance.now() - t0
+  console.log(`A: rows=${String(rows).padStart(8)}  one 5000-row batch DELETE = ${ms.toFixed(1)}ms  (deleted ${r.changes})`)
+  db.close()
+}
+
+// ---------- B ----------
+const QUEUE_CAP = 10_000
+const q = []
+let dropped = 0
+const t1 = performance.now()
+for (let i = 0; i < 200_000; i++) {
+  if (q.length >= QUEUE_CAP) { q.shift(); dropped++ } // inproc.adapter.ts:35
+  q.push({ nodeId: 'n', value: i })
+}
+console.log(`B: 200k publish into cap-${QUEUE_CAP} inproc queue = ${(performance.now() - t1).toFixed(1)}ms (dropped ${dropped})`)
+const q2 = []
+const t2 = performance.now()
+for (let i = 0; i < 200_000; i++) if (q2.length < QUEUE_CAP) q2.push(i)
+console.log(`B: same loop without shift (push-only baseline) = ${(performance.now() - t2).toFixed(1)}ms`)

package/scripts/_audit/exp-envelope-and-png.mjs

@@ -0,0 +1,77 @@
+/**
+ * 审计实验 4:
+ *  A. 队列信封未校验:NaN(坏 at)/字符串 value 落 SQLite 的后果(整批事务是否被毒化)
+ *  B. mock ccd-image 帧的 PNG 体积(评估对象存储无删除策略的增长速率)
+ * 运行:node scripts/_audit/exp-envelope-and-png.mjs
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { deflateSync } from 'node:zlib'
+
+// ---------- A ----------
+const db = new DatabaseSync(':memory:')
+db.exec(`CREATE TABLE daq_samples (node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, value REAL NOT NULL,
+  state TEXT NOT NULL DEFAULT 'ok', line_id TEXT, product_id TEXT, recipe_id TEXT, run_id TEXT,
+  PRIMARY KEY (node_id, ts_ms));`)
+const ins = db.prepare('INSERT OR IGNORE INTO daq_samples (node_id, ts_ms, value, state, line_id, product_id, recipe_id, run_id) VALUES (?,?,?,?,?,?,?,?)')
+
+console.log('--- A1: tsMs = NaN (Date.parse("garbage")) ---')
+try {
+  db.exec('BEGIN')
+  ins.run('dn-a', Date.parse('garbage'), 1.5, 'ok', null, null, null, null)
+  ins.run('dn-b', Date.now(), 2.5, 'ok', null, null, null, null)
+  db.exec('COMMIT')
+  console.log('  batch COMMITTED — rows:', db.prepare('SELECT COUNT(*) c FROM daq_samples').get().c)
+}
+catch (err) {
+  console.log('  batch FAILED (whole transaction rolls back):', err.message)
+  try { db.exec('ROLLBACK') } catch {}
+  console.log('  rows after failure:', db.prepare('SELECT COUNT(*) c FROM daq_samples').get().c)
+}
+
+console.log('--- A2: value = "abc" (string) into REAL NOT NULL ---')
+try {
+  ins.run('dn-c', Date.now() + 1, 'abc', 'ok', null, null, null, null)
+  const row = db.prepare('SELECT value, typeof(value) t FROM daq_samples WHERE node_id = ?').get('dn-c')
+  console.log(`  stored value=${JSON.stringify(row.value)} sqlite typeof=${row.t}`)
+}
+catch (err) { console.log('  rejected:', err.message) }
+
+console.log('--- A3: Date.parse(NaN 分支) 对乱序防御的影响 ---')
+let lastIngestAt = 0
+const ts = Date.parse('garbage')
+if (ts && ts <= lastIngestAt) console.log('  late'); else { lastIngestAt = ts; console.log(`  accepted; lastIngestAt=${lastIngestAt}`) }
+console.log(`  next frame compare (1000 <= NaN) = ${1000 <= lastIngestAt} → 永不判 late`)
+
+// ---------- B:mock ccd-image 帧体积(png-enc.ts 同款编码) ----------
+const CRC_TABLE = (() => { const t = new Uint32Array(256); for (let n = 0; n < 256; n++) { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; t[n] = c >>> 0 } return t })()
+function crc32(buf) { let c = 0xffffffff; for (let i = 0; i < buf.length; i++) c = CRC_TABLE[(c ^ buf[i]) & 0xff] ^ (c >>> 8); return (c ^ 0xffffffff) >>> 0 }
+function chunk(type, data) { const len = Buffer.alloc(4); len.writeUInt32BE(data.length); const body = Buffer.concat([Buffer.from(type, 'ascii'), data]); const crc = Buffer.alloc(4); crc.writeUInt32BE(crc32(body)); return Buffer.concat([len, body, crc]) }
+function encodePng(width, height, pixels) {
+  const stride = width
+  const raw = Buffer.alloc((stride + 1) * height)
+  for (let y = 0; y < height; y++) { raw[y * (stride + 1)] = 0; pixels.subarray(y * stride, (y + 1) * stride).forEach((v, i) => { raw[y * (stride + 1) + 1 + i] = v }) }
+  const ihdr = Buffer.alloc(13); ihdr.writeUInt32BE(width, 0); ihdr.writeUInt32BE(height, 4); ihdr[8] = 8; ihdr[9] = 0
+  return Buffer.concat([Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]), chunk('IHDR', ihdr), chunk('IDAT', deflateSync(raw, { level: 6 })), chunk('IEND', Buffer.alloc(0))])
+}
+// mockImageSample:320x240 灰度,纹理+噪声+暗斑
+const w = 320, h = 240, px = new Uint8Array(w * h), baseGray = 128
+for (let y = 0; y < h; y++) for (let x = 0; x < w; x++) {
+  let v = baseGray + Math.sin(x * 0.35) * 8 + Math.sin(y * 0.22 + 1.7) * 6 + (Math.random() - 0.5) * 10
+  const dx = x - 160, dy = y - 120, d2 = dx * dx + dy * dy
+  if (d2 < 400) v -= (1 - d2 / 400) * 90
+  px[y * w + x] = Math.max(0, Math.min(255, Math.round(v)))
+}
+const t0 = performance.now()
+const png = encodePng(w, h, px)
+const enc = performance.now() - t0
+// thumbnail(width=256) → 256x192
+const tw = 256, th = Math.round(h * tw / w), small = new Uint8Array(tw * th)
+for (let y = 0; y < th; y++) for (let x = 0; x < tw; x++) small[y * tw + x] = px[Math.min(h - 1, Math.floor(y * h / th)) * w + Math.min(w - 1, Math.floor(x * w / tw))]
+const t1 = performance.now()
+const thumb = encodePng(tw, th, small)
+const encT = performance.now() - t1
+console.log(`\n--- B: ccd-image 帧体积(ccd-image 模板:thumbnail width=256)---`)
+console.log(`  main  ${w}x${h} = ${(png.length / 1024).toFixed(1)} KB (encode ${enc.toFixed(1)}ms, deflateSync 同步阻塞)`)
+console.log(`  thumb ${tw}x${th} = ${(thumb.length / 1024).toFixed(1)} KB (encode ${encT.toFixed(1)}ms)`)
+console.log(`  合计 ${((png.length + thumb.length) / 1024).toFixed(1)} KB/帧 → @1fps/节点 = ${(((png.length + thumb.length) / 1048576) * 86400).toFixed(2)} GB/天/节点`)
+db.close()

package/scripts/_audit/exp-png-decode.mjs

@@ -0,0 +1,67 @@
+/**
+ * 审计实验 5:frames.ts decodeGrayPng 对「非本仓编码器」PNG 的解码正确性。
+ * 复刻 decodeGrayPng(frames.ts:144-166)与 quality-gate/thumbnail 的调用方式,
+ * 用标准 PNG(filter 类型 2 = Up,真实相机/编码器常见)验证像素是否被正确还原。
+ * 运行:node scripts/_audit/exp-png-decode.mjs
+ */
+import { deflateSync, inflateSync } from 'node:zlib'
+
+const W = 8, H = 4
+// 真实像素:每行一个常量阶跃(便于肉眼比对)
+const truth = new Uint8Array(W * H)
+for (let y = 0; y < H; y++) for (let x = 0; x < W; x++) truth[y * W + x] = 50 + y * 40
+
+/** 按 PNG 规范生成「filter type 2 (Up)」灰度 8bit PNG */
+function encodePngFilterUp(w, h, px) {
+  const raw = Buffer.alloc((w + 1) * h)
+  let prev = new Uint8Array(w)
+  for (let y = 0; y < h; y++) {
+    const row = px.subarray(y * w, (y + 1) * w)
+    raw[y * (w + 1)] = 2 // filter type 2 = Up
+    for (let x = 0; x < w; x++) raw[y * (w + 1) + 1 + x] = (row[x] - prev[x]) & 0xff // up-filtered
+    prev = row
+  }
+  const chunks = [Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])]
+  const ihdr = Buffer.alloc(13)
+  ihdr.writeUInt32BE(w, 0); ihdr.writeUInt32BE(h, 4); ihdr[8] = 8; ihdr[9] = 0
+  const crcTable = (() => { const t = new Uint32Array(256); for (let n = 0; n < 256; n++) { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; t[n] = c >>> 0 } return t })()
+  const crc32 = (b) => { let c = 0xffffffff; for (let i = 0; i < b.length; i++) c = crcTable[(c ^ b[i]) & 0xff] ^ (c >>> 8); return (c ^ 0xffffffff) >>> 0 }
+  const chunk = (type, data) => { const l = Buffer.alloc(4); l.writeUInt32BE(data.length); const body = Buffer.concat([Buffer.from(type, 'ascii'), data]); const c = Buffer.alloc(4); c.writeUInt32BE(crc32(body)); return Buffer.concat([l, body, c]) }
+  chunks.push(chunk('IHDR', ihdr), chunk('IDAT', deflateSync(raw, { level: 6 })), chunk('IEND', Buffer.alloc(0)))
+  return Buffer.concat(chunks)
+}
+
+// —— frames.ts:144-166 的逐行复刻(只跳过 filter 字节,不做反滤波) ——
+function decodeGrayPng(blob, w, h) {
+  try {
+    let off = 8
+    const idat = []
+    while (off + 8 <= blob.length) {
+      const len = blob.readUInt32BE(off)
+      const type = blob.subarray(off + 4, off + 8).toString('ascii')
+      if (type === 'IDAT') idat.push(blob.subarray(off + 8, off + 8 + len))
+      off += 12 + len
+    }
+    if (idat.length === 0) return null
+    const raw = inflateSync(Buffer.concat(idat))
+    const stride = w + 1
+    if (raw.length < stride * h) return null
+    const out = new Uint8Array(w * h)
+    for (let y = 0; y < h; y++) out.set(raw.subarray(y * stride + 1, y * stride + 1 + w), y * w)
+    return out
+  }
+  catch { return null }
+}
+
+const png = encodePngFilterUp(W, H, truth)
+const decoded = decodeGrayPng(png, W, H)
+console.log('PNG bytes:', png.length, '| decodeGrayPng returned:', decoded ? 'pixels (non-null)' : 'null')
+console.log('truth   :', Array.from(truth).join(','))
+console.log('decoded :', decoded ? Array.from(decoded).join(',') : 'null')
+if (decoded) {
+  let maxErr = 0, sum = 0
+  for (let i = 0; i < truth.length; i++) { maxErr = Math.max(maxErr, Math.abs(truth[i] - decoded[i])); sum += decoded[i] }
+  console.log(`maxErr=${maxErr}  truthBrightness=${(Array.from(truth).reduce((a, b) => a + b, 0) / truth.length).toFixed(1)}  decodedBrightness=${(sum / decoded.length).toFixed(1)}`)
+}
+// JPEG 情形:无 IDAT → null
+console.log('JPEG-like (no IDAT) →', decodeGrayPng(Buffer.from([0xff, 0xd8, 0xff, 0xe0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]), W, H))

package/scripts/_audit/exp-retention-plan.mjs

@@ -0,0 +1,61 @@
+/**
+ * 审计实验:复刻 SqliteTimeSeriesAdapter 的建表 + 保留期清理 SQL,
+ * 用 EXPLAIN QUERY PLAN + 计时证明「保留期 DELETE 走全表扫描」。
+ * 运行:node scripts/_audit/exp-retention-plan.mjs
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const dir = mkdtempSync(join(tmpdir(), 'daq-audit-'))
+const db = new DatabaseSync(join(dir, 'ts.sqlite'))
+db.exec('PRAGMA journal_mode = WAL')
+
+// —— 与 sqlite.adapter.ts:35-73 同构的 DDL ——
+db.exec(`
+  CREATE TABLE IF NOT EXISTS daq_samples (
+    node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, value REAL NOT NULL,
+    state TEXT NOT NULL DEFAULT 'ok', line_id TEXT, product_id TEXT, recipe_id TEXT, run_id TEXT,
+    PRIMARY KEY (node_id, ts_ms)
+  );
+  CREATE INDEX IF NOT EXISTS idx_daq_node_ts ON daq_samples (node_id, ts_ms DESC);
+  CREATE TABLE IF NOT EXISTS daq_frames (
+    node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, kind TEXT NOT NULL, template_key TEXT,
+    device_binding_id TEXT, line_id TEXT, product_id TEXT, recipe_id TEXT, run_id TEXT,
+    points INTEGER NOT NULL DEFAULT 0, meta TEXT NOT NULL DEFAULT '{}', metrics TEXT NOT NULL DEFAULT '{}',
+    PRIMARY KEY (node_id, ts_ms)
+  );
+  CREATE INDEX IF NOT EXISTS idx_daq_frames_node_ts ON daq_frames (node_id, ts_ms DESC);
+`)
+
+const NODES = 50
+const PER_NODE = 4000 // 200k rows total
+const now = Date.now()
+const ins = db.prepare('INSERT OR IGNORE INTO daq_samples (node_id, ts_ms, value, state) VALUES (?,?,?,?)')
+db.exec('BEGIN')
+for (let n = 0; n < NODES; n++) {
+  for (let i = 0; i < PER_NODE; i++) ins.run(`dn-${n}`, now - i * 1000, n + i / 1000, 'ok')
+}
+db.exec('COMMIT')
+const total = db.prepare('SELECT COUNT(*) AS c FROM daq_samples').get().c
+console.log(`rows=${total}`)
+
+const cutoff = now - 168 * 3600_000 // tsRetentionH 缺省 168h
+const sql = 'DELETE FROM daq_samples WHERE rowid IN (SELECT rowid FROM daq_samples WHERE ts_ms < ? LIMIT 5000)'
+console.log('\n--- EXPLAIN QUERY PLAN (retention DELETE, sqlite.adapter.ts:94) ---')
+for (const r of db.prepare(`EXPLAIN QUERY PLAN ${sql}`).all(cutoff)) console.log(r.detail)
+
+console.log('\n--- EXPLAIN QUERY PLAN (frame retention DELETE, sqlite.adapter.ts:280) ---')
+for (const r of db.prepare('EXPLAIN QUERY PLAN DELETE FROM daq_frames WHERE ts_ms < ?').all(cutoff)) console.log(r.detail)
+
+console.log('\n--- timing ---')
+const t0 = Date.now()
+let removed = 0
+for (;;) {
+  const r = db.prepare(sql).run(cutoff)
+  removed += Number(r.changes)
+  if (Number(r.changes) < 5000) break
+}
+console.log(`sweep deleted ${removed} rows in ${Date.now() - t0}ms`)
+db.close()

package/scripts/_audit/exp-retention-rescan.mjs

@@ -0,0 +1,42 @@
+/**
+ * 审计实验 3:保留期 DELETE 的「每批从索引头重扫」代价。
+ * 索引 = (node_id, ts_ms DESC) —— 同一节点内「新的在前、旧的在后」,
+ * 因此删除最旧的行必须先走完整段未过期行。批数 = ceil(过期行/5000),
+ * 每批都从索引头重新开始 → 总代价 ≈ 批数 × 每节点未过期行数。
+ * 运行:node scripts/_audit/exp-retention-rescan.mjs
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+function build(nodes, perNode) {
+  const dir = mkdtempSync(join(tmpdir(), 'daq-audit-'))
+  const db = new DatabaseSync(join(dir, 'ts.sqlite'))
+  db.exec('PRAGMA journal_mode = WAL')
+  db.exec(`CREATE TABLE daq_samples (node_id TEXT NOT NULL, ts_ms INTEGER NOT NULL, value REAL NOT NULL,
+    state TEXT NOT NULL DEFAULT 'ok', PRIMARY KEY (node_id, ts_ms));
+    CREATE INDEX idx_daq_node_ts ON daq_samples (node_id, ts_ms DESC);`)
+  const ins = db.prepare('INSERT OR IGNORE INTO daq_samples (node_id, ts_ms, value) VALUES (?,?,?)')
+  const now = Date.now()
+  db.exec('BEGIN')
+  for (let n = 0; n < nodes; n++) for (let i = 0; i < perNode; i++) ins.run(`dn-${n}`, now - i * 1000, i)
+  db.exec('COMMIT')
+  return { db, now }
+}
+
+const DEL = 'DELETE FROM daq_samples WHERE rowid IN (SELECT rowid FROM daq_samples WHERE ts_ms < ? LIMIT 5000)'
+
+// 场景:每节点 200k 行(≈55h),仅最旧 ~2% 过期 → 过期行数 < 5000(单批即收敛)
+for (const nodes of [1, 10, 40]) {
+  const perNode = 200_000
+  const { db, now } = build(nodes, perNode)
+  const total = db.prepare('SELECT COUNT(*) AS c FROM daq_samples').get().c
+  const cutoff = now - (perNode - 4000) * 1000 // 只让最旧 4000 行过期
+  const expired = db.prepare('SELECT COUNT(*) AS c FROM daq_samples WHERE ts_ms < ?').get(cutoff).c
+  const t0 = performance.now()
+  const r = db.prepare(DEL).run(cutoff)
+  const ms = performance.now() - t0
+  console.log(`nodes=${String(nodes).padStart(3)} rows=${total} expired=${expired} → single batch DELETE ${ms.toFixed(1)}ms (deleted ${r.changes})`)
+  db.close()
+}

package/scripts/_audit/exp-sweep-fairness.mjs

@@ -0,0 +1,48 @@
+/**
+ * 审计实验 6:SWEEP_MAX_CONCURRENCY=8 下 N=50 节点的公平性/吞吐模拟。
+ * 逐行复刻 daq-controller.ts:464-482 的 sweep 循环语义:
+ *   - 每 250ms 一拍;budget = 8 - inFlight;按 Map 插入序扫描;
+ *   - 未到期(now < lastSampleAt + interval)continue;到期则启动并计入 budget;
+ *   - started >= budget 立即 break(尾部节点本拍不再考虑);
+ *   - lastSampleAt = 采样完成时刻(本模拟按瞬时完成,乐观假设)。
+ * 运行:node scripts/_audit/exp-sweep-fairness.mjs
+ */
+const SWEEP_INTERVAL = 250
+const BUDGET = 8
+const TICK_MS = 250
+
+function simulate({ nodes, intervalMs, budget = BUDGET, seconds = 60, sampleCostMs = 0 }) {
+  const lastSampleAt = new Array(nodes).fill(Number.NEGATIVE_INFINITY)
+  const effectiveInterval = Math.max(1000, intervalMs) // minIntervalMs 缺省 1000
+  const counts = new Array(nodes).fill(0)
+  let inFlight = 0
+  const inFlightUntil = []
+  for (let t = 0; t <= seconds * 1000; t += SWEEP_INTERVAL) {
+    // 采样完成(耗时 sampleCostMs)
+    while (inFlightUntil.length && inFlightUntil[0].doneAt <= t) { const j = inFlightUntil.shift(); lastSampleAt[j.i] = j.doneAt; inFlight-- }
+    if (inFlight > 0 && sampleCostMs === 0) { /* 瞬时完成:本拍全部回填 */ }
+    let started = 0
+    for (let i = 0; i < nodes; i++) {
+      if (started >= budget - inFlight) break
+      if (t < lastSampleAt[i] + effectiveInterval) continue
+      started++
+      counts[i]++
+      if (sampleCostMs > 0) { inFlight++; inFlightUntil.push({ i, doneAt: t + sampleCostMs }) }
+      else lastSampleAt[i] = t
+    }
+  }
+  const demand = (seconds * 1000) / effectiveInterval * nodes
+  const total = counts.reduce((a, b) => a + b, 0)
+  return { counts, total, demand, min: Math.min(...counts), max: Math.max(...counts) }
+}
+
+for (const cfg of [
+  { nodes: 8, intervalMs: 1000, seconds: 60 },
+  { nodes: 50, intervalMs: 1000, seconds: 60 },
+  { nodes: 50, intervalMs: 1000, seconds: 60, sampleCostMs: 100 },
+  { nodes: 50, intervalMs: 1000, seconds: 60, sampleCostMs: 3000 }, // mqtt 驱动最坏:连不上 + 首帧等待 3s
+]) {
+  const r = simulate(cfg)
+  const tail = r.counts.slice(-5).join(',')
+  console.log(`nodes=${String(cfg.nodes).padStart(2)} interval=${cfg.intervalMs}ms cost=${cfg.sampleCostMs || 0}ms/拍250ms → 60s 内采样总数=${r.total}(需求 ${r.demand.toFixed(0)},达成 ${(r.total / r.demand * 100).toFixed(1)}%) 每节点 [min=${r.min} max=${r.max}] 末 5 节点=[${tail}]`)
+}

package/scripts/_audit/hello.mjs

@@ -0,0 +1,12 @@
+// scratch audit command (registration target experiment)
+export const meta = {
+  name: 'hello-audit',
+  group: 'audit',
+  summary: 'hello from audit scratch',
+  needsProject: false,
+}
+
+export async function run() {
+  console.log('hello-audit ok')
+  return 0
+}