dsh-remote-agent 0.0.0-stage → 0.4.0

package/scripts/check-packaging.mjs

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+/**
+ * 打包自洽性检查：`package.json` 的 `files` / `exports` / `bin` / `dsh.bundle.patch`
+ * 指向的路径必须**真实存在**。
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * 为什么需要这条
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * 本包没有构建步骤：`lib/**` 就是 DSH 实际加载的产物。所以"文件是否在包里"
+ * 完全由 `package.json` 的 `files` 字段与 git 追踪状态决定 —— 而这两个地方
+ * 都容易漏：
+ *
+ *   - 新增一个 `lib/foo.js` 但忘了加进 `files` → 从 git 装的人拿到一个缺文件的包
+ *   - `exports` 里写了一个已删除的路径 → `import 'dsh-remote-agent/hub'` 报错
+ *   - `dsh.bundle.patch` 指向不存在的 yml → loader 读不到 patch，插件行永不插入
+ *     （**这是 v0.1 的一个真实 blocker**，由独立验证发现）
+ *
+ * 这些错误在开发机上都不会暴露（本地有完整目录树），只有用户安装时才炸。
+ * 所以必须在 CI 里挡。
+ *
+ * 退出码：0 = 全部一致；1 = 有缺失（打印每一条）。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const HERE = path.dirname(fileURLToPath(import.meta.url))
+const ROOT = path.resolve(HERE, '..')
+
+const pkgPath = path.join(ROOT, 'package.json')
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+
+/** 把 glob 简化成"存在性检查"：只处理 `dir` 与 `dir/**` 两种形态。 */
+const exists = (rel) => {
+  const abs = path.join(ROOT, rel)
+  return fs.existsSync(abs)
+}
+
+const problems = []
+const notes = []
+
+// ── 1) files 字段 ────────────────────────────────────────────────────────────
+const files = Array.isArray(pkg.files) ? pkg.files : []
+if (files.length === 0) {
+  problems.push('package.json 没有 files 字段 —— 从 git 安装会带上一堆无关文件')
+} else {
+  for (const f of files) {
+    // files 里的条目可以是目录或文件；不接受 glob（npm 的 files 也不支持 ** 语义）
+    if (!exists(f)) problems.push(`files 里的路径不存在: ${f}`)
+  }
+  notes.push(`files: ${files.length} 项，全部存在`)
+}
+
+// ── 2) exports ───────────────────────────────────────────────────────────────
+const exportsMap = pkg.exports && typeof pkg.exports === 'object' ? pkg.exports : {}
+for (const [key, target] of Object.entries(exportsMap)) {
+  // 目标可以是字符串或条件对象
+  const targets = typeof target === 'string' ? [target] : Object.values(target ?? {})
+  for (const t of targets) {
+    if (typeof t !== 'string') continue
+    if (!exists(t)) problems.push(`exports["${key}"] 指向不存在的路径: ${t}`)
+  }
+}
+notes.push(`exports: ${Object.keys(exportsMap).length} 项`)
+
+// ── 3) main / bin ────────────────────────────────────────────────────────────
+if (typeof pkg.main === 'string' && !exists(pkg.main)) {
+  problems.push(`main 指向不存在的路径: ${pkg.main}`)
+}
+for (const [name, target] of Object.entries(pkg.bin ?? {})) {
+  if (!exists(target)) problems.push(`bin["${name}"] 指向不存在的路径: ${target}`)
+}
+
+// ── 4) dsh.bundle.patch（DSH 专用：loader 靠它插入插件行）────────────────────
+const patch = pkg.dsh?.bundle?.patch
+if (typeof patch !== 'string') {
+  problems.push('dsh.bundle.patch 缺失 —— loader 读不到 patch，插件行永不插入')
+} else if (!exists(patch)) {
+  problems.push(`dsh.bundle.patch 指向不存在的路径: ${patch}`)
+} else {
+  // patch 必须真的是一条 insert（不能是空文件）
+  const body = fs.readFileSync(path.join(ROOT, patch), 'utf8')
+  if (!/insert:/.test(body)) {
+    problems.push(`dsh.bundle.patch (${patch}) 里没有 insert: —— loader 不会插入任何行`)
+  }
+  if (!/dsh-remote-agent/.test(body)) {
+    problems.push(`dsh.bundle.patch (${patch}) 里没有引用 dsh-remote-agent`)
+  }
+  notes.push(`dsh.bundle.patch: ${patch}（含 insert）`)
+}
+
+// ── 5) dsh.client 声明 ───────────────────────────────────────────────────────
+if (!pkg.dsh?.client) {
+  problems.push('dsh.client 缺失 —— Web 面板不会加载')
+} else {
+  if (pkg.dsh.client.platform !== 'web') {
+    problems.push(`dsh.client.platform 应为 "web"，实际 ${JSON.stringify(pkg.dsh.client.platform)}`)
+  }
+  // client 半边必须真实存在
+  const clientEntry = pkg.exports?.['./client']
+  if (typeof clientEntry === 'string' && !exists(clientEntry)) {
+    problems.push(`dsh.client 声明了 web 半边，但 exports["./client"] 指向的文件不存在`)
+  }
+}
+
+// ── 6) scripts 引用的脚本文件 ────────────────────────────────────────────────
+for (const [name, cmd] of Object.entries(pkg.scripts ?? {})) {
+  // 只检查 `node scripts/xxx.mjs` 这种直接形态
+  const m = /^node\s+(scripts\/[\w.-]+)/.exec(cmd)
+  if (m && !exists(m[1])) {
+    problems.push(`scripts["${name}"] 引用了不存在的文件: ${m[1]}`)
+  }
+}
+
+// ── 输出 ─────────────────────────────────────────────────────────────────────
+console.log('打包自洽性检查')
+console.log('─'.repeat(60))
+for (const n of notes) console.log(`  ✓ ${n}`)
+
+if (problems.length === 0) {
+  console.log('─'.repeat(60))
+  console.log(`  ✓ 全部一致（${notes.length} 项通过）`)
+  process.exit(0)
+}
+
+console.log('─'.repeat(60))
+console.log(`  ✗ 发现 ${problems.length} 个问题：`)
+for (const p of problems) console.log(`    - ${p}`)
+process.exit(1)

