dd-trace 6.7.0 → 6.9.0

package/ci/test-optimization-validation/scenarios/ci-wiring.js

@@ -29,9 +29,10 @@ const RUNNER_PATTERNS = {
  * @param {object} input audit inputs
  * @param {object} input.manifest validation manifest
  * @param {object} input.framework framework entry
+ * @param {Map<string, Buffer|undefined>} [input.projectFileSources] approval-bound project sources
  * @returns {object} CI audit result
  */
-function runCiWiring ({ manifest, framework }) {
+function runCiWiring ({ manifest, framework, projectFileSources }) {
   const contradiction = getFrameworkCiDiscoveryContradiction(framework, manifest)
   if (contradiction) {
     return getIncomplete(framework, contradiction.reason, {
@@ -47,6 +48,32 @@ function runCiWiring ({ manifest, framework }) {
     domain: 'ci_configuration',
     evidenceStrength: 'unknown',
   }
+  if (hasNoSupportedCiConfiguration(manifest, ci)) {
+    return getIncomplete(
+      framework,
+      'No supported CI configuration file was found by bounded repository discovery. The CI audit is incomplete; ' +
+        'this does not prove that the repository has no external CI configuration.',
+      {
+        ...evidence,
+        reasonCode: 'no-supported-ci-configuration',
+        recommendation: 'Identify the CI system and one repository-controlled test job. If CI is configured outside ' +
+          'this repository, review that configuration separately.',
+      }
+    )
+  }
+  if (hasUnavailableRemoteCiCommand(ci)) {
+    return getIncomplete(
+      framework,
+      'The selected CI path delegates test execution to a remote action or reusable workflow whose command is not ' +
+        'available in this repository. The CI audit is incomplete.',
+      {
+        ...evidence,
+        reasonCode: 'remote-ci-command-unavailable',
+        recommendation: 'Review the referenced action or reusable workflow at its pinned revision. Keep the result ' +
+          'incomplete when its final test command and effective environment cannot be bound statically.',
+      }
+    )
+  }
   const missing = getMissingReviewFields(ci)
   if (missing.length > 0) {
     return getIncomplete(
@@ -63,7 +90,7 @@ function runCiWiring ({ manifest, framework }) {
     )
   }
 
-  const source = readCiSource(ci.configFile)
+  const source = readProjectSource(ci.configFile, projectFileSources)
   if (!source) {
     return getIncomplete(framework, 'The recorded CI configuration file is unavailable or too large to verify.', {
       ...evidence,
@@ -87,7 +114,7 @@ function runCiWiring ({ manifest, framework }) {
   }
 
   const command = ci.command.trim()
-  const resolution = getRunnerResolution(command, framework, ci)
+  const resolution = getRunnerResolution(command, framework, ci, projectFileSources)
   const normalizedSource = jobSource.replaceAll('\\', '/')
   const hasInitialization = /dd-trace\/ci\/init(?:\.js)?\b/.test(normalizedSource)
   const matrixRelevant = matrixAffectsCiFacts(jobSource, command)
@@ -138,12 +165,16 @@ function runCiWiring ({ manifest, framework }) {
   if (initialization.status === 'missing' &&
     resolution.status === 'confirmed' &&
     unresolved.relevant.length === 0) {
+    const transportMissing = ciFacts.transport.status === 'missing'
     return getFailure(
       framework,
       'The checksum-bound CI job reaches the selected test framework through a bounded static command path, but ' +
-        'does not configure the dd-trace/ci/init preload. Test Optimization is not initialized in that job.',
+        `does not configure the dd-trace/ci/init preload${
+          transportMissing ? ' and declares no visible Datadog Agent or agentless reporting transport' : ''
+        }. Test Optimization is not configured in that job.`,
       {
         ...evidence,
+        ciConfigurationStatus: 'not_configured',
         ciRemediation: remediation,
         conclusion: 'confirmed_misconfigured',
         evidenceStrength: 'confirmed_static',
@@ -153,17 +184,25 @@ function runCiWiring ({ manifest, framework }) {
   }
 
   if (resolution.status !== 'confirmed') {
-    const partial = initialization.status === 'missing'
-      ? 'The selected job has no visible dd-trace/ci/init preload. '
-      : ''
+    const visibleFacts = []
+    if (initialization.status === 'missing') {
+      visibleFacts.push('The selected job has no visible dd-trace/ci/init preload.')
+    }
+    if (ciFacts.transport.status === 'missing') {
+      visibleFacts.push('The recorded review found no visible Datadog Agent or agentless reporting transport.')
+    }
+    const recommendation = /working directory/i.test(resolution.reason)
+      ? 'Keep the CI job\'s actual working directory. Resolve the repository-root wrapper to the selected test ' +
+        'runner statically; do not substitute the framework package directory merely to make the audit conclusive.'
+      : 'Resolve the remaining wrapper or dynamic command statically, or confirm the effective NODE_OPTIONS value ' +
+        'in the final test process with DD_TRACE_DEBUG=1.'
     return getIncomplete(
       framework,
-      `${partial}The CI audit remains incomplete because the selected command could not be resolved to the ` +
-        `${framework.framework} runner: ${resolution.reason}.`,
+      'The CI audit remains incomplete because the selected command could not be resolved to the ' +
+        `${framework.framework} runner: ${resolution.reason}. ${visibleFacts.join(' ')}`.trim(),
       {
         ...evidence,
-        recommendation: 'Resolve the remaining wrapper or dynamic command statically, or confirm the effective ' +
-          'NODE_OPTIONS value in the final test process with DD_TRACE_DEBUG=1.',
+        recommendation,
       }
     )
   }
@@ -244,9 +283,10 @@ function getEffectiveNodeOptionsOverride (commandPath = []) {
  * @param {string} command selected CI command
  * @param {object} framework framework manifest entry
  * @param {object} ci selected CI evidence
+ * @param {Map<string, Buffer|undefined>} [projectFileSources] approval-bound project sources
  * @returns {object} static runner resolution
  */
-function getRunnerResolution (command, framework, ci) {
+function getRunnerResolution (command, framework, ci, projectFileSources) {
   if (getDirectRunner(command, framework.framework)) {
     return {
       commandPath: [command],
@@ -266,7 +306,7 @@ function getRunnerResolution (command, framework, ci) {
       status: 'unresolved',
     }
   }
-  const scripts = readProjectScripts(framework.project.packageJson)
+  const scripts = readProjectScripts(framework.project.packageJson, projectFileSources)
   if (!scripts) {
     return {
       reason: 'the approval-bound project package.json is unavailable or invalid',
@@ -283,10 +323,10 @@ function getRunnerResolution (command, framework, ci) {
       status: 'unresolved',
     }
   }
-  const candidate = expansion.terminals.find(terminal => {
+  const candidates = expansion.terminals.filter(terminal => {
     return getDirectRunner(terminal.command, framework.framework)
   })
-  if (!candidate) {
+  if (candidates.length === 0) {
     return {
       lifecycleScripts: expansion.lifecycleScripts,
       reason: 'no bounded local package-script path reaches the selected framework runner',
@@ -294,6 +334,15 @@ function getRunnerResolution (command, framework, ci) {
       status: 'unresolved',
     }
   }
+  if (candidates.length > 1) {
+    return {
+      lifecycleScripts: expansion.lifecycleScripts,
+      reason: 'more than one bounded local package-script path reaches the selected framework runner',
+      source: 'unresolved_wrapper',
+      status: 'unresolved',
+    }
+  }
+  const candidate = candidates[0]
   return {
     commandPath: candidate.path,
     lifecycleScripts: expansion.lifecycleScripts,
@@ -303,11 +352,11 @@ function getRunnerResolution (command, framework, ci) {
   }
 }
 
-function readProjectScripts (filename) {
+function readProjectScripts (filename, projectFileSources) {
   try {
-    const stat = fs.lstatSync(filename)
-    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > MAX_CI_FILE_BYTES) return
-    const packageJson = JSON.parse(fs.readFileSync(filename, 'utf8'))
+    const source = readProjectSource(filename, projectFileSources)
+    if (source === undefined) return
+    const packageJson = JSON.parse(source)
     if (!packageJson.scripts || typeof packageJson.scripts !== 'object' ||
       Array.isArray(packageJson.scripts)) return {}
     return packageJson.scripts
@@ -346,18 +395,19 @@ function classifyUnresolved (ci, resolution, matrixRelevant, jobSource) {
   const ignored = []
   const unresolved = Array.isArray(ci.unresolved) ? ci.unresolved : []
   const githubHosted = /[/\\]\.github[/\\]workflows[/\\]/.test(ci.configFile) &&
-    /^\s*runs-on:\s*(?:ubuntu|windows|macos)-/mi.test(jobSource)
+    /^[ \t]*runs-on:[ \t]*(?:ubuntu|windows|macos)-/mi.test(jobSource)
 
   for (const item of unresolved) {
     const isMatrix = /\bmatrix\b/i.test(item)
-    const isResolvedPackagePath = resolution.source === 'local_package_script' &&
-      /\b(?:lifecycle|npm|package script|pnpm|pretest|posttest|yarn)\b/i.test(item)
+    const isResolvedPackagePath = resolution.status === 'confirmed' &&
+      resolution.source === 'local_package_script' &&
+      /\b(?:bun|lifecycle|npm|package script|pnpm|pretest|posttest|yarn)\b/i.test(item)
     const isAmbientGithubSettings = githubHosted &&
-      /\b(?:repository|organization|environment)[-\s,\w]*\b(?:secrets?|variables?)\b/i.test(item) &&
+      /\b(?:repository|organization|environment)[-\s,\w]+\b(?:secrets?|variables?)\b/i.test(item) &&
       /\b(?:inject|inherit|outside)\b/i.test(item)
     const isOtherJob = /^Other jobs?\b/i.test(item) ||
-      /\bsecond\b.*\bjob\b.*\bonly\b.*\bselected\b/i.test(item) ||
-      /\brelease\b.*\bcontains no test job\b/i.test(item)
+      /\bsecond\b.+\bjob\b.+\bonly\b.+\bselected\b/i.test(item) ||
+      /\brelease\b.+\bcontains no test job\b/i.test(item)
     if ((isMatrix && !matrixRelevant) ||
       isResolvedPackagePath ||
       isAmbientGithubSettings ||
@@ -373,6 +423,29 @@ function classifyUnresolved (ci, resolution, matrixRelevant, jobSource) {
   return { ignored, relevant }
 }
 
+function hasNoSupportedCiConfiguration (manifest, ci) {
+  if (ci.configFile || ci.job || ci.command) return false
+  const unresolved = Array.isArray(ci.unresolved) ? ci.unresolved : []
+  return manifest.ciDiscovery?.found?.length === 0 ||
+    unresolved.some(item => /No supported CI configuration file was found/i.test(item))
+}
+
+function hasUnavailableRemoteCiCommand (ci) {
+  if (ci.command) return false
+  const evidence = [
+    ci.step,
+    ...(Array.isArray(ci.unresolved) ? ci.unresolved : []),
+  ].filter(Boolean)
+  if (evidence.some(item => {
+    return /\b(?:remote|external|third-party)\s+(?:action|workflow)\b/i.test(item)
+  })) return true
+
+  return evidence.some(item => {
+    const reference = /^\s*uses:\s*["']?([^"'\s]+)["']?\s*$/im.exec(item)?.[1]
+    return reference && !reference.startsWith('./')
+  })
+}
+
 function matrixAffectsCiFacts (jobSource, command) {
   const matrixReference = /\bmatrix\s*[.[]/
   if (!matrixReference.test(jobSource)) return false
@@ -407,6 +480,8 @@ function normalizeDirectCommand (command) {
     assignments.push(...crossEnv.assignments)
     source = source.slice(crossEnv.length)
   }
+  source = source.replace(/^(?:(?:bunx|npx)(?:\.cmd)?|(?:pnpm|yarn)(?:\.cmd)?\s+exec)\s+/, '')
+    .replace(/^bun x\s+/, '')
   return { assignments, index: prefix.length, source }
 }
 
@@ -446,7 +521,7 @@ function getSelectedJobSource (source, ci) {
 
 function getYamlKeyEntry (line, index) {
   if (!line || /^\s*(?:#|$)/.test(line) || /^\s/.test(line) && line.includes('\t')) return
-  const match = /^(\s*)(?:"([^"]+)"|'([^']+)'|([^:#][^:]*)):\s*(?:#.*)?$/.exec(line)
+  const match = /^(\s*)(?:"([^"]+)"|'([^']+)'|([^\s:#][^:]*)):\s*(?:#.*)?$/.exec(line)
   if (!match) return
   return {
     indent: match[1].length,
@@ -491,16 +566,23 @@ function getMissingReviewFields (ci) {
 }
 
 /**
- * Reads one bounded regular CI file.
+ * Reads one bounded regular project file or its approval-bound snapshot.
  *
- * @param {string} filename CI file
+ * @param {string} filename project file
+ * @param {Map<string, Buffer|undefined>} [projectFileSources] approval-bound project sources
  * @returns {string|undefined} source
  */
-function readCiSource (filename) {
+function readProjectSource (filename, projectFileSources) {
+  if (typeof filename !== 'string') return
+  const resolved = path.resolve(filename)
+  if (projectFileSources) {
+    if (!projectFileSources.has(resolved)) return
+    return projectFileSources.get(resolved)?.toString('utf8')
+  }
   try {
-    const stat = fs.lstatSync(filename)
+    const stat = fs.lstatSync(resolved)
     if (!stat.isFile() || stat.isSymbolicLink() || stat.size > MAX_CI_FILE_BYTES) return
-    return fs.readFileSync(filename, 'utf8')
+    return fs.readFileSync(resolved, 'utf8')
   } catch {}
 }
 
@@ -519,11 +601,35 @@ function containsLiteral (source, value) {
 
 function containsExecutionCommand (source, value) {
   const command = String(value).replaceAll('\r\n', '\n').trim()
-  if (!command || command.includes('\n')) return false
-  return source.split(/\r?\n/).some(line => {
+  if (!command) return false
+  const lines = source.replaceAll('\r\n', '\n').split('\n')
+  return lines.some((line, index) => {
     if (/^\s*#/.test(line)) return false
-    const match = /^\s*(?:-\s*)?(?:run|script):\s*(.*?)\s*$/.exec(line)
-    return match?.[1] === command
+    const match = /^\s*(?:-\s*)?(?:run|script):(.*)$/.exec(line)
+    if (!match) return false
+    const scalar = match[1].trim()
+    if (!/^\|[+-]?$/.test(scalar)) return scalar === command
+
+    const indicatorIndent = /^\s*/.exec(line)[0].length
+    const block = []
+    let contentIndent
+    for (let next = index + 1; next < lines.length; next++) {
+      if (!lines[next].trim()) {
+        block.push('')
+        continue
+      }
+      const nextIndent = /^\s*/.exec(lines[next])[0].length
+      if (contentIndent === undefined) {
+        if (nextIndent <= indicatorIndent) break
+        contentIndent = nextIndent
+      } else if (nextIndent < contentIndent) {
+        break
+      }
+      block.push(lines[next])
+    }
+    if (contentIndent === undefined) return false
+    const blockCommand = block.map(candidate => candidate.slice(contentIndent)).join('\n').trim()
+    return blockCommand === command
   })
 }
 

package/ci/test-optimization-validation/scenarios/helpers.js

@@ -4,6 +4,7 @@ const fs = require('node:fs')
 const path = require('path')
 
 const { getArtifactId } = require('../artifact-id')
+const { BLOCKER_CATEGORIES } = require('../blocker-category')
 const { buildDatadogEnv, buildOfflineCaptureEnv, runCommand } = require('../command-runner')
 const {
   cleanupGeneratedRuntimeFiles,
@@ -19,8 +20,10 @@ const { readOfflineOutput } = require('../offline-output')
 const { sanitizeForReport, sanitizeString } = require('../redaction')
 const { getGeneratedCommand } = require('../runner-command')
 const { ensureSafeDirectory, writeFileSafely } = require('../safe-files')
+const { getValidationBlockerEvidence } = require('../validation-blocker')
 
-const ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}${String.raw`\[[0-?]*[ -/]*[@-~]`}`, 'g')
+const ANSI_PATTERN =
+  new RegExp(`${String.fromCharCode(27)}${String.raw`\[[\u0030-\u003F]*[\u0020-\u002F]*[\u0040-\u007E]`}`, 'g')
 
 function frameworkOutDir (out, framework, scenario) {
   return path.join(out, 'runs', getArtifactId(framework.id), scenario)
@@ -193,10 +196,11 @@ async function prepareGeneratedScenario (framework, scenarioId) {
 function requireGeneratedScenario (framework, scenarioId, scenarioName) {
   const strategy = framework.generatedTestStrategy
   if (strategy?.status === 'not_possible') {
-    return skip(
+    return incomplete(
       framework,
       scenarioName,
-      `Skipped because this advanced feature is not eligible: ${strategy.reason}`,
+      `The validator cannot create a collectible test for this advanced feature: ${strategy.reason} ` +
+        'No conclusion was reached for this advanced feature.',
       getGeneratedStrategySkipEvidence(framework, scenarioName, scenarioId)
     )
   }
@@ -254,9 +258,9 @@ function getGeneratedStrategySkipEvidence (framework, scenarioName, scenarioId)
     reasonCode = 'generated-test-strategy-not-verified'
   }
 
-  return {
+  const evidence = {
     featureEligibility: {
-      eligible: false,
+      ...(reasonCode === 'generated-test-strategy-not-possible' ? {} : { eligible: false }),
       blockedBy: 'generated-test-strategy',
       reason: strategy?.reason,
       reasonCode,
@@ -265,6 +269,12 @@ function getGeneratedStrategySkipEvidence (framework, scenarioName, scenarioId)
       requiredGeneratedScenario: scenarioId,
     },
   }
+  if (reasonCode === 'generated-test-strategy-not-possible') {
+    evidence.blockerCategory = BLOCKER_CATEGORIES.VALIDATOR_LIMITATION
+    evidence.recommendation = 'Report that the selected runner configuration cannot collect validator-generated ' +
+      'tests to validator engineering. Basic Reporting remains valid; project setup changes are not required.'
+  }
+  return evidence
 }
 
 function basicEventEvidence (events) {
@@ -442,6 +452,8 @@ function copy (target, source, key) {
 
 function summarizeDebugRerun ({ result, events, offline, outDir }) {
   const output = `${result.stdout}\n${result.stderr}`
+  const testEvents = eventsOfType(events, 'test')
+  const sourceFiles = new Set(testEvents.map(test => test.testSourceFile).filter(Boolean))
 
   return {
     ran: true,
@@ -449,8 +461,12 @@ function summarizeDebugRerun ({ result, events, offline, outDir }) {
     commandTimedOut: result.timedOut,
     debugCommandFailed: result.exitCode !== 0 || result.timedOut === true,
     offlineExporterInitialized: offline.initialized,
+    settingsLoadedFromCache: offline.inputs.settings?.status === 'loaded',
     artifactDirectory: outDir,
     ...basicEventEvidence(events),
+    testEventsWithoutSourceFile: testEvents.length - testEvents.filter(test => test.testSourceFile).length,
+    testSourceFileCount: sourceFiles.size,
+    testSourceFiles: [...sourceFiles].slice(0, 5),
     debugLines: findInterestingLines(output, [
       /dd-trace/i,
       /test optimization/i,
@@ -541,7 +557,15 @@ function inconclusive (framework, scenario, diagnosis, evidence = {}, outDir, ex
 }
 
 function error (framework, scenario, err, outDir = err?.artifactDirectory) {
-  return result(framework, scenario, 'error', err && err.stack ? err.stack : String(err), {}, outDir)
+  const blockerEvidence = getValidationBlockerEvidence(err)
+  return result(
+    framework,
+    scenario,
+    blockerEvidence ? 'blocked' : 'error',
+    blockerEvidence ? err.message : (err && err.stack ? err.stack : String(err)),
+    blockerEvidence || {},
+    outDir
+  )
 }
 
 function result (framework, scenario, status, diagnosis, evidence, outDir, extraArtifacts) {

package/ci/test-optimization-validation/scenarios/test-management.js

@@ -149,7 +149,7 @@ function buildQuarantinedResponse (framework, scenario, discoveredIdentities = [
   for (const identity of identities) {
     for (const suite of getSuiteCandidates(identity, scenario)) {
       for (const name of getNameCandidates(identity)) {
-        suites[suite] = suites[suite] || { tests: {} }
+        suites[suite] ||= { tests: {} }
         suites[suite].tests[name] = {
           properties: {
             quarantined: true,
@@ -210,7 +210,7 @@ function summarizeManagedTests (testManagementTests) {
     }
     summary.set(displaySuite, testNames)
   }
-  return [...summary.entries()].slice(0, 5).map(([suite, tests]) => ({
+  return [...summary].slice(0, 5).map(([suite, tests]) => ({
     suite,
     tests: [...tests].slice(0, 5),
   }))

package/ci/test-optimization-validation/static-diagnosis.js

@@ -8,6 +8,7 @@ const {
   getFrameworkDefinitions,
   runDiagnosis,
 } = require('../diagnose')
+const { BLOCKER_CATEGORIES } = require('./blocker-category')
 const { sanitizeForReport } = require('./redaction')
 const { writeFileSafely } = require('./safe-files')
 
@@ -45,6 +46,7 @@ function runStaticDiagnosis ({ manifest, out }) {
 function getStaticBlocker (framework, diagnosis) {
   if (!SUPPORTED_FRAMEWORKS.has(framework.framework)) {
     return {
+      blockerCategory: BLOCKER_CATEGORIES.VALIDATOR_LIMITATION,
       reason: `Unsupported test framework detected: ${getUnsupportedFrameworkName(framework)}.`,
       recommendation: 'Choose Jest, Mocha, Cucumber, Cypress, Playwright, or Vitest for live validation.',
     }
@@ -56,6 +58,7 @@ function getStaticBlocker (framework, diagnosis) {
   const version = parseVersion(framework.frameworkVersion)
   if (version && !satisfies(version, definition.supportedRange)) {
     return {
+      blockerCategory: BLOCKER_CATEGORIES.UNSUPPORTED_VERSION,
       reason:
         `${definition.name} ${version} is not supported. Supported range is ${definition.supportedRange}.`,
       recommendation: definition.recommendation,
@@ -65,6 +68,7 @@ function getStaticBlocker (framework, diagnosis) {
   const staticVersionError = findStaticVersionError(definition, diagnosis, framework, version)
   if (staticVersionError) {
     return {
+      blockerCategory: BLOCKER_CATEGORIES.UNSUPPORTED_VERSION,
       reason: staticVersionError.title,
       recommendation: staticVersionError.recommendation || staticVersionError.message,
     }
@@ -117,8 +121,11 @@ function getExactFrameworkLocations (diagnosis, framework) {
   const locations = new Set()
   addRelativeFrameworkLocation(locations, diagnosis, framework.project?.packageJson)
 
-  for (const configFile of framework.project?.configFiles || []) {
-    addRelativeFrameworkLocation(locations, diagnosis, configFile)
+  const configFiles = framework.project?.configFiles
+  if (configFiles) {
+    for (const configFile of configFiles) {
+      addRelativeFrameworkLocation(locations, diagnosis, configFile)
+    }
   }
 
   return locations
@@ -149,7 +156,7 @@ function normalizeRelativePath (location) {
 
 function parseVersion (rawVersion) {
   if (typeof rawVersion !== 'string') return null
-  const match = rawVersion.match(/\d+\.\d+\.\d+/)
+  const match = rawVersion.match(/(?<!\d)\d+\.\d+\.\d+/)
   return match ? match[0] : null
 }
 

package/ci/test-optimization-validation/test-output.js

@@ -4,7 +4,8 @@ const cypressAdapter = require('./framework-adapters/cypress')
 const cucumberAdapter = require('./framework-adapters/cucumber')
 const playwrightAdapter = require('./framework-adapters/playwright')
 
-const ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}${String.raw`\[[0-?]*[ -/]*[@-~]`}`, 'g')
+const ANSI_PATTERN =
+  new RegExp(`${String.fromCharCode(27)}${String.raw`\[[\u0030-\u003F]*[\u0020-\u002F]*[\u0040-\u007E]`}`, 'g')
 
 /**
  * Extracts the final test count from common JavaScript test-runner summaries.

package/ci/test-optimization-validation/validation-blocker.js

@@ -0,0 +1,21 @@
+'use strict'
+
+function createValidationBlocker (message, { kind, recommendation, suppressReport = false }) {
+  const error = new Error(message)
+  error.validationBlocker = { kind, recommendation }
+  error.validationExitCode = 2
+  error.suppressReport = suppressReport
+  return error
+}
+
+function getValidationBlockerEvidence (error) {
+  if (!error?.validationBlocker) return
+  return {
+    blockerKind: error.validationBlocker.kind,
+    domain: 'validator_state',
+    recommendation: error.validationBlocker.recommendation,
+    validationIncomplete: true,
+  }
+}
+
+module.exports = { createValidationBlocker, getValidationBlockerEvidence }