@resolveio/server-lib 22.3.49 → 22.3.50

package/util/ai-runner-qa-tools.js

@@ -1,635 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildResolveIORunnerQaEnvScript = buildResolveIORunnerQaEnvScript;
-exports.buildResolveIORunnerLocalQaScript = buildResolveIORunnerLocalQaScript;
-exports.buildResolveIORunnerLocalQaStopperScript = buildResolveIORunnerLocalQaStopperScript;
-exports.buildResolveIORunnerBugfixComparisonQaScript = buildResolveIORunnerBugfixComparisonQaScript;
-exports.buildResolveIORunnerQaToolsReadme = buildResolveIORunnerQaToolsReadme;
-function shellDoubleQuote(value) {
-    return String(value || '').replace(/["\\$`]/g, '\\$&');
-}
-function normalizePort(value, fallback) {
-    var parsed = Number.parseInt(String(value || ''), 10);
-    return Number.isFinite(parsed) && parsed > 0 ? String(parsed) : fallback;
-}
-function envVar(mode, suffix) {
-    return mode === 'support' ? "RESOLVEIO_SUPPORT_QA_".concat(suffix) : "RESOLVEIO_RUNNER_QA_".concat(suffix);
-}
-function buildResolveIORunnerQaEnvScript(options) {
-    if (options === void 0) { options = {}; }
-    var mode = options.mode || 'runner';
-    var altMode = mode === 'support' ? 'runner' : 'support';
-    var tmpRoot = options.tmpRoot || (mode === 'support' ? '/tmp/resolveio-support-qa' : '/tmp/resolveio-ai-runner-qa');
-    var homeRoot = options.homeRoot || "".concat(tmpRoot, "/home");
-    var defaultPort = normalizePort(options.qaClientPort, '4200');
-    var username = shellDoubleQuote(options.defaultUsername || 'admin');
-    var password = shellDoubleQuote(options.defaultPassword || '');
-    var toolsBinPath = options.toolsBinPath || '';
-    var browserslistPath = options.browserslistPath || '';
-    var mongodbBinaryCachePath = options.mongodbBinaryCachePath || '';
-    var clientPortVar = envVar(mode, 'CLIENT_PORT');
-    var altClientPortVar = envVar(altMode, 'CLIENT_PORT');
-    var clientUrlVar = envVar(mode, 'CLIENT_URL');
-    var altClientUrlVar = envVar(altMode, 'CLIENT_URL');
-    var serverUrlVar = envVar(mode, 'SERVER_URL');
-    var altServerUrlVar = envVar(altMode, 'SERVER_URL');
-    var usernameVar = envVar(mode, 'USERNAME');
-    var altUsernameVar = envVar(altMode, 'USERNAME');
-    var passwordVar = envVar(mode, 'PASSWORD');
-    var altPasswordVar = envVar(altMode, 'PASSWORD');
-    var viewportWidthVar = envVar(mode, 'VIEWPORT_WIDTH');
-    var altViewportWidthVar = envVar(altMode, 'VIEWPORT_WIDTH');
-    var viewportHeightVar = envVar(mode, 'VIEWPORT_HEIGHT');
-    var altViewportHeightVar = envVar(altMode, 'VIEWPORT_HEIGHT');
-    var timeoutVar = envVar(mode, 'ANGULAR_STARTUP_TIMEOUT_SECONDS');
-    var altTimeoutVar = envVar(altMode, 'ANGULAR_STARTUP_TIMEOUT_SECONDS');
-    var prebundleVar = envVar(mode, 'ANGULAR_PREBUNDLE');
-    var altPrebundleVar = envVar(altMode, 'ANGULAR_PREBUNDLE');
-    var reuseVar = envVar(mode, 'REUSE_RUNNING');
-    var altReuseVar = envVar(altMode, 'REUSE_RUNNING');
-    var keepaliveVar = envVar(mode, 'KEEPALIVE');
-    var altKeepaliveVar = envVar(altMode, 'KEEPALIVE');
-    var browserLoopVar = mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_BROWSER' : 'RESOLVEIO_RUNNER_QA_BROWSER';
-    return [
-        "export ".concat(mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP', "=\"").concat('${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP') + ':-' + tmpRoot + '}', "\""),
-        "export ".concat(mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME', "=\"").concat('${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME') + ':-' + homeRoot + '}', "\""),
-        "RESOLVEIO_QA_TMP=\"".concat('${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_TMP' : 'RESOLVEIO_RUNNER_QA_TMP') + '}', "\""),
-        "RESOLVEIO_QA_HOME=\"".concat('${' + (mode === 'support' ? 'RESOLVEIO_SUPPORT_QA_HOME' : 'RESOLVEIO_RUNNER_QA_HOME') + '}', "\""),
-        '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"',
-        toolsBinPath ? "export PATH=\"".concat(toolsBinPath, ":$PATH\"") : '',
-        'export NODE_ENV=development',
-        browserslistPath ? "export BROWSERSLIST_CONFIG=\"".concat(browserslistPath, "\"") : '',
-        "export ".concat(clientPortVar, "=\"").concat('${' + clientPortVar + ':-${' + altClientPortVar + ':-' + defaultPort + '}}', "\""),
-        "export ".concat(altClientPortVar, "=\"").concat('${' + altClientPortVar + ':-${' + clientPortVar + '}}', "\""),
-        "export ".concat(clientUrlVar, "=\"").concat('${' + clientUrlVar + ':-${' + altClientUrlVar + ':-http://localhost:${' + clientPortVar + '}}}', "\""),
-        "export ".concat(altClientUrlVar, "=\"").concat('${' + altClientUrlVar + ':-${' + clientUrlVar + '}}', "\""),
-        "export ".concat(serverUrlVar, "=\"").concat('${' + serverUrlVar + ':-${' + altServerUrlVar + ':-http://localhost:8080}}', "\""),
-        "export ".concat(altServerUrlVar, "=\"").concat('${' + altServerUrlVar + ':-${' + serverUrlVar + '}}', "\""),
-        'export ADDITIONAL_ALLOWED_ORIGINS="${ADDITIONAL_ALLOWED_ORIGINS:-$' + clientUrlVar + '}"',
-        "export ".concat(viewportWidthVar, "=\"").concat('${' + viewportWidthVar + ':-${' + altViewportWidthVar + ':-1920}}', "\""),
-        "export ".concat(altViewportWidthVar, "=\"").concat('${' + altViewportWidthVar + ':-${' + viewportWidthVar + '}}', "\""),
-        "export ".concat(viewportHeightVar, "=\"").concat('${' + viewportHeightVar + ':-${' + altViewportHeightVar + ':-1080}}', "\""),
-        "export ".concat(altViewportHeightVar, "=\"").concat('${' + altViewportHeightVar + ':-${' + viewportHeightVar + '}}', "\""),
-        "export ".concat(timeoutVar, "=\"").concat('${' + timeoutVar + ':-${' + altTimeoutVar + ':-900}}', "\""),
-        "export ".concat(altTimeoutVar, "=\"").concat('${' + altTimeoutVar + ':-${' + timeoutVar + '}}', "\""),
-        "export ".concat(prebundleVar, "=\"").concat('${' + prebundleVar + ':-${' + altPrebundleVar + ':-false}}', "\""),
-        "export ".concat(altPrebundleVar, "=\"").concat('${' + altPrebundleVar + ':-${' + prebundleVar + '}}', "\""),
-        "export ".concat(reuseVar, "=\"").concat('${' + reuseVar + ':-${' + altReuseVar + ':-true}}', "\""),
-        "export ".concat(altReuseVar, "=\"").concat('${' + altReuseVar + ':-${' + reuseVar + '}}', "\""),
-        "export ".concat(keepaliveVar, "=\"").concat('${' + keepaliveVar + ':-${' + altKeepaliveVar + ':-false}}', "\""),
-        "export ".concat(altKeepaliveVar, "=\"").concat('${' + altKeepaliveVar + ':-${' + keepaliveVar + '}}', "\""),
-        "export ".concat(usernameVar, "=\"").concat('${' + usernameVar + ':-${' + altUsernameVar + ':-' + username + '}}', "\""),
-        "export ".concat(altUsernameVar, "=\"").concat('${' + altUsernameVar + ':-${' + usernameVar + '}}', "\""),
-        "export ".concat(passwordVar, "=\"").concat('${' + passwordVar + ':-${' + altPasswordVar + ':-' + password + '}}', "\""),
-        "export ".concat(altPasswordVar, "=\"").concat('${' + altPasswordVar + ':-${' + passwordVar + '}}', "\""),
-        'export PUPPETEER_CACHE_DIR="${PUPPETEER_CACHE_DIR:-/var/lib/resolveio/puppeteer}"',
-        'if [ ! -d "$PUPPETEER_CACHE_DIR" ] || [ ! -w "$PUPPETEER_CACHE_DIR" ]; then',
-        '  export PUPPETEER_CACHE_DIR="$RESOLVEIO_QA_TMP/puppeteer"',
-        '  mkdir -p "$PUPPETEER_CACHE_DIR"',
-        'fi',
-        "for ".concat(browserLoopVar, " in \"$PUPPETEER_CACHE_DIR\"/chrome-headless-shell/linux-*/chrome-headless-shell-linux64/chrome-headless-shell \"$PUPPETEER_CACHE_DIR\"/chrome/linux-*/chrome-linux64/chrome; do"),
-        "  if [ -x \"$".concat(browserLoopVar, "\" ]; then"),
-        "    export PUPPETEER_EXECUTABLE_PATH=\"$".concat(browserLoopVar, "\""),
-        "    export CHROME_BIN=\"$".concat(browserLoopVar, "\""),
-        '    break',
-        '  fi',
-        'done',
-        "unset ".concat(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=\"".concat(mongodbBinaryCachePath, "\"") : '',
-        'export MONGOMS_VERSION="${MONGOMS_VERSION:-7.0.14}"',
-        ''
-    ].filter(function (line) { return line !== ''; }).join('\n');
-}
-function buildResolveIORunnerLocalQaScript() {
-    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"',
-        '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',
-        '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',
-        'ANGULAR_PREBUNDLE_ARGS=()',
-        '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 $(lsof -ti tcp:"$port" 2>/dev/null || true)"; fi',
-        '  if command -v fuser >/dev/null 2>&1; then pids="$pids $(fuser -n tcp "$port" 2>/dev/null || true)"; fi',
-        '  if command -v ss >/dev/null 2>&1; then pids="$pids $(ss -ltnp "sport = :$port" 2>/dev/null | 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',
-        '}',
-        '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',
-        '    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|esbuild|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',
-        '    if [ -d /proc ]; then',
-        '      for proc_cwd in /proc/[0-9]*/cwd; do',
-        '        pid="${proc_cwd#/proc/}"',
-        '        pid="${pid%/cwd}"',
-        '        skip_cleanup_pid "$pid" && continue',
-        '        cwd="$(readlink -f "$proc_cwd" 2>/dev/null || true)"',
-        '        case "$cwd" in',
-        '          "$PROJECT_ROOT"|"$PROJECT_ROOT"/*) kill_tree "$pid" ;;',
-        '        esac',
-        '      done',
-        '    fi',
-        '    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',
-        '      if command -v lsof >/dev/null 2>&1 && [ -n "$(lsof -ti tcp:"$port" 2>/dev/null || true)" ]; then found=1; fi',
-        '    done',
-        '    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|esbuild|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() {',
-        '  kill_tree "$SERVER_PID"',
-        '  kill_tree "$CLIENT_PID"',
-        '  cleanup_project_processes',
-        '  rmdir "$LOCK_DIR" >/dev/null 2>&1 || true',
-        '}',
-        'trap cleanup EXIT',
-        '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|Error: Cannot find module|NG[0-9]{4}|TS[0-9]{4}" "$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|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',
-        '}',
-        'if reuse_running_app_if_ready; then exit 0; fi',
-        'if ! mkdir "$LOCK_DIR" 2>/dev/null; then',
-        '  echo "ResolveIO AI runner QA lock is already held for $PROJECT_ROOT; cleaning stale local QA processes before retrying." | tee "$ARTIFACT_DIR/runner.log"',
-        '  cleanup_project_processes',
-        '  rmdir "$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',
-        'cleanup_project_processes',
-        ': > "$ARTIFACT_DIR/server.log"',
-        ': > "$ARTIFACT_DIR/client.log"',
-        ': > "$ARTIFACT_DIR/runner.log"',
-        'if [ -d "$PROJECT_ROOT/server" ]; then',
-        '  SERVER_REQUIRED=1',
-        '  (cd "$PROJECT_ROOT/server" && source "$TOOLS_DIR/env.sh" && { npm run server || ./start_server.sh; } 2>&1 | tee "$ARTIFACT_DIR/server.log") &',
-        '  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',
-        '  (cd "$PROJECT_ROOT" && source "$TOOLS_DIR/env.sh" && node --max_old_space_size=8048 ./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 echo "ResolveIO AI runner QA keepalive enabled; server/client remain running until this process is stopped."; wait; 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');
-}
-function buildResolveIORunnerLocalQaStopperScript() {
-    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}}"',
-        '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 $(lsof -ti tcp:"$port" 2>/dev/null || true)"; fi',
-        '  if command -v fuser >/dev/null 2>&1; then pids="$pids $(fuser -n tcp "$port" 2>/dev/null || true)"; fi',
-        '  if command -v ss >/dev/null 2>&1; then pids="$pids $(ss -ltnp "sport = :$port" 2>/dev/null | 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',
-        '}',
-        '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',
-        '}',
-        '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',
-        '  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|esbuild|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',
-        '  if [ -d /proc ]; then',
-        '    for proc_cwd in /proc/[0-9]*/cwd; do',
-        '      pid="${proc_cwd#/proc/}"',
-        '      pid="${pid%/cwd}"',
-        '      skip_cleanup_pid "$pid" && continue',
-        '      cwd="$(readlink -f "$proc_cwd" 2>/dev/null || true)"',
-        '      case "$cwd" in',
-        '        "$PROJECT_ROOT"|"$PROJECT_ROOT"/*) kill_tree "$pid" ;;',
-        '      esac',
-        '    done',
-        '  fi',
-        '  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',
-        '    if command -v lsof >/dev/null 2>&1 && [ -n "$(lsof -ti tcp:"$port" 2>/dev/null || true)" ]; then found=1; fi',
-        '  done',
-        '  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|esbuild|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',
-        'rmdir "$ARTIFACT_DIR/.qa.lock" >/dev/null 2>&1 || true',
-        'echo "ResolveIO AI runner QA local app stopped for $PROJECT_ROOT"',
-        ''
-    ].join('\n');
-}
-function buildResolveIORunnerBugfixComparisonQaScript() {
-    return [
-        '#!/usr/bin/env bash',
-        'set -u',
-        'TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
-        'source "$TOOLS_DIR/env.sh"',
-        '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"',
-        '  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',
-        '  set +e',
-        '  (cd "$REPO_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');
-}
-function buildResolveIORunnerQaToolsReadme(options) {
-    if (options === void 0) { options = {}; }
-    var mode = options.mode || 'runner';
-    var toolsDir = mode === 'support' ? '.resolveio-support-tools' : '.resolveio-ai-runner-tools';
-    var port = normalizePort(options.qaClientPort, '4200');
-    var clientUrlVar = envVar(mode, 'CLIENT_URL');
-    var keepaliveVar = envVar(mode, 'KEEPALIVE');
-    var usernameVar = envVar(mode, 'USERNAME');
-    var passwordVar = envVar(mode, 'PASSWORD');
-    return [
-        "# ResolveIO ".concat(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 ".concat(toolsDir, "/env.sh"),
-        "".concat(toolsDir, "/run-local-qa.sh <project-root>"),
-        "node ".concat(toolsDir, "/qa-auth-bootstrap.js <project-root> /target-route"),
-        "".concat(toolsDir, "/bugfix-comparison-qa.sh <project-root> origin/master -- bash -lc '<same QA command>'"),
-        '```',
-        '',
-        "This workspace reserves Angular QA client port ".concat(port, "; use `$").concat(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.',
-        '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.',
-        "For browser clickthrough work, start the runner once with `".concat(keepaliveVar, "=true ").concat(toolsDir, "/run-local-qa.sh <project-root> &` and reuse `$").concat(clientUrlVar, "` for all login/upload/screenshot retries. Do not restart Angular for auth failures."),
-        'Use desktop screenshots at 1920x1080 by default unless the task is explicitly mobile/responsive. Every screenshot must have a customer-facing caption.',
-        'For import/export/form-submit/data workflows, prove before/action/after with representative data and a concrete row/count/value assertion.',
-        '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 `$".concat(usernameVar, "` and `$").concat(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(function (line) { return line !== ''; }).join('\n');
-}
-
-//# sourceMappingURL=ai-runner-qa-tools.js.map