@xtalpi/agentic-lab-skills 0.0.10 → 0.0.11

package/skills/lab-flow-designer/testing/test-processer.mjs

@@ -1,1240 +1,1240 @@
-#!/usr/bin/env node
-/**
- * Processer script test harness for lab-flow-designer.
- * Zero external dependencies — Node.js built-ins only.
- *
- * Usage:
- *   node test-processer.mjs \
- *     --script <path-to-script.js> \
- *     --pools-dir <path-to-pools-dir> \
- *     --valves-dir <path-to-valves-dir> \
- *     --valve-name <valve-base-name>
- */
-
-import { Script, createContext } from 'node:vm';
-import { readFileSync, readdirSync, existsSync } from 'node:fs';
-import { resolve, join, basename } from 'node:path';
-
-// ─── CLI arg parsing ───────────────────────────────────────────────
-
-function parseArgs(argv) {
-  const args = {};
-  for (let i = 2; i < argv.length; i++) {
-    if (argv[i] === '--script') args.script = argv[++i];
-    else if (argv[i] === '--pools-dir') args.poolsDir = argv[++i];
-    else if (argv[i] === '--valves-dir') args.valvesDir = argv[++i];
-    else if (argv[i] === '--valve-name') args.valveName = argv[++i];
-    else if (argv[i] === '--preview') args.preview = true;
-    else if (argv[i] === '--data') args.dataPath = argv[++i];
-  }
-  if (!args.script) {
-    console.error('Missing --script <path>');
-    process.exit(1);
-  }
-  return args;
-}
-
-// ─── Markdown parsers ──────────────────────────────────────────────
-
-function parseMarkdownTable(text) {
-  const lines = text.split('\n').filter(l => l.trim().startsWith('|'));
-  if (lines.length < 3) return { headers: [], rows: [] };
-  const split = line => line.split('|').map(c => c.trim()).filter(Boolean);
-  const headers = split(lines[0]);
-  const rows = lines.slice(2).map(split);
-  return { headers, rows };
-}
-
-function parsePoolMarkdown(content) {
-  const nameMatch = content.match(/^#\s+(.+)$/m);
-  const name = nameMatch ? nameMatch[1].trim() : 'unknown';
-
-  const schemaParts = content.split(/^##\s+Schema\s*$/m);
-  if (schemaParts.length < 2) return { name, fields: [] };
-
-  const schemaSection = schemaParts[1].split(/^##\s+/m)[0];
-  const { headers, rows } = parseMarkdownTable(schemaSection);
-
-  const colIdx = h => {
-    const lower = h.toLowerCase();
-    return headers.findIndex(hdr => hdr.toLowerCase() === lower || hdr === h);
-  };
-
-  const iKey = Math.max(colIdx('字段'), colIdx('key'), 0);
-  const iLabel = Math.max(colIdx('字段标题'), colIdx('label'), -1);
-  const iDesc = Math.max(colIdx('字段描述'), colIdx('description'), -1);
-  const iType = Math.max(colIdx('字段类型'), colIdx('type'), -1);
-  const iOptions = Math.max(colIdx('属性'), colIdx('options'), -1);
-  const iDefault = Math.max(colIdx('默认值'), colIdx('default_value'), -1);
-
-  const fields = rows.map(cells => {
-    const key = (cells[iKey] || '').trim();
-    const type = iType >= 0 ? (cells[iType] || 'text').trim() : 'text';
-    const optRaw = iOptions >= 0 ? (cells[iOptions] || '').trim() : '';
-    let options;
-    if (optRaw && optRaw !== '-') {
-      const enumMatch = optRaw.match(/^枚举[：:]\s*(.+)/);
-      if (enumMatch) {
-        options = enumMatch[1].split(/[,，、]/).map(s => s.trim()).filter(Boolean);
-      }
-    }
-    const defRaw = iDefault >= 0 ? (cells[iDefault] || '').trim() : '';
-    const default_value = defRaw && defRaw !== '-' ? defRaw : undefined;
-    return {
-      key,
-      label: iLabel >= 0 ? (cells[iLabel] || key).trim() : key,
-      description: iDesc >= 0 ? (cells[iDesc] || '').trim() : '',
-      type,
-      options,
-      default_value,
-    };
-  }).filter(f => f.key);
-
-  return { name, fields };
-}
-
-function parseValveMarkdown(content) {
-  const nameMatch = content.match(/^#\s+(.+)$/m);
-  const name = nameMatch ? nameMatch[1].trim() : 'unknown';
-
-  const input_pools = [];
-  const output_pools = [];
-
-  const yamlMatch = content.match(/```yaml\n([\s\S]*?)```/);
-  if (yamlMatch) {
-    const yaml = yamlMatch[1];
-    const primaryMatch = yaml.match(/primary:\s*(.+)/);
-    if (primaryMatch) input_pools.push({ name: primaryMatch[1].trim() });
-    const secondaryMatches = yaml.matchAll(/secondary:\s*(.+)/g);
-    for (const m of secondaryMatches) input_pools.push({ name: m[1].trim() });
-    const poolMatches = yaml.matchAll(/(?:pool|Stash):\s*(.+)/g);
-    for (const m of poolMatches) output_pools.push({ name: m[1].trim() });
-  }
-
-  if (input_pools.length === 0) {
-    const m = content.match(/\*\*输入池\*\*[：:]\s*(.+)/);
-    if (m) input_pools.push({ name: m[1].trim() });
-  }
-  if (output_pools.length === 0) {
-    const m = content.match(/\*\*输出池\*\*[：:]\s*(.+)/);
-    if (m) m[1].split(/[,，、]/).forEach(p => {
-      const cleaned = p.replace(/[（(].*?[）)]/, '').trim();
-      if (cleaned) output_pools.push({ name: cleaned });
-    });
-  }
-
-  return { name, input_pools, output_pools };
-}
-
-function loadAllPools(poolsDir) {
-  if (!poolsDir || !existsSync(poolsDir)) return [];
-  return readdirSync(poolsDir)
-    .filter(f => f.endsWith('.md'))
-    .map(f => {
-      const content = readFileSync(join(poolsDir, f), 'utf8');
-      return parsePoolMarkdown(content);
-    });
-}
-
-function loadValveConfig(valvesDir, valveName) {
-  if (!valvesDir || !valveName) return { name: 'unknown', input_pools: [{ name: '入口池' }], output_pools: [{ name: '出口池' }] };
-  const filePath = join(valvesDir, `${valveName}.md`);
-  if (!existsSync(filePath)) return { name: valveName, input_pools: [{ name: '入口池' }], output_pools: [{ name: '出口池' }] };
-  return parseValveMarkdown(readFileSync(filePath, 'utf8'));
-}
-
-// ─── Mock data generation ──────────────────────────────────────────
-
-function generateValueForType(field, seed) {
-  const { type, options, default_value, key } = field;
-  if (default_value && default_value !== '-') return default_value;
-  if (options && options.length) return options[seed % options.length];
-
-  switch ((type || '').toLowerCase()) {
-    case 'number': case 'integer': case 'float':
-      return seed * 10.5;
-    case 'boolean':
-      return seed % 2 === 0;
-    case 'json': case 'object':
-      return {};
-    case 'array':
-      return [];
-    case 'date': case 'datetime':
-      return '2026-01-15T10:00:00Z';
-    default:
-      return `mock_${key}_${seed}`;
-  }
-}
-
-function generateAdversarialValue(field) {
-  switch ((field.type || '').toLowerCase()) {
-    case 'text': case 'string':
-      return Math.random() > 0.5 ? null : 12345;
-    case 'number': case 'integer': case 'float':
-      return Math.random() > 0.5 ? null : 'not-a-number';
-    case 'boolean':
-      return null;
-    default:
-      return null;
-  }
-}
-
-function generateDetailFromSchema(fields, seed, adversarial) {
-  const detail = {};
-  for (const field of fields) {
-    if (field.key === 'id' || field.key === 'detail') continue;
-    detail[field.key] = adversarial
-      ? generateAdversarialValue(field)
-      : generateValueForType(field, seed);
-  }
-  return detail;
-}
-
-function generateMockTickets(pools, valveConfig, adversarial) {
-  const inputPoolName = valveConfig.input_pools[0]?.name;
-  const inputPool = pools.find(p => p.name === inputPoolName);
-  const fields = inputPool?.fields || [];
-
-  return [1, 2, 3].map(i => ({
-    id: i,
-    flow_id: 1,
-    pool_id: i <= 1 ? 1 : (valveConfig.input_pools.length > 1 ? 2 : 1),
-    order_id: 1000 + i,
-    parent_ticket_id: 0,
-    detail: generateDetailFromSchema(fields, i, adversarial && i === 3),
-    status: 'created',
-    uuid: `mock-uuid-${i}`,
-  }));
-}
-
-// ─── Mock context factory ──────────────────────────────────────────
-
-const KNOWN_SDK_NAMESPACES = new Set(['ticket', 'pool', 'compound', 'process', 'station']);
-
-const PAGINATED_METHODS = new Set([
-  'ticket.list', 'process.list', 'compound.getStockFromXfcSh',
-]);
-
-function createMockContext(pools, valveConfig, adversarial) {
-  const mockTickets = generateMockTickets(pools, valveConfig, adversarial);
-  const callLog = [];
-  const warnings = [];
-
-  const rawContext = {
-    ticket: {
-      list: async (params) => {
-        callLog.push({ method: 'ticket.list', params });
-        if (PAGINATED_METHODS.has('ticket.list') && params?.limit === undefined) {
-          warnings.push('ticket.list called without explicit limit — may truncate data');
-        }
-        return { list: mockTickets };
-      },
-      update: async (tickets) => {
-        callLog.push({ method: 'ticket.update', count: Array.isArray(tickets) ? tickets.length : 0 });
-      },
-      append: async (tickets) => {
-        callLog.push({ method: 'ticket.append', count: Array.isArray(tickets) ? tickets.length : 0 });
-        return (tickets || []).map((t, i) => ({ ...t, id: 9000 + i }));
-      },
-    },
-    pool: {
-      getNext: async (valveId) => {
-        callLog.push({ method: 'pool.getNext', valveId });
-        return valveConfig.output_pools.map((p, i) => ({
-          id: 100 + i,
-          name: p.name,
-          description: p.description || '',
-          schema: { fields: [] },
-          type: 'flow_process',
-        }));
-      },
-    },
-    compound: {
-      getStockFromXfcSh: async (params) => {
-        callLog.push({ method: 'compound.getStockFromXfcSh', params });
-        const data = [1, 2].map(i => ({
-          id: i, cas: `12345-67-${i}`, status: '可用',
-          source: 'MockSupplier', barcode: `XFC-MOCK-${i}`,
-          cmpd_id: `CA${1000 + i}`, owner: 'mock@example.com',
-        }));
-        return { data, meta: { count: data.length, page: 1, pageSize: 400, totalPage: 1 } };
-      },
-    },
-    process: {
-      list: async (params) => {
-        callLog.push({ method: 'process.list', params });
-        if (params?.limit === undefined) {
-          warnings.push('process.list called without explicit limit');
-        }
-        return [];
-      },
-      execute: async (items, baseURL) => {
-        callLog.push({ method: 'process.execute', itemCount: Array.isArray(items) ? items.length : 0, baseURL });
-        return { results: { exp_id_list: (items || []).map(() => 'mock-exp-' + Math.random().toString(36).slice(2, 8)) } };
-      },
-    },
-    station: {
-      list: async () => {
-        callLog.push({ method: 'station.list' });
-        return [{ id: 1, name: 'Station-1' }];
-      },
-    },
-  };
-
-  const contextProxy = new Proxy(rawContext, {
-    get(target, prop) {
-      if (typeof prop === 'symbol') return target[prop];
-      if (!KNOWN_SDK_NAMESPACES.has(prop)) {
-        warnings.push(`Unknown SDK namespace accessed: context.${String(prop)}`);
-        return new Proxy({}, {
-          get(_, method) {
-            return async () => {
-              warnings.push(`Unknown SDK method called: context.${String(prop)}.${String(method)}`);
-              return undefined;
-            };
-          },
-        });
-      }
-      return target[prop];
-    },
-  });
-
-  return { context: contextProxy, callLog, warnings, mockTickets };
-}
-
-// ─── Contract validators ───────────────────────────────────────────
-
-const CAMEL_CASE_PATTERN = /^[a-z]+[A-Z]/;
-
-function validateStartResult(result) {
-  const errors = [];
-  if (typeof result !== 'object' || result === null) {
-    errors.push('start() must return an object, got ' + (result === null ? 'null' : typeof result));
-    return errors;
-  }
-  if (typeof result.orbit_link !== 'string') {
-    errors.push(`start().orbit_link must be string, got ${result.orbit_link === undefined ? 'undefined' : typeof result.orbit_link}`);
-  }
-  if (!Array.isArray(result.ticket_ids)) {
-    errors.push(`start().ticket_ids must be array, got ${result.ticket_ids === undefined ? 'undefined' : typeof result.ticket_ids}`);
-  } else if (result.ticket_ids.length > 0 && typeof result.ticket_ids[0] !== 'number') {
-    errors.push(`start().ticket_ids[0] must be number, got ${typeof result.ticket_ids[0]}`);
-  }
-  for (const key of Object.keys(result)) {
-    if (CAMEL_CASE_PATTERN.test(key)) {
-      errors.push(`start() return key "${key}" is camelCase — must be snake_case`);
-    }
-  }
-  return errors;
-}
-
-function validateCompleteResult(result) {
-  const errors = [];
-  if (typeof result !== 'object' || result === null) {
-    errors.push('complete() must return an object, got ' + (result === null ? 'null' : typeof result));
-    return errors;
-  }
-  if (result.new_tickets !== undefined) {
-    if (!Array.isArray(result.new_tickets)) {
-      errors.push(`complete().new_tickets must be array, got ${typeof result.new_tickets}`);
-    } else {
-      for (let i = 0; i < Math.min(result.new_tickets.length, 3); i++) {
-        const t = result.new_tickets[i];
-        if (typeof t.flow_id !== 'number') errors.push(`new_tickets[${i}].flow_id must be number, got ${typeof t.flow_id}`);
-        if (typeof t.pool_id !== 'number') errors.push(`new_tickets[${i}].pool_id must be number, got ${typeof t.pool_id}`);
-        if (typeof t.order_id !== 'number') errors.push(`new_tickets[${i}].order_id must be number, got ${typeof t.order_id}`);
-        if (typeof t.detail !== 'object' || t.detail === null) errors.push(`new_tickets[${i}].detail must be object`);
-        if (typeof t.status !== 'string') errors.push(`new_tickets[${i}].status must be string, got ${typeof t.status}`);
-      }
-    }
-  }
-  for (const key of Object.keys(result)) {
-    if (CAMEL_CASE_PATTERN.test(key)) {
-      errors.push(`complete() return key "${key}" is camelCase — must be snake_case`);
-    }
-  }
-  return errors;
-}
-
-function validateRunResult(result) {
-  const errors = [];
-  if (typeof result !== 'object' || result === null) {
-    errors.push('run() must return an object, got ' + (result === null ? 'null' : typeof result));
-    return errors;
-  }
-  if (result.new_tickets !== undefined) {
-    if (!Array.isArray(result.new_tickets)) {
-      errors.push(`run().new_tickets must be array, got ${typeof result.new_tickets}`);
-    } else {
-      for (let i = 0; i < Math.min(result.new_tickets.length, 3); i++) {
-        const t = result.new_tickets[i];
-        if (typeof t.flow_id !== 'number') errors.push(`new_tickets[${i}].flow_id must be number, got ${typeof t.flow_id}`);
-        if (typeof t.pool_id !== 'number') errors.push(`new_tickets[${i}].pool_id must be number, got ${typeof t.pool_id}`);
-        if (typeof t.order_id !== 'number') errors.push(`new_tickets[${i}].order_id must be number, got ${typeof t.order_id}`);
-        if (typeof t.detail !== 'object' || t.detail === null) errors.push(`new_tickets[${i}].detail must be object`);
-        if (typeof t.status !== 'string') errors.push(`new_tickets[${i}].status must be string, got ${typeof t.status}`);
-      }
-    }
-  }
-  for (const key of Object.keys(result)) {
-    if (CAMEL_CASE_PATTERN.test(key)) {
-      errors.push(`run() return key "${key}" is camelCase — must be snake_case`);
-    }
-  }
-  return errors;
-}
-
-// ─── Script loader via vm ──────────────────────────────────────────
-
-function loadProcesserClass(scriptContent, filename) {
-  const wrapped = scriptContent + '\n;Processer;\n';
-  const script = new Script(wrapped, { filename });
-  const sandbox = {
-    console: {
-      log: () => {},
-      info: () => {},
-      warn: () => {},
-      error: () => {},
-      debug: () => {},
-    },
-    setTimeout, clearTimeout, setInterval, clearInterval,
-    Promise, Array, Object, Map, Set, JSON, Math, Date,
-    Number, String, Boolean, RegExp, Error, TypeError, ReferenceError,
-    parseInt, parseFloat, isNaN, isFinite, undefined, NaN, Infinity,
-    encodeURIComponent, decodeURIComponent, encodeURI, decodeURI,
-    fetch: async (url, opts) => {
-      const method = (opts && opts.method) || 'GET';
-      sandbox.console.warn(`[test-processer] fetch called: ${method} ${url}`);
-      return {
-        ok: true,
-        status: 200,
-        json: async () => ({ data: {} }),
-        text: async () => '{}',
-      };
-    },
-  };
-  const ctx = createContext(sandbox);
-  return script.runInContext(ctx);
-}
-
-// ─── Preview: scenario data generation ────────────────────────────
-
-function generateScenarioValue(field, idx) {
-  const { type, options, default_value, key, label } = field;
-  if (options && options.length) return options[idx % options.length];
-
-  const prefix = (label || key).replace(/\s+/g, '');
-  switch ((type || '').toLowerCase()) {
-    case 'number': case 'integer': case 'float':
-      return 1000 + idx * 100 + Math.round(Math.random() * 50);
-    case 'boolean':
-      return idx % 2 === 0;
-    case 'json': case 'object':
-      return { [`${key}_data`]: idx };
-    case 'array':
-      return [`${prefix}_item_${idx}`];
-    case 'date': case 'datetime':
-      return `2026-0${1 + (idx % 9)}-${String(10 + idx).padStart(2, '0')}T10:00:00Z`;
-    default:
-      return `${prefix}_${1000 + idx}`;
-  }
-}
-
-function generateScenarioTickets(pools, valveConfig) {
-  const inputPoolName = valveConfig.input_pools[0]?.name;
-  const inputPool = pools.find(p => p.name === inputPoolName);
-  const fields = inputPool?.fields || [];
-
-  return [1, 2, 3, 4, 5].map(i => {
-    const detail = {};
-    for (const field of fields) {
-      if (field.key === 'id' || field.key === 'detail') continue;
-      if (i === 4 && !field.default_value && !(field.options?.length)) {
-        detail[field.key] = (field.type || '').match(/number|integer|float/i) ? 0 : '';
-      } else if (i === 5 && field.options && field.options.length > 1) {
-        detail[field.key] = field.options[1];
-      } else {
-        detail[field.key] = generateScenarioValue(field, i);
-      }
-    }
-    return {
-      id: i,
-      flow_id: 1,
-      pool_id: i <= 2 ? 1 : (valveConfig.input_pools.length > 1 ? 2 : 1),
-      order_id: 1000 + i,
-      parent_ticket_id: 0,
-      detail,
-      status: 'created',
-      uuid: `scenario-uuid-${i}`,
-    };
-  });
-}
-
-// ─── Preview: user data loader ────────────────────────────────────
-
-function loadUserData(dataPath, valveConfig) {
-  const raw = readFileSync(resolve(dataPath), 'utf8');
-  const parsed = JSON.parse(raw);
-  const tickets = parsed.tickets;
-  if (!Array.isArray(tickets) || tickets.length === 0) {
-    throw new Error('--data JSON must contain a non-empty "tickets" array');
-  }
-  const defaultPoolId = valveConfig.input_pools.length > 0 ? 1 : 0;
-  return tickets.map((t, i) => ({
-    id: t.id ?? i + 1,
-    flow_id: t.flow_id ?? 1,
-    pool_id: t.pool_id ?? defaultPoolId,
-    order_id: t.order_id ?? 1000 + i + 1,
-    parent_ticket_id: t.parent_ticket_id ?? 0,
-    detail: t.detail ?? {},
-    status: t.status ?? 'created',
-    uuid: t.uuid ?? `user-data-${i + 1}`,
-  }));
-}
-
-// ─── Preview: detail diff ─────────────────────────────────────────
-
-function diffDetail(before, after) {
-  const changes = [];
-  const allKeys = new Set([...Object.keys(before || {}), ...Object.keys(after || {})]);
-  for (const key of allKeys) {
-    const bv = before?.[key];
-    const av = after?.[key];
-    const bStr = JSON.stringify(bv);
-    const aStr = JSON.stringify(av);
-    if (bStr !== aStr) {
-      changes.push({
-        key,
-        before: bv === undefined ? '(无)' : bStr,
-        after: av === undefined ? '(无)' : aStr,
-        type: bv === undefined ? 'added' : av === undefined ? 'removed' : 'changed',
-      });
-    }
-  }
-  return changes;
-}
-
-// ─── Preview: tracing context ─────────────────────────────────────
-
-function createTracingContext(pools, valveConfig, tickets) {
-  const traceLog = [];
-  let seq = 0;
-  const ticketSnapshots = new Map();
-  for (const t of tickets) {
-    ticketSnapshots.set(t.id, JSON.parse(JSON.stringify(t.detail || {})));
-  }
-  const detailDiffs = [];
-
-  function summarize(val) {
-    if (Array.isArray(val)) return `${val.length} items`;
-    if (val && typeof val === 'object' && val.list) return `${val.list.length} tickets`;
-    return JSON.stringify(val)?.slice(0, 60) ?? 'undefined';
-  }
-
-  const rawContext = {
-    ticket: {
-      list: async (params) => {
-        const result = { list: JSON.parse(JSON.stringify(tickets)) };
-        traceLog.push({ seq: seq++, method: 'ticket.list', params: JSON.parse(JSON.stringify(params || {})), returnSummary: `${result.list.length} tickets` });
-        return result;
-      },
-      update: async (updatedTickets) => {
-        const diffs = [];
-        for (const ut of (updatedTickets || [])) {
-          const oldDetail = ticketSnapshots.get(ut.id);
-          const newDetail = ut.detail || {};
-          const changes = diffDetail(oldDetail, newDetail);
-          if (changes.length > 0) {
-            diffs.push({ ticketId: ut.id, changes });
-          }
-          ticketSnapshots.set(ut.id, JSON.parse(JSON.stringify(newDetail)));
-        }
-        const entry = { seq: seq++, method: 'ticket.update', params: { count: (updatedTickets || []).length }, returnSummary: 'void' };
-        if (diffs.length > 0) {
-          entry.detailDiffs = diffs;
-          detailDiffs.push(...diffs);
-        }
-        traceLog.push(entry);
-      },
-      append: async (newTickets) => {
-        const result = (newTickets || []).map((t, i) => ({ ...t, id: 9000 + i }));
-        traceLog.push({ seq: seq++, method: 'ticket.append', params: { count: (newTickets || []).length }, returnSummary: `${result.length} created` });
-        return result;
-      },
-    },
-    pool: {
-      getNext: async (valveId) => {
-        const result = valveConfig.output_pools.map((p, i) => ({
-          id: 100 + i, name: p.name, description: p.description || '',
-          schema: { fields: [] }, type: 'flow_process',
-        }));
-        traceLog.push({ seq: seq++, method: 'pool.getNext', params: { valveId }, returnSummary: `${result.length} pools: ${result.map(p => p.name).join(', ')}` });
-        return result;
-      },
-    },
-    compound: {
-      getStockFromXfcSh: async (params) => {
-        const data = [1, 2].map(i => ({
-          id: i, cas: `12345-67-${i}`, status: '可用',
-          source: 'MockSupplier', barcode: `XFC-MOCK-${i}`,
-          cmpd_id: `CA${1000 + i}`, owner: 'mock@example.com',
-        }));
-        const result = { data, meta: { count: data.length, page: 1, pageSize: 400, totalPage: 1 } };
-        traceLog.push({ seq: seq++, method: 'compound.getStockFromXfcSh', params: JSON.parse(JSON.stringify(params || {})), returnSummary: `${data.length} records` });
-        return result;
-      },
-    },
-    process: {
-      list: async (params) => {
-        traceLog.push({ seq: seq++, method: 'process.list', params: JSON.parse(JSON.stringify(params || {})), returnSummary: '0 processes' });
-        return [];
-      },
-      execute: async (items, baseURL) => {
-        const result = { results: { exp_id_list: (items || []).map(() => 'mock-exp-' + Math.random().toString(36).slice(2, 8)) } };
-        traceLog.push({ seq: seq++, method: 'process.execute', params: { itemCount: (items || []).length, baseURL }, returnSummary: `${(items || []).length} executed` });
-        return result;
-      },
-    },
-    station: {
-      list: async () => {
-        const result = [{ id: 1, name: 'Station-1' }];
-        traceLog.push({ seq: seq++, method: 'station.list', params: {}, returnSummary: `${result.length} stations` });
-        return result;
-      },
-    },
-  };
-
-  const contextProxy = new Proxy(rawContext, {
-    get(target, prop) {
-      if (typeof prop === 'symbol') return target[prop];
-      if (!KNOWN_SDK_NAMESPACES.has(prop)) {
-        traceLog.push({ seq: seq++, method: `(unknown) ${String(prop)}.*`, params: {}, returnSummary: 'unknown namespace' });
-        return new Proxy({}, {
-          get(_, method) {
-            return async (...fnArgs) => {
-              traceLog.push({ seq: seq++, method: `${String(prop)}.${String(method)}`, params: fnArgs, returnSummary: 'undefined (unknown)' });
-              return undefined;
-            };
-          },
-        });
-      }
-      return target[prop];
-    },
-  });
-
-  return { context: contextProxy, traceLog, detailDiffs, ticketSnapshots };
-}
-
-// ─── Preview: report formatter ────────────────────────────────────
-
-function formatTicketsTable(tickets, maxDetailKeys) {
-  if (tickets.length === 0) return '(无 tickets)\n';
-  const detailKeys = maxDetailKeys || [...new Set(tickets.flatMap(t => Object.keys(t.detail || {})))].slice(0, 8);
-  const headers = ['id', 'order_id', ...detailKeys, 'status'];
-  const rows = tickets.map(t => {
-    const d = t.detail || {};
-    return [t.id, t.order_id, ...detailKeys.map(k => {
-      const v = d[k];
-      if (v === undefined || v === null) return '-';
-      if (typeof v === 'object') return JSON.stringify(v).slice(0, 30);
-      return String(v).slice(0, 30);
-    }), t.status];
-  });
-  const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map(r => String(r[i]).length)));
-  const pad = (s, w) => String(s).padEnd(w);
-  const line = colWidths.map(w => '-'.repeat(w));
-  const fmt = row => '| ' + row.map((c, i) => pad(c, colWidths[i])).join(' | ') + ' |';
-  return [fmt(headers), '| ' + line.map(l => l).join(' | ') + ' |', ...rows.map(fmt)].join('\n') + '\n';
-}
-
-function formatPreviewReport(trace) {
-  const { scriptPath, valveName, valveConfig, pools, dataSource,
-          inputTickets, isAutoTrigger,
-          startResult, startError, startTraceLog, startDetailDiffs,
-          completeTickets, completeResult, completeError, completeTraceLog, completeDetailDiffs,
-          runResult, runError, runTraceLog, runDetailDiffs } = trace;
-
-  const lines = [];
-  const push = (...args) => lines.push(...args);
-
-  push('# 脚本预览报告', '');
-
-  // Basic info
-  push('## 基本信息');
-  push(`- 脚本: \`${basename(scriptPath)}\``);
-  push(`- 门控: ${valveName}`);
-  const inputPoolNames = valveConfig.input_pools.map(p => p.name).join(', ') || '(未知)';
-  const outputPoolNames = valveConfig.output_pools.map(p => p.name).join(', ') || '(未知)';
-  push(`- 入口池: ${inputPoolNames}`);
-  push(`- 出口池: ${outputPoolNames}`);
-  push(`- 数据来源: ${dataSource}`);
-  push(`- tickets 数: ${inputTickets.length}`);
-  push(`- 触发方式: ${isAutoTrigger ? '自动触发 (run)' : '人工触发 (start/complete)'}`, '');
-
-  if (isAutoTrigger) {
-    // run() trace
-    push('## run() 执行追踪', '');
-    push(`### 输入数据 (${inputTickets.length} 条 tickets)`, '');
-    push(formatTicketsTable(inputTickets));
-
-    push('### SDK 调用链', '');
-    for (const entry of (runTraceLog || [])) {
-      const paramStr = JSON.stringify(entry.params);
-      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
-    }
-    push('');
-
-    if (runDetailDiffs && runDetailDiffs.length > 0) {
-      push('### ticket.detail 变更 (run 阶段)', '');
-      push('| ticket | 字段 | 变更前 | 变更后 |');
-      push('|--------|------|--------|--------|');
-      for (const d of runDetailDiffs) {
-        for (const c of d.changes) {
-          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
-        }
-      }
-      push('');
-    }
-
-    if (runError) {
-      push(`### run() 错误`, '');
-      push(`\`\`\`\n${runError}\n\`\`\``, '');
-    } else if (runResult) {
-      push('### 数据路由', '');
-      if (runResult.new_tickets && runResult.new_tickets.length > 0) {
-        const routeMap = new Map();
-        for (const nt of runResult.new_tickets) {
-          const poolId = nt.pool_id;
-          if (!routeMap.has(poolId)) routeMap.set(poolId, []);
-          routeMap.get(poolId).push(nt);
-        }
-        push('| 目标池 | pool_id | 数量 | status |');
-        push('|--------|---------|------|--------|');
-        for (const [poolId, nts] of routeMap) {
-          const poolName = valveConfig.output_pools.find((_, i) => 100 + i === poolId)?.name || `pool_${poolId}`;
-          push(`| ${poolName} | ${poolId} | ${nts.length} | ${nts[0]?.status || '-'} |`);
-        }
-        push('');
-      } else {
-        push('(无 new_tickets 返回)', '');
-      }
-    }
-
-    // Summary
-    push('## 执行摘要', '');
-    const usedMethods = new Set((runTraceLog || []).map(c => c.method));
-    const allMethods = ['ticket.list', 'ticket.update', 'ticket.append', 'pool.getNext',
-      'compound.getStockFromXfcSh', 'process.list', 'process.execute', 'station.list'];
-    const unused = allMethods.filter(m => !usedMethods.has(m));
-
-    const runStatus = runError
-      ? `✗ 失败: ${runError.split('\n')[0]}`
-      : `✓ 成功 (${(runTraceLog || []).length} SDK 调用, ${(runResult?.new_tickets || []).length} new_tickets)`;
-
-    push(`- run: ${runStatus}`);
-    if (unused.length > 0) {
-      push(`- 未调用的 SDK 方法: ${unused.join(', ')}`);
-    }
-    push('');
-  } else {
-    // start() trace
-    push('## start() 执行追踪', '');
-    push(`### 输入数据 (${inputTickets.length} 条 tickets)`, '');
-    push(formatTicketsTable(inputTickets));
-
-    push('### SDK 调用链', '');
-    for (const entry of startTraceLog) {
-      const paramStr = JSON.stringify(entry.params);
-      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
-    }
-    push('');
-
-    if (startDetailDiffs.length > 0) {
-      push('### ticket.detail 变更 (start 阶段)', '');
-      push('| ticket | 字段 | 变更前 | 变更后 |');
-      push('|--------|------|--------|--------|');
-      for (const d of startDetailDiffs) {
-        for (const c of d.changes) {
-          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
-        }
-      }
-      push('');
-    }
-
-    if (startError) {
-      push(`### start() 错误`, '');
-      push(`\`\`\`\n${startError}\n\`\`\``, '');
-    } else if (startResult) {
-      push('### 返回值', '');
-      push(`- orbit_link: \`${startResult.orbit_link}\``);
-      push(`- ticket_ids: [${(startResult.ticket_ids || []).join(', ')}]`);
-      push('');
-    }
-
-    // complete() trace
-    push('## complete() 执行追踪', '');
-    push(`### 输入 tickets (${(completeTickets || []).length} 条)`, '');
-
-    push('### SDK 调用链', '');
-    for (const entry of completeTraceLog) {
-      const paramStr = JSON.stringify(entry.params);
-      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
-    }
-    push('');
-
-    if (completeDetailDiffs.length > 0) {
-      push('### ticket.detail 变更 (complete 阶段)', '');
-      push('| ticket | 字段 | 变更前 | 变更后 |');
-      push('|--------|------|--------|--------|');
-      for (const d of completeDetailDiffs) {
-        for (const c of d.changes) {
-          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
-        }
-      }
-      push('');
-    }
-
-    if (completeError) {
-      push(`### complete() 错误`, '');
-      push(`\`\`\`\n${completeError}\n\`\`\``, '');
-    } else if (completeResult) {
-      push('### 数据路由', '');
-      if (completeResult.new_tickets && completeResult.new_tickets.length > 0) {
-        const routeMap = new Map();
-        for (const nt of completeResult.new_tickets) {
-          const poolId = nt.pool_id;
-          if (!routeMap.has(poolId)) routeMap.set(poolId, []);
-          routeMap.get(poolId).push(nt);
-        }
-        push('| 目标池 | pool_id | 数量 | status |');
-        push('|--------|---------|------|--------|');
-        for (const [poolId, nts] of routeMap) {
-          const poolName = valveConfig.output_pools.find((_, i) => 100 + i === poolId)?.name || `pool_${poolId}`;
-          push(`| ${poolName} | ${poolId} | ${nts.length} | ${nts[0]?.status || '-'} |`);
-        }
-        push('');
-      } else {
-        push('(无 new_tickets 返回)', '');
-      }
-    }
-
-    // Summary
-    push('## 执行摘要', '');
-    const allCalls = [...startTraceLog, ...completeTraceLog];
-    const usedMethods = new Set(allCalls.map(c => c.method));
-    const allMethods = ['ticket.list', 'ticket.update', 'ticket.append', 'pool.getNext',
-      'compound.getStockFromXfcSh', 'process.list', 'process.execute', 'station.list'];
-    const unused = allMethods.filter(m => !usedMethods.has(m));
-
-    const startStatus = startError ? `✗ 失败: ${startError.split('\n')[0]}` : `✓ 成功 (${startTraceLog.length} SDK 调用, ${inputTickets.length} tickets)`;
-    const completeStatus = completeError
-      ? `✗ 失败: ${completeError.split('\n')[0]}`
-      : `✓ 成功 (${completeTraceLog.length} SDK 调用, ${(completeResult?.new_tickets || []).length} new_tickets)`;
-
-    push(`- start: ${startStatus}`);
-    push(`- complete: ${completeStatus}`);
-    if (unused.length > 0) {
-      push(`- 未调用的 SDK 方法: ${unused.join(', ')}`);
-    }
-    push('');
-  }
-
-  return lines.join('\n');
-}
-
-// ─── Preview: main runner ─────────────────────────────────────────
-
-async function runPreview(args) {
-  const scriptPath = resolve(args.script);
-  const poolsDir = args.poolsDir ? resolve(args.poolsDir) : null;
-  const valvesDir = args.valvesDir ? resolve(args.valvesDir) : null;
-  const valveName = args.valveName || basename(scriptPath, '.js');
-
-  let scriptContent;
-  try {
-    scriptContent = readFileSync(scriptPath, 'utf8');
-  } catch (e) {
-    console.error(`Cannot read script: ${e.message}`);
-    process.exit(1);
-  }
-
-  let ProcesserClass;
-  try {
-    ProcesserClass = loadProcesserClass(scriptContent, basename(scriptPath));
-  } catch (e) {
-    console.error(`Cannot load Processer: ${e.message}`);
-    process.exit(1);
-  }
-
-  const pools = loadAllPools(poolsDir);
-  const valveConfig = loadValveConfig(valvesDir, valveName);
-
-  let inputTickets;
-  let dataSource;
-  if (args.dataPath) {
-    try {
-      inputTickets = loadUserData(args.dataPath, valveConfig);
-      dataSource = `用户数据 (${basename(args.dataPath)})`;
-    } catch (e) {
-      console.error(`Cannot load --data: ${e.message}`);
-      process.exit(1);
-    }
-  } else {
-    inputTickets = generateScenarioTickets(pools, valveConfig);
-    dataSource = '自动生成';
-  }
-
-  const inputPoolIds = valveConfig.input_pools.map((_, i) => i + 1);
-  const proto = ProcesserClass.prototype;
-  const isAutoTrigger = typeof proto.run === 'function' && typeof proto.start !== 'function';
-
-  const trace = {
-    scriptPath, valveName, valveConfig, pools, dataSource, inputTickets, isAutoTrigger,
-    startResult: null, startError: null, startTraceLog: [], startDetailDiffs: [],
-    completeTickets: null, completeResult: null, completeError: null, completeTraceLog: [], completeDetailDiffs: [],
-    runResult: null, runError: null, runTraceLog: [], runDetailDiffs: [],
-  };
-
-  if (isAutoTrigger) {
-    // Auto-trigger: run()
-    const tc = createTracingContext(pools, valveConfig, inputTickets);
-    let processer;
-    try {
-      processer = new ProcesserClass(tc.context);
-    } catch (e) {
-      trace.runError = `constructor threw: ${e.message}\n${e.stack}`;
-      console.log(formatPreviewReport(trace));
-      process.exit(1);
-    }
-
-    try {
-      trace.runResult = await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
-    } catch (e) {
-      trace.runError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
-    }
-    trace.runTraceLog = tc.traceLog;
-    trace.runDetailDiffs = tc.detailDiffs;
-  } else {
-    // Manual-trigger: start() + complete()
-    // Run start()
-    {
-      const tc = createTracingContext(pools, valveConfig, inputTickets);
-      let processer;
-      try {
-        processer = new ProcesserClass(tc.context);
-      } catch (e) {
-        trace.startError = `constructor threw: ${e.message}\n${e.stack}`;
-        console.log(formatPreviewReport(trace));
-        process.exit(1);
-      }
-
-      try {
-        trace.startResult = await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
-      } catch (e) {
-        trace.startError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
-      }
-      trace.startTraceLog = tc.traceLog;
-      trace.startDetailDiffs = tc.detailDiffs;
-    }
-
-    // Run complete()
-    {
-      const completeTickets = inputTickets.map(t => ({ ...t, status: 'created' }));
-      trace.completeTickets = completeTickets;
-
-      const tc = createTracingContext(pools, valveConfig, completeTickets);
-      let processer;
-      try {
-        processer = new ProcesserClass(tc.context);
-      } catch (e) {
-        trace.completeError = `constructor threw: ${e.message}\n${e.stack}`;
-        console.log(formatPreviewReport(trace));
-        process.exit(1);
-      }
-
-      try {
-        trace.completeResult = await processer.complete({ valve_id: 1, tickets: completeTickets });
-      } catch (e) {
-        trace.completeError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
-      }
-      trace.completeTraceLog = tc.traceLog;
-      trace.completeDetailDiffs = tc.detailDiffs;
-    }
-  }
-
-  console.log(formatPreviewReport(trace));
-  const hasError = isAutoTrigger ? trace.runError : (trace.startError || trace.completeError);
-  process.exit(hasError ? 1 : 0);
-}
-
-// ─── Main test runner ──────────────────────────────────────────────
-
-async function runTests(args) {
-  const scriptPath = resolve(args.script);
-  const poolsDir = args.poolsDir ? resolve(args.poolsDir) : null;
-  const valvesDir = args.valvesDir ? resolve(args.valvesDir) : null;
-  const valveName = args.valveName || basename(scriptPath, '.js');
-
-  const result = {
-    status: 'pass',
-    script: scriptPath,
-    phases: {
-      syntax: { pass: false },
-      structure: { pass: false, hasConstructor: false, hasStart: false, hasComplete: false, hasRun: false },
-      normalRun: {
-        start: { pass: false, returnValid: false, errors: [] },
-        complete: { pass: false, returnValid: false, errors: [] },
-      },
-      adversarialRun: {
-        start: { pass: false, errors: [] },
-        complete: { pass: false, errors: [] },
-        note: '对抗轮失败为警告，不阻断',
-      },
-      compliance: { pass: true, warnings: [] },
-    },
-    sdkCalls: [],
-    errors: [],
-    warnings: [],
-  };
-
-  // Phase 1: Syntax check
-  let scriptContent;
-  try {
-    scriptContent = readFileSync(scriptPath, 'utf8');
-  } catch (e) {
-    result.errors.push(`Cannot read script file: ${e.message}`);
-    result.status = 'fail';
-    return result;
-  }
-
-  let ProcesserClass;
-  try {
-    new Script(scriptContent, { filename: basename(scriptPath) });
-    result.phases.syntax.pass = true;
-  } catch (e) {
-    result.phases.syntax.pass = false;
-    result.phases.syntax.error = e.message;
-    result.errors.push(`SyntaxError: ${e.message}`);
-    result.status = 'fail';
-    return result;
-  }
-
-  // Phase 2: Structure check
-  try {
-    ProcesserClass = loadProcesserClass(scriptContent, basename(scriptPath));
-  } catch (e) {
-    result.errors.push(`Failed to load Processer class: ${e.message}`);
-    result.status = 'fail';
-    return result;
-  }
-
-  if (typeof ProcesserClass !== 'function') {
-    result.errors.push('Script does not define a Processer class (or class is not the last declaration)');
-    result.status = 'fail';
-    return result;
-  }
-
-  const proto = ProcesserClass.prototype;
-  result.phases.structure.hasConstructor = typeof ProcesserClass === 'function';
-  result.phases.structure.hasStart = typeof proto.start === 'function';
-  result.phases.structure.hasComplete = typeof proto.complete === 'function';
-  result.phases.structure.hasRun = typeof proto.run === 'function';
-  result.phases.structure.pass =
-    result.phases.structure.hasConstructor &&
-    (
-      (result.phases.structure.hasStart && result.phases.structure.hasComplete) ||
-      result.phases.structure.hasRun
-    );
-
-  if (!result.phases.structure.pass) {
-    if (!result.phases.structure.hasRun && !result.phases.structure.hasStart) result.errors.push('Processer missing start() method (manual-trigger) or run() method (auto-trigger)');
-    if (!result.phases.structure.hasRun && !result.phases.structure.hasComplete) result.errors.push('Processer missing complete() method (manual-trigger) or run() method (auto-trigger)');
-    result.status = 'fail';
-    return result;
-  }
-
-  const isAutoTrigger = result.phases.structure.hasRun && !result.phases.structure.hasStart;
-
-  // Load pool schemas and valve config
-  const pools = loadAllPools(poolsDir);
-  const valveConfig = loadValveConfig(valvesDir, valveName);
-  const inputPoolIds = valveConfig.input_pools.map((_, i) => i + 1);
-
-  // Phase 3: Normal run
-  {
-    const mock = createMockContext(pools, valveConfig, false);
-    let processer;
-    try {
-      processer = new ProcesserClass(mock.context);
-    } catch (e) {
-      const phaseKey = isAutoTrigger ? 'run' : 'start';
-      if (!result.phases.normalRun[phaseKey]) result.phases.normalRun[phaseKey] = { pass: false, returnValid: false, errors: [] };
-      result.phases.normalRun[phaseKey].errors.push(`constructor threw: ${e.message}`);
-      result.errors.push(`Normal run constructor error: ${e.message}`);
-      result.status = 'fail';
-      return result;
-    }
-
-    if (isAutoTrigger) {
-      // Auto-trigger: test run()
-      if (!result.phases.normalRun.run) result.phases.normalRun.run = { pass: false, returnValid: false, errors: [] };
-      try {
-        const runResult = await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
-        const runErrors = validateRunResult(runResult);
-        result.phases.normalRun.run.returnValid = runErrors.length === 0;
-        result.phases.normalRun.run.errors = runErrors;
-        result.phases.normalRun.run.pass = runErrors.length === 0;
-        if (runErrors.length > 0) {
-          result.errors.push(...runErrors.map(e => `[normal run] ${e}`));
-        }
-      } catch (e) {
-        result.phases.normalRun.run.errors.push(e.message);
-        result.errors.push(`[normal run] Runtime error: ${e.message}`);
-      }
-    } else {
-      // Manual-trigger: test start() + complete()
-      // start
-      try {
-        const startResult = await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
-        const startErrors = validateStartResult(startResult);
-        result.phases.normalRun.start.returnValid = startErrors.length === 0;
-        result.phases.normalRun.start.errors = startErrors;
-        result.phases.normalRun.start.pass = startErrors.length === 0;
-        if (startErrors.length > 0) {
-          result.errors.push(...startErrors.map(e => `[normal start] ${e}`));
-        }
-      } catch (e) {
-        result.phases.normalRun.start.errors.push(e.message);
-        result.errors.push(`[normal start] Runtime error: ${e.message}`);
-      }
-
-      // complete — use mock tickets from the start phase (with updated details if any)
-      try {
-        const completeTickets = mock.mockTickets.map(t => ({ ...t, status: 'created' }));
-        const completeResult = await processer.complete({ valve_id: 1, tickets: completeTickets });
-        const completeErrors = validateCompleteResult(completeResult);
-        result.phases.normalRun.complete.returnValid = completeErrors.length === 0;
-        result.phases.normalRun.complete.errors = completeErrors;
-        result.phases.normalRun.complete.pass = completeErrors.length === 0;
-        if (completeErrors.length > 0) {
-          result.errors.push(...completeErrors.map(e => `[normal complete] ${e}`));
-        }
-      } catch (e) {
-        result.phases.normalRun.complete.errors.push(e.message);
-        result.errors.push(`[normal complete] Runtime error: ${e.message}`);
-      }
-    }
-
-    result.sdkCalls = [...new Set(mock.callLog.map(c => c.method))];
-    result.phases.compliance.warnings.push(...mock.warnings);
-
-    // Check limit/offset compliance
-    for (const call of mock.callLog) {
-      if (PAGINATED_METHODS.has(call.method) && call.params && call.params.limit === undefined) {
-        result.phases.compliance.warnings.push(
-          `${call.method} called without limit parameter`
-        );
-      }
-    }
-
-    // Check for sandbox-unavailable APIs in source code
-    const UNAVAILABLE_APIS = ['URLSearchParams', 'TextEncoder', 'TextDecoder', 'Buffer'];
-    for (const api of UNAVAILABLE_APIS) {
-      if (scriptContent.includes(api)) {
-        result.phases.compliance.warnings.push(
-          `Script uses '${api}' which is not available in the gate script sandbox — use template literals + encodeURIComponent instead`
-        );
-      }
-    }
-  }
-
-  const normalPass = isAutoTrigger
-    ? result.phases.normalRun.run?.pass
-    : result.phases.normalRun.start.pass && result.phases.normalRun.complete.pass;
-  if (!normalPass) {
-    result.status = 'fail';
-  }
-
-  // Phase 4: Adversarial run
-  {
-    const mock = createMockContext(pools, valveConfig, true);
-    let processer;
-    try {
-      processer = new ProcesserClass(mock.context);
-    } catch (e) {
-      const phaseKey = isAutoTrigger ? 'run' : 'start';
-      if (!result.phases.adversarialRun[phaseKey]) result.phases.adversarialRun[phaseKey] = { pass: false, errors: [] };
-      result.phases.adversarialRun[phaseKey].errors.push(`constructor threw: ${e.message}`);
-      result.warnings.push(`[adversarial] constructor error: ${e.message}`);
-    }
-
-    if (processer) {
-      if (isAutoTrigger) {
-        if (!result.phases.adversarialRun.run) result.phases.adversarialRun.run = { pass: false, errors: [] };
-        try {
-          await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
-          result.phases.adversarialRun.run.pass = true;
-        } catch (e) {
-          result.phases.adversarialRun.run.errors.push(e.message);
-          result.warnings.push(`[adversarial run] ${e.constructor.name}: ${e.message}`);
-        }
-      } else {
-        try {
-          await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
-          result.phases.adversarialRun.start.pass = true;
-        } catch (e) {
-          result.phases.adversarialRun.start.errors.push(e.message);
-          result.warnings.push(`[adversarial start] ${e.constructor.name}: ${e.message}`);
-        }
-
-        try {
-          const completeTickets = mock.mockTickets.map(t => ({ ...t, status: 'created' }));
-          await processer.complete({ valve_id: 1, tickets: completeTickets });
-          result.phases.adversarialRun.complete.pass = true;
-        } catch (e) {
-          result.phases.adversarialRun.complete.errors.push(e.message);
-          result.warnings.push(`[adversarial complete] ${e.constructor.name}: ${e.message}`);
-        }
-      }
-
-      result.phases.compliance.warnings.push(
-        ...mock.warnings.filter(w => !result.phases.compliance.warnings.includes(w))
-      );
-    }
-  }
-
-  // Phase 5: Compliance
-  if (result.phases.compliance.warnings.length > 0) {
-    result.warnings.push(...result.phases.compliance.warnings);
-  }
-  result.phases.compliance.pass = result.phases.compliance.warnings.filter(
-    w => w.includes('Unknown SDK')
-  ).length === 0;
-
-  if (!result.phases.compliance.pass) {
-    result.status = 'fail';
-  }
-
-  return result;
-}
-
-// ─── Entry point ───────────────────────────────────────────────────
-
-const args = parseArgs(process.argv);
-
-if (args.preview) {
-  runPreview(args).catch(e => {
-    console.error(`Preview failed: ${e.message}`);
-    process.exit(1);
-  });
-} else {
-  runTests(args)
-    .then(result => {
-      console.log(JSON.stringify(result, null, 2));
-      process.exit(result.status === 'pass' ? 0 : 1);
-    })
-    .catch(e => {
-      console.error(JSON.stringify({ status: 'fail', errors: [e.message] }));
-      process.exit(1);
-    });
-}
+#!/usr/bin/env node
+/**
+ * Processer script test harness for lab-flow-designer.
+ * Zero external dependencies — Node.js built-ins only.
+ *
+ * Usage:
+ *   node test-processer.mjs \
+ *     --script <path-to-script.js> \
+ *     --pools-dir <path-to-pools-dir> \
+ *     --valves-dir <path-to-valves-dir> \
+ *     --valve-name <valve-base-name>
+ */
+
+import { Script, createContext } from 'node:vm';
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { resolve, join, basename } from 'node:path';
+
+// ─── CLI arg parsing ───────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 2; i < argv.length; i++) {
+    if (argv[i] === '--script') args.script = argv[++i];
+    else if (argv[i] === '--pools-dir') args.poolsDir = argv[++i];
+    else if (argv[i] === '--valves-dir') args.valvesDir = argv[++i];
+    else if (argv[i] === '--valve-name') args.valveName = argv[++i];
+    else if (argv[i] === '--preview') args.preview = true;
+    else if (argv[i] === '--data') args.dataPath = argv[++i];
+  }
+  if (!args.script) {
+    console.error('Missing --script <path>');
+    process.exit(1);
+  }
+  return args;
+}
+
+// ─── Markdown parsers ──────────────────────────────────────────────
+
+function parseMarkdownTable(text) {
+  const lines = text.split('\n').filter(l => l.trim().startsWith('|'));
+  if (lines.length < 3) return { headers: [], rows: [] };
+  const split = line => line.split('|').map(c => c.trim()).filter(Boolean);
+  const headers = split(lines[0]);
+  const rows = lines.slice(2).map(split);
+  return { headers, rows };
+}
+
+function parsePoolMarkdown(content) {
+  const nameMatch = content.match(/^#\s+(.+)$/m);
+  const name = nameMatch ? nameMatch[1].trim() : 'unknown';
+
+  const schemaParts = content.split(/^##\s+Schema\s*$/m);
+  if (schemaParts.length < 2) return { name, fields: [] };
+
+  const schemaSection = schemaParts[1].split(/^##\s+/m)[0];
+  const { headers, rows } = parseMarkdownTable(schemaSection);
+
+  const colIdx = h => {
+    const lower = h.toLowerCase();
+    return headers.findIndex(hdr => hdr.toLowerCase() === lower || hdr === h);
+  };
+
+  const iKey = Math.max(colIdx('字段'), colIdx('key'), 0);
+  const iLabel = Math.max(colIdx('字段标题'), colIdx('label'), -1);
+  const iDesc = Math.max(colIdx('字段描述'), colIdx('description'), -1);
+  const iType = Math.max(colIdx('字段类型'), colIdx('type'), -1);
+  const iOptions = Math.max(colIdx('属性'), colIdx('options'), -1);
+  const iDefault = Math.max(colIdx('默认值'), colIdx('default_value'), -1);
+
+  const fields = rows.map(cells => {
+    const key = (cells[iKey] || '').trim();
+    const type = iType >= 0 ? (cells[iType] || 'text').trim() : 'text';
+    const optRaw = iOptions >= 0 ? (cells[iOptions] || '').trim() : '';
+    let options;
+    if (optRaw && optRaw !== '-') {
+      const enumMatch = optRaw.match(/^枚举[：:]\s*(.+)/);
+      if (enumMatch) {
+        options = enumMatch[1].split(/[,，、]/).map(s => s.trim()).filter(Boolean);
+      }
+    }
+    const defRaw = iDefault >= 0 ? (cells[iDefault] || '').trim() : '';
+    const default_value = defRaw && defRaw !== '-' ? defRaw : undefined;
+    return {
+      key,
+      label: iLabel >= 0 ? (cells[iLabel] || key).trim() : key,
+      description: iDesc >= 0 ? (cells[iDesc] || '').trim() : '',
+      type,
+      options,
+      default_value,
+    };
+  }).filter(f => f.key);
+
+  return { name, fields };
+}
+
+function parseValveMarkdown(content) {
+  const nameMatch = content.match(/^#\s+(.+)$/m);
+  const name = nameMatch ? nameMatch[1].trim() : 'unknown';
+
+  const input_pools = [];
+  const output_pools = [];
+
+  const yamlMatch = content.match(/```yaml\n([\s\S]*?)```/);
+  if (yamlMatch) {
+    const yaml = yamlMatch[1];
+    const primaryMatch = yaml.match(/primary:\s*(.+)/);
+    if (primaryMatch) input_pools.push({ name: primaryMatch[1].trim() });
+    const secondaryMatches = yaml.matchAll(/secondary:\s*(.+)/g);
+    for (const m of secondaryMatches) input_pools.push({ name: m[1].trim() });
+    const poolMatches = yaml.matchAll(/(?:pool|Stash):\s*(.+)/g);
+    for (const m of poolMatches) output_pools.push({ name: m[1].trim() });
+  }
+
+  if (input_pools.length === 0) {
+    const m = content.match(/\*\*输入池\*\*[：:]\s*(.+)/);
+    if (m) input_pools.push({ name: m[1].trim() });
+  }
+  if (output_pools.length === 0) {
+    const m = content.match(/\*\*输出池\*\*[：:]\s*(.+)/);
+    if (m) m[1].split(/[,，、]/).forEach(p => {
+      const cleaned = p.replace(/[（(].*?[）)]/, '').trim();
+      if (cleaned) output_pools.push({ name: cleaned });
+    });
+  }
+
+  return { name, input_pools, output_pools };
+}
+
+function loadAllPools(poolsDir) {
+  if (!poolsDir || !existsSync(poolsDir)) return [];
+  return readdirSync(poolsDir)
+    .filter(f => f.endsWith('.md'))
+    .map(f => {
+      const content = readFileSync(join(poolsDir, f), 'utf8');
+      return parsePoolMarkdown(content);
+    });
+}
+
+function loadValveConfig(valvesDir, valveName) {
+  if (!valvesDir || !valveName) return { name: 'unknown', input_pools: [{ name: '入口池' }], output_pools: [{ name: '出口池' }] };
+  const filePath = join(valvesDir, `${valveName}.md`);
+  if (!existsSync(filePath)) return { name: valveName, input_pools: [{ name: '入口池' }], output_pools: [{ name: '出口池' }] };
+  return parseValveMarkdown(readFileSync(filePath, 'utf8'));
+}
+
+// ─── Mock data generation ──────────────────────────────────────────
+
+function generateValueForType(field, seed) {
+  const { type, options, default_value, key } = field;
+  if (default_value && default_value !== '-') return default_value;
+  if (options && options.length) return options[seed % options.length];
+
+  switch ((type || '').toLowerCase()) {
+    case 'number': case 'integer': case 'float':
+      return seed * 10.5;
+    case 'boolean':
+      return seed % 2 === 0;
+    case 'json': case 'object':
+      return {};
+    case 'array':
+      return [];
+    case 'date': case 'datetime':
+      return '2026-01-15T10:00:00Z';
+    default:
+      return `mock_${key}_${seed}`;
+  }
+}
+
+function generateAdversarialValue(field) {
+  switch ((field.type || '').toLowerCase()) {
+    case 'text': case 'string':
+      return Math.random() > 0.5 ? null : 12345;
+    case 'number': case 'integer': case 'float':
+      return Math.random() > 0.5 ? null : 'not-a-number';
+    case 'boolean':
+      return null;
+    default:
+      return null;
+  }
+}
+
+function generateDetailFromSchema(fields, seed, adversarial) {
+  const detail = {};
+  for (const field of fields) {
+    if (field.key === 'id' || field.key === 'detail') continue;
+    detail[field.key] = adversarial
+      ? generateAdversarialValue(field)
+      : generateValueForType(field, seed);
+  }
+  return detail;
+}
+
+function generateMockTickets(pools, valveConfig, adversarial) {
+  const inputPoolName = valveConfig.input_pools[0]?.name;
+  const inputPool = pools.find(p => p.name === inputPoolName);
+  const fields = inputPool?.fields || [];
+
+  return [1, 2, 3].map(i => ({
+    id: i,
+    flow_id: 1,
+    pool_id: i <= 1 ? 1 : (valveConfig.input_pools.length > 1 ? 2 : 1),
+    order_id: 1000 + i,
+    parent_ticket_id: 0,
+    detail: generateDetailFromSchema(fields, i, adversarial && i === 3),
+    status: 'created',
+    uuid: `mock-uuid-${i}`,
+  }));
+}
+
+// ─── Mock context factory ──────────────────────────────────────────
+
+const KNOWN_SDK_NAMESPACES = new Set(['ticket', 'pool', 'compound', 'process', 'station']);
+
+const PAGINATED_METHODS = new Set([
+  'ticket.list', 'process.list', 'compound.getStockFromXfcSh',
+]);
+
+function createMockContext(pools, valveConfig, adversarial) {
+  const mockTickets = generateMockTickets(pools, valveConfig, adversarial);
+  const callLog = [];
+  const warnings = [];
+
+  const rawContext = {
+    ticket: {
+      list: async (params) => {
+        callLog.push({ method: 'ticket.list', params });
+        if (PAGINATED_METHODS.has('ticket.list') && params?.limit === undefined) {
+          warnings.push('ticket.list called without explicit limit — may truncate data');
+        }
+        return { list: mockTickets };
+      },
+      update: async (tickets) => {
+        callLog.push({ method: 'ticket.update', count: Array.isArray(tickets) ? tickets.length : 0 });
+      },
+      append: async (tickets) => {
+        callLog.push({ method: 'ticket.append', count: Array.isArray(tickets) ? tickets.length : 0 });
+        return (tickets || []).map((t, i) => ({ ...t, id: 9000 + i }));
+      },
+    },
+    pool: {
+      getNext: async (valveId) => {
+        callLog.push({ method: 'pool.getNext', valveId });
+        return valveConfig.output_pools.map((p, i) => ({
+          id: 100 + i,
+          name: p.name,
+          description: p.description || '',
+          schema: { fields: [] },
+          type: 'flow_process',
+        }));
+      },
+    },
+    compound: {
+      getStockFromXfcSh: async (params) => {
+        callLog.push({ method: 'compound.getStockFromXfcSh', params });
+        const data = [1, 2].map(i => ({
+          id: i, cas: `12345-67-${i}`, status: '可用',
+          source: 'MockSupplier', barcode: `XFC-MOCK-${i}`,
+          cmpd_id: `CA${1000 + i}`, owner: 'mock@example.com',
+        }));
+        return { data, meta: { count: data.length, page: 1, pageSize: 400, totalPage: 1 } };
+      },
+    },
+    process: {
+      list: async (params) => {
+        callLog.push({ method: 'process.list', params });
+        if (params?.limit === undefined) {
+          warnings.push('process.list called without explicit limit');
+        }
+        return [];
+      },
+      execute: async (items, baseURL) => {
+        callLog.push({ method: 'process.execute', itemCount: Array.isArray(items) ? items.length : 0, baseURL });
+        return { results: { exp_id_list: (items || []).map(() => 'mock-exp-' + Math.random().toString(36).slice(2, 8)) } };
+      },
+    },
+    station: {
+      list: async () => {
+        callLog.push({ method: 'station.list' });
+        return [{ id: 1, name: 'Station-1' }];
+      },
+    },
+  };
+
+  const contextProxy = new Proxy(rawContext, {
+    get(target, prop) {
+      if (typeof prop === 'symbol') return target[prop];
+      if (!KNOWN_SDK_NAMESPACES.has(prop)) {
+        warnings.push(`Unknown SDK namespace accessed: context.${String(prop)}`);
+        return new Proxy({}, {
+          get(_, method) {
+            return async () => {
+              warnings.push(`Unknown SDK method called: context.${String(prop)}.${String(method)}`);
+              return undefined;
+            };
+          },
+        });
+      }
+      return target[prop];
+    },
+  });
+
+  return { context: contextProxy, callLog, warnings, mockTickets };
+}
+
+// ─── Contract validators ───────────────────────────────────────────
+
+const CAMEL_CASE_PATTERN = /^[a-z]+[A-Z]/;
+
+function validateStartResult(result) {
+  const errors = [];
+  if (typeof result !== 'object' || result === null) {
+    errors.push('start() must return an object, got ' + (result === null ? 'null' : typeof result));
+    return errors;
+  }
+  if (typeof result.orbit_link !== 'string') {
+    errors.push(`start().orbit_link must be string, got ${result.orbit_link === undefined ? 'undefined' : typeof result.orbit_link}`);
+  }
+  if (!Array.isArray(result.ticket_ids)) {
+    errors.push(`start().ticket_ids must be array, got ${result.ticket_ids === undefined ? 'undefined' : typeof result.ticket_ids}`);
+  } else if (result.ticket_ids.length > 0 && typeof result.ticket_ids[0] !== 'number') {
+    errors.push(`start().ticket_ids[0] must be number, got ${typeof result.ticket_ids[0]}`);
+  }
+  for (const key of Object.keys(result)) {
+    if (CAMEL_CASE_PATTERN.test(key)) {
+      errors.push(`start() return key "${key}" is camelCase — must be snake_case`);
+    }
+  }
+  return errors;
+}
+
+function validateCompleteResult(result) {
+  const errors = [];
+  if (typeof result !== 'object' || result === null) {
+    errors.push('complete() must return an object, got ' + (result === null ? 'null' : typeof result));
+    return errors;
+  }
+  if (result.new_tickets !== undefined) {
+    if (!Array.isArray(result.new_tickets)) {
+      errors.push(`complete().new_tickets must be array, got ${typeof result.new_tickets}`);
+    } else {
+      for (let i = 0; i < Math.min(result.new_tickets.length, 3); i++) {
+        const t = result.new_tickets[i];
+        if (typeof t.flow_id !== 'number') errors.push(`new_tickets[${i}].flow_id must be number, got ${typeof t.flow_id}`);
+        if (typeof t.pool_id !== 'number') errors.push(`new_tickets[${i}].pool_id must be number, got ${typeof t.pool_id}`);
+        if (typeof t.order_id !== 'number') errors.push(`new_tickets[${i}].order_id must be number, got ${typeof t.order_id}`);
+        if (typeof t.detail !== 'object' || t.detail === null) errors.push(`new_tickets[${i}].detail must be object`);
+        if (typeof t.status !== 'string') errors.push(`new_tickets[${i}].status must be string, got ${typeof t.status}`);
+      }
+    }
+  }
+  for (const key of Object.keys(result)) {
+    if (CAMEL_CASE_PATTERN.test(key)) {
+      errors.push(`complete() return key "${key}" is camelCase — must be snake_case`);
+    }
+  }
+  return errors;
+}
+
+function validateRunResult(result) {
+  const errors = [];
+  if (typeof result !== 'object' || result === null) {
+    errors.push('run() must return an object, got ' + (result === null ? 'null' : typeof result));
+    return errors;
+  }
+  if (result.new_tickets !== undefined) {
+    if (!Array.isArray(result.new_tickets)) {
+      errors.push(`run().new_tickets must be array, got ${typeof result.new_tickets}`);
+    } else {
+      for (let i = 0; i < Math.min(result.new_tickets.length, 3); i++) {
+        const t = result.new_tickets[i];
+        if (typeof t.flow_id !== 'number') errors.push(`new_tickets[${i}].flow_id must be number, got ${typeof t.flow_id}`);
+        if (typeof t.pool_id !== 'number') errors.push(`new_tickets[${i}].pool_id must be number, got ${typeof t.pool_id}`);
+        if (typeof t.order_id !== 'number') errors.push(`new_tickets[${i}].order_id must be number, got ${typeof t.order_id}`);
+        if (typeof t.detail !== 'object' || t.detail === null) errors.push(`new_tickets[${i}].detail must be object`);
+        if (typeof t.status !== 'string') errors.push(`new_tickets[${i}].status must be string, got ${typeof t.status}`);
+      }
+    }
+  }
+  for (const key of Object.keys(result)) {
+    if (CAMEL_CASE_PATTERN.test(key)) {
+      errors.push(`run() return key "${key}" is camelCase — must be snake_case`);
+    }
+  }
+  return errors;
+}
+
+// ─── Script loader via vm ──────────────────────────────────────────
+
+function loadProcesserClass(scriptContent, filename) {
+  const wrapped = scriptContent + '\n;Processer;\n';
+  const script = new Script(wrapped, { filename });
+  const sandbox = {
+    console: {
+      log: () => {},
+      info: () => {},
+      warn: () => {},
+      error: () => {},
+      debug: () => {},
+    },
+    setTimeout, clearTimeout, setInterval, clearInterval,
+    Promise, Array, Object, Map, Set, JSON, Math, Date,
+    Number, String, Boolean, RegExp, Error, TypeError, ReferenceError,
+    parseInt, parseFloat, isNaN, isFinite, undefined, NaN, Infinity,
+    encodeURIComponent, decodeURIComponent, encodeURI, decodeURI,
+    fetch: async (url, opts) => {
+      const method = (opts && opts.method) || 'GET';
+      sandbox.console.warn(`[test-processer] fetch called: ${method} ${url}`);
+      return {
+        ok: true,
+        status: 200,
+        json: async () => ({ data: {} }),
+        text: async () => '{}',
+      };
+    },
+  };
+  const ctx = createContext(sandbox);
+  return script.runInContext(ctx);
+}
+
+// ─── Preview: scenario data generation ────────────────────────────
+
+function generateScenarioValue(field, idx) {
+  const { type, options, default_value, key, label } = field;
+  if (options && options.length) return options[idx % options.length];
+
+  const prefix = (label || key).replace(/\s+/g, '');
+  switch ((type || '').toLowerCase()) {
+    case 'number': case 'integer': case 'float':
+      return 1000 + idx * 100 + Math.round(Math.random() * 50);
+    case 'boolean':
+      return idx % 2 === 0;
+    case 'json': case 'object':
+      return { [`${key}_data`]: idx };
+    case 'array':
+      return [`${prefix}_item_${idx}`];
+    case 'date': case 'datetime':
+      return `2026-0${1 + (idx % 9)}-${String(10 + idx).padStart(2, '0')}T10:00:00Z`;
+    default:
+      return `${prefix}_${1000 + idx}`;
+  }
+}
+
+function generateScenarioTickets(pools, valveConfig) {
+  const inputPoolName = valveConfig.input_pools[0]?.name;
+  const inputPool = pools.find(p => p.name === inputPoolName);
+  const fields = inputPool?.fields || [];
+
+  return [1, 2, 3, 4, 5].map(i => {
+    const detail = {};
+    for (const field of fields) {
+      if (field.key === 'id' || field.key === 'detail') continue;
+      if (i === 4 && !field.default_value && !(field.options?.length)) {
+        detail[field.key] = (field.type || '').match(/number|integer|float/i) ? 0 : '';
+      } else if (i === 5 && field.options && field.options.length > 1) {
+        detail[field.key] = field.options[1];
+      } else {
+        detail[field.key] = generateScenarioValue(field, i);
+      }
+    }
+    return {
+      id: i,
+      flow_id: 1,
+      pool_id: i <= 2 ? 1 : (valveConfig.input_pools.length > 1 ? 2 : 1),
+      order_id: 1000 + i,
+      parent_ticket_id: 0,
+      detail,
+      status: 'created',
+      uuid: `scenario-uuid-${i}`,
+    };
+  });
+}
+
+// ─── Preview: user data loader ────────────────────────────────────
+
+function loadUserData(dataPath, valveConfig) {
+  const raw = readFileSync(resolve(dataPath), 'utf8');
+  const parsed = JSON.parse(raw);
+  const tickets = parsed.tickets;
+  if (!Array.isArray(tickets) || tickets.length === 0) {
+    throw new Error('--data JSON must contain a non-empty "tickets" array');
+  }
+  const defaultPoolId = valveConfig.input_pools.length > 0 ? 1 : 0;
+  return tickets.map((t, i) => ({
+    id: t.id ?? i + 1,
+    flow_id: t.flow_id ?? 1,
+    pool_id: t.pool_id ?? defaultPoolId,
+    order_id: t.order_id ?? 1000 + i + 1,
+    parent_ticket_id: t.parent_ticket_id ?? 0,
+    detail: t.detail ?? {},
+    status: t.status ?? 'created',
+    uuid: t.uuid ?? `user-data-${i + 1}`,
+  }));
+}
+
+// ─── Preview: detail diff ─────────────────────────────────────────
+
+function diffDetail(before, after) {
+  const changes = [];
+  const allKeys = new Set([...Object.keys(before || {}), ...Object.keys(after || {})]);
+  for (const key of allKeys) {
+    const bv = before?.[key];
+    const av = after?.[key];
+    const bStr = JSON.stringify(bv);
+    const aStr = JSON.stringify(av);
+    if (bStr !== aStr) {
+      changes.push({
+        key,
+        before: bv === undefined ? '(无)' : bStr,
+        after: av === undefined ? '(无)' : aStr,
+        type: bv === undefined ? 'added' : av === undefined ? 'removed' : 'changed',
+      });
+    }
+  }
+  return changes;
+}
+
+// ─── Preview: tracing context ─────────────────────────────────────
+
+function createTracingContext(pools, valveConfig, tickets) {
+  const traceLog = [];
+  let seq = 0;
+  const ticketSnapshots = new Map();
+  for (const t of tickets) {
+    ticketSnapshots.set(t.id, JSON.parse(JSON.stringify(t.detail || {})));
+  }
+  const detailDiffs = [];
+
+  function summarize(val) {
+    if (Array.isArray(val)) return `${val.length} items`;
+    if (val && typeof val === 'object' && val.list) return `${val.list.length} tickets`;
+    return JSON.stringify(val)?.slice(0, 60) ?? 'undefined';
+  }
+
+  const rawContext = {
+    ticket: {
+      list: async (params) => {
+        const result = { list: JSON.parse(JSON.stringify(tickets)) };
+        traceLog.push({ seq: seq++, method: 'ticket.list', params: JSON.parse(JSON.stringify(params || {})), returnSummary: `${result.list.length} tickets` });
+        return result;
+      },
+      update: async (updatedTickets) => {
+        const diffs = [];
+        for (const ut of (updatedTickets || [])) {
+          const oldDetail = ticketSnapshots.get(ut.id);
+          const newDetail = ut.detail || {};
+          const changes = diffDetail(oldDetail, newDetail);
+          if (changes.length > 0) {
+            diffs.push({ ticketId: ut.id, changes });
+          }
+          ticketSnapshots.set(ut.id, JSON.parse(JSON.stringify(newDetail)));
+        }
+        const entry = { seq: seq++, method: 'ticket.update', params: { count: (updatedTickets || []).length }, returnSummary: 'void' };
+        if (diffs.length > 0) {
+          entry.detailDiffs = diffs;
+          detailDiffs.push(...diffs);
+        }
+        traceLog.push(entry);
+      },
+      append: async (newTickets) => {
+        const result = (newTickets || []).map((t, i) => ({ ...t, id: 9000 + i }));
+        traceLog.push({ seq: seq++, method: 'ticket.append', params: { count: (newTickets || []).length }, returnSummary: `${result.length} created` });
+        return result;
+      },
+    },
+    pool: {
+      getNext: async (valveId) => {
+        const result = valveConfig.output_pools.map((p, i) => ({
+          id: 100 + i, name: p.name, description: p.description || '',
+          schema: { fields: [] }, type: 'flow_process',
+        }));
+        traceLog.push({ seq: seq++, method: 'pool.getNext', params: { valveId }, returnSummary: `${result.length} pools: ${result.map(p => p.name).join(', ')}` });
+        return result;
+      },
+    },
+    compound: {
+      getStockFromXfcSh: async (params) => {
+        const data = [1, 2].map(i => ({
+          id: i, cas: `12345-67-${i}`, status: '可用',
+          source: 'MockSupplier', barcode: `XFC-MOCK-${i}`,
+          cmpd_id: `CA${1000 + i}`, owner: 'mock@example.com',
+        }));
+        const result = { data, meta: { count: data.length, page: 1, pageSize: 400, totalPage: 1 } };
+        traceLog.push({ seq: seq++, method: 'compound.getStockFromXfcSh', params: JSON.parse(JSON.stringify(params || {})), returnSummary: `${data.length} records` });
+        return result;
+      },
+    },
+    process: {
+      list: async (params) => {
+        traceLog.push({ seq: seq++, method: 'process.list', params: JSON.parse(JSON.stringify(params || {})), returnSummary: '0 processes' });
+        return [];
+      },
+      execute: async (items, baseURL) => {
+        const result = { results: { exp_id_list: (items || []).map(() => 'mock-exp-' + Math.random().toString(36).slice(2, 8)) } };
+        traceLog.push({ seq: seq++, method: 'process.execute', params: { itemCount: (items || []).length, baseURL }, returnSummary: `${(items || []).length} executed` });
+        return result;
+      },
+    },
+    station: {
+      list: async () => {
+        const result = [{ id: 1, name: 'Station-1' }];
+        traceLog.push({ seq: seq++, method: 'station.list', params: {}, returnSummary: `${result.length} stations` });
+        return result;
+      },
+    },
+  };
+
+  const contextProxy = new Proxy(rawContext, {
+    get(target, prop) {
+      if (typeof prop === 'symbol') return target[prop];
+      if (!KNOWN_SDK_NAMESPACES.has(prop)) {
+        traceLog.push({ seq: seq++, method: `(unknown) ${String(prop)}.*`, params: {}, returnSummary: 'unknown namespace' });
+        return new Proxy({}, {
+          get(_, method) {
+            return async (...fnArgs) => {
+              traceLog.push({ seq: seq++, method: `${String(prop)}.${String(method)}`, params: fnArgs, returnSummary: 'undefined (unknown)' });
+              return undefined;
+            };
+          },
+        });
+      }
+      return target[prop];
+    },
+  });
+
+  return { context: contextProxy, traceLog, detailDiffs, ticketSnapshots };
+}
+
+// ─── Preview: report formatter ────────────────────────────────────
+
+function formatTicketsTable(tickets, maxDetailKeys) {
+  if (tickets.length === 0) return '(无 tickets)\n';
+  const detailKeys = maxDetailKeys || [...new Set(tickets.flatMap(t => Object.keys(t.detail || {})))].slice(0, 8);
+  const headers = ['id', 'order_id', ...detailKeys, 'status'];
+  const rows = tickets.map(t => {
+    const d = t.detail || {};
+    return [t.id, t.order_id, ...detailKeys.map(k => {
+      const v = d[k];
+      if (v === undefined || v === null) return '-';
+      if (typeof v === 'object') return JSON.stringify(v).slice(0, 30);
+      return String(v).slice(0, 30);
+    }), t.status];
+  });
+  const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map(r => String(r[i]).length)));
+  const pad = (s, w) => String(s).padEnd(w);
+  const line = colWidths.map(w => '-'.repeat(w));
+  const fmt = row => '| ' + row.map((c, i) => pad(c, colWidths[i])).join(' | ') + ' |';
+  return [fmt(headers), '| ' + line.map(l => l).join(' | ') + ' |', ...rows.map(fmt)].join('\n') + '\n';
+}
+
+function formatPreviewReport(trace) {
+  const { scriptPath, valveName, valveConfig, pools, dataSource,
+          inputTickets, isAutoTrigger,
+          startResult, startError, startTraceLog, startDetailDiffs,
+          completeTickets, completeResult, completeError, completeTraceLog, completeDetailDiffs,
+          runResult, runError, runTraceLog, runDetailDiffs } = trace;
+
+  const lines = [];
+  const push = (...args) => lines.push(...args);
+
+  push('# 脚本预览报告', '');
+
+  // Basic info
+  push('## 基本信息');
+  push(`- 脚本: \`${basename(scriptPath)}\``);
+  push(`- 门控: ${valveName}`);
+  const inputPoolNames = valveConfig.input_pools.map(p => p.name).join(', ') || '(未知)';
+  const outputPoolNames = valveConfig.output_pools.map(p => p.name).join(', ') || '(未知)';
+  push(`- 入口池: ${inputPoolNames}`);
+  push(`- 出口池: ${outputPoolNames}`);
+  push(`- 数据来源: ${dataSource}`);
+  push(`- tickets 数: ${inputTickets.length}`);
+  push(`- 触发方式: ${isAutoTrigger ? '自动触发 (run)' : '人工触发 (start/complete)'}`, '');
+
+  if (isAutoTrigger) {
+    // run() trace
+    push('## run() 执行追踪', '');
+    push(`### 输入数据 (${inputTickets.length} 条 tickets)`, '');
+    push(formatTicketsTable(inputTickets));
+
+    push('### SDK 调用链', '');
+    for (const entry of (runTraceLog || [])) {
+      const paramStr = JSON.stringify(entry.params);
+      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
+    }
+    push('');
+
+    if (runDetailDiffs && runDetailDiffs.length > 0) {
+      push('### ticket.detail 变更 (run 阶段)', '');
+      push('| ticket | 字段 | 变更前 | 变更后 |');
+      push('|--------|------|--------|--------|');
+      for (const d of runDetailDiffs) {
+        for (const c of d.changes) {
+          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
+        }
+      }
+      push('');
+    }
+
+    if (runError) {
+      push(`### run() 错误`, '');
+      push(`\`\`\`\n${runError}\n\`\`\``, '');
+    } else if (runResult) {
+      push('### 数据路由', '');
+      if (runResult.new_tickets && runResult.new_tickets.length > 0) {
+        const routeMap = new Map();
+        for (const nt of runResult.new_tickets) {
+          const poolId = nt.pool_id;
+          if (!routeMap.has(poolId)) routeMap.set(poolId, []);
+          routeMap.get(poolId).push(nt);
+        }
+        push('| 目标池 | pool_id | 数量 | status |');
+        push('|--------|---------|------|--------|');
+        for (const [poolId, nts] of routeMap) {
+          const poolName = valveConfig.output_pools.find((_, i) => 100 + i === poolId)?.name || `pool_${poolId}`;
+          push(`| ${poolName} | ${poolId} | ${nts.length} | ${nts[0]?.status || '-'} |`);
+        }
+        push('');
+      } else {
+        push('(无 new_tickets 返回)', '');
+      }
+    }
+
+    // Summary
+    push('## 执行摘要', '');
+    const usedMethods = new Set((runTraceLog || []).map(c => c.method));
+    const allMethods = ['ticket.list', 'ticket.update', 'ticket.append', 'pool.getNext',
+      'compound.getStockFromXfcSh', 'process.list', 'process.execute', 'station.list'];
+    const unused = allMethods.filter(m => !usedMethods.has(m));
+
+    const runStatus = runError
+      ? `✗ 失败: ${runError.split('\n')[0]}`
+      : `✓ 成功 (${(runTraceLog || []).length} SDK 调用, ${(runResult?.new_tickets || []).length} new_tickets)`;
+
+    push(`- run: ${runStatus}`);
+    if (unused.length > 0) {
+      push(`- 未调用的 SDK 方法: ${unused.join(', ')}`);
+    }
+    push('');
+  } else {
+    // start() trace
+    push('## start() 执行追踪', '');
+    push(`### 输入数据 (${inputTickets.length} 条 tickets)`, '');
+    push(formatTicketsTable(inputTickets));
+
+    push('### SDK 调用链', '');
+    for (const entry of startTraceLog) {
+      const paramStr = JSON.stringify(entry.params);
+      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
+    }
+    push('');
+
+    if (startDetailDiffs.length > 0) {
+      push('### ticket.detail 变更 (start 阶段)', '');
+      push('| ticket | 字段 | 变更前 | 变更后 |');
+      push('|--------|------|--------|--------|');
+      for (const d of startDetailDiffs) {
+        for (const c of d.changes) {
+          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
+        }
+      }
+      push('');
+    }
+
+    if (startError) {
+      push(`### start() 错误`, '');
+      push(`\`\`\`\n${startError}\n\`\`\``, '');
+    } else if (startResult) {
+      push('### 返回值', '');
+      push(`- orbit_link: \`${startResult.orbit_link}\``);
+      push(`- ticket_ids: [${(startResult.ticket_ids || []).join(', ')}]`);
+      push('');
+    }
+
+    // complete() trace
+    push('## complete() 执行追踪', '');
+    push(`### 输入 tickets (${(completeTickets || []).length} 条)`, '');
+
+    push('### SDK 调用链', '');
+    for (const entry of completeTraceLog) {
+      const paramStr = JSON.stringify(entry.params);
+      push(`${entry.seq + 1}. \`${entry.method}(${paramStr === '{}' ? '' : paramStr})\` → ${entry.returnSummary}`);
+    }
+    push('');
+
+    if (completeDetailDiffs.length > 0) {
+      push('### ticket.detail 变更 (complete 阶段)', '');
+      push('| ticket | 字段 | 变更前 | 变更后 |');
+      push('|--------|------|--------|--------|');
+      for (const d of completeDetailDiffs) {
+        for (const c of d.changes) {
+          push(`| #${d.ticketId} | ${c.key} | ${c.before} | ${c.after} |`);
+        }
+      }
+      push('');
+    }
+
+    if (completeError) {
+      push(`### complete() 错误`, '');
+      push(`\`\`\`\n${completeError}\n\`\`\``, '');
+    } else if (completeResult) {
+      push('### 数据路由', '');
+      if (completeResult.new_tickets && completeResult.new_tickets.length > 0) {
+        const routeMap = new Map();
+        for (const nt of completeResult.new_tickets) {
+          const poolId = nt.pool_id;
+          if (!routeMap.has(poolId)) routeMap.set(poolId, []);
+          routeMap.get(poolId).push(nt);
+        }
+        push('| 目标池 | pool_id | 数量 | status |');
+        push('|--------|---------|------|--------|');
+        for (const [poolId, nts] of routeMap) {
+          const poolName = valveConfig.output_pools.find((_, i) => 100 + i === poolId)?.name || `pool_${poolId}`;
+          push(`| ${poolName} | ${poolId} | ${nts.length} | ${nts[0]?.status || '-'} |`);
+        }
+        push('');
+      } else {
+        push('(无 new_tickets 返回)', '');
+      }
+    }
+
+    // Summary
+    push('## 执行摘要', '');
+    const allCalls = [...startTraceLog, ...completeTraceLog];
+    const usedMethods = new Set(allCalls.map(c => c.method));
+    const allMethods = ['ticket.list', 'ticket.update', 'ticket.append', 'pool.getNext',
+      'compound.getStockFromXfcSh', 'process.list', 'process.execute', 'station.list'];
+    const unused = allMethods.filter(m => !usedMethods.has(m));
+
+    const startStatus = startError ? `✗ 失败: ${startError.split('\n')[0]}` : `✓ 成功 (${startTraceLog.length} SDK 调用, ${inputTickets.length} tickets)`;
+    const completeStatus = completeError
+      ? `✗ 失败: ${completeError.split('\n')[0]}`
+      : `✓ 成功 (${completeTraceLog.length} SDK 调用, ${(completeResult?.new_tickets || []).length} new_tickets)`;
+
+    push(`- start: ${startStatus}`);
+    push(`- complete: ${completeStatus}`);
+    if (unused.length > 0) {
+      push(`- 未调用的 SDK 方法: ${unused.join(', ')}`);
+    }
+    push('');
+  }
+
+  return lines.join('\n');
+}
+
+// ─── Preview: main runner ─────────────────────────────────────────
+
+async function runPreview(args) {
+  const scriptPath = resolve(args.script);
+  const poolsDir = args.poolsDir ? resolve(args.poolsDir) : null;
+  const valvesDir = args.valvesDir ? resolve(args.valvesDir) : null;
+  const valveName = args.valveName || basename(scriptPath, '.js');
+
+  let scriptContent;
+  try {
+    scriptContent = readFileSync(scriptPath, 'utf8');
+  } catch (e) {
+    console.error(`Cannot read script: ${e.message}`);
+    process.exit(1);
+  }
+
+  let ProcesserClass;
+  try {
+    ProcesserClass = loadProcesserClass(scriptContent, basename(scriptPath));
+  } catch (e) {
+    console.error(`Cannot load Processer: ${e.message}`);
+    process.exit(1);
+  }
+
+  const pools = loadAllPools(poolsDir);
+  const valveConfig = loadValveConfig(valvesDir, valveName);
+
+  let inputTickets;
+  let dataSource;
+  if (args.dataPath) {
+    try {
+      inputTickets = loadUserData(args.dataPath, valveConfig);
+      dataSource = `用户数据 (${basename(args.dataPath)})`;
+    } catch (e) {
+      console.error(`Cannot load --data: ${e.message}`);
+      process.exit(1);
+    }
+  } else {
+    inputTickets = generateScenarioTickets(pools, valveConfig);
+    dataSource = '自动生成';
+  }
+
+  const inputPoolIds = valveConfig.input_pools.map((_, i) => i + 1);
+  const proto = ProcesserClass.prototype;
+  const isAutoTrigger = typeof proto.run === 'function' && typeof proto.start !== 'function';
+
+  const trace = {
+    scriptPath, valveName, valveConfig, pools, dataSource, inputTickets, isAutoTrigger,
+    startResult: null, startError: null, startTraceLog: [], startDetailDiffs: [],
+    completeTickets: null, completeResult: null, completeError: null, completeTraceLog: [], completeDetailDiffs: [],
+    runResult: null, runError: null, runTraceLog: [], runDetailDiffs: [],
+  };
+
+  if (isAutoTrigger) {
+    // Auto-trigger: run()
+    const tc = createTracingContext(pools, valveConfig, inputTickets);
+    let processer;
+    try {
+      processer = new ProcesserClass(tc.context);
+    } catch (e) {
+      trace.runError = `constructor threw: ${e.message}\n${e.stack}`;
+      console.log(formatPreviewReport(trace));
+      process.exit(1);
+    }
+
+    try {
+      trace.runResult = await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
+    } catch (e) {
+      trace.runError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
+    }
+    trace.runTraceLog = tc.traceLog;
+    trace.runDetailDiffs = tc.detailDiffs;
+  } else {
+    // Manual-trigger: start() + complete()
+    // Run start()
+    {
+      const tc = createTracingContext(pools, valveConfig, inputTickets);
+      let processer;
+      try {
+        processer = new ProcesserClass(tc.context);
+      } catch (e) {
+        trace.startError = `constructor threw: ${e.message}\n${e.stack}`;
+        console.log(formatPreviewReport(trace));
+        process.exit(1);
+      }
+
+      try {
+        trace.startResult = await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
+      } catch (e) {
+        trace.startError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
+      }
+      trace.startTraceLog = tc.traceLog;
+      trace.startDetailDiffs = tc.detailDiffs;
+    }
+
+    // Run complete()
+    {
+      const completeTickets = inputTickets.map(t => ({ ...t, status: 'created' }));
+      trace.completeTickets = completeTickets;
+
+      const tc = createTracingContext(pools, valveConfig, completeTickets);
+      let processer;
+      try {
+        processer = new ProcesserClass(tc.context);
+      } catch (e) {
+        trace.completeError = `constructor threw: ${e.message}\n${e.stack}`;
+        console.log(formatPreviewReport(trace));
+        process.exit(1);
+      }
+
+      try {
+        trace.completeResult = await processer.complete({ valve_id: 1, tickets: completeTickets });
+      } catch (e) {
+        trace.completeError = `${e.constructor.name}: ${e.message}\n${e.stack}`;
+      }
+      trace.completeTraceLog = tc.traceLog;
+      trace.completeDetailDiffs = tc.detailDiffs;
+    }
+  }
+
+  console.log(formatPreviewReport(trace));
+  const hasError = isAutoTrigger ? trace.runError : (trace.startError || trace.completeError);
+  process.exit(hasError ? 1 : 0);
+}
+
+// ─── Main test runner ──────────────────────────────────────────────
+
+async function runTests(args) {
+  const scriptPath = resolve(args.script);
+  const poolsDir = args.poolsDir ? resolve(args.poolsDir) : null;
+  const valvesDir = args.valvesDir ? resolve(args.valvesDir) : null;
+  const valveName = args.valveName || basename(scriptPath, '.js');
+
+  const result = {
+    status: 'pass',
+    script: scriptPath,
+    phases: {
+      syntax: { pass: false },
+      structure: { pass: false, hasConstructor: false, hasStart: false, hasComplete: false, hasRun: false },
+      normalRun: {
+        start: { pass: false, returnValid: false, errors: [] },
+        complete: { pass: false, returnValid: false, errors: [] },
+      },
+      adversarialRun: {
+        start: { pass: false, errors: [] },
+        complete: { pass: false, errors: [] },
+        note: '对抗轮失败为警告，不阻断',
+      },
+      compliance: { pass: true, warnings: [] },
+    },
+    sdkCalls: [],
+    errors: [],
+    warnings: [],
+  };
+
+  // Phase 1: Syntax check
+  let scriptContent;
+  try {
+    scriptContent = readFileSync(scriptPath, 'utf8');
+  } catch (e) {
+    result.errors.push(`Cannot read script file: ${e.message}`);
+    result.status = 'fail';
+    return result;
+  }
+
+  let ProcesserClass;
+  try {
+    new Script(scriptContent, { filename: basename(scriptPath) });
+    result.phases.syntax.pass = true;
+  } catch (e) {
+    result.phases.syntax.pass = false;
+    result.phases.syntax.error = e.message;
+    result.errors.push(`SyntaxError: ${e.message}`);
+    result.status = 'fail';
+    return result;
+  }
+
+  // Phase 2: Structure check
+  try {
+    ProcesserClass = loadProcesserClass(scriptContent, basename(scriptPath));
+  } catch (e) {
+    result.errors.push(`Failed to load Processer class: ${e.message}`);
+    result.status = 'fail';
+    return result;
+  }
+
+  if (typeof ProcesserClass !== 'function') {
+    result.errors.push('Script does not define a Processer class (or class is not the last declaration)');
+    result.status = 'fail';
+    return result;
+  }
+
+  const proto = ProcesserClass.prototype;
+  result.phases.structure.hasConstructor = typeof ProcesserClass === 'function';
+  result.phases.structure.hasStart = typeof proto.start === 'function';
+  result.phases.structure.hasComplete = typeof proto.complete === 'function';
+  result.phases.structure.hasRun = typeof proto.run === 'function';
+  result.phases.structure.pass =
+    result.phases.structure.hasConstructor &&
+    (
+      (result.phases.structure.hasStart && result.phases.structure.hasComplete) ||
+      result.phases.structure.hasRun
+    );
+
+  if (!result.phases.structure.pass) {
+    if (!result.phases.structure.hasRun && !result.phases.structure.hasStart) result.errors.push('Processer missing start() method (manual-trigger) or run() method (auto-trigger)');
+    if (!result.phases.structure.hasRun && !result.phases.structure.hasComplete) result.errors.push('Processer missing complete() method (manual-trigger) or run() method (auto-trigger)');
+    result.status = 'fail';
+    return result;
+  }
+
+  const isAutoTrigger = result.phases.structure.hasRun && !result.phases.structure.hasStart;
+
+  // Load pool schemas and valve config
+  const pools = loadAllPools(poolsDir);
+  const valveConfig = loadValveConfig(valvesDir, valveName);
+  const inputPoolIds = valveConfig.input_pools.map((_, i) => i + 1);
+
+  // Phase 3: Normal run
+  {
+    const mock = createMockContext(pools, valveConfig, false);
+    let processer;
+    try {
+      processer = new ProcesserClass(mock.context);
+    } catch (e) {
+      const phaseKey = isAutoTrigger ? 'run' : 'start';
+      if (!result.phases.normalRun[phaseKey]) result.phases.normalRun[phaseKey] = { pass: false, returnValid: false, errors: [] };
+      result.phases.normalRun[phaseKey].errors.push(`constructor threw: ${e.message}`);
+      result.errors.push(`Normal run constructor error: ${e.message}`);
+      result.status = 'fail';
+      return result;
+    }
+
+    if (isAutoTrigger) {
+      // Auto-trigger: test run()
+      if (!result.phases.normalRun.run) result.phases.normalRun.run = { pass: false, returnValid: false, errors: [] };
+      try {
+        const runResult = await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
+        const runErrors = validateRunResult(runResult);
+        result.phases.normalRun.run.returnValid = runErrors.length === 0;
+        result.phases.normalRun.run.errors = runErrors;
+        result.phases.normalRun.run.pass = runErrors.length === 0;
+        if (runErrors.length > 0) {
+          result.errors.push(...runErrors.map(e => `[normal run] ${e}`));
+        }
+      } catch (e) {
+        result.phases.normalRun.run.errors.push(e.message);
+        result.errors.push(`[normal run] Runtime error: ${e.message}`);
+      }
+    } else {
+      // Manual-trigger: test start() + complete()
+      // start
+      try {
+        const startResult = await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
+        const startErrors = validateStartResult(startResult);
+        result.phases.normalRun.start.returnValid = startErrors.length === 0;
+        result.phases.normalRun.start.errors = startErrors;
+        result.phases.normalRun.start.pass = startErrors.length === 0;
+        if (startErrors.length > 0) {
+          result.errors.push(...startErrors.map(e => `[normal start] ${e}`));
+        }
+      } catch (e) {
+        result.phases.normalRun.start.errors.push(e.message);
+        result.errors.push(`[normal start] Runtime error: ${e.message}`);
+      }
+
+      // complete — use mock tickets from the start phase (with updated details if any)
+      try {
+        const completeTickets = mock.mockTickets.map(t => ({ ...t, status: 'created' }));
+        const completeResult = await processer.complete({ valve_id: 1, tickets: completeTickets });
+        const completeErrors = validateCompleteResult(completeResult);
+        result.phases.normalRun.complete.returnValid = completeErrors.length === 0;
+        result.phases.normalRun.complete.errors = completeErrors;
+        result.phases.normalRun.complete.pass = completeErrors.length === 0;
+        if (completeErrors.length > 0) {
+          result.errors.push(...completeErrors.map(e => `[normal complete] ${e}`));
+        }
+      } catch (e) {
+        result.phases.normalRun.complete.errors.push(e.message);
+        result.errors.push(`[normal complete] Runtime error: ${e.message}`);
+      }
+    }
+
+    result.sdkCalls = [...new Set(mock.callLog.map(c => c.method))];
+    result.phases.compliance.warnings.push(...mock.warnings);
+
+    // Check limit/offset compliance
+    for (const call of mock.callLog) {
+      if (PAGINATED_METHODS.has(call.method) && call.params && call.params.limit === undefined) {
+        result.phases.compliance.warnings.push(
+          `${call.method} called without limit parameter`
+        );
+      }
+    }
+
+    // Check for sandbox-unavailable APIs in source code
+    const UNAVAILABLE_APIS = ['URLSearchParams', 'TextEncoder', 'TextDecoder', 'Buffer'];
+    for (const api of UNAVAILABLE_APIS) {
+      if (scriptContent.includes(api)) {
+        result.phases.compliance.warnings.push(
+          `Script uses '${api}' which is not available in the gate script sandbox — use template literals + encodeURIComponent instead`
+        );
+      }
+    }
+  }
+
+  const normalPass = isAutoTrigger
+    ? result.phases.normalRun.run?.pass
+    : result.phases.normalRun.start.pass && result.phases.normalRun.complete.pass;
+  if (!normalPass) {
+    result.status = 'fail';
+  }
+
+  // Phase 4: Adversarial run
+  {
+    const mock = createMockContext(pools, valveConfig, true);
+    let processer;
+    try {
+      processer = new ProcesserClass(mock.context);
+    } catch (e) {
+      const phaseKey = isAutoTrigger ? 'run' : 'start';
+      if (!result.phases.adversarialRun[phaseKey]) result.phases.adversarialRun[phaseKey] = { pass: false, errors: [] };
+      result.phases.adversarialRun[phaseKey].errors.push(`constructor threw: ${e.message}`);
+      result.warnings.push(`[adversarial] constructor error: ${e.message}`);
+    }
+
+    if (processer) {
+      if (isAutoTrigger) {
+        if (!result.phases.adversarialRun.run) result.phases.adversarialRun.run = { pass: false, errors: [] };
+        try {
+          await processer.run({ valve_id: 1, pool_ids: inputPoolIds });
+          result.phases.adversarialRun.run.pass = true;
+        } catch (e) {
+          result.phases.adversarialRun.run.errors.push(e.message);
+          result.warnings.push(`[adversarial run] ${e.constructor.name}: ${e.message}`);
+        }
+      } else {
+        try {
+          await processer.start({ valve_id: 1, pool_ids: inputPoolIds });
+          result.phases.adversarialRun.start.pass = true;
+        } catch (e) {
+          result.phases.adversarialRun.start.errors.push(e.message);
+          result.warnings.push(`[adversarial start] ${e.constructor.name}: ${e.message}`);
+        }
+
+        try {
+          const completeTickets = mock.mockTickets.map(t => ({ ...t, status: 'created' }));
+          await processer.complete({ valve_id: 1, tickets: completeTickets });
+          result.phases.adversarialRun.complete.pass = true;
+        } catch (e) {
+          result.phases.adversarialRun.complete.errors.push(e.message);
+          result.warnings.push(`[adversarial complete] ${e.constructor.name}: ${e.message}`);
+        }
+      }
+
+      result.phases.compliance.warnings.push(
+        ...mock.warnings.filter(w => !result.phases.compliance.warnings.includes(w))
+      );
+    }
+  }
+
+  // Phase 5: Compliance
+  if (result.phases.compliance.warnings.length > 0) {
+    result.warnings.push(...result.phases.compliance.warnings);
+  }
+  result.phases.compliance.pass = result.phases.compliance.warnings.filter(
+    w => w.includes('Unknown SDK')
+  ).length === 0;
+
+  if (!result.phases.compliance.pass) {
+    result.status = 'fail';
+  }
+
+  return result;
+}
+
+// ─── Entry point ───────────────────────────────────────────────────
+
+const args = parseArgs(process.argv);
+
+if (args.preview) {
+  runPreview(args).catch(e => {
+    console.error(`Preview failed: ${e.message}`);
+    process.exit(1);
+  });
+} else {
+  runTests(args)
+    .then(result => {
+      console.log(JSON.stringify(result, null, 2));
+      process.exit(result.status === 'pass' ? 0 : 1);
+    })
+    .catch(e => {
+      console.error(JSON.stringify({ status: 'fail', errors: [e.message] }));
+      process.exit(1);
+    });
+}