NAME

PAX::Differential - compare stock Perl execution with PAX capture behavior

SYNOPSIS

my $diff = PAX::Differential->new;
my $report = $diff->compare_capture('script.pl');

DESCRIPTION

PAX::Differential is an internal validation helper. It keeps differential capture checks available after SOW-03 removed pax capture from the public CLI by invoking PAX::Capture directly.

METHODS

new

Constructs a differential runner. The historical pax_bin argument is accepted for compatibility with older tests but no longer drives capture through the CLI.

compare_capture

Runs the entrypoint with stock Perl, captures it through PAX::Capture, and returns comparable exit/status metadata.

PURPOSE

This module exists to make stock-Perl versus PAX capture differences explicit when a behavior mismatch appears, instead of forcing contributors to debug the two paths manually from scratch.