NAME

PAX::CLI - public PAX command facade

SYNOPSIS

use PAX::CLI;

exit PAX::CLI->run(@ARGV);

DESCRIPTION

PAX::CLI implements the SOW-03 public command surface for bin/pax. The only public commands are build, run, and help aliases. Older diagnostic handlers remain private implementation methods so tests and internal modules can reuse them without exposing them as user CLI commands.

PUBLIC COMMANDS

build

Reads CLI options and optional paxfile.yml defaults, then builds a standalone executable through PAX::StandaloneImage.

run

Uses the same build configuration path as build, then executes the resulting standalone binary with arguments after --.

PURPOSE

This module keeps the public command contract, option parsing, interpreter mode, and user-facing error handling in one place so bin/pax can stay thin.

HOW TO USE

Route all public CLI execution through run. Keep internal diagnostics and legacy helpers private to the module layer instead of reopening the public command surface.