sim-run-core

sim-run-core provides the command entry API used by the sim binary. It parses boot controls into CliBoot, preserves handoff payloads in Payload, projects CliEnvelope, and loads the selected boot codec as the first library. The default codec name is lisp, which maps to codec/lisp; --codec NAME maps to codec/NAME. LoadReceipt records whether a loaded library is the boot codec or an ordinary requested library.

The first non-flag token starts the loaded-library payload; -- is available when a caller wants an explicit boundary before payload tokens.

After loading, LoadSession selects a loaded library with a resolved function export under cli/main, such as cli/main/demo. Explicitly loaded libraries take precedence over the boot codec. The handoff passes the CliEnvelope as a kernel table value, then maps the returned value to an exit code by truthiness.

LibSourceSpec parses command-line source syntax, including crates.io:PACKAGE@REQ sources resolved through the CLI-owned cache. With the registry feature, callers can install a GitRegistryResolver so cache misses fetch from an explicit git registry artifact endpoint and then resolve as local path: sources.