Function compareMeasurement

orchestrate/skills/orchestrate/scripts/measurements.ts:128–193

(
  args: MeasurementComparisonInput
)

 * after whitespace collapse.
 */
export function compareMeasurement(
  args: MeasurementComparisonInput
): MeasurementCheck {
  const tolerance =
    args.spec.toleranceFraction ?? MEASUREMENT_DEFAULT_TOLERANCE;
  const measured = args.measured.trim();
  const measuredNumeric = parseFiniteNumber(measured);
  const base = {
    name: args.spec.name,
    command: args.spec.command,
    measured,
    measuredNumeric,
  };
  if (!args.claim) {
    return {
      ...base,
      claim: null,
      outcome: "claim-missing",
      driftFraction: null,
      detail: `worker did not report a claim line named ${JSON.stringify(args.spec.name)}`,
    };
  }
  const measuredParsed = parseNumericWithUnit(measured);
  const claimParsed = parseNumericWithUnit(args.claim.after);
  if (measuredParsed && claimParsed) {
    if (measuredParsed.unit !== claimParsed.unit) {
      const detail =
        measuredParsed.unit !== null && claimParsed.unit !== null
          ? `unit mismatch; claimed ${claimParsed.unit}, measured ${measuredParsed.unit}`
          : `unit inconsistency; claimed ${args.claim.after}, measured ${measured}`;
      return {
        ...base,
        claim: args.claim,
        outcome: "value-mismatch",
        driftFraction: null,
        detail,
      };
    }
    const denom = Math.max(Math.abs(claimParsed.numeric), 1);
    const drift =
      Math.abs(measuredParsed.numeric - claimParsed.numeric) / denom;
    const outcome: MeasurementCheck["outcome"] =
      drift > tolerance ? "value-mismatch" : "match";
    return {
      ...base,
      claim: args.claim,
      outcome,
      driftFraction: drift,
      detail:
        outcome === "match"
          ? `numeric within tolerance (drift ${formatFraction(drift)} ≤ ${formatFraction(tolerance)})`
          : `numeric drift ${formatFraction(drift)} > tolerance ${formatFraction(tolerance)}; claimed ${args.claim.after}, measured ${measured}`,
    };
  }
  const matches =
    collapseWhitespace(measured) === collapseWhitespace(args.claim.after);
  return {
    ...base,