@open-mercato/cli 0.6.7 → 0.6.8-canary.319.1.5b4be4bc52

package/dist/lib/telemetry-init.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/telemetry-init.ts"],
+  "sourcesContent": ["import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\n\n/**\n * `mercato telemetry init` \u2014 wire `@open-mercato/telemetry` into an app that was\n * scaffolded before telemetry existed. Deterministic, idempotent, and safe to\n * re-run: each step detects whether it is already applied and skips.\n *\n * The web-tier wiring lives in app-owned source files (a dependency bump cannot\n * touch them), so this patches them in place using the same idioms the rest of\n * the CLI uses: JSON edits, detect-before-append for `.env`, a ts-morph edit for\n * `next.config.ts`, and anchored insertion for `instrumentation.ts` + the API\n * dispatcher. When a file's shape is not recognized (a customized dispatcher, an\n * unusual next.config), the step degrades to printing the exact snippet and\n * flags it as a manual step rather than editing code it does not understand.\n *\n * Worker/scheduler telemetry is not handled here \u2014 it ships transitively via\n * `@open-mercato/cli`'s telemetry dependency once the app updates its packages.\n */\n\nconst BULLMQ_OTEL_VERSION = '^1.3.1'\n\ntype StepStatus = 'created' | 'patched' | 'skipped' | 'manual'\n\ntype StepResult = {\n  file: string\n  status: StepStatus\n  detail: string\n  /** Snippet to show when the step needs manual work. */\n  manualSnippet?: string\n}\n\ntype TelemetryInitOptions = {\n  dryRun: boolean\n}\n\nconst ENV_BLOCK = `\n# --- Telemetry & Observability (vendor-neutral OTLP: traces, logs, metrics, errors) ---\n# Off by default: leave TELEMETRY_BACKEND unset (or =noop) for a hard no-op\n# (the OpenTelemetry SDK is never loaded). Set to 'console' for local span/metric\n# output, or an OTLP backend to export: 'signoz' | 'newrelic' | 'otlp' (generic).\n# All three OTLP names use the same exporter \u2014 they differ only by the endpoint +\n# headers below. Any OTLP backend is a one-line swap; no code change.\n# TELEMETRY_BACKEND=otlp\n# Logs use the shared logger facade and its OM_LOG_LEVEL / OM_LOG_PRETTY /\n# OM_LOG_DESTINATION controls. Telemetry adds remote export; it does not create\n# a second local output path.\n# TELEMETRY_SAMPLING_RATIO=1.0        # 0.0\u20131.0 (default 1.0 dev / 0.1 prod)\n# TELEMETRY_TRUST_INBOUND_TRACE=false # default false: root-per-request (ignore an\n#                                     # inbound traceparent from a proxy/LB). Set true\n#                                     # only behind a trusted upstream whose trace continues.\n#                                     # This also enables richer bullmq-otel spans;\n#                                     # otherwise async queues use metadata._trace.\n#\n# OTLP endpoint + auth \u2014 pick ONE vendor (use your region's host):\n#   SigNoz Cloud:\n# OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.<region>.signoz.cloud:443\n# OTEL_EXPORTER_OTLP_HEADERS=signoz-ingestion-key=<your-ingestion-key>\n#   New Relic (OTLP-native; EU host shown, US is https://otlp.nr-data.net):\n# OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net\n# OTEL_EXPORTER_OTLP_HEADERS=api-key=<your-ingest-license-key>\n#\n# Resource identity: keep one stable service name across environments and\n# separate envs via the deployment.environment resource attribute.\n# OTEL_SERVICE_NAME=open-mercato\n# OTEL_RESOURCE_ATTRIBUTES=deployment.environment=local\n`\n\nconst INSTRUMENTATION_TS = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\n\nexport async function register(): Promise<void> {\n  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set). OTEL's NodeSDK\n  // is Node-only and incompatible with the edge runtime, so the telemetry\n  // bootstrap \u2014 which can pull in the SDK \u2014 is imported only on the Node.js\n  // runtime. The helper owns init + graceful degrade + shutdown flush.\n  if (\n    process.env.NEXT_RUNTIME === 'nodejs'\n    && isTelemetryBackendEnabled()\n  ) {\n    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')\n    await registerTelemetryForNextjs()\n  }\n}\n`\n\nconst DISPATCHER_SNIPPET = `  // add near the other imports:\n  import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'\n\n  // in the dispatcher's success path, just before returning the response:\n  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)\n\n  // in the dispatcher's catch (error) block, before re-throwing:\n  getTelemetryRuntime()?.reportError(error, {\n    attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },\n  })\n  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`\n\nfunction parseArgs(args: string[]): TelemetryInitOptions {\n  return {\n    dryRun: args.includes('--dry-run') || args.includes('-n'),\n  }\n}\n\n/** Read the version an app already pins its `@open-mercato/*` deps to (lockstep). */\nfunction resolveOpenMercatoVersion(pkg: Record<string, unknown>): string {\n  for (const field of ['dependencies', 'devDependencies'] as const) {\n    const deps = pkg[field]\n    if (deps && typeof deps === 'object') {\n      for (const [name, version] of Object.entries(deps as Record<string, string>)) {\n        if (name.startsWith('@open-mercato/') && typeof version === 'string') return version\n      }\n    }\n  }\n  return '*'\n}\n\nfunction patchPackageJson(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'package.json'\n  const path = join(appDir, file)\n  const raw = readFileSync(path, 'utf8')\n  const pkg = JSON.parse(raw) as {\n    dependencies?: Record<string, string>\n    optionalDependencies?: Record<string, string>\n  }\n  const version = resolveOpenMercatoVersion(pkg)\n  const hasTelemetry = Boolean(pkg.dependencies?.['@open-mercato/telemetry'])\n  const hasBullmqOtel = Boolean(pkg.optionalDependencies?.['bullmq-otel'])\n  if (hasTelemetry && hasBullmqOtel) {\n    return { file, status: 'skipped', detail: '@open-mercato/telemetry already installed' }\n  }\n\n  const deps = { ...(pkg.dependencies ?? {}) }\n  if (!hasTelemetry) deps['@open-mercato/telemetry'] = version\n  const optDeps = { ...(pkg.optionalDependencies ?? {}) }\n  if (!hasBullmqOtel) optDeps['bullmq-otel'] = BULLMQ_OTEL_VERSION\n\n  const next = {\n    ...pkg,\n    dependencies: sortRecord(deps),\n    optionalDependencies: sortRecord(optDeps),\n  }\n  if (!options.dryRun) writeFileSync(path, `${JSON.stringify(next, null, 2)}\\n`)\n  return {\n    file,\n    status: 'patched',\n    detail: `+@open-mercato/telemetry@${version}${hasBullmqOtel ? '' : ` +bullmq-otel@${BULLMQ_OTEL_VERSION} (optional)`} \u2014 run \\`yarn install\\``,\n  }\n}\n\nfunction sortRecord(record: Record<string, string>): Record<string, string> {\n  return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)))\n}\n\nfunction patchEnvFile(appDir: string, relativePath: string, options: TelemetryInitOptions): StepResult | null {\n  const path = join(appDir, relativePath)\n  if (!existsSync(path)) return null\n  const content = readFileSync(path, 'utf8')\n  if (content.includes('TELEMETRY_BACKEND')) {\n    return { file: relativePath, status: 'skipped', detail: 'TELEMETRY_* block already present' }\n  }\n  const next = `${content.replace(/\\s*$/, '')}\\n${ENV_BLOCK}`\n  if (!options.dryRun) writeFileSync(path, next)\n  return { file: relativePath, status: 'patched', detail: 'appended commented TELEMETRY_* / OTEL_* block' }\n}\n\nfunction patchInstrumentation(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'src/instrumentation.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    if (!options.dryRun) {\n      mkdirSync(dirname(path), { recursive: true })\n      writeFileSync(path, INSTRUMENTATION_TS)\n    }\n    return { file, status: 'created', detail: 'Node-runtime-guarded registerTelemetryForNextjs() bootstrap' }\n  }\n  const content = readFileSync(path, 'utf8')\n  if (content.includes('registerTelemetryForNextjs')) {\n    if (content.includes('isTelemetryBackendEnabled')) {\n      return { file, status: 'skipped', detail: 'telemetry already wired' }\n    }\n    const migrated =\n      `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\\n` +\n      content.replace(\n        `if (process.env.NEXT_RUNTIME === 'nodejs') {`,\n        `if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {`,\n      )\n    if (!options.dryRun) writeFileSync(path, migrated)\n    return { file, status: 'patched', detail: 'added the explicit backend import guard' }\n  }\n  const anchor = content.match(/export\\s+async\\s+function\\s+register\\s*\\([^)]*\\)\\s*:\\s*Promise<void>\\s*\\{/)\n  if (!anchor || anchor.index === undefined) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'register() not found \u2014 add the telemetry bootstrap manually',\n      manualSnippet: INSTRUMENTATION_TS,\n    }\n  }\n  const insertAt = anchor.index + anchor[0].length\n  const block =\n    `\\n  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set); Node-only.` +\n    `\\n  if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {` +\n    `\\n    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')` +\n    `\\n    await registerTelemetryForNextjs()` +\n    `\\n  }`\n  const importLine = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\\n`\n  const withImport = content.includes('isTelemetryBackendEnabled')\n    ? content\n    : importLine + content\n  const shiftedInsertAt = insertAt + (withImport.length - content.length)\n  const next = withImport.slice(0, shiftedInsertAt) + block + withImport.slice(shiftedInsertAt)\n  if (!options.dryRun) writeFileSync(path, next)\n  return { file, status: 'patched', detail: 'inserted registerTelemetryForNextjs() into register()' }\n}\n\nasync function patchNextConfig(appDir: string, options: TelemetryInitOptions): Promise<StepResult> {\n  const file = 'next.config.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    return { file, status: 'manual', detail: 'next.config.ts not found', manualSnippet: nextConfigSnippet() }\n  }\n  // Use ts-morph to *detect* the real `serverExternalPackages` array literal\n  // (robust against a match inside a comment/string), then do the *insertion*\n  // via a formatting-preserving text splice so the user's config stays tidy.\n  const { Project, SyntaxKind } = await import('ts-morph')\n  const project = new Project({ skipAddingFilesFromTsConfig: true, skipFileDependencyResolution: true })\n  const sf = project.addSourceFileAtPath(path)\n\n  const telemetryConfigImport = sf\n    .getImportDeclarations()\n    .find((decl) => [\n      '@open-mercato/telemetry/nextjs',\n      '@open-mercato/telemetry/nextjs-config',\n    ].includes(decl.getModuleSpecifierValue()))\n  const hasImport = Boolean(telemetryConfigImport)\n  const hasCanonicalImport =\n    telemetryConfigImport?.getModuleSpecifierValue() === '@open-mercato/telemetry/nextjs-config'\n\n  const arrayProp = sf\n    .getDescendantsOfKind(SyntaxKind.PropertyAssignment)\n    .find((prop) => prop.getName() === 'serverExternalPackages')\n  const arrayInit = arrayProp?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression)\n  if (!arrayInit) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'serverExternalPackages array not found',\n      manualSnippet: nextConfigSnippet(),\n    }\n  }\n  const hasSpread = arrayInit.getElements().some((el) => el.getText().includes('telemetryServerExternalPackages'))\n  if (hasCanonicalImport && hasSpread) {\n    return { file, status: 'skipped', detail: 'telemetryServerExternalPackages already wired' }\n  }\n\n  let text = readFileSync(path, 'utf8')\n  // Splice the array first, using the AST node's byte offsets (formatting-agnostic:\n  // handles both single-line and multi-line arrays). Do this before modifying\n  // imports, because either an inserted import or the legacy import migration\n  // shifts the array offsets captured from the original source.\n  if (!hasSpread) {\n    const start = arrayInit.getStart()\n    const end = arrayInit.getEnd()\n    text = text.slice(0, start) + insertSpread(text.slice(start, end)) + text.slice(end)\n  }\n  text = text.replace(\n    \"from '@open-mercato/telemetry/nextjs'\",\n    \"from '@open-mercato/telemetry/nextjs-config'\",\n  )\n  if (!hasImport) {\n    const importRegex = /^import[^\\n]*$/gm\n    let lastImport: RegExpExecArray | null = null\n    let match: RegExpExecArray | null\n    while ((match = importRegex.exec(text)) !== null) lastImport = match\n    const insertAt = lastImport ? lastImport.index + lastImport[0].length : 0\n    text =\n      text.slice(0, insertAt) +\n      `\\nimport { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'` +\n      text.slice(insertAt)\n  }\n  if (!options.dryRun) writeFileSync(path, text)\n  return { file, status: 'patched', detail: 'spread telemetryServerExternalPackages into serverExternalPackages' }\n}\n\n/** Add `...telemetryServerExternalPackages` as the last element of an array literal, preserving its style. */\nfunction insertSpread(arrayText: string): string {\n  const inner = arrayText.slice(1, -1)\n  if (inner.includes('\\n')) {\n    const elementIndent = inner.match(/\\n([ \\t]+)\\S/)?.[1] ?? '  '\n    const closeIndent = arrayText.match(/\\n([ \\t]*)\\]$/)?.[1] ?? ''\n    const trimmed = inner.replace(/\\s*$/, '')\n    const separator = trimmed === '' || trimmed.endsWith(',') ? '' : ','\n    return `[${trimmed}${separator}\\n${elementIndent}...telemetryServerExternalPackages,\\n${closeIndent}]`\n  }\n  const flat = inner.trim()\n  return flat === '' ? '[...telemetryServerExternalPackages]' : `[${flat}, ...telemetryServerExternalPackages]`\n}\n\nfunction nextConfigSnippet(): string {\n  return (\n    `import { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'\\n` +\n    `// serverExternalPackages: [ ...existing, ...telemetryServerExternalPackages ]`\n  )\n}\n\n/**\n * Auto-patch the catch-all API dispatcher \u2014 but only when it still matches the\n * known scaffold shape (all anchors present, telemetry not yet wired). On any\n * mismatch, print the snippet and mark it manual rather than editing an\n * unrecognized (customized) handler.\n */\nfunction patchDispatcher(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'src/app/api/[...slug]/route.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    return { file, status: 'manual', detail: 'dispatcher not found', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  let content = readFileSync(path, 'utf8')\n  if (\n    content.includes(\"from '@open-mercato/shared/lib/telemetry/runtime'\")\n    && content.includes('getTelemetryRuntime()?.recordHttpDuration')\n  ) {\n    return { file, status: 'skipped', detail: 'telemetry already wired' }\n  }\n  if (\n    content.includes(\"import { reportError } from '@open-mercato/telemetry'\")\n    && content.includes(\"import { recordHttpDuration } from '@open-mercato/telemetry/nextjs'\")\n  ) {\n    content = content\n      .replace(\n        \"import { reportError } from '@open-mercato/telemetry'\\nimport { recordHttpDuration } from '@open-mercato/telemetry/nextjs'\",\n        \"import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'\",\n      )\n      .replace(/\\brecordHttpDuration\\(/g, 'getTelemetryRuntime()?.recordHttpDuration(')\n      .replace(/\\breportError\\(/g, 'getTelemetryRuntime()?.reportError(')\n    if (!options.dryRun) writeFileSync(path, content)\n    return { file, status: 'patched', detail: 'migrated dispatcher to the default-off runtime bridge' }\n  }\n\n  const importAnchor = \"import { isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'\"\n  const returnMatch = content.match(/^([ \\t]*)return finalResponse\\s*$/m)\n  // The handleRequest catch is the first `} catch (error) {` after the success return.\n  const catchRegex = /^([ \\t]*)\\}\\s*catch\\s*\\(error\\)\\s*\\{[ \\t]*$/gm\n  const catchMatch = findCatchAfter(content, catchRegex, returnMatch?.index ?? -1)\n\n  if (!content.includes(importAnchor) || !returnMatch || returnMatch.index === undefined || !catchMatch) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'dispatcher shape not recognized \u2014 apply the snippet by hand',\n      manualSnippet: DISPATCHER_SNIPPET,\n    }\n  }\n\n  // 1) imports\n  content = content.replace(\n    importAnchor,\n    `${importAnchor}\\nimport { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'`,\n  )\n\n  // 2) success-path metric (re-match after the import edit shifted offsets)\n  const ret = content.match(/^([ \\t]*)return finalResponse\\s*$/m)\n  if (!ret || ret.index === undefined) {\n    return { file, status: 'manual', detail: 'success-path anchor lost', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  const retIndent = ret[1]\n  content =\n    content.slice(0, ret.index) +\n    `${retIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)\\n` +\n    content.slice(ret.index)\n\n  // 3) catch-block error funnel + 500 metric\n  const catch2 = findCatchAfter(content, /^([ \\t]*)\\}\\s*catch\\s*\\(error\\)\\s*\\{[ \\t]*$/gm, content.indexOf('return finalResponse'))\n  if (!catch2) {\n    return { file, status: 'manual', detail: 'catch anchor lost', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  const bodyIndent = `${catch2.indent}  `\n  const insertAt = catch2.index + catch2.length\n  const block =\n    `\\n${bodyIndent}getTelemetryRuntime()?.reportError(error, {` +\n    `\\n${bodyIndent}  attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },` +\n    `\\n${bodyIndent}})` +\n    `\\n${bodyIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`\n  content = content.slice(0, insertAt) + block + content.slice(insertAt)\n\n  if (!options.dryRun) writeFileSync(path, content)\n  return { file, status: 'patched', detail: 'wired reportError (5xx) + http.server.request.duration metric' }\n}\n\nfunction findCatchAfter(\n  content: string,\n  regex: RegExp,\n  afterIndex: number,\n): { index: number; length: number; indent: string } | null {\n  regex.lastIndex = 0\n  let match: RegExpExecArray | null\n  while ((match = regex.exec(content)) !== null) {\n    if (match.index > afterIndex) {\n      return { index: match.index, length: match[0].length, indent: match[1] }\n    }\n  }\n  return null\n}\n\nexport async function runTelemetryInit(args: string[]): Promise<number> {\n  const appDir = resolve('.')\n  const options = parseArgs(args)\n\n  if (!existsSync(join(appDir, 'src', 'modules.ts'))) {\n    console.error('\u274C  Not an Open Mercato app directory (src/modules.ts not found)')\n    return 1\n  }\n  if (!existsSync(join(appDir, 'package.json'))) {\n    console.error('\u274C  package.json not found')\n    return 1\n  }\n\n  console.log('')\n  console.log(options.dryRun ? '\uD83D\uDD2D Telemetry init (dry run \u2014 no files written)\\n' : '\uD83D\uDD2D Wiring @open-mercato/telemetry into this app\\n')\n\n  const results: StepResult[] = []\n  results.push(patchPackageJson(appDir, options))\n  const envExample = patchEnvFile(appDir, '.env.example', options)\n  if (envExample) results.push(envExample)\n  const env = patchEnvFile(appDir, '.env', options)\n  if (env) results.push(env)\n  results.push(patchInstrumentation(appDir, options))\n  results.push(await patchNextConfig(appDir, options))\n  results.push(patchDispatcher(appDir, options))\n\n  const icon: Record<StepStatus, string> = { created: '\u270D\uFE0F ', patched: '\u2705', skipped: '\u23ED\uFE0F ', manual: '\u26A0\uFE0F ' }\n  for (const result of results) {\n    console.log(`${icon[result.status]} ${result.file} \u2014 ${result.detail}`)\n  }\n\n  const manual = results.filter((result) => result.status === 'manual')\n  for (const result of manual) {\n    if (!result.manualSnippet) continue\n    console.log('')\n    console.log(`\u2500\u2500 manual step for ${result.file} \u2500\u2500`)\n    console.log(result.manualSnippet)\n  }\n\n  console.log('')\n  const changed = results.some((result) => result.status === 'patched' || result.status === 'created')\n  if (options.dryRun) {\n    console.log('Dry run complete \u2014 re-run without --dry-run to apply.')\n  } else if (changed) {\n    console.log('Next steps:')\n    console.log('  1. yarn install                 (resolve @open-mercato/telemetry + the OTEL SDK)')\n    console.log('  2. set TELEMETRY_BACKEND + OTEL_EXPORTER_OTLP_* in .env')\n    console.log('  3. yarn typecheck && yarn build (verify the wiring)')\n  } else {\n    console.log('Nothing to do \u2014 telemetry is already wired.')\n  }\n  if (manual.length > 0) {\n    console.log('')\n    console.log(`\u26A0\uFE0F  ${manual.length} file(s) need a manual edit (shown above) \u2014 the rest were applied automatically.`)\n  }\n  return 0\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/testing/integration.js

@@ -118,6 +118,7 @@ const EPHEMERAL_ENV_LOCK_PATH = path.join(projectRootDirectory, ".ai", "qa", "ep
 const LEGACY_EPHEMERAL_ENV_FILE_PATH = path.join(projectRootDirectory, ".ai", "qa", "ephemeral-env.md");
 const EPHEMERAL_BUILD_CACHE_STATE_PATH = path.join(projectRootDirectory, ".ai", "qa", "ephemeral-build-cache.json");
 const EPHEMERAL_CACHE_DB_PATH = path.join(projectRootDirectory, ".ai", "qa", "ephemeral-cache.sqlite");
+const EPHEMERAL_EMAIL_CAPTURE_PATH = path.join(projectRootDirectory, ".ai", "qa", "email-capture.jsonl");
 const EPHEMERAL_QUEUE_BASE_DIR = path.join(appDirectory, ".mercato", "queue");
 const PRIVATE_ATTACHMENTS_PARTITION_ENV_KEY = "ATTACHMENTS_PARTITION_PRIVATE_ATTACHMENTS_ROOT";
 const EPHEMERAL_PRIVATE_ATTACHMENTS_ROOT = path.join(
@@ -1438,6 +1439,7 @@ function buildReusableEnvironment(baseUrl, databaseUrl, queueBaseDir, captureScr
     BASE_URL: baseUrl,
     APP_URL: baseUrl,
     NEXT_PUBLIC_APP_URL: baseUrl,
+    PLATFORM_PORTAL_BASE_URL: baseUrl,
     NODE_ENV: "production",
     // Share the app server's cache backend with the test process and the
     // queue-drain runners it spawns (drainIntegrationQueue children inherit
@@ -1463,6 +1465,7 @@ function buildReusableEnvironment(baseUrl, databaseUrl, queueBaseDir, captureScr
     OM_ENABLE_ENTERPRISE_MODULES_SSO: process.env.OM_ENABLE_ENTERPRISE_MODULES_SSO ?? enterpriseModulesFlag,
     OM_ENABLE_ENTERPRISE_MODULES_SECURITY: process.env.OM_ENABLE_ENTERPRISE_MODULES_SECURITY ?? enterpriseModulesFlag,
     OM_TEST_MODE: "1",
+    OM_TEST_EMAIL_CAPTURE_PATH: EPHEMERAL_EMAIL_CAPTURE_PATH,
     OM_TEST_AUTH_RATE_LIMIT_MODE: "opt-in",
     // Tests assert on access_logs immediately after CRUD reads; keep the
     // blocking write path on inside the integration runtime so tests do
@@ -1478,7 +1481,6 @@ function buildReusableEnvironment(baseUrl, databaseUrl, queueBaseDir, captureScr
     MOCK_GATEWAY_WEBHOOK_SECRET: "open-mercato-mock-dev-webhook-secret",
     MOCK_CARRIER_WEBHOOK_SECRET: "open-mercato-mock-dev-carrier-webhook-secret",
     MOCK_INBOUND_WEBHOOK_SECRET: "open-mercato-mock-dev-inbound-webhook-secret",
-    NEXT_PUBLIC_OM_EXAMPLE_INJECTION_WIDGETS_ENABLED: "true",
     NEXT_PUBLIC_UMES_DEVTOOLS: "true",
     CI: "true",
     TENANT_DATA_ENCRYPTION_FALLBACK_KEY: process.env.TENANT_DATA_ENCRYPTION_FALLBACK_KEY ?? "om-ephemeral-integration-fallback-key",
@@ -2609,6 +2611,7 @@ async function startEphemeralEnvironment(options) {
       BASE_URL: applicationBaseUrl,
       APP_URL: applicationBaseUrl,
       NEXT_PUBLIC_APP_URL: applicationBaseUrl,
+      PLATFORM_PORTAL_BASE_URL: applicationBaseUrl,
       JWT_SECRET: process.env.JWT_SECRET ?? "om-ephemeral-integration-jwt-secret",
       OM_SECURITY_MFA_SETUP_SECRET: process.env.OM_SECURITY_MFA_SETUP_SECRET ?? "om-ephemeral-integration-mfa-setup-secret",
       NODE_ENV: "production",
@@ -2637,6 +2640,7 @@ async function startEphemeralEnvironment(options) {
       OM_ENABLE_ENTERPRISE_MODULES_SSO: process.env.OM_ENABLE_ENTERPRISE_MODULES_SSO ?? enterpriseModulesFlag,
       OM_ENABLE_ENTERPRISE_MODULES_SECURITY: process.env.OM_ENABLE_ENTERPRISE_MODULES_SECURITY ?? enterpriseModulesFlag,
       OM_TEST_MODE: "1",
+      OM_TEST_EMAIL_CAPTURE_PATH: EPHEMERAL_EMAIL_CAPTURE_PATH,
       OM_TEST_AUTH_RATE_LIMIT_MODE: "opt-in",
       OM_DISABLE_EMAIL_DELIVERY: "1",
       OM_WEBHOOKS_ALLOW_PRIVATE_URLS: process.env.OM_WEBHOOKS_ALLOW_PRIVATE_URLS ?? "1",
@@ -2649,7 +2653,6 @@ async function startEphemeralEnvironment(options) {
       // var at the workflow level, masking the gap). Keep in sync with the
       // Playwright-process env block above.
       MOCK_INBOUND_WEBHOOK_SECRET: "open-mercato-mock-dev-inbound-webhook-secret",
-      NEXT_PUBLIC_OM_EXAMPLE_INJECTION_WIDGETS_ENABLED: "true",
       NEXT_PUBLIC_UMES_DEVTOOLS: "true",
       CI: "true",
       TENANT_DATA_ENCRYPTION_FALLBACK_KEY: process.env.TENANT_DATA_ENCRYPTION_FALLBACK_KEY ?? "om-ephemeral-integration-fallback-key",