Function loadSamples

actions/setup/js/apply_samples.cjs:57–87

* Read and parse the GH_AW_SAMPLES env var. Returns an empty array (with a * warning) when unset or empty so the workflow can still complete cleanly. * @returns {SampleEntry[]}

()

 * @returns {SampleEntry[]}
 */
function loadSamples() {
  const raw = process.env.GH_AW_SAMPLES;
  if (!raw || !raw.trim()) {
    core.warning("apply_samples: GH_AW_SAMPLES is empty — no samples to replay.");
    return [];
  }
  let parsed;
  try {
    parsed = JSON.parse(raw);
  } catch (err) {
    throw new Error(`${ERR_PARSE}: apply_samples: failed to parse GH_AW_SAMPLES as JSON: ${getErrorMessage(err)}`);
  }
  // Tolerate a literal JSON `null` payload (older compiler emitted it for
  // workflows with --use-samples but no `samples:` entries). Treat as empty.
  if (parsed === null) {
    core.warning("apply_samples: GH_AW_SAMPLES is null — treating as no samples to replay.");
    return [];
  }
  if (!Array.isArray(parsed)) {
    throw new Error(`${ERR_VALIDATION}: apply_samples: GH_AW_SAMPLES must be a JSON array`);
  }
  for (const [i, entry] of parsed.entries()) {
    if (!entry || typeof entry !== "object" || typeof entry.tool !== "string") {
      throw new Error(`${ERR_VALIDATION}: apply_samples: entry ${i} is missing a string "tool" field`);
    }
    if (!entry.arguments || typeof entry.arguments !== "object") {
      throw new Error(`${ERR_VALIDATION}: apply_samples: entry ${i} (tool=${entry.tool}) is missing an "arguments" object`);
    }
  }
  return parsed;
}

/**
 * Run a git subcommand synchronously and return stdout. Throws on non-zero exit.