cli

Overview ¶

Package cli builds the Iris command-line surface: the cobra noun-verb command tree, the global flags, and the exit-code and --json output contracts. It sits at the top of the product import graph (nothing imports it), and cmd/iris is a thin entrypoint over Execute. Interactive full-screen views live in internal/tui; this package owns command wiring only.

Nearly every command handler is real: it resolves its target, dials the daemon over the unix socket or TCP, and maps the reply onto the contract that framed the surface from the first day -- the categorical exit codes, the single-JSON document on stdout under --json, and the strict separation of log output (stderr) from command output (stdout). A handful of read verbs are still unwired stubs (run show, engine logs, deadletter list, endpoint list/show/remove, pat list/revoke): they carry the daemonStub handler, which reports "no daemon reachable" (exit 3) with guidance to start the engine when nothing answers, and "not implemented" (exit 4) once a daemon does.