package/scripts/diag-inject.mjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+/**
+ * 诊断：`inject` 契约是否与代码实际访问的服务匹配。
+ *
+ * ═══════════════════════════════════════════════════════════════════════════
+ * 为什么需要这个脚本
+ * ═══════════════════════════════════════════════════════════════════════════
+ *
+ * `inject` 声明与 `applyHub`/`applyWorker` 实际访问的服务**必须匹配**。
+ * 不匹配时的失败形态**特别隐蔽**，我们为它付出过一整轮排查：
+ *
+ *   · **hub 半死**：`applyHub` 里工具注册在路由注册之后 —— 缺 `tools` 时
+ *     路由全部注册成功、`/healthz` 返回 200 还带着 `nodes`/`online` 实时计数，
+ *     但 **8 个 remote_* 工具全部消失**，插件管理页显示「异常」。
+ *   · **agent 无工具**：副机缺 `tools` 时 agent 能推理、能调
+ *     `load_workspace_dependencies`（DSH 全局注入的），但**没有 shell / 文件读写** ——
+ *     看起来"能用"，实际干不了活。
+ *
+ * 两者的共同点是**没有明确报错**：一个是"一半活"，一个是"能说话不能干活"。
+ *
+ * ── 本脚本做什么 ────────────────────────────────────────────────────────
+ *
+ * 1. 读包内 `cordis.patch.yml` 的 inject
+ * 2. 扫 `lib/hub/index.js` 的 `applyHub` 与 `lib/node/index.js` 的 worker 分支，
+ *    找出所有 `ctx.<service>` 属性访问（属性访问在未声明 inject 时会**抛**）
+ * 3. 断言这些服务都在 inject 里
+ * 4. 用**假 ctx** 真跑一遍 `applyHub`，确认：
+ *    · inject 齐全时 8 个工具都注册
+ *    · 缺 `tools` 时**不抛错**（只少工具 + 记日志）
+ *
+ * ── 用法 ────────────────────────────────────────────────────────────────
+ *
+ *   node scripts/diag-inject.mjs           # 人读
+ *   node scripts/diag-inject.mjs --json    # 机器读（CI 用）
+ *
+ * 退出码：0 = 契约成立；1 = 有问题（并打印是哪一条）。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const read = (p) => fs.readFileSync(path.join(ROOT, p), 'utf8')
+const stripComments = (src) => src.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/[^\n]*/g, '$1')
+
+const results = []
+const check = (name, ok, detail = '') => results.push({ name, ok, detail })
+
+/* ── 1. 读包内 inject ───────────────────────────────────────────────── */
+
+/**
+ * 取**生效的** inject（锚定行首 —— 文件注释里有多处提到 inject，不锚定会命中注释）。
+ * 这个坑我们踩过：断言用了 `/inject:\s*(\[...\])/`，命中了注释里那句事故记录。
+ */
+function declaredInject() {
+  const patch = read('cordis.patch.yml')
+  const m = patch.match(/^\s*inject:\s*(\[[^\]]*\])/m)
+  return m ? m[1] : ''
+}
+
+const injectRaw = declaredInject()
+const declared = [...injectRaw.matchAll(/'([^']+)'|"([^"]+)"/g)].map((m) => m[1] || m[2])
+check('包内 cordis.patch.yml 有 inject 声明', injectRaw !== '', injectRaw || '(未找到)')
+
+/* ── 2. 扫代码里实际访问的服务 ──────────────────────────────────────── */
+
+/** 非服务的方法名（`ctx.get` / `ctx.on` / …），不算服务访问。 */
+const NON_SERVICES = new Set([
+  'get', 'on', 'once', 'emit', 'effect', 'logger', 'plugin', 'root', 'scope',
+  'inject', 'set', 'provide', 'isolate', 'intercept', 'parallel', 'serial',
+  'waterfall', 'bail',
+])
+
+/** 取某个具名函数的函数体（花括号配对）。 */
+function bodyOf(src, header) {
+  const i = src.indexOf(header)
+  if (i < 0) return ''
+  const parenEnd = src.indexOf(')', i)
+  const braceStart = src.indexOf('{', parenEnd > 0 ? parenEnd : i)
+  if (braceStart < 0) return ''
+  let depth = 0
+  for (let k = braceStart; k < src.length; k += 1) {
+    if (src[k] === '{') depth += 1
+    else if (src[k] === '}') {
+      depth -= 1
+      if (depth === 0) return src.slice(i, k + 1)
+    }
+  }
+  return ''
+}
+
+/** 从一段代码里找出所有 `ctx.<service>` 属性访问。 */
+function servicesAccessed(code) {
+  const found = new Set()
+  for (const m of code.matchAll(/ctx\.([a-zA-Z][\w]*)/g)) {
+    if (!NON_SERVICES.has(m[1])) found.add(m[1])
+  }
+  return found
+}
+
+const hubSrc = stripComments(read('lib/hub/index.js'))
+const hubBody = bodyOf(hubSrc, 'export function applyHub')
+check('找到 applyHub', hubBody !== '')
+const hubServices = servicesAccessed(hubBody)
+
+const workerSrc = stripComments(read('lib/node/index.js'))
+const workerBody = bodyOf(workerSrc, 'function startWorker')
+const workerServices = servicesAccessed(workerBody)
+
+/* ── 3. 契约：hub 访问的服务必须在 inject 里 ────────────────────────── */
+
+// 只查**会抛**的那几个（属性访问）。`ctx.get(name)` 是非严格的，不算。
+const HUB_MUST = ['webServer', 'tools', 'systemPrompt']
+for (const svc of HUB_MUST) {
+  if (!hubServices.has(svc)) continue
+  check(
+    `hub 需要的 '${svc}' 在 inject 里`,
+    declared.includes(svc),
+    declared.includes(svc) ? '' : `applyHub 访问 ctx.${svc}，但 inject = ${injectRaw}`,
+  )
+}
+
+// worker 侧：agent 的 ctx 继承本行 inject，所以 tools 必须有
+const WORKER_MUST = ['tools', 'agentLoop', 'sessions']
+for (const svc of WORKER_MUST) {
+  if (!workerServices.has(svc)) continue
+  check(
+    `worker 需要的 '${svc}' 在 worker profile 模板里`,
+    (() => {
+      try {
+        return read('profiles/worker.cordis.yml').includes(`'${svc}'`)
+      } catch {
+        return false
+      }
+    })(),
+    `worker 分支访问 ctx.${svc}（agent 的 ctx 继承本行 inject，少了它 agent 拿不到该服务）`,
+  )
+}
+
+/* ── 4. 真跑一遍 applyHub（假 ctx）─────────────────────────────────── */
+
+/**
+ * 造一个**模拟 cordis 语义**的 ctx：
+ *   · 属性访问未声明的服务 → 抛（真实行为）
+ *   · `ctx.get(name, false)` → 不管声明都返回（非严格）
+ */
+function fakeCtx(injectList) {
+  const registered = { routes: [], tools: [], sections: [] }
+  const values = {
+    webServer: {
+      register(r) { registered.routes.push(r.path); return () => {} },
+      registerUpgrade(r) { registered.routes.push('upgrade:' + r.path); return () => {} },
+    },
+    tools: { register(t) { registered.tools.push(t.name); return () => {} } },
+    systemPrompt: { section(s) { registered.sections.push(s.name); return () => {} } },
+  }
+  const ctx = {
+    registered,
+    effect(fn) {
+      const d = fn()
+      return typeof d === 'function' ? d : () => {}
+    },
+    on() { return () => {} },
+    logger: { info() {}, warn() {}, error() {}, debug() {} },
+    get() { return undefined },
+  }
+  for (const [name, value] of Object.entries(values)) {
+    Object.defineProperty(ctx, name, {
+      get() {
+        if (!injectList.includes(name)) {
+          throw new Error(`cannot get property "${name}" without inject`)
+        }
+        return value
+      },
+    })
+  }
+  return ctx
+}
+
+let applyHub
+try {
+  ;({ applyHub } = await import(new URL('../lib/hub/index.js', import.meta.url).href))
+} catch (err) {
+  check('能 import applyHub', false, String(err?.message ?? err))
+}
+
+if (applyHub) {
+  // 4a. inject 齐全 → 不抛，且 8 个工具都在
+  try {
+    const ctx = fakeCtx(declared)
+    applyHub(ctx, { role: 'hub', nodeToken: 'nt_diag' })
+    check('inject 齐全时 applyHub 不抛', true)
+    check(
+      'inject 齐全时注册 8 个 remote_* 工具',
+      ctx.registered.tools.length === 8,
+      `实际 ${ctx.registered.tools.length} 个：${ctx.registered.tools.join(', ') || '(无)'}`,
+    )
+    check('inject 齐全时注册了路由', ctx.registered.routes.length > 0, `${ctx.registered.routes.length} 条`)
+  } catch (err) {
+    check('inject 齐全时 applyHub 不抛', false, String(err?.message ?? err))
+  }
+
+  // 4b. 缺 tools → **不该抛**（容错），只少工具
+  try {
+    const ctx = fakeCtx(['webServer'])
+    applyHub(ctx, { role: 'hub', nodeToken: 'nt_diag' })
+    check('缺 tools 时 applyHub 仍不抛（容错生效）', true)
+    check(
+      '缺 tools 时没有工具（符合预期，不是 bug）',
+      ctx.registered.tools.length === 0,
+      `实际 ${ctx.registered.tools.length} 个`,
+    )
+    check('缺 tools 时路由仍注册（半活但不挂）', ctx.registered.routes.length > 0, `${ctx.registered.routes.length} 条`)
+  } catch (err) {
+    check(
+      '缺 tools 时 applyHub 仍不抛（容错生效）',
+      false,
+      `抛了 ${String(err?.message ?? err)} —— lib/hub/index.js 的 tools 注册段缺 try/catch`,
+    )
+  }
+}
+
+/* ── 输出 ───────────────────────────────────────────────────────────── */
+
+const failed = results.filter((r) => !r.ok)
+
+if (process.argv.includes('--json')) {
+  console.log(JSON.stringify({ total: results.length, failed: failed.length, results }, null, 2))
+} else {
+  console.log('inject 契约诊断')
+  console.log('─'.repeat(64))
+  console.log(`  包内 inject: ${injectRaw || '(未找到)'}`)
+  console.log(`  hub 访问的服务: ${[...hubServices].sort().join(', ') || '(无)'}`)
+  console.log(`  worker 访问的服务: ${[...workerServices].sort().join(', ') || '(无)'}`)
+  console.log('─'.repeat(64))
+  for (const r of results) {
+    console.log(`  ${r.ok ? 'OK  ' : 'FAIL'} ${r.name}${r.detail ? `\n         ${r.detail}` : ''}`)
+  }
+  console.log('─'.repeat(64))
+  console.log(failed.length === 0 ? `  ✓ 全部通过（${results.length} 项）` : `  ✗ ${failed.length}/${results.length} 项失败`)
+}
+
+process.exit(failed.length === 0 ? 0 : 1)

