cli

func NewRoot ¶

func NewRoot(paths *config.Paths) *cobra.Command

NewRoot builds the full lo command tree: the usage-mirrored tree plus the Go-only commands. The project's spec.implementation (routing.go) is read once here: a routed command is registered as a shim to the bash tree in the project, `default: bash` shims the whole usage tree, and the Go-only commands stay Go.

func Shim ¶

func Shim(p *config.Paths, argv []string) error

Shim replaces the current process with the argsh implementation (`lo` in the bash tree), passing argv through verbatim so both implementations parse identically. The tree is a checkout or ejected tree when the project has one, else the copy embedded in the binary, extracted once into the versioned cache (assets.BashTree). This is the `lo drivers <name>` fallback for a driver without a Go twin; a routed command (routing.go) goes through execShim with the project's tree instead and never reaches the cache.

func WatchInterrupt ¶

func WatchInterrupt(parent context.Context) (ctx context.Context, exitCode func() int)

WatchInterrupt cancels the returned context on the first SIGINT or SIGTERM and reports the exit code that signal maps to. The bash entrypoint set no trap: the shell died of the signal, the process exit code was 128+n (130 for SIGINT, 143 for SIGTERM) and nothing was printed. The Go binary cancels the command context instead, so every Runner child and every wait loop stops, and main exits with the same code. The watch ends with the first signal: a second one takes the default action again and ends a process that did not stop on its own.

exitCode stops the watch and returns 0 while no signal arrived, else 128+n. Call it once, after the command returned.