@resolveio/server-lib 22.3.221 → 22.3.223

package/src/util/ai-runner-qa-tools.ts

@@ -1,3536 +0,0 @@
-import { buildRunnerProcessJanitorShellLibrary } from './runner-process-janitor';
-
-export interface ResolveIORunnerQaToolBundleOptions {
-	mode?: 'support' | 'runner';
-	qaClientPort?: number | string;
-	defaultUsername?: string;
-	defaultPassword?: string;
-	jobId?: string;
-	ownerId?: string;
-	runnerToken?: string;
-	runnerRunId?: string;
-	runnerGeneration?: string | number;
-	mongoRuntimePath?: string;
-	qaLiveDataRequired?: boolean;
-	toolsBinPath?: string;
-	browserslistPath?: string;
-	mongodbBinaryCachePath?: string;
-	tmpRoot?: string;
-	homeRoot?: string;
-}
-
-function shellDoubleQuote(value: string): string {
-	return String(value || '').replace(/["\\$`]/g, '\\$&');
-}
-
-function normalizePort(value: number | string | undefined, fallback: string): string {
-	const parsed = Number.parseInt(String(value || ''), 10);
-	return Number.isFinite(parsed) && parsed > 0 ? String(parsed) : fallback;
-}
-
-function envVar(mode: 'support' | 'runner', suffix: string): string {
-	return mode === 'support' ? `RESOLVEIO_SUPPORT_QA_${suffix}` : `RESOLVEIO_RUNNER_QA_${suffix}`;
-}
-
-export function buildResolveIORunnerQaEnvScript(options: ResolveIORunnerQaToolBundleOptions = {}): string {
-	const mode = options.mode || 'runner';
-	const altMode = mode === 'support' ? 'runner' : 'support';
-	const tmpRoot = options.tmpRoot || (mode === 'support' ? '/tmp/resolveio-support-qa' : '/tmp/resolveio-ai-runner-qa');
-	const homeRoot = options.homeRoot || `${tmpRoot}/home`;
-	const defaultPort = normalizePort(options.qaClientPort, '4200');
-	const username = shellDoubleQuote(options.defaultUsername || 'admin');
-	const password = shellDoubleQuote(options.defaultPassword || '');
-	const jobId = shellDoubleQuote(options.jobId || '');
-	const ownerId = shellDoubleQuote(options.ownerId || '');
-	const runnerToken = shellDoubleQuote(options.runnerToken || '');
-	const runnerRunId = shellDoubleQuote(options.runnerRunId || '');
-	const runnerGeneration = shellDoubleQuote(String(options.runnerGeneration || ''));
-	const mongoRuntimePath = shellDoubleQuote(options.mongoRuntimePath || '');
-	const qaLiveDataRequired = options.qaLiveDataRequired === true ? 'true' : 'false';
-	const toolsBinPath = options.toolsBinPath || '';
-	const browserslistPath = options.browserslistPath || '';
-	const mongodbBinaryCachePath = options.mongodbBinaryCachePath || '';
-	const clientPortVar = envVar(mode, 'CLIENT_PORT');
-	const altClientPortVar = envVar(altMode, 'CLIENT_PORT');
-	const clientUrlVar = envVar(mode, 'CLIENT_URL');
-	const altClientUrlVar = envVar(altMode, 'CLIENT_URL');
-	const serverUrlVar = envVar(mode, 'SERVER_URL');
-	const altServerUrlVar = envVar(altMode, 'SERVER_URL');
-	const usernameVar = envVar(mode, 'USERNAME');
-	const altUsernameVar = envVar(altMode, 'USERNAME');
-	const passwordVar = envVar(mode, 'PASSWORD');
-	const altPasswordVar = envVar(altMode, 'PASSWORD');
-	const viewportWidthVar = envVar(mode, 'VIEWPORT_WIDTH');
-	const altViewportWidthVar = envVar(altMode, 'VIEWPORT_WIDTH');
-	const viewportHeightVar = envVar(mode, 'VIEWPORT_HEIGHT');
-	const altViewportHeightVar = envVar(altMode, 'VIEWPORT_HEIGHT');
-	const timeoutVar = envVar(mode, 'ANGULAR_STARTUP_TIMEOUT_SECONDS');
-	const altTimeoutVar = envVar(altMode, 'ANGULAR_STARTUP_TIMEOUT_SECONDS');
-	const prebundleVar = envVar(mode, 'ANGULAR_PREBUNDLE');
-	const altPrebundleVar = envVar(altMode, 'ANGULAR_PREBUNDLE');
-	const reuseVar = envVar(mode, 'REUSE_RUNNING');
-	const altReuseVar = envVar(altMode, 'REUSE_RUNNING');
-	const keepaliveVar = envVar(mode, 'KEEPALIVE');
-	const altKeepaliveVar = envVar(altMode, 'KEEPALIVE');
-	const mongoPortVar = envVar(mode, 'MONGO_PORT');
-	const altMongoPortVar = envVar(altMode, 'MONGO_PORT');
-	const mongoUrlVar = envVar(mode, 'MONGO_URL');
-	const altMongoUrlVar = envVar(altMode, 'MONGO_URL');
-	const browserLoopVar = mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_BROWSER' : 'RESOLVEIO_RUNNER_QA_BROWSER';
-	return [
-		`export ${mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP'}="${'${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP') + ':-' + tmpRoot + '}'}"`,
-		`export ${mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME'}="${'${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME') + ':-' + homeRoot + '}'}"`,
-		`RESOLVEIO_QA_TMP="${'${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP') + '}'}"`,
-		`RESOLVEIO_QA_HOME="${'${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME') + '}'}"`,
-		'RESOLVEIO_QA_TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
-		'if [ -z "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" ] && [ -f "$RESOLVEIO_QA_TOOLS_DIR/current-codex-lane" ]; then',
-		'  RESOLVEIO_SUPPORT_CODEX_LANE="$(tr -d "\\r\\n\\t " < "$RESOLVEIO_QA_TOOLS_DIR/current-codex-lane" 2>/dev/null || true)"',
-		'  export RESOLVEIO_SUPPORT_CODEX_LANE',
-		'fi',
-		'resolveio_support_codex_lane_is_build() {',
-		'  case "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" in build|support_build|support-build) return 0 ;; *) return 1 ;; esac',
-		'}',
-		'resolveio_support_codex_block_build_lane_qa() {',
-		'  resolveio_support_codex_lane_is_build || return 0',
-		'  echo "ResolveIO support lane guard: build lane cannot run local QA/browser/server/client commands; return a build fix and let the QA lane run browser validation." >&2',
-		'  return 86',
-		'}',
-		'mkdir -p "$RESOLVEIO_QA_HOME/.nvm" "$RESOLVEIO_QA_TMP/npm-cache" "$RESOLVEIO_QA_TMP/mongodb-binaries" "$RESOLVEIO_QA_TMP/mongodb-memory-server-core"',
-		'if [ ! -f "$RESOLVEIO_QA_HOME/.nvm/nvm.sh" ]; then',
-		'  cat > "$RESOLVEIO_QA_HOME/.nvm/nvm.sh" <<\'RESOLVEIO_NVM_SHIM\'',
-		'nvm() {',
-		'  case "$1" in',
-		'    use|install|alias) return 0 ;;',
-		'    current) node -v 2>/dev/null || true; return 0 ;;',
-		'    *) return 0 ;;',
-		'  esac',
-		'}',
-		'RESOLVEIO_NVM_SHIM',
-		'fi',
-		'export HOME="$RESOLVEIO_QA_HOME"',
-		'export NVM_DIR="$RESOLVEIO_QA_HOME/.nvm"',
-		'export RESOLVEIO_QA_COMMAND_GUARD_BIN="$RESOLVEIO_QA_TMP/command-guard-bin"',
-		'mkdir -p "$RESOLVEIO_QA_COMMAND_GUARD_BIN"',
-		'resolveio_qa_find_real_command() {',
-		'  local name="$1"',
-		'  local old_ifs="$IFS"',
-		'  IFS=":"',
-		'  for dir in $PATH; do',
-		'    [ -n "$dir" ] || continue',
-		'    [ "$dir" = "$RESOLVEIO_QA_COMMAND_GUARD_BIN" ] && continue',
-		'    if [ -x "$dir/$name" ]; then',
-		'      echo "$dir/$name"',
-		'      IFS="$old_ifs"',
-		'      return 0',
-		'    fi',
-		'  done',
-		'  IFS="$old_ifs"',
-		'  return 1',
-		'}',
-		'export RESOLVEIO_QA_REAL_NPM="${RESOLVEIO_QA_REAL_NPM:-$(resolveio_qa_find_real_command npm || true)}"',
-		'if [ -n "$RESOLVEIO_QA_REAL_NPM" ]; then',
-		'  cat > "$RESOLVEIO_QA_COMMAND_GUARD_BIN/npm" <<\'RESOLVEIO_QA_NPM_GUARD\'',
-		'#!/usr/bin/env bash',
-		'set -u',
-		'REAL_NPM="${RESOLVEIO_QA_REAL_NPM:-}"',
-		'GUARD_BIN="${RESOLVEIO_QA_COMMAND_GUARD_BIN:-}"',
-		'if [ -z "$REAL_NPM" ] || [ "$REAL_NPM" = "$0" ]; then',
-		'  OLD_IFS="$IFS"',
-		'  IFS=":"',
-		'  for dir in $PATH; do',
-		'    [ -n "$dir" ] || continue',
-		'    [ -n "$GUARD_BIN" ] && [ "$dir" = "$GUARD_BIN" ] && continue',
-		'    if [ -x "$dir/npm" ]; then REAL_NPM="$dir/npm"; break; fi',
-		'  done',
-		'  IFS="$OLD_IFS"',
-		'fi',
-		'if [ -z "$REAL_NPM" ] || [ ! -x "$REAL_NPM" ]; then',
-		'  echo "ResolveIO QA command guard: unable to locate real npm." >&2',
-		'  exit 127',
-		'fi',
-		'if [ "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" = "build" ] || [ "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" = "support_build" ] || [ "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" = "support-build" ]; then',
-		'  if [ "${1:-}" = "run" ]; then',
-		'    case "${2:-}" in',
-		'      build-dev)',
-		'        echo "ResolveIO support lane guard: refusing npm run build-dev from the 5.3 build lane. Use a finite build-prod/tsc/unit self-gate or return a blocked self-gate." >&2',
-		'        exit 86',
-		'        ;;',
-		'      server|client|start|dev|serve|local-qa|qa|qa:*|test:browser|test:e2e|e2e)',
-		'        echo "ResolveIO support lane guard: refusing npm run ${2:-} from the 5.3 build lane. Browser/server/client QA belongs to the 5.4 mini QA lane." >&2',
-		'        exit 86',
-		'        ;;',
-		'    esac',
-		'  fi',
-		'fi',
-		'is_angular_build=0',
-		'if [ "${1:-}" = "run" ]; then',
-		'  case "${2:-}" in',
-		'    build|build-dev|build-prod) is_angular_build=1 ;;',
-		'  esac',
-		'fi',
-		'resolveio_lock_live() {',
-		'  local file="$1"',
-		'  local ttl="${RESOLVEIO_QA_COMMAND_LOCK_TTL_SECONDS:-1800}"',
-		'  [ -f "$file" ] || return 1',
-		'  node - "$file" "$ttl" <<\'RESOLVEIO_QA_LOCK_LIVE\'',
-		'const fs = require("fs");',
-		'const [file, ttlRaw] = process.argv.slice(2);',
-		'const ttlMs = Math.max(1, Number(ttlRaw || 1800)) * 1000;',
-		'try {',
-		'  const data = JSON.parse(fs.readFileSync(file, "utf8"));',
-		'  const pid = Number(data.pid || 0);',
-		'  const heartbeat = Date.parse(data.heartbeat_at || data.started_at || "");',
-		'  if (!pid || !heartbeat || Date.now() - heartbeat > ttlMs) process.exit(1);',
-		'  process.kill(pid, 0);',
-		'  process.exit(0);',
-		'} catch (error) { process.exit(1); }',
-		'RESOLVEIO_QA_LOCK_LIVE',
-		'}',
-		'if [ "$is_angular_build" = "1" ]; then',
-		'  PROJECT_ROOT="${RESOLVEIO_SUPPORT_QA_PROJECT_ROOT:-${RESOLVEIO_RUNNER_QA_PROJECT_ROOT:-$(pwd)}}"',
-		'  PROJECT_ROOT="$(cd "$PROJECT_ROOT" 2>/dev/null && pwd || pwd)"',
-		'  ARTIFACT_DIR="$PROJECT_ROOT/qa-artifacts"',
-		'  mkdir -p "$ARTIFACT_DIR/.command-locks"',
-		'  QA_LOCK="$ARTIFACT_DIR/.qa.lock/lock.json"',
-		'  if resolveio_lock_live "$QA_LOCK"; then',
-		'    echo "ResolveIO QA command guard: refusing npm run ${2:-} while local QA harness is active for $PROJECT_ROOT. Stop QA first with stop-local-qa.sh." >&2',
-		'    exit 86',
-		'  fi',
-		'  BUILD_LOCK_DIR="$ARTIFACT_DIR/.command-locks/angular-build.lock"',
-		'  BUILD_LOCK_JSON="$BUILD_LOCK_DIR/lock.json"',
-		'  if ! mkdir "$BUILD_LOCK_DIR" 2>/dev/null; then',
-		'    if resolveio_lock_live "$BUILD_LOCK_JSON"; then',
-		'      echo "ResolveIO QA command guard: refusing duplicate npm run ${2:-}; another Angular build is active for $PROJECT_ROOT." >&2',
-		'      exit 86',
-		'    fi',
-		'    rm -rf "$BUILD_LOCK_DIR" 2>/dev/null || true',
-		'    if ! mkdir "$BUILD_LOCK_DIR" 2>/dev/null; then',
-		'      echo "ResolveIO QA command guard: unable to acquire Angular build lock for $PROJECT_ROOT." >&2',
-		'      exit 86',
-		'    fi',
-		'  fi',
-		'  cat > "$BUILD_LOCK_JSON" <<EOF',
-		'{"pid": $$, "command": "npm $*", "project_root": "$PROJECT_ROOT", "started_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)", "heartbeat_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"}',
-		'EOF',
-		'  ( while true; do node - "$BUILD_LOCK_JSON" <<\'RESOLVEIO_QA_BUILD_HEARTBEAT\'',
-		'const fs = require("fs");',
-		'const [file] = process.argv.slice(2);',
-		'try {',
-		'  const data = JSON.parse(fs.readFileSync(file, "utf8"));',
-		'  data.heartbeat_at = new Date().toISOString();',
-		'  fs.writeFileSync(file, JSON.stringify(data, null, 2));',
-		'} catch (error) {}',
-		'RESOLVEIO_QA_BUILD_HEARTBEAT',
-		'    sleep 10',
-		'  done ) >/dev/null 2>&1 &',
-		'  HEARTBEAT_PID="$!"',
-		'  cleanup_build_lock() {',
-		'    kill "$HEARTBEAT_PID" >/dev/null 2>&1 || true',
-		'    rm -rf "$BUILD_LOCK_DIR" >/dev/null 2>&1 || true',
-		'  }',
-		'  trap cleanup_build_lock EXIT INT TERM',
-		'fi',
-		'exec "$REAL_NPM" "$@"',
-		'RESOLVEIO_QA_NPM_GUARD',
-		'  chmod +x "$RESOLVEIO_QA_COMMAND_GUARD_BIN/npm"',
-		'  export PATH="$RESOLVEIO_QA_COMMAND_GUARD_BIN:$PATH"',
-		'  hash -r 2>/dev/null || true',
-		'fi',
-		'export RESOLVEIO_QA_REAL_NODE="${RESOLVEIO_QA_REAL_NODE:-$(resolveio_qa_find_real_command node || true)}"',
-		'if [ -n "$RESOLVEIO_QA_REAL_NODE" ]; then',
-		'  cat > "$RESOLVEIO_QA_COMMAND_GUARD_BIN/node" <<\'RESOLVEIO_QA_NODE_GUARD\'',
-		'#!/usr/bin/env bash',
-		'set -u',
-		'REAL_NODE="${RESOLVEIO_QA_REAL_NODE:-}"',
-		'GUARD_BIN="${RESOLVEIO_QA_COMMAND_GUARD_BIN:-}"',
-		'if [ -z "$REAL_NODE" ] || [ "$REAL_NODE" = "$0" ]; then',
-		'  OLD_IFS="$IFS"',
-		'  IFS=":"',
-		'  for dir in $PATH; do',
-		'    [ -n "$dir" ] || continue',
-		'    [ -n "$GUARD_BIN" ] && [ "$dir" = "$GUARD_BIN" ] && continue',
-		'    if [ -x "$dir/node" ]; then REAL_NODE="$dir/node"; break; fi',
-		'  done',
-		'  IFS="$OLD_IFS"',
-		'fi',
-		'if [ -z "$REAL_NODE" ] || [ ! -x "$REAL_NODE" ]; then',
-		'  echo "ResolveIO QA command guard: unable to locate real node." >&2',
-		'  exit 127',
-		'fi',
-		'resolveio_qa_node_guard_active() {',
-		'  case "${RESOLVEIO_SUPPORT_CODEX_LANE:-}" in qa|support_qa|support-qa) return 0 ;; *) return 1 ;; esac',
-		'}',
-		'resolveio_qa_scan_inline_node_script() {',
-		'  local script_file="$1"',
-		'  [ -f "$script_file" ] || return 0',
-		`  if grep -Eiq "puppeteer browsers install|npx puppeteer|playwright install" "$script_file"; then`,
-		'    echo "ResolveIO QA command guard: refusing browser install/download commands. Use the staged browser executable from PUPPETEER_EXECUTABLE_PATH/CHROME_BIN." >&2',
-		'    exit 86',
-		'  fi',
-		'}',
-		'if resolveio_qa_node_guard_active; then',
-		'  case "${1:-}" in',
-		'    -)',
-		'      TMP_SCRIPT="${RESOLVEIO_QA_TMP:-/tmp/resolveio-support-qa}/inline-node-guard-$$.js"',
-		'      mkdir -p "$(dirname "$TMP_SCRIPT")"',
-		'      cat > "$TMP_SCRIPT"',
-		'      resolveio_qa_scan_inline_node_script "$TMP_SCRIPT"',
-		'      shift',
-		'      exec "$REAL_NODE" "$TMP_SCRIPT" "$@"',
-		'      ;;',
-		'    -e|--eval)',
-		'      TMP_SCRIPT="${RESOLVEIO_QA_TMP:-/tmp/resolveio-support-qa}/inline-node-guard-$$.js"',
-		'      mkdir -p "$(dirname "$TMP_SCRIPT")"',
-		'      printf "%s\\n" "${2:-}" > "$TMP_SCRIPT"',
-		'      resolveio_qa_scan_inline_node_script "$TMP_SCRIPT"',
-		'      exec "$REAL_NODE" "$@"',
-		'      ;;',
-		'  esac',
-		'fi',
-		'exec "$REAL_NODE" "$@"',
-		'RESOLVEIO_QA_NODE_GUARD',
-		'  chmod +x "$RESOLVEIO_QA_COMMAND_GUARD_BIN/node"',
-		'  export PATH="$RESOLVEIO_QA_COMMAND_GUARD_BIN:$PATH"',
-		'  hash -r 2>/dev/null || true',
-		'fi',
-		toolsBinPath ? `export PATH="${toolsBinPath}:$PATH"` : '',
-		'export NODE_ENV=development',
-		'# Local QA must start the application HTTP server even when launched from a dedicated support-manager worker.',
-		'export IS_WORKERS_ENABLED=false',
-		'export IS_WORKER_INSTANCE=false',
-		'export DISABLE_WORKER_SERVER_CONNECTION=false',
-		'export SUPPORT_CODEX_MANAGER_PROCESS_ONLY=false',
-		'export SUPPORT_AUTO_MANAGER_PROCESS_ONLY=false',
-		'export AI_ASSISTANT_CODEX_MANAGER_PROCESS_ONLY=false',
-		browserslistPath ? `export BROWSERSLIST_CONFIG="${browserslistPath}"` : '',
-		`export ${clientPortVar}="${'${' + clientPortVar + ':-${' + altClientPortVar + ':-' + defaultPort + '}}'}"`,
-		`export ${altClientPortVar}="${'${' + altClientPortVar + ':-${' + clientPortVar + '}}'}"`,
-		`export ${clientUrlVar}="${'${' + clientUrlVar + ':-${' + altClientUrlVar + ':-http://localhost:${' + clientPortVar + '}}}'}"`,
-		`export ${altClientUrlVar}="${'${' + altClientUrlVar + ':-${' + clientUrlVar + '}}'}"`,
-		`export ${serverUrlVar}="${'${' + serverUrlVar + ':-${' + altServerUrlVar + ':-http://localhost:8080}}'}"`,
-		`export ${altServerUrlVar}="${'${' + altServerUrlVar + ':-${' + serverUrlVar + '}}'}"`,
-		'export ADDITIONAL_ALLOWED_ORIGINS="${ADDITIONAL_ALLOWED_ORIGINS:-$' + clientUrlVar + '}"',
-		`export ${viewportWidthVar}="${'${' + viewportWidthVar + ':-${' + altViewportWidthVar + ':-1920}}'}"`,
-		`export ${altViewportWidthVar}="${'${' + altViewportWidthVar + ':-${' + viewportWidthVar + '}}'}"`,
-		`export ${viewportHeightVar}="${'${' + viewportHeightVar + ':-${' + altViewportHeightVar + ':-1080}}'}"`,
-		`export ${altViewportHeightVar}="${'${' + altViewportHeightVar + ':-${' + viewportHeightVar + '}}'}"`,
-		`export ${timeoutVar}="${'${' + timeoutVar + ':-${' + altTimeoutVar + ':-900}}'}"`,
-		`export ${altTimeoutVar}="${'${' + altTimeoutVar + ':-${' + timeoutVar + '}}'}"`,
-		`export ${prebundleVar}="${'${' + prebundleVar + ':-${' + altPrebundleVar + ':-false}}'}"`,
-		`export ${altPrebundleVar}="${'${' + altPrebundleVar + ':-${' + prebundleVar + '}}'}"`,
-		`export ${reuseVar}="${'${' + reuseVar + ':-${' + altReuseVar + ':-true}}'}"`,
-		`export ${altReuseVar}="${'${' + altReuseVar + ':-${' + reuseVar + '}}'}"`,
-		`export ${keepaliveVar}="${'${' + keepaliveVar + ':-${' + altKeepaliveVar + ':-false}}'}"`,
-		`export ${altKeepaliveVar}="${'${' + altKeepaliveVar + ':-${' + keepaliveVar + '}}'}"`,
-		`export ${mongoPortVar}="${'${' + mongoPortVar + ':-${' + altMongoPortVar + ':-3001}}'}"`,
-		`export ${altMongoPortVar}="${'${' + altMongoPortVar + ':-${' + mongoPortVar + '}}'}"`,
-		'export RESOLVEIO_QA_INHERITED_MONGO_URL="${RESOLVEIO_QA_INHERITED_MONGO_URL:-${MONGO_URL:-}}"',
-		`export ${mongoUrlVar}="mongodb://127.0.0.1:${'${' + mongoPortVar + '}'}/resolveio?directConnection=true"`,
-		`export ${altMongoUrlVar}="${'${' + mongoUrlVar + '}'}"`,
-		`export MONGO_URL="${'${' + mongoUrlVar + '}'}"`,
-		`export ${usernameVar}="${'${' + usernameVar + ':-${' + altUsernameVar + ':-' + username + '}}'}"`,
-		`export ${altUsernameVar}="${'${' + altUsernameVar + ':-${' + usernameVar + '}}'}"`,
-		`export ${passwordVar}="${'${' + passwordVar + ':-${' + altPasswordVar + ':-' + password + '}}'}"`,
-		`export ${altPasswordVar}="${'${' + altPasswordVar + ':-${' + passwordVar + '}}'}"`,
-		`export ${envVar(mode, 'JOB_ID')}="${'${' + envVar(mode, 'JOB_ID') + ':-${' + envVar(altMode, 'JOB_ID') + ':-' + jobId + '}}'}"`,
-		`export ${envVar(altMode, 'JOB_ID')}="${'${' + envVar(altMode, 'JOB_ID') + ':-${' + envVar(mode, 'JOB_ID') + '}}'}"`,
-		`export ${envVar(mode, 'OWNER_ID')}="${'${' + envVar(mode, 'OWNER_ID') + ':-${' + envVar(altMode, 'OWNER_ID') + ':-' + ownerId + '}}'}"`,
-		`export ${envVar(altMode, 'OWNER_ID')}="${'${' + envVar(altMode, 'OWNER_ID') + ':-${' + envVar(mode, 'OWNER_ID') + '}}'}"`,
-		`export ${envVar(mode, 'RUNNER_TOKEN')}="${'${' + envVar(mode, 'RUNNER_TOKEN') + ':-${' + envVar(altMode, 'RUNNER_TOKEN') + ':-' + runnerToken + '}}'}"`,
-		`export ${envVar(altMode, 'RUNNER_TOKEN')}="${'${' + envVar(altMode, 'RUNNER_TOKEN') + ':-${' + envVar(mode, 'RUNNER_TOKEN') + '}}'}"`,
-		`export ${envVar(mode, 'RUNNER_RUN_ID')}="${'${' + envVar(mode, 'RUNNER_RUN_ID') + ':-${' + envVar(altMode, 'RUNNER_RUN_ID') + ':-' + runnerRunId + '}}'}"`,
-		`export ${envVar(altMode, 'RUNNER_RUN_ID')}="${'${' + envVar(altMode, 'RUNNER_RUN_ID') + ':-${' + envVar(mode, 'RUNNER_RUN_ID') + '}}'}"`,
-		`export ${envVar(mode, 'RUNNER_GENERATION')}="${'${' + envVar(mode, 'RUNNER_GENERATION') + ':-${' + envVar(altMode, 'RUNNER_GENERATION') + ':-' + runnerGeneration + '}}'}"`,
-		`export ${envVar(altMode, 'RUNNER_GENERATION')}="${'${' + envVar(altMode, 'RUNNER_GENERATION') + ':-${' + envVar(mode, 'RUNNER_GENERATION') + '}}'}"`,
-		mongoRuntimePath ? `export ${envVar(mode, 'MONGO_RUNTIME_PATH')}="${'${' + envVar(mode, 'MONGO_RUNTIME_PATH') + ':-${' + envVar(altMode, 'MONGO_RUNTIME_PATH') + ':-' + mongoRuntimePath + '}}'}"` : '',
-		mongoRuntimePath ? `export ${envVar(altMode, 'MONGO_RUNTIME_PATH')}="${'${' + envVar(altMode, 'MONGO_RUNTIME_PATH') + ':-${' + envVar(mode, 'MONGO_RUNTIME_PATH') + '}}'}"` : '',
-		mongoRuntimePath ? `export RESOLVEIO_QA_MONGO_RUNTIME_PATH="${'${RESOLVEIO_QA_MONGO_RUNTIME_PATH:-$' + envVar(mode, 'MONGO_RUNTIME_PATH') + '}'}"` : '',
-		`export ${envVar(mode, 'LIVE_DATA_REQUIRED')}="${'${' + envVar(mode, 'LIVE_DATA_REQUIRED') + ':-${' + envVar(altMode, 'LIVE_DATA_REQUIRED') + ':-' + qaLiveDataRequired + '}}'}"`,
-		`export ${envVar(altMode, 'LIVE_DATA_REQUIRED')}="${'${' + envVar(altMode, 'LIVE_DATA_REQUIRED') + ':-${' + envVar(mode, 'LIVE_DATA_REQUIRED') + '}}'}"`,
-		`export RESOLVEIO_QA_LIVE_DATA_REQUIRED="${'${RESOLVEIO_QA_LIVE_DATA_REQUIRED:-$' + envVar(mode, 'LIVE_DATA_REQUIRED') + '}'}"`,
-		'export PUPPETEER_CACHE_DIR="/var/lib/resolveio/puppeteer"',
-		'RESOLVEIO_QA_NODE_PATH_ENTRIES=""',
-		'for RESOLVEIO_QA_NODE_MODULES in "$PWD/node_modules" "$PWD/server/node_modules" "$(cd "$PWD/.." 2>/dev/null && pwd)/node_modules" "$(cd "$PWD/.." 2>/dev/null && pwd)/server/node_modules" /var/app/current/node_modules; do',
-		'  if [ -d "$RESOLVEIO_QA_NODE_MODULES" ]; then',
-		'    if [ -z "$RESOLVEIO_QA_NODE_PATH_ENTRIES" ]; then RESOLVEIO_QA_NODE_PATH_ENTRIES="$RESOLVEIO_QA_NODE_MODULES"; else RESOLVEIO_QA_NODE_PATH_ENTRIES="$RESOLVEIO_QA_NODE_PATH_ENTRIES:$RESOLVEIO_QA_NODE_MODULES"; fi',
-		'  fi',
-		'done',
-		'if [ -n "$RESOLVEIO_QA_NODE_PATH_ENTRIES" ]; then',
-		'  export NODE_PATH="${NODE_PATH:+$NODE_PATH:}$RESOLVEIO_QA_NODE_PATH_ENTRIES"',
-		'fi',
-		'unset RESOLVEIO_QA_NODE_MODULES RESOLVEIO_QA_NODE_PATH_ENTRIES',
-		'export PLAYWRIGHT_BROWSERS_PATH="${PLAYWRIGHT_BROWSERS_PATH:-$RESOLVEIO_QA_HOME/.cache/ms-playwright}"',
-		'# QA rows should launch their own scoped browser unless the runner explicitly provides a live endpoint later.',
-		'unset RESOLVEIO_RUNNER_QA_BROWSER_URL RESOLVEIO_SUPPORT_QA_BROWSER_URL',
-		'if [ -n "${PUPPETEER_EXECUTABLE_PATH:-}" ] && [ -x "$PUPPETEER_EXECUTABLE_PATH" ]; then',
-		'  export CHROME_BIN="${CHROME_BIN:-$PUPPETEER_EXECUTABLE_PATH}"',
-		'elif [ -n "${CHROME_BIN:-}" ] && [ -x "$CHROME_BIN" ]; then',
-		'  export PUPPETEER_EXECUTABLE_PATH="$CHROME_BIN"',
-		'else',
-		`  for ${browserLoopVar} in /var/lib/resolveio/puppeteer/chrome-headless-shell/linux-*/chrome-headless-shell-linux64/chrome-headless-shell /var/lib/resolveio/puppeteer/chrome/linux-*/chrome-linux64/chrome /usr/bin/google-chrome-stable /usr/bin/google-chrome /usr/bin/chromium /usr/bin/chromium-browser; do`,
-		`    if [ -x "$${browserLoopVar}" ]; then`,
-		`      export PUPPETEER_EXECUTABLE_PATH="$${browserLoopVar}"`,
-		`      export CHROME_BIN="$${browserLoopVar}"`,
-		'      break',
-		'    fi',
-		'  done',
-		'fi',
-		`unset ${browserLoopVar}`,
-		'export NPM_CONFIG_CACHE="$RESOLVEIO_QA_TMP/npm-cache"',
-		'export NPM_CONFIG_PREFER_OFFLINE=true',
-		'export NPM_CONFIG_PRODUCTION=false',
-		'export npm_config_production=false',
-		'export RESOLVEIO_SUPPORT_MONGOMS_PACKAGE_ROOT="$RESOLVEIO_QA_TMP/mongodb-memory-server-core"',
-		'export MONGOMS_DOWNLOAD_DIR="$RESOLVEIO_QA_TMP/mongodb-binaries"',
-		mongodbBinaryCachePath ? `export RESOLVEIO_SUPPORT_SHARED_MONGOMS_DOWNLOAD_DIR="${mongodbBinaryCachePath}"` : '',
-		'export MONGOMS_VERSION="${MONGOMS_VERSION:-7.0.14}"',
-		''
-	].filter((line) => line !== '').join('\n');
-}
-
-export function buildResolveIORunnerQaPreflightScript(): string {
-	return [
-		'#!/usr/bin/env node',
-		'const fs = require("fs");',
-		'const path = require("path");',
-		'const { spawnSync } = require("child_process");',
-		'const projectRoot = path.resolve(process.argv[2] || process.cwd());',
-		'const artifactDir = path.join(projectRoot, "qa-artifacts");',
-		'const resultPath = path.join(artifactDir, "qa-preflight-result.json");',
-		'fs.mkdirSync(artifactDir, { recursive: true });',
-		'const checks = [];',
-		'function now() { return new Date().toISOString(); }',
-		'function redact(value) { return String(value || "").replace(/mongodb(?:\\+srv)?:\\/\\/[^\\s"\\\']+/ig, "[redacted-mongo-url]").replace(/\\b(?:sk|ghp|AKIA)[A-Za-z0-9_\\-]{12,}\\b/g, "[redacted-secret]"); }',
-		'function check(name, status, message, extra = {}) { checks.push({ name, status, message: redact(message), checkedAt: now(), ...extra }); }',
-		'function fileExecutable(filePath) { try { fs.accessSync(filePath, fs.constants.X_OK); return true; } catch (error) { return false; } }',
-		'function readJson(filePath) { try { return JSON.parse(fs.readFileSync(filePath, "utf8")); } catch (error) { return null; } }',
-		'function packageScripts(root) { const pkg = readJson(path.join(root, "package.json")); return pkg && pkg.scripts && typeof pkg.scripts === "object" ? pkg.scripts : {}; }',
-		'function requireFromCandidates(candidates, label) {',
-		'	for (const candidate of candidates) {',
-		'		try { return { module: require(candidate), candidate }; } catch (error) {}',
-		'	}',
-		'	throw new Error(`Unable to require ${label} from ${candidates.join(", ")}`);',
-		'}',
-		'function shellWhich(command) {',
-		'	const result = spawnSync("bash", ["-lc", `command -v ${command}`], { encoding: "utf8", timeout: 3000 });',
-		'	return result.status === 0 ? String(result.stdout || "").trim().split(/\\r?\\n/)[0] : "";',
-		'}',
-		'try {',
-		'	const nodeMajor = Number(String(process.versions.node || "").split(".")[0] || 0);',
-		'	check("node_version", nodeMajor >= 22 && nodeMajor < 23 ? "pass" : "fail", `Node ${process.version}`, { version: process.version });',
-		'} catch (error) { check("node_version", "fail", error && error.message || error); }',
-		'try {',
-		'	const npmPath = shellWhich("npm");',
-		'	check("npm_available", npmPath ? "pass" : "fail", npmPath ? `npm found at ${npmPath}` : "npm was not found on PATH", { path: npmPath });',
-		'} catch (error) { check("npm_available", "fail", error && error.message || error); }',
-		'try {',
-		'	const scripts = packageScripts(projectRoot);',
-		'	const serverScripts = fs.existsSync(path.join(projectRoot, "server")) ? packageScripts(path.join(projectRoot, "server")) : {};',
-		'	check("client_start_script", scripts.client || scripts.start || scripts.server ? "pass" : "blocked", "Project package scripts checked.", { scripts: Object.keys(scripts).filter((key) => /^(client|start|server|dev|build|build-dev|build-prod)$/.test(key)) });',
-		'	check("server_start_script", !fs.existsSync(path.join(projectRoot, "server")) || serverScripts.server || serverScripts.start || serverScripts["build-prod"] ? "pass" : "blocked", "Server package scripts checked.", { scripts: Object.keys(serverScripts).filter((key) => /^(server|start|dev|build|build-dev|build-prod)$/.test(key)) });',
-		'} catch (error) { check("package_scripts", "blocked", error && error.message || error); }',
-		'try {',
-		'	const settingsCandidates = [',
-		'		path.join(projectRoot, "server", "settings.json"),',
-		'		path.join(projectRoot, "server", "settings.local.json"),',
-		'		path.join(projectRoot, "settings.json"),',
-		'		path.join(projectRoot, "settings.local.json"),',
-		'		path.join(projectRoot, "server", ".env"),',
-		'		path.join(projectRoot, "server", ".env.codex"),',
-		'		path.join(projectRoot, ".env"),',
-		'		path.join(projectRoot, ".env.codex")',
-		'	];',
-		'	const found = settingsCandidates.find((candidate) => fs.existsSync(candidate));',
-		'	check("settings_available", found || !fs.existsSync(path.join(projectRoot, "server")) ? "pass" : "blocked", found ? `Runtime settings/env file exists at ${path.relative(projectRoot, found)}` : "No server directory or settings file required.", { path: found ? path.relative(projectRoot, found) : "" });',
-		'} catch (error) { check("settings_available", "blocked", error && error.message || error); }',
-		'let puppeteer = null;',
-		'try {',
-		'	const candidates = [',
-		'		path.join(projectRoot, "node_modules", "puppeteer"),',
-		'		path.join(projectRoot, "server", "node_modules", "puppeteer"),',
-		'		path.join(projectRoot, "node_modules", "puppeteer-core"),',
-		'		path.join(projectRoot, "server", "node_modules", "puppeteer-core"),',
-		'		"puppeteer",',
-		'		"puppeteer-core"',
-		'	];',
-		'	const found = requireFromCandidates(candidates, "puppeteer/puppeteer-core");',
-		'	puppeteer = found.module;',
-		'	check("puppeteer_require", "pass", `Loaded ${found.candidate}`);',
-		'} catch (error) { check("puppeteer_require", "blocked", error && error.message || error); }',
-		'let chromePath = String(process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_BIN || "").trim();',
-		'if (!chromePath) {',
-		'	const candidates = [',
-		'		"/var/lib/resolveio/puppeteer/chrome-headless-shell/linux-*/chrome-headless-shell-linux64/chrome-headless-shell",',
-		'		"/var/lib/resolveio/puppeteer/chrome/linux-*/chrome-linux64/chrome",',
-		'		"/usr/bin/google-chrome-stable",',
-		'		"/usr/bin/google-chrome",',
-		'		"/usr/bin/chromium",',
-		'		"/usr/bin/chromium-browser"',
-		'	];',
-		'	for (const pattern of candidates) {',
-		'		const result = spawnSync("bash", ["-lc", `for f in ${pattern}; do [ -x "$f" ] && echo "$f" && exit 0; done; exit 1`], { encoding: "utf8", timeout: 3000 });',
-		'		if (result.status === 0 && String(result.stdout || "").trim()) { chromePath = String(result.stdout || "").trim().split(/\\r?\\n/)[0]; break; }',
-		'	}',
-		'}',
-		'check("chrome_executable", chromePath && fileExecutable(chromePath) ? "pass" : "blocked", chromePath ? `Chrome executable ${chromePath}` : "No executable Chrome/Chromium path found.", { path: chromePath });',
-		'if (puppeteer && chromePath && fileExecutable(chromePath) && String(process.env.RESOLVEIO_QA_PREFLIGHT_SKIP_BROWSER_LAUNCH || "").toLowerCase() !== "true") {',
-		'	(async () => {',
-		'		let browser = null;',
-		'		try {',
-		'			browser = await puppeteer.launch({ executablePath: chromePath, headless: "new", args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage"] });',
-		'			check("chrome_launch", "pass", "Puppeteer launched the staged browser.");',
-		'		} catch (error) {',
-		'			check("chrome_launch", "blocked", error && error.message || error);',
-		'		} finally {',
-		'			if (browser) await browser.close().catch(() => undefined);',
-		'			finish();',
-		'		}',
-		'	})().catch((error) => { check("chrome_launch", "blocked", error && error.message || error); finish(); });',
-		'}',
-		'else {',
-		'	if (!puppeteer || !chromePath) check("chrome_launch", "skipped", "Browser launch skipped because Puppeteer or Chrome executable is unavailable.");',
-		'	finish();',
-		'}',
-		'function finish() {',
-		'	const failed = checks.filter((entry) => ["fail", "blocked"].includes(entry.status));',
-		'	const result = { status: failed.length ? "blocked" : "pass", outcome: failed.length ? "infra_failed" : "infra_passed", projectRoot, checks, updatedAt: now() };',
-		'	fs.writeFileSync(resultPath, JSON.stringify(result, null, 2));',
-		'	console.log(JSON.stringify(result, null, 2));',
-		'	process.exit(failed.length ? 2 : 0);',
-		'}',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerLocalQaScript(): string {
-	return [
-		'#!/usr/bin/env bash',
-		'set -u',
-		'TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
-		'source "$TOOLS_DIR/env.sh"',
-		'if resolveio_support_codex_lane_is_build 2>/dev/null; then',
-		'  resolveio_support_codex_block_build_lane_qa',
-		'  exit 86',
-		'fi',
-		'PROJECT_ROOT="${1:-$(pwd)}"',
-		'PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"',
-		'ARTIFACT_DIR="$PROJECT_ROOT/qa-artifacts"',
-		'mkdir -p "$ARTIFACT_DIR"',
-		'CLIENT_URL="${RESOLVEIO_RUNNER_QA_CLIENT_URL:-${RESOLVEIO_SUPPORT_QA_CLIENT_URL:-http://localhost:${RESOLVEIO_RUNNER_QA_CLIENT_PORT:-${RESOLVEIO_SUPPORT_QA_CLIENT_PORT:-4200}}}}"',
-		'SERVER_URL="${RESOLVEIO_RUNNER_QA_SERVER_URL:-${RESOLVEIO_SUPPORT_QA_SERVER_URL:-http://localhost:8080}}"',
-		'CLIENT_PORT="${RESOLVEIO_RUNNER_QA_CLIENT_PORT:-${RESOLVEIO_SUPPORT_QA_CLIENT_PORT:-4200}}"',
-		'SERVER_PORT="${RESOLVEIO_RUNNER_QA_SERVER_PORT:-${RESOLVEIO_SUPPORT_QA_SERVER_PORT:-8080}}"',
-		'MONGO_PORT="${RESOLVEIO_RUNNER_QA_MONGO_PORT:-${RESOLVEIO_SUPPORT_QA_MONGO_PORT:-3001}}"',
-		'INSPECT_PORT="${RESOLVEIO_RUNNER_QA_INSPECT_PORT:-${RESOLVEIO_SUPPORT_QA_INSPECT_PORT:-9229}}"',
-		'STARTUP_TIMEOUT="${RESOLVEIO_RUNNER_QA_ANGULAR_STARTUP_TIMEOUT_SECONDS:-${RESOLVEIO_SUPPORT_QA_ANGULAR_STARTUP_TIMEOUT_SECONDS:-900}}"',
-		'ANGULAR_PREBUNDLE="${RESOLVEIO_RUNNER_QA_ANGULAR_PREBUNDLE:-${RESOLVEIO_SUPPORT_QA_ANGULAR_PREBUNDLE:-false}}"',
-		'REUSE_RUNNING="${RESOLVEIO_RUNNER_QA_REUSE_RUNNING:-${RESOLVEIO_SUPPORT_QA_REUSE_RUNNING:-true}}"',
-		'if [[ "$(basename "$TOOLS_DIR")" == *support* ]]; then',
-		'  KEEPALIVE="${RESOLVEIO_SUPPORT_QA_KEEPALIVE:-${RESOLVEIO_RUNNER_QA_KEEPALIVE:-false}}"',
-		'else',
-		'  KEEPALIVE="${RESOLVEIO_RUNNER_QA_KEEPALIVE:-${RESOLVEIO_SUPPORT_QA_KEEPALIVE:-false}}"',
-		'fi',
-		'case "${KEEPALIVE,,}" in',
-		'  true|1|yes|on) exec >> "$ARTIFACT_DIR/runner.log" 2>&1 ;;',
-		'esac',
-		'SERVER_STABLE_SECONDS="${RESOLVEIO_RUNNER_QA_SERVER_STABLE_SECONDS:-${RESOLVEIO_SUPPORT_QA_SERVER_STABLE_SECONDS:-20}}"',
-		'LOCK_DIR="$ARTIFACT_DIR/.qa.lock"',
-		'SERVER_PID=""',
-		'CLIENT_PID=""',
-		'SERVER_REQUIRED=0',
-		'RUNNER_REUSED_READY=0',
-		'ANGULAR_PREBUNDLE_ARGS=()',
-		'REPO_ROOT="$(git -C "$PROJECT_ROOT" rev-parse --show-toplevel 2>/dev/null || echo "$PROJECT_ROOT")"',
-		buildRunnerProcessJanitorShellLibrary({ mode: 'support' }),
-		'case "${ANGULAR_PREBUNDLE,,}" in',
-		'  false|0|no|off) ANGULAR_PREBUNDLE_ARGS=(--prebundle=false) ;;',
-		'esac',
-		'kill_tree() {',
-		'  local pid="$1"',
-		'  [ -n "$pid" ] || return 0',
-		'  for child in $(pgrep -P "$pid" 2>/dev/null || true); do kill_tree "$child"; done',
-		'  kill "$pid" >/dev/null 2>&1 || true',
-		'  sleep 1',
-		'  kill -0 "$pid" >/dev/null 2>&1 && kill -9 "$pid" >/dev/null 2>&1 || true',
-		'}',
-		'kill_port_listeners() {',
-		'  local port="$1"',
-		'  [ -n "$port" ] || return 0',
-		'  local pids=""',
-		'  if command -v lsof >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 lsof -ti tcp:"$port")"; fi',
-		'  if command -v fuser >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 fuser -n tcp "$port")"; fi',
-		'  if command -v ss >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 ss -ltnp "sport = :$port" | sed -n \'s/.*pid=\\([0-9][0-9]*\\).*/\\1/p\' || true)"; fi',
-		'  for pid in $pids; do',
-		'    [ "$pid" = "$$" ] && continue',
-		'    kill_tree "$pid"',
-		'  done',
-		'  sleep 1',
-		'}',
-		'kill_env_marked_processes() {',
-		'  [ -d /proc ] || return 0',
-		'  local job_id="${RESOLVEIO_RUNNER_QA_JOB_ID:-${RESOLVEIO_SUPPORT_QA_JOB_ID:-}}"',
-		'  local owner_id="${RESOLVEIO_RUNNER_QA_OWNER_ID:-${RESOLVEIO_SUPPORT_QA_OWNER_ID:-}}"',
-		'  local token="${RESOLVEIO_RUNNER_QA_RUNNER_TOKEN:-${RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN:-}}"',
-		'  [ -n "$job_id$owner_id$token" ] || return 0',
-		'  for env_file in /proc/[0-9]*/environ; do',
-		'    pid="${env_file#/proc/}"',
-		'    pid="${pid%/environ}"',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    [ "$pid" = "$$" ] && continue',
-		'    [ -r "$env_file" ] || continue',
-		'    env_text="$(tr "\\0" "\\n" < "$env_file" 2>/dev/null || true)"',
-		'    [ -n "$env_text" ] || continue',
-		'    matched=0',
-		'    [ -n "$job_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_JOB_ID|RESOLVEIO_SUPPORT_QA_JOB_ID)=$job_id$" && matched=1',
-		'    [ "$matched" = "0" ] && [ -n "$owner_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_OWNER_ID|RESOLVEIO_SUPPORT_QA_OWNER_ID)=$owner_id$" && matched=1',
-		'    [ "$matched" = "0" ] && [ -n "$token" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_RUNNER_TOKEN|RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN)=$token$" && matched=1',
-		'    [ "$matched" = "1" ] && kill_tree "$pid"',
-		'  done',
-		'}',
-		'kill_artifact_log_writers() {',
-		'  local artifact="$ARTIFACT_DIR"',
-		'  [ -n "$artifact" ] || return 0',
-		'  for pid in $(ps -eo pid=,args= | awk -v artifact="$artifact" \'index($0, artifact) && $0 !~ /awk -v artifact=/ && $0 !~ /ps -eo pid=,args=/ && $0 ~ /(^|[ /])(tee|tail)( |$)/ {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    kill_tree "$pid"',
-		'  done',
-		'}',
-		'kill_local_mongo_processes() {',
-		'  local mongo_port="$MONGO_PORT"',
-		'  local root="$PROJECT_ROOT"',
-		'  [ -n "$mongo_port$root" ] || return 0',
-		'  for pid in $(ps -eo pid=,args= | awk -v port="$mongo_port" -v root="$root" \'$0 !~ /awk -v port=/ && $0 !~ /ps -eo pid=,args=/ && $0 ~ /mongod/ && (($0 ~ ("--port " port)) || index($0, root "/server/mongo/data/db") || index($0, root "/mongo/data/db")) && ($0 ~ /\\/tmp\\/resolveio-support-qa\\/.*mongod/ || index($0, root) || $0 ~ /--dbpath .*mongo\\/data\\/db/) {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    [ "$pid" = "$$" ] && continue',
-		'    kill_tree "$pid"',
-		'    sleep 1',
-		'    kill -0 "$pid" >/dev/null 2>&1 && kill -9 "$pid" >/dev/null 2>&1 || true',
-		'  done',
-		'}',
-		'RUNNER_ANCESTOR_PIDS=" $$ ${PPID:-} "',
-		'ancestor_pid="${PPID:-}"',
-		'while [ -n "$ancestor_pid" ] && [ "$ancestor_pid" != "0" ] && [ "$ancestor_pid" != "1" ]; do',
-		'  ancestor_pid="$(ps -o ppid= -p "$ancestor_pid" 2>/dev/null | tr -d " " || true)"',
-		'  [ -n "$ancestor_pid" ] && RUNNER_ANCESTOR_PIDS="$RUNNER_ANCESTOR_PIDS $ancestor_pid "',
-		'done',
-		'skip_cleanup_pid() {',
-		'  case "$RUNNER_ANCESTOR_PIDS" in *" $1 "*) return 0 ;; esac',
-		'  return 1',
-		'}',
-		'cleanup_project_processes() {',
-		'  for pid_file in "$ARTIFACT_DIR/server.pid" "$ARTIFACT_DIR/client.pid"; do',
-		'    [ -f "$pid_file" ] || continue',
-		'    pid="$(cat "$pid_file" 2>/dev/null || true)"',
-		'    kill_tree "$pid"',
-		'    rm -f "$pid_file"',
-		'  done',
-		'  for pass in 1 2 3; do',
-		'    for port in "$CLIENT_PORT" "$SERVER_PORT" "$MONGO_PORT" "$INSPECT_PORT"; do kill_port_listeners "$port"; done',
-		'    kill_env_marked_processes',
-		'    kill_artifact_log_writers',
-		'    kill_local_mongo_processes',
-		'    for pid in $(ps -eo pid=,args= | awk -v root="$PROJECT_ROOT" \'index($0, root) && $0 !~ /awk -v root=/ && $0 !~ /ps -eo pid=,args=/ && $0 !~ /run-local-qa\\.sh|stop-local-qa\\.sh|bugfix-comparison-qa\\.sh/ && $0 ~ /(ng serve|node .*node_modules\\/\\.bin\\/ng[[:space:]]+serve|esbuild --service|npm run client|start_client\\.sh|npm run server|start_server\\.sh|nodemon|node .*tmp\\/index\\.js|mongod|mongodb-binaries\\/mongod)/ {print $1}\' 2>/dev/null || true); do',
-		'      skip_cleanup_pid "$pid" && continue',
-		'      kill_tree "$pid"',
-		'    done',
-		'    # Do not kill arbitrary processes by project cwd; completion builds run',
-		'    # from the same cwd. Cleanup is limited to known QA process signatures,',
-		'    # recorded PIDs, scoped ports, and QA runner env markers.',
-		'    sleep 1',
-		'  done',
-		'  local wait_until=$((SECONDS + 60))',
-		'  while [ "$SECONDS" -lt "$wait_until" ]; do',
-		'    local found=0',
-		'    for port in "$CLIENT_PORT" "$SERVER_PORT" "$MONGO_PORT" "$INSPECT_PORT"; do',
-		'      port_pids=""',
-		'      if command -v lsof >/dev/null 2>&1; then port_pids="$port_pids $(janitor_bounded 3 lsof -ti tcp:"$port")"; fi',
-		'      for pid in $port_pids; do skip_cleanup_pid "$pid" && continue; found=1; kill_tree "$pid"; done',
-		'    done',
-		'    if [ -d /proc ]; then',
-		'      job_id="${RESOLVEIO_RUNNER_QA_JOB_ID:-${RESOLVEIO_SUPPORT_QA_JOB_ID:-}}"',
-		'      owner_id="${RESOLVEIO_RUNNER_QA_OWNER_ID:-${RESOLVEIO_SUPPORT_QA_OWNER_ID:-}}"',
-		'      token="${RESOLVEIO_RUNNER_QA_RUNNER_TOKEN:-${RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN:-}}"',
-		'      for env_file in /proc/[0-9]*/environ; do',
-		'        pid="${env_file#/proc/}"',
-		'        pid="${pid%/environ}"',
-		'        skip_cleanup_pid "$pid" && continue',
-		'        [ -r "$env_file" ] || continue',
-		'        env_text="$(tr "\\0" "\\n" < "$env_file" 2>/dev/null || true)"',
-		'        matched=0',
-		'        [ -n "$job_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_JOB_ID|RESOLVEIO_SUPPORT_QA_JOB_ID)=$job_id$" && matched=1',
-		'        [ "$matched" = "0" ] && [ -n "$owner_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_OWNER_ID|RESOLVEIO_SUPPORT_QA_OWNER_ID)=$owner_id$" && matched=1',
-		'        [ "$matched" = "0" ] && [ -n "$token" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_RUNNER_TOKEN|RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN)=$token$" && matched=1',
-		'        [ "$matched" = "1" ] && found=1 && kill_tree "$pid"',
-		'      done',
-		'    fi',
-		'    kill_artifact_log_writers',
-		'    kill_local_mongo_processes',
-		'    for pid in $(ps -eo pid=,args= | awk -v root="$PROJECT_ROOT" \'index($0, root) && $0 !~ /awk -v root=/ && $0 !~ /ps -eo pid=,args=/ && $0 !~ /run-local-qa\\.sh|stop-local-qa\\.sh|bugfix-comparison-qa\\.sh/ && $0 ~ /(ng serve|node .*node_modules\\/\\.bin\\/ng[[:space:]]+serve|esbuild --service|npm run client|start_client\\.sh|npm run server|start_server\\.sh|nodemon|node .*tmp\\/index\\.js|mongod|mongodb-binaries\\/mongod)/ {print $1}\' 2>/dev/null || true); do',
-		'      skip_cleanup_pid "$pid" && continue',
-		'      found=1',
-		'    done',
-		'    [ "$found" = "0" ] && break',
-		'    sleep 2',
-		'  done',
-		'}',
-		'cleanup() {',
-		'  [ "${RUNNER_REUSED_READY:-0}" = "1" ] && return 0',
-		'  janitor_stop_heartbeat',
-		'  rm -f "$ARTIFACT_DIR/heartbeat.pid"',
-		'  janitor_update_manifest_status cleanup_started',
-		'  kill_tree "$SERVER_PID"',
-		'  kill_tree "$CLIENT_PID"',
-		'  cleanup_project_processes',
-		'  janitor_update_manifest_status cleanup_complete',
-		'  janitor_write_cleanup_status complete 0',
-		'  rm -rf "$LOCK_DIR" >/dev/null 2>&1 || true',
-		'}',
-		'trap cleanup EXIT',
-		'detach_keepalive() {',
-		'  if ! probe_url "$CLIENT_URL"; then',
-		'    echo "ResolveIO AI runner QA keepalive refused: client URL is no longer reachable at $CLIENT_URL." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    return 1',
-		'  fi',
-		'  if [ "${SERVER_REQUIRED:-0}" = "1" ] && ! probe_url "$SERVER_URL"; then',
-		'    echo "ResolveIO AI runner QA keepalive refused: server URL is no longer reachable at $SERVER_URL." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    return 4',
-		'  fi',
-		'  janitor_update_manifest_status ready_keepalive',
-		'  janitor_write_cleanup_status ready_keepalive 0',
-		'  rm -rf "$LOCK_DIR" >/dev/null 2>&1 || true',
-		'  trap - EXIT',
-		'  disown >/dev/null 2>&1 || true',
-		'  echo "ResolveIO AI runner QA keepalive detached at $CLIENT_URL; stop with $TOOLS_DIR/stop-local-qa.sh $PROJECT_ROOT."',
-		'  exit 0',
-		'}',
-		'probe_url() { node - "$1" <<\'RESOLVEIO_PROBE\'',
-		'const http = require("http");',
-		'const https = require("https");',
-		'const url = process.argv[2];',
-		'const mod = /^https:/i.test(url) ? https : http;',
-		'const req = mod.get(url, { timeout: 2500 }, (res) => { res.resume(); process.exit(res.statusCode && res.statusCode < 500 ? 0 : 1); });',
-		'req.on("timeout", () => req.destroy(new Error("timeout")));',
-		'req.on("error", () => process.exit(1));',
-		'RESOLVEIO_PROBE',
-		'}',
-		'truthy() { case "${1,,}" in true|1|yes|on) return 0 ;; *) return 1 ;; esac; }',
-		'reuse_running_app_if_ready() {',
-		'  truthy "$REUSE_RUNNING" || return 1',
-		'  [ -d "$PROJECT_ROOT/server" ] && SERVER_REQUIRED=1 || SERVER_REQUIRED=0',
-		'  probe_url "$CLIENT_URL" || return 1',
-		'  if [ "$SERVER_REQUIRED" = "1" ] && ! probe_url "$SERVER_URL"; then return 1; fi',
-		'  echo "ResolveIO AI runner QA reusing already-ready local app at $CLIENT_URL"',
-		'  return 0',
-		'}',
-		'log_has_fatal() {',
-		'  local file="$1"',
-		'  [ -f "$file" ] || return 1',
-		'  grep -Eiq "Unhandled Rejection|Cannot read properties of undefined|TypeError|ReferenceError|EADDRINUSE|app crashed|Failed to compile|Compilation failed|TypeScript:.*(semantic errors|Compilation failed)|error TS[0-9]{4}|NG[0-9]{4}|TS[0-9]{4}|Error: Cannot find module" "$file"',
-		'}',
-		'prepare_angular_cache_dirs() {',
-		'  [ -d "$PROJECT_ROOT" ] || return 0',
-		'  mkdir -p "$PROJECT_ROOT/.angular/cache" 2>/dev/null || true',
-		'  local version=""',
-		'  for pkg in "$PROJECT_ROOT/node_modules/@angular/build/package.json" "$PROJECT_ROOT/node_modules/@angular/cli/package.json" "$PROJECT_ROOT/node_modules/@angular-devkit/build-angular/package.json"; do',
-		'    if [ -f "$pkg" ]; then',
-		'      version="$(node -e "try{console.log(require(process.argv[1]).version||\\\"\\\")}catch(e){}" "$pkg" 2>/dev/null | head -1)"',
-		'      [ -n "$version" ] && break',
-		'    fi',
-		'  done',
-		'  [ -n "$version" ] || return 0',
-		'  node - "$PROJECT_ROOT/angular.json" "$(basename "$PROJECT_ROOT")" <<\'RESOLVEIO_ANGULAR_CACHE_PROJECTS\' | while IFS= read -r project; do',
-		'const fs = require("fs");',
-		'const path = process.argv[2];',
-		'const fallback = process.argv[3];',
-		'const names = new Set([fallback].filter(Boolean));',
-		'try {',
-		'  const parsed = JSON.parse(fs.readFileSync(path, "utf8"));',
-		'  if (parsed.defaultProject) names.add(String(parsed.defaultProject));',
-		'  if (parsed.projects && typeof parsed.projects === "object") Object.keys(parsed.projects).forEach((name) => names.add(String(name)));',
-		'} catch (error) {}',
-		'for (const name of names) console.log(name.replace(/[^A-Za-z0-9._-]/g, "_"));',
-		'RESOLVEIO_ANGULAR_CACHE_PROJECTS',
-		'    [ -n "$project" ] || continue',
-		'    mkdir -p "$PROJECT_ROOT/.angular/cache/$version/$project/vite" 2>/dev/null || true',
-		'  done',
-		'}',
-		'server_has_started() {',
-		'  local file="$ARTIFACT_DIR/server.log"',
-		'  [ -f "$file" ] || return 1',
-		'  grep -Eiq "nodemon.*starting|node .*tmp/index\\.js|Running as Worker|Standalone Node Reaper|Running HTTP/WS server on port|listening on|server listening|Server listening|app listening|App listening|Finished .default." "$file"',
-		'}',
-		'wait_for_server_ready() {',
-		'  [ "$SERVER_REQUIRED" = "1" ] || return 0',
-		'  local end=$((SECONDS + STARTUP_TIMEOUT))',
-		'  while [ "$SECONDS" -lt "$end" ]; do',
-		'    if log_has_fatal "$ARTIFACT_DIR/server.log"; then return 4; fi',
-		'    if server_has_started; then',
-		'      local stable_until=$((SECONDS + SERVER_STABLE_SECONDS))',
-		'      while [ "$SECONDS" -lt "$stable_until" ]; do if log_has_fatal "$ARTIFACT_DIR/server.log"; then return 4; fi; sleep 2; done',
-		'      return 0',
-		'    fi',
-		'    if probe_url "$SERVER_URL"; then',
-		'      local stable_until=$((SECONDS + SERVER_STABLE_SECONDS))',
-		'      while [ "$SECONDS" -lt "$stable_until" ]; do if log_has_fatal "$ARTIFACT_DIR/server.log"; then return 4; fi; sleep 2; done',
-		'      return 0',
-		'    fi',
-		'    sleep 5',
-		'  done',
-		'  return 4',
-		'}',
-		'wait_for_client() {',
-		'  local end=$((SECONDS + STARTUP_TIMEOUT))',
-		'  while [ "$SECONDS" -lt "$end" ]; do',
-		'    if [ -n "$CLIENT_PID" ] && ! kill -0 "$CLIENT_PID" >/dev/null 2>&1; then return 2; fi',
-		'    if log_has_fatal "$ARTIFACT_DIR/client.log"; then return 3; fi',
-		'    if log_has_fatal "$ARTIFACT_DIR/server.log"; then return 4; fi',
-		'    if probe_url "$CLIENT_URL"; then wait_for_server_ready || return $?; return 0; fi',
-		'    sleep 5',
-		'  done',
-		'  return 1',
-		'}',
-		'mongo_tcp_ready() {',
-		'  node - "$MONGO_PORT" <<\'RESOLVEIO_QA_MONGO_TCP\'',
-		'const net = require("net");',
-		'const port = Number(process.argv[2] || 3001);',
-		'const socket = net.createConnection({ host: "127.0.0.1", port, timeout: 1200 });',
-		'socket.once("connect", () => { socket.destroy(); process.exit(0); });',
-		'socket.once("timeout", () => { socket.destroy(); process.exit(1); });',
-		'socket.once("error", () => process.exit(1));',
-		'RESOLVEIO_QA_MONGO_TCP',
-		'}',
-		'mongo_primary_ready() {',
-		'  mongo_tcp_ready >/dev/null 2>&1 || return 1',
-		'  node - "$PROJECT_ROOT" "$REPO_ROOT" "$MONGO_PORT" <<\'RESOLVEIO_QA_MONGO_PRIMARY\'',
-		'const path = require("path");',
-		'const [projectRoot, repoRoot, portRaw] = process.argv.slice(2);',
-		'function requireMongo() {',
-		'  const candidates = [',
-		'    path.join(projectRoot || "", "server", "node_modules", "mongodb"),',
-		'    path.join(projectRoot || "", "node_modules", "mongodb"),',
-		'    path.join(repoRoot || "", "node_modules", "mongodb"),',
-		'    "mongodb"',
-		'  ];',
-		'  for (const candidate of candidates) {',
-		'    try { return require(candidate); } catch (error) {}',
-		'  }',
-		'  throw new Error("Unable to require mongodb for local QA primary readiness.");',
-		'}',
-		'(async () => {',
-		'  const port = Number(portRaw || 3001);',
-		'  const uri = `mongodb://127.0.0.1:${port}/admin?directConnection=true`;',
-		'  const { MongoClient } = requireMongo();',
-		'  const client = new MongoClient(uri, { serverSelectionTimeoutMS: 2500 });',
-		'  await client.connect();',
-		'  try {',
-		'    const admin = client.db("admin");',
-		'    try {',
-		'      await admin.command({ replSetInitiate: { _id: "rs0", members: [{ _id: 0, host: `127.0.0.1:${port}` }] } });',
-		'    } catch (error) {',
-		'      const message = String(error && error.message || error);',
-		'      if (!/already initialized|already.*initiated|InvalidReplicaSetConfig|already exists/i.test(message)) throw error;',
-		'    }',
-		'    let hello = null;',
-		'    try { hello = await admin.command({ hello: 1 }); } catch (error) {',
-		'      try { hello = await admin.command({ isMaster: 1 }); } catch (inner) { hello = null; }',
-		'    }',
-		'    const writable = !hello || hello.isWritablePrimary === true || hello.ismaster === true || !hello.setName;',
-		'    process.exit(writable ? 0 : 1);',
-		'  } finally {',
-		'    await client.close().catch(() => undefined);',
-		'  }',
-		'})().catch((error) => { console.error(error && error.stack || error); process.exit(1); });',
-		'RESOLVEIO_QA_MONGO_PRIMARY',
-		'}',
-		'start_local_mongo_for_prestart_seed() {',
-		'  if mongo_primary_ready >/dev/null 2>&1; then return 0; fi',
-		'  if command -v mongod >/dev/null 2>&1; then',
-		'    mkdir -p "$PROJECT_ROOT/server/mongo/data/db" "$PROJECT_ROOT/server/mongo/log"',
-		'    mongod --fork --dbpath "$PROJECT_ROOT/server/mongo/data/db" --logpath "$PROJECT_ROOT/server/mongo/log/mongo.log" --port "$MONGO_PORT" --replSet rs0 --bind_ip 127.0.0.1 >/dev/null 2>&1 || true',
-		'  fi',
-		'  local end=$((SECONDS + 45))',
-		'  while [ "$SECONDS" -lt "$end" ]; do',
-		'    if mongo_tcp_ready >/dev/null 2>&1; then break; fi',
-		'    sleep 2',
-		'  done',
-		'  if ! mongo_tcp_ready >/dev/null 2>&1; then return 1; fi',
-		'  if command -v mongosh >/dev/null 2>&1; then',
-		'    timeout 8s mongosh "mongodb://127.0.0.1:$MONGO_PORT/admin?directConnection=true" --quiet --eval "try { rs.initiate({_id: \'rs0\', members: [{ _id: 0, host: \'127.0.0.1:$MONGO_PORT\' }]}) } catch (e) {}" >/dev/null 2>&1 || true',
-		'  fi',
-		'  local primary_end=$((SECONDS + 75))',
-		'  while [ "$SECONDS" -lt "$primary_end" ]; do',
-		'    if mongo_primary_ready >/dev/null 2>&1; then return 0; fi',
-		'    if command -v mongosh >/dev/null 2>&1; then',
-		'      timeout 6s mongosh "mongodb://127.0.0.1:$MONGO_PORT/admin?directConnection=true" --quiet --eval "try { rs.initiate({_id: \'rs0\', members: [{ _id: 0, host: \'127.0.0.1:$MONGO_PORT\' }]}) } catch (e) {}" >/dev/null 2>&1 || true',
-		'    fi',
-		'    sleep 2',
-		'  done',
-		'  mongo_primary_ready >/dev/null 2>&1',
-		'}',
-		'materialize_live_mongo_runtime() {',
-		'  local runtime_file="$ARTIFACT_DIR/.mongo-runtime.json"',
-		'  node - "$runtime_file" "$PROJECT_ROOT" "$REPO_ROOT" <<\'RESOLVEIO_QA_MONGO_RUNTIME\'',
-		'const fs = require("fs");',
-		'const path = require("path");',
-		'const [runtimeFile, projectRootArg, repoRootArg] = process.argv.slice(2);',
-		'function parseEnv(filePath) {',
-		'  const out = {};',
-		'  try {',
-		'    for (const raw of fs.readFileSync(filePath, "utf8").split(/\\n/)) {',
-		'      const line = raw.trim();',
-		'      if (!line || line.startsWith("#")) continue;',
-		'      if (line.includes("=")) {',
-		'        const index = line.indexOf("=");',
-		'        out[line.slice(0, index).trim().replace(/^[\\\'"]|[\\\'"]$/g, "")] = line.slice(index + 1).trim().replace(/^[\\\'"]|[\\\'"],?$/g, "");',
-		'        continue;',
-		'      }',
-		'      const jsonish = line.match(/^[\\\'"]?([A-Z0-9_]+)[\\\'"]?\\s*:\\s*[\\\'"]?(.+?)[\\\'"]?,?$/i);',
-		'      if (jsonish) out[jsonish[1]] = jsonish[2].trim();',
-		'    }',
-		'  } catch (error) {}',
-		'  return out;',
-		'}',
-		'function readJson(filePath) { try { return JSON.parse(fs.readFileSync(filePath, "utf8")); } catch (error) { return {}; } }',
-		'function pick(obj, keys) { for (const key of keys) { if (obj && typeof obj[key] === "string" && obj[key].trim()) return obj[key].trim(); } return ""; }',
-		'function isLocalMongo(uri) { return /mongodb(?:\\+srv)?:\\/\\/(?:[^@/]+@)?(?:127\\.0\\.0\\.1|localhost)(?::\\d+)?\\//i.test(String(uri || "")); }',
-		'function unique(values) { return Array.from(new Set(values.filter(Boolean).map((value) => path.resolve(String(value))))); }',
-		'const appName = projectRootArg ? path.basename(projectRootArg) : "";',
-		'const runtimeFileCandidates = unique([',
-		'  process.env.RESOLVEIO_QA_MONGO_RUNTIME_PATH,',
-		'  process.env.RESOLVEIO_SUPPORT_QA_MONGO_RUNTIME_PATH,',
-		'  process.env.RESOLVEIO_RUNNER_QA_MONGO_RUNTIME_PATH,',
-		'  repoRootArg && path.join(repoRootArg, "mongo-context", ".mongo-runtime.json"),',
-		'  projectRootArg && path.join(projectRootArg, "mongo-context", ".mongo-runtime.json"),',
-		'  repoRootArg && path.join(repoRootArg, ".resolveio-support-context", "mongo-context", ".mongo-runtime.json"),',
-		'  projectRootArg && path.join(projectRootArg, ".resolveio-support-context", "mongo-context", ".mongo-runtime.json"),',
-		'  repoRootArg && path.join(repoRootArg, ".resolveio-context", "mongo-context", ".mongo-runtime.json"),',
-		'  projectRootArg && path.join(projectRootArg, ".resolveio-context", "mongo-context", ".mongo-runtime.json")',
-		']);',
-		'for (const candidate of runtimeFileCandidates) {',
-		'  const parsed = readJson(candidate);',
-		'  const uri = pick(parsed, ["mongo_uri", "MONGO_URL"]);',
-		'  const database = pick(parsed, ["mongo_db", "DATABASE", "database"]);',
-		'  if (uri && !isLocalMongo(uri)) {',
-		'    fs.mkdirSync(path.dirname(runtimeFile), { recursive: true });',
-		'    fs.writeFileSync(runtimeFile, JSON.stringify({ mongo_uri: uri, mongo_db: database || "" }, null, 2));',
-		'    process.exit(0);',
-		'  }',
-		'}',
-		'const runtimeRoots = unique([',
-		'  process.env.RESOLVEIO_QA_RUNTIME_ROOT,',
-		'  process.env.RESOLVEIO_SUPPORT_QA_RUNTIME_ROOT,',
-		'  projectRootArg && path.join(projectRootArg, "server"),',
-		'  projectRootArg,',
-		'  repoRootArg,',
-		'  appName && path.join("/var/app/current", appName, "server"),',
-		'  appName && path.join("/var/app/current", appName),',
-		'  appName === "resolveio" && "/var/app/current"',
-		']);',
-		'for (const root of runtimeRoots) {',
-		'  const env = Object.assign({}, parseEnv(path.join(root, ".env")), parseEnv(path.join(root, ".env.production")), parseEnv(path.join(root, ".env.runtime")), parseEnv(path.join(root, ".env.codex")));',
-		'  const settings = Object.assign({}, readJson(path.join(root, "settings.json")), readJson(path.join(root, "settings.local.json")));',
-		'  const uri = pick(env, ["MONGO_URL"]) || pick(settings, ["MONGO_URL", "mongo_url"]);',
-		'  const database = pick(env, ["DATABASE"]) || pick(settings, ["DATABASE", "database"]);',
-		'  if (uri && !isLocalMongo(uri)) {',
-		'    fs.mkdirSync(path.dirname(runtimeFile), { recursive: true });',
-		'    fs.writeFileSync(runtimeFile, JSON.stringify({ mongo_uri: uri, mongo_db: database || "" }, null, 2));',
-		'    process.exit(0);',
-		'  }',
-		'}',
-		'const fallbackUri = pick(process.env, ["RESOLVEIO_QA_LIVE_MONGO_URL", "RESOLVEIO_SUPPORT_QA_LIVE_MONGO_URL", "RESOLVEIO_RUNNER_QA_LIVE_MONGO_URL"]);',
-		'if (fallbackUri && !isLocalMongo(fallbackUri)) {',
-		'  const fallbackDatabase = pick(process.env, ["RESOLVEIO_QA_LIVE_MONGO_DB", "RESOLVEIO_SUPPORT_QA_LIVE_MONGO_DB", "RESOLVEIO_RUNNER_QA_LIVE_MONGO_DB"]);',
-		'  fs.mkdirSync(path.dirname(runtimeFile), { recursive: true });',
-		'  fs.writeFileSync(runtimeFile, JSON.stringify({ mongo_uri: fallbackUri, mongo_db: fallbackDatabase || "" }, null, 2));',
-		'  process.exit(0);',
-		'}',
-		'process.exit(0);',
-		'RESOLVEIO_QA_MONGO_RUNTIME',
-		'  if [ -s "$runtime_file" ]; then export RESOLVEIO_QA_MONGO_RUNTIME_PATH="$runtime_file"; fi',
-		'}',
-		'prestart_seed_live_data() {',
-		'  local required="${RESOLVEIO_RUNNER_QA_LIVE_DATA_REQUIRED:-${RESOLVEIO_SUPPORT_QA_LIVE_DATA_REQUIRED:-false}}"',
-		'  truthy "$required" || return 0',
-		'  [ -f "$TOOLS_DIR/qa-live-data-seed.js" ] || return 0',
-		'  echo "ResolveIO AI runner QA pre-start live data seed/cleanup starting before app server startup." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'  if ! start_local_mongo_for_prestart_seed; then',
-		'    echo "ResolveIO AI runner QA pre-start local Mongo did not become ready for live-data seed." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    return 7',
-		'  fi',
-		'  materialize_live_mongo_runtime',
-		'  node "$TOOLS_DIR/qa-live-data-seed.js" "$PROJECT_ROOT" >> "$ARTIFACT_DIR/runner.log" 2>&1',
-		'  local seed_rc="$?"',
-		'  if [ "$seed_rc" != "0" ]; then',
-		'    echo "ResolveIO AI runner QA pre-start live data seed failed before app server startup (exit $seed_rc)." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    return "$seed_rc"',
-		'  fi',
-		'  export RESOLVEIO_QA_PRESTART_MONGO_READY=1',
-		'  return 0',
-		'}',
-		'prepare_tmp_server_settings() {',
-		'  mkdir -p "$PROJECT_ROOT/server/tmp"',
-		'  for f in settings.json settings.local.json .env .env.runtime .env.production .env.dev; do',
-		'    if [ -f "$PROJECT_ROOT/server/$f" ]; then cp "$PROJECT_ROOT/server/$f" "$PROJECT_ROOT/server/tmp/$f"; elif [ -f "$PROJECT_ROOT/$f" ]; then cp "$PROJECT_ROOT/$f" "$PROJECT_ROOT/server/tmp/$f"; fi',
-		'  done',
-		'  if [ ! -f "$PROJECT_ROOT/server/tmp/settings.json" ] && [ -f "$PROJECT_ROOT/server/tmp/settings.local.json" ]; then cp "$PROJECT_ROOT/server/tmp/settings.local.json" "$PROJECT_ROOT/server/tmp/settings.json"; fi',
-		'  [ -f "$PROJECT_ROOT/server/tmp/settings.json" ]',
-		'}',
-		'preseeded_tmp_server_ready() {',
-		'  [ -f "$PROJECT_ROOT/server/tmp/index.js" ] || return 1',
-		'  prepare_tmp_server_settings >/dev/null 2>&1 || return 1',
-		'  return 0',
-		'}',
-		'run_preseeded_tmp_server() {',
-		'  cd "$PROJECT_ROOT/server" || exit 4',
-		'  source "$TOOLS_DIR/env.sh"',
-		'  if [ -f "$HOME/.nvm/nvm.sh" ]; then source "$HOME/.nvm/nvm.sh"; nvm use 22 >/dev/null 2>&1 || true; fi',
-		'  if preseeded_tmp_server_ready; then',
-		'    echo "ResolveIO AI runner QA using existing compiled server/tmp/index.js for pre-seeded local Mongo."',
-		'    echo "ResolveIO AI runner QA starting node tmp/index.js"',
-		'    exec node --inspect=127.0.0.1:"$INSPECT_PORT" --max_old_space_size=3000 tmp/index.js',
-		'  fi',
-		'  echo "ResolveIO AI runner QA compiling server tmp output for pre-seeded local Mongo."',
-		'  node_modules/gulp/bin/gulp.js compile dotenv methodAndPublicationListGenerator',
-		'  compile_rc="$?"',
-		'  if [ "$compile_rc" != "0" ]; then echo "ResolveIO AI runner QA server compile failed before tmp startup (exit $compile_rc)."; exit "$compile_rc"; fi',
-		'  if ! prepare_tmp_server_settings; then echo "ResolveIO AI runner QA missing settings.json/settings.local.json for tmp server startup"; exit 4; fi',
-		'  if [ ! -f tmp/index.js ]; then echo "ResolveIO AI runner QA missing server/tmp/index.js after compile"; exit 4; fi',
-		'  echo "ResolveIO AI runner QA starting node tmp/index.js"',
-		'  exec node --inspect=127.0.0.1:"$INSPECT_PORT" --max_old_space_size=3000 tmp/index.js',
-		'}',
-		'if reuse_running_app_if_ready; then RUNNER_REUSED_READY=1; exit 0; fi',
-		'if ! mkdir "$LOCK_DIR" 2>/dev/null; then',
-		'  if janitor_lock_is_live; then',
-		'    echo "ResolveIO AI runner QA lock is already held by a live runner for $PROJECT_ROOT; refusing duplicate startup." | tee "$ARTIFACT_DIR/runner.log"',
-		'    exit 6',
-		'  fi',
-		'  echo "ResolveIO AI runner QA lock is stale for $PROJECT_ROOT; cleaning scoped local QA processes before retrying." | tee "$ARTIFACT_DIR/runner.log"',
-		'  cleanup_project_processes',
-		'  rm -rf "$LOCK_DIR" >/dev/null 2>&1 || true',
-		'  if ! mkdir "$LOCK_DIR" 2>/dev/null; then',
-		'    echo "ResolveIO AI runner QA lock is still held for $PROJECT_ROOT after cleanup. Stop the existing QA runner before starting another." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    exit 6',
-		'  fi',
-		'fi',
-		'janitor_write_lock',
-		'cleanup_project_processes',
-		': > "$ARTIFACT_DIR/server.log"',
-		': > "$ARTIFACT_DIR/client.log"',
-		': > "$ARTIFACT_DIR/runner.log"',
-		'janitor_write_manifest',
-		'janitor_start_heartbeat',
-		'echo "$RUNNER_JANITOR_HEARTBEAT_PID" > "$ARTIFACT_DIR/heartbeat.pid"',
-		'janitor_check_resources || exit $?',
-		'prestart_seed_live_data || exit $?',
-		'if [ -d "$PROJECT_ROOT/server" ]; then',
-		'  SERVER_REQUIRED=1',
-		'  if [ "${RESOLVEIO_QA_PRESTART_MONGO_READY:-}" = "1" ] && [ -x "$PROJECT_ROOT/server/node_modules/gulp/bin/gulp.js" ] && [ -f "$PROJECT_ROOT/server/gulpfile.js" ] && grep -q "mongo-start" "$PROJECT_ROOT/server/gulpfile.js"; then',
-		'    echo "ResolveIO AI runner QA using pre-seeded local Mongo; starting server without mongo-start." | tee -a "$ARTIFACT_DIR/runner.log"',
-		'    (run_preseeded_tmp_server 2>&1 | tee "$ARTIFACT_DIR/server.log") &',
-		'  elif node -e "const p=require(process.argv[1]); process.exit(p.scripts&&p.scripts.server?0:1)" "$PROJECT_ROOT/server/package.json" >/dev/null 2>&1; then',
-		'    (cd "$PROJECT_ROOT/server" && source "$TOOLS_DIR/env.sh" && npm run server 2>&1 | tee "$ARTIFACT_DIR/server.log") &',
-		'  elif [ -x "$PROJECT_ROOT/server/start_server.sh" ]; then',
-		'    (cd "$PROJECT_ROOT/server" && source "$TOOLS_DIR/env.sh" && ./start_server.sh 2>&1 | tee "$ARTIFACT_DIR/server.log") &',
-		'  else',
-		'    echo "ResolveIO AI runner QA cannot find npm server script or start_server.sh for $PROJECT_ROOT/server" | tee "$ARTIFACT_DIR/server.log"',
-		'    exit 5',
-		'  fi',
-		'  SERVER_PID=$!',
-		'  wait_for_server_ready',
-		'  SERVER_RESULT=$?',
-		'  if [ "$SERVER_RESULT" != "0" ]; then echo "ResolveIO AI runner QA server startup fatal error. See $ARTIFACT_DIR/server.log"; exit "$SERVER_RESULT"; fi',
-		'fi',
-		'CLIENT_HOST="${RESOLVEIO_RUNNER_QA_CLIENT_HOST:-${RESOLVEIO_SUPPORT_QA_CLIENT_HOST:-0.0.0.0}}"',
-		'if [ -x "$PROJECT_ROOT/node_modules/.bin/ng" ]; then',
-		'  prepare_angular_cache_dirs',
-		'  ANGULAR_OLD_SPACE="${RESOLVEIO_RUNNER_QA_ANGULAR_OLD_SPACE_MB:-${RESOLVEIO_SUPPORT_QA_ANGULAR_OLD_SPACE_MB:-3072}}"',
-		'  (cd "$PROJECT_ROOT" && source "$TOOLS_DIR/env.sh" && node --max_old_space_size="$ANGULAR_OLD_SPACE" ./node_modules/.bin/ng serve --watch --configuration local --host "$CLIENT_HOST" --port "$CLIENT_PORT" "${ANGULAR_PREBUNDLE_ARGS[@]}" 2>&1 | tee "$ARTIFACT_DIR/client.log") &',
-		'elif [ -x "$PROJECT_ROOT/start_client.sh" ]; then',
-		'  (cd "$PROJECT_ROOT" && source "$TOOLS_DIR/env.sh" && ./start_client.sh 2>&1 | tee "$ARTIFACT_DIR/client.log") &',
-		'elif node -e "const p=require(process.argv[1]); process.exit(p.scripts&&p.scripts.client?0:1)" "$PROJECT_ROOT/package.json" >/dev/null 2>&1; then',
-		'  (cd "$PROJECT_ROOT" && source "$TOOLS_DIR/env.sh" && npm run client 2>&1 | tee "$ARTIFACT_DIR/client.log") &',
-		'else',
-		'  echo "ResolveIO AI runner QA cannot find Angular CLI, start_client.sh, or npm client script for $PROJECT_ROOT" | tee "$ARTIFACT_DIR/client.log"',
-		'  exit 5',
-		'fi',
-		'CLIENT_PID=$!',
-		'wait_for_client',
-		'RESULT=$?',
-		'case "$RESULT" in',
-		'  0)',
-		'    echo "ResolveIO AI runner QA local app ready at $CLIENT_URL";',
-		'    echo "$SERVER_PID" > "$ARTIFACT_DIR/server.pid";',
-		'    echo "$CLIENT_PID" > "$ARTIFACT_DIR/client.pid";',
-		'    if truthy "$KEEPALIVE"; then detach_keepalive || exit $?; fi;',
-		'    exit 0',
-		'    ;;',
-		'  2) echo "ResolveIO AI runner QA client process exited before $CLIENT_URL became ready. See $ARTIFACT_DIR/client.log"; exit 2 ;;',
-		'  3) echo "ResolveIO AI runner QA client startup fatal error. See $ARTIFACT_DIR/client.log"; exit 3 ;;',
-		'  4) echo "ResolveIO AI runner QA server startup fatal error. See $ARTIFACT_DIR/server.log"; exit 4 ;;',
-		'  *) echo "ResolveIO AI runner QA local app did not become ready at $CLIENT_URL within ${STARTUP_TIMEOUT}s. See $ARTIFACT_DIR/client.log and $ARTIFACT_DIR/server.log"; exit 1 ;;',
-		'esac',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerLocalQaStopperScript(): string {
-	return [
-		'#!/usr/bin/env bash',
-		'set -u',
-		'TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
-		'source "$TOOLS_DIR/env.sh"',
-		'PROJECT_ROOT="${1:-$(pwd)}"',
-		'PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"',
-		'ARTIFACT_DIR="$PROJECT_ROOT/qa-artifacts"',
-		'CLIENT_PORT="${RESOLVEIO_RUNNER_QA_CLIENT_PORT:-${RESOLVEIO_SUPPORT_QA_CLIENT_PORT:-4200}}"',
-		'SERVER_PORT="${RESOLVEIO_RUNNER_QA_SERVER_PORT:-${RESOLVEIO_SUPPORT_QA_SERVER_PORT:-8080}}"',
-		'MONGO_PORT="${RESOLVEIO_RUNNER_QA_MONGO_PORT:-${RESOLVEIO_SUPPORT_QA_MONGO_PORT:-3001}}"',
-		'INSPECT_PORT="${RESOLVEIO_RUNNER_QA_INSPECT_PORT:-${RESOLVEIO_SUPPORT_QA_INSPECT_PORT:-9229}}"',
-		'REPO_ROOT="$(git -C "$PROJECT_ROOT" rev-parse --show-toplevel 2>/dev/null || echo "$PROJECT_ROOT")"',
-		buildRunnerProcessJanitorShellLibrary({ mode: 'support' }),
-		'STOP_LOCK_DIR="$ARTIFACT_DIR/.qa.stop.lock"',
-		'if ! mkdir "$STOP_LOCK_DIR" 2>/dev/null; then',
-		'  lock_pid="$(cat "$STOP_LOCK_DIR/pid" 2>/dev/null || true)"',
-		'  if [ -n "$lock_pid" ] && kill -0 "$lock_pid" >/dev/null 2>&1; then',
-		'    echo "ResolveIO AI runner QA cleanup already active for $PROJECT_ROOT; refusing duplicate stopper."',
-		'    exit 0',
-		'  fi',
-		'  rm -rf "$STOP_LOCK_DIR" >/dev/null 2>&1 || true',
-		'  mkdir "$STOP_LOCK_DIR" 2>/dev/null || { echo "ResolveIO AI runner QA cleanup lock still active for $PROJECT_ROOT."; exit 0; }',
-		'fi',
-		'echo "$$" > "$STOP_LOCK_DIR/pid" 2>/dev/null || true',
-		'trap \'rm -rf "$STOP_LOCK_DIR" >/dev/null 2>&1 || true\' EXIT',
-		'kill_tree() {',
-		'  local pid="$1"',
-		'  [ -n "$pid" ] || return 0',
-		'  kill -0 "$pid" >/dev/null 2>&1 || return 0',
-		'  for child in $(pgrep -P "$pid" 2>/dev/null || true); do kill_tree "$child"; done',
-		'  kill "$pid" >/dev/null 2>&1 || true',
-		'  sleep 1',
-		'  kill -0 "$pid" >/dev/null 2>&1 && kill -9 "$pid" >/dev/null 2>&1 || true',
-		'}',
-		'kill_port_listeners() {',
-		'  local port="$1"',
-		'  [ -n "$port" ] || return 0',
-		'  local pids=""',
-		'  if command -v lsof >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 lsof -ti tcp:"$port")"; fi',
-		'  if command -v fuser >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 fuser -n tcp "$port")"; fi',
-		'  if command -v ss >/dev/null 2>&1; then pids="$pids $(janitor_bounded 3 ss -ltnp "sport = :$port" | sed -n \'s/.*pid=\\([0-9][0-9]*\\).*/\\1/p\' || true)"; fi',
-		'  for pid in $pids; do',
-		'    [ "$pid" = "$$" ] && continue',
-		'    kill_tree "$pid"',
-		'  done',
-		'  sleep 1',
-		'}',
-		'kill_env_marked_processes() {',
-		'  [ -d /proc ] || return 0',
-		'  local job_id="${RESOLVEIO_RUNNER_QA_JOB_ID:-${RESOLVEIO_SUPPORT_QA_JOB_ID:-}}"',
-		'  local owner_id="${RESOLVEIO_RUNNER_QA_OWNER_ID:-${RESOLVEIO_SUPPORT_QA_OWNER_ID:-}}"',
-		'  local token="${RESOLVEIO_RUNNER_QA_RUNNER_TOKEN:-${RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN:-}}"',
-		'  [ -n "$job_id$owner_id$token" ] || return 0',
-		'  for env_file in /proc/[0-9]*/environ; do',
-		'    pid="${env_file#/proc/}"',
-		'    pid="${pid%/environ}"',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    [ "$pid" = "$$" ] && continue',
-		'    [ -r "$env_file" ] || continue',
-		'    env_text="$(tr "\\0" "\\n" < "$env_file" 2>/dev/null || true)"',
-		'    [ -n "$env_text" ] || continue',
-		'    matched=0',
-		'    [ -n "$job_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_JOB_ID|RESOLVEIO_SUPPORT_QA_JOB_ID)=$job_id$" && matched=1',
-		'    [ "$matched" = "0" ] && [ -n "$owner_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_OWNER_ID|RESOLVEIO_SUPPORT_QA_OWNER_ID)=$owner_id$" && matched=1',
-		'    [ "$matched" = "0" ] && [ -n "$token" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_RUNNER_TOKEN|RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN)=$token$" && matched=1',
-		'    [ "$matched" = "1" ] && kill_tree "$pid" && killed_count=$((killed_count + 1))',
-		'  done',
-		'}',
-		'kill_artifact_log_writers() {',
-		'  local artifact="$ARTIFACT_DIR"',
-		'  [ -n "$artifact" ] || return 0',
-		'  for pid in $(ps -eo pid=,args= | awk -v artifact="$artifact" \'index($0, artifact) && $0 !~ /awk -v artifact=/ && $0 !~ /ps -eo pid=,args=/ && $0 ~ /(^|[ /])(tee|tail)( |$)/ {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    kill_tree "$pid"',
-		'    killed_count=$((killed_count + 1))',
-		'  done',
-		'}',
-		'kill_local_mongo_processes() {',
-		'  local mongo_port="$MONGO_PORT"',
-		'  local root="$PROJECT_ROOT"',
-		'  [ -n "$mongo_port$root" ] || return 0',
-		'  for pid in $(ps -eo pid=,args= | awk -v port="$mongo_port" -v root="$root" \'$0 !~ /awk -v port=/ && $0 !~ /ps -eo pid=,args=/ && $0 ~ /mongod/ && (($0 ~ ("--port " port)) || index($0, root "/server/mongo/data/db") || index($0, root "/mongo/data/db")) && ($0 ~ /\\/tmp\\/resolveio-support-qa\\/.*mongod/ || index($0, root) || $0 ~ /--dbpath .*mongo\\/data\\/db/) {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    [ "$pid" = "$$" ] && continue',
-		'    kill_tree "$pid"',
-		'    sleep 1',
-		'    kill -0 "$pid" >/dev/null 2>&1 && kill -9 "$pid" >/dev/null 2>&1 || true',
-		'    killed_count=$((killed_count + 1))',
-		'  done',
-		'}',
-		'RUNNER_ANCESTOR_PIDS=" $$ ${PPID:-} "',
-		'ancestor_pid="${PPID:-}"',
-		'while [ -n "$ancestor_pid" ] && [ "$ancestor_pid" != "0" ] && [ "$ancestor_pid" != "1" ]; do',
-		'  ancestor_pid="$(ps -o ppid= -p "$ancestor_pid" 2>/dev/null | tr -d " " || true)"',
-		'  [ -n "$ancestor_pid" ] && RUNNER_ANCESTOR_PIDS="$RUNNER_ANCESTOR_PIDS $ancestor_pid "',
-		'done',
-		'skip_cleanup_pid() {',
-		'  case "$RUNNER_ANCESTOR_PIDS" in *" $1 "*) return 0 ;; esac',
-		'  return 1',
-		'}',
-		'janitor_update_manifest_status cleanup_started',
-		'killed_count=0',
-'for pid_file in "$ARTIFACT_DIR/heartbeat.pid" "$ARTIFACT_DIR/server.pid" "$ARTIFACT_DIR/client.pid"; do',
-		'  [ -f "$pid_file" ] || continue',
-		'  pid="$(cat "$pid_file" 2>/dev/null || true)"',
-		'  kill_tree "$pid"',
-		'  killed_count=$((killed_count + 1))',
-		'  rm -f "$pid_file"',
-		'done',
-		'for pass in 1 2 3; do',
-		'  for port in "$CLIENT_PORT" "$SERVER_PORT" "$MONGO_PORT" "$INSPECT_PORT"; do kill_port_listeners "$port"; done',
-		'  kill_env_marked_processes',
-		'  kill_artifact_log_writers',
-		'  kill_local_mongo_processes',
-		'  for pid in $(ps -eo pid=,args= | awk -v root="$PROJECT_ROOT" \'index($0, root) && $0 !~ /awk -v root=/ && $0 !~ /ps -eo pid=,args=/ && $0 !~ /run-local-qa\\.sh|stop-local-qa\\.sh|bugfix-comparison-qa\\.sh/ && $0 ~ /(ng serve|node .*node_modules\\/\\.bin\\/ng[[:space:]]+serve|esbuild --service|npm run client|start_client\\.sh|npm run server|start_server\\.sh|nodemon|node .*tmp\\/index\\.js|mongod|mongodb-binaries\\/mongod)/ {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    kill_tree "$pid"',
-		'    killed_count=$((killed_count + 1))',
-		'  done',
-		'  # Do not kill arbitrary processes by project cwd; completion builds run',
-		'  # from the same cwd. Stop only known QA process signatures, recorded PIDs,',
-		'  # scoped ports, and QA runner env markers.',
-		'  sleep 1',
-		'done',
-		'wait_until=$((SECONDS + 60))',
-	'while [ "$SECONDS" -lt "$wait_until" ]; do',
-		'  found=0',
-		'  for port in "$CLIENT_PORT" "$SERVER_PORT" "$MONGO_PORT" "$INSPECT_PORT"; do',
-		'    port_pids=""',
-		'    if command -v lsof >/dev/null 2>&1; then port_pids="$port_pids $(janitor_bounded 3 lsof -ti tcp:"$port")"; fi',
-		'    for pid in $port_pids; do skip_cleanup_pid "$pid" && continue; found=1; kill_tree "$pid"; done',
-		'  done',
-		'  if [ -d /proc ]; then',
-		'    job_id="${RESOLVEIO_RUNNER_QA_JOB_ID:-${RESOLVEIO_SUPPORT_QA_JOB_ID:-}}"',
-		'    owner_id="${RESOLVEIO_RUNNER_QA_OWNER_ID:-${RESOLVEIO_SUPPORT_QA_OWNER_ID:-}}"',
-		'    token="${RESOLVEIO_RUNNER_QA_RUNNER_TOKEN:-${RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN:-}}"',
-		'    for env_file in /proc/[0-9]*/environ; do',
-		'      pid="${env_file#/proc/}"',
-		'      pid="${pid%/environ}"',
-		'      skip_cleanup_pid "$pid" && continue',
-		'      [ -r "$env_file" ] || continue',
-		'      env_text="$(tr "\\0" "\\n" < "$env_file" 2>/dev/null || true)"',
-		'      matched=0',
-		'      [ -n "$job_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_JOB_ID|RESOLVEIO_SUPPORT_QA_JOB_ID)=$job_id$" && matched=1',
-		'      [ "$matched" = "0" ] && [ -n "$owner_id" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_OWNER_ID|RESOLVEIO_SUPPORT_QA_OWNER_ID)=$owner_id$" && matched=1',
-		'      [ "$matched" = "0" ] && [ -n "$token" ] && echo "$env_text" | grep -Eq "^(RESOLVEIO_RUNNER_QA_RUNNER_TOKEN|RESOLVEIO_SUPPORT_QA_RUNNER_TOKEN)=$token$" && matched=1',
-		'      [ "$matched" = "1" ] && found=1 && kill_tree "$pid"',
-		'    done',
-		'  fi',
-		'  kill_artifact_log_writers',
-		'  kill_local_mongo_processes',
-		'  for pid in $(ps -eo pid=,args= | awk -v root="$PROJECT_ROOT" \'index($0, root) && $0 !~ /awk -v root=/ && $0 !~ /ps -eo pid=,args=/ && $0 !~ /run-local-qa\\.sh|stop-local-qa\\.sh|bugfix-comparison-qa\\.sh/ && $0 ~ /(ng serve|node .*node_modules\\/\\.bin\\/ng[[:space:]]+serve|esbuild --service|npm run client|start_client\\.sh|npm run server|start_server\\.sh|nodemon|node .*tmp\\/index\\.js|mongod|mongodb-binaries\\/mongod)/ {print $1}\' 2>/dev/null || true); do',
-		'    skip_cleanup_pid "$pid" && continue',
-		'    found=1',
-		'  done',
-		'  [ "$found" = "0" ] && break',
-		'  sleep 2',
-		'done',
-		'rm -rf "$ARTIFACT_DIR/.qa.lock" >/dev/null 2>&1 || true',
-		'janitor_update_manifest_status stopped',
-		'janitor_write_cleanup_status stopped "$killed_count"',
-		'echo "ResolveIO AI runner QA local app stopped for $PROJECT_ROOT"',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerQaLiveDataSeederScript(): string {
-	return [
-			'#!/usr/bin/env node',
-			'const fs = require("fs");',
-			'const path = require("path");',
-			'const crypto = require("crypto");',
-		'',
-		'if (isBuildLane()) {',
-		'  console.error("ResolveIO support lane guard: live-data seeding is owned by the QA lane, not the 5.3 build lane.");',
-		'  process.exit(86);',
-		'}',
-		'',
-		'const projectRoot = path.resolve(process.argv[2] || process.cwd());',
-		'const repoRoot = findRepoRoot(projectRoot);',
-		'const artifactDir = path.join(projectRoot, "qa-artifacts");',
-		'fs.mkdirSync(artifactDir, { recursive: true });',
-		'const resultPath = path.join(artifactDir, "qa-live-data-seed-result.json");',
-		'',
-		'function writeResult(payload, exitCode = 0) {',
-		'  const full = { ...payload, created_at: new Date().toISOString() };',
-		'  normalizeCoverageMatrixFromLiveSeed(full);',
-		'  fs.writeFileSync(resultPath, JSON.stringify(full, null, 2));',
-		'  console.log(JSON.stringify(full, null, 2));',
-		'  process.exit(exitCode);',
-		'}',
-		'',
-		'function isBuildLane() {',
-		'  return /^(build|support_build|support-build)$/i.test(String(process.env.RESOLVEIO_SUPPORT_CODEX_LANE || "").trim());',
-		'}',
-		'',
-		'function findRepoRoot(start) {',
-		'  let current = start;',
-		'  for (let i = 0; i < 8; i += 1) {',
-		'    if (fs.existsSync(path.join(current, ".git"))) return current;',
-		'    const parent = path.dirname(current);',
-		'    if (parent === current) break;',
-		'    current = parent;',
-		'  }',
-		'  return start;',
-		'}',
-		'',
-		'function readJsonIfExists(filePath) {',
-		'  try { return JSON.parse(fs.readFileSync(filePath, "utf8")); } catch (error) { return null; }',
-		'}',
-		'',
-		'function normalizeCoverageMatrixFromLiveSeed(payload) {',
-		'  const bolContext = payload && payload.selected && payload.selected.truck_treating_bol_context;',
-		'  const notes = Array.isArray(payload && payload.notes) ? payload.notes.map((note) => String(note || "")) : [];',
-		'  const billingDisabled = notes.some((note) => /billing fixtures are disabled/i.test(note));',
-		'  if (!bolContext || !billingDisabled) return;',
-		'  const matrixPath = path.join(artifactDir, "qa-coverage-matrix.json");',
-		'  const matrix = readJsonIfExists(matrixPath) || { status: "started", seeded: true, source: "qa-live-data-seed" };',
-		'  const browserRoutes = bolContext.browser_routes && typeof bolContext.browser_routes === "object" ? bolContext.browser_routes : {};',
-		'  const routeHints = Array.isArray(bolContext.route_name_hints) ? bolContext.route_name_hints.map((value) => String(value || "").trim()).filter(Boolean) : [];',
-		'  const linkedRoutes = Array.isArray(bolContext.linked_truck_treating_routes) ? bolContext.linked_truck_treating_routes.map((value) => String(value || "").trim()).filter(Boolean) : [];',
-		'  const bolIds = Array.isArray(bolContext.bol_ids) ? bolContext.bol_ids.map((value) => String(value || "").trim()).filter(Boolean) : [];',
-		'  const routeIds = Array.isArray(bolContext.route_ids) ? bolContext.route_ids.map((value) => String(value || "").trim()).filter(Boolean) : [];',
-		'  const truckTreatingRouteIds = Array.isArray(bolContext.truck_treating_route_ids) ? bolContext.truck_treating_route_ids.map((value) => String(value || "").trim()).filter(Boolean) : [];',
-		'  const primaryStatus = String(bolContext.primary_bol_status || "");',
-		'  const delivered = Boolean(bolContext.primary_bol_delivered) || /delivered/i.test(primaryStatus);',
-		'  const hintedBol = routeHints.join(" ");',
-		'  const bolNumber = (/\\bBOL\\s*#?\\s*(\\d+)\\b/i.exec(hintedBol) || [])[1];',
-		'  const bolLabel = bolNumber ? `BOL ${bolNumber}` : (bolIds[0] ? `BOL ${bolIds[0]}` : "the requested BOL");',
-		'  const routeHint = routeHints.find((hint) => !/\\bBOL\\b/i.test(hint) && !/^\\d+$/.test(hint)) || "the ticket route hint";',
-		'  const routeSummary = linkedRoutes.length ? linkedRoutes.join(", ") : (truckTreatingRouteIds.length ? truckTreatingRouteIds.join(", ") : routeIds.slice(0, 6).join(", "));',
-		'  const deliveredNote = delivered ? ` The live BOL status is ${primaryStatus || "Delivered"}, so the direct delivery route is an action route that may correctly redirect; QA must use delivered Open File/detail proof or a localhost-only deliverable fixture copied from this live context for Treat/Deliver actions.` : "";',
-		'  const liveAssertion = `Live Mongo seeded ${bolLabel} and proved ${routeHint} is not a linked truck-treating route for that BOL; QA must continue against linked live route data: ${routeSummary}.${deliveredNote}`;',
-		'  matrix.status = "in_progress";',
-		'  matrix.source = "qa-live-data-seed-live-bol-context";',
-		'  matrix.live_seed_context_artifact = "qa-artifacts/qa-live-data-seed-result.json";',
-		'  matrix.billing_rows_removed_reason = "Live data seed disabled billing fixtures for this ticket; invoice/billing matrix rows do not apply to truck-treating BOL QA.";',
-		'  matrix.rows = [',
-		'    { workflow: "Truck treating BOL live-data target and route validation", route: browserRoutes.delivery || browserRoutes.detail || browserRoutes.list || "Deliver BOL live seeded BOL context", assertion: liveAssertion, required_proof: "Live Mongo seed artifact showing BOL id/status, linked route ids, ticket route-hint match result, and browser route.", status: "pass", result: "pass", screenshot: "", caption: `Live data seeded ${bolLabel}; the ticket route label did not match the BOL-linked live routes, so QA continued against ${routeSummary}.`, artifact: "qa-artifacts/qa-live-data-seed-result.json", persisted_assertion: `qa-live-data-seed-result.json route_hint_matched=${bolContext.route_hint_matched}; bol_ids=${bolIds.join(",") || "none"}; route_ids=${routeIds.length}; truck_treating_route_ids=${truckTreatingRouteIds.length}; primary_bol_status=${primaryStatus || "unknown"}.` },',
-		'    { workflow: "Delivered BOL detail/Open File proof", route: browserRoutes.detail || browserRoutes.list || browserRoutes.delivery || "/", assertion: `Open the seeded ${bolLabel} in the truck-treating delivered/detail workflow and prove the local QA database loaded the customer-facing BOL screen without relying on the already-delivered action route.`, required_proof: "Customer-facing screenshot of the BOL detail/list/Open File screen plus BOL id/status assertion from local Mongo.", status: "pending", screenshot: "", caption: "" },',
-		'    { workflow: "Deliver BOL service/flush rows do not render as missing chemicals", route: browserRoutes.delivery || browserRoutes.detail || "/", assertion: "Service/flush/non-chemical treatment plans must not be injected into the Deliver BOL chemical list as red missing chemical placeholders; chemical treatment rows still appear normally.", required_proof: "Customer-facing screenshot of the Deliver BOL/detail workflow or a localhost-only deliverable fixture copied from the seeded live BOL context, plus DOM/local Mongo assertion that missing placeholders are limited to Chemical treatment plans.", status: "pending", screenshot: "", caption: "" }',
-		'  ];',
-		'  fs.writeFileSync(matrixPath, JSON.stringify(matrix, null, 2));',
-		'}',
-		'',
-		'function preserveExistingSeedResult(reason) {',
-		'  const existing = readJsonIfExists(resultPath);',
-		'  const status = String(existing && existing.status || "").toLowerCase();',
-		'  const desiredProfile = desiredSeedProfile();',
-		'  if (existing && existing.profile && existing.profile !== desiredProfile) return;',
-		'  if (existing && existing.profile === "billing_inventory" && shouldSeedBillingDashboardFixtures() && !(existing.selected && existing.selected.qa_billing_fixture)) {',
-		'    return;',
-		'  }',
-		'  if (existing && extractBolIdentifiers().length && !(existing.selected && existing.selected.truck_treating_bol_context)) {',
-		'    return;',
-		'  }',
-		'  if (existing && extractBolIdentifiers().length && existing.selected && existing.selected.truck_treating_bol_context && !(existing.selected.truck_treating_bol_context.browser_routes && existing.selected.truck_treating_bol_context.browser_routes.delivery)) {',
-		'    return;',
-		'  }',
-		'  if (existing && extractBolIdentifiers().length && existing.selected && existing.selected.truck_treating_bol_context && !Object.prototype.hasOwnProperty.call(existing.selected.truck_treating_bol_context, "primary_bol_status")) {',
-		'    return;',
-		'  }',
-		'  if (existing && shouldAutoDiscoverAssetContext() && !(existing.selected && existing.selected.qa_asset_context)) {',
-		'    return;',
-		'  }',
-		'  if (existing && shouldAutoDiscoverProductionInterchangeablesContext() && !(existing.selected && existing.selected.qa_production_interchangeables_context)) {',
-		'    return;',
-		'  }',
-		'  if (["pass", "needs-data"].includes(status)) {',
-		'    normalizeCoverageMatrixFromLiveSeed(existing);',
-		'    const preserved = { ...existing, reused_existing: true, reuse_reason: reason, checked_at: new Date().toISOString() };',
-		'    console.log(JSON.stringify(preserved, null, 2));',
-		'    process.exit(0);',
-		'  }',
-		'}',
-		'',
-	'function resolveRuntimeSource() {',
-		'  const explicitRuntimePaths = [',
-		'    process.env.RESOLVEIO_QA_MONGO_RUNTIME_PATH,',
-		'    process.env.RESOLVEIO_SUPPORT_QA_MONGO_RUNTIME_PATH,',
-	'    process.env.RESOLVEIO_RUNNER_QA_MONGO_RUNTIME_PATH',
-	'  ].map((value) => String(value || "").trim()).filter(Boolean);',
-	'  const candidates = [',
-	'    ...explicitRuntimePaths,',
-	'    path.join(repoRoot, "mongo-context", ".mongo-runtime.json"),',
-	'    path.join(projectRoot, "mongo-context", ".mongo-runtime.json"),',
-		'    path.join(repoRoot, ".resolveio-support-context", "mongo-context", ".mongo-runtime.json"),',
-		'    path.join(projectRoot, ".resolveio-support-context", "mongo-context", ".mongo-runtime.json"),',
-		'    path.join(repoRoot, ".resolveio-context", "mongo-context", ".mongo-runtime.json"),',
-		'    path.join(projectRoot, ".resolveio-context", "mongo-context", ".mongo-runtime.json")',
-		'  ];',
-		'  for (const candidate of candidates) {',
-		'    const parsed = readJsonIfExists(candidate);',
-		'    if (parsed && parsed.mongo_uri) return { uri: String(parsed.mongo_uri || ""), database: String(parsed.mongo_db || "") };',
-		'  }',
-	'  const envUri = process.env.RESOLVEIO_QA_LIVE_MONGO_URL || process.env.RESOLVEIO_SUPPORT_QA_LIVE_MONGO_URL || process.env.RESOLVEIO_RUNNER_QA_LIVE_MONGO_URL || "";',
-	'  const envDb = process.env.RESOLVEIO_QA_LIVE_MONGO_DB || process.env.RESOLVEIO_SUPPORT_QA_LIVE_MONGO_DB || process.env.RESOLVEIO_RUNNER_QA_LIVE_MONGO_DB || "";',
-	'  if (envUri) return { uri: envUri, database: envDb };',
-		'  return { uri: "", database: "" };',
-		'}',
-		'',
-		'function redactUri(uri) {',
-		'  return String(uri || "").replace(/(mongodb(?:\\+srv)?:\\/\\/)([^:@/?#]+):([^@/?#]+)@/i, "$1$2:***@");',
-		'}',
-		'',
-	'function isLocalMongoUri(uri) {',
-	'  return /mongodb(?:\\+srv)?:\\/\\/(?:[^@/]+@)?(?:127\\.0\\.0\\.1|localhost)(?::\\d+)?\\//i.test(String(uri || ""));',
-		'}',
-	'',
-	'function isLiveDataRequired() {',
-	'  return /^(true|1|yes|on)$/i.test(String(process.env.RESOLVEIO_QA_LIVE_DATA_REQUIRED || process.env.RESOLVEIO_SUPPORT_QA_LIVE_DATA_REQUIRED || process.env.RESOLVEIO_RUNNER_QA_LIVE_DATA_REQUIRED || ""));',
-	'}',
-	'',
-	'function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }',
-	'',
-	'async function waitForTargetMongo(MongoClient, targetUri) {',
-	'  const deadline = Date.now() + Number(process.env.RESOLVEIO_QA_LOCAL_MONGO_WAIT_MS || process.env.RESOLVEIO_SUPPORT_QA_LOCAL_MONGO_WAIT_MS || process.env.RESOLVEIO_RUNNER_QA_LOCAL_MONGO_WAIT_MS || 60000);',
-	'  let lastError = null;',
-	'  while (Date.now() < deadline) {',
-	'    const client = new MongoClient(targetUri, { serverSelectionTimeoutMS: 2500 });',
-	'    try {',
-	'      await client.connect();',
-	'      const admin = client.db("admin");',
-	'      await admin.command({ ping: 1 });',
-	'      let hello = null;',
-	'      try { hello = await admin.command({ hello: 1 }); } catch (error) {',
-	'        try { hello = await admin.command({ isMaster: 1 }); } catch (inner) { hello = null; }',
-	'      }',
-	'      const writable = !hello || hello.isWritablePrimary === true || hello.ismaster === true || !hello.setName;',
-	'      if (!writable) {',
-	'        lastError = new Error(`target_local_mongo_not_primary: ${hello && (hello.primary || hello.me || hello.setName) || "unknown"}`);',
-	'        await client.close().catch(() => undefined);',
-	'        await delay(1500);',
-	'        continue;',
-	'      }',
-	'      await client.close().catch(() => undefined);',
-	'      return;',
-	'    } catch (error) {',
-	'      lastError = error;',
-	'      await client.close().catch(() => undefined);',
-	'      await delay(1500);',
-	'    }',
-	'  }',
-	'  const detail = lastError && (lastError.message || String(lastError)) || "local Mongo did not become ready";',
-	'  throw new Error(`target_local_mongo_unavailable: ${detail}`);',
-	'}',
-		'',
-		'function requireMongo() {',
-		'  const candidates = [',
-		'    path.join(projectRoot, "server", "node_modules", "mongodb"),',
-		'    path.join(projectRoot, "node_modules", "mongodb"),',
-		'    path.join(repoRoot, "node_modules", "mongodb"),',
-		'    "mongodb"',
-		'  ];',
-		'  const errors = [];',
-		'  for (const candidate of candidates) {',
-		'    try { return require(candidate); } catch (error) { errors.push(`${candidate}: ${error.message}`); }',
-		'  }',
-		'  throw new Error(`Unable to require mongodb package. ${errors.join(" | ")}`);',
-		'}',
-		'',
-		'function idValues(docs, keys) {',
-		'  const values = new Set();',
-		'  for (const doc of docs || []) {',
-		'    for (const key of keys) {',
-		'      const value = doc && doc[key];',
-		'      if (typeof value === "string" && value.trim()) values.add(value.trim());',
-		'      if (Array.isArray(value)) value.forEach((entry) => typeof entry === "string" && entry.trim() && values.add(entry.trim()));',
-		'    }',
-		'  }',
-		'  return Array.from(values);',
-		'}',
-		'',
-			'function unique(values) { return Array.from(new Set((values || []).filter(Boolean).map(String))); }',
-			'',
-			'function lowerTrim(value) { return String(value || "").trim().toLowerCase(); }',
-			'',
-			'function escapeRegexText(value) { return String(value || "").replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"); }',
-			'',
-			'function exactTextRegex(value) { return new RegExp(`^${escapeRegexText(value)}$`, "i"); }',
-			'',
-			'function requireOptionalXlsx() {',
-			'  const candidates = [',
-			'    path.join(projectRoot, "server", "node_modules", "xlsx"),',
-			'    path.join(projectRoot, "node_modules", "xlsx"),',
-			'    path.join(repoRoot, "node_modules", "xlsx"),',
-			'    path.join(process.cwd(), "server", "node_modules", "xlsx"),',
-			'    path.join(process.cwd(), "node_modules", "xlsx"),',
-			'    "xlsx"',
-			'  ];',
-			'  for (const candidate of candidates) { try { return require(candidate); } catch (error) {} }',
-			'  return null;',
-			'}',
-			'',
-			'function collectPricingImportWorkbookPaths() {',
-			'  const dirs = [',
-			'    path.join(projectRoot, ".resolveio-context", "attachments"),',
-			'    path.join(repoRoot, ".resolveio-context", "attachments"),',
-			'    path.join(projectRoot, ".resolveio-support-context", "attachments"),',
-			'    path.join(repoRoot, ".resolveio-support-context", "attachments")',
-			'  ];',
-			'  const paths = [];',
-			'  for (const dir of dirs) {',
-			'    try {',
-			'      for (const name of fs.readdirSync(dir)) {',
-			'        if (/\\.xlsx$/i.test(name) && !/^~\\$/.test(name)) paths.push(path.join(dir, name));',
-			'      }',
-			'    } catch (error) {}',
-			'  }',
-			'  return unique(paths);',
-			'}',
-			'',
-			'function normalizeWorkbookCell(value) {',
-			'  if (value == null) return "";',
-			'  if (value instanceof Date) return value.toISOString();',
-			'  return String(value).replace(/\\s+/g, " ").trim();',
-			'}',
-			'',
-			'function extractPricingImportWorkbookHints(summary) {',
-			'  const workbooks = collectPricingImportWorkbookPaths();',
-			'  const xlsx = workbooks.length ? requireOptionalXlsx() : null;',
-			'  const customerNames = new Set();',
-			'  const itemMap = new Map();',
-			'  const workbookSummaries = [];',
-			'  if (!workbooks.length) return { workbooks, workbook_summaries: workbookSummaries, customer_names: [], items: [] };',
-			'  if (!xlsx) {',
-			'    summary.notes.push("Pricing-import workbook seed context skipped because xlsx could not be required in the QA seeder.");',
-			'    return { workbooks, workbook_summaries: workbookSummaries, customer_names: [], items: [] };',
-			'  }',
-			'  for (const workbookPath of workbooks.slice(0, 8)) {',
-			'    try {',
-			'      const workbook = xlsx.readFile(workbookPath, { cellDates: true });',
-			'      const sheetName = workbook.SheetNames.includes("Prices") ? "Prices" : workbook.SheetNames[0];',
-			'      const rows = sheetName ? xlsx.utils.sheet_to_json(workbook.Sheets[sheetName], { defval: "" }) : [];',
-			'      for (const row of rows) {',
-			'        const customer = normalizeWorkbookCell(row.Customer || row.customer || row.CustomerName || row["Customer Name"]);',
-			'        const pricingType = normalizeWorkbookCell(row["Pricing Type"] || row.PricingType || row.Type || row.type);',
-			'        const name = normalizeWorkbookCell(row.Name || row.name || row.Item || row.item || row.Chemical || row.chemical);',
-			'        if (customer) customerNames.add(customer);',
-			'        if (name) itemMap.set(`${lowerTrim(pricingType)}::${lowerTrim(name)}`, { name, type: pricingType });',
-			'      }',
-			'      workbookSummaries.push({ name: path.basename(workbookPath), sheetName, rows: rows.length });',
-			'    } catch (error) {',
-			'      workbookSummaries.push({ name: path.basename(workbookPath), error: error && (error.message || String(error)) || String(error) });',
-			'    }',
-			'  }',
-			'  return { workbooks, workbook_summaries: workbookSummaries, customer_names: Array.from(customerNames).slice(0, 300), items: Array.from(itemMap.values()).slice(0, 700) };',
-			'}',
-			'',
-			'async function copyPricingImportWorkbookContext(sourceDb, targetDb, summary) {',
-			'  if (!shouldSeedPricingImportFixtures()) return [];',
-			'  const hints = extractPricingImportWorkbookHints(summary);',
-			'  summary.selected.pricing_import_workbook_seed = {',
-			'    workbook_names: hints.workbooks.map((entry) => path.basename(entry)),',
-			'    workbook_summaries: hints.workbook_summaries,',
-			'    customer_name_count: hints.customer_names.length,',
-			'    item_name_count: hints.items.length',
-			'  };',
-			'  if (!hints.workbooks.length) {',
-			'    summary.notes.push("Pricing-import seed profile found no attached .xlsx workbooks to derive customer/item fixture context.");',
-			'    return [];',
-			'  }',
-			'  const customerRegexes = hints.customer_names.map(exactTextRegex);',
-			'  const customers = customerRegexes.length ? await copyQuery(sourceDb, targetDb, "customers", { $or: [{ name: { $in: customerRegexes } }, { customer: { $in: customerRegexes } }, { company_name: { $in: customerRegexes } }] }, summary, 300, { name: 1 }) : [];',
-			'  const itemOrs = [];',
-			'  for (const hint of hints.items) {',
-			'    const nameRegex = exactTextRegex(hint.name);',
-			'    const typeRegex = hint.type ? exactTextRegex(hint.type) : null;',
-			'    if (typeRegex) itemOrs.push({ name: nameRegex, type: typeRegex }, { description: nameRegex, type: typeRegex });',
-			'    itemOrs.push({ name: nameRegex }, { description: nameRegex });',
-			'  }',
-			'  const items = itemOrs.length ? await copyQuery(sourceDb, targetDb, "items", { $or: itemOrs }, summary, 900, { name: 1 }) : [];',
-			'  const itemNameRegexes = hints.items.map((hint) => exactTextRegex(hint.name));',
-			'  const chemicals = itemNameRegexes.length ? await copyQuery(sourceDb, targetDb, "chemicals", { $or: [{ name: { $in: itemNameRegexes } }, { description: { $in: itemNameRegexes } }] }, summary, 900, { name: 1 }) : [];',
-			'  const chemicalIds = unique(chemicals.map((doc) => doc._id));',
-			'  const chemicalItems = chemicalIds.length ? await copyQuery(sourceDb, targetDb, "items", { $or: [{ id_chemical: { $in: chemicalIds } }, { _id: { $in: chemicalIds } }] }, summary, 900, { name: 1 }) : [];',
-			'  const copiedItems = [...items, ...chemicalItems];',
-			'  const copiedCustomerNames = new Set(customers.map((doc) => lowerTrim(doc.name || doc.customer || doc.company_name)));',
-			'  const copiedItemNames = new Set(copiedItems.map((doc) => lowerTrim(doc.name || doc.description)));',
-			'  const copiedChemicalNames = new Set(chemicals.map((doc) => lowerTrim(doc.name || doc.description)));',
-			'  const missingCustomers = hints.customer_names.filter((name) => !copiedCustomerNames.has(lowerTrim(name)));',
-			'  const missingItems = hints.items.filter((hint) => !copiedItemNames.has(lowerTrim(hint.name)) && !copiedChemicalNames.has(lowerTrim(hint.name))).map((hint) => hint.type ? `${hint.type}:${hint.name}` : hint.name);',
-			'  const itemIds = unique(copiedItems.map((doc) => doc._id));',
-			'  const customerIds = unique(customers.map((doc) => doc._id));',
-			'  summary.selected.pricing_import_workbook_context = {',
-			'    workbook_names: hints.workbooks.map((entry) => path.basename(entry)),',
-			'    customer_names: hints.customer_names.slice(0, 60),',
-			'    item_names: hints.items.map((hint) => hint.type ? `${hint.type}:${hint.name}` : hint.name).slice(0, 100),',
-			'    customer_ids: customerIds,',
-			'    item_ids: itemIds,',
-			'    chemical_ids: chemicalIds,',
-			'    missing_customer_names: missingCustomers.slice(0, 80),',
-			'    missing_item_names: missingItems.slice(0, 120)',
-			'  };',
-			'  summary.notes.push(`Seeded pricing-import workbook context: ${customers.length}/${hints.customer_names.length} customer name(s), ${copiedItems.length}/${hints.items.length} item name(s), ${chemicals.length} chemical(s) from ${hints.workbooks.length} attached workbook(s).`);',
-			'  if (missingCustomers.length || missingItems.length) summary.notes.push(`Pricing-import workbook context still missing ${missingCustomers.length} customer name(s) and ${missingItems.length} item name(s) from live Mongo.`);',
-			'  return [...customers, ...copiedItems, ...chemicals];',
-			'}',
-			'',
-			'function collectEmailLikeValues(value, out = new Set(), depth = 0) {',
-			'  if (depth > 6 || value == null) return out;',
-			'  if (typeof value === "string") {',
-			'    const matches = value.match(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\\.[A-Z]{2,}/gi) || [];',
-			'    matches.forEach((email) => out.add(String(email || "").trim().toLowerCase()));',
-			'    return out;',
-			'  }',
-			'  if (Array.isArray(value)) { value.forEach((entry) => collectEmailLikeValues(entry, out, depth + 1)); return out; }',
-			'  if (typeof value === "object") { Object.values(value).forEach((entry) => collectEmailLikeValues(entry, out, depth + 1)); }',
-			'  return out;',
-			'}',
-			'',
-			'function readContextJsonFiles() {',
-			'  const files = [',
-			'    path.join(artifactDir, "manual-ticket.metadata.json"),',
-			'    path.join(artifactDir, "email.metadata.json"),',
-			'    path.join(repoRoot, ".resolveio-support-context", "manual-ticket.metadata.json"),',
-			'    path.join(projectRoot, ".resolveio-support-context", "manual-ticket.metadata.json"),',
-			'    path.join(repoRoot, ".resolveio-support-context", "email.metadata.json"),',
-			'    path.join(projectRoot, ".resolveio-support-context", "email.metadata.json"),',
-			'    path.join(repoRoot, ".resolveio-context", "manual-ticket.metadata.json"),',
-			'    path.join(projectRoot, ".resolveio-context", "manual-ticket.metadata.json"),',
-			'    path.join(repoRoot, ".resolveio-context", "email.metadata.json"),',
-			'    path.join(projectRoot, ".resolveio-context", "email.metadata.json")',
-			'  ];',
-			'  return files.map((file) => readJsonIfExists(file)).filter(Boolean);',
-			'}',
-			'',
-			'function extractQaUserHints() {',
-			'  const affected = unique([',
-			'    process.env.RESOLVEIO_QA_AFFECTED_USER_EMAIL,',
-			'    process.env.RESOLVEIO_SUPPORT_QA_AFFECTED_USER_EMAIL,',
-			'    process.env.RESOLVEIO_RUNNER_QA_AFFECTED_USER_EMAIL',
-			'  ].map((value) => String(value || "").trim().toLowerCase()).filter(Boolean));',
-			'  const reporter = unique([',
-			'    process.env.RESOLVEIO_QA_TICKET_REPORTER_EMAIL,',
-			'    process.env.RESOLVEIO_SUPPORT_QA_TICKET_REPORTER_EMAIL,',
-			'    process.env.RESOLVEIO_RUNNER_QA_TICKET_REPORTER_EMAIL',
-			'  ].map((value) => String(value || "").trim().toLowerCase()).filter(Boolean));',
-			'  const explicitQa = unique([',
-			'    process.env.RESOLVEIO_QA_USERNAME,',
-			'    process.env.RESOLVEIO_SUPPORT_QA_USERNAME,',
-			'    process.env.RESOLVEIO_RUNNER_QA_USERNAME',
-			'  ].map((value) => String(value || "").trim().toLowerCase()).filter((value) => value && !/^(admin|dev@resolveio\\.com)$/i.test(value)));',
-			'  const contextEmails = new Set();',
-			'  readContextJsonFiles().forEach((json) => collectEmailLikeValues(json, contextEmails));',
-			'  collectEmailLikeValues(readSeedHintText(), contextEmails);',
-			'  const candidates = unique([...affected, ...reporter, ...explicitQa, ...Array.from(contextEmails)]);',
-			'  return { affected, reporter, explicitQa, candidates: candidates.slice(0, 12) };',
-			'}',
-			'',
-			'function qaUserLookupQuery(candidates) {',
-			'  const ors = [];',
-			'  for (const candidate of candidates || []) {',
-			'    const value = String(candidate || "").trim();',
-			'    if (!value) continue;',
-			'    ors.push({ username: value }, { email: value }, { "emails.address": value });',
-			'  }',
-			'  return ors.length ? { $or: ors } : null;',
-			'}',
-			'',
-			'function normalizeSeededQaUser(doc, password) {',
-			'  const now = new Date();',
-			'  const next = { ...(doc || {}) };',
-			'  const other = next.other && typeof next.other === "object" ? next.other : {};',
-			'  const settings = next.settings && typeof next.settings === "object" ? next.settings : {};',
-			'  next.active = true;',
-			'  next.readonly = false;',
-			'  next.other = { ...other, tour_completed: true, took_tour: true, core_tour_completed: true, welcome_tour_completed: true, top_navigation_tour_completed: true, user_settings_tour_completed: true };',
-			'  next.settings = { ...settings, collapsable_menu: false };',
-			'  next.updatedAt = now;',
-			'  if (password) {',
-			'    const salt = crypto.randomBytes(32).toString("hex");',
-			'    next.salt = salt;',
-			'    next.hash = crypto.pbkdf2Sync(password, salt, 25000, 512, "sha256").toString("hex");',
-			'    if (next.services && typeof next.services === "object" && next.services.password) delete next.services.password;',
-			'    next.attempts = 0;',
-			'  }',
-			'  return next;',
-			'}',
-			'',
-			'async function copyQaIdentityUsers(sourceDb, targetDb, summary) {',
-			'  const hints = extractQaUserHints();',
-			'  summary.selected.qa_user_hints = hints;',
-			'  const query = qaUserLookupQuery(hints.candidates);',
-			'  if (!query) return [];',
-			'  const users = await sourceDb.collection("users").find(query).limit(8).toArray();',
-			'  if (!users.length) {',
-			'    summary.notes.push(`No live user matched QA identity hints: ${hints.candidates.join(", ")}`);',
-			'    return [];',
-			'  }',
-			'  const password = process.env.RESOLVEIO_RUNNER_QA_PASSWORD || process.env.RESOLVEIO_SUPPORT_QA_PASSWORD || "";',
-			'  for (const user of users) {',
-			'    const normalized = normalizeSeededQaUser(user, password);',
-			'    await targetDb.collection("users").replaceOne({ _id: normalized._id }, normalized, { upsert: true });',
-			'  }',
-			'  summary.collections.users = (summary.collections.users || 0) + users.length;',
-			'  const preferred = users.find((user) => hints.affected.includes(String(user.email || user.username || "").toLowerCase()))',
-			'    || users.find((user) => hints.reporter.includes(String(user.email || user.username || "").toLowerCase()))',
-			'    || users[0];',
-			'  summary.selected.qa_user_context = {',
-			'    preferred_username: String(preferred && (preferred.email || preferred.username) || "").trim(),',
-			'    preferred_email: String(preferred && preferred.email || "").trim(),',
-			'    preferred_user_id: String(preferred && preferred._id || "").trim(),',
-			'    affected_user_email: hints.affected[0] || "",',
-			'    reporter_email: hints.reporter[0] || "",',
-			'    copied_user_ids: users.map((user) => String(user && user._id || "")).filter(Boolean),',
-			'    reason: hints.affected.length ? "affected_user" : (hints.reporter.length ? "ticket_reporter" : "context_email")',
-			'  };',
-			'  summary.notes.push(`Seeded ${users.length} live QA identity user(s); preferred browser QA user is ${summary.selected.qa_user_context.preferred_username || summary.selected.qa_user_context.preferred_user_id}.`);',
-			'  return users;',
-			'}',
-			'',
-			'function readSeedHintText() {',
-		'  const chunks = [',
-		'    process.env.RESOLVEIO_SUPPORT_QA_ROW_FILTER || "",',
-		'    process.env.RESOLVEIO_SUPPORT_QA_CURRENT_ROW_WORKFLOW || "",',
-		'    process.env.RESOLVEIO_SUPPORT_QA_CURRENT_ROW_ASSERTION || "",',
-		'    process.env.RESOLVEIO_RUNNER_QA_ROW_FILTER || "",',
-		'    process.env.RESOLVEIO_RUNNER_QA_CURRENT_ROW_WORKFLOW || "",',
-		'    process.env.RESOLVEIO_RUNNER_QA_CURRENT_ROW_ASSERTION || "",',
-		'    process.env.RESOLVEIO_QA_SEED_HINTS || "",',
-		'    process.env.RESOLVEIO_SUPPORT_QA_SEED_HINTS || "",',
-		'    process.env.RESOLVEIO_RUNNER_QA_SEED_HINTS || ""',
-		'  ];',
-		'  const candidates = [',
-		'    path.join(artifactDir, "qa-coverage-matrix.json"),',
-		'    path.join(artifactDir, "qa-row-lock.json"),',
-		'    path.join(repoRoot, ".resolveio-support-context", "manual-ticket.request.txt"),',
-		'    path.join(projectRoot, ".resolveio-support-context", "manual-ticket.request.txt"),',
-		'    path.join(repoRoot, ".resolveio-context", "manual-ticket.request.txt"),',
-		'    path.join(projectRoot, ".resolveio-context", "manual-ticket.request.txt")',
-		'  ];',
-		'  for (const candidate of candidates) {',
-		'    try {',
-		'      const raw = fs.readFileSync(candidate, "utf8");',
-		'      chunks.push(raw);',
-		'      if (/qa-coverage-matrix\\.json$/.test(candidate)) {',
-		'        const matrix = JSON.parse(raw);',
-		'        const rows = Array.isArray(matrix && matrix.rows) ? matrix.rows : [];',
-		'        for (const row of rows) chunks.push([row.workflow, row.route, row.assertion, row.required_proof, row.data_id, row.data_name, row.blocker, row.evidence, row.caption].filter(Boolean).join("\\n"));',
-		'      }',
-		'      if (/qa-row-lock\\.json$/.test(candidate)) {',
-		'        const lock = JSON.parse(raw);',
-		'        chunks.push([lock.workflow, lock.route, lock.assertion, lock.required_proof, lock.rowFilter, lock.blocker].filter(Boolean).join("\\n"));',
-		'      }',
-		'    } catch (error) {}',
-		'  }',
-		'  return chunks.filter(Boolean).join("\\n");',
-		'}',
-		'',
-		'function isUsefulSeedIdentifier(value) {',
-		'  const cleaned = String(value || "").trim().replace(/^[#:\\-]+|[.,;:)\\]]+$/g, "");',
-		'  if (!cleaned) return false;',
-		'  if (/^00?4\\d{3}$/.test(cleaned)) return false;',
-		'  if (/^(screen|tab|are|which|and|render|context|workflow|build|snapshot|state|charge|plan|data|document|delivery|deliveries)$/i.test(cleaned)) return false;',
-		'  return /\\d/.test(cleaned) || /^[A-Z][A-Z0-9._-]{3,}$/.test(cleaned);',
-		'}',
-		'',
-	'function extractBolIdentifiers() {',
-		'  const text = readSeedHintText();',
-		'  const identifiers = new Set();',
-		'  const explicit = /\\bBOL\\s*(?:#|no\\.?|number|num)?\\s*[:#-]?\\s*([A-Z0-9][A-Z0-9._-]{2,})\\b/gi;',
-		'  let match;',
-		'  while ((match = explicit.exec(text)) !== null) {',
-		'    const value = String(match[1] || "").trim();',
-		'    if (isUsefulSeedIdentifier(value)) identifiers.add(value);',
-		'  }',
-	'  return Array.from(identifiers).slice(0, 8);',
-	'}',
-	'',
-		'function shouldAutoDiscoverTruckTreatingBolContext() {',
-		'  const text = readSeedHintText();',
-		'  return /\\b(bol|bill\\s+of\\s+lading|truck\\s*treat(?:ing)?|truck-treating|deliver(?:y|ed|ies)?\\s+BOL)\\b/i.test(text);',
-		'}',
-		'',
-		'function shouldAutoDiscoverAssetContext() {',
-		'  const text = readSeedHintText();',
-		'  return /\\b(asset|assets|unit|units|equipment|current\\s+location|location\\s+name|location\\s+names|default\\s+yard|yard)\\b/i.test(text);',
-		'}',
-		'',
-		'function shouldAutoDiscoverProductionInterchangeablesContext() {',
-		'  const text = readSeedHintText();',
-		'  return /\\b(interchangeable|interchangeables|mass\\s+update|update\\s+interchangeables|from\\s+chemical|to\\s+chemical|treatment\\s+plan|treatment\\s+plans|production\\s+location)\\b/i.test(text);',
-		'}',
-		'',
-		'function extractAssetIdentifiers() {',
-		'  const text = readSeedHintText();',
-		'  const identifiers = new Set();',
-		'  const explicit = /\\b(?:asset|unit|equipment)\\s*(?:#|no\\.?|number|num)?\\s*[:#-]?\\s*([A-Z0-9][A-Z0-9._-]{1,})\\b/gi;',
-		'  let match;',
-		'  while ((match = explicit.exec(text)) !== null) {',
-		'    const value = String(match[1] || "").trim();',
-		'    if (isUsefulSeedIdentifier(value)) identifiers.add(value);',
-		'  }',
-		'  const typedUnit = /\\b(?:truck|trailer|unit|asset)\\s+([A-Z0-9][A-Z0-9._-]{1,})\\b/gi;',
-		'  while ((match = typedUnit.exec(text)) !== null) {',
-		'    const value = String(match[1] || "").trim();',
-		'    if (isUsefulSeedIdentifier(value)) identifiers.add(value);',
-		'  }',
-		'  if (shouldAutoDiscoverAssetContext()) extractSeedIdentifiers().forEach((value) => identifiers.add(value));',
-		'  return Array.from(identifiers).slice(0, 20);',
-		'}',
-		'',
-		'function extractRouteNameHints() {',
-		'  const text = readSeedHintText();',
-		'  const routes = new Set();',
-		'  const routePattern = /\\b(?:on|for)\\s+(?:the\\s+)?([A-Za-z0-9][A-Za-z0-9 &._/-]{1,48}?)\\s+route\\b/gi;',
-		'  let match;',
-		'  while ((match = routePattern.exec(text)) !== null) {',
-		'    const routeName = String(match[1] || "").trim().replace(/^(?:the|a|an)\\s+/i, "").replace(/\\s+/g, " ");',
-		'    if (routeName && !/^(?:this|that|selected)$/i.test(routeName)) routes.add(routeName);',
-		'  }',
-		'  return Array.from(routes).slice(0, 8);',
-		'}',
-		'',
-	'function extractSeedIdentifiers() {',
-		'  const text = readSeedHintText();',
-		'  const identifiers = new Set();',
-		'  const explicit = /\\b(?:invoice|inv|bol|order|pso|ticket|wo|work\\s*order|delivery|treatment)\\s*(?:#|no\\.?|number|num)?\\s*[:#-]?\\s*([A-Z0-9][A-Z0-9._-]{2,})\\b/gi;',
-		'  let match;',
-		'  while ((match = explicit.exec(text)) !== null) identifiers.add(match[1]);',
-		'  const typedUnit = /\\b(?:truck|trailer|asset|unit)\\s+([A-Z0-9][A-Z0-9._-]{1,})\\b/gi;',
-		'  while ((match = typedUnit.exec(text)) !== null) identifiers.add(match[1]);',
-		'  const numeric = /\\b\\d{3,}\\b/g;',
-		'  while ((match = numeric.exec(text)) !== null) identifiers.add(match[0]);',
-		'  return Array.from(identifiers)',
-		'    .map((value) => String(value || "").trim())',
-		'    .filter((value) => isUsefulSeedIdentifier(value))',
-		'    .slice(0, 20);',
-		'}',
-		'',
-		'function desiredSeedProfile() {',
-		'  if (shouldSeedPricingImportFixtures()) return "pricing_import";',
-		'  if (shouldSeedBillingDashboardFixtures()) return "billing_inventory";',
-		'  return "live_context";',
-		'}',
-		'',
-		'function shouldSeedBillingDashboardFixtures() {',
-		'  const force = process.env.RESOLVEIO_QA_FORCE_BILLING_FIXTURES || process.env.RESOLVEIO_SUPPORT_QA_FORCE_BILLING_FIXTURES || process.env.RESOLVEIO_RUNNER_QA_FORCE_BILLING_FIXTURES || "";',
-		'  if (/^(true|1|yes|on)$/i.test(force)) return true;',
-		'  if (shouldSeedPricingImportFixtures()) return false;',
-		'  const explicit = process.env.RESOLVEIO_QA_INCLUDE_BILLING_FIXTURES || process.env.RESOLVEIO_SUPPORT_QA_INCLUDE_BILLING_FIXTURES || process.env.RESOLVEIO_RUNNER_QA_INCLUDE_BILLING_FIXTURES || "";',
-		'  if (/^(true|1|yes|on)$/i.test(explicit)) return true;',
-		'  if (/^(false|0|no|off)$/i.test(explicit)) return false;',
-		'  const text = readSeedHintText();',
-		'  return /\\b(invoice|invoicing|billing|billable|tax|taxes|surcharge|inventory|checkout|check\\s*out|pick\\s*ticket)\\b/i.test(text);',
-		'}',
-		'',
-		'function shouldSeedPricingImportFixtures() {',
-		'  const explicit = process.env.RESOLVEIO_QA_INCLUDE_PRICING_IMPORT_FIXTURES || process.env.RESOLVEIO_SUPPORT_QA_INCLUDE_PRICING_IMPORT_FIXTURES || process.env.RESOLVEIO_RUNNER_QA_INCLUDE_PRICING_IMPORT_FIXTURES || "";',
-		'  if (/^(true|1|yes|on)$/i.test(explicit)) return true;',
-		'  if (/^(false|0|no|off)$/i.test(explicit)) return false;',
-		'  const text = readSeedHintText();',
-		'  const pricingSurface = /\\b(pricing|price|gross\\s+price|production\\s+price|manage\\s+pricing)\\b/i.test(text);',
-		'  const importSurface = /\\b(import|upload|template|spreadsheet|xlsx|excel|attached\\s+template)\\b/i.test(text);',
-		'  return pricingSurface && importSurface;',
-		'}',
-		'',
-		'function identifierQuery(identifiers) {',
-		'  const ors = [];',
-		'  const fields = ["_id", "invoice_number", "invoice_number_string", "order_number", "order_number_string", "activity_number", "bol_number", "bol_string", "ticket_number", "ticket", "wo_number", "work_order_number", "delivery_number", "treatment_number"];',
-		'  for (const identifier of identifiers || []) {',
-		'    const escaped = String(identifier).replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&");',
-		'    const regex = new RegExp(escaped, "i");',
-		'    for (const field of fields) ors.push({ [field]: regex });',
-		'    ors.push({ "bol.bol_string": regex });',
-		'    ors.push({ "bol.bol_number": regex });',
-		'  }',
-		'  return ors.length ? { $or: ors } : null;',
-		'}',
-		'',
-		'function assetLookupQuery(identifiers) {',
-		'  const ors = [];',
-		'  const fields = ["_id", "asset_number", "asset_number_string", "asset_unit_number", "unit_number", "number", "serial_number", "name"];',
-		'  for (const identifier of identifiers || []) {',
-		'    const value = String(identifier || "").trim();',
-		'    if (!value) continue;',
-		'    const escaped = value.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&");',
-		'    const exactText = new RegExp(`^${escaped}$`, "i");',
-		'    const containsText = new RegExp(escaped, "i");',
-		'    for (const field of fields) ors.push({ [field]: exactText });',
-		'    for (const field of ["asset_number_string", "asset_unit_number", "unit_number", "number", "serial_number", "name"]) ors.push({ [field]: containsText });',
-		'    if (/^\\d+$/.test(value)) {',
-		'      const numericValue = Number(value);',
-		'      for (const field of ["asset_number", "unit_number", "number"]) ors.push({ [field]: numericValue });',
-		'    }',
-		'  }',
-		'  return ors.length ? { $or: ors } : null;',
-		'}',
-		'',
-		'async function copyByIds(sourceDb, targetDb, collectionName, ids, summary, limit = 100) {',
-		'  const cleanIds = unique(ids).slice(0, limit);',
-		'  if (!cleanIds.length) return [];',
-		'  const docs = await sourceDb.collection(collectionName).find({ _id: { $in: cleanIds } }).limit(limit).toArray();',
-		'  for (const doc of docs) await targetDb.collection(collectionName).replaceOne({ _id: doc._id }, doc, { upsert: true });',
-		'  summary.collections[collectionName] = (summary.collections[collectionName] || 0) + docs.length;',
-		'  return docs;',
-		'}',
-		'',
-		'async function copyQuery(sourceDb, targetDb, collectionName, query, summary, limit = 50, sort = null) {',
-		'  let cursor = sourceDb.collection(collectionName).find(query || {});',
-		'  if (sort) cursor = cursor.sort(sort);',
-		'  const docs = await cursor.limit(limit).toArray();',
-		'  for (const doc of docs) await targetDb.collection(collectionName).replaceOne({ _id: doc._id }, doc, { upsert: true });',
-		'  summary.collections[collectionName] = (summary.collections[collectionName] || 0) + docs.length;',
-		'  return docs;',
-		'}',
-		'',
-	'function bolLookupQuery(identifiers) {',
-		'  const ors = [];',
-		'  for (const identifier of identifiers || []) {',
-		'    const value = String(identifier || "").trim();',
-		'    if (!value) continue;',
-		'    const escaped = value.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&");',
-		'    const contains = new RegExp(`(^|[^0-9A-Za-z])${escaped}([^0-9A-Za-z]|$)`, "i");',
-		'    ors.push({ _id: value }, { bol_number: value }, { bol_string: value }, { bol_number: contains }, { bol_string: contains });',
-		'    if (/^\\d+$/.test(value)) ors.push({ bol_number: Number(value) });',
-		'  }',
-	'  return ors.length ? { $or: ors } : null;',
-	'}',
-	'',
-	'async function discoverTruckTreatingBolIds(sourceDb, routeHints, limit = 5) {',
-	'  const routeRegexes = (routeHints || []).map((hint) => new RegExp(String(hint).replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i"));',
-	'  const routeHintMatch = routeRegexes.length ? { $or: [',
-	'    { location: { $in: routeRegexes } },',
-	'    { well_group: { $in: routeRegexes } },',
-	'    { route: { $in: routeRegexes } },',
-	'    { route_name: { $in: routeRegexes } }',
-	'  ] } : null;',
-	'  const baseMatch = {',
-	'    id_bol: { $type: "string", $ne: "" },',
-	'    items: { $elemMatch: { item_type: { $in: ["Service", "Flush"] } } }',
-	'  };',
-	'  const pipeline = [',
-	'    { $match: routeHintMatch ? { $and: [baseMatch, routeHintMatch] } : baseMatch },',
-	'    { $sort: { date: -1, date_ship: -1, updatedAt: -1 } },',
-	'    { $group: { _id: "$id_bol", route_count: { $sum: 1 }, latest: { $max: "$updatedAt" } } },',
-	'    { $sort: { latest: -1, route_count: -1 } },',
-	'    { $limit: limit },',
-	'    { $project: { _id: 1 } }',
-	'  ];',
-	'  const rows = await sourceDb.collection("production-routes").aggregate(pipeline).toArray();',
-	'  return rows.map((row) => row && row._id).filter(Boolean);',
-	'}',
-	'',
-		'function collectNestedStringValues(docs, keys) {',
-		'  const values = new Set();',
-		'  const visit = (value) => {',
-		'    if (!value) return;',
-		'    if (Array.isArray(value)) { value.forEach(visit); return; }',
-		'    if (typeof value === "object") {',
-		'      for (const key of keys) {',
-		'        const entry = value[key];',
-		'        if (typeof entry === "string" && entry.trim()) values.add(entry.trim());',
-		'        else if (Array.isArray(entry) || (entry && typeof entry === "object")) visit(entry);',
-		'      }',
-		'      for (const nested of Object.values(value)) if (Array.isArray(nested)) visit(nested);',
-		'    }',
-		'  };',
-		'  visit(docs || []);',
-		'  return Array.from(values);',
-		'}',
-		'',
-	'async function copyTruckTreatingBolContext(sourceDb, targetDb, summary) {',
-	'  const bolIdentifiers = extractBolIdentifiers();',
-	'  const routeHints = extractRouteNameHints();',
-	'  summary.selected.bol_identifiers = bolIdentifiers;',
-	'  if (routeHints.length) summary.selected.route_name_hints = routeHints;',
-	'  let query = bolLookupQuery(bolIdentifiers);',
-	'  let discoveryMode = "";',
-	'  if (!query && shouldAutoDiscoverTruckTreatingBolContext()) {',
-	'    const discoveredBolIds = await discoverTruckTreatingBolIds(sourceDb, routeHints, 8);',
-	'    if (discoveredBolIds.length) {',
-	'      summary.selected.discovered_truck_treating_bol_ids = discoveredBolIds;',
-	'      query = { _id: { $in: discoveredBolIds } };',
-	'      discoveryMode = "auto_discovered_from_live_production_routes";',
-	'    }',
-	'  }',
-	'  if (!query) return [];',
-	'  let bols = await copyQuery(sourceDb, targetDb, "bols", query, summary, 8, { date_shipped: -1, date: -1, updatedAt: -1 });',
-	'  if (!bols.length) {',
-	'    summary.notes.push(`No live BOL matched ticket BOL identifiers: ${bolIdentifiers.join(", ")}`);',
-	'    if (shouldAutoDiscoverTruckTreatingBolContext()) {',
-	'      const discoveredBolIds = await discoverTruckTreatingBolIds(sourceDb, routeHints, 8);',
-	'      if (discoveredBolIds.length) {',
-	'        summary.selected.discovered_truck_treating_bol_ids = discoveredBolIds;',
-	'        discoveryMode = "auto_discovered_after_identifier_miss";',
-	'        bols = await copyQuery(sourceDb, targetDb, "bols", { _id: { $in: discoveredBolIds } }, summary, 8, { date_shipped: -1, date: -1, updatedAt: -1 });',
-	'      }',
-	'    }',
-	'    if (!bols.length) return [];',
-	'  }',
-		'  const bolIds = bols.map((doc) => doc._id).filter(Boolean);',
-		'  const productionRoutes = await copyQuery(sourceDb, targetDb, "production-routes", { id_bol: { $in: bolIds } }, summary, 600, { route_order: 1, route_number: 1 });',
-		'  const routeIds = productionRoutes.map((doc) => doc._id).filter(Boolean);',
-		'  const truckTreatingRouteIds = idValues(productionRoutes, ["id_truck_treating_route"]);',
-		'  const productionSalesOrderIds = idValues(productionRoutes, ["id_pso", "id_activity", "id_production_sales_order", "id_sales_order"]);',
-		'  const productionDeliveries = await copyQuery(sourceDb, targetDb, "production-deliveries", { $or: [{ id_bol: { $in: bolIds } }, { id_activity: { $in: productionSalesOrderIds } }] }, summary, 600, { route_order: 1, updatedAt: -1 });',
-		'  const routeTruckTreatDeliveryIds = collectNestedStringValues(productionRoutes, ["id_truck_treat_delivery", "id_truck_treating_delivery"]);',
-		'  const truckTreatingDeliveries = await copyQuery(sourceDb, targetDb, "truck-treating-deliveries", { $or: [{ id_bol: { $in: bolIds } }, { _id: { $in: routeTruckTreatDeliveryIds } }] }, summary, 600, { route_order: 1, updatedAt: -1 });',
-		'  const copiedTruckTreatingRoutes = await copyByIds(sourceDb, targetDb, "truck-treating-routes", truckTreatingRouteIds, summary, 200);',
-		'  await copyByIds(sourceDb, targetDb, "production-sales-orders", productionSalesOrderIds, summary, 200);',
-		'  const locationIds = unique([...idValues(productionRoutes, ["id_location"]), ...idValues(productionDeliveries, ["id_location"]), ...idValues(truckTreatingDeliveries, ["id_location"])]);',
-		'  const wellGroupIds = unique([...idValues(productionRoutes, ["id_well_group"]), ...idValues(productionDeliveries, ["id_well_group"]), ...idValues(truckTreatingDeliveries, ["id_well_group"])]);',
-		'  const copiedLocations = await copyByIds(sourceDb, targetDb, "production-locations", locationIds, summary, 300);',
-		'  const copiedWellGroups = await copyByIds(sourceDb, targetDb, "well-groups", wellGroupIds, summary, 300);',
-		'  const copiedTreatmentPlans = await copyQuery(sourceDb, targetDb, "treatment-plans", { $or: [',
-		'    { "truck_treating.id_truck_treating_route": { $in: truckTreatingRouteIds } },',
-		'    { id_location: { $in: locationIds } },',
-		'    { id_well_group: { $in: wellGroupIds } }',
-		'  ] }, summary, 800, { route_order: 1, updatedAt: -1 });',
-		'  const itemIds = unique([',
-		'    ...collectNestedStringValues(productionRoutes, ["id_item", "id_chemical"]),',
-		'    ...idValues(productionDeliveries, ["id_item", "id_chemical"]),',
-		'    ...idValues(truckTreatingDeliveries, ["id_item", "id_chemical"]),',
-		'    ...idValues(copiedTreatmentPlans, ["id_item", "id_chemical"])',
-		'  ]);',
-		'  await copyByIds(sourceDb, targetDb, "items", itemIds, summary, 300);',
-		'  await copyByIds(sourceDb, targetDb, "chemicals", itemIds, summary, 300);',
-		'  await copyByIds(sourceDb, targetDb, "customers", unique([...idValues(copiedLocations, ["id_customer"]), ...idValues(copiedWellGroups, ["id_customer"]), ...idValues(productionDeliveries, ["id_customer"]), ...idValues(truckTreatingDeliveries, ["id_customer"])]), summary, 100);',
-		'  await copyByIds(sourceDb, targetDb, "users", unique([...idValues(bols, ["id_user", "id_driver"]), ...idValues(productionDeliveries, ["id_user_approved", "id_driver", "id_driver_scheduled", "id_account_manager", "id_foreman"])]), summary, 100);',
-		'  await copyQuery(sourceDb, targetDb, "chemical-field-transfers", { id_bol: { $in: bolIds } }, summary, 200, { updatedAt: -1 });',
-		'  await copyQuery(sourceDb, targetDb, "generic-samples", { id_bol: { $in: bolIds } }, summary, 200, { updatedAt: -1 });',
-		'  const linkedRouteNames = copiedTruckTreatingRoutes.map((doc) => String(doc.name || doc.route || doc.truck_treating_route || doc._id || "")).filter(Boolean);',
-		'  const routeHintMatched = routeHints.length ? routeHints.some((hint) => linkedRouteNames.some((name) => name.toLowerCase().includes(hint.toLowerCase()))) : null;',
-		'  const driverIds = unique([...idValues(bols, ["id_driver", "id_user"]), ...idValues(productionDeliveries, ["id_driver", "id_driver_scheduled", "id_user_approved"]), ...idValues(truckTreatingDeliveries, ["id_driver", "id_driver_scheduled", "id_user_approved"])]);',
-		'  const bolStatuses = bols.map((doc) => ({',
-		'    id: String(doc && doc._id || ""),',
-		'    bol_number: String(doc && (doc.bol_string || doc.bol_number || "") || ""),',
-		'    status: String(doc && doc.status || ""),',
-		'    delivered: /delivered/i.test(String(doc && doc.status || ""))',
-		'  })).filter((entry) => entry.id);',
-		'  const primaryDriverId = driverIds[0] || "";',
-		'  const primaryBolId = bolIds[0] || "";',
-		'  const primaryBolStatus = String((bolStatuses.find((entry) => entry.id === primaryBolId) || bolStatuses[0] || {}).status || "");',
-		'  const primaryBolDelivered = /delivered/i.test(primaryBolStatus);',
-		'  const browserRoutes = primaryDriverId && primaryBolId ? {',
-		'    delivery: `/dashboard/driver/truck-treating/bol-delivery/${primaryDriverId}/${primaryBolId}`,',
-		'    detail: `/dashboard/driver/truck-treating/bol-detail/${primaryDriverId}/${primaryBolId}`,',
-		'    list: `/dashboard/driver/truck-treating/bol-list/${primaryDriverId}`',
-		'  } : {};',
-		'  summary.selected.truck_treating_bol_context = {',
-		'    bol_ids: bolIds,',
-		'    driver_ids: driverIds,',
-		'    route_ids: routeIds.slice(0, 100),',
-		'    route_count: productionRoutes.length,',
-		'    truck_treating_route_ids: truckTreatingRouteIds,',
-		'    linked_truck_treating_routes: linkedRouteNames,',
-		'    browser_routes: browserRoutes,',
-		'    bol_statuses: bolStatuses,',
-		'    primary_bol_status: primaryBolStatus,',
-		'    primary_bol_delivered: primaryBolDelivered,',
-		'    delivery_route_is_action_route: true,',
-		'    delivery_route_requires_not_delivered_bol: true,',
-		'    route_name_hints: routeHints,',
-	'    route_hint_matched: routeHintMatched',
-	'  };',
-	'  if (discoveryMode) summary.selected.truck_treating_bol_context.discovery_mode = discoveryMode;',
-		'  if (browserRoutes.delivery) summary.notes.push(`Derived truck-treating BOL browser target from live Mongo: ${browserRoutes.delivery}`);',
-		'  else summary.notes.push("Could not derive truck-treating BOL browser route because live BOL context did not include both id_driver and id_bol.");',
-		'  if (primaryBolDelivered) summary.notes.push(`Live BOL ${primaryBolId} is already Delivered; direct bol-delivery route is an action route and may correctly redirect. QA should use delivered Open File/detail proof or create a localhost-only deliverable fixture from the fetched live context before testing Treat/Deliver actions.`);',
-		'  if (routeHints.length && routeHintMatched === false) summary.notes.push(`Ticket route hint(s) ${routeHints.join(", ")} did not match linked live BOL route(s): ${linkedRouteNames.join(", ") || "none"}. QA should use linked live BOL routes and report the mismatch as data evidence, not synthesize a route.`);',
-		'  summary.notes.push(`Seeded live truck-treating BOL context for ${bolIdentifiers.join(", ")}: ${bols.length} BOL(s), ${productionRoutes.length} production route(s), ${copiedTreatmentPlans.length} treatment plan(s).`);',
-	'  return [...bols, ...productionRoutes, ...productionDeliveries, ...truckTreatingDeliveries, ...copiedTreatmentPlans];',
-	'}',
-	'',
-	'async function copyProductionInterchangeablesContext(sourceDb, targetDb, summary) {',
-	'  if (!shouldAutoDiscoverProductionInterchangeablesContext()) return [];',
-	'  const interchangeables = await copyQuery(sourceDb, targetDb, "chemical-interchangeables", { "id_chemicals.1": { $exists: true } }, summary, 12, { updatedAt: -1 });',
-	'  if (!interchangeables.length) {',
-	'    summary.notes.push("No live chemical-interchangeables records with multiple chemicals were available for Update Interchangeables QA.");',
-	'    return [];',
-	'  }',
-	'  const chemicalIds = unique(idValues(interchangeables, ["id_chemicals"]));',
-	'  const chemicals = await copyQuery(sourceDb, targetDb, "chemicals", { _id: { $in: chemicalIds }, types: "Finished Good" }, summary, 80, { name: 1 });',
-	'  const usableChemicalIds = unique(chemicals.map((doc) => doc._id));',
-	'  const items = await copyQuery(sourceDb, targetDb, "items", { $or: [{ id_chemical: { $in: usableChemicalIds } }, { _id: { $in: usableChemicalIds } }] }, summary, 120, { name: 1 });',
-	'  const itemIds = unique(items.map((doc) => doc._id));',
-	'  let treatmentPlans = await copyQuery(sourceDb, targetDb, "treatment-plans", { date_end: null, $or: [{ id_chemical: { $in: usableChemicalIds } }, { id_item: { $in: itemIds } }] }, summary, 120, { updatedAt: -1 });',
-	'  if (!treatmentPlans.length && usableChemicalIds.length) {',
-	'    treatmentPlans = await copyQuery(sourceDb, targetDb, "treatment-plans", { date_end: null, id_chemical: usableChemicalIds[0] }, summary, 40, { updatedAt: -1 });',
-	'  }',
-	'  const customerIds = unique(idValues(treatmentPlans, ["id_customer"]));',
-	'  const yardIds = unique(idValues(treatmentPlans, ["id_yard"]));',
-	'  const locationIds = unique(idValues(treatmentPlans, ["id_location"]));',
-	'  const wellGroupIds = unique(idValues(treatmentPlans, ["id_well_group"]));',
-	'  const tankIds = unique(collectNestedStringValues(treatmentPlans, ["id_tank"]));',
-	'  await copyByIds(sourceDb, targetDb, "customers", customerIds, summary, 80);',
-	'  await copyByIds(sourceDb, targetDb, "yards", yardIds, summary, 80);',
-	'  await copyByIds(sourceDb, targetDb, "production-locations", locationIds, summary, 120);',
-	'  await copyByIds(sourceDb, targetDb, "well-groups", wellGroupIds, summary, 120);',
-	'  await copyByIds(sourceDb, targetDb, "production-location-tanks", tankIds, summary, 120);',
-	'  if (yardIds.length) {',
-	'    const users = await targetDb.collection("users").find({}).project({ _id: 1, other: 1 }).limit(50).toArray().catch(() => []);',
-	'    for (const user of users) {',
-	'      const other = user && typeof user.other === "object" && user.other ? user.other : {};',
-	'      const nextYards = unique([...(Array.isArray(other.yards) ? other.yards : []), ...yardIds]);',
-	'      await targetDb.collection("users").updateOne({ _id: user._id }, { $set: { "other.yards": nextYards } });',
-	'    }',
-	'    if (users.length) summary.notes.push(`Added seeded Update Interchangeables yard ids to ${users.length} local QA user(s) so treatment-plan filters can return data.`);',
-	'  }',
-	'  summary.selected.qa_production_interchangeables_context = {',
-	'    interchangeable_ids: interchangeables.map((doc) => doc._id).filter(Boolean),',
-	'    chemical_ids: usableChemicalIds,',
-	'    item_ids: itemIds,',
-	'    treatment_plan_ids: treatmentPlans.map((doc) => doc._id).filter(Boolean),',
-	'    customer_ids: customerIds,',
-	'    yard_ids: yardIds,',
-	'    tank_ids: tankIds,',
-	'    browser_routes: { update_interchangeables: "/production-location/update-interchangeables" }',
-	'  };',
-	'  summary.notes.push(`Seeded Update Interchangeables context: ${interchangeables.length} interchangeable group(s), ${chemicals.length} chemical(s), ${items.length} active item(s), ${treatmentPlans.length} treatment plan(s).`);',
-	'  return [...interchangeables, ...chemicals, ...items, ...treatmentPlans];',
-	'}',
-	'',
-		'async function copyTicketAssetContext(sourceDb, targetDb, summary) {',
-		'  if (!shouldAutoDiscoverAssetContext()) return [];',
-		'  const assetIdentifiers = extractAssetIdentifiers();',
-		'  summary.selected.asset_identifiers = assetIdentifiers;',
-		'  const query = assetLookupQuery(assetIdentifiers);',
-		'  if (!query) return [];',
-		'  const assets = await copyQuery(sourceDb, targetDb, "assets", query, summary, 20, { updatedAt: -1, asset_number: 1 });',
-		'  if (!assets.length) {',
-		'    summary.notes.push(`No live assets matched ticket identifiers: ${assetIdentifiers.join(", ")}`);',
-		'    return [];',
-		'  }',
-		'  const yardIds = unique([',
-		'    ...idValues(assets, ["id_yard", "id_default_yard"]),',
-		'    ...collectNestedStringValues(assets, ["id", "id_yard"])',
-		'  ]);',
-		'  const locationIds = unique([',
-		'    ...idValues(assets, ["id_location", "id_current_location", "id_default_location"]),',
-		'    ...collectNestedStringValues(assets, ["id_location"])',
-		'  ]);',
-		'  const userIds = unique([',
-		'    ...idValues(assets, ["id_user", "id_driver", "id_created_by", "id_updated_by"]),',
-		'    ...collectNestedStringValues(assets, ["id_user", "id_driver", "id_created_by", "id_updated_by"])',
-		'  ]);',
-		'  await copyByIds(sourceDb, targetDb, "yards", yardIds, summary, 100);',
-		'  await copyByIds(sourceDb, targetDb, "production-locations", locationIds, summary, 100);',
-		'  await copyByIds(sourceDb, targetDb, "users", userIds, summary, 100);',
-		'  const assetIds = assets.map((doc) => doc._id).filter(Boolean);',
-		'  const assetNumbers = assets.map((doc) => String(doc.asset_number || doc.asset_number_string || doc.asset_unit_number || doc.unit_number || "")).filter(Boolean);',
-		'  summary.selected.qa_asset_context = {',
-		'    asset_ids: assetIds,',
-		'    asset_numbers: assetNumbers,',
-		'    yard_ids: yardIds,',
-		'    production_location_ids: locationIds,',
-		'    browser_routes: assetIds[0] ? { list: "/asset/list", detail: `/asset/detail/${assetIds[0]}`, edit: `/asset/edit/${assetIds[0]}` } : { list: "/asset/list" }',
-		'  };',
-		'  summary.notes.push(`Seeded live asset context for ${assetIdentifiers.join(", ")}: ${assets.length} asset(s), ${yardIds.length} yard id(s), ${locationIds.length} production location id(s).`);',
-		'  return assets;',
-		'}',
-		'',
-		'async function ensureBillingSurchargePricingFixtures(targetDb, summary, serviceItems, customerIds) {',
-		'  const now = new Date();',
-		'  const activeServiceItems = (serviceItems || []).filter((doc) => {',
-		'    const typeText = String(doc && (doc.type || doc.category || doc.name || "") || "");',
-		'    return doc && doc._id && doc.active !== false && /misc|service|surcharge|fuel|delivery/i.test(typeText);',
-		'  });',
-		'  const fixtureItems = [];',
-		'  if (!activeServiceItems.length) {',
-		'    fixtureItems.push(',
-		'      { _id: "qa-misc-surcharge-item", name: "QA Misc Surcharge", description: "QA Misc Surcharge", type: "Misc", unit: "Each", active: true, createdAt: now, updatedAt: now },',
-		'      { _id: "qa-service-surcharge-item", name: "QA Service Surcharge", description: "QA Service Surcharge", type: "Service", unit: "Each", active: true, createdAt: now, updatedAt: now }',
-		'    );',
-		'    for (const item of fixtureItems) await targetDb.collection("items").replaceOne({ _id: item._id }, item, { upsert: true });',
-		'    summary.collections.items = (summary.collections.items || 0) + fixtureItems.length;',
-		'    summary.notes.push("Created localhost-only active service/misc surcharge item fixtures because the bounded live slice did not include one.");',
-		'  }',
-		'  const usableItems = activeServiceItems.length ? activeServiceItems : fixtureItems;',
-		'  const pricingDocs = [];',
-		'  for (const item of usableItems.slice(0, 4)) {',
-		'    const label = String(item.name || item.description || item._id || "QA Surcharge");',
-		'    const subtype = /service/i.test(String(item.type || label)) ? "service" : "misc";',
-		'    pricingDocs.push({',
-		'      _id: `qa-pricing-${subtype}-${String(item._id).replace(/[^a-z0-9_-]/gi, "-")}-global`,',
-		'      id_item: item._id, name: label, description: label, unit: item.unit || "Each", active: true, type: "sale", sub_type: subtype, price: 15, price_gross: 15, discount_percent: 0, id_customer: "", createdAt: now, updatedAt: now',
-		'    });',
-		'    if (customerIds && customerIds[0]) {',
-		'      pricingDocs.push({',
-		'        _id: `qa-pricing-${subtype}-${String(item._id).replace(/[^a-z0-9_-]/gi, "-")}-customer`,',
-		'        id_item: item._id, name: `${label} Customer Override`, description: `${label} Customer Override`, unit: item.unit || "Each", active: true, type: "sale", sub_type: subtype, price: 20, price_gross: 20, discount_percent: 0, id_customer: customerIds[0], createdAt: now, updatedAt: now',
-		'      });',
-		'    }',
-		'  }',
-		'  for (const doc of pricingDocs) await targetDb.collection("pricing-items").replaceOne({ _id: doc._id }, doc, { upsert: true });',
-		'  summary.collections["pricing-items"] = (summary.collections["pricing-items"] || 0) + pricingDocs.length;',
-		'  summary.selected.qa_surcharge_fixture_items = usableItems.map((doc) => doc._id);',
-		'  summary.selected.qa_surcharge_pricing_items = pricingDocs.map((doc) => doc._id);',
-		'  if (pricingDocs.length) summary.notes.push(`Ensured ${pricingDocs.length} local pricing-items for service/misc surcharge override/default QA.`);',
-		'}',
-		'',
-		'async function cleanupSyntheticBillingDashboardQaFixtures(targetDb, summary) {',
-		'  const fixtureIdQuery = { _id: /^qa-billing-/ };',
-		'  const fixtureCollections = ["customers", "yards", "items", "production-locations", "bols", "production-sales-orders", "production-deliveries", "invoices"];',
-		'  let removed = 0;',
-		'  for (const collectionName of fixtureCollections) {',
-		'    const result = await targetDb.collection(collectionName).deleteMany(fixtureIdQuery).catch(() => ({ deletedCount: 0 }));',
-		'    removed += Number(result && result.deletedCount || 0);',
-		'  }',
-		'  const invoiceResult = await targetDb.collection("invoices").deleteMany({ $or: [{ invoice_string: /^QA-INV-/ }, { invoice_number: 4333 }] }).catch(() => ({ deletedCount: 0 }));',
-		'  removed += Number(invoiceResult && invoiceResult.deletedCount || 0);',
-		'  const psoResult = await targetDb.collection("production-sales-orders").deleteMany({ $or: [{ order_number_string: /^QA-PSO-/ }, { activity_number: /^QA-PSO-/ }] }).catch(() => ({ deletedCount: 0 }));',
-		'  removed += Number(psoResult && psoResult.deletedCount || 0);',
-		'  if (removed) summary.notes.push(`Removed ${removed} stale synthetic billing dashboard QA fixture document(s) from the local Mongo profile.`);',
-		'}',
-		'',
-		'async function ensureBillingDashboardQaFixtures(targetDb, summary, customerIds, yardIds, serviceItems) {',
-		'  const now = new Date();',
-		'  const customerId = (customerIds && customerIds[0]) || "qa-billing-customer";',
-		'  const yardId = (yardIds && yardIds[0]) || "qa-billing-yard";',
-		'  const item = (serviceItems || []).find((doc) => doc && doc._id) || { _id: "qa-billing-service-item", name: "QA Billing Service Item", unit: "Each", type: "Service", active: true };',
-		'  const locationId = "qa-billing-location";',
-		'  const bolId = "qa-billing-bol";',
-		'  const psoId = "qa-billing-pso-awaiting-invoice";',
-		'  const deliveryId = "qa-billing-delivery-awaiting-invoice";',
-		'  const invoiceId = "qa-billing-existing-processing-invoice";',
-		'  await targetDb.collection("customers").replaceOne({ _id: customerId }, {',
-		'    _id: customerId, name: "QA Billing Customer", active: true, send_type: "Email", customer_approval_required: false, createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  await targetDb.collection("yards").replaceOne({ _id: yardId }, { _id: yardId, name: "QA Billing Yard", active: true, createdAt: now, updatedAt: now }, { upsert: true });',
-		'  await targetDb.collection("items").replaceOne({ _id: item._id }, { ...item, _id: item._id, name: item.name || "QA Billing Service Item", unit: item.unit || "Each", type: item.type || "Service", active: true, updatedAt: now }, { upsert: true });',
-		'  await targetDb.collection("production-locations").replaceOne({ _id: locationId }, {',
-		'    _id: locationId, id_customer: customerId, customer: "QA Billing Customer", location: "QA Billing Location", id_yard: yardId, county: "QA County", active: true, createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  await targetDb.collection("bols").replaceOne({ _id: bolId }, {',
-		'    _id: bolId, bol_string: "QA-BOL-004333", bol_number: "QA-BOL-004333", status: "Delivered", date: now, driver: "QA Driver", createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  const lineItem = {',
-		'    _id: "qa-billing-pso-line-1", id_item: item._id, item: item.name || "QA Billing Service Item", item_type: item.type || "Service", type: item.type || "Service", quantity: 2, unit: item.unit || "Each", price: 100, price_subtotal: 200, price_total: 216.5, tax_amount: 16.5, billed: true, memo_bill: false, taxable: true, id_location: locationId, location: "QA Billing Location", id_yard: yardId, yard: "QA Billing Yard"',
-		'  };',
-		'  await targetDb.collection("production-sales-orders").replaceOne({ _id: psoId }, {',
-		'    _id: psoId, status: "Awaiting Invoice", type: "Invoice", id_customer: customerId, customer: "QA Billing Customer", id_default_yard: yardId, date_created: now, date_ship: now, date_needed: now, order_number_string: "QA-PSO-004333", activity_number: "QA-PSO-004333", bol_numbers: "QA-BOL-004333", drivers: "QA Driver", ship_to_type: "Location", ship_to_location: "QA Billing Location", price: 200, price_subtotal: 200, account_manager: "QA Admin", user_approved: "QA Admin", production_locations: [{ id_location: locationId, location: "QA Billing Location", items: [lineItem] }], createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  await targetDb.collection("production-deliveries").replaceOne({ _id: deliveryId }, {',
-		'    _id: deliveryId, type: "Delivery", approved: true, billed: true, memo_bill: false, invoiced: false, generic: false, invoices: [], consignment: false, id_activity: psoId, activity_number: "QA-PSO-004333", activity_type: "Invoice", id_customer: customerId, id_location: locationId, location: "QA Billing Location", id_yard: yardId, yard: "QA Billing Yard", id_item: item._id, item: item.name || "QA Billing Service Item", item_type: item.type || "Service", quantity: 2, unit: item.unit || "Each", price_per_unit: 100, price_subtotal: 200, price_total: 216.5, tax_amount: 16.5, id_bol: bolId, bol_number: "QA-BOL-004333", date: now, date_ship: now, user_approved: "QA Admin", account_manager: "QA Admin", createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  await targetDb.collection("invoices").replaceOne({ _id: invoiceId }, {',
-		'    _id: invoiceId, status: "Processing", type: "Invoice", id_customer: customerId, customer: "QA Billing Customer", id_yard: yardId, yard: "QA Billing Yard", invoice_string: "QA-INV-004333", invoice_number: 4333, date_invoice: now, total: 216.5, subtotal: 200, tax_amount: 16.5, printed: false, invoice_opened: false, logs: [], files: [], line_items: [{ ...lineItem, source_production_delivery_id: deliveryId, description: lineItem.item, date: now }], createdAt: now, updatedAt: now',
-		'  }, { upsert: true });',
-		'  summary.collections.customers = (summary.collections.customers || 0) + 1;',
-		'  summary.collections.yards = (summary.collections.yards || 0) + 1;',
-		'  summary.collections.items = (summary.collections.items || 0) + 1;',
-		'  summary.collections["production-locations"] = (summary.collections["production-locations"] || 0) + 1;',
-		'  summary.collections.bols = (summary.collections.bols || 0) + 1;',
-		'  summary.collections["production-sales-orders"] = (summary.collections["production-sales-orders"] || 0) + 1;',
-		'  summary.collections["production-deliveries"] = (summary.collections["production-deliveries"] || 0) + 1;',
-		'  summary.collections.invoices = (summary.collections.invoices || 0) + 1;',
-		'  summary.selected.qa_billing_fixture = { customerId, yardId, psoId, deliveryId, invoiceId, itemId: item._id };',
-		'  summary.notes.push("Ensured localhost-only Billing Dashboard fixtures: one existing processing invoice plus one awaiting-invoice PSO/delivery source row.");',
-		'}',
-		'',
-		'async function selectDashboardReadyProductionDeliveryIds(sourceDb, query, limit = 5) {',
-		'  const rows = await sourceDb.collection("production-deliveries").aggregate([',
-		'    { $match: query || {} },',
-		'    { $lookup: { from: "production-sales-orders", localField: "id_activity", foreignField: "_id", as: "dbPSO" } },',
-		'    { $unwind: { path: "$dbPSO", preserveNullAndEmptyArrays: false } },',
-		'    { $match: { "dbPSO.type": { $ne: "Consignment Invoice" } } },',
-		'    { $lookup: {',
-		'      from: "bols",',
-		'      let: { idBol: "$id_bol" },',
-		'      pipeline: [{ $match: { $expr: { $eq: ["$_id", "$$idBol"] }, status: "Delivered" } }],',
-		'      as: "bol"',
-		'    } },',
-		'    { $unwind: { path: "$bol", preserveNullAndEmptyArrays: false } },',
-		'    { $lookup: { from: "production-locations", localField: "id_location", foreignField: "_id", as: "dbProductionLocation" } },',
-		'    { $lookup: { from: "well-groups", localField: "id_well_group", foreignField: "_id", as: "dbWellGroup" } },',
-		'    { $match: { $or: [{ "dbProductionLocation.0": { $exists: true } }, { "dbWellGroup.0": { $exists: true } }] } },',
-		'    { $sort: { date: -1, date_ship: -1, date_treated: -1, updatedAt: -1 } },',
-		'    { $limit: limit },',
-		'    { $project: { _id: 1 } }',
-		'  ]).toArray();',
-		'  return rows.map((doc) => doc._id).filter(Boolean);',
-		'}',
-		'',
-		'async function selectTruckTreatDashboardReadyProductionDeliveryIds(sourceDb, query, limit = 5) {',
-		'  const rows = await sourceDb.collection("production-deliveries").aggregate([',
-		'    { $match: query || {} },',
-		'    { $lookup: {',
-		'      from: "bols",',
-		'      let: { idBol: "$id_bol" },',
-		'      pipeline: [{ $match: { $expr: { $eq: ["$_id", "$$idBol"] }, status: "Delivered" } }],',
-		'      as: "bol"',
-		'    } },',
-		'    { $unwind: { path: "$bol", preserveNullAndEmptyArrays: false } },',
-		'    { $lookup: { from: "production-locations", localField: "id_location", foreignField: "_id", as: "dbProductionLocation" } },',
-		'    { $lookup: { from: "well-groups", localField: "id_well_group", foreignField: "_id", as: "dbWellGroup" } },',
-		'    { $match: { $or: [{ "dbProductionLocation.0": { $exists: true } }, { "dbWellGroup.0": { $exists: true } }] } },',
-		'    { $sort: { date: -1, date_treated: -1, updatedAt: -1 } },',
-		'    { $limit: limit },',
-		'    { $project: { _id: 1 } }',
-		'  ]).toArray();',
-		'  return rows.map((doc) => doc._id).filter(Boolean);',
-		'}',
-		'',
-		'async function selectLocalhostDeliveryFixtureIds(sourceDb, query, limit = 3) {',
-		'  const rows = await sourceDb.collection("production-deliveries").aggregate([',
-		'    { $match: { $and: [query || {}, { id_bol: { $type: "string", $ne: "" } }] } },',
-		'    { $lookup: { from: "production-sales-orders", localField: "id_activity", foreignField: "_id", as: "dbPSO" } },',
-		'    { $unwind: { path: "$dbPSO", preserveNullAndEmptyArrays: false } },',
-		'    { $match: { "dbPSO.type": { $ne: "Consignment Invoice" } } },',
-		'    { $lookup: { from: "production-locations", localField: "id_location", foreignField: "_id", as: "dbProductionLocation" } },',
-		'    { $lookup: { from: "well-groups", localField: "id_well_group", foreignField: "_id", as: "dbWellGroup" } },',
-		'    { $match: { $or: [{ "dbProductionLocation.0": { $exists: true } }, { "dbWellGroup.0": { $exists: true } }] } },',
-		'    { $sort: { date: -1, date_ship: -1, updatedAt: -1 } },',
-		'    { $limit: limit },',
-		'    { $project: { _id: 1 } }',
-		'  ]).toArray();',
-		'  return rows.map((doc) => doc._id).filter(Boolean);',
-		'}',
-		'',
-	'async function seedBillingInventory(sourceDb, targetDb) {',
-		'  const includeBillingFixtures = shouldSeedBillingDashboardFixtures();',
-			'  const includePricingImportFixtures = includeBillingFixtures || shouldSeedPricingImportFixtures();',
-			'  const summary = { profile: desiredSeedProfile(), collections: {}, selected: {}, notes: [] };',
-			'  const identifiers = extractSeedIdentifiers();',
-			'  summary.selected.seed_identifiers = identifiers;',
-			'  const qaIdentityUsers = await copyQaIdentityUsers(sourceDb, targetDb, summary);',
-			'  const truckTreatingBolContextDocs = await copyTruckTreatingBolContext(sourceDb, targetDb, summary);',
-			'  const ticketAssetContextDocs = await copyTicketAssetContext(sourceDb, targetDb, summary);',
-			'  const productionInterchangeablesContextDocs = await copyProductionInterchangeablesContext(sourceDb, targetDb, summary);',
-			'  const pricingImportWorkbookContextDocs = includePricingImportFixtures ? await copyPricingImportWorkbookContext(sourceDb, targetDb, summary) : [];',
-		'  if (!includeBillingFixtures) {',
-		'    summary.notes.push("Billing dashboard fixtures are disabled because ticket context does not require billing, invoices, taxes, inventory, surcharges, checkout, or pick tickets.");',
-		'    await cleanupSyntheticBillingDashboardQaFixtures(targetDb, summary);',
-		'  }',
-		'  if (includePricingImportFixtures && !includeBillingFixtures) {',
-		'    summary.notes.push("Using pricing-import seed profile: pricing records are copied without synthetic billing dashboard invoice fixtures.");',
-		'  }',
-		'  const billableDeliveryQuery = { $and: [',
-		'    { $or: [{ type: "Delivery" }, { type: "Pickup" }] },',
-		'    { $or: [{ consignment: { $exists: false } }, { consignment: false }] },',
-		'    { approved: true }, { invoiced: false }, { generic: false }, { "invoices.0": { $exists: false } },',
-		'    { $or: [{ billed: true }, { memo_bill: true }] }',
-		'  ] };',
-		'  const billableTruckTreatQuery = { $and: [',
-		'    { type: "Truck Treat" }, { invoiced: false }, { generic: false }, { approved: true }, { "invoices.0": { $exists: false } },',
-		'    { $or: [{ billed: true }, { memo_bill: true }] }',
-		'  ] };',
-		'  const hintedQuery = identifierQuery(identifiers);',
-		'  let hintedProductionDeliveries = [];',
-		'  let hintedTruckTreatingDeliveries = [];',
-		'  if (hintedQuery) {',
-		'    hintedProductionDeliveries = await copyByIds(sourceDb, targetDb, "production-deliveries", await selectDashboardReadyProductionDeliveryIds(sourceDb, { $and: [billableDeliveryQuery, hintedQuery] }, 3), summary, 3);',
-		'    hintedTruckTreatingDeliveries = await copyByIds(sourceDb, targetDb, "production-deliveries", await selectTruckTreatDashboardReadyProductionDeliveryIds(sourceDb, { $and: [billableTruckTreatQuery, hintedQuery] }, 3), summary, 3);',
-		'    if (hintedProductionDeliveries.length || hintedTruckTreatingDeliveries.length) summary.notes.push(`Preferred live records matching ticket identifiers: ${identifiers.join(", ")}`);',
-		'    else summary.notes.push(`No billable live records matched ticket identifiers: ${identifiers.join(", ")}`);',
-		'  }',
-		'',
-		'  let fallbackProductionDeliveries = hintedProductionDeliveries.length ? [] : await copyByIds(sourceDb, targetDb, "production-deliveries", await selectDashboardReadyProductionDeliveryIds(sourceDb, billableDeliveryQuery, 3), summary, 3);',
-		'  if (!hintedProductionDeliveries.length && !fallbackProductionDeliveries.length) {',
-		'    fallbackProductionDeliveries = await copyByIds(sourceDb, targetDb, "production-deliveries", await selectLocalhostDeliveryFixtureIds(sourceDb, billableDeliveryQuery, 3), summary, 3);',
-		'    if (fallbackProductionDeliveries.length) summary.notes.push("Created localhost-only delivery invoice fixture from live delivery data by normalizing copied BOL status to Delivered in local Mongo.");',
-		'  }',
-		'  const fallbackTruckTreatingDeliveries = hintedTruckTreatingDeliveries.length ? [] : await copyByIds(sourceDb, targetDb, "production-deliveries", await selectTruckTreatDashboardReadyProductionDeliveryIds(sourceDb, billableTruckTreatQuery, 3), summary, 3);',
-		'  const productionDeliveries = [...hintedProductionDeliveries, ...fallbackProductionDeliveries];',
-		'  const truckTreatingDeliveries = [...hintedTruckTreatingDeliveries, ...fallbackTruckTreatingDeliveries];',
-		'  summary.selected.production_deliveries = productionDeliveries.map((doc) => doc._id);',
-		'  summary.selected.truck_treating_deliveries = truckTreatingDeliveries.map((doc) => doc._id);',
-		'  if (!productionDeliveries.length && !truckTreatingDeliveries.length) {',
-		'    summary.notes.push("No live billable delivery or truck-treatment records matched the Billing Dashboard awaiting-invoice filters.");',
-		'  }',
-		'',
-			'  const sourceDocs = [...qaIdentityUsers, ...truckTreatingBolContextDocs, ...ticketAssetContextDocs, ...productionInterchangeablesContextDocs, ...pricingImportWorkbookContextDocs, ...productionDeliveries, ...truckTreatingDeliveries];',
-			'  const pricingImportContext = summary.selected.pricing_import_workbook_context || {};',
-			'  const customerIds = unique([...idValues(sourceDocs, ["id_customer"]), ...(Array.isArray(pricingImportContext.customer_ids) ? pricingImportContext.customer_ids : [])]);',
-		'  const locationIds = idValues(sourceDocs, ["id_location"]);',
-		'  const wellGroupIds = idValues(sourceDocs, ["id_well_group"]);',
-			'  const itemIds = unique([...idValues(sourceDocs, ["id_item", "id_chemical"]), ...(Array.isArray(pricingImportContext.item_ids) ? pricingImportContext.item_ids : []), ...(Array.isArray(pricingImportContext.chemical_ids) ? pricingImportContext.chemical_ids : [])]);',
-		'  const bolIds = idValues(sourceDocs, ["id_bol", "id_bols"]);',
-		'  const yardIds = idValues(sourceDocs, ["id_yard"]);',
-		'  const activityIds = idValues(sourceDocs, ["id_activity", "id_production_sales_order", "id_sales_order"]);',
-		'  const tankIds = idValues(sourceDocs, ["id_tank"]);',
-		'  const truckTreatingDetailIds = idValues(sourceDocs, ["id_delivery", "id_truck_treating_delivery"]);',
-		'  const userIds = idValues(sourceDocs, ["id_user_approved", "id_driver", "id_driver_scheduled", "id_account_manager", "id_foreman"]);',
-		'',
-		'  const copiedLocations = await copyByIds(sourceDb, targetDb, "production-locations", locationIds, summary);',
-		'  const copiedWellGroups = await copyByIds(sourceDb, targetDb, "well-groups", wellGroupIds, summary);',
-		'  const copiedItems = await copyByIds(sourceDb, targetDb, "items", itemIds, summary);',
-		'  const copiedChemicals = await copyByIds(sourceDb, targetDb, "chemicals", itemIds, summary);',
-		'  await copyByIds(sourceDb, targetDb, "production-sales-orders", activityIds, summary);',
-		'  await copyByIds(sourceDb, targetDb, "production-location-tanks", tankIds, summary);',
-		'  await copyByIds(sourceDb, targetDb, "truck-treating-deliveries", truckTreatingDetailIds, summary);',
-		'  await copyByIds(sourceDb, targetDb, "customers", unique([...customerIds, ...idValues(copiedLocations, ["id_customer"]), ...idValues(copiedWellGroups, ["id_customer"])]), summary);',
-		'  await copyByIds(sourceDb, targetDb, "bols", bolIds, summary);',
-		'  if (productionDeliveries.length && bolIds.length) await targetDb.collection("bols").updateMany({ _id: { $in: bolIds } }, { $set: { status: "Delivered" } });',
-		'  await copyByIds(sourceDb, targetDb, "yards", yardIds, summary);',
-		'  await copyByIds(sourceDb, targetDb, "users", userIds, summary);',
-		'',
-		'  const copiedServiceItems = await copyQuery(sourceDb, targetDb, "items", { $or: [',
-		'    { type: /service/i }, { type: /misc/i }, { category: /service/i }, { category: /misc/i },',
-		'    { name: /surcharge|fuel|delivery|service|misc/i }',
-		'  ] }, summary, 40, { updatedAt: -1 });',
-		'  summary.selected.service_or_surcharge_items = copiedServiceItems.map((doc) => doc._id);',
-		'',
-		'  if (includePricingImportFixtures) {',
-		'    await copyQuery(sourceDb, targetDb, "pricing-items", { $or: [',
-		'      { id_item: { $in: unique([...itemIds, ...copiedItems.map((doc) => doc._id), ...copiedServiceItems.map((doc) => doc._id)]) } },',
-		'      { id_chemical: { $in: unique([...itemIds, ...copiedChemicals.map((doc) => doc._id)]) } },',
-		'      { id_customer: { $in: customerIds } },',
-		'      { sub_type: { $in: ["misc", "service"] } },',
-		'      { id_item: { $in: copiedServiceItems.map((doc) => doc._id) } },',
-		'      { name: /surcharge|fuel|delivery|service|misc/i }',
-		'    ] }, summary, 80, { updatedAt: -1 });',
-		'  }',
-		'',
-		'  if (includeBillingFixtures) {',
-		'    await copyQuery(sourceDb, targetDb, "sales-taxes", {}, summary, 80, { updatedAt: -1 });',
-		'    await copyQuery(sourceDb, targetDb, "state-counties", {}, summary, 80, { updatedAt: -1 });',
-		'    await copyQuery(sourceDb, targetDb, "accounting-codes", {}, summary, 80, { updatedAt: -1 });',
-		'    await ensureBillingSurchargePricingFixtures(targetDb, summary, copiedServiceItems, customerIds);',
-		'    await ensureBillingDashboardQaFixtures(targetDb, summary, customerIds, yardIds, copiedServiceItems);',
-		'',
-		'    const inventoryLocationQuery = { $or: [',
-		'      { id_item: { $in: unique([...itemIds, ...copiedItems.map((doc) => doc._id), ...copiedServiceItems.map((doc) => doc._id)]) } },',
-		'      { id_chemical: { $in: unique([...itemIds, ...copiedChemicals.map((doc) => doc._id)]) } },',
-		'      { id_yard: { $in: yardIds } }',
-		'    ] };',
-		'    const inventoryLocations = await copyQuery(sourceDb, targetDb, "inventory-locations", inventoryLocationQuery, summary, 80, { updatedAt: -1 });',
-		'    await copyQuery(sourceDb, targetDb, "inventory-transactions", { $or: [',
-		'      { id_inventory_location: { $in: inventoryLocations.map((doc) => doc._id) } },',
-		'      { id_item: { $in: itemIds } },',
-		'      { id_chemical: { $in: itemIds } }',
-		'    ] }, summary, 120, { date: -1, updatedAt: -1 });',
-		'  }',
-		'',
-			'  summary.ready = pricingImportWorkbookContextDocs.length > 0 || truckTreatingBolContextDocs.length > 0 || ticketAssetContextDocs.length > 0 || productionInterchangeablesContextDocs.length > 0 || productionDeliveries.length > 0 || truckTreatingDeliveries.length > 0;',
-		'  return summary;',
-	'}',
-		'',
-		'(async () => {',
-		'  const { MongoClient } = requireMongo();',
-		'  const source = resolveRuntimeSource();',
-		'  const targetUri = process.env.RESOLVEIO_SUPPORT_QA_MONGO_URL || process.env.RESOLVEIO_RUNNER_QA_MONGO_URL || process.env.MONGO_URL || "mongodb://127.0.0.1:3001/resolveio?directConnection=true";',
-	'  if (!source.uri) {',
-	'    preserveExistingSeedResult("missing_live_mongo_uri");',
-	'    writeResult({ status: isLiveDataRequired() ? "failed" : "skipped", reason: "missing_live_mongo_uri", required: isLiveDataRequired(), result_path: resultPath }, isLiveDataRequired() ? 5 : 0);',
-	'  }',
-		'  if (!isLocalMongoUri(targetUri)) writeResult({ status: "failed", reason: "target_mongo_must_be_localhost", target_uri_redacted: redactUri(targetUri), result_path: resultPath }, 3);',
-		'  if (String(source.uri) === String(targetUri)) writeResult({ status: "failed", reason: "source_and_target_mongo_match", result_path: resultPath }, 3);',
-		'  await waitForTargetMongo(MongoClient, targetUri);',
-		'  const sourceClient = new MongoClient(source.uri, { readPreference: "secondaryPreferred", serverSelectionTimeoutMS: 15000 });',
-		'  const targetClient = new MongoClient(targetUri, { serverSelectionTimeoutMS: 15000 });',
-		'  try {',
-		'    await sourceClient.connect();',
-		'    await targetClient.connect();',
-		'    const sourceDb = source.database ? sourceClient.db(source.database) : sourceClient.db();',
-		'    const targetDb = targetClient.db();',
-		'    const summary = await seedBillingInventory(sourceDb, targetDb);',
-		'    writeResult({',
-		'      status: summary.ready ? "pass" : "needs-data",',
-		'      source_uri_redacted: redactUri(source.uri),',
-		'      target_uri_redacted: redactUri(targetUri),',
-		'      ...summary,',
-		'      result_path: resultPath',
-		'    }, summary.ready ? 0 : 4);',
-		'  } finally {',
-		'    await sourceClient.close().catch(() => undefined);',
-		'    await targetClient.close().catch(() => undefined);',
-		'  }',
-		'})().catch((error) => writeResult({ status: "failed", reason: error && (error.stack || error.message) || String(error), result_path: resultPath }, 2));',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerBugfixComparisonQaScript(): string {
-	return [
-		'#!/usr/bin/env bash',
-		'set -u',
-		'TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
-		'source "$TOOLS_DIR/env.sh"',
-		'if resolveio_support_codex_lane_is_build 2>/dev/null; then',
-		'  resolveio_support_codex_block_build_lane_qa',
-		'  exit 86',
-		'fi',
-		'PROJECT_ROOT="${1:-}"',
-		'if [ -z "$PROJECT_ROOT" ]; then',
-		'  echo "Usage: $0 <project-root> [baseline-ref] -- <qa-command...>" >&2',
-		'  exit 2',
-		'fi',
-		'shift || true',
-		'DEFAULT_BASELINE_REF="${RESOLVEIO_RUNNER_QA_BASELINE_REF:-${RESOLVEIO_SUPPORT_QA_BASELINE_REF:-origin/master}}"',
-		'if [ "${1:-}" = "--" ]; then',
-		'  BASELINE_REF="$DEFAULT_BASELINE_REF"',
-		'else',
-		'  BASELINE_REF="${1:-$DEFAULT_BASELINE_REF}"',
-		'  if [ "$#" -gt 0 ]; then shift || true; fi',
-		'fi',
-		'if [ "${1:-}" = "--" ]; then shift; fi',
-		'if [ "$#" -eq 0 ]; then',
-		'  echo "Usage: $0 <project-root> [baseline-ref] -- <qa-command...>" >&2',
-		'  exit 2',
-		'fi',
-		'PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"',
-		'REPO_ROOT="$(git -C "$PROJECT_ROOT" rev-parse --show-toplevel)"',
-		'PROJECT_REL="$(git -C "$REPO_ROOT" ls-files --full-name "$PROJECT_ROOT" 2>/dev/null | head -1 | xargs dirname 2>/dev/null || true)"',
-		'if [ -z "$PROJECT_REL" ] || [ "$PROJECT_REL" = "." ]; then',
-		'  PROJECT_REL="$(node - "$REPO_ROOT" "$PROJECT_ROOT" <<\'RESOLVEIO_REL\'',
-		'const path = require("path");',
-		'console.log(path.relative(process.argv[2], process.argv[3]) || ".");',
-		'RESOLVEIO_REL',
-		'  )"',
-		'fi',
-		'ARTIFACT_DIR="$PROJECT_ROOT/qa-artifacts"',
-		'mkdir -p "$ARTIFACT_DIR/baseline" "$ARTIFACT_DIR/candidate"',
-		'RESULT_JSON="$ARTIFACT_DIR/bugfix-comparison-result.json"',
-		'CANDIDATE_PATCH="$ARTIFACT_DIR/bugfix-candidate.patch"',
-		'ORIGINAL_HEAD="$(git -C "$REPO_ROOT" rev-parse HEAD)"',
-		'ORIGINAL_BRANCH="$(git -C "$REPO_ROOT" symbolic-ref --short HEAD 2>/dev/null || true)"',
-		'QA_COMMAND=("$@")',
-		'STOPPER="$TOOLS_DIR/stop-local-qa.sh"',
-		'CURRENT_PHASE=""',
-		'stop_local_qa() {',
-		'  "$STOPPER" "$PROJECT_ROOT" >/dev/null 2>&1 || true',
-		'}',
-		'write_json() {',
-		'  node - "$RESULT_JSON" "$@" <<\'RESOLVEIO_WRITE_JSON\'',
-		'const fs = require("fs");',
-		'const [path, status, baselineExit, candidateExit, baselineRef, originalHead, projectRel, note] = process.argv.slice(2);',
-		'const payload = {',
-		'  status,',
-		'  baseline_ref: baselineRef,',
-		'  original_head: originalHead,',
-		'  project: projectRel,',
-		'  baseline_exit_code: Number(baselineExit),',
-		'  candidate_exit_code: Number(candidateExit),',
-		'  code_switch_proven: Number(baselineExit) !== 0 && Number(candidateExit) === 0,',
-		'  candidate_passed: Number(candidateExit) === 0,',
-		'  baseline_failed: Number(baselineExit) !== 0,',
-		'  note,',
-		'  artifact_dirs: { baseline: "qa-artifacts/baseline", candidate: "qa-artifacts/candidate" },',
-		'  created_at: new Date().toISOString()',
-		'};',
-		'fs.writeFileSync(path, JSON.stringify(payload, null, 2));',
-		'console.log(JSON.stringify(payload, null, 2));',
-		'RESOLVEIO_WRITE_JSON',
-		'}',
-		'snapshot_phase_artifacts() {',
-		'  local phase="$1"',
-		'  mkdir -p "$ARTIFACT_DIR/$phase"',
-		'  find "$ARTIFACT_DIR" -maxdepth 1 -type f \\( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.webp" -o -name "*.json" -o -name "*.txt" -o -name "*.log" -o -name "*.zip" \\) -print0 2>/dev/null | while IFS= read -r -d "" file; do',
-		'    cp "$file" "$ARTIFACT_DIR/$phase/$(basename "$file")" 2>/dev/null || true',
-		'  done',
-		'}',
-		'capture_candidate_patch() {',
-		'  : > "$CANDIDATE_PATCH"',
-		'  git -C "$REPO_ROOT" diff --binary -- "$PROJECT_REL" >> "$CANDIDATE_PATCH" || true',
-		'  git -C "$REPO_ROOT" diff --binary --cached -- "$PROJECT_REL" >> "$CANDIDATE_PATCH" || true',
-		'}',
-		'checkout_project_from_ref() {',
-		'  local ref="$1"',
-		'  git -C "$REPO_ROOT" checkout "$ref" -- "$PROJECT_REL"',
-		'}',
-		'restore_candidate() {',
-		'  stop_local_qa',
-		'  checkout_project_from_ref "$ORIGINAL_HEAD" || true',
-		'  if [ -s "$CANDIDATE_PATCH" ]; then',
-		'    git -C "$REPO_ROOT" apply --whitespace=nowarn "$CANDIDATE_PATCH" || true',
-		'  fi',
-		'}',
-		'trap restore_candidate EXIT',
-		'run_phase() {',
-		'  local phase="$1"',
-		'  CURRENT_PHASE="$phase"',
-		'  stop_local_qa',
-		'  export RESOLVEIO_RUNNER_QA_PHASE="$phase"',
-		'  export RESOLVEIO_SUPPORT_QA_PHASE="$phase"',
-		'  export RESOLVEIO_RUNNER_QA_ARTIFACT_DIR="$ARTIFACT_DIR/$phase"',
-		'  export RESOLVEIO_SUPPORT_QA_ARTIFACT_DIR="$ARTIFACT_DIR/$phase"',
-		'  export RESOLVEIO_RUNNER_QA_PROJECT_ROOT="$PROJECT_ROOT"',
-		'  export RESOLVEIO_SUPPORT_QA_PROJECT_ROOT="$PROJECT_ROOT"',
-		'  export RESOLVEIO_RUNNER_QA_TOOLS_DIR="$TOOLS_DIR"',
-		'  export RESOLVEIO_SUPPORT_QA_TOOLS_DIR="$TOOLS_DIR"',
-		'  mkdir -p "$ARTIFACT_DIR/$phase"',
-		'  find "$ARTIFACT_DIR/$phase" -maxdepth 1 -type f \\( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.webp" -o -name "*.json" -o -name "*.txt" -o -name "*.log" -o -name "*.zip" \\) -delete 2>/dev/null || true',
-		'  find "$ARTIFACT_DIR" -maxdepth 1 -type f \\( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.webp" -o -name "*proof.json" -o -name "auth-bootstrap-result.json" \\) -delete 2>/dev/null || true',
-		'  RESOLVEIO_SUPPORT_QA_KEEPALIVE=true RESOLVEIO_RUNNER_QA_KEEPALIVE=true "$TOOLS_DIR/run-local-qa.sh" "$PROJECT_ROOT"',
-		'  local stack_rc="$?"',
-		'  if [ "$stack_rc" != "0" ]; then',
-		'    echo "ResolveIO bugfix comparison QA $phase phase blocked: local QA stack did not start (exit $stack_rc)." | tee "$ARTIFACT_DIR/$phase/qa-command.log"',
-		'    snapshot_phase_artifacts "$phase"',
-		'    stop_local_qa',
-		'    return "$stack_rc"',
-		'  fi',
-		'  if [ -f "$TOOLS_DIR/qa-live-data-seed.js" ]; then',
-		'    node "$TOOLS_DIR/qa-live-data-seed.js" "$PROJECT_ROOT"',
-		'    local seed_rc="$?"',
-		'    if [ "$seed_rc" != "0" ]; then',
-		'      echo "ResolveIO bugfix comparison QA $phase phase blocked: live data seed failed (exit $seed_rc)." | tee "$ARTIFACT_DIR/$phase/qa-command.log"',
-		'      snapshot_phase_artifacts "$phase"',
-		'      stop_local_qa',
-		'      return "$seed_rc"',
-		'    fi',
-		'  fi',
-		'  set +e',
-		'  (cd "$PROJECT_ROOT" && "${QA_COMMAND[@]}") 2>&1 | tee "$ARTIFACT_DIR/$phase/qa-command.log"',
-		'  local rc="${PIPESTATUS[0]}"',
-		'  set +e',
-		'  snapshot_phase_artifacts "$phase"',
-		'  stop_local_qa',
-		'  return "$rc"',
-		'}',
-		'echo "ResolveIO bugfix comparison QA preserving candidate diff for $PROJECT_REL"',
-		'capture_candidate_patch',
-		'stop_local_qa',
-		'echo "ResolveIO bugfix comparison QA baseline phase: $BASELINE_REF"',
-		'checkout_project_from_ref "$BASELINE_REF"',
-		'run_phase baseline',
-		'BASELINE_EXIT="$?"',
-		'echo "ResolveIO bugfix comparison QA candidate phase: restored workspace candidate"',
-		'restore_candidate',
-		'run_phase candidate',
-		'CANDIDATE_EXIT="$?"',
-		'if [ "$CANDIDATE_EXIT" = "0" ] && [ "$BASELINE_EXIT" != "0" ]; then',
-		'  STATUS="pass"',
-		'  NOTE="Baseline failed and candidate passed for the same QA command."',
-		'elif [ "$CANDIDATE_EXIT" = "0" ]; then',
-		'  STATUS="inconclusive_baseline_also_passed"',
-		'  NOTE="Candidate passed, but baseline also passed; the code switch did not prove the bug fix."',
-		'else',
-		'  STATUS="fail_candidate_failed"',
-		'  NOTE="Candidate failed the QA command."',
-		'fi',
-		'write_json "$STATUS" "$BASELINE_EXIT" "$CANDIDATE_EXIT" "$BASELINE_REF" "$ORIGINAL_HEAD" "$PROJECT_REL" "$NOTE"',
-		'[ "$CANDIDATE_EXIT" = "0" ] || exit "$CANDIDATE_EXIT"',
-		'[ "$STATUS" = "pass" ] || exit 8',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerQaWorkflowProbeScript(): string {
-	return [
-		'#!/usr/bin/env node',
-		"'use strict';",
-		'',
-		'const fs = require("fs");',
-		'const http = require("http");',
-		'const https = require("https");',
-		'const path = require("path");',
-		'',
-		'if (isBuildLane()) {',
-		'  console.error("ResolveIO support lane guard: browser workflow probes are owned by the QA lane, not the 5.3 build lane.");',
-		'  process.exit(86);',
-		'}',
-		'',
-		'const projectRoot = path.resolve(process.argv[2] || process.cwd());',
-		'const artifactDir = path.resolve(process.env.RESOLVEIO_RUNNER_QA_ARTIFACT_DIR || process.env.RESOLVEIO_SUPPORT_QA_ARTIFACT_DIR || path.join(projectRoot, "qa-artifacts"));',
-		'const routeArg = process.argv[3] || process.env.RESOLVEIO_RUNNER_QA_TARGET_ROUTE || process.env.RESOLVEIO_SUPPORT_QA_TARGET_ROUTE || "";',
-		'const targetRoute = resolveTargetRoute(routeArg);',
-		'const matrixPath = path.join(artifactDir, "qa-coverage-matrix.json");',
-		'const resultPath = path.join(artifactDir, "qa-workflow-probe-result.json");',
-		'const authBootstrapResultPath = path.join(artifactDir, "auth-bootstrap-result.json");',
-		'const passScreenshotPath = path.join(artifactDir, "qa-workflow-route-ready.jpg");',
-		'const failScreenshotPath = path.join(artifactDir, "qa-workflow-route-blocked.jpg");',
-		'const clientUrl = stripTrailingSlash(process.env.RESOLVEIO_RUNNER_QA_CLIENT_URL || process.env.RESOLVEIO_SUPPORT_QA_CLIENT_URL || `http://localhost:${process.env.RESOLVEIO_SUPPORT_QA_CLIENT_PORT || "4200"}`);',
-		'const serverUrl = stripTrailingSlash(process.env.RESOLVEIO_RUNNER_QA_SERVER_URL || process.env.RESOLVEIO_SUPPORT_QA_SERVER_URL || "http://localhost:8080");',
-		'const explicitQaUsername = process.env.RESOLVEIO_RUNNER_QA_AFFECTED_USER_EMAIL || process.env.RESOLVEIO_SUPPORT_QA_AFFECTED_USER_EMAIL || process.env.RESOLVEIO_RUNNER_QA_TICKET_REPORTER_EMAIL || process.env.RESOLVEIO_SUPPORT_QA_TICKET_REPORTER_EMAIL || "";',
-		'const envQaUsername = process.env.RESOLVEIO_RUNNER_QA_USERNAME || process.env.RESOLVEIO_SUPPORT_QA_USERNAME || "";',
-		'const seededQaUsername = readSeededPreferredQaUsername();',
-		'const username = explicitQaUsername || seededQaUsername || envQaUsername || "admin";',
-		'const password = process.env.RESOLVEIO_RUNNER_QA_PASSWORD || process.env.RESOLVEIO_SUPPORT_QA_PASSWORD || "";',
-		'const viewportWidth = Number(process.env.RESOLVEIO_RUNNER_QA_VIEWPORT_WIDTH || process.env.RESOLVEIO_SUPPORT_QA_VIEWPORT_WIDTH || 1920);',
-		'const viewportHeight = Number(process.env.RESOLVEIO_RUNNER_QA_VIEWPORT_HEIGHT || process.env.RESOLVEIO_SUPPORT_QA_VIEWPORT_HEIGHT || 1080);',
-		'',
-		'function isBuildLane() {',
-		'  return /^(build|support_build|support-build)$/i.test(String(process.env.RESOLVEIO_SUPPORT_CODEX_LANE || "").trim());',
-		'}',
-		'',
-		'function stripTrailingSlash(value) { return String(value || "").replace(/\\/+$/, ""); }',
-		'function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }',
-		'function writeJson(filePath, payload) { fs.mkdirSync(path.dirname(filePath), { recursive: true }); fs.writeFileSync(filePath, JSON.stringify(payload, null, 2)); }',
-		'function readJson(filePath) { try { return JSON.parse(fs.readFileSync(filePath, "utf8")); } catch (error) { return null; } }',
-		'function readSeedHintText() {',
-		'	const repoRoot = path.dirname(projectRoot);',
-		'	const chunks = [',
-		'		process.env.RESOLVEIO_SUPPORT_QA_ROW_FILTER || "",',
-		'		process.env.RESOLVEIO_SUPPORT_QA_CURRENT_ROW_WORKFLOW || "",',
-		'		process.env.RESOLVEIO_SUPPORT_QA_CURRENT_ROW_ASSERTION || "",',
-		'		process.env.RESOLVEIO_RUNNER_QA_ROW_FILTER || "",',
-		'		process.env.RESOLVEIO_RUNNER_QA_CURRENT_ROW_WORKFLOW || "",',
-		'		process.env.RESOLVEIO_RUNNER_QA_CURRENT_ROW_ASSERTION || "",',
-		'		process.env.RESOLVEIO_QA_SEED_HINTS || "",',
-		'		process.env.RESOLVEIO_SUPPORT_QA_SEED_HINTS || "",',
-		'		process.env.RESOLVEIO_RUNNER_QA_SEED_HINTS || ""',
-		'	];',
-		'	const candidates = [',
-		'		path.join(artifactDir, "qa-coverage-matrix.json"),',
-		'		path.join(artifactDir, "qa-row-lock.json"),',
-		'		path.join(repoRoot, ".resolveio-support-context", "manual-ticket.request.txt"),',
-		'		path.join(projectRoot, ".resolveio-support-context", "manual-ticket.request.txt"),',
-		'		path.join(repoRoot, ".resolveio-context", "manual-ticket.request.txt"),',
-		'		path.join(projectRoot, ".resolveio-context", "manual-ticket.request.txt")',
-		'	];',
-		'	for (const candidate of candidates) {',
-		'		try {',
-		'			const raw = fs.readFileSync(candidate, "utf8");',
-		'			chunks.push(raw);',
-		'			if (/qa-coverage-matrix\\.json$/.test(candidate)) {',
-		'				const matrix = JSON.parse(raw);',
-		'				const rows = Array.isArray(matrix && matrix.rows) ? matrix.rows : [];',
-		'				for (const row of rows) chunks.push([row.workflow, row.route, row.assertion, row.required_proof, row.data_id, row.data_name, row.blocker, row.evidence, row.caption].filter(Boolean).join("\\n"));',
-		'			}',
-		'			if (/qa-row-lock\\.json$/.test(candidate)) {',
-		'				const lock = JSON.parse(raw);',
-		'				chunks.push([lock.workflow, lock.route, lock.assertion, lock.required_proof, lock.rowFilter, lock.blocker].filter(Boolean).join("\\n"));',
-		'			}',
-		'		} catch (error) {}',
-		'	}',
-		'	return chunks.filter(Boolean).join("\\n");',
-		'}',
-		'function readSeededPreferredQaUsername() {',
-		'	try {',
-		'		const seed = readJson(path.join(artifactDir, "qa-live-data-seed-result.json"));',
-		'		const context = seed && seed.selected && seed.selected.qa_user_context;',
-		'		const preferred = context && (context.preferred_username || context.preferred_email || context.affected_user_email || context.reporter_email);',
-		'		return String(preferred || "").trim();',
-		'	} catch (error) {',
-		'		return "";',
-		'	}',
-		'}',
-		'function normalizeRoute(candidate) {',
-		'	const value = String(candidate || "").trim();',
-		'	if (!value) return "";',
-		'	let routeText = value;',
-		'	if (/^https?:\\/\\//i.test(routeText)) {',
-		'		try { routeText = new URL(routeText).pathname || "/"; } catch (error) { return ""; }',
-		'	}',
-		"	const match = routeText.match(/(?:^|[\\s\\\"'`(])((?:\\/[a-z0-9][a-z0-9._~!$&'()*+,;=:@%\\/-]*)(?:\\?[^\\s\\\"'`<>)]*)?)/i);",
-		'	routeText = ((match && match[1]) || routeText).split(/\\s*->\\s*/)[0].split(/\\s+-\\s+/)[0].trim().replace(/[),.;]+$/g, "");',
-		'	if (!routeText) return "";',
-		'	return routeText.startsWith("/") ? routeText : `/${routeText}`;',
-		'}',
-		'function resolveTargetRoute(explicitRoute) {',
-		'	const hintText = readSeedHintText();',
-		'	const preferInterchangeables = /\\b(interchangeable|interchangeables|mass\\s+update|update\\s+interchangeables|from\\s+chemical|to\\s+chemical|treatment\\s+plan|treatment\\s+plans|production\\s+location)\\b/i.test(hintText);',
-		'	const seedCandidates = [',
-		'		path.join(artifactDir, "qa-live-data-seed-result.json"),',
-		'		path.join(artifactDir, "candidate", "qa-live-data-seed-result.json")',
-		'	];',
-		'	for (const seedPath of seedCandidates) {',
-		'		const seed = readJson(seedPath);',
-		'		const interchangeablesRoutes = (seed && seed.selected && seed.selected.qa_production_interchangeables_context && seed.selected.qa_production_interchangeables_context.browser_routes) || (seed && seed.qa_production_interchangeables_context && seed.qa_production_interchangeables_context.browser_routes);',
-		'		const interchangeablesRoute = normalizeRoute(interchangeablesRoutes && (interchangeablesRoutes.update_interchangeables || interchangeablesRoutes.detail || interchangeablesRoutes.list));',
-		'		if (preferInterchangeables && interchangeablesRoute) return interchangeablesRoute;',
-		'		const routes = seed && seed.selected && seed.selected.truck_treating_bol_context && seed.selected.truck_treating_bol_context.browser_routes;',
-		'		const route = normalizeRoute(routes && (routes.delivery || routes.detail || routes.list));',
-		'		if (!preferInterchangeables && route) return route;',
-		'	}',
-		'	if (preferInterchangeables) return "/production-location/update-interchangeables";',
-		'	const explicit = normalizeRoute(explicitRoute);',
-		'	if (explicit) return explicit;',
-		'	return "/";',
-	'}',
-		'function requestReady(url) {',
-		'	return new Promise((resolve) => {',
-		'		try {',
-		'			const parsed = new URL(url);',
-		'			const mod = parsed.protocol === "https:" ? https : http;',
-		'			const req = mod.get(parsed, { timeout: 3000 }, (res) => { res.resume(); resolve(Boolean(res.statusCode && res.statusCode < 500)); });',
-		'			req.on("timeout", () => req.destroy(new Error("timeout")));',
-		'			req.on("error", () => resolve(false));',
-		'		} catch (error) { resolve(false); }',
-		'	});',
-		'}',
-		'async function waitForHttpReady(url, label) {',
-		'	const deadline = Date.now() + 45000;',
-		'	while (Date.now() < deadline) {',
-		'		if (await requestReady(url)) return;',
-		'		await delay(1500);',
-		'	}',
-		'	throw new Error(`${label} did not become ready at ${url}`);',
-		'}',
-		'function requestJson(url, payload) {',
-		'	return new Promise((resolve, reject) => {',
-		'		const body = JSON.stringify(payload || {});',
-		'		const parsed = new URL(url);',
-		'		const mod = parsed.protocol === "https:" ? https : http;',
-		'		const req = mod.request(parsed, { method: "POST", timeout: 20000, headers: { "content-type": "application/json", "content-length": Buffer.byteLength(body), "origin": clientUrl } }, (res) => {',
-		'			let raw = "";',
-		'			res.setEncoding("utf8");',
-		'			res.on("data", (chunk) => { raw += chunk; });',
-		'			res.on("end", () => {',
-		'				let json = null;',
-		'				try { json = raw ? JSON.parse(raw) : {}; } catch (error) { reject(new Error(`${url} returned non-JSON HTTP ${res.statusCode}: ${raw.slice(0, 300)}`)); return; }',
-		'				if (!res.statusCode || res.statusCode >= 400) { reject(new Error(`${url} returned HTTP ${res.statusCode}: ${JSON.stringify(json).slice(0, 500)}`)); return; }',
-		'				resolve(json);',
-		'			});',
-		'		});',
-		'		req.on("timeout", () => req.destroy(new Error(`${url} timed out`)));',
-		'		req.on("error", reject);',
-		'		req.write(body);',
-		'		req.end();',
-		'	});',
-		'}',
-		'function requirePuppeteer() {',
-		'	const candidates = [',
-		'		path.join(projectRoot, "server", "node_modules", "puppeteer", "lib", "cjs", "puppeteer", "puppeteer.js"),',
-		'		path.join(projectRoot, "node_modules", "puppeteer", "lib", "cjs", "puppeteer", "puppeteer.js"),',
-		'		path.join(process.cwd(), "server", "node_modules", "puppeteer", "lib", "cjs", "puppeteer", "puppeteer.js"),',
-		'		path.join(process.cwd(), "node_modules", "puppeteer", "lib", "cjs", "puppeteer", "puppeteer.js"),',
-		'		"puppeteer"',
-		'	];',
-		'	for (const candidate of candidates) { try { return require(candidate); } catch (error) {} }',
-		'	throw new Error("Unable to require puppeteer from project/server node_modules or global resolution");',
-		'}',
-		'async function launchBrowser(puppeteer) {',
-		'	const launchOptions = { headless: true, defaultViewport: { width: viewportWidth, height: viewportHeight }, args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage", `--window-size=${viewportWidth},${viewportHeight}`] };',
-		'	if (process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_BIN) launchOptions.executablePath = process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_BIN;',
-		'	return puppeteer.launch(launchOptions);',
-		'}',
-		'async function login() {',
-		'	if (!password) throw new Error("QA password is empty; source the generated env.sh before workflow probe");',
-		'	const loginJson = await requestJson(`${serverUrl}/login`, { username, password });',
-		'	const refreshToken = loginJson && loginJson.result && loginJson.result.token;',
-		'	if (loginJson.error || !refreshToken) throw new Error(`Login failed: ${JSON.stringify(loginJson).slice(0, 800)}`);',
-		'	const accessJson = await requestJson(`${serverUrl}/accessToken`, { refreshToken });',
-		'	const accessToken = accessJson && accessJson.result && accessJson.result.token;',
-		'	const user = accessJson && accessJson.result && accessJson.result.user;',
-		'	if (accessJson.error || !accessToken || !user) throw new Error(`Access token failed: ${JSON.stringify(accessJson).slice(0, 800)}`);',
-		'	return { refreshToken, accessToken, user };',
-		'}',
-		'async function seedAuth(page, auth) {',
-		'	await page.goto(clientUrl, { waitUntil: "domcontentloaded", timeout: 45000 });',
-		'	await page.evaluate((payload) => {',
-		'		localStorage.clear();',
-		'		sessionStorage.clear();',
-		'		localStorage.setItem("refreshToken", payload.refreshToken);',
-		'		localStorage.setItem("accessToken", payload.accessToken);',
-		'		localStorage.setItem("user", JSON.stringify({ ...(payload.user || {}), other: { ...((payload.user || {}).other || {}), tour_completed: true, took_tour: true }, settings: { ...((payload.user || {}).settings || {}), collapsable_menu: false, opening_route: payload.targetRoute } }));',
-		'		localStorage.setItem("lastURL", payload.targetRoute);',
-		'	}, { ...auth, targetRoute });',
-		'}',
-		'async function pageSummary(page) {',
-		'	return page.evaluate(() => {',
-		'		const bodyText = (document.body && document.body.innerText || "").replace(/\\s+/g, " ").trim();',
-		'		const rows = Array.from(document.querySelectorAll("tr")).map(row => (row.innerText || "").replace(/\\s+/g, " ").trim()).filter(Boolean);',
-		'		return { url: location.href, title: document.title, bodyTextSnippet: bodyText.slice(0, 1200), rowCount: rows.length, rows: rows.slice(0, 8), hasLoginText: /Employee\\/Customer Login|Employee Sign In|Customer Access|Unable to sign in/i.test(bodyText), hasOfflineModeText: bodyText.includes("*** OFFLINE MODE ***"), storageState: { hasRefreshToken: !!localStorage.getItem("refreshToken"), hasAccessToken: !!localStorage.getItem("accessToken"), hasUser: !!localStorage.getItem("user") } };',
-		'	});',
-		'}',
-		'function pathMatchesRoute(currentUrl, expectedRoute) {',
-		'	try {',
-		'		const current = new URL(currentUrl);',
-		'		const expected = new URL(expectedRoute, clientUrl);',
-		'		return current.pathname.replace(/\\/+$/, "") === expected.pathname.replace(/\\/+$/, "");',
-		'	} catch (error) {',
-		'		return false;',
-		'	}',
-		'}',
-		'async function waitForAuthenticatedApp(page) {',
-		'	await page.goto(`${clientUrl}/home`, { waitUntil: "domcontentloaded", timeout: 60000 });',
-		'	const deadline = Date.now() + Number(process.env.RESOLVEIO_RUNNER_QA_AUTH_WARMUP_TIMEOUT_MS || process.env.RESOLVEIO_SUPPORT_QA_AUTH_WARMUP_TIMEOUT_MS || 45000);',
-		'	let summary = await pageSummary(page);',
-		'	while (Date.now() < deadline) {',
-		'		summary = await pageSummary(page);',
-		'		if (!summary.hasLoginText && !summary.hasOfflineModeText && summary.storageState.hasRefreshToken && summary.storageState.hasAccessToken && summary.storageState.hasUser) {',
-		'			await delay(Number(process.env.RESOLVEIO_RUNNER_QA_POST_AUTH_SETTLE_MS || process.env.RESOLVEIO_SUPPORT_QA_POST_AUTH_SETTLE_MS || 2500));',
-		'			return await pageSummary(page);',
-		'		}',
-		'		await delay(1000);',
-		'	}',
-		'	throw new Error(`QA auth warmup failed before target route. Page summary: ${JSON.stringify(summary).slice(0, 1000)}`);',
-		'}',
-		'function isShellOnlySummary(summary) {',
-		'	const text = summary && summary.bodyTextSnippet || "";',
-		'	if (!text) return true;',
-		'	if (summary && Number(summary.rowCount || 0) > 0) return false;',
-		'	if (/\\b(List|Detail|Edit|New|Filter|Search|Showing|records|CLASSIFICATION|STATUS|Entries Per Page|Dashboard|Report|Invoice|Asset|BOL)\\b/i.test(text)) return false;',
-		'	return /^(Home|MENU|Logout|\\u00A9|The All-in-One Software)\\b/i.test(text) && text.length < 350;',
-		'}',
-		'function freshAuthBootstrapProof() {',
-		'	const proof = readJson(authBootstrapResultPath);',
-		'	if (!proof || proof.status !== "pass" || !proof.page) return null;',
-		'	if (!pathMatchesRoute(proof.page.url || "", targetRoute)) return null;',
-		'	if (proof.targetRoute && !pathMatchesRoute(new URL(proof.targetRoute, clientUrl).href, targetRoute)) return null;',
-		'	if (isShellOnlySummary(proof.page)) return null;',
-		'	const text = proof.page.bodyTextSnippet || "";',
-		'	if (!text || /Employee\\/Customer Login|Employee Sign In|Customer Access|Unable to sign in/i.test(text)) return null;',
-		'	if (text.includes("*** OFFLINE MODE ***")) return null;',
-		'	try {',
-		'		const stat = fs.statSync(authBootstrapResultPath);',
-		'		const maxAgeMs = Number(process.env.RESOLVEIO_RUNNER_QA_AUTH_PROOF_MAX_AGE_MS || process.env.RESOLVEIO_SUPPORT_QA_AUTH_PROOF_MAX_AGE_MS || 300000);',
-		'		if (Date.now() - stat.mtimeMs > maxAgeMs) return null;',
-		'	} catch (error) { return null; }',
-		'	return proof;',
-		'}',
-		'async function waitForHydratedTargetRoute(page) {',
-		'	const deadline = Date.now() + Number(process.env.RESOLVEIO_RUNNER_QA_ROUTE_HYDRATION_TIMEOUT_MS || process.env.RESOLVEIO_SUPPORT_QA_ROUTE_HYDRATION_TIMEOUT_MS || 45000);',
-		'	let summary = await pageSummary(page);',
-		'	while (Date.now() < deadline) {',
-		'		summary = await pageSummary(page);',
-		'		const routeOk = pathMatchesRoute(summary.url, targetRoute);',
-		'		const shellOnly = isShellOnlySummary(summary);',
-		'		if (routeOk && !summary.hasLoginText && !summary.hasOfflineModeText && !shellOnly) {',
-		'			return summary;',
-		'		}',
-		'		if (summary.hasLoginText || summary.hasOfflineModeText || !routeOk || shellOnly) {',
-		'			await delay(1500);',
-		'			await page.goto(new URL(targetRoute, clientUrl).href, { waitUntil: "domcontentloaded", timeout: 60000 }).catch(() => null);',
-		'		} else {',
-		'			await delay(1500);',
-		'		}',
-		'	}',
-		'	throw new Error(`QA route hydration failed for ${targetRoute}. Page summary: ${JSON.stringify(summary).slice(0, 1000)}`);',
-		'}',
-		'function billingDashboardHasVisibleWork(text) {',
-		'	const value = String(text || "");',
-		'	const patterns = [',
-		'		/PSO Type Invoice Awaiting Invoices, Customers: \\((\\d+)\\), Deliveries: \\((\\d+)\\)/i,',
-		'		/Deliveries Awaiting Invoices, Customers: \\((\\d+)\\), Treatments: \\((\\d+)\\)/i,',
-		'		/Truck Treatments Awaiting Invoices, Customers: \\((\\d+)\\), Treatments: \\((\\d+)\\)/i,',
-		'		/Periodic Billing, Customers: \\((\\d+)\\), Items: \\((\\d+)\\)/i,',
-		'		/Custom Consolidated Invoicing, Customers: \\((\\d+)\\), Items: \\((\\d+)\\)/i,',
-		'		/Processing, Customers: \\((\\d+)\\), Invoices: \\((\\d+)\\)/i,',
-		'		/Prepared, Customers: \\((\\d+)\\), Invoices: \\((\\d+)\\)/i,',
-		'		/Open Invoices, Customers: \\((\\d+)\\), Invoices: \\((\\d+)\\)/i',
-		'	];',
-		'	for (const pattern of patterns) {',
-		'		const match = pattern.exec(value);',
-		'		if (match && (Number(match[1]) > 0 || Number(match[2]) > 0)) return true;',
-		'	}',
-		'	return false;',
-		'}',
-		'async function waitForBillingDashboardWork(page) {',
-		'	if (!/\\/billing(?:$|[?#])|\\/dashboard\\/billing(?:$|[?#])/.test(targetRoute)) return null;',
-		'	const deadline = Date.now() + Number(process.env.RESOLVEIO_RUNNER_QA_BILLING_DATA_TIMEOUT_MS || process.env.RESOLVEIO_SUPPORT_QA_BILLING_DATA_TIMEOUT_MS || 45000);',
-		'	let summary = await pageSummary(page);',
-		'	while (Date.now() < deadline) {',
-		'		summary = await pageSummary(page);',
-		'		if (billingDashboardHasVisibleWork(summary.bodyTextSnippet)) return summary;',
-		'		await delay(1500);',
-		'	}',
-		'	throw new Error(`Billing Dashboard loaded but no actionable seeded billing rows became visible before QA handoff. This is a runner data-seeding blocker, not a feature failure. Page summary: ${JSON.stringify(summary).slice(0, 1000)}`);',
-		'}',
-		'function matrixRows(matrix) { return Array.isArray(matrix && matrix.rows) ? matrix.rows : []; }',
-		'function activeRowText() {',
-		'	const matrix = readJson(matrixPath) || {};',
-		'	const row = matrixRows(matrix).find((candidate) => !/^(pass|passed)$/i.test(String(candidate && candidate.status || ""))) || matrixRows(matrix)[0] || {};',
-		'	const rowText = [row.workflow, row.route, row.assertion, row.required_proof].map((value) => String(value || "")).join("\\n");',
-		'	return rowText.trim() ? rowText : readSeedHintText();',
-		'}',
-		'function readSeedAssetContext() {',
-		'	const seed = readJson(path.join(artifactDir, "qa-live-data-seed-result.json"));',
-		'	const context = seed && seed.selected && seed.selected.qa_asset_context;',
-		'	if (!context || !Array.isArray(context.asset_ids) || !context.asset_ids.length) return null;',
-		'	return context;',
-		'}',
-			'function depsCacheModuleCandidates(moduleName) {',
-			'	const roots = uniqueStrings([',
-			'		process.env.RESOLVEIO_RUNNER_QA_DEPS_CACHE_ROOT,',
-			'		process.env.RESOLVEIO_SUPPORT_QA_DEPS_CACHE_ROOT,',
-			'		path.join(projectRoot, ".deps-cache"),',
-			'		path.join(path.dirname(projectRoot), ".deps-cache"),',
-			'		path.join(path.dirname(path.dirname(projectRoot)), ".deps-cache"),',
-			'		"/var/app/resolveio-ai-workspace/.deps-cache/resolveio-all"',
-			'	]);',
-			'	const candidates = [];',
-			'	for (const root of roots) {',
-			'		try {',
-			'			if (!root || !fs.existsSync(root)) continue;',
-			'			for (const entry of fs.readdirSync(root)) {',
-			'				candidates.push(path.join(root, entry, "node_modules", moduleName));',
-			'				candidates.push(path.join(root, entry, "node_modules", "@resolveio", "server-lib", "node_modules", moduleName));',
-			'			}',
-			'		} catch (error) {}',
-			'	}',
-			'	return candidates;',
-			'}',
-			'function requireQaModule(moduleName) {',
-			'	const candidates = [',
-			'		path.join(projectRoot, "server", "node_modules", moduleName),',
-			'		path.join(projectRoot, "node_modules", moduleName),',
-			'		path.join(process.cwd(), "server", "node_modules", moduleName),',
-			'		path.join(process.cwd(), "node_modules", moduleName),',
-			'		...depsCacheModuleCandidates(moduleName),',
-			'		moduleName',
-			'	];',
-			'	for (const candidate of candidates) { try { return require(candidate); } catch (error) {} }',
-			'	throw new Error(`Unable to require ${moduleName} from project/server node_modules, QA dependency cache, or global resolution`);',
-			'}',
-			'function mongoRequire() { return requireQaModule("mongodb"); }',
-			'function xlsxRequire() { return requireQaModule("xlsx"); }',
-			'function localMongoUrl() {',
-			'	return process.env.MONGO_URL || process.env.RESOLVEIO_RUNNER_QA_MONGO_URL || process.env.RESOLVEIO_SUPPORT_QA_MONGO_URL || `mongodb://127.0.0.1:${process.env.RESOLVEIO_SUPPORT_QA_MONGO_PORT || "3001"}/resolveio?directConnection=true`;',
-			'}',
-			'function safeLocalMongoUrl() {',
-			'	const url = localMongoUrl();',
-			'	if (/^(true|1|yes|on)$/i.test(String(process.env.RESOLVEIO_SUPPORT_QA_ALLOW_NONLOCAL_MONGO_PROOF || process.env.RESOLVEIO_RUNNER_QA_ALLOW_NONLOCAL_MONGO_PROOF || ""))) return url;',
-			'	try {',
-			'		const parsed = new URL(url);',
-			'		const host = String(parsed.hostname || "").toLowerCase();',
-			'		if (host === "127.0.0.1" || host === "localhost" || host === "::1") return url;',
-			'	} catch (error) {}',
-			'	throw new Error(`Pricing import proof refuses to write to non-local Mongo URL: ${url.replace(/:[^:@/]+@/, ":***@")}`);',
-			'}',
-		'function assetDisplayNumber(asset) { return String(asset && (asset.unit_number || asset.asset_number || asset.number || asset.name || asset._id) || ""); }',
-		'function uniqueStrings(values) { return Array.from(new Set((values || []).map((value) => String(value || "").trim()).filter(Boolean))); }',
-		'function staleLocationTerms(text) {',
-		'	const terms = [];',
-		'	const value = String(text || "");',
-		'	const staleMatch = /stale\\s+([^.;\\n]+)/i.exec(value);',
-		'	if (staleMatch) {',
-		'		for (const part of staleMatch[1].split(/,?\\s+and\\s+|\\s+or\\s+|;/i)) {',
-		'			const clean = part.replace(/\\b(absent|are|is|old|name|names)\\b/ig, " ").replace(/\\s+/g, " ").trim();',
-		'			if (/\\b[A-Z][A-Za-z]+(?:ton|port|city|ville|field)?\\b.*\\b[A-Z]{2}\\b/.test(clean)) terms.push(clean);',
-		'		}',
-		'	}',
-		'	for (const fallback of ["Jourdanton, TX", "Schreveport, LA", "Shreveport, LA"]) {',
-		'		if (new RegExp(fallback.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test(value)) terms.push(fallback);',
-		'	}',
-		'	return uniqueStrings(terms);',
-		'}',
-		'async function fetchAssetLocationProofData(context) {',
-		'	const { MongoClient, ObjectId } = mongoRequire();',
-		'	const client = new MongoClient(localMongoUrl());',
-		'	await client.connect();',
-		'	try {',
-		'		const db = client.db();',
-		'		const assetIds = uniqueStrings(context.asset_ids);',
-		'		const assetNumbers = uniqueStrings(context.asset_numbers);',
-		'		const objectIds = assetIds.filter((id) => /^[a-f0-9]{24}$/i.test(id)).map((id) => new ObjectId(id));',
-		'		const query = { $or: [] };',
-		'		if (objectIds.length) query.$or.push({ _id: { $in: objectIds } });',
-		'		if (assetNumbers.length) query.$or.push({ unit_number: { $in: assetNumbers } }, { asset_number: { $in: assetNumbers } }, { number: { $in: assetNumbers } });',
-		'		const assets = query.$or.length ? await db.collection("assets").find(query).toArray() : [];',
-		'		const yardIds = uniqueStrings([...(context.yard_ids || []), ...assets.map((asset) => asset && asset.current_location && asset.current_location.id), ...assets.map((asset) => asset && asset.id_default_yard), ...assets.flatMap((asset) => Array.isArray(asset && asset.locations) ? asset.locations.map((location) => location && location.id) : [])]);',
-		'		const yardObjectIds = yardIds.filter((id) => /^[a-f0-9]{24}$/i.test(id)).map((id) => new ObjectId(id));',
-		'		const yardQuery = yardIds.length ? { $or: [{ _id: { $in: yardIds } }, ...(yardObjectIds.length ? [{ _id: { $in: yardObjectIds } }] : [])] } : null;',
-		'		const yards = yardQuery ? await db.collection("yards").find(yardQuery).toArray() : [];',
-		'		const yardById = new Map(yards.map((yard) => [String(yard._id), yard]));',
-		'		const rows = assets.map((asset) => {',
-		'			const currentId = asset && asset.current_location && asset.current_location.id ? String(asset.current_location.id) : "";',
-		'			const currentYard = currentId ? yardById.get(currentId) : null;',
-		'			const defaultYardName = String(asset.default_yard || "");',
-		'			const currentName = asset && asset.current_location && asset.current_location.name ? String(asset.current_location.name) : "";',
-		'			const canonicalName = currentYard && currentYard.name ? String(currentYard.name) : (defaultYardName || currentName);',
-		'			return { id: String(asset._id), number: assetDisplayNumber(asset), currentLocationId: currentId, currentLocationName: currentName, canonicalYardName: canonicalName, defaultYardId: String(asset.id_default_yard || ""), defaultYardName, pass: Boolean(canonicalName && currentName === canonicalName) };',
-		'		});',
-		'		return { assetIds, assetNumbers, rows, yards: yards.map((yard) => ({ id: String(yard._id), name: yard.name })) };',
-		'	} finally {',
-		'		await client.close().catch(() => undefined);',
-		'	}',
-		'}',
-		'async function gotoAndSummarize(page, route, screenshotName, requiredTerms = []) {',
-		'	await page.goto(new URL(route, clientUrl).href, { waitUntil: "domcontentloaded", timeout: 60000 });',
-		'	await page.waitForSelector("body", { timeout: 30000 });',
-		'	let summary = await pageSummary(page);',
-		'	const deadline = Date.now() + Number(process.env.RESOLVEIO_SUPPORT_QA_ROW_WAIT_MS || 20000);',
-		'	while (Date.now() < deadline) {',
-		'		summary = await pageSummary(page);',
-		'		const body = String(summary.bodyTextSnippet || "");',
-		'		const hasTerms = requiredTerms.filter(Boolean).every((term) => new RegExp(String(term).replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test(body));',
-		'		if (hasTerms && !isShellOnlySummary(summary)) break;',
-		'		await delay(750);',
-		'	}',
-		'	await delay(Number(process.env.RESOLVEIO_RUNNER_QA_SCREENSHOT_SETTLE_MS || process.env.RESOLVEIO_SUPPORT_QA_SCREENSHOT_SETTLE_MS || 1000));',
-		'	await page.keyboard.press("Escape").catch(() => undefined);',
-		'	await delay(750);',
-		'	summary = await pageSummary(page);',
-		'	const screenshot = path.join(artifactDir, screenshotName);',
-			'	await page.screenshot({ path: screenshot, type: "jpeg", quality: 82, fullPage: false });',
-			'	return { route, screenshot, summary };',
-			'}',
-			'function shouldRunPricingImportProof() {',
-			'	const seed = readJson(path.join(artifactDir, "qa-live-data-seed-result.json")) || {};',
-			'	if (String(seed.profile || "").toLowerCase() === "pricing_import") return true;',
-			'	const text = [activeRowText(), targetRoute].join("\\n");',
-			'	return /\\/manage\\/pricing(?:$|[/?#])/i.test(targetRoute) && /\\b(pricing|price|gross\\s+price|production\\s+price)\\b/i.test(text) && /\\b(import|upload|template|xlsx|excel|workbook|spreadsheet)\\b/i.test(text);',
-			'}',
-			'function pricingWorkbookDirs() {',
-			'	const repoRoot = path.dirname(projectRoot);',
-			'	return uniqueStrings([',
-			'		path.join(projectRoot, ".resolveio-context", "attachments"),',
-			'		path.join(projectRoot, ".resolveio-support-context", "attachments"),',
-			'		path.join(repoRoot, ".resolveio-context", "attachments"),',
-			'		path.join(repoRoot, ".resolveio-support-context", "attachments"),',
-			'		path.join(artifactDir, "attachments")',
-			'	]);',
-			'}',
-			'function collectPricingImportWorkbooks() {',
-			'	const byKey = new Map();',
-			'	for (const dir of pricingWorkbookDirs()) {',
-			'		try {',
-			'			if (!fs.existsSync(dir)) continue;',
-			'			for (const name of fs.readdirSync(dir)) {',
-			'				if (!/\\.xlsx$/i.test(name) || /^~\\$/.test(name)) continue;',
-			'				const fullPath = path.join(dir, name);',
-			'				const stat = fs.statSync(fullPath);',
-			'				if (!stat.isFile()) continue;',
-			'				const key = `${stat.size}:${name.replace(/[^a-z0-9]+/gi, "").toLowerCase()}`;',
-			'				if (!byKey.has(key)) byKey.set(key, fullPath);',
-			'			}',
-			'		} catch (error) {}',
-			'	}',
-			'	return Array.from(byKey.values()).sort();',
-			'}',
-			'function normalizeImportPriceRecord(line) {',
-			'	const source = line || {};',
-			'	const keyMap = {};',
-			'	for (const key of Object.keys(source)) keyMap[String(key).trim().toLowerCase().replace(/\\s+/g, " ")] = key;',
-			'	const getValue = (aliases) => { const alias = aliases.find((candidate) => keyMap[candidate] !== undefined); return alias ? source[keyMap[alias]] : undefined; };',
-			'	const normalized = {',
-			'		Customer: getValue(["customer"]),',
-			'		"Pricing Type": getValue(["pricing type", "type"]),',
-			'		Name: getValue(["name", "item", "chemical"]),',
-			'		Description: getValue(["description"]),',
-			'		"Gross Price": getValue(["gross price", "grossprice", "gross"]),',
-			'		"Discount Percent": getValue(["discount percent", "discount %", "discount", "discount percentage"]),',
-			'		Price: getValue(["price"])',
-			'	};',
-			'	if ((normalized["Gross Price"] === undefined || normalized["Gross Price"] === null || normalized["Gross Price"] === "") && normalized.Price !== undefined && normalized.Price !== null && normalized.Price !== "") normalized["Gross Price"] = normalized.Price;',
-			'	for (const key of Object.keys(normalized)) if (typeof normalized[key] === "string") normalized[key] = normalized[key].trim();',
-			'	return normalized;',
-			'}',
-			'function cleanNumber(value) { return String(value === undefined || value === null ? "" : value).trim().replace(/(\\$|,|\\s)/g, ""); }',
-			'function roundMoney(value) { return Math.round(Number(value || 0) * 100) / 100; }',
-			'function lowerTrim(value) { return String(value === undefined || value === null ? "" : value).toLowerCase().trim(); }',
-			'function idString(value) { return String(value && value.toHexString ? value.toHexString() : value || ""); }',
-			'function pricingSubType(pricingType) {',
-			'	const type = lowerTrim(pricingType);',
-			'	if (type === "chemical") return "chemical";',
-			'	if (type === "service") return "service";',
-			'	if (type === "misc") return "misc";',
-			'	return "";',
-			'}',
-			'async function readPricingImportContext(db) {',
-			'	const [customers, items, chemicals, users] = await Promise.all([',
-			'		db.collection("customers").find({}).project({ _id: 1, name: 1 }).toArray(),',
-			'		db.collection("items").find({}).project({ _id: 1, type: 1, name: 1, description: 1, id_chemical: 1 }).toArray(),',
-			'		db.collection("chemicals").find({}).project({ _id: 1, name: 1, description: 1, unit: 1, customers: 1 }).toArray(),',
-			'		db.collection("users").find({}).project({ _id: 1, fullname: 1, email: 1, username: 1 }).limit(5).toArray()',
-			'	]);',
-			'	return { customers, items, chemicals, user: users[0] || null };',
-			'}',
-			'function validatePricingImportRows(rawRows, context) {',
-			'	const validPriceRecords = [];',
-			'	const errorPriceRecords = [];',
-			'	const rows = rawRows.map((row, index) => ({ ...normalizeImportPriceRecord(row), __sourceRow: index + 2 }));',
-			'	for (const sample of rows) {',
-			'		const errors = [];',
-			'		const errorValues = [];',
-			'		sample.db_customer_id = "";',
-			'		sample.db_item_id = "";',
-			'		sample.db_chemical_id = "";',
-			'		sample.Customer = sample.Customer !== undefined && sample.Customer !== null ? String(sample.Customer).trim() : "";',
-			'		sample.Name = sample.Name !== undefined && sample.Name !== null ? String(sample.Name).trim() : "";',
-			'		sample.Description = sample.Description ? String(sample.Description).trim() : "";',
-			'		sample.Price = sample.Price !== undefined && sample.Price !== null ? String(sample.Price).trim() : "";',
-			'		if (sample.Customer) {',
-			'			const customer = context.customers.find((candidate) => lowerTrim(candidate.name) === lowerTrim(sample.Customer));',
-			'			if (customer) { sample.db_customer_id = idString(customer._id); sample.Customer = customer.name; }',
-			'			else if (sample.Customer === "Standard") sample.db_customer_id = "";',
-			'			else { errors.push("Customer not in the system"); errorValues.push(sample.Customer); }',
-			'		} else { errors.push("No Customer"); errorValues.push(sample.Customer); }',
-			'		if (!sample["Pricing Type"]) { errors.push("No Pricing Type"); errorValues.push(sample["Pricing Type"]); }',
-			'		else if (!/^(Chemical|Service|Misc)$/.test(String(sample["Pricing Type"]))) { errors.push("Invalid Pricing Type"); errorValues.push(sample["Pricing Type"]); }',
-			'		const item = sample.Name ? context.items.find((candidate) => lowerTrim(candidate.type) === lowerTrim(sample["Pricing Type"]) && lowerTrim(candidate.name) === lowerTrim(sample.Name)) : null;',
-			'		if (item) {',
-			'			sample.db_item_id = idString(item._id);',
-			'			sample.db_chemical_id = idString(item.id_chemical);',
-			'			sample.Name = item.name;',
-			'			sample.Description = item.description || sample.Description;',
-			'		} else if (sample.Name) { errors.push("Item not in the system"); errorValues.push(sample.Name); }',
-			'		else { errors.push("No Item"); errorValues.push(sample.Name); }',
-			'		const gross = cleanNumber(sample["Gross Price"]);',
-			'		if (gross) {',
-			'			if (!/^(\\d+\\.?\\d*|\\d*\\.?\\d+)$/.test(gross)) { errors.push("Price is not a valid number"); errorValues.push(gross); }',
-			'			else sample["Gross Price"] = gross;',
-			'		} else { errors.push("No Gross Price"); errorValues.push(sample["Gross Price"]); }',
-			'		const discount = cleanNumber(sample["Discount Percent"]);',
-			'		if (discount) {',
-			'			if (!/^(\\d+\\.?\\d*|\\d*\\.?\\d+)$/.test(discount)) { errors.push("Discount Percent is not a valid number"); errorValues.push(discount); }',
-			'			else sample["Discount Percent"] = discount;',
-			'		}',
-			'		if (errors.length) errorPriceRecords.push({ ...sample, errors, error_values: errorValues });',
-			'		else validPriceRecords.push(sample);',
-			'	}',
-			'	return { validPriceRecords, errorPriceRecords, totalRows: rawRows.length };',
-			'}',
-			'function buildPricingImportPayload(validRows, context, sourceWorkbook, proofBatchId) {',
-			'	const { ObjectId } = mongoRequire();',
-			'	const user = context.user || {};',
-			'	return validRows.map((priceRecord) => {',
-			'		const subType = pricingSubType(priceRecord["Pricing Type"]);',
-			'		const item = context.items.find((candidate) => idString(candidate._id) === String(priceRecord.db_item_id));',
-			'		const chemical = priceRecord.db_chemical_id ? context.chemicals.find((candidate) => idString(candidate._id) === String(priceRecord.db_chemical_id)) : null;',
-			'		const grossPriceValue = Number(cleanNumber(priceRecord["Gross Price"] !== undefined && priceRecord["Gross Price"] !== null && priceRecord["Gross Price"] !== "" ? priceRecord["Gross Price"] : priceRecord.Price));',
-			'		const discountPercentValue = Number(cleanNumber(priceRecord["Discount Percent"] || 0)) || 0;',
-			'		return {',
-			'			_id: new ObjectId().toHexString(),',
-			'			__v: 0,',
-			'			type: "sale",',
-			'			sub_type: subType,',
-			'			date: new Date(),',
-			'			id_user: idString(user._id) || "qa-support-runner",',
-			'			user: user.fullname || user.email || user.username || "QA Support Runner",',
-			'			id_item: idString(item && item._id) || priceRecord.db_item_id || "",',
-			'			name: subType === "chemical" && chemical ? chemical.name : priceRecord.Name,',
-			'			description: subType === "chemical" && chemical ? (chemical.description || "") : (priceRecord.Description || ""),',
-			'			id_customer: priceRecord.Customer === "Standard" ? "" : (priceRecord.db_customer_id || ""),',
-			'			customer: priceRecord.Customer === "Standard" ? "Standard" : (priceRecord.Customer || ""),',
-			'			customer_type: "Production",',
-			'			id_chemical: chemical ? idString(chemical._id) : "",',
-			'			chemical: chemical ? chemical.name : "",',
-			'			unit: chemical && chemical.unit ? chemical.unit : "Each",',
-			'			price_gross: grossPriceValue,',
-			'			discount_percent: discountPercentValue,',
-			'			price: roundMoney(grossPriceValue * (1 - discountPercentValue / 100)),',
-			'			qa_support_pricing_import_proof: true,',
-			'			qa_proof_batch_id: proofBatchId,',
-			'			qa_source_workbook: path.basename(sourceWorkbook),',
-			'			qa_source_row: priceRecord.__sourceRow,',
-			'			qa_inserted_at: new Date()',
-			'		};',
-			'	});',
-			'}',
-			'async function runPricingImportProof(page, routeSummary) {',
-			'	if (!shouldRunPricingImportProof()) return null;',
-			'	const proofPath = path.join(artifactDir, "qa-pricing-import-proof.json");',
-			'	const businessAssertionPath = path.join(artifactDir, "aiqa-business-assertion.json");',
-			'	const beforeAfterScreenshotPath = path.join(artifactDir, "support-business-proof-before-after.png");',
-			'	const startedAt = new Date().toISOString();',
-			'	const proofBatchId = `support-pricing-import-${Date.now()}-${Math.random().toString(16).slice(2)}`;',
-			'	const writePricingProof = (payload) => { writeJson(proofPath, payload); return payload; };',
-			'	const escapeHtml = (value) => String(value === undefined || value === null ? "" : value).replace(/[&<>"\']/g, (char) => { if (char === "&") return "&amp;"; if (char === "<") return "&lt;"; if (char === ">") return "&gt;"; if (char === "\\"") return "&quot;"; return "&#39;"; });',
-			'	const renderPricingProofScreenshot = async (payload, caption) => {',
-			'		const workbookRows = (payload.workbooks || []).map((entry) => `<tr><td>${escapeHtml(entry.name)}</td><td>${escapeHtml(entry.sheetName)}</td><td>${Number(entry.totalRows || 0)}</td><td class="ok">${Number(entry.validPriceRecords || 0)}</td><td>${Number(entry.errorPriceRecords || 0)}</td><td class="ok">${Number(entry.insertPricesFromImportPayloadSize || 0)}</td></tr>`).join("");',
-			'		const delta = payload.mongoDelta || {};',
-			'		const html = `<!doctype html><html><head><meta charset="utf-8"><style>body{margin:0;background:#f5f7fb;color:#111827;font-family:Arial,Helvetica,sans-serif}.wrap{padding:44px 56px}.eyebrow{font-size:18px;text-transform:uppercase;letter-spacing:1px;color:#475569;font-weight:700}.title{font-size:38px;font-weight:800;margin:10px 0 8px}.caption{font-size:22px;line-height:1.35;margin:0 0 26px;color:#1f2937}.grid{display:grid;grid-template-columns:1fr 1fr 1fr;gap:18px;margin:22px 0}.card{background:white;border:2px solid #d7dde8;border-radius:8px;padding:20px;min-height:118px}.label{font-size:16px;color:#64748b;font-weight:700;text-transform:uppercase}.value{font-size:34px;font-weight:800;margin-top:10px}.ok{color:#047857;font-weight:800}.warn{color:#b45309;font-weight:800}table{width:100%;border-collapse:collapse;background:white;border:2px solid #d7dde8;border-radius:8px;overflow:hidden;font-size:18px}th{background:#111827;color:white;text-align:left;padding:14px}td{border-top:1px solid #e5e7eb;padding:14px}.footer{margin-top:24px;font-size:18px;color:#475569}.path{font-family:Menlo,Consolas,monospace;font-size:15px;color:#334155}</style></head><body><main class="wrap"><div class="eyebrow">ResolveIO Support QA Business Proof</div><div class="title">Production Pricing Import Passed</div><p class="caption">${escapeHtml(caption)}</p><section class="grid"><div class="card"><div class="label">Action</div><div class="value">Import Proof</div></div><div class="card"><div class="label">Inserted Pricing Items</div><div class="value ok">${Number(payload.insertedCount || 0)}</div></div><div class="card"><div class="label">Mongo Total Delta</div><div class="value ok">${Number(delta.beforeTotalCount || 0)} -> ${Number(delta.afterTotalCount || 0)}</div></div></section><table><thead><tr><th>Workbook</th><th>Sheet</th><th>Total Rows</th><th>Valid Rows</th><th>Error Rows</th><th>Insert Payload</th></tr></thead><tbody>${workbookRows}</tbody></table><div class="footer">Before: pricing-items total ${Number(delta.beforeTotalCount || 0)}. Action: parsed attached workbooks through production import validation. After: pricing-items total ${Number(delta.afterTotalCount || 0)}, inserted ${Number(delta.inserted || 0)} QA proof records.</div><div class="footer path">Artifacts: qa-pricing-import-proof.json, aiqa-business-assertion.json, qa-coverage-matrix.json</div></main></body></html>`;',
-			'		await page.setViewport({ width: Math.max(viewportWidth, 1600), height: Math.max(viewportHeight, 900) }).catch(() => undefined);',
-			'		await page.setContent(html, { waitUntil: "domcontentloaded", timeout: 30000 });',
-			'		await page.screenshot({ path: beforeAfterScreenshotPath, type: "png", fullPage: false });',
-			'	};',
-			'	try {',
-			'		const workbookPaths = collectPricingImportWorkbooks();',
-			'		if (!workbookPaths.length) throw new Error("No attached pricing import .xlsx workbooks found in ResolveIO QA context attachments.");',
-			'		const xlsx = xlsxRequire();',
-			'		const { MongoClient } = mongoRequire();',
-			'		const client = new MongoClient(safeLocalMongoUrl());',
-			'		await client.connect();',
-			'		let payload;',
-			'		try {',
-			'			const db = client.db();',
-			'			const context = await readPricingImportContext(db);',
-			'			const workbookResults = [];',
-			'			const allInsertPayloads = [];',
-			'			for (const workbookPath of workbookPaths) {',
-			'				const workbook = xlsx.readFile(workbookPath, { cellDates: true });',
-			'				const sheetName = workbook.SheetNames.includes("Prices") ? "Prices" : workbook.SheetNames[0];',
-			'				const rows = sheetName ? xlsx.utils.sheet_to_json(workbook.Sheets[sheetName], { defval: "" }) : [];',
-			'				const validation = validatePricingImportRows(rows, context);',
-			'				const insertPayload = buildPricingImportPayload(validation.validPriceRecords, context, workbookPath, proofBatchId);',
-			'				allInsertPayloads.push(...insertPayload);',
-			'				workbookResults.push({',
-			'					workbook: workbookPath,',
-			'					name: path.basename(workbookPath),',
-			'					sheetName,',
-			'					totalRows: validation.totalRows,',
-			'					validPriceRecords: validation.validPriceRecords.length,',
-			'					errorPriceRecords: validation.errorPriceRecords.length,',
-			'					insertPricesFromImportPayloadSize: insertPayload.length,',
-			'					sampleValidRows: validation.validPriceRecords.slice(0, 5).map((row) => ({ sourceRow: row.__sourceRow, customer: row.Customer, pricingType: row["Pricing Type"], name: row.Name, grossPrice: row["Gross Price"], price: row.Price })),',
-			'					sampleErrors: validation.errorPriceRecords.slice(0, 5).map((row) => ({ sourceRow: row.__sourceRow, customer: row.Customer, pricingType: row["Pricing Type"], name: row.Name, errors: row.errors, error_values: row.error_values }))',
-			'				});',
-			'			}',
-			'			const blockedWorkbooks = workbookResults.filter((entry) => !entry.validPriceRecords || !entry.insertPricesFromImportPayloadSize);',
-			'			const pricingItems = db.collection("pricing-items");',
-			'			const beforeBatchCount = await pricingItems.countDocuments({ qa_support_pricing_import_proof: true, qa_proof_batch_id: proofBatchId });',
-			'			const beforeTotalCount = await pricingItems.countDocuments({});',
-			'			let insertResult = { insertedCount: 0, insertedIds: {} };',
-			'			if (!blockedWorkbooks.length && allInsertPayloads.length) insertResult = await pricingItems.insertMany(allInsertPayloads, { ordered: false });',
-			'			const afterBatchCount = await pricingItems.countDocuments({ qa_support_pricing_import_proof: true, qa_proof_batch_id: proofBatchId });',
-			'			const afterTotalCount = await pricingItems.countDocuments({});',
-			'			const insertedCount = Number(insertResult.insertedCount || 0);',
-			'			const pass = !blockedWorkbooks.length && allInsertPayloads.length > 0 && insertedCount === allInsertPayloads.length && afterBatchCount - beforeBatchCount === allInsertPayloads.length;',
-			'			const caption = pass ? `Pricing import proof passed: ${workbookResults.length} workbook(s), ${allInsertPayloads.length} valid row payload(s), ${insertedCount} local QA pricing-item insert(s).` : `Pricing import proof failed: ${blockedWorkbooks.length} workbook(s) had zero valid/importable rows or insert count did not match payload.`;',
-			'			payload = {',
-			'				status: pass ? "pass" : "failed",',
-			'				targetRoute,',
-			'				proofBatchId,',
-			'				startedAt,',
-			'				updated_at: new Date().toISOString(),',
-			'				workbooks: workbookResults,',
-			'				blockedWorkbooks: blockedWorkbooks.map((entry) => entry.name),',
-			'				validPriceRecords: workbookResults.reduce((sum, entry) => sum + entry.validPriceRecords, 0),',
-			'				errorPriceRecords: workbookResults.reduce((sum, entry) => sum + entry.errorPriceRecords, 0),',
-			'				insertPricesFromImportPayloadSize: allInsertPayloads.length,',
-			'				insertedCount,',
-			'				mongoDelta: { collection: "pricing-items", beforeBatchCount, afterBatchCount, beforeTotalCount, afterTotalCount, inserted: afterBatchCount - beforeBatchCount },',
-			'				screenshot: beforeAfterScreenshotPath,',
-			'				page: routeSummary',
-			'			};',
-			'			await renderPricingProofScreenshot(payload, caption).catch(() => undefined);',
-			'			writePricingProof(payload);',
-			'			const businessAssertion = {',
-			'				assertion: "Production pricing import validates every attached workbook, builds insertPricesFromImport payloads, and persists corresponding pricing-item records in local QA Mongo.",',
-			'				status: pass ? "pass" : "failed",',
-			'				result: pass ? "business_assertion_passed" : "business_assertion_failed",',
-			'				outcome: pass ? "business_assertion_passed" : "business_assertion_failed",',
-			'				workflow: "Upload each attached workbook through the production pricing import path or equivalent method path, record valid/error counts, insert payload size, and persisted pricing-items delta.",',
-			'				route: targetRoute,',
-			'				before: `Local QA pricing-items before proof batch ${proofBatchId}: ${beforeBatchCount}; total pricing-items before: ${beforeTotalCount}.`,',
-			'				action: `Parsed ${workbookResults.length} attached workbook(s), normalized rows with the production pricing import aliases, validated against local customers/items/chemicals, and inserted ${allInsertPayloads.length} QA-tagged pricing-item payload(s).`,',
-			'				expected: "Every attached workbook has non-zero validPriceRecords, non-zero insertPricesFromImport payload size, and matching local QA pricing-items insert delta.",',
-			'				after: `Local QA pricing-items after proof batch ${proofBatchId}: ${afterBatchCount}; total pricing-items after: ${afterTotalCount}; insertedCount=${insertedCount}.`,',
-			'				observed: caption,',
-			'				dataProof: workbookResults.map((entry) => `${entry.name}: totalRows=${entry.totalRows}, validPriceRecords=${entry.validPriceRecords}, errorPriceRecords=${entry.errorPriceRecords}, insertPricesFromImportPayloadSize=${entry.insertPricesFromImportPayloadSize}`).join("\\n"),',
-			'				mongoDelta: payload.mongoDelta,',
-			'				artifactPaths: [proofPath, beforeAfterScreenshotPath, matrixPath],',
-			'				metadata: { supportDiagnosisProof: pass, proofType: "pricing_import", methodPath: "server/src/methods/pricing.ts insertPricesFromImport", frontendPath: "angular/app/widgets/pricing/sale/production/viewcustomer/pricing-sale-production-viewcustomer.component.ts", proofBatchId, generatedBy: "resolveio_runner_pricing_import_business_proof", generatedAt: new Date().toISOString() }',
-			'			};',
-			'			writeJson(businessAssertionPath, businessAssertion);',
-			'			const matrix = readJson(matrixPath) || { status: "started", rows: [] };',
-			'			const rows = matrixRows(matrix);',
-			'			const rowIndex = rows.findIndex((candidate) => !/^(pass|passed)$/i.test(String(candidate && candidate.status || "")));',
-			'			const activeIndex = rowIndex >= 0 ? rowIndex : 0;',
-			'			if (rows[activeIndex]) {',
-			'				rows[activeIndex].status = pass ? "pass" : "failed";',
-			'				rows[activeIndex].result = pass ? "pass" : "failed";',
-			'				rows[activeIndex].acceptance_blocked = !pass;',
-			'				rows[activeIndex].screenshot = beforeAfterScreenshotPath;',
-			'				rows[activeIndex].screenshots = [beforeAfterScreenshotPath, passScreenshotPath].filter(Boolean);',
-			'				rows[activeIndex].caption = caption;',
-			'				rows[activeIndex].artifact = proofPath;',
-			'				rows[activeIndex].artifacts = [{ route: targetRoute, screenshot: beforeAfterScreenshotPath, caption }, { path: proofPath, caption: "Pricing import workbook validation and Mongo delta proof." }, { path: businessAssertionPath, caption: "AIQaBusinessAssertion for support diagnosis proof plan." }];',
-			'				rows[activeIndex].persisted_assertion = `Local QA Mongo pricing-items delta=${payload.mongoDelta.inserted}; payloadSize=${allInsertPayloads.length}; insertedCount=${insertedCount}.`;',
-			'				if (!pass) rows[activeIndex].blocker = caption;',
-			'			}',
-			'			matrix.rows = rows;',
-			'			matrix.status = pass ? "pass" : "failed";',
-			'			matrix.pricing_import_proof = proofPath;',
-			'			matrix.aiqa_business_assertion = businessAssertionPath;',
-			'			matrix.updated_at = new Date().toISOString();',
-			'			writeJson(matrixPath, matrix);',
-			'			return payload;',
-			'		} finally {',
-			'			await client.close().catch(() => undefined);',
-			'		}',
-			'	} catch (error) {',
-			'		const message = error && (error.stack || error.message) || String(error);',
-			'		const payload = writePricingProof({ status: "failed", targetRoute, proofBatchId, startedAt, updated_at: new Date().toISOString(), error: message });',
-			'		writeJson(businessAssertionPath, { assertion: "Production pricing import workbook proof", status: "failed", result: "business_assertion_failed", outcome: "business_assertion_failed", workflow: "Pricing import business proof", route: targetRoute, before: "", action: "Attempted deterministic pricing import proof.", expected: "Workbook validation and local QA Mongo pricing-items insert delta.", after: "", observed: message, dataProof: message, mongoDelta: {}, artifactPaths: [proofPath, matrixPath], metadata: { supportDiagnosisProof: false, proofType: "pricing_import", generatedBy: "resolveio_runner_pricing_import_business_proof", generatedAt: new Date().toISOString() } });',
-			'		const matrix = readJson(matrixPath) || { status: "started", rows: [] };',
-			'		const rows = matrixRows(matrix);',
-			'		if (rows[0]) { rows[0].status = "failed"; rows[0].result = "failed"; rows[0].acceptance_blocked = true; rows[0].blocker = message; rows[0].artifact = proofPath; }',
-			'		matrix.rows = rows;',
-			'		matrix.status = "failed";',
-			'		matrix.pricing_import_proof = proofPath;',
-			'		matrix.aiqa_business_assertion = businessAssertionPath;',
-			'		matrix.updated_at = new Date().toISOString();',
-			'		writeJson(matrixPath, matrix);',
-			'		return payload;',
-			'	}',
-			'}',
-			'async function runAssetLocationRowProof(page, routeSummary) {',
-		'	const rowText = activeRowText();',
-		'	const context = readSeedAssetContext();',
-		'	if (!context || !/asset|unit|yard|location|current\\s+location/i.test(rowText)) return null;',
-		'	const proofPath = path.join(artifactDir, "qa-asset-location-proof.json");',
-		'	const staleTerms = staleLocationTerms(rowText);',
-		'	const data = await fetchAssetLocationProofData(context);',
-		'	const expectedNumbers = uniqueStrings(context.asset_numbers).filter((value) => /^\\d+[A-Za-z-]*$/.test(value));',
-		'	const missingNumbers = expectedNumbers.filter((number) => !data.rows.some((row) => row.number === number));',
-		'	const mismatchedRows = data.rows.filter((row) => !row.pass);',
-		'	if (expectedNumbers.length) {',
-		'		await page.goto(new URL(targetRoute, clientUrl).href, { waitUntil: "domcontentloaded", timeout: 60000 }).catch(() => undefined);',
-		'		await page.waitForFunction((numbers) => {',
-		'			const text = document.body ? document.body.innerText || "" : "";',
-		'			return numbers.every((number) => new RegExp(`\\\\b${String(number).replace(/[.*+?^${}()|[\\\\]\\\\\\\\]/g, "\\\\\\\\$&")}\\\\b`).test(text));',
-		'		}, { timeout: Number(process.env.RESOLVEIO_SUPPORT_QA_ROW_WAIT_MS || 15000) }, expectedNumbers).catch(() => undefined);',
-		'		routeSummary = await pageSummary(page);',
-		'		await page.screenshot({ path: passScreenshotPath, type: "jpeg", quality: 82, fullPage: false }).catch(() => undefined);',
-		'	}',
-		'	const listText = String((routeSummary && routeSummary.bodyTextSnippet) || "");',
-		'	const listMissing = expectedNumbers.filter((number) => !new RegExp(`\\\\b${number.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&")}\\\\b`).test(listText));',
-		'	const staleSeen = staleTerms.filter((term) => new RegExp(term.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test(listText) || data.rows.some((row) => new RegExp(term.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test([row.currentLocationName, row.defaultYardName].join(" "))));',
-		'	const artifacts = [];',
-		'	if (routeSummary) artifacts.push({ route: targetRoute, screenshot: passScreenshotPath, caption: `Asset list shows ${expectedNumbers.join(", ")} with canonical yard names and no stale yard labels.` });',
-		'	for (const row of data.rows) {',
-		'		const requiredTerms = [row.number || row.id, row.canonicalYardName || row.currentLocationName].filter(Boolean);',
-		'		const detail = await gotoAndSummarize(page, `/asset/detail/${row.id}`, `asset-location-detail-${row.number || row.id}.jpg`, requiredTerms);',
-		'		const edit = await gotoAndSummarize(page, `/asset/edit/${row.id}`, `asset-location-edit-${row.number || row.id}.jpg`, requiredTerms);',
-		'		const detailBody = String(detail.summary.bodyTextSnippet || "");',
-		'		const editBody = String(edit.summary.bodyTextSnippet || "");',
-		'		const detailHasProof = requiredTerms.every((term) => new RegExp(String(term).replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test(detailBody)) && !isShellOnlySummary(detail.summary);',
-		'		const editHasProof = requiredTerms.every((term) => new RegExp(String(term).replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&"), "i").test(editBody)) && !isShellOnlySummary(edit.summary);',
-		'		if (detailHasProof) artifacts.push({ route: detail.route, screenshot: detail.screenshot, caption: `Asset ${row.number || row.id} detail shows canonical yard ${row.canonicalYardName || row.currentLocationName}.`, bodyTextSnippet: detail.summary.bodyTextSnippet });',
-		'		if (editHasProof) artifacts.push({ route: edit.route, screenshot: edit.screenshot, caption: `Asset ${row.number || row.id} edit screen opens with canonical yard ${row.canonicalYardName || row.currentLocationName} selected/visible.`, bodyTextSnippet: edit.summary.bodyTextSnippet });',
-		'		if (!detailHasProof || !editHasProof) mismatchedRows.push({ ...row, proofMissing: `${!detailHasProof ? "detail" : ""}${!detailHasProof && !editHasProof ? "," : ""}${!editHasProof ? "edit" : ""}` });',
-		'	}',
-		'	const pass = !missingNumbers.length && !mismatchedRows.length && !listMissing.length && !staleSeen.length && data.rows.length >= Math.max(expectedNumbers.length, 1);',
-		'	const payload = { status: pass ? "pass" : "failed", targetRoute, expectedNumbers, staleTerms, missingNumbers, listMissing, staleSeen, mismatchedRows, dataRows: data.rows, artifacts, updated_at: new Date().toISOString() };',
-		'	writeJson(proofPath, payload);',
-		'	const matrix = readJson(matrixPath) || { status: "started", rows: [] };',
-		'	const rows = matrixRows(matrix);',
-		'	const rowIndex = rows.findIndex((candidate) => !/^(pass|passed)$/i.test(String(candidate && candidate.status || "")));',
-		'	const activeIndex = rowIndex >= 0 ? rowIndex : 0;',
-		'	if (rows[activeIndex]) {',
-		'		rows[activeIndex].status = pass ? "pass" : "failed";',
-		'		rows[activeIndex].result = pass ? "pass" : "failed";',
-		'		rows[activeIndex].screenshot = artifacts[0] && artifacts[0].screenshot || passScreenshotPath;',
-		'		rows[activeIndex].screenshots = artifacts.map((artifact) => artifact.screenshot).filter(Boolean);',
-		'		rows[activeIndex].caption = pass ? `Verified exact assets ${expectedNumbers.join(", ")} use canonical yard names ${uniqueStrings(data.rows.map((row) => row.canonicalYardName)).join(", ")} on list/detail/edit screens; stale names ${staleTerms.join(", ") || "from the ticket"} are absent.` : `Asset location QA failed: missing=${missingNumbers.join(",") || "none"} listMissing=${listMissing.join(",") || "none"} staleSeen=${staleSeen.join(",") || "none"} mismatched=${mismatchedRows.map((row) => row.number).join(",") || "none"}.`;',
-		'		rows[activeIndex].artifact = proofPath;',
-		'		rows[activeIndex].artifacts = artifacts;',
-		'		rows[activeIndex].persisted_assertion = `Local QA Mongo joined ${data.rows.length} asset(s) to yards; ${data.rows.map((row) => `${row.number}:${row.currentLocationName}->${row.canonicalYardName}`).join("; ")}`;',
-		'		if (!pass) rows[activeIndex].blocker = rows[activeIndex].caption;',
-		'	}',
-		'	matrix.rows = rows;',
-		'	matrix.status = pass ? "pass" : "failed";',
-		'	matrix.asset_location_proof = proofPath;',
-		'	matrix.updated_at = new Date().toISOString();',
-		'	writeJson(matrixPath, matrix);',
-		'	return payload;',
-		'}',
-		'function updateMatrix(status, screenshotPath, caption, assertion) {',
-		'	const matrix = readJson(matrixPath) || { status: "started", rows: [] };',
-		'	const routeProbePassed = status === "route_probe_pass" || status === "pass";',
-		'	const matrixStatus = status === "route_probe_pass" ? "in_progress" : status;',
-		'	matrix.workflow_probe = { status, outcome: status === "route_probe_pass" ? "route_only_pass" : status, route: targetRoute, screenshot: screenshotPath, caption, assertion, acceptance_blocked: status === "route_probe_pass", updated_at: new Date().toISOString() };',
-		'	matrix.updated_at = new Date().toISOString();',
-		'	const rows = Array.isArray(matrix.rows) ? matrix.rows : [];',
-		'	if (rows[0]) {',
-		'		rows[0].route_probe = { status: routeProbePassed ? "pass" : status, outcome: status === "route_probe_pass" ? "route_only_pass" : status, route: targetRoute, screenshot: screenshotPath, caption, assertion, acceptance_blocked: status === "route_probe_pass", updated_at: matrix.updated_at };',
-		'		if (!routeProbePassed) { rows[0].status = "blocked"; rows[0].screenshot = screenshotPath; rows[0].caption = caption; }',
-		'		else if (!rows[0].status || rows[0].status === "pending") { rows[0].status = "in_progress"; rows[0].result = "in_progress"; rows[0].acceptance_blocked = true; rows[0].blocker = "Route probe passed, but issue-specific business assertions are still required before acceptance."; }',
-		'	}',
-		'	matrix.rows = rows;',
-		'	if (!matrix.status || matrix.status === "started" || matrix.status === "pending") matrix.status = matrixStatus;',
-		'	writeJson(matrixPath, matrix);',
-		'}',
-		'',
-		'(async () => {',
-		'	fs.mkdirSync(artifactDir, { recursive: true });',
-		'	const puppeteer = requirePuppeteer();',
-		'	const browser = await launchBrowser(puppeteer);',
-		'	let page;',
-		'	try {',
-		'		await waitForHttpReady(clientUrl, "QA client");',
-		'		await waitForHttpReady(serverUrl, "QA server");',
-		'		page = await browser.newPage();',
-		'		await page.setViewport({ width: viewportWidth, height: viewportHeight });',
-		'		const auth = await login();',
-		'		await seedAuth(page, auth);',
-		'		await waitForAuthenticatedApp(page);',
-		'		await page.goto(`${clientUrl}${targetRoute}`, { waitUntil: "domcontentloaded", timeout: 60000 });',
-		'		await page.waitForSelector("body", { timeout: 30000 });',
-		'		let summary = await waitForHydratedTargetRoute(page);',
-		'		if (summary.hasLoginText || summary.hasOfflineModeText || !summary.bodyTextSnippet) throw new Error(`Workflow route did not reach authenticated app: ${JSON.stringify(summary).slice(0, 1000)}`);',
-		'		summary = await waitForBillingDashboardWork(page) || summary;',
-		'		const caption = `Workflow route ready: ${targetRoute} loaded in authenticated local QA with live seeded data available.`;',
-		'		await page.screenshot({ path: passScreenshotPath, type: "jpeg", quality: 82, fullPage: false });',
-		'		updateMatrix("route_probe_pass", passScreenshotPath, caption, "Authenticated customer workflow route loaded; deeper row-specific UI/data proof still required.");',
-			'		let specializedProof = await runPricingImportProof(page, summary);',
-			'		let specializedProofPath = specializedProof ? path.join(artifactDir, "qa-pricing-import-proof.json") : "";',
-			'		let specializedProofLabel = specializedProof ? "Pricing import workbook business proof" : "";',
-			'		if (!specializedProof) {',
-			'			specializedProof = await runAssetLocationRowProof(page, summary);',
-			'			specializedProofPath = specializedProof ? path.join(artifactDir, "qa-asset-location-proof.json") : "";',
-			'			specializedProofLabel = specializedProof ? "Asset location list/detail/edit business proof" : "";',
-			'		}',
-			'		if (specializedProof && specializedProof.status !== "pass") {',
-			'			const result = { status: "failed", clientUrl, serverUrl, targetRoute, screenshot: passScreenshotPath, caption: `${specializedProofLabel || "Specialized business proof"} failed; see ${path.basename(specializedProofPath)}.`, page: summary, matrix: matrixPath, specializedProof: specializedProofPath };',
-			'			writeJson(resultPath, result);',
-			'			console.error(JSON.stringify(result, null, 2));',
-			'			process.exitCode = 1;',
-			'			return;',
-			'		}',
-			'		const result = { status: specializedProof ? "pass" : "route_probe_pass", outcome: specializedProof ? "business_assertion_passed" : "route_only_pass", acceptance_blocked: !specializedProof, clientUrl, serverUrl, targetRoute, screenshot: passScreenshotPath, caption: specializedProof ? `${specializedProofLabel} passed with issue-specific data proof.` : caption, page: summary, matrix: matrixPath, specializedProof: specializedProofPath };',
-		'		writeJson(resultPath, result);',
-		'		console.log(JSON.stringify(result, null, 2));',
-		'	} catch (error) {',
-		'		let summary = null;',
-		'		try { if (page) { await page.screenshot({ path: failScreenshotPath, type: "jpeg", quality: 82, fullPage: false }); summary = await pageSummary(page); } } catch (screenshotError) {}',
-		'		if (summary && pathMatchesRoute(summary.url, targetRoute) && !summary.hasLoginText && !summary.hasOfflineModeText && !isShellOnlySummary(summary)) {',
-		'			const caption = `Workflow route ready after late hydration: ${targetRoute} loaded in authenticated local QA with live seeded data available.`;',
-		'			try { if (page) await page.screenshot({ path: passScreenshotPath, type: "jpeg", quality: 82, fullPage: false }); } catch (screenshotError) {}',
-		'			updateMatrix("route_probe_pass", passScreenshotPath, caption, "Authenticated customer workflow route loaded after transient offline/shell state; deeper row-specific UI/data proof still required.");',
-		'			const result = { status: "route_probe_pass", outcome: "route_only_pass", acceptance_blocked: true, clientUrl, serverUrl, targetRoute, screenshot: passScreenshotPath, caption, recoveredFromTransientError: error && (error.message || String(error)) || "late hydration", page: summary, matrix: matrixPath };',
-		'			writeJson(resultPath, result);',
-		'			console.log(JSON.stringify(result, null, 2));',
-		'			process.exitCode = 0;',
-		'			return;',
-		'		}',
-		'		const bootstrapProof = freshAuthBootstrapProof();',
-		'		if (bootstrapProof) {',
-		'			const caption = `Workflow route ready from authenticated bootstrap proof: ${targetRoute} loaded for the seeded QA user with live data before a transient probe shell state.`;',
-		'			updateMatrix("route_probe_pass", bootstrapProof.screenshot || passScreenshotPath, caption, "Authenticated bootstrap proof loaded the exact target route with live seeded data; deeper row-specific UI/data proof still required.");',
-		'			const result = { status: "route_probe_pass", outcome: "route_only_pass", acceptance_blocked: true, clientUrl, serverUrl, targetRoute, screenshot: bootstrapProof.screenshot || passScreenshotPath, caption, recoveredFromTransientError: error && (error.message || String(error)) || "bootstrap proof recovery", page: bootstrapProof.page, authBootstrapProof: authBootstrapResultPath, matrix: matrixPath };',
-		'			writeJson(resultPath, result);',
-		'			console.log(JSON.stringify(result, null, 2));',
-		'			process.exitCode = 0;',
-		'			return;',
-		'		}',
-		'		const caption = `Blocked before workflow QA: ${targetRoute} could not be reached in authenticated local QA.`;',
-		'		updateMatrix("blocked", failScreenshotPath, caption, error && (error.message || String(error)) || "Workflow probe failed");',
-		'		const result = { status: "blocked", clientUrl, serverUrl, targetRoute, screenshot: failScreenshotPath, caption, error: error && (error.stack || error.message) || String(error), page: summary, matrix: matrixPath };',
-		'		writeJson(resultPath, result);',
-		'		console.error(JSON.stringify(result, null, 2));',
-		'		process.exitCode = 1;',
-		'	} finally {',
-		'		await browser.close().catch(() => undefined);',
-		'		process.exit(process.exitCode || 0);',
-		'	}',
-		'})();',
-		''
-	].join('\n');
-}
-
-export function buildResolveIORunnerQaToolsReadme(options: ResolveIORunnerQaToolBundleOptions = {}): string {
-	const mode = options.mode || 'runner';
-	const toolsDir = mode === 'support' ? '.resolveio-support-tools' : '.resolveio-ai-runner-tools';
-	const port = normalizePort(options.qaClientPort, '4200');
-	const clientUrlVar = envVar(mode, 'CLIENT_URL');
-	const keepaliveVar = envVar(mode, 'KEEPALIVE');
-	const usernameVar = envVar(mode, 'USERNAME');
-	const passwordVar = envVar(mode, 'PASSWORD');
-	return [
-		`# ResolveIO ${mode === 'support' ? 'Support' : 'AI Runner'} Local QA Tools`,
-		'',
-		'These scripts are generated by `@resolveio/server-lib` and are shared by support tickets, AICoder app-builder runs, and AI-terminal runs.',
-		'',
-		'```bash',
-		`source ${toolsDir}/env.sh`,
-		`node ${toolsDir}/qa-preflight.js <project-root>`,
-		`${toolsDir}/run-local-qa.sh <project-root>`,
-		`node ${toolsDir}/qa-live-data-seed.js <project-root>`,
-		`node ${toolsDir}/qa-auth-bootstrap.js <project-root> /target-route`,
-		`node ${toolsDir}/qa-workflow-probe.js <project-root> /target-route`,
-		`${toolsDir}/bugfix-comparison-qa.sh <project-root> origin/master -- bash -lc '<same QA command>'`,
-		'```',
-		'',
-		`This workspace reserves Angular QA client port ${port}; use \`$${clientUrlVar}\` instead of assuming 4200 is free.`,
-		'The local QA runner starts server/client, polls the reserved client URL, writes `qa-artifacts/server.log` and `qa-artifacts/client.log`, and fails fast on fatal startup/runtime errors.',
-		'Run `qa-preflight.js` before spending another model repair cycle when QA is failing. It checks Node/npm, package scripts, runtime settings, Puppeteer require resolution, staged Chrome executability, and browser launch, then writes `qa-artifacts/qa-preflight-result.json` with `infra_passed` or `infra_failed`.',
-		'The shared auth bootstrap first opens the exact localhost client origin, logs out any visible stale session, clears service workers/cache/IndexedDB/local/session storage, then calls `/login` and `/accessToken`, seeds `refreshToken`, `accessToken`, `user`, and `lastURL`, and writes `qa-artifacts/auth-bootstrap-result.json` plus a ready/failure screenshot.',
-		'The shared workflow probe logs in with the same local QA account, opens the target customer route, captures an email-safe desktop JPEG, and updates `qa-artifacts/qa-coverage-matrix.json` without falsely marking row-specific business assertions as passed.',
-		`For browser clickthrough work, start the runner once with \`${keepaliveVar}=true ${toolsDir}/run-local-qa.sh <project-root>\`; it detaches after the app is ready, and later calls should reuse \`$${clientUrlVar}\` for all login/upload/screenshot retries. Do not restart Angular for auth failures.`,
-		'Do not wait for `networkidle0` or `networkidle2` in ResolveIO browser QA. Use `domcontentloaded`, then wait for route/workflow-specific DOM text, buttons, rows, dialogs, saved records, or persisted data assertions.',
-		'Do not use version-fragile browser helpers such as `page.$x` or `page.waitForTimeout`; use DOM traversal/locator-compatible helpers and a local `delay(ms)` promise helper, then rerun the same matrix row if the QA script itself fails.',
-		'Do not run `npm run build-dev`, `ng build`, or another Angular compile while keepalive `ng serve` is running. If a full Angular build is required after browser QA, first run the staged `stop-local-qa.sh`, then build, then restart `run-local-qa.sh` for final browser proof.',
-		'Use desktop screenshots at 1920x1080 by default unless the task is explicitly mobile/responsive. Every screenshot must have a customer-facing caption.',
-		'For From/To, source/target, dropdown, combobox, rio-select, filter, item, customer, yard, chemical, or treatment-plan selection workflows, capture pass screenshots only after the selected values are visible in the controls/chips/labels. The QA matrix data/assertion/caption must name the selected values; empty controls, placeholder text, or route-load screenshots are blocker evidence, not pass evidence.',
-		'For import/export/form-submit/data workflows, prove before/action/after with representative data and a concrete row/count/value assertion.',
-		'For pricing import/upload bugs, drive the actual Manage Pricing browser import for the attached/template variants and assert localhost Mongo pricing row/count/value changes. Validator-only proof must fail.',
-		'For asset location/current-yard bugs, prove the exact asset/unit on list, detail, and edit/save screens, with a joined/canonical yard assertion and stale yard name absence proof.',
-		'For Update Interchangeables/Mass Update chemical bugs, select the real source and target chemicals, run the update, and assert before/after treatment-plan/tank document counts or ids in localhost Mongo. Route-load or dropdown-only proof must fail.',
-		'For data-backed workflows, run `qa-live-data-seed.js` after the local app is ready and before browser clickthrough. It reads a bounded live-data slice from `RESOLVEIO_QA_LIVE_MONGO_URL` or staged mongo context, writes only to localhost QA Mongo, prefers ticket-mentioned invoice/BOL/order/ticket identifiers, and records `qa-artifacts/qa-live-data-seed-result.json`.',
-		'For support-ticket QA, use the ticket reporter or named affected user when the live seed can identify/copy that user. `qa-live-data-seed-result.json.selected.qa_user_context` and `auth-bootstrap-result.json.user` must agree, or the row is not ready to pass.',
-		'For customer-reported data bugs, QA must seed and prove the exact named production records in local QA. If the exact unit/BOL/invoice/chemical/customer/yard/user is missing, fail with a seed/query blocker instead of switching to a representative record.',
-		'For bug fixes, use `bugfix-comparison-qa.sh` so baseline/master runs the exact same repro before the candidate/PR run. A passing candidate is not enough unless the comparison result shows baseline failed or the report explicitly explains why the baseline failure could not be reproduced.',
-		`Use \`$${usernameVar}\` and \`$${passwordVar}\` for the local fixture admin account unless ticket/app-specific credentials are provided.`,
-		'The env file reuses `/var/lib/resolveio/puppeteer`, npm cache, worker-safe Browserslist settings, and Angular cache prep so QA should not download a browser or rebuild cold caches unnecessarily.',
-		mode === 'support'
-			? 'Support workspaces also stage local `mongod` and `mongosh` wrappers so app server scripts can start MongoDB when the worker image does not have MongoDB installed.'
-			: '',
-		''
-	].filter((line) => line !== '').join('\n');
-}