README
- ::to_reprArgumentsError::to_repr
- ::to_reprExecutableError::to_repr
- ::to_reprPayloadError::to_repr
- ::to_reprPayloadPathError::to_repr
- ::to_reprShutdownGraceError::to_repr
- ::concatArguments::concat
- ::emptyArguments::empty
- ::parseArguments::parse
- ::to_arrayArguments::to_array
- ::to_reprCancellationCause::to_repr
- ::to_reprChildCompletion::to_repr
- ::argumentsCommand::arguments
- ::executableCommand::executable
- ::newCommand::new
- ::nodeExecutable::node
- ::parseExecutable::parse
- ::to_reprExecutable::to_repr
- ::to_stringExecutable::to_string
- ::equalExecutableRule::equal
- ::not_equalExecutableRule::not_equal
- ::to_reprExecutableRule::to_repr
- ::to_reprFinalizationFailure::to_repr
- ::finalization_failuresLaunchOutcome::finalization_failures
- ::newLaunchOutcome::new
- ::resultLaunchOutcome::result
- ::selected_statusLaunchOutcome::selected_status
T
LaunchPlan
- ::to_reprLaunchResult::to_repr
- ::equalLauncherSignal::equal
- ::not_equalLauncherSignal::not_equal
- ::to_reprLauncherSignal::to_repr
- ::argumentsNodeLaunch::arguments
- ::executableNodeLaunch::executable
- ::newNodeLaunch::new
- ::payloadNodeLaunch::payload
- ::entryPayload::entry
- ::filesPayload::files
- ::newPayload::new
- ::bytesPayloadFile::bytes
- ::newPayloadFile::new
- ::pathPayloadFile::path
- ::equalPayloadPathRule::equal
- ::not_equalPayloadPathRule::not_equal
- ::to_reprPayloadPathRule::to_repr
- ::bitsProcessStatus::bits
- ::equalProcessStatus::equal
- ::failureProcessStatus::failure
- ::from_bitsProcessStatus::from_bits
- ::is_successProcessStatus::is_success
- ::not_equalProcessStatus::not_equal
- ::successProcessStatus::success
- ::to_intProcessStatus::to_int
- ::to_reprProcessStatus::to_repr
- ::parseRelativeFilePath::parse
- ::to_reprRelativeFilePath::to_repr
- ::to_stringRelativeFilePath::to_string
- ::from_millisecondsShutdownGrace::from_milliseconds
- ::millisecondsShutdownGrace::milliseconds
- ::standardShutdownGrace::standard
- ::to_reprStartupFailure::to_repr
- ::to_reprStartupStop::to_repr

#Public Moonx launcher

moonx moonrockz/moon-lander-moonx/launch@VERSION [--json] [--] EXECUTABLE [ARG...]

Replace VERSION with the published shared version. This small executable calls the public driver. It has no separate process lifetime implementation and no application payload protocol. Use the library's NodeLaunch for embedded files. Node is a prerequisite when it is the selected executable.

Launcher options stop at -- or the first executable. Everything after the executable is an opaque argument, including --json, --help, empty strings and Unicode. Use -- before an executable whose name starts with a dash. --help or -h prints help and starts no child. An unknown launcher option, absent executable, empty executable or unrepresentable process argument selects status 2.

The executable preserves binary stdin/stdout and separate stderr. Once a child starts, the child owns stdout completely. --json does not wrap successful output, failure output or a child's own JSON. A finite child status is preserved, including a nonzero status. The public driver owns signal forwarding, deadlines, reaping and finalization; see the guide.

Original SIGINT/SIGTERM forwarding is guaranteed on POSIX hosts. On the two qualified stock Windows Moonrun versions, parent Ctrl-C reaches Node as Ctrl-Break, so a genuine Node-owned host reports Quit/131. The parent preserves its original Interrupt observation and full Windows cancellation status. Finite transport, Ctrl-Break and forced cleanup remain supported. The launcher does not rewrite the child's completion or application result.

#JSON ownership contract

--json selects a single parent JSON document only for command help, usage failure, or a typed outcome proving that no child started. Those reports use stdout; their human forms use stdout for help and stderr for failures. Parent startup reporting does not read the child channel. The argument boundary also prevents an application's --json from selecting parent reporting.

Each parent document has schema_version: 1, command: "moon-lander-moonx/launch", package_version, kind and exit_status. exit_status is an unsigned 32-bit number so Windows status bits are preserved.

kind	Extra fields	Meaning
help	usage, stdout_ownership	Explicit command help, status 0
usage-error	reason	Typed argument rule, status 2
not-started	reason, finalization_failure_count	No child started; status selected after cleanup

Usage reasons are unknown-option, missing-executable, invalid-executable and invalid-argument, with the input, rule or index where relevant. Startup reasons are process-start-failed, node-missing, materialization-failed, signal and requested. A signal reason names its original OS identity. Error messages are display text; consumers match the documented kinds rather than parsing messages. Application result schemas remain application-owned.

For example, --json -- /missing/program reports kind: "not-started"; it starts no child and selects failure. --json -- node app.js --json forwards the last option to app.js and emits no parent document once Node has started. Cancellation after startup also emits no parent application result.