package/scripts/e2e-live-check.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * e2e-live-check —— 发布前的真实运行时端到端自检（挂到正在跑的 DSH 上）。
+ *
+ * 与 test/ 的区别：测试是**进程内**装配（真协议真传输，同一 node 进程）；
+ * 本工具把 worker 跑在**独立的操作系统进程**里，通过真实 TCP/WebSocket
+ * 拨入**正在运行的 DSH 桌面版 hub**（真实 webServer 路由、真实 upgrade
+ * 握手、真实 registry）。
+ *
+ * ⚠ 派发为什么不是全自动：实测 hub 的 webserver 除 /healthz 外整台被
+ * DSH 会话围栏保护（requestRejection，桌面渲染器外一律 401）——这是
+ * **安全设计生效的证据**（UI 路由不裸奔）。所以本工具分两段：
+ *   ① 自动：拨入 → 确认 online（最难的一段：真实握手/鉴权/注册）
+ *   ② 人肉一步：由你从 DSH 桌面给这个节点派一个 exec 任务，
+ *      工具监视副机 TaskStore 落盘记录 + roots 产物，自动验证状态机
+ *      与 handoff/清单，并做 sha256 自校验。
+ *
+ * 用法：
+ *   node scripts/e2e-live-check.mjs --hub-url ws://127.0.0.1:19387/api/remote-agent/node \
+ *        [--token <nt_...>] [--node-id e2e-live-worker] [--watch-seconds 90] [--keep]
+ *
+ * 退出码：0 = 拨入+任务链路通过；1 = 失败（附人话诊断）；3 = 仅拨入通过但超时未见任务。
+ */
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import process from 'node:process'
+import { createHash } from 'node:crypto'
+import { parseArgs } from 'node:util'
+import { applyWorker } from '../lib/node/index.js'
+
+const { values } = parseArgs({
+  options: {
+    'hub-url': { type: 'string' },
+    token: { type: 'string', default: '' },
+    'node-id': { type: 'string', default: 'e2e-live-worker' },
+    'roots': { type: 'string' }, // 逗号分隔；默认建临时目录
+    'watch-seconds': { type: 'string', default: '120' },
+    keep: { type: 'boolean', default: false },
+  },
+})
+
+const say = (m = '') => console.log(m)
+const hubUrl = values['hub-url'] ?? ''
+if (hubUrl === '') {
+  say('用法：node scripts/e2e-live-check.mjs --hub-url ws://<hub>:19387/api/remote-agent/node')
+  process.exit(2)
+}
+const nodeId = values['node-id'] ?? 'e2e-live-worker'
+const watchMs = Number(values['watch-seconds']) > 0 ? Number(values['watch-seconds']) * 1000 : 120000
+
+const root = fs.realpathSync.native(fs.mkdtempSync(path.join(os.tmpdir(), 'dsh-e2e-')))
+const stateDir = path.join(root, 'worker-state')
+const roots = (values.roots ? values.roots.split(/[,;]+/) : [path.join(root, 'ws')])
+  .map((s) => s.trim()).filter(Boolean)
+for (const r of roots) fs.mkdirSync(r, { recursive: true })
+
+/* ── worker：最小 ctx（logger/effect/get）──────────────────────────
+ * 与 DSH 里真实的副机一致：没有 webServer / systemPrompt —— 副机
+ * inject: [] 拿不到它们，worker 全部按可选处理。 */
+const logs = []
+const logger = {
+  info: (m, e) => logs.push(['info', m, e]),
+  warn: (m, e) => logs.push(['warn', m, e]),
+  error: (m, e) => logs.push(['error', m, e]),
+  debug: (m, e) => logs.push(['debug', m, e]),
+}
+const disposeWorker = applyWorker(
+  { logger, on: () => () => {}, effect: (fn) => fn(), get: () => undefined },
+  {
+    role: 'worker',
+    nodeId,
+    transportMode: 'direct',
+    hubUrl,
+    token: values.token ?? '',
+    stateDir,
+    roots,
+    maxConcurrent: 2,
+    resumeQueued: false,
+  },
+)
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+async function waitOnline(ms) {
+  const started = Date.now()
+  for (;;) {
+    // logger 会给消息加 "[dsh-remote-agent:worker] " 前缀，匹配结尾
+    if (logs.some(([, m]) => typeof m === 'string' && m.endsWith(' online'))) return true
+    if (logs.some(([lv, m]) => lv === 'error' && /transport start failed/.test(m))) return false
+    if (Date.now() - started > ms) return false
+    await sleep(250)
+  }
+}
+
+/* ── ① 拨入（全自动） ───────────────────────────────────────────── */
+if (!(await waitOnline(30000))) {
+  say('✗ worker 未上线 —— 最近日志：')
+  for (const [lv, m, e] of logs.slice(-8)) say(`  [${lv}] ${m}${e ? ' ' + JSON.stringify(e) : ''}`)
+  say('排查：hub 是否在跑 / token 是否一致 / 防火墙端口')
+  disposeWorker()
+  process.exit(1)
+}
+say(`✓ worker 已拨入真实 hub（nodeId=${nodeId}，pid=${process.pid}）`)
+
+/* ── ② 人肉派发 + 自动监视 ──────────────────────────────────────── */
+say('')
+say('现在请到 DSH 桌面对这个节点派一个 exec 任务，例如：')
+say(`  「让 ${nodeId} 在它的工作区里创建 proof.txt 并写入 e2e-live-ok」`)
+say(`（工具最多等 ${Math.round(watchMs / 1000)} 秒；等不到按 Ctrl+C 中断）`)
+say('')
+
+const tasksDir = path.join(stateDir, 'tasks')
+const seen = new Set()
+const started = Date.now()
+let hit = null
+while (Date.now() - started < watchMs) {
+  let files = []
+  try { files = fs.readdirSync(tasksDir) } catch { /* 还没有任务目录 */ }
+  for (const f of files) {
+    if (!f.endsWith('.json') || seen.has(f)) continue
+    seen.add(f)
+    let rec
+    try { rec = JSON.parse(fs.readFileSync(path.join(tasksDir, f), 'utf8')) } catch { continue }
+    say(`· 收到任务记录：${rec.taskId} status=${rec.status}`)
+    hit = rec
+  }
+  if (hit && !['queued', 'running'].includes(hit.status)) break
+  await sleep(1000)
+}
+
+if (!hit) {
+  say('✗ 超时未见任何任务记录 —— 请确认派发时选中的节点 id 是本节点')
+  say(`  （本节点 nodeId=${nodeId}；hub 侧可在面板/对话里让 agent 选节点）`)
+  disposeWorker()
+  process.exit(3)
+}
+
+/* ── ③ 验证：终态 + 产物 + handoff ─────────────────────────────── */
+say('')
+say(`✓ 任务到达终态：${hit.status}（${hit.taskId}）`)
+if (hit.error) say(`  error：${JSON.stringify(hit.error).slice(0, 300)}`)
+if (hit.status !== 'completed') {
+  say('✗ 任务未 completed（真实运行时下这同样是有效结论 —— 记下错误信息排查）')
+  disposeWorker()
+  process.exit(1)
+}
+
+// roots 下新增/变化的文件 = 副机真实执行痕迹
+const before = new Set()
+for (const r of roots) {
+  const walk = (d) => {
+    for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+      const p = path.join(d, e.name)
+      if (e.isDirectory()) walk(p)
+      else before.add(p)
+    }
+  }
+  try { walk(r) } catch { /* 目录可能被任务删了 */ }
+}
+// （记录是终态后才统计的，所以这里看到的就是任务产物全集）
+const artifacts = [...before].filter((p) => !p.includes('worker-state'))
+say(`✓ 副机 roots 产物 ${artifacts.length} 个：`)
+for (const p of artifacts.slice(0, 10)) {
+  const buf = fs.readFileSync(p)
+  say(`  - ${path.relative(root, p)}  ${buf.length}B  sha256=${createHash('sha256').update(buf).digest('hex').slice(0, 16)}`)
+}
+if (hit.manifest) {
+  say(`✓ manifest：final=${hit.manifest.counts?.final ?? '?'} changed=${hit.manifest.counts?.changed ?? '?'}`)
+}
+
+disposeWorker()
+if (!values.keep) fs.rmSync(root, { recursive: true, force: true })
+else say(`（--keep：worker 状态与产物保留在 ${root}）`)
+
+if (artifacts.length === 0) {
+  say('✗ 任务 completed 但 roots 无产物 —— 派的任务可能没写文件，换一个会落盘的任务再试')
+  process.exit(1)
+}
+say('')
+say('✓ 真实运行时链路验证通过：独立进程 worker → 真实 hub → 任务落盘执行 → 终态/产物齐全')
+process.exit(0)